@tessar/core 0.1.0-alpha.0 → 0.1.0

package/dist/engine/recovery.d.ts

@@ -8,8 +8,7 @@ export type RecoveryPlan = {
     kind: "model";
     attempt: ModelAttemptRecord;
 } | {
-    kind: "tool";
-    tool: ToolExecutionRecord;
+    kind: "tools";
 } | {
     kind: "incompatible";
 };

package/dist/engine/recovery.js

@@ -12,8 +12,10 @@ export class RecoveryService {
             return attempt ? { kind: "model", attempt } : { kind: "incompatible" };
         }
         if (position.phase === "ToolPending") {
-            const tool = tools.find((t) => t.id === position.pendingToolExecutionIds[0]);
-            return tool ? { kind: "tool", tool } : { kind: "incompatible" };
+            return position.pendingToolExecutionIds.length &&
+                position.pendingToolExecutionIds.every((id) => tools.some((tool) => tool.id === id))
+                ? { kind: "tools" }
+                : { kind: "incompatible" };
         }
         return { kind: "continue" };
     }

package/dist/engine/recovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../src/engine/recovery.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,eAAe;IAC1B,IAAI,CACF,UAAsB,EACtB,QAAuC,EACvC,KAAqC;QAErC,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAC/C,IAAI,QAAQ,CAAC,kBAAkB;YAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;QACtE,IAAI,QAAQ,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,QAAQ;iBACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC;iBACtE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACV,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QACzE,CAAC;QACD,IAAI,QAAQ,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CACrB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC,CACpD,CAAC;YACF,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAClE,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;CACF"}
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../src/engine/recovery.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,eAAe;IAC1B,IAAI,CACF,UAAsB,EACtB,QAAuC,EACvC,KAAqC;QAErC,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAC/C,IAAI,QAAQ,CAAC,kBAAkB;YAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;QACtE,IAAI,QAAQ,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,QAAQ;iBACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC;iBACtE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACV,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QACzE,CAAC;QACD,IAAI,QAAQ,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;YACrC,OAAO,QAAQ,CAAC,uBAAuB,CAAC,MAAM;gBAC5C,QAAQ,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAC5C,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CACrC;gBACD,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE;gBACnB,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAC/B,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/engine/resume.d.ts

@@ -1,7 +1,9 @@
+import type { Attachment } from "./delivery.js";
+import { type ExecutionContext, type ExecutionFrame, type ExecutionRequest } from "./frame.js";
 import { type JsonValue } from "../json.js";
 import type { StorageBackend } from "../state/storage-ports.js";
 import type { RegistryLease } from "../plugins/registry.js";
