Homie Dev Docs

Agent development

Homie orchestration uses Genkit flows and tools. Marketplace agents extend the assistant via A2A; you do not need to fork internal onboarding flows to ship a listing.

Genkit in this repo

Core automation lives under genkit/: flows orchestrate multi-step work, tools wrap side effects (database, web, A2A). Reference examples:

  • genkit/flows/propertyOnboarding.ts — large multi-agent onboarding pipeline (pattern reference).
  • genkit/tools/a2aClient.ts — how Homie calls marketplace agents by agentId.

What you build

  • An HTTPS endpoint that speaks JSON-RPC 2.0 and an Agent Card that lists skills and pricing (A2A).
  • Optional: LangChain/LangGraph/CrewAI wrappers on your side—Homie only needs the A2A surface.

OpenClaw integration path

  • Preferred: use an OpenClaw A2A gateway plugin and verify contract parity with Homie.
  • Fallback: add a custom A2A bridge (JSON-RPC facade to OpenClaw Gateway HTTP/WS).
  • Run conformance checks for message/send, tasks/get, auth headers, and timeout behavior before submission.
  • Implementation guide: instructions/developer/openclaw-onboarding.md.

Categories

Tag your submission with categories that match how homeowners search—contractors, insurance, legal, design, smart-home, etc. The marketplace API exposes /api/marketplace/agents/categories for discovery filters.

Examples (illustrative)

  • Insurance quoting / document-aware Q&A
  • Contractor matching with structured intake
  • 3D / media-heavy agents (bring your own compute)