@dexto/core 1.5.8 → 1.6.0

package/dist/hooks/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/hooks/manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAwB,IAAI,EAAc,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IACxC,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,iBAAiB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,qBAAqB,CAA0C;IACvE,OAAO,CAAC,kBAAkB,CAAwC;IAClE,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IAEvB,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAQ;gBAEnC,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM;IAOtE;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAkB7B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BjC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;;;;;;;;OASG;IACG,YAAY,CAAC,CAAC,SAAS,MAAM,EAC/B,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,EACV,OAAO,EAAE,2BAA2B,GACrC,OAAO,CAAC,CAAC,CAAC;IAqKb;;;OAGG;YACW,kBAAkB;IA8BhC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B;;OAEG;IACH,QAAQ,IAAI;QACR,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;KACpD;IAaD;;;;;;;OAOG;IACH,YAAY,IAAI,MAAM,EAAE;IAMxB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,oBAAoB;CAsB/B"}

package/dist/hooks/manager.js

@@ -0,0 +1,331 @@
+import "../chunk-PTJYTZNU.js";
+import { DextoRuntimeError, ErrorScope, ErrorType } from "../errors/index.js";
+import { HookErrorCode } from "./error-codes.js";
+import { getContext } from "../utils/async-context.js";
+import { DextoLogComponent } from "../logger/v2/types.js";
+class HookManager {
+  hooks = [];
+  hooksByExtensionPoint = /* @__PURE__ */ new Map();
+  hookNameByInstance = /* @__PURE__ */ new WeakMap();
+  options;
+  initialized = false;
+  logger;
+  /** Default timeout for hook execution (milliseconds) */
+  static DEFAULT_TIMEOUT = 5e3;
+  constructor(options, hooks, logger) {
+    this.options = options;
+    this.logger = logger.createChild(DextoLogComponent.HOOK);
+    this.setHooks(hooks);
+    this.logger.debug("HookManager created");
+  }
+  /**
+   * Provide the concrete hooks this manager should orchestrate.
+   * Hooks must be fully resolved and initialized before calling `initialize()`.
+   */
+  setHooks(hooks) {
+    if (this.initialized) {
+      throw new DextoRuntimeError(
+        HookErrorCode.HOOK_CONFIGURATION_INVALID,
+        ErrorScope.HOOK,
+        ErrorType.SYSTEM,
+        "Cannot set hooks after initialization"
+      );
+    }
+    this.hooks = [...hooks];
+    this.hooksByExtensionPoint.clear();
+    this.hookNameByInstance = /* @__PURE__ */ new WeakMap();
+    for (const [index, hook] of this.hooks.entries()) {
+      this.hookNameByInstance.set(hook, this.deriveHookName(hook, index));
+    }
+  }
+  /**
+   * Initialize hook orchestration.
+   * Validates hook shapes and registers them to extension points.
+   * @throws {DextoRuntimeError} If any hook fails validation (fail-fast)
+   */
+  async initialize() {
+    if (this.initialized) {
+      throw new DextoRuntimeError(
+        HookErrorCode.HOOK_CONFIGURATION_INVALID,
+        ErrorScope.HOOK,
+        ErrorType.SYSTEM,
+        "HookManager already initialized"
+      );
+    }
+    for (const [index, hook] of this.hooks.entries()) {
+      this.assertValidHookShape(hook, index);
+      this.registerToExtensionPoints(hook);
+    }
+    for (const [extensionPoint, hooks] of this.hooksByExtensionPoint.entries()) {
+      this.logger.debug(
+        `Extension point '${extensionPoint}': ${hooks.length} hook(s) registered`
+      );
+    }
+    this.initialized = true;
+    this.logger.info(`HookManager initialized with ${this.hooks.length} hook(s)`);
+  }
+  /**
+   * Register a hook to the extension points it implements.
+   */
+  registerToExtensionPoints(hook) {
+    const extensionPoints = [
+      "beforeLLMRequest",
+      "beforeToolCall",
+      "afterToolResult",
+      "beforeResponse"
+    ];
+    for (const point of extensionPoints) {
+      if (typeof hook[point] === "function") {
+        if (!this.hooksByExtensionPoint.has(point)) {
+          this.hooksByExtensionPoint.set(point, []);
+        }
+        this.hooksByExtensionPoint.get(point).push(hook);
+      }
+    }
+  }
+  /**
+   * Execute all hooks at a specific extension point.
+   * Hooks execute sequentially in the order they were provided.
+   *
+   * @param extensionPoint - Which extension point to execute
+   * @param payload - Payload for this extension point (must be an object)
+   * @param options - Options for building execution context
+   * @returns Modified payload after all hooks execute
+   * @throws {DextoRuntimeError} If a hook cancels execution or payload is not an object
+   */
+  async executeHooks(extensionPoint, payload, options) {
+    const hooks = this.hooksByExtensionPoint.get(extensionPoint) || [];
+    if (hooks.length === 0) {
+      return payload;
+    }
+    if (payload === null || typeof payload !== "object") {
+      throw new DextoRuntimeError(
+        HookErrorCode.HOOK_INVALID_SHAPE,
+        ErrorScope.HOOK,
+        ErrorType.USER,
+        `Payload for ${extensionPoint} must be an object (got ${payload === null ? "null" : typeof payload})`,
+        { extensionPoint, payloadType: typeof payload }
+      );
+    }
+    let currentPayload = { ...payload };
+    const asyncCtx = getContext();
+    const llmConfig = options.stateManager.getLLMConfig(options.sessionId);
+    const context = {
+      sessionId: options.sessionId ?? void 0,
+      userId: asyncCtx?.userId ?? void 0,
+      tenantId: asyncCtx?.tenantId ?? void 0,
+      llmConfig,
+      logger: this.logger,
+      abortSignal: options.abortSignal ?? void 0,
+      agent: {
+        sessionManager: options.sessionManager,
+        mcpManager: options.mcpManager,
+        toolManager: options.toolManager,
+        stateManager: options.stateManager,
+        agentEventBus: this.options.agentEventBus,
+        storageManager: this.options.storageManager
+      }
+    };
+    for (const [index, hook] of hooks.entries()) {
+      const method = hook[extensionPoint];
+      if (!method) continue;
+      const hookName = this.hookNameByInstance.get(hook) ?? this.deriveHookName(hook, index);
+      const startTime = Date.now();
+      try {
+        const result = await this.executeWithTimeout(
+          method.call(hook, currentPayload, context),
+          hookName,
+          HookManager.DEFAULT_TIMEOUT
+        );
+        const duration = Date.now() - startTime;
+        this.logger.debug(`Hook '${hookName}' executed at ${extensionPoint}`, {
+          ok: result.ok,
+          cancelled: result.cancel,
+          duration,
+          hasModifications: !!result.modify
+        });
+        if (result.notices && result.notices.length > 0) {
+          for (const notice of result.notices) {
+            const level = notice.kind === "block" || notice.kind === "warn" ? "warn" : "info";
+            this.logger[level](`Hook notice (${notice.kind}): ${notice.message}`, {
+              hook: hookName,
+              code: notice.code,
+              details: notice.details
+            });
+          }
+        }
+        if (!result.ok) {
+          this.logger.warn(`Hook '${hookName}' returned error`, {
+            message: result.message
+          });
+          if (result.cancel) {
+            throw new DextoRuntimeError(
+              HookErrorCode.HOOK_BLOCKED_EXECUTION,
+              ErrorScope.HOOK,
+              ErrorType.FORBIDDEN,
+              result.message || `Operation blocked by hook '${hookName}'`,
+              {
+                hook: hookName,
+                extensionPoint,
+                notices: result.notices
+              }
+            );
+          }
+          continue;
+        }
+        if (result.modify) {
+          currentPayload = {
+            ...currentPayload,
+            ...result.modify
+          };
+          this.logger.debug(`Hook '${hookName}' modified payload`, {
+            keys: Object.keys(result.modify)
+          });
+        }
+        if (result.cancel) {
+          throw new DextoRuntimeError(
+            HookErrorCode.HOOK_BLOCKED_EXECUTION,
+            ErrorScope.HOOK,
+            ErrorType.FORBIDDEN,
+            result.message || `Operation cancelled by hook '${hookName}'`,
+            {
+              hook: hookName,
+              extensionPoint,
+              notices: result.notices
+            }
+          );
+        }
+      } catch (error) {
+        const duration = Date.now() - startTime;
+        if (error instanceof DextoRuntimeError) {
+          throw error;
+        }
+        this.logger.error(`Hook '${hookName}' threw error`, {
+          error: error instanceof Error ? error.message : String(error),
+          duration
+        });
+        throw new DextoRuntimeError(
+          HookErrorCode.HOOK_EXECUTION_FAILED,
+          ErrorScope.HOOK,
+          ErrorType.SYSTEM,
+          `Hook '${hookName}' failed: ${error instanceof Error ? error.message : String(error)}`,
+          {
+            hook: hookName,
+            extensionPoint
+          }
+        );
+      }
+    }
+    return currentPayload;
+  }
+  /**
+   * Execute a promise with timeout, properly clearing timer on completion
+   * Prevents timer leaks and unhandled rejections from Promise.race
+   */
+  async executeWithTimeout(promise, hookName, ms) {
+    let timer;
+    return await new Promise((resolve, reject) => {
+      timer = setTimeout(() => {
+        reject(
+          new DextoRuntimeError(
+            HookErrorCode.HOOK_EXECUTION_TIMEOUT,
+            ErrorScope.HOOK,
+            ErrorType.TIMEOUT,
+            `Hook '${hookName}' execution timed out after ${ms}ms`
+          )
+        );
+      }, ms);
+      promise.then(
+        (val) => {
+          if (timer) clearTimeout(timer);
+          resolve(val);
+        },
+        (err) => {
+          if (timer) clearTimeout(timer);
+          reject(err);
+        }
+      );
+    });
+  }
+  /**
+   * Cleanup all hooks.
+   * Called when agent shuts down
+   */
+  async cleanup() {
+    for (const [index, hook] of this.hooks.entries()) {
+      const hookName = this.hookNameByInstance.get(hook) ?? this.deriveHookName(hook, index);
+      if (hook.cleanup) {
+        try {
+          await hook.cleanup();
+          this.logger.debug(`Hook cleaned up: ${hookName}`);
+        } catch (error) {
+          this.logger.error(`Hook cleanup failed: ${hookName}`, {
+            error: error instanceof Error ? error.message : String(error)
+          });
+        }
+      }
+    }
+    this.logger.info("HookManager cleanup complete");
+  }
+  /**
+   * Get hook statistics.
+   */
+  getStats() {
+    const byExtensionPoint = {};
+    for (const [point, hooks] of this.hooksByExtensionPoint.entries()) {
+      byExtensionPoint[point] = hooks.length;
+    }
+    return {
+      total: this.hooks.length,
+      enabled: this.hooks.length,
+      byExtensionPoint
+    };
+  }
+  /**
+   * List hook display names in execution order.
+   *
+   * Names are derived from:
+   * - `hook.name` (if present)
+   * - constructor/class name (if available)
+   * - fallback `hook#N`
+   */
+  getHookNames() {
+    return this.hooks.map((hook, index) => {
+      return this.hookNameByInstance.get(hook) ?? this.deriveHookName(hook, index);
+    });
+  }
+  deriveHookName(hook, index) {
+    const maybeNamed = hook;
+    if (typeof maybeNamed.name === "string" && maybeNamed.name.trim().length > 0) {
+      return maybeNamed.name;
+    }
+    const ctorName = hook.constructor?.name;
+    if (typeof ctorName === "string" && ctorName !== "Object" && ctorName.trim().length > 0) {
+      return ctorName;
+    }
+    return `hook#${index + 1}`;
+  }
+  assertValidHookShape(hook, index) {
+    const extensionPoints = [
+      "beforeLLMRequest",
+      "beforeToolCall",
+      "afterToolResult",
+      "beforeResponse"
+    ];
+    const hasExtensionPoint = extensionPoints.some(
+      (point) => typeof hook[point] === "function"
+    );
+    if (!hasExtensionPoint) {
+      throw new DextoRuntimeError(
+        HookErrorCode.HOOK_INVALID_SHAPE,
+        ErrorScope.HOOK,
+        ErrorType.USER,
+        `Hook '${this.deriveHookName(hook, index)}' must implement at least one extension point method`,
+        { availableExtensionPoints: extensionPoints }
+      );
+    }
+  }
+}
+export {
+  HookManager
+};

