kennel 0.2.30 → 0.2.32

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.30",
+  "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.13",
+    "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"]
 }

package/dist/site/folder-icons.d.ts

@@ -1,39 +0,0 @@
-export type IconMediaType = 'image/jpeg' | 'image/png';
-export type IconAsset = {
-    mediaType: IconMediaType;
-    source: 'local' | 'favicon';
-    url: string;
-};
-/**
- * Optional fallback for folders without a local icon (external website
- * favicon, data URL, ...). Receives the folder and the shared asset record
- * and returns a new asset key when it produced an asset.
- */
-export type FolderIconFallback = (folder: string, assets: Record<string, IconAsset>) => Promise<string | undefined>;
-/**
- * Folder icons are served as immutable, content-addressed assets, so the
- * cap is generous: it only guards against pathological files, not normal
- * photos that happen to be named icon.png (e.g. a 700 KiB folder photo).
- */
-export declare const maxIconBytes: number;
-export declare function assetKey(value: Buffer): string;
-export declare function encodeBase64Url(value: string): string;
-export declare function decodeBase64Url(value: string): string;
-export declare function iconUrl(folder: string, hash: string, mediaType: IconMediaType): string;
-export declare function folderIcon(folder: string, assets: Record<string, IconAsset>, assetFiles: Map<string, {
-    mediaType: IconMediaType;
-    path: string;
-}>, fallback?: FolderIconFallback): Promise<string | undefined>;
-/**
- * Attach the nearest ancestor icon to each workspace breadcrumb so the
- * client can render folder icons in the header and breadcrumb dropdown.
- * Icons are registered as immutable assets served by `/api/folders/...`.
- */
-export declare function workspaceBreadcrumbIcons<B extends {
-    path: string;
-}>(breadcrumbs: B[], assetFiles: Map<string, {
-    mediaType: IconMediaType;
-    path: string;
-}>, assets?: Record<string, IconAsset>): Promise<Array<B & {
-    icon?: Pick<IconAsset, 'mediaType' | 'url'>;
-}>>;

package/dist/site/folder-icons.js

@@ -1,68 +0,0 @@
-import { createHash } from 'node:crypto';
-import { readFile, stat } from 'node:fs/promises';
-import { extname } from 'node:path';
-import { discoverFolderIcon } from '@raggle-ai/local';
-/**
- * Folder icons are served as immutable, content-addressed assets, so the
- * cap is generous: it only guards against pathological files, not normal
- * photos that happen to be named icon.png (e.g. a 700 KiB folder photo).
- */
-export const maxIconBytes = 4 * 1024 * 1024;
-const iconTypes = new Map([
-    ['.jpeg', 'image/jpeg'],
-    ['.jpg', 'image/jpeg'],
-    ['.png', 'image/png'],
-]);
-const iconExtensions = new Map([
-    ['image/jpeg', 'jpg'],
-    ['image/png', 'png'],
-]);
-export function assetKey(value) {
-    return createHash('sha256').update(value).digest('hex');
-}
-export function encodeBase64Url(value) {
-    return Buffer.from(value, 'utf8')
-        .toString('base64')
-        .replaceAll('+', '-')
-        .replaceAll('/', '_')
-        .replaceAll('=', '');
-}
-export function decodeBase64Url(value) {
-    const padded = `${value}${'='.repeat((4 - (value.length % 4)) % 4)}`;
-    return Buffer.from(padded.replaceAll('-', '+').replaceAll('_', '/'), 'base64').toString('utf8');
-}
-export function iconUrl(folder, hash, mediaType) {
-    return `/api/folders/${encodeBase64Url(folder)}/assets/${hash}.${iconExtensions.get(mediaType)}`;
-}
-export async function folderIcon(folder, assets, assetFiles, fallback) {
-    const icon = discoverFolderIcon(folder);
-    const mediaType = icon ? iconTypes.get(extname(icon).toLowerCase()) : null;
-    const details = icon && mediaType ? await stat(icon).catch(() => undefined) : undefined;
-    if (!icon || !mediaType || !details?.size || details.size > maxIconBytes) {
-        return fallback ? await fallback(folder, assets) : undefined;
-    }
-    const data = await readFile(icon);
-    const hash = assetKey(data);
-    const key = `local:${hash}`;
-    assetFiles.set(hash, { mediaType, path: icon });
-    assets[key] = {
-        mediaType,
-        source: 'local',
-        url: iconUrl(folder, hash, mediaType),
-    };
-    return key;
-}
-/**
- * Attach the nearest ancestor icon to each workspace breadcrumb so the
- * client can render folder icons in the header and breadcrumb dropdown.
- * Icons are registered as immutable assets served by `/api/folders/...`.
- */
-export async function workspaceBreadcrumbIcons(breadcrumbs, assetFiles, assets = {}) {
-    return Promise.all(breadcrumbs.map(async (crumb) => {
-        const iconAssetKey = await folderIcon(crumb.path, assets, assetFiles);
-        const icon = iconAssetKey ? assets[iconAssetKey] : undefined;
-        return icon
-            ? { ...crumb, icon: { mediaType: icon.mediaType, url: icon.url } }
-            : crumb;
-    }));
-}