@dexto/agent-management 1.4.0 → 1.5.0

package/dist/models/custom-models.d.ts

@@ -1,28 +1,71 @@
 /**
  * Custom Models Persistence
  *
- * Manages saved openai-compatible model configurations.
+ * Manages saved custom model configurations for openai-compatible and openrouter providers.
  * Stored in ~/.dexto/models/custom-models.json
  */
 import { z } from 'zod';
+/** Providers that support custom models */
+export declare const CUSTOM_MODEL_PROVIDERS: readonly ["openai-compatible", "openrouter", "litellm", "glama", "bedrock", "ollama", "local", "vertex"];
+export type CustomModelProvider = (typeof CUSTOM_MODEL_PROVIDERS)[number];
 /**
- * Schema for a saved openai-compatible model configuration.
+ * Schema for a saved custom model configuration.
+ * - openai-compatible: requires baseURL, optional per-model apiKey
+ * - openrouter: baseURL is auto-injected, maxInputTokens from registry
+ * - litellm: requires baseURL, uses LITELLM_API_KEY or per-model override
+ * - glama: fixed baseURL, uses GLAMA_API_KEY or per-model override
+ * - bedrock: no baseURL, uses AWS credentials from environment
+ * - ollama: optional baseURL (defaults to http://localhost:11434)
+ * - local: no baseURL, uses local GGUF files via node-llama-cpp
+ * - vertex: no baseURL, uses Google Cloud ADC
+ *
+ * TODO: For hosted deployments, API keys should be stored in a secure
+ * key management service (e.g., AWS Secrets Manager, HashiCorp Vault)
+ * rather than in the local JSON file. Current approach is suitable for
+ * local CLI usage where the file is in ~/.dexto/ (user-private).
  */
