@rasputin-ai/node 0.5.0-alpha.8 → 0.5.0-alpha.9

package/dist/auto-instrumentation/transform-source.d.ts

@@ -4,8 +4,8 @@ export type TransformSourceOptions = {
     filePath: string;
     mapLocation?: SourceLocationMapper;
     /**
-     * analysis keeps full value capture on every hook. selective omits argument/return
-     * serialization for exact helpers whose callers can reconstruct those values. Default: analysis.
+     * analysis (default): full call capture plus derivation.
+     * selective (experimental): omit argument/return serialization for exact helpers.
      */
     derivationMode?: DerivationCaptureMode;
 };

package/dist/derivation/analyze-function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-function.d.ts","sourceRoot":"","sources":["../../src/derivation/analyze-function.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EAGb,cAAc,EAGd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAEN,KAAK,gBAAgB,EAErB,MAAM,0BAA0B,CAAC;AAIlC,MAAM,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,KAAK,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,eAAe,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC1B,CAAC;AAojBF,MAAM,MAAM,oBAAoB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,EAAE,CAAC,uBAAuB,GAAG;QAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAA;KAAE,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAClC,YAAY,EAAE,CAAC,UAAU,EACzB,SAAS,oBAAoB,EAAE,KAC7B,gBAAgB,EAmClB,CAAC"}
+{"version":3,"file":"analyze-function.d.ts","sourceRoot":"","sources":["../../src/derivation/analyze-function.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EAGb,cAAc,EAGd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAEN,KAAK,gBAAgB,EAErB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,KAAK,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,eAAe,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC1B,CAAC;AAojBF,MAAM,MAAM,oBAAoB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,EAAE,CAAC,uBAAuB,GAAG;QAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAA;KAAE,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAClC,YAAY,EAAE,CAAC,UAAU,EACzB,SAAS,oBAAoB,EAAE,KAC7B,gBAAgB,EA2ClB,CAAC"}

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":"AA0BA,OAAO,KAAK,EAGX,wBAAwB,EAExB,iBAAiB,EACjB,MAAM,4BAA4B,CAAC;AAiRpC,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,GACnC,SAAS,wBAAwB,GAAG,SAAS,KAC3C,iBA0wBF,CAAC"}
+{"version":3,"file":"execution-recorder.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/execution-recorder.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAGX,wBAAwB,EAExB,iBAAiB,EACjB,MAAM,4BAA4B,CAAC;AAiRpC,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,GACnC,SAAS,wBAAwB,GAAG,SAAS,KAC3C,iBA4yBF,CAAC"}

package/dist/index.js

@@ -391,6 +391,7 @@ import {
   capturedValueCompleteness,
   hashInstrumentationManifest,
   rasputinOmitted,
+  rasputinTagKind,
   runtimeFunctionId as runtimeFunctionId2
 } from "@rasputin-ai/core";
 
@@ -1704,21 +1705,44 @@ var createExecutionRecorder = (options) => {
       derivationRootBytes: recording.derivationRootBytes
     };
   };
