promptspeak-mcp-server 0.1.0

package/dist/core/errors/types.d.ts

@@ -0,0 +1,708 @@
+/**
+ * ===============================================================================
+ * ERROR TYPES - Specific Error Classes for PromptSpeak
+ * ===============================================================================
+ *
+ * Provides concrete error classes for different error scenarios.
+ * All errors extend PromptSpeakError and implement the required abstract members.
+ *
+ * ===============================================================================
+ */
+import { PromptSpeakError, PromptSpeakErrorOptions } from './base.js';
+import { ErrorCode, ErrorSeverity } from './codes.js';
+/**
+ * Error thrown when input validation fails.
+ */
+export declare class ValidationError extends PromptSpeakError {
+    readonly code = ErrorCode.VALIDATION_ERROR;
+    readonly severity: ErrorSeverity;
+    /**
+     * Creates a new ValidationError.
+     *
+     * @param message - Description of the validation failure
+     * @param options - Additional error options
+     */
+    constructor(message: string, options?: PromptSpeakErrorOptions);
+    /**
+     * Creates a ValidationError for a missing required field.
+     */
+    static requiredField(fieldName: string): ValidationError;
+    /**
+     * Creates a ValidationError for an invalid field value.
+     */
+    static invalidValue(fieldName: string, value: unknown, expectedType?: string): ValidationError;
+}
+/**
+ * Error thrown when a requested resource is not found.
+ */
+export declare class NotFoundError extends PromptSpeakError {
+    readonly code = ErrorCode.NOT_FOUND;
+    readonly severity: ErrorSeverity;
+    /**
+     * The type of resource that was not found.
+     */
+    readonly resourceType: string;
+    /**
+     * The identifier of the resource that was not found.
+     */
+    readonly resourceId?: string;
+    /**
+     * Creates a new NotFoundError.
+     *
+     * @param resourceType - The type of resource (e.g., 'User', 'Document')
+     * @param resourceId - The identifier of the resource
+     * @param options - Additional error options
+     */
+    constructor(resourceType: string, resourceId?: string, options?: PromptSpeakErrorOptions);
+    toJSON(includeStack?: boolean): {
+        resourceType: string;
+        resourceId: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when there is a conflict with existing resources.
+ */
+export declare class ConflictError extends PromptSpeakError {
+    readonly code = ErrorCode.CONFLICT;
+    readonly severity: ErrorSeverity;
+    constructor(message: string, options?: PromptSpeakErrorOptions);
+}
+/**
+ * Error thrown when a network operation fails.
+ */
+export declare class NetworkError extends PromptSpeakError {
+    readonly code = ErrorCode.NETWORK_ERROR;
+    readonly severity: ErrorSeverity;
+    /**
+     * The URL that was being accessed when the error occurred.
+     */
+    readonly url?: string;
+    constructor(message: string, options?: PromptSpeakErrorOptions & {
+        url?: string;
+    });
+    toJSON(includeStack?: boolean): {
+        url: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when a request times out.
+ */
+export declare class TimeoutError extends PromptSpeakError {
+    readonly code = ErrorCode.TIMEOUT;
+    readonly severity: ErrorSeverity;
+    /**
+     * The timeout duration in milliseconds.
+     */
+    readonly timeoutMs?: number;
+    constructor(message?: string, options?: PromptSpeakErrorOptions & {
+        timeoutMs?: number;
+    });
+    toJSON(includeStack?: boolean): {
+        timeoutMs: number | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when rate limit is exceeded.
+ */
+export declare class RateLimitError extends PromptSpeakError {
+    readonly code = ErrorCode.RATE_LIMITED;
+    readonly severity: ErrorSeverity;
+    /**
+     * Number of seconds until the rate limit resets.
+     */
+    readonly retryAfter?: number;
+    /**
+     * The limit that was exceeded.
+     */
+    readonly limit?: number;
+    /**
+     * The time window for the limit (e.g., 'minute', 'hour').
+     */
+    readonly window?: string;
+    constructor(message?: string, options?: PromptSpeakErrorOptions & {
+        retryAfter?: number;
+        limit?: number;
+        window?: string;
+    });
+    toJSON(includeStack?: boolean): {
+        retryAfter: number | undefined;
+        limit: number | undefined;
+        window: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when the circuit breaker is open.
+ */
+export declare class CircuitBreakerError extends PromptSpeakError {
+    readonly code = ErrorCode.CIRCUIT_OPEN;
+    readonly severity: ErrorSeverity;
+    /**
+     * Name of the service protected by the circuit breaker.
+     */
+    readonly serviceName?: string;
+    /**
+     * When the circuit breaker will attempt to half-open.
+     */
+    readonly resetAfter?: number;
+    constructor(message?: string, options?: PromptSpeakErrorOptions & {
+        serviceName?: string;
+        resetAfter?: number;
+    });
+    toJSON(includeStack?: boolean): {
+        serviceName: string | undefined;
+        resetAfter: number | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when authentication fails.
+ */
+export declare class AuthenticationError extends PromptSpeakError {
+    readonly code = ErrorCode.AUTH_FAILED;
+    readonly severity: ErrorSeverity;
+    constructor(message?: string, options?: PromptSpeakErrorOptions);
+}
+/**
+ * Error thrown when access is forbidden.
+ */
+export declare class ForbiddenError extends PromptSpeakError {
+    readonly code = ErrorCode.FORBIDDEN;
+    readonly severity: ErrorSeverity;
+    /**
+     * The resource or action that was forbidden.
+     */
+    readonly resource?: string;
+    constructor(message?: string, options?: PromptSpeakErrorOptions & {
+        resource?: string;
+    });
+    toJSON(includeStack?: boolean): {
+        resource: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown by external API adapters.
+ * Compatible with the existing AdapterError pattern in base-adapter.ts.
+ */
+export declare class AdapterError extends PromptSpeakError {
+    readonly code: ErrorCode;
+    readonly severity: ErrorSeverity;
+    /**
+     * The name of the adapter that threw the error.
+     */
+    readonly adapterName?: string;
+    /**
+     * The original adapter error code (for backwards compatibility).
+     */
+    readonly adapterCode?: string;
+    constructor(message: string, options?: PromptSpeakErrorOptions & {
+        adapterName?: string;
+        adapterCode?: string;
+        code?: ErrorCode;
+    });
+    /**
+     * Creates an AdapterError from the legacy AdapterError format.
+     * For backwards compatibility with existing code.
+     */
+    static fromLegacy(message: string, legacyCode: string, statusCode?: number, retryable?: boolean, originalError?: Error): AdapterError;
+    toJSON(includeStack?: boolean): {
+        adapterName: string | undefined;
+        adapterCode: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown by the agent system.
+ */
+export declare class AgentError extends PromptSpeakError {
+    readonly code: ErrorCode;
+    readonly severity: ErrorSeverity;
+    /**
+     * The ID of the agent that threw the error.
+     */
+    readonly agentId?: string;
+    /**
+     * The task or operation that failed.
+     */
+    readonly operation?: string;
+    constructor(message: string, options?: PromptSpeakErrorOptions & {
+        agentId?: string;
+        operation?: string;
+        code?: ErrorCode;
+    });
+    /**
+     * Creates an error for agent not found.
+     */
+    static notFound(agentId: string): AgentError;
+    /**
+     * Creates an error for agent already registered.
+     */
+    static alreadyRegistered(agentId: string): AgentError;
+    /**
+     * Creates an error for delegation depth exceeded.
+     */
+    static delegationDepthExceeded(maxDepth: number): AgentError;
+    toJSON(includeStack?: boolean): {
+        agentId: string | undefined;
+        operation: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when intent processing fails.
+ */
+export declare class IntentError extends PromptSpeakError {
+    readonly code: ErrorCode;
+    readonly severity: ErrorSeverity;
+    /**
+     * The raw input that failed to parse.
+     */
+    readonly rawInput?: string;
+    /**
+     * The intent type, if known.
+     */
+    readonly intentType?: string;
+    constructor(message: string, options?: PromptSpeakErrorOptions & {
+        rawInput?: string;
+        intentType?: string;
+        code?: ErrorCode;
+    });
+    /**
+     * Creates an error for intent parsing failure.
+     */
+    static parseError(rawInput: string, reason?: string): IntentError;
+    /**
+     * Creates an error for unknown intent.
+     */
+    static unknownIntent(intentType: string): IntentError;
+    toJSON(includeStack?: boolean): {
+        rawInput: string | undefined;
+        intentType: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when mission operations fail.
+ */
+export declare class MissionError extends PromptSpeakError {
+    readonly code: ErrorCode;
+    readonly severity: ErrorSeverity;
+    /**
+     * The ID of the mission that caused the error.
+     */
+    readonly missionId?: string;
+    /**
+     * The current state of the mission.
+     */
+    readonly missionState?: string;
+    constructor(message: string, options?: PromptSpeakErrorOptions & {
+        missionId?: string;
+        missionState?: string;
+        code?: ErrorCode;
+    });
+    /**
+     * Creates an error for mission not found.
+     */
+    static notFound(missionId: string): MissionError;
+    /**
+     * Creates an error for mission already completed.
+     */
+    static alreadyCompleted(missionId: string): MissionError;
+    /**
+     * Creates an error for mission expired.
+     */
+    static expired(missionId: string): MissionError;
+    toJSON(includeStack?: boolean): {
+        missionId: string | undefined;
+        missionState: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when proposal operations fail.
+ */
+export declare class ProposalError extends PromptSpeakError {
+    readonly code: ErrorCode;
+    readonly severity: ErrorSeverity;
+    /**
+     * The ID of the proposal that caused the error.
+     */
+    readonly proposalId?: string;
+    /**
+     * The current state of the proposal.
+     */
+    readonly proposalState?: string;
+    constructor(message: string, options?: PromptSpeakErrorOptions & {
+        proposalId?: string;
+        proposalState?: string;
+        code?: ErrorCode;
+    });
+    /**
+     * Creates an error for proposal not found.
+     */
+    static notFound(proposalId: string): ProposalError;
+    /**
+     * Creates an error for proposal not pending.
+     */
+    static notPending(proposalId: string, currentState: string): ProposalError;
+    /**
+     * Creates an error for proposal expired.
+     */
+    static expired(proposalId: string): ProposalError;
+    toJSON(includeStack?: boolean): {
+        proposalId: string | undefined;
+        proposalState: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when document operations fail.
+ */
+export declare class DocumentError extends PromptSpeakError {
+    readonly code: ErrorCode;
+    readonly severity: ErrorSeverity;
+    /**
+     * The path or identifier of the document.
+     */
+    readonly documentPath?: string;
+    /**
+     * The format of the document.
+     */
+    readonly format?: string;
+    constructor(message: string, options?: PromptSpeakErrorOptions & {
+        documentPath?: string;
+        format?: string;
+        code?: ErrorCode;
+    });
+    /**
+     * Creates an error for document not found.
+     */
+    static notFound(path: string): DocumentError;
+    /**
+     * Creates an error for unsupported format.
+     */
+    static unsupportedFormat(format: string): DocumentError;
+    /**
+     * Creates an error for parse failure.
+     */
+    static parseError(path: string, reason?: string): DocumentError;
+    toJSON(includeStack?: boolean): {
+        documentPath: string | undefined;
+        format: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when translation/symbol resolution fails.
+ */
+export declare class TranslationError extends PromptSpeakError {
+    readonly code: ErrorCode;
+    readonly severity: ErrorSeverity;
+    /**
+     * The symbol or alias that could not be resolved.
+     */
+    readonly symbol?: string;
+    constructor(message: string, options?: PromptSpeakErrorOptions & {
+        symbol?: string;
+        code?: ErrorCode;
+    });
+    /**
+     * Creates an error for unknown symbol.
+     */
+    static unknownSymbol(symbol: string): TranslationError;
+    toJSON(includeStack?: boolean): {
+        symbol: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when database operations fail.
+ */
+export declare class DatabaseError extends PromptSpeakError {
+    readonly code: ErrorCode;
+    readonly severity: ErrorSeverity;
+    /**
+     * The operation that failed.
+     */
+    readonly operation?: string;
+    /**
+     * The table/collection involved.
+     */
+    readonly table?: string;
+    constructor(message: string, options?: PromptSpeakErrorOptions & {
+        operation?: string;
+        table?: string;
+        code?: ErrorCode;
+    });
+    /**
+     * Creates an error for database not initialized.
+     */
+    static notInitialized(component: string): DatabaseError;
+    toJSON(includeStack?: boolean): {
+        operation: string | undefined;
+        table: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown when tool operations fail.
+ */
+export declare class ToolError extends PromptSpeakError {
+    readonly code: ErrorCode;
+    readonly severity: ErrorSeverity;
+    /**
+     * The name of the tool that failed.
+     */
+    readonly toolName?: string;
+    constructor(message: string, options?: PromptSpeakErrorOptions & {
+        toolName?: string;
+        code?: ErrorCode;
+    });
+    /**
+     * Creates an error for unknown tool.
+     */
+    static unknownTool(toolName: string): ToolError;
+    toJSON(includeStack?: boolean): {
+        toolName: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+/**
+ * Error thrown for internal server errors.
+ */
+export declare class InternalError extends PromptSpeakError {
+    readonly code = ErrorCode.INTERNAL_ERROR;
+    readonly severity: ErrorSeverity;
+    constructor(message?: string, options?: PromptSpeakErrorOptions);
+}
+/**
+ * Error thrown for unimplemented features.
+ */
+export declare class NotImplementedError extends PromptSpeakError {
+    readonly code = ErrorCode.NOT_IMPLEMENTED;
+    readonly severity: ErrorSeverity;
+    /**
+     * The feature that is not implemented.
+     */
+    readonly feature?: string;
+    constructor(message?: string, options?: PromptSpeakErrorOptions & {
+        feature?: string;
+    });
+    toJSON(includeStack?: boolean): {
+        feature: string | undefined;
+        name: string;
+        message: string;
+        code: ErrorCode;
+        severity: ErrorSeverity;
+        retryable: boolean;
+        statusCode: number;
+        timestamp: string;
+        details?: Record<string, unknown>;
+        stack?: string;
+        cause?: {
+            name: string;
+            message: string;
+            stack?: string;
+        };
+    };
+}
+//# sourceMappingURL=types.d.ts.map