@cloudwarriors-ai/rlm 0.1.5

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

@@ -0,0 +1,14 @@
+export { RLMError } from './base-error.js';
+export { ExecutionError, CodeValidationError, ExecutionTimeoutError, SandboxViolationError, type ValidationErrorInfo, } from './execution-error.js';
+export { LimitExceededError, SessionCancelledError, SessionTimeoutError, } from './limit-exceeded.js';
+export { ValidationError, ConfigurationError, ContextError, QueryError, } from './validation-error.js';
+export { LLMError, RateLimitError, AuthenticationError, ContentFilterError, MalformedResponseError, } from './llm-error.js';
+/**
+ * Check if an error is an RLM error
+ */
+export declare function isRLMError(error: unknown): error is import('./base-error.js').RLMError;
+/**
+ * Check if an error is recoverable
+ */
+export declare function isRecoverableError(error: unknown): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,UAAU,GACX,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,iBAAiB,EAAE,QAAQ,CAEtF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1D"}

package/dist/domain/errors/index.js

@@ -0,0 +1,26 @@
+// Base error
+export { RLMError } from './base-error.js';
+// Execution errors
+export { ExecutionError, CodeValidationError, ExecutionTimeoutError, SandboxViolationError, } from './execution-error.js';
+// Limit errors
+export { LimitExceededError, SessionCancelledError, SessionTimeoutError, } from './limit-exceeded.js';
+// Validation errors
+export { ValidationError, ConfigurationError, ContextError, QueryError, } from './validation-error.js';
+// LLM errors
+export { LLMError, RateLimitError, AuthenticationError, ContentFilterError, MalformedResponseError, } from './llm-error.js';
+/**
+ * Check if an error is an RLM error
+ */
+export function isRLMError(error) {
+    return error instanceof Error && 'code' in error && 'recoverable' in error;
+}
+/**
+ * Check if an error is recoverable
+ */
+export function isRecoverableError(error) {
+    if (isRLMError(error)) {
+        return error.recoverable;
+    }
+    return false;
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/errors/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GAEtB,MAAM,sBAAsB,CAAC;AAE9B,eAAe;AACf,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,aAAa;AACb,OAAO,EACL,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,aAAa,IAAI,KAAK,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,WAAW,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/domain/errors/limit-exceeded.d.ts

@@ -0,0 +1,38 @@
+import { RLMError } from './base-error.js';
+import type { LimitType } from '../services/limit-checker.js';
+/**
+ * Error when a limit is exceeded
+ */
+export declare class LimitExceededError extends RLMError {
+    readonly code = "LIMIT_EXCEEDED";
+    readonly recoverable = false;
+    /** Type of limit that was exceeded */
+    readonly limitType: LimitType;
+    /** Current value */
+    readonly currentValue: number;
+    /** Maximum allowed value */
+    readonly maxValue: number;
+    constructor(limitType: LimitType, currentValue: number, maxValue: number, sessionId?: string);
+    private static formatMessage;
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error when session is cancelled
+ */
+export declare class SessionCancelledError extends RLMError {
+    readonly code = "SESSION_CANCELLED";
+    readonly recoverable = false;
+    constructor(sessionId: string);
+}
+/**
+ * Error when session times out
+ */
+export declare class SessionTimeoutError extends RLMError {
+    readonly code = "SESSION_TIMEOUT";
+    readonly recoverable = false;
+    /** Timeout duration in milliseconds */
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number, sessionId?: string);
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=limit-exceeded.d.ts.map

package/dist/domain/errors/limit-exceeded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limit-exceeded.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/limit-exceeded.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,SAAS;IAE7B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,oBAAoB;IACpB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAGxB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM;IASpB,OAAO,CAAC,MAAM,CAAC,aAAa;IAiBnB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQ3C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,SAAS;gBAEjB,SAAS,EAAE,MAAM;CAG9B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,SAAS;IAE7B,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAKxC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM3C"}

package/dist/domain/errors/limit-exceeded.js

@@ -0,0 +1,71 @@
+import { RLMError } from './base-error.js';
+/**
+ * Error when a limit is exceeded
+ */
+export class LimitExceededError extends RLMError {
+    code = 'LIMIT_EXCEEDED';
+    recoverable = false;
+    /** Type of limit that was exceeded */
+    limitType;
+    /** Current value */
+    currentValue;
+    /** Maximum allowed value */
+    maxValue;
+    constructor(limitType, currentValue, maxValue, sessionId) {
+        const message = LimitExceededError.formatMessage(limitType, currentValue, maxValue);
+        super(message, sessionId);
+        this.limitType = limitType;
+        this.currentValue = currentValue;
+        this.maxValue = maxValue;
+    }
+    static formatMessage(limitType, currentValue, maxValue) {
+        switch (limitType) {
+            case 'depth':
+                return `Maximum recursion depth exceeded: ${currentValue}/${maxValue}`;
+            case 'tokens':
+                return `Maximum tokens exceeded: ${currentValue.toLocaleString()}/${maxValue.toLocaleString()}`;
+            case 'cost':
+                return `Maximum cost exceeded: $${currentValue.toFixed(4)}/$${maxValue.toFixed(2)}`;
+            case 'time':
+                return `Timeout exceeded: ${(currentValue / 1000).toFixed(1)}s/${(maxValue / 1000).toFixed(0)}s`;
+        }
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            limitType: this.limitType,
+            currentValue: this.currentValue,
+            maxValue: this.maxValue,
+        };
+    }
+}
+/**
+ * Error when session is cancelled
+ */
+export class SessionCancelledError extends RLMError {
+    code = 'SESSION_CANCELLED';
+    recoverable = false;
+    constructor(sessionId) {
+        super('Session was cancelled', sessionId);
+    }
+}
+/**
+ * Error when session times out
+ */
+export class SessionTimeoutError extends RLMError {
+    code = 'SESSION_TIMEOUT';
+    recoverable = false;
+    /** Timeout duration in milliseconds */
+    timeoutMs;
+    constructor(timeoutMs, sessionId) {
+        super(`Session timed out after ${(timeoutMs / 1000).toFixed(0)} seconds`, sessionId);
+        this.timeoutMs = timeoutMs;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            timeoutMs: this.timeoutMs,
+        };
+    }
+}
+//# sourceMappingURL=limit-exceeded.js.map

