@dexto/agent-management 1.3.0 → 1.5.0

package/dist/models/state-manager.cjs

@@ -0,0 +1,220 @@
+"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, {
+  addInstalledModel: () => addInstalledModel,
+  addToDownloadQueue: () => addToDownloadQueue,
+  getActiveModel: () => getActiveModel,
+  getActiveModelId: () => getActiveModelId,
+  getAllInstalledModels: () => getAllInstalledModels,
+  getDownloadQueue: () => getDownloadQueue,
+  getInstalledModel: () => getInstalledModel,
+  getInstalledModelCount: () => getInstalledModelCount,
+  getTotalInstalledSize: () => getTotalInstalledSize,
+  isModelInstalled: () => isModelInstalled,
+  loadModelState: () => loadModelState,
+  registerManualModel: () => registerManualModel,
+  removeFromDownloadQueue: () => removeFromDownloadQueue,
+  removeInstalledModel: () => removeInstalledModel,
+  saveModelState: () => saveModelState,
+  setActiveModel: () => setActiveModel,
+  syncStateWithFilesystem: () => syncStateWithFilesystem,
+  updateModelLastUsed: () => updateModelLastUsed
+});
+module.exports = __toCommonJS(state_manager_exports);
+var import_fs = require("fs");
+var import_path_resolver = require("./path-resolver.js");
+const CURRENT_VERSION = "1.0";
+function createDefaultState() {
+  return {
+    version: CURRENT_VERSION,
+    installed: {},
+    downloadQueue: []
+  };
+}
+async function loadModelState() {
+  const statePath = (0, import_path_resolver.getModelStatePath)();
+  try {
+    const content = await import_fs.promises.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 (0, import_path_resolver.ensureModelsDirectory)();
+  const statePath = (0, import_path_resolver.getModelStatePath)();
+  await import_fs.promises.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 (0, import_path_resolver.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 (0, import_path_resolver.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 = (0, import_path_resolver.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);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addInstalledModel,
+  addToDownloadQueue,
+  getActiveModel,
+  getActiveModelId,
+  getAllInstalledModels,
+  getDownloadQueue,
+  getInstalledModel,
+  getInstalledModelCount,
+  getTotalInstalledSize,
+  isModelInstalled,
+  loadModelState,
+  registerManualModel,
+  removeFromDownloadQueue,
+  removeInstalledModel,
+  saveModelState,
+  setActiveModel,
+  syncStateWithFilesystem,
+  updateModelLastUsed
+});

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

@@ -0,0 +1,138 @@
+/**
+ * Model state manager for tracking downloaded local models.
+ *
+ * Persists model metadata to ~/.dexto/models/state.json including:
+ * - Which models are installed
+ * - File paths and sizes
+ * - Download timestamps
+ * - Usage tracking
+ *
+ * Note: ModelSource and InstalledModel types here intentionally differ from
+ * packages/core/src/llm/providers/local/types.ts. This package extends the core
+ * types with agent-management specific needs:
+ * - ModelSource adds 'manual' for user-placed model files
+ * - InstalledModel adds 'filename' for file system operations (isModelInstalled, syncStateWithFilesystem)
+ */
+/**
+ * Source of the model download.
+ */
+export type ModelSource = 'huggingface' | 'manual';
+/**
+ * Installed model metadata.
+ */
+export interface InstalledModel {
+    /** Model ID from registry */
+    id: string;
+    /** Absolute path to the .gguf file */
+    filePath: string;
+    /** File size in bytes */
+    sizeBytes: number;
+    /** When the model was downloaded (ISO timestamp) */
+    downloadedAt: string;
+    /** When the model was last used (ISO timestamp) */
+    lastUsedAt?: string;
+    /** SHA-256 hash of the file for integrity verification */
+    sha256?: string;
+    /** Source of the download */
+    source: ModelSource;
+    /** GGUF filename */
+    filename: string;
+}
+/**
+ * Persisted model state.
+ */
+export interface ModelState {
+    /** Schema version for migrations */
+    version: string;
+    /** Map of model ID to installed model info */
+    installed: Record<string, InstalledModel>;
+    /** Currently active/selected model ID */
+    activeModelId?: string;
+    /** Queue of model IDs pending download */
+    downloadQueue: string[];
+}
+/**
+ * Load model state from disk.
+ * Returns default state if file doesn't exist.
+ */
+export declare function loadModelState(): Promise<ModelState>;
+/**
+ * Save model state to disk.
+ */
+export declare function saveModelState(state: ModelState): Promise<void>;
+/**
+ * Add an installed model to state.
+ *
+ * Note: These operations are not atomic. Ensure single-threaded access
+ * or implement file locking for concurrent usage scenarios.
+ */
+export declare function addInstalledModel(model: InstalledModel): Promise<void>;
+/**
+ * Remove an installed model from state.
+ *
+ * Note: These operations are not atomic. Ensure single-threaded access
+ * or implement file locking for concurrent usage scenarios.
+ */
+export declare function removeInstalledModel(modelId: string): Promise<boolean>;
+/**
+ * Get installed model info.
+ */
+export declare function getInstalledModel(modelId: string): Promise<InstalledModel | null>;
+/**
+ * Get all installed models.
+ */
+export declare function getAllInstalledModels(): Promise<InstalledModel[]>;
+/**
+ * Check if a model is installed.
+ */
+export declare function isModelInstalled(modelId: string): Promise<boolean>;
+/**
+ * Update last used timestamp for a model.
+ */
+export declare function updateModelLastUsed(modelId: string): Promise<void>;
+/**
+ * Set the active model.
+ */
+export declare function setActiveModel(modelId: string | undefined): Promise<void>;
+/**
+ * Get the active model ID.
+ */
+export declare function getActiveModelId(): Promise<string | undefined>;
+/**
+ * Get the active model info.
+ */
+export declare function getActiveModel(): Promise<InstalledModel | null>;
+/**
+ * Add a model to the download queue.
+ */
+export declare function addToDownloadQueue(modelId: string): Promise<void>;
+/**
+ * Remove a model from the download queue.
+ */
+export declare function removeFromDownloadQueue(modelId: string): Promise<void>;
+/**
+ * Get the download queue.
+ */
+export declare function getDownloadQueue(): Promise<string[]>;
+/**
+ * Sync state with actual filesystem.
+ * Removes entries for models that no longer exist on disk.
+ */
+export declare function syncStateWithFilesystem(): Promise<{
+    removed: string[];
+    kept: string[];
+}>;
+/**
+ * Get total size of all installed models.
+ */
+export declare function getTotalInstalledSize(): Promise<number>;
+/**
+ * Get count of installed models.
+ */
+export declare function getInstalledModelCount(): Promise<number>;
+/**
+ * Register a manually added model file.
+ * Used when user places a GGUF file directly in the models directory.
+ */
+export declare function registerManualModel(modelId: string, filename: string, sizeBytes: number, sha256?: string): Promise<void>;
+//# sourceMappingURL=state-manager.d.ts.map

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,46 @@ 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;
+    }
+    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
     }
   };
 }