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

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.
+# 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 preferred high-performance mode. Transform compiled unbundled JavaScript after `tsc` so the production process never loads TypeScript:
+
+```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`.
+
+Load-time transformation remains available as a compatibility fallback. It imports the TypeScript compiler into the application process and increases RSS:
+
+```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.
 
-## Diagnostics
+Recorder work counters support performance diagnosis without retaining successful execution state:
 
-```ts
-const { recorder, transport } = rasputin.getStats();
-```
+- `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.
 
-Counters are local to the current process and reset on restart.
+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,17 @@
+import type { InstrumentationManifestContent } from '@rasputin-ai/core';
+export type InstrumentCompiledDirectoryOptions = {
+    inputDir: string;
+    outputDir?: string;
+    manifestPath?: string;
+    excludedRoots?: readonly string[];
+    sourceRoot?: string;
+    sourceRoots?: Record<string, string>;
+};
+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;AAYxE,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;CACrC,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,iCA2CF,CAAC"}

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

@@ -0,0 +1,40 @@
+import type { 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[];
+};
+//# 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,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACnG,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;CACvC,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';
+import type { InstrumentationManifestDelta } from './instrumentation-manifest-delta';
 export declare const INSTRUMENTATION_MANIFEST_SYMBOL = "rasputin.instrumentation.manifest.v2";
 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,EAGN,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,SA4FnC,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,4 +1,4 @@
