open-multi-agent-kit 0.98.4 → 0.99.0

package/dist/core/session-prompt-lifecycle.js

@@ -0,0 +1,87 @@
+import { createPromptSettlementState, reducePromptSettlement, settlePromptIfReady, } from "./prompt-settlement.js";
+export class PromptExecutionBusyError extends Error {
+    constructor() {
+        super("Agent is already processing or has unsettled tool execution. Wait for actual termination.");
+        this.name = "PromptExecutionBusyError";
+    }
+}
+/** Session-local ownership, not a durable journal or a detached-process sandbox. */
+export class SessionPromptLifecycle {
+    owner;
+    disposed = false;
+    canSettle;
+    auditsLateSettlement;
+    constructor(options = {}) {
+        this.canSettle = options.canSettle ?? (() => true);
+        this.auditsLateSettlement = options.auditsLateSettlement ?? (() => true);
+    }
+    assertIdle() {
+        if (this.owner !== undefined || this.disposed)
+            throw new PromptExecutionBusyError();
+    }
+    begin(promptRunId) {
+        this.assertIdle();
+        const owner = { promptRunId, startedAt: performance.now(), executions: new Set() };
+        this.owner = owner;
+        return {
+            finish: (outcome, notify) => {
+                if (owner.terminal !== undefined)
+                    return;
+                owner.terminal = { outcome, notify };
+                this.flush();
+            },
+        };
+    }
+    wrapTool(tool) {
+        return {
+            name: tool.name,
+            label: tool.label,
+            description: tool.description,
+            parameters: tool.parameters,
+            prepareArguments: tool.prepareArguments,
+            executionMode: tool.executionMode,
+            resourceClaims: tool.resourceClaims,
+            // A spread would evaluate and freeze the context-sensitive timeout too early.
+            get timeoutMs() {
+                return tool.timeoutMs;
+            },
+            execute: async (...args) => {
+                const owner = this.owner;
+                if (this.disposed || owner?.terminal !== undefined)
+                    throw new PromptExecutionBusyError();
+                // Runtime-owned identities cannot collide with reused model toolCallIds.
+                const execution = Symbol();
+                const requiresAudit = this.auditsLateSettlement();
+                owner?.executions.add(execution);
+                try {
+                    return await tool.execute(...args);
+                }
+                finally {
+                    owner?.executions.delete(execution);
+                    // Audit mode flushes only after the late event has been delivered.
+                    if (!requiresAudit)
+                        this.flush();
+                }
+            },
+        };
+    }
+    /** Called after the root producer drains, or after late-settlement event delivery. */
+    flush() {
+        const owner = this.owner;
+        if (!owner?.terminal || owner.executions.size > 0 || this.disposed || !this.canSettle())
+            return;
+        const state = reducePromptSettlement(createPromptSettlementState(owner.promptRunId, owner.startedAt), {
+            kind: "terminal",
+            outcome: owner.terminal.outcome,
+        });
+        const { event } = settlePromptIfReady(state, performance.now());
+        this.owner = undefined;
+        if (event !== null)
+            owner.terminal.notify(event);
+    }
+    dispose() {
+        this.disposed = true;
+        this.owner = undefined;
+    }
+}
+//# sourceMappingURL=session-prompt-lifecycle.js.map

package/dist/core/session-prompt-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-prompt-lifecycle.js","sourceRoot":"","sources":["../../src/core/session-prompt-lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"omk-agent-core\";\nimport {\n\tcreatePromptSettlementState,\n\ttype PromptSettledEvent,\n\ttype PromptSettlementOutcome,\n\treducePromptSettlement,\n\tsettlePromptIfReady,\n} from \"./prompt-settlement.ts\";\n\ninterface PromptOwner {\n\treadonly promptRunId: string;\n\treadonly startedAt: number;\n\treadonly executions: Set<symbol>;\n\tterminal?: { readonly outcome: PromptSettlementOutcome; readonly notify: (event: PromptSettledEvent) => void };\n}\n\nexport class PromptExecutionBusyError extends Error {\n\tconstructor() {\n\t\tsuper(\"Agent is already processing or has unsettled tool execution. Wait for actual termination.\");\n\t\tthis.name = \"PromptExecutionBusyError\";\n\t}\n}\n\n/** Session-local ownership, not a durable journal or a detached-process sandbox. */\nexport class SessionPromptLifecycle {\n\tprivate owner: PromptOwner | undefined;\n\tprivate disposed = false;\n\tprivate readonly canSettle: () => boolean;\n\tprivate readonly auditsLateSettlement: () => boolean;\n\n\tconstructor(options: { canSettle?: () => boolean; auditsLateSettlement?: () => boolean } = {}) {\n\t\tthis.canSettle = options.canSettle ?? (() => true);\n\t\tthis.auditsLateSettlement = options.auditsLateSettlement ?? (() => true);\n\t}\n\n\tassertIdle(): void {\n\t\tif (this.owner !== undefined || this.disposed) throw new PromptExecutionBusyError();\n\t}\n\n\tbegin(promptRunId: string): {\n\t\tfinish: (outcome: PromptSettlementOutcome, notify: (event: PromptSettledEvent) => void) => void;\n\t} {\n\t\tthis.assertIdle();\n\t\tconst owner: PromptOwner = { promptRunId, startedAt: performance.now(), executions: new Set() };\n\t\tthis.owner = owner;\n\t\treturn {\n\t\t\tfinish: (outcome, notify) => {\n\t\t\t\tif (owner.terminal !== undefined) return;\n\t\t\t\towner.terminal = { outcome, notify };\n\t\t\t\tthis.flush();\n\t\t\t},\n\t\t};\n\t}\n\n\twrapTool(tool: AgentTool): AgentTool {\n\t\treturn {\n\t\t\tname: tool.name,\n\t\t\tlabel: tool.label,\n\t\t\tdescription: tool.description,\n\t\t\tparameters: tool.parameters,\n\t\t\tprepareArguments: tool.prepareArguments,\n\t\t\texecutionMode: tool.executionMode,\n\t\t\tresourceClaims: tool.resourceClaims,\n\t\t\t// A spread would evaluate and freeze the context-sensitive timeout too early.\n\t\t\tget timeoutMs() {\n\t\t\t\treturn tool.timeoutMs;\n\t\t\t},\n\t\t\texecute: async (...args) => {\n\t\t\t\tconst owner = this.owner;\n\t\t\t\tif (this.disposed || owner?.terminal !== undefined) throw new PromptExecutionBusyError();\n\t\t\t\t// Runtime-owned identities cannot collide with reused model toolCallIds.\n\t\t\t\tconst execution = Symbol();\n\t\t\t\tconst requiresAudit = this.auditsLateSettlement();\n\t\t\t\towner?.executions.add(execution);\n\t\t\t\ttry {\n\t\t\t\t\treturn await tool.execute(...args);\n\t\t\t\t} finally {\n\t\t\t\t\towner?.executions.delete(execution);\n\t\t\t\t\t// Audit mode flushes only after the late event has been delivered.\n\t\t\t\t\tif (!requiresAudit) this.flush();\n\t\t\t\t}\n\t\t\t},\n\t\t};\n\t}\n\n\t/** Called after the root producer drains, or after late-settlement event delivery. */\n\tflush(): void {\n\t\tconst owner = this.owner;\n\t\tif (!owner?.terminal || owner.executions.size > 0 || this.disposed || !this.canSettle()) return;\n\t\tconst state = reducePromptSettlement(createPromptSettlementState(owner.promptRunId, owner.startedAt), {\n\t\t\tkind: \"terminal\",\n\t\t\toutcome: owner.terminal.outcome,\n\t\t});\n\t\tconst { event } = settlePromptIfReady(state, performance.now());\n\t\tthis.owner = undefined;\n\t\tif (event !== null) owner.terminal.notify(event);\n\t}\n\n\tdispose(): void {\n\t\tthis.disposed = true;\n\t\tthis.owner = undefined;\n\t}\n}\n"]}

package/dist/core/session-run-budget.d.ts

