kennel 0.2.31 → 0.2.32

package/dist/package/preview.js

@@ -38894,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,
@@ -38908,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"]);
@@ -38920,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);
@@ -38930,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()];
 }
@@ -39010,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
@@ -39237,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,
@@ -39340,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,
@@ -39395,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,
@@ -39513,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`);
@@ -39723,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"
@@ -39802,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);
@@ -39818,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;
@@ -39830,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,
@@ -39859,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;
@@ -39883,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);
           }
@@ -39897,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;
@@ -39909,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",
@@ -40197,7 +40242,7 @@ function createFolderApi({
     }
   };
 }
-var applyProjectFavorites, buildProjectCatalog, buildProjectSearchIndex, catalogProjectToLocalProject, discoverProjectIcon, discoverProjectsUnderFolder, listLocalMarkdownFiles, projectRepositoryAccessory, projectSubtitle, projectTitle, readRaggleUserSettings, gitRemoteUrl, githubRepositoryPath, repositoryDisplayName, searchProjectIndex, sortProjectList, 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();
@@ -40254,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);
@@ -40277,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();
@@ -40295,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;

package/dist/site/server-plugins.js

@@ -1,7 +1,7 @@
 // packages/api/src/server/plugins.ts
 import { pathToFileURL } from "node:url";
 import { existsSync } from "node:fs";
-import { mkdir, stat as stat2, writeFile } from "node:fs/promises";
+import { mkdir, readFile, stat as stat2, writeFile } from "node:fs/promises";
 import { dirname, resolve as resolve2, sep as sep2 } from "node:path";
 
 // packages/plugins/src/server.ts
@@ -31,6 +31,7 @@ var notesManifest = {
 
 // packages/notes/src/server.ts
 var markdownExtensions = new Set([".md", ".markdown"]);
+var llmNoteLimit = 20;
 async function listMarkdownFiles(folder) {
   const files = [];
   const visit = async (current) => {
@@ -76,6 +77,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) => resolve(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,
@@ -90,7 +130,8 @@ function createNotesPlugin() {
       linkedFolders
     }) {
       return { data: await loadNotes(folder, linkedFolders), kind: "available" };
-    }
+    },
+    llm: notesLlmSections
   };
 }
 
@@ -104,6 +145,44 @@ function configuredFolderServerRegistry(registry, resolvedConfig) {
   ];
   return new Map(ids.map((id) => [id, registry.get(id)]));
 }
+var defaultPluginRegistryConfig = {
+  plugins: { disable: [], order: [] }
+};
+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 = dirname(current)) {
+    const candidate = resolve2(current, "kennel.json");
+    const details = await stat2(candidate).catch(() => {
+      return;
+    });
+    if (details?.isFile())
+      return candidate;
+    if (dirname(current) === current)
+      return;
+  }
+}
+async function folderPluginRegistryConfig(folder) {
+  const path = await nearestKennelConfig(folder);
+  if (!path)
+    return defaultPluginRegistryConfig;
+  try {
+    return parsePluginRegistryConfig(await readFile(path, "utf8"));
+  } catch {
+    return defaultPluginRegistryConfig;
+  }
+}
 function createFolderServerPlugins() {
   return [createNotesPlugin()];
 }
@@ -225,6 +304,7 @@ export {
   configuredFolderServerRegistry,
   createFolderServerPlugins,
   externalApiHandlers,
+  folderPluginRegistryConfig,
   folderServerRegistry,
   folderServerRegistryAsync,
   scaffoldFolderPlugins

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kennel",
-  "version": "0.2.31",
+  "version": "0.2.32",
   "description": "Open-source pop-up previews for AI output: markdown, HTML artifacts, email, images, code, tables, notes, and calendars, from the terminal or your agent session.",
   "type": "module",
   "license": "MIT",
@@ -67,7 +67,7 @@
     "effect": "^3.19.7",
     "esbuild": "^0.27.0",
     "kennel-mcp": "https://registry.npmjs.org/%40raggle-ai%2fkennel-mcp/-/kennel-mcp-0.1.8.tgz",
-    "kennel-plugins": "0.1.14",
+    "kennel-plugins": "0.1.15",
     "koffi": "^3.3.1",
     "lucide-react": "^0.562.0",
     "radix-ui": "^1.6.7",
@@ -84,6 +84,7 @@
   "devDependencies": {
     "@types/node": "^22.13.4",
     "kennel-api": "0.1.0",
+    "kennel-llm": "0.1.0",
     "kennel-preview": "0.1.0",
     "typescript": "^5.9.3"
   },

package/templates/plugin/package.json

@@ -4,6 +4,7 @@
   "private": true,
   "type": "module",
   "devDependencies": {
+    "@types/node": "latest",
     "@types/react": "latest",
     "kennel-plugins": "latest",
     "typescript": "latest"

package/templates/plugin/server.ts

@@ -1,7 +1,29 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
 import type { FolderPluginServer } from "kennel-plugins/server";
 
 import manifest from "./manifest";
 
+// Example content file read by the `llm` hook below: a JSON array of items
+// with a string `title`, for example [{ "title": "First item" }].
+const CONTENT_FILE = "__PLUGIN_ID__.json";
+
+async function readItems(folder: string) {
+  const source = join(folder, CONTENT_FILE);
+  let text: string;
+  try {
+    text = await readFile(source, "utf8");
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === "ENOENT") return undefined;
+    throw error;
+  }
+  const items: unknown = JSON.parse(text);
+  if (!Array.isArray(items) || !items.every((item) => typeof item?.title === "string")) {
+    throw new Error(`${source} must be a JSON array of items with a string title`);
+  }
+  return { source, titles: items.map((item: { title: string }) => item.title) };
+}
+
 export default {
   ...manifest,
   async detect() {
@@ -10,4 +32,25 @@ export default {
   async handle() {
     return { data: { items: [] } };
   },
+  // Optional `knl llm` context. Read only: no writes, network calls, or other
+  // side effects. Return [] when the folder has no content for this plugin.
+  // The host adds the headings; each line is one Markdown line without line
+  // breaks or headings. Invalid output or a thrown error fails `knl llm`.
+  async llm({ folder, signal }) {
+    signal.throwIfAborted();
+    const items = await readItems(folder);
+    if (!items) return [];
+    return [
+      {
+        id: "summary",
+        title: "Summary",
+        lines: [
+          `- Source: ${items.source}`,
+          `- Items: ${items.titles.length}`,
+          ...items.titles.slice(0, 5).map((title) => `- Item: ${title}`),
+          "- Use the source file as the authority for these items.",
+        ],
+      },
+    ];
+  },
 } satisfies FolderPluginServer;

package/templates/plugin/tsconfig.json

@@ -5,7 +5,7 @@
     "moduleResolution": "NodeNext",
     "strict": true,
     "target": "ES2022",
-    "types": []
+    "types": ["node"]
   },
   "include": ["*.ts", "*.tsx"]
 }