@stackmemoryai/stackmemory 0.2.6 → 0.2.8

package/dist/src/core/errors/index.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Custom error classes for StackMemory
+ * Provides a hierarchy of error types for better error handling and debugging
+ */
+export declare enum ErrorCode {
+    DB_CONNECTION_FAILED = "DB_001",
+    DB_QUERY_FAILED = "DB_002",
+    DB_TRANSACTION_FAILED = "DB_003",
+    DB_MIGRATION_FAILED = "DB_004",
+    DB_CONSTRAINT_VIOLATION = "DB_005",
+    FRAME_NOT_FOUND = "FRAME_001",
+    FRAME_INVALID_STATE = "FRAME_002",
+    FRAME_PARENT_NOT_FOUND = "FRAME_003",
+    FRAME_CYCLE_DETECTED = "FRAME_004",
+    FRAME_ALREADY_CLOSED = "FRAME_005",
+    TASK_NOT_FOUND = "TASK_001",
+    TASK_INVALID_STATE = "TASK_002",
+    TASK_DEPENDENCY_CONFLICT = "TASK_003",
+    TASK_CIRCULAR_DEPENDENCY = "TASK_004",
+    LINEAR_AUTH_FAILED = "LINEAR_001",
+    LINEAR_API_ERROR = "LINEAR_002",
+    LINEAR_SYNC_FAILED = "LINEAR_003",
+    LINEAR_WEBHOOK_FAILED = "LINEAR_004",
+    MCP_TOOL_NOT_FOUND = "MCP_001",
+    MCP_INVALID_PARAMS = "MCP_002",
+    MCP_EXECUTION_FAILED = "MCP_003",
+    MCP_RATE_LIMITED = "MCP_004",
+    PROJECT_NOT_FOUND = "PROJECT_001",
+    PROJECT_INVALID_PATH = "PROJECT_002",
+    PROJECT_GIT_ERROR = "PROJECT_003",
+    VALIDATION_FAILED = "VAL_001",
+    INVALID_INPUT = "VAL_002",
+    MISSING_REQUIRED_FIELD = "VAL_003",
+    TYPE_MISMATCH = "VAL_004",
+    INITIALIZATION_ERROR = "SYS_001",
+    NOT_FOUND = "SYS_002",
+    INTERNAL_ERROR = "SYS_001",
+    CONFIGURATION_ERROR = "SYS_002",
+    PERMISSION_DENIED = "SYS_003",
+    RESOURCE_EXHAUSTED = "SYS_004",
+    SERVICE_UNAVAILABLE = "SYS_005"
+}
+export interface ErrorContext {
+    [key: string]: unknown;
+}
+export interface StackMemoryErrorOptions {
+    code: ErrorCode;
+    message: string;
+    context?: ErrorContext;
+    cause?: Error;
+    isRetryable?: boolean;
+    httpStatus?: number;
+}
+/**
+ * Base error class for all StackMemory errors
+ */
+export declare class StackMemoryError extends Error {
+    readonly code: ErrorCode;
+    readonly context?: ErrorContext;
+    readonly cause?: Error;
+    readonly isRetryable: boolean;
+    readonly httpStatus: number;
+    readonly timestamp: Date;
+    constructor(options: StackMemoryErrorOptions);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Database-related errors
+ */
+export declare class DatabaseError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext, cause?: Error);
+}
+/**
+ * Frame-related errors
+ */
+export declare class FrameError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * Task-related errors
+ */
+export declare class TaskError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * Integration errors (Linear, etc.)
+ */
+export declare class IntegrationError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext, cause?: Error);
+}
+/**
+ * MCP-related errors
+ */
+export declare class MCPError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * Validation errors
+ */
+export declare class ValidationError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * Project-related errors
+ */
+export declare class ProjectError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * System/Internal errors
+ */
+export declare class SystemError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext, cause?: Error);
+}
+/**
+ * Helper function to determine if an error is retryable
+ */
+export declare function isRetryableError(error: unknown): boolean;
+/**
+ * Helper function to safely extract error message
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Helper function to wrap unknown errors in StackMemoryError
+ */
+export declare function wrapError(error: unknown, defaultMessage: string, code?: ErrorCode, context?: ErrorContext): StackMemoryError;
+/**
+ * Type guard to check if error is a StackMemoryError
+ */
+export declare function isStackMemoryError(error: unknown): error is StackMemoryError;
+/**
+ * Create context-aware error handler
+ */
+export declare function createErrorHandler(defaultContext: ErrorContext): (error: unknown, additionalContext?: ErrorContext) => StackMemoryError;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/errors/index.d.ts.map

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

