@cloudwarriors-ai/rlm 0.1.5

package/dist/domain/types/context.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Metadata associated with context content
+ */
+export interface ContextMetadata {
+    /** Source type: file, string, url, etc. */
+    readonly source: ContextSource;
+    /** Original source path/url if applicable */
+    readonly sourcePath?: string;
+    /** MIME type if known */
+    readonly mimeType?: string;
+    /** Size in bytes */
+    readonly sizeBytes: number;
+    /** Estimated token count */
+    readonly estimatedTokens: number;
+    /** Timestamp when context was created */
+    readonly createdAt: Date;
+}
+export type ContextSource = 'file' | 'string' | 'url' | 'stdin' | 'variable';
+/**
+ * A named context variable available in the Python REPL
+ */
+export interface ContextVariable {
+    /** Variable name (valid Python identifier) */
+    readonly name: string;
+    /** The actual content */
+    readonly content: string;
+    /** Metadata about the content */
+    readonly metadata: ContextMetadata;
+}
+/**
+ * Input for creating context - more flexible than ContextVariable
+ */
+export interface ContextInput {
+    /** The content to process */
+    readonly content: string;
+    /** Optional name (defaults to 'context') */
+    readonly name?: string;
+    /** Optional source info */
+    readonly source?: ContextSource;
+    /** Optional source path */
+    readonly sourcePath?: string;
+}
+/**
+ * A chunk of context for processing
+ */
+export interface ContextChunk {
+    /** Chunk index (0-based) */
+    readonly index: number;
+    /** Total number of chunks */
+    readonly total: number;
+    /** The chunk content */
+    readonly content: string;
+    /** Start offset in original content */
+    readonly startOffset: number;
+    /** End offset in original content */
+    readonly endOffset: number;
+    /** Estimated tokens in this chunk */
+    readonly estimatedTokens: number;
+}
+/**
+ * Create a context variable from input
+ */
+export declare function createContextVariable(input: ContextInput, tokenEstimator: (text: string) => number): ContextVariable;
+//# sourceMappingURL=context.d.ts.map

package/dist/domain/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/domain/types/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAE/B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,oBAAoB;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,4BAA4B;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAEhC,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,wBAAwB;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,qCAAqC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACvC,eAAe,CAgBjB"}

package/dist/domain/types/context.js