-  const resolveCaptureMode = (recording) => {
-    if (recording.derivationRoots.length > 0) return "derivation";
-    const plans = snapshotInstrumentationManifest()?.derivationPlans ?? [];
-    if (recording.sawAutomatic && plans.some(
-      (plan) => !plan.fallbackReason && recording.executedFunctionIds.has(plan.functionId)
-    )) {
-      return "derivation";
+  const eventsHaveOmittedValues = (events) => {
+    for (const event of events) {
+      if (event.type === "function_enter" && event.args.some((arg) => rasputinTagKind(arg) === "omitted")) {
+        return true;
+      }
+      if (event.type === "function_exit" && rasputinTagKind(event.returnValue) === "omitted") {
+        return true;
+      }
     }
-    if (recording.sawAutomatic) return "automatic-full";
-    if (recording.sawManual) return "manual";
-    return "scope-only";
+    return false;
+  };
+  const resolveCaptureProfile = (recording, events, truncated, capture, derivation) => {
+    const source = recording.sawAutomatic ? "automatic" : recording.sawManual ? "manual" : "scope-only";
+    if (source === "scope-only") {
+      return {
+        source,
+        functionBoundaries: "none",
+        functionValues: "none",
+        timings: "none",
+        derivation: derivation ? "available" : "none"
+      };
+    }
+    const droppedEvents = Boolean(truncated?.eventsDropped || capture?.eventsDropped);
+    return {
+      source,
+      functionBoundaries: droppedEvents ? "partial" : "full",
+      functionValues: eventsHaveOmittedValues(events) ? "selective" : "full",
+      timings: droppedEvents ? "partial" : "full",
+      derivation: derivation ? "available" : "none"
+    };
   };
   const derivationCapture = (recording) => {
     const manifest = snapshotInstrumentationManifest();
     if (!manifest) return void 0;
+    const plans = manifest.derivationPlans ?? [];
+    if (!plans.some((plan) => recording.executedFunctionIds.has(plan.functionId))) {
+      return void 0;
+    }
     return {
       manifestHash: hashInstrumentationManifest(manifest),
       roots: recording.derivationRoots.slice(),
@@ -1759,8 +1783,8 @@ var createExecutionRecorder = (options) => {
       }
     }
     const state = {
-      version: 3,
-      captureMode: resolveCaptureMode(recording),
+      version: 4,
+      captureProfile: resolveCaptureProfile(recording, events, truncated, capture, derivation),
       executionId: recording.executionId,
       startedAt: recording.startedAt,
       durationMs: elapsedMs2(recording.startedAtNs, endedAtNs),
@@ -2385,7 +2409,7 @@ import {
 
 // src/sdk-meta.ts
 var SDK_NAME = "@rasputin-ai/node";
-var SDK_VERSION = "0.5.0-alpha.8";
+var SDK_VERSION = "0.5.0-alpha.9";
 
 // src/rasputin-init.ts
 var withExecution = (client, execution, installRuntime, manifest) => {

package/dist/instrument/build.js

@@ -377,9 +377,6 @@ var emptyPlan = (functionId) => ({
   controlFacts: []
 });
 
-// src/derivation/derivation-proof.ts
-var functionIsExact = (plan) => plan.fallbackReason === void 0 && plan.captureBoundaries.length === 0 && plan.controlFacts.length === 0;
-
 // src/derivation/analyze-function.ts
 var loc = (node, sourceFile) => {
   const position = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
@@ -589,7 +586,7 @@ var analyzeExpression = (ctx, node) => {
     if (!ts.isIdentifier(node.expression)) return capture(ctx, node, "dynamic_callee");
     const calleeName = node.expression.text;
     if (lookup(ctx, calleeName)) return capture(ctx, node, "opaque_call");
-    const provenId = ctx.provenExact.get(calleeName);
+    const provenId = ctx.moduleCallees.get(calleeName);
     ctx.callEdges.push({
       callerFunctionId: ctx.functionId,
       calleeName,
@@ -779,7 +776,7 @@ var bindParams = (ctx, node) => {
     index++;
   }
 };
-var analyzeOne = (node, functionId, name, sourceFile, provenExact) => {
+var analyzeOne = (node, functionId, name, sourceFile, moduleCallees) => {
   const ctx = {
     sourceFile,
     functionId,
@@ -795,7 +792,7 @@ var analyzeOne = (node, functionId, name, sourceFile, provenExact) => {
     nextAssignmentId: { value: 0 },
     hasThrow: false,
     hasCoercionGuard: false,
-    provenExact,
+    moduleCallees,
     identifierParams: []
   };
   if (node.asteriskToken || node.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.AsyncKeyword)) {
@@ -852,14 +849,20 @@ var analyzeModuleFunctions = (sourceFile, targets) => {
     graph
   );
   const byId = new Map(targets.map((target) => [target.functionId, target]));
-  const provenExact = /* @__PURE__ */ new Map();
+  const moduleCallees = /* @__PURE__ */ new Map();
   const analyzed = [];
   for (const functionId of order) {
     const target = byId.get(functionId);
     if (!target) continue;
-    const result2 = analyzeOne(target.node, target.functionId, target.name, sourceFile, provenExact);
-    if (functionIsExact(result2.plan) && nameCounts.get(result2.name) === 1) {
-      provenExact.set(result2.name, result2.functionId);
+    const result2 = analyzeOne(
+      target.node,
+      target.functionId,
+      target.name,
+      sourceFile,
+      moduleCallees
+    );
+    if (nameCounts.get(result2.name) === 1) {
+      moduleCallees.set(result2.name, result2.functionId);
     }
     analyzed.push(result2);
   }
@@ -867,11 +870,16 @@ var analyzeModuleFunctions = (sourceFile, targets) => {
     (target) => !analyzed.some((fn) => fn.functionId === target.functionId)
   );
   for (const target of remaining) {
-    analyzed.push(analyzeOne(target.node, target.functionId, target.name, sourceFile, provenExact));
+    analyzed.push(
+      analyzeOne(target.node, target.functionId, target.name, sourceFile, moduleCallees)
+    );
   }
   return analyzed;
 };
 
+// src/derivation/derivation-proof.ts
+var functionIsExact = (plan) => plan.fallbackReason === void 0 && plan.captureBoundaries.length === 0 && plan.controlFacts.length === 0;
+
 // src/derivation/emit-capture-plan.ts
 var captureWrapEdits = (wraps, capName) => {
   const edits = [];

package/dist/instrument/bun.js

@@ -211,9 +211,6 @@ var emptyPlan = (functionId) => ({
   controlFacts: []
 });
 
-// src/derivation/derivation-proof.ts
-var functionIsExact = (plan) => plan.fallbackReason === void 0 && plan.captureBoundaries.length === 0 && plan.controlFacts.length === 0;
-
 // src/derivation/analyze-function.ts
 var loc = (node, sourceFile) => {
   const position = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
@@ -423,7 +420,7 @@ var analyzeExpression = (ctx, node) => {
     if (!ts.isIdentifier(node.expression)) return capture(ctx, node, "dynamic_callee");
     const calleeName = node.expression.text;
     if (lookup(ctx, calleeName)) return capture(ctx, node, "opaque_call");
-    const provenId = ctx.provenExact.get(calleeName);
+    const provenId = ctx.moduleCallees.get(calleeName);
     ctx.callEdges.push({
       callerFunctionId: ctx.functionId,
       calleeName,
@@ -613,7 +610,7 @@ var bindParams = (ctx, node) => {
     index++;
   }
 };
-var analyzeOne = (node, functionId, name, sourceFile, provenExact) => {
+var analyzeOne = (node, functionId, name, sourceFile, moduleCallees) => {
   const ctx = {
     sourceFile,
     functionId,
@@ -629,7 +626,7 @@ var analyzeOne = (node, functionId, name, sourceFile, provenExact) => {
     nextAssignmentId: { value: 0 },
     hasThrow: false,
     hasCoercionGuard: false,
-    provenExact,
+    moduleCallees,
     identifierParams: []
   };
   if (node.asteriskToken || node.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.AsyncKeyword)) {
@@ -686,14 +683,20 @@ var analyzeModuleFunctions = (sourceFile, targets) => {
     graph
   );
   const byId = new Map(targets.map((target) => [target.functionId, target]));
-  const provenExact = /* @__PURE__ */ new Map();
+  const moduleCallees = /* @__PURE__ */ new Map();
   const analyzed = [];
   for (const functionId of order) {
     const target = byId.get(functionId);
     if (!target) continue;
-    const result = analyzeOne(target.node, target.functionId, target.name, sourceFile, provenExact);
-    if (functionIsExact(result.plan) && nameCounts.get(result.name) === 1) {
-      provenExact.set(result.name, result.functionId);
+    const result = analyzeOne(
+      target.node,
+      target.functionId,
+      target.name,
+      sourceFile,
+      moduleCallees
+    );
+    if (nameCounts.get(result.name) === 1) {
+      moduleCallees.set(result.name, result.functionId);
     }
     analyzed.push(result);
   }
@@ -701,11 +704,16 @@ var analyzeModuleFunctions = (sourceFile, targets) => {
     (target) => !analyzed.some((fn) => fn.functionId === target.functionId)
   );
   for (const target of remaining) {
-    analyzed.push(analyzeOne(target.node, target.functionId, target.name, sourceFile, provenExact));
+    analyzed.push(
+      analyzeOne(target.node, target.functionId, target.name, sourceFile, moduleCallees)
+    );
   }
   return analyzed;
 };
 
+// src/derivation/derivation-proof.ts
+var functionIsExact = (plan) => plan.fallbackReason === void 0 && plan.captureBoundaries.length === 0 && plan.controlFacts.length === 0;
+
 // src/derivation/emit-capture-plan.ts
 var captureWrapEdits = (wraps, capName) => {
   const edits = [];

package/dist/instrument/node.js

@@ -266,9 +266,6 @@ var emptyPlan = (functionId) => ({
   controlFacts: []
 });
 
-// src/derivation/derivation-proof.ts
-var functionIsExact = (plan) => plan.fallbackReason === void 0 && plan.captureBoundaries.length === 0 && plan.controlFacts.length === 0;
-
 // src/derivation/analyze-function.ts
 var loc = (node, sourceFile) => {
   const position = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
@@ -478,7 +475,7 @@ var analyzeExpression = (ctx, node) => {
     if (!ts.isIdentifier(node.expression)) return capture(ctx, node, "dynamic_callee");
     const calleeName = node.expression.text;
     if (lookup(ctx, calleeName)) return capture(ctx, node, "opaque_call");
-    const provenId = ctx.provenExact.get(calleeName);
+    const provenId = ctx.moduleCallees.get(calleeName);
     ctx.callEdges.push({
       callerFunctionId: ctx.functionId,
       calleeName,
@@ -668,7 +665,7 @@ var bindParams = (ctx, node) => {
     index++;
   }
 };
-var analyzeOne = (node, functionId, name, sourceFile, provenExact) => {
+var analyzeOne = (node, functionId, name, sourceFile, moduleCallees) => {
   const ctx = {
     sourceFile,
     functionId,
@@ -684,7 +681,7 @@ var analyzeOne = (node, functionId, name, sourceFile, provenExact) => {
     nextAssignmentId: { value: 0 },
     hasThrow: false,
     hasCoercionGuard: false,
-    provenExact,
+    moduleCallees,
     identifierParams: []
   };
   if (node.asteriskToken || node.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.AsyncKeyword)) {
@@ -741,14 +738,20 @@ var analyzeModuleFunctions = (sourceFile, targets) => {
     graph
   );
   const byId = new Map(targets.map((target) => [target.functionId, target]));
-  const provenExact = /* @__PURE__ */ new Map();
+  const moduleCallees = /* @__PURE__ */ new Map();
   const analyzed = [];
   for (const functionId of order) {
     const target = byId.get(functionId);
     if (!target) continue;
-    const result = analyzeOne(target.node, target.functionId, target.name, sourceFile, provenExact);
-    if (functionIsExact(result.plan) && nameCounts.get(result.name) === 1) {
-      provenExact.set(result.name, result.functionId);
+    const result = analyzeOne(
+      target.node,
+      target.functionId,
+      target.name,
+      sourceFile,
+      moduleCallees
+    );
+    if (nameCounts.get(result.name) === 1) {
+      moduleCallees.set(result.name, result.functionId);
     }
     analyzed.push(result);
   }
@@ -756,11 +759,16 @@ var analyzeModuleFunctions = (sourceFile, targets) => {
     (target) => !analyzed.some((fn) => fn.functionId === target.functionId)
   );
   for (const target of remaining) {
-    analyzed.push(analyzeOne(target.node, target.functionId, target.name, sourceFile, provenExact));
+    analyzed.push(
+      analyzeOne(target.node, target.functionId, target.name, sourceFile, moduleCallees)
+    );
   }
   return analyzed;
 };
 
+// src/derivation/derivation-proof.ts
+var functionIsExact = (plan) => plan.fallbackReason === void 0 && plan.captureBoundaries.length === 0 && plan.controlFacts.length === 0;
+
 // src/derivation/emit-capture-plan.ts
 var captureWrapEdits = (wraps, capName) => {
   const edits = [];

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.5.0-alpha.8";
+export declare const SDK_VERSION = "0.5.0-alpha.9";
 //# sourceMappingURL=sdk-meta.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rasputin-ai/node",
-	"version": "0.5.0-alpha.8",
+	"version": "0.5.0-alpha.9",
 	"description": "Official Rasputin AI SDK for Node and Bun.",
 	"type": "module",
 	"exports": {
@@ -44,7 +44,7 @@
 	},
 	"dependencies": {
 		"@jridgewell/trace-mapping": "0.3.31",
-		"@rasputin-ai/core": "0.5.0-alpha.8",
+		"@rasputin-ai/core": "0.5.0-alpha.9",
 		"typescript": "5"
 	},
 	"devDependencies": {