@tangle-network/braid 0.1.2 → 0.2.0

package/dist/adapters/runtime/cli-bridge-retained-run.js

@@ -1,40 +1,55 @@
-import { AgentExactRunControlRefSchema, } from '@tangle-network/agent-interface';
-import { reconnectRetainedRun, startRetainedRun, } from '@tangle-network/agent-runtime/kernel';
+import { reconnectRetainedRun, recoverRetainedRun, startRetainedRun, } from '@tangle-network/agent-runtime/kernel';
+import { canonicalDigest } from '../../domain/canonical.js';
 import { publicMaterializationReceipt } from '../../domain/materialization-receipt.js';
-import { safeExecutionId } from './production-backend-common.js';
+import { safeExecutionId, stableProviderId } from './production-backend-common.js';
 import { finalRetainedEnvelope, isTerminalRetainedStatus, modelRequestsFromResult, retainedCapabilities, retainedStatus, retainedTurnUsage, } from './retained-execution-projection.js';
-const MAX_STATUS_BYTES = 64 * 1024;
-export async function createCliBridgeRetainedPlan(prepared, runId, controlRef) {
-    const { createCliBridgeProvider } = await import('@tangle-network/agent-provider-cli-bridge');
-    const provider = createCliBridgeProvider({
-        baseUrl: prepared.bridgeUrl,
-        bearerToken: prepared.bearerToken,
-        defaultModel: prepared.route,
-        ...(prepared.fetch === undefined ? {} : { fetch: prepared.fetch }),
-    });
-    const environmentId = controlRef?.environmentId ?? retainedEnvironmentId(runId);
-    const executionId = controlRef?.executionId ?? safeExecutionId(runId);
+export async function createCliBridgeRetainedPlan(prepared, runId, controlRef, recovery) {
+    const provider = prepared.provider;
+    const admission = headlessRetainedAdmission(recovery?.retainedAdmission);
+    if (admission !== undefined && admissionProvider(admission) !== provider.name) {
+        throw new Error('retained CLI Bridge admission belongs to another provider');
+    }
+    const persistedControlRef = admission?.phase === 'dispatched' ? admission.controlRef : undefined;
+    if (controlRef !== undefined &&
+        persistedControlRef !== undefined &&
+        canonicalDigest(controlRef) !== canonicalDigest(persistedControlRef)) {
+        throw new Error('retained CLI Bridge control reference conflicts with the persisted run');
+    }
+    const exactControlRef = controlRef ?? persistedControlRef;
+    const environmentId = exactControlRef?.environmentId ??
+        (admission?.phase === 'environment' ? admission.environmentId : undefined);
+    const executionId = exactControlRef?.executionId ??
+        (admission?.phase === 'intent' || admission?.phase === 'environment'
+            ? admission.executionId
+            : safeExecutionId(runId));
+    const providerSessionId = exactControlRef?.sessionId ??
+        (admission?.phase === 'intent' || admission?.phase === 'environment'
+            ? admission.sessionId
+            : prepared.providerSessionId);
+    const environmentIdempotencyKey = admission?.idempotencyKey ?? retainedEnvironmentIdempotencyKey(providerSessionId);
     const providerName = provider.name;
-    const capabilities = retainedCapabilities(prepared.capabilities);
+    const capabilities = retainedCapabilities(await provider.capabilities());
     const materializationReceipt = publicMaterializationReceipt({
         ...prepared.materializationReceipt,
         backend: 'environment-provider',
-        environmentId,
-        providerRunId: controlRef?.runId ?? executionId,
+        ...(environmentId === undefined ? {} : { environmentId }),
+        providerRunId: exactControlRef?.runId ?? executionId,
         retainedControl: 'exact-after-dispatch',
     });
     const plan = {
         prepared,
         provider,
-        environmentId,
+        ...(environmentId === undefined ? {} : { environmentId }),
+        environmentIdempotencyKey,
         executionId,
         providerName,
-        providerSessionId: controlRef?.sessionId ?? prepared.providerSessionId,
+        providerSessionId,
         model: prepared.route,
         capabilities,
         materializationReceipt,
         start: (input) => startCliBridgeRetainedRun(plan, input),
         reconnect: (controlRef) => reconnectCliBridgeRetainedRun(plan, controlRef),
+        recover: (input) => recoverCliBridgeRetainedRun(plan, input),
         discover: (braidRunId, signal) => discoverCliBridgeControlRef(plan, braidRunId, signal),
         observe: () => prepared.observation.snapshot(),
         projectStatus: ({ status, detached }) => retainedStatus(status, detached),
@@ -58,11 +73,12 @@ export async function startCliBridgeRetainedRun(plan, input) {
             profile: plan.prepared.profile,
             backend: plan.prepared.runner,
             workspace: { cwd: plan.prepared.workspace },
-            idempotencyKey: plan.environmentId,
+            idempotencyKey: plan.environmentIdempotencyKey,
         },
         turn: {
             prompt: input.text,
             turnId: safeExecutionId(input.operationId),
+            interactions: input.interactions ?? {},
             signal: input.signal,
         },
         identity: {
@@ -75,70 +91,73 @@ export async function startCliBridgeRetainedRun(plan, input) {
 export async function reconnectCliBridgeRetainedRun(plan, controlRef) {
     return reconnectRetainedRun({ provider: plan.provider, controlRef });
 }
+async function recoverCliBridgeRetainedRun(plan, input) {
+    const admission = headlessRetainedAdmission(input.admission);
+    if (admission === undefined)
+        return null;
+    if (admission.phase === 'intent') {
+        if (input.receipt === undefined || input.onRetainedAdmission === undefined)
+            return null;
+        const result = await recoverRetainedRun({
+            provider: plan.provider,
+            admission,
+            replay: {
+                environment: {
+                    profile: plan.prepared.profile,
+                    backend: plan.prepared.runner,
+                    workspace: { cwd: plan.prepared.workspace },
+                    idempotencyKey: admission.idempotencyKey,
+                },
+                turn: {
+                    prompt: input.receipt.requested.text,
+                    turnId: admission.turnId,
+                    interactions: input.receipt.requested.interactions ?? {},
+                    ...(input.signal === undefined ? {} : { signal: input.signal }),
+                },
+                identity: {
+                    sessionId: admission.sessionId,
+                    executionId: admission.executionId,
+                },
+            },
+            onAdmission: input.onRetainedAdmission,
+        });
+        return result.outcome === 'recovered' ? result.handle : null;
+    }
+    if (admission.phase !== 'environment')
+        return null;
+    const result = await recoverRetainedRun({
+        provider: plan.provider,
+        environmentId: admission.environmentId,
+        sessionId: admission.sessionId,
+        executionId: admission.executionId,
+    });
+    return result.outcome === 'recovered' ? result.handle : null;
+}
 /** Recover the exact server-issued digest after a client crashed during dispatch. */
 export async function discoverCliBridgeControlRef(plan, _braidRunId, signal) {
-    const providerRunId = plan.executionId;
-    const response = await (plan.prepared.fetch ?? globalThis.fetch)(`${plan.prepared.bridgeUrl}/v1/runs/${encodeURIComponent(providerRunId)}`, {
-        method: 'GET',
-        headers: { authorization: `Bearer ${plan.prepared.bearerToken}` },
-        ...(signal === undefined ? {} : { signal }),
-    });
-    if (response.status === 404)
+    if (plan.environmentId === undefined || plan.providerSessionId === undefined)
         return null;
-    if (!response.ok) {
-        throw new Error(`cli-bridge run discovery returned HTTP ${response.status}`);
-    }
-    const body = await boundedResponseText(response);
-    let value;
-    try {
-        value = JSON.parse(body);
-    }
-    catch {
-        throw new Error('cli-bridge run discovery returned invalid JSON');
-    }
-    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
-        throw new Error('cli-bridge run discovery returned an invalid run snapshot');
-    }
-    const snapshot = value;
-    if (snapshot.id !== providerRunId) {
-        throw new Error('cli-bridge run discovery returned another run identity');
-    }
-    return AgentExactRunControlRefSchema.parse({
-        runId: snapshot.id,
-        provider: plan.provider.name,
+    return plan.provider.lookupRun({
+        runId: plan.executionId,
         environmentId: plan.environmentId,
         sessionId: plan.providerSessionId,
         executionId: plan.executionId,
-        requestDigest: snapshot.requestDigest,
+        ...(signal === undefined ? {} : { signal }),
     });
 }
-export function retainedEnvironmentId(runId) {
-    return `environment-braid-${safeExecutionId(runId)}`;
+/** One provider session keeps one Bridge environment across every retained turn. */
+function retainedEnvironmentIdempotencyKey(providerSessionId) {
+    return stableProviderId('environment-braid-', providerSessionId);
 }
-async function boundedResponseText(response) {
-    if (response.body === null)
-        return '';
-    const reader = response.body.getReader();
-    const decoder = new TextDecoder();
-    const chunks = [];
-    let byteLength = 0;
-    try {
-        while (true) {
-            const next = await reader.read();
-            if (next.done)
-                break;
-            byteLength += next.value.byteLength;
-            if (byteLength > MAX_STATUS_BYTES) {
-                await reader.cancel('CLI Bridge run discovery response exceeded 64 KiB');
-                throw new Error('cli-bridge run discovery response exceeded 64 KiB');
-            }
-            chunks.push(decoder.decode(next.value, { stream: true }));
-        }
-        chunks.push(decoder.decode());
-        return chunks.join('');
-    }
-    finally {
-        reader.releaseLock();
+function headlessRetainedAdmission(admission) {
+    if (admission?.phase !== 'intent' &&
+        admission?.phase !== 'environment' &&
+        admission?.phase !== 'dispatched') {
+        return undefined;
     }
+    return admission;
+}
+function admissionProvider(admission) {
+    return admission.phase === 'dispatched' ? admission.controlRef.provider : admission.provider;
 }
 //# sourceMappingURL=cli-bridge-retained-run.js.map

package/dist/adapters/runtime/cli-bridge-retained-run.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-bridge-retained-run.js","sourceRoot":"","sources":["../../../src/adapters/runtime/cli-bridge-retained-run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-bridge-retained-run.js","sourceRoot":"","sources":["../../../src/adapters/runtime/cli-bridge-retained-run.ts"],"names":[],"mappings":"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"}

package/dist/adapters/runtime/mode-routing-execution.d.ts

@@ -0,0 +1,42 @@
+import type { InteractionResponseCommand } from '@tangle-network/agent-interface';
+import type { ExecuteTurnInput, ExecutionPort, NormalizedExecutionEvent, RetainedExecutionRecoveryContext } from '../../ports/execution.js';
+type StatusInput = Parameters<NonNullable<ExecutionPort['status']>>[0];
+type ReconnectInput = Parameters<NonNullable<ExecutionPort['reconnect']>>[0];
+type ReconnectEvent = Awaited<ReturnType<NonNullable<ExecutionPort['reconnect']>>> extends AsyncIterable<infer Event> ? Event : never;
+type CancelInput = Parameters<NonNullable<ExecutionPort['cancelRun']>>[0];
+type DetachInput = Parameters<NonNullable<ExecutionPort['detachRun']>>[0];
+type SteerInput = Parameters<NonNullable<ExecutionPort['steerRun']>>[0];
+type NativeBoundaryInput = Parameters<NonNullable<ExecutionPort['nativeBoundary']>>[0];
+export interface ModeRoutingExecutionOptions {
+    readonly headless: ExecutionPort;
+    readonly interactive: ExecutionPort;
+    /** Supplies durable mode state after Braid has restarted. */
+    readonly isInteractiveRun?: (runId: string) => boolean;
+}
+/** Routes one run by its explicit mode or canonical retained admission. */
+export declare class ModeRoutingExecutionPort implements ExecutionPort {
+    #private;
+    readonly admissionMode: 'sync' | 'async';
+    readonly capabilities: NonNullable<ExecutionPort['capabilities']>;
+    readonly environmentCapabilities?: NonNullable<ExecutionPort['environmentCapabilities']>;
+    constructor(options: ModeRoutingExecutionOptions);
+    admit(input: ExecuteTurnInput): Promise<import("../../ports/execution.js").ExecutionAdmission>;
+    streamTurn(input: ExecuteTurnInput): AsyncIterable<NormalizedExecutionEvent>;
+    cancelRun(input: CancelInput): Promise<import("../../ports/execution.js").ControlAcknowledgement | import("../../ports/execution.js").CancelRunResult>;
+    detachRun(input: DetachInput): Promise<import("../../ports/execution.js").ControlAcknowledgement>;
+    steerRun(input: SteerInput): Promise<import("../../ports/execution.js").ControlAcknowledgement>;
+    status(input: StatusInput): Promise<import("../../ports/execution.js").ProviderRunSnapshot | null>;
+    respondInteraction(input: {
+        readonly command: InteractionResponseCommand;
+        readonly signal?: AbortSignal;
+        readonly recovery?: RetainedExecutionRecoveryContext;
+    }): Promise<import("../../ports/execution.js").ControlAcknowledgement>;
+    reconnect(input: ReconnectInput): AsyncIterable<ReconnectEvent>;
+    nativeBoundary(input: NativeBoundaryInput): Promise<{
+        readonly boundary: string;
+        readonly digest: string;
+        readonly revision?: string;
+    } | null>;
+}
+export {};
+//# sourceMappingURL=mode-routing-execution.d.ts.map

package/dist/adapters/runtime/mode-routing-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-routing-execution.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/mode-routing-execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AACjF,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACxB,gCAAgC,EAEjC,MAAM,0BAA0B,CAAA;AAGjC,KAAK,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACtE,KAAK,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5E,KAAK,cAAc,GACjB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,KAAK,CAAC,GAC3F,KAAK,GACL,KAAK,CAAA;AACX,KAAK,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACzE,KAAK,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACzE,KAAK,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACvE,KAAK,mBAAmB,GAAG,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEtF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAA;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;CACvD;AAED,2EAA2E;AAC3E,qBAAa,wBAAyB,YAAW,aAAa;;IAK5D,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAA;IACxC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAA;IACjE,QAAQ,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC,CAAA;IAExF,YAAY,OAAO,EAAE,2BAA2B,EAY/C;IAEK,KAAK,CAAC,KAAK,EAAE,gBAAgB,kEAQlC;IAEM,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,CAAC,wBAAwB,CAAC,CAGlF;IAEK,SAAS,CAAC,KAAK,EAAE,WAAW,2HAMjC;IAEK,SAAS,CAAC,KAAK,EAAE,WAAW,sEAMjC;IAEK,QAAQ,CAAC,KAAK,EAAE,UAAU,sEAM/B;IAEK,MAAM,CAAC,KAAK,EAAE,WAAW,0EAM9B;IAEK,kBAAkB,CAAC,KAAK,EAAE;QAC9B,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAA;QAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;QAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gCAAgC,CAAA;KACrD,sEAYA;IAEM,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC,CAMrE;IAEK,cAAc,CAAC,KAAK,EAAE,mBAAmB;;;;cAI9C;CA8DF"}

package/dist/adapters/runtime/mode-routing-execution.js

@@ -0,0 +1,161 @@
+import { UNKNOWN_RUN_CAPABILITIES } from '../../ports/execution.js';
+/** Routes one run by its explicit mode or canonical retained admission. */
+export class ModeRoutingExecutionPort {
+    #headless;
+    #interactive;
+    #isInteractiveRun;
+    #interactiveRuns = new Set();
+    admissionMode;
+    capabilities;
+    environmentCapabilities;
+    constructor(options) {
+        this.#headless = options.headless;
+        this.#interactive = options.interactive;
+        this.#isInteractiveRun = options.isInteractiveRun ?? (() => false);
+        this.admissionMode =
+            options.headless.admissionMode === 'async' || options.interactive.admissionMode === 'async'
+                ? 'async'
+                : 'sync';
+        this.capabilities = this.#capabilities();
+        if (options.headless.environmentCapabilities !== undefined) {
+            this.environmentCapabilities = options.headless.environmentCapabilities.bind(options.headless);
+        }
+    }
+    async admit(input) {
+        const port = this.#portForInput(input);
+        if (port.admit === undefined) {
+            throw new Error('The selected execution port does not support admission');
+        }
+        const admission = await port.admit(input);
+        if (this.#isInteractivePort(port))
+            this.#interactiveRuns.add(input.runId);
+        return admission;
+    }
+    async *streamTurn(input) {
+        const port = this.#portForInput(input);
+        yield* port.streamTurn(input);
+    }
+    async cancelRun(input) {
+        const port = this.#portForInput(input);
+        if (port.cancelRun === undefined) {
+            throw new Error('The selected execution port does not support cancellation');
+        }
+        return port.cancelRun(input);
+    }
+    async detachRun(input) {
+        const port = this.#portForInput(input);
+        if (port.detachRun === undefined) {
+            throw new Error('The selected execution port does not support detachment');
+        }
+        return port.detachRun(input);
+    }
+    async steerRun(input) {
+        const port = this.#portForRun(input.runId);
+        if (port.steerRun === undefined) {
+            throw new Error('The selected execution port does not support steering');
+        }
+        return port.steerRun(input);
+    }
+    async status(input) {
+        const port = this.#portForRecovery(input);
+        if (port.status === undefined) {
+            throw new Error('The selected execution port does not support status');
+        }
+        return port.status(input);
+    }
+    async respondInteraction(input) {
+        const port = this.#portForInput({
+            runId: input.command.binding.runId,
+            ...(input.recovery?.retainedAdmission === undefined
+                ? {}
+                : { retainedAdmission: input.recovery.retainedAdmission }),
+            ...(input.recovery?.receipt === undefined ? {} : { receipt: input.recovery.receipt }),
+        });
+        if (port.respondInteraction === undefined) {
+            throw new Error('The selected execution port does not support interaction responses');
+        }
+        return port.respondInteraction(input);
+    }
+    async *reconnect(input) {
+        const port = this.#portForRecovery(input);
+        if (port.reconnect === undefined) {
+            throw new Error('The selected execution port does not support reconnection');
+        }
+        yield* port.reconnect(input);
+    }
+    async nativeBoundary(input) {
+        const port = this.#portForRun(input.runId);
+        if (port.nativeBoundary === undefined)
+            return null;
+        return port.nativeBoundary(input);
+    }
+    #capabilities() {
+        return ((input) => {
+            const selected = this.#portForInput(input).capabilities;
+            if (selected === undefined)
+                return UNKNOWN_RUN_CAPABILITIES;
+            if (typeof selected === 'function')
+                return selected(input);
+            return legacyCapabilities(selected);
+        });
+    }
+    #portForRecovery(input) {
+        const port = this.#portForInput(input);
+        if (this.#isInteractivePort(port))
+            this.#interactiveRuns.add(input.runId);
+        return port;
+    }
+    #portForRun(runId, _controlRef) {
+        const known = this.#interactiveRuns.has(runId) || this.#isInteractiveRun(runId);
+        if (known) {
+            this.#interactiveRuns.add(runId);
+            return this.#interactive;
+        }
+        return this.#headless;
+    }
+    #portForInput(input) {
+        const admissionMode = retainedAdmissionMode(input.retainedAdmission);
+        const receiptMode = input.receipt?.requested?.mode;
+        if (input.mode === 'interactive' && admissionMode === 'headless') {
+            throw new Error('Interactive mode conflicts with a headless retained admission');
+        }
+        if (input.mode !== undefined &&
+            input.mode !== 'interactive' &&
+            admissionMode === 'interactive') {
+            throw new Error('Headless mode conflicts with an interactive retained admission');
+        }
+        if (input.mode === 'interactive' ||
+            admissionMode === 'interactive' ||
+            receiptMode === 'interactive') {
+            this.#interactiveRuns.add(input.runId);
+            return this.#interactive;
+        }
+        if (this.#interactiveRuns.has(input.runId) || this.#isInteractiveRun(input.runId)) {
+            this.#interactiveRuns.add(input.runId);
+            return this.#interactive;
+        }
+        return this.#headless;
+    }
+    #isInteractivePort(port) {
+        return port === this.#interactive;
+    }
+}
+function legacyCapabilities(capabilities) {
+    return {
+        ...UNKNOWN_RUN_CAPABILITIES,
+        controls: { ...UNKNOWN_RUN_CAPABILITIES.controls, cancel: capabilities.cancel },
+    };
+}
+function retainedAdmissionMode(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const phase = value.phase;
+    if (typeof phase !== 'string')
+        return undefined;
+    if (phase.startsWith('interactive_'))
+        return 'interactive';
+    if (phase === 'intent' || phase === 'environment' || phase === 'dispatched')
+        return 'headless';
+    return undefined;
+}
+//# sourceMappingURL=mode-routing-execution.js.map

package/dist/adapters/runtime/mode-routing-execution.js.map

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

package/dist/adapters/runtime/native-interactive-run-broker.d.ts

@@ -0,0 +1,21 @@
+import type { RetainedInteractiveRunHandle } from '@tangle-network/agent-runtime/kernel';
+import type { NativeInteractiveExecutionControl, NativeInteractiveRunOutcome } from '../../ports/native-interactive-execution.js';
+export type NativeInteractiveRunSettlement = 'settled' | 'absent' | 'already-settled';
+export interface NativeInteractiveRunLease {
+    publish(handle: RetainedInteractiveRunHandle): void;
+    outcome(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<NativeInteractiveRunOutcome>;
+    fail(error: unknown): void;
+    close(): void;
+}
+/** One in-memory rendezvous only; Runtime and Braid's journal remain the durable owners. */
+export declare class NativeInteractiveRunBroker implements NativeInteractiveExecutionControl {
+    #private;
+    open(runId: string): NativeInteractiveRunLease;
+    waitForHandle(runId: string, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<RetainedInteractiveRunHandle>;
+    settle(runId: string, outcome: NativeInteractiveRunOutcome): NativeInteractiveRunSettlement;
+}
+//# sourceMappingURL=native-interactive-run-broker.d.ts.map

package/dist/adapters/runtime/native-interactive-run-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-interactive-run-broker.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/native-interactive-run-broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAA;AACxF,OAAO,KAAK,EACV,iCAAiC,EACjC,2BAA2B,EAC5B,MAAM,6CAA6C,CAAA;AAepD,MAAM,MAAM,8BAA8B,GAAG,SAAS,GAAG,QAAQ,GAAG,iBAAiB,CAAA;AAErF,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAAA;IACnD,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAA;IAC1F,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAC1B,KAAK,IAAI,IAAI,CAAA;CACd;AAED,4FAA4F;AAC5F,qBAAa,0BAA2B,YAAW,iCAAiC;;IAGlF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,yBAAyB,CAwB7C;IAED,aAAa,CACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC1C,OAAO,CAAC,4BAA4B,CAAC,CAEvC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,2BAA2B,GAAG,8BAA8B,CAM1F;CAcF"}

package/dist/adapters/runtime/native-interactive-run-broker.js

@@ -0,0 +1,97 @@
+/** One in-memory rendezvous only; Runtime and Braid's journal remain the durable owners. */
+export class NativeInteractiveRunBroker {
+    #entries = new Map();
+    open(runId) {
+        const entry = this.#entry(runId);
+        if (entry.opened)
+            throw new Error(`Interactive run ${runId} already has an active execution`);
+        entry.opened = true;
+        let closed = false;
+        return Object.freeze({
+            publish: (handle) => {
+                if (closed)
+                    throw new Error(`Interactive run ${runId} execution is closed`);
+                entry.handle.resolve(handle);
+            },
+            outcome: (options) => abortable(entry.outcome.promise, options?.signal),
+            fail: (error) => {
+                entry.handle.reject(asError(error));
+                entry.outcome.reject(asError(error));
+            },
+            close: () => {
+                if (closed)
+                    return;
+                closed = true;
+                entry.handle.reject(new Error(`Interactive run ${runId} ended before terminal attach`));
+                entry.outcome.reject(new Error(`Interactive run ${runId} ended without a terminal outcome`));
+                if (this.#entries.get(runId) === entry)
+                    this.#entries.delete(runId);
+            },
+        });
+    }
+    waitForHandle(runId, options) {
+        return abortable(this.#entry(runId).handle.promise, options?.signal);
+    }
+    settle(runId, outcome) {
+        const entry = this.#entries.get(runId);
+        if (entry === undefined || !entry.opened)
+            return 'absent';
+        if (entry.outcome.settled)
+            return 'already-settled';
+        entry.outcome.resolve(structuredClone(outcome));
+        return 'settled';
+    }
+    #entry(runId) {
+        if (runId.trim().length === 0)
+            throw new Error('Interactive run id must not be empty');
+        const current = this.#entries.get(runId);
+        if (current !== undefined)
+            return current;
+        const entry = {
+            handle: deferred(),
+            outcome: deferred(),
+            opened: false,
+        };
+        this.#entries.set(runId, entry);
+        return entry;
+    }
+}
+function deferred() {
+    let resolvePromise = () => { };
+    let rejectPromise = () => { };
+    const value = {
+        promise: new Promise((resolve, reject) => {
+            resolvePromise = resolve;
+            rejectPromise = reject;
+        }),
+        resolve: (next) => {
+            if (value.settled)
+                return;
+            value.settled = true;
+            resolvePromise(next);
+        },
+        reject: (error) => {
+            if (value.settled)
+                return;
+            value.settled = true;
+            rejectPromise(error);
+        },
+        settled: false,
+    };
+    void value.promise.catch(() => undefined);
+    return value;
+}
+function asError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+async function abortable(promise, signal) {
+    signal?.throwIfAborted();
+    if (signal === undefined)
+        return promise;
+    return new Promise((resolve, reject) => {
+        const abort = () => reject(signal.reason);
+        signal.addEventListener('abort', abort, { once: true });
+        void promise.then(resolve, reject).finally(() => signal.removeEventListener('abort', abort));
+    });
+}
+//# sourceMappingURL=native-interactive-run-broker.js.map

package/dist/adapters/runtime/native-interactive-run-broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-interactive-run-broker.js","sourceRoot":"","sources":["../../../src/adapters/runtime/native-interactive-run-broker.ts"],"names":[],"mappings":"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"}

package/dist/adapters/runtime/production-backend-common.d.ts

@@ -22,6 +22,8 @@ export declare function requiredProfileModel(profile: Readonly<AgentProfile>, co
 export declare function requiredProfileRunner(profile: Readonly<AgentProfile>, connectionId: ConnectionId): HarnessType;
 export declare function requiredWorkspaceCwd(inputRoot: string | undefined, configuredRoot: string | undefined): string;
 export declare function safeExecutionId(value: string): string;
+/** Build a readable provider key without collisions or overlong truncation. */
+export declare function stableProviderId(prefix: string, value: string): string;
 export declare function freezeExecution<T>(value: T): T;
 export declare function connectionRecord(connectionId: ConnectionId, options: ProductionBackendResolverOptions): ConnectionRecord;
 //# sourceMappingURL=production-backend-common.d.ts.map

package/dist/adapters/runtime/production-backend-common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"production-backend-common.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/production-backend-common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAEhF,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEhE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAA;AAEhG,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAA;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,MAAM,2BAA2B,GAAG,CACxC,KAAK,EAAE,gBAAgB,KACpB,4BAA4B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAA;AAEzE,MAAM,WAAW,gCAAiC,SAAQ,2BAA2B;IACnF,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAA;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,SAAS,EAAE,4BAA4B,EACvC,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE;IAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,OAAO,CAAC,YAAY,CAAC,CA4BvB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC/B,YAAY,EAAE,YAAY,GACzB,MAAM,CAUR;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC/B,YAAY,EAAE,YAAY,GACzB,WAAW,CASb;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,MAAM,CASR;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAM9C;AAED,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gCAAgC,GACxC,gBAAgB,CAQlB"}
+{"version":3,"file":"production-backend-common.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/production-backend-common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAEhF,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAE3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEhE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAA;AAEhG,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAA;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,MAAM,2BAA2B,GAAG,CACxC,KAAK,EAAE,gBAAgB,KACpB,4BAA4B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAA;AAEzE,MAAM,WAAW,gCAAiC,SAAQ,2BAA2B;IACnF,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAA;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,SAAS,EAAE,4BAA4B,EACvC,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE;IAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,OAAO,CAAC,YAAY,CAAC,CA4BvB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC/B,YAAY,EAAE,YAAY,GACzB,MAAM,CAUR;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC/B,YAAY,EAAE,YAAY,GACzB,WAAW,CASb;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,MAAM,CASR;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAM9C;AAED,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gCAAgC,GACxC,gBAAgB,CAQlB"}