kennel 0.2.41 → 0.2.42

package/dist/package/preview.js

@@ -242,7 +242,7 @@ function repositoryName(folder) {
     return;
   }
 }
-function previewTerminal(url, target, startShare) {
+function previewTerminal(url, target, startShare, views) {
   url = new URL(url).href;
   const input = process.stdin;
   const output = process.stdout;
@@ -253,8 +253,9 @@ function previewTerminal(url, target, startShare) {
   const repository = interactive ? repositoryName(target.root) : undefined;
   const color = terminal && process.env.NO_COLOR === undefined && output.hasColors();
   const accent = (text) => color ? `\x1B[32m${text}\x1B[39m` : text;
-  const link = (label) => terminal ? `\x1B]8;;${url}\x1B\\${accent(label)}\x1B]8;;\x1B\\` : `${label}
-  ${url}`;
+  const linkTo = (label, href, plain = `${label}
+${href}`) => terminal ? `\x1B]8;;${href}\x07${accent(label)}\x1B]8;;\x07` : plain;
+  const link = (label) => linkTo(label, url);
   const wasRaw = Boolean(input.isRaw);
   const wasFlowing = input.readableFlowing === true;
   let resolveClosed;
@@ -271,27 +272,28 @@ function previewTerminal(url, target, startShare) {
       return;
     cursorTo(output, 0, 0);
     clearScreenDown(output);
-    const width = Math.max(1, (output.columns || 80) - 5);
+    const width = Math.max(1, (output.columns || 80) - 1);
     const fit = (text) => {
       const characters = Array.from(terminalText(text));
       return characters.length > width ? characters.slice(0, width - 1).join("") + "…" : characters.join("");
     };
-    const count = Math.max(1, Math.min(8, (output.rows || 24) - 12));
-    const start = Math.max(0, Math.min(selected - Math.floor(count / 2), actions.length - count));
-    const choices = actions.slice(start, start + count).map((item, index) => {
+    const choices = [];
+    actions.forEach((item, index) => {
       const label = fit(item.shortcut ? `[${item.shortcut}] ${item.label}` : item.label);
-      return start + index === selected ? accent(`  › ${label}`) : `    ${label}`;
+      let text = index === selected ? accent(`› ${label}`) : `  ${label}`;
+      if (item.view !== undefined)
+        text = linkTo(text, item.view, accent(text));
+      choices.push(text);
     });
     output.write([
-      `  \x1B[1m${link(fit(title))}\x1B[22m`,
-      ...repository ? [`  ${color ? "\x1B[2m" : ""}${fit(repository)}${color ? "\x1B[22m" : ""}`] : [],
-      ...target.target ? [`  File: ${fit(name)}`] : [],
+      `\x1B[1m${link(fit(title))}\x1B[22m`,
+      ...repository ? [`${color ? "\x1B[2m" : ""}${fit(repository)}${color ? "\x1B[22m" : ""}`] : [],
+      ...target.target ? [`File: ${fit(name)}`] : [],
       "",
       ...choices,
       "",
-      "  ↑ ↓ to move · Enter to choose · Esc or Ctrl+C to exit",
-      ...actions.length > count ? [`  ${selected + 1} / ${actions.length}`] : [],
-      ...status ? ["", `  ${status}`] : [],
+      "↑ ↓ to move · Enter to choose · Esc or Ctrl+C to exit",
+      ...status ? ["", status] : [],
       ""
     ].join(`
 `));
@@ -356,6 +358,10 @@ function previewTerminal(url, target, startShare) {
       resolveClosed();
   };
   const actions = [
+    ...(views ?? []).map((view) => ({ label: view.id, run: () => {
+      openPreview(view.url);
+      status = "Browser open requested.";
+    }, view: view.url })),
     { label: "Open in browser", shortcut: "o", run: () => {
       openPreview(url);
       status = "Browser open requested.";
@@ -415,7 +421,7 @@ function previewTerminal(url, target, startShare) {
     render();
   else
     console.log(`
-  ${link(name)}
+${link(name)}
 `);
   return { close, closed, interactive };
 }

package/dist/plugins/external.d.ts

@@ -25,6 +25,11 @@ export type ExternalPluginEntry = {
             digest: string;
         };
     };
+    /** Manifest-declared subviews, recorded at install time. */
+    views?: {
+        subpath: string;
+        label: string;
+    }[];
 };
 export declare function kennelConfigPath(): string;
 export declare const PLUGIN_SOURCE_IGNORED: Set<string>;

package/dist/plugins/external.js

@@ -373,6 +373,12 @@ async function validateImports(entry) {
             if (typeof apiModule.default !== "function")
                 throw new Error("API default export missing handler");
         }
+        if (Array.isArray(manifest.views)) {
+            entry.views = manifest.views.map((view) => ({
+                subpath: view.subpath,
+                label: view.label,
+            }));
+        }
     }
     finally {
         await rm(dir, { force: true, recursive: true });

package/dist/site/hot-viewer.js

@@ -6,7 +6,7 @@ import { createConnection } from 'node:net';
 import { tmpdir } from 'node:os';
 import { dirname, relative, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { popUrl } from './viewer.js';
+import { popUrl, pluginViewLinks } from './viewer.js';
 import { createKennelClient } from '../core/api-client.js';
 import { pluginSetKey } from '../plugins/external.js';
 import { openPreview, previewTerminal } from './terminal.js';
@@ -179,7 +179,7 @@ export async function hotViewer(options, restarting = false) {
                 return hotViewer(options, true);
             throw new Error(stale);
         }
-        const terminal = previewTerminal(viewerUrl, options);
+        const terminal = previewTerminal(viewerUrl, options, pluginViewLinks(viewerUrl, options.root));
         if (options.open)
             openPreview(viewerUrl);
         try {
@@ -245,7 +245,7 @@ export async function hotViewer(options, restarting = false) {
         },
         stdio: ['ignore', 'inherit', 'inherit'],
     });
-    const terminal = previewTerminal(viewerUrl, options);
+    const terminal = previewTerminal(viewerUrl, options, pluginViewLinks(viewerUrl, options.root));
     void terminal.closed.then(() => {
         if (child.exitCode === null && child.signalCode === null)
             child.kill('SIGTERM');

package/dist/site/terminal.d.ts

@@ -1,8 +1,13 @@
 export { openPreview } from "kennel-preview/terminal";
+/** Extra list entries rendered as hyperlinked plugin view links. */
+export type PluginView = {
+    id: string;
+    url: string;
+};
 export declare function previewTerminal(url: string, target: {
     root: string;
     target?: string;
-}): {
+}, views: PluginView[]): {
     close: () => void;
     closed: Promise<void>;
     interactive: boolean;

package/dist/site/terminal.js

@@ -31,7 +31,7 @@ function repositoryName(folder) {
     return;
   }
 }
-function previewTerminal(url, target, startShare) {
+function previewTerminal(url, target, startShare, views) {
   url = new URL(url).href;
   const input = process.stdin;
   const output = process.stdout;
@@ -42,8 +42,9 @@ function previewTerminal(url, target, startShare) {
   const repository = interactive ? repositoryName(target.root) : undefined;
   const color = terminal && process.env.NO_COLOR === undefined && output.hasColors();
   const accent = (text) => color ? `\x1B[32m${text}\x1B[39m` : text;
-  const link = (label) => terminal ? `\x1B]8;;${url}\x1B\\${accent(label)}\x1B]8;;\x1B\\` : `${label}
-  ${url}`;
+  const linkTo = (label, href, plain = `${label}
+${href}`) => terminal ? `\x1B]8;;${href}\x07${accent(label)}\x1B]8;;\x07` : plain;
+  const link = (label) => linkTo(label, url);
   const wasRaw = Boolean(input.isRaw);
   const wasFlowing = input.readableFlowing === true;
   let resolveClosed;
@@ -60,27 +61,28 @@ function previewTerminal(url, target, startShare) {
       return;
     cursorTo(output, 0, 0);
     clearScreenDown(output);
-    const width = Math.max(1, (output.columns || 80) - 5);
+    const width = Math.max(1, (output.columns || 80) - 1);
     const fit = (text) => {
       const characters = Array.from(terminalText(text));
       return characters.length > width ? characters.slice(0, width - 1).join("") + "…" : characters.join("");
     };
-    const count = Math.max(1, Math.min(8, (output.rows || 24) - 12));
-    const start = Math.max(0, Math.min(selected - Math.floor(count / 2), actions.length - count));
-    const choices = actions.slice(start, start + count).map((item, index) => {
+    const choices = [];
+    actions.forEach((item, index) => {
       const label = fit(item.shortcut ? `[${item.shortcut}] ${item.label}` : item.label);
-      return start + index === selected ? accent(`  › ${label}`) : `    ${label}`;
+      let text = index === selected ? accent(`› ${label}`) : `  ${label}`;
+      if (item.view !== undefined)
+        text = linkTo(text, item.view, accent(text));
+      choices.push(text);
     });
     output.write([
-      `  \x1B[1m${link(fit(title))}\x1B[22m`,
-      ...repository ? [`  ${color ? "\x1B[2m" : ""}${fit(repository)}${color ? "\x1B[22m" : ""}`] : [],
-      ...target.target ? [`  File: ${fit(name)}`] : [],
+      `\x1B[1m${link(fit(title))}\x1B[22m`,
+      ...repository ? [`${color ? "\x1B[2m" : ""}${fit(repository)}${color ? "\x1B[22m" : ""}`] : [],
+      ...target.target ? [`File: ${fit(name)}`] : [],
       "",
       ...choices,
       "",
-      "  ↑ ↓ to move · Enter to choose · Esc or Ctrl+C to exit",
-      ...actions.length > count ? [`  ${selected + 1} / ${actions.length}`] : [],
-      ...status ? ["", `  ${status}`] : [],
+      "↑ ↓ to move · Enter to choose · Esc or Ctrl+C to exit",
+      ...status ? ["", status] : [],
       ""
     ].join(`
 `));
@@ -145,6 +147,10 @@ function previewTerminal(url, target, startShare) {
       resolveClosed();
   };
   const actions = [
+    ...(views ?? []).map((view) => ({ label: view.id, run: () => {
+      openPreview(view.url);
+      status = "Browser open requested.";
+    }, view: view.url })),
     { label: "Open in browser", shortcut: "o", run: () => {
       openPreview(url);
       status = "Browser open requested.";
@@ -204,17 +210,17 @@ function previewTerminal(url, target, startShare) {
     render();
   else
     console.log(`
-  ${link(name)}
+${link(name)}
 `);
   return { close, closed, interactive };
 }
 
 // packages/cli/src/site/terminal.ts
-function previewTerminal2(url, target) {
+function previewTerminal2(url, target, views) {
   return previewTerminal(url, target, async (password = false) => {
     const { startPreviewShare } = await import(new URL("../package/preview.js", import.meta.url).href);
     return startPreviewShare({ ...target, ...password ? { password: true } : {} });
-  });
+  }, views);
 }
 export {
   openPreview,

package/dist/site/viewer.d.ts

@@ -1,3 +1,6 @@
+import { type PluginView } from "./terminal.js";
+/** Installed-plugin view links for the terminal menu; each is hyperlinked. */
+export declare function pluginViewLinks(viewerUrl: string, root: string): PluginView[];
 export type ViewerOptions = {
     dryRun: boolean;
     host: string;

package/dist/site/viewer.js

@@ -2,8 +2,25 @@ import { execFileSync } from "node:child_process";
 import { existsSync, realpathSync, statSync } from "node:fs";
 import { createServer } from "node:net";
 import { dirname, isAbsolute, relative, resolve } from "node:path";
+import { readExternalPlugins } from "../plugins/external.js";
 import { previewKind } from "./kinds.js";
 import { openPreview, previewTerminal } from "./terminal.js";
+/** Installed-plugin view links for the terminal menu; each is hyperlinked. */
+export function pluginViewLinks(viewerUrl, root) {
+    return readExternalPlugins().flatMap((plugin) => {
+        const view = (subpath) => {
+            const url = new URL(viewerUrl);
+            url.pathname = `/folder/${encodeBase64Url(root)}/views/${encodeURIComponent(plugin.id)}${subpath ? `/${encodeURIComponent(subpath)}` : ""}`;
+            // A query `folder` makes the route parser ignore the path and select Notes.
+            url.searchParams.delete("folder");
+            return url.href;
+        };
+        const views = [{ id: plugin.id, url: view() }];
+        for (const item of plugin.views ?? [])
+            views.push({ id: `${plugin.id} · ${item.label}`, url: view(item.subpath) });
+        return views;
+    });
+}
 export function viewerFolder(root, value) {
     return resolve(value ?? root);
 }
@@ -312,7 +329,7 @@ export async function viewer(input, plugin) {
                 existing.kernelKey === plugins.key &&
                 isSameOrDescendant(existing.root, options.root)))) {
         const viewerUrl = popUrl(displayHost, options.port, options);
-        const terminal = previewTerminal(viewerUrl, options);
+        const terminal = previewTerminal(viewerUrl, options, pluginViewLinks(viewerUrl, options.root));
         if (options.open)
             openPreview(viewerUrl);
         try {
@@ -342,7 +359,7 @@ export async function viewer(input, plugin) {
             execFileSync("tailscale", ["serve", "--bg", "--yes", options.port]);
         }
         const viewerUrl = popUrl(displayHost, options.port, options);
-        const terminal = previewTerminal(viewerUrl, options);
+        const terminal = previewTerminal(viewerUrl, options, pluginViewLinks(viewerUrl, options.root));
         if (options.open)
             openPreview(viewerUrl);
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kennel",
-  "version": "0.2.41",
+  "version": "0.2.42",
   "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",

package/schemas/config.schema.json

@@ -100,6 +100,20 @@
           "pattern": "^(?!\\.{1,2}$)[^/\\\\]+$"
         },
         "skill": { "$ref": "#/$defs/pluginSkill" },
+        "views": {
+          "description": "Undirected views declared by the plugin manifest, recorded at install time.",
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["subpath", "label"],
+            "properties": {
+              "subpath": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+              "label": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
         "entries": {
           "description": "Resolved absolute convention entry files. api is optional.",
           "oneOf": [