@autonome-research/thread-phase-agents 3.0.0

package/dist/injectors.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Pre-built `inject` callbacks for `withMemory` and `withThread`.
+ *
+ * Both wrappers in `thread-phase/agents` take a caller-supplied
+ * `inject` function because each adapter shapes its prompt field
+ * differently — `inferenceAgent` puts it on `config.config.systemPrompt`,
+ * Anthropic uses `systemPrompt`, Codex uses `instructions`, ACP-based
+ * adapters use `config.prompt`. Writing the right splicer at every
+ * call site is friction; these tables ship the canonical ones for the
+ * bundled adapter set.
+ *
+ * Composes with `withMemory` / `withThread`:
+ *
+ *     const memoryAware = withMemory(claudeCodeAgent, {
+ *       scope: { userId: 'alice' },
+ *       inject: injectMemory.claudeCode,
+ *     });
+ *
+ *     const threadAware = withThread(hermesAgent, thread, {
+ *       applyResume: injectResume.hermes,
+ *     });
+ *
+ * The keys match each adapter's public id (`'claude-code'` → `claudeCode`
+ * etc., camelCased for TypeScript ergonomics).
+ *
+ * @internal
+ */
+import type { InferenceAgentConfig, ResumeToken } from '@autonome-research/thread-phase/agents';
+import type { AcpAgentConfig } from './acp/index.js';
+import type { AnthropicAgentConfig } from './anthropic/index.js';
+import type { ClaudeCodeAgentConfig } from './claude-code/index.js';
+import type { CodexAgentConfig } from './codex/index.js';
+import type { CodexCliAgentConfig } from './codex-cli/index.js';
+import type { HermesAgentConfig } from './hermes/index.js';
+import type { OpenClawAgentConfig } from './openclaw/index.js';
+import type { PiAgentConfig } from './pi/index.js';
+/** @internal */
+export declare const injectMemory: {
+    /**
+     * Append memory to the agent runner's system prompt. Leaves config
+     * unchanged when memory is empty (first-run users with no recall).
+     */
+    inference(cfg: InferenceAgentConfig, memory: string): InferenceAgentConfig;
+    /** Append memory to Anthropic's system prompt. */
+    anthropic(cfg: AnthropicAgentConfig, memory: string): AnthropicAgentConfig;
+    /** Append memory to Codex's `instructions` (Responses API system equivalent). */
+    codex(cfg: CodexAgentConfig, memory: string): CodexAgentConfig;
+    /**
+     * Prepend memory to Claude Code's prompt. Claude Code's CLI has no
+     * separate system-prompt flag at this layer, so memory becomes part
+     * of the user prompt.
+     */
+    claudeCode(cfg: ClaudeCodeAgentConfig, memory: string): ClaudeCodeAgentConfig;
+    /**
+     * Prepend memory to the ACP prompt. ACP's `session/prompt` has no
+     * system slot — memory becomes part of the user message content.
+     * Preserves a non-text prompt (ContentBlock[]) by injecting the
+     * memory as a leading text block.
+     */
+    acp(cfg: AcpAgentConfig, memory: string): AcpAgentConfig;
+    /** Same shape as `acp` — Hermes is an ACP wrapper. */
+    hermes(cfg: HermesAgentConfig, memory: string): HermesAgentConfig;
+    /** Same shape as `acp` — OpenClaw is an ACP wrapper. */
+    openClaw(cfg: OpenClawAgentConfig, memory: string): OpenClawAgentConfig;
+    /**
+     * Prepend memory to codex CLI's positional prompt. Same pattern as
+     * claudeCode: no system-prompt flag, memory becomes part of the user
+     * prompt.
+     */
+    codexCli(cfg: CodexCliAgentConfig, memory: string): CodexCliAgentConfig;
+    /**
+     * Prepend memory to pi's prompt. Pi's `prompt(text)` takes a string;
+     * pi handles its own system prompt internally via prompt templates
+     * and resource loader.
+     */
+    pi(cfg: PiAgentConfig, memory: string): PiAgentConfig;
+};
+/** @internal */
+export declare const injectResume: {
+    /** inferenceAgent declares `resumption: 'none'`; passthrough. */
+    inference(cfg: InferenceAgentConfig, _token: ResumeToken): InferenceAgentConfig;
+    /** anthropicAgent declares `resumption: 'none'`; passthrough. */
+    anthropic(cfg: AnthropicAgentConfig, _token: ResumeToken): AnthropicAgentConfig;
+    /** Codex's Responses API takes `previous_response_id` natively. */
+    codex(cfg: CodexAgentConfig, token: ResumeToken): CodexAgentConfig;
+    /** Claude Code's CLI takes `--resume <session-id>`. */
+    claudeCode(cfg: ClaudeCodeAgentConfig, token: ResumeToken): ClaudeCodeAgentConfig;
+    /** ACP's `session/load` takes a session id. */
+    acp(cfg: AcpAgentConfig, token: ResumeToken): AcpAgentConfig;
+    /** Hermes inherits ACP's resume path. */
+    hermes(cfg: HermesAgentConfig, token: ResumeToken): HermesAgentConfig;
+    /** OpenClaw inherits ACP's resume path. */
+    openClaw(cfg: OpenClawAgentConfig, token: ResumeToken): OpenClawAgentConfig;
+    /** Codex CLI uses thread-id-based resumption. */
+    codexCli(cfg: CodexCliAgentConfig, token: ResumeToken): CodexCliAgentConfig;
+    /**
+     * Pi resumption uses on-disk session files. Accepts either
+     * `session-file` (preferred — the actual session path) or `opaque`
+     * (treated as a session id for SessionManager lookup; falls through
+     * unchanged so the caller can set continueSession themselves).
+     */
+    pi(cfg: PiAgentConfig, token: ResumeToken): PiAgentConfig;
+};
+//# sourceMappingURL=injectors.d.ts.map