package/dist/domain/errors/limit-exceeded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limit-exceeded.js","sourceRoot":"","sources":["../../../src/domain/errors/limit-exceeded.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IACrC,IAAI,GAAG,gBAAgB,CAAC;IACxB,WAAW,GAAG,KAAK,CAAC;IAE7B,sCAAsC;IAC7B,SAAS,CAAY;IAE9B,oBAAoB;IACX,YAAY,CAAS;IAE9B,4BAA4B;IACnB,QAAQ,CAAS;IAE1B,YACE,SAAoB,EACpB,YAAoB,EACpB,QAAgB,EAChB,SAAkB;QAElB,MAAM,OAAO,GAAG,kBAAkB,CAAC,aAAa,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;QACpF,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEO,MAAM,CAAC,aAAa,CAC1B,SAAoB,EACpB,YAAoB,EACpB,QAAgB;QAEhB,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,OAAO;gBACV,OAAO,qCAAqC,YAAY,IAAI,QAAQ,EAAE,CAAC;YACzE,KAAK,QAAQ;gBACX,OAAO,4BAA4B,YAAY,CAAC,cAAc,EAAE,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;YAClG,KAAK,MAAM;gBACT,OAAO,2BAA2B,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,KAAK,MAAM;gBACT,OAAO,qBAAqB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;QACrG,CAAC;IACH,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IACxC,IAAI,GAAG,mBAAmB,CAAC;IAC3B,WAAW,GAAG,KAAK,CAAC;IAE7B,YAAY,SAAiB;QAC3B,KAAK,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;IAC5C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IACtC,IAAI,GAAG,iBAAiB,CAAC;IACzB,WAAW,GAAG,KAAK,CAAC;IAE7B,uCAAuC;IAC9B,SAAS,CAAS;IAE3B,YAAY,SAAiB,EAAE,SAAkB;QAC/C,KAAK,CAAC,2BAA2B,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACrF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF"}

package/dist/domain/errors/llm-error.d.ts

