@relayflows/sdk 2.0.9 → 2.0.11

package/dist/adapters/base.d.ts

@@ -0,0 +1,46 @@
+/**
+ * First-class headless adapter contract (flows#141).
+ *
+ * Every supported agent CLI ships one implementation. `worker-cli.ts` and
+ * `cli/check.ts` dispatch through the registry in `./index.ts` — never string
+ * formatting against per-CLI knowledge inline. Adding a new CLI is one new
+ * file that implements this interface.
+ *
+ * Behavior-preserving migration: the exported functions in `cli-adapter.ts`
+ * (`agentExecution`, `llmExecution`, `authenticationProbe`,
+ * `modelReadinessProbe`, `adapterIdentification`) now delegate to the
+ * registered adapter for the resolved kind, so callers don't change.
+ */
+export interface CliInvocation {
+    args: string[];
+    timeoutMs: number;
+    /** Set only for wrapper readiness probes; raw providers receive a model flag. */
+    modelEnv?: string;
+}
+export interface CliAdapterIdentification {
+    invocation: CliInvocation;
+    expectedStdout?: string;
+}
+/**
+ * The declared, per-CLI headless contract. Members intentionally mirror the
+ * function-scoped predecessors in `cli-adapter.ts` so migration is mechanical.
+ */
+export interface HeadlessAdapter {
+    /** Identity of this adapter — matches CliAdapterKind for registry keys. */
+    readonly kind: string;
+    /** Shape-check invocation before classifying an auth failure. */
+    buildIdentification(): CliAdapterIdentification;
+    /** Non-interactive auth-status probe. */
+    buildAuthProbe(): CliInvocation;
+    /**
+     * Real, noninteractive model round-trip. Providers hand the model via a
+     * native flag; wrappers hand it via the explicitly identified environment
+     * contract on `modelEnv`.
+     */
+    buildModelReadinessProbe(model: string): CliInvocation;
+    /** Agent-step worker argv for an instruction under an optional model. */
+    buildAgentInvocation(instruction: string, model?: string): CliInvocation;
+    /** LLM-step worker argv for a prompt under an optional model. */
+    buildLlmInvocation(prompt: string, model?: string): CliInvocation;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,aAAa,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iEAAiE;IACjE,mBAAmB,IAAI,wBAAwB,CAAC;IAEhD,yCAAyC;IACzC,cAAc,IAAI,aAAa,CAAC;IAEhC;;;;OAIG;IACH,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC;IAEvD,yEAAyE;IACzE,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IAEzE,iEAAiE;IACjE,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;CACnE"}

package/dist/adapters/base.js

@@ -0,0 +1,15 @@
+/**
+ * First-class headless adapter contract (flows#141).
+ *
+ * Every supported agent CLI ships one implementation. `worker-cli.ts` and
+ * `cli/check.ts` dispatch through the registry in `./index.ts` — never string
+ * formatting against per-CLI knowledge inline. Adding a new CLI is one new
+ * file that implements this interface.
+ *
+ * Behavior-preserving migration: the exported functions in `cli-adapter.ts`
+ * (`agentExecution`, `llmExecution`, `authenticationProbe`,
+ * `modelReadinessProbe`, `adapterIdentification`) now delegate to the
+ * registered adapter for the resolved kind, so callers don't change.
+ */
+export {};
+//# sourceMappingURL=base.js.map

package/dist/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/adapters/claude.d.ts

@@ -0,0 +1,5 @@
+import type { HeadlessAdapter } from './base.js';
+/** Claude Code CLI headless contract. Wire and behavior identical to the
+ *  pre-#141 inline shape in `cli-adapter.ts` — only the packaging changed. */
+export declare const claudeAdapter: HeadlessAdapter;
+//# sourceMappingURL=claude.d.ts.map

package/dist/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,WAAW,CAAC;AAInB;8EAC8E;AAC9E,eAAO,MAAM,aAAa,EAAE,eA4C3B,CAAC"}

package/dist/adapters/claude.js

@@ -0,0 +1,44 @@
+const MODEL_PROBE_PROMPT = 'Reply with exactly RELAYFLOWS_MODEL_READY and nothing else.';
+/** Claude Code CLI headless contract. Wire and behavior identical to the
+ *  pre-#141 inline shape in `cli-adapter.ts` — only the packaging changed. */
+export const claudeAdapter = {
+    kind: 'claude',
+    buildIdentification() {
+        return { invocation: { args: ['auth', 'status', '--help'], timeoutMs: 10_000 } };
+    },
+    buildAuthProbe() {
+        return { args: ['auth', 'status'], timeoutMs: 10_000 };
+    },
+    buildModelReadinessProbe(model) {
+        return {
+            args: [
+                '-p', '--model', model, '--tools', '', '--no-session-persistence',
+                MODEL_PROBE_PROMPT,
+            ],
+            timeoutMs: 60_000,
+        };
+    },
+    buildAgentInvocation(instruction, model) {
+        return {
+            args: [
+                '-p',
+                // Symmetric to codex's --dangerously-bypass-approvals-and-sandbox: in
+                // agent mode the flow explicitly delegates writes. Without this
+                // claude's headless mode prompts for tool approval, gets no TTY,
+                // and completes "successfully" without touching files.
+                '--dangerously-skip-permissions',
+                ...(model === undefined ? [] : ['--model', model]),
+                instruction,
+            ],
+            timeoutMs: 0,
+        };
+    },
+    buildLlmInvocation(prompt, model) {
+        return {
+            args: ['-p', '--tools', '', '--no-session-persistence',
+                ...(model === undefined ? [] : ['--model', model]), prompt],
+            timeoutMs: 0,
+        };
+    },
+};
+//# sourceMappingURL=claude.js.map

package/dist/adapters/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAMA,MAAM,kBAAkB,GAAG,6DAA6D,CAAC;AAEzF;8EAC8E;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC5C,IAAI,EAAE,QAAQ;IAEd,mBAAmB;QACjB,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACnF,CAAC;IAED,cAAc;QACZ,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACzD,CAAC;IAED,wBAAwB,CAAC,KAAa;QACpC,OAAO;YACL,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,0BAA0B;gBACjE,kBAAkB;aACnB;YACD,SAAS,EAAE,MAAM;SAClB,CAAC;IACJ,CAAC;IAED,oBAAoB,CAAC,WAAmB,EAAE,KAAc;QACtD,OAAO;YACL,IAAI,EAAE;gBACJ,IAAI;gBACJ,sEAAsE;gBACtE,gEAAgE;gBAChE,iEAAiE;gBACjE,uDAAuD;gBACvD,gCAAgC;gBAChC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAClD,WAAW;aACZ;YACD,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,MAAc,EAAE,KAAc;QAC/C,OAAO;YACL,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,0BAA0B;gBACpD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;YAC7D,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/adapters/codex.d.ts

@@ -0,0 +1,5 @@
+import type { HeadlessAdapter } from './base.js';
+/** OpenAI Codex CLI headless contract. Behavior identical to the pre-#141
+ *  inline shape in `cli-adapter.ts` — only the packaging changed. */
+export declare const codexAdapter: HeadlessAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,WAAW,CAAC;AAInB;qEACqE;AACrE,eAAO,MAAM,YAAY,EAAE,eA6C1B,CAAC"}

package/dist/adapters/codex.js

@@ -0,0 +1,45 @@
+const MODEL_PROBE_PROMPT = 'Reply with exactly RELAYFLOWS_MODEL_READY and nothing else.';
+/** OpenAI Codex CLI headless contract. Behavior identical to the pre-#141
+ *  inline shape in `cli-adapter.ts` — only the packaging changed. */
+export const codexAdapter = {
+    kind: 'codex',
+    buildIdentification() {
+        return { invocation: { args: ['login', 'status', '--help'], timeoutMs: 10_000 } };
+    },
+    buildAuthProbe() {
+        return { args: ['login', 'status'], timeoutMs: 10_000 };
+    },
+    buildModelReadinessProbe(model) {
+        return {
+            args: [
+                'exec', '--ephemeral', '--sandbox', 'read-only', '--skip-git-repo-check',
+                '--model', model, MODEL_PROBE_PROMPT,
+            ],
+            timeoutMs: 60_000,
+        };
+    },
+    buildAgentInvocation(instruction, model) {
+        return {
+            args: [
+                'exec', '--ephemeral', '--skip-git-repo-check',
+                // Agent-mode is where the flow explicitly delegates code changes to
+                // the CLI. Without this flag codex prompts for approval on every
+                // write, gets nothing (no TTY), and completes "successfully" without
+                // touching files — the dogfood no-op failure mode. LLM-mode stays
+                // read-only and does NOT get the bypass.
+                '--dangerously-bypass-approvals-and-sandbox',
+                ...(model === undefined ? [] : ['--model', model]),
+                instruction,
+            ],
+            timeoutMs: 0,
+        };
+    },
+    buildLlmInvocation(prompt, model) {
+        return {
+            args: ['exec', '--ephemeral', '--sandbox', 'read-only', '--skip-git-repo-check',
+                ...(model === undefined ? [] : ['--model', model]), prompt],
+            timeoutMs: 0,
+        };
+    },
+};
+//# sourceMappingURL=codex.js.map

package/dist/adapters/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAMA,MAAM,kBAAkB,GAAG,6DAA6D,CAAC;AAEzF;qEACqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,IAAI,EAAE,OAAO;IAEb,mBAAmB;QACjB,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACpF,CAAC;IAED,cAAc;QACZ,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC1D,CAAC;IAED,wBAAwB,CAAC,KAAa;QACpC,OAAO;YACL,IAAI,EAAE;gBACJ,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,uBAAuB;gBACxE,SAAS,EAAE,KAAK,EAAE,kBAAkB;aACrC;YACD,SAAS,EAAE,MAAM;SAClB,CAAC;IACJ,CAAC;IAED,oBAAoB,CAAC,WAAmB,EAAE,KAAc;QACtD,OAAO;YACL,IAAI,EAAE;gBACJ,MAAM,EAAE,aAAa,EAAE,uBAAuB;gBAC9C,oEAAoE;gBACpE,iEAAiE;gBACjE,qEAAqE;gBACrE,kEAAkE;gBAClE,yCAAyC;gBACzC,4CAA4C;gBAC5C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAClD,WAAW;aACZ;YACD,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,MAAc,EAAE,KAAc;QAC/C,OAAO;YACL,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,uBAAuB;gBAC7E,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;YAC7D,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,14 @@
+import { claudeAdapter } from './claude.js';
+import { codexAdapter } from './codex.js';
+import { wrapperAdapter } from './wrapper.js';
+import type { HeadlessAdapter } from './base.js';
+export type CliAdapterKind = 'claude' | 'codex' | 'relayflows-wrapper-v1';
+/** Select the adapter for the resolved executable basename. */
+export declare function resolveAdapter(executable: string): HeadlessAdapter;
+/** Backward-compatible kind lookup for callers still speaking string-tag lang. */
+export declare function resolveAdapterKind(executable: string): CliAdapterKind;
+/** Registered adapters by kind (read-only view for tests and diagnostics). */
+export declare function registeredAdapters(): Readonly<Record<CliAdapterKind, HeadlessAdapter>>;
+export { claudeAdapter, codexAdapter, wrapperAdapter };
+export type { HeadlessAdapter, CliInvocation, CliAdapterIdentification } from './base.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,GAAG,uBAAuB,CAAC;AAS1E,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAKlE;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAErE;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,IAAI,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAEtF;AAED,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,29 @@
+import { basename } from 'node:path';
+import { claudeAdapter } from './claude.js';
+import { codexAdapter } from './codex.js';
+import { wrapperAdapter } from './wrapper.js';
+/** The registered adapter set. Adding a CLI is adding one file + one entry. */
+const ADAPTERS = {
+    claude: claudeAdapter,
+    codex: codexAdapter,
+    'relayflows-wrapper-v1': wrapperAdapter,
+};
+/** Select the adapter for the resolved executable basename. */
+export function resolveAdapter(executable) {
+    const name = basename(executable).replace(/\.exe$/i, '');
+    if (name === 'claude')
+        return ADAPTERS.claude;
+    if (name === 'codex')
+        return ADAPTERS.codex;
+    return ADAPTERS['relayflows-wrapper-v1'];
+}
+/** Backward-compatible kind lookup for callers still speaking string-tag lang. */
+export function resolveAdapterKind(executable) {
+    return resolveAdapter(executable).kind;
+}
+/** Registered adapters by kind (read-only view for tests and diagnostics). */
+export function registeredAdapters() {
+    return ADAPTERS;
+}
+export { claudeAdapter, codexAdapter, wrapperAdapter };
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAK9C,+EAA+E;AAC/E,MAAM,QAAQ,GAA4C;IACxD,MAAM,EAAE,aAAa;IACrB,KAAK,EAAE,YAAY;IACnB,uBAAuB,EAAE,cAAc;CACxC,CAAC;AAEF,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACzD,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC;IAC9C,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC;IAC5C,OAAO,QAAQ,CAAC,uBAAuB,CAAC,CAAC;AAC3C,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC,IAAsB,CAAC;AAC3D,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB;IAChC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/adapters/wrapper.d.ts

@@ -0,0 +1,12 @@
+import type { HeadlessAdapter } from './base.js';
+/**
+ * `relayflows-adapter-v1` identifies a per-flow wrapper script — the pre-#141
+ * per-flow shim shape. The wrapper answers a probe with a known token; agent
+ * and llm execution flow through `runWrapperSession`, so this adapter refuses
+ * to construct a direct-argv invocation for them.
+ */
+export declare const WRAPPER_IDENTIFY_ARG = "--relayflows-adapter-v1";
+export declare const WRAPPER_IDENTIFY_TOKEN = "relayflows-agent-cli-v1";
+export declare const WRAPPER_EXECUTE_TOKEN = "relayflows-agent-cli-v1-execute";
+export declare const wrapperAdapter: HeadlessAdapter;
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/adapters/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../src/adapters/wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,WAAW,CAAC;AAEnB;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,4BAA4B,CAAC;AAC9D,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAChE,eAAO,MAAM,qBAAqB,oCAAoC,CAAC;AAEvE,eAAO,MAAM,cAAc,EAAE,eAyB5B,CAAC"}

package/dist/adapters/wrapper.js

@@ -0,0 +1,31 @@
+/**
+ * `relayflows-adapter-v1` identifies a per-flow wrapper script — the pre-#141
+ * per-flow shim shape. The wrapper answers a probe with a known token; agent
+ * and llm execution flow through `runWrapperSession`, so this adapter refuses
+ * to construct a direct-argv invocation for them.
+ */
+export const WRAPPER_IDENTIFY_ARG = '--relayflows-adapter-v1';
+export const WRAPPER_IDENTIFY_TOKEN = 'relayflows-agent-cli-v1';
+export const WRAPPER_EXECUTE_TOKEN = 'relayflows-agent-cli-v1-execute';
+export const wrapperAdapter = {
+    kind: 'relayflows-wrapper-v1',
+    buildIdentification() {
+        return {
+            invocation: { args: [WRAPPER_IDENTIFY_ARG], timeoutMs: 10_000 },
+            expectedStdout: WRAPPER_IDENTIFY_TOKEN,
+        };
+    },
+    buildAuthProbe() {
+        return { args: ['auth', 'status'], timeoutMs: 10_000 };
+    },
+    buildModelReadinessProbe(model) {
+        return { args: ['auth', 'status'], timeoutMs: 60_000, modelEnv: model };
+    },
+    buildAgentInvocation() {
+        throw new Error('custom wrapper execution requires the runAgentCli same-process session');
+    },
+    buildLlmInvocation() {
+        throw new Error('custom wrapper execution requires the same-process session');
+    },
+};
+//# sourceMappingURL=wrapper.js.map

package/dist/adapters/wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.js","sourceRoot":"","sources":["../../src/adapters/wrapper.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,yBAAyB,CAAC;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAG,iCAAiC,CAAC;AAEvE,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,IAAI,EAAE,uBAAuB;IAE7B,mBAAmB;QACjB,OAAO;YACL,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,oBAAoB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE;YAC/D,cAAc,EAAE,sBAAsB;SACvC,CAAC;IACJ,CAAC;IAED,cAAc;QACZ,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACzD,CAAC;IAED,wBAAwB,CAAC,KAAa;QACpC,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC1E,CAAC;IAED,oBAAoB;QAClB,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IAED,kBAAkB;QAChB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;CACF,CAAC"}

package/dist/agent-relay-receipt.d.ts

@@ -0,0 +1,24 @@
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+export declare const nonempty: (value: unknown) => value is string;
+export interface RelayTaskExecution {
+    execution_id: string;
+    run_id: string;
+    step_id: string;
+    dispatch_id: string;
+    deadline: string;
+    worker_generation?: string;
+    accepted_at?: string;
+    accounting?: Record<string, number>;
+}
+export interface RelayTaskReceipt {
+    invocation_id: string;
+    action_name: "task.run";
+    status: "pending" | "dispatched" | "running" | "completed" | "failed";
+    task_execution: RelayTaskExecution;
+    output: unknown;
+    error: string | null;
+    completed_at: string | null;
+}
+/** GET is authoritative. A spawn/POST acknowledgment is never a task result. */
+export declare function readTaskReceipt(value: unknown, invocationId: string, input: Record<string, unknown>, previous?: RelayTaskReceipt): RelayTaskReceipt;
+//# sourceMappingURL=agent-relay-receipt.d.ts.map

package/dist/agent-relay-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-relay-receipt.d.ts","sourceRoot":"","sources":["../src/agent-relay-receipt.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACH,CAAC;AACvE,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACJ,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AACD,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,UAAU,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtE,cAAc,EAAE,kBAAkB,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,gBAAgB,CAsFlB"}

package/dist/agent-relay-receipt.js

@@ -0,0 +1,66 @@
+import { canonicalize } from "./canonical.js";
+export const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+export const nonempty = (value) => typeof value === "string" && value.length > 0;
+/** GET is authoritative. A spawn/POST acknowledgment is never a task result. */
+export function readTaskReceipt(value, invocationId, input, previous) {
+    const context = input.task_context;
+    if (!isRecord(value) ||
+        value.invocation_id !== invocationId ||
+        value.action_name !== "task.run" ||
+        canonicalize(value.input) !== canonicalize(input) ||
+        !isRecord(value.task_execution)) {
+        throw new Error("Relay task receipt has mismatched invocation or input");
+    }
+    const execution = value.task_execution;
+    const validDate = (date) => nonempty(date) && Number.isFinite(Date.parse(date));
+    if (!nonempty(execution.execution_id) ||
+        !validDate(execution.deadline) ||
+        ["run_id", "step_id", "dispatch_id"].some((key) => execution[key] !== context[key]) ||
+        !["pending", "dispatched", "running", "completed", "failed"].includes(String(value.status))) {
+        throw new Error("Relay task receipt has invalid execution correlation");
+    }
+    const accepted = nonempty(execution.worker_generation) && validDate(execution.accepted_at);
+    if ((value.status === "running" || value.status === "completed") &&
+        !accepted) {
+        throw new Error("Relay task receipt is missing durable acceptance");
+    }
+    if ((execution.worker_generation !== undefined ||
+        execution.accepted_at !== undefined) &&
+        !accepted) {
+        throw new Error("Relay task receipt has incomplete durable acceptance");
+    }
+    if (previous !== undefined &&
+        (previous.task_execution.execution_id !== execution.execution_id ||
+            previous.task_execution.deadline !== execution.deadline ||
+            (previous.task_execution.worker_generation !== undefined &&
+                (previous.task_execution.worker_generation !==
+                    execution.worker_generation ||
+                    previous.task_execution.accepted_at !== execution.accepted_at)))) {
+        throw new Error("Relay task receipt changed its execution, accepted generation/time, or deadline");
+    }
+    if (execution.accounting !== undefined &&
+        (!isRecord(execution.accounting) ||
+            Object.values(execution.accounting).some((n) => typeof n !== "number" || !Number.isFinite(n) || n < 0))) {
+        throw new Error("Relay task receipt has invalid accounting");
+    }
+    if (value.status === "completed" &&
+        (!Object.hasOwn(value, "output") ||
+            value.error !== null ||
+            !validDate(value.completed_at))) {
+        throw new Error("Relay task receipt has no authoritative final output");
+    }
+    if (value.status === "failed" &&
+        (!nonempty(value.error) || !validDate(value.completed_at))) {
+        throw new Error("Relay task failure receipt has no reason");
+    }
+    return {
+        invocation_id: invocationId,
+        action_name: "task.run",
+        status: value.status,
+        task_execution: execution,
+        output: value.output,
+        error: value.error,
+        completed_at: value.completed_at,
+    };
+}
+//# sourceMappingURL=agent-relay-receipt.js.map

package/dist/agent-relay-receipt.js.map

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

package/dist/agent-relay-state.d.ts

@@ -0,0 +1,18 @@
+export interface RelayTaskClaim {
+    version: 1;
+    baseUrl: string;
+    callerId: string;
+    workspaceId: string;
+    invocationId: string;
+    runId: string;
+    stepId: string;
+    idempotencyKey: string;
+    input: Record<string, unknown>;
+    startedAt: number;
+}
+/** Exclusive creation pins the request before POST; no last-writer overwrite. */
+export declare function claimRelayTask(dataDir: string, claim: RelayTaskClaim): Promise<{
+    claim: RelayTaskClaim;
+    created: boolean;
+}>;
+//# sourceMappingURL=agent-relay-state.d.ts.map

package/dist/agent-relay-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-relay-state.d.ts","sourceRoot":"","sources":["../src/agent-relay-state.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iFAAiF;AACjF,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAkDtD"}

package/dist/agent-relay-state.js

@@ -0,0 +1,58 @@
+import { createHash } from "node:crypto";
+import { mkdir, open, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { canonicalize } from "./canonical.js";
+/** Exclusive creation pins the request before POST; no last-writer overwrite. */
+export async function claimRelayTask(dataDir, claim) {
+    const directory = join(dataDir, "relay-tasks");
+    await mkdir(directory, { recursive: true });
+    const parent = await open(dataDir, "r");
+    try {
+        await parent.sync();
+    }
+    finally {
+        await parent.close();
+    }
+    const digest = createHash("sha256")
+        .update(canonicalize([claim.runId, claim.stepId, claim.idempotencyKey]))
+        .digest("hex");
+    const path = join(directory, `${digest}.json`);
+    let file;
+    try {
+        file = await open(path, "wx", 0o600);
+    }
+    catch (error) {
+        if (error.code !== "EEXIST")
+            throw error;
+        const prior = JSON.parse(await readFile(path, "utf8"));
+        if (typeof prior !== "object" ||
+            prior === null ||
+            !("startedAt" in prior) ||
+            typeof prior.startedAt !== "number" ||
+            !Number.isSafeInteger(prior.startedAt) ||
+            prior.startedAt < 0 ||
+            canonicalize(prior) !==
+                canonicalize({ ...claim, startedAt: prior.startedAt })) {
+            throw new Error("Relay task dispatch conflicts with its durable caller, endpoint, or input");
+        }
+        return { claim: prior, created: false };
+    }
+    // A crash during creation leaves a partial claim that fails closed on read.
+    // Never remove an uncertain claim and retry under a different identity.
+    try {
+        await file.writeFile(canonicalize(claim));
+        await file.sync();
+    }
+    finally {
+        await file.close();
+    }
+    const dir = await open(directory, "r");
+    try {
+        await dir.sync();
+    }
+    finally {
+        await dir.close();
+    }
+    return { claim, created: true };
+}
+//# sourceMappingURL=agent-relay-state.js.map

package/dist/agent-relay-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-relay-state.js","sourceRoot":"","sources":["../src/agent-relay-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAe9C,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,KAAqB;IAErB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC;SAChC,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;SACvE,MAAM,CAAC,KAAK,CAAC,CAAC;IACjB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;QACpE,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAChE,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC;YACvB,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;YACnC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC;YACtC,KAAK,CAAC,SAAS,GAAG,CAAC;YACnB,YAAY,CAAC,KAAK,CAAC;gBACjB,YAAY,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,EACxD,CAAC;YACD,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAuB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC;IACD,4EAA4E;IAC5E,wEAAwE;IACxE,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1C,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/agent-relay-transport.d.ts

@@ -0,0 +1,31 @@
+import { type RelayTaskReceipt } from "./agent-relay-receipt.js";
+export type AgentTransport = "direct" | "relay";
+export interface AgentRelayTaskRequest {
+    cli: string;
+    task: string;
+    model?: string;
+    worker_cwd?: string;
+    result_schema?: unknown;
+    runId: string;
+    stepId: string;
+    idempotencyKey: string;
+    dataDir: string;
+    /** Engine task contract ceiling; bounded independently of the renewing lease. */
+    timeoutMs?: number;
+}
+export interface AgentRelayEnv {
+    baseUrl?: string;
+    agentToken?: string;
+}
+export declare class AgentRelayTransportError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare function readAgentRelayEnv(env?: NodeJS.ProcessEnv): Required<AgentRelayEnv>;
+/** Exact Relaycast #436 HTTP contract. Only terminal GET receipts can return. */
+export declare function runAgentRelayTask(request: AgentRelayTaskRequest, options?: AgentRelayEnv & {
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+    pollMs?: number;
+}): Promise<RelayTaskReceipt>;
+//# sourceMappingURL=agent-relay-transport.d.ts.map

package/dist/agent-relay-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-relay-transport.d.ts","sourceRoot":"","sources":["../src/agent-relay-transport.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAChD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,qBAAa,wBAAyB,SAAQ,KAAK;aAG/B,KAAK,CAAC,EAAE,OAAO;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AACD,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,QAAQ,CAAC,aAAa,CAAC,CAUzB;AAED,iFAAiF;AACjF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,GAAE,aAAa,GAAG;IACvB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GACL,OAAO,CAAC,gBAAgB,CAAC,CAmN3B"}