kennel 0.2.30 → 0.2.32

package/dist/package/preview.js

@@ -38723,6 +38723,10 @@ function assetKey(value) {
 function encodeBase64Url(value) {
   return Buffer.from(value, "utf8").toString("base64").replaceAll("+", "-").replaceAll("/", "_").replaceAll("=", "");
 }
+function decodeBase64Url2(value) {
+  const padded = `${value}${"=".repeat((4 - value.length % 4) % 4)}`;
+  return Buffer.from(padded.replaceAll("-", "+").replaceAll("_", "/"), "base64").toString("utf8");
+}
 function iconUrl(folder, hash, mediaType) {
   return `/api/folders/${encodeBase64Url(folder)}/assets/${hash}.${iconExtensions.get(mediaType)}`;
 }
@@ -38746,6 +38750,54 @@ async function folderIcon(folder, assets, assetFiles, fallback) {
   };
   return key;
 }
+async function searchIconDataUrl(icon) {
+  if (!icon)
+    return;
+  if (icon.startsWith("data:"))
+    return icon;
+  const mediaType = searchIconTypes.get(extname4(icon).toLowerCase());
+  if (!mediaType)
+    return;
+  const details = await stat5(icon).catch(() => {
+    return;
+  });
+  if (!details?.size || details.size > maxSearchIconBytes)
+    return;
+  return `data:${mediaType};base64,${(await readFile8(icon)).toString("base64")}`;
+}
+async function faviconAsset(folderName, assets) {
+  if (process.env.KENNEL_EXTERNAL_ICONS !== "1")
+    return;
+  const host = await folderWebsite(folderName);
+  if (!host)
+    return;
+  const key = `favicon:${host}`;
+  assets[key] = {
+    mediaType: "image/png",
+    source: "favicon",
+    url: `/api/folder-favicon?path=${encodeURIComponent(folderName)}&host=${encodeURIComponent(host)}`
+  };
+  return key;
+}
+async function iconWithFaviconFallback(folder, assets, assetFiles) {
+  return folderIcon(folder, assets, assetFiles, (folderName) => faviconAsset(folderName, assets));
+}
+async function hydrateFolderIcons(metadata, assetFiles) {
+  const assets = {};
+  const projects = metadata.projects?.items ?? [];
+  const [iconAssetKey, projectItems] = await Promise.all([
+    iconWithFaviconFallback(metadata.folder, assets, assetFiles),
+    Promise.all(projects.map(async (project) => ({
+      ...project,
+      iconAssetKey: await iconWithFaviconFallback(project.worktree, assets, assetFiles)
+    })))
+  ]);
+  return {
+    assets,
+    iconAssetKey,
+    projects: { items: projectItems }
+  };
+}
 async function workspaceBreadcrumbIcons(breadcrumbs, assetFiles, assets = {}) {
   return Promise.all(breadcrumbs.map(async (crumb) => {
     const iconAssetKey = await folderIcon(crumb.path, assets, assetFiles);
@@ -38753,8 +38805,9 @@ async function workspaceBreadcrumbIcons(breadcrumbs, assetFiles, assets = {}) {
     return icon ? { ...crumb, icon: { mediaType: icon.mediaType, url: icon.url } } : crumb;
   }));
 }
-var maxIconBytes2, iconTypes, iconExtensions;
+var maxIconBytes2, iconTypes, iconExtensions, maxSearchIconBytes, searchIconTypes;
 var init_folder_icons = __esm(() => {
+  init_folder_favicon();
   maxIconBytes2 = 4 * 1024 * 1024;
   iconTypes = new Map([
     [".jpeg", "image/jpeg"],
@@ -38765,6 +38818,16 @@ var init_folder_icons = __esm(() => {
     ["image/jpeg", "jpg"],
     ["image/png", "png"]
   ]);
+  maxSearchIconBytes = 512 * 1024;
+  searchIconTypes = new Map([
+    [".gif", "image/gif"],
+    [".ico", "image/x-icon"],
+    [".jpeg", "image/jpeg"],
+    [".jpg", "image/jpeg"],
+    [".png", "image/png"],
+    [".svg", "image/svg+xml"],
+    [".webp", "image/webp"]
+  ]);
 });
 
 // packages/notes/src/manifest.ts
@@ -38831,6 +38894,45 @@ async function loadNotes(folder, linkedFolders = []) {
     status: "available"
   };
 }
+function codeSpan(text) {
+  const escaped = text.replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029]/gu, (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`);
+  const longest = Math.max(0, ...(escaped.match(/`+/g) ?? []).map((run) => run.length));
+  const fence = "`".repeat(longest + 1);
+  const pad = escaped.startsWith("`") || escaped.endsWith("`") ? " " : "";
+  return `${fence}${pad}${escaped}${pad}${fence}`;
+}
+async function notesLlmSections({
+  folder,
+  linkedFolders = [],
+  signal
+}) {
+  const groups = [];
+  const notes = [];
+  for (const source of [folder, ...linkedFolders]) {
+    signal.throwIfAborted();
+    const files = await listMarkdownFiles(source);
+    const paths = files.map((file) => resolve10(source, file.relativePath));
+    groups.push({ folder: source, paths });
+    files.forEach((file, index) => notes.push({ activityAt: file.activityAt, path: paths[index] }));
+  }
+  if (notes.length === 0)
+    return [];
+  const recent = notes.sort((left, right) => right.activityAt - left.activityAt || (left.path < right.path ? -1 : left.path > right.path ? 1 : 0)).slice(0, llmNoteLimit);
+  return [
+    {
+      id: "notes",
+      title: "Markdown notes",
+      lines: [
+        ...groups.filter((group) => group.paths.length > 0).map((group) => `- Source: ${codeSpan(group.folder)} (${group.paths.length} ${group.paths.length === 1 ? "note" : "notes"})`),
+        `- Total notes: ${notes.length}`,
+        "",
+        `Most recently changed (${recent.length} of ${notes.length}):`,
+        "",
+        ...recent.map((note) => `- ${codeSpan(note.path)}`)
+      ]
+    }
+  ];
+}
 function createNotesPlugin() {
   return {
     ...notesManifest,
@@ -38845,10 +38947,11 @@ function createNotesPlugin() {
       linkedFolders
     }) {
       return { data: await loadNotes(folder, linkedFolders), kind: "available" };
-    }
+    },
+    llm: notesLlmSections
   };
 }
