kennel 0.2.3 → 0.2.5

package/README.md

@@ -2,6 +2,13 @@
 
 Publishing, MCP generation, and knowledge-source commands for Kennel workspaces. The compact schema validator has moved to the private [`raggle-ai/kennel-compact`](https://github.com/raggle-ai/kennel-compact) repository.
 
+## Local web development
+
+Run `bun run web` from the repository root. The dev server uses the plugins
+installed with `kennel plugin add` in your Kennel user configuration. It shares
+the CLI's client registry and server/API bundling; it does not require a local
+`plugins/` directory. Restart the dev server after installing a plugin.
+
 ## Usage
 
 ```bash
@@ -27,6 +34,7 @@ kennel serve /path/to/workspace
 kennel dev /path/to/docs-site --config index.json
 kennel init .
 kennel plugin add https://github.com/example/kennel-transcripts-plugin.git#main
+kennel plugin add https://github.com/raggle-ai/kennel-plugins.git --path plugins/calendar
 kennel core-folders .
 kennel mcp generate . --config index.json
 kennel publish init cloudflare .
@@ -76,13 +84,14 @@ Entity search reads allowed local roots from
 ```
 
 The same user config stores trusted external folder plugins added with
-`kennel plugin add <git-repository-url[#ref]>`. The command pins the requested
-ref, or `HEAD` with no fragment, to a full commit, validates package metadata
-and explicit client/server/manifest exports, builds the composed kernel in the
-XDG cache, and only then atomically updates config. Installed plugin imports are
-derived from package metadata, not from URL text. The transcripts plugin
-contract is package `kennel-transcripts-plugin`, id `memos`, trigger
-`memos.json`.
+`kennel plugin add <git-repository-url[#ref]> [--path <subdirectory>]`. The
+command pins the requested ref, or `HEAD` with no fragment, to a full commit,
+selects the repository root or the requested subdirectory as the plugin package
+root, validates package metadata and explicit client/server/manifest exports
+plus optional API/CSS exports, builds the composed kernel in the XDG cache, and
+only then atomically updates config. Installed plugin imports are derived from
+package metadata, not from URL text. The transcripts plugin contract is package
+`kennel-transcripts-plugin`, id `memos`, trigger `memos.json`.
 
 When this file is absent, entity search allows only the workspace opened by
 `knl`. Invalid config fails closed.
@@ -92,12 +101,13 @@ Suggested convention for agents: write generated HTML components to
 .kennel/preview/<name>.html --watch` (reuses 5180), so preview items share one
 well-known scratch folder across any AI client.
 
-`kennel init` scaffolds starter content files for the folder plugins into
-the current folder (or the given path): `todo.json` for Tasks and
-`calendar.json` for Calendar, each referencing its published schema and
-passing the plugin's validation immediately. Existing files are left
-untouched; `--plugin <id>` scaffolds one plugin, `--force` overwrites, and
-`--list` prints what would be created without writing.
+`kennel init` scaffolds starter content files for installed folder plugins into
+the current folder (or the given path). The external Tasks and Calendar plugins
+provide `todo.json` and `calendar.json` templates after they are installed from
+`raggle-ai/kennel-plugins` with `kennel plugin add ... --path plugins/<id>`.
+Existing files are left untouched; `--plugin <id>` scaffolds one plugin,
+`--force` overwrites, and `--list` prints what would be created without
+writing.
 
 `kennel core-folders` lists schema-declared collections and their records using
 the same metadata index as the UI. Titles, icons, counts, fields and validation

package/dist/cli/dispatch.js

@@ -13,10 +13,23 @@ export async function dispatch(argv) {
     }
     if (command === 'plugin' && args[0] === 'add') {
         const url = args[1];
-        if (!url || args.length !== 2)
-            throw new Error('Usage: kennel plugin add <git-repository-url>');
+        let directory;
+        for (let index = 2; index < args.length; index += 1) {
+            const arg = args[index];
+            if (arg === '--path' || arg === '--directory') {
+                directory = args[index + 1];
+                if (!directory)
+                    throw new Error(`${arg} requires a plugin subdirectory`);
+                index += 1;
+            }
+            else {
+                throw new Error('Usage: kennel plugin add <git-repository-url> [--path <subdirectory>]');
+            }
+        }
+        if (!url)
+            throw new Error('Usage: kennel plugin add <git-repository-url> [--path <subdirectory>]');
         const { installExternalPlugin } = await import('../plugins/external.js');
-        const plugin = await installExternalPlugin(url);
+        const plugin = await installExternalPlugin(url, { directory });
         console.log(`Installed plugin ${plugin.id} from ${plugin.packageName} at ${plugin.commit}`);
         return;
     }

package/dist/cli/src/cli/dispatch.js

@@ -13,10 +13,23 @@ export async function dispatch(argv) {
     }
     if (command === 'plugin' && args[0] === 'add') {
         const url = args[1];
-        if (!url || args.length !== 2)
-            throw new Error('Usage: kennel plugin add <git-repository-url>');
+        let directory;
+        for (let index = 2; index < args.length; index += 1) {
+            const arg = args[index];
+            if (arg === '--path' || arg === '--directory') {
+                directory = args[index + 1];
+                if (!directory)
+                    throw new Error(`${arg} requires a plugin subdirectory`);
+                index += 1;
+            }
+            else {
+                throw new Error('Usage: kennel plugin add <git-repository-url> [--path <subdirectory>]');
+            }
+        }
+        if (!url)
+            throw new Error('Usage: kennel plugin add <git-repository-url> [--path <subdirectory>]');
         const { installExternalPlugin } = await import('../plugins/external.js');
-        const plugin = await installExternalPlugin(url);
+        const plugin = await installExternalPlugin(url, { directory });
         console.log(`Installed plugin ${plugin.id} from ${plugin.packageName} at ${plugin.commit}`);
         return;
     }

package/dist/cli/src/cli/usage.js

@@ -2,7 +2,7 @@ export function usage() {
     console.log(`Usage:
   knl core [folder] [--host <host>] [--port <port>] [--api-only]
   kennel init [path] [--plugin <id>] [--force] [--list]
-  kennel plugin add <git-repository-url>
+  kennel plugin add <git-repository-url> [--path <subdirectory>]
   kennel core-folders [path] [--json]
   kennel [folder] [--host <host>] [--port <port>] [--lan|--tailscale]
   kennel pop|p <file|folder> [--open] [--watch] [--host <host>] [--port <port>] [--lan|--tailscale]

package/dist/cli/src/core/command.js

@@ -45,6 +45,7 @@ export async function core(args) {
         throw new Error("Web assets missing; build the CLI or use --api-only");
     process.env.KENNEL_KERNEL_KEY = kernel.key;
     process.env.KENNEL_EXTERNAL_SERVER_ENTRIES = JSON.stringify(kernel.serverEntries);
+    process.env.KENNEL_EXTERNAL_API_ENTRIES = JSON.stringify(kernel.apiEntries);
     const api = createKennelApi({
         root,
         host,

package/dist/cli/src/core/init.js

@@ -22,7 +22,7 @@ function parseArgs(args) {
         else if (arg === '--plugin') {
             const value = args[index + 1];
             if (!value)
-                throw new Error('--plugin requires a plugin id (tasks, calendar)');
+                throw new Error('--plugin requires a plugin id');
             options.plugin = value;
             index += 1;
         }
@@ -41,11 +41,11 @@ function initUsage() {
     return `Usage:
   kennel init [path] [--plugin <id>] [--force] [--list]
 
-Scaffold starter content files for folder plugins (todo.json, calendar.json)
-into the given folder (default: current directory). Existing files are left
-untouched unless --force is passed.
+Scaffold starter content files for installed folder plugins into the given
+folder (default: current directory). Existing files are left untouched unless
+--force is passed.
 
-  --plugin <id>   only scaffold one plugin (tasks, calendar)
+  --plugin <id>   only scaffold one plugin
   --force         overwrite existing starter files
   --list          show which files each plugin would create, without writing`;
 }

package/dist/cli/src/plugins/external.d.ts

@@ -4,6 +4,7 @@ export type ExternalPluginEntry = {
     commit: string;
     packageName: string;
     id: string;
+    directory?: string;
     trigger?: string;
     entries: {
         client: string;
@@ -12,13 +13,19 @@ export type ExternalPluginEntry = {
         serverSymbol: string;
         manifest: string;
         manifestSymbol: string;
+        api?: string;
+        apiSymbol?: string;
         css?: string;
     };
 };
 export declare function kennelConfigPath(): string;
-export declare function validateExternalPlugin(inputUrl: string, existing?: ExternalPluginEntry[]): Promise<ExternalPluginEntry>;
+export declare function validateExternalPlugin(inputUrl: string, existing?: ExternalPluginEntry[], options?: {
+    directory?: string;
+}): Promise<ExternalPluginEntry>;
 export declare function readExternalPlugins(): ExternalPluginEntry[];
-export declare function installExternalPlugin(url: string): Promise<ExternalPluginEntry>;
+export declare function installExternalPlugin(url: string, options?: {
+    directory?: string;
+}): Promise<ExternalPluginEntry>;
 export declare function kernelKey(plugins?: ExternalPluginEntry[]): string;
 export type ActiveKernel = {
     buildIdentity: string;
@@ -32,5 +39,24 @@ export type ActiveKernel = {
         symbol: string;
         trigger?: string;
     }>;
+    apiEntries: Array<{
+        id: string;
+        module: string;
+        symbol: string;
+    }>;
 };
+export declare function prepareExternalPluginModules(temp: string, target?: string, plugins?: ExternalPluginEntry[]): Promise<{
+    clientModule: string;
+    serverEntries: {
+        id: string;
+        module: string;
+        symbol: string;
+        trigger?: string;
+    }[];
+    apiEntries: {
+        id: string;
+        module: string;
+        symbol: string;
+    }[];
+}>;
 export declare function ensureKernel(plugins?: ExternalPluginEntry[]): Promise<ActiveKernel>;

package/dist/cli/src/plugins/external.js

@@ -15,10 +15,10 @@ import { pathToFileURL, fileURLToPath } from "node:url";
 import { spawnSync } from "node:child_process";
 const CONFIG_FILE = join("kennel", "config.json");
 const VALID_ID = /^[a-z][a-z0-9-]*$/u;
-const CORE_IDS = new Set(["agents", "calendar", "mail", "notes", "projects", "tasks"]);
+const CORE_IDS = new Set(["agents", "notes"]);
 const KENNEL_KERNEL_SCHEMA = 2;
 const BUILD_RUNTIME = `node-${process.versions.node}`;
-const BUILD_IDENTITY = "kennel-external-kernel-v2";
+const BUILD_IDENTITY = "kennel-external-kernel-v3";
 function xdgConfigHome() {
     return process.env.XDG_CONFIG_HOME?.trim() || join(homedir(), ".config");
 }
@@ -103,6 +103,19 @@ function sourceCheckout(url, commit) {
     run("git", ["checkout", "--force", commit], { cwd: dir });
     return realpathSync(dir);
 }
+function pluginRoot(repoRoot, directory) {
+    if (!directory)
+        return repoRoot;
+    if (isAbsolute(directory) || directory.includes("\0"))
+        throw new Error(`Unsafe plugin directory: ${directory}`);
+    const target = resolve(repoRoot, directory);
+    const rel = relative(repoRoot, target);
+    if (rel === "" || rel.startsWith("..") || isAbsolute(rel))
+        throw new Error(`Unsafe plugin directory: ${directory}`);
+    if (!existsSync(target) || !statSync(target).isDirectory())
+        throw new Error(`Missing plugin directory: ${directory}`);
+    return target;
+}
 function packageExportPath(exportsValue, key) {
     if (!exportsValue || typeof exportsValue !== "object" || Array.isArray(exportsValue))
         return undefined;
@@ -150,16 +163,12 @@ function internalSourceAliases(root = kernelSourceRoot()) {
     const aliases = {};
     for (const [name, path] of Object.entries({
         "@raggle-ai/agents": "packages/agents/src",
-        "@raggle-ai/calendar": "plugins/calendar/src",
         "@raggle-ai/folder-plugin": "packages/folder-plugin/src",
         "@raggle-ai/kennel-api": "packages/api/src",
-        "@raggle-ai/mail": "plugins/mail/src",
         "@raggle-ai/markdown": "packages/markdown/src",
         "@raggle-ai/notes": "packages/notes/src",
-        "@raggle-ai/projects": "plugins/projects/src",
         "@raggle-ai/schemas": "packages/schemas/src",
         "@raggle-ai/session-finding": "packages/session-finding/src",
-        "@raggle-ai/tasks": "plugins/tasks/src",
         "@raggle-ai/ui": "packages/ui/src",
         "kennel-client": "packages/api-client/src",
     })) {
@@ -188,7 +197,7 @@ function resolveAliasPath(target, suffix) {
 }
 function esbuildAliasPlugin(root = kernelSourceRoot()) {
     const sourceAliases = internalSourceAliases(root);
-    const hostPackages = ["@raggle-ai/barkdown", "@raggle-ai/scout-ui", "@tanstack/react-query", "@tanstack/react-router", "lucide-react", "react", "react-dom", "react/jsx-runtime", "yaml", "lexical"];
+    const hostPackages = ["@raggle-ai/barkdown", "@raggle-ai/scout-ui", "@tanstack/react-query", "@tanstack/react-router", "date-fns", "effect", "lucide-react", "react", "react-dom", "react/jsx-runtime", "yaml", "lexical"];
     return {
         name: "kennel-host-resolution",
         setup(build) {
@@ -241,9 +250,12 @@ async function validateImports(entry) {
         const manifestOut = join(dir, "manifest.mjs");
         const serverOut = join(dir, "server.mjs");
         const clientOut = join(dir, "client.mjs");
+        const apiOut = join(dir, "api.mjs");
         await bundleForImport(entry.entries.manifest, manifestOut, "browser");
         await bundleForImport(entry.entries.server, serverOut, "node");
         await bundleForImport(entry.entries.client, clientOut, "node");
+        if (entry.entries.api)
+            await bundleForImport(entry.entries.api, apiOut, "node");
         const manifestModule = await import(__rewriteRelativeImportExtension(pathToFileURL(manifestOut).href));
         const serverModule = await import(__rewriteRelativeImportExtension(pathToFileURL(serverOut).href));
         const clientModule = await import(__rewriteRelativeImportExtension(pathToFileURL(clientOut).href));
@@ -260,15 +272,22 @@ async function validateImports(entry) {
             throw new Error("client id mismatch");
         if (typeof client.component !== "function")
             throw new Error("client export missing component");
+        if (entry.entries.api && entry.entries.apiSymbol) {
+            const apiModule = await import(__rewriteRelativeImportExtension(pathToFileURL(apiOut).href));
+            if (typeof apiModule[entry.entries.apiSymbol] !== "function")
+                throw new Error("API export missing handler");
+        }
     }
     finally {
         await rm(dir, { force: true, recursive: true });
     }
 }
-export async function validateExternalPlugin(inputUrl, existing = []) {
+export async function validateExternalPlugin(inputUrl, existing = [], options = {}) {
     const { url, requestedRef } = splitRepositoryUrl(inputUrl);
     const commit = resolveCommit(url, requestedRef);
-    const root = sourceCheckout(url, commit);
+    const checkoutRoot = sourceCheckout(url, commit);
+    const directory = options.directory?.trim() || undefined;
+    const root = pluginRoot(checkoutRoot, directory);
     const pkgPath = join(root, "package.json");
     if (!existsSync(pkgPath))
         throw new Error("Plugin repository has no package.json at its root");
@@ -277,8 +296,6 @@ export async function validateExternalPlugin(inputUrl, existing = []) {
     const metadata = pkg.kennel?.plugin;
     if (!metadata || typeof metadata !== "object")
         throw new Error("package.json must define kennel.plugin metadata");
-    if (!metadata.exports || typeof metadata.exports !== "object")
-        throw new Error("kennel.plugin.exports is required");
     const id = stringField(metadata.id, "plugin id");
     if (!VALID_ID.test(id))
         throw new Error(`Invalid plugin id: ${id}`);
@@ -293,7 +310,16 @@ export async function validateExternalPlugin(inputUrl, existing = []) {
     const client = safeRelativeFile(root, packageExportPath(exportsValue, "./client"), "./client package export");
     const server = safeRelativeFile(root, packageExportPath(exportsValue, "./server"), "./server package export");
     const manifest = safeRelativeFile(root, packageExportPath(exportsValue, "./manifest"), "./manifest package export");
-    const cssValue = metadata.exports.css;
+    const apiPath = packageExportPath(exportsValue, "./api");
+    const apiExport = apiPath
+        ? safeRelativeFile(root, apiPath, "./api package export")
+        : undefined;
+    const apiSymbol = apiExport
+        ? typeof metadata.exports?.apiSymbol === "string"
+            ? metadata.exports.apiSymbol
+            : "default"
+        : undefined;
+    const cssValue = metadata.exports?.css;
     const css = cssValue === undefined ? undefined : safeRelativeFile(root, cssValue, "css export path");
     const entry = {
         url,
@@ -301,14 +327,22 @@ export async function validateExternalPlugin(inputUrl, existing = []) {
         commit,
         packageName,
         id,
+        ...(directory ? { directory } : {}),
         ...(trigger ? { trigger } : {}),
         entries: {
             client,
-            clientSymbol: stringField(metadata.exports.clientSymbol, "client export symbol"),
+            clientSymbol: typeof metadata.exports?.clientSymbol === "string"
+                ? metadata.exports.clientSymbol
+                : "default",
             server,
-            serverSymbol: stringField(metadata.exports.serverSymbol, "server export symbol"),
+            serverSymbol: typeof metadata.exports?.serverSymbol === "string"
+                ? metadata.exports.serverSymbol
+                : "default",
             manifest,
-            manifestSymbol: stringField(metadata.exports.manifestSymbol, "manifest export symbol"),
+            manifestSymbol: typeof metadata.exports?.manifestSymbol === "string"
+                ? metadata.exports.manifestSymbol
+                : "default",
+            ...(apiExport ? { api: apiExport, apiSymbol } : {}),
             ...(css ? { css } : {}),
         },
     };
@@ -319,13 +353,13 @@ export function readExternalPlugins() {
     const config = readJson(kennelConfigPath());
     return Array.isArray(config.externalPlugins) ? config.externalPlugins : [];
 }
-export async function installExternalPlugin(url) {
+export async function installExternalPlugin(url, options = {}) {
     const path = kennelConfigPath();
     const config = readJson(path);
     const externalPlugins = Array.isArray(config.externalPlugins) ? config.externalPlugins : [];
     let entry;
     try {
-        entry = await validateExternalPlugin(url, externalPlugins);
+        entry = await validateExternalPlugin(url, externalPlugins, options);
         const nextPlugins = [...externalPlugins, entry];
         await ensureKernel(nextPlugins);
         writeJsonAtomic(path, { ...config, externalPlugins: nextPlugins });
@@ -349,6 +383,7 @@ export function kernelKey(plugins = readExternalPlugins()) {
             requestedRef: plugin.requestedRef ?? null,
             packageName: plugin.packageName,
             id: plugin.id,
+            directory: plugin.directory ?? null,
             commit: plugin.commit,
             trigger: plugin.trigger,
             entries: plugin.entries,
@@ -369,7 +404,9 @@ async function readKernelMarker(marker, key) {
             kernel.key !== key ||
             !existsSync(resolve(kernel.webRoot, "index.html")) ||
             !Array.isArray(kernel.serverEntries) ||
-            kernel.serverEntries.some((entry) => !entry.id || !entry.module || !entry.symbol || !existsSync(entry.module)))
+            kernel.serverEntries.some((entry) => !entry.id || !entry.module || !entry.symbol || !existsSync(entry.module)) ||
+            !Array.isArray(kernel.apiEntries) ||
+            kernel.apiEntries.some((entry) => !entry.id || !entry.module || !entry.symbol || !existsSync(entry.module)))
             return undefined;
         return kernel;
     }
@@ -404,8 +441,7 @@ function moveIncompleteAside(target) {
     renameSync(target, broken);
     rmSync(broken, { force: true, recursive: true });
 }
-async function buildKernelTemp(temp, target, key, plugins) {
-    const sourceRoot = kernelSourceRoot();
+export async function prepareExternalPluginModules(temp, target = temp, plugins = readExternalPlugins()) {
     const clientModule = join(temp, "external-plugins.tsx");
     const serverDir = join(temp, "server");
     mkdirSync(serverDir, { recursive: true });
@@ -414,16 +450,29 @@ async function buildKernelTemp(temp, target, key, plugins) {
     const clientItems = plugins.map((plugin, index) => `  { ...manifest${index}, component: lazy(async () => ({ default: (await import(${JSON.stringify(plugin.entries.client)}))[${JSON.stringify(plugin.entries.clientSymbol)}].component })) }`).join(",\n");
     await writeFile(clientModule, `import { lazy } from "react";\nimport type { FolderPluginClient } from "@raggle-ai/folder-plugin/client";\n${cssImports}\n${clientImports}\nexport const externalFolderPlugins: FolderPluginClient[] = [\n${clientItems}\n];\n`);
     const serverEntries = [];
+    const apiEntries = [];
     for (const plugin of plugins) {
         const outfile = join(serverDir, `${plugin.id}.js`);
         await bundleForImport(plugin.entries.server, outfile, "node");
         serverEntries.push({ id: plugin.id, module: join(target, "server", `${plugin.id}.js`), symbol: plugin.entries.serverSymbol, trigger: plugin.trigger });
+        if (plugin.entries.api && plugin.entries.apiSymbol) {
+            const apiOutfile = join(serverDir, `${plugin.id}-api.js`);
+            await bundleForImport(plugin.entries.api, apiOutfile, "node");
+            apiEntries.push({ id: plugin.id, module: join(target, "server", `${plugin.id}-api.js`), symbol: plugin.entries.apiSymbol });
+        }
     }
+    return { clientModule, serverEntries, apiEntries };
+}
+async function buildKernelTemp(temp, target, key, plugins) {
+    const sourceRoot = kernelSourceRoot();
+    const { clientModule, serverEntries, apiEntries } = await prepareExternalPluginModules(temp, target, plugins);
     const vite = await import("vite");
     const previousClientModule = process.env.KENNEL_EXTERNAL_CLIENT_MODULE;
     const previousSourceRoot = process.env.KENNEL_KERNEL_SOURCE_ROOT;
+    const previousHostNodeModules = process.env.KENNEL_HOST_NODE_MODULES;
     process.env.KENNEL_EXTERNAL_CLIENT_MODULE = clientModule;
     process.env.KENNEL_KERNEL_SOURCE_ROOT = sourceRoot;
+    process.env.KENNEL_HOST_NODE_MODULES = resolve(cliRoot(), "node_modules");
     try {
         await vite.build({
             configFile: resolve(sourceRoot, "apps/web/vite.config.ts"),
@@ -442,6 +491,10 @@ async function buildKernelTemp(temp, target, key, plugins) {
             delete process.env.KENNEL_KERNEL_SOURCE_ROOT;
         else
             process.env.KENNEL_KERNEL_SOURCE_ROOT = previousSourceRoot;
+        if (previousHostNodeModules === undefined)
+            delete process.env.KENNEL_HOST_NODE_MODULES;
+        else
+            process.env.KENNEL_HOST_NODE_MODULES = previousHostNodeModules;
     }
     const kernel = {
         buildIdentity: BUILD_IDENTITY,
@@ -450,6 +503,7 @@ async function buildKernelTemp(temp, target, key, plugins) {
         key,
         webRoot: join(target, "web"),
         serverEntries,
+        apiEntries,
     };
     await writeFile(join(temp, "kernel.json"), JSON.stringify(kernel, null, 2));
     return kernel;
@@ -457,7 +511,7 @@ async function buildKernelTemp(temp, target, key, plugins) {
 export async function ensureKernel(plugins = readExternalPlugins()) {
     if (plugins.length === 0) {
         const webRoot = resolve(dirname(fileURLToPath(import.meta.url)), "../../web");
-        return { buildIdentity: BUILD_IDENTITY, schema: KENNEL_KERNEL_SCHEMA, runtime: BUILD_RUNTIME, key: "core", webRoot, serverEntries: [] };
+        return { buildIdentity: BUILD_IDENTITY, schema: KENNEL_KERNEL_SCHEMA, runtime: BUILD_RUNTIME, key: "core", webRoot, serverEntries: [], apiEntries: [] };
     }
     const key = kernelKey(plugins);
     const target = kernelRoot(key);

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

@@ -18,13 +18,8 @@ export type { FolderPluginContext, FolderPluginData, FolderPluginDetection, Fold
 export declare class FolderPluginFailure extends Error {
     constructor(message: string);
 }
-export declare function handleMailApiRoutes(request: import("node:http").IncomingMessage, response: import("node:http").ServerResponse, context: {
-    authorizeFolder: (value: string | null) => string;
-    mailDir?: string;
-    watch: (folder: string) => void;
-}): Promise<boolean>;
 export declare function folderServerRegistry(options?: {
-    mailDir?: string;
+    agentsHomeDir?: string;
 }): Map<string, FolderPluginServer>;
 export type FolderPluginScaffoldFile = {
     plugin: string;
@@ -50,5 +45,5 @@ export type FolderPluginScaffoldResult = {
 export declare function scaffoldFolderPlugins(folder: string, options?: {
     force?: boolean;
     write?: boolean;
-    mailDir?: string;
+    agentsHomeDir?: string;
 }): Promise<FolderPluginScaffoldResult>;

package/dist/cli/src/site/viewer.js

@@ -313,6 +313,7 @@ export async function viewer(input) {
     }
     process.env.KENNEL_KERNEL_KEY = kernel.key;
     process.env.KENNEL_EXTERNAL_SERVER_ENTRIES = JSON.stringify(kernel.serverEntries);
+    process.env.KENNEL_EXTERNAL_API_ENTRIES = JSON.stringify(kernel.apiEntries);
     const api = createKennelApi({
         root: options.root,
         host: options.host,

package/dist/cli/usage.js

@@ -2,7 +2,7 @@ export function usage() {
     console.log(`Usage:
   knl core [folder] [--host <host>] [--port <port>] [--api-only]
   kennel init [path] [--plugin <id>] [--force] [--list]
-  kennel plugin add <git-repository-url>
+  kennel plugin add <git-repository-url> [--path <subdirectory>]
   kennel core-folders [path] [--json]
   kennel [folder] [--host <host>] [--port <port>] [--lan|--tailscale]
   kennel pop|p <file|folder> [--open] [--watch] [--host <host>] [--port <port>] [--lan|--tailscale]

package/dist/core/command.js

@@ -45,6 +45,7 @@ export async function core(args) {
         throw new Error("Web assets missing; build the CLI or use --api-only");
     process.env.KENNEL_KERNEL_KEY = kernel.key;
     process.env.KENNEL_EXTERNAL_SERVER_ENTRIES = JSON.stringify(kernel.serverEntries);
+    process.env.KENNEL_EXTERNAL_API_ENTRIES = JSON.stringify(kernel.apiEntries);
     const api = createKennelApi({
         root,
         host,

package/dist/core/init.js

@@ -22,7 +22,7 @@ function parseArgs(args) {
         else if (arg === '--plugin') {
             const value = args[index + 1];
             if (!value)
-                throw new Error('--plugin requires a plugin id (tasks, calendar)');
+                throw new Error('--plugin requires a plugin id');
             options.plugin = value;
             index += 1;
         }
@@ -41,11 +41,11 @@ function initUsage() {
     return `Usage:
   kennel init [path] [--plugin <id>] [--force] [--list]
 
-Scaffold starter content files for folder plugins (todo.json, calendar.json)
-into the given folder (default: current directory). Existing files are left
-untouched unless --force is passed.
+Scaffold starter content files for installed folder plugins into the given
+folder (default: current directory). Existing files are left untouched unless
+--force is passed.
 
-  --plugin <id>   only scaffold one plugin (tasks, calendar)
+  --plugin <id>   only scaffold one plugin
   --force         overwrite existing starter files
   --list          show which files each plugin would create, without writing`;
 }