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

package/README.md

@@ -1,162 +1,188 @@
-# Official Rasputin AI SDK for Node and Bun
-
-Report application errors to Rasputin.
-
-## Setup
-
-Initialize once when your application starts:
-
-```ts
-import { RasputinInit } from '@rasputin-ai/node';
-
-export const rasputin = RasputinInit({
-  projectApiKey: process.env.RASPUTIN_PROJECT_API_KEY!,
-  release: process.env.RASPUTIN_RELEASE!,
-  environment: process.env.NODE_ENV ?? 'development',
-  enabled: ['staging', 'production'].includes(process.env.NODE_ENV ?? 'development'),
-});
-```
-
-Uncaught exceptions and unhandled rejections are reported automatically.
-
-## Capture handled errors
-
-```ts
-try {
-  await processPayment();
-} catch (error) {
-  rasputin.captureException(error);
-}
-```
-
-## Configuration
-
-| Field | Required | Description |
-| --- | --- | --- |
-| `projectApiKey` | yes | Project API key from the Rasputin dashboard |
-| `environment` | yes | Environment such as `production`, `staging`, or `preview` |
-| `release` | yes | Git commit SHA for the deployed version |
-| `enabled` | no | Enables or disables the SDK; defaults to `true` |
-| `logSuccess` | no | Prints a configuration summary when setup succeeds; defaults to `true`. Failures always log. |
-| `moduleUrl` | no | `import.meta.url` from the initialization file; helps normalize local stack paths |
-| `sourceRoot` | no | Git repository folder for a single-package service, such as `apps/api` |
-| `sourceRoots` | no | Package-name to Git-folder mappings for ambiguous monorepos |
-| `repoRoot` | no | Local filesystem display root; it does not control instrumentation or Git identity |
-
-Rasputin normally identifies source from the nearest `package.json` and verifies it against the exact release on the server. Filesystem paths such as `/container` are never used as source identity.
-
-For deployment checks, call:
-
-```ts
-const verification = await rasputin.verifyConfiguration();
-```
-
-`verified` means every instrumented source file maps uniquely to the configured Git release. If a monorepo is ambiguous, set `sourceRoot` or `sourceRoots` using repository-relative folders, never Docker paths.
-
-Rasputin also prints a configuration summary after the instrumentation manifest is uploaded. Set `logSuccess: false` if you do not want that banner in production logs. Mapping failures still warn.
-
-## Shutdown
-
-Events are sent in the background. Flush before a short-lived process exits:
-
-```ts
-await rasputin.flush();
-```
-
-Call `await rasputin.close()` during graceful shutdown when the process stays alive afterward.
-
----
-
-# Runtime recorder
-
-Optionally attach the runtime state that led to an error — arguments, return values, and call history from the failing execution.
-
-## Automatic instrumentation
-
-Start your process with the adapter for your runtime so Rasputin can instrument application functions as they load:
-
-```json
-{
-  "scripts": {
-    "start:node": "node --import @rasputin-ai/node/instrument/node dist/app.js",
-    "start:bun": "bun --preload @rasputin-ai/node/instrument/bun src/app.ts"
-  }
-}
-```
-
-Runtime state is retained only inside an active execution and attached when that execution throws.
-
-## Manual capture
-
-Wrap each meaningful unit of work — an HTTP request, background job, scheduled task, or worker iteration — in an execution:
-
-```ts
-await rasputin.execution.run({ kind: 'job', name: 'sync-invoices' }, async () => {
-  await syncInvoices();
-});
-```
-
-When automatic instrumentation is unavailable, mark individual functions explicitly:
-
-```ts
-const syncInvoices = rasputin.execution.trace(
-  'src/jobs/sync-invoices.ts:syncInvoices',
-  async () => {
-    // ...
-  },
-);
-```
-
-Framework packages such as `@rasputin-ai/elysia` create HTTP executions automatically.
-
-## Runtime support
-
-| Environment | Support |
-| --- | --- |
-| Bun 1.3.x | Supported for directly loaded JavaScript and TypeScript using `instrument/bun` |
-| Node.js 22.15 or newer | Supported for unbundled ESM/CJS JavaScript using `instrument/node`; Node 22 and 24 are the supported LTS lines |
-| TypeScript compiled to multiple JavaScript files | Supported on Node; emit adjacent source maps to retain original TypeScript locations |
-| Single-file bundles (esbuild, tsup, webpack, Vite SSR, Next.js) | Automatic instrumentation not supported |
-| `tsx`, custom Node loader stacks, and Node's native TypeScript execution | Automatic instrumentation not supported |
-| Deno and edge runtimes | Not supported |
-
-Tested on Bun 1.3.13, Node.js 24.19.0. Node.js 22.15.0 is the minimum for automatic instrumentation (synchronous module hooks). Use `execution.run()` and `execution.trace()` when automatic instrumentation is not available.
-
-## Recorder configuration
-
-Defaults work for most apps. Customize to exclude noisy sources, redact fields, or retain less state:
-
-| Field | Default | Description |
-| --- | ---: | --- |
-| `enabled` | `true` | Enables runtime-state capture |
-| `maxEventsPerExecution` | `500` | Maximum events retained for one execution |
-| `maxCapturedCallsPerFunction` | `3` | Detailed successful calls retained before similar calls are summarized |
-| `maxActiveMemoryBytes` | `64 MiB` | Maximum recorder memory shared across active executions |
-| `maxDepth` | `3` | Maximum captured value depth |
-| `maxObjectKeys` | `30` | Maximum properties retained from one object |
-| `maxArrayElements` | `20` | Maximum items retained from one array, map, or set |
-| `maxStringLength` | `500` | Maximum characters retained from one string |
-| `maxSerializedValueBytes` | `8 KiB` | Maximum retained size of one captured value |
-| `redactKeys` | `[]` | Additional case-insensitive property names to redact |
-| `excludeSources` | `[]` | Source globs or function-name patterns to exclude |
-
-```ts
-const rasputin = RasputinInit({
-  // ...required options
-  executionRecorder: {
-    excludeSources: ['src/logger/**', 'packages/shared-logger/**'],
-    redactKeys: ['customerEmail'],
-    maxEventsPerExecution: 200,
-  },
-});
-```
-
-Runtime state can include application data. Use `redactKeys` for sensitive fields.
-
-## Diagnostics
-
-```ts
-const { recorder, transport } = rasputin.getStats();
-```
-
-Counters are local to the current process and reset on restart.
+# Official Rasputin AI SDK for Node and Bun
+
+Report application errors to Rasputin.
+
+## Setup
+
+Initialize once when your application starts:
+
+```ts
+import { RasputinInit } from '@rasputin-ai/node';
+
+export const rasputin = RasputinInit({
+  projectApiKey: process.env.RASPUTIN_PROJECT_API_KEY!,
+  release: process.env.RASPUTIN_RELEASE!,
+  environment: process.env.NODE_ENV ?? 'development',
+  enabled: ['staging', 'production'].includes(process.env.NODE_ENV ?? 'development'),
+});
+```
+
+Uncaught exceptions and unhandled rejections are reported automatically.
+
+## Capture handled errors
+
+```ts
+try {
+  await processPayment();
+} catch (error) {
+  rasputin.captureException(error);
+}
+```
+
+## Configuration
+
+| Field | Required | Description |
+| --- | --- | --- |
+| `projectApiKey` | yes | Project API key from the Rasputin dashboard |
+| `environment` | yes | Environment such as `production`, `staging`, or `preview` |
+| `release` | yes | Git commit SHA for the deployed version |
+| `enabled` | no | Enables or disables the SDK; defaults to `true` |
+| `logSuccess` | no | Prints a configuration summary when setup succeeds; defaults to `true`. Failures always log. |
+| `moduleUrl` | no | `import.meta.url` from the initialization file; helps normalize local stack paths |
+| `sourceRoot` | no | Git repository folder for a single-package service, such as `apps/api` |
+| `sourceRoots` | no | Package-name to Git-folder mappings for ambiguous monorepos |
+| `repoRoot` | no | Local filesystem display root; it does not control instrumentation or Git identity |
+
+Rasputin normally identifies source from the nearest `package.json` and verifies it against the exact release on the server. Filesystem paths such as `/container` are never used as source identity.
+
+For deployment checks, call:
+
+```ts
+const verification = await rasputin.verifyConfiguration();
+```
+
+`verified` means every instrumented source file maps uniquely to the configured Git release. If a monorepo is ambiguous, set `sourceRoot` or `sourceRoots` using repository-relative folders, never Docker paths.
+
+Rasputin also prints a configuration summary after the instrumentation manifest is uploaded. Set `logSuccess: false` if you do not want that banner in production logs. Mapping failures still warn.
+
+## Shutdown
+
+Events are sent in the background. Flush before a short-lived process exits:
+
+```ts
+await rasputin.flush();
+```
+
+Call `await rasputin.close()` during graceful shutdown when the process stays alive afterward.
+
+---
+
+# Runtime recorder
+
+Optionally attach the runtime state that led to an error — arguments, return values, and call history from the failing execution.
+
+## Automatic instrumentation
+
+Build-time instrumentation is the production default. Transform compiled unbundled JavaScript after `tsc` so the running process never loads the TypeScript compiler:
+
+```json
+{
+  "scripts": {
+    "build": "tsc && rasputin-instrument dist",
+    "start:node": "node dist/app.js",
+    "start:bun": "bun dist/app.js"
+  }
+}
+```
+
+Emit adjacent source maps from TypeScript so function identities stay pointed at the original files. The instrumenter writes `.rasputin/instrumentation-manifest.json` next to the output. RasputinInit loads that file automatically, or from `RASPUTIN_INSTRUMENTATION_MANIFEST`.
+
+Node `--import` and Bun `--preload` remain compatibility and development fallbacks. They transform application source as it loads, which pulls compiler infrastructure into the process and has materially higher RSS. Do not use those loader measurements in low-overhead comparisons. In `NODE_ENV=production` the loaders print a one-time warning recommending `rasputin-instrument`. Set `RASPUTIN_SUPPRESS_RUNTIME_TRANSFORM_WARNING=1` to hide it.
+
+```json
+{
+  "scripts": {
+    "start:node": "node --import @rasputin-ai/node/instrument/node dist/app.js",
+    "start:bun": "bun --preload @rasputin-ai/node/instrument/bun src/app.ts"
+  }
+}
+```
+
+Runtime state is retained only inside an active execution and attached when that execution throws.
+
+## Manual capture
+
+Wrap each meaningful unit of work — an HTTP request, background job, scheduled task, or worker iteration — in an execution:
+
+```ts
+await rasputin.execution.run({ kind: 'job', name: 'sync-invoices' }, async () => {
+  await syncInvoices();
+});
+```
+
+When automatic instrumentation is unavailable, mark individual functions explicitly:
+
+```ts
+const syncInvoices = rasputin.execution.trace(
+  'src/jobs/sync-invoices.ts:syncInvoices',
+  async () => {
+    // ...
+  },
+);
+```
+
+Framework packages such as `@rasputin-ai/elysia` create HTTP executions automatically.
+
+## Runtime support
+
+| Environment | Support |
+| --- | --- |
+| TypeScript compiled to multiple JavaScript files | Preferred: `rasputin-instrument dist` after `tsc`, with adjacent source maps |
+| Bun 1.3.x loading application source directly | Supported using `instrument/bun` as a compatibility fallback |
+| Node.js 22.15 or newer loading unbundled ESM/CJS | Supported using `instrument/node` as a compatibility fallback; Node 22 and 24 are the supported LTS lines |
+| Single-file bundles (esbuild, tsup, webpack, Vite SSR, Next.js) | Automatic instrumentation not supported |
+| `tsx`, custom Node loader stacks, and Node's native TypeScript execution | Automatic instrumentation not supported |
+| Deno and edge runtimes | Not supported |
+
+Tested on Bun 1.3.13, Node.js 24.19.0. Node.js 22.15.0 is the minimum for automatic instrumentation (synchronous module hooks). Use `execution.run()` and `execution.trace()` when automatic instrumentation is not available.
+
+## Recorder configuration
+
+Defaults work for most apps. Customize to exclude noisy sources, redact fields, or retain less state:
+
+| Field | Default | Description |
+| --- | ---: | --- |
+| `enabled` | `true` | Enables runtime-state capture |
+| `maxEventsPerExecution` | `500` | Maximum events retained for one execution |
+| `maxCapturedCallsPerFunction` | `3` | Detailed successful calls retained before similar calls are summarized |
+| `maxActiveMemoryBytes` | `64 MiB` | Maximum recorder memory shared across active executions |
+| `maxDepth` | `3` | Maximum captured value depth |
+| `maxObjectKeys` | `30` | Maximum properties retained from one object |
+| `maxArrayElements` | `20` | Maximum items retained from one array, map, or set |
+| `maxStringLength` | `500` | Maximum characters retained from one string |
+| `maxSerializedValueBytes` | `8 KiB` | Maximum retained size of one captured value |
+| `redactKeys` | `[]` | Additional case-insensitive property names to redact |
+| `excludeSources` | `[]` | Source globs or function-name patterns to exclude |
+
+```ts
+const rasputin = RasputinInit({
+  // ...required options
+  executionRecorder: {
+    excludeSources: ['src/logger/**', 'packages/shared-logger/**'],
+    redactKeys: ['customerEmail'],
+    maxEventsPerExecution: 200,
+  },
+});
+```
+
+Runtime state can include application data. Use `redactKeys` for sensitive fields.
+
+## Diagnostics
+
+```ts
+const { recorder, transport } = rasputin.getStats();
+```
+
+Counters are local to the current process and reset on restart.
+
+Recorder work counters support performance diagnosis without retaining successful execution state:
+
+- `functionCallsObserved` counts hooks reached inside active execution scopes.
+- `functionCallsCaptured` counts complete enter/terminal pairs recorded before any later eviction.
+- `functionCallsExcluded` counts hooks omitted by source or excluded-subtree rules.
+- `repeatedCallsSuppressed` counts successful repetitions represented by suppression summaries.
+- `serializedValues`, `serializedValueNodes`, and `serializedValueBytes` describe bounded value
+  capture work. Redacted subtrees are not traversed or included in the node count.
+
+All counters are cumulative. Compare before/after snapshots for a measurement window rather than
+dividing the process-lifetime totals by a single request count.

