@rasputin-ai/node 0.6.2 → 0.7.0

package/dist/execution-recorder/error-observation.d.ts

@@ -0,0 +1,14 @@
+import type { ErrorObservation } from '@rasputin-ai/core';
+export type ObservationProvenance = 'instrumented-throw' | 'scope-observe';
+export type ObservationBinding = {
+    owner: object;
+    ownerGeneration: number;
+    recordingId: string;
+    recordingGeneration: number;
+    occurrenceId: number;
+    provenance: ObservationProvenance;
+};
+export declare const mintErrorObservation: (binding: ObservationBinding) => ErrorObservation;
+export declare const bindingForObservation: (value: unknown) => ObservationBinding | undefined;
+export declare const inertErrorObservation: () => ErrorObservation;
+//# sourceMappingURL=error-observation.d.ts.map

package/dist/execution-recorder/error-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-observation.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/error-observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,GAAG,eAAe,CAAC;AAE3E,MAAM,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,qBAAqB,CAAC;CAClC,CAAC;AAIF,eAAO,MAAM,oBAAoB,GAAI,SAAS,kBAAkB,KAAG,gBAIlE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,kBAAkB,GAAG,SAG3E,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAO,gBAExC,CAAC"}

package/dist/execution-recorder/execution-recorder-types.d.ts

@@ -3,7 +3,7 @@
  * event model explicit allows the same bounded state to represent HTTP requests, jobs, scheduled
  * work, and future serverless invocations without coupling the recorder to one framework lifecycle.
  */
-import type { RuntimeExecutionEvent, RuntimeExecutionKind, RuntimeExecutionMetadata, RuntimeExecutionState, RuntimeFunctionDefinition, SourcePosition } from '@rasputin-ai/core';
+import type { ErrorObservation, RuntimeExecutionEvent, RuntimeExecutionKind, RuntimeExecutionMetadata, RuntimeExecutionState, RuntimeFunctionDefinition, SourcePosition } from '@rasputin-ai/core';
 import type { EncodedFunctionPlan } from '@rasputin-ai/recorder';
 import type { PreparedFunctionPlan } from './function-plan';
 /** A file glob (`src/logger/**`) or a regular expression matched against a function id. */