@@ -0,0 +1,20 @@
+/**
+ * Create a context variable from input
+ */
+export function createContextVariable(input, tokenEstimator) {
+    const name = input.name ?? 'context';
+    const content = input.content;
+    const estimatedTokens = tokenEstimator(content);
+    return {
+        name,
+        content,
+        metadata: {
+            source: input.source ?? 'string',
+            sourcePath: input.sourcePath,
+            sizeBytes: Buffer.byteLength(content, 'utf-8'),
+            estimatedTokens,
+            createdAt: new Date(),
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/domain/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/domain/types/context.ts"],"names":[],"mappings":"AA+EA;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAmB,EACnB,cAAwC;IAExC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAEhD,OAAO;QACL,IAAI;QACJ,OAAO;QACP,QAAQ,EAAE;YACR,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,QAAQ;YAChC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;YAC9C,eAAe;YACf,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB;KACF,CAAC;AACJ,CAAC"}

package/dist/domain/types/index.d.ts

@@ -0,0 +1,5 @@
+export { type RLMConfig, type RLMConfigInput, type SandboxMode, DEFAULT_CONFIG, createConfig, } from './config.js';
+export { type ContextMetadata, type ContextSource, type ContextVariable, type ContextInput, type ContextChunk, createContextVariable, } from './context.js';
+export { type TokenUsage, type ResourceUsage, type ExecutionStep, type ExecutionStepType, type ExecutionStepDetails, type LLMCallDetails, type CodeGenerationDetails, type CodeExecutionDetails, type RecursiveCallDetails, type ResultAggregationDetails, type ExecutionTrace, type RecoveredError, type RecursiveCallResult, type RLMResult, createEmptyUsage, mergeUsage, } from './result.js';
+export { type SessionStatus, type RLMSession, type SessionState, createSessionState, stateToUsage, } from './session.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/types/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,gBAAgB,EAChB,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,kBAAkB,EAClB,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/domain/types/index.js

@@ -0,0 +1,9 @@
+// Configuration types
+export { DEFAULT_CONFIG, createConfig, } from './config.js';
+// Context types
+export { createContextVariable, } from './context.js';
+// Result types
+export { createEmptyUsage, mergeUsage, } from './result.js';
+// Session types
+export { createSessionState, stateToUsage, } from './session.js';
+//# sourceMappingURL=index.js.map

package/dist/domain/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/types/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,OAAO,EAIL,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,gBAAgB;AAChB,OAAO,EAML,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,eAAe;AACf,OAAO,EAeL,gBAAgB,EAChB,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,gBAAgB;AAChB,OAAO,EAIL,kBAAkB,EAClB,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/domain/types/result.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Token usage statistics
+ */
+export interface TokenUsage {
+    /** Input tokens (prompt) */
+    readonly promptTokens: number;
+    /** Output tokens (completion) */
+    readonly completionTokens: number;
+    /** Total tokens */
+    readonly totalTokens: number;
+}
+/**
+ * Resource usage for a session
+ */
+export interface ResourceUsage {
+    /** Total tokens used across all calls */
+    readonly totalTokens: number;
+    /** Cost in USD */
+    readonly costUsd: number;
+    /** Number of LLM calls made */
+    readonly llmCalls: number;
+    /** Number of recursive calls */
+    readonly recursiveCalls: number;
+    /** Maximum recursion depth reached */
+    readonly maxDepthReached: number;
+    /** Total execution time in milliseconds */
+    readonly executionTimeMs: number;
+}
+/**
+ * A single step in the execution trace
+ */
+export interface ExecutionStep {
+    /** Step index */
+    readonly index: number;
+    /** Recursion depth at this step */
+    readonly depth: number;
+    /** Type of step */
+    readonly type: ExecutionStepType;
+    /** Timestamp when step started */
+    readonly startedAt: Date;
+    /** Timestamp when step completed */
+    readonly completedAt: Date;
+    /** Duration in milliseconds */
+    readonly durationMs: number;
+    /** Details specific to step type */
+    readonly details: ExecutionStepDetails;
+}
+export type ExecutionStepType = 'llm_call' | 'code_generation' | 'code_execution' | 'recursive_call' | 'result_aggregation';
+export type ExecutionStepDetails = LLMCallDetails | CodeGenerationDetails | CodeExecutionDetails | RecursiveCallDetails | ResultAggregationDetails;
+export interface LLMCallDetails {
+    readonly type: 'llm_call';
+    readonly model: string;
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly cost: number;
+}
+export interface CodeGenerationDetails {
+    readonly type: 'code_generation';
+    readonly codeLength: number;
+    readonly codePreview: string;
+}
+export interface CodeExecutionDetails {
+    readonly type: 'code_execution';
+    readonly success: boolean;
+    readonly output?: string;
+    readonly error?: string;
+}
+export interface RecursiveCallDetails {
+    readonly type: 'recursive_call';
+    readonly query: string;
+    readonly contextSize: number;
+    readonly depth: number;
+}
+export interface ResultAggregationDetails {
+    readonly type: 'result_aggregation';
+    readonly resultCount: number;
+    readonly combinedLength: number;
+}
+/**
+ * Execution trace for debugging and analysis
+ */
+export interface ExecutionTrace {
+    /** All execution steps */
+    readonly steps: readonly ExecutionStep[];
+    /** Any warnings during execution */
+    readonly warnings: readonly string[];
+    /** Any errors that were recovered from */
+    readonly recoveredErrors: readonly RecoveredError[];
+}
+export interface RecoveredError {
+    readonly stepIndex: number;
+    readonly error: string;
+    readonly recovery: string;
+}
+/**
+ * Result of a single recursive call
+ */
+export interface RecursiveCallResult {
+    /** The query that was executed */
+    readonly query: string;
+    /** The answer/result */
+    readonly answer: string;
+    /** Depth at which this call was made */
+    readonly depth: number;
+    /** Token usage for this call */
+    readonly usage: TokenUsage;
+    /** Child call results */
+    readonly children: readonly RecursiveCallResult[];
+}
+/**
+ * Final result of an RLM query
+ */
+export interface RLMResult {
+    /** Session ID */
+    readonly sessionId: string;
+    /** The final answer */
+    readonly answer: string;
+    /** Whether the query completed successfully */
+    readonly success: boolean;
+    /** Error message if not successful */
+    readonly error?: string;
+    /** Full execution trace */
+    readonly trace: ExecutionTrace;
+    /** Resource usage statistics */
+    readonly usage: ResourceUsage;
+    /** Timestamp when completed */
+    readonly completedAt: Date;
+}
+/**
+ * Create an empty resource usage object
+ */
+export declare function createEmptyUsage(): ResourceUsage;
+/**
+ * Merge two resource usage objects
+ */
+export declare function mergeUsage(a: ResourceUsage, b: ResourceUsage): ResourceUsage;
+//# sourceMappingURL=result.d.ts.map

package/dist/domain/types/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/domain/types/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,iCAAiC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,mBAAmB;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,gCAAgC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,sCAAsC;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,2CAA2C;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAEjC,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAEzB,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAE3B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AAED,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,qBAAqB,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,wBAAwB,CAAC;AAE7B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAEzC,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAErC,0CAA0C;IAC1C,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAShD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,aAAa,CAS5E"}

package/dist/domain/types/result.js

@@ -0,0 +1,27 @@
+/**
+ * Create an empty resource usage object
+ */
+export function createEmptyUsage() {
+    return {
+        totalTokens: 0,
+        costUsd: 0,
+        llmCalls: 0,
+        recursiveCalls: 0,
+        maxDepthReached: 0,
+        executionTimeMs: 0,
+    };
+}
+/**
+ * Merge two resource usage objects
+ */
+export function mergeUsage(a, b) {
+    return {
+        totalTokens: a.totalTokens + b.totalTokens,
+        costUsd: a.costUsd + b.costUsd,
+        llmCalls: a.llmCalls + b.llmCalls,
+        recursiveCalls: a.recursiveCalls + b.recursiveCalls,
+        maxDepthReached: Math.max(a.maxDepthReached, b.maxDepthReached),
+        executionTimeMs: a.executionTimeMs + b.executionTimeMs,
+    };
+}
+//# sourceMappingURL=result.js.map

package/dist/domain/types/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/domain/types/result.ts"],"names":[],"mappings":"AAiLA;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,WAAW,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC;QACX,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;KACnB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,CAAgB,EAAE,CAAgB;IAC3D,OAAO;QACL,WAAW,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;QAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;QAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ;QACjC,cAAc,EAAE,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc;QACnD,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,eAAe,CAAC;QAC/D,eAAe,EAAE,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe;KACvD,CAAC;AACJ,CAAC"}

package/dist/domain/types/session.d.ts

@@ -0,0 +1,74 @@
+import type { RLMConfig } from './config.js';
+import type { ContextVariable } from './context.js';
+import type { ResourceUsage, ExecutionTrace, RLMResult } from './result.js';
+/**
+ * Status of an RLM session
+ */
+export type SessionStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'timeout';
+/**
+ * An RLM session representing a complete query execution
+ */
+export interface RLMSession {
+    /** Unique session ID */
+    readonly id: string;
+    /** The original query */
+    readonly query: string;
+    /** Initial context variables */
+    readonly context: readonly ContextVariable[];
+    /** Configuration for this session */
+    readonly config: RLMConfig;
+    /** Current status */
+    readonly status: SessionStatus;
+    /** Current recursion depth */
+    readonly currentDepth: number;
+    /** Running resource usage */
+    readonly usage: ResourceUsage;
+    /** Execution trace so far */
+    readonly trace: ExecutionTrace;
+    /** Timestamp when session was created */
+    readonly createdAt: Date;
+    /** Timestamp when session started executing */
+    readonly startedAt?: Date;
+    /** Timestamp when session completed */
+    readonly completedAt?: Date;
+    /** Final result if completed */
+    readonly result?: RLMResult;
+    /** Error message if failed */
+    readonly error?: string;
+    /** Cancellation requested */
+    readonly cancellationRequested: boolean;
+}
+/**
+ * Mutable session state for internal tracking during execution
+ */
+export interface SessionState {
+    /** Session ID */
+    sessionId: string;
+    /** Current depth */
+    currentDepth: number;
+    /** Accumulated tokens */
+    totalTokens: number;
+    /** Accumulated cost */
+    totalCostUsd: number;
+    /** Number of LLM calls */
+    llmCalls: number;
+    /** Number of recursive calls */
+    recursiveCalls: number;
+    /** Maximum depth reached */
+    maxDepthReached: number;
+    /** Start time */
+    startTime: number;
+    /** Whether cancellation has been requested */
+    cancellationRequested: boolean;
+    /** Python variables currently in scope */
+    pythonVariables: Map<string, string>;
+}
+/**
+ * Create initial session state
+ */
+export declare function createSessionState(sessionId: string): SessionState;
+/**
+ * Convert session state to resource usage
+ */
+export declare function stateToUsage(state: SessionState): ResourceUsage;
+//# sourceMappingURL=session.d.ts.map

package/dist/domain/types/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/domain/types/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,gCAAgC;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAE7C,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAE3B,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAE/B,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAEzB,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAE1B,uCAAuC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAE5B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAE5B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,6BAA6B;IAC7B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IAEpB,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;IAErB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IAEvB,4BAA4B;IAC5B,eAAe,EAAE,MAAM,CAAC;IAExB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,8CAA8C;IAC9C,qBAAqB,EAAE,OAAO,CAAC;IAE/B,0CAA0C;IAC1C,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAalE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAS/D"}

package/dist/domain/types/session.js

@@ -0,0 +1,31 @@
+/**
+ * Create initial session state
+ */
+export function createSessionState(sessionId) {
+    return {
+        sessionId,
+        currentDepth: 0,
+        totalTokens: 0,
+        totalCostUsd: 0,
+        llmCalls: 0,
+        recursiveCalls: 0,
+        maxDepthReached: 0,
+        startTime: Date.now(),
+        cancellationRequested: false,
+        pythonVariables: new Map(),
+    };
+}
+/**
+ * Convert session state to resource usage
+ */
+export function stateToUsage(state) {
+    return {
+        totalTokens: state.totalTokens,
+        costUsd: state.totalCostUsd,
+        llmCalls: state.llmCalls,
+        recursiveCalls: state.recursiveCalls,
+        maxDepthReached: state.maxDepthReached,
+        executionTimeMs: Date.now() - state.startTime,
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/domain/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/domain/types/session.ts"],"names":[],"mappings":"AAiGA;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO;QACL,SAAS;QACT,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,QAAQ,EAAE,CAAC;QACX,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,CAAC;QAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,qBAAqB,EAAE,KAAK;QAC5B,eAAe,EAAE,IAAI,GAAG,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,YAAY;QAC3B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS;KAC9C,CAAC;AACJ,CAAC"}

package/dist/factory/create-rlm.d.ts

@@ -0,0 +1,77 @@
+import type { EventEmitter } from 'node:events';
+import type { RLMConfigInput } from '../domain/types/config.js';
+import type { ISessionStore } from '../domain/interfaces/session-store.js';
+import type { IEventEmitter } from '../domain/interfaces/event-emitter.js';
+import { RLMService } from '../application/rlm-service.js';
+/**
+ * Options for creating an RLM instance
+ */
+export interface CreateRLMOptions {
+    /**
+     * OpenRouter API key
+     * If not provided, will look for OPENROUTER_API_KEY environment variable
+     */
+    readonly apiKey?: string;
+    /**
+     * LLM model to use
+     * @default 'anthropic/claude-sonnet-4'
+     */
+    readonly model?: string;
+    /**
+     * Configuration overrides
+     */
+    readonly config?: RLMConfigInput;
+    /**
+     * Custom session store
+     * If not provided, uses in-memory store
+     */
+    readonly sessionStore?: ISessionStore;
+    /**
+     * Custom event emitter
+     * If not provided, uses a no-op emitter
+     */
+    readonly eventEmitter?: IEventEmitter;
+    /**
+     * External Node.js EventEmitter to use for events
+     * Alternative to providing a custom IEventEmitter
+     */
+    readonly eventBus?: EventEmitter;
+    /**
+     * Whether to include environment variables in config resolution
+     * @default true
+     */
+    readonly includeEnv?: boolean;
+    /**
+     * Site URL for OpenRouter analytics
+     */
+    readonly siteUrl?: string;
+    /**
+     * Site name for OpenRouter analytics
+     */
+    readonly siteName?: string;
+}
+/**
+ * Create an RLM service instance
+ *
+ * This is the main entry point for using RLM.
+ *
+ * @example
+ * ```typescript
+ * import { createRLM } from '@cloudwarriors-ai/rlm';
+ *
+ * const rlm = createRLM({
+ *   apiKey: process.env.OPENROUTER_API_KEY,
+ *   model: 'anthropic/claude-sonnet-4',
+ * });
+ *
+ * const result = await rlm.query(
+ *   fs.readFileSync('./large-file.txt', 'utf-8'),
+ *   'Summarize the main points'
+ * );
+ *
+ * console.log(result.answer);
+ * console.log(`Cost: $${result.usage.costUsd.toFixed(4)}`);
+ * ```
+ */
+export declare function createRLM(options?: CreateRLMOptions): RLMService;
+//# sourceMappingURL=create-rlm.d.ts.map

package/dist/factory/create-rlm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-rlm.d.ts","sourceRoot":"","sources":["../../src/factory/create-rlm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAQ3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,UAAU,CA4DpE"}

package/dist/factory/create-rlm.js

@@ -0,0 +1,82 @@
+import { RLMService } from '../application/rlm-service.js';
+import { OpenRouterProvider } from '../infrastructure/llm/openrouter-provider.js';
+import { PythonExecutor } from '../infrastructure/sandbox/python-executor.js';
+import { MemorySessionStore } from '../infrastructure/persistence/memory-store.js';
+import { NodeEventEmitter, NoopEventEmitter } from '../infrastructure/events/node-emitter.js';
+import { resolveConfig, validateConfig, ENV_VARS } from './default-config.js';
+import { ConfigurationError } from '../domain/errors/index.js';
+/**
+ * Create an RLM service instance
+ *
+ * This is the main entry point for using RLM.
+ *
+ * @example
+ * ```typescript
+ * import { createRLM } from '@cloudwarriors-ai/rlm';
+ *
+ * const rlm = createRLM({
+ *   apiKey: process.env.OPENROUTER_API_KEY,
+ *   model: 'anthropic/claude-sonnet-4',
+ * });
+ *
+ * const result = await rlm.query(
+ *   fs.readFileSync('./large-file.txt', 'utf-8'),
+ *   'Summarize the main points'
+ * );
+ *
+ * console.log(result.answer);
+ * console.log(`Cost: $${result.usage.costUsd.toFixed(4)}`);
+ * ```
+ */
+export function createRLM(options = {}) {
+    // Resolve API key
+    const apiKey = options.apiKey ?? process.env[ENV_VARS.OPENROUTER_API_KEY];
+    if (!apiKey) {
+        throw new ConfigurationError('OpenRouter API key is required. Set OPENROUTER_API_KEY environment variable or pass apiKey option.', 'apiKey');
+    }
+    // Resolve config
+    const includeEnv = options.includeEnv ?? true;
+    const userConfig = {
+        ...options.config,
+        model: options.model ?? options.config?.model,
+    };
+    const config = resolveConfig(userConfig, includeEnv);
+    // Validate config
+    const configErrors = validateConfig(config);
+    if (configErrors.length > 0) {
+        throw new ConfigurationError(`Invalid configuration: ${configErrors.join(', ')}`);
+    }
+    // Create LLM provider
+    const llmProvider = new OpenRouterProvider({
+        apiKey,
+        model: config.model,
+        siteUrl: options.siteUrl,
+        siteName: options.siteName ?? 'RLM',
+    });
+    // Create code executor
+    const codeExecutor = new PythonExecutor({
+        strictMode: config.sandboxMode === 'strict',
+    });
+    // Resolve session store
+    const sessionStore = options.sessionStore ?? new MemorySessionStore();
+    // Resolve event emitter
+    let eventEmitter;
+    if (options.eventEmitter) {
+        eventEmitter = options.eventEmitter;
+    }
+    else if (options.eventBus) {
+        eventEmitter = new NodeEventEmitter(options.eventBus);
+    }
+    else {
+        eventEmitter = new NoopEventEmitter();
+    }
+    // Create and return service
+    return new RLMService({
+        llmProvider,
+        codeExecutor,
+        sessionStore,
+        eventEmitter,
+        config,
+    });
+}
+//# sourceMappingURL=create-rlm.js.map

package/dist/factory/create-rlm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-rlm.js","sourceRoot":"","sources":["../../src/factory/create-rlm.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AA0D/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,SAAS,CAAC,UAA4B,EAAE;IACtD,kBAAkB;IAClB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,kBAAkB,CAC1B,oGAAoG,EACpG,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC9C,MAAM,UAAU,GAAmB;QACjC,GAAG,OAAO,CAAC,MAAM;QACjB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,KAAK;KAC9C,CAAC;IACF,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAErD,kBAAkB;IAClB,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,kBAAkB,CAC1B,0BAA0B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpD,CAAC;IACJ,CAAC;IAED,sBAAsB;IACtB,MAAM,WAAW,GAAG,IAAI,kBAAkB,CAAC;QACzC,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;KACpC,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,YAAY,GAAG,IAAI,cAAc,CAAC;QACtC,UAAU,EAAE,MAAM,CAAC,WAAW,KAAK,QAAQ;KAC5C,CAAC,CAAC;IAEH,wBAAwB;IACxB,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,kBAAkB,EAAE,CAAC;IAEtE,wBAAwB;IACxB,IAAI,YAA2B,CAAC;IAChC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACtC,CAAC;SAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC5B,YAAY,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,YAAY,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACxC,CAAC;IAED,4BAA4B;IAC5B,OAAO,IAAI,UAAU,CAAC;QACpB,WAAW;QACX,YAAY;QACZ,YAAY;QACZ,YAAY;QACZ,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/factory/default-config.d.ts

@@ -0,0 +1,27 @@
+import type { RLMConfig, RLMConfigInput } from '../domain/types/config.js';
+/**
+ * Environment variable names for configuration
+ */
+export declare const ENV_VARS: {
+    readonly OPENROUTER_API_KEY: "OPENROUTER_API_KEY";
+    readonly RLM_MODEL: "RLM_MODEL";
+    readonly RLM_MAX_DEPTH: "RLM_MAX_DEPTH";
+    readonly RLM_MAX_COST_USD: "RLM_MAX_COST_USD";
+    readonly RLM_MAX_TOKENS: "RLM_MAX_TOKENS";
+    readonly RLM_TIMEOUT_SECONDS: "RLM_TIMEOUT_SECONDS";
+    readonly RLM_SANDBOX_MODE: "RLM_SANDBOX_MODE";
+    readonly RLM_TEMPERATURE: "RLM_TEMPERATURE";
+};
+/**
+ * Load configuration from environment variables
+ */
+export declare function loadConfigFromEnv(): RLMConfigInput;
+/**
+ * Resolve configuration with defaults and environment
+ */
+export declare function resolveConfig(userConfig?: RLMConfigInput, includeEnv?: boolean): RLMConfig;
+/**
+ * Validate configuration values
+ */
+export declare function validateConfig(config: RLMConfig): string[];
+//# sourceMappingURL=default-config.d.ts.map

package/dist/factory/default-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-config.d.ts","sourceRoot":"","sources":["../../src/factory/default-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3E;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;CASX,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAsDlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,UAAU,CAAC,EAAE,cAAc,EAC3B,UAAU,UAAO,GAChB,SAAS,CAQX;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,CAwB1D"}