@rasputin-ai/node 0.1.4 → 0.3.0

package/README.md

@@ -1,33 +1,148 @@
-# Official Rasputin AI SDK for Node
+# Official Rasputin AI SDK for Node and Bun
 
-## Usage
+Report application errors to Rasputin.
+
+## Setup
+
+Initialize once when your application starts:
 
 ```ts
 import { RasputinInit } from '@rasputin-ai/node';
 
-const rasputin = RasputinInit({
+export const rasputin = RasputinInit({
   projectApiKey: process.env.RASPUTIN_PROJECT_API_KEY!,
+  release: process.env.RASPUTIN_RELEASE!,
   environment: process.env.NODE_ENV ?? 'development',
-  release: process.env.GIT_COMMIT,
+  enabled: ['staging', 'production'].includes(process.env.NODE_ENV ?? 'development'),
+  moduleUrl: import.meta.url,
 });
+```
 
+Uncaught exceptions and unhandled rejections are reported automatically.
+
+## Capture handled errors
+
+```ts
 try {
-  // ...
+  await processPayment();
 } catch (error) {
   rasputin.captureException(error);
 }
 ```
 
-Call `RasputinInit` once at process startup. Uncaught errors and unhandled rejections are captured automatically.
-
-For short-lived processes (scripts, serverless), call `await rasputin.flush()` before exit.
-
-## Options
+## Configuration
 
 | Field | Required | Description |
 | --- | --- | --- |
 | `projectApiKey` | yes | Project API key from the Rasputin dashboard |
