@dexto/agent-management 1.4.0 → 1.5.1

package/dist/models/state-manager.d.ts.map

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

package/dist/models/state-manager.js

@@ -0,0 +1,184 @@
+import { promises as fs } from "fs";
+import {
+  getModelStatePath,
+  ensureModelsDirectory,
+  modelFileExists,
+  getModelFilePath
+} from "./path-resolver.js";
+const CURRENT_VERSION = "1.0";
+function createDefaultState() {
+  return {
+    version: CURRENT_VERSION,
+    installed: {},
+    downloadQueue: []
+  };
+}
+async function loadModelState() {
+  const statePath = getModelStatePath();
+  try {
+    const content = await fs.readFile(statePath, "utf-8");
+    const state = JSON.parse(content);
+    if (state.version !== CURRENT_VERSION) {
+      return migrateState(state);
+    }
+    return state;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return createDefaultState();
+    }
+    console.warn("Invalid model state file, resetting to default");
+    return createDefaultState();
+  }
+}
+async function saveModelState(state) {
+  await ensureModelsDirectory();
+  const statePath = getModelStatePath();
+  await fs.writeFile(statePath, JSON.stringify(state, null, 2), "utf-8");
+}
+function migrateState(state) {
+  return {
+    ...state,
+    version: CURRENT_VERSION
+  };
+}
+async function addInstalledModel(model) {
+  const state = await loadModelState();
+  state.installed[model.id] = model;
+  await saveModelState(state);
+}
+async function removeInstalledModel(modelId) {
+  const state = await loadModelState();
+  if (!state.installed[modelId]) {
+    return false;
+  }
+  delete state.installed[modelId];
+  if (state.activeModelId === modelId) {
+    delete state.activeModelId;
+  }
+  state.downloadQueue = state.downloadQueue.filter((id) => id !== modelId);
+  await saveModelState(state);
+  return true;
+}
+async function getInstalledModel(modelId) {
+  const state = await loadModelState();
+  return state.installed[modelId] ?? null;
+}
+async function getAllInstalledModels() {
+  const state = await loadModelState();
+  return Object.values(state.installed);
+}
+async function isModelInstalled(modelId) {
+  const model = await getInstalledModel(modelId);
+  if (!model) {
+    return false;
+  }
+  return modelFileExists(modelId, model.filename);
+}
+async function updateModelLastUsed(modelId) {
+  const state = await loadModelState();
+  const model = state.installed[modelId];
+  if (model) {
+    model.lastUsedAt = (/* @__PURE__ */ new Date()).toISOString();
+    await saveModelState(state);
+  }
+}
+async function setActiveModel(modelId) {
+  const state = await loadModelState();
+  if (modelId === void 0) {
+    delete state.activeModelId;
+  } else {
+    state.activeModelId = modelId;
+  }
+  await saveModelState(state);
+}
+async function getActiveModelId() {
+  const state = await loadModelState();
+  return state.activeModelId;
+}
+async function getActiveModel() {
+  const activeId = await getActiveModelId();
+  if (!activeId) {
+    return null;
+  }
+  return getInstalledModel(activeId);
+}
+async function addToDownloadQueue(modelId) {
+  const state = await loadModelState();
+  if (!state.downloadQueue.includes(modelId)) {
+    state.downloadQueue.push(modelId);
+    await saveModelState(state);
+  }
+}
+async function removeFromDownloadQueue(modelId) {
+  const state = await loadModelState();
+  state.downloadQueue = state.downloadQueue.filter((id) => id !== modelId);
+  await saveModelState(state);
+}
+async function getDownloadQueue() {
+  const state = await loadModelState();
+  return [...state.downloadQueue];
+}
+async function syncStateWithFilesystem() {
+  const state = await loadModelState();
+  const removed = [];
+  const kept = [];
+  for (const [modelId, model] of Object.entries(state.installed)) {
+    const exists = await modelFileExists(modelId, model.filename);
+    if (exists) {
+      kept.push(modelId);
+    } else {
+      removed.push(modelId);
+      delete state.installed[modelId];
+    }
+  }
+  if (state.activeModelId && removed.includes(state.activeModelId)) {
+    delete state.activeModelId;
+  }
+  if (removed.length > 0) {
+    await saveModelState(state);
+  }
+  return { removed, kept };
+}
+async function getTotalInstalledSize() {
+  const state = await loadModelState();
+  return Object.values(state.installed).reduce((total, model) => total + model.sizeBytes, 0);
+}
+async function getInstalledModelCount() {
+  const state = await loadModelState();
+  return Object.keys(state.installed).length;
+}
+async function registerManualModel(modelId, filename, sizeBytes, sha256) {
+  const filePath = getModelFilePath(modelId, filename);
+  const model = {
+    id: modelId,
+    filePath,
+    sizeBytes,
+    downloadedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    source: "manual",
+    filename
+  };
+  if (sha256 !== void 0) {
+    model.sha256 = sha256;
+  }
+  await addInstalledModel(model);
+}
+export {
+  addInstalledModel,
+  addToDownloadQueue,
+  getActiveModel,
+  getActiveModelId,
+  getAllInstalledModels,
+  getDownloadQueue,
+  getInstalledModel,
+  getInstalledModelCount,
+  getTotalInstalledSize,
+  isModelInstalled,
+  loadModelState,
+  registerManualModel,
+  removeFromDownloadQueue,
+  removeInstalledModel,
+  saveModelState,
+  setActiveModel,
+  syncStateWithFilesystem,
+  updateModelLastUsed
+};