@@ -0,0 +1,28 @@
+import type { Agent, StreamFn } from "omk-agent-core";
+import { RunBudget, type RunBudgetSnapshot } from "./run-budget.ts";
+import { RunBudgetExceededError, type RunBudgetLimits, RunBudgetPolicyError } from "./run-budget-policy.ts";
+interface RunBudgetLifecycle {
+    readonly assertIdle: () => void;
+    readonly stop: (error: RunBudgetExceededError) => void;
+    readonly reject: (error: RunBudgetExceededError | RunBudgetPolicyError) => void;
+}
+/** Installs one scoped stream boundary; restores it without overwriting a later owner. */
+export declare class SessionRunBudget {
+    private readonly agent;
+    private readonly lifecycle;
+    private current;
+    private previous;
+    private executing;
+    private disposed;
+    constructor(agent: Agent, lifecycle: RunBudgetLifecycle);
+    get failure(): RunBudgetExceededError | undefined;
+    get remainingMs(): number | undefined;
+    snapshot(): RunBudgetSnapshot | undefined;
+    assertActive(): void;
+    assertAdmission(): void;
+    close(): void;
+    execute(limits: RunBudgetLimits | undefined, operation: () => Promise<void>, preflightResult?: (accepted: boolean) => void): Promise<void>;
+}
+export declare function wrapBudgetStream(source: StreamFn, budget: RunBudget): StreamFn;
+export {};
+//# sourceMappingURL=session-run-budget.d.ts.map

package/dist/core/session-run-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-run-budget.d.ts","sourceRoot":"","sources":["../../src/core/session-run-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,KAAK,eAAe,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG5G,UAAU,kBAAkB;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,sBAAsB,GAAG,oBAAoB,KAAK,IAAI,CAAC;CAChF;AAED,0FAA0F;AAC1F,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IAEzB,YAAY,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAGtD;IAED,IAAI,OAAO,IAAI,sBAAsB,GAAG,SAAS,CAEhD;IACD,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IACD,QAAQ,IAAI,iBAAiB,GAAG,SAAS,CAExC;IACD,YAAY,IAAI,IAAI,CAEnB;IACD,eAAe,IAAI,IAAI,CAEtB;IACD,KAAK,IAAI,IAAI,CAGZ;IAEK,OAAO,CACZ,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC9B,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAC3C,OAAO,CAAC,IAAI,CAAC,CAmDf;CACD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,CA6B9E","sourcesContent":["import type { Agent, StreamFn } from \"omk-agent-core\";\nimport { RunBudget, type RunBudgetSnapshot } from \"./run-budget.ts\";\nimport { RunBudgetExceededError, type RunBudgetLimits, RunBudgetPolicyError } from \"./run-budget-policy.ts\";\nimport { PromptExecutionBusyError } from \"./session-prompt-lifecycle.ts\";\n\ninterface RunBudgetLifecycle {\n\treadonly assertIdle: () => void;\n\treadonly stop: (error: RunBudgetExceededError) => void;\n\treadonly reject: (error: RunBudgetExceededError | RunBudgetPolicyError) => void;\n}\n\n/** Installs one scoped stream boundary; restores it without overwriting a later owner. */\nexport class SessionRunBudget {\n\tprivate readonly agent: Agent;\n\tprivate readonly lifecycle: RunBudgetLifecycle;\n\tprivate current: RunBudget | undefined;\n\tprivate previous: RunBudget | undefined;\n\tprivate executing = false;\n\tprivate disposed = false;\n\n\tconstructor(agent: Agent, lifecycle: RunBudgetLifecycle) {\n\t\tthis.agent = agent;\n\t\tthis.lifecycle = lifecycle;\n\t}\n\n\tget failure(): RunBudgetExceededError | undefined {\n\t\treturn this.current?.failure;\n\t}\n\tget remainingMs(): number | undefined {\n\t\treturn this.current?.remainingMs;\n\t}\n\tsnapshot(): RunBudgetSnapshot | undefined {\n\t\treturn (this.current ?? this.previous)?.snapshot();\n\t}\n\tassertActive(): void {\n\t\tthis.current?.assertActive();\n\t}\n\tassertAdmission(): void {\n\t\tthis.current?.assertAdmission();\n\t}\n\tclose(): void {\n\t\tthis.disposed = true;\n\t\tthis.current?.close();\n\t}\n\n\tasync execute(\n\t\tlimits: RunBudgetLimits | undefined,\n\t\toperation: () => Promise<void>,\n\t\tpreflightResult?: (accepted: boolean) => void,\n\t): Promise<void> {\n\t\tlet ownsScope = false;\n\t\tlet entered = false;\n\t\tlet budget: RunBudget | undefined;\n\t\tconst source = this.agent.streamFn;\n\t\tconst sourceAuth = this.agent.getApiKey;\n\t\tlet wrapped: StreamFn | undefined;\n\t\tlet wrappedAuth: Agent[\"getApiKey\"];\n\t\ttry {\n\t\t\tif (this.executing || this.disposed || (this.previous?.snapshot().activeRequests ?? 0) > 0) {\n\t\t\t\tthrow new PromptExecutionBusyError();\n\t\t\t}\n\t\t\tthis.executing = true;\n\t\t\townsScope = true;\n\t\t\tif (limits !== undefined) {\n\t\t\t\tif (this.agent.state.isStreaming) throw new PromptExecutionBusyError();\n\t\t\t\tthis.lifecycle.assertIdle();\n\t\t\t\tconst scopedBudget = new RunBudget(limits, this.lifecycle.stop);\n\t\t\t\tbudget = scopedBudget;\n\t\t\t\tthis.current = scopedBudget;\n\t\t\t\twrapped = wrapBudgetStream(source, scopedBudget);\n\t\t\t\twrappedAuth = async (provider) => {\n\t\t\t\t\tscopedBudget.assertAdmission();\n\t\t\t\t\tconst key = await sourceAuth?.(provider);\n\t\t\t\t\tscopedBudget.assertActive();\n\t\t\t\t\treturn key;\n\t\t\t\t};\n\t\t\t\tthis.agent.streamFn = wrapped;\n\t\t\t\tthis.agent.getApiKey = wrappedAuth;\n\t\t\t\tscopedBudget.assertAdmission();\n\t\t\t}\n\t\t\tentered = true;\n\t\t\tawait operation();\n\t\t\tbudget?.assertActive();\n\t\t} catch (error) {\n\t\t\tif (!entered) {\n\t\t\t\tpreflightResult?.(false);\n\t\t\t\tif (error instanceof RunBudgetExceededError || error instanceof RunBudgetPolicyError)\n\t\t\t\t\tthis.lifecycle.reject(error);\n\t\t\t}\n\t\t\tthrow budget?.failure ?? error;\n\t\t} finally {\n\t\t\tif (budget) {\n\t\t\t\tbudget.close();\n\t\t\t\tthis.previous = budget;\n\t\t\t\tif (this.current === budget) this.current = undefined;\n\t\t\t}\n\t\t\tif (wrapped !== undefined && this.agent.streamFn === wrapped) this.agent.streamFn = source;\n\t\t\tif (wrappedAuth !== undefined && this.agent.getApiKey === wrappedAuth) this.agent.getApiKey = sourceAuth;\n\t\t\tif (ownsScope) this.executing = false;\n\t\t}\n\t}\n}\n\nexport function wrapBudgetStream(source: StreamFn, budget: RunBudget): StreamFn {\n\tconst wrapped: StreamFn = async (model, context, options) => {\n\t\toptions?.signal?.throwIfAborted();\n\t\tconst release = budget.admit();\n\t\tconst remainingMs = budget.remainingMs;\n\t\ttry {\n\t\t\tconst stream = await source(model, context, {\n\t\t\t\t...options,\n\t\t\t\tsignal: options?.signal ? AbortSignal.any([options.signal, budget.signal]) : budget.signal,\n\t\t\t\tmaxRetries: 0,\n\t\t\t\t...(remainingMs === undefined\n\t\t\t\t\t? {}\n\t\t\t\t\t: { timeoutMs: Math.min(options?.timeoutMs ?? remainingMs, remainingMs) }),\n\t\t\t});\n\t\t\t// A returned stream is not yet a completed request. Missing terminal metadata\n\t\t\t// retains the reservation; abort alone never refunds it.\n\t\t\tvoid stream.result().then(release, release);\n\t\t\treturn stream;\n\t\t} catch (error) {\n\t\t\trelease();\n\t\t\tthrow error;\n\t\t}\n\t};\n\t// Preserve source-owned identity brands used by mandatory credential checks.\n\tfor (const key of Object.getOwnPropertySymbols(source)) {\n\t\tconst descriptor = Object.getOwnPropertyDescriptor(source, key);\n\t\tif (descriptor) Object.defineProperty(wrapped, key, descriptor);\n\t}\n\treturn wrapped;\n}\n"]}

package/dist/core/session-run-budget.js

