@dexto/core 1.1.4 → 1.1.6

package/dist/agent/schemas.js

@@ -0,0 +1,88 @@
+import { LLMConfigSchema } from "../llm/schemas.js";
+import { ServerConfigsSchema as McpServersConfigSchema } from "../mcp/schemas.js";
+import { SessionConfigSchema } from "../session/schemas.js";
+import { StorageSchema } from "../storage/schemas.js";
+import { SystemPromptConfigSchema } from "../systemPrompt/schemas.js";
+import { InternalToolsSchema, ToolConfirmationConfigSchema } from "../tools/schemas.js";
+import { z } from "zod";
+const AgentCardSchema = z.object({
+  name: z.string(),
+  // No default, must be provided by context
+  description: z.string().default(
+    "Dexto is an AI assistant capable of chat and task delegation, accessible via multiple protocols."
+  ),
+  url: z.string().url(),
+  // No default, must be provided by context
+  provider: z.object({
+    organization: z.string(),
+    url: z.string().url()
+  }).optional(),
+  // Remains optional, undefined if not provided
+  version: z.string(),
+  // No default, must be provided by context
+  documentationUrl: z.string().url().optional(),
+  // Remains optional, undefined if not provided
+  capabilities: z.object({
+    streaming: z.boolean().optional().default(true),
+    pushNotifications: z.boolean().optional(),
+    // Default is context-dependent (webSubscriber)
+    stateTransitionHistory: z.boolean().optional().default(false)
+  }).strict().default({}),
+  // Add default for the capabilities object itself
+  authentication: z.object({
+    schemes: z.array(z.string()).default([]),
+    credentials: z.string().optional()
+    // Remains optional
+  }).strict().default({}),
+  // Add default for the authentication object itself
+  defaultInputModes: z.array(z.string()).default(["application/json", "text/plain"]),
+  defaultOutputModes: z.array(z.string()).default(["application/json", "text/event-stream", "text/plain"]),
+  skills: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+      description: z.string(),
+      tags: z.array(z.string()),
+      examples: z.array(z.string()).optional(),
+      inputModes: z.array(z.string()).optional().default(["text/plain"]),
+      outputModes: z.array(z.string()).optional().default(["text/plain"])
+    })
+  ).default([
+    {
+      id: "chat_with_agent",
+      name: "chat_with_agent",
+      description: "Allows you to chat with an AI agent. Send a message to interact.",
+      tags: ["chat", "AI", "assistant", "mcp", "natural language"],
+      examples: [
+        `Send a JSON-RPC request to /mcp with method: "chat_with_agent" and params: {"message":"Your query..."}`,
+        "Alternatively, use a compatible MCP client library."
+      ]
+      // inputModes and outputModes will use their own defaults if not specified here
+    }
+  ])
+}).strict();
+const AgentConfigSchema = z.object({
+  agentCard: AgentCardSchema.describe("Configuration for the agent card").optional(),
+  greeting: z.string().max(500).optional().describe("Default greeting text to show when a chat starts (for UI consumption)"),
+  systemPrompt: SystemPromptConfigSchema.describe(
+    "System prompt: string shorthand or structured config"
+  ),
+  mcpServers: McpServersConfigSchema.default({}).describe(
+    "Configurations for MCP (Model Context Protocol) servers used by the agent"
+  ),
+  internalTools: InternalToolsSchema,
+  llm: LLMConfigSchema.describe("Core LLM configuration for the agent"),
+  // Storage configuration
+  storage: StorageSchema.default({
+    cache: { type: "in-memory" },
+    database: { type: "in-memory" }
+  }).describe("Storage configuration for the agent using cache and database backends"),
+  sessions: SessionConfigSchema.default({}).describe("Session management configuration"),
+  toolConfirmation: ToolConfirmationConfigSchema.default({}).describe(
+    "Tool confirmation and approval configuration"
+  )
+}).strict().describe("Main configuration for an agent, including its LLM and server connections").brand();
+export {
+  AgentCardSchema,
+  AgentConfigSchema
+};

package/dist/agent/state-manager.cjs

