codemie-sdk 0.1.339 → 0.1.341

package/dist/index.d.cts

@@ -116,6 +116,161 @@ interface Integration {
     setting_type: IntegrationTypeType;
 }
 
+/**
+ * Error models for structured error handling in CodeMie SDK responses.
+ *
+ * This module provides error classification and structured error details that match
+ * the CodeMie API error response format, enabling proper error handling without
+ * parsing error messages.
+ */
+/**
+ * High-level categorization of errors in the CodeMie system.
+ *
+ * Separates errors by their source to enable proper handling and debugging.
+ */
+declare enum ErrorCategory {
+    AGENT = "agent",// Agent-level errors (execution, callbacks, etc.)
+    TOOL = "tool",// Tool execution errors (HTTP errors, timeouts, etc.)
+    LLM = "llm",// LLM provider errors (rate limits, content policy, etc.)
+    VALIDATION = "validation"
+}
+/**
+ * Specific error codes for detailed error classification.
+ *
+ * These codes enable clients to programmatically handle different error scenarios
+ * without parsing error messages.
+ */
+declare enum ErrorCode {
+    AGENT_TIMEOUT = "agent_timeout",
+    AGENT_TOKEN_LIMIT = "agent_token_limit",
+    AGENT_BUDGET_EXCEEDED = "agent_budget_exceeded",
+    AGENT_CALLBACK_FAILURE = "agent_callback_failure",
+    AGENT_NETWORK_ERROR = "agent_network_error",
+    AGENT_CONFIGURATION_ERROR = "agent_configuration_error",
+    AGENT_INTERNAL_ERROR = "agent_internal_error",
+    TOOL_AUTHENTICATION = "tool_authentication",// 401 Unauthorized
+    TOOL_AUTHORIZATION = "tool_authorization",// 403 Forbidden
+    TOOL_NOT_FOUND = "tool_not_found",// 404 Not Found
+    TOOL_CONFLICT = "tool_conflict",// 409 Conflict
+    TOOL_RATE_LIMITED = "tool_rate_limited",// 429 Too Many Requests
+    TOOL_SERVER_ERROR = "tool_server_error",// 5xx Server Error
+    TOOL_TIMEOUT = "tool_timeout",
+    TOOL_VALIDATION = "tool_validation",// Invalid tool input
+    TOOL_NETWORK_ERROR = "tool_network_error",
+    TOOL_EXECUTION_FAILED = "tool_execution_failed",// Generic tool failure
+    LLM_CONTENT_POLICY = "llm_content_policy",
+    LLM_CONTEXT_LENGTH = "llm_context_length",
+    LLM_UNAVAILABLE = "llm_unavailable",
+    LLM_RATE_LIMITED = "llm_rate_limited",
+    LLM_INVALID_REQUEST = "llm_invalid_request",
+    VALIDATION_INPUT = "validation_input",
+    VALIDATION_OUTPUT = "validation_output",
+    VALIDATION_SCHEMA = "validation_schema"
+}
+/**
+ * Structured details for a tool execution error.
+ *
+ * Captures comprehensive information about tool failures to enable proper
+ * debugging and error handling without relying on the LLM to interpret errors.
+ */
+interface ToolErrorDetails {
+    /** Name of the tool that encountered an error */
+    tool_name: string;
+    /** Unique identifier for the tool call */
+    tool_call_id?: string;
+    /** Classified error code for programmatic handling */
+    error_code: ErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** HTTP status code if applicable (401, 403, 404, 5xx, etc.) */
+    http_status?: number;
+    /** Additional error context (integration name, action, etc.) */
+    details?: Record<string, unknown>;
+    /** ISO 8601 timestamp of when error occurred */
+    timestamp: string;
+}
+/**
+ * Error verbosity level for API responses.
+ *
+ * Controls how much detail is included in tool error responses:
+ * - Minimal: Only error code and message (for production clients)
+ * - Standard: Adds HTTP status and tool_call_id (default, for debugging)
+ * - Full: Includes all details including timestamp (for development)
+ */
+declare enum ErrorDetailLevel {
+    Minimal = "minimal",
+    Standard = "standard",
+    Full = "full"
+}
+/**
+ * Structured details for an agent-level error.
+ *
+ * Captures agent execution failures that are not related to specific tools,
+ * such as token limits, budget constraints, or internal errors.
+ */
+interface AgentErrorDetails {
+    /** Classified error code for programmatic handling */
+    error_code: ErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** Additional error context */
+    details?: Record<string, unknown>;
+    /** Full stacktrace for debugging (only in debug mode) */
+    stacktrace?: string;
+}
+/**
+ * Complete error response with separated agent and tool errors.
+ *
+ * This structure ensures that errors from different sources are clearly
+ * distinguished and not absorbed by the LLM's response text.
+ */
+interface ErrorResponse {
+    /** High-level error category */
+    category: ErrorCategory;
+    /** Agent-level error details (if applicable) */
+    agent_error?: AgentErrorDetails;
+    /** Tool error details (multiple tools can fail) */
+    tool_errors?: ToolErrorDetails[];
+    /** Whether the error is recoverable */
+    is_recoverable: boolean;
+}
+/**
+ * Format tool error details to minimal format (code + message only).
+ */
+declare function formatToolErrorMinimal(error: ToolErrorDetails): Record<string, unknown>;
+/**
+ * Format tool error details to standard format (+ http_status, tool_call_id).
+ */
+declare function formatToolErrorStandard(error: ToolErrorDetails): Record<string, unknown>;
+/**
+ * Format tool error details to full format (all fields).
+ */
+declare function formatToolErrorFull(error: ToolErrorDetails): Record<string, unknown>;
+/**
+ * Format tool error details based on verbosity level.
+ */
+declare function formatToolErrorForLevel(error: ToolErrorDetails, level: ErrorDetailLevel): Record<string, unknown>;
+/**
+ * HTTP status code to error code mapping.
+ */
+declare const HTTP_STATUS_TO_ERROR_CODE: Record<number, ErrorCode>;
+/**
+ * Error message keywords to error code mapping.
+ */
+declare const ERROR_MESSAGE_PATTERNS: Record<string, ErrorCode>;
+/**
+ * Classify HTTP status codes into appropriate ErrorCode values.
+ *
+ * Uses a two-stage classification approach:
+ * 1. Primary: Classification by HTTP status code using dictionary mapping
+ * 2. Fallback: If status yields generic result, analyze error message content
+ */
+declare function classifyHttpError(statusCode: number, errorMessage?: string): ErrorCode;
+/**
+ * Determine if an error is recoverable (can be retried).
+ */
+declare function isRecoverableError(errorCode: ErrorCode): boolean;
+
 /** Models for assistant-related data structures. */
 
 declare enum ContextType {
@@ -215,19 +370,36 @@ interface Assistant extends AssistantBase {
     user_abilities?: unknown[];
     version_count?: number;
 }
+/**
+ * API response for assistant chat (camelCase format from API).
+ *
+ * Error fields expose agent and tool errors.
+ */
 interface BaseModelApiResponse {
     generated: string;
     timeElapsed?: number;
     tokensUsed?: number;
     thoughts?: Record<string, unknown>[];
     taskId?: string;
+    success?: boolean;
+    agentError?: AgentErrorDetails;
+    toolErrors?: ToolErrorDetails[];
 }
+/**
+ * Client-facing response for assistant chat (snake_case format).
+ *
+ * Error fields expose agent and tool errors without breaking backward
+ * compatibility (all error fields optional).
+ */
 interface BaseModelResponse {
     generated: string | object | unknown;
     time_elapsed?: number;
     tokens_used?: number;
     thoughts?: Record<string, unknown>[];
     task_id?: string;
+    success?: boolean;
+    agent_error?: AgentErrorDetails;
+    tool_errors?: ToolErrorDetails[];
 }
 interface AssistantVersion {
     version_number: number;
@@ -1800,4 +1972,4 @@ declare class NotFoundError extends ApiError {
     constructor(resourceType: string, resourceId: string);
 }
 
-export { type AboutUser, type AboutUserResponse, type AnyJson, ApiError, type Assistant, type AssistantBase, type AssistantCategory, type AssistantChatParams, AssistantChatParamsSchema, type AssistantCreateParams, AssistantCreateParamsSchema, type AssistantCreateResponse, type AssistantDataItem, type AssistantDetailsData, type AssistantListParams, AssistantListParamsSchema, type AssistantUpdateParams, AssistantUpdateParamsSchema, type AssistantUpdateResponse, type AssistantVersion, type AssistantVersionsListParams, AssistantVersionsListParamsSchema, type AuthConfig, type BackgroundTaskEntity, BackgroundTaskStatus, type BackgroundTaskStatusType, type BaseCodeParams, type BaseConfluenceParams, type BaseDataSourceCreateDto, type BaseDataSourceCreateParams, type BaseDataSourceResponse, type BaseDataSourceUpdateDto, type BaseDataSourceUpdateParams, type BaseFileParams, type BaseGoogleParams, type BaseJiraParams, type BaseModelApiResponse, type BaseModelResponse, type BaseUser, ChatRole, type Code, type CodeDataSourceCreateDto, type CodeDataSourceCreateParams, type CodeDataSourceResponse, CodeDataSourceType, type CodeDataSourceTypeType, type CodeDataSourceUpdateDto, type CodeDataSourceUpdateParams, CodeMieClient, type CodeMieClientConfig, CodeMieError, type Confluence, type ConfluenceDataSourceCreateDto, type ConfluenceDataSourceCreateParams, type ConfluenceDataSourceUpdateDto, type ConfluenceDataSourceUpdateParams, type Context, type ContextItem, ContextType, type Conversation, type ConversationCreateParams, ConversationCreateParamsSchema, type ConversationCreateRequest, type ConversationDetails, type ConversationDetailsData, type CostConfig, CredentialTypes, type CredentialTypesType, type CredentialValues, type DataSource, type DataSourceCreateDto, type DataSourceCreateParams, type DataSourceListParams, type DataSourceProcessingInfo, type DataSourceProcessingInfoResponse, type DataSourceResponse, DataSourceStatus, type DataSourceStatusType, DataSourceType, type DataSourceTypeType, type DataSourceUpdateDto, type DataSourceUpdateParams, ExecutionStatus, type ExecutionStatusType, type File, type FileDataSourceCreateDto, type FileDataSourceCreateParams, type FileDataSourceUpdateDto, type FileDataSourceUpdateParams, type Files, type Google, type GoogleDataSourceCreateDto, type GoogleDataSourceCreateParams, type GoogleDataSourceUpdateDto, type GoogleDataSourceUpdateParams, type HistoryItem, type HistoryMark, type Integration, type IntegrationCreateParams, IntegrationCreateParamsSchema, type IntegrationGetByAliasParams, IntegrationGetByAliasParamsSchema, type IntegrationGetParams, IntegrationGetParamsSchema, type IntegrationListParams, IntegrationListParamsSchema, IntegrationType, type IntegrationTypeType, type IntegrationUpdateParams, IntegrationUpdateParamsSchema, type IntegrationValidationResult, type Jira, type JiraDataSourceCreateDto, type JiraDataSourceCreateParams, type JiraDataSourceUpdateDto, type JiraDataSourceUpdateParams, type LLMFeatures, type LLMModel, LLMProvider, type LLMProviderType, type MCPServerConfig, type MCPServerDetails, type Mark, type MissingIntegration, type MissingIntegrationsByCredentialType, NotFoundError, type Operator, type OtherDataSourceCreateParams, type OtherDataSourceUpdateParams, type PaginatedResponse, type PaginationParams, type PromptVariable, type SortOrder, type SystemPromptHistory, type TaskUser, type Thought, type TokensUsage, type ToolDetails, type ToolItem, type ToolKitDetails, type UserData, type Workflow, type WorkflowCreateParams, WorkflowCreateParamsSchema, type WorkflowExecution, type WorkflowExecutionCreateParams, WorkflowExecutionCreateParamsSchema, type WorkflowExecutionListParams, WorkflowExecutionListParamsSchema, type WorkflowExecutionResponse, type WorkflowExecutionState, type WorkflowExecutionStateListParams, WorkflowExecutionStateListParamsSchema, type WorkflowExecutionStateOutput, type WorkflowExecutionStateThought, type WorkflowListParams, WorkflowListParamsSchema, WorkflowMode, type WorkflowModeType, type WorkflowResponse, type WorkflowUpdateParams, WorkflowUpdateParamsSchema, formatCookies };
+export { type AboutUser, type AboutUserResponse, type AgentErrorDetails, type AnyJson, ApiError, type Assistant, type AssistantBase, type AssistantCategory, type AssistantChatParams, AssistantChatParamsSchema, type AssistantCreateParams, AssistantCreateParamsSchema, type AssistantCreateResponse, type AssistantDataItem, type AssistantDetailsData, type AssistantListParams, AssistantListParamsSchema, type AssistantUpdateParams, AssistantUpdateParamsSchema, type AssistantUpdateResponse, type AssistantVersion, type AssistantVersionsListParams, AssistantVersionsListParamsSchema, type AuthConfig, type BackgroundTaskEntity, BackgroundTaskStatus, type BackgroundTaskStatusType, type BaseCodeParams, type BaseConfluenceParams, type BaseDataSourceCreateDto, type BaseDataSourceCreateParams, type BaseDataSourceResponse, type BaseDataSourceUpdateDto, type BaseDataSourceUpdateParams, type BaseFileParams, type BaseGoogleParams, type BaseJiraParams, type BaseModelApiResponse, type BaseModelResponse, type BaseUser, ChatRole, type Code, type CodeDataSourceCreateDto, type CodeDataSourceCreateParams, type CodeDataSourceResponse, CodeDataSourceType, type CodeDataSourceTypeType, type CodeDataSourceUpdateDto, type CodeDataSourceUpdateParams, CodeMieClient, type CodeMieClientConfig, CodeMieError, type Confluence, type ConfluenceDataSourceCreateDto, type ConfluenceDataSourceCreateParams, type ConfluenceDataSourceUpdateDto, type ConfluenceDataSourceUpdateParams, type Context, type ContextItem, ContextType, type Conversation, type ConversationCreateParams, ConversationCreateParamsSchema, type ConversationCreateRequest, type ConversationDetails, type ConversationDetailsData, type CostConfig, CredentialTypes, type CredentialTypesType, type CredentialValues, type DataSource, type DataSourceCreateDto, type DataSourceCreateParams, type DataSourceListParams, type DataSourceProcessingInfo, type DataSourceProcessingInfoResponse, type DataSourceResponse, DataSourceStatus, type DataSourceStatusType, DataSourceType, type DataSourceTypeType, type DataSourceUpdateDto, type DataSourceUpdateParams, ERROR_MESSAGE_PATTERNS, ErrorCategory, ErrorCode, ErrorDetailLevel, type ErrorResponse, ExecutionStatus, type ExecutionStatusType, type File, type FileDataSourceCreateDto, type FileDataSourceCreateParams, type FileDataSourceUpdateDto, type FileDataSourceUpdateParams, type Files, type Google, type GoogleDataSourceCreateDto, type GoogleDataSourceCreateParams, type GoogleDataSourceUpdateDto, type GoogleDataSourceUpdateParams, HTTP_STATUS_TO_ERROR_CODE, type HistoryItem, type HistoryMark, type Integration, type IntegrationCreateParams, IntegrationCreateParamsSchema, type IntegrationGetByAliasParams, IntegrationGetByAliasParamsSchema, type IntegrationGetParams, IntegrationGetParamsSchema, type IntegrationListParams, IntegrationListParamsSchema, IntegrationType, type IntegrationTypeType, type IntegrationUpdateParams, IntegrationUpdateParamsSchema, type IntegrationValidationResult, type Jira, type JiraDataSourceCreateDto, type JiraDataSourceCreateParams, type JiraDataSourceUpdateDto, type JiraDataSourceUpdateParams, type LLMFeatures, type LLMModel, LLMProvider, type LLMProviderType, type MCPServerConfig, type MCPServerDetails, type Mark, type MissingIntegration, type MissingIntegrationsByCredentialType, NotFoundError, type Operator, type OtherDataSourceCreateParams, type OtherDataSourceUpdateParams, type PaginatedResponse, type PaginationParams, type PromptVariable, type SortOrder, type SystemPromptHistory, type TaskUser, type Thought, type TokensUsage, type ToolDetails, type ToolErrorDetails, type ToolItem, type ToolKitDetails, type UserData, type Workflow, type WorkflowCreateParams, WorkflowCreateParamsSchema, type WorkflowExecution, type WorkflowExecutionCreateParams, WorkflowExecutionCreateParamsSchema, type WorkflowExecutionListParams, WorkflowExecutionListParamsSchema, type WorkflowExecutionResponse, type WorkflowExecutionState, type WorkflowExecutionStateListParams, WorkflowExecutionStateListParamsSchema, type WorkflowExecutionStateOutput, type WorkflowExecutionStateThought, type WorkflowListParams, WorkflowListParamsSchema, WorkflowMode, type WorkflowModeType, type WorkflowResponse, type WorkflowUpdateParams, WorkflowUpdateParamsSchema, classifyHttpError, formatCookies, formatToolErrorForLevel, formatToolErrorFull, formatToolErrorMinimal, formatToolErrorStandard, isRecoverableError };

package/dist/index.d.ts

@@ -116,6 +116,161 @@ interface Integration {
     setting_type: IntegrationTypeType;
 }
 
+/**
+ * Error models for structured error handling in CodeMie SDK responses.
+ *
+ * This module provides error classification and structured error details that match
+ * the CodeMie API error response format, enabling proper error handling without
+ * parsing error messages.
+ */
+/**
+ * High-level categorization of errors in the CodeMie system.
+ *
+ * Separates errors by their source to enable proper handling and debugging.
+ */
+declare enum ErrorCategory {
+    AGENT = "agent",// Agent-level errors (execution, callbacks, etc.)
+    TOOL = "tool",// Tool execution errors (HTTP errors, timeouts, etc.)
+    LLM = "llm",// LLM provider errors (rate limits, content policy, etc.)
+    VALIDATION = "validation"
+}
+/**
+ * Specific error codes for detailed error classification.
+ *
+ * These codes enable clients to programmatically handle different error scenarios
+ * without parsing error messages.
+ */
+declare enum ErrorCode {
+    AGENT_TIMEOUT = "agent_timeout",
+    AGENT_TOKEN_LIMIT = "agent_token_limit",
+    AGENT_BUDGET_EXCEEDED = "agent_budget_exceeded",
+    AGENT_CALLBACK_FAILURE = "agent_callback_failure",
+    AGENT_NETWORK_ERROR = "agent_network_error",
+    AGENT_CONFIGURATION_ERROR = "agent_configuration_error",
+    AGENT_INTERNAL_ERROR = "agent_internal_error",
+    TOOL_AUTHENTICATION = "tool_authentication",// 401 Unauthorized
+    TOOL_AUTHORIZATION = "tool_authorization",// 403 Forbidden
+    TOOL_NOT_FOUND = "tool_not_found",// 404 Not Found
+    TOOL_CONFLICT = "tool_conflict",// 409 Conflict
+    TOOL_RATE_LIMITED = "tool_rate_limited",// 429 Too Many Requests
+    TOOL_SERVER_ERROR = "tool_server_error",// 5xx Server Error
+    TOOL_TIMEOUT = "tool_timeout",
+    TOOL_VALIDATION = "tool_validation",// Invalid tool input
+    TOOL_NETWORK_ERROR = "tool_network_error",
+    TOOL_EXECUTION_FAILED = "tool_execution_failed",// Generic tool failure
+    LLM_CONTENT_POLICY = "llm_content_policy",
+    LLM_CONTEXT_LENGTH = "llm_context_length",
+    LLM_UNAVAILABLE = "llm_unavailable",
+    LLM_RATE_LIMITED = "llm_rate_limited",
+    LLM_INVALID_REQUEST = "llm_invalid_request",
+    VALIDATION_INPUT = "validation_input",
+    VALIDATION_OUTPUT = "validation_output",
+    VALIDATION_SCHEMA = "validation_schema"
+}
+/**
+ * Structured details for a tool execution error.
+ *
+ * Captures comprehensive information about tool failures to enable proper
+ * debugging and error handling without relying on the LLM to interpret errors.
+ */
+interface ToolErrorDetails {
+    /** Name of the tool that encountered an error */
+    tool_name: string;
+    /** Unique identifier for the tool call */
+    tool_call_id?: string;
+    /** Classified error code for programmatic handling */
+    error_code: ErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** HTTP status code if applicable (401, 403, 404, 5xx, etc.) */
+    http_status?: number;
+    /** Additional error context (integration name, action, etc.) */
+    details?: Record<string, unknown>;
+    /** ISO 8601 timestamp of when error occurred */
+    timestamp: string;
+}
+/**
+ * Error verbosity level for API responses.
+ *
+ * Controls how much detail is included in tool error responses:
+ * - Minimal: Only error code and message (for production clients)
+ * - Standard: Adds HTTP status and tool_call_id (default, for debugging)
+ * - Full: Includes all details including timestamp (for development)
+ */
+declare enum ErrorDetailLevel {
+    Minimal = "minimal",
+    Standard = "standard",
+    Full = "full"
+}
+/**
+ * Structured details for an agent-level error.
+ *
+ * Captures agent execution failures that are not related to specific tools,
+ * such as token limits, budget constraints, or internal errors.
+ */
+interface AgentErrorDetails {
+    /** Classified error code for programmatic handling */
+    error_code: ErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** Additional error context */
+    details?: Record<string, unknown>;
+    /** Full stacktrace for debugging (only in debug mode) */
+    stacktrace?: string;
+}
+/**
+ * Complete error response with separated agent and tool errors.
+ *
+ * This structure ensures that errors from different sources are clearly
+ * distinguished and not absorbed by the LLM's response text.
+ */
+interface ErrorResponse {
+    /** High-level error category */
+    category: ErrorCategory;
+    /** Agent-level error details (if applicable) */
+    agent_error?: AgentErrorDetails;
+    /** Tool error details (multiple tools can fail) */
+    tool_errors?: ToolErrorDetails[];
+    /** Whether the error is recoverable */
+    is_recoverable: boolean;
+}
+/**
+ * Format tool error details to minimal format (code + message only).
+ */
+declare function formatToolErrorMinimal(error: ToolErrorDetails): Record<string, unknown>;
+/**
+ * Format tool error details to standard format (+ http_status, tool_call_id).
+ */
+declare function formatToolErrorStandard(error: ToolErrorDetails): Record<string, unknown>;
+/**
+ * Format tool error details to full format (all fields).
+ */
+declare function formatToolErrorFull(error: ToolErrorDetails): Record<string, unknown>;
+/**
+ * Format tool error details based on verbosity level.
+ */
+declare function formatToolErrorForLevel(error: ToolErrorDetails, level: ErrorDetailLevel): Record<string, unknown>;
+/**
+ * HTTP status code to error code mapping.
+ */
+declare const HTTP_STATUS_TO_ERROR_CODE: Record<number, ErrorCode>;
+/**
+ * Error message keywords to error code mapping.
+ */
+declare const ERROR_MESSAGE_PATTERNS: Record<string, ErrorCode>;
+/**
+ * Classify HTTP status codes into appropriate ErrorCode values.
+ *
+ * Uses a two-stage classification approach:
+ * 1. Primary: Classification by HTTP status code using dictionary mapping
+ * 2. Fallback: If status yields generic result, analyze error message content
+ */
+declare function classifyHttpError(statusCode: number, errorMessage?: string): ErrorCode;
+/**
+ * Determine if an error is recoverable (can be retried).
+ */
+declare function isRecoverableError(errorCode: ErrorCode): boolean;
+
 /** Models for assistant-related data structures. */
 
 declare enum ContextType {
@@ -215,19 +370,36 @@ interface Assistant extends AssistantBase {
     user_abilities?: unknown[];
     version_count?: number;
 }
+/**
+ * API response for assistant chat (camelCase format from API).
+ *
+ * Error fields expose agent and tool errors.
+ */
 interface BaseModelApiResponse {
     generated: string;
     timeElapsed?: number;
     tokensUsed?: number;
     thoughts?: Record<string, unknown>[];
     taskId?: string;
+    success?: boolean;
+    agentError?: AgentErrorDetails;
+    toolErrors?: ToolErrorDetails[];
 }
+/**
+ * Client-facing response for assistant chat (snake_case format).
+ *
+ * Error fields expose agent and tool errors without breaking backward
+ * compatibility (all error fields optional).
+ */
 interface BaseModelResponse {
     generated: string | object | unknown;
     time_elapsed?: number;
     tokens_used?: number;
     thoughts?: Record<string, unknown>[];
     task_id?: string;
+    success?: boolean;
+    agent_error?: AgentErrorDetails;
+    tool_errors?: ToolErrorDetails[];
 }
 interface AssistantVersion {
     version_number: number;
@@ -1800,4 +1972,4 @@ declare class NotFoundError extends ApiError {
     constructor(resourceType: string, resourceId: string);
 }
 
-export { type AboutUser, type AboutUserResponse, type AnyJson, ApiError, type Assistant, type AssistantBase, type AssistantCategory, type AssistantChatParams, AssistantChatParamsSchema, type AssistantCreateParams, AssistantCreateParamsSchema, type AssistantCreateResponse, type AssistantDataItem, type AssistantDetailsData, type AssistantListParams, AssistantListParamsSchema, type AssistantUpdateParams, AssistantUpdateParamsSchema, type AssistantUpdateResponse, type AssistantVersion, type AssistantVersionsListParams, AssistantVersionsListParamsSchema, type AuthConfig, type BackgroundTaskEntity, BackgroundTaskStatus, type BackgroundTaskStatusType, type BaseCodeParams, type BaseConfluenceParams, type BaseDataSourceCreateDto, type BaseDataSourceCreateParams, type BaseDataSourceResponse, type BaseDataSourceUpdateDto, type BaseDataSourceUpdateParams, type BaseFileParams, type BaseGoogleParams, type BaseJiraParams, type BaseModelApiResponse, type BaseModelResponse, type BaseUser, ChatRole, type Code, type CodeDataSourceCreateDto, type CodeDataSourceCreateParams, type CodeDataSourceResponse, CodeDataSourceType, type CodeDataSourceTypeType, type CodeDataSourceUpdateDto, type CodeDataSourceUpdateParams, CodeMieClient, type CodeMieClientConfig, CodeMieError, type Confluence, type ConfluenceDataSourceCreateDto, type ConfluenceDataSourceCreateParams, type ConfluenceDataSourceUpdateDto, type ConfluenceDataSourceUpdateParams, type Context, type ContextItem, ContextType, type Conversation, type ConversationCreateParams, ConversationCreateParamsSchema, type ConversationCreateRequest, type ConversationDetails, type ConversationDetailsData, type CostConfig, CredentialTypes, type CredentialTypesType, type CredentialValues, type DataSource, type DataSourceCreateDto, type DataSourceCreateParams, type DataSourceListParams, type DataSourceProcessingInfo, type DataSourceProcessingInfoResponse, type DataSourceResponse, DataSourceStatus, type DataSourceStatusType, DataSourceType, type DataSourceTypeType, type DataSourceUpdateDto, type DataSourceUpdateParams, ExecutionStatus, type ExecutionStatusType, type File, type FileDataSourceCreateDto, type FileDataSourceCreateParams, type FileDataSourceUpdateDto, type FileDataSourceUpdateParams, type Files, type Google, type GoogleDataSourceCreateDto, type GoogleDataSourceCreateParams, type GoogleDataSourceUpdateDto, type GoogleDataSourceUpdateParams, type HistoryItem, type HistoryMark, type Integration, type IntegrationCreateParams, IntegrationCreateParamsSchema, type IntegrationGetByAliasParams, IntegrationGetByAliasParamsSchema, type IntegrationGetParams, IntegrationGetParamsSchema, type IntegrationListParams, IntegrationListParamsSchema, IntegrationType, type IntegrationTypeType, type IntegrationUpdateParams, IntegrationUpdateParamsSchema, type IntegrationValidationResult, type Jira, type JiraDataSourceCreateDto, type JiraDataSourceCreateParams, type JiraDataSourceUpdateDto, type JiraDataSourceUpdateParams, type LLMFeatures, type LLMModel, LLMProvider, type LLMProviderType, type MCPServerConfig, type MCPServerDetails, type Mark, type MissingIntegration, type MissingIntegrationsByCredentialType, NotFoundError, type Operator, type OtherDataSourceCreateParams, type OtherDataSourceUpdateParams, type PaginatedResponse, type PaginationParams, type PromptVariable, type SortOrder, type SystemPromptHistory, type TaskUser, type Thought, type TokensUsage, type ToolDetails, type ToolItem, type ToolKitDetails, type UserData, type Workflow, type WorkflowCreateParams, WorkflowCreateParamsSchema, type WorkflowExecution, type WorkflowExecutionCreateParams, WorkflowExecutionCreateParamsSchema, type WorkflowExecutionListParams, WorkflowExecutionListParamsSchema, type WorkflowExecutionResponse, type WorkflowExecutionState, type WorkflowExecutionStateListParams, WorkflowExecutionStateListParamsSchema, type WorkflowExecutionStateOutput, type WorkflowExecutionStateThought, type WorkflowListParams, WorkflowListParamsSchema, WorkflowMode, type WorkflowModeType, type WorkflowResponse, type WorkflowUpdateParams, WorkflowUpdateParamsSchema, formatCookies };
+export { type AboutUser, type AboutUserResponse, type AgentErrorDetails, type AnyJson, ApiError, type Assistant, type AssistantBase, type AssistantCategory, type AssistantChatParams, AssistantChatParamsSchema, type AssistantCreateParams, AssistantCreateParamsSchema, type AssistantCreateResponse, type AssistantDataItem, type AssistantDetailsData, type AssistantListParams, AssistantListParamsSchema, type AssistantUpdateParams, AssistantUpdateParamsSchema, type AssistantUpdateResponse, type AssistantVersion, type AssistantVersionsListParams, AssistantVersionsListParamsSchema, type AuthConfig, type BackgroundTaskEntity, BackgroundTaskStatus, type BackgroundTaskStatusType, type BaseCodeParams, type BaseConfluenceParams, type BaseDataSourceCreateDto, type BaseDataSourceCreateParams, type BaseDataSourceResponse, type BaseDataSourceUpdateDto, type BaseDataSourceUpdateParams, type BaseFileParams, type BaseGoogleParams, type BaseJiraParams, type BaseModelApiResponse, type BaseModelResponse, type BaseUser, ChatRole, type Code, type CodeDataSourceCreateDto, type CodeDataSourceCreateParams, type CodeDataSourceResponse, CodeDataSourceType, type CodeDataSourceTypeType, type CodeDataSourceUpdateDto, type CodeDataSourceUpdateParams, CodeMieClient, type CodeMieClientConfig, CodeMieError, type Confluence, type ConfluenceDataSourceCreateDto, type ConfluenceDataSourceCreateParams, type ConfluenceDataSourceUpdateDto, type ConfluenceDataSourceUpdateParams, type Context, type ContextItem, ContextType, type Conversation, type ConversationCreateParams, ConversationCreateParamsSchema, type ConversationCreateRequest, type ConversationDetails, type ConversationDetailsData, type CostConfig, CredentialTypes, type CredentialTypesType, type CredentialValues, type DataSource, type DataSourceCreateDto, type DataSourceCreateParams, type DataSourceListParams, type DataSourceProcessingInfo, type DataSourceProcessingInfoResponse, type DataSourceResponse, DataSourceStatus, type DataSourceStatusType, DataSourceType, type DataSourceTypeType, type DataSourceUpdateDto, type DataSourceUpdateParams, ERROR_MESSAGE_PATTERNS, ErrorCategory, ErrorCode, ErrorDetailLevel, type ErrorResponse, ExecutionStatus, type ExecutionStatusType, type File, type FileDataSourceCreateDto, type FileDataSourceCreateParams, type FileDataSourceUpdateDto, type FileDataSourceUpdateParams, type Files, type Google, type GoogleDataSourceCreateDto, type GoogleDataSourceCreateParams, type GoogleDataSourceUpdateDto, type GoogleDataSourceUpdateParams, HTTP_STATUS_TO_ERROR_CODE, type HistoryItem, type HistoryMark, type Integration, type IntegrationCreateParams, IntegrationCreateParamsSchema, type IntegrationGetByAliasParams, IntegrationGetByAliasParamsSchema, type IntegrationGetParams, IntegrationGetParamsSchema, type IntegrationListParams, IntegrationListParamsSchema, IntegrationType, type IntegrationTypeType, type IntegrationUpdateParams, IntegrationUpdateParamsSchema, type IntegrationValidationResult, type Jira, type JiraDataSourceCreateDto, type JiraDataSourceCreateParams, type JiraDataSourceUpdateDto, type JiraDataSourceUpdateParams, type LLMFeatures, type LLMModel, LLMProvider, type LLMProviderType, type MCPServerConfig, type MCPServerDetails, type Mark, type MissingIntegration, type MissingIntegrationsByCredentialType, NotFoundError, type Operator, type OtherDataSourceCreateParams, type OtherDataSourceUpdateParams, type PaginatedResponse, type PaginationParams, type PromptVariable, type SortOrder, type SystemPromptHistory, type TaskUser, type Thought, type TokensUsage, type ToolDetails, type ToolErrorDetails, type ToolItem, type ToolKitDetails, type UserData, type Workflow, type WorkflowCreateParams, WorkflowCreateParamsSchema, type WorkflowExecution, type WorkflowExecutionCreateParams, WorkflowExecutionCreateParamsSchema, type WorkflowExecutionListParams, WorkflowExecutionListParamsSchema, type WorkflowExecutionResponse, type WorkflowExecutionState, type WorkflowExecutionStateListParams, WorkflowExecutionStateListParamsSchema, type WorkflowExecutionStateOutput, type WorkflowExecutionStateThought, type WorkflowListParams, WorkflowListParamsSchema, WorkflowMode, type WorkflowModeType, type WorkflowResponse, type WorkflowUpdateParams, WorkflowUpdateParamsSchema, classifyHttpError, formatCookies, formatToolErrorForLevel, formatToolErrorFull, formatToolErrorMinimal, formatToolErrorStandard, isRecoverableError };

package/dist/index.js

@@ -1570,6 +1570,143 @@ var ChatRole = /* @__PURE__ */ ((ChatRole2) => {
   return ChatRole2;
 })(ChatRole || {});
 
+// src/models/errors.ts
+var ErrorCategory = /* @__PURE__ */ ((ErrorCategory2) => {
+  ErrorCategory2["AGENT"] = "agent";
+  ErrorCategory2["TOOL"] = "tool";
+  ErrorCategory2["LLM"] = "llm";
+  ErrorCategory2["VALIDATION"] = "validation";
+  return ErrorCategory2;
+})(ErrorCategory || {});
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["AGENT_TIMEOUT"] = "agent_timeout";
+  ErrorCode2["AGENT_TOKEN_LIMIT"] = "agent_token_limit";
+  ErrorCode2["AGENT_BUDGET_EXCEEDED"] = "agent_budget_exceeded";
+  ErrorCode2["AGENT_CALLBACK_FAILURE"] = "agent_callback_failure";
+  ErrorCode2["AGENT_NETWORK_ERROR"] = "agent_network_error";
+  ErrorCode2["AGENT_CONFIGURATION_ERROR"] = "agent_configuration_error";
+  ErrorCode2["AGENT_INTERNAL_ERROR"] = "agent_internal_error";
+  ErrorCode2["TOOL_AUTHENTICATION"] = "tool_authentication";
+  ErrorCode2["TOOL_AUTHORIZATION"] = "tool_authorization";
+  ErrorCode2["TOOL_NOT_FOUND"] = "tool_not_found";
+  ErrorCode2["TOOL_CONFLICT"] = "tool_conflict";
+  ErrorCode2["TOOL_RATE_LIMITED"] = "tool_rate_limited";
+  ErrorCode2["TOOL_SERVER_ERROR"] = "tool_server_error";
+  ErrorCode2["TOOL_TIMEOUT"] = "tool_timeout";
+  ErrorCode2["TOOL_VALIDATION"] = "tool_validation";
+  ErrorCode2["TOOL_NETWORK_ERROR"] = "tool_network_error";
+  ErrorCode2["TOOL_EXECUTION_FAILED"] = "tool_execution_failed";
+  ErrorCode2["LLM_CONTENT_POLICY"] = "llm_content_policy";
+  ErrorCode2["LLM_CONTEXT_LENGTH"] = "llm_context_length";
+  ErrorCode2["LLM_UNAVAILABLE"] = "llm_unavailable";
+  ErrorCode2["LLM_RATE_LIMITED"] = "llm_rate_limited";
+  ErrorCode2["LLM_INVALID_REQUEST"] = "llm_invalid_request";
+  ErrorCode2["VALIDATION_INPUT"] = "validation_input";
+  ErrorCode2["VALIDATION_OUTPUT"] = "validation_output";
+  ErrorCode2["VALIDATION_SCHEMA"] = "validation_schema";
+  return ErrorCode2;
+})(ErrorCode || {});
+var ErrorDetailLevel = /* @__PURE__ */ ((ErrorDetailLevel2) => {
+  ErrorDetailLevel2["Minimal"] = "minimal";
+  ErrorDetailLevel2["Standard"] = "standard";
+  ErrorDetailLevel2["Full"] = "full";
+  return ErrorDetailLevel2;
+})(ErrorDetailLevel || {});
+function formatToolErrorMinimal(error) {
+  return {
+    tool_name: error.tool_name,
+    error_code: error.error_code,
+    message: error.message
+  };
+}
+function formatToolErrorStandard(error) {
+  return {
+    tool_name: error.tool_name,
+    tool_call_id: error.tool_call_id,
+    error_code: error.error_code,
+    message: error.message,
+    http_status: error.http_status
+  };
+}
+function formatToolErrorFull(error) {
+  return { ...error };
+}
+function formatToolErrorForLevel(error, level) {
+  switch (level) {
+    case "minimal" /* Minimal */:
+      return formatToolErrorMinimal(error);
+    case "standard" /* Standard */:
+      return formatToolErrorStandard(error);
+    case "full" /* Full */:
+      return formatToolErrorFull(error);
+  }
+}
+var HTTP_STATUS_TO_ERROR_CODE = {
+  // Client errors (4xx)
+  401: "tool_authentication" /* TOOL_AUTHENTICATION */,
+  403: "tool_authorization" /* TOOL_AUTHORIZATION */,
+  404: "tool_not_found" /* TOOL_NOT_FOUND */,
+  409: "tool_conflict" /* TOOL_CONFLICT */,
+  429: "tool_rate_limited" /* TOOL_RATE_LIMITED */,
+  // Server errors (5xx)
+  500: "tool_server_error" /* TOOL_SERVER_ERROR */,
+  501: "tool_server_error" /* TOOL_SERVER_ERROR */,
+  502: "tool_server_error" /* TOOL_SERVER_ERROR */,
+  503: "tool_server_error" /* TOOL_SERVER_ERROR */,
+  504: "tool_server_error" /* TOOL_SERVER_ERROR */,
+  505: "tool_server_error" /* TOOL_SERVER_ERROR */,
+  506: "tool_server_error" /* TOOL_SERVER_ERROR */,
+  507: "tool_server_error" /* TOOL_SERVER_ERROR */,
+  508: "tool_server_error" /* TOOL_SERVER_ERROR */,
+  509: "tool_server_error" /* TOOL_SERVER_ERROR */,
+  510: "tool_server_error" /* TOOL_SERVER_ERROR */,
+  511: "tool_server_error" /* TOOL_SERVER_ERROR */
+};
+var ERROR_MESSAGE_PATTERNS = {
+  timeout: "tool_timeout" /* TOOL_TIMEOUT */,
+  network: "tool_network_error" /* TOOL_NETWORK_ERROR */,
+  connection: "tool_network_error" /* TOOL_NETWORK_ERROR */,
+  validation: "tool_validation" /* TOOL_VALIDATION */,
+  invalid: "tool_validation" /* TOOL_VALIDATION */
+};
+function classifyByHttpStatus(statusCode) {
+  if (statusCode in HTTP_STATUS_TO_ERROR_CODE) {
+    return HTTP_STATUS_TO_ERROR_CODE[statusCode];
+  }
+  if (statusCode >= 500 && statusCode < 600) {
+    return "tool_server_error" /* TOOL_SERVER_ERROR */;
+  }
+  return "tool_execution_failed" /* TOOL_EXECUTION_FAILED */;
+}
+function classifyByMessage(errorMessage) {
+  const errorLower = errorMessage.toLowerCase();
+  for (const [keyword, errorCode] of Object.entries(ERROR_MESSAGE_PATTERNS)) {
+    if (errorLower.includes(keyword)) {
+      return errorCode;
+    }
+  }
+  return "tool_execution_failed" /* TOOL_EXECUTION_FAILED */;
+}
+function classifyHttpError(statusCode, errorMessage = "") {
+  let errorCode = classifyByHttpStatus(statusCode);
+  if (errorCode === "tool_execution_failed" /* TOOL_EXECUTION_FAILED */ && errorMessage) {
+    errorCode = classifyByMessage(errorMessage);
+  }
+  return errorCode;
+}
+function isRecoverableError(errorCode) {
+  const recoverableErrors = /* @__PURE__ */ new Set([
+    "tool_timeout" /* TOOL_TIMEOUT */,
+    "tool_rate_limited" /* TOOL_RATE_LIMITED */,
+    "tool_server_error" /* TOOL_SERVER_ERROR */,
+    "tool_network_error" /* TOOL_NETWORK_ERROR */,
+    "agent_network_error" /* AGENT_NETWORK_ERROR */,
+    "llm_rate_limited" /* LLM_RATE_LIMITED */,
+    "llm_unavailable" /* LLM_UNAVAILABLE */
+  ]);
+  return recoverableErrors.has(errorCode);
+}
+
 // src/models/llm.ts
 var LLMProvider = {
   AZURE_OPENAI: "azure_openai",
@@ -1600,7 +1737,12 @@ export {
   CredentialTypes,
   DataSourceStatus,
   DataSourceType,
+  ERROR_MESSAGE_PATTERNS,
+  ErrorCategory,
+  ErrorCode,
+  ErrorDetailLevel,
   ExecutionStatus,
+  HTTP_STATUS_TO_ERROR_CODE,
   IntegrationCreateParamsSchema,
   IntegrationGetByAliasParamsSchema,
   IntegrationGetParamsSchema,
@@ -1616,6 +1758,12 @@ export {
   WorkflowListParamsSchema,
   WorkflowMode,
   WorkflowUpdateParamsSchema,
-  formatCookies
+  classifyHttpError,
+  formatCookies,
+  formatToolErrorForLevel,
+  formatToolErrorFull,
+  formatToolErrorMinimal,
+  formatToolErrorStandard,
+  isRecoverableError
 };
 //# sourceMappingURL=index.js.map