zooid 0.6.1 → 0.7.0

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+import { AcpRuntime, ApprovalCorrelator, TapEvent, ZooidConfig, AcpAgentRegistry } from '@zooid/core';
+import { SpawnRegistry } from '@zooid/context-mcp';
+
+interface BuildAcpRegistryOptions {
+    /** Override the runtime selection (tests). */
+    runtime?: AcpRuntime;
+    /** When set, the registry's approval handler routes through this correlator. */
+    approvals?: ApprovalCorrelator;
+    /** Observability tap forwarded to each AcpClient. */
+    onTap?: (agentName: string, event: TapEvent) => void;
+    /**
+     * Per-agent state root (`<dataRoot>/agents/`). When set, each AcpClient
+     * persists its `(threadId → sessionId)` map under
+     * `<agentsDir>/<agentName>/sessions.json` so threads survive daemon restarts.
+     */
+    agentsDir?: string;
+    /**
+     * Per-spawn binding store for the zooid-context MCP server. When set
+     * together with `daemonSockPath`, agents bound to a transport that owns
+     * conversation context get a `contextSpawn` factory threaded into their
+     * AcpClient so `session/new mcpServers` includes the zooid-context entry.
+     */
+    contextSpawnRegistry?: SpawnRegistry;
+    /** Path to the daemon's context Unix socket. Passed to the MCP server bin. */
+    daemonSockPath?: string;
+}
+/**
+ * Build an `AcpAgentRegistry` from a parsed workforce config.
+ *
+ *   - `runtime: local`   → `LocalAcpRuntime`
+ *   - `runtime: docker`  → `DockerAcpRuntime` (engine: docker)
+ *   - `runtime: podman`  → `DockerAcpRuntime` (engine: podman)
+ *
+ * Per-agent `container.env` is passed through to each `AcpClient`'s spawn
+ * spec verbatim (interpolation happens at parse time in `@zooid/core`).
+ * The image is resolved as `agent.container?.image ?? cfg.container?.image`.
+ */
+declare function buildAcpRegistry(cfg: ZooidConfig, opts?: BuildAcpRegistryOptions): AcpAgentRegistry;
+
+export { type BuildAcpRegistryOptions, buildAcpRegistry };