@@ -0,0 +1,127 @@
+import { RunBudget } from "./run-budget.js";
+import { RunBudgetExceededError, RunBudgetPolicyError } from "./run-budget-policy.js";
+import { PromptExecutionBusyError } from "./session-prompt-lifecycle.js";
+/** Installs one scoped stream boundary; restores it without overwriting a later owner. */
+export class SessionRunBudget {
+    agent;
+    lifecycle;
+    current;
+    previous;
+    executing = false;
+    disposed = false;
+    constructor(agent, lifecycle) {
+        this.agent = agent;
+        this.lifecycle = lifecycle;
+    }
+    get failure() {
+        return this.current?.failure;
+    }
+    get remainingMs() {
+        return this.current?.remainingMs;
+    }
+    snapshot() {
+        return (this.current ?? this.previous)?.snapshot();
+    }
+    assertActive() {
+        this.current?.assertActive();
+    }
+    assertAdmission() {
+        this.current?.assertAdmission();
+    }
+    close() {
+        this.disposed = true;
+        this.current?.close();
+    }
+    async execute(limits, operation, preflightResult) {
+        let ownsScope = false;
+        let entered = false;
+        let budget;
+        const source = this.agent.streamFn;
+        const sourceAuth = this.agent.getApiKey;
+        let wrapped;
+        let wrappedAuth;
+        try {
+            if (this.executing || this.disposed || (this.previous?.snapshot().activeRequests ?? 0) > 0) {
+                throw new PromptExecutionBusyError();
+            }
+            this.executing = true;
+            ownsScope = true;
+            if (limits !== undefined) {
+                if (this.agent.state.isStreaming)
+                    throw new PromptExecutionBusyError();
+                this.lifecycle.assertIdle();
+                const scopedBudget = new RunBudget(limits, this.lifecycle.stop);
+                budget = scopedBudget;
+                this.current = scopedBudget;
+                wrapped = wrapBudgetStream(source, scopedBudget);
+                wrappedAuth = async (provider) => {
+                    scopedBudget.assertAdmission();
+                    const key = await sourceAuth?.(provider);
+                    scopedBudget.assertActive();
+                    return key;
+                };
+                this.agent.streamFn = wrapped;
+                this.agent.getApiKey = wrappedAuth;
+                scopedBudget.assertAdmission();
+            }
+            entered = true;
+            await operation();
+            budget?.assertActive();
+        }
+        catch (error) {
+            if (!entered) {
+                preflightResult?.(false);
+                if (error instanceof RunBudgetExceededError || error instanceof RunBudgetPolicyError)
+                    this.lifecycle.reject(error);
+            }
+            throw budget?.failure ?? error;
+        }
+        finally {
+            if (budget) {
+                budget.close();
+                this.previous = budget;
+                if (this.current === budget)
+                    this.current = undefined;
+            }
+            if (wrapped !== undefined && this.agent.streamFn === wrapped)
+                this.agent.streamFn = source;
+            if (wrappedAuth !== undefined && this.agent.getApiKey === wrappedAuth)
+                this.agent.getApiKey = sourceAuth;
+            if (ownsScope)
+                this.executing = false;
+        }
+    }
+}
+export function wrapBudgetStream(source, budget) {
+    const wrapped = async (model, context, options) => {
+        options?.signal?.throwIfAborted();
+        const release = budget.admit();
+        const remainingMs = budget.remainingMs;
+        try {
+            const stream = await source(model, context, {
+                ...options,
+                signal: options?.signal ? AbortSignal.any([options.signal, budget.signal]) : budget.signal,
+                maxRetries: 0,
+                ...(remainingMs === undefined
+                    ? {}
+                    : { timeoutMs: Math.min(options?.timeoutMs ?? remainingMs, remainingMs) }),
+            });
+            // A returned stream is not yet a completed request. Missing terminal metadata
+            // retains the reservation; abort alone never refunds it.
+            void stream.result().then(release, release);
+            return stream;
+        }
+        catch (error) {
+            release();
+            throw error;
+        }
+    };
+    // Preserve source-owned identity brands used by mandatory credential checks.
+    for (const key of Object.getOwnPropertySymbols(source)) {
+        const descriptor = Object.getOwnPropertyDescriptor(source, key);
+        if (descriptor)
+            Object.defineProperty(wrapped, key, descriptor);
+    }
+    return wrapped;
+}
+//# sourceMappingURL=session-run-budget.js.map

package/dist/core/session-run-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-run-budget.js","sourceRoot":"","sources":["../../src/core/session-run-budget.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Agent, StreamFn } from \"omk-agent-core\";\nimport { RunBudget, type RunBudgetSnapshot } from \"./run-budget.ts\";\nimport { RunBudgetExceededError, type RunBudgetLimits, RunBudgetPolicyError } from \"./run-budget-policy.ts\";\nimport { PromptExecutionBusyError } from \"./session-prompt-lifecycle.ts\";\n\ninterface RunBudgetLifecycle {\n\treadonly assertIdle: () => void;\n\treadonly stop: (error: RunBudgetExceededError) => void;\n\treadonly reject: (error: RunBudgetExceededError | RunBudgetPolicyError) => void;\n}\n\n/** Installs one scoped stream boundary; restores it without overwriting a later owner. */\nexport class SessionRunBudget {\n\tprivate readonly agent: Agent;\n\tprivate readonly lifecycle: RunBudgetLifecycle;\n\tprivate current: RunBudget | undefined;\n\tprivate previous: RunBudget | undefined;\n\tprivate executing = false;\n\tprivate disposed = false;\n\n\tconstructor(agent: Agent, lifecycle: RunBudgetLifecycle) {\n\t\tthis.agent = agent;\n\t\tthis.lifecycle = lifecycle;\n\t}\n\n\tget failure(): RunBudgetExceededError | undefined {\n\t\treturn this.current?.failure;\n\t}\n\tget remainingMs(): number | undefined {\n\t\treturn this.current?.remainingMs;\n\t}\n\tsnapshot(): RunBudgetSnapshot | undefined {\n\t\treturn (this.current ?? this.previous)?.snapshot();\n\t}\n\tassertActive(): void {\n\t\tthis.current?.assertActive();\n\t}\n\tassertAdmission(): void {\n\t\tthis.current?.assertAdmission();\n\t}\n\tclose(): void {\n\t\tthis.disposed = true;\n\t\tthis.current?.close();\n\t}\n\n\tasync execute(\n\t\tlimits: RunBudgetLimits | undefined,\n\t\toperation: () => Promise<void>,\n\t\tpreflightResult?: (accepted: boolean) => void,\n\t): Promise<void> {\n\t\tlet ownsScope = false;\n\t\tlet entered = false;\n\t\tlet budget: RunBudget | undefined;\n\t\tconst source = this.agent.streamFn;\n\t\tconst sourceAuth = this.agent.getApiKey;\n\t\tlet wrapped: StreamFn | undefined;\n\t\tlet wrappedAuth: Agent[\"getApiKey\"];\n\t\ttry {\n\t\t\tif (this.executing || this.disposed || (this.previous?.snapshot().activeRequests ?? 0) > 0) {\n\t\t\t\tthrow new PromptExecutionBusyError();\n\t\t\t}\n\t\t\tthis.executing = true;\n\t\t\townsScope = true;\n\t\t\tif (limits !== undefined) {\n\t\t\t\tif (this.agent.state.isStreaming) throw new PromptExecutionBusyError();\n\t\t\t\tthis.lifecycle.assertIdle();\n\t\t\t\tconst scopedBudget = new RunBudget(limits, this.lifecycle.stop);\n\t\t\t\tbudget = scopedBudget;\n\t\t\t\tthis.current = scopedBudget;\n\t\t\t\twrapped = wrapBudgetStream(source, scopedBudget);\n\t\t\t\twrappedAuth = async (provider) => {\n\t\t\t\t\tscopedBudget.assertAdmission();\n\t\t\t\t\tconst key = await sourceAuth?.(provider);\n\t\t\t\t\tscopedBudget.assertActive();\n\t\t\t\t\treturn key;\n\t\t\t\t};\n\t\t\t\tthis.agent.streamFn = wrapped;\n\t\t\t\tthis.agent.getApiKey = wrappedAuth;\n\t\t\t\tscopedBudget.assertAdmission();\n\t\t\t}\n\t\t\tentered = true;\n\t\t\tawait operation();\n\t\t\tbudget?.assertActive();\n\t\t} catch (error) {\n\t\t\tif (!entered) {\n\t\t\t\tpreflightResult?.(false);\n\t\t\t\tif (error instanceof RunBudgetExceededError || error instanceof RunBudgetPolicyError)\n\t\t\t\t\tthis.lifecycle.reject(error);\n\t\t\t}\n\t\t\tthrow budget?.failure ?? error;\n\t\t} finally {\n\t\t\tif (budget) {\n\t\t\t\tbudget.close();\n\t\t\t\tthis.previous = budget;\n\t\t\t\tif (this.current === budget) this.current = undefined;\n\t\t\t}\n\t\t\tif (wrapped !== undefined && this.agent.streamFn === wrapped) this.agent.streamFn = source;\n\t\t\tif (wrappedAuth !== undefined && this.agent.getApiKey === wrappedAuth) this.agent.getApiKey = sourceAuth;\n\t\t\tif (ownsScope) this.executing = false;\n\t\t}\n\t}\n}\n\nexport function wrapBudgetStream(source: StreamFn, budget: RunBudget): StreamFn {\n\tconst wrapped: StreamFn = async (model, context, options) => {\n\t\toptions?.signal?.throwIfAborted();\n\t\tconst release = budget.admit();\n\t\tconst remainingMs = budget.remainingMs;\n\t\ttry {\n\t\t\tconst stream = await source(model, context, {\n\t\t\t\t...options,\n\t\t\t\tsignal: options?.signal ? AbortSignal.any([options.signal, budget.signal]) : budget.signal,\n\t\t\t\tmaxRetries: 0,\n\t\t\t\t...(remainingMs === undefined\n\t\t\t\t\t? {}\n\t\t\t\t\t: { timeoutMs: Math.min(options?.timeoutMs ?? remainingMs, remainingMs) }),\n\t\t\t});\n\t\t\t// A returned stream is not yet a completed request. Missing terminal metadata\n\t\t\t// retains the reservation; abort alone never refunds it.\n\t\t\tvoid stream.result().then(release, release);\n\t\t\treturn stream;\n\t\t} catch (error) {\n\t\t\trelease();\n\t\t\tthrow error;\n\t\t}\n\t};\n\t// Preserve source-owned identity brands used by mandatory credential checks.\n\tfor (const key of Object.getOwnPropertySymbols(source)) {\n\t\tconst descriptor = Object.getOwnPropertyDescriptor(source, key);\n\t\tif (descriptor) Object.defineProperty(wrapped, key, descriptor);\n\t}\n\treturn wrapped;\n}\n"]}

