volute 0.30.1 → 0.32.0

package/dist/{archive-WWDBWYN2.js → archive-INXYFVCW.js}

@@ -5,8 +5,9 @@ import {
   extractArchive,
   isHomeOnlyArchive,
   readManifest
-} from "./chunk-DTC6EH5I.js";
-import "./chunk-HHTXM4JT.js";
+} from "./chunk-I5KY25PQ.js";
+import "./chunk-LRCG2JLP.js";
+import "./chunk-RPZZSXV3.js";
 import "./chunk-K3NQKI34.js";
 export {
   addHistoryToArchive,

package/dist/auth-6DMGES3I.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import {
+  approveUser,
+  changePassword,
+  countAdmins,
+  createUser,
+  deleteMindUser,
+  deleteUser,
+  getOrCreateMindUser,
+  getOrCreateSystemUser,
+  getUser,
+  getUserByUsername,
+  listPendingUsers,
+  listUsers,
+  listUsersByType,
+  setUserRole,
+  syncMindProfile,
+  updateUserProfile,
+  verifyUser
+} from "./chunk-TDRYEPH4.js";
+import "./chunk-QZANELPX.js";
+import "./chunk-YUIHSKR6.js";
+import "./chunk-LRCG2JLP.js";
+import "./chunk-RPZZSXV3.js";
+import "./chunk-K3NQKI34.js";
+export {
+  approveUser,
+  changePassword,
+  countAdmins,
+  createUser,
+  deleteMindUser,
+  deleteUser,
+  getOrCreateMindUser,
+  getOrCreateSystemUser,
+  getUser,
+  getUserByUsername,
+  listPendingUsers,
+  listUsers,
+  listUsersByType,
+  setUserRole,
+  syncMindProfile,
+  updateUserProfile,
+  verifyUser
+};

package/dist/{bridge-RO37CUFM.js → bridge-BVCBTGPF.js}

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
-import {
-  daemonFetch
-} from "./chunk-EFVHR7KH.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
-import "./chunk-HHTXM4JT.js";
+import {
+  daemonFetch
+} from "./chunk-UKVWJRKN.js";
+import "./chunk-LRCG2JLP.js";
+import "./chunk-RPZZSXV3.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/chat/bridge.ts

package/dist/{chat-TCUNPFGO.js → chat-XT4OBJBU.js}

@@ -7,28 +7,28 @@ async function run(args) {
   const subArgs = args.slice(1);
   switch (subcommand) {
     case "send":
-      await import("./send-OAN3RYYY.js").then((m) => m.run(subArgs));
+      await import("./send-3MI36LEF.js").then((m) => m.run(subArgs));
       break;
     case "list":
-      await import("./list-Q6O7FGAN.js").then((m) => m.run(subArgs));
+      await import("./list-DW2VRTOZ.js").then((m) => m.run(subArgs));
       break;
     case "read":
-      await import("./read-WQMPTSN2.js").then((m) => m.run(subArgs));
+      await import("./read-5AMJRO3D.js").then((m) => m.run(subArgs));
       break;
     case "create":
-      await import("./create-JTLS7GX3.js").then((m) => m.run(subArgs));
+      await import("./create-RNLNCORE.js").then((m) => m.run(subArgs));
       break;
     case "bridge":
-      await import("./bridge-RO37CUFM.js").then((m) => m.run(subArgs));
+      await import("./bridge-BVCBTGPF.js").then((m) => m.run(subArgs));
       break;
     case "files":
-      await import("./files-4VEJDASH.js").then((m) => m.run(subArgs));
+      await import("./files-EAMPO2SJ.js").then((m) => m.run(subArgs));
       break;
     case "accept":
-      await import("./accept-E3PAH3QJ.js").then((m) => m.run(subArgs));
+      await import("./accept-74M7I4RZ.js").then((m) => m.run(subArgs));
       break;
     case "reject":
-      await import("./reject-2HZOJEIJ.js").then((m) => m.run(subArgs));
+      await import("./reject-33HEZMZ4.js").then((m) => m.run(subArgs));
       break;
     case "--help":
     case "-h":

package/dist/{chunk-P7VFDSSG.js → chunk-2FLJ63GU.js}

@@ -5,10 +5,10 @@ import {
   pollHealthDown,
   readDaemonConfig,
   stopService
-} from "./chunk-FXHXHI2A.js";
+} from "./chunk-LSGWR54X.js";
 import {
   voluteSystemDir
-} from "./chunk-HHTXM4JT.js";
+} from "./chunk-LRCG2JLP.js";
 
 // src/commands/down.ts
 import { existsSync, readFileSync, unlinkSync } from "fs";

package/dist/{chunk-ZWKTUQEL.js → chunk-2NGTS5UU.js}

@@ -2,7 +2,7 @@
 import {
   stateDir,
   voluteSystemDir
-} from "./chunk-HHTXM4JT.js";
+} from "./chunk-LRCG2JLP.js";
 
 // src/lib/env.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";