package/dist/injectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectors.d.ts","sourceRoot":"","sources":["../src/injectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EACZ,MAAM,wCAAwC,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQnD,gBAAgB;AAChB,eAAO,MAAM,YAAY;IACvB;;;OAGG;mBACY,oBAAoB,UAAU,MAAM,GAAG,oBAAoB;IAW1E,kDAAkD;mBACnC,oBAAoB,UAAU,MAAM,GAAG,oBAAoB;IAQ1E,iFAAiF;eACtE,gBAAgB,UAAU,MAAM,GAAG,gBAAgB;IAQ9D;;;;OAIG;oBACa,qBAAqB,UAAU,MAAM,GAAG,qBAAqB;IAQ7E;;;;;OAKG;aACM,cAAc,UAAU,MAAM,GAAG,cAAc;IAcxD,sDAAsD;gBAC1C,iBAAiB,UAAU,MAAM,GAAG,iBAAiB;IAcjE,wDAAwD;kBAC1C,mBAAmB,UAAU,MAAM,GAAG,mBAAmB;IAcvE;;;;OAIG;kBACW,mBAAmB,UAAU,MAAM,GAAG,mBAAmB;IAQvE;;;;OAIG;YACK,aAAa,UAAU,MAAM,GAAG,aAAa;CAOtD,CAAC;AAMF,gBAAgB;AAChB,eAAO,MAAM,YAAY;IACvB,iEAAiE;mBAClD,oBAAoB,UAAU,WAAW,GAAG,oBAAoB;IAI/E,iEAAiE;mBAClD,oBAAoB,UAAU,WAAW,GAAG,oBAAoB;IAI/E,mEAAmE;eACxD,gBAAgB,SAAS,WAAW,GAAG,gBAAgB;IAKlE,uDAAuD;oBACvC,qBAAqB,SAAS,WAAW,GAAG,qBAAqB;IAKjF,+CAA+C;aACtC,cAAc,SAAS,WAAW,GAAG,cAAc;IAK5D,yCAAyC;gBAC7B,iBAAiB,SAAS,WAAW,GAAG,iBAAiB;IAKrE,2CAA2C;kBAC7B,mBAAmB,SAAS,WAAW,GAAG,mBAAmB;IAK3E,iDAAiD;kBACnC,mBAAmB,SAAS,WAAW,GAAG,mBAAmB;IAK3E;;;;;OAKG;YACK,aAAa,SAAS,WAAW,GAAG,aAAa;CAM1D,CAAC"}