-import type { ControlDecision } from "../events/catalog.js";
+import type { ControlDecision } from "../events/type.js";
 import type { ExecutionPhase, InterruptRecord } from "../state/schema.js";
 export declare function phaseForEvent(id: string): ExecutionPhase;
 export declare function validateManifest(manifest: readonly {
@@ -18,3 +20,12 @@ export declare function validateResume(backend: StorageBackend, registry: Regist
     interrupt: InterruptRecord;
     decision: ControlDecision;
 }>;
+export declare function restoreFrame(execution: ExecutionContext, request: Extract<ExecutionRequest, {
+    kind: "recover";
+}>, sink: Attachment, registry: RegistryLease, checkManifest?: boolean): Promise<ExecutionFrame>;
+export declare function prepareRecovery(execution: ExecutionContext, request: Extract<ExecutionRequest, {
+    kind: "recover";
+}>, sink: Attachment, registry: RegistryLease): Promise<ExecutionFrame>;
+export declare function prepareResume(execution: ExecutionContext, request: Extract<ExecutionRequest, {
+    kind: "resume";
+}>, sink: Attachment, registry: RegistryLease): Promise<ExecutionFrame>;

package/dist/engine/resume.js

@@ -1,3 +1,8 @@
+import { bindExecutionModel } from "../models/stream.js";
+import { model as modelHooks } from "../events/type.js";
+import { createFrame, loadRecords, } from "./frame.js";
+import { RecoveryService } from "./recovery.js";
+import { recoverTools } from "./tool-executor.js";
 import { TessarError, fail } from "../errors.js";
 import { immutable } from "../json.js";
 import { canonicalJson } from "../state/commit.js";
@@ -58,4 +63,188 @@ export async function validateResume(backend, registry, threadId, interruptId, v
         fail("InvalidResumeResponse", "Resolver must return a resolved decision");
     return { interrupt, decision: immutable(decision) };
 }
+export async function restoreFrame(execution, request, sink, registry, checkManifest = true) {
+    const head = await execution.runtime.backend.threads.get(request.threadId);
+    if (!head)
+        fail("ThreadNotFound", "Thread not found");
+    const stored = await execution.runtime.backend.executions.get("streams", request.streamId, { threadId: request.threadId });
+    if (!stored)
+        fail("StreamNotFound", "Execution not found");
+    if (["completed", "failed", "stopped", "cancelled"].includes(stored.status))
+        fail("AlreadyTerminal", "Execution already ended");
+    const cp = structuredClone((await execution.runtime.backend.checkpoints.get(head.currentCheckpointId)));
+    if (cp.execution?.streamId !== request.streamId)
+        fail("InvalidTransition", "Execution is not current thread work");
+    if (checkManifest)
+        validateManifest(cp.execution.registryManifest, registry, request.model);
+    const lease = await execution.runtime.backend.ownership.acquire({
+        threadId: request.threadId,
+        ownerToken: execution.ids.next("owner"),
+        ttlMs: 30000,
+    });
+    try {
+        const records = await loadRecords(execution, request.threadId);
+        const stream = records.get("streams:" + request.streamId).data;
+        const frame = createFrame(execution, {
+            request,
+            sink,
+            registry,
+            lease,
+            cp,
+            stream,
+            records,
+            admitted: true,
+        });
+        if (checkManifest)
+            bindExecutionModel(registry, cp.execution, frame.request.adapter, request.model);
+        sink.setId(stream.id);
+        return frame;
+    }
+    catch (error) {
+        await execution.runtime.backend.ownership.release(lease);
+        throw error;
+    }
+}
+export async function prepareRecovery(execution, request, sink, registry) {
+    const frame = await restoreFrame(execution, request, sink, registry);
+    try {
+        const plan = new RecoveryService().plan(frame.cp, execution.rows(frame, "model_attempts"), execution.rows(frame, "tool_executions"));
+        if (plan.kind === "pending-interrupt") {
+            if (request.model)
+                await execution.commit(frame, "ExecutionTransition");
+            return frame;
+        }
+        frame.stream.status = "interrupted";
+        if (plan.kind === "incompatible")
+            fail("ResumeIncompatible", "Invalid recovery cursor");
+        if (plan.kind === "model") {
+            plan.attempt.status = "interrupted";
+            plan.attempt.endedAt = execution.clock.now();
+            plan.attempt.error = {
+                source: "tessar",
+                name: "TessarError",
+                code: "InterruptedModelCall",
+                message: "Provider outcome was not committed",
+                retryable: true,
+            };
+            await execution.commit(frame, "ExecutionTransition");
+            const decision = await execution.hook(frame, modelHooks.recover, {
+                attemptId: plan.attempt.id,
+                error: plan.attempt.error,
+            });
+            if (decision?.decision !== "retry")
+                fail("RecoveryRequired", "Model retry requires an explicit recovery policy");
+            frame.cp.execution.phase = "BeforeModel";
+        }
+        if (plan.kind === "tools")
+            await recoverTools(frame, execution);
+        frame.stream.status = "running";
+        await execution.commit(frame, "Resumed");
+        return frame;
+    }
+    catch (error) {
+        await execution.runtime.backend.ownership.release(frame.lease);
+        throw error;
+    }
+}
+export async function prepareResume(execution, request, sink, registry) {
+    const existing = execution.resumeAdmissions.get(request.interruptId);
+    if (existing) {
+        await existing;
+        fail("AlreadyResumed", "Another response was already committed");
+    }
+    const pending = prepareResumeFrame(execution, request, sink, registry);
+    execution.resumeAdmissions.set(request.interruptId, pending);
+    try {
+        return await pending;
+    }
+    finally {
+        execution.resumeAdmissions.delete(request.interruptId);
+    }
+}
+async function prepareResumeFrame(execution, request, sink, registry) {
+    await validateResume(execution.runtime.backend, registry, request.threadId, request.interruptId, request.value);
+    const head = await execution.runtime.backend.threads.get(request.threadId);
+    if (!head)
+        fail("ThreadNotFound", "Thread not found");
+    const stored = (await execution.runtime.backend.checkpoints.get(head.currentCheckpointId));
+    if (!stored.execution ||
+        stored.execution.pendingInterruptId !== request.interruptId)
+        fail("InvalidTransition", "Thread is not waiting for this interruption");
+    validateManifest(stored.execution.registryManifest, registry, request.model);
+    const lease = await execution.runtime.backend.ownership.acquire({
+        threadId: request.threadId,
+        ownerToken: execution.ids.next("owner"),
+        ttlMs: 30000,
+    });
+    try {
+        const { interrupt, decision } = await validateResume(execution.runtime.backend, registry, request.threadId, request.interruptId, request.value);
+        const cp = structuredClone(stored), records = await loadRecords(execution, request.threadId);
+        const stream = records.get("streams:" + interrupt.streamId).data;
+        if (interrupt.actionRef?.toolExecutionId) {
+            const tool = execution
+                .rows({ records }, "tool_executions")
+                .find((t) => t.id === interrupt.actionRef.toolExecutionId);
+            if (!tool ||
+                canonicalJson(tool.arguments) !== interrupt.actionRef.argumentsDigest)
+                fail("ResumeIncompatible", "Pending operation payload changed");
+        }
+        const frame = createFrame(execution, {
+            request,
+            sink,
+            registry,
+            lease,
+            cp,
+            stream,
+            records,
+            admitted: true,
+        });
+        const position = cp.execution, cursor = position.handlerCursor;
+        bindExecutionModel(registry, position, frame.request.adapter, request.model);
+        if (!cursor)
+            fail("ResumeIncompatible", "Missing continuation cursor");
+        const previous = cursor.decisions.at(-2);
+        const resolved = previous && ["deny", "stop"].includes(previous.decision)
+            ? previous
+            : decision;
+        cursor.decisions = [
+            ...cursor.decisions.slice(0, -1),
+            resolved,
+        ];
+        position.phase = phaseForEvent(cursor.eventId);
+        position.pendingInterruptId = null;
+        if (request.model) {
+            position.registryManifest = position.registryManifest.filter((r) => r.kind !== "provider");
+            const provider = registry.values.find((r) => r.kind === "provider" && r.id === request.model.providerId);
+            if (!provider)
+                fail("MissingProvider", "Override model provider missing");
+            position.registryManifest = [
+                ...position.registryManifest,
+                {
+                    pluginId: provider.pluginId,
+                    kind: provider.kind,
+                    id: provider.id,
+                    version: provider.version,
+                    requiredForContinuation: true,
+                },
+            ];
+        }
+        stream.status = "running";
+        execution.put(frame, "interrupts", {
+            ...interrupt,
+            status: "resolved",
+            response: request.value,
+            resolvedDecision: resolved,
+            resolvedAt: execution.clock.now(),
+            revision: cp.revision + 1,
+        });
+        sink.setId(stream.id);
+        await execution.commit(frame, "Resumed");
+        return frame;
+    }
+    catch (error) {
+        await execution.runtime.backend.ownership.release(lease);
+        throw error;
+    }
+}
 //# sourceMappingURL=resume.js.map

package/dist/engine/resume.js.map

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

package/dist/engine/runtime.d.ts

@@ -0,0 +1,16 @@
+import { PluginHost } from "../plugins/host.js";
+import type { ValueRegistration } from "../plugins/registry.js";
+import type { ErrorInfo } from "../errors.js";
+import type { EventContext } from "../events/definition.js";
+import { StateQueries } from "../state/queries.js";
+import type { StorageBackend } from "../state/storage-ports.js";
+import type { Tool } from "../tools/tool.js";
+export interface ExecutionRuntime {
+    readonly id?: string;
+    readonly backend: StorageBackend;
+    readonly queries: StateQueries;
+    readonly hooks: PluginHost;
+    report(error: ErrorInfo, context?: EventContext): void;
+}
+export declare function toolRegistrations(agentId: string, tools: readonly Tool[]): ValueRegistration[];
+export declare function standaloneRuntime(agentId: string, tools: readonly Tool[]): ExecutionRuntime;

package/dist/engine/runtime.js

@@ -0,0 +1,29 @@
+import { PluginHost } from "../plugins/host.js";
+import { canonicalJson } from "../state/commit.js";
+import { createMemoryBackend } from "../state/memory-backend.js";
+import { StateQueries } from "../state/queries.js";
+export function toolRegistrations(agentId, tools) {
+    return tools.map((tool) => ({
+        kind: "tool",
+        id: tool.name,
+        value: tool,
+        version: 1,
+        pluginId: agentId,
+        pluginVersion: 1,
+        configurationId: canonicalJson(tool.jsonSchema),
+    }));
+}
+export function standaloneRuntime(agentId, tools) {
+    const backend = createMemoryBackend();
+    const report = () => { };
+    return {
+        backend,
+        queries: new StateQueries(backend),
+        report,
+        hooks: new PluginHost({
+            values: toolRegistrations(agentId, tools),
+            diagnostics: report,
+        }),
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/engine/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/engine/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIhD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAanD,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,KAAsB;IAEtB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,IAAI,CAAC,IAAI;QACb,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,OAAO;QACjB,aAAa,EAAE,CAAC;QAChB,eAAe,EAAE,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC;KAChD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,KAAsB;IAEtB,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;IACxB,OAAO;QACL,OAAO;QACP,OAAO,EAAE,IAAI,YAAY,CAAC,OAAO,CAAC;QAClC,MAAM;QACN,KAAK,EAAE,IAAI,UAAU,CAAC;YACpB,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC;YACzC,WAAW,EAAE,MAAM;SACpB,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/engine/services.d.ts

@@ -0,0 +1,3 @@
+import { type TrackedServices } from "./tracked-effects.js";
+import type { ExecutionContext, ExecutionFrame } from "./frame.js";
+export declare function services(execution: ExecutionContext, frame: ExecutionFrame, toolExecutionId?: string): TrackedServices;

package/dist/engine/services.js

@@ -0,0 +1,125 @@
+import { model as modelHooks } from "../events/type.js";
+import { TessarError, errorInfo, fail } from "../errors.js";
+import { immutable } from "../json.js";
+import { providerCall, selectAdapter, streamModel } from "../models/stream.js";
+import { createModelAttempt } from "../trace/records.js";
+import { EffectService, childStateDefinition, } from "./tracked-effects.js";
+export function services(execution, frame, toolExecutionId) {
+    const state = frame.state.withOwner({
+        type: "stream",
+        id: frame.stream.id,
+    });
+    frame.effectLocks ??= new Map();
+    const effects = new EffectService((id) => frame.registry.find("effect", id), state, () => execution.commit(frame, "PluginStateCommitted"), {
+        signal: frame.sink.controller.signal,
+        threadId: frame.cp.threadId,
+        streamId: frame.stream.id,
+        turnId: frame.cp.execution?.turnId ?? null,
+        ...(toolExecutionId ? { toolExecutionId } : {}),
+    }, () => execution.ids.next("effect"), frame.effectLocks);
+    const guard = () => {
+        if (!frame.admitted || !frame.cp.execution)
+            fail("UnsupportedBoundary", "Tracked execution requires admitted active work");
+    };
+    return {
+        models: {
+            stream: (options) => {
+                guard();
+                return auxiliary(execution, frame, toolExecutionId, options);
+            },
+        },
+        effects: {
+            execute: (definition, input, options) => {
+                guard();
+                return effects.execute(definition, input, options);
+            },
+        },
+        executions: {
+            reserveChild: async (options) => {
+                guard();
+                if (options.threadId === frame.cp.threadId)
+                    fail("InvalidLineage", "Child requires a separate Thread");
+                if (!(await execution.runtime.backend.threads.get(options.threadId)))
+                    fail("ThreadNotFound", "Child Thread not found");
+                const previous = state.get(childStateDefinition), old = previous[options.dispatchKey];
+                if (old) {
+                    if (old.threadId !== options.threadId)
+                        fail("CommitConflict", "Dispatch key is bound to another Thread");
+                    await execution.commit(frame, "PluginStateCommitted");
+                    return old;
+                }
+                const reservation = {
+                    threadId: options.threadId,
+                    streamId: execution.ids.next("stream"),
+                    origin: {
+                        parentStreamId: frame.stream.id,
+                        ...(toolExecutionId
+                            ? { parentToolExecutionId: toolExecutionId }
+                            : {}),
+                        dispatchId: execution.ids.next("dispatch"),
+                    },
+                };
+                state.update(childStateDefinition, {
+                    ...previous,
+                    [options.dispatchKey]: reservation,
+                });
+                await execution.commit(frame, "PluginStateCommitted");
+                return immutable(reservation);
+            },
+        },
+        events: {
+            emit: async (definition, payload) => {
+                if (execution.runtime.hooks.kind(definition) !== "notification")
+                    fail("InvalidEvent", "Custom progress must be notification events");
+                await execution.hook(frame, definition, payload, toolExecutionId);
+            },
+        },
+    };
+}
+async function* auxiliary(execution, frame, toolExecutionId, options) {
+    const position = frame.cp.execution;
+    if (!position.turnId)
+        fail("UnsupportedBoundary", "Auxiliary calls require an active turn");
+    const adapter = selectAdapter(frame.registry, options.model, frame.request.adapter), request = await execution.hook(frame, modelHooks.request, immutable(options.request), toolExecutionId);
+    // Reserve after awaited hooks so concurrent auxiliary calls cannot oversubscribe.
+    if (position.budgets.modelAttempts >= position.budgets.limits.maxModelAttempts)
+        fail("StreamLimit", "Model attempt budget exhausted");
+    providerCall(options.model, () => adapter.validate(request));
+    const attempt = createModelAttempt(execution, frame.cp, options.model, "auxiliary", toolExecutionId);
+    position.budgets.modelAttempts++;
+    execution.put(frame, "model_attempts", attempt);
+    await execution.commit(frame, "ExecutionTransition");
+    const attemptStartedAt = performance.now();
+    try {
+        for await (const chunk of streamModel(adapter, request, {
+            signal: frame.sink.controller.signal,
+        })) {
+            if (chunk.type === "message-delta" && attempt.firstOutputAt === null) {
+                attempt.firstOutputAt = execution.clock.now();
+                attempt.timeToFirstOutputMs = Math.max(0, performance.now() - attemptStartedAt);
+            }
+            if (chunk.type === "usage")
+                attempt.usage = chunk.usage;
+            if (chunk.type === "response") {
+                attempt.usage = chunk.response.usage ?? attempt.usage;
+                attempt.status = "succeeded";
+                attempt.finishReason = chunk.response.finishReason ?? null;
+                attempt.providerRequestId = chunk.response.providerRequestId ?? null;
+            }
+            yield chunk;
+        }
+    }
+    catch (error) {
+        attempt.status = "failed";
+        attempt.error = errorInfo(error);
+        throw error;
+    }
+    finally {
+        if (attempt.status === "running")
+            attempt.status = "interrupted";
+        attempt.endedAt = execution.clock.now();
+        attempt.durationMs = Math.max(0, performance.now() - attemptStartedAt);
+        await execution.commit(frame, "ExecutionTransition");
+    }
+}
+//# sourceMappingURL=services.js.map

package/dist/engine/services.js.map

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

package/dist/engine/tool-executor.d.ts

@@ -1,2 +1,8 @@
-import type { Tool, ToolExecutionContext, ToolResult } from "../tools/tool.js";
-export declare function executeTool(tool: Tool, input: unknown, context: ToolExecutionContext): Promise<ToolResult>;
+import { ToolMessage } from "../messages/message.js";
+import { type Tool, type ToolExecutionContext } from "../tools/tool.js";
+import type { ExecutionFrame } from "./frame.js";
+import type { LoopContext } from "../loop.js";
+export declare function executeTool(tool: Tool, input: unknown, context: ToolExecutionContext): Promise<ToolMessage>;
+export declare function callTools(frame: ExecutionFrame, context: LoopContext): Promise<void>;
+/** Reconcile each dispatched call; saved sibling results never execute again. */
+export declare function recoverTools(frame: ExecutionFrame, context: LoopContext, cancel?: boolean): Promise<void>;