@@ -0,0 +1,60 @@
+import { RLMError } from './base-error.js';
+/**
+ * Error from LLM provider
+ */
+export declare class LLMError extends RLMError {
+    readonly code = "LLM_ERROR";
+    readonly recoverable = true;
+    /** HTTP status code if applicable */
+    readonly statusCode?: number;
+    /** Provider-specific error code */
+    readonly providerCode?: string;
+    constructor(message: string, options?: {
+        sessionId?: string;
+        statusCode?: number;
+        providerCode?: string;
+    });
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error when LLM rate limit is exceeded
+ */
+export declare class RateLimitError extends RLMError {
+    readonly code = "RATE_LIMIT_ERROR";
+    readonly recoverable = true;
+    /** Seconds to wait before retry */
+    readonly retryAfter?: number;
+    constructor(message: string, retryAfter?: number, sessionId?: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error when LLM authentication fails
+ */
+export declare class AuthenticationError extends RLMError {
+    readonly code = "AUTHENTICATION_ERROR";
+    readonly recoverable = false;
+    constructor(message: string, sessionId?: string);
+}
+/**
+ * Error when LLM content is filtered
+ */
+export declare class ContentFilterError extends RLMError {
+    readonly code = "CONTENT_FILTER_ERROR";
+    readonly recoverable = false;
+    /** Reason for filtering */
+    readonly filterReason?: string;
+    constructor(message: string, filterReason?: string, sessionId?: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error when LLM response is malformed
+ */
+export declare class MalformedResponseError extends RLMError {
+    readonly code = "MALFORMED_RESPONSE_ERROR";
+    readonly recoverable = true;
+    /** The malformed response */
+    readonly response?: string;
+    constructor(message: string, response?: string, sessionId?: string);
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=llm-error.d.ts.map

package/dist/domain/errors/llm-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-error.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/llm-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;GAEG;AACH,qBAAa,QAAS,SAAQ,QAAQ;IACpC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,QAAQ;IAE5B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,mCAAmC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAG7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAOM,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAO3C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,QAAQ;IAE5B,mCAAmC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAK3D,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,WAAW,SAAS;gBAEjB,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAGhD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,WAAW,SAAS;IAE7B,2BAA2B;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAK7D,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM3C;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,WAAW,QAAQ;IAE5B,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAKzD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM3C"}

package/dist/domain/errors/llm-error.js

@@ -0,0 +1,92 @@
+import { RLMError } from './base-error.js';
+/**
+ * Error from LLM provider
+ */
+export class LLMError extends RLMError {
+    code = 'LLM_ERROR';
+    recoverable = true;
+    /** HTTP status code if applicable */
+    statusCode;
+    /** Provider-specific error code */
+    providerCode;
+    constructor(message, options) {
+        super(message, options?.sessionId);
+        this.statusCode = options?.statusCode;
+        this.providerCode = options?.providerCode;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            statusCode: this.statusCode,
+            providerCode: this.providerCode,
+        };
+    }
+}
+/**
+ * Error when LLM rate limit is exceeded
+ */
+export class RateLimitError extends RLMError {
+    code = 'RATE_LIMIT_ERROR';
+    recoverable = true;
+    /** Seconds to wait before retry */
+    retryAfter;
+    constructor(message, retryAfter, sessionId) {
+        super(message, sessionId);
+        this.retryAfter = retryAfter;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            retryAfter: this.retryAfter,
+        };
+    }
+}
+/**
+ * Error when LLM authentication fails
+ */
+export class AuthenticationError extends RLMError {
+    code = 'AUTHENTICATION_ERROR';
+    recoverable = false;
+    constructor(message, sessionId) {
+        super(message, sessionId);
+    }
+}
+/**
+ * Error when LLM content is filtered
+ */
+export class ContentFilterError extends RLMError {
+    code = 'CONTENT_FILTER_ERROR';
+    recoverable = false;
+    /** Reason for filtering */
+    filterReason;
+    constructor(message, filterReason, sessionId) {
+        super(message, sessionId);
+        this.filterReason = filterReason;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            filterReason: this.filterReason,
+        };
+    }
+}
+/**
+ * Error when LLM response is malformed
+ */
+export class MalformedResponseError extends RLMError {
+    code = 'MALFORMED_RESPONSE_ERROR';
+    recoverable = true;
+    /** The malformed response */
+    response;
+    constructor(message, response, sessionId) {
+        super(message, sessionId);
+        this.response = response;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            response: this.response,
+        };
+    }
+}
+//# sourceMappingURL=llm-error.js.map

package/dist/domain/errors/llm-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-error.js","sourceRoot":"","sources":["../../../src/domain/errors/llm-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,QAAQ;IAC3B,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,IAAI,CAAC;IAE5B,qCAAqC;IAC5B,UAAU,CAAU;IAE7B,mCAAmC;IAC1B,YAAY,CAAU;IAE/B,YACE,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC5C,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAQ;IACjC,IAAI,GAAG,kBAAkB,CAAC;IAC1B,WAAW,GAAG,IAAI,CAAC;IAE5B,mCAAmC;IAC1B,UAAU,CAAU;IAE7B,YAAY,OAAe,EAAE,UAAmB,EAAE,SAAkB;QAClE,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IACtC,IAAI,GAAG,sBAAsB,CAAC;IAC9B,WAAW,GAAG,KAAK,CAAC;IAE7B,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IACrC,IAAI,GAAG,sBAAsB,CAAC;IAC9B,WAAW,GAAG,KAAK,CAAC;IAE7B,2BAA2B;IAClB,YAAY,CAAU;IAE/B,YAAY,OAAe,EAAE,YAAqB,EAAE,SAAkB;QACpE,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IACzC,IAAI,GAAG,0BAA0B,CAAC;IAClC,WAAW,GAAG,IAAI,CAAC;IAE5B,6BAA6B;IACpB,QAAQ,CAAU;IAE3B,YAAY,OAAe,EAAE,QAAiB,EAAE,SAAkB;QAChE,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/domain/errors/validation-error.d.ts

@@ -0,0 +1,58 @@
+import { RLMError } from './base-error.js';
+/**
+ * Error when input validation fails
+ */
+export declare class ValidationError extends RLMError {
+    readonly code = "VALIDATION_ERROR";
+    readonly recoverable = true;
+    /** Field that failed validation */
+    readonly field?: string;
+    /** Expected value or format */
+    readonly expected?: string;
+    /** Actual value received */
+    readonly actual?: string;
+    constructor(message: string, options?: {
+        sessionId?: string;
+        field?: string;
+        expected?: string;
+        actual?: string;
+    });
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error when configuration is invalid
+ */
+export declare class ConfigurationError extends RLMError {
+    readonly code = "CONFIGURATION_ERROR";
+    readonly recoverable = false;
+    /** Configuration key that's invalid */
+    readonly configKey?: string;
+    constructor(message: string, configKey?: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error when context is invalid or too large
+ */
+export declare class ContextError extends RLMError {
+    readonly code = "CONTEXT_ERROR";
+    readonly recoverable = false;
+    /** Size of context in bytes or tokens */
+    readonly contextSize?: number;
+    /** Maximum allowed size */
+    readonly maxSize?: number;
+    constructor(message: string, options?: {
+        sessionId?: string;
+        contextSize?: number;
+        maxSize?: number;
+    });
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error when query is invalid
+ */
+export declare class QueryError extends RLMError {
+    readonly code = "QUERY_ERROR";
+    readonly recoverable = true;
+    constructor(message: string, sessionId?: string);
+}
+//# sourceMappingURL=validation-error.d.ts.map

package/dist/domain/errors/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,QAAQ;IAE5B,mCAAmC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAGvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAQM,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQ3C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,WAAW,SAAS;IAE7B,uCAAuC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAKtC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM3C;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,SAAS;IAE7B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAGxB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAOM,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAO3C;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,QAAQ;IACtC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,QAAQ;gBAEhB,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAGhD"}

package/dist/domain/errors/validation-error.js

@@ -0,0 +1,81 @@
+import { RLMError } from './base-error.js';
+/**
+ * Error when input validation fails
+ */
+export class ValidationError extends RLMError {
+    code = 'VALIDATION_ERROR';
+    recoverable = true;
+    /** Field that failed validation */
+    field;
+    /** Expected value or format */
+    expected;
+    /** Actual value received */
+    actual;
+    constructor(message, options) {
+        super(message, options?.sessionId);
+        this.field = options?.field;
+        this.expected = options?.expected;
+        this.actual = options?.actual;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            field: this.field,
+            expected: this.expected,
+            actual: this.actual,
+        };
+    }
+}
+/**
+ * Error when configuration is invalid
+ */
+export class ConfigurationError extends RLMError {
+    code = 'CONFIGURATION_ERROR';
+    recoverable = false;
+    /** Configuration key that's invalid */
+    configKey;
+    constructor(message, configKey) {
+        super(message);
+        this.configKey = configKey;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            configKey: this.configKey,
+        };
+    }
+}
+/**
+ * Error when context is invalid or too large
+ */
+export class ContextError extends RLMError {
+    code = 'CONTEXT_ERROR';
+    recoverable = false;
+    /** Size of context in bytes or tokens */
+    contextSize;
+    /** Maximum allowed size */
+    maxSize;
+    constructor(message, options) {
+        super(message, options?.sessionId);
+        this.contextSize = options?.contextSize;
+        this.maxSize = options?.maxSize;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            contextSize: this.contextSize,
+            maxSize: this.maxSize,
+        };
+    }
+}
+/**
+ * Error when query is invalid
+ */
+export class QueryError extends RLMError {
+    code = 'QUERY_ERROR';
+    recoverable = true;
+    constructor(message, sessionId) {
+        super(message, sessionId);
+    }
+}
+//# sourceMappingURL=validation-error.js.map

package/dist/domain/errors/validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.js","sourceRoot":"","sources":["../../../src/domain/errors/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAClC,IAAI,GAAG,kBAAkB,CAAC;IAC1B,WAAW,GAAG,IAAI,CAAC;IAE5B,mCAAmC;IAC1B,KAAK,CAAU;IAExB,+BAA+B;IACtB,QAAQ,CAAU;IAE3B,4BAA4B;IACnB,MAAM,CAAU;IAEzB,YACE,OAAe,EACf,OAKC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAChC,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IACrC,IAAI,GAAG,qBAAqB,CAAC;IAC7B,WAAW,GAAG,KAAK,CAAC;IAE7B,uCAAuC;IAC9B,SAAS,CAAU;IAE5B,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IAC/B,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAAG,KAAK,CAAC;IAE7B,yCAAyC;IAChC,WAAW,CAAU;IAE9B,2BAA2B;IAClB,OAAO,CAAU;IAE1B,YACE,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IAClC,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,QAAQ;IAC7B,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAAG,IAAI,CAAC;IAE5B,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/domain/interfaces/code-executor.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Context for code execution
+ */
+export interface ExecutionContext {
+    /** Variables available in the Python environment */
+    readonly variables: ReadonlyMap<string, string>;
+    /** Session ID for tracking */
+    readonly sessionId: string;
+    /** Current recursion depth */
+    readonly depth: number;
+    /** Timeout in milliseconds */
+    readonly timeoutMs: number;
+}
+/**
+ * Result of code validation
+ */
+export interface ValidationResult {
+    /** Whether the code is valid and safe */
+    readonly valid: boolean;
+    /** Validation errors if any */
+    readonly errors: readonly ValidationError[];
+    /** Warnings (code is valid but might have issues) */
+    readonly warnings: readonly string[];
+}
+export interface ValidationError {
+    /** Line number (1-indexed) */
+    readonly line: number;
+    /** Column number (1-indexed) */
+    readonly column: number;
+    /** Error message */
+    readonly message: string;
+    /** Error code for categorization */
+    readonly code: ValidationErrorCode;
+}
+export type ValidationErrorCode = 'SYNTAX_ERROR' | 'FORBIDDEN_IMPORT' | 'FORBIDDEN_BUILTIN' | 'FORBIDDEN_ATTRIBUTE' | 'INFINITE_LOOP_RISK' | 'FILE_SYSTEM_ACCESS' | 'NETWORK_ACCESS' | 'SHELL_EXECUTION';
+/**
+ * Result of code execution
+ */
+export interface ExecutionResult {
+    /** Whether execution completed successfully */
+    readonly success: boolean;
+    /** Output printed to stdout */
+    readonly stdout: string;
+    /** Output printed to stderr */
+    readonly stderr: string;
+    /** Final result value if any */
+    readonly result?: string;
+    /** Error message if execution failed */
+    readonly error?: string;
+    /** Execution time in milliseconds */
+    readonly executionTimeMs: number;
+    /** Commands from Python to Node (llm_query, set_result, etc.) */
+    readonly commands: readonly PythonCommand[];
+}
+/**
+ * Commands that Python code can issue to Node
+ */
+export type PythonCommand = LLMQueryCommand | SetResultCommand | SetVariableCommand;
+export interface LLMQueryCommand {
+    readonly type: 'llm_query';
+    readonly query: string;
+    readonly contextVariables: readonly string[];
+}
+export interface SetResultCommand {
+    readonly type: 'set_result';
+    readonly result: string;
+}
+export interface SetVariableCommand {
+    readonly type: 'set_variable';
+    readonly name: string;
+    readonly value: string;
+}
+/**
+ * Interface for code execution (Python sandbox)
+ */
+export interface ICodeExecutor {
+    /**
+     * Validate code before execution
+     */
+    validate(code: string): ValidationResult;
+    /**
+     * Execute Python code in sandbox
+     */
+    execute(code: string, context: ExecutionContext): Promise<ExecutionResult>;
+    /**
+     * Send a response to a pending llm_query
+     */
+    respondToQuery(response: string): Promise<void>;
+    /**
+     * Kill any running execution
+     */
+    kill(): Promise<void>;
+    /**
+     * Check if executor is ready
+     */
+    isReady(): boolean;
+}
+//# sourceMappingURL=code-executor.d.ts.map

package/dist/domain/interfaces/code-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-executor.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/code-executor.ts"],"names":[],"mappings":"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"}

package/dist/domain/interfaces/code-executor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-executor.js.map

package/dist/domain/interfaces/code-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-executor.js","sourceRoot":"","sources":["../../../src/domain/interfaces/code-executor.ts"],"names":[],"mappings":""}