package/dist/auto-instrumentation/collect-instrumentation-delta.d.ts

@@ -4,55 +4,20 @@
  * bindings. transform-source calls these collectors and passes the delta to the manifest
  * registry so the server can map runtime locations back to Git.
  */
-import type { InstrumentationArgIdentifier, InstrumentationParamBinding } from '@rasputin-ai/core';
+import type { InstrumentationParamBinding } from '@rasputin-ai/core';
 import ts from 'typescript';
+import type { RawManifestCallSite, RawManifestDestructure, RawManifestFunction } from './instrumentation-manifest-delta';
 type SourceLocation = {
     filePath: string;
     line: number;
     column: number;
 };
 type SourceLocationMapper = (location: SourceLocation) => SourceLocation | undefined;
-type RawManifestCallSite = {
-    callerSourceToken: string;
-    calleeName: string;
-    calleeText: string;
-    filePath: string;
-    line: number;
-    column: number;
-    endLine: number;
-    endColumn: number;
-    resultBinding: string | null;
-    argIdentifiers: InstrumentationArgIdentifier[];
-};
-type RawManifestDestructure = {
-    callerSourceToken: string;
-    sourceParam: string;
-    filePath: string;
-    line: number;
-    column: number;
-    binding: InstrumentationParamBinding;
-};
 type CollectContext = {
     sourceFile: ts.SourceFile;
     mapLocation?: SourceLocationMapper;
     absolutePath: string;
 };