package/dist/src/core/errors/index.js

@@ -0,0 +1,274 @@
+/**
+ * Custom error classes for StackMemory
+ * Provides a hierarchy of error types for better error handling and debugging
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    // Database errors (1000-1999)
+    ErrorCode["DB_CONNECTION_FAILED"] = "DB_001";
+    ErrorCode["DB_QUERY_FAILED"] = "DB_002";
+    ErrorCode["DB_TRANSACTION_FAILED"] = "DB_003";
+    ErrorCode["DB_MIGRATION_FAILED"] = "DB_004";
+    ErrorCode["DB_CONSTRAINT_VIOLATION"] = "DB_005";
+    // Frame errors (2000-2999)
+    ErrorCode["FRAME_NOT_FOUND"] = "FRAME_001";
+    ErrorCode["FRAME_INVALID_STATE"] = "FRAME_002";
+    ErrorCode["FRAME_PARENT_NOT_FOUND"] = "FRAME_003";
+    ErrorCode["FRAME_CYCLE_DETECTED"] = "FRAME_004";
+    ErrorCode["FRAME_ALREADY_CLOSED"] = "FRAME_005";
+    // Task errors (3000-3999)
+    ErrorCode["TASK_NOT_FOUND"] = "TASK_001";
+    ErrorCode["TASK_INVALID_STATE"] = "TASK_002";
+    ErrorCode["TASK_DEPENDENCY_CONFLICT"] = "TASK_003";
+    ErrorCode["TASK_CIRCULAR_DEPENDENCY"] = "TASK_004";
+    // Integration errors (4000-4999)
+    ErrorCode["LINEAR_AUTH_FAILED"] = "LINEAR_001";
+    ErrorCode["LINEAR_API_ERROR"] = "LINEAR_002";
+    ErrorCode["LINEAR_SYNC_FAILED"] = "LINEAR_003";
+    ErrorCode["LINEAR_WEBHOOK_FAILED"] = "LINEAR_004";
+    // MCP errors (5000-5999)
+    ErrorCode["MCP_TOOL_NOT_FOUND"] = "MCP_001";
+    ErrorCode["MCP_INVALID_PARAMS"] = "MCP_002";
+    ErrorCode["MCP_EXECUTION_FAILED"] = "MCP_003";
+    ErrorCode["MCP_RATE_LIMITED"] = "MCP_004";
+    // Project errors (6000-6999)
+    ErrorCode["PROJECT_NOT_FOUND"] = "PROJECT_001";
+    ErrorCode["PROJECT_INVALID_PATH"] = "PROJECT_002";
+    ErrorCode["PROJECT_GIT_ERROR"] = "PROJECT_003";
+    // Validation errors (7000-7999)
+    ErrorCode["VALIDATION_FAILED"] = "VAL_001";
+    ErrorCode["INVALID_INPUT"] = "VAL_002";
+    ErrorCode["MISSING_REQUIRED_FIELD"] = "VAL_003";
+    ErrorCode["TYPE_MISMATCH"] = "VAL_004";
+    // System errors (8000-8999)
+    ErrorCode["INITIALIZATION_ERROR"] = "SYS_001";
+    ErrorCode["NOT_FOUND"] = "SYS_002";
+    ErrorCode["INTERNAL_ERROR"] = "SYS_001";
+    ErrorCode["CONFIGURATION_ERROR"] = "SYS_002";
+    ErrorCode["PERMISSION_DENIED"] = "SYS_003";
+    ErrorCode["RESOURCE_EXHAUSTED"] = "SYS_004";
+    ErrorCode["SERVICE_UNAVAILABLE"] = "SYS_005";
+})(ErrorCode || (ErrorCode = {}));
+/**
+ * Base error class for all StackMemory errors
+ */
+export class StackMemoryError extends Error {
+    code;
+    context;
+    cause;
+    isRetryable;
+    httpStatus;
+    timestamp;
+    constructor(options) {
+        super(options.message);
+        this.name = this.constructor.name;
+        this.code = options.code;
+        this.context = options.context;
+        this.cause = options.cause;
+        this.isRetryable = options.isRetryable ?? false;
+        this.httpStatus = options.httpStatus ?? 500;
+        this.timestamp = new Date();
+        // Maintains proper stack trace for where our error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            context: this.context,
+            isRetryable: this.isRetryable,
+            httpStatus: this.httpStatus,
+            timestamp: this.timestamp.toISOString(),
+            stack: this.stack,
+            cause: this.cause?.message,
+        };
+    }
+}
+/**
+ * Database-related errors
+ */
+export class DatabaseError extends StackMemoryError {
+    constructor(message, code = ErrorCode.DB_QUERY_FAILED, context, cause) {
+        super({
+            code,
+            message,
+            context,
+            cause,
+            isRetryable: code === ErrorCode.DB_CONNECTION_FAILED,
+            httpStatus: 503,
+        });
+    }
+}
+/**
+ * Frame-related errors
+ */
+export class FrameError extends StackMemoryError {
+    constructor(message, code = ErrorCode.FRAME_INVALID_STATE, context) {
+        super({
+            code,
+            message,
+            context,
+            isRetryable: false,
+            httpStatus: 400,
+        });
+    }
+}
+/**
+ * Task-related errors
+ */
+export class TaskError extends StackMemoryError {
+    constructor(message, code = ErrorCode.TASK_INVALID_STATE, context) {
+        super({
+            code,
+            message,
+            context,
+            isRetryable: false,
+            httpStatus: 400,
+        });
+    }
+}
+/**
+ * Integration errors (Linear, etc.)
+ */
+export class IntegrationError extends StackMemoryError {
+    constructor(message, code = ErrorCode.LINEAR_API_ERROR, context, cause) {
+        super({
+            code,
+            message,
+            context,
+            cause,
+            isRetryable: true,
+            httpStatus: 502,
+        });
+    }
+}
+/**
+ * MCP-related errors
+ */
+export class MCPError extends StackMemoryError {
+    constructor(message, code = ErrorCode.MCP_EXECUTION_FAILED, context) {
+        super({
+            code,
+            message,
+            context,
+            isRetryable: code === ErrorCode.MCP_RATE_LIMITED,
+            httpStatus: code === ErrorCode.MCP_RATE_LIMITED ? 429 : 400,
+        });
+    }
+}
+/**
+ * Validation errors
+ */
+export class ValidationError extends StackMemoryError {
+    constructor(message, code = ErrorCode.VALIDATION_FAILED, context) {
+        super({
+            code,
+            message,
+            context,
+            isRetryable: false,
+            httpStatus: 400,
+        });
+    }
+}
+/**
+ * Project-related errors
+ */
+export class ProjectError extends StackMemoryError {
+    constructor(message, code = ErrorCode.PROJECT_NOT_FOUND, context) {
+        super({
+            code,
+            message,
+            context,
+            isRetryable: false,
+            httpStatus: 404,
+        });
+    }
+}
+/**
+ * System/Internal errors
+ */
+export class SystemError extends StackMemoryError {
+    constructor(message, code = ErrorCode.INTERNAL_ERROR, context, cause) {
+        super({
+            code,
+            message,
+            context,
+            cause,
+            isRetryable: code === ErrorCode.SERVICE_UNAVAILABLE,
+            httpStatus: 500,
+        });
+    }
+}
+/**
+ * Helper function to determine if an error is retryable
+ */
+export function isRetryableError(error) {
+    if (error instanceof StackMemoryError) {
+        return error.isRetryable;
+    }
+    // Check for common retryable error patterns
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        return (message.includes('econnrefused') ||
+            message.includes('timeout') ||
+            message.includes('enotfound') ||
+            message.includes('socket hang up'));
+    }
+    return false;
+}
+/**
+ * Helper function to safely extract error message
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error && typeof error === 'object' && 'message' in error) {
+        return String(error.message);
+    }
+    return 'An unknown error occurred';
+}
+/**
+ * Helper function to wrap unknown errors in StackMemoryError
+ */
+export function wrapError(error, defaultMessage, code = ErrorCode.INTERNAL_ERROR, context) {
+    if (error instanceof StackMemoryError) {
+        return error;
+    }
+    const cause = error instanceof Error ? error : undefined;
+    const message = error instanceof Error ? error.message : defaultMessage;
+    return new SystemError(message, code, context, cause);
+}
+/**
+ * Type guard to check if error is a StackMemoryError
+ */
+export function isStackMemoryError(error) {
+    return error instanceof StackMemoryError;
+}
+/**
+ * Create context-aware error handler
+ */
+export function createErrorHandler(defaultContext) {
+    return (error, additionalContext) => {
+        const context = { ...defaultContext, ...additionalContext };
+        if (error instanceof StackMemoryError) {
+            // Create a new error with merged context since context is readonly
+            return new StackMemoryError({
+                code: error.code,
+                message: error.message,
+                context: { ...error.context, ...context },
+                cause: error.cause,
+                isRetryable: error.isRetryable,
+                httpStatus: error.httpStatus,
+            });
+        }
+        return wrapError(error, getErrorMessage(error), ErrorCode.INTERNAL_ERROR, context);
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/core/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAN,IAAY,SAoDX;AApDD,WAAY,SAAS;IACnB,8BAA8B;IAC9B,4CAA+B,CAAA;IAC/B,uCAA0B,CAAA;IAC1B,6CAAgC,CAAA;IAChC,2CAA8B,CAAA;IAC9B,+CAAkC,CAAA;IAElC,2BAA2B;IAC3B,0CAA6B,CAAA;IAC7B,8CAAiC,CAAA;IACjC,iDAAoC,CAAA;IACpC,+CAAkC,CAAA;IAClC,+CAAkC,CAAA;IAElC,0BAA0B;IAC1B,wCAA2B,CAAA;IAC3B,4CAA+B,CAAA;IAC/B,kDAAqC,CAAA;IACrC,kDAAqC,CAAA;IAErC,iCAAiC;IACjC,8CAAiC,CAAA;IACjC,4CAA+B,CAAA;IAC/B,8CAAiC,CAAA;IACjC,iDAAoC,CAAA;IAEpC,yBAAyB;IACzB,2CAA8B,CAAA;IAC9B,2CAA8B,CAAA;IAC9B,6CAAgC,CAAA;IAChC,yCAA4B,CAAA;IAE5B,6BAA6B;IAC7B,8CAAiC,CAAA;IACjC,iDAAoC,CAAA;IACpC,8CAAiC,CAAA;IAEjC,gCAAgC;IAChC,0CAA6B,CAAA;IAC7B,sCAAyB,CAAA;IACzB,+CAAkC,CAAA;IAClC,sCAAyB,CAAA;IAEzB,4BAA4B;IAC5B,6CAAgC,CAAA;IAChC,kCAAqB,CAAA;IACrB,uCAA0B,CAAA;IAC1B,4CAA+B,CAAA;IAC/B,0CAA6B,CAAA;IAC7B,2CAA8B,CAAA;IAC9B,4CAA+B,CAAA;AACjC,CAAC,EApDW,SAAS,KAAT,SAAS,QAoDpB;AAeD;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzB,IAAI,CAAY;IAChB,OAAO,CAAgB;IACvB,KAAK,CAAS;IACd,WAAW,CAAU;IACrB,UAAU,CAAS;IACnB,SAAS,CAAO;IAEhC,YAAY,OAAgC;QAC1C,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE5B,8DAA8D;QAC9D,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO;SAC3B,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,gBAAgB;IACjD,YACE,OAAe,EACf,OAAkB,SAAS,CAAC,eAAe,EAC3C,OAAsB,EACtB,KAAa;QAEb,KAAK,CAAC;YACJ,IAAI;YACJ,OAAO;YACP,OAAO;YACP,KAAK;YACL,WAAW,EAAE,IAAI,KAAK,SAAS,CAAC,oBAAoB;YACpD,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,gBAAgB;IAC9C,YACE,OAAe,EACf,OAAkB,SAAS,CAAC,mBAAmB,EAC/C,OAAsB;QAEtB,KAAK,CAAC;YACJ,IAAI;YACJ,OAAO;YACP,OAAO;YACP,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,gBAAgB;IAC7C,YACE,OAAe,EACf,OAAkB,SAAS,CAAC,kBAAkB,EAC9C,OAAsB;QAEtB,KAAK,CAAC;YACJ,IAAI;YACJ,OAAO;YACP,OAAO;YACP,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IACpD,YACE,OAAe,EACf,OAAkB,SAAS,CAAC,gBAAgB,EAC5C,OAAsB,EACtB,KAAa;QAEb,KAAK,CAAC;YACJ,IAAI;YACJ,OAAO;YACP,OAAO;YACP,KAAK;YACL,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,gBAAgB;IAC5C,YACE,OAAe,EACf,OAAkB,SAAS,CAAC,oBAAoB,EAChD,OAAsB;QAEtB,KAAK,CAAC;YACJ,IAAI;YACJ,OAAO;YACP,OAAO;YACP,WAAW,EAAE,IAAI,KAAK,SAAS,CAAC,gBAAgB;YAChD,UAAU,EAAE,IAAI,KAAK,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;SAC5D,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IACnD,YACE,OAAe,EACf,OAAkB,SAAS,CAAC,iBAAiB,EAC7C,OAAsB;QAEtB,KAAK,CAAC;YACJ,IAAI;YACJ,OAAO;YACP,OAAO;YACP,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,gBAAgB;IAChD,YACE,OAAe,EACf,OAAkB,SAAS,CAAC,iBAAiB,EAC7C,OAAsB;QAEtB,KAAK,CAAC;YACJ,IAAI;YACJ,OAAO;YACP,OAAO;YACP,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,gBAAgB;IAC/C,YACE,OAAe,EACf,OAAkB,SAAS,CAAC,cAAc,EAC1C,OAAsB,EACtB,KAAa;QAEb,KAAK,CAAC;YACJ,IAAI;YACJ,OAAO;YACP,OAAO;YACP,KAAK;YACL,WAAW,EAAE,IAAI,KAAK,SAAS,CAAC,mBAAmB;YACnD,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,WAAW,CAAC;IAC3B,CAAC;IACD,4CAA4C;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5C,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;YAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CACnC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,2BAA2B,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,KAAc,EACd,cAAsB,EACtB,OAAkB,SAAS,CAAC,cAAc,EAC1C,OAAsB;IAEtB,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;IAExE,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,gBAAgB,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,cAA4B;IAC7D,OAAO,CAAC,KAAc,EAAE,iBAAgC,EAAE,EAAE;QAC1D,MAAM,OAAO,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,iBAAiB,EAAE,CAAC;QAE5D,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;YACtC,mEAAmE;YACnE,OAAO,IAAI,gBAAgB,CAAC;gBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE;gBACzC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,SAAS,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/core/errors/recovery.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Error recovery utilities for StackMemory
+ * Provides retry logic, circuit breakers, and fallback mechanisms
+ */
+import { ErrorContext } from './index.js';
+export interface RetryOptions {
+    maxAttempts?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffFactor?: number;
+    timeout?: number;
+    onRetry?: (attempt: number, error: unknown) => void;
+}
+export interface CircuitBreakerOptions {
+    failureThreshold?: number;
+    resetTimeout?: number;
+    halfOpenRequests?: number;
+}
+export declare enum CircuitState {
+    CLOSED = "closed",
+    OPEN = "open",
+    HALF_OPEN = "half_open"
+}
+/**
+ * Exponential backoff with jitter
+ */
+export declare function calculateBackoff(attempt: number, initialDelay: number, maxDelay: number, factor: number): number;
+/**
+ * Retry with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Circuit breaker implementation
+ */
+export declare class CircuitBreaker<T> {
+    private readonly name;
+    private state;
+    private failures;
+    private successCount;
+    private lastFailTime?;
+    private readonly options;
+    constructor(name: string, options?: CircuitBreakerOptions);
+    execute<R = T>(fn: () => Promise<R>): Promise<R>;
+    private handleFailure;
+    getState(): CircuitState;
+    reset(): void;
+}
+/**
+ * Fallback with multiple strategies
+ */
+export declare function withFallback<T>(primary: () => Promise<T>, fallbacks: Array<() => Promise<T>>, context?: ErrorContext): Promise<T>;
+/**
+ * Bulkhead pattern - limit concurrent operations
+ */
+export declare class Bulkhead {
+    private readonly name;
+    private readonly maxConcurrent;
+    private running;
+    private queue;
+    constructor(name: string, maxConcurrent: number);
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    getStats(): {
+        running: number;
+        queued: number;
+        maxConcurrent: number;
+    };
+}
+/**
+ * Timeout wrapper with proper cleanup
+ */
+export declare function withTimeout<T>(fn: () => Promise<T>, timeoutMs: number, timeoutMessage?: string): Promise<T>;
+/**
+ * Graceful degradation helper
+ */
+export declare function gracefulDegrade<T, F>(fn: () => Promise<T>, defaultValue: F, logContext?: ErrorContext): Promise<T | F>;
+/**
+ * Create a resilient operation with multiple recovery strategies
+ */
+export declare function createResilientOperation<T>(name: string, options?: {
+    retry?: RetryOptions;
+    circuitBreaker?: CircuitBreakerOptions;
+    bulkhead?: number;
+    timeout?: number;
+    fallback?: () => Promise<T>;
+}): (fn: () => Promise<T>) => Promise<T>;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/src/core/errors/recovery.d.ts.map

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