package/dist/injectors.js

@@ -0,0 +1,219 @@
+/**
+ * Pre-built `inject` callbacks for `withMemory` and `withThread`.
+ *
+ * Both wrappers in `thread-phase/agents` take a caller-supplied
+ * `inject` function because each adapter shapes its prompt field
+ * differently — `inferenceAgent` puts it on `config.config.systemPrompt`,
+ * Anthropic uses `systemPrompt`, Codex uses `instructions`, ACP-based
+ * adapters use `config.prompt`. Writing the right splicer at every
+ * call site is friction; these tables ship the canonical ones for the
+ * bundled adapter set.
+ *
+ * Composes with `withMemory` / `withThread`:
+ *
+ *     const memoryAware = withMemory(claudeCodeAgent, {
+ *       scope: { userId: 'alice' },
+ *       inject: injectMemory.claudeCode,
+ *     });
+ *
+ *     const threadAware = withThread(hermesAgent, thread, {
+ *       applyResume: injectResume.hermes,
+ *     });
+ *
+ * The keys match each adapter's public id (`'claude-code'` → `claudeCode`
+ * etc., camelCased for TypeScript ergonomics).
+ *
+ * @internal
+ */
+// ---------------------------------------------------------------------------
+// Memory injectors
+// ---------------------------------------------------------------------------
+const MEMORY_HEADER = '\n\nContext from prior interactions:\n';
+/** @internal */
+export const injectMemory = {
+    /**
+     * Append memory to the agent runner's system prompt. Leaves config
+     * unchanged when memory is empty (first-run users with no recall).
+     */
+    inference(cfg, memory) {
+        if (!memory)
+            return cfg;
+        return {
+            ...cfg,
+            config: {
+                ...cfg.config,
+                systemPrompt: `${cfg.config.systemPrompt}${MEMORY_HEADER}${memory}`,
+            },
+        };
+    },
+    /** Append memory to Anthropic's system prompt. */
+    anthropic(cfg, memory) {
+        if (!memory)
+            return cfg;
+        return {
+            ...cfg,
+            systemPrompt: `${cfg.systemPrompt ?? ''}${MEMORY_HEADER}${memory}`,
+        };
+    },
+    /** Append memory to Codex's `instructions` (Responses API system equivalent). */
+    codex(cfg, memory) {
+        if (!memory)
+            return cfg;
+        return {
+            ...cfg,
+            instructions: `${cfg.instructions ?? ''}${MEMORY_HEADER}${memory}`,
+        };
+    },
+    /**
+     * Prepend memory to Claude Code's prompt. Claude Code's CLI has no
+     * separate system-prompt flag at this layer, so memory becomes part
+     * of the user prompt.
+     */
+    claudeCode(cfg, memory) {
+        if (!memory)
+            return cfg;
+        return {
+            ...cfg,
+            prompt: `Context from prior interactions:\n${memory}\n\nCurrent request: ${cfg.prompt}`,
+        };
+    },
+    /**
+     * Prepend memory to the ACP prompt. ACP's `session/prompt` has no
+     * system slot — memory becomes part of the user message content.
+     * Preserves a non-text prompt (ContentBlock[]) by injecting the
+     * memory as a leading text block.
+     */
+    acp(cfg, memory) {
+        if (!memory)
+            return cfg;
+        if (Array.isArray(cfg.prompt)) {
+            return {
+                ...cfg,
+                prompt: [{ type: 'text', text: `Context from prior interactions:\n${memory}\n\n` }, ...cfg.prompt],
+            };
+        }
+        return {
+            ...cfg,
+            prompt: `Context from prior interactions:\n${memory}\n\nCurrent request: ${cfg.prompt}`,
+        };
+    },
+    /** Same shape as `acp` — Hermes is an ACP wrapper. */
+    hermes(cfg, memory) {
+        if (!memory)
+            return cfg;
+        if (Array.isArray(cfg.prompt)) {
+            return {
+                ...cfg,
+                prompt: [{ type: 'text', text: `Context from prior interactions:\n${memory}\n\n` }, ...cfg.prompt],
+            };
+        }
+        return {
+            ...cfg,
+            prompt: `Context from prior interactions:\n${memory}\n\nCurrent request: ${cfg.prompt}`,
+        };
+    },
+    /** Same shape as `acp` — OpenClaw is an ACP wrapper. */
+    openClaw(cfg, memory) {
+        if (!memory)
+            return cfg;
+        if (Array.isArray(cfg.prompt)) {
+            return {
+                ...cfg,
+                prompt: [{ type: 'text', text: `Context from prior interactions:\n${memory}\n\n` }, ...cfg.prompt],
+            };
+        }
+        return {
+            ...cfg,
+            prompt: `Context from prior interactions:\n${memory}\n\nCurrent request: ${cfg.prompt}`,
+        };
+    },
+    /**
+     * Prepend memory to codex CLI's positional prompt. Same pattern as
+     * claudeCode: no system-prompt flag, memory becomes part of the user
+     * prompt.
+     */
+    codexCli(cfg, memory) {
+        if (!memory)
+            return cfg;
+        return {
+            ...cfg,
+            prompt: `Context from prior interactions:\n${memory}\n\nCurrent request: ${cfg.prompt}`,
+        };
+    },
+    /**
+     * Prepend memory to pi's prompt. Pi's `prompt(text)` takes a string;
+     * pi handles its own system prompt internally via prompt templates
+     * and resource loader.
+     */
+    pi(cfg, memory) {
+        if (!memory)
+            return cfg;
+        return {
+            ...cfg,
+            prompt: `Context from prior interactions:\n${memory}\n\nCurrent request: ${cfg.prompt}`,
+        };
+    },
+};
+// ---------------------------------------------------------------------------
+// Resume injectors
+// ---------------------------------------------------------------------------
+/** @internal */
+export const injectResume = {
+    /** inferenceAgent declares `resumption: 'none'`; passthrough. */
+    inference(cfg, _token) {
+        return cfg;
+    },
+    /** anthropicAgent declares `resumption: 'none'`; passthrough. */
+    anthropic(cfg, _token) {
+        return cfg;
+    },
+    /** Codex's Responses API takes `previous_response_id` natively. */
+    codex(cfg, token) {
+        if (token.kind !== 'response-id')
+            return cfg;
+        return { ...cfg, previousResponseId: token.id };
+    },
+    /** Claude Code's CLI takes `--resume <session-id>`. */
+    claudeCode(cfg, token) {
+        if (token.kind !== 'opaque')
+            return cfg;
+        return { ...cfg, resumeSessionId: token.data };
+    },
+    /** ACP's `session/load` takes a session id. */
+    acp(cfg, token) {
+        if (token.kind !== 'opaque')
+            return cfg;
+        return { ...cfg, resumeSessionId: token.data };
+    },
+    /** Hermes inherits ACP's resume path. */
+    hermes(cfg, token) {
+        if (token.kind !== 'opaque')
+            return cfg;
+        return { ...cfg, resumeSessionId: token.data };
+    },
+    /** OpenClaw inherits ACP's resume path. */
+    openClaw(cfg, token) {
+        if (token.kind !== 'opaque')
+            return cfg;
+        return { ...cfg, resumeSessionId: token.data };
+    },
+    /** Codex CLI uses thread-id-based resumption. */
+    codexCli(cfg, token) {
+        if (token.kind !== 'opaque')
+            return cfg;
+        return { ...cfg, resumeThreadId: token.data };
+    },
+    /**
+     * Pi resumption uses on-disk session files. Accepts either
+     * `session-file` (preferred — the actual session path) or `opaque`
+     * (treated as a session id for SessionManager lookup; falls through
+     * unchanged so the caller can set continueSession themselves).
+     */
+    pi(cfg, token) {
+        if (token.kind === 'session-file') {
+            return { ...cfg, resumeSessionFile: token.path };
+        }
+        return cfg;
+    },
+};
+//# sourceMappingURL=injectors.js.map

