@relayflows/sdk 2.0.9 → 2.0.10

package/dist/authored-mcp.js

@@ -0,0 +1,171 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { compileSpec, toKernelSpec } from './compile.js';
+import { snapshotJsonValue } from './json-value.js';
+import { McpError, openMcpSession } from './mcp-client.js';
+import { SPEC_SCHEMA_VERSION } from './spec.js';
+import { AuthoredFlowExecutionError } from './authored-flow-error.js';
+import { readCompletedStepOutput } from './authored-step-output.js';
+import { withWorkerLease } from './worker-lease.js';
+/** Own keys expose precisely the preflight inventory, including prototype-like names. */
+export function buildMcpProxy(inventory, invoke) {
+    const servers = Object.create(null);
+    for (const [server, names] of Object.entries(inventory)) {
+        const tools = Object.create(null);
+        const call = (tool, known) => (args) => invoke(server, tool, snapshotJsonValue(args, `f.mcp.${server}.${tool} arguments`), known);
+        for (const tool of names)
+            tools[tool] = call(tool, true);
+        servers[server] = new Proxy(Object.freeze(tools), {
+            get(target, key) {
+                if (typeof key !== 'string')
+                    return undefined;
+                if (Object.hasOwn(target, key))
+                    return target[key];
+                // Calling a tool outside the inventory still creates an operation,
+                // so worker_error is journaled like other runtime failures.
+                return call(key, false);
+            },
+        });
+    }
+    return Object.freeze(servers);
+}
+export class McpStepError extends AuthoredFlowExecutionError {
+    diagnostic;
+    constructor(diagnostic, runId) {
+        super('step_failed', diagnostic, 'worker_error', runId);
+        this.diagnostic = diagnostic;
+    }
+}
+/** Helpers lower to an existing agent effect, never a fourth kernel primitive.
+ * The MCP receipt lives in step.completed.output: { type, input, output, ... }.
+ * A private stream routes the step to this short-lived SDK worker exclusively.
+ */
+export async function runMcpEffect(journal, flowName, id, server, tool, args, known, config, journalSteps) {
+    const idempotencyKey = `mcp:${server}:${tool}:${createHash('sha256').update(JSON.stringify(args)).digest('hex')}`;
+    const surfacePath = `/mcp/${pathPart(server)}/${pathPart(tool)}`;
+    const stream = `mcp-worker-${randomUUID()}`;
+    const instruction = JSON.stringify({ type: 'mcp', server, tool, input: args });
+    const peer = journal.createPeer();
+    let diagnostic;
+    let settled;
+    let failed;
+    const completed = new Promise((resolve, reject) => { settled = resolve; failed = reject; });
+    void completed.catch(() => undefined);
+    let timer;
+    let work;
+    let dispatchExpired = false;
+    const dispatch = (event) => {
+        if (dispatchExpired)
+            return;
+        const dispatched = event.spec;
+        if (event.step_id !== id || event.step_type !== 'agent' || work !== undefined
+            || dispatched?.instruction !== instruction
+            || !dispatched.surfaces?.streams?.some(pin => pin.stream === stream)) {
+            failed(new Error('MCP worker received an unexpected dispatch'));
+            return;
+        }
+        clearTimeout(timer);
+        timer = undefined;
+        work = execute(event);
+        void work.then(settled, failed);
+    };
+    async function execute(event) {
+        const receipt = { type: 'mcp', server, tool, input: args, idempotencyKey };
+        let output;
+        let confirmed = false;
+        try {
+            if (!known)
+                throw new Error('mcp_unknown_tool');
+            // Renew the worker lease while the MCP tool is in flight. Without this,
+            // a tool that runs longer than the initial lease loses ownership and
+            // the write-back path fails — see worker-lease.ts for the renewal contract.
+            confirmed = await withWorkerLease(peer, event, async () => {
+                return peer.performEffect({
+                    runId: event.run_id, stepId: id, attempt: event.attempt, idempotencyKey: event.idempotency_key,
+                    surfacePath, revisionBefore: 'pending', revisionAfter: idempotencyKey,
+                }, async () => {
+                    const session = await openMcpSession(config, 10_000);
+                    try {
+                        output = await session.callTool(tool, args);
+                        if (typeof output === 'object' && output !== null && 'isError' in output && output.isError === true) {
+                            throw new Error('mcp_tool_error');
+                        }
+                    }
+                    finally {
+                        await session.close();
+                    }
+                });
+            });
+            // A confirmed election without its receipt is an interrupted writeback,
+            // not a successful result we may invent or a call we may safely repeat.
+            if (!confirmed)
+                throw new Error('mcp_result_unavailable');
+        }
+        catch (error) {
+            if (error instanceof McpError)
+                diagnostic = error.code;
+            else if (error instanceof Error && ['mcp_unknown_tool', 'mcp_tool_error', 'mcp_result_unavailable'].includes(error.message))
+                diagnostic = error.message;
+            else
+                throw error; // Journal failures remain fail-closed, never provider errors.
+        }
+        await peer.stepComplete(event.run_id, id, event.attempt, event.idempotency_key, diagnostic === undefined ? 'success' : 'worker_error', {
+            output: { ...receipt, output: output ?? null, ...(diagnostic ? { diagnostic } : {}) },
+            started_pins: event.pins, end_pins: event.pins,
+            ...(diagnostic ? { trajectory_tail: { ...receipt, diagnostic } } : {}),
+            effects: confirmed ? [{ surface_path: surfacePath, idempotency_key: event.idempotency_key }] : [],
+        });
+    }
+    let childRunId;
+    try {
+        await peer.connect();
+        await peer.hello('flows-mcp');
+        peer.on('step.dispatch', dispatch);
+        await peer.workerAttach(stream, ['agent'], { workspace: [], streams: [{ stream, read_offset: 0 }] }, 1);
+        const spec = toKernelSpec(compileSpec({ version: SPEC_SCHEMA_VERSION, name: `${flowName}/${id}`,
+            steps: [{ id, type: 'agent', instruction,
+                    surfaces: { streams: [{ stream }], external: [surfacePath] }, maxIterations: 1 }],
+        }));
+        timer = setTimeout(() => {
+            dispatchExpired = true;
+            failed(new Error('MCP worker dispatch deadline exceeded'));
+        }, 30_000);
+        // Propagate a dispatch failure even if run.start itself is still pending.
+        const starting = journal.runStart(spec);
+        await Promise.race([starting, completed]);
+        const outcome = await starting;
+        childRunId = outcome.run_id;
+        await completed;
+        if (diagnostic !== undefined) {
+            try {
+                await readCompletedStepOutput(journal, outcome.run_id, id, journalSteps);
+            }
+            catch (error) {
+                if (!(error instanceof AuthoredFlowExecutionError) || error.code !== 'step_failed')
+                    throw error;
+                throw new McpStepError(diagnostic, outcome.run_id);
+            }
+        }
+        const receipt = await readCompletedStepOutput(journal, outcome.run_id, id, journalSteps);
+        return receipt.output;
+    }
+    finally {
+        clearTimeout(timer);
+        peer.off('step.dispatch', dispatch);
+        // If the dispatch deadline fired we started a child run that will never
+        // be worked -- cancel it so its journal doesn't stay indeterminate.
+        // Best-effort: the parent flow already surfaced the deadline via the
+        // rejected `completed` promise, so a cancel error here must not mask it.
+        if (dispatchExpired && childRunId !== undefined) {
+            try {
+                await journal.runCancel(childRunId);
+            }
+            catch { /* fail-open on cleanup */ }
+        }
+        peer.close();
+        await work?.catch(() => undefined);
+    }
+}
+function pathPart(value) {
+    return encodeURIComponent(value).replaceAll('.', '%2E');
+}
+//# sourceMappingURL=authored-mcp.js.map