-export declare const CustomModelSchema: z.ZodObject<{
+export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     name: z.ZodString;
-    baseURL: z.ZodString;
+    provider: z.ZodDefault<z.ZodEnum<["openai-compatible", "openrouter", "litellm", "glama", "bedrock", "ollama", "local", "vertex"]>>;
+    baseURL: z.ZodOptional<z.ZodString>;
     displayName: z.ZodOptional<z.ZodString>;
     maxInputTokens: z.ZodOptional<z.ZodNumber>;
     maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    filePath: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    baseURL: string;
+    provider: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
+    filePath?: string | undefined;
+    displayName?: string | undefined;
+    maxInputTokens?: number | undefined;
+    maxOutputTokens?: number | undefined;
+}, {
+    name: string;
+    provider?: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
+    filePath?: string | undefined;
+    displayName?: string | undefined;
+    maxInputTokens?: number | undefined;
+    maxOutputTokens?: number | undefined;
+}>, {
+    name: string;
+    provider: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
+    filePath?: string | undefined;
     displayName?: string | undefined;
     maxInputTokens?: number | undefined;
     maxOutputTokens?: number | undefined;
 }, {
     name: string;
-    baseURL: string;
+    provider?: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
+    filePath?: string | undefined;
     displayName?: string | undefined;
     maxInputTokens?: number | undefined;
     maxOutputTokens?: number | undefined;

package/dist/models/custom-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom-models.d.ts","sourceRoot":"","sources":["../../src/models/custom-models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAO7D;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAmB/D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUtE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG9E"}
+{"version":3,"file":"custom-models.d.ts","sourceRoot":"","sources":["../../src/models/custom-models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,0GASzB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CxB,CAAC;AAEP,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAO7D;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAmB/D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUtE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG9E"}

package/dist/models/custom-models.js

@@ -2,12 +2,51 @@ import { z } from "zod";
 import { promises as fs } from "fs";
 import * as path from "path";
 import { getDextoGlobalPath } from "../utils/path.js";
+const CUSTOM_MODEL_PROVIDERS = [
+  "openai-compatible",
+  "openrouter",
+  "litellm",
+  "glama",
+  "bedrock",
+  "ollama",
+  "local",
+  "vertex"
+];
 const CustomModelSchema = z.object({
   name: z.string().min(1),
-  baseURL: z.string().url(),
+  provider: z.enum(CUSTOM_MODEL_PROVIDERS).default("openai-compatible"),
+  baseURL: z.string().url().optional(),
   displayName: z.string().optional(),
   maxInputTokens: z.number().int().positive().optional(),
-  maxOutputTokens: z.number().int().positive().optional()
+  maxOutputTokens: z.number().int().positive().optional(),
+  // Optional per-model API key. For openai-compatible this is the primary key source.
+  // For litellm/glama/openrouter this overrides the provider-level env var key.
+  apiKey: z.string().optional(),
+  // File path for local GGUF models. Required when provider is 'local'.
+  // Stores the absolute path to the .gguf file on disk.
+  filePath: z.string().optional()
+}).superRefine((data, ctx) => {
+  if ((data.provider === "openai-compatible" || data.provider === "litellm") && !data.baseURL) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["baseURL"],
+      message: `Base URL is required for ${data.provider} provider`
+    });
+  }
+  if (data.provider === "local" && !data.filePath) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["filePath"],
+      message: "File path is required for local provider"
+    });
+  }
+  if (data.provider === "local" && data.filePath && !data.filePath.endsWith(".gguf")) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["filePath"],
+      message: "File path must be a .gguf file"
+    });
+  }
 });
 const StorageSchema = z.object({
   version: z.literal(1),
@@ -68,6 +107,7 @@ async function writeCustomModels(models) {
   await fs.writeFile(filePath, JSON.stringify({ version: 1, models }, null, 2), "utf-8");
 }
 export {
+  CUSTOM_MODEL_PROVIDERS,
   CustomModelSchema,
   deleteCustomModel,
   getCustomModel,

package/dist/models/index.cjs

@@ -0,0 +1,89 @@
+"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 models_exports = {};
+__export(models_exports, {
+  addInstalledModel: () => import_state_manager.addInstalledModel,
+  addToDownloadQueue: () => import_state_manager.addToDownloadQueue,
+  deleteModelDirectory: () => import_path_resolver.deleteModelDirectory,
+  ensureModelDirectory: () => import_path_resolver.ensureModelDirectory,
+  ensureModelsDirectory: () => import_path_resolver.ensureModelsDirectory,
+  formatSize: () => import_path_resolver.formatSize,
+  getActiveModel: () => import_state_manager.getActiveModel,
+  getActiveModelId: () => import_state_manager.getActiveModelId,
+  getAllInstalledModels: () => import_state_manager.getAllInstalledModels,
+  getDownloadQueue: () => import_state_manager.getDownloadQueue,
+  getInstalledModel: () => import_state_manager.getInstalledModel,
+  getInstalledModelCount: () => import_state_manager.getInstalledModelCount,
+  getModelDirectory: () => import_path_resolver.getModelDirectory,
+  getModelFilePath: () => import_path_resolver.getModelFilePath,
+  getModelFileSize: () => import_path_resolver.getModelFileSize,
+  getModelStatePath: () => import_path_resolver.getModelStatePath,
+  getModelTempDirectory: () => import_path_resolver.getModelTempDirectory,
+  getModelsDirectory: () => import_path_resolver.getModelsDirectory,
+  getModelsDiskUsage: () => import_path_resolver.getModelsDiskUsage,
+  getTotalInstalledSize: () => import_state_manager.getTotalInstalledSize,
+  isModelInstalled: () => import_state_manager.isModelInstalled,
+  listModelDirectories: () => import_path_resolver.listModelDirectories,
+  loadModelState: () => import_state_manager.loadModelState,
+  modelFileExists: () => import_path_resolver.modelFileExists,
+  registerManualModel: () => import_state_manager.registerManualModel,
+  removeFromDownloadQueue: () => import_state_manager.removeFromDownloadQueue,
+  removeInstalledModel: () => import_state_manager.removeInstalledModel,
+  saveModelState: () => import_state_manager.saveModelState,
+  setActiveModel: () => import_state_manager.setActiveModel,
+  syncStateWithFilesystem: () => import_state_manager.syncStateWithFilesystem,
+  updateModelLastUsed: () => import_state_manager.updateModelLastUsed
+});
+module.exports = __toCommonJS(models_exports);
+var import_path_resolver = require("./path-resolver.js");
+var import_state_manager = require("./state-manager.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addInstalledModel,
+  addToDownloadQueue,
+  deleteModelDirectory,
+  ensureModelDirectory,
+  ensureModelsDirectory,
+  formatSize,
+  getActiveModel,
+  getActiveModelId,
+  getAllInstalledModels,
+  getDownloadQueue,
+  getInstalledModel,
+  getInstalledModelCount,
+  getModelDirectory,
+  getModelFilePath,
+  getModelFileSize,
+  getModelStatePath,
+  getModelTempDirectory,
+  getModelsDirectory,
+  getModelsDiskUsage,
+  getTotalInstalledSize,
+  isModelInstalled,
+  listModelDirectories,
+  loadModelState,
+  modelFileExists,
+  registerManualModel,
+  removeFromDownloadQueue,
+  removeInstalledModel,
+  saveModelState,
+  setActiveModel,
+  syncStateWithFilesystem,
+  updateModelLastUsed
+});

package/dist/models/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Model management for local GGUF models.
+ *
+ * This module handles:
+ * - Path resolution for ~/.dexto/models/
+ * - State tracking for installed models
+ * - Download queue management
+ */
+export { getModelsDirectory, getModelFilePath, getModelDirectory, getModelStatePath, getModelTempDirectory, ensureModelsDirectory, ensureModelDirectory, modelFileExists, getModelFileSize, deleteModelDirectory, listModelDirectories, getModelsDiskUsage, formatSize, } from './path-resolver.js';
+export { type ModelSource, type InstalledModel, type ModelState, loadModelState, saveModelState, addInstalledModel, removeInstalledModel, getInstalledModel, getAllInstalledModels, isModelInstalled, updateModelLastUsed, setActiveModel, getActiveModelId, getActiveModel, addToDownloadQueue, removeFromDownloadQueue, getDownloadQueue, syncStateWithFilesystem, getTotalInstalledSize, getInstalledModelCount, registerManualModel, } from './state-manager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACH,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,GACb,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACH,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/models/index.js

@@ -0,0 +1,68 @@
+import {
+  getModelsDirectory,
+  getModelFilePath,
+  getModelDirectory,
+  getModelStatePath,
+  getModelTempDirectory,
+  ensureModelsDirectory,
+  ensureModelDirectory,
+  modelFileExists,
+  getModelFileSize,
+  deleteModelDirectory,
+  listModelDirectories,
+  getModelsDiskUsage,
+  formatSize
+} from "./path-resolver.js";
+import {
+  loadModelState,
+  saveModelState,
+  addInstalledModel,
+  removeInstalledModel,
+  getInstalledModel,
+  getAllInstalledModels,
+  isModelInstalled,
+  updateModelLastUsed,
+  setActiveModel,
+  getActiveModelId,
+  getActiveModel,
+  addToDownloadQueue,
+  removeFromDownloadQueue,
+  getDownloadQueue,
+  syncStateWithFilesystem,
+  getTotalInstalledSize,
+  getInstalledModelCount,
+  registerManualModel
+} from "./state-manager.js";
+export {
+  addInstalledModel,
+  addToDownloadQueue,
+  deleteModelDirectory,
+  ensureModelDirectory,
+  ensureModelsDirectory,
+  formatSize,
+  getActiveModel,
+  getActiveModelId,
+  getAllInstalledModels,
+  getDownloadQueue,
+  getInstalledModel,
+  getInstalledModelCount,
+  getModelDirectory,
+  getModelFilePath,
+  getModelFileSize,
+  getModelStatePath,
+  getModelTempDirectory,
+  getModelsDirectory,
+  getModelsDiskUsage,
+  getTotalInstalledSize,
+  isModelInstalled,
+  listModelDirectories,
+  loadModelState,
+  modelFileExists,
+  registerManualModel,
+  removeFromDownloadQueue,
+  removeInstalledModel,
+  saveModelState,
+  setActiveModel,
+  syncStateWithFilesystem,
+  updateModelLastUsed
+};

package/dist/models/path-resolver.cjs

@@ -0,0 +1,154 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var path_resolver_exports = {};
+__export(path_resolver_exports, {
+  deleteModelDirectory: () => deleteModelDirectory,
+  ensureModelDirectory: () => ensureModelDirectory,
+  ensureModelsDirectory: () => ensureModelsDirectory,
+  formatSize: () => formatSize,
+  getModelDirectory: () => getModelDirectory,
+  getModelFilePath: () => getModelFilePath,
+  getModelFileSize: () => getModelFileSize,
+  getModelStatePath: () => getModelStatePath,
+  getModelTempDirectory: () => getModelTempDirectory,
+  getModelsDirectory: () => getModelsDirectory,
+  getModelsDiskUsage: () => getModelsDiskUsage,
+  listModelDirectories: () => listModelDirectories,
+  modelFileExists: () => modelFileExists
+});
+module.exports = __toCommonJS(path_resolver_exports);
+var path = __toESM(require("path"), 1);
+var import_fs = require("fs");
+var import_os = require("os");
+function getModelsDirectory() {
+  return path.join((0, import_os.homedir)(), ".dexto", "models");
+}
+function getModelFilePath(modelId, filename) {
+  return path.join(getModelsDirectory(), modelId, filename);
+}
+function getModelDirectory(modelId) {
+  return path.join(getModelsDirectory(), modelId);
+}
+function getModelStatePath() {
+  return path.join(getModelsDirectory(), "state.json");
+}
+function getModelTempDirectory() {
+  return path.join(getModelsDirectory(), ".tmp");
+}
+async function ensureModelsDirectory() {
+  const modelsDir = getModelsDirectory();
+  const tempDir = getModelTempDirectory();
+  await import_fs.promises.mkdir(modelsDir, { recursive: true });
+  await import_fs.promises.mkdir(tempDir, { recursive: true });
+}
+async function ensureModelDirectory(modelId) {
+  const modelDir = getModelDirectory(modelId);
+  await import_fs.promises.mkdir(modelDir, { recursive: true });
+  return modelDir;
+}
+async function modelFileExists(modelId, filename) {
+  const filePath = getModelFilePath(modelId, filename);
+  try {
+    await import_fs.promises.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function getModelFileSize(modelId, filename) {
+  const filePath = getModelFilePath(modelId, filename);
+  try {
+    const stats = await import_fs.promises.stat(filePath);
+    return stats.size;
+  } catch {
+    return null;
+  }
+}
+async function deleteModelDirectory(modelId) {
+  const modelDir = getModelDirectory(modelId);
+  try {
+    await import_fs.promises.rm(modelDir, { recursive: true, force: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function listModelDirectories() {
+  const modelsDir = getModelsDirectory();
+  try {
+    const entries = await import_fs.promises.readdir(modelsDir, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory() && !e.name.startsWith(".")).map((e) => e.name);
+  } catch {
+    return [];
+  }
+}
+async function getModelsDiskUsage() {
+  const modelsDir = getModelsDirectory();
+  async function getDirSize(dir) {
+    let size = 0;
+    try {
+      const entries = await import_fs.promises.readdir(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const entryPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          size += await getDirSize(entryPath);
+        } else if (entry.isFile()) {
+          const stats = await import_fs.promises.stat(entryPath);
+          size += stats.size;
+        }
+      }
+    } catch {
+    }
+    return size;
+  }
+  return getDirSize(modelsDir);
+}
+function formatSize(bytes) {
+  if (bytes === 0) return "0 B";
+  const units = ["B", "KB", "MB", "GB", "TB"];
+  const k = 1024;
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${(bytes / Math.pow(k, i)).toFixed(1)} ${units[i]}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  deleteModelDirectory,
+  ensureModelDirectory,
+  ensureModelsDirectory,
+  formatSize,
+  getModelDirectory,
+  getModelFilePath,
+  getModelFileSize,
+  getModelStatePath,
+  getModelTempDirectory,
+  getModelsDirectory,
+  getModelsDiskUsage,
+  listModelDirectories,
+  modelFileExists
+});

package/dist/models/path-resolver.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Path resolver for local model storage.
+ *
+ * Models are stored globally at ~/.dexto/models/ to be shared across projects.
+ * This avoids duplicating large model files for each project.
+ */
+/**
+ * Get the base models directory path.
+ * Always returns global path: ~/.dexto/models/
+ */
+export declare function getModelsDirectory(): string;
+/**
+ * Get the path to a specific model file.
+ * @param modelId Model ID from registry
+ * @param filename GGUF filename
+ */
+export declare function getModelFilePath(modelId: string, filename: string): string;
+/**
+ * Get the path to a model's directory.
+ * @param modelId Model ID from registry
+ */
+export declare function getModelDirectory(modelId: string): string;
+/**
+ * Get the path to the model state file.
+ * Stores download status, hashes, and usage metadata.
+ */
+export declare function getModelStatePath(): string;
+/**
+ * Get the path to the model download temp directory.
+ * Used for in-progress downloads.
+ */
+export declare function getModelTempDirectory(): string;
+/**
+ * Ensure the models directory and subdirectories exist.
+ */
+export declare function ensureModelsDirectory(): Promise<void>;
+/**
+ * Ensure a specific model's directory exists.
+ * @param modelId Model ID from registry
+ */
+export declare function ensureModelDirectory(modelId: string): Promise<string>;
+/**
+ * Check if a model file exists at the expected path.
+ * @param modelId Model ID from registry
+ * @param filename GGUF filename
+ */
+export declare function modelFileExists(modelId: string, filename: string): Promise<boolean>;
+/**
+ * Get file size of an installed model.
+ * @param modelId Model ID from registry
+ * @param filename GGUF filename
+ * @returns File size in bytes, or null if file doesn't exist
+ */
+export declare function getModelFileSize(modelId: string, filename: string): Promise<number | null>;
+/**
+ * Delete a model's directory and all its files.
+ * @param modelId Model ID to delete
+ * @returns True if deleted, false if not found
+ */
+export declare function deleteModelDirectory(modelId: string): Promise<boolean>;
+/**
+ * List all model directories in the models folder.
+ * @returns Array of model IDs (directory names)
+ */
+export declare function listModelDirectories(): Promise<string[]>;
+/**
+ * Get disk usage statistics for the models directory.
+ * @returns Total bytes used by models, or 0 if directory doesn't exist
+ */
+export declare function getModelsDiskUsage(): Promise<number>;
+/**
+ * Format bytes to human-readable string.
+ * @param bytes Number of bytes
+ * @returns Formatted string (e.g., "4.5 GB")
+ */
+export declare function formatSize(bytes: number): string;
+//# sourceMappingURL=path-resolver.d.ts.map

package/dist/models/path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../src/models/path-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3D;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3E;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQzF;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQhG;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ5E;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ9D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAuB1D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQhD"}

package/dist/models/path-resolver.js

@@ -0,0 +1,108 @@
+import * as path from "path";
+import { promises as fs } from "fs";
+import { homedir } from "os";
+function getModelsDirectory() {
+  return path.join(homedir(), ".dexto", "models");
+}
+function getModelFilePath(modelId, filename) {
+  return path.join(getModelsDirectory(), modelId, filename);
+}
+function getModelDirectory(modelId) {
+  return path.join(getModelsDirectory(), modelId);
+}
+function getModelStatePath() {
+  return path.join(getModelsDirectory(), "state.json");
+}
+function getModelTempDirectory() {
+  return path.join(getModelsDirectory(), ".tmp");
+}
+async function ensureModelsDirectory() {
+  const modelsDir = getModelsDirectory();
+  const tempDir = getModelTempDirectory();
+  await fs.mkdir(modelsDir, { recursive: true });
+  await fs.mkdir(tempDir, { recursive: true });
+}
+async function ensureModelDirectory(modelId) {
+  const modelDir = getModelDirectory(modelId);
+  await fs.mkdir(modelDir, { recursive: true });
+  return modelDir;
+}
+async function modelFileExists(modelId, filename) {
+  const filePath = getModelFilePath(modelId, filename);
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function getModelFileSize(modelId, filename) {
+  const filePath = getModelFilePath(modelId, filename);
+  try {
+    const stats = await fs.stat(filePath);
+    return stats.size;
+  } catch {
+    return null;
+  }
+}
+async function deleteModelDirectory(modelId) {
+  const modelDir = getModelDirectory(modelId);
+  try {
+    await fs.rm(modelDir, { recursive: true, force: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function listModelDirectories() {
+  const modelsDir = getModelsDirectory();
+  try {
+    const entries = await fs.readdir(modelsDir, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory() && !e.name.startsWith(".")).map((e) => e.name);
+  } catch {
+    return [];
+  }
+}
+async function getModelsDiskUsage() {
+  const modelsDir = getModelsDirectory();
+  async function getDirSize(dir) {
+    let size = 0;
+    try {
+      const entries = await fs.readdir(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const entryPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          size += await getDirSize(entryPath);
+        } else if (entry.isFile()) {
+          const stats = await fs.stat(entryPath);
+          size += stats.size;
+        }
+      }
+    } catch {
+    }
+    return size;
+  }
+  return getDirSize(modelsDir);
+}
+function formatSize(bytes) {
+  if (bytes === 0) return "0 B";
+  const units = ["B", "KB", "MB", "GB", "TB"];
+  const k = 1024;
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${(bytes / Math.pow(k, i)).toFixed(1)} ${units[i]}`;
+}
+export {
+  deleteModelDirectory,
+  ensureModelDirectory,
+  ensureModelsDirectory,
+  formatSize,
+  getModelDirectory,
+  getModelFilePath,
+  getModelFileSize,
+  getModelStatePath,
+  getModelTempDirectory,
+  getModelsDirectory,
+  getModelsDiskUsage,
+  listModelDirectories,
+  modelFileExists
+};