@dexto/core 1.1.10 → 1.2.0

package/dist/plugins/schemas.js

@@ -0,0 +1,36 @@
+import "../chunk-C6A6W6XS.js";
+import { z } from "zod";
+const CustomPluginConfigSchema = z.object({
+  name: z.string().describe("Unique name for the plugin"),
+  module: z.string().describe(
+    "Absolute path to plugin module (use ${{dexto.agent_dir}} for agent-relative paths)"
+  ),
+  enabled: z.boolean().default(true).describe("Whether this plugin is enabled"),
+  blocking: z.boolean().describe("If true, plugin errors will halt execution"),
+  priority: z.number().int().describe("Execution priority (lower runs first)"),
+  config: z.record(z.any()).optional().describe("Plugin-specific configuration")
+}).strict();
+const BuiltInPluginConfigSchema = z.object({
+  priority: z.number().int().describe("Execution priority (lower runs first)"),
+  blocking: z.boolean().optional().describe("If true, plugin errors will halt execution"),
+  enabled: z.boolean().default(true).describe("Whether this plugin is enabled")
+  // Plugin-specific config fields are defined per-plugin
+}).passthrough().describe("Configuration for a built-in plugin");
+const PluginsConfigSchema = z.object({
+  // Built-in plugins - referenced by name
+  contentPolicy: BuiltInPluginConfigSchema.optional().describe(
+    "Content policy plugin for input validation and sanitization"
+  ),
+  responseSanitizer: BuiltInPluginConfigSchema.optional().describe(
+    "Response sanitizer plugin for output sanitization"
+  ),
+  // Custom plugins - array of plugin configurations
+  custom: z.array(CustomPluginConfigSchema).default([]).describe("Array of custom plugin configurations")
+}).strict().default({
+  custom: []
+}).describe("Plugin system configuration");
+export {
+  BuiltInPluginConfigSchema,
+  CustomPluginConfigSchema,
+  PluginsConfigSchema
+};

package/dist/{storage/backend/cache-backend.cjs → plugins/types.cjs}

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

package/dist/plugins/types.d.ts