-export type RawManifestFunction = {
-    sourceToken: string;
-    filePath: string;
-    name: string;
-    startLine: number;
-    startColumn: number;
-    endLine: number;
-    endColumn: number;
-    params: InstrumentationParamBinding[];
-    paramNames: Set<string>;
-};
-export type InstrumentationManifestDelta = {
-    functions: RawManifestFunction[];
-    callSites: RawManifestCallSite[];
-    destructures: RawManifestDestructure[];
-};
 export declare const collectFunctionParams: (node: ts.FunctionLikeDeclaration, sourceFile: ts.SourceFile) => {
     params: InstrumentationParamBinding[];
     paramNames: Set<string>;

package/dist/auto-instrumentation/collect-instrumentation-delta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collect-instrumentation-delta.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/collect-instrumentation-delta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,KAAK,cAAc,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,oBAAoB,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,cAAc,GAAG,SAAS,CAAC;AAErF,KAAK,mBAAmB,GAAG;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,4BAA4B,EAAE,CAAC;CAC/C,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,2BAA2B,CAAC;CACrC,CAAC;AAEF,KAAK,cAAc,GAAG;IACrB,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;IAC1B,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,2BAA2B,EAAE,CAAC;IACtC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,YAAY,EAAE,sBAAsB,EAAE,CAAC;CACvC,CAAC;AAqCF,eAAO,MAAM,qBAAqB,GACjC,MAAM,EAAE,CAAC,uBAAuB,EAChC,YAAY,EAAE,CAAC,UAAU,KACvB;IAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;IAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAQlE,CAAC;AA2BF,eAAO,MAAM,cAAc,GAC1B,YAAY,EAAE,CAAC,UAAU,EACzB,UAAU,MAAM,EAChB,cAAc,MAAM,EACpB,cAAc,oBAAoB,+BASlC,CAAC;AAuEF,eAAO,MAAM,eAAe,GAC3B,MAAM,EAAE,CAAC,cAAc,GAAG,EAAE,CAAC,aAAa,EAC1C,QAAQ,mBAAmB,EAC3B,SAAS,cAAc,KACrB,mBAAmB,GAAG,IA4BxB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GACnC,aAAa,EAAE,CAAC,mBAAmB,EACnC,QAAQ,mBAAmB,EAC3B,SAAS,cAAc,KACrB,sBAAsB,GAAG,IAsB3B,CAAC"}
+{"version":3,"file":"collect-instrumentation-delta.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/collect-instrumentation-delta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAgC,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EACX,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,MAAM,kCAAkC,CAAC;AAE1C,KAAK,cAAc,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,oBAAoB,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,cAAc,GAAG,SAAS,CAAC;AAErF,KAAK,cAAc,GAAG;IACrB,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;IAC1B,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAqCF,eAAO,MAAM,qBAAqB,GACjC,MAAM,EAAE,CAAC,uBAAuB,EAChC,YAAY,EAAE,CAAC,UAAU,KACvB;IAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;IAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAQlE,CAAC;AA2BF,eAAO,MAAM,cAAc,GAC1B,YAAY,EAAE,CAAC,UAAU,EACzB,UAAU,MAAM,EAChB,cAAc,MAAM,EACpB,cAAc,oBAAoB,+BASlC,CAAC;AAuEF,eAAO,MAAM,eAAe,GAC3B,MAAM,EAAE,CAAC,cAAc,GAAG,EAAE,CAAC,aAAa,EAC1C,QAAQ,mBAAmB,EAC3B,SAAS,cAAc,KACrB,mBAAmB,GAAG,IA4BxB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GACnC,aAAa,EAAE,CAAC,mBAAmB,EACnC,QAAQ,mBAAmB,EAC3B,SAAS,cAAc,KACrB,sBAAsB,GAAG,IAsB3B,CAAC"}

package/dist/auto-instrumentation/instrument-compiled-esm.d.ts

@@ -0,0 +1,19 @@
+import type { InstrumentationManifestContent } from '@rasputin-ai/core';
+import { type DerivationCaptureMode } from './transform-source';
+export type InstrumentCompiledDirectoryOptions = {
+    inputDir: string;
+    outputDir?: string;
+    manifestPath?: string;
+    excludedRoots?: readonly string[];
+    sourceRoot?: string;
+    sourceRoots?: Record<string, string>;
+    derivationMode?: DerivationCaptureMode;
+};
+export type InstrumentCompiledDirectoryResult = {
+    transformedFiles: string[];
+    manifest: InstrumentationManifestContent | undefined;
+    manifestPath: string;
+};
+/** Instrument compiled unbundled ESM/CJS and emit the source manifest next to the output. */
+export declare const instrumentCompiledDirectory: (options: InstrumentCompiledDirectoryOptions) => InstrumentCompiledDirectoryResult;
+//# sourceMappingURL=instrument-compiled-esm.d.ts.map

package/dist/auto-instrumentation/instrument-compiled-esm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument-compiled-esm.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/instrument-compiled-esm.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AAQxE,OAAO,EAAE,KAAK,qBAAqB,EAAmB,MAAM,oBAAoB,CAAC;AAIjF,MAAM,MAAM,kCAAkC,GAAG;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC/C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,8BAA8B,GAAG,SAAS,CAAC;IACrD,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAuBF,6FAA6F;AAC7F,eAAO,MAAM,2BAA2B,GACvC,SAAS,kCAAkC,KACzC,iCA4CF,CAAC"}

package/dist/auto-instrumentation/instrumentation-manifest-delta.d.ts

@@ -0,0 +1,41 @@
+import type { DerivationPlan, InstrumentationArgIdentifier, InstrumentationParamBinding } from '@rasputin-ai/core';
+import type { EncodedFunctionPlan } from '../execution-recorder/function-plan';
+export type RawManifestCallSite = {
+    callerFunctionId: string;
+    calleeName: string;
+    calleeText: string;
+    filePath: string;
+    line: number;
+    column: number;
+    endLine: number;
+    endColumn: number;
+    resultBinding: string | null;
+    argIdentifiers: InstrumentationArgIdentifier[];
+};
+export type RawManifestDestructure = {
+    callerFunctionId: string;
+    sourceParam: string;
+    filePath: string;
+    line: number;
+    column: number;
+    binding: InstrumentationParamBinding;
+};
+export type RawManifestFunction = {
+    plan: EncodedFunctionPlan;
+    functionId: string;
+    filePath: string;
+    name: string;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+    params: InstrumentationParamBinding[];
+    paramNames: Set<string>;
+};
+export type InstrumentationManifestDelta = {
+    functions: RawManifestFunction[];
+    callSites: RawManifestCallSite[];
+    destructures: RawManifestDestructure[];
+    derivationPlans: DerivationPlan[];
+};
+//# sourceMappingURL=instrumentation-manifest-delta.d.ts.map

package/dist/auto-instrumentation/instrumentation-manifest-delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation-manifest-delta.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/instrumentation-manifest-delta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,4BAA4B,EAC5B,2BAA2B,EAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE/E,MAAM,MAAM,mBAAmB,GAAG;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,4BAA4B,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,2BAA2B,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,2BAA2B,EAAE,CAAC;IACtC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACvC,eAAe,EAAE,cAAc,EAAE,CAAC;CAClC,CAAC"}

package/dist/auto-instrumentation/instrumentation-manifest-registry.d.ts

@@ -1,11 +1,14 @@
 import { type InstrumentationManifestContent } from '@rasputin-ai/core';
-import type { InstrumentationManifestDelta } from './collect-instrumentation-delta';
-export declare const INSTRUMENTATION_MANIFEST_SYMBOL = "rasputin.instrumentation.manifest.v2";
+import type { InstrumentationManifestDelta } from './instrumentation-manifest-delta';
+export declare const INSTRUMENTATION_MANIFEST_SYMBOL = "rasputin.instrumentation.manifest.v3";
 type SnapshotOptions = {
     sourceRoot?: string;
     sourceRoots?: Record<string, string>;
 };
 export declare const recordInstrumentationManifestDelta: (filePath: string, delta: InstrumentationManifestDelta) => void;
+export declare const recordPrebuiltInstrumentationManifest: (manifest: InstrumentationManifestContent) => void;
+export declare const loadInstrumentationManifestFile: (path: string) => boolean;
+export declare const loadInstrumentationManifestIfPresent: (path: string | undefined) => void;
 export declare const isInstrumentationManifestDirty: () => boolean;
 export declare const instrumentationManifestGeneration: () => number;
 export declare const instrumentationManifestModuleCount: () => number;

package/dist/auto-instrumentation/instrumentation-manifest-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation-manifest-registry.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/instrumentation-manifest-registry.ts"],"names":[],"mappings":"AAMA,OAAO,EAGN,KAAK,8BAA8B,EAKnC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAEpF,eAAO,MAAM,+BAA+B,yCAAyC,CAAC;AAYtF,KAAK,eAAe,GAAG;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CAAC;AAiCF,eAAO,MAAM,kCAAkC,GAC9C,UAAU,MAAM,EAChB,OAAO,4BAA4B,KACjC,IAKF,CAAC;AAEF,eAAO,MAAM,8BAA8B,QAAO,OAGjD,CAAC;AAEF,eAAO,MAAM,iCAAiC,QAAO,MAAkC,CAAC;AAExF,eAAO,MAAM,kCAAkC,QAAO,MAAkC,CAAC;AAEzF,eAAO,MAAM,+BAA+B,GAC3C,UAAS,eAAoB,KAC3B,8BAA8B,GAAG,SAiFnC,CAAC;AAEF,eAAO,MAAM,mCAAmC,GAAI,YAAY,MAAM,KAAG,IAGxE,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAAI,UAAU,MAAM,IAAI,KAAG,IAExE,CAAC;AAEF,eAAO,MAAM,oCAAoC,QAAO,IAEvD,CAAC"}
+{"version":3,"file":"instrumentation-manifest-registry.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/instrumentation-manifest-registry.ts"],"names":[],"mappings":"AAOA,OAAO,EAIN,KAAK,8BAA8B,EAKnC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAErF,eAAO,MAAM,+BAA+B,yCAAyC,CAAC;AAatF,KAAK,eAAe,GAAG;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CAAC;AAiCF,eAAO,MAAM,kCAAkC,GAC9C,UAAU,MAAM,EAChB,OAAO,4BAA4B,KACjC,IAKF,CAAC;AAEF,eAAO,MAAM,qCAAqC,GACjD,UAAU,8BAA8B,KACtC,IAKF,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAI,MAAM,MAAM,KAAG,OAU9D,CAAC;AAEF,eAAO,MAAM,oCAAoC,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,IAG/E,CAAC;AAEF,eAAO,MAAM,8BAA8B,QAAO,OAMjD,CAAC;AAEF,eAAO,MAAM,iCAAiC,QAAO,MAAkC,CAAC;AAExF,eAAO,MAAM,kCAAkC,QAAO,MAKrD,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAC3C,UAAS,eAAoB,KAC3B,8BAA8B,GAAG,SAgGnC,CAAC;AAEF,eAAO,MAAM,mCAAmC,GAAI,YAAY,MAAM,KAAG,IAGxE,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAAI,UAAU,MAAM,IAAI,KAAG,IAExE,CAAC;AAEF,eAAO,MAAM,oCAAoC,QAAO,IAEvD,CAAC"}

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

