@tangle-network/braid 0.1.0 → 0.1.2

package/dist/adapters/analysis/production-analysis-analyst.js

@@ -11,7 +11,7 @@ export class ProductionAnalysisAnalyst {
         const connectionOptions = input.connectionOptions ?? {};
         this.#create =
             input.create ??
-                (async (target) => {
+                (async (target, request) => {
                     if (target.connection === undefined) {
                         return createUnavailableTraceAnalysisAnalyst('The captured analysis route has no matching connection record.');
                     }
@@ -23,6 +23,14 @@ export class ProductionAnalysisAnalyst {
                             ? {}
                             : { maxOutputTokens: modelSettings.maxOutputTokens }),
                         ...connectionOptions,
+                        managedRuntimeReadiness: 'complete',
+                        ...(request.onRetainedAdmission === undefined
+                            ? {}
+                            : { onRetainedAdmission: request.onRetainedAdmission }),
+                        ...(request.signal === undefined ? {} : { signal: request.signal }),
+                        ...(request.totalTimeoutMs === undefined
+                            ? {}
+                            : { pythonProbeTimeoutMs: request.totalTimeoutMs }),
                     }));
                 });
     }
@@ -43,7 +51,15 @@ export class ProductionAnalysisAnalyst {
         const target = request.executionTarget;
         const analyst = target === undefined
             ? createUnavailableTraceAnalysisAnalyst('The analysis request has no captured execution route.')
-            : await this.#create(target);
+            : await this.#create(target, {
+                ...(request.onRetainedAdmission === undefined
+                    ? {}
+                    : { onRetainedAdmission: request.onRetainedAdmission }),
+                ...(request.signal === undefined ? {} : { signal: request.signal }),
+                ...(request.totalTimeoutMs === undefined
+                    ? {}
+                    : { totalTimeoutMs: request.totalTimeoutMs }),
+            });
         try {
             for await (const item of analyst.stream(request))
                 yield item;

package/dist/adapters/analysis/production-analysis-analyst.js.map

@@ -1 +1 @@
-{"version":3,"file":"production-analysis-analyst.js","sourceRoot":"","sources":["../../../src/adapters/analysis/production-analysis-analyst.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AAG1E,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,qCAAqC,GACtC,MAAM,6BAA6B,CAAA;AAEpC,MAAM,kBAAkB,GAAG,GAAG,CAAA;AAE9B,wFAAwF;AACxF,MAAM,OAAO,yBAAyB;IAC3B,UAAU,CAAiB;IAC3B,OAAO,CAA+D;IACtE,UAAU,GAAG,IAAI,GAAG,EAAiE,CAAA;IAE9F,YAAY,KAIX;QACC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,SAAS,CAAA;QACjC,MAAM,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAA;QACvD,IAAI,CAAC,OAAO;YACV,KAAK,CAAC,MAAM;gBACZ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;oBAChB,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;wBACpC,OAAO,qCAAqC,CAC1C,gEAAgE,CACjE,CAAA;oBACH,CAAC;oBACD,MAAM,aAAa,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;oBAC1D,OAAO,0BAA0B,CAC/B,MAAM,0BAA0B,CAAC;wBAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,UAAU,EAAE,MAAM,CAAC,UAAU;wBAC7B,GAAG,CAAC,aAAa,CAAC,eAAe,KAAK,SAAS;4BAC7C,CAAC,CAAC,EAAE;4BACJ,CAAC,CAAC,EAAE,eAAe,EAAE,aAAa,CAAC,eAAe,EAAE,CAAC;wBACvD,GAAG,iBAAiB;qBACrB,CAAC,CACH,CAAA;gBACH,CAAC,CAAC,CAAA;IACN,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;IAC/B,CAAC;IAED,iBAAiB,CAAC,OAA4D;QAC5E,OAAO,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA;IACnD,CAAC;IAED,eAAe,CAAC,KAAa;QAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC/C,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;QACzC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC7B,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAA;IACxE,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,OAA2B;QACvC,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAA;QACtC,MAAM,OAAO,GACX,MAAM,KAAK,SAAS;YAClB,CAAC,CAAC,qCAAqC,CACnC,uDAAuD,CACxD;YACH,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAChC,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;gBAAE,MAAM,IAAI,CAAA;QAC9D,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QAC/E,CAAC;IACH,CAAC;IAED,SAAS,CACP,KAAa,EACb,YAAmE;QAEnE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CACjB,KAAK,EACL,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAC/E,CAAA;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,kBAAkB,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;YAClD,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAK;YAC/B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"production-analysis-analyst.js","sourceRoot":"","sources":["../../../src/adapters/analysis/production-analysis-analyst.ts"],"names":[],"mappings":"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"}

package/dist/adapters/analysis/python-runner.d.ts

@@ -3,7 +3,7 @@ export interface PythonRunnerSpec {
     readonly args?: readonly string[];
 }
 export interface PythonRunnerIdentity extends PythonRunnerSpec {
-    readonly source: 'explicit' | 'detected';
+    readonly source: 'explicit' | 'detected' | 'managed';
 }
 export type PythonCommandProbeStatus = 'ok' | 'not-found' | 'failed' | 'timed-out';
 export interface PythonCommandProbeResult {
@@ -18,6 +18,8 @@ export interface ResolvePythonRunnerOptions {
     readonly candidates?: readonly string[];
     readonly probe?: PythonCommandProbe;
     readonly timeoutMs?: number;
+    readonly managedRuntimeReadiness?: 'launcher' | 'complete';
+    readonly signal?: AbortSignal;
 }
 export type PythonRunnerResolution = {
     readonly status: 'ready';

package/dist/adapters/analysis/python-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python-runner.d.ts","sourceRoot":"","sources":["../../../src/adapters/analysis/python-runner.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAA;CACzC;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAA;AAElF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAA;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,wBAAwB,CAAC,CAAA;AAEtC,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,MAAM,sBAAsB,GAC9B;IACE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CACtC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAA;AAiGL,uEAAuE;AACvE,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CAyCjC;AAED,eAAO,MAAM,mCAAmC,QAAgB,CAAA"}
+{"version":3,"file":"python-runner.d.ts","sourceRoot":"","sources":["../../../src/adapters/analysis/python-runner.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAA;CACrD;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAA;AAElF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAA;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,wBAAwB,CAAC,CAAA;AAEtC,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,uBAAuB,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,MAAM,sBAAsB,GAC9B;IACE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CACtC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAA;AAyKL,uEAAuE;AACvE,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CA6FjC;AAED,eAAO,MAAM,mCAAmC,QAAgB,CAAA"}

package/dist/adapters/analysis/python-runner.js

@@ -1,4 +1,5 @@
 import { spawn } from 'node:child_process';
+import { managedAnalysisRunner } from './managed-analysis-runtime.js';
 const PACKAGE_PROBE = [
     'import importlib.util',
     "required = ('agent_eval_rpc.dspy_rlm_bridge', 'dspy')",
@@ -14,6 +15,7 @@ const PACKAGE_PROBE = [
 ].join('\n');
 const PACKAGE_MISSING_EXIT_CODE = 13;
 const DEFAULT_PROBE_TIMEOUT_MS = 2_000;
+const DEFAULT_MANAGED_RUNTIME_PROBE_TIMEOUT_MS = 120_000;
 function defaultCandidates() {
     const configured = process.env.BRAID_PYTHON?.trim();
     return [...new Set([configured, 'python3', 'python'].filter((value) => !!value))];
@@ -60,6 +62,61 @@ async function defaultProbe(command, args, timeoutMs) {
         });
     });
 }
+const completeManagedRuntimeProbes = new WeakMap();
+function waitForProbe(pending, timeoutMs, signal) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', aborted);
+            resolve(result);
+        };
+        const fail = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', aborted);
+            reject(error);
+        };
+        const aborted = () => {
+            fail(signal?.reason instanceof Error
+                ? signal.reason
+                : new DOMException('The operation was aborted', 'AbortError'));
+        };
+        const timer = setTimeout(() => finish({ status: 'timed-out' }), timeoutMs);
+        if (signal?.aborted) {
+            aborted();
+            return;
+        }
+        signal?.addEventListener('abort', aborted, { once: true });
+        pending.then(finish, fail);
+    });
+}
+async function probeCompleteManagedRuntime(command, args, probe, timeoutMs, signal) {
+    const key = JSON.stringify([command, args]);
+    let probes = completeManagedRuntimeProbes.get(probe);
+    if (probes === undefined) {
+        probes = new Map();
+        completeManagedRuntimeProbes.set(probe, probes);
+    }
+    let pending = probes.get(key);
+    if (pending === undefined) {
+        pending = probe(command, args, DEFAULT_MANAGED_RUNTIME_PROBE_TIMEOUT_MS);
+        probes.set(key, pending);
+        void pending.then((result) => {
+            if (result.status !== 'ok' && probes.get(key) === pending)
+                probes.delete(key);
+        }, () => {
+            if (probes.get(key) === pending)
+                probes.delete(key);
+        });
+    }
+    return waitForProbe(pending, timeoutMs, signal);
+}
 async function probeRunner(runner, probe, timeoutMs) {
     const prefix = runner.args ?? [];
     const version = await probe(runner.command, [...prefix, '--version'], timeoutMs);
@@ -94,8 +151,17 @@ async function probeRunner(runner, probe, timeoutMs) {
 }
 /** Resolve and verify a Python executable without invoking a shell. */
 export async function resolvePythonRunner(options = {}) {
+    if (options.signal?.aborted) {
+        throw options.signal.reason instanceof Error
+            ? options.signal.reason
+            : new DOMException('The operation was aborted', 'AbortError');
+    }
     const probe = options.probe ?? defaultProbe;
-    const timeoutMs = options.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;
+    const managedRuntimeReadiness = options.managedRuntimeReadiness ?? 'launcher';
+    const timeoutMs = options.timeoutMs ??
+        (managedRuntimeReadiness === 'complete'
+            ? DEFAULT_MANAGED_RUNTIME_PROBE_TIMEOUT_MS
+            : DEFAULT_PROBE_TIMEOUT_MS);
     if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0) {
         throw new RangeError('Python readiness probe timeout must be a positive safe integer');
     }
@@ -112,6 +178,38 @@ export async function resolvePythonRunner(options = {}) {
     }
     let packageMissing;
     let probeFailed;
+    if (options.candidates === undefined && !process.env.BRAID_PYTHON?.trim()) {
+        const managed = managedAnalysisRunner();
+        if (managed !== undefined) {
+            const readinessArgs = managedRuntimeReadiness === 'complete'
+                ? managed.runtimeProbeArgs
+                : managed.launcherProbeArgs;
+            const readiness = managedRuntimeReadiness === 'complete'
+                ? await probeCompleteManagedRuntime(managed.command, readinessArgs, probe, timeoutMs, options.signal)
+                : await probe(managed.command, readinessArgs, timeoutMs);
+            if (readiness.status === 'ok') {
+                return {
+                    status: 'ready',
+                    runner: {
+                        command: managed.command,
+                        args: managed.args,
+                        source: 'managed',
+                    },
+                };
+            }
+            probeFailed = {
+                status: 'python-probe-failed',
+                runner: {
+                    command: managed.command,
+                    args: managed.args,
+                    source: 'managed',
+                },
+                message: managedRuntimeReadiness === 'complete'
+                    ? 'The managed trace-analysis runtime could not resolve Python 3.12 and the pinned Agent Eval package.'
+                    : 'The managed trace-analysis launcher could not be started.',
+            };
+        }
+    }
     for (const candidate of options.candidates ?? defaultCandidates()) {
         const runner = normalizedRunner({ command: candidate }, 'detected');
         if (runner === undefined)

package/dist/adapters/analysis/python-runner.js.map

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

package/dist/adapters/analysis/question-analyst.js

@@ -18,8 +18,8 @@ async function prepareQuestionContext(store) {
         'Never use an attribute label or a constructed JSON fragment as an excerpt.',
         'For numeric facts, quote a related model, status, or output string from the same span.',
         'Before SUBMIT, ensure each distinct request in Focus has one finding or one explicit limit.',
-        'The final call must be SUBMIT(answer, json.dumps(findings)).',
-        'Never pass the findings list directly to SUBMIT.',
+        'The final call must be SUBMIT(answer=answer, findings_json=json.dumps(findings)).',
+        'Never pass either output positionally or pass the findings list without JSON encoding.',
     ].join('\n');
 }
 export const BRAID_QUESTION_ANALYST_DEFINITION = Object.freeze({

package/dist/adapters/analysis/question-analyst.js.map

@@ -1 +1 @@
-{"version":3,"file":"question-analyst.js","sourceRoot":"","sources":["../../../src/adapters/analysis/question-analyst.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kBAAkB,GAInB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEzD,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAA;AAEnD,KAAK,UAAU,sBAAsB,CAAC,KAAyB;IAC7D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;IAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACtF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,mFAAmF,CAAA;IAC5F,CAAC;IACD,OAAO;QACL,+CAA+C;QAC/C,mBAAmB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG;QAC7C,2DAA2D;QAC3D,0EAA0E;QAC1E,qBAAqB;QACrB,kCAAkC;QAClC,yFAAyF;QACzF,4EAA4E;QAC5E,wFAAwF;QACxF,6FAA6F;QAC7F,8DAA8D;QAC9D,kDAAkD;KACnD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7D,EAAE,EAAE,yBAAyB;IAC7B,WAAW,EAAE,2EAA2E;IACxF,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,qDAAqD;IAC/D,YAAY,EAAE;QACZ,yDAAyD;QACzD,wCAAwC;QACxC,+DAA+D;QAC/D,8BAA8B;QAC9B,0FAA0F;QAC1F,qEAAqE;QACrE,qDAAqD;QACrD,wCAAwC;QACxC,0DAA0D;QAC1D,iFAAiF;QACjF,gEAAgE;QAChE,sEAAsE;QACtE,mDAAmD;QACnD,wFAAwF;QACxF,iEAAiE;QACjE,wEAAwE;QACxE,0FAA0F;QAC1F,wFAAwF;KACzF,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,cAAc,EAAE,sBAAsB;IACtC,SAAS,EAAE,aAAa;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACpB,aAAa,EAAE,EAAE;QACjB,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;KACvB,CAAC;IACF,wBAAwB,EAAE,CAAC;IAC3B,yBAAyB,EAAE,IAAI;CAChC,CAAkC,CAAA;AAEnC,SAAS,gBAAgB,CAAC,OAAuB;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAmB,CAAA;AAC7D,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,4BAA4B,CAC1C,QAAyB,EACzB,MAA2B;IAE3B,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,yBAAyB,CAAC;QAAE,OAAM;IACvF,MAAM,OAAO,GAAG,kBAAkB,CAAC,iCAAiC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IACjF,QAAQ,CAAC,QAAQ,CAAC;QAChB,GAAG,OAAO;QACV,OAAO,EAAE,KAAK,EAAE,KAAyB,EAAE,OAAuB,EAAE,EAAE,CACpE,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC;KAChE,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"question-analyst.js","sourceRoot":"","sources":["../../../src/adapters/analysis/question-analyst.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kBAAkB,GAInB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEzD,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAA;AAEnD,KAAK,UAAU,sBAAsB,CAAC,KAAyB;IAC7D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;IAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACtF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,mFAAmF,CAAA;IAC5F,CAAC;IACD,OAAO;QACL,+CAA+C;QAC/C,mBAAmB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG;QAC7C,2DAA2D;QAC3D,0EAA0E;QAC1E,qBAAqB;QACrB,kCAAkC;QAClC,yFAAyF;QACzF,4EAA4E;QAC5E,wFAAwF;QACxF,6FAA6F;QAC7F,mFAAmF;QACnF,wFAAwF;KACzF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7D,EAAE,EAAE,yBAAyB;IAC7B,WAAW,EAAE,2EAA2E;IACxF,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,qDAAqD;IAC/D,YAAY,EAAE;QACZ,yDAAyD;QACzD,wCAAwC;QACxC,+DAA+D;QAC/D,8BAA8B;QAC9B,0FAA0F;QAC1F,qEAAqE;QACrE,qDAAqD;QACrD,wCAAwC;QACxC,0DAA0D;QAC1D,iFAAiF;QACjF,gEAAgE;QAChE,sEAAsE;QACtE,mDAAmD;QACnD,wFAAwF;QACxF,iEAAiE;QACjE,wEAAwE;QACxE,0FAA0F;QAC1F,wFAAwF;KACzF,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,cAAc,EAAE,sBAAsB;IACtC,SAAS,EAAE,aAAa;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACpB,aAAa,EAAE,EAAE;QACjB,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;KACvB,CAAC;IACF,wBAAwB,EAAE,CAAC;IAC3B,yBAAyB,EAAE,IAAI;CAChC,CAAkC,CAAA;AAEnC,SAAS,gBAAgB,CAAC,OAAuB;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAmB,CAAA;AAC7D,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,4BAA4B,CAC1C,QAAyB,EACzB,MAA2B;IAE3B,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,yBAAyB,CAAC;QAAE,OAAM;IACvF,MAAM,OAAO,GAAG,kBAAkB,CAAC,iCAAiC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IACjF,QAAQ,CAAC,QAAQ,CAAC;QAChB,GAAG,OAAO;QACV,OAAO,EAAE,KAAK,EAAE,KAAyB,EAAE,OAAuB,EAAE,EAAE,CACpE,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC;KAChE,CAAC,CAAA;AACJ,CAAC"}

package/dist/adapters/analysis/runtime-model-owner.d.ts

@@ -3,6 +3,7 @@ import type { ExternalOptimizerModelCall, ExternalOptimizerModelExecutionObserva
 import { type AgentProfile } from '@tangle-network/agent-interface';
 import type { RouterTransportConfig } from '@tangle-network/agent-runtime/kernel';
 import type { ConnectionRecord } from '../../domain/entities.js';
+import type { RetainedRunAdmissionRecord } from '../../domain/run-contracts.js';
 export interface RuntimeRouterRetryPolicy {
     readonly maxAttempts?: number;
     readonly initialBackoffMs?: number;
@@ -22,6 +23,7 @@ export interface RuntimeTraceModelOwnerOptions {
     readonly complete?: RouterTransportConfig['complete'];
     readonly retry?: RuntimeRouterRetryPolicy;
     readonly recordExecution?: ModelExecutionRecorder;
+    readonly onRetainedAdmission?: (callId: string, admission: RetainedRunAdmissionRecord) => Promise<void>;
 }
 export interface RuntimeTraceModelOwner {
     readonly call: ExternalOptimizerModelCall;

package/dist/adapters/analysis/runtime-model-owner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-model-owner.d.ts","sourceRoot":"","sources":["../../../src/adapters/analysis/runtime-model-owner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EACV,0BAA0B,EAE1B,0CAA0C,EAC3C,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,iCAAiC,CAAA;AAE/F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AAEjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAgChE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED,KAAK,sBAAsB,GAAG,CAAC,WAAW,EAAE,0CAA0C,KAAK,IAAI,CAAA;AAE/F,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAAA;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAA;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,wBAAwB,CAAA;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAA;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAA;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAA;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAA;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,SAAS,0CAA0C,EAAE,CAAA;CACjF;AAidD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,sBAAsB,CAuJxB"}
+{"version":3,"file":"runtime-model-owner.d.ts","sourceRoot":"","sources":["../../../src/adapters/analysis/runtime-model-owner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EACV,0BAA0B,EAE1B,0CAA0C,EAC3C,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,iCAAiC,CAAA;AAExC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AAEjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAA;AAwC/E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED,KAAK,sBAAsB,GAAG,CAAC,WAAW,EAAE,0CAA0C,KAAK,IAAI,CAAA;AAE/F,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAAA;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAA;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,wBAAwB,CAAA;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAA;IACjD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAC7B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,0BAA0B,KAClC,OAAO,CAAC,IAAI,CAAC,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAA;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAA;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAA;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,SAAS,0CAA0C,EAAE,CAAA;CACjF;AAqhBD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,sBAAsB,CA4KxB"}

package/dist/adapters/analysis/runtime-model-owner.js

@@ -1,29 +1,34 @@
 import { costForTokenPricing, resolveModelPricing, } from '@tangle-network/agent-eval';
-import { harnessSystemPromptIntents } from '@tangle-network/agent-interface';
+import { harnessSystemPromptIntents, } from '@tangle-network/agent-interface';
 import { canonicalDigest } from '../../domain/canonical.js';
 import { safePublicIdentifier } from '../../domain/provider-values.js';
 import { redactProviderError } from '../../domain/redaction.js';
 import { canonicalAgentProfileDigestHex, snapshotAgentProfile, } from '../agent-interface/profile-runtime.js';
 import { portableBridgeModel } from '../connections/cli-bridge-model-route.js';
 import { AGENT_RUNTIME_VERSION } from '../runtime/agent-runtime-version.js';
+import { RetainedModelCallError, runRetainedCliBridgeModelCall, } from './runtime-retained-model-call.js';
 const MAX_RETAINED_EXECUTIONS = 256;
 const LOCAL_ROUTER_BEARER = 'braid-local-analysis';
-const ANALYST_MODEL_PROFILE_POLICY_VERSION = 3;
+const ANALYST_MODEL_PROFILE_POLICY_VERSION = 4;
 const ANALYST_MODEL_INSTRUCTIONS = Object.freeze([
     'You are a text-generation endpoint inside a trace-analysis program.',
-    'Treat the supplied message array as the complete conversation.',
-    'Return only the assistant response requested by that conversation.',
+    'Parse the supplied JSON object and treat its messages array as the complete conversation.',
+    'Follow those messages in order, including every system message and output contract.',
+    'Return only the requested assistant message, without a preface or explanation.',
+    'When the messages require a machine format, emit exactly that format without Markdown fences.',
+    'Never replace a requested structured field with prose.',
+    'A format-repair request must preserve every exact identifier and quoted evidence string.',
     'Do not inspect files, use tools, modify workspaces, or perform unrelated work.',
 ]);
 const ANALYST_MODEL_TOOLS = Object.freeze({
     read: false,
-    shell: false,
+    bash: false,
     edit: false,
     write: false,
 });
 const ANALYST_MODEL_PERMISSIONS = Object.freeze({
     read: 'deny',
-    shell: 'deny',
+    bash: 'deny',
     edit: 'deny',
     write: 'deny',
 });
@@ -80,6 +85,7 @@ function summarizeRuntimeEvents(events, startedAt) {
     const promptCache = promptCacheFacts(calls);
     const cachedTokens = sumPromptCache(promptCache, ['cachedTokens', 'cacheReadTokens']);
     const cacheWriteTokens = sumPromptCache(promptCache, ['cacheWriteTokens']);
+    const reasoningTokens = finiteTokenCount(final.metadata?.reasoningTokens);
     const observedCostUsd = completeCallAmount(calls, 'costUsd', (event) => event.usdKnown !== false);
     const estimatedCostUsd = completeCallAmount(calls, 'estimatedCostUsd');
     return {
@@ -101,6 +107,7 @@ function summarizeRuntimeEvents(events, startedAt) {
             : 0,
         ...(cachedTokens === undefined ? {} : { cachedTokens }),
         ...(cacheWriteTokens === undefined ? {} : { cacheWriteTokens }),
+        ...(reasoningTokens === undefined ? {} : { reasoningTokens }),
         ...(Object.keys(promptCache).length === 0 ? {} : { promptCache }),
         ...(observedCostUsd === undefined ? {} : { observedCostUsd }),
         ...(estimatedCostUsd === undefined ? {} : { estimatedCostUsd }),
@@ -111,6 +118,40 @@ function summarizeRuntimeEvents(events, startedAt) {
         ...(errorStatus === undefined ? {} : { errorStatus }),
     };
 }
+function summarizeRetainedResult(result, model, startedAt) {
+    const endedAt = Date.now();
+    const inputTokens = finiteTokenCount(result.usage?.inputTokens);
+    const outputTokens = finiteTokenCount(result.usage?.outputTokens);
+    const usageCaptured = inputTokens !== undefined && outputTokens !== undefined;
+    const errorStatus = result.error === undefined ? undefined : httpStatusFromReason(result.error);
+    const cachedTokens = finiteTokenCount(result.usage?.cacheReadInputTokens);
+    const cacheWriteTokens = finiteTokenCount(result.usage?.cacheCreationInputTokens);
+    const observedCostUsd = finiteNumber(result.usage?.cost);
+    const reasoningTokens = finiteTokenCount(result.usage?.reasoningTokens);
+    return {
+        events: [],
+        status: result.success ? 'completed' : 'failed',
+        reason: result.success
+            ? 'Retained model execution completed'
+            : (result.error ?? 'Retained model execution failed'),
+        content: result.text,
+        durationMs: Math.max(0, endedAt - startedAt),
+        endedAt,
+        inputTokens: inputTokens ?? 0,
+        outputTokens: outputTokens ?? 0,
+        ...(cachedTokens === undefined ? {} : { cachedTokens }),
+        ...(cacheWriteTokens === undefined ? {} : { cacheWriteTokens }),
+        ...(observedCostUsd === undefined ? {} : { observedCostUsd }),
+        ...(reasoningTokens === undefined ? {} : { reasoningTokens }),
+        usageCaptured,
+        reportedModel: model,
+        ...(!result.success ? { errorKind: 'backend' } : {}),
+        ...(errorStatus === undefined ? {} : { errorStatus }),
+    };
+}
+function finiteTokenCount(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+}
 function finiteNumber(value) {
     return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : undefined;
 }
@@ -169,6 +210,7 @@ function receiptFor(model, pricing, usage, knownNoExecution = false) {
         outputTokens: usage.outputTokens,
         ...(usage.cachedTokens === undefined ? {} : { cachedTokens: usage.cachedTokens }),
         ...(usage.cacheWriteTokens === undefined ? {} : { cacheWriteTokens: usage.cacheWriteTokens }),
+        ...(usage.reasoningTokens === undefined ? {} : { reasoningTokens: usage.reasoningTokens }),
     };
     if (usage.observedCostUsd !== undefined) {
         return { ...receipt, actualCostUsd: usage.observedCostUsd };
@@ -183,6 +225,7 @@ function receiptFor(model, pricing, usage, knownNoExecution = false) {
 function responseFor(request, summary, pricing) {
     const model = safeModelRoute(request.request.model);
     const receipt = receiptFor(model, pricing, summary);
+    const promptTokens = summary.inputTokens + (summary.cachedTokens ?? 0);
     const costUsd = summary.observedCostUsd ??
         (summary.usageCaptured && pricing !== undefined ? costForTokenPricing(pricing, receipt) : null);
     const raw = {
@@ -197,10 +240,14 @@ function responseFor(request, summary, pricing) {
     return {
         content: summary.content,
         usage: {
-            promptTokens: summary.inputTokens,
+            promptTokens,
             completionTokens: summary.outputTokens,
-            totalTokens: summary.inputTokens + summary.outputTokens,
+            totalTokens: promptTokens + summary.outputTokens,
             captured: summary.usageCaptured,
+            ...(summary.cachedTokens === undefined ? {} : { cachedPromptTokens: summary.cachedTokens }),
+            ...(summary.reasoningTokens === undefined
+                ? {}
+                : { reasoningTokens: summary.reasoningTokens }),
         },
         costUsd,
         model,
@@ -219,7 +266,7 @@ function executionEvidence(input) {
         runtime: {
             package: '@tangle-network/agent-runtime',
             version: AGENT_RUNTIME_VERSION,
-            operation: 'streamAgentTurn',
+            operation: input.operation,
         },
         ...(input.provider === undefined ? {} : { provider: input.provider }),
         callId: input.request.callId,
@@ -245,6 +292,17 @@ function executionEvidence(input) {
         durationMs: summary?.durationMs ?? Math.max(0, endedAt - input.startedAt),
         billing: cost,
         dispatched: input.dispatched,
+        ...(input.controlRef === undefined
+            ? {}
+            : {
+                retained: {
+                    runId: input.controlRef.runId,
+                    environmentId: input.controlRef.environmentId,
+                    sessionId: input.controlRef.sessionId,
+                    executionId: input.controlRef.executionId,
+                    requestDigest: input.controlRef.requestDigest,
+                },
+            }),
         ...(summary === undefined
             ? {}
             : {
@@ -262,6 +320,9 @@ function executionEvidence(input) {
                     ...(summary.cacheWriteTokens === undefined
                         ? {}
                         : { cacheWriteTokens: summary.cacheWriteTokens }),
+                    ...(summary.reasoningTokens === undefined
+                        ? {}
+                        : { reasoningTokens: summary.reasoningTokens }),
                     ...(summary.promptCache === undefined ? {} : { promptCache: summary.promptCache }),
                     ...(summary.reportedModel === undefined
                         ? {}
@@ -315,10 +376,10 @@ function publicError(value) {
 function analystCallProfile(options, request, retry) {
     const source = snapshotAgentProfile(options.profile);
     const provider = source.model?.provider?.trim();
-    if (!provider) {
+    const bridge = options.connection.kind === 'cli-bridge';
+    if (!bridge && !provider) {
         throw new TypeError('Trace analysis requires AgentProfile.model.provider before model execution');
     }
-    const bridge = options.connection.kind === 'cli-bridge';
     let harness = 'cli-base';
     let model = safeModelRoute(options.model);
     let prompt;
@@ -357,7 +418,7 @@ function analystCallProfile(options, request, retry) {
             : {}),
         model: {
             default: model,
-            provider,
+            ...(provider === undefined ? {} : { provider }),
             ...(reasoningEffort === undefined ? {} : { reasoningEffort }),
             metadata: {
                 ...(bridge ? {} : { retry }),
@@ -414,6 +475,8 @@ export function createRuntimeTraceModelOwner(options) {
         let dispatched = false;
         let summary;
         let executionProfileDigest = sourceProfileDigest;
+        const operation = options.connection.kind === 'cli-bridge' ? 'startRetainedRun' : 'streamAgentTurn';
+        let controlRef;
         try {
             const configuredModel = safePublicIdentifier(options.model);
             if (configuredModel === undefined) {
@@ -425,34 +488,49 @@ export function createRuntimeTraceModelOwner(options) {
             const messages = textMessages(request.request);
             const profile = analystCallProfile(options, request.request, retry);
             executionProfileDigest = canonicalAgentProfileDigestHex(profile);
-            const { createExecutor, streamAgentTurn } = await import('@tangle-network/agent-runtime/kernel');
-            const executor = options.connection.kind === 'cli-bridge'
-                ? createExecutor({
-                    backend: 'bridge',
-                    bridgeUrl: options.baseUrl,
-                    bridgeBearer: options.credential ?? LOCAL_ROUTER_BEARER,
-                })
-                : createExecutor({
+            if (options.connection.kind === 'cli-bridge') {
+                const onRetainedAdmission = options.onRetainedAdmission;
+                if (onRetainedAdmission === undefined) {
+                    throw new TypeError('CLI Bridge trace analysis requires durable admission storage');
+                }
+                dispatched = true;
+                const retained = await runRetainedCliBridgeModelCall({
+                    baseUrl: options.baseUrl,
+                    bearerToken: options.credential ?? LOCAL_ROUTER_BEARER,
+                    profile,
+                    model: configuredModel,
+                    messages,
+                    callId: request.callId,
+                    signal: request.signal,
+                    onAdmission: (admission) => onRetainedAdmission(request.callId, admission),
+                });
+                controlRef = retained.controlRef;
+                summary = summarizeRetainedResult(retained.result, configuredModel, startedAt);
+            }
+            else {
+                dispatched = true;
+                const { createExecutor, streamAgentTurn } = await import('@tangle-network/agent-runtime/kernel');
+                const executor = createExecutor({
                     backend: 'router',
                     routerBaseUrl: options.baseUrl,
                     routerKey: options.credential ?? LOCAL_ROUTER_BEARER,
                     ...(options.complete === undefined ? {} : { complete: options.complete }),
                 });
-            const backend = Object.freeze({
-                kind: 'executor',
-                factory: executor,
-                profile,
-                agentRunName: configuredModel,
-            });
-            dispatched = true;
-            for await (const event of streamAgentTurn(backend, { messages }, {
-                signal: request.signal,
-                callId: request.callId,
-                correlationId: `braid-analysis-${request.callId}`,
-            })) {
-                events.push(event);
+                const backend = Object.freeze({
+                    kind: 'executor',
+                    factory: executor,
+                    profile,
+                    agentRunName: configuredModel,
+                });
+                for await (const event of streamAgentTurn(backend, { messages }, {
+                    signal: request.signal,
+                    callId: request.callId,
+                    correlationId: `braid-analysis-${request.callId}`,
+                })) {
+                    events.push(event);
+                }
+                summary = summarizeRuntimeEvents(events, startedAt);
             }
-            summary = summarizeRuntimeEvents(events, startedAt);
             const receipt = receiptFor(options.model, pricing, summary);
             const evidence = executionEvidence({
                 request,
@@ -466,6 +544,8 @@ export function createRuntimeTraceModelOwner(options) {
                 summary,
                 dispatched,
                 startedAt,
+                operation,
+                ...(controlRef === undefined ? {} : { controlRef }),
             });
             if (summary.status !== 'completed') {
                 return {
@@ -483,6 +563,8 @@ export function createRuntimeTraceModelOwner(options) {
             };
         }
         catch (error) {
+            if (error instanceof RetainedModelCallError)
+                controlRef = error.controlRef;
             const message = publicError(error);
             const receipt = receiptFor(options.model, pricing, summary ?? { inputTokens: 0, outputTokens: 0, usageCaptured: false }, !dispatched);
             return {
@@ -504,6 +586,8 @@ export function createRuntimeTraceModelOwner(options) {
                     dispatched,
                     ...(events.length === 0 ? {} : { partialEvents: events }),
                     startedAt,
+                    operation,
+                    ...(controlRef === undefined ? {} : { controlRef }),
                     failure: message,
                 }),
             };