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

package/README.md

@@ -1,188 +1,219 @@
-# 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.
+# 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
+
+Rasputin wraps your functions so it can show what ran when an error happened.
+
+**Compiled JavaScript (use this in production)**
+
+Build as you already do, then run `rasputin-instrument` on the output. Start the process normally — no extra flags:
+
+```json
+{
+  "scripts": {
+    "build": "tsc && rasputin-instrument dist",
+    "start:node": "node dist/app.js",
+    "start:bun": "bun dist/app.js"
+  }
+}
+```
+
+Have TypeScript write `.js.map` files next to the output so recorded functions still point at your `.ts` sources. The instrumenter writes `.rasputin/instrumentation-manifest.json` beside `dist`, and `RasputinInit` loads it automatically.
+
+**Running TypeScript directly**
+
+`rasputin-instrument` rewrites compiled `.js` files on disk. It does not run when you start TypeScript with Bun (`bun src/app.ts`, `bun run src/app.ts`, and similar). Use `--preload` so Bun wraps files as they load:
+
+```json
+{
+  "scripts": {
+    "start:bun": "bun --preload @rasputin-ai/node/instrument/bun src/app.ts"
+  }
+}
+```
+
+On Node you can wrap compiled files as they load instead of instrumenting at build time:
+
+```json
+{
+  "scripts": {
+    "start:node": "node --import @rasputin-ai/node/instrument/node dist/app.js"
+  }
+}
+```
+
+Use `--preload` / `--import` while you run TypeScript locally. In production, instrument at build time instead — wrapping files at startup is slower and uses more memory.
+
+Runtime state is kept only while a request or job is running, and is attached when that work throws.
+
+## Manual capture
+
+Wrap each meaningful unit of work — an HTTP request, background job, scheduled task, or worker iteration — in an execution:
+
+```ts
+const scope = rasputin.execution.createScope({
+  kind: 'job',
+  name: 'sync-invoices',
+})
+
+try {
+  return await scope.run(() => syncInvoices())
+} catch (error) {
+  scope.associateError(error)
+  throw error
+} finally {
+  scope.finish()
+}
+```
+
+`scope.run()` executes the callback under this recording's async context and returns exactly what the callback returned. It does not wrap, replace, or observe Promises. The caller owns `await`, error association, and `finish()`.
+
+When automatic instrumentation is unavailable, mark individual functions explicitly:
+
+```ts
+const syncInvoices = rasputin.execution.trace(
+  'src/jobs/sync-invoices.ts:syncInvoices',
+  async () => {
+    // ...
+  },
+);
+```
+
+`trace()` preserves the call receiver (`this`) for methods and `.call` / `.apply` / `.bind`. It is not a constructor — do not use `new` on the wrapped function.
+
+Framework packages such as `@rasputin-ai/elysia` create HTTP executions automatically.
+
+## Runtime support
+
+| Environment | Support |
+| --- | --- |
+| TypeScript compiled to multiple JavaScript files | Use `rasputin-instrument dist` after `tsc`, with adjacent source maps |
+| Bun 1.3.x running `.ts` or `.js` files directly | Use `--preload @rasputin-ai/node/instrument/bun` |
+| Node.js 22.15 or newer, unbundled ESM/CJS | Use `rasputin-instrument`, or `--import @rasputin-ai/node/instrument/node`; Node 22 and 24 are the supported LTS lines |
+
+On Node.js 22, start the process with `--experimental-async-context-frame` (or set `NODE_OPTIONS`) so `AsyncLocalStorage` uses the faster implementation that Node.js 24 enables by default. Rasputin logs this once when the flag is missing; set `RASPUTIN_SUPPRESS_ASYNC_CONTEXT_FRAME_WARNING=1` to hide it.
+| Single-file bundles (esbuild, tsup, webpack, Vite SSR, Next.js) | Automatic instrumentation is not supported |
+| `tsx`, custom Node loader stacks, and Node's native TypeScript execution | Automatic instrumentation is not supported |
+| Deno and edge runtimes | Not supported |
+
+Tested on Bun 1.3.13 and Node.js 24.19.0. Node.js 22.15.0 is the minimum for automatic instrumentation. Use `execution.createScope()` 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 |
+| `runtimeStateTargetBytes` | `256 KiB` | Soft size goal for the snapshot sent with an error; extra reconstruction data is dropped first |
+| `maxRuntimeStateBytes` | `512 KiB` | Hard size limit for that snapshot; values are dropped before call history |
+| `redactKeys` | `[]` | Additional property names to redact (case- and separator-insensitive, trailing digits ignored) |
+| `excludeSources` | `[]` | Source globs or function-name patterns to exclude |
+| `maxExecutionHoldMs` | `60s` | How long one recording may hold process-wide memory, including finished work with in-flight calls |
+| `maxRetainedErrorRecordings` | `32` | Finished error snapshots kept for later `getErrorState`. Older ones report `unavailable` / `retained_state_evicted` |
+
+```ts
+const rasputin = RasputinInit({
+  // ...required options
+  executionRecorder: {
+    excludeSources: ['src/logger/**', 'packages/shared-logger/**'],
+    redactKeys: ['customerEmail'],
+    maxEventsPerExecution: 200,
+  },
+});
+```
+
+Runtime state can include application data. Rasputin redacts **property names** that look like secrets (`password`, `token`, `DATABASE_URL`, `jwt`, `sessionId`, and similar, including digit suffixes like `password2`). It does **not** scan ordinary string values for embedded secrets. Use `redactKeys` for additional field names.
+
+`captureProfile.functionBoundaries: "full"` means every retained function boundary is complete. Repeated successful calls may still be summarized into `function_calls_suppressed` events.
+
+Short-lived processes flush telemetry for at most about two seconds on exit. If ingest is unreachable, Rasputin drops the leftover events and prints one stderr line rather than holding a CLI or cron job open.
+
+The on-disk transform cache includes the verification mode in its key, so an unverified rewrite cannot be reused by a verifying process. On POSIX the cache directory must be owned by the process user and not world-writable. Windows cannot enforce those ownership bits, so a project-local cache is trusted when the directory can be created.
+
+## Diagnostics
+
+```ts
+const { recorder, transport } = rasputin.getStats();
+```
+
+These counters describe what this process has recorded and sent since it started. They reset on restart. Compare two snapshots if you want activity over a window, rather than dividing lifetime totals by one request.

