@dexto/core 1.1.10 → 1.2.0

package/dist/agent/schemas.d.ts.map

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

package/dist/agent/schemas.js

@@ -1,3 +1,4 @@
+import "../chunk-C6A6W6XS.js";
 import { LLMConfigSchema } from "../llm/schemas.js";
 import { ServerConfigsSchema as McpServersConfigSchema } from "../mcp/schemas.js";
 import { SessionConfigSchema } from "../session/schemas.js";
@@ -5,6 +6,10 @@ import { StorageSchema } from "../storage/schemas.js";
 import { SystemPromptConfigSchema } from "../systemPrompt/schemas.js";
 import { InternalToolsSchema, ToolConfirmationConfigSchema } from "../tools/schemas.js";
 import { z } from "zod";
+import { InternalResourcesSchema } from "../resources/schemas.js";
+import { StarterPromptsSchema } from "../prompts/schemas.js";
+import { PluginsConfigSchema } from "../plugins/schemas.js";
+import { OtelConfigurationSchema } from "../telemetry/schemas.js";
 const AgentCardSchema = z.object({
   name: z.string(),
   // No default, must be provided by context
@@ -75,12 +80,27 @@ const AgentConfigSchema = z.object({
   // Storage configuration
   storage: StorageSchema.default({
     cache: { type: "in-memory" },
-    database: { type: "in-memory" }
-  }).describe("Storage configuration for the agent using cache and database backends"),
+    database: { type: "in-memory" },
+    blob: { type: "local" }
+  }).describe("Storage configuration for cache, database, and blob storage"),
   sessions: SessionConfigSchema.default({}).describe("Session management configuration"),
   toolConfirmation: ToolConfirmationConfigSchema.default({}).describe(
     "Tool confirmation and approval configuration"
-  )
+  ),
+  // Internal resources configuration (filesystem, etc.)
+  internalResources: InternalResourcesSchema.describe(
+    "Configuration for internal resources (filesystem, etc.)"
+  ).default([]),
+  // Agent-specific starter prompts configuration (used by WebUI and PromptManager)
+  starterPrompts: StarterPromptsSchema,
+  // Plugin configuration
+  plugins: PluginsConfigSchema.describe(
+    "Plugin system configuration for built-in and custom plugins"
+  ).default({}),
+  // Telemetry configuration
+  telemetry: OtelConfigurationSchema.describe(
+    "OpenTelemetry configuration for distributed tracing and observability"
+  ).optional()
 }).strict().describe("Main configuration for an agent, including its LLM and server connections").brand();
 export {
   AgentCardSchema,

package/dist/agent/state-manager.d.ts

@@ -1,15 +1,11 @@
-import { ValidatedAgentConfig } from './schemas.js';
-import { ValidatedLLMConfig } from '../llm/schemas.js';
-import { ValidatedMcpServerConfig } from '../mcp/schemas.js';
-import { AgentEventBus } from '../events/index.js';
-import 'zod';
-import '../llm/types.js';
-import 'events';
-
+import type { ValidatedAgentConfig } from './schemas.js';
+import type { ValidatedLLMConfig } from '../llm/schemas.js';
+import type { ValidatedMcpServerConfig } from '../mcp/schemas.js';
+import type { AgentEventBus } from '../events/index.js';
 /**
  * Session-specific overrides that can differ from the global configuration
  */
-interface SessionOverride {
+export interface SessionOverride {
     /** Override LLM config for this session - must be a complete validated config */
     llm?: ValidatedLLMConfig;
 }
@@ -26,7 +22,7 @@ interface SessionOverride {
  * 5. Provide change tracking and validation capabilities
  * 6. Maintain effective configuration for each session
  */
-declare class AgentStateManager {
+export declare class AgentStateManager {
     private agentEventBus;
     private runtimeConfig;
     private readonly baselineConfig;
@@ -93,5 +89,4 @@ declare class AgentStateManager {
      */
     getLLMConfig(sessionId?: string): Readonly<ValidatedLLMConfig>;
 }
-
-export { AgentStateManager, type SessionOverride };
+//# sourceMappingURL=state-manager.d.ts.map

package/dist/agent/state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../src/agent/state-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,iFAAiF;IACjF,GAAG,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAiB;IAatB,OAAO,CAAC,aAAa;IAZzB,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,gBAAgB,CAA2C;IAEnE;;;;;OAKG;gBAEC,YAAY,EAAE,oBAAoB,EAC1B,aAAa,EAAE,aAAa;IAaxC;;OAEG;IACI,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,oBAAoB,CAAC;IAkB3E;;;;;;OAMG;IACI,SAAS,CAAC,eAAe,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IA4B/E;;;;;;OAMG;IACI,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,wBAAwB,GAAG,IAAI;IAqBxF;;OAEG;IACI,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAsBhD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACI,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAUpD;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAehC;;;OAGG;IACI,cAAc,IAAI,oBAAoB;IAmB7C;;OAEG;IACI,eAAe,IAAI,IAAI;IAW9B;;;OAGG;IACI,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,kBAAkB,CAAC;CAGxE"}

package/dist/agent/state-manager.js

@@ -1,3 +1,4 @@
+import "../chunk-C6A6W6XS.js";
 import { logger } from "../logger/index.js";
 class AgentStateManager {
   /**

package/dist/approval/error-codes.cjs

@@ -0,0 +1,44 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var error_codes_exports = {};
+__export(error_codes_exports, {
+  ApprovalErrorCode: () => ApprovalErrorCode
+});
+module.exports = __toCommonJS(error_codes_exports);
+var ApprovalErrorCode = /* @__PURE__ */ ((ApprovalErrorCode2) => {
+  ApprovalErrorCode2["APPROVAL_INVALID_REQUEST"] = "approval_invalid_request";
+  ApprovalErrorCode2["APPROVAL_INVALID_RESPONSE"] = "approval_invalid_response";
+  ApprovalErrorCode2["APPROVAL_INVALID_METADATA"] = "approval_invalid_metadata";
+  ApprovalErrorCode2["APPROVAL_INVALID_SCHEMA"] = "approval_invalid_schema";
+  ApprovalErrorCode2["APPROVAL_TIMEOUT"] = "approval_timeout";
+  ApprovalErrorCode2["APPROVAL_CANCELLED"] = "approval_cancelled";
+  ApprovalErrorCode2["APPROVAL_CANCELLED_ALL"] = "approval_cancelled_all";
+  ApprovalErrorCode2["APPROVAL_PROVIDER_NOT_CONFIGURED"] = "approval_provider_not_configured";
+  ApprovalErrorCode2["APPROVAL_PROVIDER_ERROR"] = "approval_provider_error";
+  ApprovalErrorCode2["APPROVAL_NOT_FOUND"] = "approval_not_found";
+  ApprovalErrorCode2["APPROVAL_TOOL_CONFIRMATION_DENIED"] = "approval_tool_confirmation_denied";
+  ApprovalErrorCode2["APPROVAL_ELICITATION_DENIED"] = "approval_elicitation_denied";
+  ApprovalErrorCode2["APPROVAL_ELICITATION_VALIDATION_FAILED"] = "approval_elicitation_validation_failed";
+  ApprovalErrorCode2["APPROVAL_CONFIG_INVALID"] = "approval_config_invalid";
+  return ApprovalErrorCode2;
+})(ApprovalErrorCode || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApprovalErrorCode
+});

package/dist/approval/error-codes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Error codes for the approval system
+ * Covers validation, timeout, cancellation, and provider errors
+ */
+export declare enum ApprovalErrorCode {
+    APPROVAL_INVALID_REQUEST = "approval_invalid_request",
+    APPROVAL_INVALID_RESPONSE = "approval_invalid_response",
+    APPROVAL_INVALID_METADATA = "approval_invalid_metadata",
+    APPROVAL_INVALID_SCHEMA = "approval_invalid_schema",
+    APPROVAL_TIMEOUT = "approval_timeout",
+    APPROVAL_CANCELLED = "approval_cancelled",
+    APPROVAL_CANCELLED_ALL = "approval_cancelled_all",
+    APPROVAL_PROVIDER_NOT_CONFIGURED = "approval_provider_not_configured",
+    APPROVAL_PROVIDER_ERROR = "approval_provider_error",
+    APPROVAL_NOT_FOUND = "approval_not_found",
+    APPROVAL_TOOL_CONFIRMATION_DENIED = "approval_tool_confirmation_denied",
+    APPROVAL_ELICITATION_DENIED = "approval_elicitation_denied",
+    APPROVAL_ELICITATION_VALIDATION_FAILED = "approval_elicitation_validation_failed",
+    APPROVAL_CONFIG_INVALID = "approval_config_invalid"
+}
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/approval/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/approval/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,iBAAiB;IAEzB,wBAAwB,6BAA6B;IACrD,yBAAyB,8BAA8B;IACvD,yBAAyB,8BAA8B;IACvD,uBAAuB,4BAA4B;IAGnD,gBAAgB,qBAAqB;IAGrC,kBAAkB,uBAAuB;IACzC,sBAAsB,2BAA2B;IAGjD,gCAAgC,qCAAqC;IACrE,uBAAuB,4BAA4B;IACnD,kBAAkB,uBAAuB;IAGzC,iCAAiC,sCAAsC;IACvE,2BAA2B,gCAAgC;IAC3D,sCAAsC,2CAA2C;IAGjF,uBAAuB,4BAA4B;CACtD"}

package/dist/approval/error-codes.js

@@ -0,0 +1,21 @@
+import "../chunk-C6A6W6XS.js";
+var ApprovalErrorCode = /* @__PURE__ */ ((ApprovalErrorCode2) => {
+  ApprovalErrorCode2["APPROVAL_INVALID_REQUEST"] = "approval_invalid_request";
+  ApprovalErrorCode2["APPROVAL_INVALID_RESPONSE"] = "approval_invalid_response";
+  ApprovalErrorCode2["APPROVAL_INVALID_METADATA"] = "approval_invalid_metadata";
+  ApprovalErrorCode2["APPROVAL_INVALID_SCHEMA"] = "approval_invalid_schema";
+  ApprovalErrorCode2["APPROVAL_TIMEOUT"] = "approval_timeout";
+  ApprovalErrorCode2["APPROVAL_CANCELLED"] = "approval_cancelled";
+  ApprovalErrorCode2["APPROVAL_CANCELLED_ALL"] = "approval_cancelled_all";
+  ApprovalErrorCode2["APPROVAL_PROVIDER_NOT_CONFIGURED"] = "approval_provider_not_configured";
+  ApprovalErrorCode2["APPROVAL_PROVIDER_ERROR"] = "approval_provider_error";
+  ApprovalErrorCode2["APPROVAL_NOT_FOUND"] = "approval_not_found";
+  ApprovalErrorCode2["APPROVAL_TOOL_CONFIRMATION_DENIED"] = "approval_tool_confirmation_denied";
+  ApprovalErrorCode2["APPROVAL_ELICITATION_DENIED"] = "approval_elicitation_denied";
+  ApprovalErrorCode2["APPROVAL_ELICITATION_VALIDATION_FAILED"] = "approval_elicitation_validation_failed";
+  ApprovalErrorCode2["APPROVAL_CONFIG_INVALID"] = "approval_config_invalid";
+  return ApprovalErrorCode2;
+})(ApprovalErrorCode || {});
+export {
+  ApprovalErrorCode
+};

package/dist/approval/errors.cjs

@@ -0,0 +1,251 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var errors_exports = {};
+__export(errors_exports, {
+  ApprovalError: () => ApprovalError
+});
+module.exports = __toCommonJS(errors_exports);
+var import_errors = require("../errors/index.js");
+var import_error_codes = require("./error-codes.js");
+class ApprovalError {
+  /**
+   * Create an error for invalid approval request
+   */
+  static invalidRequest(reason, context) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_INVALID_REQUEST,
+      import_errors.ErrorScope.TOOLS,
+      // Approvals are part of tool execution flow
+      import_errors.ErrorType.USER,
+      `Invalid approval request: ${reason}`,
+      context,
+      ["Check the approval request structure", "Ensure all required fields are provided"]
+    );
+  }
+  /**
+   * Create an error for invalid approval response
+   */
+  static invalidResponse(reason, context) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_INVALID_RESPONSE,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.USER,
+      `Invalid approval response: ${reason}`,
+      context,
+      [
+        "Check the approval response structure",
+        "Ensure approvalId matches the request",
+        "Verify status is valid"
+      ]
+    );
+  }
+  /**
+   * Create an error for invalid metadata
+   */
+  static invalidMetadata(type, reason) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_INVALID_METADATA,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.USER,
+      `Invalid metadata for ${type}: ${reason}`,
+      { type, reason },
+      ["Check the metadata structure for this approval type"]
+    );
+  }
+  /**
+   * Create an error for invalid elicitation schema
+   */
+  static invalidSchema(reason) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_INVALID_SCHEMA,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.USER,
+      `Invalid elicitation schema: ${reason}`,
+      { reason },
+      ["Ensure the schema is a valid JSON Schema", "Check MCP server implementation"]
+    );
+  }
+  /**
+   * Create an error for approval timeout
+   */
+  static timeout(approvalId, type, timeout, sessionId) {
+    const context = {
+      approvalId,
+      type,
+      timeout
+    };
+    if (sessionId !== void 0) {
+      context.sessionId = sessionId;
+    }
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_TIMEOUT,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.TIMEOUT,
+      `Approval request timed out after ${timeout}ms`,
+      context,
+      [
+        "Increase the timeout value",
+        "Respond to approval requests more quickly",
+        "Check if approval UI is functioning"
+      ]
+    );
+  }
+  /**
+   * Create an error for cancelled approval
+   */
+  static cancelled(approvalId, type, reason) {
+    const message = reason ? `Approval request cancelled: ${reason}` : "Approval request was cancelled";
+    const context = {
+      approvalId,
+      type
+    };
+    if (reason !== void 0) {
+      context.reason = reason;
+    }
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_CANCELLED,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.USER,
+      message,
+      context
+    );
+  }
+  /**
+   * Create an error for all approvals cancelled
+   */
+  static cancelledAll(reason) {
+    const message = reason ? `All approval requests cancelled: ${reason}` : "All approval requests were cancelled";
+    const context = {};
+    if (reason !== void 0) {
+      context.reason = reason;
+    }
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_CANCELLED_ALL,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.USER,
+      message,
+      context
+    );
+  }
+  /**
+   * Create an error for approval provider not configured
+   */
+  static providerNotConfigured() {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_PROVIDER_NOT_CONFIGURED,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.SYSTEM,
+      "Approval provider not configured",
+      {},
+      [
+        "Configure an approval provider in your agent configuration",
+        "Check approval.mode in agent.yml"
+      ]
+    );
+  }
+  /**
+   * Create an error for approval provider error
+   */
+  static providerError(message, cause) {
+    const context = {};
+    if (cause?.message !== void 0) {
+      context.cause = cause.message;
+    }
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_PROVIDER_ERROR,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.SYSTEM,
+      `Approval provider error: ${message}`,
+      context,
+      ["Check approval provider implementation", "Review system logs for details"]
+    );
+  }
+  /**
+   * Create an error for approval not found
+   */
+  static notFound(approvalId) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_NOT_FOUND,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.NOT_FOUND,
+      `Approval request not found: ${approvalId}`,
+      { approvalId },
+      [
+        "Verify the approvalId is correct",
+        "Check if the approval has already been resolved or timed out"
+      ]
+    );
+  }
+  /**
+   * Create an error for tool confirmation denied
+   */
+  static toolConfirmationDenied(toolName, sessionId) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_TOOL_CONFIRMATION_DENIED,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.FORBIDDEN,
+      `Tool execution denied: ${toolName}`,
+      sessionId ? { toolName, sessionId } : { toolName },
+      ["Approve the tool in the confirmation dialog", "Check tool permissions"]
+    );
+  }
+  /**
+   * Create an error for elicitation denied
+   */
+  static elicitationDenied(serverName, sessionId) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_ELICITATION_DENIED,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.FORBIDDEN,
+      `Elicitation request denied from MCP server: ${serverName}`,
+      sessionId ? { serverName, sessionId } : { serverName },
+      ["Complete the requested form", "Check MCP server requirements"]
+    );
+  }
+  /**
+   * Create an error for elicitation validation failed
+   */
+  static elicitationValidationFailed(serverName, errors, approvalId) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_ELICITATION_VALIDATION_FAILED,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.USER,
+      `Elicitation form validation failed: ${errors.join(", ")}`,
+      { approvalId, serverName, errors },
+      ["Check the form inputs match the schema requirements", "Review validation errors"]
+    );
+  }
+  /**
+   * Create an error for invalid approval configuration
+   */
+  static invalidConfig(reason) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ApprovalErrorCode.APPROVAL_CONFIG_INVALID,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.USER,
+      `Invalid approval configuration: ${reason}`,
+      { reason },
+      ["Check approval configuration in agent.yml", "Review approval.mode and related fields"]
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApprovalError
+});

