@dexto/core 1.5.8 → 1.6.0

package/dist/agent/errors.cjs

@@ -21,8 +21,8 @@ __export(errors_exports, {
   AgentError: () => AgentError
 });
 module.exports = __toCommonJS(errors_exports);
-var import_DextoRuntimeError = require("../errors/DextoRuntimeError.cjs");
-var import_types = require("../errors/types.cjs");
+var import_DextoRuntimeError = require("../errors/DextoRuntimeError.js");
+var import_types = require("../errors/types.js");
 var import_error_codes = require("./error-codes.js");
 class AgentError {
   /**

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agent/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAItE;;;;GAIG;AACH,qBAAa,UAAU;IACnB;;OAEG;IACH,MAAM,CAAC,UAAU;IAWjB;;OAEG;IACH,MAAM,CAAC,cAAc;IAWrB;;OAEG;IACH,MAAM,CAAC,OAAO;IAWd;;OAEG;IACH,MAAM,CAAC,gBAAgB;IAWvB;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAW7D;;OAEG;IACH,MAAM,CAAC,YAAY;IAWnB;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAW5D;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAUzD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agent/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAInE;;;;GAIG;AACH,qBAAa,UAAU;IACnB;;OAEG;IACH,MAAM,CAAC,UAAU;IAWjB;;OAEG;IACH,MAAM,CAAC,cAAc;IAWrB;;OAEG;IACH,MAAM,CAAC,OAAO;IAWd;;OAEG;IACH,MAAM,CAAC,gBAAgB;IAWvB;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAW7D;;OAEG;IACH,MAAM,CAAC,YAAY;IAWnB;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAW5D;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAUzD"}

package/dist/agent/index.cjs

@@ -20,27 +20,22 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var agent_exports = {};
 __export(agent_exports, {
   AgentCardSchema: () => import_schemas.AgentCardSchema,
-  AgentConfigSchema: () => import_schemas.AgentConfigSchema,
   DextoAgent: () => import_DextoAgent.DextoAgent,
   SecuritySchemeSchema: () => import_schemas.SecuritySchemeSchema,
-  createAgentCard: () => import_agentCard.createAgentCard,
-  createAgentConfigSchema: () => import_schemas2.createAgentConfigSchema
+  createAgentCard: () => import_agentCard.createAgentCard
 });
 module.exports = __toCommonJS(agent_exports);
 var import_DextoAgent = require("./DextoAgent.js");
 var import_schemas = require("./schemas.js");
-var import_schemas2 = require("./schemas.js");
 var import_agentCard = require("./agentCard.js");
 __reExport(agent_exports, require("./errors.js"), module.exports);
 __reExport(agent_exports, require("./error-codes.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentCardSchema,
-  AgentConfigSchema,
   DextoAgent,
   SecuritySchemeSchema,
   createAgentCard,
-  createAgentConfigSchema,
   ...require("./errors.js"),
   ...require("./error-codes.js")
 });

package/dist/agent/index.d.ts

@@ -1,9 +1,10 @@
 export { DextoAgent } from './DextoAgent.js';
-export { AgentConfigSchema, AgentCardSchema, SecuritySchemeSchema, type AgentCard, type ValidatedAgentCard, } from './schemas.js';
-export { type ValidatedAgentConfig, type AgentConfig, type LLMValidationOptions, createAgentConfigSchema, } from './schemas.js';
+export { AgentCardSchema, SecuritySchemeSchema, type AgentCard, type ValidatedAgentCard, } from './schemas.js';
 export { createAgentCard } from './agentCard.js';
 export * from './errors.js';
 export * from './error-codes.js';
+export type { DextoAgentOptions } from './agent-options.js';
+export type { AgentRuntimeSettings, DextoAgentConfigInput } from './runtime-config.js';
 export type { ContentInput, GenerateOptions, GenerateResponse, StreamOptions, AgentToolCall, } from './types.js';
 export type { StreamingEvent, StreamingEventName, STREAMING_EVENTS } from '../events/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACH,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,kBAAkB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,uBAAuB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAGjC,YAAY,EACR,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,GAChB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACH,eAAe,EACf,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,kBAAkB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGvF,YAAY,EACR,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,GAChB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/agent/index.js

@@ -1,21 +1,15 @@
 import "../chunk-PTJYTZNU.js";
 import { DextoAgent } from "./DextoAgent.js";
 import {
-  AgentConfigSchema,
   AgentCardSchema,
   SecuritySchemeSchema
 } from "./schemas.js";
-import {
-  createAgentConfigSchema
-} from "./schemas.js";
 import { createAgentCard } from "./agentCard.js";
 export * from "./errors.js";
 export * from "./error-codes.js";
 export {
   AgentCardSchema,
-  AgentConfigSchema,
   DextoAgent,
   SecuritySchemeSchema,
-  createAgentCard,
-  createAgentConfigSchema
+  createAgentCard
 };

package/dist/{storage/blob/provider.cjs → agent/runtime-config.cjs}

@@ -12,5 +12,5 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var provider_exports = {};
-module.exports = __toCommonJS(provider_exports);
+var runtime_config_exports = {};
+module.exports = __toCommonJS(runtime_config_exports);

package/dist/agent/runtime-config.d.ts

@@ -0,0 +1,53 @@
+import type { LLMConfig, ValidatedLLMConfig } from '../llm/schemas.js';
+import type { ServersConfig, ValidatedServersConfig } from '../mcp/schemas.js';
+import type { MemoriesConfig, ValidatedMemoriesConfig } from '../memory/schemas.js';
+import type { ResourcesConfig, ValidatedResourcesConfig } from '../resources/schemas.js';
+import type { SessionConfig, ValidatedSessionConfig } from '../session/schemas.js';
+import type { SystemPromptConfig, ValidatedSystemPromptConfig } from '../systemPrompt/schemas.js';
+import type { ElicitationConfig, PermissionsConfig, ValidatedPermissionsConfig, ValidatedElicitationConfig } from '../tools/schemas.js';
+import type { PromptsConfig, ValidatedPromptsConfig } from '../prompts/schemas.js';
+import type { OtelConfiguration } from '../telemetry/schemas.js';
+import type { AgentCard, ValidatedAgentCard } from './schemas.js';
+/**
+ * Core runtime settings shape (validated + defaulted).
+ *
+ * DextoAgent is the validation boundary: host layers may validate earlier (e.g. YAML parsing),
+ * but core always normalizes runtime settings before use.
+ */
+export interface AgentRuntimeSettings {
+    systemPrompt: ValidatedSystemPromptConfig;
+    llm: ValidatedLLMConfig;
+    agentCard?: ValidatedAgentCard | undefined;
+    greeting?: string | undefined;
+    telemetry?: OtelConfiguration | undefined;
+    memories?: ValidatedMemoriesConfig | undefined;
+    agentId: string;
+    mcpServers: ValidatedServersConfig;
+    sessions: ValidatedSessionConfig;
+    permissions: ValidatedPermissionsConfig;
+    elicitation: ValidatedElicitationConfig;
+    resources: ValidatedResourcesConfig;
+    prompts: ValidatedPromptsConfig;
+}
+/**
+ * Runtime settings input shape (unvalidated / may omit defaulted sections).
+ *
+ * This is the ergonomic surface for programmatic construction.
+ * DextoAgent will validate + default these values internally.
+ */
+export interface DextoAgentConfigInput {
+    systemPrompt: SystemPromptConfig;
+    llm: LLMConfig;
+    agentCard?: AgentCard | undefined;
+    greeting?: string | undefined;
+    telemetry?: OtelConfiguration | undefined;
+    memories?: MemoriesConfig | undefined;
+    agentId: string;
+    mcpServers?: ServersConfig | undefined;
+    sessions?: SessionConfig | undefined;
+    permissions?: PermissionsConfig | undefined;
+    elicitation?: ElicitationConfig | undefined;
+    resources?: ResourcesConfig | undefined;
+    prompts?: PromptsConfig | undefined;
+}
+//# sourceMappingURL=runtime-config.d.ts.map

package/dist/agent/runtime-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config.d.ts","sourceRoot":"","sources":["../../src/agent/runtime-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAClG,OAAO,KAAK,EACR,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,0BAA0B,EAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACjC,YAAY,EAAE,2BAA2B,CAAC;IAC1C,GAAG,EAAE,kBAAkB,CAAC;IAExB,SAAS,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAE/C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,sBAAsB,CAAC;IACnC,QAAQ,EAAE,sBAAsB,CAAC;IAEjC,WAAW,EAAE,0BAA0B,CAAC;IACxC,WAAW,EAAE,0BAA0B,CAAC;IAExC,SAAS,EAAE,wBAAwB,CAAC;IACpC,OAAO,EAAE,sBAAsB,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IAClC,YAAY,EAAE,kBAAkB,CAAC;IACjC,GAAG,EAAE,SAAS,CAAC;IAEf,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAEtC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAErC,WAAW,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAE5C,SAAS,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACxC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CACvC"}

package/dist/agent/schemas.cjs

@@ -19,26 +19,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var schemas_exports = {};
 __export(schemas_exports, {
   AgentCardSchema: () => AgentCardSchema,
-  AgentConfigSchema: () => AgentConfigSchema,
-  AgentConfigSchemaRelaxed: () => AgentConfigSchemaRelaxed,
-  SecuritySchemeSchema: () => SecuritySchemeSchema,
-  createAgentConfigSchema: () => createAgentConfigSchema
+  SecuritySchemeSchema: () => SecuritySchemeSchema
 });
 module.exports = __toCommonJS(schemas_exports);
-var import_schemas = require("../llm/schemas.cjs");
-var import_logger = require("../logger/index.cjs");
-var import_schemas2 = require("../mcp/schemas.cjs");
-var import_schemas3 = require("../memory/schemas.cjs");
-var import_schemas4 = require("../session/schemas.cjs");
-var import_schemas5 = require("../storage/schemas.cjs");
-var import_schemas6 = require("../systemPrompt/schemas.cjs");
-var import_schemas7 = require("../context/compaction/schemas.cjs");
-var import_schemas8 = require("../tools/schemas.cjs");
 var import_zod = require("zod");
-var import_schemas9 = require("../resources/schemas.cjs");
-var import_schemas10 = require("../prompts/schemas.cjs");
-var import_schemas11 = require("../plugins/schemas.cjs");
-var import_schemas12 = require("../telemetry/schemas.cjs");
 const ApiKeySecurityScheme = import_zod.z.object({
   type: import_zod.z.literal("apiKey").describe("Security scheme type"),
   name: import_zod.z.string().describe("Name of the header/query/cookie parameter"),
@@ -170,94 +154,8 @@ const AgentCardSchema = import_zod.z.object({
     dexto: DextoMetadataSchema.optional().describe("Dexto-specific extension metadata")
   }).passthrough().optional().describe("Extension-specific metadata (namespaced by extension name)")
 }).strict();
-function createAgentConfigSchema(options = {}) {
-  const llmSchema = (0, import_schemas.createLLMConfigSchema)(options);
-  return import_zod.z.object({
-    // ========================================
-    // REQUIRED FIELDS (user must provide or schema validation fails)
-    // ========================================
-    systemPrompt: import_schemas6.SystemPromptConfigSchema.describe(
-      "System prompt: string shorthand or structured config"
-    ),
-    llm: llmSchema.describe("Core LLM configuration for the agent"),
-    // ========================================
-    // OPTIONAL FEATURES (undefined if not provided)
-    // ========================================
-    agentCard: AgentCardSchema.describe("Configuration for the agent card").optional(),
-    greeting: import_zod.z.string().max(500).describe("Default greeting text to show when a chat starts (for UI consumption)").optional(),
-    telemetry: import_schemas12.OtelConfigurationSchema.describe(
-      "OpenTelemetry configuration for distributed tracing and observability"
-    ).optional(),
-    memories: import_schemas3.MemoriesConfigSchema.describe(
-      "Memory configuration for system prompt inclusion (optional feature)"
-    ).optional(),
-    agentFile: import_zod.z.object({
-      discoverInCwd: import_zod.z.boolean().default(true).describe(
-        "Whether to discover AGENTS.md/CLAUDE.md/GEMINI.md in the current working directory and include it in the system prompt"
-      )
-    }).strict().default({}).describe("Agent instruction file discovery configuration"),
-    image: import_zod.z.string().describe(
-      'Image package that provides required providers (e.g., "@dexto/image-local"). Optional - platform can load images via CLI flag, environment variable, or static imports.'
-    ).optional(),
-    // ========================================
-    // FIELDS WITH DEFAULTS (always present after parsing)
-    // ========================================
-    agentId: import_zod.z.string().describe(
-      "Unique identifier for this agent instance - CLI enrichment derives from agentCard.name or filename"
-    ).default("coding-agent"),
-    mcpServers: import_schemas2.ServerConfigsSchema.describe(
-      "Configurations for MCP (Model Context Protocol) servers used by the agent"
-    ).default({}),
-    internalTools: import_schemas8.InternalToolsSchema.describe(
-      "Internal tools configuration (read-file, write-file, bash-exec, etc.)"
-    ).default([]),
-    customTools: import_schemas8.CustomToolsSchema.describe(
-      "Custom tool provider configurations. Providers must be registered via customToolRegistry before loading agent config."
-    ).default([]),
-    tools: import_schemas8.ToolsConfigSchema.describe(
-      "Configuration for individual tools (limits, etc.)"
-    ).default({}),
-    logger: import_logger.LoggerConfigSchema.describe(
-      "Logger configuration with multi-transport support (file, console, remote) - CLI enrichment adds per-agent file transport"
-    ).default({
-      level: "error",
-      transports: [{ type: "console", colorize: true }]
-    }),
-    storage: import_schemas5.StorageSchema.describe(
-      "Storage configuration for cache, database, and blob storage - defaults to in-memory, CLI enrichment provides filesystem paths"
-    ).default({
-      cache: { type: "in-memory" },
-      database: { type: "in-memory" },
-      blob: { type: "in-memory" }
-    }),
-    sessions: import_schemas4.SessionConfigSchema.describe("Session management configuration").default({}),
-    toolConfirmation: import_schemas8.ToolConfirmationConfigSchema.describe(
-      "Tool confirmation and approval configuration"
-    ).default({}),
-    elicitation: import_schemas8.ElicitationConfigSchema.default({}).describe(
-      "Elicitation configuration for user input requests (ask_user tool and MCP server elicitations). Independent from toolConfirmation mode."
-    ),
-    internalResources: import_schemas9.InternalResourcesSchema.describe(
-      "Configuration for internal resources (filesystem, etc.)"
-    ).default([]),
-    prompts: import_schemas10.PromptsSchema.describe(
-      "Agent prompts configuration - sample prompts which can be defined inline or referenced from file"
-    ).default([]),
-    plugins: import_schemas11.PluginsConfigSchema.describe(
-      "Plugin system configuration for built-in and custom plugins"
-    ).default({}),
-    compaction: import_schemas7.CompactionConfigSchema.describe(
-      "Context compaction configuration - custom providers can be registered via compactionRegistry"
-    ).default(import_schemas7.DEFAULT_COMPACTION_CONFIG)
-  }).strict().describe("Main configuration for an agent, including its LLM and server connections").brand();
-}
-const AgentConfigSchema = createAgentConfigSchema({ strict: true });
-const AgentConfigSchemaRelaxed = createAgentConfigSchema({ strict: false });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentCardSchema,
-  AgentConfigSchema,
-  AgentConfigSchemaRelaxed,
-  SecuritySchemeSchema,
-  createAgentConfigSchema
+  SecuritySchemeSchema
 });