@@ -1,7 +1,13 @@
-import { type InstrumentationManifestDelta } from './collect-instrumentation-delta';
+import type { InstrumentationManifestDelta } from './instrumentation-manifest-delta';
+export type DerivationCaptureMode = 'analysis' | 'selective';
 export type TransformSourceOptions = {
     filePath: string;
     mapLocation?: SourceLocationMapper;
+    /**
+     * analysis (default): full call capture plus derivation.
+     * selective (experimental): omit argument/return serialization for exact helpers.
+     */
+    derivationMode?: DerivationCaptureMode;
 };
 export type TransformedSource = {
     code: string;

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

@@ -1 +1 @@
-{"version":3,"file":"transform-source.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/transform-source.ts"],"names":[],"mappings":"AAWA,OAAO,EAIN,KAAK,4BAA4B,EAGjC,MAAM,iCAAiC,CAAC;AAIzC,MAAM,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,4BAA4B,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,cAAc,GAAG,SAAS,CAAC;AAuH5F,6FAA6F;AAC7F,eAAO,MAAM,eAAe,GAC3B,QAAQ,MAAM,EACd,SAAS,sBAAsB,KAC7B,iBAAiB,GAAG,SAiFtB,CAAC"}
+{"version":3,"file":"transform-source.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/transform-source.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACX,4BAA4B,EAE5B,MAAM,kCAAkC,CAAC;AAI1C,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,WAAW,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC;;;OAGG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,4BAA4B,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,cAAc,GAAG,SAAS,CAAC;AA6J5F,6FAA6F;AAC7F,eAAO,MAAM,eAAe,GAC3B,QAAQ,MAAM,EACd,SAAS,sBAAsB,KAC7B,iBAAiB,GAAG,SAqItB,CAAC"}

