agentenkit 0.2.3 → 0.4.0

package/dist/core/segment.js

@@ -0,0 +1,318 @@
+import { THREAD_KEY_TTL_SECONDS } from './keys.js';
+import { publish } from './publish.js';
+import { streamIdOf } from './stream-events.js';
+/** The worker's side of a run stream: one per segment, open from pickup to
+ *  the segment's end. Everything published on the thread while it is open
+ *  is turned into typed stream events here (see forward), so the engine
+ *  keeps calling `publish` and only opens and closes the segment.
+ *
+ *  Events are appended together: they wait up to `streamFlushMs`, or until
+ *  `streamFlushEvents` are waiting. A step end, a tool result, a park and a
+ *  close go out at once. A failed append is logged, never thrown: the stream
+ *  is delivery, and the run's messages are saved either way. */
+/** The segment counter: each pickup of a run takes the next number, so a
+ *  retry or a resume gets a stream of its own. */
+export const segmentKey = (runId) => `agent:segment:${runId}`;
+/** Open segments by thread, per RunStreams, so two runtimes in one process
+ *  never see each other's. */
+const open = new WeakMap();
+/** The segment this process has open on a thread, if any. */
+export function activeSegment(deps, threadId) {
+    return deps.streams ? open.get(deps.streams)?.get(threadId) : undefined;
+}
+/** Events that go out at once rather than wait for the window. */
+const IMMEDIATE = new Set([
+    'RUN_STARTED', 'TOOL_CALL_RESULT', 'STEP_FINISHED', 'INPUT_REQUIRED', 'SUBAGENT_FINISHED',
+]);
+const immediate = (e) => IMMEDIATE.has(e.type) || (e.type === 'SUBAGENT_EVENT' && immediate(e.event));
+/** Opens the segment's stream and says RUN_STARTED on it. Null when the
+ *  runtime has no streams, or the open failed (logged): the run goes on
+ *  without a stream. */
+export async function openSegment(deps, threadId, runId) {
+    if (!deps.streams || !runId)
+        return null;
+    try {
+        const segment = await deps.kv.incrWithExpiry(segmentKey(runId), THREAD_KEY_TTL_SECONDS);
+        const streamId = streamIdOf(runId, segment);
+        await deps.streams.open(streamId, { threadId, runId }, deps.config.streamTtlMs);
+        const seg = new SegmentStream(deps, deps.streams, threadId, runId, segment, streamId);
+        let byThread = open.get(deps.streams);
+        if (!byThread) {
+            byThread = new Map();
+            open.set(deps.streams, byThread);
+        }
+        byThread.set(threadId, seg);
+        await seg.push([{ type: 'RUN_STARTED', threadId, runId, streamId, segment }]);
+        // The thread record says which stream is open, so a tab that opens the
+        // thread finds it.
+        await publish(deps, threadId, 'RUN_STARTED', { runId, streamId, segment }, runId);
+        return seg;
+    }
+    catch (err) {
+        (deps.log ?? console).error('run stream not opened', { threadId, runId, err });
+        return null;
+    }
+}
+/** Closes a segment's stream that its worker could not: the sweep's end for
+ *  a run whose worker died. A stream that is already closed or gone is left
+ *  as it is. */
+export async function closeLostSegment(deps, threadId, runId, error) {
+    if (!deps.streams)
+        return;
+    const segment = Number(await deps.kv.get(segmentKey(runId)));
+    if (!segment)
+        return;
+    const streamId = streamIdOf(runId, segment);
+    const snap = await deps.streams.snapshot(streamId).catch(() => null);
+    if (!snap || snap.end)
+        return; // gone, or its worker closed it after all
+    await deps.streams
+        .close(streamId, { type: 'RUN_ERROR', status: 'lost', error }, deps.config.streamGraceMs)
+        .catch(() => undefined);
+    await publish(deps, threadId, 'RUN_ENDED', { runId, streamId, segment, status: 'lost', error }, runId);
+}
+export class SegmentStream {
+    deps;
+    streams;
+    threadId;
+    runId;
+    segment;
+    streamId;
+    buf = [];
+    timer;
+    chain = Promise.resolve();
+    ended = false;
+    agents = new Map();
+    ids = 0;
+    /** A one-shot agent's final text, carried on RUN_FINISHED. */
+    oneShotText;
+    constructor(deps, streams, threadId, runId, segment, streamId) {
+        this.deps = deps;
+        this.streams = streams;
+        this.threadId = threadId;
+        this.runId = runId;
+        this.segment = segment;
+        this.streamId = streamId;
+    }
+    get closed() {
+        return this.ended;
+    }
+    /** Queue events; resolves once they are appended when any must go at once. */
+    push(events) {
+        if (this.ended || events.length === 0)
+            return Promise.resolve();
+        this.buf.push(...events);
+        const { streamFlushMs, streamFlushEvents } = this.deps.config;
+        if (streamFlushMs === 0 || this.buf.length >= streamFlushEvents || events.some(immediate)) {
+            return this.flush();
+        }
+        if (!this.timer) {
+            this.timer = setTimeout(() => void this.flush(), streamFlushMs);
+            this.timer.unref?.();
+        }
+        return Promise.resolve();
+    }
+    /** Append what waits; resolves once everything pushed so far is out. */
+    flush() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+        const batch = this.buf.splice(0);
+        if (batch.length > 0) {
+            this.chain = this.chain
+                .then(() => this.streams.append(this.streamId, batch))
+                .then(() => undefined)
+                .catch((err) => {
+                (this.deps.log ?? console).error('run stream events not appended', { streamId: this.streamId, err });
+            });
+        }
+        return this.chain;
+    }
+    /** End the stream: what is open is ended, what waits is appended, and the
+     *  end item goes last. A second close is a no-op. */
+    async close(end) {
+        if (this.ended)
+            return;
+        const closing = [];
+        for (const key of this.agents.keys())
+            closing.push(...this.endBlocks(key));
+        await this.push(closing);
+        await this.flush();
+        this.ended = true;
+        const byThread = open.get(this.streams);
+        if (byThread?.get(this.threadId) === this)
+            byThread.delete(this.threadId);
+        await this.streams.close(this.streamId, end, this.deps.config.streamGraceMs).catch((err) => {
+            (this.deps.log ?? console).error('run stream not closed', { streamId: this.streamId, err });
+        });
+        // The thread record says how the segment ended.
+        await publish(this.deps, this.threadId, 'RUN_ENDED', {
+            runId: this.runId, streamId: this.streamId, segment: this.segment, status: end.status,
+            ...(end.type === 'RUN_ERROR' ? { error: end.error } : {}),
+        }, this.runId).catch((err) => {
+            (this.deps.log ?? console).error('run end not recorded', { streamId: this.streamId, err });
+        });
+    }
+    /** Turn a published event into stream events. `reserved` is whether the
+     *  type is one of the platform's; any other is an app's own, and goes out
+     *  as CUSTOM. */
+    forward(type, payload, reserved) {
+        const p = (payload ?? {});
+        switch (type) {
+            case 'CHUNK':
+                return this.push(this.mapChunk('', p));
+            case 'SUBAGENT_CHUNK': {
+                const agentId = String(p.agentId);
+                return this.push(this.wrap(agentId, this.mapChunk(agentId, p.chunk ?? {})));
+            }
+            // The step is saved: the stream's STEP_FINISHED says so, right here,
+            // ahead of any park the step raised.
+            case 'STEP_COMMITTED': {
+                const agentId = p.agentId ?? null;
+                const ending = agentId === null ? this.endBlocks('') : this.wrap(agentId, this.endBlocks(agentId));
+                return this.push([
+                    ...ending,
+                    {
+                        type: 'STEP_FINISHED',
+                        step: Number(p.step ?? 0),
+                        agentId,
+                        finishReason: String(p.finishReason ?? ''),
+                        usage: {
+                            inputTokens: Number(p.inputTokens ?? 0),
+                            cachedInputTokens: Number(p.cachedInputTokens ?? 0),
+                            outputTokens: Number(p.outputTokens ?? 0),
+                            totalTokens: Number(p.totalTokens ?? 0),
+                        },
+                    },
+                ]);
+            }
+            case 'INPUT_REQUIRED':
+                // Through JSON, so a Date goes out as the string every store holds.
+                return this.push([{ ...JSON.parse(JSON.stringify(p)), type: 'INPUT_REQUIRED' }]);
+            case 'SUBAGENT_STARTED':
+                return this.push([
+                    { type: 'SUBAGENT_STARTED', subagentId: String(p.agentId), name: String(p.name ?? ''), depth: Number(p.depth ?? 0) },
+                ]);
+            case 'SUBAGENT_COMPLETED':
+            case 'SUBAGENT_FAILED': {
+                const agentId = String(p.agentId);
+                const failed = type === 'SUBAGENT_FAILED';
+                const status = !failed ? 'completed' : p.state === 'CANCELLED' ? 'cancelled' : 'failed';
+                return this.push([
+                    ...this.wrap(agentId, this.endBlocks(agentId)),
+                    {
+                        type: 'SUBAGENT_FINISHED',
+                        subagentId: agentId,
+                        status,
+                        ...(failed && p.error !== undefined ? { error: String(p.error) } : {}),
+                    },
+                ]);
+            }
+            case 'TEXT_RESULT':
+                this.oneShotText = typeof p.text === 'string' ? p.text : undefined;
+                return Promise.resolve();
+            default:
+                if (reserved)
+                    return Promise.resolve(); // the thread record's, or a notice
+                return this.push([{ type: 'CUSTOM', name: type, value: payload ?? null }]);
+        }
+    }
+    blocks(key) {
+        let b = this.agents.get(key);
+        if (!b) {
+            b = { tools: new Set() };
+            this.agents.set(key, b);
+        }
+        return b;
+    }
+    newId() {
+        return `${this.streamId}:m${++this.ids}`;
+    }
+    wrap(agentId, events) {
+        return events.map((event) => ({ type: 'SUBAGENT_EVENT', subagentId: agentId, event }));
+    }
+    /** End an agent's open text and reasoning. */
+    endBlocks(key) {
+        const b = this.agents.get(key);
+        if (!b)
+            return [];
+        const out = [];
+        if (b.reasoning)
+            out.push({ type: 'REASONING_END', messageId: b.reasoning });
+        if (b.text)
+            out.push({ type: 'TEXT_MESSAGE_END', messageId: b.text });
+        b.reasoning = undefined;
+        b.text = undefined;
+        return out;
+    }
+    /** One SDK stream part as stream events, for one agent ('' the main one). */
+    mapChunk(key, c) {
+        const b = this.blocks(key);
+        const out = [];
+        const startTool = (toolCallId, toolName) => {
+            if (b.tools.has(toolCallId))
+                return;
+            b.tools.add(toolCallId);
+            out.push({ type: 'TOOL_CALL_START', toolCallId, toolName });
+        };
+        switch (c.type) {
+            case 'text-delta': {
+                if (b.reasoning) {
+                    out.push({ type: 'REASONING_END', messageId: b.reasoning });
+                    b.reasoning = undefined;
+                }
+                if (!b.text) {
+                    b.text = this.newId();
+                    out.push({ type: 'TEXT_MESSAGE_START', messageId: b.text, role: 'assistant' });
+                }
+                out.push({ type: 'TEXT_MESSAGE_CONTENT', messageId: b.text, delta: String(c.textDelta ?? '') });
+                break;
+            }
+            case 'reasoning': {
+                if (b.text) {
+                    out.push({ type: 'TEXT_MESSAGE_END', messageId: b.text });
+                    b.text = undefined;
+                }
+                if (!b.reasoning) {
+                    b.reasoning = this.newId();
+                    out.push({ type: 'REASONING_START', messageId: b.reasoning });
+                }
+                out.push({ type: 'REASONING_CONTENT', messageId: b.reasoning, delta: String(c.textDelta ?? '') });
+                break;
+            }
+            case 'tool-call-streaming-start':
+                out.push(...this.endBlocks(key));
+                startTool(String(c.toolCallId), String(c.toolName));
+                break;
+            case 'tool-call-delta':
+                startTool(String(c.toolCallId), String(c.toolName));
+                out.push({ type: 'TOOL_CALL_ARGS', toolCallId: String(c.toolCallId), delta: String(c.argsTextDelta ?? '') });
+                break;
+            case 'tool-call': {
+                out.push(...this.endBlocks(key));
+                const toolCallId = String(c.toolCallId);
+                startTool(toolCallId, String(c.toolName));
+                b.tools.delete(toolCallId);
+                let args = c.args;
+                if (typeof args === 'string') {
+                    try {
+                        args = JSON.parse(args);
+                    }
+                    catch { /* left as the string it came as */ }
+                }
+                out.push({ type: 'TOOL_CALL_END', toolCallId, toolName: String(c.toolName), args: args ?? null });
+                break;
+            }
+            case 'tool-result':
+                out.push({
+                    type: 'TOOL_CALL_RESULT', toolCallId: String(c.toolCallId), toolName: String(c.toolName), result: c.result ?? null,
+                });
+                break;
+            case 'source':
+                out.push({ type: 'SOURCE', source: c.source ?? null });
+                break;
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=segment.js.map

package/dist/core/segment.js.map

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

package/dist/core/settle.d.ts

@@ -0,0 +1,57 @@
+import type { RunFinishInfo, RuntimePorts } from '../ports/runtime.js';
+import type { ExecutionState, UsageTotals } from './types.js';
+import type { RegisteredAgent } from './agent.js';
+/** How long a settle claim holds (§5.6). A claim older than this belongs to a
+ *  settler that died, and the next settle takes the run over. */
+export declare const SETTLE_CLAIM_TTL_MS: number;
+/** Whether a state is one a run cannot leave. */
+export declare const isTerminal: (state?: ExecutionState | null) => boolean;
+/** Sum every model call a run made, nested runs included (§4). A storage
+ *  hiccup must not turn a finished run into a failed one, so the read never
+ *  throws; but a hook that bills from these totals must be able to tell
+ *  "spent nothing" from "could not read", so the error comes back beside the
+ *  zero totals rather than swallowed. */
+export declare function runBill(deps: RuntimePorts, threadId: string, runId?: string): Promise<{
+    usage: UsageTotals;
+    error?: unknown;
+}>;
+/** Run the spec's `onSettle` for a run, once (§5.6). Every path that ends a
+ *  run goes through here: the worker that finished or aborted it, the worker
+ *  that failed it, a stop that ended it while no worker held it, and the
+ *  late-settle sweep.
+ *
+ *  Once is kept by a claim on the run record, made in one conditional write
+ *  before the hook runs: only the settler that wins it calls the hook, so two
+ *  that arrive together cannot both bill. The hook's success marks the run
+ *  settled; its failure drops the claim, so a later stop, delivery or sweep
+ *  runs it again. A claim that is never ended (the settler died mid-hook) is
+ *  taken over after SETTLE_CLAIM_TTL_MS. That is also why the hook must be
+ *  idempotent by runId: a hook slower than the claim, or a mark that could
+ *  not be written, can see the same run twice.
+ *
+ *  `reached` is whether this call ran the settle at all; `error` is the
+ *  hook's. A run with no record (a foreign dispatch) settles unclaimed, as it
+ *  always did. A store that cannot take the claim leaves the run unsettled
+ *  for the sweep rather than risk a second bill. */
+export declare function settleRun(deps: RuntimePorts, agent: RegisteredAgent | null, info: RunFinishInfo): Promise<{
+    reached: boolean;
+    error?: unknown;
+}>;
+/** Fire a spec's `onFinish`. The run has already ended: a callback that throws
+ *  is the caller's bug to see in the log, not a reason to change the end. */
+export declare function callOnFinish(deps: RuntimePorts, agent: RegisteredAgent | null, info: RunFinishInfo): Promise<void>;
+/** Settle a run whose record has ended but whose settle never ran (§2.1,
+ *  §5.6): a stop that ended it while it was queued or parked, a worker that
+ *  died between finishing and settling, or a settle hook that failed. The
+ *  steps it did make were priced as they happened, so its bill is real and
+ *  has to reach the hook. Nothing happens when the run already settled, or
+ *  when its record is still open.
+ *
+ *  The caller holds the run lock: a stop takes it for exactly this, and so do
+ *  a worker that finds the thread already ended and the sweep. */
+export declare function settleEndedRun(deps: RuntimePorts, agent: RegisteredAgent | null, threadId: string, runId?: string): Promise<boolean>;
+/** Settle an ended run whose settle never ran (§5.6), under the run lock.
+ *  False when it was settled meanwhile, or a worker holds the run (that
+ *  worker settles it). */
+export declare function settleLate(deps: RuntimePorts, agent: RegisteredAgent | null, threadId: string, runId?: string): Promise<boolean>;
+//# sourceMappingURL=settle.d.ts.map

package/dist/core/settle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../../src/core/settle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD;iEACiE;AACjE,eAAO,MAAM,mBAAmB,QAAiB,CAAC;AAIlD,iDAAiD;AACjD,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,GAAG,IAAI,KAAG,OACW,CAAC;AAEvE;;;;yCAIyC;AACzC,wBAAsB,OAAO,CAC3B,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAQlD;AAED;;;;;;;;;;;;;;;;;oDAiBoD;AACpD,wBAAsB,SAAS,CAC7B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,eAAe,GAAG,IAAI,EAC7B,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA6DhD;AAED;6EAC6E;AAC7E,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,EAAE,IAAI,EAAE,aAAa,iBAQxG;AAED;;;;;;;;kEAQkE;AAClE,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,eAAe,GAAG,IAAI,EAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;0BAE0B;AAC1B,wBAAsB,UAAU,CAC9B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,eAAe,GAAG,IAAI,EAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/core/settle.js

@@ -0,0 +1,181 @@
+import { randomUUID } from 'node:crypto';
+import { emptyTotals } from './usage.js';
+import { Lease } from './lease.js';
+/** How long a settle claim holds (§5.6). A claim older than this belongs to a
+ *  settler that died, and the next settle takes the run over. */
+export const SETTLE_CLAIM_TTL_MS = 10 * 60 * 1000;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** Whether a state is one a run cannot leave. */
+export const isTerminal = (state) => state === 'CANCELLED' || state === 'COMPLETED' || state === 'FAILED';
+/** Sum every model call a run made, nested runs included (§4). A storage
+ *  hiccup must not turn a finished run into a failed one, so the read never
+ *  throws; but a hook that bills from these totals must be able to tell
+ *  "spent nothing" from "could not read", so the error comes back beside the
+ *  zero totals rather than swallowed. */
+export async function runBill(deps, threadId, runId) {
+    if (!runId)
+        return { usage: emptyTotals() };
+    try {
+        return { usage: await deps.storage.usage.total(threadId, { runId }) };
+    }
+    catch (error) {
+        (deps.log ?? console).error('run bill not read', { run: runId, err: error });
+        return { usage: emptyTotals(), error };
+    }
+}
+/** Run the spec's `onSettle` for a run, once (§5.6). Every path that ends a
+ *  run goes through here: the worker that finished or aborted it, the worker
+ *  that failed it, a stop that ended it while no worker held it, and the
+ *  late-settle sweep.
+ *
+ *  Once is kept by a claim on the run record, made in one conditional write
+ *  before the hook runs: only the settler that wins it calls the hook, so two
+ *  that arrive together cannot both bill. The hook's success marks the run
+ *  settled; its failure drops the claim, so a later stop, delivery or sweep
+ *  runs it again. A claim that is never ended (the settler died mid-hook) is
+ *  taken over after SETTLE_CLAIM_TTL_MS. That is also why the hook must be
+ *  idempotent by runId: a hook slower than the claim, or a mark that could
+ *  not be written, can see the same run twice.
+ *
+ *  `reached` is whether this call ran the settle at all; `error` is the
+ *  hook's. A run with no record (a foreign dispatch) settles unclaimed, as it
+ *  always did. A store that cannot take the claim leaves the run unsettled
+ *  for the sweep rather than risk a second bill. */
+export async function settleRun(deps, agent, info) {
+    const log = deps.log ?? console;
+    const hook = async () => {
+        const onSettle = agent?.args.onSettle;
+        if (typeof onSettle !== 'function')
+            return undefined;
+        try {
+            await onSettle(info);
+            return undefined;
+        }
+        catch (err) {
+            return err ?? new Error('onSettle threw');
+        }
+    };
+    const runId = info.runId;
+    if (!runId)
+        return { reached: true, error: await hook() };
+    const token = randomUUID();
+    let claimed = false;
+    let failure;
+    for (let attempt = 0; attempt < 3; attempt++) {
+        if (attempt > 0)
+            await sleep(attempt * 200);
+        try {
+            claimed = await deps.admin.runs.claimSettle(runId, token, new Date(Date.now() - SETTLE_CLAIM_TTL_MS));
+            failure = undefined;
+            break;
+        }
+        catch (err) {
+            failure = err;
+        }
+    }
+    if (failure !== undefined) {
+        log.error('settle not claimed; the run stays unsettled for the late-settle sweep', { run: runId, err: failure });
+        return { reached: false };
+    }
+    if (!claimed) {
+        const rec = await deps.admin.runs.get(runId).catch(() => undefined);
+        // No record to claim: settled unclaimed.
+        if (rec === null)
+            return { reached: true, error: await hook() };
+        return { reached: false }; // settled already, or being settled by someone else
+    }
+    const error = await hook();
+    let markError;
+    for (let attempt = 0; attempt < 3; attempt++) {
+        if (attempt > 0)
+            await sleep(attempt * 200);
+        try {
+            await deps.admin.runs.endSettle(runId, token, error === undefined);
+            markError = undefined;
+            break;
+        }
+        catch (err) {
+            markError = err;
+        }
+    }
+    if (error !== undefined) {
+        // The claim is dropped, so a later stop, delivery or sweep can run the
+        // hook again.
+        log.error('settle hook failed; the run stays unsettled for a retry', { run: runId, err: error });
+    }
+    else if (markError !== undefined) {
+        log.error('settle mark not written; the claim lapses and the late-settle sweep may settle this run again', {
+            run: runId, err: markError,
+        });
+    }
+    return { reached: true, error };
+}
+/** Fire a spec's `onFinish`. The run has already ended: a callback that throws
+ *  is the caller's bug to see in the log, not a reason to change the end. */
+export async function callOnFinish(deps, agent, info) {
+    const onFinish = agent?.args.onFinish;
+    if (typeof onFinish !== 'function')
+        return;
+    try {
+        await onFinish(info);
+    }
+    catch (err) {
+        (deps.log ?? console).error('onFinish threw', { runId: info.runId, err: String(err) });
+    }
+}
+/** Settle a run whose record has ended but whose settle never ran (§2.1,
+ *  §5.6): a stop that ended it while it was queued or parked, a worker that
+ *  died between finishing and settling, or a settle hook that failed. The
+ *  steps it did make were priced as they happened, so its bill is real and
+ *  has to reach the hook. Nothing happens when the run already settled, or
+ *  when its record is still open.
+ *
+ *  The caller holds the run lock: a stop takes it for exactly this, and so do
+ *  a worker that finds the thread already ended and the sweep. */
+export async function settleEndedRun(deps, agent, threadId, runId) {
+    if (!agent || !runId)
+        return false;
+    const rec = await deps.admin.runs.get(runId).catch(() => null);
+    if (!rec || rec.settledAt || !isTerminal(rec.state))
+        return false;
+    const bill = await runBill(deps, threadId, runId);
+    const info = {
+        threadId, runId, state: rec.state, stopReason: rec.stopReason || 'cancelled',
+        cancelled: rec.state === 'CANCELLED',
+        ...(rec.error ? { error: rec.error } : {}),
+        tokensUsed: rec.totalTokens,
+        attribution: {
+            inputTokens: rec.inputTokens, cachedInputTokens: rec.cachedInputTokens,
+            outputTokens: rec.outputTokens, totalTokens: rec.totalTokens,
+        },
+        steps: rec.steps,
+        usage: bill.usage,
+        ...(bill.error !== undefined ? { usageError: bill.error } : {}),
+    };
+    // The hook's error is not acted on: the run has already ended either way,
+    // and the claim is dropped for a retry.
+    const { reached } = await settleRun(deps, agent, info);
+    if (reached)
+        await callOnFinish(deps, agent, info);
+    return reached;
+}
+/** Settle an ended run whose settle never ran (§5.6), under the run lock.
+ *  False when it was settled meanwhile, or a worker holds the run (that
+ *  worker settles it). */
+export async function settleLate(deps, agent, threadId, runId) {
+    if (!runId)
+        return false;
+    const lease = await Lease.acquire(deps, threadId, runId, undefined);
+    if (!lease)
+        return false;
+    // Renewed while the hook runs: a slow settle must not let a queued job take
+    // the lock and settle the same run beside it.
+    lease.keep();
+    try {
+        return await settleEndedRun(deps, agent, threadId, runId);
+    }
+    finally {
+        await lease.release();
+    }
+}
+//# sourceMappingURL=settle.js.map

package/dist/core/settle.js.map

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

package/dist/core/snapshot.d.ts

@@ -0,0 +1,36 @@
+import type { RuntimePorts, ThreadSnapshot } from '../ports/runtime.js';
+import type { StreamEnd, StreamItem } from './stream-events.js';
+/** The run stream a snapshot carries: the segment in flight, or one that
+ *  ended a moment ago, so a tab that loads just as a run ends still sees
+ *  its end. */
+export interface SnapshotStream {
+    streamId: string;
+    runId: string;
+    /** What the messages do not have yet: each agent's events after its last
+     *  finished step. A finished step is in the messages already, and showing
+     *  its deltas too would put its text on screen twice. */
+    items: StreamItem[];
+    /** The stream's end, when it has one. */
+    end: StreamEnd | null;
+    /** Where a live read picks up: the last offset the stream held, cut items
+     *  included. Null for a stream with nothing in it. */
+    offset: string | null;
+}
+/** How long after its end a stream still rides on the snapshot. */
+export declare const RECENT_END_MS = 60000;
+/** Drop each agent's content up to its last finished step (see
+ *  SnapshotStream.items). */
+export declare function cutCommitted(items: StreamItem[]): StreamItem[];
+/** The thread's current run stream, from the thread record: the latest
+ *  segment that started, while it is open or only just ended. Null when
+ *  there is none, or it is gone. */
+export declare function snapshotStream(deps: RuntimePorts, threadId: string): Promise<SnapshotStream | null>;
+/** One read for a UI: the thread, its messages, its runs, the unfinished
+ *  run's record entries and its run stream. Null when the thread is gone.
+ *  `afterMessageId` keeps only the messages after that one: what a tab that
+ *  already has it is missing (a SNAPSHOT frame). An id the thread does not
+ *  have keeps them all. */
+export declare function threadSnapshot(deps: RuntimePorts, threadId: string, opts?: {
+    afterMessageId?: string;
+}): Promise<ThreadSnapshot | null>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/core/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/core/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhE;;eAEe;AACf,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd;;6DAEyD;IACzD,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,yCAAyC;IACzC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB;0DACsD;IACtD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,mEAAmE;AACnE,eAAO,MAAM,aAAa,QAAS,CAAC;AAgBpC;6BAC6B;AAC7B,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAS9D;AAED;;oCAEoC;AACpC,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAsBzG;AAED;;;;2BAI2B;AAC3B,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GACrC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAsBhC"}