@@ -0,0 +1,214 @@
+"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 state_manager_exports = {};
+__export(state_manager_exports, {
+  AgentStateManager: () => AgentStateManager
+});
+module.exports = __toCommonJS(state_manager_exports);
+var import_logger = require("../logger/index.js");
+class AgentStateManager {
+  /**
+   * Initialize AgentStateManager from a validated static configuration.
+   *
+   * @param staticConfig The validated configuration from DextoAgent
+   * @param agentEventBus The agent event bus for emitting state change events
+   */
+  constructor(staticConfig, agentEventBus) {
+    this.agentEventBus = agentEventBus;
+    this.baselineConfig = structuredClone(staticConfig);
+    this.runtimeConfig = structuredClone(staticConfig);
+    import_logger.logger.debug("AgentStateManager initialized", {
+      staticConfigKeys: Object.keys(this.baselineConfig),
+      mcpServerCount: Object.keys(this.runtimeConfig.mcpServers).length
+    });
+  }
+  runtimeConfig;
+  baselineConfig;
+  sessionOverrides = /* @__PURE__ */ new Map();
+  // ============= GETTERS =============
+  /**
+   * Get runtime configuration for a session (includes session overrides if sessionId provided)
+   */
+  getRuntimeConfig(sessionId) {
+    if (!sessionId) {
+      return structuredClone(this.runtimeConfig);
+    }
+    const override = this.sessionOverrides.get(sessionId);
+    if (!override) {
+      return structuredClone(this.runtimeConfig);
+    }
+    return {
+      ...this.runtimeConfig,
+      llm: { ...this.runtimeConfig.llm, ...override.llm }
+    };
+  }
+  // ============= LLM CONFIGURATION =============
+  /**
+   * Update the LLM configuration (globally or for a specific session)
+   *
+   * This method is a pure state updater - it assumes the input has already been validated
+   * by the caller (typically DextoAgent.switchLLM). The ValidatedLLMConfig branded type
+   * ensures validation has occurred.
+   */
+  updateLLM(validatedConfig, sessionId) {
+    const oldValue = sessionId ? this.getRuntimeConfig(sessionId).llm : this.runtimeConfig.llm;
+    if (sessionId) {
+      this.setSessionOverride(sessionId, {
+        llm: validatedConfig
+      });
+    } else {
+      this.runtimeConfig.llm = validatedConfig;
+    }
+    this.agentEventBus.emit("dexto:stateChanged", {
+      field: "llm",
+      oldValue,
+      newValue: validatedConfig,
+      ...sessionId && { sessionId }
+    });
+    import_logger.logger.info("LLM config updated", {
+      sessionId,
+      provider: validatedConfig.provider,
+      model: validatedConfig.model,
+      isSessionSpecific: !!sessionId
+    });
+  }
+  // ============= MCP SERVER MANAGEMENT =============
+  /**
+   * Add or update an MCP server configuration at runtime.
+   *
+   * This method is a pure state updater - it assumes the input has already been validated
+   * by the caller (typically DextoAgent.connectMcpServer). The ValidatedMcpServerConfig
+   * branded type ensures validation has occurred.
+   */
+  addMcpServer(serverName, validatedConfig) {
+    import_logger.logger.debug(`Adding/updating MCP server: ${serverName}`);
+    const isUpdate = serverName in this.runtimeConfig.mcpServers;
+    this.runtimeConfig.mcpServers[serverName] = validatedConfig;
+    const eventName = isUpdate ? "dexto:mcpServerUpdated" : "dexto:mcpServerAdded";
+    this.agentEventBus.emit(eventName, { serverName, config: validatedConfig });
+    this.agentEventBus.emit("dexto:stateChanged", {
+      field: "mcpServers",
+      oldValue: isUpdate ? "updated" : "added",
+      newValue: validatedConfig
+      // sessionId omitted - MCP servers are global
+    });
+    import_logger.logger.info(`MCP server '${serverName}' ${isUpdate ? "updated" : "added"} successfully`);
+  }
+  /**
+   * Remove an MCP server configuration at runtime.
+   */
+  removeMcpServer(serverName) {
+    import_logger.logger.debug(`Removing MCP server: ${serverName}`);
+    if (serverName in this.runtimeConfig.mcpServers) {
+      delete this.runtimeConfig.mcpServers[serverName];
+      this.agentEventBus.emit("dexto:mcpServerRemoved", { serverName });
+      this.agentEventBus.emit("dexto:stateChanged", {
+        field: "mcpServers",
+        oldValue: "removed",
+        newValue: void 0
+        // sessionId omitted - MCP servers are global
+      });
+      import_logger.logger.info(`MCP server '${serverName}' removed successfully`);
+    } else {
+      import_logger.logger.warn(`MCP server '${serverName}' not found for removal`);
+    }
+  }
+  // ============= SESSION MANAGEMENT =============
+  /**
+   * Set a session-specific override
+   */
+  setSessionOverride(sessionId, override) {
+    this.sessionOverrides.set(sessionId, override);
+    this.agentEventBus.emit("dexto:sessionOverrideSet", {
+      sessionId,
+      override: structuredClone(override)
+    });
+  }
+  /**
+   * Get a session override (internal helper)
+   */
+  getSessionOverride(sessionId) {
+    return this.sessionOverrides.get(sessionId);
+  }
+  /**
+   * Clear session-specific overrides
+   */
+  clearSessionOverride(sessionId) {
+    const hadOverride = this.sessionOverrides.has(sessionId);
+    this.sessionOverrides.delete(sessionId);
+    if (hadOverride) {
+      this.agentEventBus.emit("dexto:sessionOverrideCleared", { sessionId });
+      import_logger.logger.info("Session override cleared", { sessionId });
+    }
+  }
+  /**
+   * Clear all session overrides (private helper for resetToBaseline)
+   */
+  clearAllSessionOverrides() {
+    const sessionIds = Array.from(this.sessionOverrides.keys());
+    this.sessionOverrides.clear();
+    sessionIds.forEach((sessionId) => {
+      this.agentEventBus.emit("dexto:sessionOverrideCleared", { sessionId });
+    });
+    if (sessionIds.length > 0) {
+      import_logger.logger.info("All session overrides cleared", { clearedSessions: sessionIds });
+    }
+  }
+  // ============= CONFIG EXPORT =============
+  /**
+   * Export current runtime state as config.
+   * This allows users to save their runtime modifications as a new agent config.
+   */
+  exportAsConfig() {
+    const exportedConfig = {
+      ...this.baselineConfig,
+      llm: structuredClone(this.runtimeConfig.llm),
+      systemPrompt: this.runtimeConfig.systemPrompt,
+      mcpServers: structuredClone(this.runtimeConfig.mcpServers)
+    };
+    this.agentEventBus.emit("dexto:stateExported", {
+      config: exportedConfig
+    });
+    import_logger.logger.info("Runtime state exported as config", {
+      exportedConfig
+    });
+    return exportedConfig;
+  }
+  /**
+   * Reset runtime state back to baseline configuration
+   */
+  resetToBaseline() {
+    this.runtimeConfig = structuredClone(this.baselineConfig);
+    this.clearAllSessionOverrides();
+    this.agentEventBus.emit("dexto:stateReset", { toConfig: this.baselineConfig });
+    import_logger.logger.info("Runtime state reset to baseline config");
+  }
+  // ============= CONVENIENCE GETTERS FOR USED FUNCTIONALITY =============
+  /**
+   * Get the current effective LLM configuration for a session.
+   * **Use this for session-specific LLM config** (includes session overrides).
+   */
+  getLLMConfig(sessionId) {
+    return this.getRuntimeConfig(sessionId).llm;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentStateManager
+});

