@rasputin-ai/node 0.3.0 → 0.4.0

package/README.md

@@ -14,7 +14,6 @@ export const rasputin = RasputinInit({
   release: process.env.RASPUTIN_RELEASE!,
   environment: process.env.NODE_ENV ?? 'development',
   enabled: ['staging', 'production'].includes(process.env.NODE_ENV ?? 'development'),
-  moduleUrl: import.meta.url,
 });
 ```
 
@@ -38,8 +37,23 @@ try {
 | `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` |
-| `moduleUrl` | one of these two | `import.meta.url` from the initialization file |
-| `repoRoot` | one of these two | Explicit source root for deployments with a different filesystem layout |
+| `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
 
@@ -124,7 +138,7 @@ Defaults work for most apps. Customize to exclude noisy sources, redact fields,
 | `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-ID patterns to exclude |
+| `excludeSources` | `[]` | Source globs or function-name patterns to exclude |
 
 ```ts
 const rasputin = RasputinInit({

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

@@ -1,3 +1,9 @@
+/**
+ * Walks the TypeScript AST while a module is being transformed and records the static facts
+ * Rasputin needs for replay: instrumented functions, call sites, and parameter destructuring
+ * 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 ts from 'typescript';
 type SourceLocation = {

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,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,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"}

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

@@ -0,0 +1,14 @@
+import type { SourceVerification } from '@rasputin-ai/core';
+type ConfigurationReportInput = {
+    release: string;
+    runtime: string;
+    modules: number;
+    functions: number;
+    packageNames: string[];
+    verification: SourceVerification;
+    uploaded: boolean;
+};
+export declare const formatConfigurationReport: (input: ConfigurationReportInput) => string;
+export declare const runtimeLabel: () => string;
+export {};
+//# sourceMappingURL=format-configuration-report.d.ts.map

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

@@ -0,0 +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"}

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

@@ -1,11 +1,17 @@
-import type { InstrumentationManifestContent } from '@rasputin-ai/core';
+import { type InstrumentationManifestContent } from '@rasputin-ai/core';
 import type { InstrumentationManifestDelta } from './collect-instrumentation-delta';
-export declare const INSTRUMENTATION_MANIFEST_SYMBOL = "rasputin.instrumentation.manifest.v1";
+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 isInstrumentationManifestDirty: () => boolean;
 export declare const instrumentationManifestGeneration: () => number;
-export declare const snapshotInstrumentationManifest: (repoRoot: string) => InstrumentationManifestContent | undefined;
+export declare const instrumentationManifestModuleCount: () => number;
+export declare const snapshotInstrumentationManifest: (options?: SnapshotOptions) => InstrumentationManifestContent | undefined;
 export declare const markInstrumentationManifestUploaded: (generation: number) => void;
 export declare const setInstrumentationManifestOnDirty: (onDirty?: () => void) => void;
 export declare const resetInstrumentationManifestRegistry: () => void;
+export {};
 //# sourceMappingURL=instrumentation-manifest-registry.d.ts.map

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":"AAKA,OAAO,KAAK,EAEX,8BAA8B,EAG9B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAEpF,eAAO,MAAM,+BAA+B,yCAAyC,CAAC;AA2CtF,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,+BAA+B,GAC3C,UAAU,MAAM,KACd,8BAA8B,GAAG,SAmEnC,CAAC;AAEF,eAAO,MAAM,mCAAmC,GAAI,YAAY,MAAM,KAAG,IAKxE,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":"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"}

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

@@ -1,8 +1,17 @@
+/**
+ * The manifest registry accumulates instrumentation facts as modules load, but Rasputin only
+ * learns about them after an upload. This schedules that upload after startup without blocking
+ * the process, debounces on registry changes, prints the configuration report once, and exposes
+ * verifyConfiguration().
+ */
+import { type SourceVerification } from '@rasputin-ai/core';
 type ScheduleInstrumentationManifestUploadOptions = {
     projectApiKey: string;
     release?: string;
     apiUrl?: string;
-    repoRoot?: string;
+    sourceRoot?: string;
+    sourceRoots?: Record<string, string>;
+    logSuccess?: boolean;
     fetch?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
     enabled: boolean;
 };
@@ -10,6 +19,7 @@ type InstrumentationManifestUploadHandle = {
     flushSoon: () => void;
     wait: () => Promise<void>;
     disconnect: () => void;
+    verify: () => Promise<SourceVerification>;
 };
 export declare const scheduleInstrumentationManifestUpload: (options: ScheduleInstrumentationManifestUploadOptions) => InstrumentationManifestUploadHandle;
 export {};

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,KAAK,4CAA4C,GAAG;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,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;CACvB,CAAC;AAQF,eAAO,MAAM,qCAAqC,GACjD,SAAS,4CAA4C,KACnD,mCA4CF,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;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"}

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

@@ -1,18 +1,21 @@
+/**
+ * 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.
+ */
+import { type RuntimeFunctionDefinition } from '@rasputin-ai/core';
 import type { RasputinExecution } from './execution-recorder-types';
-export declare const AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v1";
+export declare const AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v2";
 type AutomaticFunctionSource = {
     filePath: string;
     name: string;
     line: number;
     column: number;
 };
-type AutomaticExecutionRuntimeOptions = {
-    repoRoot?: string;
-};
-/** Encode source metadata once at transform time without allocating an object per function call. */
+/** Resolve package ownership at transform time, never on the user's request hot path. */
 export declare const encodeAutomaticFunctionSource: (source: AutomaticFunctionSource) => string;
-export declare const normalizeAutomaticFunctionId: (sourceToken: string, repoRoot: string) => string | undefined;
-/** Connect compiler-instrumented application functions to this SDK instance. */
-export declare const installAutomaticExecutionRuntime: (execution: RasputinExecution, options?: AutomaticExecutionRuntimeOptions) => (() => void);
+export declare const decodeAutomaticFunctionSource: (sourceToken: string) => RuntimeFunctionDefinition | undefined;
+/** Connect transformed application functions to this SDK instance. */
+export declare const installAutomaticExecutionRuntime: (execution: RasputinExecution) => (() => void);
 export {};
 //# sourceMappingURL=automatic-runtime.d.ts.map

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":"AAOA,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;AAEF,KAAK,gCAAgC,GAAG;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAWF,oGAAoG;AACpG,eAAO,MAAM,6BAA6B,GAAI,QAAQ,uBAAuB,KAAG,MAG9E,CAAC;AAEH,eAAO,MAAM,4BAA4B,GACxC,aAAa,MAAM,EACnB,UAAU,MAAM,KACd,MAAM,GAAG,SAWX,CAAC;AA0BF,gFAAgF;AAChF,eAAO,MAAM,gCAAgC,GAC5C,WAAW,iBAAiB,EAC5B,UAAS,gCAAqC,KAC5C,CAAC,MAAM,IAAI,CAwBb,CAAC"}
+{"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"}

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

@@ -3,7 +3,7 @@
  * event model explicit allows the same bounded state to represent HTTP requests, jobs, scheduled
  * work, and future serverless invocations without coupling the recorder to one framework lifecycle.
  */
-import type { RuntimeExecutionEvent, RuntimeExecutionKind, RuntimeExecutionMetadata, RuntimeExecutionState, RuntimeFunctionCallsSuppressedEvent, RuntimeFunctionEnterEvent } from '@rasputin-ai/core';
+import type { RuntimeExecutionEvent, RuntimeExecutionKind, RuntimeExecutionMetadata, RuntimeExecutionState, RuntimeFunctionCallsSuppressedEvent, RuntimeFunctionDefinition, RuntimeFunctionEnterEvent, SourcePosition } from '@rasputin-ai/core';
 export type ExecutionSourceExclusion = string | RegExp;
 export type ExecutionRecorderOptions = {
     /** Disable runtime-state capture explicitly. It is enabled by SDK initializers by default. */
@@ -37,6 +37,10 @@ export type ExecutionFunctionEnterEvent = RuntimeFunctionEnterEvent;
 export type ExecutionFunctionCallsSuppressedEvent = RuntimeFunctionCallsSuppressedEvent;
 export type ExecutionEvent = RuntimeExecutionEvent;
 export type ExecutionState = RuntimeExecutionState;
+export type ExecutionFunctionDescriptor = {
+    name: string;
+    source?: SourcePosition;
+};
 export type ExecutionRecorderStats = {
     errorSnapshots: number;
     successfulExecutionsDiscarded: number;
@@ -63,9 +67,9 @@ export type RasputinExecution = {
     run: <T>(metadata: ExecutionMetadata, callback: () => T) => T;
     getErrorState: (error: unknown, metadata?: Partial<ExecutionMetadata>) => ExecutionState | undefined;
     /** Internal primitive used by SDK-owned source instrumentation. */
-    runFunction: <T>(functionId: string, args: ArrayLike<unknown>, callback: () => T) => T;
+    runFunction: <T>(definition: RuntimeFunctionDefinition | string, args: ArrayLike<unknown>, callback: () => T) => T;
     /** Manual fallback for runtimes/build systems without automatic instrumentation. */
-    trace: <TThis, TArgs extends unknown[], TResult>(functionId: string, fn: (this: TThis, ...args: TArgs) => TResult) => (this: TThis, ...args: TArgs) => TResult;
+    trace: <TThis, TArgs extends unknown[], TResult>(definition: string | ExecutionFunctionDescriptor, fn: (this: TThis, ...args: TArgs) => TResult) => (this: TThis, ...args: TArgs) => TResult;
     getStats: () => ExecutionRecorderStats;
 };
 //# sourceMappingURL=execution-recorder-types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"execution-recorder-types.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/execution-recorder-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"execution-recorder-types.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/execution-recorder-types.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"execution-recorder.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/execution-recorder.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAKX,wBAAwB,EAExB,iBAAiB,EACjB,MAAM,4BAA4B,CAAC;AAwKpC,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,GACnC,SAAS,wBAAwB,GAAG,SAAS,KAC3C,iBA+bF,CAAC"}
+{"version":3,"file":"execution-recorder.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/execution-recorder.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAKX,wBAAwB,EAExB,iBAAiB,EACjB,MAAM,4BAA4B,CAAC;AA8LpC,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,GACnC,SAAS,wBAAwB,GAAG,SAAS,KAC3C,iBAkdF,CAAC"}

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

@@ -1,3 +1,3 @@
 export { createExecutionRecorder } from './execution-recorder';
-export type { ExecutionKind, ExecutionMetadata, ExecutionRecorderOptions, ExecutionRecorderStats, ExecutionScope, ExecutionSourceExclusion, ExecutionState, RasputinExecution, } from './execution-recorder-types';
+export type { ExecutionFunctionDescriptor, ExecutionKind, ExecutionMetadata, ExecutionRecorderOptions, ExecutionRecorderStats, ExecutionScope, ExecutionSourceExclusion, ExecutionState, RasputinExecution, } from './execution-recorder-types';
 //# sourceMappingURL=index.d.ts.map

package/dist/execution-recorder/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EACX,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,cAAc,EACd,iBAAiB,GACjB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EACX,2BAA2B,EAC3B,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,cAAc,EACd,iBAAiB,GACjB,MAAM,4BAA4B,CAAC"}

package/dist/execution-recorder/source-exclusions.d.ts

@@ -3,7 +3,8 @@
  * capture time avoids both CPU work and accidental retention of redundant logger/framework state,
  * while compiling patterns once keeps the exclusion feature off the hot path.
  */
+import type { RuntimeFunctionDefinition } from '@rasputin-ai/core';
 import type { ExecutionSourceExclusion } from './execution-recorder-types';
 /** Compile exclusions once so skipped calls avoid serialization and repeated pattern work. */
-export declare const createSourceExclusionMatcher: (exclusions: ExecutionSourceExclusion[] | undefined) => ((functionId: string) => boolean);
+export declare const createSourceExclusionMatcher: (exclusions: ExecutionSourceExclusion[] | undefined) => ((definition: RuntimeFunctionDefinition) => boolean);
 //# sourceMappingURL=source-exclusions.d.ts.map

package/dist/execution-recorder/source-exclusions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-exclusions.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/source-exclusions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAsC3E,8FAA8F;AAC9F,eAAO,MAAM,4BAA4B,GACxC,YAAY,wBAAwB,EAAE,GAAG,SAAS,KAChD,CAAC,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CA8BlC,CAAC"}
+{"version":3,"file":"source-exclusions.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/source-exclusions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AA2C3E,8FAA8F;AAC9F,eAAO,MAAM,4BAA4B,GACxC,YAAY,wBAAwB,EAAE,GAAG,SAAS,KAChD,CAAC,CAAC,UAAU,EAAE,yBAAyB,KAAK,OAAO,CAgCrD,CAAC"}

package/dist/index.js

@@ -5,23 +5,133 @@ import {
   uploadInstrumentationManifest
 } from "@rasputin-ai/core";
 
+// src/auto-instrumentation/format-configuration-report.ts
+var RULE = "-".repeat(64);
+var BANNER = [
+  RULE,
+  " ____       _      ____    ____    _   _   _____   ___   _   _",
+  "|  _ \\     / \\    / ___|  |  _ \\  | | | | |_   _| |_ _| | \\ | |",
+  "| |_) |   / _ \\   \\___ \\  | |_) | | | | |   | |    | |  |  \\| |",
+  "|  _ <   / ___ \\   ___) | |  __/  | |_| |   | |    | |  | |\\  |",
+  "|_| \\_\\ /_/   \\_\\ |____/  |_|      \\___/    |_|   |___| |_| \\_|",
+  "",
+  "",
+  "CONFIGURATION:"
+];
+var counted = (n, singular, plural) => `${n} ${n === 1 ? singular : plural}`;
+var issueHeadline = (issue) => {
+  const target = issue.packageName ? `package ${issue.packageName}` : issue.packageRelativePath;
+  if (issue.reason === "ambiguous") return `Could not uniquely locate ${target}.`;
+  if (issue.reason === "not_found") return `Could not find ${target} in this Git release.`;
+  if (issue.reason === "invalid_mapping") {
+    return `The configured package root for ${target} does not match this Git release.`;
+  }
+  return `GitHub could not be reached while locating ${target}.`;
+};
+var formatIssue = (issue) => {
+  const lines = [
+    `! ${issueHeadline(issue)}`,
+    "",
+    "  Captured:",
+    `    ${issue.packageRelativePath}`
+  ];
+  if (issue.candidates?.length) {
+    lines.push("", "  Possible repository locations:");
+    for (const candidate of issue.candidates) lines.push(`    ${candidate}`);
+  }
+  return lines;
+};
+var formatConfigurationReport = (input) => {
+  const packages = input.verification.packages ?? [];
+  const unresolved = input.verification.unresolved;
+  const mappingIssues = unresolved.filter((issue) => issue.reason !== "github_unavailable");
+  const githubUnavailable = input.verification.status === "unavailable" || unresolved.some((issue) => issue.reason === "github_unavailable");
+  const verified = input.uploaded && input.verification.status === "verified";
+  const lines = [
+    ...BANNER,
+    "",
+    "Release",
+    `\u2713 ${input.release}`,
+    "",
+    "Runtime",
+    `\u2713 ${input.runtime}`,
+    "",
+    "Instrumentation",
+    `\u2713 ${counted(input.modules, "application module", "application modules")} observed`,
+    `\u2713 ${counted(input.functions, "function", "functions")} instrumented`,
+    `\u2713 ${counted(input.packageNames.length, "workspace package", "workspace packages")} detected`
+  ];
+  if (packages.length > 0 || mappingIssues.length > 0) {
+    lines.push("", "Package roots");
+    for (const mapping of packages) {
+      lines.push(
+        mapping.packageName ? `\u2713 ${mapping.packageName} \u2192 ${mapping.repositoryRoot}` : `\u2713 ${mapping.repositoryRoot}`
+      );
+    }
+    for (const [index, issue] of mappingIssues.entries()) {
+      if (packages.length > 0 || index > 0) lines.push("");
+      lines.push(...formatIssue(issue));
+    }
+  }
+  lines.push("", "Manifest");
+  if (!input.uploaded) {
+    lines.push("! upload failed");
+  } else {
+    lines.push("\u2713 uploaded");
+    lines.push(
+      verified ? "\u2713 verified against GitHub" : "! some source files could not be mapped to this Git release"
+    );
+  }
+  lines.push("", "GitHub");
+  if (!input.uploaded) {
+    lines.push("! not verified");
+  } else if (githubUnavailable) {
+    lines.push("! repository is not connected, or this release could not be read");
+  } else {
+    lines.push("\u2713 repository connected");
+  }
+  if (input.uploaded && input.verification.status !== "verified") {
+    lines.push("", "Runtime recording is unaffected.");
+  }
+  lines.push(RULE);
+  return lines.join("\n");
+};
+var runtimeLabel = () => {
+  const bun = globalThis.Bun;
+  if (typeof bun?.version === "string" && bun.version) return `Bun ${bun.version}`;
+  return `Node ${process.versions.node}`;
+};
+
 // src/auto-instrumentation/instrumentation-manifest-registry.ts
-import { isAbsolute as isAbsolute2, relative as relative2, resolve as resolve2, sep as sep2 } from "node:path";
+import { createHash } from "node:crypto";
+import {
+  INSTRUMENTATION_MANIFEST_SCHEMA_VERSION,
+  sourceLocatorFromFile as sourceLocatorFromFile2
+} from "@rasputin-ai/core";
 
 // src/execution-recorder/automatic-runtime.ts
-import { isAbsolute, relative, resolve, sep } from "node:path";
-var AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v1";
-var AUTOMATIC_SOURCE_SEPARATOR = "\0";
+import {
+  runtimeFunctionId,
+  sourceLocatorFromFile
+} from "@rasputin-ai/core";
+var AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v2";
+var AUTOMATIC_SOURCE_PREFIX = "rasputin-source-v2:";
 var runtimeSymbol = Symbol.for(AUTOMATIC_RUNTIME_SYMBOL);
-var normalizeAutomaticFunctionId = (sourceToken, repoRoot) => {
-  if (!sourceToken.includes(AUTOMATIC_SOURCE_SEPARATOR)) return sourceToken;
-  const [filePath, name, line, column] = sourceToken.split(AUTOMATIC_SOURCE_SEPARATOR);
-  if (!filePath || !name || !line || !column) return void 0;
-  const fromRoot = relative(repoRoot, resolve(filePath));
-  if (!fromRoot || fromRoot === ".." || fromRoot.startsWith(`..${sep}`) || isAbsolute(fromRoot)) {
+var decodeAutomaticFunctionSource = (sourceToken) => {
+  if (!sourceToken.startsWith(AUTOMATIC_SOURCE_PREFIX)) return void 0;
+  try {
+    const parsed = JSON.parse(
+      sourceToken.slice(AUTOMATIC_SOURCE_PREFIX.length)
+    );
+    if (typeof parsed.name !== "string" || !parsed.name) return void 0;
+    const definition = {
+      name: parsed.name,
+      ...parsed.source ? { source: parsed.source } : {}
+    };
+    return { ...definition, functionId: runtimeFunctionId(definition) };
+  } catch {
     return void 0;
   }
-  return `${fromRoot.replaceAll("\\", "/")}:${name}@${line}:${column}`;
 };
 var getRegistry = () => {
   const existing = Reflect.get(globalThis, runtimeSymbol);
@@ -32,30 +142,25 @@ var getRegistry = () => {
   const registry = {
     __rasputinRuntimeRegistry: true,
     runtimes,
-    run: (functionId, args, callback) => {
+    run: (sourceToken, args, callback) => {
       const runtime = runtimes.at(-1);
-      return runtime ? runtime.run(functionId, args, callback) : callback();
+      return runtime ? runtime.run(sourceToken, args, callback) : callback();
     }
   };
   Reflect.set(globalThis, runtimeSymbol, registry);
   return registry;
 };
-var installAutomaticExecutionRuntime = (execution, options = {}) => {
+var installAutomaticExecutionRuntime = (execution) => {
   const registry = getRegistry();
-  const repoRoot = options.repoRoot ? resolve(options.repoRoot) : void 0;
-  const normalizedIds = /* @__PURE__ */ new Map();
+  const definitions = /* @__PURE__ */ new Map();
   const runtime = {
     run: (sourceToken, args, callback) => {
-      if (!sourceToken.includes(AUTOMATIC_SOURCE_SEPARATOR)) {
-        return execution.runFunction(sourceToken, args, callback);
-      }
-      if (!repoRoot) return callback();
-      let functionId = normalizedIds.get(sourceToken);
-      if (!normalizedIds.has(sourceToken)) {
-        functionId = normalizeAutomaticFunctionId(sourceToken, repoRoot);
-        normalizedIds.set(sourceToken, functionId);
+      let definition = definitions.get(sourceToken);
+      if (!definitions.has(sourceToken)) {
+        definition = decodeAutomaticFunctionSource(sourceToken);
+        definitions.set(sourceToken, definition);
       }
-      return functionId ? execution.runFunction(functionId, args, callback) : callback();
+      return definition ? execution.runFunction(definition, args, callback) : callback();
     }
   };
   registry.runtimes.push(runtime);
@@ -66,7 +171,7 @@ var installAutomaticExecutionRuntime = (execution, options = {}) => {
 };
 
 // src/auto-instrumentation/instrumentation-manifest-registry.ts
-var INSTRUMENTATION_MANIFEST_SYMBOL = "rasputin.instrumentation.manifest.v1";
+var INSTRUMENTATION_MANIFEST_SYMBOL = "rasputin.instrumentation.manifest.v2";
 var registrySymbol = Symbol.for(INSTRUMENTATION_MANIFEST_SYMBOL);
 var getRegistry2 = () => {
   const existing = Reflect.get(globalThis, registrySymbol);
@@ -82,31 +187,28 @@ var getRegistry2 = () => {
   Reflect.set(globalThis, registrySymbol, registry);
   return registry;
 };
-var repoRelativePath = (filePath, repoRoot) => {
-  const fromRoot = relative2(repoRoot, resolve2(filePath));
-  if (!fromRoot || fromRoot === ".." || fromRoot.startsWith(`..${sep2}`) || isAbsolute2(fromRoot)) {
-    return void 0;
-  }
-  return fromRoot.replaceAll("\\", "/");
+var sourceAt = (filePath, line, column) => {
+  const source = sourceLocatorFromFile2(filePath);
+  return source ? { ...source, line, column } : void 0;
 };
+var stableId = (kind, ...parts) => `${kind}_${createHash("sha256").update(parts.join("\0")).digest("base64url").slice(0, 24)}`;
 var isInstrumentationManifestDirty = () => {
   const registry = getRegistry2();
   return registry.generation !== registry.uploadedGeneration && registry.files.size > 0;
 };
 var instrumentationManifestGeneration = () => getRegistry2().generation;
-var snapshotInstrumentationManifest = (repoRoot) => {
+var instrumentationManifestModuleCount = () => getRegistry2().files.size;
+var snapshotInstrumentationManifest = (options = {}) => {
   const functions = [];
   const callSites = [];
   const destructures = [];
-  const root = resolve2(repoRoot);
   for (const delta of getRegistry2().files.values()) {
     for (const fn of delta.functions) {
-      const functionId = normalizeAutomaticFunctionId(fn.sourceToken, root);
-      const path = repoRelativePath(fn.filePath, root);
-      if (!functionId || !path) continue;
+      const definition = decodeAutomaticFunctionSource(fn.sourceToken);
+      if (!definition?.source) continue;
       functions.push({
-        functionId,
-        path,
+        functionId: definition.functionId,
+        source: definition.source,
         name: fn.name,
         startLine: fn.startLine,
         startColumn: fn.startColumn,
@@ -116,15 +218,22 @@ var snapshotInstrumentationManifest = (repoRoot) => {
       });
     }
     for (const site of delta.callSites) {
-      const callerFunctionId = normalizeAutomaticFunctionId(site.callerSourceToken, root);
-      const path = repoRelativePath(site.filePath, root);
-      if (!callerFunctionId || !path) continue;
+      const caller = decodeAutomaticFunctionSource(site.callerSourceToken);
+      const source = sourceAt(site.filePath, site.line, site.column);
+      if (!caller || !source) continue;
       callSites.push({
-        id: `${path}:${site.line}:${site.column}`,
-        callerFunctionId,
+        id: stableId(
+          "cs",
+          caller.functionId,
+          source.packageName ?? "",
+          source.packageRelativePath,
+          site.line,
+          site.column
+        ),
+        callerFunctionId: caller.functionId,
         calleeName: site.calleeName,
         calleeText: site.calleeText,
-        path,
+        source,
         line: site.line,
         column: site.column,
         endLine: site.endLine,
@@ -134,13 +243,13 @@ var snapshotInstrumentationManifest = (repoRoot) => {
       });
     }
     for (const destructure of delta.destructures) {
-      const callerFunctionId = normalizeAutomaticFunctionId(destructure.callerSourceToken, root);
-      const path = repoRelativePath(destructure.filePath, root);
-      if (!callerFunctionId || !path) continue;
+      const caller = decodeAutomaticFunctionSource(destructure.callerSourceToken);
+      const source = sourceAt(destructure.filePath, destructure.line, destructure.column);
+      if (!caller || !source) continue;
       destructures.push({
-        callerFunctionId,
+        callerFunctionId: caller.functionId,
         sourceParam: destructure.sourceParam,
-        path,
+        source,
         line: destructure.line,
         column: destructure.column,
         binding: destructure.binding
@@ -150,8 +259,15 @@ var snapshotInstrumentationManifest = (repoRoot) => {
   if (functions.length === 0 && callSites.length === 0 && destructures.length === 0) {
     return void 0;
   }
+  const packages = { ...options.sourceRoots ?? {} };
   return {
-    schema_version: 1,
+    schema_version: INSTRUMENTATION_MANIFEST_SCHEMA_VERSION,
+    ...options.sourceRoot || Object.keys(packages).length > 0 ? {
+      sourceRoots: {
+        ...options.sourceRoot ? { default: options.sourceRoot } : {},
+        packages
+      }
+    } : {},
     functions,
     callSites,
     destructures
@@ -159,35 +275,63 @@ var snapshotInstrumentationManifest = (repoRoot) => {
 };
 var markInstrumentationManifestUploaded = (generation) => {
   const registry = getRegistry2();
-  if (registry.generation === generation) {
-    registry.uploadedGeneration = generation;
-  }
+  if (registry.generation === generation) registry.uploadedGeneration = generation;
 };
 var setInstrumentationManifestOnDirty = (onDirty) => {
   getRegistry2().onDirty = onDirty;
 };
 
 // src/auto-instrumentation/schedule-instrumentation-manifest-upload.ts
+var unavailable = () => ({
+  status: "unavailable",
+  verified: 0,
+  unresolved: [],
+  packages: []
+});
 var noopHandle = {
   flushSoon() {
   },
   async wait() {
   },
   disconnect() {
+  },
+  async verify() {
+    return unavailable();
   }
 };
 var scheduleInstrumentationManifestUpload = (options) => {
   const release = detectRelease({ release: options.release });
-  const repoRoot = options.repoRoot;
-  if (!options.enabled || !release || !repoRoot || !options.projectApiKey.trim()) {
+  if (!options.enabled || !release || !options.projectApiKey.trim()) {
     return noopHandle;
   }
   const { instrumentationManifestUrl } = resolveEndpointUrls(options.apiUrl);
   let inflight;
+  let verification = unavailable();
+  let loggedSuccess = false;
+  let loggedFailure = false;
+  const packageNamesOf = (manifest) => [
+    ...new Set(
+      manifest.functions.map((fn) => fn.source.packageName).filter((name) => Boolean(name))
+    )
+  ].sort();
+  const report = (manifest, uploaded, next) => {
+    return formatConfigurationReport({
+      release,
+      runtime: runtimeLabel(),
+      modules: instrumentationManifestModuleCount(),
+      functions: manifest.functions.length,
+      packageNames: packageNamesOf(manifest),
+      verification: next,
+      uploaded
+    });
+  };
   const flushSoon = () => {
     if (!isInstrumentationManifestDirty()) return;
     const generation = instrumentationManifestGeneration();
-    const manifest = snapshotInstrumentationManifest(repoRoot);
+    const manifest = snapshotInstrumentationManifest({
+      sourceRoot: options.sourceRoot,
+      sourceRoots: options.sourceRoots
+    });
     if (!manifest) {
       markInstrumentationManifestUploaded(generation);
       return;
@@ -199,7 +343,26 @@ var scheduleInstrumentationManifestUpload = (options) => {
       manifest,
       fetch: options.fetch
     }).then((result) => {
-      if (result === "ok") markInstrumentationManifestUploaded(generation);
+      if (result.ok) {
+        verification = result.verification;
+        markInstrumentationManifestUploaded(generation);
+        if (verification.status === "verified") {
+          if (!loggedSuccess && options.logSuccess !== false) {
+            loggedSuccess = true;
+            console.info(report(manifest, true, verification));
+          }
+          return;
+        }
+        if (!loggedFailure) {
+          loggedFailure = true;
+          console.warn(report(manifest, true, verification));
+        }
+        return;
+      }
+      if (!loggedFailure) {
+        loggedFailure = true;
+        console.warn(report(manifest, false, unavailable()));
+      }
     });
     inflight = inflight ? inflight.then(() => work) : work;
   };
@@ -212,12 +375,18 @@ var scheduleInstrumentationManifestUpload = (options) => {
     },
     disconnect: () => {
       setInstrumentationManifestOnDirty(void 0);
+    },
+    verify: async () => {
+      flushSoon();
+      await inflight;
+      return verification;
     }
   };
 };
 
 // src/execution-recorder/execution-recorder.ts
 import { AsyncLocalStorage } from "node:async_hooks";
+import { runtimeFunctionId as runtimeFunctionId2 } from "@rasputin-ai/core";
 
 // src/execution-recorder/call-aware-event-buffer.ts
 var CallAwareEventBuffer = class {
@@ -577,9 +746,10 @@ var safeSerializeWithBytes = (value, options = {}) => {
 var safeSerialize = (value, options = {}) => safeSerializeWithBytes(value, options).value;
 
 // src/execution-recorder/source-exclusions.ts
-var sourcePathFrom = (functionId) => {
-  const separator = functionId.indexOf(":");
-  return (separator < 0 ? functionId : functionId.slice(0, separator)).replaceAll("\\", "/");
+var sourcePathFrom = (definition) => definition.source?.packageRelativePath.replaceAll("\\", "/") ?? definition.name;
+var searchableIdentity = (definition) => {
+  const source = definition.source;
+  return source ? `${source.packageName ? `${source.packageName}:` : ""}${source.packageRelativePath}:${definition.name}@${source.line ?? ""}:${source.column ?? ""}` : definition.name;
 };
 var normalizePattern = (pattern) => pattern.trim().replaceAll("\\", "/").replace(/^\.\//, "").replace(/\/$/, "");
 var globRegex = (pattern) => {
@@ -610,35 +780,51 @@ var globRegex = (pattern) => {
   return new RegExp(`^${expression}$`);
 };
 var createSourceExclusionMatcher = (exclusions) => {
-  const matchers = (exclusions ?? []).flatMap((exclusion) => {
-    if (exclusion instanceof RegExp) {
+  const matchers = (exclusions ?? []).flatMap(
+    (exclusion) => {
+      if (exclusion instanceof RegExp) {
+        return [
+          (definition) => {
+            exclusion.lastIndex = 0;
+            const matched = exclusion.test(searchableIdentity(definition));
+            exclusion.lastIndex = 0;
+            return matched;
+          }
+        ];
+      }
+      const pattern = normalizePattern(exclusion);
+      if (!pattern) return [];
+      if (pattern.includes("*") || pattern.includes("?")) {
+        const regex = globRegex(pattern);
+        return [(definition) => regex.test(sourcePathFrom(definition))];
+      }
       return [
-        (functionId) => {
-          exclusion.lastIndex = 0;
-          const matched = exclusion.test(functionId);
-          exclusion.lastIndex = 0;
-          return matched;
+        (definition) => {
+          const sourcePath = sourcePathFrom(definition);
+          return sourcePath === pattern || sourcePath.startsWith(`${pattern}/`);
         }
       ];
     }
-    const pattern = normalizePattern(exclusion);
-    if (!pattern) return [];
-    if (pattern.includes("*") || pattern.includes("?")) {
-      const regex = globRegex(pattern);
-      return [(functionId) => regex.test(sourcePathFrom(functionId))];
-    }
-    return [
-      (functionId) => {
-        const sourcePath = sourcePathFrom(functionId);
-        return sourcePath === pattern || sourcePath.startsWith(`${pattern}/`);
-      }
-    ];
-  });
-  return matchers.length === 0 ? () => false : (functionId) => matchers.some((matcher) => matcher(functionId));
+  );
+  return matchers.length === 0 ? () => false : (definition) => matchers.some((matcher) => matcher(definition));
 };
 
 // src/execution-recorder/execution-recorder.ts
 var DEFAULT_MAX_ACTIVE_MEMORY_BYTES = 64 * 1024 * 1024;
+var manualFunctionDefinition = (value) => {
+  const located = /^(.+):([^:@]+)@(\d+):(\d+)$/.exec(value);
+  const named = located ? void 0 : /^(.+):([^:@]+)$/.exec(value);
+  const path = located?.[1] ?? named?.[1];
+  const name = located?.[2] ?? named?.[2] ?? value;
+  const source = path ? {
+    packageRelativePath: path.replaceAll("\\", "/").replace(/^\.\//, ""),
+    ...located?.[3] ? { line: Number(located[3]) } : {},
+    ...located?.[4] ? { column: Number(located[4]) } : {}
+  } : void 0;
+  const definition = { name, ...source ? { source } : {} };
+  return { ...definition, functionId: runtimeFunctionId2(definition) };
+};
+var normalizeFunctionDefinition = (value) => typeof value === "string" ? manualFunctionDefinition(value) : value;
 var elapsedMs = (startedAtNs, endedAtNs = process.hrtime.bigint()) => Number(endedAtNs - startedAtNs) / 1e6;
 var roundedMilliseconds = (nanoseconds) => Math.round(Number(nanoseconds) / 1e6 * 1e4) / 1e4;
 var addRecorderTime = (recording, nanoseconds) => {
@@ -773,8 +959,14 @@ var createExecutionRecorder = (options) => {
   const captureValue = (recording, value) => memoryBudget.captureValue(recording.memory, () => safeSerializeWithBytes(value, options));
   const stateFrom = (recording, endedAtNs = process.hrtime.bigint()) => {
     const recorderStartedAtNs = process.hrtime.bigint();
+    const events = recording.events.values().map((event) => event.type === "function_calls_suppressed" ? { ...event } : event);
+    const referencedFunctionIds = new Set(
+      events.flatMap(
+        (event) => event.type === "function_enter" || event.type === "function_calls_suppressed" ? [event.functionId] : []
+      )
+    );
     const state = {
-      version: 1,
+      version: 2,
       executionId: recording.executionId,
       startedAt: recording.startedAt,
       durationMs: elapsedMs(recording.startedAtNs, endedAtNs),
@@ -783,7 +975,10 @@ var createExecutionRecorder = (options) => {
         ...recording.execution,
         ...recording.execution.request ? { request: { ...recording.execution.request } } : {}
       },
-      events: recording.events.values().map((event) => event.type === "function_calls_suppressed" ? { ...event } : event),
+      functions: [...recording.functions.values()].filter(
+        (definition) => referencedFunctionIds.has(definition.functionId)
+      ),
+      events,
       ...recording.events.dropped > 0 ? { truncated: { eventsDropped: recording.events.dropped } } : {},
       ...recording.memory.underPressure ? {
         capture: {
@@ -925,6 +1120,7 @@ var createExecutionRecorder = (options) => {
           ...metadata.request ? { request: { ...metadata.request } } : {}
         },
         events: new CallAwareEventBuffer(maxEventsPerExecution),
+        functions: /* @__PURE__ */ new Map(),
         repeatedCalls: /* @__PURE__ */ new Map(),
         capturedErrors: /* @__PURE__ */ new WeakMap(),
         nextCallId: 0,
@@ -993,16 +1189,19 @@ var createExecutionRecorder = (options) => {
       return void 0;
     }
   };
-  const runFunction = (functionId, args, callback) => {
+  const runFunction = (input, args, callback) => {
     const store = storage.getStore();
     if (!store || store.recording.finished) return callback();
+    const definition = normalizeFunctionDefinition(input);
+    const functionId = definition.functionId;
     const recorderStartedAtNs = process.hrtime.bigint();
-    if (store.suppressCapture || excludesSource(functionId)) {
+    if (store.suppressCapture || excludesSource(definition)) {
       return storage.run({ ...store, suppressCapture: true }, () => {
         addRecorderTime(store.recording, process.hrtime.bigint() - recorderStartedAtNs);
         return callback();
       });
     }
+    store.recording.functions.set(functionId, definition);
     const parentCallId = store.currentCallId;
     const group = repeatedCallGroup(store.recording, functionId, parentCallId);
     group.observedCalls++;
@@ -1111,9 +1310,10 @@ var createExecutionRecorder = (options) => {
       )
     );
   };
-  function trace(functionId, fn) {
+  function trace(input, fn) {
+    const definition = typeof input === "string" ? manualFunctionDefinition(input) : { ...input, functionId: runtimeFunctionId2(input) };
     return function traced(...args) {
-      return runFunction(functionId, args, () => fn.apply(this, args));
+      return runFunction(definition, args, () => fn.apply(this, args));
     };
   }
   return {
@@ -1177,26 +1377,23 @@ var installGlobalHandlers = (client, options = {}) => {
 // src/rasputin-init.ts
 import {
   createClient,
-  isClientEnabled,
-  resolveRepoRoot
+  isClientEnabled
 } from "@rasputin-ai/core";
 
 // src/sdk-meta.ts
 var SDK_NAME = "@rasputin-ai/node";
-var SDK_VERSION = "0.3.0";
+var SDK_VERSION = "0.4.0";
 
 // src/rasputin-init.ts
-var withExecution = (client, execution, installRuntime, repoRoot, manifest) => {
-  const uninstallRuntime = installRuntime ? installAutomaticExecutionRuntime(execution, { repoRoot }) : () => {
+var withExecution = (client, execution, installRuntime, manifest) => {
+  const uninstallRuntime = installRuntime ? installAutomaticExecutionRuntime(execution) : () => {
   };
-  const manifestUpload = scheduleInstrumentationManifestUpload({
-    ...manifest,
-    repoRoot
-  });
+  const manifestUpload = scheduleInstrumentationManifestUpload(manifest);
   return {
     ...client,
     execution,
     getStats: () => ({ ...client.getStats(), recorder: execution.getStats() }),
+    verifyConfiguration: manifestUpload.verify,
     captureException: (error, context) => {
       const runtimeState = context?.runtimeState ?? execution.getErrorState(
         error,
@@ -1226,18 +1423,15 @@ var RasputinInit = (options) => {
       ...options.executionRecorder,
       enabled: recorderEnabled
     });
-    const wrappedClient = withExecution(
-      client,
-      execution,
-      recorderEnabled,
-      resolveRepoRoot(options),
-      {
-        projectApiKey: options.projectApiKey,
-        release: options.release,
-        apiUrl: options.apiUrl,
-        enabled: isClientEnabled(options)
-      }
-    );
+    const wrappedClient = withExecution(client, execution, recorderEnabled, {
+      projectApiKey: options.projectApiKey,
+      release: options.release,
+      apiUrl: options.apiUrl,
+      enabled: isClientEnabled(options),
+      sourceRoot: options.sourceRoot,
+      sourceRoots: options.sourceRoots,
+      logSuccess: options.logSuccess
+    });
     if (isClientEnabled(options)) {
       installGlobalHandlers(wrappedClient);
     }
@@ -1247,12 +1441,14 @@ var RasputinInit = (options) => {
       createClient({ ...options, enabled: false }),
       createExecutionRecorder({ enabled: false }),
       false,
-      void 0,
       {
         projectApiKey: options.projectApiKey,
         release: options.release,
         apiUrl: options.apiUrl,
-        enabled: false
+        enabled: false,
+        sourceRoot: options.sourceRoot,
+        sourceRoots: options.sourceRoots,
+        logSuccess: options.logSuccess
       }
     );
   }

package/dist/instrument/bun.js

@@ -3,22 +3,34 @@ import { plugin } from "bun";
 
 // src/auto-instrumentation/bun-plugin.ts
 import { readFile } from "node:fs/promises";
-import { resolve as resolve5 } from "node:path";
+import { resolve as resolve4 } from "node:path";
 
 // src/auto-instrumentation/instrumentation-manifest-registry.ts
-import { isAbsolute as isAbsolute2, relative as relative2, resolve as resolve2, sep as sep2 } from "node:path";
+import { resolve } from "node:path";
+import {
+  INSTRUMENTATION_MANIFEST_SCHEMA_VERSION,
+  sourceLocatorFromFile as sourceLocatorFromFile2
+} from "@rasputin-ai/core";
 
 // src/execution-recorder/automatic-runtime.ts
-import { isAbsolute, relative, resolve, sep } from "node:path";
-var AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v1";
-var AUTOMATIC_SOURCE_SEPARATOR = "\0";
+import {
+  runtimeFunctionId,
+  sourceLocatorFromFile
+} from "@rasputin-ai/core";
+var AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v2";
+var AUTOMATIC_SOURCE_PREFIX = "rasputin-source-v2:";
 var runtimeSymbol = Symbol.for(AUTOMATIC_RUNTIME_SYMBOL);
-var encodeAutomaticFunctionSource = (source) => [resolve(source.filePath), source.name, String(source.line), String(source.column)].join(
-  AUTOMATIC_SOURCE_SEPARATOR
-);
+var encodeAutomaticFunctionSource = (source) => {
+  const locator = sourceLocatorFromFile(source.filePath);
+  const value = {
+    name: source.name,
+    ...locator ? { source: { ...locator, line: source.line, column: source.column } } : {}
+  };
+  return `${AUTOMATIC_SOURCE_PREFIX}${JSON.stringify(value)}`;
+};
 
 // src/auto-instrumentation/instrumentation-manifest-registry.ts
-var INSTRUMENTATION_MANIFEST_SYMBOL = "rasputin.instrumentation.manifest.v1";
+var INSTRUMENTATION_MANIFEST_SYMBOL = "rasputin.instrumentation.manifest.v2";
 var registrySymbol = Symbol.for(INSTRUMENTATION_MANIFEST_SYMBOL);
 var getRegistry = () => {
   const existing = Reflect.get(globalThis, registrySymbol);
@@ -36,13 +48,13 @@ var getRegistry = () => {
 };
 var recordInstrumentationManifestDelta = (filePath, delta) => {
   const registry = getRegistry();
-  registry.files.set(resolve2(filePath), delta);
+  registry.files.set(resolve(filePath), delta);
   registry.generation += 1;
   registry.onDirty?.();
 };
 
 // src/auto-instrumentation/source-classification.ts
-import { isAbsolute as isAbsolute3, relative as relative3, resolve as resolve3, sep as sep3 } from "node:path";
+import { isAbsolute, relative, resolve as resolve2, sep } from "node:path";
 var sourceExtension = /\.[cm]?[jt]sx?$/i;
 var alwaysExcludedDirectory = /(^|[\\/])(node_modules|coverage|generated|\.git|\.next|\.svelte-kit|\.output|\.vercel|\.rasputin|\.turbo|\.yarn|\.pnpm|\.bun)([\\/]|$)/;
 var buildOutputDirectory = /(^|[\\/])(dist|build|out)([\\/]|$)/;
@@ -53,11 +65,11 @@ var matches = (pattern, value) => {
   return result;
 };
 var isWithinRoot = (filePath, root) => {
-  const fromRoot = relative3(resolve3(root), filePath);
-  return fromRoot === "" || !fromRoot.startsWith(`..${sep3}`) && fromRoot !== ".." && !isAbsolute3(fromRoot);
+  const fromRoot = relative(resolve2(root), filePath);
+  return fromRoot === "" || !fromRoot.startsWith(`..${sep}`) && fromRoot !== ".." && !isAbsolute(fromRoot);
 };
 var isApplicationSource = (filePath, options = {}) => {
-  const absolutePath = resolve3(filePath);
+  const absolutePath = resolve2(filePath);
   if (!sourceExtension.test(absolutePath) || alwaysExcludedDirectory.test(absolutePath))
     return false;
   if (options.includeBuildOutput !== true && buildOutputDirectory.test(absolutePath)) return false;
@@ -71,7 +83,7 @@ var isApplicationSource = (filePath, options = {}) => {
 };
 
 // src/auto-instrumentation/transform-source.ts
-import { resolve as resolve4 } from "node:path";
+import { resolve as resolve3 } from "node:path";
 import ts2 from "typescript";
 
 // src/auto-instrumentation/collect-instrumentation-delta.ts
@@ -348,7 +360,7 @@ var transformSource = (source, options) => {
   );
   let helperName = "__rasputinAutoRun__";
   while (source.includes(helperName)) helperName += "_";
-  const absolutePath = resolve4(options.filePath);
+  const absolutePath = resolve3(options.filePath);
   const edits = [];
   let order = 0;
   const delta = {
@@ -423,7 +435,7 @@ var loaderFor = (filePath) => {
 var loadedSourceFilter = /^(?!.*[\\/](?:node_modules|dist|build|out|coverage|generated|\.git|\.next|\.svelte-kit|\.output|\.vercel|\.rasputin|\.turbo|\.yarn|\.pnpm|\.bun)[\\/]).*\.[cm]?[jt]sx?$/i;
 var isLoadedApplicationSource = (filePath, options = {}) => isApplicationSource(filePath, { ...options, includeBuildOutput: false });
 var loadSourceForInstrumentation = async (filePath, options = {}) => {
-  const absolutePath = resolve5(filePath);
+  const absolutePath = resolve4(filePath);
   const source = await readFile(absolutePath, "utf8");
   if (!isLoadedApplicationSource(absolutePath, options)) {
     return { contents: source, loader: loaderFor(absolutePath), transformed: false };
@@ -449,11 +461,11 @@ var createRasputinBunPlugin = (options = {}) => {
     setup(build) {
       if (debug) {
         console.info(
-          options.rootDir ? `[rasputin] automatic instrumentation active (source root: ${resolve5(options.rootDir)})` : "[rasputin] automatic instrumentation active (loaded local source)"
+          options.rootDir ? `[rasputin] automatic instrumentation active (source root: ${resolve4(options.rootDir)})` : "[rasputin] automatic instrumentation active (loaded local source)"
         );
       }
       build.onLoad({ filter: loadedSourceFilter }, async ({ path }) => {
-        const absolutePath = resolve5(path);
+        const absolutePath = resolve4(path);
         const result = await loadSourceForInstrumentation(absolutePath, options);
         if (debug && result.transformed) {
           console.info(`[rasputin] instrumented ${absolutePath}`);
@@ -465,9 +477,9 @@ var createRasputinBunPlugin = (options = {}) => {
 };
 
 // src/auto-instrumentation/sdk-source-boundary.ts
-import { dirname, resolve as resolve6 } from "node:path";
+import { dirname, resolve as resolve5 } from "node:path";
 import { fileURLToPath } from "node:url";
-var sdkPackageScopeRootFrom = (instrumentEntryUrl) => resolve6(dirname(fileURLToPath(instrumentEntryUrl)), "../../..");
+var sdkPackageScopeRootFrom = (instrumentEntryUrl) => resolve5(dirname(fileURLToPath(instrumentEntryUrl)), "../../..");
 
 // src/instrument/bun.ts
 plugin(

package/dist/instrument/node.js

@@ -3,19 +3,31 @@ import * as nodeModule from "node:module";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/auto-instrumentation/instrumentation-manifest-registry.ts
-import { isAbsolute as isAbsolute2, relative as relative2, resolve as resolve2, sep as sep2 } from "node:path";
+import { resolve } from "node:path";
+import {
+  INSTRUMENTATION_MANIFEST_SCHEMA_VERSION,
+  sourceLocatorFromFile as sourceLocatorFromFile2
+} from "@rasputin-ai/core";
 
 // src/execution-recorder/automatic-runtime.ts
-import { isAbsolute, relative, resolve, sep } from "node:path";
-var AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v1";
-var AUTOMATIC_SOURCE_SEPARATOR = "\0";
+import {
+  runtimeFunctionId,
+  sourceLocatorFromFile
+} from "@rasputin-ai/core";
+var AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v2";
+var AUTOMATIC_SOURCE_PREFIX = "rasputin-source-v2:";
 var runtimeSymbol = Symbol.for(AUTOMATIC_RUNTIME_SYMBOL);
-var encodeAutomaticFunctionSource = (source) => [resolve(source.filePath), source.name, String(source.line), String(source.column)].join(
-  AUTOMATIC_SOURCE_SEPARATOR
-);
+var encodeAutomaticFunctionSource = (source) => {
+  const locator = sourceLocatorFromFile(source.filePath);
+  const value = {
+    name: source.name,
+    ...locator ? { source: { ...locator, line: source.line, column: source.column } } : {}
+  };
+  return `${AUTOMATIC_SOURCE_PREFIX}${JSON.stringify(value)}`;
+};
 
 // src/auto-instrumentation/instrumentation-manifest-registry.ts
-var INSTRUMENTATION_MANIFEST_SYMBOL = "rasputin.instrumentation.manifest.v1";
+var INSTRUMENTATION_MANIFEST_SYMBOL = "rasputin.instrumentation.manifest.v2";
 var registrySymbol = Symbol.for(INSTRUMENTATION_MANIFEST_SYMBOL);
 var getRegistry = () => {
   const existing = Reflect.get(globalThis, registrySymbol);
@@ -33,13 +45,13 @@ var getRegistry = () => {
 };
 var recordInstrumentationManifestDelta = (filePath, delta) => {
   const registry = getRegistry();
-  registry.files.set(resolve2(filePath), delta);
+  registry.files.set(resolve(filePath), delta);
   registry.generation += 1;
   registry.onDirty?.();
 };
 
 // src/auto-instrumentation/source-classification.ts
-import { isAbsolute as isAbsolute3, relative as relative3, resolve as resolve3, sep as sep3 } from "node:path";
+import { isAbsolute, relative, resolve as resolve2, sep } from "node:path";
 var sourceExtension = /\.[cm]?[jt]sx?$/i;
 var alwaysExcludedDirectory = /(^|[\\/])(node_modules|coverage|generated|\.git|\.next|\.svelte-kit|\.output|\.vercel|\.rasputin|\.turbo|\.yarn|\.pnpm|\.bun)([\\/]|$)/;
 var buildOutputDirectory = /(^|[\\/])(dist|build|out)([\\/]|$)/;
@@ -50,11 +62,11 @@ var matches = (pattern, value) => {
   return result;
 };
 var isWithinRoot = (filePath, root) => {
-  const fromRoot = relative3(resolve3(root), filePath);
-  return fromRoot === "" || !fromRoot.startsWith(`..${sep3}`) && fromRoot !== ".." && !isAbsolute3(fromRoot);
+  const fromRoot = relative(resolve2(root), filePath);
+  return fromRoot === "" || !fromRoot.startsWith(`..${sep}`) && fromRoot !== ".." && !isAbsolute(fromRoot);
 };
 var isApplicationSource = (filePath, options = {}) => {
-  const absolutePath = resolve3(filePath);
+  const absolutePath = resolve2(filePath);
   if (!sourceExtension.test(absolutePath) || alwaysExcludedDirectory.test(absolutePath))
     return false;
   if (options.includeBuildOutput !== true && buildOutputDirectory.test(absolutePath)) return false;
@@ -69,7 +81,7 @@ var isApplicationSource = (filePath, options = {}) => {
 
 // src/auto-instrumentation/source-map-locations.ts
 import { readFileSync } from "node:fs";
-import { dirname, isAbsolute as isAbsolute4, join, resolve as resolve4 } from "node:path";
+import { dirname, isAbsolute as isAbsolute2, join, resolve as resolve3 } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { LEAST_UPPER_BOUND, originalPositionFor, TraceMap } from "@jridgewell/trace-mapping";
 var sourceMapComment = /(?:\/\/[#@][ \t]*sourceMappingURL=([^\s'"]+)|\/\*[#@][ \t]*sourceMappingURL=([^\s*'"]+)[ \t]*\*\/)\s*$/;
@@ -86,7 +98,7 @@ var sourceMapFor = (generatedPath, source) => {
     const payload = decodeDataUrl(reference);
     return payload ? { payload, mapUrl: pathToFileURL(generatedPath).href } : void 0;
   }
-  const mapPath = reference ? resolve4(dirname(generatedPath), reference) : `${generatedPath}.map`;
+  const mapPath = reference ? resolve3(dirname(generatedPath), reference) : `${generatedPath}.map`;
   return {
     payload: readFileSync(mapPath, "utf8"),
     mapUrl: pathToFileURL(mapPath).href
@@ -94,7 +106,7 @@ var sourceMapFor = (generatedPath, source) => {
 };
 var toFilePath = (source, generatedPath) => {
   if (source.startsWith("file:")) return fileURLToPath(source);
-  return isAbsolute4(source) ? source : join(dirname(generatedPath), source);
+  return isAbsolute2(source) ? source : join(dirname(generatedPath), source);
 };
 var createSourceMapLocationMapper = (generatedPath, source) => {
   try {
@@ -126,7 +138,7 @@ var createSourceMapLocationMapper = (generatedPath, source) => {
 };
 
 // src/auto-instrumentation/transform-source.ts
-import { resolve as resolve5 } from "node:path";
+import { resolve as resolve4 } from "node:path";
 import ts2 from "typescript";
 
 // src/auto-instrumentation/collect-instrumentation-delta.ts
@@ -403,7 +415,7 @@ var transformSource = (source, options) => {
   );
   let helperName = "__rasputinAutoRun__";
   while (source.includes(helperName)) helperName += "_";
-  const absolutePath = resolve5(options.filePath);
+  const absolutePath = resolve4(options.filePath);
   const edits = [];
   let order = 0;
   const delta = {
@@ -522,9 +534,9 @@ var registerRasputinNodeHooks = (options = {}) => {
 };
 
 // src/auto-instrumentation/sdk-source-boundary.ts
-import { dirname as dirname2, resolve as resolve6 } from "node:path";
+import { dirname as dirname2, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
-var sdkPackageScopeRootFrom = (instrumentEntryUrl) => resolve6(dirname2(fileURLToPath3(instrumentEntryUrl)), "../../..");
+var sdkPackageScopeRootFrom = (instrumentEntryUrl) => resolve5(dirname2(fileURLToPath3(instrumentEntryUrl)), "../../..");
 
 // src/instrument/node.ts
 registerRasputinNodeHooks({

package/dist/rasputin-init.d.ts

@@ -3,7 +3,7 @@
  * recorder. Centralizing this wiring keeps initialization fail-safe and ensures every capture path
  * attaches runtime state using the same limits and lifecycle rules.
  */
-import { type RasputinClient, type RasputinClientStats, type RasputinOptions } from '@rasputin-ai/core';
+import { type RasputinClient, type RasputinClientStats, type RasputinOptions, type SourceVerification } from '@rasputin-ai/core';
 import { type ExecutionRecorderOptions, type ExecutionRecorderStats, type RasputinExecution } from './execution-recorder';
 export type RasputinNodeOptions = RasputinOptions & {
     /** Bounded runtime-state capture. Enabled by default; successful executions are discarded. */
@@ -16,6 +16,8 @@ export type RasputinNodeClientStats = RasputinClientStats & {
 export type RasputinNodeClient = Omit<RasputinClient, 'getStats'> & {
     execution: RasputinExecution;
     getStats: () => RasputinNodeClientStats;
+    /** Verify package source locators against the configured Git repository and exact release. */
+    verifyConfiguration: () => Promise<SourceVerification>;
 };
 /**
  * Boot the Node/Bun SDK: client + process global handlers.
@@ -27,7 +29,6 @@ export type RasputinNodeClient = Omit<RasputinClient, 'getStats'> & {
  *   release: process.env.RASPUTIN_RELEASE!,
  *   environment: process.env.NODE_ENV ?? 'development',
  *   enabled: ['staging', 'production'].includes(process.env.NODE_ENV ?? 'development'),
- *   moduleUrl: import.meta.url,
  * });
  */
 export declare const RasputinInit: (options: RasputinNodeOptions) => RasputinNodeClient;

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

@@ -1 +1 @@
-{"version":3,"file":"rasputin-init.d.ts","sourceRoot":"","sources":["../src/rasputin-init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAIN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EAEpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEN,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG;IACnD,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG;IAC3D,+EAA+E;IAC/E,QAAQ,EAAE,sBAAsB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IACnE,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,uBAAuB,CAAC;CACxC,CAAC;AAkDF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,mBAAmB,KAAG,kBA4C3D,CAAC"}
+{"version":3,"file":"rasputin-init.d.ts","sourceRoot":"","sources":["../src/rasputin-init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAIN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEN,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG;IACnD,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG;IAC3D,+EAA+E;IAC/E,QAAQ,EAAE,sBAAsB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IACnE,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,uBAAuB,CAAC;IACxC,8FAA8F;IAC9F,mBAAmB,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvD,CAAC;AAgDF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,mBAAmB,KAAG,kBA2C3D,CAAC"}

package/dist/sdk-meta.d.ts

@@ -1,4 +1,4 @@
-/** Generated by packages/sdk/scripts/generate-sdk-meta.ts — do not edit. */
+/** Generated by scripts/generate-sdk-meta.ts — do not edit. */
 export declare const SDK_NAME = "@rasputin-ai/node";
-export declare const SDK_VERSION = "0.3.0";
+export declare const SDK_VERSION = "0.4.0";
 //# sourceMappingURL=sdk-meta.d.ts.map

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

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

package/package.json

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