@rasputin-ai/node 0.5.0-alpha.13 → 0.5.0-alpha.14

package/dist/rasputin-init.d.ts

@@ -1,22 +1,42 @@
 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. */
+    /**
+     * Limits and redaction for the runtime recorder. Recording is on unless you
+     * set `enabled: false`. Successful requests and jobs are not kept.
+     */
     executionRecorder?: ExecutionRecorderOptions;
     /**
-     * Path to a build-time instrumentation manifest. Defaults to RASPUTIN_INSTRUMENTATION_MANIFEST
-     * or `.rasputin/instrumentation-manifest.json` in the current working directory.
+     * Path to the JSON file `rasputin-instrument` writes at build time.
+     * Defaults to `RASPUTIN_INSTRUMENTATION_MANIFEST`, or
+     * `.rasputin/instrumentation-manifest.json` in the current working directory.
      */
     instrumentationManifestPath?: string;
+    /**
+     * Observe `uncaughtException` / nonfatal `unhandledRejection`. Default true.
+     * Rasputin does not become the host crash/recovery owner: it exits only when
+     * it is the sole `uncaughtException` listener. Set false when the host owns
+     * process diagnostics.
+     */
+    installGlobalHandlers?: boolean;
+    /**
+     * Install SIGINT / SIGTERM / beforeExit flush hooks. Default true.
+     * Set false when the host owns process shutdown.
+     */
+    installTransportSignalHandlers?: boolean;
 };
 export type RasputinNodeClientStats = RasputinClientStats & {
-    /** Process-local recorder safety, truncation, and memory-pressure counters. */
+    /** What this process has recorded since it started. See `ExecutionRecorderStats`. */
     recorder: ExecutionRecorderStats;
 };
 export type RasputinNodeClient = Omit<RasputinClient, 'getStats'> & {
+    /** Wrap background jobs, inspect recorder stats, or mark functions by hand. */
     execution: RasputinExecution;
     getStats: () => RasputinNodeClientStats;
-    /** Verify package source locators against the configured Git repository and exact release. */
+    /**
+     * Check that every recorded source file maps to the Git commit in `release`.
+     * Call this from a deploy check, not on every request.
+     */
     verifyConfiguration: () => Promise<SourceVerification>;
 };
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"rasputin-init.d.ts","sourceRoot":"","sources":["../src/rasputin-init.ts"],"names":[],"mappings":"AAMA,OAAO,EAIN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,MAAM,mBAAmB,CAAC;AAG3B,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;IAC7C;;;OAGG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACrC,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,kBAiD3D,CAAC"}
+{"version":3,"file":"rasputin-init.d.ts","sourceRoot":"","sources":["../src/rasputin-init.ts"],"names":[],"mappings":"AAMA,OAAO,EAIN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAEN,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EACtB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG;IACnD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG;IAC3D,qFAAqF;IACrF,QAAQ,EAAE,sBAAsB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IACnE,+EAA+E;IAC/E,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,uBAAuB,CAAC;IACxC;;;OAGG;IACH,mBAAmB,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvD,CAAC;AA+DF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,mBAAmB,KAAG,kBAmE3D,CAAC"}