package/dist/agent/state-manager.d.cts

@@ -0,0 +1,97 @@
+import { ValidatedAgentConfig } from './schemas.cjs';
+import { ValidatedLLMConfig } from '../llm/schemas.cjs';
+import { ValidatedMcpServerConfig } from '../mcp/schemas.cjs';
+import { AgentEventBus } from '../events/index.cjs';
+import 'zod';
+import '../llm/types.cjs';
+import 'events';
+
+/**
+ * Session-specific overrides that can differ from the global configuration
+ */
+interface SessionOverride {
+    /** Override LLM config for this session - must be a complete validated config */
+    llm?: ValidatedLLMConfig;
+}
+/**
+ * Manages the runtime configuration of the agent.
+ *
+ * This class handles dynamic configuration changes that occur during agent execution.
+ *
+ * Key responsibilities:
+ * 1. Track runtime changes separate from static config baseline
+ * 2. Support session-specific overrides for LLM settings
+ * 3. Dynamic MCP server management (add/remove servers at runtime)
+ * 4. Export modified state back to config format
+ * 5. Provide change tracking and validation capabilities
+ * 6. Maintain effective configuration for each session
+ */
+declare class AgentStateManager {
+    private agentEventBus;
+    private runtimeConfig;
+    private readonly baselineConfig;
+    private sessionOverrides;
+    /**
+     * Initialize AgentStateManager from a validated static configuration.
+     *
+     * @param staticConfig The validated configuration from DextoAgent
+     * @param agentEventBus The agent event bus for emitting state change events
+     */
+    constructor(staticConfig: ValidatedAgentConfig, agentEventBus: AgentEventBus);
+    /**
+     * Get runtime configuration for a session (includes session overrides if sessionId provided)
+     */
+    getRuntimeConfig(sessionId?: string): Readonly<ValidatedAgentConfig>;
+    /**
+     * Update the LLM configuration (globally or for a specific session)
+     *
+     * This method is a pure state updater - it assumes the input has already been validated
+     * by the caller (typically DextoAgent.switchLLM). The ValidatedLLMConfig branded type
+     * ensures validation has occurred.
+     */
+    updateLLM(validatedConfig: ValidatedLLMConfig, sessionId?: string): void;
+    /**
+     * Add or update an MCP server configuration at runtime.
+     *
+     * This method is a pure state updater - it assumes the input has already been validated
+     * by the caller (typically DextoAgent.connectMcpServer). The ValidatedMcpServerConfig
+     * branded type ensures validation has occurred.
+     */
+    addMcpServer(serverName: string, validatedConfig: ValidatedMcpServerConfig): void;
+    /**
+     * Remove an MCP server configuration at runtime.
+     */
+    removeMcpServer(serverName: string): void;
+    /**
+     * Set a session-specific override
+     */
+    private setSessionOverride;
+    /**
+     * Get a session override (internal helper)
+     */
+    private getSessionOverride;
+    /**
+     * Clear session-specific overrides
+     */
+    clearSessionOverride(sessionId: string): void;
+    /**
+     * Clear all session overrides (private helper for resetToBaseline)
+     */
+    private clearAllSessionOverrides;
+    /**
+     * Export current runtime state as config.
+     * This allows users to save their runtime modifications as a new agent config.
+     */
+    exportAsConfig(): ValidatedAgentConfig;
+    /**
+     * Reset runtime state back to baseline configuration
+     */
+    resetToBaseline(): void;
+    /**
+     * Get the current effective LLM configuration for a session.
+     * **Use this for session-specific LLM config** (includes session overrides).
+     */
+    getLLMConfig(sessionId?: string): Readonly<ValidatedLLMConfig>;
+}
+
+export { AgentStateManager, type SessionOverride };