package/dist/{chunk-JGFRDMR6.js → chunk-ALEF47VT.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   stateDir
-} from "./chunk-HHTXM4JT.js";
+} from "./chunk-LRCG2JLP.js";
 
 // src/lib/file-sharing.ts
 import { randomBytes } from "crypto";

package/dist/{chunk-MDPCSXZ4.js → chunk-D5G5YOPL.js}

@@ -5,16 +5,18 @@ import {
 import {
   exec,
   gitExec
-} from "./chunk-CVH6Y2YG.js";
+} from "./chunk-LGB6JBHI.js";
 import {
   readGlobalConfig,
   writeGlobalConfig
-} from "./chunk-7D47T4RB.js";
+} from "./chunk-TSXLLQZW.js";
 import {
   getDb,
-  sharedSkills,
   voluteHome
-} from "./chunk-HHTXM4JT.js";
+} from "./chunk-LRCG2JLP.js";
+import {
+  sharedSkills
+} from "./chunk-RPZZSXV3.js";
 
 // src/lib/skills.ts
 import { createHash } from "crypto";
@@ -32,7 +34,7 @@ import { basename, dirname, join, resolve } from "path";
 import { eq, sql } from "drizzle-orm";
 var VALID_SKILL_ID = /^[a-zA-Z0-9_-]+$/;
 var SEED_SKILLS = ["orientation", "memory"];