@@ -0,0 +1,152 @@
+import type { ValidatedLLMConfig } from '../llm/schemas.js';
+import type { Logger } from '../logger/index.js';
+import type { SessionManager } from '../session/index.js';
+import type { MCPManager } from '../mcp/manager.js';
+import type { ToolManager } from '../tools/tool-manager.js';
+import type { AgentStateManager } from '../agent/state-manager.js';
+import type { AgentEventBus } from '../events/index.js';
+import type { StorageManager } from '../storage/index.js';
+/**
+ * Extension point names - fixed for MVP
+ * These are the 4 hook sites from PR #385 converted to generic plugin extension points
+ */
+export type ExtensionPoint = 'beforeLLMRequest' | 'beforeToolCall' | 'afterToolResult' | 'beforeResponse';
+/**
+ * Plugin result - what plugins return from extension point methods
+ */
+export interface PluginResult {
+    /** Did plugin execute successfully? */
+    ok: boolean;
+    /** Partial modifications to apply to payload */
+    modify?: Record<string, any>;
+    /** Should execution stop? (Only respected if plugin is blocking) */
+    cancel?: boolean;
+    /** User-facing message (shown when cancelled) */
+    message?: string;
+    /** Notices for logging/events */
+    notices?: PluginNotice[];
+}
+/**
+ * Plugin notice - for logging and user feedback
+ */
+export interface PluginNotice {
+    kind: 'allow' | 'block' | 'warn' | 'info';
+    code?: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Execution context passed to every plugin method
+ * Contains runtime state and read-only access to agent services
+ */
+export interface PluginExecutionContext {
+    /** Current session ID */
+    sessionId?: string | undefined;
+    /** User ID (set by application layer via AsyncLocalStorage) */
+    userId?: string | undefined;
+    /** Tenant ID (set by application layer for multi-tenant deployments via AsyncLocalStorage) */
+    tenantId?: string | undefined;
+    /** Current LLM configuration */
+    llmConfig: ValidatedLLMConfig;
+    /** Logger scoped to this plugin execution */
+    logger: Logger;
+    /** Abort signal for cancellation */
+    abortSignal?: AbortSignal | undefined;
+    /** Reference to agent services (read-only access) */
+    agent: {
+        readonly sessionManager: SessionManager;
+        readonly mcpManager: MCPManager;
+        readonly toolManager: ToolManager;
+        readonly stateManager: AgentStateManager;
+        readonly agentEventBus: AgentEventBus;
+        readonly storageManager: StorageManager;
+    };
+}
+/**
+ * Payload for beforeLLMRequest extension point
+ */
+export interface BeforeLLMRequestPayload {
+    text: string;
+    imageData?: {
+        image: string;
+        mimeType: string;
+    };
+    fileData?: {
+        data: string;
+        mimeType: string;
+        filename?: string;
+    };
+    sessionId?: string;
+}
+/**
+ * Payload for beforeToolCall extension point
+ */
+export interface BeforeToolCallPayload {
+    toolName: string;
+    args: any;
+    sessionId?: string;
+    callId?: string;
+}
+/**
+ * Payload for afterToolResult extension point
+ */
+export interface AfterToolResultPayload {
+    toolName: string;
+    result: any;
+    success: boolean;
+    sessionId?: string;
+    callId?: string;
+}
+/**
+ * Payload for beforeResponse extension point
+ */
+export interface BeforeResponsePayload {
+    content: string;
+    reasoning?: string;
+    provider: string;
+    model?: string;
+    router?: string;
+    tokenUsage?: {
+        input: number;
+        output: number;
+    };
+    sessionId?: string;
+}
+/**
+ * Main plugin interface - implement any subset of these methods
+ * All methods are optional - plugin must implement at least one extension point
+ */
+export interface DextoPlugin {
+    /** Called once at plugin initialization (before agent starts) */
+    initialize?(config: Record<string, any>): Promise<void>;
+    /** Extension point: before LLM request */
+    beforeLLMRequest?(payload: BeforeLLMRequestPayload, context: PluginExecutionContext): Promise<PluginResult>;
+    /** Extension point: before tool call */
+    beforeToolCall?(payload: BeforeToolCallPayload, context: PluginExecutionContext): Promise<PluginResult>;
+    /** Extension point: after tool result */
+    afterToolResult?(payload: AfterToolResultPayload, context: PluginExecutionContext): Promise<PluginResult>;
+    /** Extension point: before response */
+    beforeResponse?(payload: BeforeResponsePayload, context: PluginExecutionContext): Promise<PluginResult>;
+    /** Called when agent shuts down (cleanup) */
+    cleanup?(): Promise<void>;
+}
+/**
+ * Plugin configuration from YAML (custom plugins)
+ */
+export interface PluginConfig {
+    name: string;
+    module: string;
+    enabled: boolean;
+    blocking: boolean;
+    priority: number;
+    config?: Record<string, any> | undefined;
+}
+/**
+ * Loaded plugin with its configuration
+ * Internal type used by PluginManager
+ */
+export interface LoadedPlugin {
+    plugin: DextoPlugin;
+    config: PluginConfig;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/preferences/constants.d.ts

@@ -1,3 +1,2 @@
-declare const PREFERENCES_FILE = "preferences.yml";
-
-export { PREFERENCES_FILE };
+export declare const PREFERENCES_FILE = "preferences.yml";
+//# sourceMappingURL=constants.d.ts.map

package/dist/preferences/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/preferences/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,oBAAoB,CAAC"}

package/dist/preferences/constants.js

@@ -1,3 +1,4 @@
+import "../chunk-C6A6W6XS.js";
 const PREFERENCES_FILE = "preferences.yml";
 export {
   PREFERENCES_FILE

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

@@ -1,9 +1,8 @@
-declare enum PreferenceErrorCode {
+export declare enum PreferenceErrorCode {
     FILE_NOT_FOUND = "preference_file_not_found",
     FILE_READ_ERROR = "preference_file_read_error",
     FILE_WRITE_ERROR = "preference_file_write_error",
     VALIDATION_ERROR = "preference_validation_error",
     MODEL_INCOMPATIBLE = "preference_model_incompatible"
 }
-
-export { PreferenceErrorCode };
+//# sourceMappingURL=error-codes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/preferences/error-codes.ts"],"names":[],"mappings":"AAEA,oBAAY,mBAAmB;IAC3B,cAAc,8BAA8B;IAC5C,eAAe,+BAA+B;IAC9C,gBAAgB,gCAAgC;IAChD,gBAAgB,gCAAgC;IAChD,kBAAkB,kCAAkC;CACvD"}

package/dist/preferences/error-codes.js

@@ -1,3 +1,4 @@
+import "../chunk-C6A6W6XS.js";
 var PreferenceErrorCode = /* @__PURE__ */ ((PreferenceErrorCode2) => {
   PreferenceErrorCode2["FILE_NOT_FOUND"] = "preference_file_not_found";
   PreferenceErrorCode2["FILE_READ_ERROR"] = "preference_file_read_error";

package/dist/preferences/errors.d.ts

@@ -1,21 +1,7 @@
-import { DextoRuntimeError } from '../errors/DextoRuntimeError.js';
-import { DextoValidationError } from '../errors/DextoValidationError.js';
+import { DextoRuntimeError, DextoValidationError } from '../errors/index.js';
+import { type ZodError } from 'zod';
 export { PreferenceErrorCode } from './error-codes.js';
-import { ZodError } from 'zod';
-import '../errors/DextoBaseError.js';
-import '../errors/types.js';
-import '../agent/error-codes.js';
-import '../config/error-codes.js';
-import '../context/error-codes.js';
-import '../llm/error-codes.js';
-import '../mcp/error-codes.js';
-import '../session/error-codes.js';
-import '../storage/error-codes.js';
-import '../systemPrompt/error-codes.js';
-import '../tools/error-codes.js';
-import '../agent/registry/error-codes.js';
-
-declare class PreferenceError {
+export declare class PreferenceError {
     static fileNotFound(preferencesPath: string): DextoRuntimeError<{
         preferencesPath: string;
     }>;
@@ -29,5 +15,4 @@ declare class PreferenceError {
     }>;
     static validationFailed(zodError: ZodError): DextoValidationError;
 }
-
-export { PreferenceError };
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/preferences/errors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAGpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,qBAAa,eAAe;IACxB,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM;;;IAW3C,MAAM,CAAC,aAAa,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAW3D,MAAM,CAAC,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAW5D,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ;CAW7C"}

package/dist/preferences/errors.js

@@ -1,3 +1,4 @@
+import "../chunk-C6A6W6XS.js";
 import { DextoRuntimeError, DextoValidationError } from "../errors/index.js";
 import { ErrorScope, ErrorType } from "../errors/types.js";
 import { PreferenceErrorCode } from "./error-codes.js";

package/dist/preferences/index.d.ts

@@ -1,21 +1,6 @@
-export { GlobalPreferences, GlobalPreferencesSchema, PreferenceDefaults, PreferenceDefaultsSchema, PreferenceLLM, PreferenceLLMSchema, PreferenceSetup, PreferenceSetupSchema } from './schemas.js';
+export type { GlobalPreferences, PreferenceLLM, PreferenceDefaults, PreferenceSetup, } from './schemas.js';
+export { GlobalPreferencesSchema, PreferenceLLMSchema, PreferenceDefaultsSchema, PreferenceSetupSchema, } from './schemas.js';
 export { PREFERENCES_FILE } from './constants.js';
-export { createInitialPreferences, getGlobalPreferencesPath, globalPreferencesExist, loadGlobalPreferences, saveGlobalPreferences, updateGlobalPreferences } from './loader.js';
-export { PreferenceError } from './errors.js';
-export { PreferenceErrorCode } from './error-codes.js';
-import 'zod';
-import '../llm/types.js';
-import '../errors/DextoRuntimeError.js';
-import '../errors/DextoBaseError.js';
-import '../errors/types.js';
-import '../agent/error-codes.js';
-import '../config/error-codes.js';
-import '../context/error-codes.js';
-import '../llm/error-codes.js';
-import '../mcp/error-codes.js';
-import '../session/error-codes.js';
-import '../storage/error-codes.js';
-import '../systemPrompt/error-codes.js';
-import '../tools/error-codes.js';
-import '../agent/registry/error-codes.js';
-import '../errors/DextoValidationError.js';
+export { loadGlobalPreferences, saveGlobalPreferences, globalPreferencesExist, getGlobalPreferencesPath, createInitialPreferences, updateGlobalPreferences, } from './loader.js';
+export { PreferenceError, PreferenceErrorCode } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/preferences/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACR,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,eAAe,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EACH,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/preferences/index.js

@@ -1,3 +1,4 @@
+import "../chunk-C6A6W6XS.js";
 import {
   GlobalPreferencesSchema,
   PreferenceLLMSchema,

package/dist/preferences/loader.cjs

@@ -100,7 +100,9 @@ function createInitialPreferences(provider, model, apiKeyVar, defaultAgent = "de
       apiKey: `$${apiKeyVar}`
     },
     defaults: {
-      defaultAgent
+      defaultAgent,
+      defaultMode: "web"
+      // Default to web mode
     },
     setup: {
       completed: true

package/dist/preferences/loader.d.ts

@@ -1,30 +1,28 @@
-import { LLMProvider } from '../llm/types.js';
-import { GlobalPreferences } from './schemas.js';
-import 'zod';
-
+import type { LLMProvider } from '../llm/types.js';
+import { type GlobalPreferences } from './schemas.js';
 /**
  * Load global preferences from ~/.dexto/preferences.yml
  * @returns Global preferences object
  * @throws DextoRuntimeError if file not found or corrupted
  * @throws DextoValidationError if preferences are invalid
  */
-declare function loadGlobalPreferences(): Promise<GlobalPreferences>;
+export declare function loadGlobalPreferences(): Promise<GlobalPreferences>;
 /**
  * Save global preferences to ~/.dexto/preferences.yml
  * @param preferences Validated preferences object
  * @throws DextoRuntimeError if write fails
  */
-declare function saveGlobalPreferences(preferences: GlobalPreferences): Promise<void>;
+export declare function saveGlobalPreferences(preferences: GlobalPreferences): Promise<void>;
 /**
  * Check if global preferences exist (for first-time detection)
  * @returns true if preferences.yml exists
  */
-declare function globalPreferencesExist(): boolean;
+export declare function globalPreferencesExist(): boolean;
 /**
  * Get global preferences file path
  * @returns Absolute path to preferences.yml
  */
-declare function getGlobalPreferencesPath(): string;
+export declare function getGlobalPreferencesPath(): string;
 /**
  * Create initial preferences from setup data
  * @param provider Selected LLM provider
@@ -32,7 +30,15 @@ declare function getGlobalPreferencesPath(): string;
  * @param apiKeyVar Environment variable name for API key
  * @param defaultAgent Optional default agent name
  */
-declare function createInitialPreferences(provider: LLMProvider, model: string, apiKeyVar: string, defaultAgent?: string): GlobalPreferences;
+export declare function createInitialPreferences(provider: LLMProvider, model: string, apiKeyVar: string, defaultAgent?: string): GlobalPreferences;
+/**
+ * Updates type that allows partial nested objects
+ */
+type GlobalPreferencesUpdates = {
+    llm?: GlobalPreferences['llm'];
+    defaults?: Partial<GlobalPreferences['defaults']>;
+    setup?: Partial<GlobalPreferences['setup']>;
+};
 /**
  * Update specific preference sections
  * @param updates Partial preference updates
@@ -40,6 +46,6 @@ declare function createInitialPreferences(provider: LLMProvider, model: string,
  * @throws DextoRuntimeError if load/save fails
  * @throws DextoValidationError if merged preferences are invalid
  */
-declare function updateGlobalPreferences(updates: Partial<GlobalPreferences>): Promise<GlobalPreferences>;
-
-export { createInitialPreferences, getGlobalPreferencesPath, globalPreferencesExist, loadGlobalPreferences, saveGlobalPreferences, updateGlobalPreferences };
+export declare function updateGlobalPreferences(updates: GlobalPreferencesUpdates): Promise<GlobalPreferences>;
+export {};
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/preferences/loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAI/E;;;;;GAKG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA+BxE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCzF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,MAAwB,GACvC,iBAAiB,CAenB;AAED;;GAEG;AACH,KAAK,wBAAwB,GAAG;IAC5B,GAAG,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,iBAAiB,CAAC,CA2B5B"}

package/dist/preferences/loader.js

@@ -1,3 +1,4 @@
+import "../chunk-C6A6W6XS.js";
 import { existsSync } from "fs";
 import { promises as fs } from "fs";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
@@ -72,7 +73,9 @@ function createInitialPreferences(provider, model, apiKeyVar, defaultAgent = "de
       apiKey: `$${apiKeyVar}`
     },
     defaults: {
-      defaultAgent
+      defaultAgent,
+      defaultMode: "web"
+      // Default to web mode
     },
     setup: {
       completed: true

package/dist/preferences/schemas.cjs

@@ -53,7 +53,8 @@ const PreferenceLLMSchema = import_zod.z.object({
   }
 });
 const PreferenceDefaultsSchema = import_zod.z.object({
-  defaultAgent: import_zod.z.string().min(1).describe("Default agent name for global CLI usage (required)")
+  defaultAgent: import_zod.z.string().min(1).describe("Default agent name for global CLI usage (required)"),
+  defaultMode: import_zod.z.enum(["cli", "web", "server", "discord", "telegram", "mcp"]).default("web").describe("Default run mode when --mode flag is not specified (default: web)")
 }).strict();
 const PreferenceSetupSchema = import_zod.z.object({
   completed: import_zod.z.boolean().default(false).describe("Whether initial setup has been completed")

package/dist/preferences/schemas.d.ts

@@ -1,68 +1,73 @@
 import { z } from 'zod';
-
-declare const PreferenceLLMSchema: z.ZodEffects<z.ZodObject<{
+export declare const PreferenceLLMSchema: z.ZodEffects<z.ZodObject<{
     provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere"]>;
     model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
     apiKey: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     apiKey: string;
-    model: string;
     provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    model: string;
 }, {
     apiKey: string;
-    model: string;
     provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    model: string;
 }>, {
     apiKey: string;
-    model: string;
     provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    model: string;
 }, {
     apiKey: string;
-    model: string;
     provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    model: string;
 }>;
-declare const PreferenceDefaultsSchema: z.ZodObject<{
+export declare const PreferenceDefaultsSchema: z.ZodObject<{
     defaultAgent: z.ZodString;
+    defaultMode: z.ZodDefault<z.ZodEnum<["cli", "web", "server", "discord", "telegram", "mcp"]>>;
 }, "strict", z.ZodTypeAny, {
     defaultAgent: string;
+    defaultMode: "mcp" | "cli" | "web" | "server" | "discord" | "telegram";
 }, {
     defaultAgent: string;
+    defaultMode?: "mcp" | "cli" | "web" | "server" | "discord" | "telegram" | undefined;
 }>;
-declare const PreferenceSetupSchema: z.ZodObject<{
+export declare const PreferenceSetupSchema: z.ZodObject<{
     completed: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     completed: boolean;
 }, {
     completed?: boolean | undefined;
 }>;
-declare const GlobalPreferencesSchema: z.ZodObject<{
+export declare const GlobalPreferencesSchema: z.ZodObject<{
     llm: z.ZodEffects<z.ZodObject<{
         provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere"]>;
         model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
         apiKey: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         apiKey: string;
-        model: string;
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        model: string;
     }, {
         apiKey: string;
-        model: string;
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        model: string;
     }>, {
         apiKey: string;
-        model: string;
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        model: string;
     }, {
         apiKey: string;
-        model: string;
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        model: string;
     }>;
     defaults: z.ZodObject<{
         defaultAgent: z.ZodString;
+        defaultMode: z.ZodDefault<z.ZodEnum<["cli", "web", "server", "discord", "telegram", "mcp"]>>;
     }, "strict", z.ZodTypeAny, {
         defaultAgent: string;
+        defaultMode: "mcp" | "cli" | "web" | "server" | "discord" | "telegram";
     }, {
         defaultAgent: string;
+        defaultMode?: "mcp" | "cli" | "web" | "server" | "discord" | "telegram" | undefined;
     }>;
     setup: z.ZodDefault<z.ZodObject<{
         completed: z.ZodDefault<z.ZodBoolean>;
@@ -74,11 +79,12 @@ declare const GlobalPreferencesSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     llm: {
         apiKey: string;
-        model: string;
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        model: string;
     };
     defaults: {
         defaultAgent: string;
+        defaultMode: "mcp" | "cli" | "web" | "server" | "discord" | "telegram";
     };
     setup: {
         completed: boolean;
@@ -86,19 +92,19 @@ declare const GlobalPreferencesSchema: z.ZodObject<{
 }, {
     llm: {
         apiKey: string;
-        model: string;
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        model: string;
     };
     defaults: {
         defaultAgent: string;
+        defaultMode?: "mcp" | "cli" | "web" | "server" | "discord" | "telegram" | undefined;
     };
     setup?: {
         completed?: boolean | undefined;
     } | undefined;
 }>;
-type PreferenceLLM = z.output<typeof PreferenceLLMSchema>;
-type PreferenceDefaults = z.output<typeof PreferenceDefaultsSchema>;
-type PreferenceSetup = z.output<typeof PreferenceSetupSchema>;
-type GlobalPreferences = z.output<typeof GlobalPreferencesSchema>;
-
-export { type GlobalPreferences, GlobalPreferencesSchema, type PreferenceDefaults, PreferenceDefaultsSchema, type PreferenceLLM, PreferenceLLMSchema, type PreferenceSetup, PreferenceSetupSchema };
+export type PreferenceLLM = z.output<typeof PreferenceLLMSchema>;
+export type PreferenceDefaults = z.output<typeof PreferenceDefaultsSchema>;
+export type PreferenceSetup = z.output<typeof PreferenceSetupSchema>;
+export type GlobalPreferences = z.output<typeof GlobalPreferencesSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/preferences/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/preferences/schemas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;EA6B1B,CAAC;AAEP,eAAO,MAAM,wBAAwB;;;;;;;;;EAYxB,CAAC;AAEd,eAAO,MAAM,qBAAqB;;;;;;EAIrB,CAAC;AAEd,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUvB,CAAC;AAGd,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC3E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/preferences/schemas.js

@@ -1,3 +1,4 @@
+import "../chunk-C6A6W6XS.js";
 import { z } from "zod";
 import { isValidProviderModel, getSupportedModels } from "../llm/registry.js";
 import { LLM_PROVIDERS } from "../llm/types.js";
@@ -27,7 +28,8 @@ const PreferenceLLMSchema = z.object({
   }
 });
 const PreferenceDefaultsSchema = z.object({
-  defaultAgent: z.string().min(1).describe("Default agent name for global CLI usage (required)")
+  defaultAgent: z.string().min(1).describe("Default agent name for global CLI usage (required)"),
+  defaultMode: z.enum(["cli", "web", "server", "discord", "telegram", "mcp"]).default("web").describe("Default run mode when --mode flag is not specified (default: web)")
 }).strict();
 const PreferenceSetupSchema = z.object({
   completed: z.boolean().default(false).describe("Whether initial setup has been completed")