package/dist/agent/state-manager.d.ts

@@ -0,0 +1,97 @@
+import { ValidatedAgentConfig } from './schemas.js';
+import { ValidatedLLMConfig } from '../llm/schemas.js';
+import { ValidatedMcpServerConfig } from '../mcp/schemas.js';
+import { AgentEventBus } from '../events/index.js';
+import 'zod';
+import '../llm/types.js';
+import 'events';
+
+/**
+ * Session-specific overrides that can differ from the global configuration
+ */
+interface SessionOverride {
+    /** Override LLM config for this session - must be a complete validated config */
+    llm?: ValidatedLLMConfig;
+}
+/**
+ * Manages the runtime configuration of the agent.
+ *
+ * This class handles dynamic configuration changes that occur during agent execution.
+ *
+ * Key responsibilities:
+ * 1. Track runtime changes separate from static config baseline
+ * 2. Support session-specific overrides for LLM settings
+ * 3. Dynamic MCP server management (add/remove servers at runtime)
+ * 4. Export modified state back to config format
+ * 5. Provide change tracking and validation capabilities
+ * 6. Maintain effective configuration for each session
+ */
+declare class AgentStateManager {
+    private agentEventBus;
+    private runtimeConfig;
+    private readonly baselineConfig;
+    private sessionOverrides;
+    /**
+     * Initialize AgentStateManager from a validated static configuration.
+     *
+     * @param staticConfig The validated configuration from DextoAgent
+     * @param agentEventBus The agent event bus for emitting state change events
+     */
+    constructor(staticConfig: ValidatedAgentConfig, agentEventBus: AgentEventBus);
+    /**
+     * Get runtime configuration for a session (includes session overrides if sessionId provided)
+     */
+    getRuntimeConfig(sessionId?: string): Readonly<ValidatedAgentConfig>;
+    /**
+     * Update the LLM configuration (globally or for a specific session)
+     *
+     * This method is a pure state updater - it assumes the input has already been validated
+     * by the caller (typically DextoAgent.switchLLM). The ValidatedLLMConfig branded type
+     * ensures validation has occurred.
+     */
+    updateLLM(validatedConfig: ValidatedLLMConfig, sessionId?: string): void;
+    /**
+     * Add or update an MCP server configuration at runtime.
+     *
+     * This method is a pure state updater - it assumes the input has already been validated
+     * by the caller (typically DextoAgent.connectMcpServer). The ValidatedMcpServerConfig
+     * branded type ensures validation has occurred.
+     */
+    addMcpServer(serverName: string, validatedConfig: ValidatedMcpServerConfig): void;
+    /**
+     * Remove an MCP server configuration at runtime.
+     */
+    removeMcpServer(serverName: string): void;
+    /**
+     * Set a session-specific override
+     */
+    private setSessionOverride;
+    /**
+     * Get a session override (internal helper)
+     */
+    private getSessionOverride;
+    /**
+     * Clear session-specific overrides
+     */
+    clearSessionOverride(sessionId: string): void;
+    /**
+     * Clear all session overrides (private helper for resetToBaseline)
+     */
+    private clearAllSessionOverrides;
+    /**
+     * Export current runtime state as config.
+     * This allows users to save their runtime modifications as a new agent config.
+     */
+    exportAsConfig(): ValidatedAgentConfig;
+    /**
+     * Reset runtime state back to baseline configuration
+     */
+    resetToBaseline(): void;
+    /**
+     * Get the current effective LLM configuration for a session.
+     * **Use this for session-specific LLM config** (includes session overrides).
+     */
+    getLLMConfig(sessionId?: string): Readonly<ValidatedLLMConfig>;
+}
+
+export { AgentStateManager, type SessionOverride };

