@dexto/core 1.2.3 → 1.2.5

package/dist/{preferences/constants.cjs → agent/types.cjs}

@@ -3,10 +3,6 @@ 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))
@@ -16,13 +12,5 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var constants_exports = {};
-__export(constants_exports, {
-  PREFERENCES_FILE: () => PREFERENCES_FILE
-});
-module.exports = __toCommonJS(constants_exports);
-const PREFERENCES_FILE = "preferences.yml";
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  PREFERENCES_FILE
-});
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/agent/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Type definitions for DextoAgent generate() and stream() APIs
+ *
+ * Re-uses existing types from context, llm/services, and events to avoid duplication.
+ */
+import type { ImageData, FileData } from '../context/types.js';
+import type { LLMTokenUsage } from '../llm/services/types.js';
+/**
+ * Re-export existing types for convenience
+ */
+export type { ImageData as ImageInput, FileData as FileInput } from '../context/types.js';
+export type { LLMTokenUsage as TokenUsage } from '../llm/services/types.js';
+/**
+ * Tool call information for agent streaming
+ * Simplified version of tools/types.ts ToolCall for streaming context
+ */
+export interface AgentToolCall {
+    toolName: string;
+    args: Record<string, any>;
+    callId: string;
+    result?: {
+        success: boolean;
+        data: any;
+    } | undefined;
+}
+/**
+ * Options for generate() method
+ */
+export interface GenerateOptions {
+    sessionId: string;
+    imageData?: ImageData | undefined;
+    fileData?: FileData | undefined;
+    signal?: AbortSignal | undefined;
+}
+/**
+ * Complete response from generate() method
+ */
+export interface GenerateResponse {
+    content: string;
+    reasoning?: string | undefined;
+    usage: LLMTokenUsage;
+    toolCalls: AgentToolCall[];
+    sessionId: string;
+    messageId: string;
+}
+/**
+ * Options for stream() method (same as generate)
+ *
+ * Note: stream() now returns core StreamingEvent types directly from the event system.
+ * See packages/core/src/events/index.ts for event definitions.
+ */
+export interface StreamOptions extends GenerateOptions {
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;GAEG;AACH,YAAY,EAAE,SAAS,IAAI,UAAU,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC1F,YAAY,EAAE,aAAa,IAAI,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EACD;QACI,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,GAAG,CAAC;KACb,GACD,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAc,SAAQ,eAAe;CAErD"}

package/dist/approval/errors.cjs

@@ -195,27 +195,108 @@ class ApprovalError {
   /**
    * Create an error for tool confirmation denied
    */
-  static toolConfirmationDenied(toolName, sessionId) {
+  static toolConfirmationDenied(toolName, reason, customMessage, sessionId) {
+    let message;
+    let suggestions;
+    switch (reason) {
+      case "user_denied":
+        message = customMessage ?? `Tool execution denied by user: ${toolName}`;
+        suggestions = ["Tool was denied by user"];
+        break;
+      case "system_denied":
+        message = customMessage ?? `Tool execution denied by system policy: ${toolName}`;
+        suggestions = [
+          "Tool is in the alwaysDeny list",
+          "Check toolConfirmation.toolPolicies in agent configuration"
+        ];
+        break;
+      case "timeout":
+        message = customMessage ?? `Tool confirmation timed out: ${toolName}`;
+        suggestions = [
+          "Increase the timeout value",
+          "Respond to approval requests more quickly"
+        ];
+        break;
+      default:
+        message = customMessage ?? `Tool execution denied: ${toolName}`;
+        suggestions = [
+          "Approve the tool in the confirmation dialog",
+          "Check tool permissions"
+        ];
+    }
+    const context = {
+      toolName
+    };
+    if (reason) context.reason = reason;
+    if (sessionId) context.sessionId = 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"]
+      message,
+      context,
+      suggestions
     );
   }
   /**
    * Create an error for elicitation denied
    */
-  static elicitationDenied(serverName, sessionId) {
+  static elicitationDenied(serverName, reason, customMessage, sessionId) {
+    let message;
+    let suggestions;
+    switch (reason) {
+      case "user_denied":
+        message = customMessage ?? `Elicitation request denied by user from MCP server: ${serverName}`;
+        suggestions = [
+          "User clicked deny on the form",
+          "The agent cannot proceed without this input"
+        ];
+        break;
+      case "user_cancelled":
+        message = customMessage ?? `Elicitation request cancelled by user from MCP server: ${serverName}`;
+        suggestions = [
+          "User cancelled the form",
+          "The agent cannot proceed without this input"
+        ];
+        break;
+      case "system_cancelled":
+        message = customMessage ?? `Elicitation request cancelled from MCP server: ${serverName}`;
+        suggestions = ["Session may have ended", "Try again"];
+        break;
+      case "timeout":
+        message = customMessage ?? `Elicitation request timed out from MCP server: ${serverName}`;
+        suggestions = [
+          "Increase the timeout value",
+          "Respond to elicitation requests more quickly"
+        ];
+        break;
+      case "elicitation_disabled":
+        message = customMessage ?? `Elicitation is disabled. Cannot request input from MCP server: ${serverName}`;
+        suggestions = [
+          "Enable elicitation in your agent configuration",
+          "Set elicitation.enabled: true in agent.yml"
+        ];
+        break;
+      case "validation_failed":
+        message = customMessage ?? `Elicitation form validation failed from MCP server: ${serverName}`;
+        suggestions = ["Check the form inputs match the schema requirements"];
+        break;
+      default:
+        message = customMessage ?? `Elicitation request denied from MCP server: ${serverName}`;
+        suggestions = ["Complete the requested form", "Check MCP server requirements"];
+    }
+    const context = {
+      serverName
+    };
+    if (reason) context.reason = reason;
+    if (sessionId) context.sessionId = 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"]
+      message,
+      context,
+      suggestions
     );
   }
   /**

package/dist/approval/errors.d.ts

@@ -1,5 +1,5 @@
 import { DextoRuntimeError } from '../errors/index.js';
-import type { ApprovalType } from './types.js';
+import type { ApprovalType, DenialReason } from './types.js';
 /**
  * Context for approval validation errors
  */
@@ -85,15 +85,17 @@ export declare class ApprovalError {
     /**
      * Create an error for tool confirmation denied
      */
-    static toolConfirmationDenied(toolName: string, sessionId?: string): DextoRuntimeError<{
+    static toolConfirmationDenied(toolName: string, reason?: DenialReason, customMessage?: string, sessionId?: string): DextoRuntimeError<{
         toolName: string;
+        reason?: DenialReason;
         sessionId?: string;
     }>;
     /**
      * Create an error for elicitation denied
      */
-    static elicitationDenied(serverName: string, sessionId?: string): DextoRuntimeError<{
+    static elicitationDenied(serverName: string, reason?: DenialReason, customMessage?: string, sessionId?: string): DextoRuntimeError<{
         serverName: string;
+        reason?: DenialReason;
         sessionId?: string;
     }>;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/approval/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAyB,MAAM,oBAAoB,CAAC;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,aAAa;IACtB;;OAEG;IACH,MAAM,CAAC,cAAc,CACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,yBAAyB,GACpC,iBAAiB,CAAC,yBAAyB,CAAC;IAW/C;;OAEG;IACH,MAAM,CAAC,eAAe,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,yBAAyB,GACpC,iBAAiB,CAAC,yBAAyB,CAAC;IAe/C;;OAEG;IACH,MAAM,CAAC,eAAe,CAClB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,GACf,iBAAiB,CAAC,yBAAyB,CAAC;IAW/C;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAC,yBAAyB,CAAC;IAWlF;;OAEG;IACH,MAAM,CAAC,OAAO,CACV,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACnB,iBAAiB,CAAC,sBAAsB,CAAC;IAyB5C;;OAEG;IACH,MAAM,CAAC,SAAS,CACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,MAAM,GAChB,iBAAiB,CAAC,2BAA2B,CAAC;IAuBjD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC,2BAA2B,CAAC;IAoBpF;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAcxE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,iBAAiB,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB3F;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAc9E;;OAEG;IACH,MAAM,CAAC,sBAAsB,CACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACnB,iBAAiB,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAW9D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACpB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACnB,iBAAiB,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAWhE;;OAEG;IACH,MAAM,CAAC,2BAA2B,CAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,UAAU,EAAE,MAAM,GACnB,iBAAiB,CAAC,4BAA4B,CAAC;IAWlD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAU9E"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/approval/errors.ts"],"names":[],"mappings":"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"}

package/dist/approval/errors.js

@@ -173,27 +173,108 @@ class ApprovalError {
   /**
    * Create an error for tool confirmation denied
    */
-  static toolConfirmationDenied(toolName, sessionId) {
+  static toolConfirmationDenied(toolName, reason, customMessage, sessionId) {
+    let message;
+    let suggestions;
+    switch (reason) {
+      case "user_denied":
+        message = customMessage ?? `Tool execution denied by user: ${toolName}`;
+        suggestions = ["Tool was denied by user"];
+        break;
+      case "system_denied":
+        message = customMessage ?? `Tool execution denied by system policy: ${toolName}`;
+        suggestions = [
+          "Tool is in the alwaysDeny list",
+          "Check toolConfirmation.toolPolicies in agent configuration"
+        ];
+        break;
+      case "timeout":
+        message = customMessage ?? `Tool confirmation timed out: ${toolName}`;
+        suggestions = [
+          "Increase the timeout value",
+          "Respond to approval requests more quickly"
+        ];
+        break;
+      default:
+        message = customMessage ?? `Tool execution denied: ${toolName}`;
+        suggestions = [
+          "Approve the tool in the confirmation dialog",
+          "Check tool permissions"
+        ];
+    }
+    const context = {
+      toolName
+    };
+    if (reason) context.reason = reason;
+    if (sessionId) context.sessionId = sessionId;
     return new DextoRuntimeError(
       ApprovalErrorCode.APPROVAL_TOOL_CONFIRMATION_DENIED,
       ErrorScope.TOOLS,
       ErrorType.FORBIDDEN,
-      `Tool execution denied: ${toolName}`,
-      sessionId ? { toolName, sessionId } : { toolName },
-      ["Approve the tool in the confirmation dialog", "Check tool permissions"]
+      message,
+      context,
+      suggestions
     );
   }
   /**
    * Create an error for elicitation denied
    */
-  static elicitationDenied(serverName, sessionId) {
+  static elicitationDenied(serverName, reason, customMessage, sessionId) {
+    let message;
+    let suggestions;
+    switch (reason) {
+      case "user_denied":
+        message = customMessage ?? `Elicitation request denied by user from MCP server: ${serverName}`;
+        suggestions = [
+          "User clicked deny on the form",
+          "The agent cannot proceed without this input"
+        ];
+        break;
+      case "user_cancelled":
+        message = customMessage ?? `Elicitation request cancelled by user from MCP server: ${serverName}`;
+        suggestions = [
+          "User cancelled the form",
+          "The agent cannot proceed without this input"
+        ];
+        break;
+      case "system_cancelled":
+        message = customMessage ?? `Elicitation request cancelled from MCP server: ${serverName}`;
+        suggestions = ["Session may have ended", "Try again"];
+        break;
+      case "timeout":
+        message = customMessage ?? `Elicitation request timed out from MCP server: ${serverName}`;
+        suggestions = [
+          "Increase the timeout value",
+          "Respond to elicitation requests more quickly"
+        ];
+        break;
+      case "elicitation_disabled":
+        message = customMessage ?? `Elicitation is disabled. Cannot request input from MCP server: ${serverName}`;
+        suggestions = [
+          "Enable elicitation in your agent configuration",
+          "Set elicitation.enabled: true in agent.yml"
+        ];
+        break;
+      case "validation_failed":
+        message = customMessage ?? `Elicitation form validation failed from MCP server: ${serverName}`;
+        suggestions = ["Check the form inputs match the schema requirements"];
+        break;
+      default:
+        message = customMessage ?? `Elicitation request denied from MCP server: ${serverName}`;
+        suggestions = ["Complete the requested form", "Check MCP server requirements"];
+    }
+    const context = {
+      serverName
+    };
+    if (reason) context.reason = reason;
+    if (sessionId) context.sessionId = sessionId;
     return new DextoRuntimeError(
       ApprovalErrorCode.APPROVAL_ELICITATION_DENIED,
       ErrorScope.TOOLS,
       ErrorType.FORBIDDEN,
-      `Elicitation request denied from MCP server: ${serverName}`,
-      sessionId ? { serverName, sessionId } : { serverName },
-      ["Complete the requested form", "Check MCP server requirements"]
+      message,
+      context,
+      suggestions
     );
   }
   /**

package/dist/approval/{providers/factory.d.ts → factory.d.ts}

@@ -1,8 +1,8 @@
-import type { ApprovalRequest, ApprovalRequestDetails } from '../types.js';
+import type { ApprovalRequest, ApprovalRequestDetails } from './types.js';
 /**
  * Factory function to create an approval request with generated ID and timestamp.
  *
- * This is a generic helper used by all approval providers to create properly
+ * This is a generic helper used by ApprovalManager to create properly
  * formatted approval requests from simplified details.
  *
  * @param details - Simplified approval request details without ID and timestamp

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/approval/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAStF"}

package/dist/approval/{providers/factory.js → factory.js}

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../chunk-C6A6W6XS.js";
 import { randomUUID } from "crypto";
 function createApprovalRequest(details) {
   return {

package/dist/approval/index.cjs

@@ -34,12 +34,12 @@ __export(approval_exports, {
   CustomApprovalRequestSchema: () => import_schemas.CustomApprovalRequestSchema,
   CustomApprovalResponseDataSchema: () => import_schemas.CustomApprovalResponseDataSchema,
   CustomApprovalResponseSchema: () => import_schemas.CustomApprovalResponseSchema,
+  DenialReason: () => import_types.DenialReason,
+  DenialReasonSchema: () => import_schemas.DenialReasonSchema,
   ElicitationMetadataSchema: () => import_schemas.ElicitationMetadataSchema,
   ElicitationRequestSchema: () => import_schemas.ElicitationRequestSchema,
   ElicitationResponseDataSchema: () => import_schemas.ElicitationResponseDataSchema,
   ElicitationResponseSchema: () => import_schemas.ElicitationResponseSchema,
-  EventBasedApprovalProvider: () => import_event_based_approval_provider.EventBasedApprovalProvider,
-  NoOpApprovalProvider: () => import_noop_approval_provider.NoOpApprovalProvider,
   ToolConfirmationMetadataSchema: () => import_schemas.ToolConfirmationMetadataSchema,
   ToolConfirmationRequestSchema: () => import_schemas.ToolConfirmationRequestSchema,
   ToolConfirmationResponseDataSchema: () => import_schemas.ToolConfirmationResponseDataSchema,
@@ -51,8 +51,6 @@ var import_schemas = require("./schemas.js");
 var import_error_codes = require("./error-codes.js");
 var import_errors = require("./errors.js");
 var import_manager = require("./manager.js");
-var import_event_based_approval_provider = require("./providers/event-based-approval-provider.js");
-var import_noop_approval_provider = require("./providers/noop-approval-provider.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ApprovalError,
@@ -71,12 +69,12 @@ var import_noop_approval_provider = require("./providers/noop-approval-provider.
   CustomApprovalRequestSchema,
   CustomApprovalResponseDataSchema,
   CustomApprovalResponseSchema,
+  DenialReason,
+  DenialReasonSchema,
   ElicitationMetadataSchema,
   ElicitationRequestSchema,
   ElicitationResponseDataSchema,
   ElicitationResponseSchema,
-  EventBasedApprovalProvider,
-  NoOpApprovalProvider,
   ToolConfirmationMetadataSchema,
   ToolConfirmationRequestSchema,
   ToolConfirmationResponseDataSchema,

package/dist/approval/index.d.ts

@@ -1,12 +1,10 @@
-export type { ApprovalProvider, ApprovalRequest, ApprovalResponse, ApprovalRequestDetails, ElicitationMetadata, ElicitationRequest, ElicitationResponse, ElicitationResponseData, CustomApprovalMetadata, CustomApprovalRequest, CustomApprovalResponse, CustomApprovalResponseData, BaseApprovalRequest, BaseApprovalResponse, } from './types.js';
-export { ApprovalType, ApprovalStatus } from './types.js';
-export { ApprovalTypeSchema, ApprovalStatusSchema, ToolConfirmationMetadataSchema, ElicitationMetadataSchema, CustomApprovalMetadataSchema, BaseApprovalRequestSchema, ToolConfirmationRequestSchema, ElicitationRequestSchema, CustomApprovalRequestSchema, ApprovalRequestSchema, ToolConfirmationResponseDataSchema, ElicitationResponseDataSchema, CustomApprovalResponseDataSchema, BaseApprovalResponseSchema, ToolConfirmationResponseSchema, ElicitationResponseSchema, CustomApprovalResponseSchema, ApprovalResponseSchema, ApprovalRequestDetailsSchema, } from './schemas.js';
+export type { ApprovalHandler, ApprovalRequest, ApprovalResponse, ApprovalRequestDetails, ElicitationMetadata, ElicitationRequest, ElicitationResponse, ElicitationResponseData, CustomApprovalMetadata, CustomApprovalRequest, CustomApprovalResponse, CustomApprovalResponseData, BaseApprovalRequest, BaseApprovalResponse, } from './types.js';
+export { ApprovalType, ApprovalStatus, DenialReason } from './types.js';
+export { ApprovalTypeSchema, ApprovalStatusSchema, DenialReasonSchema, ToolConfirmationMetadataSchema, ElicitationMetadataSchema, CustomApprovalMetadataSchema, BaseApprovalRequestSchema, ToolConfirmationRequestSchema, ElicitationRequestSchema, CustomApprovalRequestSchema, ApprovalRequestSchema, ToolConfirmationResponseDataSchema, ElicitationResponseDataSchema, CustomApprovalResponseDataSchema, BaseApprovalResponseSchema, ToolConfirmationResponseSchema, ElicitationResponseSchema, CustomApprovalResponseSchema, ApprovalResponseSchema, ApprovalRequestDetailsSchema, } from './schemas.js';
 export type { ValidatedApprovalRequest, ValidatedApprovalResponse, ValidatedToolConfirmationRequest, ValidatedElicitationRequest, ValidatedCustomApprovalRequest, } from './schemas.js';
 export { ApprovalErrorCode } from './error-codes.js';
 export { ApprovalError } from './errors.js';
 export type { ApprovalValidationContext, ApprovalTimeoutContext, ApprovalCancellationContext, ElicitationValidationContext, } from './errors.js';
 export { ApprovalManager } from './manager.js';
 export type { ApprovalManagerConfig } from './manager.js';
-export { EventBasedApprovalProvider } from './providers/event-based-approval-provider.js';
-export { NoOpApprovalProvider } from './providers/noop-approval-provider.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/approval/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACR,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,GACvB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EACH,kBAAkB,EAClB,oBAAoB,EACpB,8BAA8B,EAC9B,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,EACzB,6BAA6B,EAC7B,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,kCAAkC,EAClC,6BAA6B,EAC7B,gCAAgC,EAChC,0BAA0B,EAC1B,8BAA8B,EAC9B,yBAAyB,EACzB,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,GAC/B,MAAM,cAAc,CAAC;AAEtB,YAAY,EACR,wBAAwB,EACxB,yBAAyB,EACzB,gCAAgC,EAChC,2BAA2B,EAC3B,8BAA8B,GACjC,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EACR,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,GAC/B,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/approval/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACR,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,GACvB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGxE,OAAO,EACH,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,8BAA8B,EAC9B,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,EACzB,6BAA6B,EAC7B,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,kCAAkC,EAClC,6BAA6B,EAC7B,gCAAgC,EAChC,0BAA0B,EAC1B,8BAA8B,EAC9B,yBAAyB,EACzB,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,GAC/B,MAAM,cAAc,CAAC;AAEtB,YAAY,EACR,wBAAwB,EACxB,yBAAyB,EACzB,gCAAgC,EAChC,2BAA2B,EAC3B,8BAA8B,GACjC,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EACR,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,GAC/B,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/approval/index.js

@@ -1,8 +1,9 @@
 import "../chunk-C6A6W6XS.js";
-import { ApprovalType, ApprovalStatus } from "./types.js";
+import { ApprovalType, ApprovalStatus, DenialReason } from "./types.js";
 import {
   ApprovalTypeSchema,
   ApprovalStatusSchema,
+  DenialReasonSchema,
   ToolConfirmationMetadataSchema,
   ElicitationMetadataSchema,
   CustomApprovalMetadataSchema,
@@ -24,8 +25,6 @@ import {
 import { ApprovalErrorCode } from "./error-codes.js";
 import { ApprovalError } from "./errors.js";
 import { ApprovalManager } from "./manager.js";
-import { EventBasedApprovalProvider } from "./providers/event-based-approval-provider.js";
-import { NoOpApprovalProvider } from "./providers/noop-approval-provider.js";
 export {
   ApprovalError,
   ApprovalErrorCode,
@@ -43,12 +42,12 @@ export {
   CustomApprovalRequestSchema,
   CustomApprovalResponseDataSchema,
   CustomApprovalResponseSchema,
+  DenialReason,
+  DenialReasonSchema,
   ElicitationMetadataSchema,
   ElicitationRequestSchema,
   ElicitationResponseDataSchema,
   ElicitationResponseSchema,
-  EventBasedApprovalProvider,
-  NoOpApprovalProvider,
   ToolConfirmationMetadataSchema,
   ToolConfirmationRequestSchema,
   ToolConfirmationResponseDataSchema,