package/dist/auto-instrumentation/warn-production-runtime-transform.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Load-time transformation pulls the TypeScript compiler into the application process. Production
+ * should prefer `rasputin-instrument` at build time; this warning exists so that fallback stays
+ * available without being mistaken for the low-overhead path.
+ */
+export declare const RUNTIME_TRANSFORM_WARNING_SUPPRESS_ENV = "RASPUTIN_SUPPRESS_RUNTIME_TRANSFORM_WARNING";
+export declare const warnIfProductionRuntimeTransform: () => void;
+//# sourceMappingURL=warn-production-runtime-transform.d.ts.map

package/dist/auto-instrumentation/warn-production-runtime-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn-production-runtime-transform.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/warn-production-runtime-transform.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,gDAAgD,CAAC;AAIpG,eAAO,MAAM,gCAAgC,QAAO,IAQnD,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { CaptureReason, DerivationPlan } from '@rasputin-ai/core';
+import ts from 'typescript';
+import { type FunctionCallEdge } from './build-dependency-graph';
+export type CaptureWrap = {
+    rootId: number;
+    reason: CaptureReason;
+    start: number;
+    end: number;
+    line: number;
+    column: number;
+    expressionId: number;
+    /** Object-literal shorthand must be expanded before its value can be wrapped. */
+    shorthandPropertyName?: string;
+};
+type NumericBinaryOp = 'add' | 'sub' | 'mul' | 'div' | 'mod';
+export type GuardWrap = {
+    fallbackRootId: number;
+    start: number;
+    end: number;
+    op: NumericBinaryOp;
+};
+export type AnalyzedFunction = {
+    functionId: string;
+    name: string;
+    node: ts.FunctionLikeDeclaration;
+    plan: DerivationPlan;
+    captureWraps: CaptureWrap[];
+    guardWraps: GuardWrap[];
+    callEdges: FunctionCallEdge[];
+    hasThrow: boolean;
+    hasCoercionGuard: boolean;
+};
+export type ModuleFunctionTarget = {
+    functionId: string;
+    name: string;
+    node: ts.FunctionLikeDeclaration & {
+        body: ts.ConciseBody;
+    };
+};
+export declare const analyzeModuleFunctions: (sourceFile: ts.SourceFile, targets: ModuleFunctionTarget[]) => AnalyzedFunction[];
+export {};
+//# sourceMappingURL=analyze-function.d.ts.map

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