package/dist/authored-mcp.js.map

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

package/dist/authored-memory.d.ts

@@ -0,0 +1,7 @@
+import type { MemoryHelper } from '@relayflows/surface';
+/** Stable across runs; disjoint from other flow files and other named flows. */
+export declare function scriptMemoryScope(flowPath: string, name: string): string;
+export declare function probeScriptMemory(): Promise<void>;
+export declare function assertMemoryReachable(): Promise<void>;
+export declare function authoredMemory(scope: string, assertOpen: () => void, enabled: boolean): MemoryHelper;
+//# sourceMappingURL=authored-memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authored-memory.d.ts","sourceRoot":"","sources":["../src/authored-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQxD,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOvD;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3D;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,IAAI,EACtB,OAAO,EAAE,OAAO,GACf,YAAY,CAqBd"}

package/dist/authored-memory.js

@@ -0,0 +1,60 @@
+import { createHash } from 'node:crypto';
+import { access, stat } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { AuthoredFlowExecutionError } from './authored-flow-error.js';
+import { preflightMemory } from './preflight.js';
+/** Stable across runs; disjoint from other flow files and other named flows. */
+export function scriptMemoryScope(flowPath, name) {
+    const absolute = resolve(flowPath);
+    const key = createHash('sha256').update(JSON.stringify([absolute, name])).digest('hex');
+    return join(dirname(absolute), '.relayflows', 'memory', 'scripts', key);
+}
+export async function probeScriptMemory() {
+    const { defaultDbPath, openAiHist } = await import('ai-hist');
+    const path = defaultDbPath();
+    await access(path, constants.R_OK);
+    if (!(await stat(path)).isFile())
+        throw new Error('memory database must be a file');
+    const reader = await openAiHist({ dbPath: path, fallback: 'error' });
+    try {
+        reader.search('', { limit: 1 });
+    }
+    finally {
+        reader.close();
+    }
+}
+export async function assertMemoryReachable() {
+    const refusal = await preflightMemory(probeScriptMemory);
+    if (refusal)
+        throw new AuthoredFlowExecutionError('memory_unreachable', refusal.message);
+}
+export function authoredMemory(scope, assertOpen, enabled) {
+    async function read(action) {
+        assertOpen();
+        if (!enabled)
+            throw new AuthoredFlowExecutionError('unsupported_header', 'f.memory requires script memory; memory.script is false');
+        await assertMemoryReachable();
+        assertOpen();
+        const { openAiHist } = await import('ai-hist');
+        const reader = await openAiHist({ projectScope: scope, fallback: 'error' });
+        try {
+            return action(reader);
+        }
+        finally {
+            reader.close();
+        }
+    }
+    return {
+        recall: (query, options) => read(reader => reader.search(query, { ...options, project: scope })),
+        why: task => read(reader => {
+            const entry = reader.whyForTask(task);
+            return entry?.projectId === scope ? [entry] : [];
+        }),
+        async learn() {
+            assertOpen();
+            throw new AuthoredFlowExecutionError('unsupported_verb', 'f.memory.learn requires the follow-up journal-backed trajectory writer');
+        },
+    };
+}
+//# sourceMappingURL=authored-memory.js.map