-var markdownExtensions;
+var markdownExtensions, llmNoteLimit = 20;
 var init_server3 = __esm(() => {
   init_manifest();
   markdownExtensions = new Set([".md", ".markdown"]);
@@ -38857,6 +38960,7 @@ var init_server3 = __esm(() => {
 // packages/api/src/server/plugins.ts
 import { pathToFileURL } from "node:url";
 import { existsSync as existsSync4 } from "node:fs";
+import { mkdir as mkdir3, readFile as readFile9, stat as stat7, writeFile as writeFile5 } from "node:fs/promises";
 import { dirname as dirname8, resolve as resolve11, sep as sep6 } from "node:path";
 function configuredFolderServerRegistry(registry, resolvedConfig) {
   const disabled = new Set(resolvedConfig.plugins.disable);
@@ -38867,6 +38971,41 @@ function configuredFolderServerRegistry(registry, resolvedConfig) {
   ];
   return new Map(ids.map((id) => [id, registry.get(id)]));
 }
+function stringArray(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function parsePluginRegistryConfig(content) {
+  const parsed = JSON.parse(content);
+  const config = parsed && typeof parsed === "object" ? parsed : {};
+  return {
+    plugins: {
+      disable: stringArray(config.plugins?.disable),
+      order: stringArray(config.plugins?.order)
+    }
+  };
+}
+async function nearestKennelConfig(folder) {
+  for (let current = folder;; current = dirname8(current)) {
+    const candidate = resolve11(current, "kennel.json");
+    const details = await stat7(candidate).catch(() => {
+      return;
+    });
+    if (details?.isFile())
+      return candidate;
+    if (dirname8(current) === current)
+      return;
+  }
+}
+async function folderPluginRegistryConfig(folder) {
+  const path = await nearestKennelConfig(folder);
+  if (!path)
+    return defaultPluginRegistryConfig;
+  try {
+    return parsePluginRegistryConfig(await readFile9(path, "utf8"));
+  } catch {
+    return defaultPluginRegistryConfig;
+  }
+}
 function createFolderServerPlugins() {
   return [createNotesPlugin()];
 }
@@ -38947,8 +39086,12 @@ async function externalApiHandlers() {
   }
   return handlers;
 }
+var defaultPluginRegistryConfig;
 var init_plugins = __esm(() => {
   init_server3();
+  defaultPluginRegistryConfig = {
+    plugins: { disable: [], order: [] }
+  };
 });
 
 // packages/api/src/server/linked-folder-discovery.ts
@@ -39174,7 +39317,7 @@ var init_project_discovery = __esm(() => {
 // packages/api/src/server/folder-metadata-plugin.ts
 import { createHash as createHash5 } from "node:crypto";
 import { realpathSync as realpathSync2 } from "node:fs";
-import { readdir as readdir5, readFile as readFile9, stat as stat7 } from "node:fs/promises";
+import { readdir as readdir5, readFile as readFile10, stat as stat8 } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
 import {
   basename as basename7,
@@ -39243,42 +39386,6 @@ function apiHostAllowed(value, remote) {
   const allowlist = (process.env.KENNEL_VIEWER_HOSTS ?? "").split(",").map((host) => host.trim().toLowerCase()).filter(Boolean);
   return allowlist.includes(hostname);
 }
-function decodeBase64Url2(value) {
-  const padded = `${value}${"=".repeat((4 - value.length % 4) % 4)}`;
-  return Buffer.from(padded.replaceAll("-", "+").replaceAll("_", "/"), "base64").toString("utf8");
-}
-async function searchIconDataUrl(icon) {
-  if (!icon)
-    return;
-  if (icon.startsWith("data:"))
-    return icon;
-  const mediaType = searchIconTypes.get(extname6(icon).toLowerCase());
-  if (!mediaType)
-    return;
-  const details = await stat7(icon).catch(() => {
-    return;
-  });
-  if (!details?.size || details.size > maxIconBytes3)
-    return;
-  return `data:${mediaType};base64,${(await readFile9(icon)).toString("base64")}`;
-}
-async function faviconAsset(folderName, assets) {
-  if (process.env.KENNEL_EXTERNAL_ICONS !== "1")
-    return;
-  const host = await folderWebsite(folderName);
-  if (!host)
-    return;
-  const key = `favicon:${host}`;
-  assets[key] = {
-    mediaType: "image/png",
-    source: "favicon",
-    url: `/api/folder-favicon?path=${encodeURIComponent(folderName)}&host=${encodeURIComponent(host)}`
-  };
-  return key;
-}
-async function iconWithFaviconFallback(folder, assets, assetFiles) {
-  return folderIcon(folder, assets, assetFiles, (folderName) => faviconAsset(folderName, assets));
-}
 async function repositoryIdentity(folder, assets) {
   const remoteUrl = await gitRemoteUrl(folder).catch(() => {
     return;
@@ -39302,22 +39409,6 @@ async function repositoryIdentity(folder, assets) {
     return;
   }
 }
-async function hydrateAssets(metadata, assetFiles) {
-  const assets = {};
-  const projects = metadata.projects?.items ?? [];
-  const [iconAssetKey, projectItems] = await Promise.all([
-    iconWithFaviconFallback(metadata.folder, assets, assetFiles),
-    Promise.all(projects.map(async (project) => ({
-      ...project,
-      iconAssetKey: await iconWithFaviconFallback(project.worktree, assets, assetFiles)
-    })))
-  ]);
-  return {
-    assets,
-    iconAssetKey,
-    projects: { items: projectItems }
-  };
-}
 function unique(values) {
   return [...new Set(values)];
 }
@@ -39329,8 +39420,8 @@ async function shallowMetadata(folder) {
   const visible = entries.filter((entry) => !entry.name.startsWith(".") && entry.name !== "node_modules");
   const files = await Promise.all(visible.filter((entry) => entry.isFile() && [".markdown", ".md"].includes(extname6(entry.name).toLowerCase())).map(async (entry) => {
     const path = resolve12(folder, entry.name);
-    const details = await stat7(path);
-    const content = await readFile9(path, "utf8").catch(() => "");
+    const details = await stat8(path);
+    const content = await readFile10(path, "utf8").catch(() => "");
     const title = markdownMetadata(content).title;
     return {
       activityAt: details.mtimeMs,
@@ -39384,7 +39475,7 @@ async function notesFiles(folder, files, origin) {
       const path = file.path ?? (file.relativePath ? resolve12(folder, file.relativePath) : undefined);
       if (!path)
         return origin ? { ...file, folder: origin } : file;
-      const content = [".markdown", ".md"].includes(extname6(path).toLowerCase()) ? await readFile9(path, "utf8").catch(() => "") : "";
+      const content = [".markdown", ".md"].includes(extname6(path).toLowerCase()) ? await readFile10(path, "utf8").catch(() => "") : "";
       const title = content ? markdownMetadata(content).title : undefined;
       return {
         ...file,
@@ -39502,41 +39593,6 @@ async function projectSearchItem(project, match) {
     worktree: project.worktree
   };
 }
-function stringArray(value) {
-  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
-}
-function parsePluginRegistryConfig(content) {
-  const parsed = JSON.parse(content);
-  const config = parsed && typeof parsed === "object" ? parsed : {};
-  return {
-    plugins: {
-      disable: stringArray(config.plugins?.disable),
-      order: stringArray(config.plugins?.order)
-    }
-  };
-}
-async function nearestKennelConfig(folder) {
-  for (let current = folder;; current = dirname10(current)) {
-    const candidate = resolve12(current, "kennel.json");
-    const details = await stat7(candidate).catch(() => {
-      return;
-    });
-    if (details?.isFile())
-      return candidate;
-    if (dirname10(current) === current)
-      return;
-  }
-}
-async function folderPluginRegistryConfig(folder) {
-  const path = await nearestKennelConfig(folder);
-  if (!path)
-    return defaultPluginRegistryConfig;
-  try {
-    return parsePluginRegistryConfig(await readFile9(path, "utf8"));
-  } catch {
-    return defaultPluginRegistryConfig;
-  }
-}
 function pluginConfigWarnings(registry, config) {
   const ids = unique([...config.plugins.disable, ...config.plugins.order]);
   return ids.filter((id) => !registry.has(id)).map((id) => `unknown plugin id "${id}" — not installed in this build`);
@@ -39712,7 +39768,7 @@ function createFolderApi({
               "Content-Type": asset.mediaType,
               ETag: `"${hash}"`
             });
-            response.end(await readFile9(asset.path));
+            response.end(await readFile10(asset.path));
           } catch (error) {
             response.writeHead(404, {
               "Content-Type": "text/plain; charset=utf-8"
@@ -39791,7 +39847,7 @@ function createFolderApi({
               {
                 path: relative11(folder, target.path),
                 kind: target.kind,
-                content: previewTextKind(target.kind) ? await readFile9(target.path, "utf8") : ""
+                content: previewTextKind(target.kind) ? await readFile10(target.path, "utf8") : ""
               }
             ] : []
           } : await readFolder(folder);
@@ -39807,7 +39863,7 @@ function createFolderApi({
               documentError(response);
               return;
             }
-            const details = await stat7(target.path);
+            const details = await stat8(target.path);
             if (!details.isFile()) {
               documentError(response);
               return;
@@ -39819,7 +39875,7 @@ function createFolderApi({
               return;
             }
             watch(folder);
-            const content = previewTextKind(target.kind) ? await readFile9(target.path, "utf8") : "";
+            const content = previewTextKind(target.kind) ? await readFile10(target.path, "utf8") : "";
             sendContract(response, url, {
               content,
               kind: target.kind,
@@ -39848,7 +39904,7 @@ function createFolderApi({
               documentError(response);
               return;
             }
-            const details = await stat7(target.path);
+            const details = await stat8(target.path);
             if (!details.isFile()) {
               documentError(response);
               return;
@@ -39872,7 +39928,7 @@ function createFolderApi({
                 "Content-Disposition": `attachment; filename="${basename7(target.path)}"`
               } : {}
             });
-            response.end(await readFile9(target.path));
+            response.end(await readFile10(target.path));
           } catch (error) {
             documentError(response);
           }
@@ -39886,7 +39942,7 @@ function createFolderApi({
               documentError(response);
               return;
             }
-            const details = await stat7(target.path);
+            const details = await stat8(target.path);
             if (!details.isFile()) {
               documentError(response);
               return;
@@ -39898,7 +39954,7 @@ function createFolderApi({
               return;
             }
             watch(folder);
-            const data = await readFile9(target.path);
+            const data = await readFile10(target.path);
             const baseHeaders = {
               "Accept-Ranges": "bytes",
               "Cache-Control": "private, max-age=0, must-revalidate",
@@ -40155,7 +40211,7 @@ function createFolderApi({
               response.off("close", cancel);
             }
             const [hydrated, workspace] = await Promise.all([
-              hydrateAssets({ folder, projects: { items: projects } }, assetFiles),
+              hydrateFolderIcons({ folder, projects: { items: projects } }, assetFiles),
               readWorkspace(folder)
             ]);
             workspace.breadcrumbs = await workspaceBreadcrumbIcons(workspace.breadcrumbs ?? [], assetFiles, hydrated.assets);
@@ -40168,7 +40224,7 @@ function createFolderApi({
             return;
           }
           const metadata = machine ? await shallowMetadata(folder) : await loadFolderData(folder);
-          const assets = await hydrateAssets(metadata, assetFiles);
+          const assets = await hydrateFolderIcons(metadata, assetFiles);
           const body = {
             ...metadata,
             ...assets,
@@ -40186,7 +40242,7 @@ function createFolderApi({
     }
   };
 }
-var applyProjectFavorites, buildProjectCatalog, buildProjectSearchIndex, catalogProjectToLocalProject, discoverProjectIcon, discoverProjectsUnderFolder, listLocalMarkdownFiles, projectRepositoryAccessory, projectSubtitle, projectTitle, readRaggleUserSettings, gitRemoteUrl, githubRepositoryPath, repositoryDisplayName, searchProjectIndex, sortProjectList, maxIconBytes3, iconTypes2, iconExtensions2, searchIconTypes, projectSearchCacheMs = 5000, metadataExtensions, loopbackServerHosts, defaultPluginRegistryConfig;
+var applyProjectFavorites, buildProjectCatalog, buildProjectSearchIndex, catalogProjectToLocalProject, discoverProjectIcon, discoverProjectsUnderFolder, listLocalMarkdownFiles, projectRepositoryAccessory, projectSubtitle, projectTitle, readRaggleUserSettings, gitRemoteUrl, githubRepositoryPath, repositoryDisplayName, searchProjectIndex, sortProjectList, projectSearchCacheMs = 5000, metadataExtensions, loopbackServerHosts;
 var init_folder_metadata_plugin = __esm(() => {
   init_contracts();
   init_markdown();
@@ -40225,25 +40281,6 @@ var init_folder_metadata_plugin = __esm(() => {
     searchProjectIndex,
     sortProjectList
   } = local);
-  maxIconBytes3 = 512 * 1024;
-  iconTypes2 = new Map([
-    [".jpeg", "image/jpeg"],
-    [".jpg", "image/jpeg"],
-    [".png", "image/png"]
-  ]);
-  iconExtensions2 = new Map([
-    ["image/jpeg", "jpg"],
-    ["image/png", "png"]
-  ]);
-  searchIconTypes = new Map([
-    [".gif", "image/gif"],
-    [".ico", "image/x-icon"],
-    [".jpeg", "image/jpeg"],
-    [".jpg", "image/jpeg"],
-    [".png", "image/png"],
-    [".svg", "image/svg+xml"],
-    [".webp", "image/webp"]
-  ]);
   metadataExtensions = new Set([
     ".html",
     ".jpeg",
@@ -40262,16 +40299,13 @@ var init_folder_metadata_plugin = __esm(() => {
     undefined,
     false
   ]);
-  defaultPluginRegistryConfig = {
-    plugins: { disable: [], order: [] }
-  };
 });
 
 // packages/api/src/server/index.ts
 import {
   createServer
 } from "node:http";
-import { readFile as readFile10, realpath as realpath5, stat as stat8 } from "node:fs/promises";
+import { readFile as readFile11, realpath as realpath5, stat as stat9 } from "node:fs/promises";
 import { extname as extname7, isAbsolute as isAbsolute7, relative as relative12, resolve as resolve13 } from "node:path";
 async function sendFile(request, response, directory, pathname, fallback) {
   const root = await realpath5(directory);
@@ -40285,7 +40319,7 @@ async function sendFile(request, response, directory, pathname, fallback) {
     response.end();
     return;
   }
-  if (!(await stat8(target).catch(() => null))?.isFile()) {
+  if (!(await stat9(target).catch(() => null))?.isFile()) {
     if (!fallback) {
       response.writeHead(404);
       response.end();
@@ -40303,7 +40337,7 @@ async function sendFile(request, response, directory, pathname, fallback) {
     "Content-Type": contentTypes[extname7(target)] ?? "application/octet-stream",
     "X-Content-Type-Options": "nosniff"
   });
-  response.end(request.method === "HEAD" ? undefined : await readFile10(target));
+  response.end(request.method === "HEAD" ? undefined : await readFile11(target));
 }
 function createKennelApi(options) {
   const remote = options.remoteAccess || !isLoopbackServerHost(options.host);

package/dist/plugins/external.d.ts

@@ -83,6 +83,12 @@ export type PluginBuild = {
 };
 /** Points the core runtime at a plugin build. */
 export declare function usePluginBuild(build: PluginBuild): void;
+/**
+ * The pinned build of the installed plugins, read without building. `knl llm`
+ * uses it: a missing or stale build is an error, never a browser build or an
+ * install during context generation.
+ */
+export declare function readPluginBuild(plugins?: ExternalPluginEntry[]): Promise<PluginBuild>;
 /**
  * Compiles the installed external plugins once per plugin set. The host web
  * app is never rebuilt: plugin browser modules load at runtime against the

package/dist/plugins/external.js

@@ -350,6 +350,8 @@ async function validateImports(entry) {
             throw new Error("server id mismatch");
         if (typeof server.detect !== "function" || typeof server.handle !== "function")
             throw new Error("server export missing detect/handle");
+        if (server.llm !== undefined && typeof server.llm !== "function")
+            throw new Error("server export llm hook must be a function");
         if (!client || typeof client !== "object" || client.id !== entry.id)
             throw new Error("client id mismatch");
         if (typeof client.component !== "function")
@@ -570,6 +572,20 @@ async function readBuildMarker(marker, key) {
         return undefined;
     }
 }
+/**
+ * The pinned build of the installed plugins, read without building. `knl llm`
+ * uses it: a missing or stale build is an error, never a browser build or an
+ * install during context generation.
+ */
+export async function readPluginBuild(plugins = readExternalPlugins()) {
+    const key = pluginSetKey(plugins);
+    if (plugins.length === 0)
+        return { key, serverEntries: [], apiEntries: [] };
+    const build = await readBuildMarker(join(buildRoot(key), "build.json"), key);
+    if (build)
+        return build;
+    throw new Error(`The installed plugin build is missing or stale (${plugins.map((plugin) => plugin.id).join(", ")}). Refresh each changed plugin with \`kennel plugin add <source>\`, or run knl llm --no-plugins.`);
+}
 function acquireBuildLock(key) {
     const locks = join(cacheRoot(), "plugin-builds", ".locks");
     mkdirSync(locks, { recursive: true });

package/dist/site/server-plugins.d.ts

@@ -19,6 +19,18 @@ export declare class FolderPluginFailure extends Error {
     constructor(message: string);
 }
 export declare function folderServerRegistry(): Map<string, FolderPluginServer>;
+/** Core plugins plus the installed plugins named by the active plugin build. */
+export declare function folderServerRegistryAsync(): Promise<Map<string, FolderPluginServer>>;
+export type FolderPluginRegistryConfig = {
+    plugins: {
+        disable: string[];
+        order: string[];
+    };
+};
+/** Applies kennel.json disable/order settings to a registry; never adds plugins. */
+export declare function configuredFolderServerRegistry(registry: Map<string, FolderPluginServer>, config: FolderPluginRegistryConfig): Map<string, FolderPluginServer>;
+/** Reads the plugin settings from the folder's nearest kennel.json. */
+export declare function folderPluginRegistryConfig(folder: string): Promise<FolderPluginRegistryConfig>;
 export type FolderPluginScaffoldFile = {
     plugin: string;
     path: string;