package/dist/auto-instrumentation/bun-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bun-plugin.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/bun-plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAK7C,MAAM,MAAM,iCAAiC,GAAG;IAC/C,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;CACrB,CAAC;AAcF,eAAO,MAAM,yBAAyB,GACrC,UAAU,MAAM,EAChB,UAAS,iCAAsC,KAC7C,OAAmF,CAAC;AAEvF,kGAAkG;AAClG,eAAO,MAAM,4BAA4B,GACxC,UAAU,MAAM,EAChB,UAAS,iCAAsC,KAC7C,OAAO,CAAC,yBAAyB,CAqBnC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GACnC,UAAS,iCAAsC,KAC7C,SAsBF,CAAC"}
+{"version":3,"file":"bun-plugin.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/bun-plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAK7C,MAAM,MAAM,iCAAiC,GAAG;IAC/C,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;CACrB,CAAC;AAcF,eAAO,MAAM,yBAAyB,GACrC,UAAU,MAAM,EAChB,UAAS,iCAAsC,KAC7C,OAAmF,CAAC;AAEvF,kGAAkG;AAClG,eAAO,MAAM,4BAA4B,GACxC,UAAU,MAAM,EAChB,UAAS,iCAAsC,KAC7C,OAAO,CAAC,yBAAyB,CAwBnC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GACnC,UAAS,iCAAsC,KAC7C,SAsBF,CAAC"}

package/dist/auto-instrumentation/format-configuration-report.d.ts