package/dist/authored-memory.js.map

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

package/dist/authored-plugin-effect.d.ts

@@ -0,0 +1,16 @@
+import { type LoadedPlugin } from './plugin-loader.js';
+import type { PluginVerb } from './plugin-manifest.js';
+import type { AuthoredBudget } from './authored-budget.js';
+import type { JournalClient } from './journal-client.js';
+import { AuthoredFlowExecutionError } from './authored-flow-error.js';
+import type { AuthoredFlowJournalStep } from './authored-flow-executor.js';
+export declare class PluginStepError extends AuthoredFlowExecutionError {
+    readonly diagnostic: string;
+    constructor(diagnostic: string, runId: string);
+}
+/** Helpers lower to an existing agent effect, never a fourth kernel primitive.
+ * The Plugin receipt lives in step.completed.output: { type, input, output, ... }.
+ * A private stream routes the step to this short-lived SDK worker exclusively.
+ */
+export declare function runPluginEffect(journal: JournalClient, flowName: string, id: string, plugin: LoadedPlugin, verb: PluginVerb, args: unknown, journalSteps: AuthoredFlowJournalStep[], budget: AuthoredBudget): Promise<unknown>;
+//# sourceMappingURL=authored-plugin-effect.d.ts.map

package/dist/authored-plugin-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-plugin-effect.d.ts","sourceRoot":"","sources":["../src/authored-plugin-effect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAI3E,qBAAa,eAAgB,SAAQ,0BAA0B;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAGvD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAC5F,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,EAAE,MAAM,EAAE,cAAc,GAC7E,OAAO,CAAC,OAAO,CAAC,CAuHlB"}

