@tangle-network/braid 0.1.0 → 0.1.2

package/dist/adapters/runtime/retained-execution.js

@@ -0,0 +1,293 @@
+import { canonicalDigest } from '../../domain/canonical.js';
+import { canonicalAgentProfileDigestHex } from '../agent-interface/profile-runtime.js';
+import { RetainedExecutionState, retainedExecutionKey } from './retained-execution-state.js';
+import { streamRetainedExecution } from './retained-execution-stream.js';
+/** Provider-neutral durable execution lifecycle used by Braid adapters. */
+export class RetainedExecutionPort {
+    admissionMode = 'async';
+    #driver;
+    #state = new RetainedExecutionState();
+    constructor(driver) {
+        this.#driver = driver;
+    }
+    async admit(input) {
+        const plan = await this.#driver.resolve(input);
+        this.#state.rememberPrepared(input.runId, retainedExecutionKey(input), plan);
+        return {
+            capabilities: plan.capabilities,
+            provider: plan.providerName,
+            ...(plan.environmentId === undefined ? {} : { environmentId: plan.environmentId }),
+            ...(plan.providerSessionId === undefined
+                ? {}
+                : { providerSessionId: plan.providerSessionId }),
+            materializationReceipt: plan.materializationReceipt,
+            profileDigest: canonicalAgentProfileDigestHex(input.profile),
+            capabilitiesDigest: canonicalDigest(plan.capabilities),
+            materializationDigest: canonicalDigest(plan.materializationReceipt),
+        };
+    }
+    async *streamTurn(input) {
+        if (this.#state.isCancellationRequested(input.runId))
+            return;
+        const plan = this.#state.takePrepared(input.runId, retainedExecutionKey(input));
+        if (plan === undefined) {
+            throw new Error('Retained run was not admitted with this exact request');
+        }
+        const starting = Promise.resolve().then(() => plan.start(input));
+        this.#state.rememberStartingHandle(input.runId, starting);
+        let handle;
+        try {
+            handle = await starting;
+            this.#state.rememberHandle(input.runId, plan, handle);
+        }
+        finally {
+            this.#state.clearStartingHandle(input.runId, starting);
+        }
+        if (this.#state.isDetached(input.runId))
+            return;
+        this.#state.markDetached(input.runId, false);
+        yield* streamRetainedExecution({
+            runId: input.runId,
+            handle,
+            plan,
+            state: this.#state,
+            signal: input.signal,
+            includeObservation: true,
+            afterSequence: 0,
+        });
+    }
+    async *reconnect(input) {
+        if (input.after !== undefined && input.afterSequence === undefined) {
+            throw new Error('Retained reconnect requires the saved event sequence');
+        }
+        const providerSessionId = this.#recoverySessionId(input.providerSessionId, input.controlRef);
+        const plan = await this.#planFor(input.runId, providerSessionId, input.controlRef);
+        const controlRef = await this.#controlRefFor(input.runId, plan, input.controlRef, input.signal);
+        if (!controlRef)
+            return;
+        const handle = await plan.reconnect(controlRef, input.signal);
+        if (!handle)
+            return;
+        this.#state.rememberHandle(input.runId, plan, handle);
+        this.#state.markDetached(input.runId, false);
+        yield* streamRetainedExecution({
+            runId: input.runId,
+            handle,
+            plan,
+            state: this.#state,
+            signal: input.signal,
+            includeObservation: (input.afterSequence ?? 0) === 0,
+            afterSequence: input.afterSequence ?? 0,
+            ...(input.after === undefined ? {} : { after: input.after }),
+        });
+    }
+    async detachRun(input) {
+        this.#validateKnownControl(input.runId, input.providerSessionId, input.controlRef);
+        if (this.#state.isDetached(input.runId)) {
+            return { operationId: input.operationId, outcome: 'already-applied', detail: 'detached' };
+        }
+        const reader = this.#state.reader(input.runId);
+        this.#state.markDetached(input.runId, true);
+        reader?.abort(new DOMException('Braid detached from the retained run', 'AbortError'));
+        return { operationId: input.operationId, outcome: 'accepted', detail: 'detached' };
+    }
+    async cancelRun(input) {
+        this.#validateKnownControl(input.runId, input.providerSessionId, input.controlRef);
+        if (this.#state.isCancellationRequested(input.runId)) {
+            return {
+                operationId: input.operationId,
+                outcome: 'already-applied',
+                detail: 'cancelled-before-start',
+            };
+        }
+        if (this.#state.hasPrepared(input.runId)) {
+            this.#state.markCancellationRequested(input.runId);
+            this.#state.discardPrepared(input.runId);
+            return {
+                operationId: input.operationId,
+                outcome: 'accepted',
+                detail: 'cancelled-before-start',
+            };
+        }
+        const resolved = await this.#handleFor(input.runId, input.providerSessionId, input.controlRef, input.signal);
+        if (!resolved) {
+            return {
+                operationId: input.operationId,
+                outcome: 'unknown',
+                detail: 'Retained run was not found',
+            };
+        }
+        const cancelSignal = resolved.wasStarting || input.signal?.aborted ? undefined : input.signal;
+        const result = await resolved.handle.cancel({
+            operationId: input.operationId,
+            ...(input.reason === undefined ? {} : { reason: input.reason }),
+            ...(cancelSignal === undefined ? {} : { signal: cancelSignal }),
+        });
+        if (result.status === 'conflict') {
+            return { operationId: input.operationId, outcome: 'rejected', detail: result.effect };
+        }
+        if (result.status === 'unknown') {
+            return { operationId: input.operationId, outcome: 'unknown', detail: result.effect };
+        }
+        if (result.effect === 'cancel_requested') {
+            return {
+                operationId: input.operationId,
+                outcome: 'unknown',
+                detail: 'cancel_requested',
+            };
+        }
+        let effect = result.effect;
+        if (effect === 'unknown' || effect === 'not_live') {
+            if (resolved.plan.exactStatus === false) {
+                return { operationId: input.operationId, outcome: 'unknown', detail: result.effect };
+            }
+            const reconciled = await this.#reconcileCancelled(resolved, input);
+            if (!reconciled) {
+                return { operationId: input.operationId, outcome: 'unknown', detail: result.effect };
+            }
+            effect = 'cancelled';
+        }
+        if (effect !== 'cancelled') {
+            return { operationId: input.operationId, outcome: 'unknown', detail: effect };
+        }
+        this.#state.reader(input.runId)?.abort(new DOMException('Retained run cancelled', 'AbortError'));
+        this.#state.markDetached(input.runId, false);
+        return {
+            operationId: input.operationId,
+            outcome: result.status === 'replayed' ? 'already-applied' : 'accepted',
+            detail: effect,
+        };
+    }
+    async status(input) {
+        const resolved = await this.#handleFor(input.runId, input.providerSessionId, input.controlRef, input.signal);
+        if (!resolved)
+            return null;
+        if (resolved.plan.exactStatus === false)
+            return null;
+        const snapshot = await resolved.handle.status({
+            ...(input.signal === undefined ? {} : { signal: input.signal }),
+        });
+        const snapshotControlRef = this.#state.validateControlRef(resolved.plan, snapshot.controlRef);
+        this.#state.assertSameControlRef(resolved.handle.controlRef, snapshotControlRef);
+        const status = resolved.plan.projectStatus({
+            status: snapshot.status,
+            detached: this.#state.isDetached(input.runId),
+        });
+        const base = {
+            runId: input.runId,
+            status,
+            sessionId: resolved.handle.controlRef.sessionId,
+        };
+        if (!resolved.plan.isTerminalStatus(status))
+            return base;
+        if (status === 'cancelled' || status === 'expired')
+            return base;
+        try {
+            const projected = resolved.plan.projectResult(await resolved.handle.result());
+            return {
+                ...base,
+                finalText: projected.text,
+                usage: projected.usage,
+                ...(projected.error === undefined ? {} : { error: projected.error }),
+            };
+        }
+        catch (error) {
+            return {
+                ...base,
+                error: error instanceof Error ? error.message : 'Retained result unavailable',
+            };
+        }
+    }
+    async #handleFor(runId, providerSessionId, supplied, signal) {
+        const active = this.#state.handle(runId);
+        const activePlan = this.#state.plan(runId);
+        const starting = this.#state.startingHandle(runId);
+        if (active !== undefined || starting !== undefined) {
+            if (activePlan === undefined)
+                throw new Error('Retained run state is incomplete');
+            this.#state.assertProviderSession(activePlan, providerSessionId);
+            let handle = active;
+            if (handle === undefined) {
+                if (starting === undefined)
+                    throw new Error('Retained run state is incomplete');
+                handle = await starting;
+            }
+            if (supplied !== undefined) {
+                const exact = this.#state.validateControlRef(activePlan, supplied);
+                this.#state.assertSameControlRef(handle.controlRef, exact);
+            }
+            return { handle, plan: activePlan, wasStarting: starting !== undefined };
+        }
+        if (activePlan !== undefined) {
+            if (this.#state.isCancellationRequested(runId))
+                return null;
+        }
+        const recoverySessionId = this.#recoverySessionId(providerSessionId, supplied);
+        const plan = await this.#planFor(runId, recoverySessionId, supplied);
+        const controlRef = await this.#controlRefFor(runId, plan, supplied, signal);
+        if (!controlRef)
+            return null;
+        const handle = await plan.reconnect(controlRef, signal);
+        if (handle)
+            this.#state.rememberHandle(runId, plan, handle);
+        return handle === null ? null : { handle, plan, wasStarting: false };
+    }
+    async #reconcileCancelled(resolved, input) {
+        try {
+            const signal = resolved.wasStarting || input.signal?.aborted ? undefined : input.signal;
+            const snapshot = await resolved.handle.status({
+                ...(signal === undefined ? {} : { signal }),
+            });
+            const exact = this.#state.validateControlRef(resolved.plan, snapshot.controlRef);
+            this.#state.assertSameControlRef(resolved.handle.controlRef, exact);
+            return snapshot.status === 'cancelled';
+        }
+        catch {
+            return false;
+        }
+    }
+    async #controlRefFor(runId, plan, supplied, signal) {
+        if (supplied !== undefined)
+            return this.#state.validateControlRef(plan, supplied);
+        const discovered = await plan.discover(runId, signal);
+        if (discovered === null)
+            return null;
+        return this.#state.validateControlRef(plan, discovered);
+    }
+    async #planFor(runId, providerSessionId, controlRef) {
+        const cached = this.#state.plan(runId);
+        if (cached !== undefined) {
+            this.#state.assertProviderSession(cached, providerSessionId);
+            return cached;
+        }
+        const plan = await this.#driver.recover({
+            runId,
+            ...(providerSessionId === undefined ? {} : { providerSessionId }),
+            ...(controlRef === undefined ? {} : { controlRef }),
+        });
+        this.#state.assertProviderSession(plan, providerSessionId);
+        this.#state.rememberPlan(runId, plan);
+        return plan;
+    }
+    #recoverySessionId(providerSessionId, controlRef) {
+        if (providerSessionId !== undefined &&
+            controlRef !== undefined &&
+            providerSessionId !== controlRef.sessionId) {
+            throw new Error('retained provider session conflicts with the exact run reference');
+        }
+        return controlRef?.sessionId ?? providerSessionId;
+    }
+    #validateKnownControl(runId, providerSessionId, controlRef) {
+        const plan = this.#state.plan(runId);
+        if (plan === undefined)
+            return;
+        this.#state.assertProviderSession(plan, providerSessionId);
+        if (controlRef === undefined)
+            return;
+        const exact = this.#state.validateControlRef(plan, controlRef);
+        const active = this.#state.handle(runId);
+        if (active !== undefined)
+            this.#state.assertSameControlRef(active.controlRef, exact);
+    }
+}
+//# sourceMappingURL=retained-execution.js.map