package/dist/preferences/error-codes.cjs

@@ -27,6 +27,8 @@ var PreferenceErrorCode = /* @__PURE__ */ ((PreferenceErrorCode2) => {
   PreferenceErrorCode2["FILE_WRITE_ERROR"] = "preference_file_write_error";
   PreferenceErrorCode2["VALIDATION_ERROR"] = "preference_validation_error";
   PreferenceErrorCode2["MODEL_INCOMPATIBLE"] = "preference_model_incompatible";
+  PreferenceErrorCode2["INVALID_PREFERENCE_VALUE"] = "preference_invalid_value";
+  PreferenceErrorCode2["MISSING_PREFERENCE"] = "preference_missing_required";
   return PreferenceErrorCode2;
 })(PreferenceErrorCode || {});
 // Annotate the CommonJS export names for ESM import in node:

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

@@ -3,6 +3,8 @@ export declare enum PreferenceErrorCode {
     FILE_READ_ERROR = "preference_file_read_error",
     FILE_WRITE_ERROR = "preference_file_write_error",
     VALIDATION_ERROR = "preference_validation_error",
-    MODEL_INCOMPATIBLE = "preference_model_incompatible"
+    MODEL_INCOMPATIBLE = "preference_model_incompatible",
+    INVALID_PREFERENCE_VALUE = "preference_invalid_value",
+    MISSING_PREFERENCE = "preference_missing_required"
 }
 //# sourceMappingURL=error-codes.d.ts.map

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

@@ -1 +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"}
+{"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;IACpD,wBAAwB,6BAA6B;IACrD,kBAAkB,gCAAgC;CACrD"}

package/dist/preferences/error-codes.js

