@dexto/core 1.5.8 → 1.6.0

package/dist/plugins/index.cjs

@@ -1,61 +0,0 @@
-"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 plugins_exports = {};
-__export(plugins_exports, {
-  BuiltInPluginConfigSchema: () => import_schemas.BuiltInPluginConfigSchema,
-  ContentPolicyPlugin: () => import_content_policy.ContentPolicyPlugin,
-  CustomPluginConfigSchema: () => import_schemas.CustomPluginConfigSchema,
-  PluginErrorCode: () => import_error_codes.PluginErrorCode,
-  PluginManager: () => import_manager.PluginManager,
-  PluginRegistry: () => import_registry.PluginRegistry,
-  PluginsConfigSchema: () => import_schemas.PluginsConfigSchema,
-  RegistryPluginConfigSchema: () => import_schemas.RegistryPluginConfigSchema,
-  ResponseSanitizerPlugin: () => import_response_sanitizer.ResponseSanitizerPlugin,
-  loadPluginModule: () => import_loader.loadPluginModule,
-  pluginRegistry: () => import_registry.pluginRegistry,
-  registerBuiltInPlugins: () => import_builtins.registerBuiltInPlugins,
-  resolvePluginPath: () => import_loader.resolvePluginPath,
-  validatePluginShape: () => import_loader.validatePluginShape
-});
-module.exports = __toCommonJS(plugins_exports);
-var import_manager = require("./manager.js");
-var import_schemas = require("./schemas.js");
-var import_registry = require("./registry.js");
-var import_error_codes = require("./error-codes.js");
-var import_loader = require("./loader.js");
-var import_builtins = require("./registrations/builtins.js");
-var import_content_policy = require("./builtins/content-policy.js");
-var import_response_sanitizer = require("./builtins/response-sanitizer.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  BuiltInPluginConfigSchema,
-  ContentPolicyPlugin,
-  CustomPluginConfigSchema,
-  PluginErrorCode,
-  PluginManager,
-  PluginRegistry,
-  PluginsConfigSchema,
-  RegistryPluginConfigSchema,
-  ResponseSanitizerPlugin,
-  loadPluginModule,
-  pluginRegistry,
-  registerBuiltInPlugins,
-  resolvePluginPath,
-  validatePluginShape
-});

package/dist/plugins/index.d.ts

@@ -1,21 +0,0 @@
-/**
- * Plugin System
- *
- * Unified plugin architecture for extending agent behavior at key extension points.
- * Replaces the hooks system from PR #385 with a more flexible plugin model.
- */
-export type { DextoPlugin, PluginConfig, PluginExecutionContext, PluginResult, PluginNotice, ExtensionPoint, BeforeLLMRequestPayload, BeforeToolCallPayload, AfterToolResultPayload, BeforeResponsePayload, } from './types.js';
-export { PluginManager } from './manager.js';
-export type { PluginManagerOptions, ExecutionContextOptions } from './manager.js';
-export { CustomPluginConfigSchema, BuiltInPluginConfigSchema, PluginsConfigSchema, RegistryPluginConfigSchema, } from './schemas.js';
-export type { PluginsConfig, ValidatedPluginsConfig, RegistryPluginConfig } from './schemas.js';
-export { PluginRegistry, pluginRegistry } from './registry.js';
-export type { PluginProvider, PluginCreationContext } from './registry.js';
-export { PluginErrorCode } from './error-codes.js';
-export { loadPluginModule, resolvePluginPath, validatePluginShape } from './loader.js';
-export { registerBuiltInPlugins } from './registrations/builtins.js';
-export { ContentPolicyPlugin } from './builtins/content-policy.js';
-export type { ContentPolicyConfig } from './builtins/content-policy.js';
-export { ResponseSanitizerPlugin } from './builtins/response-sanitizer.js';
-export type { ResponseSanitizerConfig } from './builtins/response-sanitizer.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACR,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGlF,OAAO,EACH,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,0BAA0B,GAC7B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGhG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,YAAY,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/plugins/index.js