package/dist/injectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectors.js","sourceRoot":"","sources":["../src/injectors.ts"],"names":[],"mappings":"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"}

package/dist/openclaw/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * OpenClaw adapter — wraps the ACP chassis to talk to OpenClaw via `acpx`.
+ *
+ * OpenClaw itself runs as a Gateway daemon (default :18789); `acpx` is the
+ * companion ACP client that bridges the Gateway. The adapter spawns `acpx`
+ * and lets the chassis handle the protocol.
+ *
+ * The Gateway must be running before the adapter is invoked. If it isn't,
+ * `acpx` exits early and the adapter surfaces the subprocess stderr as a
+ * `native { kind: 'acp:stderr' }` event followed by `finishReason: 'error'`.
+ *
+ * NemoClaw mode: NemoClaw is NVIDIA's sandboxing layer that runs OpenClaw
+ * inside an isolated environment. Setting `sandbox: 'nemoclaw'` invokes the
+ * chassis command via `nemoclaw connect`, which routes IO through the
+ * sandbox. Requires NemoClaw to be installed and onboarded.
+ *
+ * @internal
+ */
+import { type AgentAdapterMeta } from '@autonome-research/thread-phase/agents';
+import { type AcpAgentConfig, type ContentBlock, type McpServer } from '../acp/index.js';
+/** @internal */
+export interface OpenClawAgentConfig {
+    /** Working directory advertised to OpenClaw at session/new. */
+    cwd: string;
+    /** Prompt sent via session/prompt. */
+    prompt: string | ContentBlock[];
+    /** Resume a prior OpenClaw session by its id. */
+    resumeSessionId?: string;
+    /** Path to the `acpx` executable; default 'acpx'. */
+    openClawExecutable?: string;
+    /** Extra args passed to acpx; default []. */
+    openClawArgs?: string[];
+    /**
+     * Sandbox mode. 'local' (default) runs acpx directly. 'nemoclaw' invokes
+     * the acpx command through `nemoclaw connect` so the agent runs inside
+     * the NemoClaw OpenShell sandbox.
+     */
+    sandbox?: 'local' | 'nemoclaw';
+    /** Executable for the NemoClaw CLI; default 'nemoclaw'. */
+    nemoclawExecutable?: string;
+    /** Environment overrides merged with process.env. */
+    env?: Record<string, string>;
+    /** MCP servers exposed to OpenClaw; default []. */
+    mcpServers?: McpServer[];
+    /** Permission handling for tool calls OpenClaw asks the client to authorize. */
+    permissionMode?: AcpAgentConfig['permissionMode'];
+    /** Cancel-then-SIGTERM grace window in ms; default 2000. */
+    cancelGraceMs?: number;
+    /** SIGTERM-then-SIGKILL grace window in ms; default 3000. */
+    killGraceMs?: number;
+}
+/** @internal */
+export declare const openClawAgent: AgentAdapterMeta<OpenClawAgentConfig>;
+//# sourceMappingURL=index.d.ts.map

