@rasputin-ai/node 0.6.2 → 0.7.1

package/dist/internal.d.ts

@@ -2,6 +2,7 @@ export { scheduleInstrumentationManifestUpload } from './auto-instrumentation/sc
 export type { ExecutionRuntime, ExecutionRuntimeScope, ExecutionState, PreparedCallHandle, } from './execution-recorder';
 export { createExecutionRecorder } from './execution-recorder';
 export { installAutomaticExecutionRuntime } from './execution-recorder/automatic-runtime';
+export { inertErrorObservation } from './execution-recorder/error-observation';
 export type { InstallGlobalHandlersOptions } from './install-global-handlers';
 export { installGlobalHandlers } from './install-global-handlers';
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,iEAAiE,CAAC;AACxH,YAAY,EACX,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAC;AAC1F,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,iEAAiE,CAAC;AACxH,YAAY,EACX,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/internal.js

@@ -665,6 +665,21 @@ import {
   runtimeFunctionId as runtimeFunctionId2
 } from "@rasputin-ai/core";
 
+// src/execution-recorder/error-observation.ts
+var bindings = /* @__PURE__ */ new WeakMap();
+var mintErrorObservation = (binding) => {
+  const observation = Object.freeze(/* @__PURE__ */ Object.create(null));
+  bindings.set(observation, binding);
+  return observation;
+};
+var bindingForObservation = (value) => {
+  if (typeof value !== "object" || value === null) return void 0;
+  return bindings.get(value);
+};
+var inertErrorObservation = () => {
+  return Object.freeze(/* @__PURE__ */ Object.create(null));
+};
+
 // src/execution-recorder/execution-journal.ts
 var KIND_ENTER = 1;
 var KIND_EXIT = 2;