@@ -62,7 +62,7 @@ export type ExecutionRecorderOptions = {
      */
     maxExecutionHoldMs?: number;
     /**
-     * How many finished error recordings to keep for later `getErrorState` lookups.
+     * How many finished error recordings to keep for later observation lookups.
      * Older finished recordings are evicted and report `unavailable` /
      * `retained_state_evicted`. Default: 32.
      */
@@ -151,13 +151,16 @@ export type ExecutionRecorderStats = {
 export type ExecutionScope = {
     /** Run `callback` under this recording's async context and return exactly what it returned. */
     run: <T>(callback: () => T) => T;
-    /** Bind `error` to this recording without materializing the snapshot. */
-    associateError: (error: unknown) => void;
+    /**
+     * Observe this failure as belonging to this execution. Ownership is fixed
+     * here; later capture only materializes this handle.
+     */
+    observeError: (error: unknown) => ErrorObservation;
     /** Mark the recording finished. The caller owns async completion. */
     finish: (metadata?: Partial<ExecutionMetadata>) => void;
 };
 export type ExecutionRuntimeScope = ExecutionScope & {
-    getErrorState: (error: unknown, metadata?: Partial<ExecutionMetadata>) => ExecutionState | undefined;
+    getErrorState: (observation: ErrorObservation) => ExecutionState | undefined;
 };
 export type PreparedCallHandle = {
     leave: (value?: unknown) => unknown;
@@ -175,7 +178,7 @@ export type PreparedCallHandle = {
     resume: (value?: unknown) => unknown;
 };
 export type RasputinExecution = {
-    /** Start a recording you will drive yourself with `run` / `associateError` / `finish`. */
+    /** Start a recording you will drive yourself with `run` / `observeError` / `finish`. */
     createScope: (metadata: ExecutionMetadata) => ExecutionScope;
     /**
      * Wrap a function yourself when automatic instrumentation is not available.
@@ -191,7 +194,7 @@ export type ExecutionRuntime = {
     createScope: (metadata: ExecutionMetadata) => ExecutionRuntimeScope;
     trace: RasputinExecution['trace'];
     getStats: RasputinExecution['getStats'];
-    getErrorState: (error: unknown, metadata?: Partial<ExecutionMetadata>) => ExecutionState | undefined;
+    getErrorState: (observation: ErrorObservation) => ExecutionState | undefined;
     runFunction: <T>(definition: RuntimeFunctionDefinition | string, args: ArrayLike<unknown>, callback: () => T) => T;
     runFunctionPlans: <T>(plans: readonly EncodedFunctionPlan[], planIndex: number, args: ArrayLike<unknown>, callback: () => T, omitValues?: boolean) => T;
     prepareFunctionPlans: (plans: readonly EncodedFunctionPlan[]) => PreparedFunctionPlan[];

package/dist/execution-recorder/execution-recorder-types.d.ts.map

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

package/dist/execution-recorder/execution-recorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-recorder.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/execution-recorder.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAGX,wBAAwB,EACxB,gBAAgB,EAGhB,MAAM,4BAA4B,CAAC;AAwOpC,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,GACnC,SAAS,wBAAwB,GAAG,SAAS,KAC3C,gBAq8CF,CAAC"}
+{"version":3,"file":"execution-recorder.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/execution-recorder.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAGX,wBAAwB,EACxB,gBAAgB,EAGhB,MAAM,4BAA4B,CAAC;AA2OpC,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,GACnC,SAAS,wBAAwB,GAAG,SAAS,KAC3C,gBA2/CF,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { CaptureContext, RasputinClient, RasputinOptions } from '@rasputin-ai/core';
+export type { CaptureContext, ErrorObservation, RasputinClient, RasputinOptions, } from '@rasputin-ai/core';
 export type { ExecutionFunctionDescriptor, ExecutionKind, ExecutionMetadata, ExecutionRecorderOptions, ExecutionRecorderStats, ExecutionScope, ExecutionSourceExclusion, RasputinExecution, } from './execution-recorder';
 export type { RasputinNodeClient, RasputinNodeClientStats, RasputinNodeOptions, } from './rasputin-init';
 export { RasputinInit } from './rasputin-init';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzF,YAAY,EACX,2BAA2B,EAC3B,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACX,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,GACf,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACX,2BAA2B,EAC3B,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACX,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -694,6 +694,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;
@@ -2700,8 +2715,7 @@ var noOpExecution = {
   createScope: () => ({
     run: (callback) => callback(),
     getErrorState: () => void 0,
-    associateError: () => {
-    },
+    observeError: () => inertErrorObservation(),
     finish: () => {
     }
   }),
@@ -2814,7 +2828,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 = {
@@ -3047,6 +3066,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;
@@ -3071,6 +3123,8 @@ var createExecutionRecorder = (options) => {
         eventsDropped: Math.max(1, dropped)
       }
     };
+    evictedRecordingIds.push(recording.executionId);
+    dropOldestEvictedRecording();
   };
   const trimFinishedRetainedRecordings = (keep) => {
     while (retainedErrorRecordings.length > maxRetainedErrorRecordings) {
@@ -3148,10 +3202,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
@@ -3169,15 +3230,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;
@@ -3241,11 +3310,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;
@@ -3271,7 +3338,6 @@ var createExecutionRecorder = (options) => {
       capturedError.commit();
     }
     countDroppedEvents(recording, droppedBefore);
-    rememberError(error, recording);
   };
   const recordSuppressedCall = (recording, group, parentCallId, startedAtNs, endedAtNs) => {
     stats.repeatedCallsSuppressed++;
@@ -3317,7 +3383,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 {
     }
   };
@@ -3329,6 +3400,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++;
       }
@@ -3354,6 +3428,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,
@@ -3376,6 +3451,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 {
@@ -3389,8 +3465,9 @@ var createExecutionRecorder = (options) => {
               try {
                 return callback();
               } catch (error) {
+                recording.runFailed = true;
                 if (recording.budgetExpired || recording.evicted) {
-                  rememberError(error, recording);
+                  retainFailure(recording);
                 }
                 throw error;
               }
@@ -3400,21 +3477,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)
@@ -3423,16 +3500,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;
     }
@@ -3467,7 +3537,7 @@ var createExecutionRecorder = (options) => {
         return callback();
       } catch (error) {
         if (store.recording.budgetExpired || store.recording.evicted) {
-          rememberError(error, store.recording);
+          retainFailure(store.recording);
         }
         throw error;
       }
@@ -3515,8 +3585,7 @@ var createExecutionRecorder = (options) => {
           recorderStartedAtNs,
           callback,
           () => settleInFlight(recording),
-          (error) => {
-            rememberError(error, recording);
+          (_error) => {
             settleInFlight(recording);
           }
         );
@@ -3548,8 +3617,7 @@ var createExecutionRecorder = (options) => {
         recorderStartedAtNs,
         callback,
         () => settleInFlight(recording),
-        (error) => {
-          rememberError(error, recording);
+        (_error) => {
           settleInFlight(recording);
         }
       );
@@ -3567,8 +3635,7 @@ var createExecutionRecorder = (options) => {
           recorderStartedAtNs,
           callback,
           () => settleInFlight(recording),
-          (error) => {
-            rememberError(error, recording);
+          (_error) => {
             settleInFlight(recording);
           }
         );
@@ -3592,7 +3659,6 @@ var createExecutionRecorder = (options) => {
         },
         (error) => {
           if (!recording.journal) {
-            rememberError(error, recording);
             settleInFlight(recording);
             return;
           }
@@ -3606,7 +3672,6 @@ var createExecutionRecorder = (options) => {
           );
           stats.functionCallsCaptured++;
           capturedError.commit();
-          rememberError(error, recording);
           settleInFlight(recording);
         }
       );
@@ -3681,8 +3746,7 @@ var createExecutionRecorder = (options) => {
       const expiredStore = { recording: expired };
       return {
         leave: (value) => value,
-        fail: (error) => {
-          rememberError(error, expired);
+        fail: () => {
         },
         end: () => {
         },
@@ -3816,10 +3880,9 @@ var createExecutionRecorder = (options) => {
           }
           return value;
         },
-        fail: (error) => {
+        fail: (_error) => {
           if (status === "failed") return;
           status = "failed";
-          rememberError(error, recording);
         },
         end: finishEnd,
         ...context
@@ -3840,10 +3903,9 @@ var createExecutionRecorder = (options) => {
           }
           return value;
         },
-        fail: (error) => {
+        fail: (_error) => {
           if (status === "failed") return;
           status = "failed";
-          rememberError(error, recording);
         },
         end: finishEnd,
         ...context
@@ -3856,7 +3918,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);
@@ -3871,7 +3934,6 @@ var createExecutionRecorder = (options) => {
     };
     const writeThrow = (error) => {
       if (!recording.journal) {
-        rememberError(error, recording);
         return;
       }
       const capturedError = serializedError(recording, error, callId);
@@ -3884,7 +3946,6 @@ var createExecutionRecorder = (options) => {
       );
       stats.functionCallsCaptured++;
       capturedError.commit();
-      rememberError(error, recording);
     };
     return {
       leave: (value) => {
@@ -3900,7 +3961,6 @@ var createExecutionRecorder = (options) => {
         try {
           writeThrow(error);
         } catch {
-          rememberError(error, recording);
         }
       },
       end: () => {
@@ -4205,7 +4265,7 @@ var installGlobalHandlers = (client, options = {}) => {
 
 // src/sdk-meta.ts
 var SDK_NAME = "@rasputin-ai/node";
-var SDK_VERSION = "0.6.2";
+var SDK_VERSION = "0.7.0";
 
 // src/rasputin-init.ts
 var publicExecution = (runtime) => ({
@@ -4213,7 +4273,7 @@ var publicExecution = (runtime) => ({
     const scope = runtime.createScope(metadata);
     return {
       run: scope.run,
-      associateError: scope.associateError,
+      observeError: scope.observeError,
       finish: scope.finish
     };
   },
@@ -4267,10 +4327,7 @@ var RasputinInit = (options) => {
       sdkVersion: SDK_VERSION,
       sdkName: SDK_NAME,
       installTransportSignalHandlers: options.installTransportSignalHandlers,
-      resolveRuntimeState: (error, context) => runtime.getErrorState(
-        error,
-        context?.request ? { kind: "http", request: context.request } : void 0
-      )
+      resolveObservation: (observation) => runtime.getErrorState(observation)
     });
     if (enabled) {
       loadInstrumentationManifestIfPresent(