@autonome-research/thread-phase-agents 3.0.0

package/dist/thread-bridge.js

@@ -0,0 +1,143 @@
+/**
+ * Render a `Thread` into the input shape each adapter expects.
+ *
+ * Same-adapter handoff (claude-code → claude-code) uses the resume
+ * token; native fidelity. Cross-adapter handoff (claude-code →
+ * anthropic) loses the per-adapter native log and falls back to a
+ * text rendering of the canonical event stream.
+ *
+ * These helpers turn `thread.events` into the next adapter's input
+ * format. They're lossy by design — preserve the gist, not the
+ * adapter-specific structure. For tighter fidelity, pass the
+ * adapter's resume token via `injectResume.<adapter>` instead.
+ *
+ * @internal
+ */
+import { threadToMessages, } from '@autonome-research/thread-phase/agents';
+// ---------------------------------------------------------------------------
+// Internal: render a thread's events as a single text transcript
+// ---------------------------------------------------------------------------
+/**
+ * Produce a text transcript of the thread suitable for splicing into
+ * any adapter's prompt. Format is "[<source>] <text>" for assistant
+ * turns, "[<source>:tool] <name>(<input>)" for tool calls,
+ * "[<source>:result] <output>" for tool results. Skips native /
+ * thinking / lifecycle events.
+ *
+ * Output is bounded by the thread's content; very long threads
+ * produce very long transcripts — callers managing token budgets
+ * should pre-trim or summarize.
+ *
+ * @internal
+ */
+export function threadToTranscript(thread) {
+    const lines = [];
+    for (const event of thread.events) {
+        switch (event.type) {
+            case 'text': {
+                // Accumulate text per source — but for simplicity emit each delta
+                // as a separate line tagged with source. Lossy but unambiguous.
+                lines.push(`[${event.source}] ${event.delta}`);
+                break;
+            }
+            case 'tool_call': {
+                const inputStr = safeJson(event.input);
+                lines.push(`[${event.source}:tool_call ${event.name}] ${inputStr}`);
+                break;
+            }
+            case 'tool_result': {
+                const outputStr = typeof event.output === 'string' ? event.output : safeJson(event.output);
+                const prefix = event.isError ? 'tool_error' : 'tool_result';
+                lines.push(`[${event.source}:${prefix} ${event.name}] ${outputStr}`);
+                break;
+            }
+            case 'turn_end': {
+                // Assistant text from turn_end is redundant with prior text
+                // deltas — skip unless no text was streamed (turns-only adapters).
+                if (event.assistantText && event.toolCallCount === 0 && !lines.some((l) => l.startsWith(`[${event.source}] `))) {
+                    lines.push(`[${event.source}] ${event.assistantText}`);
+                }
+                break;
+            }
+            default:
+                // skip agent_start, agent_end, error, native, thinking
+                break;
+        }
+    }
+    return lines.join('\n');
+}
+function safeJson(value) {
+    if (value === undefined)
+        return 'undefined';
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+// ---------------------------------------------------------------------------
+// Per-adapter prompt-input renderers
+// ---------------------------------------------------------------------------
+/**
+ * Render a thread as a single ACP `ContentBlock[]` (one text block).
+ * Suitable for `acpAgent.adapter({ ..., prompt: threadToAcpPrompt(thread) })`
+ * when a downstream adapter call shouldn't try same-session resume.
+ *
+ * @internal
+ */
+export function threadToAcpPrompt(thread) {
+    const transcript = threadToTranscript(thread);
+    return [{ type: 'text', text: transcript }];
+}
+/**
+ * Render a thread as a plain string. Suitable for `claudeCodeAgent` or
+ * any adapter that takes a single user-prompt string.
+ *
+ * @internal
+ */
+export function threadToClaudeCodePrompt(thread) {
+    return threadToTranscript(thread);
+}
+/**
+ * Render a thread as a single text input for the OpenAI Responses API.
+ * The Responses API's `input` field accepts a string or an items array;
+ * we use the string form for cross-adapter handoff.
+ *
+ * @internal
+ */
+export function threadToCodexInput(thread) {
+    return threadToTranscript(thread);
+}
+/**
+ * Render a thread as Anthropic `MessageParam[]` — currently a single
+ * user message wrapping the transcript. Anthropic's role-based
+ * conversation structure doesn't round-trip from canonical events
+ * losslessly; for tighter fidelity, use Anthropic's own messages
+ * array directly rather than crossing adapter boundaries.
+ *
+ * The return type is intentionally typed loosely as `unknown[]` to
+ * avoid importing `@anthropic-ai/sdk` types from this module — the
+ * runtime shape matches `MessageParam[]` (role: 'user' | 'assistant',
+ * content: string), which is the broadly-compatible subset across
+ * Anthropic SDK versions.
+ *
+ * @internal
+ */
+export function threadToAnthropicMessages(thread) {
+    // For now: collapse to a single user message containing the
+    // transcript. Higher-fidelity conversion (turn-by-turn) is a
+    // follow-up.
+    const transcript = threadToTranscript(thread);
+    return [{ role: 'user', content: transcript }];
+}
+/**
+ * Render the thread's canonical event log to thread-phase's internal
+ * `Message[]` shape. Re-exports the upstream `threadToMessages` so
+ * sibling-package consumers can find all the bridge helpers in one
+ * place.
+ *
+ * @internal
+ */
+export { threadToMessages };
+//# sourceMappingURL=thread-bridge.js.map

package/dist/thread-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-bridge.js","sourceRoot":"","sources":["../src/thread-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,gBAAgB,GAEjB,MAAM,wCAAwC,CAAC;AAIhD,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,kEAAkE;gBAClE,gEAAgE;gBAChE,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC/C,MAAM;YACR,CAAC;YACD,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACvC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,cAAc,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC,CAAC;gBACpE,MAAM;YACR,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC3F,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;gBAC5D,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC,CAAC;gBACrE,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,4DAA4D;gBAC5D,mEAAmE;gBACnE,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;oBAC/G,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;gBACzD,CAAC;gBACD,MAAM;YACR,CAAC;YACD;gBACE,uDAAuD;gBACvD,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAc;IAEd,4DAA4D;IAC5D,6DAA6D;IAC7D,aAAa;IACb,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@autonome-research/thread-phase-agents",
+  "version": "3.0.0",
+  "description": "Agent adapters for thread-phase — wraps hermes, openclaw, anthropic, codex, claude-code, pi behind a uniform AgentAdapter protocol.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@autonome-research/thread-phase": "^3.0.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.96.0",
+    "@mariozechner/pi-coding-agent": "^0.73.1",
+    "openai": "^6.38.0"
+  },
+  "devDependencies": {
+    "@autonome-research/thread-phase": "*",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Code4me2/thread-phase.git",
+    "directory": "packages/thread-phase-agents"
+  }
+}