@@ -2671,8 +2686,7 @@ var noOpExecution = {
   createScope: () => ({
     run: (callback) => callback(),
     getErrorState: () => void 0,
-    associateError: () => {
-    },
+    observeError: () => inertErrorObservation(),
     finish: () => {
     }
   }),
@@ -2785,7 +2799,12 @@ var createExecutionRecorder = (options) => {
   let nextRuntimePlanId = 1;
   const internedPlans = /* @__PURE__ */ new Map();
   const preparedModules = /* @__PURE__ */ new WeakMap();
-  const errorExecutions = /* @__PURE__ */ new WeakMap();
+  const owner = {};
+  const ownerGeneration = 1;
+  let storageClock = 0;
+  let occurrenceCounter = 0;
+  const recordingsById = /* @__PURE__ */ new Map();
+  const evictedRecordingIds = [];
   const retainedErrorRecordings = [];
   const phases = phaseTimingEnabled ? { alsNs: 0n, materializeNs: 0n } : void 0;
   const stats = {
@@ -3018,6 +3037,39 @@ var createExecutionRecorder = (options) => {
     };
     return boundedState.truncated?.size ? enforceRuntimeStateSizeBudget(boundedState, runtimeStateSizeBudget) : boundedState;
   };
+  const forgetDiscardedRecording = (recording) => {
+    if (recording.hasError || recording.retainedForError) return;
+    recordingsById.delete(recording.executionId);
+  };
+  const discardSuccessfulEvidence = (recording) => {
+    if (recording.evidenceDiscarded) return;
+    recording.evidenceDiscarded = true;
+    recording.cachedState = void 0;
+    recording.repeatedCalls = [];
+    recording.lateCapturedCallIds = void 0;
+    recording.capturedErrors = /* @__PURE__ */ new WeakMap();
+    if (recording.journal) {
+      journalPool.release(recording.journal);
+      recording.journal = void 0;
+    }
+    recordingsById.delete(recording.executionId);
+  };
+  const mintOccurrence = (recording, provenance) => mintErrorObservation({
+    owner,
+    ownerGeneration,
+    recordingId: recording.executionId,
+    recordingGeneration: recording.storageGeneration,
+    occurrenceId: ++occurrenceCounter,
+    provenance
+  });
+  const dropOldestEvictedRecording = () => {
+    while (evictedRecordingIds.length > maxRetainedErrorRecordings) {
+      const oldId = evictedRecordingIds.shift();
+      if (!oldId) continue;
+      const old = recordingsById.get(oldId);
+      if (old?.evicted) recordingsById.delete(oldId);
+    }
+  };
   const evictRetainedRecording = (recording) => {
     const eventCount = recording.cachedState?.events.length ?? recording.journal?.eventCount ?? 0;
     const dropped = (recording.cachedState?.truncated?.eventsDropped ?? recording.journal?.dropped ?? 0) + eventCount;
@@ -3042,6 +3094,8 @@ var createExecutionRecorder = (options) => {
         eventsDropped: Math.max(1, dropped)
       }
     };
+    evictedRecordingIds.push(recording.executionId);
+    dropOldestEvictedRecording();
   };
   const trimFinishedRetainedRecordings = (keep) => {
     while (retainedErrorRecordings.length > maxRetainedErrorRecordings) {
@@ -3119,10 +3173,17 @@ var createExecutionRecorder = (options) => {
       }
     }
   };
-  const rememberError = (error, recording) => {
-    recording.hasError = true;
-    const key = (typeof error === "object" || typeof error === "function") && error !== null ? error : void 0;
-    if (recording.budgetExpired && !(key && errorExecutions.has(key))) {
+  const retainFailure = (recording) => {
+    if (recording.evidenceDiscarded) return;
+    if (!recording.hasError) {
+      recording.hasError = true;
+      stats.errorSnapshots++;
+      if (recording.memory.underPressure && !recording.partialSnapshotCounted) {
+        recording.partialSnapshotCounted = true;
+        stats.partialErrorSnapshots++;
+      }
+    }
+    if (recording.budgetExpired) {
       const eventsDropped = Math.max(
         1,
         recording.cachedState?.capture?.eventsDropped ?? recording.cachedState?.truncated?.eventsDropped ?? recording.memory.eventsDropped
@@ -3140,15 +3201,23 @@ var createExecutionRecorder = (options) => {
       };
     }
     retainErrorRecording(recording);
-    if (!key) return;
-    if (!errorExecutions.has(key)) {
-      stats.errorSnapshots++;
-      if (recording.memory.underPressure && !recording.partialSnapshotCounted) {
-        recording.partialSnapshotCounted = true;
-        stats.partialErrorSnapshots++;
-      }
+    recordingsById.set(recording.executionId, recording);
+  };
+  const observeFailure = (recording, provenance) => {
+    if (!recording.evidenceDiscarded) {
+      retainFailure(recording);
+    }
+    return mintOccurrence(recording, provenance);
+  };
+  const stateForObservation = (observation) => {
+    const binding = bindingForObservation(observation);
+    if (!binding) return void 0;
+    if (binding.owner !== owner || binding.ownerGeneration !== ownerGeneration) return void 0;
+    const recording = recordingsById.get(binding.recordingId);
+    if (!recording || recording.evidenceDiscarded || recording.storageGeneration !== binding.recordingGeneration) {
+      return void 0;
     }
-    errorExecutions.set(key, recording);
+    return stateFrom(recording, recording.finishedAtNs);
   };
   const countDroppedEvents = (recording, droppedBefore) => {
     const dropped = recording.journal?.dropped ?? droppedBefore;
@@ -3212,11 +3281,9 @@ var createExecutionRecorder = (options) => {
   };
   const captureCompletedThrow = (recording, plan, args, parentCallId, startedAtNs, error, capturedArgs) => {
     if (!recording.journal) {
-      rememberError(error, recording);
       return;
     }
     if (!memoryBudget.reserveCall(recording.memory, plan.estimatedCallBytes)) {
-      rememberError(error, recording);
       return;
     }
     const callId = ++recording.nextCallId;
@@ -3242,7 +3309,6 @@ var createExecutionRecorder = (options) => {
       capturedError.commit();
     }
     countDroppedEvents(recording, droppedBefore);
-    rememberError(error, recording);
   };
   const recordSuppressedCall = (recording, group, parentCallId, startedAtNs, endedAtNs) => {
     stats.repeatedCallsSuppressed++;
@@ -3288,7 +3354,12 @@ var createExecutionRecorder = (options) => {
     try {
       if (!recording.finished || recording.inFlightCalls > 0) return;
       memoryBudget.release(recording.memory);
+      if (!recording.hasError && !recording.retainedForError) {
+        discardSuccessfulEvidence(recording);
+        return;
+      }
       releaseJournalIfIdle(recording);
+      forgetDiscardedRecording(recording);
     } catch {
     }
   };
@@ -3300,6 +3371,9 @@ var createExecutionRecorder = (options) => {
       recording.finished = true;
       if (metadata) mergeExecutionMetadata(recording.execution, metadata);
       stats.activeExecutions = Math.max(0, stats.activeExecutions - 1);
+      if (recording.runFailed && !recording.hasError) {
+        retainFailure(recording);
+      }
       if (!recording.hasError) {
         stats.successfulExecutionsDiscarded++;
       }
@@ -3325,6 +3399,7 @@ var createExecutionRecorder = (options) => {
       sweepLongLivedExecutions(recorderStartedAtNs);
       const recording = {
         executionId: `${Date.now()}-${process.pid}-${++executionCounter}`,
+        storageGeneration: ++storageClock,
         startedAt: (/* @__PURE__ */ new Date()).toISOString(),
         startedAtNs: recorderStartedAtNs,
         inlineRecorderTimeNs: 0n,
@@ -3347,6 +3422,7 @@ var createExecutionRecorder = (options) => {
       stats.activeExecutions++;
       stats.peakActiveExecutions = Math.max(stats.peakActiveExecutions, stats.activeExecutions);
       liveRecordings.push(recording);
+      recordingsById.set(recording.executionId, recording);
       addRecorderTime(recording, process.hrtime.bigint() - recorderStartedAtNs);
       const store = { recording };
       return {
@@ -3360,8 +3436,9 @@ var createExecutionRecorder = (options) => {
               try {
                 return callback();
               } catch (error) {
+                recording.runFailed = true;
                 if (recording.budgetExpired || recording.evicted) {
-                  rememberError(error, recording);
+                  retainFailure(recording);
                 }
                 throw error;
               }
@@ -3371,21 +3448,21 @@ var createExecutionRecorder = (options) => {
             return callback();
           }
         },
-        getErrorState: (error, errorMetadata) => {
+        observeError: (_error) => {
           try {
-            const getStateStartedAtNs = process.hrtime.bigint();
-            if (errorMetadata) mergeExecutionMetadata(recording.execution, errorMetadata);
-            rememberError(error, recording);
-            addRecorderTime(recording, process.hrtime.bigint() - getStateStartedAtNs);
-            return stateFrom(recording, recording.finishedAtNs);
+            return observeFailure(recording, "scope-observe");
           } catch {
-            return void 0;
+            return inertErrorObservation();
           }
         },
-        associateError: (error) => {
+        getErrorState: (observation) => {
           try {
-            rememberError(error, recording);
+            const getStateStartedAtNs = process.hrtime.bigint();
+            const state = stateForObservation(observation);
+            addRecorderTime(recording, process.hrtime.bigint() - getStateStartedAtNs);
+            return state;
           } catch {
+            return void 0;
           }
         },
         finish: (finishMetadata) => finish(store, finishMetadata)
@@ -3394,16 +3471,9 @@ var createExecutionRecorder = (options) => {
       return noOpExecution.createScope(metadata);
     }
   };
-  const getErrorState = (error, metadata) => {
-    const getStateStartedAtNs = process.hrtime.bigint();
+  const getErrorState = (observation) => {
     try {
-      const weakKey = (typeof error === "object" || typeof error === "function") && error !== null ? error : void 0;
-      const recording = (weakKey ? errorExecutions.get(weakKey) : void 0) ?? currentStore()?.recording;
-      if (!recording) return void 0;
-      if (metadata) mergeExecutionMetadata(recording.execution, metadata);
-      rememberError(error, recording);
-      addRecorderTime(recording, process.hrtime.bigint() - getStateStartedAtNs);
-      return stateFrom(recording, recording.finishedAtNs);
+      return stateForObservation(observation);
     } catch {
       return void 0;
     }
@@ -3438,7 +3508,7 @@ var createExecutionRecorder = (options) => {
         return callback();
       } catch (error) {
         if (store.recording.budgetExpired || store.recording.evicted) {
-          rememberError(error, store.recording);
+          retainFailure(store.recording);
         }
         throw error;
       }
@@ -3486,8 +3556,7 @@ var createExecutionRecorder = (options) => {
           recorderStartedAtNs,
           callback,
           () => settleInFlight(recording),
-          (error) => {
-            rememberError(error, recording);
+          (_error) => {
             settleInFlight(recording);
           }
         );
@@ -3519,8 +3588,7 @@ var createExecutionRecorder = (options) => {
         recorderStartedAtNs,
         callback,
         () => settleInFlight(recording),
-        (error) => {
-          rememberError(error, recording);
+        (_error) => {
           settleInFlight(recording);
         }
       );
@@ -3538,8 +3606,7 @@ var createExecutionRecorder = (options) => {
           recorderStartedAtNs,
           callback,
           () => settleInFlight(recording),
-          (error) => {
-            rememberError(error, recording);
+          (_error) => {
             settleInFlight(recording);
           }
         );
@@ -3563,7 +3630,6 @@ var createExecutionRecorder = (options) => {
         },
         (error) => {
           if (!recording.journal) {
-            rememberError(error, recording);
             settleInFlight(recording);
             return;
           }
@@ -3577,7 +3643,6 @@ var createExecutionRecorder = (options) => {
           );
           stats.functionCallsCaptured++;
           capturedError.commit();
-          rememberError(error, recording);
           settleInFlight(recording);
         }
       );
@@ -3652,8 +3717,7 @@ var createExecutionRecorder = (options) => {
       const expiredStore = { recording: expired };
       return {
         leave: (value) => value,
-        fail: (error) => {
-          rememberError(error, expired);
+        fail: () => {
         },
         end: () => {
         },
@@ -3787,10 +3851,9 @@ var createExecutionRecorder = (options) => {
           }
           return value;
         },
-        fail: (error) => {
+        fail: (_error) => {
           if (status === "failed") return;
           status = "failed";
-          rememberError(error, recording);
         },
         end: finishEnd,
         ...context
@@ -3811,10 +3874,9 @@ var createExecutionRecorder = (options) => {
           }
           return value;
         },
-        fail: (error) => {
+        fail: (_error) => {
           if (status === "failed") return;
           status = "failed";
-          rememberError(error, recording);
         },
         end: finishEnd,
         ...context
@@ -3827,7 +3889,8 @@ var createExecutionRecorder = (options) => {
       journal.startCall(plan.runtimePlanId, callId, parentCallId, enterTimestampNs, capturedArgs);
     } catch {
       journal.dropCall();
-      return dropWithoutCapture((error) => rememberError(error, recording));
+      return dropWithoutCapture(() => {
+      });
     }
     const callStore = { recording, currentCallId: callId };
     const captured = bindStoreTransitions(callStore, parentStore, recording, plan);
@@ -3842,7 +3905,6 @@ var createExecutionRecorder = (options) => {
     };
     const writeThrow = (error) => {
       if (!recording.journal) {
-        rememberError(error, recording);
         return;
       }
       const capturedError = serializedError(recording, error, callId);
@@ -3855,7 +3917,6 @@ var createExecutionRecorder = (options) => {
       );
       stats.functionCallsCaptured++;
       capturedError.commit();
-      rememberError(error, recording);
     };
     return {
       leave: (value) => {
@@ -3871,7 +3932,6 @@ var createExecutionRecorder = (options) => {
         try {
           writeThrow(error);
         } catch {
-          rememberError(error, recording);
         }
       },
       end: () => {
@@ -4175,6 +4235,7 @@ var installGlobalHandlers = (client, options = {}) => {
 };
 export {
   createExecutionRecorder,
+  inertErrorObservation,
   installAutomaticExecutionRuntime,
   installGlobalHandlers,
   scheduleInstrumentationManifestUpload

package/dist/rasputin-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rasputin-init.d.ts","sourceRoot":"","sources":["../src/rasputin-init.ts"],"names":[],"mappings":"AAMA,OAAO,EAIN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAEN,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EACtB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG;IACnD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG;IAC3D,qFAAqF;IACrF,QAAQ,EAAE,sBAAsB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IACnE,+EAA+E;IAC/E,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,uBAAuB,CAAC;IACxC;;;OAGG;IACH,mBAAmB,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvD,CAAC;AA+DF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,mBAAmB,KAAG,kBAmE3D,CAAC"}
+{"version":3,"file":"rasputin-init.d.ts","sourceRoot":"","sources":["../src/rasputin-init.ts"],"names":[],"mappings":"AAMA,OAAO,EAIN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAEN,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EACtB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG;IACnD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG;IAC3D,qFAAqF;IACrF,QAAQ,EAAE,sBAAsB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IACnE,+EAA+E;IAC/E,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,uBAAuB,CAAC;IACxC;;;OAGG;IACH,mBAAmB,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvD,CAAC;AA+DF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,mBAAmB,KAAG,kBA+D3D,CAAC"}

package/dist/sdk-meta.d.ts

@@ -1,4 +1,4 @@
 /** Generated by scripts/generate-sdk-meta.ts — do not edit. */
 export declare const SDK_NAME = "@rasputin-ai/node";
-export declare const SDK_VERSION = "0.6.2";
+export declare const SDK_VERSION = "0.7.1";
 //# sourceMappingURL=sdk-meta.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rasputin-ai/node",
-	"version": "0.6.2",
+	"version": "0.7.1",
 	"description": "Official Rasputin AI SDK for Node and Bun.",
 	"type": "module",
 	"exports": {
@@ -37,10 +37,10 @@
 		"dist"
 	],
 	"scripts": {
-		"build": "bun ../scripts/build-package.ts .",
-		"prepublishOnly": "npm run build && bun ../scripts/check-lockstep-versions.ts",
+		"build": "bun ../../scripts/build-package.ts .",
+		"prepublishOnly": "npm run build && bun ../../scripts/check-lockstep-versions.ts",
 		"pack:check": "npm run build && npm pack --dry-run",
-		"typecheck": "bun ../scripts/build-package.ts ../core && bun ../scripts/generate-sdk-meta.ts . && bunx tsc --noEmit",
+		"typecheck": "bun ../../scripts/generate-sdk-meta.ts . && bunx tsc --noEmit",
 		"lint": "biome check .",
 		"test": "bun test"
 	},
@@ -49,7 +49,7 @@
 	},
 	"dependencies": {
 		"@jridgewell/trace-mapping": "0.3.31",
-		"@rasputin-ai/core": "0.6.2",
+		"@rasputin-ai/core": "0.7.1",
 		"typescript": "5"
 	},
 	"devDependencies": {