package/dist/sdk-meta.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rasputin-ai/node",
-	"version": "0.5.0-alpha.13",
+	"version": "0.5.0-alpha.14",
 	"description": "Official Rasputin AI SDK for Node and Bun.",
 	"type": "module",
 	"exports": {
@@ -23,6 +23,11 @@
 			"types": "./dist/instrument/build.d.ts",
 			"import": "./dist/instrument/build.js",
 			"default": "./dist/instrument/build.js"
+		},
+		"./internal": {
+			"types": "./dist/internal.d.ts",
+			"import": "./dist/internal.js",
+			"default": "./dist/internal.js"
 		}
 	},
 	"bin": {
@@ -44,7 +49,7 @@
 	},
 	"dependencies": {
 		"@jridgewell/trace-mapping": "0.3.31",
-		"@rasputin-ai/core": "0.5.0-alpha.13",
+		"@rasputin-ai/core": "0.5.0-alpha.14",
 		"typescript": "5"
 	},
 	"devDependencies": {

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

@@ -1,47 +0,0 @@
-/**
- * Walks a module's functions and decides what can be reconstructed later versus what must be
- * captured at runtime. The result is a derivation plan plus wrap sites the transformer injects, so
- * investigation can recover locals without recording every assignment in production.
- */
-import type { CaptureReason, DerivationPlan } from '@rasputin-ai/core';
-import ts from 'typescript';
-import { type FunctionCallEdge } from './build-dependency-graph';
-export type CaptureWrap = {
-    rootId: number;
-    reason: CaptureReason;
-    start: number;
-    end: number;
-    line: number;
-    column: number;
-    expressionId: number;
-    /** Object-literal shorthand must be expanded before its value can be wrapped. */
-    shorthandPropertyName?: string;
-};
-type NumericBinaryOp = 'add' | 'sub' | 'mul' | 'div' | 'mod';
-export type GuardWrap = {
-    fallbackRootId: number;
-    start: number;
-    end: number;
-    op: NumericBinaryOp;
-};
-export type AnalyzedFunction = {
-    functionId: string;
-    name: string;
-    node: ts.FunctionLikeDeclaration;
-    plan: DerivationPlan;
-    captureWraps: CaptureWrap[];
-    guardWraps: GuardWrap[];
-    callEdges: FunctionCallEdge[];
-    hasThrow: boolean;
-    hasCoercionGuard: boolean;
-};
-export type ModuleFunctionTarget = {
-    functionId: string;
-    name: string;
-    node: ts.FunctionLikeDeclaration & {
-        body: ts.ConciseBody;
-    };
-};
-export declare const analyzeModuleFunctions: (sourceFile: ts.SourceFile, targets: ModuleFunctionTarget[]) => AnalyzedFunction[];
-export {};
-//# sourceMappingURL=analyze-function.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"analyze-function.d.ts","sourceRoot":"","sources":["../../src/derivation/analyze-function.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACX,aAAa,EAGb,cAAc,EAGd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAEN,KAAK,gBAAgB,EAErB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,KAAK,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,eAAe,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC1B,CAAC;AAojBF,MAAM,MAAM,oBAAoB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,EAAE,CAAC,uBAAuB,GAAG;QAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAA;KAAE,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAClC,YAAY,EAAE,CAAC,UAAU,EACzB,SAAS,oBAAoB,EAAE,KAC7B,gBAAgB,EA2ClB,CAAC"}

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

@@ -1,26 +0,0 @@
-/**
- * Same-module calls can be inlined into a caller's derivation plan only after callees are proven
- * first. This graph and topological order let analysis reuse exact helper proofs instead of treating
- * every local call as opaque.
- */
-export type FunctionCallEdge = {
-    callerFunctionId: string;
-    calleeName: string;
-    calleeFunctionId?: string;
-};
-export type FunctionDependencyGraph = {
-    functions: string[];
-    edges: FunctionCallEdge[];
-    calleesByCaller: Map<string, string[]>;
-};
-/** Same-module identifier calls only. Anything else is treated as opaque at the call site. */
-export declare const buildDependencyGraph: (functions: Array<{
-    functionId: string;
-    name: string;
-}>, edges: FunctionCallEdge[]) => FunctionDependencyGraph;
-/** Callees before callers so purity proofs can be reused at call sites. */
-export declare const topologicalFunctionOrder: (functions: Array<{
-    functionId: string;
-    name: string;
-}>, graph: FunctionDependencyGraph) => string[];
-//# sourceMappingURL=build-dependency-graph.d.ts.map

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

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

package/dist/derivation/derivation-ir.d.ts

@@ -1,38 +0,0 @@
-/**
- * Derivation plans are a numbered expression graph, not the TypeScript AST. This builder assigns
- * stable ids as a function is analyzed so capture wraps and later investigation refer to the same
- * nodes. emptyPlan is the shell the analyzer fills with expressions, variables, and boundaries.
- */
-import type { DerivationBinaryOp, DerivationExpression, DerivationPlan, DerivationUnaryOp, PrimitiveConst } from '@rasputin-ai/core';
-export declare class DerivationIrBuilder {
-    readonly expressions: DerivationExpression[];
-    private nextId;
-    constValue(value: PrimitiveConst): number;
-    param(index: number): number;
-    root(rootId: number): number;
-    alias(from: number): number;
-    binary(op: DerivationBinaryOp, left: number, right: number, guard: 'numeric' | 'primitive' | 'none'): number;
-    unary(op: DerivationUnaryOp, operand: number): number;
-    logical(op: 'and' | 'or' | 'nullish', left: number, right: number): number;
-    cond(test: number, consequent: number, alternate: number): number;
-    object(properties: Array<{
-        key: string;
-        value: number;
-    }>): number;
-    array(elements: Array<number | {
-        kind: 'hole';
-    }>): number;
-    prop(object: number, key: string): number;
-    index(array: number, index: number): number;
-    pureCall(calleeFunctionId: string, args: number[]): number;
-    template(parts: Array<{
-        kind: 'lit';
-        value: string;
-    } | {
-        kind: 'expr';
-        expressionId: number;
-    }>): number;
-    private add;
-}
-export declare const emptyPlan: (functionId: string) => DerivationPlan;
-//# sourceMappingURL=derivation-ir.d.ts.map

package/dist/derivation/derivation-ir.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"derivation-ir.d.ts","sourceRoot":"","sources":["../../src/derivation/derivation-ir.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACX,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,mBAAmB;IAC/B,QAAQ,CAAC,WAAW,EAAE,oBAAoB,EAAE,CAAM;IAClD,OAAO,CAAC,MAAM,CAAK;IAEnB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAIzC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI5B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI3B,MAAM,CACL,EAAE,EAAE,kBAAkB,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,GACrC,MAAM;IAIT,KAAK,CAAC,EAAE,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAIrD,OAAO,CAAC,EAAE,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI1E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAIjE,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM;IAIjE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM;IAIzD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIzC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI3C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM;IAI1D,QAAQ,CACP,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,GACnF,MAAM;IAIT,OAAO,CAAC,GAAG;CAIX;AAED,eAAO,MAAM,SAAS,GAAI,YAAY,MAAM,KAAG,cAO7C,CAAC"}

package/dist/derivation/emit-capture-plan.d.ts

@@ -1,14 +0,0 @@
-/**
- * Turns capture boundaries from analysis into source edits. The transformer wraps those expressions
- * with a runtime capture call so the recorder stores a root instead of trying to reconstruct an
- * opaque or unknown value.
- */
-import type { CaptureWrap } from './analyze-function';
-type SourceEdit = {
-    position: number;
-    text: string;
-    order: number;
-};
-export declare const captureWrapEdits: (wraps: CaptureWrap[], capName: string) => SourceEdit[];
-export {};
-//# sourceMappingURL=emit-capture-plan.d.ts.map

package/dist/derivation/emit-capture-plan.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"emit-capture-plan.d.ts","sourceRoot":"","sources":["../../src/derivation/emit-capture-plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,KAAK,UAAU,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,eAAO,MAAM,gBAAgB,GAAI,OAAO,WAAW,EAAE,EAAE,SAAS,MAAM,KAAG,UAAU,EAgBlF,CAAC"}

package/dist/derivation/plan-is-exact.d.ts

@@ -1,7 +0,0 @@
-/**
- * A function is exact when nothing in its body needs a runtime root or control fact. Selective
- * capture uses this to omit helper argument and return snapshots when the parent can reconstruct them.
- */
-import type { DerivationPlan } from '@rasputin-ai/core';
-export declare const functionIsExact: (plan: DerivationPlan) => boolean;
-//# sourceMappingURL=plan-is-exact.d.ts.map

package/dist/derivation/plan-is-exact.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan-is-exact.d.ts","sourceRoot":"","sources":["../../src/derivation/plan-is-exact.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,eAAO,MAAM,eAAe,GAAI,MAAM,cAAc,KAAG,OAGxB,CAAC"}