package/dist/agent/state-manager.js

@@ -0,0 +1,190 @@
+import { logger } from "../logger/index.js";
+class AgentStateManager {
+  /**
+   * Initialize AgentStateManager from a validated static configuration.
+   *
+   * @param staticConfig The validated configuration from DextoAgent
+   * @param agentEventBus The agent event bus for emitting state change events
+   */
+  constructor(staticConfig, agentEventBus) {
+    this.agentEventBus = agentEventBus;
+    this.baselineConfig = structuredClone(staticConfig);
+    this.runtimeConfig = structuredClone(staticConfig);
+    logger.debug("AgentStateManager initialized", {
+      staticConfigKeys: Object.keys(this.baselineConfig),
+      mcpServerCount: Object.keys(this.runtimeConfig.mcpServers).length
+    });
+  }
+  runtimeConfig;
+  baselineConfig;
+  sessionOverrides = /* @__PURE__ */ new Map();
+  // ============= GETTERS =============
+  /**
+   * Get runtime configuration for a session (includes session overrides if sessionId provided)
+   */
+  getRuntimeConfig(sessionId) {
+    if (!sessionId) {
+      return structuredClone(this.runtimeConfig);
+    }
+    const override = this.sessionOverrides.get(sessionId);
+    if (!override) {
+      return structuredClone(this.runtimeConfig);
+    }
+    return {
+      ...this.runtimeConfig,
+      llm: { ...this.runtimeConfig.llm, ...override.llm }
+    };
+  }
+  // ============= LLM CONFIGURATION =============
+  /**
+   * Update the LLM configuration (globally or for a specific session)
+   *
+   * This method is a pure state updater - it assumes the input has already been validated
+   * by the caller (typically DextoAgent.switchLLM). The ValidatedLLMConfig branded type
+   * ensures validation has occurred.
+   */
+  updateLLM(validatedConfig, sessionId) {
+    const oldValue = sessionId ? this.getRuntimeConfig(sessionId).llm : this.runtimeConfig.llm;
+    if (sessionId) {
+      this.setSessionOverride(sessionId, {
+        llm: validatedConfig
+      });
+    } else {
+      this.runtimeConfig.llm = validatedConfig;
+    }
+    this.agentEventBus.emit("dexto:stateChanged", {
+      field: "llm",
+      oldValue,
+      newValue: validatedConfig,
+      ...sessionId && { sessionId }
+    });
+    logger.info("LLM config updated", {
+      sessionId,
+      provider: validatedConfig.provider,
+      model: validatedConfig.model,
+      isSessionSpecific: !!sessionId
+    });
+  }
+  // ============= MCP SERVER MANAGEMENT =============
+  /**
+   * Add or update an MCP server configuration at runtime.
+   *
+   * This method is a pure state updater - it assumes the input has already been validated
+   * by the caller (typically DextoAgent.connectMcpServer). The ValidatedMcpServerConfig
+   * branded type ensures validation has occurred.
+   */
+  addMcpServer(serverName, validatedConfig) {
+    logger.debug(`Adding/updating MCP server: ${serverName}`);
+    const isUpdate = serverName in this.runtimeConfig.mcpServers;
+    this.runtimeConfig.mcpServers[serverName] = validatedConfig;
+    const eventName = isUpdate ? "dexto:mcpServerUpdated" : "dexto:mcpServerAdded";
+    this.agentEventBus.emit(eventName, { serverName, config: validatedConfig });
+    this.agentEventBus.emit("dexto:stateChanged", {
+      field: "mcpServers",
+      oldValue: isUpdate ? "updated" : "added",
+      newValue: validatedConfig
+      // sessionId omitted - MCP servers are global
+    });
+    logger.info(`MCP server '${serverName}' ${isUpdate ? "updated" : "added"} successfully`);
+  }
+  /**
+   * Remove an MCP server configuration at runtime.
+   */
+  removeMcpServer(serverName) {
+    logger.debug(`Removing MCP server: ${serverName}`);
+    if (serverName in this.runtimeConfig.mcpServers) {
+      delete this.runtimeConfig.mcpServers[serverName];
+      this.agentEventBus.emit("dexto:mcpServerRemoved", { serverName });
+      this.agentEventBus.emit("dexto:stateChanged", {
+        field: "mcpServers",
+        oldValue: "removed",
+        newValue: void 0
+        // sessionId omitted - MCP servers are global
+      });
+      logger.info(`MCP server '${serverName}' removed successfully`);
+    } else {
+      logger.warn(`MCP server '${serverName}' not found for removal`);
+    }
+  }
+  // ============= SESSION MANAGEMENT =============
+  /**
+   * Set a session-specific override
+   */
+  setSessionOverride(sessionId, override) {
+    this.sessionOverrides.set(sessionId, override);
+    this.agentEventBus.emit("dexto:sessionOverrideSet", {
+      sessionId,
+      override: structuredClone(override)
+    });
+  }
+  /**
+   * Get a session override (internal helper)
+   */
+  getSessionOverride(sessionId) {
+    return this.sessionOverrides.get(sessionId);
+  }
+  /**
+   * Clear session-specific overrides
+   */
+  clearSessionOverride(sessionId) {
+    const hadOverride = this.sessionOverrides.has(sessionId);
+    this.sessionOverrides.delete(sessionId);
+    if (hadOverride) {
+      this.agentEventBus.emit("dexto:sessionOverrideCleared", { sessionId });
+      logger.info("Session override cleared", { sessionId });
+    }
+  }
+  /**
+   * Clear all session overrides (private helper for resetToBaseline)
+   */
+  clearAllSessionOverrides() {
+    const sessionIds = Array.from(this.sessionOverrides.keys());
+    this.sessionOverrides.clear();
+    sessionIds.forEach((sessionId) => {
+      this.agentEventBus.emit("dexto:sessionOverrideCleared", { sessionId });
+    });
+    if (sessionIds.length > 0) {
+      logger.info("All session overrides cleared", { clearedSessions: sessionIds });
+    }
+  }
+  // ============= CONFIG EXPORT =============
+  /**
+   * Export current runtime state as config.
+   * This allows users to save their runtime modifications as a new agent config.
+   */
+  exportAsConfig() {
+    const exportedConfig = {
+      ...this.baselineConfig,
+      llm: structuredClone(this.runtimeConfig.llm),
+      systemPrompt: this.runtimeConfig.systemPrompt,
+      mcpServers: structuredClone(this.runtimeConfig.mcpServers)
+    };
+    this.agentEventBus.emit("dexto:stateExported", {
+      config: exportedConfig
+    });
+    logger.info("Runtime state exported as config", {
+      exportedConfig
+    });
+    return exportedConfig;
+  }
+  /**
+   * Reset runtime state back to baseline configuration
+   */
+  resetToBaseline() {
+    this.runtimeConfig = structuredClone(this.baselineConfig);
+    this.clearAllSessionOverrides();
+    this.agentEventBus.emit("dexto:stateReset", { toConfig: this.baselineConfig });
+    logger.info("Runtime state reset to baseline config");
+  }
+  // ============= CONVENIENCE GETTERS FOR USED FUNCTIONALITY =============
+  /**
+   * Get the current effective LLM configuration for a session.
+   * **Use this for session-specific LLM config** (includes session overrides).
+   */
+  getLLMConfig(sessionId) {
+    return this.getRuntimeConfig(sessionId).llm;
+  }
+}
+export {
+  AgentStateManager
+};