-import { type InstrumentationManifestDelta } from './collect-instrumentation-delta';
+import type { InstrumentationManifestDelta } from './instrumentation-manifest-delta';
 export type TransformSourceOptions = {
     filePath: string;
     mapLocation?: SourceLocationMapper;

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":"AAeA,OAAO,KAAK,EACX,4BAA4B,EAE5B,MAAM,kCAAkC,CAAC;AAI1C,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;AA+H5F,6FAA6F;AAC7F,eAAO,MAAM,eAAe,GAC3B,QAAQ,MAAM,EACd,SAAS,sBAAsB,KAC7B,iBAAiB,GAAG,SAsFtB,CAAC"}

package/dist/execution-recorder/automatic-runtime.d.ts

@@ -1,20 +1,22 @@
 /**
  * Compiler-instrumented functions and the initialized SDK can live in separate bundles. This
  * versioned global registry joins them without generated code importing a physical SDK file. Source
- * tokens contain only package-relative identity, so Docker paths never leak into runtime events.
+ * identity is encoded once per module as a compact plan table so call sites pass only a numeric index.
  */
-import { type RuntimeFunctionDefinition } from '@rasputin-ai/core';
 import type { RasputinExecution } from './execution-recorder-types';
+import type { EncodedFunctionPlan } from './function-plan';
 export declare const AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v2";
-type AutomaticFunctionSource = {
-    filePath: string;
-    name: string;
-    line: number;
-    column: number;
+type ModuleRunner = <T>(planIndex: number, args: ArrayLike<unknown>, callback: () => T) => T;
+type AutomaticRuntime = {
+    run: <T>(plans: readonly EncodedFunctionPlan[], planIndex: number, args: ArrayLike<unknown>, callback: () => T) => T;
 };
-/** Resolve package ownership at transform time, never on the user's request hot path. */
-export declare const encodeAutomaticFunctionSource: (source: AutomaticFunctionSource) => string;
-export declare const decodeAutomaticFunctionSource: (sourceToken: string) => RuntimeFunctionDefinition | undefined;
+type AutomaticRuntimeRegistry = {
+    __rasputinRuntimeRegistry: true;
+    runtimes: AutomaticRuntime[];
+    register: (plans: readonly EncodedFunctionPlan[]) => ModuleRunner;
+};
+export declare const getAutomaticRuntimeRegistry: () => AutomaticRuntimeRegistry;
+export declare const resetAutomaticExecutionRuntime: () => void;
 /** Connect transformed application functions to this SDK instance. */
 export declare const installAutomaticExecutionRuntime: (execution: RasputinExecution) => (() => void);
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"automatic-runtime.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/automatic-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,KAAK,yBAAyB,EAG9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,eAAO,MAAM,wBAAwB,kCAAkC,CAAC;AAKxE,KAAK,uBAAuB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAaF,yFAAyF;AACzF,eAAO,MAAM,6BAA6B,GAAI,QAAQ,uBAAuB,KAAG,MAO/E,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACzC,aAAa,MAAM,KACjB,yBAAyB,GAAG,SAe9B,CAAC;AAuBF,sEAAsE;AACtE,eAAO,MAAM,gCAAgC,GAAI,WAAW,iBAAiB,KAAG,CAAC,MAAM,IAAI,CAkB1F,CAAC"}
+{"version":3,"file":"automatic-runtime.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/automatic-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,eAAO,MAAM,wBAAwB,kCAAkC,CAAC;AAIxE,KAAK,YAAY,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AAE7F,KAAK,gBAAgB,GAAG;IACvB,GAAG,EAAE,CAAC,CAAC,EACN,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,EACxB,QAAQ,EAAE,MAAM,CAAC,KACb,CAAC,CAAC;CACP,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC/B,yBAAyB,EAAE,IAAI,CAAC;IAChC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,KAAK,YAAY,CAAC;CAClE,CAAC;AAgBF,eAAO,MAAM,2BAA2B,QAAO,wBAY9C,CAAC;AAEF,eAAO,MAAM,8BAA8B,QAAO,IAEjD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,gCAAgC,GAAI,WAAW,iBAAiB,KAAG,CAAC,MAAM,IAAI,CAW1F,CAAC"}

package/dist/execution-recorder/call-aware-event-buffer.d.ts

@@ -8,6 +8,7 @@ export declare class CallAwareEventBuffer {
     private readonly capacity;
     private readonly items;
     private readonly openCallIds;
+    private readonly retainedSummaries;
     dropped: number;
     constructor(capacity: number);
     canStartCall(): boolean;
@@ -15,9 +16,9 @@ export declare class CallAwareEventBuffer {
     finishCall(event: ExecutionEvent): void;
     dropCall(): void;
     append(event: ExecutionEvent): boolean;
+    hasSummary(event: object): boolean;
     forceCompletedCall(enter: ExecutionFunctionEnterEvent, terminal: ExecutionEvent): boolean;
     values(): ExecutionEvent[];
-    contains(target: ExecutionEvent): boolean;
     private evictCompletedLeafOrSummary;
 }
 //# sourceMappingURL=call-aware-event-buffer.d.ts.map

package/dist/execution-recorder/call-aware-event-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call-aware-event-buffer.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/call-aware-event-buffer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAE9F,qBAAa,oBAAoB;IAMpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IALrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IAEjD,OAAO,SAAK;gBAEiB,QAAQ,EAAE,MAAM;IAE7C,YAAY,IAAI,OAAO;IAIvB,SAAS,CAAC,KAAK,EAAE,2BAA2B;IAK5C,UAAU,CAAC,KAAK,EAAE,cAAc;IAMhC,QAAQ;IAIR,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAUtC,kBAAkB,CAAC,KAAK,EAAE,2BAA2B,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO;IAYzF,MAAM,IAAI,cAAc,EAAE;IAI1B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;IAIzC,OAAO,CAAC,2BAA2B;CA+CnC"}
+{"version":3,"file":"call-aware-event-buffer.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/call-aware-event-buffer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAE9F,qBAAa,oBAAoB;IAOpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IANrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAE3D,OAAO,SAAK;gBAEiB,QAAQ,EAAE,MAAM;IAE7C,YAAY,IAAI,OAAO;IAIvB,SAAS,CAAC,KAAK,EAAE,2BAA2B;IAK5C,UAAU,CAAC,KAAK,EAAE,cAAc;IAMhC,QAAQ;IAIR,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAWtC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIlC,kBAAkB,CAAC,KAAK,EAAE,2BAA2B,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO;IAYzF,MAAM,IAAI,cAAc,EAAE;IAI1B,OAAO,CAAC,2BAA2B;CAiDnC"}

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

@@ -4,6 +4,7 @@
  * work, and future serverless invocations without coupling the recorder to one framework lifecycle.
  */
 import type { RuntimeExecutionEvent, RuntimeExecutionKind, RuntimeExecutionMetadata, RuntimeExecutionState, RuntimeFunctionCallsSuppressedEvent, RuntimeFunctionDefinition, RuntimeFunctionEnterEvent, SourcePosition } from '@rasputin-ai/core';
+import type { EncodedFunctionPlan, PreparedFunctionPlan } from './function-plan';
 export type ExecutionSourceExclusion = string | RegExp;
 export type ExecutionRecorderOptions = {
     /** Disable runtime-state capture explicitly. It is enabled by SDK initializers by default. */
@@ -42,6 +43,18 @@ export type ExecutionFunctionDescriptor = {
     source?: SourcePosition;
 };
 export type ExecutionRecorderStats = {
+    /** Function hooks observed while an active execution scope exists. */
+    functionCallsObserved: number;
+    /** Observed calls for which a complete enter/terminal pair was captured. */
+    functionCallsCaptured: number;
+    /** Observed calls omitted because their source or parent subtree was excluded. */
+    functionCallsExcluded: number;
+    /** Values actually traversed by the bounded serializer. */
+    serializedValues: number;
+    /** Application value nodes visited while producing bounded snapshots. */
+    serializedValueNodes: number;
+    /** Bounded serialized bytes produced before values are stored in recorder events. */
+    serializedValueBytes: number;
     errorSnapshots: number;
     successfulExecutionsDiscarded: number;
     truncatedEvents: number;
@@ -71,6 +84,10 @@ export type RasputinExecution = {
     getErrorState: (error: unknown, metadata?: Partial<ExecutionMetadata>) => ExecutionState | undefined;
     /** Internal primitive used by SDK-owned source instrumentation. */
     runFunction: <T>(definition: RuntimeFunctionDefinition | string, args: ArrayLike<unknown>, callback: () => T) => T;
+    /** Internal prepared-plan path used by automatic instrumentation. */
+    runFunctionPlans: <T>(plans: readonly EncodedFunctionPlan[], planIndex: number, args: ArrayLike<unknown>, callback: () => T) => T;
+    /** Internal primitive used after a module's function plans have been resolved. */
+    runPreparedFunction: <T>(plan: PreparedFunctionPlan, args: ArrayLike<unknown>, callback: () => T) => T;
     /** Manual fallback for runtimes/build systems without automatic instrumentation. */
     trace: <TThis, TArgs extends unknown[], TResult>(definition: string | ExecutionFunctionDescriptor, fn: (this: TThis, ...args: TArgs) => TResult) => (this: TThis, ...args: TArgs) => TResult;
     getStats: () => ExecutionRecorderStats;