@@ -4,6 +4,8 @@ var PreferenceErrorCode = /* @__PURE__ */ ((PreferenceErrorCode2) => {
   PreferenceErrorCode2["FILE_WRITE_ERROR"] = "preference_file_write_error";
   PreferenceErrorCode2["VALIDATION_ERROR"] = "preference_validation_error";
   PreferenceErrorCode2["MODEL_INCOMPATIBLE"] = "preference_model_incompatible";
+  PreferenceErrorCode2["INVALID_PREFERENCE_VALUE"] = "preference_invalid_value";
+  PreferenceErrorCode2["MISSING_PREFERENCE"] = "preference_missing_required";
   return PreferenceErrorCode2;
 })(PreferenceErrorCode || {});
 export {

package/dist/preferences/index.d.ts

@@ -1,6 +1,6 @@
 export type { GlobalPreferences, PreferenceLLM, PreferenceDefaults, PreferenceSetup, } from './schemas.js';
 export { GlobalPreferencesSchema, PreferenceLLMSchema, PreferenceDefaultsSchema, PreferenceSetupSchema, } from './schemas.js';
 export { PREFERENCES_FILE } from './constants.js';
-export { loadGlobalPreferences, saveGlobalPreferences, globalPreferencesExist, getGlobalPreferencesPath, createInitialPreferences, updateGlobalPreferences, } from './loader.js';
+export { loadGlobalPreferences, saveGlobalPreferences, globalPreferencesExist, getGlobalPreferencesPath, createInitialPreferences, updateGlobalPreferences, type CreatePreferencesOptions, } from './loader.js';
 export { PreferenceError, PreferenceErrorCode } from './errors.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,EACvB,KAAK,wBAAwB,GAChC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/preferences/loader.cjs

@@ -66,7 +66,7 @@ async function saveGlobalPreferences(preferences) {
     throw import_errors.PreferenceError.validationFailed(validation.error);
   }
   try {
-    import_core.logger.info(`Saving global preferences to: ${preferencesPath}`);
+    import_core.logger.debug(`Saving global preferences to: ${preferencesPath}`);
     const dextoDir = (0, import_path.getDextoGlobalPath)("");
     await import_fs2.promises.mkdir(dextoDir, { recursive: true });
     const yamlContent = (0, import_yaml.stringify)(preferences, {
@@ -75,7 +75,7 @@ async function saveGlobalPreferences(preferences) {
       minContentWidth: 20
     });
     await import_fs2.promises.writeFile(preferencesPath, yamlContent, "utf-8");
-    import_core.logger.info(
+    import_core.logger.debug(
       `\u2713 Saved global preferences ${JSON.stringify(preferences)} to: ${preferencesPath}`
     );
   } catch (error) {
@@ -92,20 +92,49 @@ function globalPreferencesExist() {
 function getGlobalPreferencesPath() {
   return (0, import_path.getDextoGlobalPath)(import_constants.PREFERENCES_FILE);
 }
-function createInitialPreferences(provider, model, apiKeyVar, defaultAgent = "default-agent") {
+function createInitialPreferences(providerOrOptions, model, apiKeyVar, defaultAgent = "coding-agent") {
+  if (typeof providerOrOptions === "object") {
+    const opts = providerOrOptions;
+    const llmConfig = {
+      provider: opts.provider,
+      model: opts.model
+    };
+    if (opts.apiKeyVar) {
+      llmConfig.apiKey = `$${opts.apiKeyVar}`;
+    }
+    if (opts.baseURL) {
+      llmConfig.baseURL = opts.baseURL;
+    }
+    if (opts.reasoningEffort) {
+      llmConfig.reasoningEffort = opts.reasoningEffort;
+    }
+    return {
+      llm: llmConfig,
+      defaults: {
+        defaultAgent: opts.defaultAgent || "coding-agent",
+        defaultMode: opts.defaultMode || "web"
+      },
+      setup: {
+        completed: opts.setupCompleted ?? true,
+        apiKeyPending: opts.apiKeyPending ?? false,
+        baseURLPending: opts.baseURLPending ?? false
+      }
+    };
+  }
   return {
     llm: {
-      provider,
+      provider: providerOrOptions,
       model,
       apiKey: `$${apiKeyVar}`
     },
     defaults: {
       defaultAgent,
       defaultMode: "web"
-      // Default to web mode
     },
     setup: {
-      completed: true
+      completed: true,
+      apiKeyPending: false,
+      baseURLPending: false
     }
   };
 }

package/dist/preferences/loader.d.ts

@@ -23,12 +23,33 @@ export declare function globalPreferencesExist(): boolean;
  * @returns Absolute path to preferences.yml
  */
 export declare function getGlobalPreferencesPath(): string;
+/**
+ * Options for creating initial preferences
+ */
+export interface CreatePreferencesOptions {
+    provider: LLMProvider;
+    model: string;
+    /** API key env var (optional for providers like Ollama that don't need auth) */
+    apiKeyVar?: string;
+    defaultAgent?: string;
+    defaultMode?: 'cli' | 'web' | 'server' | 'discord' | 'telegram' | 'mcp';
+    baseURL?: string;
+    /** Reasoning effort for OpenAI reasoning models (o1, o3, codex, gpt-5.x) */
+    reasoningEffort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+    setupCompleted?: boolean;
+    /** Whether API key setup was skipped and needs to be configured later */
+    apiKeyPending?: boolean;
+    /** Whether baseURL setup was skipped and needs to be configured later */
+    baseURLPending?: boolean;
+}
 /**
  * Create initial preferences from setup data
- * @param provider Selected LLM provider
- * @param model Selected model
- * @param apiKeyVar Environment variable name for API key
- * @param defaultAgent Optional default agent name
+ * @param options Configuration options for preferences
+ */
+export declare function createInitialPreferences(options: CreatePreferencesOptions): GlobalPreferences;
+/**
+ * Create initial preferences from setup data (legacy signature)
+ * @deprecated Use options object instead
  */
 export declare function createInitialPreferences(provider: LLMProvider, model: string, apiKeyVar: string, defaultAgent?: string): GlobalPreferences;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/preferences/loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,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,MAAM,MAAM,wBAAwB,GAAG;IACnC,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"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/preferences/loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,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;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAAC;AAE/F;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACtB,iBAAiB,CAAC;AAgErB;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACnC,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

@@ -38,7 +38,7 @@ async function saveGlobalPreferences(preferences) {
     throw PreferenceError.validationFailed(validation.error);
   }
   try {
-    logger.info(`Saving global preferences to: ${preferencesPath}`);
+    logger.debug(`Saving global preferences to: ${preferencesPath}`);
     const dextoDir = getDextoGlobalPath("");
     await fs.mkdir(dextoDir, { recursive: true });
     const yamlContent = stringifyYaml(preferences, {
@@ -47,7 +47,7 @@ async function saveGlobalPreferences(preferences) {
       minContentWidth: 20
     });
     await fs.writeFile(preferencesPath, yamlContent, "utf-8");
-    logger.info(
+    logger.debug(
       `\u2713 Saved global preferences ${JSON.stringify(preferences)} to: ${preferencesPath}`
     );
   } catch (error) {
@@ -64,20 +64,49 @@ function globalPreferencesExist() {
 function getGlobalPreferencesPath() {
   return getDextoGlobalPath(PREFERENCES_FILE);
 }
-function createInitialPreferences(provider, model, apiKeyVar, defaultAgent = "default-agent") {
+function createInitialPreferences(providerOrOptions, model, apiKeyVar, defaultAgent = "coding-agent") {
+  if (typeof providerOrOptions === "object") {
+    const opts = providerOrOptions;
+    const llmConfig = {
+      provider: opts.provider,
+      model: opts.model
+    };
+    if (opts.apiKeyVar) {
+      llmConfig.apiKey = `$${opts.apiKeyVar}`;
+    }
+    if (opts.baseURL) {
+      llmConfig.baseURL = opts.baseURL;
+    }
+    if (opts.reasoningEffort) {
+      llmConfig.reasoningEffort = opts.reasoningEffort;
+    }
+    return {
+      llm: llmConfig,
+      defaults: {
+        defaultAgent: opts.defaultAgent || "coding-agent",
+        defaultMode: opts.defaultMode || "web"
+      },
+      setup: {
+        completed: opts.setupCompleted ?? true,
+        apiKeyPending: opts.apiKeyPending ?? false,
+        baseURLPending: opts.baseURLPending ?? false
+      }
+    };
+  }
   return {
     llm: {
-      provider,
+      provider: providerOrOptions,
       model,
       apiKey: `$${apiKeyVar}`
     },
     defaults: {
       defaultAgent,
       defaultMode: "web"
-      // Default to web mode
     },
     setup: {
-      completed: true
+      completed: true,
+      apiKeyPending: false,
+      baseURLPending: false
     }
   };
 }

package/dist/preferences/schemas.cjs

@@ -36,9 +36,16 @@ const PreferenceLLMSchema = import_zod.z.object({
   apiKey: import_zod.z.string().regex(
     /^\$[A-Z_][A-Z0-9_]*$/,
     "Must be environment variable reference (e.g., $OPENAI_API_KEY)"
-  ).describe("Environment variable reference for API key")
+  ).optional().describe(
+    "Environment variable reference for API key (optional for local providers like Ollama)"
+  ),
+  baseURL: import_zod.z.string().url("Must be a valid URL (e.g., http://localhost:11434/v1)").optional().describe("Custom base URL for providers that support it (openai-compatible, litellm)"),
+  reasoningEffort: import_zod.z.enum(["none", "minimal", "low", "medium", "high", "xhigh"]).optional().describe(
+    "Reasoning effort level for OpenAI reasoning models (o1, o3, codex, gpt-5.x). Auto-detected if not set."
+  )
 }).strict().superRefine((data, ctx) => {
-  if (!(0, import_core.isValidProviderModel)(data.provider, data.model)) {
+  const skipModelValidation = (0, import_core.acceptsAnyModel)(data.provider) || (0, import_core.supportsCustomModels)(data.provider);
+  if (!skipModelValidation && !(0, import_core.isValidProviderModel)(data.provider, data.model)) {
     const supportedModels = (0, import_core.getSupportedModels)(data.provider);
     ctx.addIssue({
       code: import_zod.z.ZodIssueCode.custom,
@@ -51,13 +58,27 @@ const PreferenceLLMSchema = import_zod.z.object({
       }
     });
   }
+  if (data.baseURL && !(0, import_core.supportsBaseURL)(data.provider)) {
+    ctx.addIssue({
+      code: import_zod.z.ZodIssueCode.custom,
+      path: ["baseURL"],
+      message: `Provider '${data.provider}' does not support custom baseURL. Use 'openai-compatible' for custom endpoints.`,
+      params: {
+        code: import_error_codes.PreferenceErrorCode.INVALID_PREFERENCE_VALUE,
+        scope: "preference",
+        type: import_core4.ErrorType.USER
+      }
+    });
+  }
 });
 const PreferenceDefaultsSchema = import_zod.z.object({
   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")
+  completed: import_zod.z.boolean().default(false).describe("Whether initial setup has been completed"),
+  apiKeyPending: import_zod.z.boolean().default(false).describe("Whether API key setup was skipped and needs to be configured later"),
+  baseURLPending: import_zod.z.boolean().default(false).describe("Whether baseURL setup was skipped and needs to be configured later")
 }).strict();
 const GlobalPreferencesSchema = import_zod.z.object({
   llm: PreferenceLLMSchema.describe("LLM configuration preferences"),

package/dist/preferences/schemas.d.ts

@@ -1,24 +1,34 @@
 import { z } from 'zod';
 export declare const PreferenceLLMSchema: z.ZodEffects<z.ZodObject<{
-    provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere"]>;
+    provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere", "openrouter", "litellm", "glama", "vertex", "bedrock", "local", "ollama"]>;
     model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-    apiKey: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+    baseURL: z.ZodOptional<z.ZodString>;
+    reasoningEffort: z.ZodOptional<z.ZodEnum<["none", "minimal", "low", "medium", "high", "xhigh"]>>;
 }, "strict", z.ZodTypeAny, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
-    apiKey: string;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
 }, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
-    apiKey: string;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
 }>, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
-    apiKey: string;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
 }, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
-    apiKey: string;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
 }>;
 export declare const PreferenceDefaultsSchema: z.ZodObject<{
     defaultAgent: z.ZodString;
@@ -32,32 +42,48 @@ export declare const PreferenceDefaultsSchema: z.ZodObject<{
 }>;
 export declare const PreferenceSetupSchema: z.ZodObject<{
     completed: z.ZodDefault<z.ZodBoolean>;
+    apiKeyPending: z.ZodDefault<z.ZodBoolean>;
+    baseURLPending: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     completed: boolean;
+    apiKeyPending: boolean;
+    baseURLPending: boolean;
 }, {
     completed?: boolean | undefined;
+    apiKeyPending?: boolean | undefined;
+    baseURLPending?: boolean | undefined;
 }>;
 export declare const GlobalPreferencesSchema: z.ZodObject<{
     llm: z.ZodEffects<z.ZodObject<{
-        provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere"]>;
+        provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere", "openrouter", "litellm", "glama", "vertex", "bedrock", "local", "ollama"]>;
         model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-        apiKey: z.ZodString;
+        apiKey: z.ZodOptional<z.ZodString>;
+        baseURL: z.ZodOptional<z.ZodString>;
+        reasoningEffort: z.ZodOptional<z.ZodEnum<["none", "minimal", "low", "medium", "high", "xhigh"]>>;
     }, "strict", z.ZodTypeAny, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     }, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     }>, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     }, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     }>;
     defaults: z.ZodObject<{
         defaultAgent: z.ZodString;
@@ -71,16 +97,24 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
     }>;
     setup: z.ZodDefault<z.ZodObject<{
         completed: z.ZodDefault<z.ZodBoolean>;
+        apiKeyPending: z.ZodDefault<z.ZodBoolean>;
+        baseURLPending: z.ZodDefault<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         completed: boolean;
+        apiKeyPending: boolean;
+        baseURLPending: boolean;
     }, {
         completed?: boolean | undefined;
+        apiKeyPending?: boolean | undefined;
+        baseURLPending?: boolean | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
     llm: {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     };
     defaults: {
         defaultAgent: string;
@@ -88,12 +122,16 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
     };
     setup: {
         completed: boolean;
+        apiKeyPending: boolean;
+        baseURLPending: boolean;
     };
 }, {
     llm: {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     };
     defaults: {
         defaultAgent: string;
@@ -101,6 +139,8 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
     };
     setup?: {
         completed?: boolean | undefined;
+        apiKeyPending?: boolean | undefined;
+        baseURLPending?: boolean | undefined;
     } | undefined;
 }>;
 export type PreferenceLLM = z.output<typeof PreferenceLLMSchema>;

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

@@ -1 +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"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/preferences/schemas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsE1B,CAAC;AAEP,eAAO,MAAM,wBAAwB;;;;;;;;;EAYxB,CAAC;AAEd,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAYrB,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"}