@relayflows/sdk 2.0.8 → 2.0.10

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-transport.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Agent-relay HTTP transport for f.agent step dispatch (flows#385).
+ *
+ * The SDK's default agent path is a direct `child_process.spawn(cli, ...)`
+ * in worker-cli.ts. That is unobservable — you cannot DM the spawned agent
+ * mid-flight, and every ecosystem tool that wants to steer or watch it
+ * ends up shelling out to the `agent-relay` CLI, which is fragile.
+ *
+ * This module speaks to agent-relay via structured HTTP: the same call
+ * shape the `mcp__agent-relay__spawn` MCP tool posts. The SDK becomes a
+ * first-class agent-relay participant, registered under a derived agent
+ * name a caller can DM against.
+ *
+ * Scope: spawn + close. Streaming inbox and observation are follow-ups.
+ */
+export type AgentTransport = 'direct' | 'relay';
+export interface AgentRelaySpawnRequest {
+    /** Registered agent name in the workspace. */
+    name: string;
+    /** CLI to launch. */
+    cli: 'claude' | 'codex' | 'gemini' | 'aider' | 'goose' | 'grok' | 'opencode';
+    /** Initial task instructions. */
+    task: string;
+    /** Optional model powering the worker. */
+    model?: string;
+    /** Optional working directory for the spawned worker process. */
+    worker_cwd?: string;
+    /** Optional target fleet node name. */
+    target_node?: string;
+    /** Declared objective for workforce reporting. */
+    objective?: string;
+    /** Declared role for workforce reporting. */
+    role?: string;
+    /** Declared project for workforce reporting. */
+    project?: string;
+    /** Declared workstream for workforce reporting. */
+    workstream?: string;
+}
+export interface AgentRelayEnv {
+    /** `RELAY_BASE_URL` env; defaults to https://cast.agentrelay.com. */
+    baseUrl?: string;
+    /** `RELAY_API_KEY` env (rk_live_...). Required. */
+    apiKey?: string;
+    /** `RELAY_DEFAULT_WORKSPACE` env; workspace scoping for the spawn. */
+    workspaceId?: string;
+    /** Optional bearer token for the individual agent identity, if pre-registered. */
+    agentToken?: string;
+}
+export interface AgentSpawnHandle {
+    /** Registered agent name in the workspace — DM this to steer. */
+    readonly registeredName: string;
+    /** Invocation id returned by relay; use for status polling. */
+    readonly invocationId: string;
+    /** Best-effort deregistration/notification. */
+    close(): Promise<void>;
+}
+export declare class AgentRelayTransportError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/**
+ * Read the same env the relay MCP already consumes. Explicit override wins.
+ * Missing RELAY_API_KEY refuses immediately — the transport cannot proceed
+ * unauthenticated and the direct-spawn fallback is a separate decision.
+ */
+export declare function readAgentRelayEnv(env?: NodeJS.ProcessEnv): Required<Pick<AgentRelayEnv, 'baseUrl' | 'apiKey'>> & AgentRelayEnv;
+/**
+ * Spawn a worker via agent-relay HTTP. The endpoint mirrors what the
+ * `mcp__agent-relay__spawn` MCP tool wraps — a POST that requests a fleet
+ * node dispatch. Returns a handle keyed on the registered agent name.
+ *
+ * The `fetch` argument is injected so tests can mock the transport without
+ * hitting the network.
+ */
+export declare function agentRelaySpawn(request: AgentRelaySpawnRequest, env?: AgentRelayEnv & {
+    fetch?: typeof fetch;
+}): Promise<AgentSpawnHandle>;
+/**
+ * Derive a workspace-unique agent name from a run identity + step id. The
+ * result is stable across replays of the same step so DMs can be addressed
+ * even during retries.
+ */
+export declare function deriveAgentName(runId: string, stepId: string): string;
+//# 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":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,GAAG,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IAC7E,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,wBAAyB,SAAQ,KAAK;aACJ,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,QAAQ,CAAC,CAAC,GAAG,aAAa,CAc3I;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,EAC/B,GAAG,GAAE,aAAa,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GACjD,OAAO,CAAC,gBAAgB,CAAC,CA2E3B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIrE"}

package/dist/agent-relay-transport.js

@@ -0,0 +1,134 @@
+/**
+ * Agent-relay HTTP transport for f.agent step dispatch (flows#385).
+ *
+ * The SDK's default agent path is a direct `child_process.spawn(cli, ...)`
+ * in worker-cli.ts. That is unobservable — you cannot DM the spawned agent
+ * mid-flight, and every ecosystem tool that wants to steer or watch it
+ * ends up shelling out to the `agent-relay` CLI, which is fragile.
+ *
+ * This module speaks to agent-relay via structured HTTP: the same call
+ * shape the `mcp__agent-relay__spawn` MCP tool posts. The SDK becomes a
+ * first-class agent-relay participant, registered under a derived agent
+ * name a caller can DM against.
+ *
+ * Scope: spawn + close. Streaming inbox and observation are follow-ups.
+ */
+export class AgentRelayTransportError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'AgentRelayTransportError';
+    }
+}
+/**
+ * Read the same env the relay MCP already consumes. Explicit override wins.
+ * Missing RELAY_API_KEY refuses immediately — the transport cannot proceed
+ * unauthenticated and the direct-spawn fallback is a separate decision.
+ */
+export function readAgentRelayEnv(env = process.env) {
+    const baseUrl = env['RELAY_BASE_URL']?.trim() || 'https://cast.agentrelay.com';
+    const apiKey = env['RELAY_API_KEY']?.trim();
+    if (!apiKey) {
+        throw new AgentRelayTransportError('agent-relay transport requires RELAY_API_KEY in the environment; falling back to direct transport is the caller\'s responsibility.');
+    }
+    return {
+        baseUrl,
+        apiKey,
+        workspaceId: env['RELAY_DEFAULT_WORKSPACE']?.trim() || undefined,
+        agentToken: env['RELAY_AGENT_TOKEN']?.trim() || undefined,
+    };
+}
+/**
+ * Spawn a worker via agent-relay HTTP. The endpoint mirrors what the
+ * `mcp__agent-relay__spawn` MCP tool wraps — a POST that requests a fleet
+ * node dispatch. Returns a handle keyed on the registered agent name.
+ *
+ * The `fetch` argument is injected so tests can mock the transport without
+ * hitting the network.
+ */
+export async function agentRelaySpawn(request, env = {}) {
+    // Only fall back to process.env if the caller didn't supply the required
+    // fields directly. Tests pass { apiKey, fetch } inline; they shouldn't need
+    // to also set RELAY_API_KEY in the runner env.
+    const fromEnv = env.apiKey
+        ? { baseUrl: env.baseUrl || 'https://cast.agentrelay.com' }
+        : readAgentRelayEnv();
+    const resolved = { ...fromEnv, ...env };
+    const url = new URL('/api/v1/agents/spawn', resolved.baseUrl).toString();
+    const doFetch = env.fetch ?? globalThis.fetch;
+    if (typeof doFetch !== 'function') {
+        throw new AgentRelayTransportError('global fetch is unavailable; provide { fetch } explicitly.');
+    }
+    const headers = {
+        'content-type': 'application/json',
+        'authorization': `Bearer ${resolved.apiKey}`,
+    };
+    if (resolved.workspaceId !== undefined)
+        headers['x-relay-workspace'] = resolved.workspaceId;
+    if (resolved.agentToken !== undefined)
+        headers['x-relay-agent-token'] = resolved.agentToken;
+    let response;
+    try {
+        response = await doFetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(request),
+        });
+    }
+    catch (cause) {
+        throw new AgentRelayTransportError(`agent-relay spawn network error at ${url}: ${cause.message ?? String(cause)}`, cause);
+    }
+    if (response.status < 200 || response.status >= 300) {
+        let body;
+        try {
+            body = (await response.text()).slice(0, 512);
+        }
+        catch {
+            body = '<no body>';
+        }
+        throw new AgentRelayTransportError(`agent-relay spawn refused with status ${response.status}: ${body}`);
+    }
+    let json;
+    try {
+        json = await response.json();
+    }
+    catch (cause) {
+        throw new AgentRelayTransportError('agent-relay spawn response was not JSON', cause);
+    }
+    const invocationId = json.invocation?.invocationId;
+    const registeredName = json.invocation?.input?.name ?? request.name;
+    if (typeof invocationId !== 'string' || invocationId.length === 0) {
+        throw new AgentRelayTransportError('agent-relay spawn response missing invocation.invocationId');
+    }
+    return {
+        registeredName,
+        invocationId,
+        async close() {
+            // Best-effort: post to /api/v1/invocations/<id>/close if defined server-side;
+            // no throw on error because the invocation may already be terminal.
+            const closeUrl = new URL(`/api/v1/invocations/${encodeURIComponent(invocationId)}/close`, resolved.baseUrl).toString();
+            try {
+                await doFetch(closeUrl, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify({ reason: 'sdk_transport_close' }),
+                });
+            }
+            catch {
+                // Deliberate: close is advisory in this minimum-viable slice.
+            }
+        },
+    };
+}
+/**
+ * Derive a workspace-unique agent name from a run identity + step id. The
+ * result is stable across replays of the same step so DMs can be addressed
+ * even during retries.
+ */
+export function deriveAgentName(runId, stepId) {
+    // Keep readable + collision-safe: prefix with 'flow-' and use lower-kebab.
+    const clean = (s) => s.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '');
+    return `flow-${clean(runId)}-${clean(stepId)}`.slice(0, 96);
+}
+//# sourceMappingURL=agent-relay-transport.js.map

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

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