package/dist/core/session-run-termination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-run-termination.d.ts","sourceRoot":"","sources":["../../src/core/session-run-termination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,GAAG,EAAoB,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE3D,OAAO,EACN,KAAK,+BAA+B,EAEpC,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,MAAM,0BAA0B,CAAC;AAElC,UAAU,qBAAsB,SAAQ,IAAI,CAAC,+BAA+B,EAAE,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;IACjH,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,eAAe,CAAC,CAAC;IACvE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE;QACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;KACnC,CAAC;CACF;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,OAAO,EAAE,qBAAqB,GAC5B,kBAAkB,CAuDpB","sourcesContent":["import type { AgentMessage } from \"omk-agent-core\";\nimport type { Api, AssistantMessage, Model } from \"omk-ai\";\nimport { providerFailureCause, terminationMessage } from \"./session-failure-cause.ts\";\nimport {\n\ttype ClassifySessionTerminationInput,\n\tclassifySessionTermination,\n\ttype SessionTermination,\n\ttype SessionTerminationCause,\n} from \"./session-termination.ts\";\n\ninterface RunTerminationContext extends Pick<ClassifySessionTerminationInput, \"sessionId\" | \"runId\" | \"timestamp\"> {\n\treadonly model?: Pick<Model<Api>, \"provider\" | \"id\" | \"contextWindow\">;\n\treadonly elevatedRisk: boolean;\n\treadonly userAbortRequested: boolean;\n\treadonly pendingCause?: SessionTerminationCause;\n\treadonly toolTimeout?: {\n\t\treadonly toolCallId: string;\n\t\treadonly toolName: string;\n\t\treadonly executionStarted: boolean;\n\t};\n}\n\n/** Translate one settled core run into a cause; lifecycle persistence stays with AgentSession. */\nexport function classifyRunTermination(\n\tmessages: readonly AgentMessage[],\n\tcontext: RunTerminationContext,\n): SessionTermination {\n\tlet assistant: AssistantMessage | undefined;\n\tfor (let index = messages.length - 1; index >= 0; index--) {\n\t\tconst candidate = messages[index];\n\t\tif (candidate?.role === \"assistant\") {\n\t\t\tassistant = candidate;\n\t\t\tbreak;\n\t\t}\n\t}\n\tlet cause: SessionTerminationCause;\n\tlet message: string;\n\tlet sideEffects: \"none\" | \"possible\" = context.elevatedRisk ? \"possible\" : \"none\";\n\tlet toolCallId: string | undefined;\n\tlet toolName: string | undefined;\n\n\tif (context.toolTimeout) {\n\t\tcause = { area: \"tool\", code: \"timeout\" };\n\t\tmessage = `Tool ${context.toolTimeout.toolName} timed out.`;\n\t\ttoolCallId = context.toolTimeout.toolCallId;\n\t\ttoolName = context.toolTimeout.toolName;\n\t\tsideEffects = context.toolTimeout.executionStarted ? \"possible\" : sideEffects;\n\t} else if (context.pendingCause?.area === \"configuration\") {\n\t\tcause = context.pendingCause;\n\t\tmessage = \"Model dispatch was rejected by the configured model contract.\";\n\t} else if (!assistant) {\n\t\tcause = { area: \"internal\", code: \"unclassified\" };\n\t\tmessage = \"Agent run ended without an assistant result.\";\n\t} else if (assistant.stopReason === \"aborted\") {\n\t\tcause = context.userAbortRequested ? { area: \"user\", code: \"abort\" } : { area: \"provider\", code: \"abort\" };\n\t\tmessage = terminationMessage(\n\t\t\tassistant.errorMessage,\n\t\t\tcontext.userAbortRequested ? \"The user aborted the run.\" : \"The provider aborted the run.\",\n\t\t);\n\t} else if (assistant.stopReason === \"error\") {\n\t\tcause = providerFailureCause(assistant, context.model?.contextWindow ?? 0);\n\t\tmessage = terminationMessage(assistant.errorMessage, \"The provider request failed.\");\n\t} else {\n\t\tcause = { area: \"completed\" };\n\t\tmessage = \"Run completed.\";\n\t}\n\tconst provider = assistant?.provider || context.model?.provider;\n\tconst model = assistant?.model || context.model?.id;\n\treturn classifySessionTermination({\n\t\tsessionId: context.sessionId,\n\t\trunId: context.runId,\n\t\ttimestamp: context.timestamp,\n\t\tsource: \"observed\",\n\t\tmessage,\n\t\tcause,\n\t\tsideEffects,\n\t\t...(provider ? { provider } : {}),\n\t\t...(model ? { model } : {}),\n\t\t...(toolCallId ? { toolCallId } : {}),\n\t\t...(toolName ? { toolName } : {}),\n\t});\n}\n"]}
+{"version":3,"file":"session-run-termination.d.ts","sourceRoot":"","sources":["../../src/core/session-run-termination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,GAAG,EAAoB,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE3D,OAAO,EACN,KAAK,+BAA+B,EAEpC,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,MAAM,0BAA0B,CAAC;AAElC,UAAU,qBAAsB,SAAQ,IAAI,CAAC,+BAA+B,EAAE,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;IACjH,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,eAAe,CAAC,CAAC;IACvE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE;QACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;KACnC,CAAC;CACF;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,OAAO,EAAE,qBAAqB,GAC5B,kBAAkB,CA4DpB","sourcesContent":["import type { AgentMessage } from \"omk-agent-core\";\nimport type { Api, AssistantMessage, Model } from \"omk-ai\";\nimport { providerFailureCause, terminationMessage } from \"./session-failure-cause.ts\";\nimport {\n\ttype ClassifySessionTerminationInput,\n\tclassifySessionTermination,\n\ttype SessionTermination,\n\ttype SessionTerminationCause,\n} from \"./session-termination.ts\";\n\ninterface RunTerminationContext extends Pick<ClassifySessionTerminationInput, \"sessionId\" | \"runId\" | \"timestamp\"> {\n\treadonly model?: Pick<Model<Api>, \"provider\" | \"id\" | \"contextWindow\">;\n\treadonly elevatedRisk: boolean;\n\treadonly userAbortRequested: boolean;\n\treadonly pendingCause?: SessionTerminationCause;\n\treadonly toolTimeout?: {\n\t\treadonly toolCallId: string;\n\t\treadonly toolName: string;\n\t\treadonly executionStarted: boolean;\n\t};\n}\n\n/** Translate one settled core run into a cause; lifecycle persistence stays with AgentSession. */\nexport function classifyRunTermination(\n\tmessages: readonly AgentMessage[],\n\tcontext: RunTerminationContext,\n): SessionTermination {\n\tlet assistant: AssistantMessage | undefined;\n\tfor (let index = messages.length - 1; index >= 0; index--) {\n\t\tconst candidate = messages[index];\n\t\tif (candidate?.role === \"assistant\") {\n\t\t\tassistant = candidate;\n\t\t\tbreak;\n\t\t}\n\t}\n\tlet cause: SessionTerminationCause;\n\tlet message: string;\n\tlet sideEffects: \"none\" | \"possible\" = context.elevatedRisk ? \"possible\" : \"none\";\n\tlet toolCallId: string | undefined;\n\tlet toolName: string | undefined;\n\n\tif (context.pendingCause?.area === \"budget\") {\n\t\tcause = context.pendingCause;\n\t\tmessage = `Run budget exhausted: ${context.pendingCause.code}`;\n\t\tsideEffects = \"possible\";\n\t} else if (context.toolTimeout) {\n\t\tcause = { area: \"tool\", code: \"timeout\" };\n\t\tmessage = `Tool ${context.toolTimeout.toolName} timed out.`;\n\t\ttoolCallId = context.toolTimeout.toolCallId;\n\t\ttoolName = context.toolTimeout.toolName;\n\t\tsideEffects = context.toolTimeout.executionStarted ? \"possible\" : sideEffects;\n\t} else if (context.pendingCause?.area === \"configuration\") {\n\t\tcause = context.pendingCause;\n\t\tmessage = \"Model dispatch was rejected by the configured model contract.\";\n\t} else if (context.userAbortRequested) {\n\t\tcause = { area: \"user\", code: \"abort\" };\n\t\tmessage = \"The user aborted the run.\";\n\t\tif (messages.some((entry) => entry.role === \"toolResult\")) sideEffects = \"possible\";\n\t} else if (!assistant) {\n\t\tcause = { area: \"internal\", code: \"unclassified\" };\n\t\tmessage = \"Agent run ended without an assistant result.\";\n\t} else if (assistant.stopReason === \"aborted\") {\n\t\tcause = { area: \"provider\", code: \"abort\" };\n\t\tmessage = terminationMessage(assistant.errorMessage, \"The provider aborted the run.\");\n\t} else if (assistant.stopReason === \"error\") {\n\t\tcause = providerFailureCause(assistant, context.model?.contextWindow ?? 0);\n\t\tmessage = terminationMessage(assistant.errorMessage, \"The provider request failed.\");\n\t} else {\n\t\tcause = { area: \"completed\" };\n\t\tmessage = \"Run completed.\";\n\t}\n\tconst provider = assistant?.provider || context.model?.provider;\n\tconst model = assistant?.model || context.model?.id;\n\treturn classifySessionTermination({\n\t\tsessionId: context.sessionId,\n\t\trunId: context.runId,\n\t\ttimestamp: context.timestamp,\n\t\tsource: \"observed\",\n\t\tmessage,\n\t\tcause,\n\t\tsideEffects,\n\t\t...(provider ? { provider } : {}),\n\t\t...(model ? { model } : {}),\n\t\t...(toolCallId ? { toolCallId } : {}),\n\t\t...(toolName ? { toolName } : {}),\n\t});\n}\n"]}

package/dist/core/session-run-termination.js

@@ -15,7 +15,12 @@ export function classifyRunTermination(messages, context) {
     let sideEffects = context.elevatedRisk ? "possible" : "none";
     let toolCallId;
     let toolName;
-    if (context.toolTimeout) {
+    if (context.pendingCause?.area === "budget") {
+        cause = context.pendingCause;
+        message = `Run budget exhausted: ${context.pendingCause.code}`;
+        sideEffects = "possible";
+    }
+    else if (context.toolTimeout) {
         cause = { area: "tool", code: "timeout" };
         message = `Tool ${context.toolTimeout.toolName} timed out.`;
         toolCallId = context.toolTimeout.toolCallId;
@@ -26,13 +31,19 @@ export function classifyRunTermination(messages, context) {
         cause = context.pendingCause;
         message = "Model dispatch was rejected by the configured model contract.";
     }
+    else if (context.userAbortRequested) {
+        cause = { area: "user", code: "abort" };
+        message = "The user aborted the run.";
+        if (messages.some((entry) => entry.role === "toolResult"))
+            sideEffects = "possible";
+    }
     else if (!assistant) {
         cause = { area: "internal", code: "unclassified" };
         message = "Agent run ended without an assistant result.";
     }
     else if (assistant.stopReason === "aborted") {
-        cause = context.userAbortRequested ? { area: "user", code: "abort" } : { area: "provider", code: "abort" };
-        message = terminationMessage(assistant.errorMessage, context.userAbortRequested ? "The user aborted the run." : "The provider aborted the run.");
+        cause = { area: "provider", code: "abort" };
+        message = terminationMessage(assistant.errorMessage, "The provider aborted the run.");
     }
     else if (assistant.stopReason === "error") {
         cause = providerFailureCause(assistant, context.model?.contextWindow ?? 0);

package/dist/core/session-run-termination.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-run-termination.js","sourceRoot":"","sources":["../../src/core/session-run-termination.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentMessage } from \"omk-agent-core\";\nimport type { Api, AssistantMessage, Model } from \"omk-ai\";\nimport { providerFailureCause, terminationMessage } from \"./session-failure-cause.ts\";\nimport {\n\ttype ClassifySessionTerminationInput,\n\tclassifySessionTermination,\n\ttype SessionTermination,\n\ttype SessionTerminationCause,\n} from \"./session-termination.ts\";\n\ninterface RunTerminationContext extends Pick<ClassifySessionTerminationInput, \"sessionId\" | \"runId\" | \"timestamp\"> {\n\treadonly model?: Pick<Model<Api>, \"provider\" | \"id\" | \"contextWindow\">;\n\treadonly elevatedRisk: boolean;\n\treadonly userAbortRequested: boolean;\n\treadonly pendingCause?: SessionTerminationCause;\n\treadonly toolTimeout?: {\n\t\treadonly toolCallId: string;\n\t\treadonly toolName: string;\n\t\treadonly executionStarted: boolean;\n\t};\n}\n\n/** Translate one settled core run into a cause; lifecycle persistence stays with AgentSession. */\nexport function classifyRunTermination(\n\tmessages: readonly AgentMessage[],\n\tcontext: RunTerminationContext,\n): SessionTermination {\n\tlet assistant: AssistantMessage | undefined;\n\tfor (let index = messages.length - 1; index >= 0; index--) {\n\t\tconst candidate = messages[index];\n\t\tif (candidate?.role === \"assistant\") {\n\t\t\tassistant = candidate;\n\t\t\tbreak;\n\t\t}\n\t}\n\tlet cause: SessionTerminationCause;\n\tlet message: string;\n\tlet sideEffects: \"none\" | \"possible\" = context.elevatedRisk ? \"possible\" : \"none\";\n\tlet toolCallId: string | undefined;\n\tlet toolName: string | undefined;\n\n\tif (context.toolTimeout) {\n\t\tcause = { area: \"tool\", code: \"timeout\" };\n\t\tmessage = `Tool ${context.toolTimeout.toolName} timed out.`;\n\t\ttoolCallId = context.toolTimeout.toolCallId;\n\t\ttoolName = context.toolTimeout.toolName;\n\t\tsideEffects = context.toolTimeout.executionStarted ? \"possible\" : sideEffects;\n\t} else if (context.pendingCause?.area === \"configuration\") {\n\t\tcause = context.pendingCause;\n\t\tmessage = \"Model dispatch was rejected by the configured model contract.\";\n\t} else if (!assistant) {\n\t\tcause = { area: \"internal\", code: \"unclassified\" };\n\t\tmessage = \"Agent run ended without an assistant result.\";\n\t} else if (assistant.stopReason === \"aborted\") {\n\t\tcause = context.userAbortRequested ? { area: \"user\", code: \"abort\" } : { area: \"provider\", code: \"abort\" };\n\t\tmessage = terminationMessage(\n\t\t\tassistant.errorMessage,\n\t\t\tcontext.userAbortRequested ? \"The user aborted the run.\" : \"The provider aborted the run.\",\n\t\t);\n\t} else if (assistant.stopReason === \"error\") {\n\t\tcause = providerFailureCause(assistant, context.model?.contextWindow ?? 0);\n\t\tmessage = terminationMessage(assistant.errorMessage, \"The provider request failed.\");\n\t} else {\n\t\tcause = { area: \"completed\" };\n\t\tmessage = \"Run completed.\";\n\t}\n\tconst provider = assistant?.provider || context.model?.provider;\n\tconst model = assistant?.model || context.model?.id;\n\treturn classifySessionTermination({\n\t\tsessionId: context.sessionId,\n\t\trunId: context.runId,\n\t\ttimestamp: context.timestamp,\n\t\tsource: \"observed\",\n\t\tmessage,\n\t\tcause,\n\t\tsideEffects,\n\t\t...(provider ? { provider } : {}),\n\t\t...(model ? { model } : {}),\n\t\t...(toolCallId ? { toolCallId } : {}),\n\t\t...(toolName ? { toolName } : {}),\n\t});\n}\n"]}
+{"version":3,"file":"session-run-termination.js","sourceRoot":"","sources":["../../src/core/session-run-termination.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentMessage } from \"omk-agent-core\";\nimport type { Api, AssistantMessage, Model } from \"omk-ai\";\nimport { providerFailureCause, terminationMessage } from \"./session-failure-cause.ts\";\nimport {\n\ttype ClassifySessionTerminationInput,\n\tclassifySessionTermination,\n\ttype SessionTermination,\n\ttype SessionTerminationCause,\n} from \"./session-termination.ts\";\n\ninterface RunTerminationContext extends Pick<ClassifySessionTerminationInput, \"sessionId\" | \"runId\" | \"timestamp\"> {\n\treadonly model?: Pick<Model<Api>, \"provider\" | \"id\" | \"contextWindow\">;\n\treadonly elevatedRisk: boolean;\n\treadonly userAbortRequested: boolean;\n\treadonly pendingCause?: SessionTerminationCause;\n\treadonly toolTimeout?: {\n\t\treadonly toolCallId: string;\n\t\treadonly toolName: string;\n\t\treadonly executionStarted: boolean;\n\t};\n}\n\n/** Translate one settled core run into a cause; lifecycle persistence stays with AgentSession. */\nexport function classifyRunTermination(\n\tmessages: readonly AgentMessage[],\n\tcontext: RunTerminationContext,\n): SessionTermination {\n\tlet assistant: AssistantMessage | undefined;\n\tfor (let index = messages.length - 1; index >= 0; index--) {\n\t\tconst candidate = messages[index];\n\t\tif (candidate?.role === \"assistant\") {\n\t\t\tassistant = candidate;\n\t\t\tbreak;\n\t\t}\n\t}\n\tlet cause: SessionTerminationCause;\n\tlet message: string;\n\tlet sideEffects: \"none\" | \"possible\" = context.elevatedRisk ? \"possible\" : \"none\";\n\tlet toolCallId: string | undefined;\n\tlet toolName: string | undefined;\n\n\tif (context.pendingCause?.area === \"budget\") {\n\t\tcause = context.pendingCause;\n\t\tmessage = `Run budget exhausted: ${context.pendingCause.code}`;\n\t\tsideEffects = \"possible\";\n\t} else if (context.toolTimeout) {\n\t\tcause = { area: \"tool\", code: \"timeout\" };\n\t\tmessage = `Tool ${context.toolTimeout.toolName} timed out.`;\n\t\ttoolCallId = context.toolTimeout.toolCallId;\n\t\ttoolName = context.toolTimeout.toolName;\n\t\tsideEffects = context.toolTimeout.executionStarted ? \"possible\" : sideEffects;\n\t} else if (context.pendingCause?.area === \"configuration\") {\n\t\tcause = context.pendingCause;\n\t\tmessage = \"Model dispatch was rejected by the configured model contract.\";\n\t} else if (context.userAbortRequested) {\n\t\tcause = { area: \"user\", code: \"abort\" };\n\t\tmessage = \"The user aborted the run.\";\n\t\tif (messages.some((entry) => entry.role === \"toolResult\")) sideEffects = \"possible\";\n\t} else if (!assistant) {\n\t\tcause = { area: \"internal\", code: \"unclassified\" };\n\t\tmessage = \"Agent run ended without an assistant result.\";\n\t} else if (assistant.stopReason === \"aborted\") {\n\t\tcause = { area: \"provider\", code: \"abort\" };\n\t\tmessage = terminationMessage(assistant.errorMessage, \"The provider aborted the run.\");\n\t} else if (assistant.stopReason === \"error\") {\n\t\tcause = providerFailureCause(assistant, context.model?.contextWindow ?? 0);\n\t\tmessage = terminationMessage(assistant.errorMessage, \"The provider request failed.\");\n\t} else {\n\t\tcause = { area: \"completed\" };\n\t\tmessage = \"Run completed.\";\n\t}\n\tconst provider = assistant?.provider || context.model?.provider;\n\tconst model = assistant?.model || context.model?.id;\n\treturn classifySessionTermination({\n\t\tsessionId: context.sessionId,\n\t\trunId: context.runId,\n\t\ttimestamp: context.timestamp,\n\t\tsource: \"observed\",\n\t\tmessage,\n\t\tcause,\n\t\tsideEffects,\n\t\t...(provider ? { provider } : {}),\n\t\t...(model ? { model } : {}),\n\t\t...(toolCallId ? { toolCallId } : {}),\n\t\t...(toolName ? { toolName } : {}),\n\t});\n}\n"]}

package/dist/core/session-termination-types.d.ts

@@ -0,0 +1,97 @@
+import type { RunBudgetStopCode } from "./run-budget-policy.ts";
+export declare const SESSION_TERMINATION_SCHEMA_VERSION: 1;
+export declare const MAX_SESSION_TERMINATION_MESSAGE_LENGTH = 512;
+/** The journal validator derives its accepted kinds from this tuple. */
+export declare const SESSION_TERMINATION_KIND_VALUES: readonly ["completed", "user_abort", "provider_abort", "provider_auth", "provider_rate_limit", "provider_network", "provider_protocol", "provider_refusal", "context_overflow", "transcript_invalid", "tool_timeout", "tool_fatal", "compaction", "persistence", "process_signal", "process_crash", "configuration", "internal_error", "resource_pressure", "budget_exhausted"];
+export type SessionTerminationKind = (typeof SESSION_TERMINATION_KIND_VALUES)[number];
+export type SessionTerminationPhase = "completed" | "control" | "preflight" | "provider" | "tool" | "compaction" | "persistence" | "process" | "resume";
+export type SessionTerminationSource = "observed" | "inferred_on_resume";
+export type SessionSideEffects = "none" | "possible" | "confirmed";
+export type SessionProcessSignal = "SIGINT" | "SIGTERM" | "SIGHUP" | "SIGQUIT";
+export type ProviderTerminationCauseCode = "abort" | "auth" | "rate_limit" | "network" | "protocol" | "refusal" | "context_overflow";
+export type ToolTerminationCauseCode = "timeout" | "fatal";
+export type ResourceTerminationCauseCode = "memory" | "disk" | "cpu" | "heap" | "probe_unavailable" | "queue_overflow";
+export type CompactionTerminationCauseCode = "aborted" | "failed" | "stale" | "quota_exhausted";
+export type PersistenceTerminationCauseCode = "read_failed" | "append_failed" | "replace_failed" | "fsync_failed" | "lock_failed";
+export type TranscriptTerminationCauseCode = "missing_result" | "duplicate_result" | "orphan_result" | "duplicate_call_id" | "interleaved_non_result" | "invalid_jsonl" | "invalid_tree" | "unsupported_version" | "trailing_fragment";
+export type SessionTerminationCauseCode = "session.completed" | "session.user_abort" | `provider.${ProviderTerminationCauseCode}` | `tool.${ToolTerminationCauseCode}` | `compaction.${CompactionTerminationCauseCode}` | `persistence.${PersistenceTerminationCauseCode}` | "process.signal" | "process.crash" | `transcript.${TranscriptTerminationCauseCode}` | "configuration.invalid" | "internal.unclassified" | `resource.${ResourceTerminationCauseCode}` | `budget.${RunBudgetStopCode}`;
+export type SessionTerminationCause = {
+    readonly area: "completed";
+} | {
+    readonly area: "user";
+    readonly code: "abort";
+} | {
+    readonly area: "provider";
+    readonly code: ProviderTerminationCauseCode;
+} | {
+    readonly area: "tool";
+    readonly code: ToolTerminationCauseCode;
+} | {
+    readonly area: "compaction";
+    readonly code: CompactionTerminationCauseCode;
+} | {
+    readonly area: "persistence";
+    readonly code: PersistenceTerminationCauseCode;
+} | {
+    readonly area: "process";
+    readonly code: "signal";
+    readonly signal: SessionProcessSignal;
+} | {
+    readonly area: "process";
+    readonly code: "crash";
+} | {
+    readonly area: "transcript";
+    readonly code: TranscriptTerminationCauseCode;
+} | {
+    readonly area: "configuration";
+    readonly code: "invalid";
+} | {
+    readonly area: "internal";
+    readonly code: "unclassified";
+} | {
+    readonly area: "resource";
+    readonly code: ResourceTerminationCauseCode;
+} | {
+    readonly area: "budget";
+    readonly code: RunBudgetStopCode;
+};
+export interface ClassifySessionTerminationInput {
+    readonly sessionId: string;
+    readonly runId: string;
+    /** Deterministic caller-provided ISO-8601 timestamp. */
+    readonly timestamp: string;
+    readonly source: SessionTerminationSource;
+    /** Caller-supplied, pre-redacted diagnostic text. */
+    readonly message: string;
+    readonly cause: SessionTerminationCause;
+    readonly sideEffects: SessionSideEffects;
+    readonly retryAfterMs?: number;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly toolCallId?: string;
+    readonly toolName?: string;
+}
+export interface SessionTermination {
+    readonly schemaVersion: typeof SESSION_TERMINATION_SCHEMA_VERSION;
+    readonly sessionId: string;
+    readonly runId: string;
+    readonly kind: SessionTerminationKind;
+    readonly phase: SessionTerminationPhase;
+    readonly source: SessionTerminationSource;
+    readonly message: string;
+    readonly causeCode: SessionTerminationCauseCode;
+    /** Stable operator guidance suitable for print, JSON, RPC, and TUI surfaces. */
+    readonly nextAction: string;
+    readonly retryable: boolean;
+    readonly safeToAutoRetry: boolean;
+    readonly sideEffects: SessionSideEffects;
+    readonly timestamp: string;
+    readonly retryAfterMs?: number;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly toolCallId?: string;
+    readonly toolName?: string;
+    readonly processSignal?: SessionProcessSignal;
+    readonly transcriptIssue?: TranscriptTerminationCauseCode;
+}
+//# sourceMappingURL=session-termination-types.d.ts.map

package/dist/core/session-termination-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-termination-types.d.ts","sourceRoot":"","sources":["../../src/core/session-termination-types.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RunBudgetStopCode } from \"./run-budget-policy.ts\";\n\nexport const SESSION_TERMINATION_SCHEMA_VERSION = 1 as const;\nexport const MAX_SESSION_TERMINATION_MESSAGE_LENGTH = 512;\n\n/** The journal validator derives its accepted kinds from this tuple. */\nexport const SESSION_TERMINATION_KIND_VALUES = [\n\t\"completed\",\n\t\"user_abort\",\n\t\"provider_abort\",\n\t\"provider_auth\",\n\t\"provider_rate_limit\",\n\t\"provider_network\",\n\t\"provider_protocol\",\n\t\"provider_refusal\",\n\t\"context_overflow\",\n\t\"transcript_invalid\",\n\t\"tool_timeout\",\n\t\"tool_fatal\",\n\t\"compaction\",\n\t\"persistence\",\n\t\"process_signal\",\n\t\"process_crash\",\n\t\"configuration\",\n\t\"internal_error\",\n\t\"resource_pressure\",\n\t\"budget_exhausted\",\n] as const;\nexport type SessionTerminationKind = (typeof SESSION_TERMINATION_KIND_VALUES)[number];\nexport type SessionTerminationPhase =\n\t| \"completed\"\n\t| \"control\"\n\t| \"preflight\"\n\t| \"provider\"\n\t| \"tool\"\n\t| \"compaction\"\n\t| \"persistence\"\n\t| \"process\"\n\t| \"resume\";\nexport type SessionTerminationSource = \"observed\" | \"inferred_on_resume\";\nexport type SessionSideEffects = \"none\" | \"possible\" | \"confirmed\";\nexport type SessionProcessSignal = \"SIGINT\" | \"SIGTERM\" | \"SIGHUP\" | \"SIGQUIT\";\nexport type ProviderTerminationCauseCode =\n\t| \"abort\"\n\t| \"auth\"\n\t| \"rate_limit\"\n\t| \"network\"\n\t| \"protocol\"\n\t| \"refusal\"\n\t| \"context_overflow\";\nexport type ToolTerminationCauseCode = \"timeout\" | \"fatal\";\nexport type ResourceTerminationCauseCode = \"memory\" | \"disk\" | \"cpu\" | \"heap\" | \"probe_unavailable\" | \"queue_overflow\";\nexport type CompactionTerminationCauseCode = \"aborted\" | \"failed\" | \"stale\" | \"quota_exhausted\";\nexport type PersistenceTerminationCauseCode =\n\t| \"read_failed\"\n\t| \"append_failed\"\n\t| \"replace_failed\"\n\t| \"fsync_failed\"\n\t| \"lock_failed\";\nexport type TranscriptTerminationCauseCode =\n\t| \"missing_result\"\n\t| \"duplicate_result\"\n\t| \"orphan_result\"\n\t| \"duplicate_call_id\"\n\t| \"interleaved_non_result\"\n\t| \"invalid_jsonl\"\n\t| \"invalid_tree\"\n\t| \"unsupported_version\"\n\t| \"trailing_fragment\";\nexport type SessionTerminationCauseCode =\n\t| \"session.completed\"\n\t| \"session.user_abort\"\n\t| `provider.${ProviderTerminationCauseCode}`\n\t| `tool.${ToolTerminationCauseCode}`\n\t| `compaction.${CompactionTerminationCauseCode}`\n\t| `persistence.${PersistenceTerminationCauseCode}`\n\t| \"process.signal\"\n\t| \"process.crash\"\n\t| `transcript.${TranscriptTerminationCauseCode}`\n\t| \"configuration.invalid\"\n\t| \"internal.unclassified\"\n\t| `resource.${ResourceTerminationCauseCode}`\n\t| `budget.${RunBudgetStopCode}`;\n\nexport type SessionTerminationCause =\n\t| { readonly area: \"completed\" }\n\t| { readonly area: \"user\"; readonly code: \"abort\" }\n\t| { readonly area: \"provider\"; readonly code: ProviderTerminationCauseCode }\n\t| { readonly area: \"tool\"; readonly code: ToolTerminationCauseCode }\n\t| { readonly area: \"compaction\"; readonly code: CompactionTerminationCauseCode }\n\t| { readonly area: \"persistence\"; readonly code: PersistenceTerminationCauseCode }\n\t| { readonly area: \"process\"; readonly code: \"signal\"; readonly signal: SessionProcessSignal }\n\t| { readonly area: \"process\"; readonly code: \"crash\" }\n\t| { readonly area: \"transcript\"; readonly code: TranscriptTerminationCauseCode }\n\t| { readonly area: \"configuration\"; readonly code: \"invalid\" }\n\t| { readonly area: \"internal\"; readonly code: \"unclassified\" }\n\t| { readonly area: \"resource\"; readonly code: ResourceTerminationCauseCode }\n\t| { readonly area: \"budget\"; readonly code: RunBudgetStopCode };\n\nexport interface ClassifySessionTerminationInput {\n\treadonly sessionId: string;\n\treadonly runId: string;\n\t/** Deterministic caller-provided ISO-8601 timestamp. */\n\treadonly timestamp: string;\n\treadonly source: SessionTerminationSource;\n\t/** Caller-supplied, pre-redacted diagnostic text. */\n\treadonly message: string;\n\treadonly cause: SessionTerminationCause;\n\treadonly sideEffects: SessionSideEffects;\n\treadonly retryAfterMs?: number;\n\treadonly provider?: string;\n\treadonly model?: string;\n\treadonly toolCallId?: string;\n\treadonly toolName?: string;\n}\n\nexport interface SessionTermination {\n\treadonly schemaVersion: typeof SESSION_TERMINATION_SCHEMA_VERSION;\n\treadonly sessionId: string;\n\treadonly runId: string;\n\treadonly kind: SessionTerminationKind;\n\treadonly phase: SessionTerminationPhase;\n\treadonly source: SessionTerminationSource;\n\treadonly message: string;\n\treadonly causeCode: SessionTerminationCauseCode;\n\t/** Stable operator guidance suitable for print, JSON, RPC, and TUI surfaces. */\n\treadonly nextAction: string;\n\treadonly retryable: boolean;\n\treadonly safeToAutoRetry: boolean;\n\treadonly sideEffects: SessionSideEffects;\n\treadonly timestamp: string;\n\treadonly retryAfterMs?: number;\n\treadonly provider?: string;\n\treadonly model?: string;\n\treadonly toolCallId?: string;\n\treadonly toolName?: string;\n\treadonly processSignal?: SessionProcessSignal;\n\treadonly transcriptIssue?: TranscriptTerminationCauseCode;\n}\n"]}

