@deepstrike/sdk 0.2.60 → 0.2.62

package/dist/runtime/canonical-kernel-step.js

@@ -41,239 +41,186 @@ export function canonicalUnsupportedEffectResolution(effectId, effectKind) {
     };
 }
 /** The only ABI-v3 planned-step → Node host-action projection. */
-export function canonicalActionFromPlannedStep(plannedStep) {
-    if (plannedStep.disposition.kind === "terminal") {
-        const terminal = plannedStep.disposition.terminal;
-        const usage = asObject(terminal.usage);
-        let termination = String(terminal.kind ?? "failed");
-        let turnsUsed = Number(usage.turns ?? 0);
-        if (terminal.kind === "agent") {
-            const result = asObject(terminal.result);
-            termination = String(result.termination ?? "completed");
-            turnsUsed = Number(result.turns_used ?? turnsUsed);
-            const finalMessage = asObject(result.final_message);
-            const pace = asObject(result.pace_decision);
-            if (Object.keys(finalMessage).length > 0) {
-                return {
-                    kind: "done",
-                    effectId: "",
-                    result: {
-                        termination,
-                        turnsUsed,
-                        totalTokensUsed: totalUsageTokens(terminal),
-                        finalMessage: {
-                            role: String(finalMessage.role ?? "assistant"),
-                            content: String(finalMessage.content ?? ""),
-                            toolCalls: (Array.isArray(finalMessage.tool_calls) ? finalMessage.tool_calls : [])
-                                .map(value => {
-                                const call = asObject(value);
-                                return {
-                                    id: String(call.call_id ?? ""),
-                                    name: String(call.name ?? ""),
-                                    arguments: JSON.stringify(call.arguments ?? {}),
-                                };
-                            }),
-                        },
-                        ...(Object.keys(pace).length > 0
-                            ? {
-                                paceDecision: {
-                                    action: String(pace.action ?? "stop"),
-                                    ...(pace.delay_ms !== undefined ? { delayMs: Number(pace.delay_ms) } : {}),
-                                    reason: String(pace.reason ?? ""),
-                                    ...(pace.coerced_from ? { coercedFrom: String(pace.coerced_from) } : {}),
-                                },
-                            }
-                            : {}),
-                    },
-                };
-            }
-        }
-        else if (terminal.kind === "workflow") {
-            const outcome = asObject(terminal.outcome);
-            termination = String(outcome.status ?? "completed");
-        }
-        else if (terminal.kind === "cancelled") {
-            termination = String(terminal.reason ?? "cancelled");
-        }
-        else if (terminal.kind === "failed") {
-            const failure = asObject(terminal.failure);
-            termination = failure.code === "provider_recovery_exhausted"
-                ? "context_overflow"
-                : "error";
-        }
+function canonicalDoneFromTerminal(terminal) {
+    const usage = asObject(terminal.usage);
+    let termination = String(terminal.kind ?? "failed");
+    let turnsUsed = Number(usage.turns ?? 0);
+    if (terminal.kind === "agent") {
+        const result = asObject(terminal.result);
+        termination = String(result.termination ?? "completed");
+        turnsUsed = Number(result.turns_used ?? turnsUsed);
+        const finalMessage = asObject(result.final_message);
+        const pace = asObject(result.pace_decision);
         return {
-            kind: "done",
-            effectId: "",
+            kind: "done", effectId: "",
             result: {
-                termination,
-                turnsUsed,
-                totalTokensUsed: totalUsageTokens(terminal),
+                termination, turnsUsed, totalTokensUsed: totalUsageTokens(terminal),
+                ...(Object.keys(finalMessage).length > 0 ? { finalMessage: {
+                        role: String(finalMessage.role ?? "assistant"),
+                        content: String(finalMessage.content ?? ""),
+                        toolCalls: (Array.isArray(finalMessage.tool_calls) ? finalMessage.tool_calls : []).map(value => {
+                            const call = asObject(value);
+                            return { id: String(call.call_id ?? ""), name: String(call.name ?? ""), arguments: JSON.stringify(call.arguments ?? {}) };
+                        }),
+                    } } : {}),
+                ...(Object.keys(pace).length > 0 ? { paceDecision: {
+                        action: String(pace.action ?? "stop"),
+                        ...(pace.delay_ms !== undefined ? { delayMs: Number(pace.delay_ms) } : {}),
+                        reason: String(pace.reason ?? ""),
+                        ...(pace.coerced_from ? { coercedFrom: String(pace.coerced_from) } : {}),
+                    } } : {}),
             },
         };
     }
-    const published = plannedStep.disposition.effects ?? [];
-    if (published.length === 0)
+    if (terminal.kind === "workflow")
+        termination = String(asObject(terminal.outcome).status ?? "completed");
+    if (terminal.kind === "cancelled")
+        termination = String(terminal.reason ?? "cancelled");
+    if (terminal.kind === "failed")
+        termination = asObject(terminal.failure).code === "provider_recovery_exhausted" ? "context_overflow" : "error";
+    return { kind: "done", effectId: "", result: { termination, turnsUsed, totalTokensUsed: totalUsageTokens(terminal) } };
+}
+/** Adapt the additive core CurrentProjection JSON into the existing Node action surface. */
+export function canonicalActionFromProjectionJson(raw) {
+    const projection = asObject(JSON.parse(raw));
+    const state = String(projection.state ?? "idle");
+    if (state === "idle")
         return null;
-    if (published.length !== 1) {
-        throw new Error(`Node runner expects one canonical effect at a time, received ${published.length}`);
+    if (state === "terminal") {
+        return canonicalDoneFromTerminal(asObject(projection.action));
     }
-    const envelope = asObject(published[0]);
-    const effectId = String(envelope.effect_id ?? "");
-    const effect = asObject(envelope.effect);
-    if (!effectId)
-        throw new Error("canonical effect is missing effect_id");
-    switch (effect.kind) {
-        case "call_provider":
-            return {
-                kind: "call_provider",
-                effectId,
-                context: renderedContextToSdk(asObject(effect.context)),
-                tools: (Array.isArray(effect.tools) ? effect.tools : []).map(raw => {
-                    const tool = asObject(raw);
-                    return {
-                        name: String(tool.name ?? ""),
-                        description: String(tool.description ?? ""),
-                        parameters: JSON.stringify(tool.parameters ?? {}),
-                    };
-                }),
-            };
-        case "execute_tools":
-            return {
-                kind: "execute_tool",
-                effectId,
-                calls: (Array.isArray(effect.calls) ? effect.calls : []).map(raw => {
-                    const call = asObject(raw);
-                    return {
-                        id: String(call.call_id ?? ""),
-                        name: String(call.name ?? ""),
-                        arguments: JSON.stringify(call.arguments ?? {}),
-                    };
-                }),
-            };
-        case "request_approval":
-            return {
-                kind: "request_approval",
-                effectId,
-                requests: (Array.isArray(effect.requests) ? effect.requests : []).map(raw => {
-                    const request = asObject(raw);
-                    return {
-                        callId: String(request.call_id ?? ""),
-                        tool: String(request.tool_name ?? ""),
-                        arguments: JSON.stringify(request.arguments ?? {}),
-                        reason: String(request.reason ?? ""),
-                    };
-                }),
-            };
-        case "spawn_tasks":
-            return {
-                kind: "spawn_workflow",
-                effectId,
-                nodes: (Array.isArray(effect.tasks) ? effect.tasks : []).map(raw => {
-                    const task = asObject(raw);
-                    const spec = asObject(task.spec);
-                    return {
-                        agent_id: String(task.task_id ?? ""),
-                        task_id: String(task.task_id ?? ""),
-                        attempt_id: String(task.attempt_id ?? ""),
-                        launch_token: String(task.launch_token ?? ""),
-                        node_id: String(task.node_id ?? ""),
-                        goal: String(spec.goal ?? ""),
-                        role: String(spec.role ?? "custom"),
-                        isolation: String(spec.isolation ?? "shared"),
-                        context_inheritance: String(spec.context_inheritance ?? "none"),
-                        ...(spec.metadata && typeof spec.metadata === "object"
-                            ? asObject(spec.metadata)
-                            : {}),
-                    };
-                }),
-                ...(effect.budget ? { budget: asObject(effect.budget) } : {}),
-            };
-        case "preempt_tasks": {
-            const attempts = (Array.isArray(effect.attempts) ? effect.attempts : []).map(raw => {
-                const attempt = asObject(raw);
+    const action = asObject(projection.action);
+    const payload = asObject(action.payload);
+    const effectId = String(action.effect_id ?? "");
+    if (action.kind === "query_memory") {
+        return {
+            kind: "query_memory",
+            effectId,
+            query: asObject(payload.query),
+            requestedK: Number(payload.requested_k ?? 0),
+        };
+    }
+    if (action.kind === "execute_tools") {
+        return {
+            kind: "execute_tool",
+            effectId,
+            calls: (Array.isArray(payload.calls) ? payload.calls : []).map(raw => {
+                const call = asObject(raw);
                 return {
-                    task_id: String(attempt.task_id ?? ""),
-                    attempt_id: String(attempt.attempt_id ?? ""),
+                    id: String(call.call_id ?? ""),
+                    name: String(call.name ?? ""),
+                    arguments: JSON.stringify(call.arguments ?? {}),
                 };
-            });
-            return {
-                kind: "preempt_sub_agents",
-                effectId,
-                attempts,
-                agentIds: attempts.map(attempt => attempt.task_id),
-                reason: String(effect.reason ?? ""),
-            };
-        }
-        case "persist_memory":
-            return {
-                kind: "persist_memory",
-                effectId,
-                memory: asObject(effect.memory),
-            };
-        case "query_memory":
-            return {
-                kind: "query_memory",
-                effectId,
-                query: asObject(effect.query),
-                requestedK: Number(effect.requested_k ?? 0),
-            };
-        case "archive_page_out": {
-            const payload = asObject(effect.payload);
-            let archived = [];
-            try {
-                const decoded = JSON.parse(String(payload.content ?? ""));
-                if (Array.isArray(decoded)) {
-                    archived = decoded.map(value => kernelMessageToSdk(asObject(value)));
-                }
-            }
-            catch {
-                // Persistence still uses the opaque body and digest. Only optional presentation-side
-                // summarization is skipped if the archived message batch cannot be decoded.
-            }
-            const compressed = (plannedStep.observations ?? [])
-                .find(observation => observation.kind === "compressed");
-            const pressureAction = compressed ? String(compressed.action ?? "") : "";
-            return {
-                kind: "archive_page_out",
-                effectId,
-                handleId: String(effect.handle_id ?? ""),
-                payload,
-                archived,
-                ...(pressureAction ? { action: pressureAction } : {}),
-                ...(compressed?.summary ? { summary: String(compressed.summary) } : {}),
-                ...(pressureAction
-                    ? {
-                        tier: ["context_collapse", "auto_compact"].includes(pressureAction)
-                            ? "semantic"
-                            : "durable",
-                    }
-                    : {}),
-            };
+            }),
+        };
+    }
+    if (action.kind === "call_provider") {
+        const context = asObject(payload.context);
+        return {
+            kind: "call_provider",
+            effectId,
+            context: renderedContextToSdk(context),
+            tools: (Array.isArray(payload.tools) ? payload.tools : []).map(raw => {
+                const tool = asObject(raw);
+                return {
+                    name: String(tool.name ?? ""),
+                    description: String(tool.description ?? ""),
+                    parameters: JSON.stringify(tool.parameters ?? {}),
+                };
+            }),
+        };
+    }
+    if (action.kind === "request_approval") {
+        return {
+            kind: "request_approval",
+            effectId,
+            requests: (Array.isArray(payload.requests) ? payload.requests : []).map(raw => {
+                const request = asObject(raw);
+                return {
+                    callId: String(request.call_id ?? ""),
+                    tool: String(request.tool_name ?? ""),
+                    arguments: JSON.stringify(request.arguments ?? {}),
+                    reason: String(request.reason ?? ""),
+                };
+            }),
+        };
+    }
+    if (action.kind === "load_payload") {
+        return {
+            kind: "load_payload",
+            effectId,
+            handleId: String(payload.handle_id ?? ""),
+            payloadRef: String(payload.payload_ref ?? ""),
+        };
+    }
+    if (action.kind === "evaluate_milestone") {
+        const request = asObject(payload.request);
+        return {
+            kind: "evaluate_milestone",
+            effectId,
+            phaseId: String(request.phase_id ?? ""),
+            criteria: [],
+            requiredEvidence: [],
+        };
+    }
+    if (action.kind === "spawn_tasks") {
+        return {
+            kind: "spawn_workflow",
+            effectId,
+            nodes: (Array.isArray(payload.tasks) ? payload.tasks : []).map(raw => {
+                const task = asObject(raw);
+                const spec = asObject(task.spec);
+                return {
+                    agent_id: String(task.task_id ?? ""), task_id: String(task.task_id ?? ""),
+                    attempt_id: String(task.attempt_id ?? ""), launch_token: String(task.launch_token ?? ""),
+                    node_id: String(task.node_id ?? ""), goal: String(spec.goal ?? ""),
+                    role: String(spec.role ?? "custom"), isolation: String(spec.isolation ?? "shared"),
+                    context_inheritance: String(spec.context_inheritance ?? "none"),
+                    ...(spec.metadata && typeof spec.metadata === "object" ? asObject(spec.metadata) : {}),
+                };
+            }),
+            ...(payload.budget ? { budget: asObject(payload.budget) } : {}),
+        };
+    }
+    if (action.kind === "preempt_tasks") {
+        const attempts = (Array.isArray(payload.attempts) ? payload.attempts : []).map(raw => {
+            const attempt = asObject(raw);
+            return { task_id: String(attempt.task_id ?? ""), attempt_id: String(attempt.attempt_id ?? "") };
+        });
+        return { kind: "preempt_sub_agents", effectId, attempts, agentIds: attempts.map(a => a.task_id), reason: String(payload.reason ?? "") };
+    }
+    if (action.kind === "persist_memory") {
+        return { kind: "persist_memory", effectId, memory: asObject(payload.memory) };
+    }
+    if (action.kind === "archive_page_out") {
+        const archivePayload = asObject(payload.payload);
+        let archived = [];
+        try {
+            const decoded = JSON.parse(String(archivePayload.content ?? ""));
+            if (Array.isArray(decoded))
+                archived = decoded.map(value => kernelMessageToSdk(asObject(value)));
         }
-        case "load_payload":
-            return {
-                kind: "load_payload",
-                effectId,
-                handleId: String(effect.handle_id ?? ""),
-                payloadRef: String(effect.payload_ref ?? ""),
-            };
-        case "evaluate_milestone": {
-            const request = asObject(effect.request);
-            return {
-                kind: "evaluate_milestone",
-                effectId,
-                phaseId: String(request.phase_id ?? ""),
-                criteria: [],
-                requiredEvidence: [],
-            };
+        catch {
+            // The opaque archive payload remains authoritative even when presentation decoding fails.
         }
-        default:
-            return {
-                kind: "unsupported_effect",
-                effectId,
-                effectKind: String(effect.kind),
-            };
+        return {
+            kind: "archive_page_out",
+            effectId,
+            handleId: String(payload.handle_id ?? ""),
+            payload: {
+                content: String(archivePayload.content ?? ""),
+                digest: String(archivePayload.digest ?? ""),
+                original_size: String(archivePayload.original_size ?? "0"),
+                ...(archivePayload.preview ? { preview: String(archivePayload.preview) } : {}),
+            },
+            archived,
+        };
     }
+    return {
+        kind: "unsupported_effect",
+        effectId,
+        effectKind: String(action.kind ?? ""),
+    };
 }
 export class CanonicalKernelRejectedError extends Error {
     fault;
@@ -1178,6 +1125,16 @@ export class CanonicalRunnerRuntime {
                             throw new Error("canonical observation is missing kind");
                         this.hostObservations.push({ ...raw, kind });
                     }
+                    // §7.11 · a committed step that publishes effects is a fact worth recording in the
+                    // host event log: the journal stores only a digest of the step, so this manifest is
+                    // what makes the published effect ids + kinds recoverable post-hoc without replaying.
+                    const published = JSON.parse(this.host.kernel.publishedEffectsManifestJson(JSON.stringify(transition.plannedStep)));
+                    if (published.length > 0) {
+                        this.hostObservations.push({
+                            kind: "step_published_effects",
+                            effects: published,
+                        });
+                    }
                     if (transition.checkpointAdvice) {
                         this.hostObservations.push({
                             kind: "checkpoint_advised",
@@ -1191,7 +1148,7 @@ export class CanonicalRunnerRuntime {
                         });
                     }
                 }
-                this.lastAction = canonicalActionFromPlannedStep(transition.plannedStep);
+                this.lastAction = canonicalActionFromProjectionJson(this.host.kernel.projectPlannedStepJson(JSON.stringify(transition.plannedStep)));
             }
             if (this.lastAction?.kind !== "unsupported_effect")
                 return this.lastAction;
@@ -1199,16 +1156,7 @@ export class CanonicalRunnerRuntime {
         }
     }
     currentAction() {
-        const terminal = this.host.kernel.terminalJson();
-        if (terminal) {
-            return canonicalActionFromPlannedStep({
-                disposition: { kind: "terminal", terminal: JSON.parse(terminal) },
-            });
-        }
-        const effects = this.pendingEffects();
-        return canonicalActionFromPlannedStep({
-            disposition: { kind: "effects", effects },
-        });
+        return canonicalActionFromProjectionJson(this.host.kernel.currentProjectionJson());
     }
     pendingEffects() {
         return JSON.parse(this.host.kernel.pendingEffectsJson());

package/dist/runtime/kernel-doctor.d.ts

@@ -0,0 +1,36 @@
+import type { CanonicalKernelInstance } from "../kernel.js";
+import type { KernelJournal } from "./kernel-journal.js";
+/**
+ * What a journal inspection knows: whether the operation restores, and — when it does not — which
+ * record is the first this binary cannot replay. The effect manifest (which effects each step
+ * published) lives in the host event log via the `step_published_effects` observation, not here:
+ * a journal stores only each record's input and digests, never the step it produced (§8.1).
+ */
+export interface KernelJournalDiagnosis {
+    operationId: string;
+    recordCount: number;
+    /** True when `restore()` replayed the whole journal and verified every step digest. */
+    restorable: boolean;
+    /**
+     * The `step_seq` of the first record whose replay diverged from the durable digest, when known.
+     * The restore failure message names this step; a fault before any record replays leaves it null.
+     */
+    divergenceStep: number | null;
+    divergenceReason: string | null;
+    /** The operation's terminal, only when the journal restored cleanly. */
+    terminal: Record<string, unknown> | undefined;
+    /** Pending effects at the head, only when the journal restored cleanly. */
+    pendingEffects: Array<{
+        effect_id: string;
+        kind: string;
+    }>;
+}
+/**
+ * Inspect a durable journal without committing anything: replay it through the kernel and report
+ * whether it still restores. This turns a "silent brick" — an operation whose journal was appended
+ * but whose step can no longer be re-derived by this binary — into an actionable diagnosis: which
+ * record diverges, and what the head still holds if it does not.
+ *
+ * Nothing is mutated; the same journal can be diagnosed repeatedly and then restored normally.
+ */
+export declare function diagnoseKernelJournal(kernel: CanonicalKernelInstance, journal: KernelJournal, operationId: string): Promise<KernelJournalDiagnosis>;

package/dist/runtime/kernel-doctor.js

@@ -0,0 +1,60 @@
+const DIVERGENCE_STEP = /at step (\d+)/;
+/**
+ * Inspect a durable journal without committing anything: replay it through the kernel and report
+ * whether it still restores. This turns a "silent brick" — an operation whose journal was appended
+ * but whose step can no longer be re-derived by this binary — into an actionable diagnosis: which
+ * record diverges, and what the head still holds if it does not.
+ *
+ * Nothing is mutated; the same journal can be diagnosed repeatedly and then restored normally.
+ */
+export async function diagnoseKernelJournal(kernel, journal, operationId) {
+    const checkpoint = await journal.latestCheckpoint(operationId);
+    const records = await journal.recordsAfter(operationId, checkpoint?.covered_head);
+    try {
+        const cost = kernel.restore(checkpoint ? Buffer.from(checkpoint.checkpoint_bytes) : undefined, records.map(record => Buffer.from(record.record_bytes)));
+        return {
+            operationId,
+            recordCount: records.length,
+            restorable: true,
+            divergenceStep: null,
+            divergenceReason: null,
+            terminal: parseJson(kernel.terminalJson()),
+            pendingEffects: parsePendingEffects(kernel.pendingEffectsJson()),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const match = DIVERGENCE_STEP.exec(message);
+        return {
+            operationId,
+            recordCount: records.length,
+            restorable: false,
+            divergenceStep: match ? Number(match[1]) : null,
+            divergenceReason: message,
+            terminal: undefined,
+            pendingEffects: [],
+        };
+    }
+}
+function parseJson(value) {
+    if (!value)
+        return undefined;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function parsePendingEffects(raw) {
+    const parsed = parseJson(raw);
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed.map(envelope => {
+        const effect = envelope?.effect;
+        return {
+            effect_id: String(envelope?.effect_id ?? ""),
+            kind: String(effect?.kind ?? ""),
+        };
+    });
+}

package/dist/runtime/kernel-step.d.ts

@@ -73,11 +73,7 @@ export type KernelRunnerAction = {
 } | {
     kind: "archive_page_out";
     effectId: string;
-    turn?: number;
-    action?: string;
-    summary?: string;
     archived?: Message[];
-    tier?: string;
     handleId?: string;
     payload?: {
         content: string;
@@ -200,7 +196,18 @@ export interface KernelObservation {
     rollbacks_in_window?: number;
     window_turns?: number;
     threshold?: number;
+    effects?: Array<{
+        effect_id: string;
+        kind: string;
+    }>;
 }
+/** Presentation/policy facts for an archive action come from committed observations, never from
+ * the wire effect projection. */
+export declare function archivePresentationFromObservations(observations: readonly KernelObservation[]): {
+    action?: string;
+    summary?: string;
+    tier?: "semantic" | "durable";
+};
 export declare function toolSchemaToKernel(schema: ToolSchema): Record<string, unknown>;
 export declare function skillMetadataToKernel(skill: SkillMetadata): Record<string, unknown>;
 export declare function messageToKernelMessage(message: Message): Record<string, unknown>;

package/dist/runtime/kernel-step.js

@@ -15,6 +15,26 @@ function decodeCanonicalContentParts(content) {
         return undefined;
     }
 }
+/** Presentation/policy facts for an archive action come from committed observations, never from
+ * the wire effect projection. */
+export function archivePresentationFromObservations(observations) {
+    const compressed = [...observations].reverse().find(observation => observation.kind === "compressed");
+    if (!compressed)
+        return {};
+    const action = compressionActionFromObservation(compressed.action);
+    if (!action)
+        return {};
+    return {
+        action,
+        ...(compressed.summary ? { summary: compressed.summary } : {}),
+        tier: action === "context_collapse" || action === "auto_compact" ? "semantic" : "durable",
+    };
+}
+function compressionActionFromObservation(action) {
+    return action === "snip_compact" || action === "micro_compact" || action === "context_collapse" || action === "auto_compact"
+        ? action
+        : undefined;
+}
 function tryParseJson(s) {
     try {
         return JSON.parse(s);

package/dist/runtime/provider-replay.d.ts

@@ -1,5 +1,9 @@
 import type { LLMProvider, Message, ProviderDescriptor, ProviderReplay, RenderedContext, ReplayabilityAssessment, ToolCall } from "../types.js";
 import type { SessionEvent } from "./session-log.js";
+export declare class ProviderReplayProtocolMismatchError extends Error {
+    readonly code: "provider_replay_protocol_mismatch";
+    constructor(provider: string, storedProtocol: string, resolvedProtocol: string);
+}
 export declare function assistantReplayKey(message: Pick<Message, "content" | "toolCalls">): string;
 /**
  * A stored replay may only be seeded into a provider speaking the same wire

package/dist/runtime/provider-replay.js

@@ -1,3 +1,11 @@
+export class ProviderReplayProtocolMismatchError extends Error {
+    code = "provider_replay_protocol_mismatch";
+    constructor(provider, storedProtocol, resolvedProtocol) {
+        super(`Stored ${storedProtocol} tool replay is incompatible with resolved ${provider}/${resolvedProtocol}; `
+            + `pin the previous ${storedProtocol} endpoint explicitly to resume this session`);
+        this.name = "ProviderReplayProtocolMismatchError";
+    }
+}
 function sortObjectKeys(val) {
     if (val === null || typeof val !== "object") {
         return val;
@@ -60,8 +68,14 @@ export function seedProviderReplayFromEvents(provider, events) {
             continue;
         const toolCalls = event.tool_calls ?? [];
         const stored = event.provider_replay;
-        if (!stored || !isReplayCompatibleWithProvider(stored, descriptor))
+        if (!stored)
             continue;
+        if (!isReplayCompatibleWithProvider(stored, descriptor)) {
+            if (toolCalls.length > 0 && descriptor) {
+                throw new ProviderReplayProtocolMismatchError(descriptor.provider, stored.protocol, descriptor.protocol);
+            }
+            continue;
+        }
         provider.seedProviderReplay({ content: event.content, toolCalls }, stored);
     }
 }