zooid 0.6.1 → 0.7.1

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+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;
+    /**
+     * Directory containing zooid.yaml. Required when any agent uses the
+     * workspace auto-mount (the default under `runtime: docker | podman`):
+     * relative `agent.workdir` paths are resolved against this dir.
+     */
+    configDir?: string;
+    /**
+     * Daemon data root. Each agent's preset mounts target
+     * `<dataDir>/agents/<agentName>` on the host.
+     */
+    dataDir?: string;
+    /**
+     * Daemon user's `$HOME`. Sourced by the v1 preset `home` / `data` /
+     * `config` mounts. Tests inject a stub; production threads
+     * `process.env.HOME` from `start-daemon`.
+     */
+    daemonHome?: string;
+    /**
+     * Sink for the per-agent "resolved image + mounts" startup log lines.
+     * Defaults to `console.log`. Tests pass a capture array.
+     */
+    log?: (line: string) => void;
+}
+/**
+ * Build an `AcpAgentRegistry` from a parsed workforce config.
+ *
+ *   - `runtime: local`   → `LocalAcpRuntime`
+ *   - `runtime: docker`  → `DockerAcpRuntime` (engine: docker)
+ *   - `runtime: podman`  → `DockerAcpRuntime` (engine: podman)
+ *
+ * Compose layers (docker/podman only): workspace auto-mount → preset-declared
+ * canonical-id mounts (filtered by `container.disable_mounts`) → user mounts.
+ * Image resolution: agent.container.image > workforce container.image >
+ * preset.image. Under `runtime: docker | podman`, throws at startup if any
+ * agent has no resolvable image.
+ */
+declare function buildAcpRegistry(cfg: ZooidConfig, opts?: BuildAcpRegistryOptions): AcpAgentRegistry;
+
+export { type BuildAcpRegistryOptions, buildAcpRegistry };