@@ -1,30 +0,0 @@
-import "../chunk-PTJYTZNU.js";
-import { PluginManager } from "./manager.js";
-import {
-  CustomPluginConfigSchema,
-  BuiltInPluginConfigSchema,
-  PluginsConfigSchema,
-  RegistryPluginConfigSchema
-} from "./schemas.js";
-import { PluginRegistry, pluginRegistry } from "./registry.js";
-import { PluginErrorCode } from "./error-codes.js";
-import { loadPluginModule, resolvePluginPath, validatePluginShape } from "./loader.js";
-import { registerBuiltInPlugins } from "./registrations/builtins.js";
-import { ContentPolicyPlugin } from "./builtins/content-policy.js";
-import { ResponseSanitizerPlugin } from "./builtins/response-sanitizer.js";
-export {
-  BuiltInPluginConfigSchema,
-  ContentPolicyPlugin,
-  CustomPluginConfigSchema,
-  PluginErrorCode,
-  PluginManager,
-  PluginRegistry,
-  PluginsConfigSchema,
-  RegistryPluginConfigSchema,
-  ResponseSanitizerPlugin,
-  loadPluginModule,
-  pluginRegistry,
-  registerBuiltInPlugins,
-  resolvePluginPath,
-  validatePluginShape
-};

package/dist/plugins/loader.cjs