package/dist/approval/errors.d.ts

@@ -0,0 +1,110 @@
+import { DextoRuntimeError } from '../errors/index.js';
+import type { ApprovalType } from './types.js';
+/**
+ * Context for approval validation errors
+ */
+export interface ApprovalValidationContext {
+    approvalId?: string;
+    type?: ApprovalType;
+    field?: string;
+    reason?: string;
+}
+/**
+ * Context for approval timeout errors
+ */
+export interface ApprovalTimeoutContext {
+    approvalId: string;
+    type: ApprovalType;
+    timeout: number;
+    sessionId?: string;
+}
+/**
+ * Context for approval cancellation errors
+ */
+export interface ApprovalCancellationContext {
+    approvalId?: string;
+    type?: ApprovalType;
+    reason?: string;
+}
+/**
+ * Context for elicitation validation errors
+ */
+export interface ElicitationValidationContext {
+    approvalId: string;
+    serverName: string;
+    errors: string[];
+}
+/**
+ * Error factory for approval system errors
+ */
+export declare class ApprovalError {
+    /**
+     * Create an error for invalid approval request
+     */
+    static invalidRequest(reason: string, context?: ApprovalValidationContext): DextoRuntimeError<ApprovalValidationContext>;
+    /**
+     * Create an error for invalid approval response
+     */
+    static invalidResponse(reason: string, context?: ApprovalValidationContext): DextoRuntimeError<ApprovalValidationContext>;
+    /**
+     * Create an error for invalid metadata
+     */
+    static invalidMetadata(type: ApprovalType, reason: string): DextoRuntimeError<ApprovalValidationContext>;
+    /**
+     * Create an error for invalid elicitation schema
+     */
+    static invalidSchema(reason: string): DextoRuntimeError<ApprovalValidationContext>;
+    /**
+     * Create an error for approval timeout
+     */
+    static timeout(approvalId: string, type: ApprovalType, timeout: number, sessionId?: string): DextoRuntimeError<ApprovalTimeoutContext>;
+    /**
+     * Create an error for cancelled approval
+     */
+    static cancelled(approvalId: string, type: ApprovalType, reason?: string): DextoRuntimeError<ApprovalCancellationContext>;
+    /**
+     * Create an error for all approvals cancelled
+     */
+    static cancelledAll(reason?: string): DextoRuntimeError<ApprovalCancellationContext>;
+    /**
+     * Create an error for approval provider not configured
+     */
+    static providerNotConfigured(): DextoRuntimeError<Record<string, never>>;
+    /**
+     * Create an error for approval provider error
+     */
+    static providerError(message: string, cause?: Error): DextoRuntimeError<{
+        cause?: string;
+    }>;
+    /**
+     * Create an error for approval not found
+     */
+    static notFound(approvalId: string): DextoRuntimeError<{
+        approvalId: string;
+    }>;
+    /**
+     * Create an error for tool confirmation denied
+     */
+    static toolConfirmationDenied(toolName: string, sessionId?: string): DextoRuntimeError<{
+        toolName: string;
+        sessionId?: string;
+    }>;
+    /**
+     * Create an error for elicitation denied
+     */
+    static elicitationDenied(serverName: string, sessionId?: string): DextoRuntimeError<{
+        serverName: string;
+        sessionId?: string;
+    }>;
+    /**
+     * Create an error for elicitation validation failed
+     */
+    static elicitationValidationFailed(serverName: string, errors: string[], approvalId: string): DextoRuntimeError<ElicitationValidationContext>;
+    /**
+     * Create an error for invalid approval configuration
+     */
+    static invalidConfig(reason: string): DextoRuntimeError<{
+        reason: string;
+    }>;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/approval/errors.d.ts.map

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