@relayflows/sdk 2.0.9 → 2.0.11

package/dist/authored-flow-operation.d.ts

@@ -1,4 +1,4 @@
-import type { Step } from '@relayflows/surface';
+import type { NamedGate, Step } from '@relayflows/surface';
 import { AuthoredFlowLifecycle, type AuthoredOperationInvocation } from './authored-flow-lifecycle.js';
 type OperationState = 'created' | 'running' | 'fulfilled' | 'rejected';
 /** A root authored operation whose outcome cannot be hidden by promise handlers. */
@@ -9,6 +9,14 @@ export declare class AuthoredFlowOperation<T> {
     private readonly start;
     private readonly scope;
     readonly step: Step<T>;
+    /**
+     * Named-gate config attached via `.gate({type: '…', …})`. The start closure
+     * reads this at spec-build time and injects it into the compiled StepSpec's
+     * `verification:` field — journal-honest via slice P's named-gate lowering.
+     * Undefined means no postfix gate (default behavior). Predicate `.gate(fn)`
+     * still throws `unsupported_gate` and never sets this field.
+     */
+    namedGate: NamedGate | undefined;
     private state;
     private thenInvoked;
     private rootFailureRecorded;

package/dist/authored-flow-operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authored-flow-operation.d.ts","sourceRoot":"","sources":["../src/authored-flow-operation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,EACjC,MAAM,8BAA8B,CAAC;AAEtC,KAAK,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAGvE,oFAAoF;AACpF,qBAAa,qBAAqB,CAAC,CAAC;IAahC,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAhBxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;gBAGzC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACJ,cAAc,EAAE,MAAM,IAAI,EAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACvB,KAAK,EAAE,qBAAqB;IAyC/C,IAAI,SAAS,IAAI,cAAc,CAE9B;IAED,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,OAAO,IAAI;QAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAErE;IAED,IAAI,cAAc,IAAI;QAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAE5E;IAED,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAOtB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC,cAAc,CAAC,OAAO,EACpB,UAAU,EAAE,2BAA2B,EACvC,QAAQ,EAAE,MAAM,OAAO,GACtB,OAAO;YAII,KAAK;IAenB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,qBAAqB;CAK9B;AAED,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,SAAS,qBAAqB,CAAC,OAAO,CAAC,EAAE,EACrD,SAAS,EAAE,qBAAqB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,SAAS,qBAAqB,CAAC,OAAO,CAAC,EAAE,EACrD,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAGf"}
+{"version":3,"file":"authored-flow-operation.d.ts","sourceRoot":"","sources":["../src/authored-flow-operation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,EACjC,MAAM,8BAA8B,CAAC;AAatC,KAAK,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAGvE,oFAAoF;AACpF,qBAAa,qBAAqB,CAAC,CAAC;IAqBhC,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAxBxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB;;;;;;OAMG;IACH,SAAS,EAAE,SAAS,GAAG,SAAS,CAAa;IAC7C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;gBAGzC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACJ,cAAc,EAAE,MAAM,IAAI,EAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACvB,KAAK,EAAE,qBAAqB;IAuD/C,IAAI,SAAS,IAAI,cAAc,CAE9B;IAED,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,OAAO,IAAI;QAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAErE;IAED,IAAI,cAAc,IAAI;QAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAE5E;IAED,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAOtB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC,cAAc,CAAC,OAAO,EACpB,UAAU,EAAE,2BAA2B,EACvC,QAAQ,EAAE,MAAM,OAAO,GACtB,OAAO;YAII,KAAK;IAenB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,qBAAqB;CAK9B;AAED,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,SAAS,qBAAqB,CAAC,OAAO,CAAC,EAAE,EACrD,SAAS,EAAE,qBAAqB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,SAAS,qBAAqB,CAAC,OAAO,CAAC,EAAE,EACrD,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/authored-flow-operation.js

@@ -1,5 +1,14 @@
 import { executionAsyncId } from 'node:async_hooks';
 import { AuthoredFlowExecutionError } from './authored-flow-error.js';
+/** Slice-P kinds the surface `.gate(config)` accepts and the SDK lowers. */
+const NAMED_GATE_KINDS = new Set([
+    'references_input', 'subprocess_gate', 'word_count_bounds', 'regex_match',
+]);
+function isNamedGateConfig(candidate) {
+    return typeof candidate === 'object' && candidate !== null && !Array.isArray(candidate)
+        && typeof candidate.type === 'string'
+        && NAMED_GATE_KINDS.has(candidate.type);
+}
 const nativePromiseThen = Promise.prototype.then;
 /** A root authored operation whose outcome cannot be hidden by promise handlers. */
 export class AuthoredFlowOperation {
@@ -9,6 +18,14 @@ export class AuthoredFlowOperation {
     start;
     scope;
     step;
+    /**
+     * Named-gate config attached via `.gate({type: '…', …})`. The start closure
+     * reads this at spec-build time and injects it into the compiled StepSpec's
+     * `verification:` field — journal-honest via slice P's named-gate lowering.
+     * Undefined means no postfix gate (default behavior). Predicate `.gate(fn)`
+     * still throws `unsupported_gate` and never sets this field.
+     */
+    namedGate = undefined;
     state = 'created';
     thenInvoked = false;
     rootFailureRecorded = false;
@@ -34,9 +51,19 @@ export class AuthoredFlowOperation {
         this.reject = reject;
         observeRejection(this.promise, (error) => this.recordRootFailure(error));
         const operation = this;
-        this.step = Object.freeze({
-            gate() {
-                throw new AuthoredFlowExecutionError('unsupported_gate', 'postfix gates are not lowered by the initial authored executor');
+        const step = {
+            gate(configOrPredicate, _because) {
+                if (isNamedGateConfig(configOrPredicate)) {
+                    // Config-object gate: lowers into the compiled StepSpec's
+                    // `verification:` field via slice-P named-gate lowering.
+                    operation.namedGate = configOrPredicate;
+                    return step;
+                }
+                // Predicate gate: closures cannot be journaled (covenant 1
+                // journal-as-truth). Refuse — authors should use a config-object
+                // gate or the declarative `verification:` block.
+                throw new AuthoredFlowExecutionError('unsupported_gate', 'postfix .gate(predicate) closures cannot be journaled; '
+                    + 'use .gate({type: "…", …}) with a slice-P named gate instead.');
             },
             then(onfulfilled, onrejected) {
                 operation.thenInvoked = true;
@@ -45,7 +72,11 @@ export class AuthoredFlowOperation {
                 const derived = nativeThen(operation.promise, wrapResolver(operation, invocation, onfulfilled), wrapResolver(operation, invocation, onrejected));
                 return trackDerivedPromise(derived, (error) => operation.recordCallbackFailure(error));
             },
-        });
+        };
+        // Freeze the `then`/`gate` method table so the surface's Step contract
+        // stays intact, but keep `namedGate` reachable via the enclosing
+        // operation reference (not through the surface Step handle).
+        this.step = Object.freeze(step);
         this.scope.registerStep(this.step, this);
     }
     get lifecycle() {

package/dist/authored-flow-operation.js.map

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

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

@@ -0,0 +1,12 @@
+import { JournalClient } from './journal-client.js';
+import type { AuthoredFlowJournalStep } from './authored-flow-executor.js';
+import { type HelperCall } from '@relayflows/surface/runtime';
+import { type SlackCall } from './slack-writeback.js';
+type ProviderCall = HelperCall | SlackCall;
+export declare function assertHelperCredentials(provider: string): void;
+/** Each helper uses the existing agent lease + effect protocol; no new kernel verb. */
+export declare function runHelperEffect(journal: JournalClient, name: string, stepId: string, call: ProviderCall, dataDir: string, journalSteps: AuthoredFlowJournalStep[]): Promise<unknown>;
+/** Recognize only the journaled helper envelope, so ordinary agent runs keep their worker path. */
+export declare function resumeHelperEffect(journal: JournalClient, runId: string, dataDir: string): Promise<boolean>;
+export {};
+//# sourceMappingURL=authored-helper-effect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authored-helper-effect.d.ts","sourceRoot":"","sources":["../src/authored-helper-effect.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAK3E,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAG/E,OAAO,EAA6D,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjH,KAAK,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3C,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAS9D;AAED,uFAAuF;AACvF,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EACxE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,uBAAuB,EAAE,GACvD,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED,mGAAmG;AACnG,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBjH"}

package/dist/authored-helper-effect.js

@@ -0,0 +1,144 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { JournalClient } from './journal-client.js';
+import { AuthoredFlowExecutionError } from './authored-flow-error.js';
+import { readCompletedStepOutput } from './authored-step-output.js';
+import { compileSpec, toKernelSpec } from './compile.js';
+import { SPEC_SCHEMA_VERSION } from './spec.js';
+import { withWorkerLease } from './worker-lease.js';
+import { helperProviders } from '@relayflows/surface/runtime';
+import { helperWriteback, HelperDeliveryError } from './helper-writeback.js';
+import { checkSlackHelpers } from './slack-preflight.js';
+import { atomicJson, readSlackReceipt, receiptPath, slackWriteback } from './slack-writeback.js';
+export function assertHelperCredentials(provider) {
+    const namespace = helperProviders.find(p => p.provider === provider)?.namespace;
+    if (!namespace)
+        throw new AuthoredFlowExecutionError('helper_provider.unsupported', `Unknown helper ${provider}`);
+    const report = checkSlackHelpers({ header: { tools: { [namespace]: true } }, body() { } });
+    if (!report.ok) {
+        const diagnostic = report.diagnostics[0];
+        throw new AuthoredFlowExecutionError(diagnostic.kind, diagnostic.message);
+    }
+}
+/** Each helper uses the existing agent lease + effect protocol; no new kernel verb. */
+export async function runHelperEffect(journal, name, stepId, call, dataDir, journalSteps) {
+    assertHelperCredentials(call.provider);
+    if (call.provider === 'notion' && call.verb === 'appendBlock' && process.env.RELAYFLOWS_NOTION_MOCK !== '1') {
+        throw new AuthoredFlowExecutionError('helper_provider.unsupported', 'Notion appendBlock has no upstream mount writeback route');
+    }
+    const stream = `${call.provider}-helper-${randomUUID()}`;
+    const spec = toKernelSpec(compileSpec({
+        version: SPEC_SCHEMA_VERSION, name: `${name}/${stepId}`,
+        steps: [{ id: stepId, type: 'agent', instruction: JSON.stringify(call),
+                maxIterations: 3, recoveryMode: 'reset',
+                surfaces: { streams: [{ stream }], external: [`/${call.provider}`] } }],
+    }));
+    const outcome = await journal.runStart(spec);
+    await atomicJson(join(dataDir, 'helper-runs', `${outcome.run_id}.json`), { provider: call.provider });
+    await driveHelperEffect(journal, outcome.run_id, spec.steps[0], call, dataDir);
+    const output = await readCompletedStepOutput(journal, outcome.run_id, stepId, journalSteps);
+    return output.receipt;
+}
+/** Recognize only the journaled helper envelope, so ordinary agent runs keep their worker path. */
+export async function resumeHelperEffect(journal, runId, dataDir) {
+    if (!/^[A-Za-z0-9_-]+$/.test(runId) || !existsSync(join(dataDir, 'helper-runs', `${runId}.json`)))
+        return false;
+    const entries = (await journal.journalRead(runId, 1)).entries;
+    const steps = entries.find(entry => entry.entry_type === 'run.spawned')?.payload.spec?.steps;
+    if (steps?.length !== 1)
+        return false;
+    const step = steps[0];
+    if (step.type !== 'agent' || !step.surfaces?.streams?.[0]?.stream.includes('-helper-'))
+        return false;
+    const call = JSON.parse(step.instruction);
+    if (call.type !== 'effect' || !helperProviders.some(p => p.provider === call.provider && p.supported))
+        return false;
+    const snapshot = await journal.runGet(runId);
+    if (snapshot.status === 'completed' || snapshot.status === 'failed')
+        return true;
+    assertHelperCredentials(call.provider);
+    await driveHelperEffect(journal, runId, step, call, dataDir);
+    return true;
+}
+async function driveHelperEffect(journal, runId, step, call, dataDir) {
+    const client = new JournalClient(journal.socketPath);
+    const stream = step.surfaces.streams[0].stream;
+    const pins = { workspace: [], streams: [{ stream, read_offset: 0 }] };
+    let resolve;
+    let reject;
+    const completed = new Promise((yes, no) => { resolve = yes; reject = no; });
+    // Observe early dispatch failures even while attach/run.resume is still pending.
+    void completed.catch(() => undefined);
+    let executing = false;
+    client.on('step.dispatch', (dispatch) => {
+        if (executing || dispatch.run_id !== runId || dispatch.step_id !== step.id)
+            return;
+        executing = true;
+        void completeHelperDispatch(client, dispatch, call, dataDir).then(resolve, reject);
+    });
+    client.on('error', reject);
+    try {
+        await client.connect();
+        await client.hello('flows-provider-helper');
+        await client.workerAttach(`${call.provider}-${randomUUID()}`, ['agent'], pins, 1);
+        const outcome = await journal.runResume(runId);
+        if (outcome.status === 'completed')
+            return;
+        if (outcome.status === 'failed') {
+            throw new AuthoredFlowExecutionError('step_failed', `Helper run ${runId} ${outcome.status}`, undefined, runId);
+        }
+        await completed;
+    }
+    catch (error) {
+        if (error instanceof AuthoredFlowExecutionError)
+            throw error;
+        throw new AuthoredFlowExecutionError('step_failed', error instanceof Error ? error.message : 'Helper effect failed', 'worker_error', runId);
+    }
+    finally {
+        client.close();
+    }
+}
+async function completeHelperDispatch(client, dispatch, call, dataDir) {
+    let output;
+    try {
+        output = await withWorkerLease(client, dispatch, async (signal) => {
+            const file = receiptPath(dataDir, dispatch.run_id, dispatch.step_id);
+            let receipt;
+            await client.performEffect({
+                runId: dispatch.run_id, stepId: dispatch.step_id, attempt: dispatch.attempt,
+                idempotencyKey: dispatch.idempotency_key, surfacePath: `/${call.provider}`,
+                revisionBefore: 'pending', revisionAfter: `${dispatch.run_id}:${dispatch.step_id}`,
+            }, async () => {
+                try {
+                    receipt = await readSlackReceipt(file);
+                }
+                catch (error) {
+                    if (error.code !== 'ENOENT')
+                        throw error;
+                    receipt = await (call.provider === 'slack' && 'params' in call
+                        ? slackWriteback(call, dataDir, dispatch.run_id, dispatch.step_id, signal)
+                        : helperWriteback(call, dataDir, dispatch.run_id, dispatch.step_id, signal));
+                    await atomicJson(file, receipt);
+                }
+                signal.throwIfAborted();
+            });
+            // Also required after a confirmed election followed by a crash before step.complete.
+            if (receipt === undefined)
+                receipt = await readSlackReceipt(file);
+            return { ...call, idempotencyKey: `${dispatch.run_id}:${dispatch.step_id}`, receipt };
+        });
+    }
+    catch (error) {
+        if (!(error instanceof HelperDeliveryError))
+            throw error;
+        await client.stepComplete(dispatch.run_id, dispatch.step_id, dispatch.attempt, dispatch.idempotency_key, 'worker_error', {
+            output: { ...call, diagnostic: error.message },
+            started_pins: dispatch.pins, end_pins: dispatch.pins, effects: [],
+        });
+        return;
+    }
+    await client.stepComplete(dispatch.run_id, dispatch.step_id, dispatch.attempt, dispatch.idempotency_key, 'success', { output, started_pins: dispatch.pins, end_pins: dispatch.pins,
+        effects: [{ surface_path: `/${call.provider}`, idempotency_key: dispatch.idempotency_key }] });
+}
+//# sourceMappingURL=authored-helper-effect.js.map

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

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

package/dist/authored-mcp.d.ts

@@ -0,0 +1,17 @@
+import type { Ctx, Step } from '@relayflows/surface';
+import type { McpServerConfig } from './spec.js';
+import type { JournalClient } from './journal-client.js';
+import { AuthoredFlowExecutionError } from './authored-flow-error.js';
+import type { AuthoredFlowJournalStep } from './authored-flow-executor.js';
+/** Own keys expose precisely the preflight inventory, including prototype-like names. */
+export declare function buildMcpProxy(inventory: Readonly<Record<string, readonly string[]>>, invoke: (server: string, tool: string, args: unknown, known: boolean) => Step<unknown>): Ctx['mcp'];
+export declare class McpStepError extends AuthoredFlowExecutionError {
+    readonly diagnostic: string;
+    constructor(diagnostic: string, runId: string);
+}
+/** 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 declare function runMcpEffect(journal: JournalClient, flowName: string, id: string, server: string, tool: string, args: unknown, known: boolean, config: McpServerConfig, journalSteps: AuthoredFlowJournalStep[]): Promise<unknown>;
+//# sourceMappingURL=authored-mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authored-mcp.d.ts","sourceRoot":"","sources":["../src/authored-mcp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAIrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,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,yFAAyF;AACzF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,EACtD,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,GACrF,GAAG,CAAC,KAAK,CAAC,CAkBZ;AAED,qBAAa,YAAa,SAAQ,0BAA0B;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAGvD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAClF,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EACtD,YAAY,EAAE,uBAAuB,EAAE,GACtC,OAAO,CAAC,OAAO,CAAC,CA6GlB"}

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":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,yFAAyF;AACzF,MAAM,UAAU,aAAa,CAC3B,SAAsD,EACtD,MAAsF;IAEtF,MAAM,OAAO,GAAqE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtG,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,MAAM,KAAK,GAAqD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE,CAAC,CAAC,IAAa,EAAE,EAAE,CAC/D,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,IAAI,IAAI,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5F,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzD,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAChD,GAAG,CAAC,MAAM,EAAE,GAAG;gBACb,IAAI,OAAO,GAAG,KAAK,QAAQ;oBAAE,OAAO,SAAS,CAAC;gBAC9C,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;oBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;gBACnD,mEAAmE;gBACnE,4DAA4D;gBAC5D,OAAO,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1B,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,OAAO,YAAa,SAAQ,0BAA0B;IACrC;IAArB,YAAqB,UAAkB,EAAE,KAAa;QACpD,KAAK,CAAC,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;QADrC,eAAU,GAAV,UAAU,CAAQ;IAEvC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAsB,EAAE,QAAgB,EAAE,EAAU,EAAE,MAAc,EAAE,IAAY,EAClF,IAAa,EAAE,KAAc,EAAE,MAAuB,EACtD,YAAuC;IAEvC,MAAM,cAAc,GAAG,OAAO,MAAM,IAAI,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAClH,MAAM,WAAW,GAAG,QAAQ,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,cAAc,UAAU,EAAE,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAClC,IAAI,UAA8B,CAAC;IACnC,IAAI,OAAoB,CAAC;IACzB,IAAI,MAAiC,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAClG,KAAK,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,KAAgD,CAAC;IACrD,IAAI,IAA+B,CAAC;IACpC,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,MAAM,QAAQ,GAAG,CAAC,KAAwB,EAAQ,EAAE;QAClD,IAAI,eAAe;YAAE,OAAO;QAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,IAA+E,CAAC;QACzG,IAAI,KAAK,CAAC,OAAO,KAAK,EAAE,IAAI,KAAK,CAAC,SAAS,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS;eACxE,UAAU,EAAE,WAAW,KAAK,WAAW;eACvC,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,CAAC;YACvE,MAAM,CAAC,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QACD,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,GAAG,SAAS,CAAC;QAClB,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACtB,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC,CAAC;IACF,KAAK,UAAU,OAAO,CAAC,KAAwB;QAC7C,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,KAAc,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QACpF,IAAI,MAAe,CAAC;QACpB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC;YACH,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAChD,wEAAwE;YACxE,qEAAqE;YACrE,4EAA4E;YAC5E,SAAS,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;gBACxD,OAAO,IAAI,CAAC,aAAa,CAAC;oBACxB,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,eAAe;oBAC9F,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc;iBACtE,EAAE,KAAK,IAAI,EAAE;oBACZ,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBACrD,IAAI,CAAC;wBACH,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;wBAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,SAAS,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;4BACpG,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;wBACpC,CAAC;oBACH,CAAC;4BAAS,CAAC;wBAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;oBAAC,CAAC;gBACtC,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,wEAAwE;YACxE,wEAAwE;YACxE,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ;gBAAE,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;iBAClD,IAAI,KAAK,YAAY,KAAK,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,wBAAwB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;gBAAE,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC;;gBACnJ,MAAM,KAAK,CAAC,CAAC,8DAA8D;QAClF,CAAC;QACD,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,eAAe,EAC5E,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,EAAE;YACrD,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;YACrF,YAAY,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI;YAC9C,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;SAClG,CAAC,CAAC;IACP,CAAC;IACD,IAAI,UAA8B,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACxG,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,GAAG,QAAQ,IAAI,EAAE,EAAE;YAC7F,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW;oBACtC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;SACpF,CAAC,CAAC,CAAC;QACJ,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,eAAe,GAAG,IAAI,CAAC;YACvB,MAAM,CAAC,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAC;QAC7D,CAAC,EAAE,MAAM,CAAC,CAAC;QACX,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;QAC/B,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;QAC5B,MAAM,SAAS,CAAC;QAChB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC;gBAAC,MAAM,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC;YAAC,CAAC;YACjF,OAAO,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,CAAC,KAAK,YAAY,0BAA0B,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;oBAAE,MAAM,KAAK,CAAC;gBAChG,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,YAAY,CAAwB,CAAC;QAChH,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QACpC,wEAAwE;QACxE,oEAAoE;QACpE,qEAAqE;QACrE,yEAAyE;QACzE,IAAI,eAAe,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAChD,IAAI,CAAC;gBAAC,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC"}

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"}