@@ -1,171 +0,0 @@
-"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 loader_exports = {};
-__export(loader_exports, {
-  loadPluginModule: () => loadPluginModule,
-  resolvePluginPath: () => resolvePluginPath,
-  validatePluginShape: () => validatePluginShape
-});
-module.exports = __toCommonJS(loader_exports);
-var import_path = require("path");
-var import_url = require("url");
-var import_errors = require("../errors/index.js");
-var import_error_codes = require("./error-codes.js");
-const import_meta = {};
-function validatePluginShape(PluginClass, pluginName) {
-  if (typeof PluginClass !== "function" || !PluginClass.prototype) {
-    throw new import_errors.DextoRuntimeError(
-      import_error_codes.PluginErrorCode.PLUGIN_INVALID_SHAPE,
-      import_errors.ErrorScope.PLUGIN,
-      import_errors.ErrorType.USER,
-      `Plugin '${pluginName}' default export must be a class or constructor function`
-    );
-  }
-  const proto = PluginClass.prototype;
-  const extensionPoints = [
-    "beforeLLMRequest",
-    "beforeToolCall",
-    "afterToolResult",
-    "beforeResponse"
-  ];
-  const hasExtensionPoint = extensionPoints.some((point) => typeof proto[point] === "function");
-  if (!hasExtensionPoint) {
-    throw new import_errors.DextoRuntimeError(
-      import_error_codes.PluginErrorCode.PLUGIN_INVALID_SHAPE,
-      import_errors.ErrorScope.PLUGIN,
-      import_errors.ErrorType.USER,
-      `Plugin '${pluginName}' must implement at least one extension point method`,
-      { availableExtensionPoints: extensionPoints }
-    );
-  }
-  if ("initialize" in proto && typeof proto.initialize !== "function") {
-    throw new import_errors.DextoRuntimeError(
-      import_error_codes.PluginErrorCode.PLUGIN_INVALID_SHAPE,
-      import_errors.ErrorScope.PLUGIN,
-      import_errors.ErrorType.USER,
-      `Plugin '${pluginName}' initialize property must be a function (found ${typeof proto.initialize})`
-    );
-  }
-  if ("cleanup" in proto && typeof proto.cleanup !== "function") {
-    throw new import_errors.DextoRuntimeError(
-      import_error_codes.PluginErrorCode.PLUGIN_INVALID_SHAPE,
-      import_errors.ErrorScope.PLUGIN,
-      import_errors.ErrorType.USER,
-      `Plugin '${pluginName}' cleanup property must be a function (found ${typeof proto.cleanup})`
-    );
-  }
-}
-function resolvePluginPath(modulePath, configDir) {
-  if (!(0, import_path.isAbsolute)(modulePath)) {
-    throw new import_errors.DextoRuntimeError(
-      import_error_codes.PluginErrorCode.PLUGIN_CONFIGURATION_INVALID,
-      import_errors.ErrorScope.PLUGIN,
-      import_errors.ErrorType.USER,
-      "Plugin module path must be absolute (got '" + modulePath + "'). Use ${{dexto.agent_dir}} template variable for agent-relative paths.",
-      {
-        modulePath,
-        configDir,
-        hint: 'Example: module: "${{dexto.agent_dir}}/plugins/my-plugin.ts"'
-      }
-    );
-  }
-  return modulePath;
-}
-async function loadPluginModule(modulePath, pluginName) {
-  try {
-    let pluginModule;
-    if (modulePath.endsWith(".ts") || modulePath.endsWith(".tsx")) {
-      if (typeof process === "undefined" || !process.versions?.node) {
-        throw new import_errors.DextoRuntimeError(
-          import_error_codes.PluginErrorCode.PLUGIN_LOAD_FAILED,
-          import_errors.ErrorScope.PLUGIN,
-          import_errors.ErrorType.SYSTEM,
-          `Cannot load TypeScript plugin '${pluginName}' in browser environment. Plugins with .ts extension require Node.js runtime.`,
-          { modulePath, pluginName }
-        );
-      }
-      const tsxPackage = "tsx/esm/api";
-      let tsx;
-      try {
-        tsx = await import(
-          /* webpackIgnore: true */
-          tsxPackage
-        );
-      } catch (importError) {
-        const err = importError;
-        if (err.code === "ERR_MODULE_NOT_FOUND") {
-          throw new import_errors.DextoRuntimeError(
-            import_error_codes.PluginErrorCode.PLUGIN_DEPENDENCY_NOT_INSTALLED,
-            import_errors.ErrorScope.PLUGIN,
-            import_errors.ErrorType.USER,
-            `Cannot load TypeScript plugin '${pluginName}': tsx package is not installed.
-Install with: npm install tsx
-Or pre-compile your plugin to .js for production use.`,
-            { modulePath, pluginName, packageName: "tsx" }
-          );
-        }
-        throw importError;
-      }
-      const moduleUrl = (0, import_url.pathToFileURL)(modulePath).href;
-      pluginModule = await tsx.tsImport(moduleUrl, import_meta.url);
-    } else {
-      const moduleUrl = (0, import_url.pathToFileURL)(modulePath).href;
-      pluginModule = await import(
-        /* webpackIgnore: true */
-        moduleUrl
-      );
-    }
-    let PluginClass = pluginModule.default;
-    if (PluginClass && typeof PluginClass === "object" && "default" in PluginClass) {
-      PluginClass = PluginClass.default;
-    }
-    if (!PluginClass) {
-      throw new import_errors.DextoRuntimeError(
-        import_error_codes.PluginErrorCode.PLUGIN_INVALID_SHAPE,
-        import_errors.ErrorScope.PLUGIN,
-        import_errors.ErrorType.USER,
-        `Plugin '${pluginName}' at '${modulePath}' has no default export. Ensure your plugin exports a class as default.`,
-        { modulePath, pluginName }
-      );
-    }
-    validatePluginShape(PluginClass, pluginName);
-    return PluginClass;
-  } catch (error) {
-    if (error instanceof import_errors.DextoRuntimeError) {
-      throw error;
-    }
-    throw new import_errors.DextoRuntimeError(
-      import_error_codes.PluginErrorCode.PLUGIN_LOAD_FAILED,
-      import_errors.ErrorScope.PLUGIN,
-      import_errors.ErrorType.SYSTEM,
-      `Failed to load plugin '${pluginName}' from '${modulePath}': ${error instanceof Error ? error.message : String(error)}`,
-      {
-        modulePath,
-        pluginName,
-        originalError: error instanceof Error ? error.message : String(error)
-      }
-    );
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  loadPluginModule,
-  resolvePluginPath,
-  validatePluginShape
-});

