@swarmvaultai/engine 1.0.0 → 1.1.0

package/dist/index.js

@@ -1,4 +1,5 @@
 import {
+  LocalWhisperProviderAdapter,
   PRIMARY_SCHEMA_FILENAME,
   appendJsonLine,
   assertProviderCapability,
@@ -23,7 +24,7 @@ import {
   uniqueBy,
   writeFileIfChanged,
   writeJsonFile
-} from "./chunk-4MSSM2GH.js";
+} from "./chunk-UQCF65BN.js";
 import {
   estimatePageTokens,
   estimateTokens,
@@ -8379,15 +8380,15 @@ function sourceTypeForNode(node, pagesById) {
   return pagesById.get(node.pageId)?.sourceType;
 }
 function supportingPathDetails(graph, edge) {
-  const path32 = shortestGraphPath(graph, edge.source, edge.target);
+  const path33 = shortestGraphPath(graph, edge.source, edge.target);
   const edgesById = new Map(graph.edges.map((item) => [item.id, item]));
-  const pathEdges = path32.edgeIds.map((edgeId) => edgesById.get(edgeId)).filter((item) => Boolean(item));
+  const pathEdges = path33.edgeIds.map((edgeId) => edgesById.get(edgeId)).filter((item) => Boolean(item));
   return {
-    pathNodeIds: path32.nodeIds,
-    pathEdgeIds: path32.edgeIds,
+    pathNodeIds: path33.nodeIds,
+    pathEdgeIds: path33.edgeIds,
     pathRelations: pathEdges.map((item) => item.relation),
     pathEvidenceClasses: pathEdges.map((item) => item.evidenceClass),
-    pathSummary: path32.summary
+    pathSummary: path33.summary
   };
 }
 function surpriseScore(edge, graph, pagesById, hyperedgesByNodeId) {
@@ -8456,7 +8457,7 @@ function topSurprisingConnections(graph, pagesById) {
     }).map((edge) => {
       const source = nodesById.get(edge.source);
       const target = nodesById.get(edge.target);
-      const path32 = supportingPathDetails(graph, edge);
+      const path33 = supportingPathDetails(graph, edge);
       const scored = surpriseScore(edge, graph, pagesById, hyperedgesByNodeId);
       return {
         id: edge.id,
@@ -8467,11 +8468,11 @@ function topSurprisingConnections(graph, pagesById) {
         relation: edge.relation,
         evidenceClass: edge.evidenceClass,
         confidence: edge.confidence,
-        pathNodeIds: path32.pathNodeIds,
-        pathEdgeIds: path32.pathEdgeIds,
-        pathRelations: path32.pathRelations,
-        pathEvidenceClasses: path32.pathEvidenceClasses,
-        pathSummary: path32.pathSummary,
+        pathNodeIds: path33.pathNodeIds,
+        pathEdgeIds: path33.pathEdgeIds,
+        pathRelations: path33.pathRelations,
+        pathEvidenceClasses: path33.pathEvidenceClasses,
+        pathSummary: path33.pathSummary,
         why: scored.why,
         explanation: scored.explanation,
         surpriseScore: scored.score
@@ -18310,7 +18311,8 @@ function isSupportedInboxKind(sourceKind) {
     "chat_export",
     "email",
     "calendar",
-    "image"
+    "image",
+    "audio"
   ].includes(sourceKind);
 }
 async function ingestInputDetailed(rootDir, input, options) {
@@ -20897,7 +20899,7 @@ async function resolveImageGenerationProvider(rootDir) {
   if (!providerConfig) {
     throw new Error(`No provider configured with id "${preferredProviderId}" for task "imageProvider".`);
   }
-  const { createProvider: createProvider2 } = await import("./registry-QAG2ZYH3.js");
+  const { createProvider: createProvider2 } = await import("./registry-GH4O3A7H.js");
   return createProvider2(preferredProviderId, providerConfig, rootDir);
 }
 async function generateOutputArtifacts(rootDir, input) {
@@ -26613,7 +26615,7 @@ async function getWatchStatus(rootDir) {
 }
 
 // src/mcp.ts
-var SERVER_VERSION = "1.0.0";
+var SERVER_VERSION = "1.1.0";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -27149,6 +27151,155 @@ function asTextResource(uri, text) {
   };
 }
 
+// src/providers/local-whisper-setup.ts
+import { createWriteStream, constants as fsConstants } from "fs";
+import fs25 from "fs/promises";
+import os3 from "os";
+import path29 from "path";
+import { Readable as Readable2 } from "stream";
+import { pipeline } from "stream/promises";
+var BINARY_CANDIDATES = ["whisper-cli", "whisper-cpp", "whisper"];
+var HUGGINGFACE_BASE = "https://huggingface.co/ggerganov/whisper.cpp/resolve/main";
+var LOCAL_WHISPER_MODEL_SIZES = Object.freeze({
+  "tiny.en": "78 MB",
+  tiny: "78 MB",
+  "base.en": "147 MB",
+  base: "147 MB",
+  "small.en": "488 MB",
+  small: "488 MB",
+  "medium.en": "1.5 GB",
+  medium: "1.5 GB",
+  "large-v3": "3.1 GB",
+  "large-v3-turbo": "1.6 GB"
+});
+async function discoverLocalWhisperBinary(options = {}) {
+  const env = options.env ?? process.env;
+  if (env.SWARMVAULT_WHISPER_BINARY) {
+    return {
+      binaryPath: env.SWARMVAULT_WHISPER_BINARY,
+      candidates: [env.SWARMVAULT_WHISPER_BINARY],
+      source: "env"
+    };
+  }
+  const pathValue = env.PATH ?? "";
+  const candidates = [];
+  for (const dir of pathValue.split(path29.delimiter)) {
+    if (!dir) continue;
+    for (const name of BINARY_CANDIDATES) {
+      const full = path29.join(dir, name);
+      candidates.push(full);
+      if (await isExecutable(full)) {
+        return { binaryPath: full, candidates, source: "path" };
+      }
+    }
+  }
+  return { binaryPath: null, candidates, source: "not-found" };
+}
+function expectedModelPath(modelName, homeDir) {
+  const home = homeDir ?? os3.homedir();
+  return path29.join(home, ".swarmvault", "models", `ggml-${modelName}.bin`);
+}
+function modelDownloadUrl(modelName) {
+  return `${HUGGINGFACE_BASE}/ggml-${modelName}.bin`;
+}
+async function downloadWhisperModel(options) {
+  const destPath = expectedModelPath(options.modelName, options.homeDir);
+  await ensureDir(path29.dirname(destPath));
+  const doFetch = options.fetchImpl ?? fetch;
+  const url = modelDownloadUrl(options.modelName);
+  const response = await doFetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
+  }
+  if (!response.body) {
+    throw new Error(`Response body missing for ${url}`);
+  }
+  const totalHeader = response.headers.get("content-length");
+  const totalBytes = totalHeader ? Number.parseInt(totalHeader, 10) : void 0;
+  let downloadedBytes = 0;
+  const webStream = response.body;
+  const source = Readable2.fromWeb(webStream);
+  source.on("data", (chunk) => {
+    downloadedBytes += chunk.length;
+    options.onProgress?.({ downloadedBytes, totalBytes });
+  });
+  const tmpPath = `${destPath}.part`;
+  await pipeline(source, createWriteStream(tmpPath));
+  await fs25.rename(tmpPath, destPath);
+  const stat = await fs25.stat(destPath);
+  return { path: destPath, bytes: stat.size };
+}
+async function registerLocalWhisperProvider(options) {
+  const { config, paths } = await loadVaultConfig(options.rootDir);
+  const providerId = options.providerId ?? "local-whisper";
+  const desired = buildProviderEntry(options);
+  const existing = config.providers[providerId];
+  const providerWasAdded = !existing;
+  const providerWasUpdated = !providerWasAdded && !providerEntryMatches(existing, desired);
+  const previousAudioProvider = config.tasks.audioProvider;
+  const shouldSetAudio = options.setAsAudioProvider !== false && (options.setAsAudioProvider === true || !previousAudioProvider);
+  const next = {
+    ...config,
+    providers: {
+      ...config.providers,
+      [providerId]: desired
+    },
+    tasks: {
+      ...config.tasks,
+      audioProvider: shouldSetAudio ? providerId : previousAudioProvider
+    }
+  };
+  await writeJsonFile(paths.configPath, next);
+  return {
+    providerId,
+    configPath: paths.configPath,
+    providerWasAdded,
+    providerWasUpdated,
+    audioProviderSet: shouldSetAudio && previousAudioProvider !== providerId,
+    previousAudioProvider
+  };
+}
+function buildProviderEntry(options) {
+  const entry = {
+    type: "local-whisper",
+    model: options.model
+  };
+  if (options.binaryPath) entry.binaryPath = options.binaryPath;
+  if (options.modelPath) entry.modelPath = options.modelPath;
+  if (options.threads !== void 0) entry.threads = options.threads;
+  return entry;
+}
+function providerEntryMatches(existing, desired) {
+  return existing.type === desired.type && existing.model === desired.model && existing.binaryPath === desired.binaryPath && existing.modelPath === desired.modelPath && existing.threads === desired.threads;
+}
+async function summarizeLocalWhisperSetup(options) {
+  const discovery = await discoverLocalWhisperBinary({ env: options.env });
+  const modelPath = expectedModelPath(options.modelName, options.homeDir);
+  return {
+    binary: {
+      found: discovery.binaryPath !== null,
+      path: discovery.binaryPath,
+      source: discovery.source,
+      installHint: 'Install whisper.cpp \u2014 macOS: "brew install whisper-cpp"; Debian/Ubuntu: "sudo apt install whisper.cpp" (or build from https://github.com/ggerganov/whisper.cpp).'
+    },
+    model: {
+      name: options.modelName,
+      expectedPath: modelPath,
+      exists: await fileExists(modelPath),
+      downloadUrl: modelDownloadUrl(options.modelName),
+      approximateSize: LOCAL_WHISPER_MODEL_SIZES[options.modelName]
+    }
+  };
+}
+async function isExecutable(p) {
+  try {
+    await fs25.access(p, fsConstants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // src/providers/openai-compatible-capabilities.ts
 var OPENAI_COMPATIBLE_CAPABILITY_MATRIX = Object.freeze({
   openai: {
@@ -27212,13 +27363,13 @@ async function withCapabilityFallback(provider, capability, run, fallback) {
 }
 
 // src/schedule.ts
-import fs25 from "fs/promises";
-import path29 from "path";
+import fs26 from "fs/promises";
+import path30 from "path";
 function scheduleStatePath(schedulesDir, jobId) {
-  return path29.join(schedulesDir, `${encodeURIComponent(jobId)}.json`);
+  return path30.join(schedulesDir, `${encodeURIComponent(jobId)}.json`);
 }
 function scheduleLockPath(schedulesDir, jobId) {
-  return path29.join(schedulesDir, `${encodeURIComponent(jobId)}.lock`);
+  return path30.join(schedulesDir, `${encodeURIComponent(jobId)}.lock`);
 }
 function parseEveryDuration(value) {
   const match = value.trim().match(/^(\d+)(m|h|d)$/i);
@@ -27321,13 +27472,13 @@ async function acquireJobLease(rootDir, jobId) {
   const { paths } = await loadVaultConfig(rootDir);
   const leasePath = scheduleLockPath(paths.schedulesDir, jobId);
   await ensureDir(paths.schedulesDir);
-  const handle = await fs25.open(leasePath, "wx");
+  const handle = await fs26.open(leasePath, "wx");
   await handle.writeFile(`${process.pid}
 ${(/* @__PURE__ */ new Date()).toISOString()}
 `);
   await handle.close();
   return async () => {
-    await fs25.rm(leasePath, { force: true });
+    await fs26.rm(leasePath, { force: true });
   };
 }
 async function listSchedules(rootDir) {
@@ -27486,8 +27637,8 @@ async function serveSchedules(rootDir, pollMs = 3e4) {
 
 // src/sources.ts
 import { spawn as spawn2 } from "child_process";
-import fs26 from "fs/promises";
-import path30 from "path";
+import fs27 from "fs/promises";
+import path31 from "path";
 import matter14 from "gray-matter";
 import { JSDOM as JSDOM3 } from "jsdom";
 var DEFAULT_CRAWL_MAX_PAGES = 12;
@@ -27533,24 +27684,24 @@ function emptyManagedSourceSyncCounts() {
   };
 }
 function withinRoot2(rootPath, targetPath) {
-  const relative = path30.relative(rootPath, targetPath);
-  return relative === "" || !relative.startsWith("..") && !path30.isAbsolute(relative);
+  const relative = path31.relative(rootPath, targetPath);
+  return relative === "" || !relative.startsWith("..") && !path31.isAbsolute(relative);
 }
 async function findNearestGitRoot3(startPath) {
-  let current = path30.resolve(startPath);
+  let current = path31.resolve(startPath);
   try {
-    const stat = await fs26.stat(current);
+    const stat = await fs27.stat(current);
     if (!stat.isDirectory()) {
-      current = path30.dirname(current);
+      current = path31.dirname(current);
     }
   } catch {
-    current = path30.dirname(current);
+    current = path31.dirname(current);
   }
   while (true) {
-    if (await fileExists(path30.join(current, ".git"))) {
+    if (await fileExists(path31.join(current, ".git"))) {
       return current;
     }
-    const parent = path30.dirname(current);
+    const parent = path31.dirname(current);
     if (parent === current) {
       return null;
     }
@@ -27624,7 +27775,7 @@ function isAllowedDocsCandidate(candidate, startUrl) {
   if (candidate.origin !== startUrl.origin) {
     return false;
   }
-  const extension = path30.extname(candidate.pathname).toLowerCase();
+  const extension = path31.extname(candidate.pathname).toLowerCase();
   if (extension && extension !== ".html" && extension !== ".htm" && extension !== ".md") {
     return false;
   }
@@ -27713,14 +27864,14 @@ function matchesManagedSourceSpec(existing, input) {
     return false;
   }
   if (input.kind === "directory" || input.kind === "file") {
-    return path30.resolve(existing.path ?? "") === path30.resolve(input.path);
+    return path31.resolve(existing.path ?? "") === path31.resolve(input.path);
   }
   return (existing.url ?? "") === input.url;
 }
 async function resolveManagedSourceInput(rootDir, input) {
-  const absoluteInput = path30.resolve(rootDir, input);
+  const absoluteInput = path31.resolve(rootDir, input);
   if (!(input.startsWith("http://") || input.startsWith("https://"))) {
-    const stat = await fs26.stat(absoluteInput).catch(() => null);
+    const stat = await fs27.stat(absoluteInput).catch(() => null);
     if (!stat) {
       throw new Error(`Source not found: ${input}`);
     }
@@ -27728,7 +27879,7 @@ async function resolveManagedSourceInput(rootDir, input) {
       return {
         kind: "file",
         path: absoluteInput,
-        title: path30.basename(absoluteInput, path30.extname(absoluteInput)) || absoluteInput
+        title: path31.basename(absoluteInput, path31.extname(absoluteInput)) || absoluteInput
       };
     }
     if (!stat.isDirectory()) {
@@ -27740,7 +27891,7 @@ async function resolveManagedSourceInput(rootDir, input) {
       kind: "directory",
       path: absoluteInput,
       repoRoot,
-      title: path30.basename(absoluteInput) || absoluteInput
+      title: path31.basename(absoluteInput) || absoluteInput
     };
   }
   const github = normalizeGitHubRepoRootUrl(input);
@@ -27763,16 +27914,16 @@ async function resolveManagedSourceInput(rootDir, input) {
   };
 }
 function directorySourceIdsFor(manifests, inputPath) {
-  return manifests.filter((manifest) => manifest.originalPath && withinRoot2(path30.resolve(inputPath), path30.resolve(manifest.originalPath))).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
+  return manifests.filter((manifest) => manifest.originalPath && withinRoot2(path31.resolve(inputPath), path31.resolve(manifest.originalPath))).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
 }
 function fileSourceIdsFor(manifests, inputPath) {
-  const absoluteInput = path30.resolve(inputPath);
-  return manifests.filter((manifest) => manifest.originalPath && path30.resolve(manifest.originalPath) === absoluteInput).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
+  const absoluteInput = path31.resolve(inputPath);
+  return manifests.filter((manifest) => manifest.originalPath && path31.resolve(manifest.originalPath) === absoluteInput).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
 }
 async function syncDirectorySource(rootDir, inputPath, repoRoot) {
   const manifestsBefore = await listManifests(rootDir);
   const previousInScope = manifestsBefore.filter(
-    (manifest) => manifest.originalPath && withinRoot2(path30.resolve(inputPath), path30.resolve(manifest.originalPath))
+    (manifest) => manifest.originalPath && withinRoot2(path31.resolve(inputPath), path31.resolve(manifest.originalPath))
   );
   const result = await ingestDirectory(rootDir, inputPath, { repoRoot });
   const removed = [];
@@ -27780,7 +27931,7 @@ async function syncDirectorySource(rootDir, inputPath, repoRoot) {
     if (!manifest.originalPath) {
       continue;
     }
-    if (await fileExists(path30.resolve(manifest.originalPath))) {
+    if (await fileExists(path31.resolve(manifest.originalPath))) {
       continue;
     }
     const removedManifest = await removeManifestBySourceId(rootDir, manifest.sourceId);
@@ -27790,7 +27941,7 @@ async function syncDirectorySource(rootDir, inputPath, repoRoot) {
   }
   const manifestsAfter = await listManifests(rootDir);
   return {
-    title: path30.basename(inputPath) || inputPath,
+    title: path31.basename(inputPath) || inputPath,
     sourceIds: directorySourceIdsFor(manifestsAfter, inputPath),
     counts: {
       scannedCount: result.scannedCount,
@@ -27806,7 +27957,7 @@ async function syncFileSource(rootDir, inputPath) {
   const result = await ingestInputDetailed(rootDir, inputPath);
   const manifestsAfter = await listManifests(rootDir);
   return {
-    title: path30.basename(inputPath, path30.extname(inputPath)) || inputPath,
+    title: path31.basename(inputPath, path31.extname(inputPath)) || inputPath,
     sourceIds: fileSourceIdsFor(manifestsAfter, inputPath),
     counts: {
       scannedCount: result.scannedCount,
@@ -27840,8 +27991,8 @@ async function runGitCommand(cwd, args) {
 }
 async function syncGitHubRepoSource(rootDir, entry) {
   const workingDir = await managedSourceWorkingDir(rootDir, entry.id);
-  const checkoutDir = path30.join(workingDir, "checkout");
-  await fs26.rm(checkoutDir, { recursive: true, force: true });
+  const checkoutDir = path31.join(workingDir, "checkout");
+  await fs27.rm(checkoutDir, { recursive: true, force: true });
   await ensureDir(workingDir);
   if (!entry.url) {
     throw new Error(`Managed source ${entry.id} is missing its repository URL.`);
@@ -27971,7 +28122,7 @@ function scopedNodeIds(graph, sourceIds) {
 async function loadSourceAnalyses(rootDir, sourceIds) {
   const { paths } = await loadVaultConfig(rootDir);
   const analyses = await Promise.all(
-    sourceIds.map(async (sourceId) => await readJsonFile(path30.join(paths.analysesDir, `${sourceId}.json`)))
+    sourceIds.map(async (sourceId) => await readJsonFile(path31.join(paths.analysesDir, `${sourceId}.json`)))
   );
   return analyses.filter((analysis) => Boolean(analysis?.sourceId));
 }
@@ -28132,9 +28283,9 @@ async function writeSourceBriefForScope(rootDir, source) {
       confidence: 0.82
     }
   });
-  const absolutePath = path30.join(paths.wikiDir, output.page.path);
-  await ensureDir(path30.dirname(absolutePath));
-  await fs26.writeFile(absolutePath, output.content, "utf8");
+  const absolutePath = path31.join(paths.wikiDir, output.page.path);
+  await ensureDir(path31.dirname(absolutePath));
+  await fs27.writeFile(absolutePath, output.content, "utf8");
   return absolutePath;
 }
 async function writeSourceBrief(rootDir, source) {
@@ -28422,7 +28573,7 @@ function selectGuidedTargetPages(scope, sourcePages, questions) {
   return (matchedTargets.length ? matchedTargets : canonicalPages).slice(0, 6);
 }
 function insightRelativePathForTarget(page, scope) {
-  const basename = path30.basename(page.path);
+  const basename = path31.basename(page.path);
   if (page.kind === "concept") {
     return `insights/concepts/${basename}`;
   }
@@ -28649,7 +28800,7 @@ async function stageSourceReviewForScope(rootDir, scope) {
   return {
     sourceId: scope.id,
     pageId: output.page.id,
-    reviewPath: path30.join(approval.approvalDir, "wiki", output.page.path),
+    reviewPath: path31.join(approval.approvalDir, "wiki", output.page.path),
     staged: true,
     approvalId: approval.approvalId,
     approvalDir: approval.approvalDir
@@ -28716,7 +28867,7 @@ async function buildSourceSessionSavedPage(rootDir, scope, session) {
   const evidenceState = contradictions.length > 0 ? "conflicting" : session.targetedPagePaths.some(
     (targetPath) => sourcePages.some((page) => page.path === targetPath && page.sourceIds.some((sourceId) => !scope.sourceIds.includes(sourceId)))
   ) ? "reinforcing" : session.targetedPagePaths.length ? "new" : "needs_judgment";
-  const relativeBriefPath = session.briefPath && path30.isAbsolute(session.briefPath) ? path30.relative(paths.wikiDir, session.briefPath) : session.briefPath;
+  const relativeBriefPath = session.briefPath && path31.isAbsolute(session.briefPath) ? path31.relative(paths.wikiDir, session.briefPath) : session.briefPath;
   const sessionMarkdown = [
     `# Guided Session: ${scope.title}`,
     "",
@@ -28799,9 +28950,9 @@ async function buildSourceSessionSavedPage(rootDir, scope, session) {
 async function persistSourceSessionPage(rootDir, scope, session) {
   const { paths } = await loadVaultConfig(rootDir);
   const output = await buildSourceSessionSavedPage(rootDir, scope, session);
-  const absolutePath = path30.join(paths.wikiDir, output.page.path);
-  await ensureDir(path30.dirname(absolutePath));
-  await fs26.writeFile(absolutePath, output.content, "utf8");
+  const absolutePath = path31.join(paths.wikiDir, output.page.path);
+  await ensureDir(path31.dirname(absolutePath));
+  await fs27.writeFile(absolutePath, output.content, "utf8");
   return { pageId: output.page.id, sessionPath: absolutePath };
 }
 async function buildGuidedUpdatePages(rootDir, scope, session) {
@@ -28829,8 +28980,8 @@ async function buildGuidedUpdatePages(rootDir, scope, session) {
     targetPages.map(async (targetPage) => {
       const evidenceState = classifyGuidedEvidenceState(scope, targetPage, contradictions);
       const relativePath = useCanonicalTargets && targetPage ? targetPage.path : targetPage ? insightRelativePathForTarget(targetPage, scope) : `insights/topics/${slugify(scope.title)}.md`;
-      const absolutePath = path30.join(paths.wikiDir, relativePath);
-      const existingContent = await fileExists(absolutePath) ? await fs26.readFile(absolutePath, "utf8") : "";
+      const absolutePath = path31.join(paths.wikiDir, relativePath);
+      const existingContent = await fileExists(absolutePath) ? await fs27.readFile(absolutePath, "utf8") : "";
       const parsed = existingContent ? matter14(existingContent) : { data: {}, content: "" };
       const existingData = parsed.data;
       const existingSourceIds = Array.isArray(existingData.source_ids) ? existingData.source_ids.filter((value) => typeof value === "string") : [];
@@ -29001,8 +29152,8 @@ async function stageSourceGuideForScope(rootDir, scope, options = {}) {
     }
   );
   session.status = "staged";
-  session.reviewPath = path30.join(approval.approvalDir, "wiki", reviewOutput.page.path);
-  session.guidePath = path30.join(approval.approvalDir, "wiki", guideOutput.page.path);
+  session.reviewPath = path31.join(approval.approvalDir, "wiki", reviewOutput.page.path);
+  session.guidePath = path31.join(approval.approvalDir, "wiki", guideOutput.page.path);
   session.approvalId = approval.approvalId;
   session.approvalDir = approval.approvalDir;
   const persisted = await persistSourceSessionPage(rootDir, scope, session);
@@ -29140,7 +29291,7 @@ async function addManagedSource(rootDir, input, options = {}) {
   const existing = sources.find((candidate) => matchesManagedSourceSpec(candidate, resolved));
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const source = existing ?? {
-    id: resolved.kind === "directory" || resolved.kind === "file" ? stableManagedSourceId(resolved.kind, path30.resolve(resolved.path), resolved.title) : stableManagedSourceId(resolved.kind, resolved.url, resolved.title),
+    id: resolved.kind === "directory" || resolved.kind === "file" ? stableManagedSourceId(resolved.kind, path31.resolve(resolved.path), resolved.title) : stableManagedSourceId(resolved.kind, resolved.url, resolved.title),
     kind: resolved.kind,
     title: resolved.title,
     path: resolved.kind === "directory" || resolved.kind === "file" ? resolved.path : void 0,
@@ -29268,7 +29419,7 @@ async function deleteManagedSource(rootDir, id) {
     sources.filter((source) => source.id !== id)
   );
   const workingDir = await managedSourceWorkingDir(rootDir, id);
-  await fs26.rm(workingDir, { recursive: true, force: true });
+  await fs27.rm(workingDir, { recursive: true, force: true });
   return { removed: target };
 }
 
@@ -29276,9 +29427,9 @@ async function deleteManagedSource(rootDir, id) {
 import { execFile as execFile2 } from "child_process";
 import { randomUUID } from "crypto";
 import { EventEmitter } from "events";
-import fs27 from "fs/promises";
+import fs28 from "fs/promises";
 import http from "http";
-import path31 from "path";
+import path32 from "path";
 import { promisify as promisify2 } from "util";
 import matter15 from "gray-matter";
 import mime2 from "mime-types";
@@ -29432,7 +29583,7 @@ function toViewerLintFindings(findings) {
 var execFileAsync2 = promisify2(execFile2);
 async function isReadableFile(absolutePath) {
   try {
-    const stats = await fs27.stat(absolutePath);
+    const stats = await fs28.stat(absolutePath);
     return stats.isFile();
   } catch {
     return false;
@@ -29443,15 +29594,15 @@ async function readViewerPage(rootDir, relativePath) {
     return null;
   }
   const { paths } = await loadVaultConfig(rootDir);
-  const absolutePath = path31.resolve(paths.wikiDir, relativePath);
+  const absolutePath = path32.resolve(paths.wikiDir, relativePath);
   if (!isPathWithin(paths.wikiDir, absolutePath) || !await isReadableFile(absolutePath)) {
     return null;
   }
-  const raw = await fs27.readFile(absolutePath, "utf8");
+  const raw = await fs28.readFile(absolutePath, "utf8");
   const parsed = matter15(raw);
   return {
     path: relativePath,
-    title: typeof parsed.data.title === "string" ? parsed.data.title : path31.basename(relativePath, path31.extname(relativePath)),
+    title: typeof parsed.data.title === "string" ? parsed.data.title : path32.basename(relativePath, path32.extname(relativePath)),
     frontmatter: parsed.data,
     content: parsed.content,
     assets: normalizeOutputAssets(parsed.data.output_assets)
@@ -29462,12 +29613,12 @@ async function readViewerAsset(rootDir, relativePath) {
     return null;
   }
   const { paths } = await loadVaultConfig(rootDir);
-  const absolutePath = path31.resolve(paths.wikiDir, relativePath);
+  const absolutePath = path32.resolve(paths.wikiDir, relativePath);
   if (!isPathWithin(paths.wikiDir, absolutePath) || !await isReadableFile(absolutePath)) {
     return null;
   }
   return {
-    buffer: await fs27.readFile(absolutePath),
+    buffer: await fs28.readFile(absolutePath),
     mimeType: mime2.lookup(absolutePath) || "application/octet-stream"
   };
 }
@@ -29490,12 +29641,12 @@ async function readJsonBody(request) {
   return JSON.parse(raw);
 }
 async function ensureViewerDist(viewerDistDir) {
-  const indexPath = path31.join(viewerDistDir, "index.html");
+  const indexPath = path32.join(viewerDistDir, "index.html");
   if (await fileExists(indexPath)) {
     return;
   }
-  const viewerProjectDir = path31.dirname(viewerDistDir);
-  if (await fileExists(path31.join(viewerProjectDir, "package.json"))) {
+  const viewerProjectDir = path32.dirname(viewerDistDir);
+  if (await fileExists(path32.join(viewerProjectDir, "package.json"))) {
     await execFileAsync2("pnpm", ["build"], { cwd: viewerProjectDir });
   }
 }
@@ -29518,7 +29669,7 @@ async function startGraphServer(rootDir, port, options = {}) {
           response.end(JSON.stringify({ error: "Graph artifact not found. Run `swarmvault compile` first." }));
           return;
         }
-        const reportPath = path31.join(paths.wikiDir, "graph", "report.json");
+        const reportPath = path32.join(paths.wikiDir, "graph", "report.json");
         const report = await readJsonFile(reportPath) ?? null;
         response.writeHead(200, { "content-type": "application/json" });
         response.end(JSON.stringify(buildViewerGraphArtifact(graph, { report, full: options.full ?? false })));
@@ -29582,13 +29733,13 @@ async function startGraphServer(rootDir, port, options = {}) {
         return;
       }
       if (url.pathname === "/api/graph-report") {
-        const reportPath = path31.join(paths.wikiDir, "graph", "report.json");
+        const reportPath = path32.join(paths.wikiDir, "graph", "report.json");
         if (!await fileExists(reportPath)) {
           response.writeHead(404, { "content-type": "application/json" });
           response.end(JSON.stringify({ error: "Graph report artifact not found. Run `swarmvault compile` first." }));
           return;
         }
-        const body = await fs27.readFile(reportPath, "utf8");
+        const body = await fs28.readFile(reportPath, "utf8");
         response.writeHead(200, { "content-type": "application/json" });
         response.end(body);
         return;
@@ -29689,7 +29840,7 @@ async function startGraphServer(rootDir, port, options = {}) {
         return;
       }
       if (url.pathname === "/api/workspace") {
-        const reportPath = path31.join(paths.wikiDir, "graph", "report.json");
+        const reportPath = path32.join(paths.wikiDir, "graph", "report.json");
         const [graphRaw, reportRaw, approvalsRaw, candidatesRaw, watchStatusRaw, lintRaw] = await Promise.all([
           readJsonFile(paths.graphPath).catch(() => null),
           readJsonFile(reportPath).catch(() => null),
@@ -29785,15 +29936,15 @@ async function startGraphServer(rootDir, port, options = {}) {
         return;
       }
       const relativePath = url.pathname === "/" ? "index.html" : url.pathname.slice(1);
-      const target = path31.join(paths.viewerDistDir, relativePath);
-      const fallback = path31.join(paths.viewerDistDir, "index.html");
+      const target = path32.join(paths.viewerDistDir, relativePath);
+      const fallback = path32.join(paths.viewerDistDir, "index.html");
       const filePath = await fileExists(target) ? target : fallback;
       if (!await fileExists(filePath)) {
         response.writeHead(503, { "content-type": "text/plain" });
         response.end("Viewer build not found. Run `pnpm build` first.");
         return;
       }
-      const staticBody = await fs27.readFile(filePath);
+      const staticBody = await fs28.readFile(filePath);
       response.writeHead(200, { "content-type": mime2.lookup(filePath) || "text/plain" });
       response.end(staticBody);
     } catch (error) {
@@ -29833,7 +29984,7 @@ async function exportGraphHtml(rootDir, outputPath, options = {}) {
     throw new Error("Graph artifact not found. Run `swarmvault compile` first.");
   }
   await ensureViewerDist(paths.viewerDistDir);
-  const indexPath = path31.join(paths.viewerDistDir, "index.html");
+  const indexPath = path32.join(paths.viewerDistDir, "index.html");
   if (!await fileExists(indexPath)) {
     throw new Error("Viewer build not found. Run `pnpm build` first.");
   }
@@ -29859,17 +30010,17 @@ async function exportGraphHtml(rootDir, outputPath, options = {}) {
       } : null;
     })
   );
-  const rawHtml = await fs27.readFile(indexPath, "utf8");
+  const rawHtml = await fs28.readFile(indexPath, "utf8");
   const scriptMatch = rawHtml.match(/<script type="module" crossorigin src="([^"]+)"><\/script>/);
   const styleMatch = rawHtml.match(/<link rel="stylesheet" crossorigin href="([^"]+)">/);
-  const scriptPath = scriptMatch?.[1] ? path31.join(paths.viewerDistDir, scriptMatch[1].replace(/^\//, "")) : null;
-  const stylePath = styleMatch?.[1] ? path31.join(paths.viewerDistDir, styleMatch[1].replace(/^\//, "")) : null;
+  const scriptPath = scriptMatch?.[1] ? path32.join(paths.viewerDistDir, scriptMatch[1].replace(/^\//, "")) : null;
+  const stylePath = styleMatch?.[1] ? path32.join(paths.viewerDistDir, styleMatch[1].replace(/^\//, "")) : null;
   if (!scriptPath || !await fileExists(scriptPath)) {
     throw new Error("Viewer script bundle not found. Run `pnpm build` first.");
   }
-  const script = await fs27.readFile(scriptPath, "utf8");
-  const style = stylePath && await fileExists(stylePath) ? await fs27.readFile(stylePath, "utf8") : "";
-  const report = await readJsonFile(path31.join(paths.wikiDir, "graph", "report.json"));
+  const script = await fs28.readFile(scriptPath, "utf8");
+  const style = stylePath && await fileExists(stylePath) ? await fs28.readFile(stylePath, "utf8") : "";
+  const report = await readJsonFile(path32.join(paths.wikiDir, "graph", "report.json"));
   const embeddedData = JSON.stringify(
     { graph: buildViewerGraphArtifact(graph, { report, full: options.full ?? false }), pages: pages.filter(Boolean), report },
     null,
@@ -29892,9 +30043,9 @@ async function exportGraphHtml(rootDir, outputPath, options = {}) {
     "</html>",
     ""
   ].filter(Boolean).join("\n");
-  await fs27.mkdir(path31.dirname(outputPath), { recursive: true });
-  await fs27.writeFile(outputPath, html, "utf8");
-  return path31.resolve(outputPath);
+  await fs28.mkdir(path32.dirname(outputPath), { recursive: true });
+  await fs28.writeFile(outputPath, html, "utf8");
+  return path32.resolve(outputPath);
 }
 export {
   ALL_MIGRATIONS,
@@ -29905,6 +30056,8 @@ export {
   DEFAULT_REDACTION_PATTERNS,
   DEFAULT_STALE_THRESHOLD,
   LARGE_REPO_NODE_THRESHOLD,
+  LOCAL_WHISPER_MODEL_SIZES,
+  LocalWhisperProviderAdapter,
   OPENAI_COMPATIBLE_CAPABILITY_MATRIX,
   acceptApproval,
   addInput,
@@ -29931,9 +30084,12 @@ export {
   defaultVaultSchema,
   deleteManagedSource,
   detectVaultVersion,
+  discoverLocalWhisperBinary,
+  downloadWhisperModel,
   estimatePageTokens,
   estimateTokens,
   evaluateCandidateForPromotion,
+  expectedModelPath,
   explainGraphVault,
   exploreVault,
   exportGraphFormat,
@@ -29974,6 +30130,7 @@ export {
   loadVaultSchemas,
   lookupPresetCapabilities,
   markSuperseded,
+  modelDownloadUrl,
   pathGraphVault,
   persistDecayFrontmatter,
   planMigration,
@@ -29986,6 +30143,7 @@ export {
   readExtractedText,
   readGraphReport,
   readPage,
+  registerLocalWhisperProvider,
   rejectApproval,
   reloadManagedSources,
   removeWatchedRoot,
@@ -30010,6 +30168,7 @@ export {
   stageGeneratedOutputPages,
   startGraphServer,
   startMcpServer,
+  summarizeLocalWhisperSetup,
   syncTrackedRepos,
   syncTrackedReposForWatch,
   synthesizeHyperedgeHubs,