@rasputin-ai/node 0.4.1 → 0.5.0-alpha.2

package/dist/instrument/bun.js

@@ -12,21 +12,25 @@ import {
   sourceLocatorFromFile as sourceLocatorFromFile2
 } from "@rasputin-ai/core";
 
-// src/execution-recorder/automatic-runtime.ts
+// src/execution-recorder/function-plan.ts
 import {
   runtimeFunctionId,
   sourceLocatorFromFile
 } from "@rasputin-ai/core";
-var AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v2";
-var AUTOMATIC_SOURCE_PREFIX = "rasputin-source-v2:";
-var runtimeSymbol = Symbol.for(AUTOMATIC_RUNTIME_SYMBOL);
-var encodeAutomaticFunctionSource = (source) => {
+var encodeFunctionPlan = (source) => {
   const locator = sourceLocatorFromFile(source.filePath);
-  const value = {
+  const definition = {
     name: source.name,
     ...locator ? { source: { ...locator, line: source.line, column: source.column } } : {}
   };
-  return `${AUTOMATIC_SOURCE_PREFIX}${JSON.stringify(value)}`;
+  return [
+    runtimeFunctionId(definition),
+    source.name,
+    locator?.packageName ?? null,
+    locator?.packageRelativePath ?? null,
+    source.line,
+    source.column
+  ];
 };
 
 // src/auto-instrumentation/instrumentation-manifest-registry.ts
@@ -86,6 +90,10 @@ var isApplicationSource = (filePath, options = {}) => {
 import { resolve as resolve3 } from "node:path";
 import ts2 from "typescript";
 
+// src/execution-recorder/automatic-runtime.ts
+var AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v2";
+var runtimeSymbol = Symbol.for(AUTOMATIC_RUNTIME_SYMBOL);
+
 // src/auto-instrumentation/collect-instrumentation-delta.ts
 import ts from "typescript";
 var paramBindingFromName = (name, sourceFile) => {
@@ -227,7 +235,7 @@ var collectCallSite = (call, caller, context) => {
   );
   if (!start || !end) return null;
   return {
-    callerSourceToken: caller.sourceToken,
+    callerFunctionId: caller.functionId,
     calleeName: callee.calleeName,
     calleeText: callee.calleeText,
     filePath: start.filePath,
@@ -254,7 +262,7 @@ var collectParamDestructure = (declaration, caller, context) => {
   );
   if (!start) return null;
   return {
-    callerSourceToken: caller.sourceToken,
+    callerFunctionId: caller.functionId,
     sourceParam,
     filePath: start.filePath,
     line: start.line,
@@ -320,7 +328,12 @@ var isSupportedFunction = (node) => {
   if (!node.body || "asteriskToken" in node && node.asteriskToken) return false;
   return true;
 };
-var helperDeclaration = (helperName) => `const ${helperName}=(functionId,args,callback)=>{const runtime=Reflect.get(globalThis,Symbol.for(${JSON.stringify(AUTOMATIC_RUNTIME_SYMBOL)}));return runtime?runtime.run(functionId,args,callback):callback()};`;
+var uniqueName = (source, base) => {
+  let name = base;
+  while (source.includes(name)) name += "_";
+  return name;
+};
+var modulePreamble = (runName, plansName, plansJson) => `const ${plansName}=${plansJson};const ${runName}=((g,k)=>{const r=g[k]??(g[k]={runtimes:[],modules:[],register(p){const d={run:(i,a,c)=>c()};const m={plans:p,cell:d};this.modules.push(m);const n=this.runtimes.at(-1);if(n)n.bind(m);return(i,a,c)=>d.run(i,a,c)}});return r.register(${plansName})})(globalThis,Symbol.for(${JSON.stringify(AUTOMATIC_RUNTIME_SYMBOL)}));`;
 var collectWrappedFunction = (node, sourceFile, absolutePath, mapLocation) => {
   const start = mappedLocation(
     sourceFile,
@@ -332,13 +345,15 @@ var collectWrappedFunction = (node, sourceFile, absolutePath, mapLocation) => {
   const end = mappedLocation(sourceFile, node.end, absolutePath, mapLocation) ?? start;
   const name = functionName(node, sourceFile).replace(/@\d+:\d+$/, "");
   const { params, paramNames } = collectFunctionParams(node, sourceFile);
+  const plan = encodeFunctionPlan({
+    filePath: start.filePath,
+    name,
+    line: start.line,
+    column: start.column
+  });
   return {
-    sourceToken: encodeAutomaticFunctionSource({
-      filePath: start.filePath,
-      name,
-      line: start.line,
-      column: start.column
-    }),
+    plan,
+    functionId: plan[0],
     filePath: start.filePath,
     name,
     startLine: start.line,
@@ -358,8 +373,8 @@ var transformSource = (source, options) => {
     true,
     scriptKindFor(options.filePath)
   );
-  let helperName = "__rasputinAutoRun__";
-  while (source.includes(helperName)) helperName += "_";
+  const runName = uniqueName(source, "__rasputinRun__");
+  const plansName = uniqueName(source, "__rasputinPlans__");
   const absolutePath = resolve3(options.filePath);
   const edits = [];
   let order = 0;
@@ -380,6 +395,7 @@ var transformSource = (source, options) => {
         ts2.forEachChild(node, (child) => visit(child, caller));
         return;
       }
+      const planIndex = delta.functions.length;
       delta.functions.push(collected);
       const args = ts2.isArrowFunction(node) ? arrowArguments(node) : "arguments";
       const asyncCallback = node.modifiers?.some(
@@ -388,14 +404,14 @@ var transformSource = (source, options) => {
       if (ts2.isBlock(node.body)) {
         edits.push({
           position: node.body.getStart(sourceFile) + 1,
-          text: `return ${helperName}(${JSON.stringify(collected.sourceToken)},${args},${asyncCallback}()=>{`,
+          text: `return ${runName}(${planIndex},${args},${asyncCallback}()=>{`,
           order: order++
         });
         edits.push({ position: node.body.end - 1, text: "});", order: order++ });
       } else {
         edits.push({
           position: node.body.getStart(sourceFile),
-          text: `${helperName}(${JSON.stringify(collected.sourceToken)},${args},${asyncCallback}()=>(`,
+          text: `${runName}(${planIndex},${args},${asyncCallback}()=>(`,
           order: order++
         });
         edits.push({ position: node.body.end, text: "))", order: order++ });
@@ -416,7 +432,11 @@ var transformSource = (source, options) => {
   visit(sourceFile);
   if (edits.length === 0) return void 0;
   const shebangEnd = source.startsWith("#!") ? source.indexOf("\n") + 1 : 0;
-  edits.push({ position: shebangEnd, text: helperDeclaration(helperName), order: -1 });
+  edits.push({
+    position: shebangEnd,
+    text: modulePreamble(runName, plansName, JSON.stringify(delta.functions.map((fn) => fn.plan))),
+    order: -1
+  });
   edits.sort((left, right) => right.position - left.position || right.order - left.order);
   let transformed = source;
   for (const edit of edits) {
@@ -481,7 +501,21 @@ import { dirname, resolve as resolve5 } from "node:path";
 import { fileURLToPath } from "node:url";
 var sdkPackageScopeRootFrom = (instrumentEntryUrl) => resolve5(dirname(fileURLToPath(instrumentEntryUrl)), "../../..");
 
+// src/auto-instrumentation/warn-production-runtime-transform.ts
+var RUNTIME_TRANSFORM_WARNING_SUPPRESS_ENV = "RASPUTIN_SUPPRESS_RUNTIME_TRANSFORM_WARNING";
+var warnedSymbol = Symbol.for("rasputin.runtimeTransformWarning");
+var warnIfProductionRuntimeTransform = () => {
+  if (process.env.NODE_ENV !== "production") return;
+  if (process.env[RUNTIME_TRANSFORM_WARNING_SUPPRESS_ENV] === "1") return;
+  if (Reflect.get(globalThis, warnedSymbol)) return;
+  Reflect.set(globalThis, warnedSymbol, true);
+  console.warn(
+    "[rasputin] Production is using load-time source transformation (`--import` / `--preload`). Prefer build-time `rasputin-instrument` so the process does not load the TypeScript compiler. Set RASPUTIN_SUPPRESS_RUNTIME_TRANSFORM_WARNING=1 to hide this warning."
+  );
+};
+
 // src/instrument/bun.ts
+warnIfProductionRuntimeTransform();
 plugin(
   createRasputinBunPlugin({
     excludedRoots: [sdkPackageScopeRootFrom(import.meta.url)]

package/dist/instrument/node.js

@@ -9,21 +9,25 @@ import {
   sourceLocatorFromFile as sourceLocatorFromFile2
 } from "@rasputin-ai/core";
 
-// src/execution-recorder/automatic-runtime.ts
+// src/execution-recorder/function-plan.ts
 import {
   runtimeFunctionId,
   sourceLocatorFromFile
 } from "@rasputin-ai/core";
-var AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v2";
-var AUTOMATIC_SOURCE_PREFIX = "rasputin-source-v2:";
-var runtimeSymbol = Symbol.for(AUTOMATIC_RUNTIME_SYMBOL);
-var encodeAutomaticFunctionSource = (source) => {
+var encodeFunctionPlan = (source) => {
   const locator = sourceLocatorFromFile(source.filePath);
-  const value = {
+  const definition = {
     name: source.name,
     ...locator ? { source: { ...locator, line: source.line, column: source.column } } : {}
   };
-  return `${AUTOMATIC_SOURCE_PREFIX}${JSON.stringify(value)}`;
+  return [
+    runtimeFunctionId(definition),
+    source.name,
+    locator?.packageName ?? null,
+    locator?.packageRelativePath ?? null,
+    source.line,
+    source.column
+  ];
 };
 
 // src/auto-instrumentation/instrumentation-manifest-registry.ts
@@ -141,6 +145,10 @@ var createSourceMapLocationMapper = (generatedPath, source) => {
 import { resolve as resolve4 } from "node:path";
 import ts2 from "typescript";
 
+// src/execution-recorder/automatic-runtime.ts
+var AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v2";
+var runtimeSymbol = Symbol.for(AUTOMATIC_RUNTIME_SYMBOL);
+
 // src/auto-instrumentation/collect-instrumentation-delta.ts
 import ts from "typescript";
 var paramBindingFromName = (name, sourceFile) => {
@@ -282,7 +290,7 @@ var collectCallSite = (call, caller, context) => {
   );
   if (!start || !end) return null;
   return {
-    callerSourceToken: caller.sourceToken,
+    callerFunctionId: caller.functionId,
     calleeName: callee.calleeName,
     calleeText: callee.calleeText,
     filePath: start.filePath,
@@ -309,7 +317,7 @@ var collectParamDestructure = (declaration, caller, context) => {
   );
   if (!start) return null;
   return {
-    callerSourceToken: caller.sourceToken,
+    callerFunctionId: caller.functionId,
     sourceParam,
     filePath: start.filePath,
     line: start.line,
@@ -375,7 +383,12 @@ var isSupportedFunction = (node) => {
   if (!node.body || "asteriskToken" in node && node.asteriskToken) return false;
   return true;
 };
-var helperDeclaration = (helperName) => `const ${helperName}=(functionId,args,callback)=>{const runtime=Reflect.get(globalThis,Symbol.for(${JSON.stringify(AUTOMATIC_RUNTIME_SYMBOL)}));return runtime?runtime.run(functionId,args,callback):callback()};`;
+var uniqueName = (source, base) => {
+  let name = base;
+  while (source.includes(name)) name += "_";
+  return name;
+};
+var modulePreamble = (runName, plansName, plansJson) => `const ${plansName}=${plansJson};const ${runName}=((g,k)=>{const r=g[k]??(g[k]={runtimes:[],modules:[],register(p){const d={run:(i,a,c)=>c()};const m={plans:p,cell:d};this.modules.push(m);const n=this.runtimes.at(-1);if(n)n.bind(m);return(i,a,c)=>d.run(i,a,c)}});return r.register(${plansName})})(globalThis,Symbol.for(${JSON.stringify(AUTOMATIC_RUNTIME_SYMBOL)}));`;
 var collectWrappedFunction = (node, sourceFile, absolutePath, mapLocation) => {
   const start = mappedLocation(
     sourceFile,
@@ -387,13 +400,15 @@ var collectWrappedFunction = (node, sourceFile, absolutePath, mapLocation) => {
   const end = mappedLocation(sourceFile, node.end, absolutePath, mapLocation) ?? start;
   const name = functionName(node, sourceFile).replace(/@\d+:\d+$/, "");
   const { params, paramNames } = collectFunctionParams(node, sourceFile);
+  const plan = encodeFunctionPlan({
+    filePath: start.filePath,
+    name,
+    line: start.line,
+    column: start.column
+  });
   return {
-    sourceToken: encodeAutomaticFunctionSource({
-      filePath: start.filePath,
-      name,
-      line: start.line,
-      column: start.column
-    }),
+    plan,
+    functionId: plan[0],
     filePath: start.filePath,
     name,
     startLine: start.line,
@@ -413,8 +428,8 @@ var transformSource = (source, options) => {
     true,
     scriptKindFor(options.filePath)
   );
-  let helperName = "__rasputinAutoRun__";
-  while (source.includes(helperName)) helperName += "_";
+  const runName = uniqueName(source, "__rasputinRun__");
+  const plansName = uniqueName(source, "__rasputinPlans__");
   const absolutePath = resolve4(options.filePath);
   const edits = [];
   let order = 0;
@@ -435,6 +450,7 @@ var transformSource = (source, options) => {
         ts2.forEachChild(node, (child) => visit(child, caller));
         return;
       }
+      const planIndex = delta.functions.length;
       delta.functions.push(collected);
       const args = ts2.isArrowFunction(node) ? arrowArguments(node) : "arguments";
       const asyncCallback = node.modifiers?.some(
@@ -443,14 +459,14 @@ var transformSource = (source, options) => {
       if (ts2.isBlock(node.body)) {
         edits.push({
           position: node.body.getStart(sourceFile) + 1,
-          text: `return ${helperName}(${JSON.stringify(collected.sourceToken)},${args},${asyncCallback}()=>{`,
+          text: `return ${runName}(${planIndex},${args},${asyncCallback}()=>{`,
           order: order++
         });
         edits.push({ position: node.body.end - 1, text: "});", order: order++ });
       } else {
         edits.push({
           position: node.body.getStart(sourceFile),
-          text: `${helperName}(${JSON.stringify(collected.sourceToken)},${args},${asyncCallback}()=>(`,
+          text: `${runName}(${planIndex},${args},${asyncCallback}()=>(`,
           order: order++
         });
         edits.push({ position: node.body.end, text: "))", order: order++ });
@@ -471,7 +487,11 @@ var transformSource = (source, options) => {
   visit(sourceFile);
   if (edits.length === 0) return void 0;
   const shebangEnd = source.startsWith("#!") ? source.indexOf("\n") + 1 : 0;
-  edits.push({ position: shebangEnd, text: helperDeclaration(helperName), order: -1 });
+  edits.push({
+    position: shebangEnd,
+    text: modulePreamble(runName, plansName, JSON.stringify(delta.functions.map((fn) => fn.plan))),
+    order: -1
+  });
   edits.sort((left, right) => right.position - left.position || right.order - left.order);
   let transformed = source;
   for (const edit of edits) {
@@ -538,7 +558,21 @@ import { dirname as dirname2, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 var sdkPackageScopeRootFrom = (instrumentEntryUrl) => resolve5(dirname2(fileURLToPath3(instrumentEntryUrl)), "../../..");
 
+// src/auto-instrumentation/warn-production-runtime-transform.ts
+var RUNTIME_TRANSFORM_WARNING_SUPPRESS_ENV = "RASPUTIN_SUPPRESS_RUNTIME_TRANSFORM_WARNING";
+var warnedSymbol = Symbol.for("rasputin.runtimeTransformWarning");
+var warnIfProductionRuntimeTransform = () => {
+  if (process.env.NODE_ENV !== "production") return;
+  if (process.env[RUNTIME_TRANSFORM_WARNING_SUPPRESS_ENV] === "1") return;
+  if (Reflect.get(globalThis, warnedSymbol)) return;
+  Reflect.set(globalThis, warnedSymbol, true);
+  console.warn(
+    "[rasputin] Production is using load-time source transformation (`--import` / `--preload`). Prefer build-time `rasputin-instrument` so the process does not load the TypeScript compiler. Set RASPUTIN_SUPPRESS_RUNTIME_TRANSFORM_WARNING=1 to hide this warning."
+  );
+};
+
 // src/instrument/node.ts
+warnIfProductionRuntimeTransform();
 registerRasputinNodeHooks({
   excludedRoots: [sdkPackageScopeRootFrom(import.meta.url)]
 });

package/dist/rasputin-init.d.ts

@@ -1,13 +1,13 @@
-/**
- * Node/Bun composition root for error transport, process handlers, and the bounded execution
- * recorder. Centralizing this wiring keeps initialization fail-safe and ensures every capture path
- * attaches runtime state using the same limits and lifecycle rules.
- */
 import { type RasputinClient, type RasputinClientStats, type RasputinOptions, type SourceVerification } from '@rasputin-ai/core';
 import { type ExecutionRecorderOptions, type ExecutionRecorderStats, type RasputinExecution } from './execution-recorder';
 export type RasputinNodeOptions = RasputinOptions & {
     /** Bounded runtime-state capture. Enabled by default; successful executions are discarded. */
     executionRecorder?: ExecutionRecorderOptions;
+    /**
+     * Path to a build-time instrumentation manifest. Defaults to RASPUTIN_INSTRUMENTATION_MANIFEST
+     * or `.rasputin/instrumentation-manifest.json` in the current working directory.
+     */
+    instrumentationManifestPath?: string;
 };
 export type RasputinNodeClientStats = RasputinClientStats & {
     /** Process-local recorder safety, truncation, and memory-pressure counters. */

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

@@ -1 +1 @@
-{"version":3,"file":"rasputin-init.d.ts","sourceRoot":"","sources":["../src/rasputin-init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAIN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEN,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG;IACnD,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG;IAC3D,+EAA+E;IAC/E,QAAQ,EAAE,sBAAsB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IACnE,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,uBAAuB,CAAC;IACxC,8FAA8F;IAC9F,mBAAmB,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvD,CAAC;AAgDF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,mBAAmB,KAAG,kBA2C3D,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,EAC3B,KAAK,iBAAiB,EACtB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG;IACnD,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C;;;OAGG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG;IAC3D,+EAA+E;IAC/E,QAAQ,EAAE,sBAAsB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IACnE,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,uBAAuB,CAAC;IACxC,8FAA8F;IAC9F,mBAAmB,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvD,CAAC;AAgDF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,mBAAmB,KAAG,kBAiD3D,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.4.1";
+export declare const SDK_VERSION = "0.5.0-alpha.2";
 //# sourceMappingURL=sdk-meta.d.ts.map

package/dist/sdk-meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-meta.d.ts","sourceRoot":"","sources":["../src/sdk-meta.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,sBAAsB,CAAC;AAC5C,eAAO,MAAM,WAAW,UAAU,CAAC"}
+{"version":3,"file":"sdk-meta.d.ts","sourceRoot":"","sources":["../src/sdk-meta.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,sBAAsB,CAAC;AAC5C,eAAO,MAAM,WAAW,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rasputin-ai/node",
-	"version": "0.4.1",
+	"version": "0.5.0-alpha.2",
 	"description": "Official Rasputin AI SDK for Node and Bun.",
 	"type": "module",
 	"exports": {
@@ -18,8 +18,16 @@
 			"types": "./dist/instrument/node.d.ts",
 			"import": "./dist/instrument/node.js",
 			"default": "./dist/instrument/node.js"
+		},
+		"./instrument/build": {
+			"types": "./dist/instrument/build.d.ts",
+			"import": "./dist/instrument/build.js",
+			"default": "./dist/instrument/build.js"
 		}
 	},
+	"bin": {
+		"rasputin-instrument": "./dist/instrument/build.js"
+	},
 	"files": [
 		"dist"
 	],
@@ -36,7 +44,7 @@
 	},
 	"dependencies": {
 		"@jridgewell/trace-mapping": "0.3.31",
-		"@rasputin-ai/core": "0.4.1",
+		"@rasputin-ai/core": "0.5.0-alpha.2",
 		"typescript": "5"
 	},
 	"devDependencies": {