package/dist/plugins/loader.d.ts

@@ -1,30 +0,0 @@
-/**
- * Validate that a loaded plugin implements the DextoPlugin interface correctly
- * Performs runtime checks that complement TypeScript's compile-time type checking
- *
- * @param PluginClass - The plugin class constructor
- * @param pluginName - Name for error messages
- * @throws {DextoRuntimeError} If validation fails
- */
-export declare function validatePluginShape(PluginClass: any, pluginName: string): void;
-/**
- * Resolve and validate plugin module path
- * Ensures path is absolute after template variable expansion
- *
- * @param modulePath - Path from config (after template expansion)
- * @param configDir - Directory containing agent config (for validation context)
- * @returns Resolved absolute path
- * @throws {DextoRuntimeError} If path is not absolute
- */
-export declare function resolvePluginPath(modulePath: string, configDir: string): string;
-/**
- * Load a plugin from a module path
- * Supports both .ts (via tsx) and .js files
- *
- * @param modulePath - Absolute path to plugin module
- * @param pluginName - Name for error messages
- * @returns Plugin class constructor
- * @throws {DextoRuntimeError} If loading or validation fails
- */
-export declare function loadPluginModule(modulePath: string, pluginName: string): Promise<any>;
-//# sourceMappingURL=loader.d.ts.map

package/dist/plugins/loader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAqD9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAoB/E;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAuG3F"}

package/dist/plugins/loader.js