package/dist/openclaw/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openclaw/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AACnG,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AAEzB,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IAChC,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC/B,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mDAAmD;IACnD,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,gFAAgF;IAChF,cAAc,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAClD,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAwCD,gBAAgB;AAChB,eAAO,MAAM,aAAa,EAAE,gBAAgB,CAAC,mBAAmB,CAI9D,CAAC"}

package/dist/openclaw/index.js

@@ -0,0 +1,61 @@
+/**
+ * OpenClaw adapter — wraps the ACP chassis to talk to OpenClaw via `acpx`.
+ *
+ * OpenClaw itself runs as a Gateway daemon (default :18789); `acpx` is the
+ * companion ACP client that bridges the Gateway. The adapter spawns `acpx`
+ * and lets the chassis handle the protocol.
+ *
+ * The Gateway must be running before the adapter is invoked. If it isn't,
+ * `acpx` exits early and the adapter surfaces the subprocess stderr as a
+ * `native { kind: 'acp:stderr' }` event followed by `finishReason: 'error'`.
+ *
+ * NemoClaw mode: NemoClaw is NVIDIA's sandboxing layer that runs OpenClaw
+ * inside an isolated environment. Setting `sandbox: 'nemoclaw'` invokes the
+ * chassis command via `nemoclaw connect`, which routes IO through the
+ * sandbox. Requires NemoClaw to be installed and onboarded.
+ *
+ * @internal
+ */
+import { defineAgentAdapter } from '@autonome-research/thread-phase/agents';
+import { createAcpAdapter, } from '../acp/index.js';
+const chassis = createAcpAdapter({ id: 'openclaw' });
+function toAcpConfig(config) {
+    const acpx = config.openClawExecutable ?? 'acpx';
+    const userArgs = config.openClawArgs ?? [];
+    if (config.sandbox === 'nemoclaw') {
+        const nemoclaw = config.nemoclawExecutable ?? 'nemoclaw';
+        return {
+            command: nemoclaw,
+            args: ['connect', acpx, ...userArgs],
+            cwd: config.cwd,
+            prompt: config.prompt,
+            resumeSessionId: config.resumeSessionId,
+            env: config.env,
+            mcpServers: config.mcpServers,
+            permissionMode: config.permissionMode,
+            cancelGraceMs: config.cancelGraceMs,
+            killGraceMs: config.killGraceMs,
+            clientInfo: { name: 'thread-phase-agents', version: '0.0.1' },
+        };
+    }
+    return {
+        command: acpx,
+        args: userArgs,
+        cwd: config.cwd,
+        prompt: config.prompt,
+        resumeSessionId: config.resumeSessionId,
+        env: config.env,
+        mcpServers: config.mcpServers,
+        permissionMode: config.permissionMode,
+        cancelGraceMs: config.cancelGraceMs,
+        killGraceMs: config.killGraceMs,
+        clientInfo: { name: 'thread-phase-agents', version: '0.0.1' },
+    };
+}
+/** @internal */
+export const openClawAgent = defineAgentAdapter({
+    id: chassis.id,
+    capabilities: chassis.capabilities,
+    adapter: (config, options) => chassis.adapter(toAcpConfig(config), options),
+});
+//# sourceMappingURL=index.js.map

