@deepstrike/sdk 0.2.51 → 0.2.52

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

@@ -30,6 +30,10 @@ export interface CanonicalTransition {
     recordDigest: string;
     plannedStep: CanonicalPlannedStep;
     checkpointAdvice?: Record<string, unknown>;
+    /** Set when the advised §12.3 checkpoint failed AFTER this step was durably committed.
+     *  The step itself is published and authoritative; the checkpoint is deferred
+     *  housekeeping retried at the next advice or forced by the checkpoint_required gate. */
+    checkpointFailure?: string;
     replayed: boolean;
 }
 export declare function canonicalUnsupportedEffectResolution(effectId: string, effectKind: string): CanonicalKernelInput;
@@ -44,8 +48,13 @@ export declare class CanonicalKernelRejectedError extends Error {
  * is therefore a rebuild boundary, never an abort boundary.
  */
 export declare class CanonicalKernelRebuildRequiredError extends Error {
+    /** True when the runtime was already rebuilt from the journal with the durable record
+     *  applied — the caller can resync and continue. False when the rebuild itself failed
+     *  and the operation cannot proceed without journal repair. */
+    readonly rebuilt: boolean;
     constructor(message: string, options?: {
         cause?: unknown;
+        rebuilt?: boolean;
     });
 }
 /**

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

@@ -281,9 +281,14 @@ export class CanonicalKernelRejectedError extends Error {
  * is therefore a rebuild boundary, never an abort boundary.
  */
 export class CanonicalKernelRebuildRequiredError extends Error {
+    /** True when the runtime was already rebuilt from the journal with the durable record
+     *  applied — the caller can resync and continue. False when the rebuild itself failed
+     *  and the operation cannot proceed without journal repair. */
+    rebuilt;
     constructor(message, options) {
-        super(message, options);
+        super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);
         this.name = "CanonicalKernelRebuildRequiredError";
+        this.rebuilt = options?.rebuilt ?? false;
     }
 }
 function chainPosition(value, label) {
@@ -434,6 +439,7 @@ export class CanonicalKernelHost {
         }
         const stepSeq = chainPosition(preparation.stepSeq, "prepared stepSeq");
         let appended = false;
+        let transition;
         try {
             const receipt = await this.journal.compareAndAppend(this.operationId, preparation.expectedHead, {
                 step_seq: stepSeq,
@@ -447,7 +453,7 @@ export class CanonicalKernelHost {
                 throw new Error("canonical commit receipt disagrees with the durably appended record");
             }
             const checkpointAdvice = parseAdvice(committed.checkpointAdviceJson);
-            const transition = {
+            transition = {
                 inputJson,
                 stepSeq,
                 recordDigest: committed.recordDigest,
@@ -455,9 +461,6 @@ export class CanonicalKernelHost {
                 ...(checkpointAdvice ? { checkpointAdvice } : {}),
                 replayed: false,
             };
-            if (checkpointAdvice)
-                await this.checkpoint();
-            return transition;
         }
         catch (error) {
             if (appended) {
@@ -467,7 +470,7 @@ export class CanonicalKernelHost {
                 catch (restoreError) {
                     throw new CanonicalKernelRebuildRequiredError("canonical record is durable, commit failed, and journal rebuild also failed", { cause: new AggregateError([error, restoreError]) });
                 }
-                throw new CanonicalKernelRebuildRequiredError("canonical record is durable but commit could not be published; runtime rebuilt from journal", { cause: error });
+                throw new CanonicalKernelRebuildRequiredError("canonical record is durable but commit could not be published; runtime rebuilt from journal", { cause: error, rebuilt: true });
             }
             try {
                 this.kernel.abort(preparation.prepareToken);
@@ -481,6 +484,19 @@ export class CanonicalKernelHost {
             }
             throw error;
         }
+        // Past this point the step is durable AND committed. A failing advised checkpoint
+        // must not be misdiagnosed as a lost commit: it is deferred housekeeping — the next
+        // advice retries it, and the checkpoint_required prepare gate is the hard backstop.
+        if (transition.checkpointAdvice) {
+            try {
+                await this.checkpoint();
+            }
+            catch (checkpointError) {
+                transition.checkpointFailure =
+                    checkpointError instanceof Error ? checkpointError.message : String(checkpointError);
+            }
+        }
+        return transition;
     }
 }
 function canonicalProviderMessage(raw) {
@@ -1100,22 +1116,45 @@ export class CanonicalRunnerRuntime {
     async commit(input) {
         let nextInput = input;
         for (;;) {
-            const transition = await this.host.transition(nextInput);
-            if (!transition.replayed) {
-                for (const raw of transition.plannedStep.observations ?? []) {
-                    const kind = String(raw.kind ?? "");
-                    if (!kind)
-                        throw new Error("canonical observation is missing kind");
-                    this.hostObservations.push({ ...raw, kind });
-                }
-                if (transition.checkpointAdvice) {
-                    this.hostObservations.push({
-                        kind: "checkpoint_advised",
-                        ...transition.checkpointAdvice,
-                    });
+            let transition;
+            try {
+                transition = await this.host.transition(nextInput);
+            }
+            catch (error) {
+                if (!(error instanceof CanonicalKernelRebuildRequiredError) || !error.rebuilt)
+                    throw error;
+                // The input's record is durable and the kernel was rebuilt from the journal with it
+                // applied; only that step's observations are lost (the crash-window cost). Resync and
+                // publish the rebuilt kernel's pending work instead of failing a healthy run.
+                const lifecycle = this.host.kernel.lifecycle();
+                this.configured = lifecycle !== "created";
+                this.started = !["created", "configured"].includes(lifecycle);
+                this.hostObservations.push({ kind: "kernel_rebuilt", reason: error.message });
+                this.lastAction = this.currentAction();
+            }
+            if (transition) {
+                if (!transition.replayed) {
+                    for (const raw of transition.plannedStep.observations ?? []) {
+                        const kind = String(raw.kind ?? "");
+                        if (!kind)
+                            throw new Error("canonical observation is missing kind");
+                        this.hostObservations.push({ ...raw, kind });
+                    }
+                    if (transition.checkpointAdvice) {
+                        this.hostObservations.push({
+                            kind: "checkpoint_advised",
+                            ...transition.checkpointAdvice,
+                        });
+                    }
+                    if (transition.checkpointFailure) {
+                        this.hostObservations.push({
+                            kind: "checkpoint_deferred",
+                            reason: transition.checkpointFailure,
+                        });
+                    }
                 }
+                this.lastAction = canonicalActionFromPlannedStep(transition.plannedStep);
             }
-            this.lastAction = canonicalActionFromPlannedStep(transition.plannedStep);
             if (this.lastAction?.kind !== "unsupported_effect")
                 return this.lastAction;
             nextInput = canonicalUnsupportedEffectResolution(this.lastAction.effectId, this.lastAction.effectKind);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstrike/sdk",
-  "version": "0.2.51",
+  "version": "0.2.52",
   "description": "DeepStrike Node.js SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -72,7 +72,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.99.0",
-    "@deepstrike/core": "0.2.51",
+    "@deepstrike/core": "0.2.52",
     "@google/generative-ai": "^0.24.1",
     "openai": "^5.23.2"
   },