package/dist/authored-plugin-effect.js

@@ -0,0 +1,163 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { compileSpec, toKernelSpec } from './compile.js';
+import { invokePlugin } from './plugin-loader.js';
+import { SPEC_SCHEMA_VERSION } from './spec.js';
+import { AuthoredFlowExecutionError } from './authored-flow-error.js';
+import { readCompletedStepOutput } from './authored-step-output.js';
+import { withWorkerLease } from './worker-lease.js';
+export class PluginStepError extends AuthoredFlowExecutionError {
+    diagnostic;
+    constructor(diagnostic, runId) {
+        super('step_failed', diagnostic, 'worker_error', runId);
+        this.diagnostic = diagnostic;
+    }
+}
+/** Helpers lower to an existing agent effect, never a fourth kernel primitive.
+ * The Plugin receipt lives in step.completed.output: { type, input, output, ... }.
+ * A private stream routes the step to this short-lived SDK worker exclusively.
+ */
+export async function runPluginEffect(journal, flowName, id, plugin, verb, args, journalSteps, budget) {
+    const server = verb.namespace;
+    const tool = verb.method;
+    const idempotencyKey = `plugin:${server}:${tool}:${createHash('sha256').update(JSON.stringify(args)).digest('hex')}`;
+    const surfacePath = `/plugins/${pathPart(server)}/${pathPart(tool)}`;
+    const stream = `plugin-worker-${randomUUID()}`;
+    const instruction = JSON.stringify({ type: 'effect', server, tool, input: args });
+    const peer = journal.createPeer();
+    let diagnostic;
+    let settled;
+    let failed;
+    const completed = new Promise((resolve, reject) => { settled = resolve; failed = reject; });
+    void completed.catch(() => undefined);
+    let timer;
+    let work;
+    let dispatchExpired = false;
+    const dispatch = (event) => {
+        if (dispatchExpired)
+            return;
+        const dispatched = event.spec;
+        if (event.step_id !== id || event.step_type !== 'agent' || work !== undefined
+            || dispatched?.instruction !== instruction
+            || !dispatched.surfaces?.streams?.some(pin => pin.stream === stream)) {
+            failed(new Error('Plugin worker received an unexpected dispatch'));
+            return;
+        }
+        clearTimeout(timer);
+        timer = undefined;
+        work = execute(event);
+        void work.then(settled, failed);
+    };
+    async function execute(event) {
+        const receipt = { type: 'effect', plugin: plugin.manifest.name, version: plugin.manifest.version,
+            namespace: server, method: tool, input: args, idempotencyKey: event.idempotency_key };
+        let output;
+        let confirmed = false;
+        try {
+            // Renew the worker lease while the Plugin tool is in flight. Without this,
+            // a tool that runs longer than the initial lease loses ownership and
+            // the write-back path fails — see worker-lease.ts for the renewal contract.
+            confirmed = await withWorkerLease(peer, event, async () => {
+                return peer.performEffect({
+                    runId: event.run_id, stepId: id, attempt: event.attempt, idempotencyKey: event.idempotency_key,
+                    surfacePath, revisionBefore: 'pending', revisionAfter: idempotencyKey,
+                }, async () => {
+                    try {
+                        output = await invokePlugin(plugin, verb, args, event.idempotency_key);
+                    }
+                    catch {
+                        diagnostic = 'plugin_execution_failed';
+                        throw new PluginExecutionFailure();
+                    }
+                });
+            });
+            // A confirmed election without its receipt is an interrupted writeback,
+            // not a successful result we may invent or a call we may safely repeat.
+            if (!confirmed)
+                throw new Error('plugin_result_unavailable');
+        }
+        catch (error) {
+            if (error instanceof PluginExecutionFailure)
+                diagnostic = 'plugin_execution_failed';
+            else if (error instanceof Error && error.message === 'plugin_result_unavailable')
+                diagnostic = error.message;
+            else
+                throw error; // Journal failures remain fail-closed, never provider errors.
+        }
+        await peer.stepComplete(event.run_id, id, event.attempt, event.idempotency_key, diagnostic === undefined ? 'success' : 'worker_error', {
+            output: { ...receipt, output: output ?? null, ...(diagnostic ? { diagnostic } : {}) },
+            started_pins: event.pins, end_pins: event.pins,
+            ...(diagnostic ? { trajectory_tail: { ...receipt, diagnostic } } : {}),
+            effects: confirmed ? [{ surface_path: surfacePath, idempotency_key: event.idempotency_key }] : [],
+        });
+    }
+    let childRunId;
+    async function cancelChildRun() {
+        const runId = childRunId;
+        childRunId = undefined;
+        if (runId !== undefined) {
+            try {
+                await journal.runCancel(runId);
+            }
+            catch { /* fail-open on cleanup */ }
+        }
+    }
+    const deadlineError = new Error('Plugin worker dispatch deadline exceeded');
+    let finishDeadline;
+    const deadline = new Promise((resolve, reject) => {
+        finishDeadline = resolve;
+        // One deadline covers connection, initialization, run creation and dispatch.
+        timer = setTimeout(() => {
+            dispatchExpired = true;
+            failed(deadlineError);
+            reject(deadlineError);
+        }, 30_000);
+    });
+    try {
+        await Promise.race([peer.connect(), deadline]);
+        await Promise.race([peer.hello('flows-plugin'), deadline]);
+        peer.on('step.dispatch', dispatch);
+        await Promise.race([peer.workerAttach(stream, ['agent'], { workspace: [], streams: [{ stream, read_offset: 0 }] }, 1), deadline]);
+        const spec = toKernelSpec(compileSpec({ version: SPEC_SCHEMA_VERSION, name: `${flowName}/${id}`,
+            steps: [{ id, type: 'agent', instruction,
+                    surfaces: { streams: [{ stream }], external: [surfacePath] }, maxIterations: 1 }],
+        }));
+        return await Promise.race([budget.execute(journal, spec, async (outcome) => {
+                childRunId = outcome.run_id;
+                // run.start may answer after the deadline and the outer cleanup.
+                if (dispatchExpired)
+                    await cancelChildRun();
+                await completed;
+                if (diagnostic !== undefined) {
+                    try {
+                        await readCompletedStepOutput(journal, outcome.run_id, id, journalSteps);
+                    }
+                    catch (error) {
+                        if (!(error instanceof AuthoredFlowExecutionError) || error.code !== 'step_failed')
+                            throw error;
+                        throw new PluginStepError(diagnostic, outcome.run_id);
+                    }
+                }
+                const receipt = await readCompletedStepOutput(journal, outcome.run_id, id, journalSteps);
+                return receipt.output;
+            }), deadline]);
+    }
+    finally {
+        clearTimeout(timer);
+        finishDeadline();
+        peer.off('step.dispatch', dispatch);
+        // If the dispatch deadline fired we started a child run that will never
+        // be worked -- cancel it so its journal doesn't stay indeterminate.
+        // Best-effort: the parent flow already surfaced the deadline via the
+        // rejected `completed` promise, so a cancel error here must not mask it.
+        if (dispatchExpired)
+            await cancelChildRun();
+        peer.close();
+        await work?.catch(() => undefined);
+    }
+}
+function pathPart(value) {
+    return encodeURIComponent(value).replaceAll('.', '%2E');
+}
+class PluginExecutionFailure extends Error {
+}
+//# sourceMappingURL=authored-plugin-effect.js.map