@@ -1,145 +0,0 @@
-import "../chunk-PTJYTZNU.js";
-import { isAbsolute } from "path";
-import { pathToFileURL } from "url";
-import { DextoRuntimeError, ErrorScope, ErrorType } from "../errors/index.js";
-import { PluginErrorCode } from "./error-codes.js";
-function validatePluginShape(PluginClass, pluginName) {
-  if (typeof PluginClass !== "function" || !PluginClass.prototype) {
-    throw new DextoRuntimeError(
-      PluginErrorCode.PLUGIN_INVALID_SHAPE,
-      ErrorScope.PLUGIN,
-      ErrorType.USER,
-      `Plugin '${pluginName}' default export must be a class or constructor function`
-    );
-  }
-  const proto = PluginClass.prototype;
-  const extensionPoints = [
-    "beforeLLMRequest",
-    "beforeToolCall",
-    "afterToolResult",
-    "beforeResponse"
-  ];
-  const hasExtensionPoint = extensionPoints.some((point) => typeof proto[point] === "function");
-  if (!hasExtensionPoint) {
-    throw new DextoRuntimeError(
-      PluginErrorCode.PLUGIN_INVALID_SHAPE,
-      ErrorScope.PLUGIN,
-      ErrorType.USER,
-      `Plugin '${pluginName}' must implement at least one extension point method`,
-      { availableExtensionPoints: extensionPoints }
-    );
-  }
-  if ("initialize" in proto && typeof proto.initialize !== "function") {
-    throw new DextoRuntimeError(
-      PluginErrorCode.PLUGIN_INVALID_SHAPE,
-      ErrorScope.PLUGIN,
-      ErrorType.USER,
-      `Plugin '${pluginName}' initialize property must be a function (found ${typeof proto.initialize})`
-    );
-  }
-  if ("cleanup" in proto && typeof proto.cleanup !== "function") {
-    throw new DextoRuntimeError(
-      PluginErrorCode.PLUGIN_INVALID_SHAPE,
-      ErrorScope.PLUGIN,
-      ErrorType.USER,
-      `Plugin '${pluginName}' cleanup property must be a function (found ${typeof proto.cleanup})`
-    );
-  }
-}
-function resolvePluginPath(modulePath, configDir) {
-  if (!isAbsolute(modulePath)) {
-    throw new DextoRuntimeError(
-      PluginErrorCode.PLUGIN_CONFIGURATION_INVALID,
-      ErrorScope.PLUGIN,
-      ErrorType.USER,
-      "Plugin module path must be absolute (got '" + modulePath + "'). Use ${{dexto.agent_dir}} template variable for agent-relative paths.",
-      {
-        modulePath,
-        configDir,
-        hint: 'Example: module: "${{dexto.agent_dir}}/plugins/my-plugin.ts"'
-      }
-    );
-  }
-  return modulePath;
-}
-async function loadPluginModule(modulePath, pluginName) {
-  try {
-    let pluginModule;
-    if (modulePath.endsWith(".ts") || modulePath.endsWith(".tsx")) {
-      if (typeof process === "undefined" || !process.versions?.node) {
-        throw new DextoRuntimeError(
-          PluginErrorCode.PLUGIN_LOAD_FAILED,
-          ErrorScope.PLUGIN,
-          ErrorType.SYSTEM,
-          `Cannot load TypeScript plugin '${pluginName}' in browser environment. Plugins with .ts extension require Node.js runtime.`,
-          { modulePath, pluginName }
-        );
-      }
-      const tsxPackage = "tsx/esm/api";
-      let tsx;
-      try {
-        tsx = await import(
-          /* webpackIgnore: true */
-          tsxPackage
-        );
-      } catch (importError) {
-        const err = importError;
-        if (err.code === "ERR_MODULE_NOT_FOUND") {
-          throw new DextoRuntimeError(
-            PluginErrorCode.PLUGIN_DEPENDENCY_NOT_INSTALLED,
-            ErrorScope.PLUGIN,
-            ErrorType.USER,
-            `Cannot load TypeScript plugin '${pluginName}': tsx package is not installed.
-Install with: npm install tsx
-Or pre-compile your plugin to .js for production use.`,
-            { modulePath, pluginName, packageName: "tsx" }
-          );
-        }
-        throw importError;
-      }
-      const moduleUrl = pathToFileURL(modulePath).href;
-      pluginModule = await tsx.tsImport(moduleUrl, import.meta.url);
-    } else {
-      const moduleUrl = pathToFileURL(modulePath).href;
-      pluginModule = await import(
-        /* webpackIgnore: true */
-        moduleUrl
-      );
-    }
-    let PluginClass = pluginModule.default;
-    if (PluginClass && typeof PluginClass === "object" && "default" in PluginClass) {
-      PluginClass = PluginClass.default;
-    }
-    if (!PluginClass) {
-      throw new DextoRuntimeError(
-        PluginErrorCode.PLUGIN_INVALID_SHAPE,
-        ErrorScope.PLUGIN,
-        ErrorType.USER,
-        `Plugin '${pluginName}' at '${modulePath}' has no default export. Ensure your plugin exports a class as default.`,
-        { modulePath, pluginName }
-      );
-    }
-    validatePluginShape(PluginClass, pluginName);
-    return PluginClass;
-  } catch (error) {
-    if (error instanceof DextoRuntimeError) {
-      throw error;
-    }
-    throw new DextoRuntimeError(
-      PluginErrorCode.PLUGIN_LOAD_FAILED,
-      ErrorScope.PLUGIN,
-      ErrorType.SYSTEM,
-      `Failed to load plugin '${pluginName}' from '${modulePath}': ${error instanceof Error ? error.message : String(error)}`,
-      {
-        modulePath,
-        pluginName,
-        originalError: error instanceof Error ? error.message : String(error)
-      }
-    );
-  }
-}
-export {
-  loadPluginModule,
-  resolvePluginPath,
-  validatePluginShape
-};