package/dist/core/session-termination-types.js

@@ -0,0 +1,26 @@
+export const SESSION_TERMINATION_SCHEMA_VERSION = 1;
+export const MAX_SESSION_TERMINATION_MESSAGE_LENGTH = 512;
+/** The journal validator derives its accepted kinds from this tuple. */
+export const SESSION_TERMINATION_KIND_VALUES = [
+    "completed",
+    "user_abort",
+    "provider_abort",
+    "provider_auth",
+    "provider_rate_limit",
+    "provider_network",
+    "provider_protocol",
+    "provider_refusal",
+    "context_overflow",
+    "transcript_invalid",
+    "tool_timeout",
+    "tool_fatal",
+    "compaction",
+    "persistence",
+    "process_signal",
+    "process_crash",
+    "configuration",
+    "internal_error",
+    "resource_pressure",
+    "budget_exhausted",
+];
+//# sourceMappingURL=session-termination-types.js.map

package/dist/core/session-termination-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-termination-types.js","sourceRoot":"","sources":["../../src/core/session-termination-types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAU,CAAC;AAC7D,MAAM,CAAC,MAAM,sCAAsC,GAAG,GAAG,CAAC;AAE1D,wEAAwE;AACxE,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC9C,WAAW;IACX,YAAY;IACZ,gBAAgB;IAChB,eAAe;IACf,qBAAqB;IACrB,kBAAkB;IAClB,mBAAmB;IACnB,kBAAkB;IAClB,kBAAkB;IAClB,oBAAoB;IACpB,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,gBAAgB;IAChB,mBAAmB;IACnB,kBAAkB;CACT,CAAC","sourcesContent":["import type { RunBudgetStopCode } from \"./run-budget-policy.ts\";\n\nexport const SESSION_TERMINATION_SCHEMA_VERSION = 1 as const;\nexport const MAX_SESSION_TERMINATION_MESSAGE_LENGTH = 512;\n\n/** The journal validator derives its accepted kinds from this tuple. */\nexport const SESSION_TERMINATION_KIND_VALUES = [\n\t\"completed\",\n\t\"user_abort\",\n\t\"provider_abort\",\n\t\"provider_auth\",\n\t\"provider_rate_limit\",\n\t\"provider_network\",\n\t\"provider_protocol\",\n\t\"provider_refusal\",\n\t\"context_overflow\",\n\t\"transcript_invalid\",\n\t\"tool_timeout\",\n\t\"tool_fatal\",\n\t\"compaction\",\n\t\"persistence\",\n\t\"process_signal\",\n\t\"process_crash\",\n\t\"configuration\",\n\t\"internal_error\",\n\t\"resource_pressure\",\n\t\"budget_exhausted\",\n] as const;\nexport type SessionTerminationKind = (typeof SESSION_TERMINATION_KIND_VALUES)[number];\nexport type SessionTerminationPhase =\n\t| \"completed\"\n\t| \"control\"\n\t| \"preflight\"\n\t| \"provider\"\n\t| \"tool\"\n\t| \"compaction\"\n\t| \"persistence\"\n\t| \"process\"\n\t| \"resume\";\nexport type SessionTerminationSource = \"observed\" | \"inferred_on_resume\";\nexport type SessionSideEffects = \"none\" | \"possible\" | \"confirmed\";\nexport type SessionProcessSignal = \"SIGINT\" | \"SIGTERM\" | \"SIGHUP\" | \"SIGQUIT\";\nexport type ProviderTerminationCauseCode =\n\t| \"abort\"\n\t| \"auth\"\n\t| \"rate_limit\"\n\t| \"network\"\n\t| \"protocol\"\n\t| \"refusal\"\n\t| \"context_overflow\";\nexport type ToolTerminationCauseCode = \"timeout\" | \"fatal\";\nexport type ResourceTerminationCauseCode = \"memory\" | \"disk\" | \"cpu\" | \"heap\" | \"probe_unavailable\" | \"queue_overflow\";\nexport type CompactionTerminationCauseCode = \"aborted\" | \"failed\" | \"stale\" | \"quota_exhausted\";\nexport type PersistenceTerminationCauseCode =\n\t| \"read_failed\"\n\t| \"append_failed\"\n\t| \"replace_failed\"\n\t| \"fsync_failed\"\n\t| \"lock_failed\";\nexport type TranscriptTerminationCauseCode =\n\t| \"missing_result\"\n\t| \"duplicate_result\"\n\t| \"orphan_result\"\n\t| \"duplicate_call_id\"\n\t| \"interleaved_non_result\"\n\t| \"invalid_jsonl\"\n\t| \"invalid_tree\"\n\t| \"unsupported_version\"\n\t| \"trailing_fragment\";\nexport type SessionTerminationCauseCode =\n\t| \"session.completed\"\n\t| \"session.user_abort\"\n\t| `provider.${ProviderTerminationCauseCode}`\n\t| `tool.${ToolTerminationCauseCode}`\n\t| `compaction.${CompactionTerminationCauseCode}`\n\t| `persistence.${PersistenceTerminationCauseCode}`\n\t| \"process.signal\"\n\t| \"process.crash\"\n\t| `transcript.${TranscriptTerminationCauseCode}`\n\t| \"configuration.invalid\"\n\t| \"internal.unclassified\"\n\t| `resource.${ResourceTerminationCauseCode}`\n\t| `budget.${RunBudgetStopCode}`;\n\nexport type SessionTerminationCause =\n\t| { readonly area: \"completed\" }\n\t| { readonly area: \"user\"; readonly code: \"abort\" }\n\t| { readonly area: \"provider\"; readonly code: ProviderTerminationCauseCode }\n\t| { readonly area: \"tool\"; readonly code: ToolTerminationCauseCode }\n\t| { readonly area: \"compaction\"; readonly code: CompactionTerminationCauseCode }\n\t| { readonly area: \"persistence\"; readonly code: PersistenceTerminationCauseCode }\n\t| { readonly area: \"process\"; readonly code: \"signal\"; readonly signal: SessionProcessSignal }\n\t| { readonly area: \"process\"; readonly code: \"crash\" }\n\t| { readonly area: \"transcript\"; readonly code: TranscriptTerminationCauseCode }\n\t| { readonly area: \"configuration\"; readonly code: \"invalid\" }\n\t| { readonly area: \"internal\"; readonly code: \"unclassified\" }\n\t| { readonly area: \"resource\"; readonly code: ResourceTerminationCauseCode }\n\t| { readonly area: \"budget\"; readonly code: RunBudgetStopCode };\n\nexport interface ClassifySessionTerminationInput {\n\treadonly sessionId: string;\n\treadonly runId: string;\n\t/** Deterministic caller-provided ISO-8601 timestamp. */\n\treadonly timestamp: string;\n\treadonly source: SessionTerminationSource;\n\t/** Caller-supplied, pre-redacted diagnostic text. */\n\treadonly message: string;\n\treadonly cause: SessionTerminationCause;\n\treadonly sideEffects: SessionSideEffects;\n\treadonly retryAfterMs?: number;\n\treadonly provider?: string;\n\treadonly model?: string;\n\treadonly toolCallId?: string;\n\treadonly toolName?: string;\n}\n\nexport interface SessionTermination {\n\treadonly schemaVersion: typeof SESSION_TERMINATION_SCHEMA_VERSION;\n\treadonly sessionId: string;\n\treadonly runId: string;\n\treadonly kind: SessionTerminationKind;\n\treadonly phase: SessionTerminationPhase;\n\treadonly source: SessionTerminationSource;\n\treadonly message: string;\n\treadonly causeCode: SessionTerminationCauseCode;\n\t/** Stable operator guidance suitable for print, JSON, RPC, and TUI surfaces. */\n\treadonly nextAction: string;\n\treadonly retryable: boolean;\n\treadonly safeToAutoRetry: boolean;\n\treadonly sideEffects: SessionSideEffects;\n\treadonly timestamp: string;\n\treadonly retryAfterMs?: number;\n\treadonly provider?: string;\n\treadonly model?: string;\n\treadonly toolCallId?: string;\n\treadonly toolName?: string;\n\treadonly processSignal?: SessionProcessSignal;\n\treadonly transcriptIssue?: TranscriptTerminationCauseCode;\n}\n"]}