package/dist/adapters/runtime/retained-execution.js.map

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

package/dist/adapters/runtime/sandbox-observation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox-observation.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/sandbox-observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,uCAAuC,CAAA;AAiBnG,OAAO,KAAK,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAEjG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAA;CACjD;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,sBAAsB,EACjC,GAAG,GAAE,MAAM,MAAuC,GACjD,yBAAyB,CAwF3B"}
+{"version":3,"file":"sandbox-observation.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/sandbox-observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,uCAAuC,CAAA;AAEnG,OAAO,KAAK,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAiBjG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAA;CACjD;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,sBAAsB,EACjC,GAAG,GAAE,MAAM,MAAuC,GACjD,yBAAyB,CAmG3B"}

package/dist/adapters/runtime/sandbox-observation.js

@@ -23,6 +23,20 @@ export function observeSandboxClient(source, lifecycle, now = () => new Date().t
         }));
     };
     observeSandboxAccount(client, state, unavailable, track, now);
+    const observeBox = (box) => {
+        captureSandboxBox(state, box, unavailable);
+        if (source.describePlacement === undefined) {
+            unavailable.add('verified-placement:not-exposed-by-client');
+        }
+        else {
+            track(Promise.resolve()
+                .then(() => source.describePlacement?.(box))
+                .then((placement) => captureSandboxPlacement(state, placement, unavailable)));
+        }
+        const proxy = wrapObservedSandboxBox(box, state, unavailable);
+        originals.set(proxy, box);
+        return proxy;
+    };
     const wrapped = {
         async create(options, requestOptions) {
             state.lifecycle = 'creating';
@@ -32,18 +46,7 @@ export function observeSandboxClient(source, lifecycle, now = () => new Date().t
             state.storagePersistence = options?.ephemeral === true ? 'ephemeral-home' : 'persistent-home';
             try {
                 const box = (await source.create(options, requestOptions));
-                captureSandboxBox(state, box, unavailable);
-                if (source.describePlacement === undefined) {
-                    unavailable.add('verified-placement:not-exposed-by-client');
-                }
-                else {
-                    track(Promise.resolve()
-                        .then(() => source.describePlacement?.(box))
-                        .then((placement) => captureSandboxPlacement(state, placement, unavailable)));
-                }
-                const proxy = wrapObservedSandboxBox(box, state, unavailable);
-                originals.set(proxy, box);
-                return proxy;
+                return observeBox(box);
             }
             catch (error) {
                 state.lifecycle = 'failed';
@@ -54,8 +57,12 @@ export function observeSandboxClient(source, lifecycle, now = () => new Date().t
         ...(source.get === undefined
             ? {}
             : {
-                get: (id, requestOptions) => source.get?.(id, requestOptions) ?? Promise.resolve(null),
+                async get(id, requestOptions) {
+                    const box = (await source.get?.(id, requestOptions));
+                    return box === null || box === undefined ? null : observeBox(box);
+                },
             }),
+        ...(source.fetch === undefined ? {} : { fetch: source.fetch.bind(source) }),
         ...(source.list === undefined
             ? {}
             : {

package/dist/adapters/runtime/sandbox-observation.js.map

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

package/dist/adapters/runtime/tangle-retained-execution.d.ts

@@ -0,0 +1,17 @@
+import type { AgentExactRunControlRef } from '@tangle-network/agent-interface';
+import type { ExecuteTurnInput } from '../../ports/execution.js';
+import type { PreparedTangleRetainedConnection } from './production-tangle-sandbox-backend.js';
+import { RetainedExecutionPort } from './retained-execution.js';
+export interface TangleRetainedExecutionOptions {
+    readonly resolve: (input: ExecuteTurnInput) => Promise<PreparedTangleRetainedConnection>;
+    readonly recover: (input: {
+        readonly runId: string;
+        readonly providerSessionId?: string;
+        readonly controlRef?: AgentExactRunControlRef;
+    }) => Promise<PreparedTangleRetainedConnection>;
+}
+/** The cloud owns the retained sandbox; Braid owns readers and exact recovery state. */
+export declare class TangleRetainedExecutionPort extends RetainedExecutionPort {
+    constructor(options: TangleRetainedExecutionOptions);
+}
+//# sourceMappingURL=tangle-retained-execution.d.ts.map

package/dist/adapters/runtime/tangle-retained-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tangle-retained-execution.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/tangle-retained-execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAA;AAC9F,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAG/D,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,gCAAgC,CAAC,CAAA;IACxF,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;QACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAA;KAC9C,KAAK,OAAO,CAAC,gCAAgC,CAAC,CAAA;CAChD;AAED,wFAAwF;AACxF,qBAAa,2BAA4B,SAAQ,qBAAqB;IACpE,YAAY,OAAO,EAAE,8BAA8B,EAclD;CACF"}

package/dist/adapters/runtime/tangle-retained-execution.js

@@ -0,0 +1,16 @@
+import { RetainedExecutionPort } from './retained-execution.js';
+import { createTangleRetainedPlan } from './tangle-retained-run.js';
+/** The cloud owns the retained sandbox; Braid owns readers and exact recovery state. */
+export class TangleRetainedExecutionPort extends RetainedExecutionPort {
+    constructor(options) {
+        super({
+            resolve: async (input) => createTangleRetainedPlan(await options.resolve(input), input.runId),
+            recover: async ({ runId, providerSessionId, controlRef }) => createTangleRetainedPlan(await options.recover({
+                runId,
+                ...(providerSessionId === undefined ? {} : { providerSessionId }),
+                ...(controlRef === undefined ? {} : { controlRef }),
+            }), runId, controlRef),
+        });
+    }
+}
+//# sourceMappingURL=tangle-retained-execution.js.map

package/dist/adapters/runtime/tangle-retained-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tangle-retained-execution.js","sourceRoot":"","sources":["../../../src/adapters/runtime/tangle-retained-execution.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAWnE,wFAAwF;AACxF,MAAM,OAAO,2BAA4B,SAAQ,qBAAqB;IACpE,YAAY,OAAuC;QACjD,KAAK,CAAC;YACJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;YAC7F,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,EAAE,CAC1D,wBAAwB,CACtB,MAAM,OAAO,CAAC,OAAO,CAAC;gBACpB,KAAK;gBACL,GAAG,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC;gBACjE,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;aACpD,CAAC,EACF,KAAK,EACL,UAAU,CACX;SACJ,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/adapters/runtime/tangle-retained-run.d.ts

@@ -0,0 +1,14 @@
+import type { AgentExactRunControlRef } from '@tangle-network/agent-interface';
+import type { AgentEnvironmentProvider } from '@tangle-network/agent-interface/environment-provider';
+import { type RetainedRunHandle } from '@tangle-network/agent-runtime/kernel';
+import type { ExecuteTurnInput } from '../../ports/execution.js';
+import type { PreparedTangleRetainedConnection } from './production-tangle-sandbox-backend.js';
+import type { RetainedExecutionPlan } from './retained-execution-contract.js';
+export interface TangleRetainedPlan extends RetainedExecutionPlan {
+    readonly prepared: PreparedTangleRetainedConnection;
+    readonly provider: AgentEnvironmentProvider;
+    readonly executionId: string;
+}
+export declare function createTangleRetainedPlan(prepared: PreparedTangleRetainedConnection, runId: string, controlRef?: AgentExactRunControlRef): TangleRetainedPlan;
+export declare function startTangleRetainedRun(plan: TangleRetainedPlan, input: ExecuteTurnInput): Promise<RetainedRunHandle>;
+//# sourceMappingURL=tangle-retained-run.d.ts.map

package/dist/adapters/runtime/tangle-retained-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tangle-retained-run.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/tangle-retained-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AAC9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sDAAsD,CAAA;AACpG,OAAO,EACL,KAAK,iBAAiB,EAGvB,MAAM,sCAAsC,CAAA;AAG7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAA;AAE9F,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,kCAAkC,CAAA;AAUzC,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,QAAQ,CAAC,QAAQ,EAAE,gCAAgC,CAAA;IACnD,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAA;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gCAAgC,EAC1C,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,uBAAuB,GACnC,kBAAkB,CAgDpB;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CA0B5B"}

package/dist/adapters/runtime/tangle-retained-run.js

@@ -0,0 +1,75 @@
+import { reconnectRetainedRun, startRetainedRun, } from '@tangle-network/agent-runtime/kernel';
+import { publicMaterializationReceipt } from '../../domain/materialization-receipt.js';
+import { safeExecutionId } from './production-backend-common.js';
+import { finalRetainedEnvelope, isTerminalRetainedStatus, modelRequestsFromResult, retainedCapabilities, retainedStatus, retainedTurnUsage, } from './retained-execution-projection.js';
+export function createTangleRetainedPlan(prepared, runId, controlRef) {
+    const executionId = controlRef?.executionId ?? safeExecutionId(runId);
+    const plan = {
+        prepared,
+        provider: prepared.provider,
+        executionId,
+        providerName: prepared.provider.name,
+        exactStatus: false,
+        ...(controlRef === undefined ? {} : { environmentId: controlRef.environmentId }),
+        providerSessionId: controlRef?.sessionId ?? prepared.providerSessionId,
+        model: prepared.model,
+        capabilities: retainedCapabilities(prepared.capabilities, {
+            sessionContinuation: prepared.capabilities.sessions.continue,
+            exactStatus: false,
+        }),
+        materializationReceipt: publicMaterializationReceipt({
+            ...prepared.materializationReceipt,
+            providerRunId: controlRef?.runId ?? executionId,
+            retainedControl: 'exact-after-dispatch',
+        }),
+        start: (input) => startTangleRetainedRun(plan, input),
+        reconnect: (exact) => reconnectRetainedRun({ provider: plan.provider, controlRef: exact }),
+        discover: async (braidRunId, signal) => {
+            const exact = await prepared.discoverControlRef(braidRunId, signal);
+            if (exact === null)
+                return null;
+            if (exact.executionId !== executionId) {
+                throw new Error('Tangle retained lookup returned another execution');
+            }
+            return exact;
+        },
+        observe: () => prepared.observation.snapshot(),
+        projectStatus: ({ status, detached }) => retainedStatus(status, detached),
+        isTerminalStatus: isTerminalRetainedStatus,
+        projectResult: (result) => ({
+            text: result.text,
+            usage: retainedTurnUsage(result.usage, prepared.model, modelRequestsFromResult(result)),
+            ...(result.error === undefined ? {} : { error: result.error }),
+        }),
+        projectFinal: ({ runId: braidRunId, sequence, result }) => finalRetainedEnvelope(braidRunId, sequence, prepared.model, result, 'Execute the retained Tangle sandbox turn'),
+    };
+    return Object.freeze(plan);
+}
+export async function startTangleRetainedRun(plan, input) {
+    if (input.onRetainedAdmission === undefined) {
+        throw new Error('Retained Tangle execution requires a durable admission recorder');
+    }
+    // A retained create may return an existing environment for the same key.
+    // Do not destroy it after an ambiguous dispatch failure without a provider-issued creation receipt.
+    return startRetainedRun({
+        provider: plan.provider,
+        environment: {
+            profile: plan.prepared.profile,
+            backend: plan.prepared.runner,
+            name: plan.prepared.environmentName,
+            metadata: plan.prepared.environmentMetadata,
+            idempotencyKey: plan.prepared.environmentIdempotencyKey,
+        },
+        turn: {
+            prompt: input.text,
+            turnId: safeExecutionId(input.operationId),
+            signal: input.signal,
+        },
+        identity: {
+            sessionId: plan.prepared.providerSessionId,
+            executionId: plan.executionId,
+        },
+        onAdmission: input.onRetainedAdmission,
+    });
+}
+//# sourceMappingURL=tangle-retained-run.js.map

package/dist/adapters/runtime/tangle-retained-run.js.map

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

package/dist/adapters/runtime/tangle-sandbox-retention.d.ts

@@ -0,0 +1,19 @@
+import type { SandboxClientLike } from '@tangle-network/agent-provider-tangle';
+import { MAX_RETAINED_IDLE_TTL_SECONDS, MIN_RETAINED_IDLE_TTL_SECONDS } from '../../domain/entities-core.js';
+import type { SandboxLifecyclePolicy } from './prepared-execution.js';
+export { MAX_RETAINED_IDLE_TTL_SECONDS, MIN_RETAINED_IDLE_TTL_SECONDS };
+export interface RetainedSandboxIdentity {
+    readonly providerSessionId: string;
+    readonly environmentIdempotencyKey: string;
+    readonly name: string;
+    readonly metadata: Readonly<{
+        owner: 'braid';
+        lifecycle: 'retained';
+        providerSessionId: string;
+    }>;
+}
+export declare function retainedSandboxIdentity(providerSessionId: string): RetainedSandboxIdentity;
+export declare function retainedSandboxLifecycle(idleTtlSeconds: number): SandboxLifecyclePolicy;
+/** Apply Braid's bounded lifetime without replacing the Sandbox SDK. */
+export declare function withRetainedSandboxPolicy(source: SandboxClientLike, idleTtlSeconds: number): SandboxClientLike;
+//# sourceMappingURL=tangle-sandbox-retention.d.ts.map

package/dist/adapters/runtime/tangle-sandbox-retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tangle-sandbox-retention.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/tangle-sandbox-retention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,uCAAuC,CAAA;AAEnG,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC9B,MAAM,+BAA+B,CAAA;AACtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAIrE,OAAO,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,CAAA;AAEvE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC1B,KAAK,EAAE,OAAO,CAAA;QACd,SAAS,EAAE,UAAU,CAAA;QACrB,iBAAiB,EAAE,MAAM,CAAA;KAC1B,CAAC,CAAA;CACH;AAED,wBAAgB,uBAAuB,CAAC,iBAAiB,EAAE,MAAM,GAAG,uBAAuB,CAQ1F;AAED,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,sBAAsB,CAOvF;AAED,wEAAwE;AACxE,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EACzB,cAAc,EAAE,MAAM,GACrB,iBAAiB,CA+CnB"}