package/dist/{plugins → hooks}/types.d.ts

@@ -1,5 +1,5 @@
 import type { ValidatedLLMConfig } from '../llm/schemas.js';
-import type { IDextoLogger } from '../logger/v2/types.js';
+import type { Logger } from '../logger/v2/types.js';
 import type { SessionManager } from '../session/index.js';
 import type { MCPManager } from '../mcp/manager.js';
 import type { ToolManager } from '../tools/tool-manager.js';
@@ -8,38 +8,38 @@ import type { AgentEventBus } from '../events/index.js';
 import type { StorageManager } from '../storage/index.js';
 /**
  * Extension point names - fixed for MVP
- * These are the 4 hook sites from PR #385 converted to generic plugin extension points
+ * These are the 4 hook sites from PR #385 converted to generic hook extension points.
  */
 export type ExtensionPoint = 'beforeLLMRequest' | 'beforeToolCall' | 'afterToolResult' | 'beforeResponse';
 /**
- * Plugin result - what plugins return from extension point methods
+ * Hook result - what hooks return from extension point methods.
  */
-export interface PluginResult {
-    /** Did plugin execute successfully? */
+export interface HookResult {
+    /** Did hook execute successfully? */
     ok: boolean;
     /** Partial modifications to apply to payload */
-    modify?: Record<string, any>;
-    /** Should execution stop? (Only respected if plugin is blocking) */
+    modify?: Record<string, unknown>;
+    /** Should execution stop? When true, HookManager blocks execution. */
     cancel?: boolean;
     /** User-facing message (shown when cancelled) */
     message?: string;
     /** Notices for logging/events */
-    notices?: PluginNotice[];
+    notices?: HookNotice[];
 }
 /**
- * Plugin notice - for logging and user feedback
+ * Hook notice - for logging and user feedback.
  */
-export interface PluginNotice {
+export interface HookNotice {
     kind: 'allow' | 'block' | 'warn' | 'info';
     code?: string;
     message: string;
     details?: Record<string, unknown>;
 }
 /**
- * Execution context passed to every plugin method
+ * Execution context passed to every hook method.
  * Contains runtime state and read-only access to agent services
  */
-export interface PluginExecutionContext {
+export interface HookExecutionContext {
     /** Current session ID */
     sessionId?: string | undefined;
     /** User ID (set by application layer via AsyncLocalStorage) */
@@ -48,8 +48,8 @@ export interface PluginExecutionContext {
     tenantId?: string | undefined;
     /** Current LLM configuration */
     llmConfig: ValidatedLLMConfig;
-    /** Logger scoped to this plugin execution */
-    logger: IDextoLogger;
+    /** Logger scoped to this hook execution */
+    logger: Logger;
     /** Abort signal for cancellation */
     abortSignal?: AbortSignal | undefined;
     /** Reference to agent services (read-only access) */
@@ -83,7 +83,7 @@ export interface BeforeLLMRequestPayload {
  */
 export interface BeforeToolCallPayload {
     toolName: string;
-    args: any;
+    args: Record<string, unknown>;
     sessionId?: string;
     callId?: string;
 }
@@ -92,7 +92,7 @@ export interface BeforeToolCallPayload {
  */
 export interface AfterToolResultPayload {
     toolName: string;
-    result: any;
+    result: unknown;
     success: boolean;
     sessionId?: string;
     callId?: string;
@@ -112,40 +112,42 @@ export interface BeforeResponsePayload {
     sessionId?: string;
 }
 /**
- * Main plugin interface - implement any subset of these methods
- * All methods are optional - plugin must implement at least one extension point
+ * Main hook type - implement any subset of these methods.
+ * All methods are optional - a hook must implement at least one extension point.
  */
-export interface DextoPlugin {
-    /** Called once at plugin initialization (before agent starts) */
-    initialize?(config: Record<string, any>): Promise<void>;
+export type Hook = {
+    /** Called once at hook initialization (before agent starts). */
+    initialize?(config: Record<string, unknown>): Promise<void>;
     /** Extension point: before LLM request */
-    beforeLLMRequest?(payload: BeforeLLMRequestPayload, context: PluginExecutionContext): Promise<PluginResult>;
+    beforeLLMRequest?(payload: BeforeLLMRequestPayload, context: HookExecutionContext): Promise<HookResult>;
     /** Extension point: before tool call */
-    beforeToolCall?(payload: BeforeToolCallPayload, context: PluginExecutionContext): Promise<PluginResult>;
+    beforeToolCall?(payload: BeforeToolCallPayload, context: HookExecutionContext): Promise<HookResult>;
     /** Extension point: after tool result */
-    afterToolResult?(payload: AfterToolResultPayload, context: PluginExecutionContext): Promise<PluginResult>;
+    afterToolResult?(payload: AfterToolResultPayload, context: HookExecutionContext): Promise<HookResult>;
     /** Extension point: before response */
-    beforeResponse?(payload: BeforeResponsePayload, context: PluginExecutionContext): Promise<PluginResult>;
+    beforeResponse?(payload: BeforeResponsePayload, context: HookExecutionContext): Promise<HookResult>;
     /** Called when agent shuts down (cleanup) */
     cleanup?(): Promise<void>;
-}
+};
 /**
- * Plugin configuration from YAML (custom plugins)
+ * Hook configuration from YAML (custom hooks).
+ *
+ * Note: core is DI-first; most hosts should resolve hooks outside core.
  */
-export interface PluginConfig {
+export interface HookConfig {
     name: string;
     module: string;
     enabled: boolean;
     blocking: boolean;
     priority: number;
-    config?: Record<string, any> | undefined;
+    config?: Record<string, unknown> | undefined;
 }
 /**
- * Loaded plugin with its configuration
- * Internal type used by PluginManager
+ * Loaded hook with its configuration.
+ * Internal type used by HookManager.
  */
-export interface LoadedPlugin {
-    plugin: DextoPlugin;
-    config: PluginConfig;
+export interface LoadedHook {
+    hook: Hook;
+    config: HookConfig;
 }
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/index.browser.cjs

@@ -18,22 +18,22 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var index_browser_exports = {};
 __export(index_browser_exports, {
-  ALLOWED_TOOLS_STORAGE_TYPES: () => import_schemas3.ALLOWED_TOOLS_STORAGE_TYPES,
+  ALLOWED_TOOLS_STORAGE_TYPES: () => import_schemas2.ALLOWED_TOOLS_STORAGE_TYPES,
   ApprovalStatus: () => import_types4.ApprovalStatus,
   ApprovalType: () => import_types4.ApprovalType,
-  CACHE_TYPES: () => import_schemas2.CACHE_TYPES,
-  DATABASE_TYPES: () => import_schemas2.DATABASE_TYPES,
-  DEFAULT_ALLOWED_TOOLS_STORAGE: () => import_schemas3.DEFAULT_ALLOWED_TOOLS_STORAGE,
+  DEFAULT_ALLOWED_TOOLS_STORAGE: () => import_schemas2.DEFAULT_ALLOWED_TOOLS_STORAGE,
   DEFAULT_MCP_CONNECTION_MODE: () => import_schemas.DEFAULT_MCP_CONNECTION_MODE,
-  DEFAULT_TOOL_CONFIRMATION_MODE: () => import_schemas3.DEFAULT_TOOL_CONFIRMATION_MODE,
+  DEFAULT_PERMISSIONS_MODE: () => import_schemas2.DEFAULT_PERMISSIONS_MODE,
   DenialReason: () => import_types4.DenialReason,
+  EnvExpandedString: () => import_result2.EnvExpandedString,
   ErrorScope: () => import_types.ErrorScope,
   ErrorType: () => import_types.ErrorType,
   LLM_PROVIDERS: () => import_types3.LLM_PROVIDERS,
   MCP_CONNECTION_MODES: () => import_schemas.MCP_CONNECTION_MODES,
   MCP_SERVER_TYPES: () => import_schemas.MCP_SERVER_TYPES,
+  PERMISSIONS_MODES: () => import_schemas2.PERMISSIONS_MODES,
   PROMPT_GENERATOR_SOURCES: () => import_registry.PROMPT_GENERATOR_SOURCES,
-  TOOL_CONFIRMATION_MODES: () => import_schemas3.TOOL_CONFIRMATION_MODES,
+  StorageErrorCode: () => import_error_codes.StorageErrorCode,
   getFileMediaKind: () => import_media_helpers.getFileMediaKind,
   getResourceKind: () => import_media_helpers.getResourceKind,
   isAssistantMessage: () => import_types2.isAssistantMessage,
@@ -52,13 +52,14 @@ __export(index_browser_exports, {
 module.exports = __toCommonJS(index_browser_exports);
 var import_error_conversion = require("./utils/error-conversion.js");
 var import_result = require("./utils/result.js");
+var import_result2 = require("./utils/result.js");
 var import_types = require("./errors/types.js");
 var import_types2 = require("./context/types.js");
 var import_media_helpers = require("./context/media-helpers.js");
 var import_types3 = require("./llm/types.js");
 var import_schemas = require("./mcp/schemas.js");
-var import_schemas2 = require("./storage/schemas.js");
-var import_schemas3 = require("./tools/schemas.js");
+var import_error_codes = require("./storage/error-codes.js");
+var import_schemas2 = require("./tools/schemas.js");
 var import_types4 = require("./approval/types.js");
 var import_registry = require("./systemPrompt/registry.js");
 var import_reference_parser = require("./resources/reference-parser.js");
@@ -67,19 +68,19 @@ var import_reference_parser = require("./resources/reference-parser.js");
   ALLOWED_TOOLS_STORAGE_TYPES,
   ApprovalStatus,
   ApprovalType,
-  CACHE_TYPES,
-  DATABASE_TYPES,
   DEFAULT_ALLOWED_TOOLS_STORAGE,
   DEFAULT_MCP_CONNECTION_MODE,
-  DEFAULT_TOOL_CONFIRMATION_MODE,
+  DEFAULT_PERMISSIONS_MODE,
   DenialReason,
+  EnvExpandedString,
   ErrorScope,
   ErrorType,
   LLM_PROVIDERS,
   MCP_CONNECTION_MODES,
   MCP_SERVER_TYPES,
+  PERMISSIONS_MODES,
   PROMPT_GENERATOR_SOURCES,
-  TOOL_CONFIRMATION_MODES,
+  StorageErrorCode,
   getFileMediaKind,
   getResourceKind,
   isAssistantMessage,

package/dist/index.browser.d.ts

@@ -1,5 +1,6 @@
 export { toError } from './utils/error-conversion.js';
 export { zodToIssues } from './utils/result.js';
+export { EnvExpandedString } from './utils/result.js';
 export { ErrorScope, ErrorType } from './errors/types.js';
 export type { Issue, Severity, DextoErrorCode } from './errors/types.js';
 export type { InternalMessage, SystemMessage, UserMessage, AssistantMessage, ToolMessage, TextPart, FilePart, ImageData, FileData, UIResourcePart, ContentPart, ToolCall, ToolApprovalStatus, } from './context/types.js';
@@ -9,14 +10,13 @@ export type { LLMProvider } from './llm/types.js';
 export { LLM_PROVIDERS } from './llm/types.js';
 export type { McpServerType, McpConnectionMode } from './mcp/schemas.js';
 export { MCP_SERVER_TYPES, MCP_CONNECTION_MODES, DEFAULT_MCP_CONNECTION_MODE, } from './mcp/schemas.js';
-export type { CacheType, DatabaseType } from './storage/schemas.js';
-export { CACHE_TYPES, DATABASE_TYPES } from './storage/schemas.js';
-export type { ToolConfirmationMode, AllowedToolsStorageType } from './tools/schemas.js';
-export { TOOL_CONFIRMATION_MODES, ALLOWED_TOOLS_STORAGE_TYPES, DEFAULT_TOOL_CONFIRMATION_MODE, DEFAULT_ALLOWED_TOOLS_STORAGE, } from './tools/schemas.js';
+export { StorageErrorCode } from './storage/error-codes.js';
+export type { PermissionsMode, AllowedToolsStorageType } from './tools/schemas.js';
+export { PERMISSIONS_MODES, ALLOWED_TOOLS_STORAGE_TYPES, DEFAULT_PERMISSIONS_MODE, DEFAULT_ALLOWED_TOOLS_STORAGE, } from './tools/schemas.js';
 export { ApprovalStatus, ApprovalType, DenialReason } from './approval/types.js';
 export type { ApprovalRequest, ApprovalResponse } from './approval/types.js';
 export type { SessionMetadata } from './session/session-manager.js';
-export type { AgentConfig, ValidatedAgentConfig } from './agent/schemas.js';
+export type { WorkspaceContext, SetWorkspaceInput } from './workspace/types.js';
 export { PROMPT_GENERATOR_SOURCES } from './systemPrompt/registry.js';
 export type { ContributorConfig, SystemPromptConfig } from './systemPrompt/schemas.js';
 export type { SearchOptions, SearchResult, SessionSearchResult, SearchResponse, SessionSearchResponse, } from './search/types.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG1D,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGzE,YAAY,EACR,eAAe,EACf,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,cAAc,EACd,WAAW,EACX,QAAQ,EACR,kBAAkB,GACrB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACH,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG/E,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,GAC9B,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGnE,YAAY,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EACH,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,GAChC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGvF,YAAY,EACR,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGxE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EACH,uBAAuB,EACvB,yBAAyB,GAC5B,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG1D,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGzE,YAAY,EACR,eAAe,EACf,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,cAAc,EACd,WAAW,EACX,QAAQ,EACR,kBAAkB,GACrB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACH,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG/E,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,GAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EACH,iBAAiB,EACjB,2BAA2B,EAC3B,wBAAwB,EACxB,6BAA6B,GAChC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGvF,YAAY,EACR,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGxE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EACH,uBAAuB,EACvB,yBAAyB,GAC5B,MAAM,iCAAiC,CAAC"}

package/dist/index.browser.js

@@ -1,6 +1,7 @@
 import "./chunk-PTJYTZNU.js";
 import { toError } from "./utils/error-conversion.js";
 import { zodToIssues } from "./utils/result.js";
+import { EnvExpandedString } from "./utils/result.js";
 import { ErrorScope, ErrorType } from "./errors/types.js";
 import {
   isSystemMessage,
@@ -19,11 +20,11 @@ import {
   MCP_CONNECTION_MODES,
   DEFAULT_MCP_CONNECTION_MODE
 } from "./mcp/schemas.js";
-import { CACHE_TYPES, DATABASE_TYPES } from "./storage/schemas.js";
+import { StorageErrorCode } from "./storage/error-codes.js";
 import {
-  TOOL_CONFIRMATION_MODES,
+  PERMISSIONS_MODES,
   ALLOWED_TOOLS_STORAGE_TYPES,
-  DEFAULT_TOOL_CONFIRMATION_MODE,
+  DEFAULT_PERMISSIONS_MODE,
   DEFAULT_ALLOWED_TOOLS_STORAGE
 } from "./tools/schemas.js";
 import { ApprovalStatus, ApprovalType, DenialReason } from "./approval/types.js";
@@ -36,19 +37,19 @@ export {
   ALLOWED_TOOLS_STORAGE_TYPES,
   ApprovalStatus,
   ApprovalType,
-  CACHE_TYPES,
-  DATABASE_TYPES,
   DEFAULT_ALLOWED_TOOLS_STORAGE,
   DEFAULT_MCP_CONNECTION_MODE,
-  DEFAULT_TOOL_CONFIRMATION_MODE,
+  DEFAULT_PERMISSIONS_MODE,
   DenialReason,
+  EnvExpandedString,
   ErrorScope,
   ErrorType,
   LLM_PROVIDERS,
   MCP_CONNECTION_MODES,
   MCP_SERVER_TYPES,
+  PERMISSIONS_MODES,
   PROMPT_GENERATOR_SOURCES,
-  TOOL_CONFIRMATION_MODES,
+  StorageErrorCode,
   getFileMediaKind,
   getResourceKind,
   isAssistantMessage,