package/dist/openclaw/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openclaw/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,kBAAkB,EAAyB,MAAM,wCAAwC,CAAC;AACnG,OAAO,EACL,gBAAgB,GAIjB,MAAM,iBAAiB,CAAC;AAkCzB,MAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AAErD,SAAS,WAAW,CAAC,MAA2B;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;IAE3C,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,kBAAkB,IAAI,UAAU,CAAC;QACzD,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;YACpC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,EAAE;SAC9D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,EAAE;KAC9D,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,aAAa,GAA0C,kBAAkB,CAAC;IACrF,EAAE,EAAE,OAAO,CAAC,EAAE;IACd,YAAY,EAAE,OAAO,CAAC,YAAY;IAClC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC5E,CAAC,CAAC"}

package/dist/pi/adapter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Pi adapter — in-process via `@mariozechner/pi-coding-agent`.
+ *
+ * Pi is a fully-featured TypeScript coding agent SDK. Unlike the
+ * subprocess-based adapters (claude-code, codex-cli, ACP), pi runs in
+ * the same Node process: the adapter calls `createAgentSession`,
+ * subscribes to its event stream, and forwards each event into the
+ * canonical AgentEvent vocabulary.
+ *
+ * The headline difference from every other adapter: **pi supports
+ * native mid-stream steering and follow-up.** This is the first
+ * adapter where both `steer()` and `followUp()` on
+ * `SteerableAgentRun` actually work at runtime — pi accepts new
+ * messages while the model is still generating.
+ *
+ * Capabilities:
+ *   streaming        'text'
+ *   cancellation     'cooperative'   (session.abort())
+ *   resumption       'session-file'  (pi's SessionManager persists to disk)
+ *   structuredOutput 'prompted'
+ *
+ * Event translation:
+ *   pi agent_start                  -> canonical agent_start
+ *   pi message_update + text_delta  -> canonical text
+ *   pi message_update + thinking_*  -> canonical thinking
+ *   pi tool_execution_start         -> canonical tool_call
+ *   pi tool_execution_end           -> canonical tool_result
+ *   pi turn_end                     -> canonical turn_end (via endTurn)
+ *   pi agent_end                    -> canonical agent_end
+ *   everything else                 -> native events (kind: 'pi:*')
+ *
+ * @internal
+ */
+import { type AgentAdapterMeta, type StructuredOutputConfig } from '@autonome-research/thread-phase/agents';
+type AgentSession = unknown;
+/** @internal */
+export interface PiAgentConfig {
+    /** Working directory. Default: process.cwd(). */
+    cwd?: string;
+    /** Prompt text sent to `session.prompt`. */
+    prompt: string;
+    /**
+     * Resume a specific pi session file. Mutually exclusive with
+     * `continueSession`. The path is exposed as `ResumeToken{ kind:
+     * 'session-file' }` on agent_start and agent_end.
+     */
+    resumeSessionFile?: string;
+    /**
+     * Continue the most recent session in cwd. Equivalent to passing
+     * `continueSession: true` to `createAgentSession`.
+     */
+    continueSession?: boolean;
+    /**
+     * Pi model object — pass `getModel('provider', 'model')` from
+     * `@mariozechner/pi-ai`. When omitted, pi uses the default from
+     * settings.json.
+     */
+    model?: unknown;
+    /** Thinking level override. */
+    thinkingLevel?: 'low' | 'medium' | 'high';
+    /**
+     * Additional options forwarded to `createAgentSession`. Use this to
+     * pass tools, customTools, extensions, auth storage, etc.
+     */
+    sessionOptions?: Record<string, unknown>;
+    /**
+     * Pre-built pi session — bypasses `createAgentSession` entirely.
+     * Useful for tests and for callers managing the session lifecycle
+     * themselves. When provided, the adapter does NOT dispose the
+     * session at run end.
+     */
+    session?: AgentSession;
+    /** Optional structured-output spec (prompted path). */
+    outputSchema?: StructuredOutputConfig;
+}
+/** @internal */
+export declare const piAgent: AgentAdapterMeta<PiAgentConfig>;
+export {};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/pi/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/pi/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EASL,KAAK,gBAAgB,EAOrB,KAAK,sBAAsB,EAC5B,MAAM,wCAAwC,CAAC;AAOhD,KAAK,YAAY,GAAG,OAAO,CAAC;AAK5B,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,uDAAuD;IACvD,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACvC;AAED,gBAAgB;AAChB,eAAO,MAAM,OAAO,EAAE,gBAAgB,CAAC,aAAa,CASlD,CAAC"}