package/dist/authored-plugin-effect.js.map

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

package/dist/authored-step-output.d.ts

@@ -0,0 +1,23 @@
+import type { JournalClient } from './journal-client.js';
+import type { CompletionReason as ProtocolCompletionReason, RunCompletionReason as ProtocolRunCompletionReason, RunOutcome } from './protocol.js';
+import type { AuthoredFlowJournalStep } from './authored-flow-executor.js';
+/**
+ * Shared by every `f.*` verb that lowers to one kernel step run in isolation:
+ * find its `step.completed` entry, record it, and refuse anything but a
+ * clean success before handing the raw `output` back for verb-specific
+ * extraction (a plain string for `f.run`, an `AgentResult` for `f.agent`).
+ *
+ * Callers are responsible for having already established that the RUN
+ * reached a terminal, successful state before calling this — `f.run`'s
+ * caller relies on `runStart`'s own immediate response (the kernel drives a
+ * deterministic step to completion inline, no race); `f.agent`'s caller
+ * relies on `classifyOutcome` (cli/run.ts) having already polled to a true
+ * terminal state. Given that, a single read from the start of this run's
+ * (small, single-step) journal is enough — no polling here, and no run
+ * outcome ever needs re-checking.
+ */
+export declare function readCompletedStepOutput(journal: JournalClient, runId: string, stepId: string, journalSteps: AuthoredFlowJournalStep[]): Promise<unknown>;
+export declare function readSuccessfulOutput(journal: JournalClient, outcome: RunOutcome, stepId: string, journalSteps: AuthoredFlowJournalStep[]): Promise<string>;
+export declare function isSurfaceCompletionReason(value: unknown): value is ProtocolCompletionReason;
+export declare function isSurfaceRunCompletionReason(value: unknown): value is ProtocolRunCompletionReason;
+//# sourceMappingURL=authored-step-output.d.ts.map