-| `environment` | yes | Where errors occur, e.g. `production`, `staging` |
-| `release` | no | Deploy id (usually a git SHA). Auto-detected from common CI env vars when omitted |
-| `enabled` | no | Master switch. Default `true` |
-| `repoRoot` | no | Repo root for stack paths. |
+| `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 |
+
+## Shutdown
+
+Events are sent in the background. Flush before a short-lived process exits:
+
+```ts
+await rasputin.flush();
+```
+
+Call `await rasputin.close()` during graceful shutdown when the process stays alive afterward.
+
+---
+
+# Runtime recorder
+
+Optionally attach the runtime state that led to an error — arguments, return values, and call history from the failing execution.
+
+## Automatic instrumentation
+
+Start your process with the adapter for your runtime so Rasputin can instrument application functions as they load:
+
+```json
+{
+  "scripts": {
+    "start:node": "node --import @rasputin-ai/node/instrument/node dist/app.js",
+    "start:bun": "bun --preload @rasputin-ai/node/instrument/bun src/app.ts"
+  }
+}
+```
+
+Runtime state is retained only inside an active execution and attached when that execution throws.
+
+## Manual capture
+
+Wrap each meaningful unit of work — an HTTP request, background job, scheduled task, or worker iteration — in an execution:
+
+```ts
+await rasputin.execution.run({ kind: 'job', name: 'sync-invoices' }, async () => {
+  await syncInvoices();
+});
+```
+
+When automatic instrumentation is unavailable, mark individual functions explicitly:
+
+```ts
+const syncInvoices = rasputin.execution.trace(
+  'src/jobs/sync-invoices.ts:syncInvoices',
+  async () => {
+    // ...
+  },
+);
+```
+
+Framework packages such as `@rasputin-ai/elysia` create HTTP executions automatically.
+
+## Runtime support
+
+| Environment | Support |
+| --- | --- |
+| Bun 1.3.x | Supported for directly loaded JavaScript and TypeScript using `instrument/bun` |
+| Node.js 22.15 or newer | Supported for unbundled ESM/CJS JavaScript using `instrument/node`; Node 22 and 24 are the supported LTS lines |
+| TypeScript compiled to multiple JavaScript files | Supported on Node; emit adjacent source maps to retain original TypeScript locations |
+| Single-file bundles (esbuild, tsup, webpack, Vite SSR, Next.js) | Automatic instrumentation not supported |
+| `tsx`, custom Node loader stacks, and Node's native TypeScript execution | Automatic instrumentation not supported |
+| Deno and edge runtimes | Not supported |
+
+Tested on Bun 1.3.13, Node.js 24.19.0. Node.js 22.15.0 is the minimum for automatic instrumentation (synchronous module hooks). Use `execution.run()` and `execution.trace()` when automatic instrumentation is not available.
+
+## Recorder configuration
+
+Defaults work for most apps. Customize to exclude noisy sources, redact fields, or retain less state:
+
+| Field | Default | Description |
+| --- | ---: | --- |
+| `enabled` | `true` | Enables runtime-state capture |
+| `maxEventsPerExecution` | `500` | Maximum events retained for one execution |
+| `maxCapturedCallsPerFunction` | `3` | Detailed successful calls retained before similar calls are summarized |
+| `maxActiveMemoryBytes` | `64 MiB` | Maximum recorder memory shared across active executions |
+| `maxDepth` | `3` | Maximum captured value depth |
+| `maxObjectKeys` | `30` | Maximum properties retained from one object |
+| `maxArrayElements` | `20` | Maximum items retained from one array, map, or set |
+| `maxStringLength` | `500` | Maximum characters retained from one string |
+| `maxSerializedValueBytes` | `8 KiB` | Maximum retained size of one captured value |
+| `redactKeys` | `[]` | Additional case-insensitive property names to redact |
+| `excludeSources` | `[]` | Source globs or function-ID 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.

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

@@ -0,0 +1,23 @@
+import type { BunPlugin, Loader } from 'bun';
+export type RasputinBunInstrumentationOptions = {
+    /** Optional explicit source boundary. By default, all loaded local source is considered. */
+    rootDir?: string;
+    /** Further restrict loaded local source using its absolute runtime path. */
+    include?: RegExp;
+    /** Exclude loaded source using its absolute runtime path. */
+    exclude?: RegExp;
+    /** Internal package roots that must never be transformed, including workspace-linked SDKs. */
+    excludedRoots?: readonly string[];
+    debug?: boolean;
+};
+type InstrumentationLoadResult = {
+    contents: string;
+    loader: Loader;
+    transformed: boolean;
+};
+export declare const isLoadedApplicationSource: (filePath: string, options?: RasputinBunInstrumentationOptions) => boolean;
+/** Bun's runtime plugin loader requires an object even when a file is intentionally unchanged. */
+export declare const loadSourceForInstrumentation: (filePath: string, options?: RasputinBunInstrumentationOptions) => Promise<InstrumentationLoadResult>;
+export declare const createRasputinBunPlugin: (options?: RasputinBunInstrumentationOptions) => BunPlugin;
+export {};
+//# sourceMappingURL=bun-plugin.d.ts.map

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

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

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

@@ -0,0 +1,58 @@
+import type { InstrumentationArgIdentifier, InstrumentationParamBinding } from '@rasputin-ai/core';
+import ts from 'typescript';
+type SourceLocation = {
+    filePath: string;
+    line: number;
+    column: number;
+};
+type SourceLocationMapper = (location: SourceLocation) => SourceLocation | undefined;
+type RawManifestCallSite = {
+    callerSourceToken: string;
+    calleeName: string;
+    calleeText: string;
+    filePath: string;
+    line: number;
+    column: number;
+    endLine: number;
+    endColumn: number;
+    resultBinding: string | null;
+    argIdentifiers: InstrumentationArgIdentifier[];
+};
+type RawManifestDestructure = {
+    callerSourceToken: string;
+    sourceParam: string;
+    filePath: string;
+    line: number;
+    column: number;
+    binding: InstrumentationParamBinding;
+};
+type CollectContext = {
+    sourceFile: ts.SourceFile;
+    mapLocation?: SourceLocationMapper;
+    absolutePath: string;
+};
+export type RawManifestFunction = {
+    sourceToken: string;
+    filePath: string;
+    name: string;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+    params: InstrumentationParamBinding[];
+    paramNames: Set<string>;
+};
+export type InstrumentationManifestDelta = {
+    functions: RawManifestFunction[];
+    callSites: RawManifestCallSite[];
+    destructures: RawManifestDestructure[];
+};
+export declare const collectFunctionParams: (node: ts.FunctionLikeDeclaration, sourceFile: ts.SourceFile) => {
+    params: InstrumentationParamBinding[];
+    paramNames: Set<string>;
+};
+export declare const mappedLocation: (sourceFile: ts.SourceFile, position: number, absolutePath: string, mapLocation?: SourceLocationMapper) => SourceLocation | undefined;
+export declare const collectCallSite: (call: ts.CallExpression | ts.NewExpression, caller: RawManifestFunction, context: CollectContext) => RawManifestCallSite | null;
+export declare const collectParamDestructure: (declaration: ts.VariableDeclaration, caller: RawManifestFunction, context: CollectContext) => RawManifestDestructure | null;
+export {};
+//# sourceMappingURL=collect-instrumentation-delta.d.ts.map

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

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

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

@@ -0,0 +1,11 @@
+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 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 markInstrumentationManifestUploaded: (generation: number) => void;
+export declare const setInstrumentationManifestOnDirty: (onDirty?: () => void) => void;
+export declare const resetInstrumentationManifestRegistry: () => void;
+//# sourceMappingURL=instrumentation-manifest-registry.d.ts.map

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

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

package/dist/auto-instrumentation/node-hooks.d.ts

@@ -0,0 +1,6 @@
+export type RasputinNodeInstrumentationOptions = {
+    /** Internal package roots that must never be transformed, including workspace-linked SDKs. */
+    excludedRoots?: readonly string[];
+};
+export declare const registerRasputinNodeHooks: (options?: RasputinNodeInstrumentationOptions) => void;
+//# sourceMappingURL=node-hooks.d.ts.map

package/dist/auto-instrumentation/node-hooks.d.ts.map

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

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

@@ -0,0 +1,16 @@
+type ScheduleInstrumentationManifestUploadOptions = {
+    projectApiKey: string;
+    release?: string;
+    apiUrl?: string;
+    repoRoot?: string;
+    fetch?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+    enabled: boolean;
+};
+type InstrumentationManifestUploadHandle = {
+    flushSoon: () => void;
+    wait: () => Promise<void>;
+    disconnect: () => void;
+};
+export declare const scheduleInstrumentationManifestUpload: (options: ScheduleInstrumentationManifestUploadOptions) => InstrumentationManifestUploadHandle;
+export {};
+//# sourceMappingURL=schedule-instrumentation-manifest-upload.d.ts.map

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

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

package/dist/auto-instrumentation/sdk-source-boundary.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The source and built preload entries both live two directories below the Node package root.
+ * Excluding its parent protects every sibling Rasputin package when package managers resolve a
+ * workspace/link to physical source paths instead of a conventional node_modules/dist location.
+ */
+export declare const sdkPackageScopeRootFrom: (instrumentEntryUrl: string) => string;
+//# sourceMappingURL=sdk-source-boundary.d.ts.map

package/dist/auto-instrumentation/sdk-source-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-source-boundary.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/sdk-source-boundary.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,oBAAoB,MAAM,KAAG,MACL,CAAC"}

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

@@ -0,0 +1,10 @@
+export type ApplicationSourceOptions = {
+    rootDir?: string;
+    include?: RegExp;
+    exclude?: RegExp;
+    /** Physical package roots owned by the instrumentation runtime itself. */
+    excludedRoots?: readonly string[];
+    includeBuildOutput?: boolean;
+};
+export declare const isApplicationSource: (filePath: string, options?: ApplicationSourceOptions) => boolean;
+//# sourceMappingURL=source-classification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-classification.d.ts","sourceRoot":"","sources":["../../src/auto-instrumentation/source-classification.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,wBAAwB,GAAG;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAsBF,eAAO,MAAM,mBAAmB,GAC/B,UAAU,MAAM,EAChB,UAAS,wBAA6B,KACpC,OAcF,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { SourceLocationMapper } from './transform-source';
+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

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

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

@@ -0,0 +1,18 @@
+import { type InstrumentationManifestDelta } from './collect-instrumentation-delta';
+export type TransformSourceOptions = {
+    filePath: string;
+    mapLocation?: SourceLocationMapper;
+};
+export type TransformedSource = {
+    code: string;
+    delta: InstrumentationManifestDelta;
+};
+export type SourceLocation = {
+    filePath: string;
+    line: number;
+    column: number;
+};
+export type SourceLocationMapper = (location: SourceLocation) => SourceLocation | undefined;
+/** Add low-overhead function-boundary hooks while preserving the customer's source lines. */
+export declare const transformSource: (source: string, options: TransformSourceOptions) => TransformedSource | undefined;
+//# sourceMappingURL=transform-source.d.ts.map

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

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

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

@@ -0,0 +1,18 @@
+import type { RasputinExecution } from './execution-recorder-types';
+export declare const AUTOMATIC_RUNTIME_SYMBOL = "rasputin.execution.runtime.v1";
+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. */
+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 {};
+//# sourceMappingURL=automatic-runtime.d.ts.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * A plain capped array can retain only half of a call and produce a misleading tree. This buffer
+ * preserves enter/terminal pairs and valid parent links while evicting older completed leaves, which
+ * keeps truncated snapshots usable by investigations and source-addressable debugging UIs.
+ */
+import type { ExecutionEvent, ExecutionFunctionEnterEvent } from './execution-recorder-types';
+export declare class CallAwareEventBuffer {
+    private readonly capacity;
+    private readonly items;
+    private readonly openCallIds;
+    dropped: number;
+    constructor(capacity: number);
+    canStartCall(): boolean;
+    startCall(event: ExecutionFunctionEnterEvent): void;
+    finishCall(event: ExecutionEvent): void;
+    dropCall(): void;
+    append(event: ExecutionEvent): boolean;
+    forceCompletedCall(enter: ExecutionFunctionEnterEvent, terminal: ExecutionEvent): boolean;
+    values(): ExecutionEvent[];
+    contains(target: ExecutionEvent): boolean;
+    private evictCompletedLeafOrSummary;
+}
+//# sourceMappingURL=call-aware-event-buffer.d.ts.map

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * Public recorder contracts shared by runtime integrations and consumers. Keeping the execution and
+ * 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';
+export type ExecutionSourceExclusion = string | RegExp;
+export type ExecutionRecorderOptions = {
+    /** Disable runtime-state capture explicitly. It is enabled by SDK initializers by default. */
+    enabled?: boolean;
+    /** Maximum recent runtime events retained per active execution. Default: 500. */
+    maxEventsPerExecution?: number;
+    /** Successful calls retained per function and parent before repetitions are aggregated. Default: 3. */
+    maxCapturedCallsPerFunction?: number;
+    /**
+     * Process-wide estimated memory available to active execution recordings. Default: 64 MiB.
+     * When exhausted, capture degrades from values to call structure and finally metadata-only;
+     * the application is never blocked or crashed to preserve recorder completeness.
+     */
+    maxActiveMemoryBytes?: number;
+    /**
+     * Repo-relative files/directories to omit from runtime state. Strings support `*` and `**` globs;
+     * regular expressions match the complete function ID. Excluded calls suppress their nested subtree.
+     */
+    excludeSources?: ExecutionSourceExclusion[];
+    /** Additional object keys whose values should be redacted before capture. */
+    redactKeys?: string[];
+    maxDepth?: number;
+    maxObjectKeys?: number;
+    maxArrayElements?: number;
+    maxStringLength?: number;
+    maxSerializedValueBytes?: number;
+};
+export type ExecutionMetadata = RuntimeExecutionMetadata;
+export type ExecutionKind = RuntimeExecutionKind;
+export type ExecutionFunctionEnterEvent = RuntimeFunctionEnterEvent;
+export type ExecutionFunctionCallsSuppressedEvent = RuntimeFunctionCallsSuppressedEvent;
+export type ExecutionEvent = RuntimeExecutionEvent;
+export type ExecutionState = RuntimeExecutionState;
+export type ExecutionRecorderStats = {
+    errorSnapshots: number;
+    successfulExecutionsDiscarded: number;
+    truncatedEvents: number;
+    repeatedCallsSuppressed: number;
+    activeExecutions: number;
+    peakActiveExecutions: number;
+    activeEstimatedBytes: number;
+    peakActiveEstimatedBytes: number;
+    memoryPressureExecutions: number;
+    memoryPressureDegradations: number;
+    valuesDroppedByMemoryBudget: number;
+    eventsDroppedByMemoryBudget: number;
+    partialErrorSnapshots: number;
+};
+export type ExecutionScope = {
+    run: <T>(callback: () => T) => T;
+    getErrorState: (error: unknown, metadata?: Partial<ExecutionMetadata>) => ExecutionState | undefined;
+    finish: (metadata?: Partial<ExecutionMetadata>) => void;
+};
+export type RasputinExecution = {
+    createScope: (metadata: ExecutionMetadata) => ExecutionScope;
+    /** Define a logical non-HTTP execution such as a job, worker cycle, or scheduled task. */
+    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;
+    /** 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;
+    getStats: () => ExecutionRecorderStats;
+};
+//# sourceMappingURL=execution-recorder-types.d.ts.map

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

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

@@ -0,0 +1,4 @@
+import type { ExecutionRecorderOptions, RasputinExecution } from './execution-recorder-types';
+/** Bounded, error-only execution recorder for application functions. */
+export declare const createExecutionRecorder: (options: ExecutionRecorderOptions | undefined) => RasputinExecution;
+//# sourceMappingURL=execution-recorder.d.ts.map

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

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

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

@@ -0,0 +1,3 @@
+export { createExecutionRecorder } from './execution-recorder';
+export type { 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

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

package/dist/execution-recorder/recorder-memory-budget.d.ts

@@ -0,0 +1,37 @@
+import type { SafeSerializedValue } from './safe-serialize';
+type CaptureMode = 'full' | 'structure-only' | 'metadata-only';
+export type RecorderMemoryAllocation = {
+    mode: CaptureMode;
+    estimatedBytes: number;
+    released: boolean;
+    underPressure: boolean;
+    valuesDropped: number;
+    eventsDropped: number;
+};
+export type RecorderMemoryStats = {
+    activeEstimatedBytes: number;
+    peakActiveEstimatedBytes: number;
+    memoryPressureExecutions: number;
+    memoryPressureDegradations: number;
+    valuesDroppedByMemoryBudget: number;
+    eventsDroppedByMemoryBudget: number;
+};
+export declare class RecorderMemoryBudget {
+    private readonly maximumBytes;
+    private readonly maximumSerializedValueBytes;
+    private activeEstimatedBytes;
+    private readonly stats;
+    constructor(maximumBytes: number, maximumSerializedValueBytes: number);
+    startExecution(): RecorderMemoryAllocation;
+    captureValue(allocation: RecorderMemoryAllocation, serialize: () => SafeSerializedValue): unknown;
+    reserveCall(allocation: RecorderMemoryAllocation, functionId: string): boolean;
+    reserveStandaloneEvent(allocation: RecorderMemoryAllocation): boolean;
+    release(allocation: RecorderMemoryAllocation): void;
+    getStats(): RecorderMemoryStats;
+    private reserve;
+    private markPressure;
+    private dropValues;
+    private dropEvents;
+}
+export {};
+//# sourceMappingURL=recorder-memory-budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recorder-memory-budget.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/recorder-memory-budget.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAW5D,KAAK,WAAW,GAAG,MAAM,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAE/D,MAAM,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,wBAAwB,EAAE,MAAM,CAAC;IACjC,0BAA0B,EAAE,MAAM,CAAC;IACnC,2BAA2B,EAAE,MAAM,CAAC;IACpC,2BAA2B,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,qBAAa,oBAAoB;IAY/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,2BAA2B;IAZ7C,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAOpB;gBAGgB,YAAY,EAAE,MAAM,EACpB,2BAA2B,EAAE,MAAM;IAGrD,cAAc,IAAI,wBAAwB;IAwB1C,YAAY,CACX,UAAU,EAAE,wBAAwB,EACpC,SAAS,EAAE,MAAM,mBAAmB,GAClC,OAAO;IAuBV,WAAW,CAAC,UAAU,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAe9E,sBAAsB,CAAC,UAAU,EAAE,wBAAwB,GAAG,OAAO;IAarE,OAAO,CAAC,UAAU,EAAE,wBAAwB;IAQ5C,QAAQ,IAAI,mBAAmB;IAI/B,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,UAAU;CAIlB"}

package/dist/execution-recorder/safe-serialize.d.ts

@@ -0,0 +1,10 @@
+import type { ExecutionRecorderOptions } from './execution-recorder-types';
+export type SafeSerializedValue = {
+    value: unknown;
+    bytes: number;
+};
+/** Safely converts an arbitrary value and reports its bounded JSON byte size. */
+export declare const safeSerializeWithBytes: (value: unknown, options?: ExecutionRecorderOptions) => SafeSerializedValue;
+/** Safely converts an arbitrary value to bounded JSON-compatible data. */
+export declare const safeSerialize: (value: unknown, options?: ExecutionRecorderOptions) => unknown;
+//# sourceMappingURL=safe-serialize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safe-serialize.d.ts","sourceRoot":"","sources":["../../src/execution-recorder/safe-serialize.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AA4K3E,MAAM,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,sBAAsB,GAClC,OAAO,OAAO,EACd,UAAS,wBAA6B,KACpC,mBA+BF,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,EAAE,UAAS,wBAA6B,KAAG,OAC1C,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Source exclusions remove known-noisy utility subtrees before values are serialized. Doing this at
+ * 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 { 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);
+//# sourceMappingURL=source-exclusions.d.ts.map

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

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

package/dist/index.d.ts

@@ -1,5 +1,10 @@
 export type { CaptureContext, RasputinClient, RasputinOptions } from '@rasputin-ai/core';
+export { scheduleInstrumentationManifestUpload } from './auto-instrumentation/schedule-instrumentation-manifest-upload';
+export type { ExecutionKind, ExecutionMetadata, ExecutionRecorderOptions, ExecutionRecorderStats, ExecutionScope, ExecutionSourceExclusion, ExecutionState, RasputinExecution, } from './execution-recorder';
+export { createExecutionRecorder } from './execution-recorder';
+export { installAutomaticExecutionRuntime } from './execution-recorder/automatic-runtime';
 export type { InstallGlobalHandlersOptions } from './install-global-handlers';
 export { installGlobalHandlers } from './install-global-handlers';
+export type { RasputinNodeClient, RasputinNodeClientStats, RasputinNodeOptions, } from './rasputin-init';
 export { RasputinInit } from './rasputin-init';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzF,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,qCAAqC,EAAE,MAAM,iEAAiE,CAAC;AACxH,YAAY,EACX,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,cAAc,EACd,iBAAiB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAC;AAC1F,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EACX,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}