-var STANDARD_SKILLS = ["volute-mind", "memory", "sessions", "dreaming", "shared-files"];
+var STANDARD_SKILLS = ["volute-mind", "memory", "dreaming", "shared-files"];
 function getStandardSkillsWithExtensions() {
   const config = readGlobalConfig();
   if (config.defaultSkills) return [...config.defaultSkills];
@@ -42,7 +44,7 @@ async function initDefaultSkills() {
   const config = readGlobalConfig();
   let extensionSkills = [];
   try {
-    const { getExtensionStandardSkills } = await import("./extensions-ECO4RPFQ.js");
+    const { getExtensionStandardSkills } = await import("./extensions-GDYWQXC4.js");
     extensionSkills = getExtensionStandardSkills();
   } catch (err) {
     logger_default.warn("failed to load extension standard skills during init", logger_default.errorData(err));
@@ -66,15 +68,43 @@ function sharedSkillsDir() {
 }
 function parseSkillMd(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
-  if (!match) return { name: "", description: "", npmDependencies: [] };
+  if (!match) return { name: "", description: "", npmDependencies: [], hooks: {}, bin: null };
   const frontmatter = match[1];
   const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
   const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
   const depsMatch = frontmatter.match(/^\s*npm-dependencies:\s*(.+)$/m);
+  const binMatch = frontmatter.match(/^\s*bin:\s*(.+)$/m);
+  const hooks = {};
+  const lines = frontmatter.split("\n");
+  let inHooks = false;
+  let hooksIndent = -1;
+  for (const line of lines) {
+    if (!line.trim()) continue;
+    const hooksStart = line.match(/^(\s+)hooks:\s*$/);
+    if (hooksStart) {
+      inHooks = true;
+      hooksIndent = hooksStart[1].length;
+      continue;
+    }
+    if (inHooks) {
+      const lineIndentMatch = line.match(/^(\s*)/);
+      const lineIndent = lineIndentMatch ? lineIndentMatch[1].length : 0;
+      if (lineIndent <= hooksIndent) {
+        inHooks = false;
+        continue;
+      }
+      const hookMatch = line.match(/^\s+([a-z0-9-]+):\s*(.+)$/);
+      if (hookMatch) {
+        hooks[hookMatch[1]] = hookMatch[2].trim();
+      }
+    }
+  }
   return {
     name: nameMatch?.[1].trim() ?? "",
     description: descMatch?.[1].trim() ?? "",
-    npmDependencies: depsMatch ? depsMatch[1].trim().split(/[\s,]+/).filter(Boolean) : []
+    npmDependencies: depsMatch ? depsMatch[1].trim().split(/[\s,]+/).filter(Boolean) : [],
+    hooks,
+    bin: binMatch?.[1].trim() ?? null
   };
 }
 async function listSharedSkills() {
@@ -128,8 +158,24 @@ async function removeSharedSkill(id) {
   const dir = join(sharedSkillsDir(), id);
   if (existsSync(dir)) rmSync(dir, { recursive: true });
 }
+var TEMPLATE_SKILLS_DIR = {
+  claude: ".claude/skills",
+  pi: ".pi/skills",
+  codex: ".agents/skills"
+};
 function mindSkillsDir(dir) {
-  return resolve(dir, "home", ".claude", "skills");
+  const home = resolve(dir, "home");
+  let subdir = TEMPLATE_SKILLS_DIR.claude;
+  if (existsSync(join(home, "AGENTS.md"))) {
+    subdir = TEMPLATE_SKILLS_DIR.codex;
+  } else if (existsSync(join(home, "MINDS.md"))) {
+    subdir = TEMPLATE_SKILLS_DIR.pi;
+  }
+  return resolve(home, subdir);
+}
+function relSkillsPath(dir) {
+  const home = resolve(dir, "home");
+  return join("home", mindSkillsDir(dir).slice(home.length + 1));
 }
 function readUpstream(skillDir) {
   const upstreamPath = join(skillDir, ".upstream.json");
@@ -172,12 +218,21 @@ async function installSkill(_mindName, dir, skillId) {
       }
     }
   }
+  if (existsSync(skillMdPath)) {
+    const { hooks, bin } = parseSkillMd(readFileSync(skillMdPath, "utf-8"));
+    installHookShims(dir, skillId, hooks);
+    if (bin) installBinShim(dir, skillId, bin);
+  }
   let installNotes = null;
   const installMdPath = join(destDir, "references", "INSTALL.md");
   if (existsSync(installMdPath)) {
     installNotes = readFileSync(installMdPath, "utf-8");
   }
-  await gitExec(["add", join("home", ".claude", "skills", skillId)], { cwd: dir });
+  await gitExec(["add", join(relSkillsPath(dir), skillId)], { cwd: dir });
+  await gitExec(["add", join("home", ".local", "hooks")], { cwd: dir }).catch(() => {
+  });
+  await gitExec(["add", join("home", ".local", "bin")], { cwd: dir }).catch(() => {
+  });
   if (npmInstalled.length > 0) {
     await gitExec(["add", "package.json", "package-lock.json"], { cwd: dir });
   }
@@ -190,7 +245,7 @@ async function installSkill(_mindName, dir, skillId) {
   };
   writeFileSync(join(destDir, ".upstream.json"), `${JSON.stringify(upstream, null, 2)}
 `);
-  await gitExec(["add", join("home", ".claude", "skills", skillId, ".upstream.json")], {
+  await gitExec(["add", join(relSkillsPath(dir), skillId, ".upstream.json")], {
     cwd: dir
   });
   await gitExec(["commit", "--amend", "--no-edit"], { cwd: dir });
@@ -200,8 +255,18 @@ async function uninstallSkill(_mindName, dir, skillId) {
   validateSkillId(skillId);
   const skillDir = join(mindSkillsDir(dir), skillId);
   if (!existsSync(skillDir)) throw new Error(`Skill not installed: ${skillId}`);
+  removeHookShims(dir, skillId);
+  const skillMdPath = join(skillDir, "SKILL.md");
+  if (existsSync(skillMdPath)) {
+    const { bin } = parseSkillMd(readFileSync(skillMdPath, "utf-8"));
+    if (bin) removeBinShim(dir, bin);
+  }
   rmSync(skillDir, { recursive: true });
-  await gitExec(["add", join("home", ".claude", "skills", skillId)], { cwd: dir });
+  await gitExec(["add", join(relSkillsPath(dir), skillId)], { cwd: dir });
+  await gitExec(["add", join("home", ".local", "hooks")], { cwd: dir }).catch(() => {
+  });
+  await gitExec(["add", join("home", ".local", "bin")], { cwd: dir }).catch(() => {
+  });
   await gitExec(["commit", "-m", `Uninstall skill: ${skillId}`], { cwd: dir });
 }
 async function updateSkill(_mindName, dir, skillId) {
@@ -217,7 +282,7 @@ async function updateSkill(_mindName, dir, skillId) {
   }
   const sourceDir = join(sharedSkillsDir(), upstream.source);
   if (!existsSync(sourceDir)) throw new Error(`Shared skill files missing: ${upstream.source}`);
-  const relSkillPath = join("home", ".claude", "skills", skillId);
+  const relSkillPath = join(relSkillsPath(dir), skillId);
   const currentFiles = listFilesRecursive(skillDir).filter((f) => f !== ".upstream.json");
   const newFiles = listFilesRecursive(sourceDir).filter((f) => f !== ".upstream.json");
   const allFiles = [.../* @__PURE__ */ new Set([...currentFiles, ...newFiles])];
@@ -241,7 +306,9 @@ async function updateSkill(_mindName, dir, skillId) {
         try {
           baseContent2 = await gitExec(
             ["show", `${upstream.baseCommit}:${join(relSkillPath, file)}`],
-            { cwd: dir }
+            {
+              cwd: dir
+            }
           );
         } catch {
           continue;
@@ -256,7 +323,9 @@ async function updateSkill(_mindName, dir, skillId) {
       try {
         baseContent = await gitExec(
           ["show", `${upstream.baseCommit}:${join(relSkillPath, file)}`],
-          { cwd: dir }
+          {
+            cwd: dir
+          }
         );
       } catch {
         baseContent = "";
@@ -352,6 +421,77 @@ async function publishSkill(mindName, dir, skillId) {
   if (!existsSync(skillMdPath)) throw new Error(`SKILL.md not found in ${skillId}`);
   return importSkillFromDir(skillDir, mindName);
 }
+function shimContent(skillId, scriptPath, skillsSubdir) {
+  const ext = scriptPath.split(".").pop() ?? "sh";
+  const skillScriptPath = `${skillsSubdir}/${skillId}/${scriptPath}`;
+  if (ext === "ts") {
+    return `#!/bin/bash
+exec node --import tsx ${skillScriptPath} "$@"
+`;
+  }
+  if (ext === "js") {
+    return `#!/bin/bash
+exec node ${skillScriptPath} "$@"
+`;
+  }
+  return `#!/bin/bash
+exec bash ${skillScriptPath} "$@"
+`;
+}
+function installHookShims(dir, skillId, hooks) {
+  const home = resolve(dir, "home");
+  const skillsSubdir = mindSkillsDir(dir).slice(home.length + 1);
+  for (const [event, scriptPath] of Object.entries(hooks)) {
+    const eventDir = join(dir, "home", ".local", "hooks", event);
+    mkdirSync(eventDir, { recursive: true });
+    const shimPath = join(eventDir, `50-${skillId}.sh`);
+    const content = shimContent(skillId, scriptPath, skillsSubdir);
+    writeFileSync(shimPath, content, { mode: 493 });
+  }
+}
+function removeHookShims(dir, skillId) {
+  const hooksBase = join(dir, "home", ".local", "hooks");
+  if (!existsSync(hooksBase)) return;
+  for (const eventDir of readdirSync(hooksBase, { withFileTypes: true })) {
+    if (!eventDir.isDirectory()) continue;
+    const shimPath = join(hooksBase, eventDir.name, `50-${skillId}.sh`);
+    if (existsSync(shimPath)) rmSync(shimPath);
+  }
+}
+function binShimContent(skillId, scriptPath, skillsSubdir) {
+  const skillScriptPath = `${skillsSubdir}/${skillId}/${scriptPath}`;
+  const ext = scriptPath.split(".").pop() ?? "sh";
+  if (ext === "ts") {
+    return `#!/bin/bash
+exec node --import tsx ${skillScriptPath} "$@"
+`;
+  }
+  if (ext === "js") {
+    return `#!/bin/bash
+exec node ${skillScriptPath} "$@"
+`;
+  }
+  return `#!/bin/bash
+exec bash ${skillScriptPath} "$@"
+`;
+}
+function binCommandName(scriptPath) {
+  return basename(scriptPath).replace(/\.[^.]+$/, "");
+}
+function installBinShim(dir, skillId, scriptPath) {
+  const home = resolve(dir, "home");
+  const skillsSubdir = mindSkillsDir(dir).slice(home.length + 1);
+  const binDir = join(dir, "home", ".local", "bin");
+  mkdirSync(binDir, { recursive: true });
+  const cmdName = binCommandName(scriptPath);
+  const shimPath = join(binDir, cmdName);
+  writeFileSync(shimPath, binShimContent(skillId, scriptPath, skillsSubdir), { mode: 493 });
+}
+function removeBinShim(dir, scriptPath) {
+  const cmdName = binCommandName(scriptPath);
+  const shimPath = join(dir, "home", ".local", "bin", cmdName);
+  if (existsSync(shimPath)) rmSync(shimPath);
+}
 function listFilesRecursive(dir, prefix = "") {
   const results = [];
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
@@ -420,16 +560,24 @@ export {
   getStandardSkillsWithExtensions,
   initDefaultSkills,
   sharedSkillsDir,
+  parseSkillMd,
   listSharedSkills,
   getSharedSkill,
   importSkillFromDir,
   removeSharedSkill,
+  mindSkillsDir,
+  readUpstream,
   installSkill,
   uninstallSkill,
   updateSkill,
   listMindSkills,
   publishSkill,
+  installHookShims,
+  removeHookShims,
+  installBinShim,
+  removeBinShim,
   listFilesRecursive,
+  findSkillsRoot,
   hashSkillDir,
   syncBuiltinSkills
 };

package/dist/{chunk-VGWJSNHS.js → chunk-G53F3JA4.js}

@@ -1,10 +1,5 @@
 #!/usr/bin/env node
 
-// src/lib/template-hash.ts
-import { createHash } from "crypto";
-import { existsSync as existsSync2, readFileSync as readFileSync2, rmSync as rmSync2 } from "fs";
-import { resolve as resolve2 } from "path";
-
 // src/lib/template.ts
 import {
   cpSync,
@@ -110,39 +105,10 @@ function listFiles(dir) {
   return results;
 }
 
-// src/lib/template-hash.ts
-var hashCache = /* @__PURE__ */ new Map();
-function computeTemplateHash(templateName) {
-  const cached = hashCache.get(templateName);
-  if (cached) return cached;
-  const templatesRoot = findTemplatesRoot();
-  const baseDir = resolve2(templatesRoot, "_base");
-  const templateDir = resolve2(templatesRoot, templateName);
-  if (!existsSync2(baseDir)) throw new Error(`Base template not found: ${baseDir}`);
-  if (!existsSync2(templateDir)) throw new Error(`Template not found: ${templateName}`);
-  const { composedDir } = composeTemplate(templatesRoot, templateName);
-  try {
-    const files = listFiles(composedDir).filter((f) => !f.startsWith(".init/") && !f.startsWith(".init\\")).sort();
-    const hash = createHash("sha256");
-    for (const file of files) {
-      const content = readFileSync2(resolve2(composedDir, file));
-      hash.update(file);
-      hash.update("\0");
-      hash.update(content);
-    }
-    const result = hash.digest("hex");
-    hashCache.set(templateName, result);
-    return result;
-  } finally {
-    rmSync2(composedDir, { recursive: true, force: true });
-  }
-}
-
 export {
   findTemplatesRoot,
   composeTemplate,
   copyTemplateToDir,
   applyInitFiles,
-  listFiles,
-  computeTemplateHash
+  listFiles
 };

package/dist/{chunk-A6TUJJ3L.js → chunk-G6BSYHPK.js}

@@ -6,11 +6,11 @@ function slugify(text) {
 }
 function buildVoluteSlug(opts) {
   if (opts.convType === "channel" && opts.convName) {
-    return `volute:#${opts.convName}`;
+    return `#${opts.convName}`;
   }
   const other = opts.participants.find((p) => p.username !== opts.mindUsername);
   const otherSlug = other ? slugify(other.username) : "";
-  return otherSlug ? `volute:@${otherSlug}` : `volute:${opts.conversationId}`;
+  return otherSlug ? `@${otherSlug}` : opts.conversationId;
 }
 
 export {

package/dist/{chunk-DTC6EH5I.js → chunk-I5KY25PQ.js}

@@ -2,7 +2,7 @@
 import {
   mindDir,
   stateDir
-} from "./chunk-HHTXM4JT.js";
+} from "./chunk-LRCG2JLP.js";
 
 // src/lib/archive.ts
 import { execFileSync } from "child_process";
@@ -91,12 +91,6 @@ function createExportArchive(options) {
       }
     }
   }
-  if (existsSync(state)) {
-    const channelsPath = resolve(state, "channels.json");
-    if (existsSync(channelsPath)) {
-      zip.addFile("state/channels.json", readFileSync(channelsPath));
-    }
-  }
   if (includeEnv && existsSync(state)) {
     const envPath = resolve(state, "env.json");
     if (existsSync(envPath)) {
@@ -184,14 +178,12 @@ function extractArchive(archivePath, destDir) {
     mkdirSync(resolve(destPath, ".."), { recursive: true });
     writeFileSync(destPath, entry.getData());
   }
-  const channelsJson = resolve(extractedStateDir, "channels.json");
   const envJson = resolve(extractedStateDir, "env.json");
   const historyJsonl = resolve(normalizedDestDir, "history.jsonl");
   const sessionsDir = resolve(normalizedDestDir, "sessions");
   return {
     manifest,
     mindDir: extractedMindDir,
-    channelsJson: existsSync(channelsJson) ? channelsJson : null,
     envJson: existsSync(envJson) ? envJson : null,
     historyJsonl: existsSync(historyJsonl) ? historyJsonl : null,
     sessionsDir: existsSync(sessionsDir) ? sessionsDir : null

package/dist/{chunk-NSBFETWP.js → chunk-IYDIE3HG.js}

@@ -5,36 +5,15 @@ import {
 import {
   readGlobalConfig,
   writeGlobalConfig
-} from "./chunk-7D47T4RB.js";
+} from "./chunk-TSXLLQZW.js";
 
 // src/lib/ai-service.ts
-import {
-  complete,
-  getEnvApiKey,
-  getModel,
-  getModels,
-  getOAuthApiKey,
-  getProviders
-} from "@mariozechner/pi-ai";
+import { complete, getEnvApiKey, getModel, getModels, getProviders } from "@mariozechner/pi-ai";
+import { getOAuthApiKey } from "@mariozechner/pi-ai/oauth";
 var aiLog = logger_default.child("ai-service");
 function getAiConfig() {
   const config = readGlobalConfig();
-  if (!config.ai) return null;
-  const ai = config.ai;
-  if ("provider" in ai && !("providers" in ai)) {
-    const old = ai;
-    const migrated = {
-      providers: {
-        [old.provider]: {
-          ...old.apiKey ? { apiKey: old.apiKey } : {},
-          ...old.oauth ? { oauth: old.oauth } : {}
-        }
-      }
-    };
-    writeGlobalConfig({ ...config, ai: migrated });
-    return migrated;
-  }
-  return config.ai;
+  return config.ai ?? null;
 }
 function saveProviderConfig(providerId, providerConfig) {
   const ai = getAiConfig() ?? { providers: {} };
@@ -78,6 +57,47 @@ function getConfiguredProviders() {
 function isAiConfigured() {
   return getEnabledModels().length > 0;
 }
+function getUtilityModel() {
+  const ai = getAiConfig();
+  return ai?.utilityModel;
+}
+function setUtilityModel(modelId) {
+  const ai = getAiConfig() ?? { providers: {} };
+  ai.utilityModel = modelId;
+  const config = readGlobalConfig();
+  writeGlobalConfig({ ...config, ai });
+}
+async function aiCompleteUtility(systemPrompt, userMessage) {
+  const utilityModel = getUtilityModel();
+  return aiComplete(systemPrompt, userMessage, utilityModel);
+}
+function templateForProvider(provider) {
+  if (provider === "anthropic") return "claude";
+  if (provider === "openai-codex") return "codex";
+  return "pi";
+}
+function resolveTemplate(modelId) {
+  if (!modelId) {
+    const enabled = getEnabledModels();
+    if (enabled.length > 0) {
+      const model2 = findModel(enabled[0]);
+      if (model2) return templateForProvider(model2.provider);
+    }
+    const providers = getConfiguredProviders();
+    if (providers.length === 1) return templateForProvider(providers[0]);
+    if (providers.length > 0 && !providers.includes("anthropic")) {
+      return templateForProvider(providers[0]);
+    }
+    return "claude";
+  }
+  if (modelId.includes(":")) {
+    const provider = modelId.split(":")[0];
+    return templateForProvider(provider);
+  }
+  const model = findModel(modelId);
+  if (model) return templateForProvider(model.provider);
+  return "claude";
+}
 function getEnabledModels() {
   const ai = getAiConfig();
   return ai?.models ?? [];
@@ -95,7 +115,7 @@ function getAvailableModels() {
     try {
       models.push(...getModels(provider));
     } catch (err) {
-      aiLog.debug(`no models for provider ${provider}`, logger_default.errorData(err));
+      aiLog.warn(`failed to load models for provider ${provider}`, logger_default.errorData(err));
     }
   }
   return models;
@@ -121,6 +141,16 @@ async function resolveApiKey(providerId) {
   if (providerConfig?.apiKey) return providerConfig.apiKey;
   return getEnvApiKey(providerId) ?? void 0;
 }
+function qualifyModelId(modelId) {
+  if (modelId.includes(":")) return modelId;
+  const model = findModel(modelId);
+  if (model) return `${model.provider}:${model.id}`;
+  return modelId;
+}
+function unqualifyModelId(modelId) {
+  const idx = modelId.indexOf(":");
+  return idx >= 0 ? modelId.slice(idx + 1) : modelId;
+}
 function findModel(modelId) {
   const providers = getConfiguredProviders();
   for (const provider of providers) {
@@ -154,6 +184,7 @@ async function aiComplete(systemPrompt, userMessage, modelId) {
   const model = modelId ? findModel(modelId) : autoSelectModel();
   if (!model) {
     if (modelId) aiLog.warn(`model not found: ${modelId}`);
+    else aiLog.debug("no enabled model available for auto-selection");
     return null;
   }
   try {
@@ -181,8 +212,15 @@ export {
   removeAiConfig,
   getConfiguredProviders,
   isAiConfigured,
+  getUtilityModel,
+  setUtilityModel,
+  aiCompleteUtility,
+  resolveTemplate,
   getEnabledModels,
   setEnabledModels,
   getAvailableModels,
+  resolveApiKey,
+  qualifyModelId,
+  unqualifyModelId,
   aiComplete
 };