package/dist/authored-budget.d.ts

@@ -0,0 +1,13 @@
+import type { JournalClient } from './journal-client.js';
+import type { RunOutcome } from './protocol.js';
+import type { KernelRunSpec } from './spec.js';
+/** Serialized admission for the internal authored runner's separate step runs. */
+export declare class AuthoredBudget {
+    private readonly limit;
+    private failed;
+    private tail;
+    private charges;
+    constructor(header: unknown);
+    execute<T>(journal: JournalClient, spec: KernelRunSpec, consume: (outcome: RunOutcome) => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=authored-budget.d.ts.map

package/dist/authored-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-budget.d.ts","sourceRoot":"","sources":["../src/authored-budget.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,WAAW,CAAC;AAEjE,kFAAkF;AAClF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAuC;IACnD,OAAO,CAAC,OAAO,CAAmF;gBAEtF,MAAM,EAAE,OAAO;IASrB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CA8CxH"}

package/dist/authored-budget.js

@@ -0,0 +1,78 @@
+import { BudgetSyntaxError, parseBudget, toKernelBudget } from './budget.js';
+import { AuthoredFlowExecutionError } from './authored-flow-error.js';
+/** Serialized admission for the internal authored runner's separate step runs. */
+export class AuthoredBudget {
+    limit;
+    failed = false;
+    tail = Promise.resolve();
+    charges = [];
+    constructor(header) {
+        try {
+            this.limit = header === undefined ? undefined : toKernelBudget(parseBudget(header));
+        }
+        catch (error) {
+            if (error instanceof BudgetSyntaxError)
+                throw new AuthoredFlowExecutionError('budget_syntax_invalid', error.message);
+            throw error;
+        }
+    }
+    async execute(journal, spec, consume) {
+        if (this.limit === undefined)
+            return consume(await journal.runStart(spec));
+        const previous = this.tail;
+        let release;
+        this.tail = new Promise(resolve => { release = resolve; });
+        await previous;
+        try {
+            if (this.failed)
+                throw new AuthoredFlowExecutionError('step_failed', 'A prior budgeted step did not finish successfully.');
+            // Window selection follows journal timestamps, never the SDK host clock.
+            const day = this.charges.at(-1)?.day;
+            const total = this.charges.filter(c => this.limit.window !== 'day' || c.day === day)
+                .reduce((s, c) => ({ input: s.input + c.input, output: s.output + c.output, micro: s.micro + c.micro, ms: s.ms + c.ms }), { input: 0n, output: 0n, micro: 0n, ms: 0n });
+            const exactNumber = (n) => { if (n > BigInt(Number.MAX_SAFE_INTEGER))
+                throw new Error('budget counter overflow'); return Number(n); };
+            const outcome = await journal.runStart({ ...spec, budget: { ...this.limit, prior_spend: {
+                        tokens_in: exactNumber(total.input), tokens_out: exactNumber(total.output),
+                        dollars: `${total.micro / 1000000n}.${String(total.micro % 1000000n).padStart(6, '0')}`,
+                        wallclock_ms: exactNumber(total.ms), ...(this.limit.window === 'day' && day !== undefined ? { day } : {}),
+                    } } });
+            try {
+                if (outcome.completion_reason === 'budget_exceeded')
+                    throw new AuthoredFlowExecutionError('step_failed', 'Flow budget exceeded before the next step.', 'budget_exceeded', outcome.run_id);
+                return await consume(outcome);
+            }
+            finally {
+                let seq = 1;
+                for (;;) {
+                    const { entries } = await journal.journalRead(outcome.run_id, seq);
+                    if (entries.length === 0)
+                        break;
+                    for (const raw of entries) {
+                        const e = raw;
+                        seq = e.seq + 1;
+                        if (!['step.completed', 'memory.injected'].includes(e.entry_type))
+                            continue;
+                        const b = e.payload.budget;
+                        if (b === undefined)
+                            throw new Error('journal completion missing budget');
+                        const [whole, fraction = ''] = b.dollars.split('.');
+                        if (fraction.length > 6 && /[1-9]/.test(fraction.slice(6)))
+                            throw new Error('budget accounting requires microdollar precision');
+                        this.charges.push({ input: BigInt(b.tokens_in), output: BigInt(b.tokens_out),
+                            micro: BigInt(whole) * 1000000n + BigInt(fraction.slice(0, 6).padEnd(6, '0')),
+                            ms: BigInt(e.payload.spend?.wallclock_ms ?? 0), day: Math.floor(e.at_ms / 86_400_000) });
+                    }
+                }
+            }
+        }
+        catch (error) {
+            this.failed = true;
+            throw error;
+        }
+        finally {
+            release();
+        }
+    }
+}
+//# sourceMappingURL=authored-budget.js.map