package/dist/authored-step-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-step-output.d.ts","sourceRoot":"","sources":["../src/authored-step-output.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,IAAI,wBAAwB,EAAE,mBAAmB,IAAI,2BAA2B,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAClJ,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE3E;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,uBAAuB,EAAE,GACtC,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,uBAAuB,EAAE,GACtC,OAAO,CAAC,MAAM,CAAC,CAajB;AAqBD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,wBAAwB,CAG3F;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,2BAA2B,CAGjG"}

package/dist/authored-step-output.js

@@ -0,0 +1,67 @@
+import { COMPLETION_REASONS, RUN_COMPLETION_REASONS } from '@relayflows/surface';
+import { AuthoredFlowExecutionError } from './authored-flow-error.js';
+/**
+ * Shared by every `f.*` verb that lowers to one kernel step run in isolation:
+ * find its `step.completed` entry, record it, and refuse anything but a
+ * clean success before handing the raw `output` back for verb-specific
+ * extraction (a plain string for `f.run`, an `AgentResult` for `f.agent`).
+ *
+ * Callers are responsible for having already established that the RUN
+ * reached a terminal, successful state before calling this — `f.run`'s
+ * caller relies on `runStart`'s own immediate response (the kernel drives a
+ * deterministic step to completion inline, no race); `f.agent`'s caller
+ * relies on `classifyOutcome` (cli/run.ts) having already polled to a true
+ * terminal state. Given that, a single read from the start of this run's
+ * (small, single-step) journal is enough — no polling here, and no run
+ * outcome ever needs re-checking.
+ */
+export async function readCompletedStepOutput(journal, runId, stepId, journalSteps) {
+    const entries = (await journal.journalRead(runId, 1)).entries;
+    const completed = entries.find((entry) => isStepCompleted(entry, stepId));
+    if (!isStepCompleted(completed, stepId)) {
+        throw protocolViolation(runId, `journal has no step.completed for "${stepId}"`);
+    }
+    const reason = completed.payload.completionReason;
+    journalSteps.push(Object.freeze({ id: stepId, runId, completionReason: reason }));
+    if (reason !== 'success') {
+        throw new AuthoredFlowExecutionError('step_failed', `journal step "${stepId}" completed with ${reason}`, reason, runId);
+    }
+    return completed.payload.output;
+}
+export async function readSuccessfulOutput(journal, outcome, stepId, journalSteps) {
+    const output = await readCompletedStepOutput(journal, outcome.run_id, stepId, journalSteps).catch(error => {
+        if (error instanceof AuthoredFlowExecutionError
+            && (error.completionReason === 'timeout' || error.completionReason === 'lease_expired')) {
+            throw new AuthoredFlowExecutionError('lease_exceeded', `f.run step "${stepId}" exceeded its command timeout.`, error.completionReason, error.runId);
+        }
+        throw error;
+    });
+    if (!isRecord(output) || typeof output['stdout_tail'] !== 'string') {
+        throw protocolViolation(outcome.run_id, `step "${stepId}" has no string stdout_tail`);
+    }
+    return output['stdout_tail'];
+}
+function isStepCompleted(value, stepId) {
+    if (!isRecord(value) || value['entry_type'] !== 'step.completed' || value['step_id'] !== stepId) {
+        return false;
+    }
+    const payload = value['payload'];
+    return isRecord(payload)
+        && isSurfaceCompletionReason(payload['completionReason'])
+        && 'output' in payload;
+}
+export function isSurfaceCompletionReason(value) {
+    return typeof value === 'string'
+        && COMPLETION_REASONS.includes(value);
+}
+export function isSurfaceRunCompletionReason(value) {
+    return typeof value === 'string'
+        && RUN_COMPLETION_REASONS.includes(value);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function protocolViolation(runId, detail) {
+    return new AuthoredFlowExecutionError('journal_protocol_violation', detail, undefined, runId);
+}
+//# sourceMappingURL=authored-step-output.js.map

package/dist/authored-step-output.js.map

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

package/dist/authored-worker-step.d.ts

@@ -0,0 +1,15 @@
+import type { AuthoredBudget } from './authored-budget.js';
+import type { AgentOptions, AgentResult, LlmOptions, NamedGate } from '@relayflows/surface';
+import { type RunLifecycleOptions } from './cli/run.js';
+import type { JournalClient } from './journal-client.js';
+import type { AuthoredFlowJournalStep } from './authored-flow-executor.js';
+/** Agent and LLM calls share the exact declarative preflight and lease wait. */
+export declare function authoredWorkerRunner(definition: {
+    name: string;
+}, journal: JournalClient, flowPath: string, journalSteps: AuthoredFlowJournalStep[], waitOptions: RunLifecycleOptions, localAgentStream?: string, budget?: AuthoredBudget, headerBudget?: unknown): {
+    agent(id: string, options: AgentOptions, verification?: NamedGate): Promise<AgentResult>;
+    llm(id: string, prompt: string, options?: LlmOptions, verification?: NamedGate): Promise<unknown>;
+};
+/** Deterministic commands execute inline under their per-invocation lease. */
+export declare function authoredDeterministicRunner(name: string, journal: JournalClient, journalSteps: AuthoredFlowJournalStep[], budget: AuthoredBudget): (id: string, command: string, terminal?: boolean, leaseMs?: number, verification?: NamedGate) => Promise<string>;
+//# sourceMappingURL=authored-worker-step.d.ts.map

package/dist/authored-worker-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-worker-step.d.ts","sourceRoot":"","sources":["../src/authored-worker-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG5F,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAK3E,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EACtE,YAAY,EAAE,uBAAuB,EAAE,EAAE,WAAW,EAAE,mBAAmB,EACzE,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,OAAO;cAiExD,MAAM,WAAW,YAAY,iBAAiB,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;YAyDhF,MAAM,UAAU,MAAM,YAAY,UAAU,iBAAiB,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;EAmB1G;AAED,8EAA8E;AAC9E,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAAE,EAAE,MAAM,EAAE,cAAc,IAEvF,IAAI,MAAM,EAAE,SAAS,MAAM,EAAE,kBAAgB,EAAE,UAAU,MAAM,EAAE,eAAe,SAAS,KAAG,OAAO,CAAC,MAAM,CAAC,CAa1H"}