@@ -4,6 +4,10 @@ type ConfigurationReportInput = {
     runtime: string;
     modules: number;
     functions: number;
+    skippedFunctions?: number;
+    instrumentedAsync?: number;
+    skippedByReason?: Partial<Record<string, number>>;
+    attributionDegradations?: number;
     packageNames: string[];
     verification: SourceVerification;
     uploaded: boolean;

package/dist/auto-instrumentation/format-configuration-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-configuration-report.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/format-configuration-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,KAAK,wBAAwB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,kBAAkB,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AA2CF,eAAO,MAAM,yBAAyB,GAAI,OAAO,wBAAwB,KAAG,MAkE3E,CAAC;AAEF,eAAO,MAAM,YAAY,QAAO,MAI/B,CAAC"}
+{"version":3,"file":"format-configuration-report.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/format-configuration-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,KAAK,wBAAwB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,kBAAkB,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AA2CF,eAAO,MAAM,yBAAyB,GAAI,OAAO,wBAAwB,KAAG,MAiF3E,CAAC;AAEF,eAAO,MAAM,YAAY,QAAO,MAI/B,CAAC"}

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

@@ -1,5 +1,4 @@
-import type { InstrumentationManifestContent } from '@rasputin-ai/core';
-import { type DerivationCaptureMode } from './transform-source';
+import { type InstrumentationManifestContent } from '@rasputin-ai/core';
 export type InstrumentCompiledDirectoryOptions = {
     inputDir: string;
     outputDir?: string;
@@ -7,7 +6,6 @@ export type InstrumentCompiledDirectoryOptions = {
     excludedRoots?: readonly string[];
     sourceRoot?: string;
     sourceRoots?: Record<string, string>;
-    derivationMode?: DerivationCaptureMode;
 };
 export type InstrumentCompiledDirectoryResult = {
     transformedFiles: string[];

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

@@ -1 +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"}
+{"version":3,"file":"instrument-compiled-esm.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/instrument-compiled-esm.ts"],"names":[],"mappings":"AAMA,OAAO,EAEN,KAAK,8BAA8B,EACnC,MAAM,mBAAmB,CAAC;AAY3B,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,iCAmDF,CAAC"}

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

@@ -1,5 +1,10 @@
-import type { DerivationPlan, InstrumentationArgIdentifier, InstrumentationParamBinding } from '@rasputin-ai/core';
+/**
+ * One transformed file's contribution to the release manifest: functions, call sites, and
+ * destructures. The registry concatenates these deltas before upload.
+ */
+import type { InstrumentationArgIdentifier, InstrumentationParamBinding, InstrumentationSkipReason } from '@rasputin-ai/core';
 import type { EncodedFunctionPlan } from '../execution-recorder/function-plan';
+export type { InstrumentationSkipReason };
 export type RawManifestCallSite = {
     callerFunctionId: string;
     calleeName: string;
@@ -31,11 +36,14 @@ export type RawManifestFunction = {
     endColumn: number;
     params: InstrumentationParamBinding[];
     paramNames: Set<string>;
+    instrumented: boolean;
+    skipReason?: InstrumentationSkipReason;
+    asyncFunction?: boolean;
 };
 export type InstrumentationManifestDelta = {
     functions: RawManifestFunction[];
     callSites: RawManifestCallSite[];
     destructures: RawManifestDestructure[];
-    derivationPlans: DerivationPlan[];
+    alreadyInstrumented?: boolean;
 };
 //# sourceMappingURL=instrumentation-manifest-delta.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"instrumentation-manifest-delta.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/instrumentation-manifest-delta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACX,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE/E,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAE1C,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;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,aAAa,CAAC,EAAE,OAAO,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,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC"}

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

@@ -11,6 +11,12 @@ 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 instrumentationCoverageStats: () => {
+    instrumented: number;
+    instrumentedAsync: number;
+    alreadyInstrumented: number;
+    skippedByReason: Record<string, number>;
+};
 export declare const instrumentationManifestModuleCount: () => number;
 export declare const snapshotInstrumentationManifest: (options?: SnapshotOptions) => InstrumentationManifestContent | undefined;
 export declare const markInstrumentationManifestUploaded: (generation: number) => void;

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":"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"}
+{"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;AAqBtF,KAAK,eAAe,GAAG;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CAAC;AAoCF,eAAO,MAAM,kCAAkC,GAC9C,UAAU,MAAM,EAChB,OAAO,4BAA4B,KACjC,IASF,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,4BAA4B,QAAO;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CA0BxC,CAAC;AAEF,eAAO,MAAM,kCAAkC,QAAO,MAKrD,CAAC;AAQF,eAAO,MAAM,+BAA+B,GAC3C,UAAS,eAAoB,KAC3B,8BAA8B,GAAG,SA+GnC,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/node-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-hooks.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/node-hooks.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,kCAAkC,GAAG;IAChD,8FAA8F;IAC9F,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC;AA6BF,eAAO,MAAM,yBAAyB,GACrC,UAAS,kCAAuC,KAC9C,IA8CF,CAAC"}
+{"version":3,"file":"node-hooks.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/node-hooks.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,kCAAkC,GAAG;IAChD,8FAA8F;IAC9F,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC;AA6BF,eAAO,MAAM,yBAAyB,GACrC,UAAS,kCAAuC,KAC9C,IAuDF,CAAC"}

package/dist/auto-instrumentation/parameter-initializer-may-run-code.d.ts

@@ -0,0 +1,3 @@
+import ts from 'typescript';
+export declare const functionHasPreBodyParameterEvaluation: (node: ts.SignatureDeclaration) => boolean;
+//# sourceMappingURL=parameter-initializer-may-run-code.d.ts.map

package/dist/auto-instrumentation/parameter-initializer-may-run-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-initializer-may-run-code.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/parameter-initializer-may-run-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAqC5B,eAAO,MAAM,qCAAqC,GAAI,MAAM,EAAE,CAAC,oBAAoB,KAAG,OAOrF,CAAC"}

package/dist/auto-instrumentation/schedule-instrumentation-manifest-upload.d.ts

@@ -17,7 +17,7 @@ type ScheduleInstrumentationManifestUploadOptions = {
 };
 type InstrumentationManifestUploadHandle = {
     flushSoon: () => void;
-    wait: () => Promise<void>;
+    wait: (timeoutMs?: number) => Promise<void>;
     disconnect: () => void;
     verify: () => Promise<SourceVerification>;
 };

package/dist/auto-instrumentation/schedule-instrumentation-manifest-upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schedule-instrumentation-manifest-upload.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/schedule-instrumentation-manifest-upload.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGN,KAAK,kBAAkB,EAEvB,MAAM,mBAAmB,CAAC;AAW3B,KAAK,4CAA4C,GAAG;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjF,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,mCAAmC,GAAG;IAC1C,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC1C,CAAC;AAkBF,eAAO,MAAM,qCAAqC,GACjD,SAAS,4CAA4C,KACnD,mCAwGF,CAAC"}
+{"version":3,"file":"schedule-instrumentation-manifest-upload.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/schedule-instrumentation-manifest-upload.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGN,KAAK,kBAAkB,EAEvB,MAAM,mBAAmB,CAAC;AAY3B,KAAK,4CAA4C,GAAG;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjF,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,mCAAmC,GAAG;IAC1C,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC1C,CAAC;AAkBF,eAAO,MAAM,qCAAqC,GACjD,SAAS,4CAA4C,KACnD,mCA6LF,CAAC"}

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

@@ -1,3 +1,4 @@
 import type { SourceLocationMapper } from './transform-source';
+export declare const sourceMapPayloadForCache: (generatedPath: string, source: string) => string;
 export declare const createSourceMapLocationMapper: (generatedPath: string, source: string) => SourceLocationMapper | undefined;
 //# sourceMappingURL=source-map-locations.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"source-map-locations.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/source-map-locations.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAkB,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAgC/E,eAAO,MAAM,6BAA6B,GACzC,eAAe,MAAM,EACrB,QAAQ,MAAM,KACZ,oBAAoB,GAAG,SA8BzB,CAAC"}
+{"version":3,"file":"source-map-locations.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/source-map-locations.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAkB,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAgC/E,eAAO,MAAM,wBAAwB,GAAI,eAAe,MAAM,EAAE,QAAQ,MAAM,KAAG,MAMhF,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACzC,eAAe,MAAM,EACrB,QAAQ,MAAM,KACZ,oBAAoB,GAAG,SA8BzB,CAAC"}

package/dist/auto-instrumentation/suspension-whitelist.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Phase-1 async instrumentation is a whitelist. Anything we have not proven
+ * exact — `for await`, `await using`, async generators, unknown future
+ * syntax — is skipped rather than approximated.
+ */
+import ts from 'typescript';
+import type { InstrumentationSkipReason } from './instrumentation-manifest-delta';
+export declare const knownSuspensionSyntaxKindNames: () => readonly string[];
+export declare const unexpectedSuspensionSyntaxKindNames: () => string[];
+export type AsyncInstrumentationAction = {
+    action: 'skip';
+    reason: InstrumentationSkipReason;
+} | {
+    action: 'inline';
+} | {
+    action: 'suspend_resume';
+};
+type FunctionLike = ts.FunctionLikeDeclaration;
+export declare const isAsyncFunctionLike: (node: FunctionLike) => boolean;
+export declare const isAsyncGeneratorLike: (node: ts.Node) => node is FunctionLike;
+export declare const isSyncGeneratorLike: (node: ts.Node) => node is FunctionLike;
+export declare const ownBodyHasAwaitKeyword: (node: FunctionLike, sourceFile: ts.SourceFile) => boolean;
+export type OwnSuspensionFacts = {
+    awaitExpressions: boolean;
+    forAwait: boolean;
+    awaitUsing: boolean;
+    unknown: boolean;
+    awaitKeyword: boolean;
+};
+export declare const ownSuspensionFacts: (node: FunctionLike, sourceFile: ts.SourceFile) => OwnSuspensionFacts;
+export declare const decideAsyncInstrumentation: (node: FunctionLike, sourceFile: ts.SourceFile) => AsyncInstrumentationAction;
+export {};
+//# sourceMappingURL=suspension-whitelist.d.ts.map

package/dist/auto-instrumentation/suspension-whitelist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suspension-whitelist.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/suspension-whitelist.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAclF,eAAO,MAAM,8BAA8B,QAAO,SAAS,MAAM,EAAiC,CAAC;AAEnG,eAAO,MAAM,mCAAmC,QAAO,MAAM,EAU5D,CAAC;AAEF,MAAM,MAAM,0BAA0B,GACnC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,yBAAyB,CAAA;CAAE,GACrD;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEhC,KAAK,YAAY,GAAG,EAAE,CAAC,uBAAuB,CAAC;AAI/C,eAAO,MAAM,mBAAmB,GAAI,MAAM,YAAY,KAAG,OACU,CAAC;AAEpE,eAAO,MAAM,oBAAoB,GAAI,MAAM,EAAE,CAAC,IAAI,KAAG,IAAI,IAAI,YAIjC,CAAC;AAE7B,eAAO,MAAM,mBAAmB,GAAI,MAAM,EAAE,CAAC,IAAI,KAAG,IAAI,IAAI,YAIjC,CAAC;AAgE5B,eAAO,MAAM,sBAAsB,GAAI,MAAM,YAAY,EAAE,YAAY,EAAE,CAAC,UAAU,KAAG,OAOtF,CAAC;AAgBF,MAAM,MAAM,kBAAkB,GAAG;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC9B,MAAM,YAAY,EAClB,YAAY,EAAE,CAAC,UAAU,KACvB,kBAkBF,CAAC;AAiBF,eAAO,MAAM,0BAA0B,GACtC,MAAM,YAAY,EAClB,YAAY,EAAE,CAAC,UAAU,KACvB,0BAcF,CAAC"}

package/dist/auto-instrumentation/transform-disk-cache.d.ts

@@ -0,0 +1,7 @@
+import { type TransformedSource, type TransformSourceOptions } from './transform-source';
+export declare const resolveTransformCacheDir: () => string;
+export declare const transformSourceCached: (source: string, options: TransformSourceOptions, cache?: {
+    directory?: string;
+    limit?: number;
+}) => TransformedSource | undefined;
+//# sourceMappingURL=transform-disk-cache.d.ts.map

package/dist/auto-instrumentation/transform-disk-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-disk-cache.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/transform-disk-cache.ts"],"names":[],"mappings":"AAuBA,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAE3B,MAAM,oBAAoB,CAAC;AA+B5B,eAAO,MAAM,wBAAwB,QAAO,MAGoB,CAAC;AAwIjE,eAAO,MAAM,qBAAqB,GACjC,QAAQ,MAAM,EACd,SAAS,sBAAsB,EAC/B,QAAO;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,KAChD,iBAAiB,GAAG,SAgBtB,CAAC"}