@dexto/core 1.4.0 → 1.5.1

package/README.md

@@ -78,6 +78,42 @@ See the [Dexto Agent SDK docs](https://docs.dexto.ai/docs/guides/dexto-sdk) for
 
 ---
 
+### Starting a Server
+
+Start a Dexto server programmatically to expose REST and SSE streaming APIs to interact and manage your agent backend.
+
+```typescript
+import { DextoAgent } from '@dexto/core';
+import { startHonoApiServer } from 'dexto';
+
+// Create and configure agent
+const agent = new DextoAgent({
+  llm: {
+    provider: 'openai',
+    model: 'gpt-5-mini',
+    apiKey: process.env.OPENAI_API_KEY
+  },
+  mcpServers: {
+    filesystem: {
+      type: 'stdio',
+      command: 'npx',
+      args: ['-y', '@modelcontextprotocol/server-filesystem', '.']
+    }
+  }
+});
+
+// Start server on port 3001
+const { server } = await startHonoApiServer(agent, 3001);
+
+console.log('Dexto server running at http://localhost:3001');
+// Server provides REST API and SSE streaming endpoints
+// POST /api/message - Send messages
+// GET /api/sessions - List sessions
+// See docs.dexto.ai/api/rest/ for all endpoints
+```
+
+This starts an HTTP server with full REST and SSE APIs, enabling integration with web frontends, webhooks, and other services. See the [REST API Documentation](https://docs.dexto.ai/api/rest/) for available endpoints.
+
 ### Session Management
 
 Create and manage multiple conversation sessions with persistent storage.

package/dist/agent/DextoAgent.cjs

@@ -121,10 +121,14 @@ class DextoAgent {
    *
    * @param config - Agent configuration (validated and enriched)
    * @param configPath - Optional path to config file (for relative path resolution)
+   * @param options - Validation options
+   * @param options.strict - When true (default), enforces API key and baseURL requirements.
+   *                         When false, allows missing credentials for interactive configuration.
    */
-  constructor(config, configPath) {
+  constructor(config, configPath, options) {
     this.configPath = configPath;
-    this.config = import_schemas2.AgentConfigSchema.parse(config);
+    const schema = options?.strict === false ? (0, import_schemas2.createAgentConfigSchema)({ strict: false }) : import_schemas2.AgentConfigSchema;
+    this.config = schema.parse(config);
     this.logger = (0, import_factory.createLogger)({
       config: this.config.logger,
       agentId: this.config.agentId,
@@ -222,6 +226,8 @@ Either:
         memoryManager: services.memoryManager,
         services
       });
+      services.toolManager.setAgent(this);
+      await services.toolManager.initialize();
       this.searchService = services.searchService;
       const promptManager = new import_prompts.PromptManager(
         this.mcpManager,
@@ -1219,7 +1225,11 @@ Either:
     }
     const validatedUpdates = parseResult.data;
     const currentLLMConfig = sessionId ? this.stateManager.getRuntimeConfig(sessionId).llm : this.stateManager.getRuntimeConfig().llm;
-    const result = (0, import_resolver.resolveAndValidateLLMConfig)(currentLLMConfig, validatedUpdates, this.logger);
+    const result = await (0, import_resolver.resolveAndValidateLLMConfig)(
+      currentLLMConfig,
+      validatedUpdates,
+      this.logger
+    );
     const validatedConfig = (0, import_result_bridge.ensureOk)(result, this.logger);
     await this.performLLMSwitch(validatedConfig, sessionId);
     this.logger.info(
@@ -1531,6 +1541,15 @@ Either:
     this.ensureStarted();
     return await this.mcpManager.getAllTools();
   }
+  /**
+   * Gets all MCP tools with their server metadata.
+   * Returns tool cache entries which include server names for proper grouping.
+   * @returns Map of tool names to cache entries with server info
+   */
+  getAllMcpToolsWithServerInfo() {
+    this.ensureStarted();
+    return this.mcpManager.getAllToolsWithServerInfo();
+  }
   /**
    * Gets all available tools from all sources (MCP servers and custom tools).
    * This is the unified interface for tool discovery that includes both MCP and custom tools.

package/dist/agent/DextoAgent.d.ts

@@ -14,7 +14,7 @@ import { ValidatedLLMConfig, LLMUpdates } from '../llm/schemas.js';
 import type { McpServerConfig, McpServerStatus } from '../mcp/schemas.js';
 import { ModelInfo } from '../llm/registry.js';
 import type { LLMProvider } from '../llm/types.js';
-import type { AgentConfig, ValidatedAgentConfig } from './schemas.js';
+import type { AgentConfig, ValidatedAgentConfig, LLMValidationOptions } from './schemas.js';
 import { AgentEventBus, type StreamingEvent } from '../events/index.js';
 import type { IMCPClient } from '../mcp/types.js';
 import type { ToolSet } from '../tools/types.js';
@@ -108,8 +108,11 @@ export declare class DextoAgent {
      *
      * @param config - Agent configuration (validated and enriched)
      * @param configPath - Optional path to config file (for relative path resolution)
+     * @param options - Validation options
+     * @param options.strict - When true (default), enforces API key and baseURL requirements.
+     *                         When false, allows missing credentials for interactive configuration.
      */
-    constructor(config: AgentConfig, configPath?: string | undefined);
+    constructor(config: AgentConfig, configPath?: string | undefined, options?: LLMValidationOptions);
     /**
      * Starts the agent by initializing all async services.
      * This method handles storage backends, MCP connections, session manager initialization, and other async operations.
@@ -561,6 +564,20 @@ export declare class DextoAgent {
      * @returns Promise resolving to a map of tool names to tool definitions
      */
     getAllMcpTools(): Promise<ToolSet>;
+    /**
+     * Gets all MCP tools with their server metadata.
+     * Returns tool cache entries which include server names for proper grouping.
+     * @returns Map of tool names to cache entries with server info
+     */
+    getAllMcpToolsWithServerInfo(): Map<string, {
+        serverName: string;
+        client: IMCPClient;
+        definition: {
+            name?: string;
+            description?: string;
+            parameters: import("json-schema").JSONSchema7;
+        };
+    }>;
     /**
      * Gets all available tools from all sources (MCP servers and custom tools).
      * This is the unified interface for tool discovery that includes both MCP and custom tools.

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

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

package/dist/agent/DextoAgent.js

@@ -32,7 +32,7 @@ import {
   LLM_REGISTRY
 } from "../llm/registry.js";
 import { createAgentServices } from "../utils/service-initializer.js";
-import { AgentConfigSchema } from "./schemas.js";
+import { AgentConfigSchema, createAgentConfigSchema } from "./schemas.js";
 import {
   AgentEventBus
 } from "../events/index.js";
@@ -65,10 +65,14 @@ class DextoAgent {
    *
    * @param config - Agent configuration (validated and enriched)
    * @param configPath - Optional path to config file (for relative path resolution)
+   * @param options - Validation options
+   * @param options.strict - When true (default), enforces API key and baseURL requirements.
+   *                         When false, allows missing credentials for interactive configuration.
    */
-  constructor(config, configPath) {
+  constructor(config, configPath, options) {
     this.configPath = configPath;
-    this.config = AgentConfigSchema.parse(config);
+    const schema = options?.strict === false ? createAgentConfigSchema({ strict: false }) : AgentConfigSchema;
+    this.config = schema.parse(config);
     this.logger = createLogger({
       config: this.config.logger,
       agentId: this.config.agentId,
@@ -166,6 +170,8 @@ Either:
         memoryManager: services.memoryManager,
         services
       });
+      services.toolManager.setAgent(this);
+      await services.toolManager.initialize();
       this.searchService = services.searchService;
       const promptManager = new PromptManager(
         this.mcpManager,
@@ -1163,7 +1169,11 @@ Either:
     }
     const validatedUpdates = parseResult.data;
     const currentLLMConfig = sessionId ? this.stateManager.getRuntimeConfig(sessionId).llm : this.stateManager.getRuntimeConfig().llm;
-    const result = resolveAndValidateLLMConfig(currentLLMConfig, validatedUpdates, this.logger);
+    const result = await resolveAndValidateLLMConfig(
+      currentLLMConfig,
+      validatedUpdates,
+      this.logger
+    );
     const validatedConfig = ensureOk(result, this.logger);
     await this.performLLMSwitch(validatedConfig, sessionId);
     this.logger.info(
@@ -1475,6 +1485,15 @@ Either:
     this.ensureStarted();
     return await this.mcpManager.getAllTools();
   }
+  /**
+   * Gets all MCP tools with their server metadata.
+   * Returns tool cache entries which include server names for proper grouping.
+   * @returns Map of tool names to cache entries with server info
+   */
+  getAllMcpToolsWithServerInfo() {
+    this.ensureStarted();
+    return this.mcpManager.getAllToolsWithServerInfo();
+  }
   /**
    * Gets all available tools from all sources (MCP servers and custom tools).
    * This is the unified interface for tool discovery that includes both MCP and custom tools.

package/dist/agent/index.cjs

@@ -23,11 +23,13 @@ __export(agent_exports, {
   AgentConfigSchema: () => import_schemas.AgentConfigSchema,
   DextoAgent: () => import_DextoAgent.DextoAgent,
   SecuritySchemeSchema: () => import_schemas.SecuritySchemeSchema,
-  createAgentCard: () => import_agentCard.createAgentCard
+  createAgentCard: () => import_agentCard.createAgentCard,
+  createAgentConfigSchema: () => import_schemas2.createAgentConfigSchema
 });
 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);
@@ -38,6 +40,7 @@ __reExport(agent_exports, require("./error-codes.js"), module.exports);
   DextoAgent,
   SecuritySchemeSchema,
   createAgentCard,
+  createAgentConfigSchema,
   ...require("./errors.js"),
   ...require("./error-codes.js")
 });

package/dist/agent/index.d.ts

@@ -1,6 +1,6 @@
 export { DextoAgent } from './DextoAgent.js';
 export { AgentConfigSchema, AgentCardSchema, SecuritySchemeSchema, type AgentCard, type ValidatedAgentCard, } from './schemas.js';
-export { type ValidatedAgentConfig, type AgentConfig } from './schemas.js';
+export { type ValidatedAgentConfig, type AgentConfig, type LLMValidationOptions, createAgentConfigSchema, } from './schemas.js';
 export { createAgentCard } from './agentCard.js';
 export * from './errors.js';
 export * from './error-codes.js';

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,EAAE,KAAK,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3E,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,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"}

package/dist/agent/index.js

@@ -5,6 +5,9 @@ import {
   AgentCardSchema,
   SecuritySchemeSchema
 } from "./schemas.js";
+import {
+  createAgentConfigSchema
+} from "./schemas.js";
 import { createAgentCard } from "./agentCard.js";
 export * from "./errors.js";
 export * from "./error-codes.js";
@@ -13,5 +16,6 @@ export {
   AgentConfigSchema,
   DextoAgent,
   SecuritySchemeSchema,
-  createAgentCard
+  createAgentCard,
+  createAgentConfigSchema
 };

package/dist/agent/schemas.cjs

@@ -20,7 +20,9 @@ var schemas_exports = {};
 __export(schemas_exports, {
   AgentCardSchema: () => AgentCardSchema,
   AgentConfigSchema: () => AgentConfigSchema,
-  SecuritySchemeSchema: () => SecuritySchemeSchema
+  AgentConfigSchemaRelaxed: () => AgentConfigSchemaRelaxed,
+  SecuritySchemeSchema: () => SecuritySchemeSchema,
+  createAgentConfigSchema: () => createAgentConfigSchema
 });
 module.exports = __toCommonJS(schemas_exports);
 var import_schemas = require("../llm/schemas.cjs");
@@ -30,12 +32,13 @@ 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("../tools/schemas.cjs");
+var import_schemas7 = require("../context/compaction/schemas.cjs");
+var import_schemas8 = require("../tools/schemas.cjs");
 var import_zod = require("zod");
-var import_schemas8 = require("../resources/schemas.cjs");
-var import_schemas9 = require("../prompts/schemas.cjs");
-var import_schemas10 = require("../plugins/schemas.cjs");
-var import_schemas11 = require("../telemetry/schemas.cjs");
+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"),
@@ -167,73 +170,89 @@ 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();
-const AgentConfigSchema = 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: import_schemas.LLMConfigSchema.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_schemas11.OtelConfigurationSchema.describe(
-    "OpenTelemetry configuration for distributed tracing and observability"
-  ).optional(),
-  memories: import_schemas3.MemoriesConfigSchema.describe(
-    "Memory configuration for system prompt inclusion (optional feature)"
-  ).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("default-agent"),
-  mcpServers: import_schemas2.ServerConfigsSchema.describe(
-    "Configurations for MCP (Model Context Protocol) servers used by the agent"
-  ).default({}),
-  internalTools: import_schemas7.InternalToolsSchema.describe(
-    "Internal tools configuration (read-file, write-file, bash-exec, etc.)"
-  ).default([]),
-  tools: import_schemas7.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_schemas7.ToolConfirmationConfigSchema.describe(
-    "Tool confirmation and approval configuration"
-  ).default({}),
-  elicitation: import_schemas7.ElicitationConfigSchema.default({}).describe(
-    "Elicitation configuration for user input requests (ask_user tool and MCP server elicitations). Independent from toolConfirmation mode."
-  ),
-  internalResources: import_schemas8.InternalResourcesSchema.describe(
-    "Configuration for internal resources (filesystem, etc.)"
-  ).default([]),
-  prompts: import_schemas9.PromptsSchema.describe(
-    "Agent prompts configuration - sample prompts which can be defined inline or referenced from file"
-  ).default([]),
-  plugins: import_schemas10.PluginsConfigSchema.describe(
-    "Plugin system configuration for built-in and custom plugins"
-  ).default({})
-}).strict().describe("Main configuration for an agent, including its LLM and server connections").brand();
+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(),
+    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,
-  SecuritySchemeSchema
+  AgentConfigSchemaRelaxed,
+  SecuritySchemeSchema,
+  createAgentConfigSchema
 });