@dexto/core 1.3.0 → 1.5.0

package/dist/memory/schemas.d.ts

@@ -89,18 +89,18 @@ export declare const UpdateMemoryInputSchema: z.ZodObject<{
         pinned: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">>>;
 }, "strict", z.ZodTypeAny, {
+    content?: string | undefined;
     metadata?: z.objectOutputType<{
         source: z.ZodOptional<z.ZodEnum<["user", "system"]>>;
         pinned: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
-    content?: string | undefined;
     tags?: string[] | undefined;
 }, {
+    content?: string | undefined;
     metadata?: z.objectInputType<{
         source: z.ZodOptional<z.ZodEnum<["user", "system"]>>;
         pinned: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
-    content?: string | undefined;
     tags?: string[] | undefined;
 }>;
 export declare const ListMemoriesOptionsSchema: z.ZodObject<{
@@ -143,8 +143,8 @@ export declare const MemoriesConfigSchema: z.ZodObject<{
     limit?: number | undefined;
 }, {
     enabled?: boolean | undefined;
-    limit?: number | undefined;
     priority?: number | undefined;
+    limit?: number | undefined;
     includeTimestamps?: boolean | undefined;
     includeTags?: boolean | undefined;
     pinnedOnly?: boolean | undefined;

package/dist/memory/schemas.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { z } from "zod";
 const MAX_CONTENT_LENGTH = 1e4;
 const MAX_TAG_LENGTH = 50;

package/dist/plugins/builtins/content-policy.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 const DEFAULTS = {
   maxInputChars: 0,
   redactEmails: false,

package/dist/plugins/builtins/response-sanitizer.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 const DEFAULTS = {
   redactEmails: false,
   redactApiKeys: false,

package/dist/plugins/error-codes.cjs

@@ -32,6 +32,9 @@ var PluginErrorCode = /* @__PURE__ */ ((PluginErrorCode2) => {
   PluginErrorCode2["PLUGIN_BLOCKED_EXECUTION"] = "PLUGIN_BLOCKED_EXECUTION";
   PluginErrorCode2["PLUGIN_DUPLICATE_PRIORITY"] = "PLUGIN_DUPLICATE_PRIORITY";
   PluginErrorCode2["PLUGIN_DEPENDENCY_NOT_INSTALLED"] = "PLUGIN_DEPENDENCY_NOT_INSTALLED";
+  PluginErrorCode2["PLUGIN_PROVIDER_ALREADY_REGISTERED"] = "PLUGIN_PROVIDER_ALREADY_REGISTERED";
+  PluginErrorCode2["PLUGIN_PROVIDER_NOT_FOUND"] = "PLUGIN_PROVIDER_NOT_FOUND";
+  PluginErrorCode2["PLUGIN_PROVIDER_VALIDATION_FAILED"] = "PLUGIN_PROVIDER_VALIDATION_FAILED";
   return PluginErrorCode2;
 })(PluginErrorCode || {});
 // Annotate the CommonJS export names for ESM import in node:

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

@@ -22,7 +22,13 @@ export declare enum PluginErrorCode {
     /** Duplicate plugin priority */
     PLUGIN_DUPLICATE_PRIORITY = "PLUGIN_DUPLICATE_PRIORITY",
     /** Required dependency not installed for plugin loading */
-    PLUGIN_DEPENDENCY_NOT_INSTALLED = "PLUGIN_DEPENDENCY_NOT_INSTALLED"
+    PLUGIN_DEPENDENCY_NOT_INSTALLED = "PLUGIN_DEPENDENCY_NOT_INSTALLED",
+    /** Plugin provider already registered in registry */
+    PLUGIN_PROVIDER_ALREADY_REGISTERED = "PLUGIN_PROVIDER_ALREADY_REGISTERED",
+    /** Plugin provider not found in registry */
+    PLUGIN_PROVIDER_NOT_FOUND = "PLUGIN_PROVIDER_NOT_FOUND",
+    /** Plugin provider configuration validation failed */
+    PLUGIN_PROVIDER_VALIDATION_FAILED = "PLUGIN_PROVIDER_VALIDATION_FAILED"
 }
 export type { PluginErrorCode as default };
 //# sourceMappingURL=error-codes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/plugins/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,eAAe;IACvB,gDAAgD;IAChD,kBAAkB,uBAAuB;IAEzC,mDAAmD;IACnD,oBAAoB,yBAAyB;IAE7C,wCAAwC;IACxC,2BAA2B,gCAAgC;IAE3D,mCAAmC;IACnC,4BAA4B,iCAAiC;IAE7D,sCAAsC;IACtC,4BAA4B,iCAAiC;IAE7D,8BAA8B;IAC9B,uBAAuB,4BAA4B;IAEnD,iCAAiC;IACjC,wBAAwB,6BAA6B;IAErD,+BAA+B;IAC/B,wBAAwB,6BAA6B;IAErD,gCAAgC;IAChC,yBAAyB,8BAA8B;IAEvD,2DAA2D;IAC3D,+BAA+B,oCAAoC;CACtE;AAED,YAAY,EAAE,eAAe,IAAI,OAAO,EAAE,CAAC"}
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/plugins/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,eAAe;IACvB,gDAAgD;IAChD,kBAAkB,uBAAuB;IAEzC,mDAAmD;IACnD,oBAAoB,yBAAyB;IAE7C,wCAAwC;IACxC,2BAA2B,gCAAgC;IAE3D,mCAAmC;IACnC,4BAA4B,iCAAiC;IAE7D,sCAAsC;IACtC,4BAA4B,iCAAiC;IAE7D,8BAA8B;IAC9B,uBAAuB,4BAA4B;IAEnD,iCAAiC;IACjC,wBAAwB,6BAA6B;IAErD,+BAA+B;IAC/B,wBAAwB,6BAA6B;IAErD,gCAAgC;IAChC,yBAAyB,8BAA8B;IAEvD,2DAA2D;IAC3D,+BAA+B,oCAAoC;IAEnE,qDAAqD;IACrD,kCAAkC,uCAAuC;IAEzE,4CAA4C;IAC5C,yBAAyB,8BAA8B;IAEvD,sDAAsD;IACtD,iCAAiC,sCAAsC;CAC1E;AAED,YAAY,EAAE,eAAe,IAAI,OAAO,EAAE,CAAC"}

package/dist/plugins/error-codes.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 var PluginErrorCode = /* @__PURE__ */ ((PluginErrorCode2) => {
   PluginErrorCode2["PLUGIN_LOAD_FAILED"] = "PLUGIN_LOAD_FAILED";
   PluginErrorCode2["PLUGIN_INVALID_SHAPE"] = "PLUGIN_INVALID_SHAPE";
@@ -10,6 +10,9 @@ var PluginErrorCode = /* @__PURE__ */ ((PluginErrorCode2) => {
   PluginErrorCode2["PLUGIN_BLOCKED_EXECUTION"] = "PLUGIN_BLOCKED_EXECUTION";
   PluginErrorCode2["PLUGIN_DUPLICATE_PRIORITY"] = "PLUGIN_DUPLICATE_PRIORITY";
   PluginErrorCode2["PLUGIN_DEPENDENCY_NOT_INSTALLED"] = "PLUGIN_DEPENDENCY_NOT_INSTALLED";
+  PluginErrorCode2["PLUGIN_PROVIDER_ALREADY_REGISTERED"] = "PLUGIN_PROVIDER_ALREADY_REGISTERED";
+  PluginErrorCode2["PLUGIN_PROVIDER_NOT_FOUND"] = "PLUGIN_PROVIDER_NOT_FOUND";
+  PluginErrorCode2["PLUGIN_PROVIDER_VALIDATION_FAILED"] = "PLUGIN_PROVIDER_VALIDATION_FAILED";
   return PluginErrorCode2;
 })(PluginErrorCode || {});
 export {

package/dist/plugins/index.cjs

@@ -23,9 +23,12 @@ __export(plugins_exports, {
   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
@@ -33,6 +36,7 @@ __export(plugins_exports, {
 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");
@@ -45,9 +49,12 @@ var import_response_sanitizer = require("./builtins/response-sanitizer.js");
   CustomPluginConfigSchema,
   PluginErrorCode,
   PluginManager,
+  PluginRegistry,
   PluginsConfigSchema,
+  RegistryPluginConfigSchema,
   ResponseSanitizerPlugin,
   loadPluginModule,
+  pluginRegistry,
   registerBuiltInPlugins,
   resolvePluginPath,
   validatePluginShape

package/dist/plugins/index.d.ts

@@ -7,8 +7,10 @@
 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, } from './schemas.js';
-export type { PluginsConfig, ValidatedPluginsConfig } from './schemas.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';

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

@@ -1 +1 @@
-{"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,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG1E,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"}
+{"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,10 +1,12 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { PluginManager } from "./manager.js";
 import {
   CustomPluginConfigSchema,
   BuiltInPluginConfigSchema,
-  PluginsConfigSchema
+  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";
@@ -16,9 +18,12 @@ export {
   CustomPluginConfigSchema,
   PluginErrorCode,
   PluginManager,
+  PluginRegistry,
   PluginsConfigSchema,
+  RegistryPluginConfigSchema,
   ResponseSanitizerPlugin,
   loadPluginModule,
+  pluginRegistry,
   registerBuiltInPlugins,
   resolvePluginPath,
   validatePluginShape

package/dist/plugins/loader.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { isAbsolute } from "path";
 import { pathToFileURL } from "url";
 import { DextoRuntimeError, ErrorScope, ErrorType } from "../errors/index.js";

package/dist/plugins/manager.cjs

@@ -25,6 +25,7 @@ var import_errors = require("../errors/index.js");
 var import_error_codes = require("./error-codes.js");
 var import_loader = require("./loader.js");
 var import_async_context = require("../utils/async-context.js");
+var import_registry = require("./registry.js");
 var import_types = require("../logger/v2/types.js");
 class PluginManager {
   plugins = /* @__PURE__ */ new Map();
@@ -73,12 +74,18 @@ class PluginManager {
   }
   /**
    * Initialize all plugins from configuration
-   * Loads custom plugins, validates priorities, sorts by priority, and calls initialize()
+   * Loads custom plugins (file-based), registry plugins (programmatic), validates priorities,
+   * sorts by priority, and calls initialize()
    *
-   * @param customPlugins - Array of custom plugin configurations from YAML
+   * TODO: Consider adding an MCP server-like convention for plugin discovery.
+   * Instead of requiring explicit file paths, plugins could be connected as
+   * plugin servers to the PluginManager.
+   *
+   * @param customPlugins - Array of custom plugin configurations from YAML (file-based)
+   * @param registryPlugins - Array of registry plugin configurations from YAML (programmatic)
    * @throws {DextoRuntimeError} If any plugin fails to load or initialize (fail-fast)
    */
-  async initialize(customPlugins = []) {
+  async initialize(customPlugins = [], registryPlugins = []) {
     if (this.initialized) {
       throw new import_errors.DextoRuntimeError(
         import_error_codes.PluginErrorCode.PLUGIN_CONFIGURATION_INVALID,
@@ -88,9 +95,19 @@ class PluginManager {
       );
     }
     const priorities = /* @__PURE__ */ new Set();
-    const allPlugins = [...this.plugins.values(), ...customPlugins.map((c) => ({ config: c }))];
-    for (const item of allPlugins) {
-      const config = "config" in item ? item.config : item;
+    const allPluginConfigs = [
+      ...Array.from(this.plugins.values()).map((p) => p.config),
+      ...customPlugins,
+      ...registryPlugins.map((r) => ({
+        name: r.type,
+        module: `<registry:${r.type}>`,
+        enabled: r.enabled,
+        blocking: r.blocking,
+        priority: r.priority,
+        config: r.config
+      }))
+    ];
+    for (const config of allPluginConfigs) {
       if (!config.enabled) continue;
       if (priorities.has(config.priority)) {
         throw new import_errors.DextoRuntimeError(
@@ -100,12 +117,80 @@ class PluginManager {
           `Duplicate plugin priority: ${config.priority}. Each plugin must have a unique priority.`,
           {
             priority: config.priority,
-            hint: "Ensure all enabled plugins (built-in and custom) have unique priority values."
+            hint: "Ensure all enabled plugins (built-in, custom, and registry) have unique priority values."
           }
         );
       }
       priorities.add(config.priority);
     }
+    for (const registryConfig of registryPlugins) {
+      if (!registryConfig.enabled) {
+        this.logger.debug(`Skipping disabled registry plugin: ${registryConfig.type}`);
+        continue;
+      }
+      try {
+        const provider = import_registry.pluginRegistry.get(registryConfig.type);
+        if (!provider) {
+          throw new import_errors.DextoRuntimeError(
+            import_error_codes.PluginErrorCode.PLUGIN_PROVIDER_NOT_FOUND,
+            import_errors.ErrorScope.PLUGIN,
+            import_errors.ErrorType.USER,
+            `Plugin provider '${registryConfig.type}' not found in registry`,
+            {
+              type: registryConfig.type,
+              available: import_registry.pluginRegistry.getTypes()
+            },
+            `Available plugin providers: ${import_registry.pluginRegistry.getTypes().join(", ") || "none"}. Register the provider using pluginRegistry.register() before agent initialization.`
+          );
+        }
+        const validatedConfig = provider.configSchema.safeParse({
+          type: registryConfig.type,
+          ...registryConfig.config
+        });
+        if (!validatedConfig.success) {
+          throw new import_errors.DextoRuntimeError(
+            import_error_codes.PluginErrorCode.PLUGIN_PROVIDER_VALIDATION_FAILED,
+            import_errors.ErrorScope.PLUGIN,
+            import_errors.ErrorType.USER,
+            `Invalid configuration for plugin provider '${registryConfig.type}'`,
+            {
+              type: registryConfig.type,
+              errors: validatedConfig.error.errors
+            },
+            "Check the configuration schema for this plugin provider"
+          );
+        }
+        const creationContext = {
+          config: registryConfig.config || {},
+          blocking: registryConfig.blocking,
+          priority: registryConfig.priority
+        };
+        const plugin = provider.create(validatedConfig.data, creationContext);
+        const loadedPlugin = {
+          plugin,
+          config: {
+            name: registryConfig.type,
+            module: `<registry:${registryConfig.type}>`,
+            enabled: registryConfig.enabled,
+            blocking: registryConfig.blocking,
+            priority: registryConfig.priority,
+            config: registryConfig.config
+          }
+        };
+        this.plugins.set(registryConfig.type, loadedPlugin);
+        this.logger.info(`Registry plugin loaded: ${registryConfig.type}`);
+      } catch (error) {
+        if (error instanceof import_errors.DextoRuntimeError) {
+          throw error;
+        }
+        throw new import_errors.DextoRuntimeError(
+          import_error_codes.PluginErrorCode.PLUGIN_INITIALIZATION_FAILED,
+          import_errors.ErrorScope.PLUGIN,
+          import_errors.ErrorType.SYSTEM,
+          `Failed to load registry plugin '${registryConfig.type}': ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
     for (const pluginConfig of customPlugins) {
       if (!pluginConfig.enabled) {
         this.logger.debug(`Skipping disabled plugin: ${pluginConfig.name}`);

package/dist/plugins/manager.d.ts

@@ -1,3 +1,4 @@
+import type { RegistryPluginConfig } from './schemas.js';
 import type { ExtensionPoint, PluginConfig } from './types.js';
 import type { AgentEventBus } from '../events/index.js';
 import type { StorageManager } from '../storage/index.js';
@@ -56,12 +57,18 @@ export declare class PluginManager {
     registerBuiltin(name: string, PluginClass: any, config: Omit<PluginConfig, 'module'>): void;
     /**
      * Initialize all plugins from configuration
-     * Loads custom plugins, validates priorities, sorts by priority, and calls initialize()
+     * Loads custom plugins (file-based), registry plugins (programmatic), validates priorities,
+     * sorts by priority, and calls initialize()
      *
-     * @param customPlugins - Array of custom plugin configurations from YAML
+     * TODO: Consider adding an MCP server-like convention for plugin discovery.
+     * Instead of requiring explicit file paths, plugins could be connected as
+     * plugin servers to the PluginManager.
+     *
+     * @param customPlugins - Array of custom plugin configurations from YAML (file-based)
+     * @param registryPlugins - Array of registry plugin configurations from YAML (programmatic)
      * @throws {DextoRuntimeError} If any plugin fails to load or initialize (fail-fast)
      */
-    initialize(customPlugins?: PluginConfig[]): Promise<void>;
+    initialize(customPlugins?: PluginConfig[], registryPlugins?: RegistryPluginConfig[]): Promise<void>;
     /**
      * Register a plugin to the extension points it implements
      */

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

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/plugins/manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,cAAc,EAEd,YAAY,EAGf,MAAM,YAAY,CAAC;AACpB,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,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC,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;;;;;;;;;GASG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,uBAAuB,CAAkD;IACjF,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAe;IAE7B,0DAA0D;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAQ;gBAEnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY;IAM/D;;;;;;;OAOG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,IAAI;IA8B3F;;;;;;OAMG;IACG,UAAU,CAAC,aAAa,GAAE,YAAY,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAqHnE;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;;;;;;;;OASG;IACG,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9C,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,EACV,OAAO,EAAE,uBAAuB,GACjC,OAAO,CAAC,CAAC,CAAC;IAoKb;;;OAGG;YACW,kBAAkB;IA8BhC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;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;CAcJ"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/plugins/manager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EACR,cAAc,EAEd,YAAY,EAGf,MAAM,YAAY,CAAC;AACpB,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,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC,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;;;;;;;;;GASG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,uBAAuB,CAAkD;IACjF,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAe;IAE7B,0DAA0D;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAQ;gBAEnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY;IAM/D;;;;;;;OAOG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,IAAI;IA8B3F;;;;;;;;;;;;OAYG;IACG,UAAU,CACZ,aAAa,GAAE,YAAY,EAAO,EAClC,eAAe,GAAE,oBAAoB,EAAO,GAC7C,OAAO,CAAC,IAAI,CAAC;IAqNhB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;;;;;;;;OASG;IACG,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9C,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,EACV,OAAO,EAAE,uBAAuB,GACjC,OAAO,CAAC,CAAC,CAAC;IAoKb;;;OAGG;YACW,kBAAkB;IA8BhC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;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;CAcJ"}

package/dist/plugins/manager.js

@@ -1,8 +1,9 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { DextoRuntimeError, ErrorScope, ErrorType } from "../errors/index.js";
 import { PluginErrorCode } from "./error-codes.js";
 import { loadPluginModule, resolvePluginPath } from "./loader.js";
 import { getContext } from "../utils/async-context.js";
+import { pluginRegistry } from "./registry.js";
 import { DextoLogComponent } from "../logger/v2/types.js";
 class PluginManager {
   plugins = /* @__PURE__ */ new Map();
@@ -51,12 +52,18 @@ class PluginManager {
   }
   /**
    * Initialize all plugins from configuration
-   * Loads custom plugins, validates priorities, sorts by priority, and calls initialize()
+   * Loads custom plugins (file-based), registry plugins (programmatic), validates priorities,
+   * sorts by priority, and calls initialize()
    *
-   * @param customPlugins - Array of custom plugin configurations from YAML
+   * TODO: Consider adding an MCP server-like convention for plugin discovery.
+   * Instead of requiring explicit file paths, plugins could be connected as
+   * plugin servers to the PluginManager.
+   *
+   * @param customPlugins - Array of custom plugin configurations from YAML (file-based)
+   * @param registryPlugins - Array of registry plugin configurations from YAML (programmatic)
    * @throws {DextoRuntimeError} If any plugin fails to load or initialize (fail-fast)
    */
-  async initialize(customPlugins = []) {
+  async initialize(customPlugins = [], registryPlugins = []) {
     if (this.initialized) {
       throw new DextoRuntimeError(
         PluginErrorCode.PLUGIN_CONFIGURATION_INVALID,
@@ -66,9 +73,19 @@ class PluginManager {
       );
     }
     const priorities = /* @__PURE__ */ new Set();
-    const allPlugins = [...this.plugins.values(), ...customPlugins.map((c) => ({ config: c }))];
-    for (const item of allPlugins) {
-      const config = "config" in item ? item.config : item;
+    const allPluginConfigs = [
+      ...Array.from(this.plugins.values()).map((p) => p.config),
+      ...customPlugins,
+      ...registryPlugins.map((r) => ({
+        name: r.type,
+        module: `<registry:${r.type}>`,
+        enabled: r.enabled,
+        blocking: r.blocking,
+        priority: r.priority,
+        config: r.config
+      }))
+    ];
+    for (const config of allPluginConfigs) {
       if (!config.enabled) continue;
       if (priorities.has(config.priority)) {
         throw new DextoRuntimeError(
@@ -78,12 +95,80 @@ class PluginManager {
           `Duplicate plugin priority: ${config.priority}. Each plugin must have a unique priority.`,
           {
             priority: config.priority,
-            hint: "Ensure all enabled plugins (built-in and custom) have unique priority values."
+            hint: "Ensure all enabled plugins (built-in, custom, and registry) have unique priority values."
           }
         );
       }
       priorities.add(config.priority);
     }
+    for (const registryConfig of registryPlugins) {
+      if (!registryConfig.enabled) {
+        this.logger.debug(`Skipping disabled registry plugin: ${registryConfig.type}`);
+        continue;
+      }
+      try {
+        const provider = pluginRegistry.get(registryConfig.type);
+        if (!provider) {
+          throw new DextoRuntimeError(
+            PluginErrorCode.PLUGIN_PROVIDER_NOT_FOUND,
+            ErrorScope.PLUGIN,
+            ErrorType.USER,
+            `Plugin provider '${registryConfig.type}' not found in registry`,
+            {
+              type: registryConfig.type,
+              available: pluginRegistry.getTypes()
+            },
+            `Available plugin providers: ${pluginRegistry.getTypes().join(", ") || "none"}. Register the provider using pluginRegistry.register() before agent initialization.`
+          );
+        }
+        const validatedConfig = provider.configSchema.safeParse({
+          type: registryConfig.type,
+          ...registryConfig.config
+        });
+        if (!validatedConfig.success) {
+          throw new DextoRuntimeError(
+            PluginErrorCode.PLUGIN_PROVIDER_VALIDATION_FAILED,
+            ErrorScope.PLUGIN,
+            ErrorType.USER,
+            `Invalid configuration for plugin provider '${registryConfig.type}'`,
+            {
+              type: registryConfig.type,
+              errors: validatedConfig.error.errors
+            },
+            "Check the configuration schema for this plugin provider"
+          );
+        }
+        const creationContext = {
+          config: registryConfig.config || {},
+          blocking: registryConfig.blocking,
+          priority: registryConfig.priority
+        };
+        const plugin = provider.create(validatedConfig.data, creationContext);
+        const loadedPlugin = {
+          plugin,
+          config: {
+            name: registryConfig.type,
+            module: `<registry:${registryConfig.type}>`,
+            enabled: registryConfig.enabled,
+            blocking: registryConfig.blocking,
+            priority: registryConfig.priority,
+            config: registryConfig.config
+          }
+        };
+        this.plugins.set(registryConfig.type, loadedPlugin);
+        this.logger.info(`Registry plugin loaded: ${registryConfig.type}`);
+      } catch (error) {
+        if (error instanceof DextoRuntimeError) {
+          throw error;
+        }
+        throw new DextoRuntimeError(
+          PluginErrorCode.PLUGIN_INITIALIZATION_FAILED,
+          ErrorScope.PLUGIN,
+          ErrorType.SYSTEM,
+          `Failed to load registry plugin '${registryConfig.type}': ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
     for (const pluginConfig of customPlugins) {
       if (!pluginConfig.enabled) {
         this.logger.debug(`Skipping disabled plugin: ${pluginConfig.name}`);

package/dist/plugins/registrations/builtins.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { ContentPolicyPlugin } from "../builtins/content-policy.js";
 import { ResponseSanitizerPlugin } from "../builtins/response-sanitizer.js";
 function registerBuiltInPlugins(args) {

package/dist/plugins/registry.cjs

@@ -0,0 +1,63 @@
+"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 registry_exports = {};
+__export(registry_exports, {
+  PluginRegistry: () => PluginRegistry,
+  pluginRegistry: () => pluginRegistry
+});
+module.exports = __toCommonJS(registry_exports);
+var import_errors = require("../errors/index.js");
+var import_error_codes = require("./error-codes.js");
+var import_base_registry = require("../providers/base-registry.js");
+const pluginRegistryErrorFactory = {
+  alreadyRegistered: (type) => new import_errors.DextoRuntimeError(
+    import_error_codes.PluginErrorCode.PLUGIN_PROVIDER_ALREADY_REGISTERED,
+    import_errors.ErrorScope.PLUGIN,
+    import_errors.ErrorType.USER,
+    `Plugin provider '${type}' is already registered`,
+    { type },
+    "Each plugin provider type can only be registered once"
+  ),
+  notFound: (type, availableTypes) => new import_errors.DextoRuntimeError(
+    import_error_codes.PluginErrorCode.PLUGIN_PROVIDER_NOT_FOUND,
+    import_errors.ErrorScope.PLUGIN,
+    import_errors.ErrorType.USER,
+    `Plugin provider '${type}' not found`,
+    { type, available: availableTypes },
+    `Available plugin providers: ${availableTypes.join(", ") || "none"}`
+  )
+};
+class PluginRegistry extends import_base_registry.BaseRegistry {
+  constructor() {
+    super(pluginRegistryErrorFactory);
+  }
+  /**
+   * Get all registered plugin providers.
+   * Alias for getAll() to match other registry patterns.
+   */
+  getProviders() {
+    return this.getAll();
+  }
+}
+const pluginRegistry = new PluginRegistry();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PluginRegistry,
+  pluginRegistry
+});