@@ -0,0 +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;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/derivation/build-dependency-graph.d.ts

@@ -0,0 +1,21 @@
+export type FunctionCallEdge = {
+    callerFunctionId: string;
+    calleeName: string;
+    calleeFunctionId?: string;
+};
+export type FunctionDependencyGraph = {
+    functions: string[];
+    edges: FunctionCallEdge[];
+    calleesByCaller: Map<string, string[]>;
+};
+/** Same-module identifier calls only. Anything else is treated as opaque at the call site. */
+export declare const buildDependencyGraph: (functions: Array<{
+    functionId: string;
+    name: string;
+}>, edges: FunctionCallEdge[]) => FunctionDependencyGraph;
+/** Callees before callers so purity proofs can be reused at call sites. */
+export declare const topologicalFunctionOrder: (functions: Array<{
+    functionId: string;
+    name: string;
+}>, graph: FunctionDependencyGraph) => string[];
+//# sourceMappingURL=build-dependency-graph.d.ts.map

package/dist/derivation/build-dependency-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-dependency-graph.d.ts","sourceRoot":"","sources":["../../src/derivation/build-dependency-graph.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACvC,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,GAChC,WAAW,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACtD,OAAO,gBAAgB,EAAE,KACvB,uBAcF,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,GACpC,WAAW,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACtD,OAAO,uBAAuB,KAC5B,MAAM,EA8CR,CAAC"}