kennel 0.1.8 → 0.2.0

package/dist/deploy/cloudflare.js

@@ -4,13 +4,15 @@ import { existsSync } from 'node:fs';
 import { relative } from 'node:path';
 import { readJson } from '../shared/json.js';
 import { localBin } from '../shared/package-manager.js';
+import { projectConfigPath } from '../shared/project-config.js';
 import { commandLine } from '../shared/process.js';
-import { packageJsonPath, publishBuildCommand, publishTestUrl, publishWranglerArgs, publishWranglerCommand, publicationAccess, } from '../publish/config.js';
+import { packageJsonPath, publishBuildCommand, publishTestUrl, publishWranglerArgs, publishWranglerCommand, publicationAccess, publicationConfig, } from '../publish/config.js';
 import { publishInitCloudflare } from '../publish/cloudflare-init.js';
 import { splitPublishArgs } from '../publish/options.js';
 import { withCloudflareEnvironment } from './environment.js';
 import { runAccessHttpTest, runHttpTest } from './smoke-tests.js';
 import { syncTriggerDev } from './trigger-dev.js';
+import { publishVercel } from './vercel.js';
 export function runPublishCommand(root, child, options) {
     console.log(commandLine(child.command, child.args));
     if (options.dryRun)
@@ -84,6 +86,13 @@ export function publish(input) {
     if (input[0] === 'cloudflare' || input[0] === 'cloudflare-workers') {
         return publishCloudflare(input.slice(1));
     }
+    if (input[0] === 'vercel')
+        return publishVercel(input.slice(1));
+    const options = splitPublishArgs(input);
+    const config = readJson(projectConfigPath(options.targetPath, options.configFile));
+    const provider = publicationConfig(config).provider;
+    if (provider === 'vercel')
+        return publishVercel(input);
     return publishCloudflare(input);
 }
 export function deploy(input) {

package/dist/deploy/smoke-tests.d.ts

@@ -1,3 +1,4 @@
 import type { PublishOptions } from '../publish/options.js';
 export declare function runHttpTest(root: string, hostname: string, testEmail: string, options: PublishOptions): void;
+export declare function runStaticHttpTest(root: string, hostname: string, options: PublishOptions): void;
 export declare function runAccessHttpTest(root: string, hostname: string, options: PublishOptions): void;

package/dist/deploy/smoke-tests.js

@@ -47,6 +47,27 @@ export function runHttpTest(root, hostname, testEmail, options) {
         }
     }
 }
+export function runStaticHttpTest(root, hostname, options) {
+    const baseUrl = publishTestUrl(hostname);
+    if (!baseUrl) {
+        console.log('skip test: no hostname configured');
+        return;
+    }
+    if (!commandExists('curl')) {
+        console.log('skip test: curl is not available');
+        return;
+    }
+    const rootTest = {
+        command: 'curl',
+        args: ['-fsS', '-H', 'Cache-Control: no-cache', baseUrl],
+    };
+    console.log(`${commandLine(rootTest.command, rootTest.args)} | returns 2xx`);
+    if (!options.dryRun) {
+        const result = spawnSync(rootTest.command, rootTest.args, { cwd: root, stdio: 'ignore' });
+        if (result.status !== 0)
+            throw new Error(`${baseUrl} did not return a successful response`);
+    }
+}
 export function runAccessHttpTest(root, hostname, options) {
     const baseUrl = publishTestUrl(hostname);
     if (!baseUrl) {

package/dist/deploy/vercel.d.ts

@@ -0,0 +1,3 @@
+import { type ChildCommand } from '../shared/process.js';
+export declare function publishVercelCommand(root: string, projectName: string): ChildCommand;
+export declare function publishVercel(input: string[]): void;

package/dist/deploy/vercel.js

@@ -0,0 +1,67 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { readJson } from '../shared/json.js';
+import { localBin } from '../shared/package-manager.js';
+import { commandLine } from '../shared/process.js';
+import { packageJsonPath, publicationConfig, publicationDomains, publishBuildCommand, publishTestUrl, } from '../publish/config.js';
+import { splitPublishArgs } from '../publish/options.js';
+import { publishInitVercel } from '../publish/vercel-init.js';
+import { runStaticHttpTest } from './smoke-tests.js';
+function runVercelCommand(root, child, options) {
+    console.log(commandLine(child.command, child.args));
+    if (options.dryRun)
+        return;
+    const result = spawnSync(child.command, child.args, {
+        cwd: root,
+        stdio: 'inherit',
+        env: process.env,
+    });
+    if (result.status !== 0)
+        process.exit(result.status ?? 1);
+}
+export function publishVercelCommand(root, projectName) {
+    const args = ['deploy', '--prod', '--yes', '--project', projectName];
+    const vercel = localBin(root, 'vercel');
+    if (vercel)
+        return { command: vercel, args };
+    return { command: 'npx', args: ['vercel', ...args] };
+}
+function vercelHostname(config, fallback) {
+    const publication = publicationConfig(config);
+    const domains = publicationDomains(config);
+    const hostname = fallback ||
+        domains.primary ||
+        publication.hostname ||
+        publication.domain ||
+        publication.url;
+    return typeof hostname === 'string' ? hostname : '';
+}
+export function publishVercel(input) {
+    const options = splitPublishArgs(input);
+    const setup = publishInitVercel([
+        '--force',
+        '--config',
+        options.configFile,
+        ...(options.hostname ? ['--hostname', options.hostname] : []),
+        options.targetPath,
+    ]);
+    const { root } = setup;
+    const packagePath = packageJsonPath(root);
+    if (!existsSync(packagePath))
+        throw new Error(`No package.json found next to ${setup.configPath}`);
+    const pkg = readJson(packagePath);
+    if (options.build)
+        runVercelCommand(root, publishBuildCommand(root, pkg), options);
+    const publication = publicationConfig(setup.config);
+    const projectName = typeof publication.projectName === 'string'
+        ? publication.projectName
+        : 'kennel-docs';
+    if (options.deploy)
+        runVercelCommand(root, publishVercelCommand(root, projectName), options);
+    const hostname = vercelHostname(setup.config, setup.hostname);
+    if (hostname && !options.skipTest)
+        runStaticHttpTest(root, hostname, options);
+    const url = publishTestUrl(hostname);
+    if (url)
+        console.log(`url ${url}`);
+}

package/dist/main.js

@@ -1,4 +1,5 @@
 import { dispatch } from './cli/dispatch.js';
+delete process.env.NAPI_RS_NATIVE_LIBRARY_PATH;
 try {
     await dispatch(process.argv);
 }

package/dist/mcp/config.js

@@ -152,6 +152,18 @@ function toolPacks(config) {
         return undefined;
     return mcp.toolPacks;
 }
+function toolCatalog(config) {
+    const mcp = runtimeMcpConfig(config);
+    if (!isObject(mcp.toolCatalog))
+        return undefined;
+    return mcp.toolCatalog;
+}
+function docs(config) {
+    const mcp = runtimeMcpConfig(config);
+    if (!isObject(mcp.docs))
+        return undefined;
+    return mcp.docs;
+}
 export function serverConfig(config) {
     const mcp = runtimeMcpConfig(config);
     const serverName = String(mcp.serverName ?? config.name ?? 'index');
@@ -159,11 +171,13 @@ export function serverConfig(config) {
         ...(access(config) ? { access: access(config) } : {}),
         ...(isObject(mcp.analytics) ? { analytics: mcp.analytics } : {}),
         ...(isObject(mcp.conversationSnapshots) ? { conversationSnapshots: mcp.conversationSnapshots } : {}),
+        ...(docs(config) ? { docs: docs(config) } : {}),
         instructions: typeof mcp.instructions === 'string' && mcp.instructions.trim()
             ? mcp.instructions.trim()
             : "Find relevant Index documents and repo entries for the user's topic. Use search_index_docs and search_index_repos for topic lookup, then read index://doc/{slug} or index://repo/{name} when more detail is needed.",
         name: mcp.runtimeName ?? `${serverName}-mcp`,
         ...(repoIntegrations(config) ? { repoIntegrations: repoIntegrations(config) } : {}),
+        ...(toolCatalog(config) ? { toolCatalog: toolCatalog(config) } : {}),
         toolAliases: toolAliases(config),
         ...(toolPacks(config) ? { toolPacks: toolPacks(config) } : {}),
         version: mcp.version ?? '1.0.0',

package/dist/mcp/function-source.js

@@ -16,7 +16,7 @@ export function mcpFunctionSource(options) {
         ].join(', ')}];\n`
         : '';
     const customToolOption = customToolNames.length || toolModuleNames.length ? ', customTools' : '';
-    return `import { createMcpHttpHandler } from "@raggle-ai/kennel-mcp";
+    return `import { createMcpHttpHandler } from "@raggle-ai/kennel/mcp";
 import data from "./_generated/mcp-data.json";
 ${customToolImports ? `${customToolImports}\n` : ''}${toolModuleImports ? `${toolModuleImports}\n` : ''}
 
@@ -24,8 +24,10 @@ const serverConfig = ${JSON.stringify(options.serverConfig, null, 2)} as {
   access?: Record<string, unknown>;
   analytics?: Record<string, unknown>;
   conversationSnapshots?: Record<string, unknown>;
+  docs?: Record<string, unknown>;
   instructions: string;
   name: string;
+  toolCatalog?: Record<string, unknown>;
   toolAliases: Record<string, string>;
   toolPacks?: Record<string, unknown>;
   version: string;

package/dist/mcp/install-page.d.ts

@@ -1 +1,12 @@
-export declare function writeInstallPage(root: string, config: any): string | undefined;
+import { installPageLink, installPageMarkdownPath, renderInstallPage } from '@raggle-ai/kennel-knowledge/install-page';
+export { installPageLink, installPageMarkdownPath, renderInstallPage, };
+export type InstallModel = {
+    description: string;
+    displayName: string;
+    installMarkdownUrl?: string;
+    protectedUrl?: string;
+    publicUrl: string;
+    serverName: string;
+    tools: string[];
+};
+export declare function writeInstallPage(root: string, config: Record<string, unknown>): string | undefined;

package/dist/mcp/install-page.js

@@ -1,360 +1,5 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, relative, resolve } from 'node:path';
-import { isObject } from '../shared/object.js';
-const defaultSources = [
-    { text: 'Claude Code deep links', url: 'https://code.claude.com/docs/en/deep-links' },
-    { text: 'Claude Code MCP', url: 'https://code.claude.com/docs/en/mcp' },
-    { text: 'Codex app deep links', url: 'https://developers.openai.com/codex/app/commands#deep-links' },
-    { text: 'Codex MCP', url: 'https://developers.openai.com/codex/mcp' },
-    { text: 'Cursor deep links', url: 'https://cursor.com/docs/reference/deeplinks' },
-    { text: 'Cursor MCP', url: 'https://cursor.com/docs/mcp' },
-    {
-        text: 'Copilot Studio MCP onboarding',
-        url: 'https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent',
-    },
-    {
-        text: 'Microsoft 365 agent connectors for MCP',
-        url: 'https://learn.microsoft.com/en-us/microsoftteams/platform/m365-apps/agent-connectors',
-    },
-];
-function codeBlock(language, source) {
-    return [`\`\`\`${language}`, source, '```'].join('\n');
-}
-function frontmatter(title, description) {
-    return ['---', `title: ${JSON.stringify(title)}`, `description: ${JSON.stringify(description)}`, '---'].join('\n');
-}
-function escapeHtmlAttribute(value) {
-    return String(value).replace(/&/g, '&').replace(/"/g, '"');
-}
-function normalizeBasePath(base) {
-    if (typeof base !== 'string' || !base.trim() || base === '/')
-        return '/';
-    return `/${base.replace(/^\/+|\/+$/g, '')}/`;
-}
-function publicSiteUrl(config) {
-    const publication = config.publication ?? {};
-    const domains = publication.domains ?? {};
-    const url = config.url
-        ?? config.siteUrl
-        ?? publication.url
-        ?? domains.primary
-        ?? publication.hostname
-        ?? config.hostname;
-    if (typeof url !== 'string' || !url.trim())
-        return undefined;
-    const trimmed = url.trim().replace(/\/+$/, '');
-    return /^https?:\/\//.test(trimmed) ? trimmed : `https://${trimmed}`;
-}
-function publicMcpSiteUrl(config) {
-    const publicUrl = publicMcpEndpoint(config);
-    if (!publicUrl)
-        return undefined;
-    try {
-        return new URL(publicUrl).origin;
-    }
-    catch {
-        return undefined;
-    }
-}
-function list(items = []) {
-    return items.map((item) => `   - \`${item}\``).join('\n');
-}
-function enabledInstallConfig(config) {
-    if (!isObject(config.install) || config.install.enabled === false)
-        return null;
-    if (config.install.enabled !== true && !publicMcpEndpoint(config))
-        return null;
-    return config.install;
-}
-function mcpEndpoints(config) {
-    const endpoints = isObject(config.mcp?.endpoints) ? config.mcp.endpoints : {};
-    const installMcp = isObject(config.install?.mcp) ? config.install.mcp : {};
-    return {
-        portal: stringValue(endpoints.portal),
-        protected: stringValue(installMcp.protectedUrl) ?? stringValue(endpoints.protected),
-        public: stringValue(installMcp.publicUrl) ?? stringValue(endpoints.public),
-    };
-}
-function publicMcpEndpoint(config) {
-    return mcpEndpoints(config).public;
-}
-function stringValue(value) {
-    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
-}
-function installMarkdownUrl(config) {
-    const siteUrl = publicMcpSiteUrl(config) ?? publicSiteUrl(config);
-    if (!siteUrl)
-        return undefined;
-    return `${siteUrl}${normalizeBasePath(config.base)}${installPagePath(config).replace(/^\/+/, '')}`;
-}
-function appGuideUrl(baseUrl, client) {
-    if (!baseUrl)
-        return undefined;
-    const fragment = client === 'Claude Code' ? 'claude-code' : client.toLowerCase();
-    return `${baseUrl.replace(/#.*$/, '')}#${fragment}`;
-}
-function quickStartPrompt(quickStart = {}, mcp, client) {
-    const promptKey = client === 'Claude Code' ? 'claudePrompt' : client === 'Cursor' ? 'cursorPrompt' : 'codexPrompt';
-    if (typeof quickStart[promptKey] === 'string')
-        return quickStart[promptKey];
-    if (typeof quickStart.prompt === 'string')
-        return quickStart.prompt;
-    const setupStep = client === 'Claude Code'
-        ? `Run: claude mcp add --transport http ${mcp.serverName} ${mcp.publicUrl}`
-        : client === 'Cursor'
-            ? `Add hosted MCP server ${mcp.serverName}: ${mcp.publicUrl}`
-            : `Run: codex mcp add ${mcp.serverName} --url ${mcp.publicUrl}`;
-    const guideUrl = appGuideUrl(mcp.installMarkdownUrl, client);
-    return [
-        `Set up ${mcp.displayName} in ${client}.`,
-        guideUrl ? `Guide: ${guideUrl}` : undefined,
-        setupStep,
-        `Verify tools; search ${mcp.displayName} for "${client} MCP setup". If blocked, give the next command.`,
-    ].filter(Boolean).join('\n');
-}
-function quickStartCard(input) {
-    return [
-        `<a href="${escapeHtmlAttribute(input.href)}" style="display:flex;flex:1 1 0;min-width:180px;gap:12px;align-items:center;justify-content:center;min-height:64px;border:1px solid var(--vp-c-brand-1);border-radius:8px;padding:12px 16px;text-decoration:none;color:var(--vp-c-text-1);background:var(--vp-c-bg-soft);cursor:pointer;font-weight:700;transition:border-color .15s ease,background-color .15s ease,transform .15s ease;">`,
-        `  <span aria-hidden="true" style="display:grid;place-items:center;flex:0 0 auto;width:34px;height:34px;border-radius:8px;background:var(--vp-c-bg);color:${input.color};">${input.icon}</span>`,
-        `  <span>${input.label}</span>`,
-        '</a>',
-    ].join('\n');
-}
-function quickStartSection(quickStart = {}, mcp) {
-    if (quickStart.enabled === false)
-        return [];
-    const codexPrompt = quickStartPrompt(quickStart, mcp, 'Codex');
-    const claudePrompt = quickStartPrompt(quickStart, mcp, 'Claude Code');
-    const cursorPrompt = quickStartPrompt(quickStart, mcp, 'Cursor');
-    const codexUrl = `codex://new?prompt=${encodeURIComponent(codexPrompt)}`;
-    const claudeUrl = `claude://claude.ai/new?q=${encodeURIComponent(claudePrompt)}`;
-    const cursorUrl = `cursor://anysphere.cursor-deeplink/prompt?text=${encodeURIComponent(cursorPrompt)}`;
-    const codexIcon = '<svg width="28" height="28" viewBox="0 0 24 24" role="img" aria-label="OpenAI"><path fill="currentColor" d="M22.282 9.821a6 6 0 0 0-.516-4.91a6.05 6.05 0 0 0-6.51-2.9A6.065 6.065 0 0 0 4.981 4.18a6 6 0 0 0-3.998 2.9a6.05 6.05 0 0 0 .743 7.097a5.98 5.98 0 0 0 .51 4.911a6.05 6.05 0 0 0 6.515 2.9A6 6 0 0 0 13.26 24a6.06 6.06 0 0 0 5.772-4.206a6 6 0 0 0 3.997-2.9a6.06 6.06 0 0 0-.747-7.073M13.26 22.43a4.48 4.48 0 0 1-2.876-1.04l.141-.081l4.779-2.758a.8.8 0 0 0 .392-.681v-6.737l2.02 1.168a.07.07 0 0 1 .038.052v5.583a4.504 4.504 0 0 1-4.494 4.494M3.6 18.304a4.47 4.47 0 0 1-.535-3.014l.142.085l4.783 2.759a.77.77 0 0 0 .78 0l5.843-3.369v2.332a.08.08 0 0 1-.033.062L9.74 19.95a4.5 4.5 0 0 1-6.14-1.646M2.34 7.896a4.5 4.5 0 0 1 2.366-1.973V11.6a.77.77 0 0 0 .388.677l5.815 3.354l-2.02 1.168a.08.08 0 0 1-.071 0l-4.83-2.786A4.504 4.504 0 0 1 2.34 7.872zm16.597 3.855l-5.833-3.387L15.119 7.2a.08.08 0 0 1 .071 0l4.83 2.791a4.494 4.494 0 0 1-.676 8.105v-5.678a.79.79 0 0 0-.407-.667m2.01-3.023l-.141-.085l-4.774-2.782a.78.78 0 0 0-.785 0L9.409 9.23V6.897a.07.07 0 0 1 .028-.061l4.83-2.787a4.5 4.5 0 0 1 6.68 4.66zm-12.64 4.135l-2.02-1.164a.08.08 0 0 1-.038-.057V6.075a4.5 4.5 0 0 1 7.375-3.453l-.142.08L8.704 5.46a.8.8 0 0 0-.393.681zm1.097-2.365l2.602-1.5l2.607 1.5v2.999l-2.597 1.5l-2.607-1.5Z"/></svg>';
-    const claudeIcon = '<svg width="28" height="28" viewBox="0 0 24 24" role="img" aria-label="Claude"><path fill="currentColor" d="m4.714 15.956l4.718-2.648l.079-.23l-.08-.128h-.23l-.79-.048l-2.695-.073l-2.337-.097l-2.265-.122l-.57-.121l-.535-.704l.055-.353l.48-.321l.685.06l1.518.104l2.277.157l1.651.098l2.447.255h.389l.054-.158l-.133-.097l-.103-.098l-2.356-1.596l-2.55-1.688l-1.336-.972l-.722-.491L2 6.223l-.158-1.008l.656-.722l.88.06l.224.061l.893.686l1.906 1.476l2.49 1.833l.364.304l.146-.104l.018-.072l-.164-.274l-1.354-2.446l-1.445-2.49l-.644-1.032l-.17-.619a3 3 0 0 1-.103-.729L6.287.133L6.7 0l.995.134l.42.364l.619 1.415L9.735 4.14l1.555 3.03l.455.898l.243.832l.09.255h.159V9.01l.127-1.706l.237-2.095l.23-2.695l.08-.76l.376-.91l.747-.492l.583.28l.48.685l-.067.444l-.286 1.851l-.558 2.903l-.365 1.942h.213l.243-.242l.983-1.306l1.652-2.064l.728-.82l.85-.904l.547-.431h1.032l.759 1.129l-.34 1.166l-1.063 1.347l-.88 1.142l-1.263 1.7l-.79 1.36l.074.11l.188-.02l2.853-.606l1.542-.28l1.84-.315l.832.388l.09.395l-.327.807l-1.967.486l-2.307.462l-3.436.813l-.043.03l.049.061l1.548.146l.662.036h1.62l3.018.225l.79.522l.473.638l-.08.485l-1.213.62l-1.64-.389l-3.825-.91l-1.31-.329h-.183v.11l1.093 1.068l2.003 1.81l2.508 2.33l.127.578l-.321.455l-.34-.049l-2.204-1.657l-.85-.747l-1.925-1.62h-.127v.17l.443.649l2.343 3.521l.122 1.08l-.17.353l-.607.213l-.668-.122l-1.372-1.924l-1.415-2.168l-1.141-1.943l-.14.08l-.674 7.254l-.316.37l-.728.28l-.607-.461l-.322-.747l.322-1.476l.388-1.924l.316-1.53l.285-1.9l.17-.632l-.012-.042l-.14.018l-1.432 1.967l-2.18 2.945l-1.724 1.845l-.413.164l-.716-.37l.066-.662l.401-.589l2.386-3.036l1.439-1.882l.929-1.086l-.006-.158h-.055L4.138 18.56l-1.13.146l-.485-.456l.06-.746l.231-.243l1.907-1.312Z"/></svg>';
-    const cards = [
-        quickStartCard({
-            href: codexUrl,
-            label: quickStart.codexLabel ?? 'OpenAI Codex',
-            icon: codexIcon,
-            color: '#111111',
-        }),
-        quickStartCard({
-            href: claudeUrl,
-            label: quickStart.claudeLabel ?? 'Claude Code',
-            icon: claudeIcon,
-            color: '#D97757',
-        }),
-        quickStartCard({
-            href: cursorUrl,
-            label: quickStart.cursorLabel ?? 'Cursor',
-            icon: '<svg width="28" height="28" viewBox="0 0 24 24" role="img" aria-label="Cursor"><path fill="currentColor" d="M12 2 3 7.25v9.5L12 22l9-5.25v-9.5zm0 2.32 6.98 4.07-4.17 2.44L12 9.19 9.19 10.83 5.02 8.39zm-7 5.8 4 2.34v4.65l-4-2.34zm6 9.28v-4.66l1 .59 1-.59v4.66l-1 .58zm3-2.29v-4.65l4-2.34v4.65zm-.99-5.25L12 12.45l-1.01-.59L12 11.27z"/></svg>',
-            color: '#111111',
-        }),
-    ];
-    const layoutStyle = cards.length >= 4
-        ? 'display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:12px;margin:20px 0;'
-        : 'display:flex;flex-wrap:wrap;gap:12px;margin:20px 0;';
-    return [
-        '## AI Quick Start',
-        '',
-        `<div class="ai-quick-start" style="${layoutStyle}">`,
-        ...cards,
-        '</div>',
-    ];
-}
-function installPagePath(config) {
-    const install = enabledInstallConfig(config);
-    const configured = String(install?.path ?? 'install.md').replace(/^\/+/, '');
-    if (!configured || configured.split('/').includes('..'))
-        throw new Error(`Invalid install.path: ${install?.path}`);
-    return configured.endsWith('.md') ? configured : `${configured}.md`;
-}
-function repositoryPrompt(config, displayName, remoteUrl) {
-    return config.setupPrompt ?? [
-        `Set up the ${displayName} MCP server from this repository.`,
-        'Read mcp/README.md, run npm install and npm run build in mcp/, then configure this local stdio MCP server for this client.',
-        `Use the Git remote ${remoteUrl}.`,
-    ].join(' ');
-}
-function cloudflarePortalSection(portal = {}, mcp) {
-    if (portal.enabled === false || !portal.url)
-        return [];
-    const serverId = portal.serverId ?? mcp.serverName;
-    const upstreamUrl = portal.upstreamUrl ?? mcp.publicUrl;
-    const portalId = portal.portalId ?? `${serverId}-portal`;
-    const hostname = portal.hostname ?? new URL(String(portal.url)).hostname;
-    const gatewayCname = portal.gatewayCname ?? 'gateway.agents.cloudflare.com';
-    return [
-        '## Cloudflare Managed Portal',
-        '',
-        "Cloudflare MCP server portals are managed under **Zero Trust** > **Access controls** > **AI controls**. They require a dedicated hostname that points at Cloudflare's MCP portal gateway, then expose MCP at `/mcp`.",
-        '',
-        'Target portal:',
-        '',
-        codeBlock('text', String(portal.url)),
-        '',
-        'Upstream MCP server:',
-        '',
-        codeBlock('text', upstreamUrl),
-        '',
-        'Cloudflare setup:',
-        '',
-        `1. Add an MCP server with server ID \`${serverId}\`, authentication \`${portal.authentication ?? 'Unauthenticated'}\`, and HTTP URL \`${upstreamUrl}\`.`,
-        `2. Create an MCP server portal with portal ID \`${portalId}\`, hostname \`${hostname}\`, and include the \`${serverId}\` server.`,
-        `3. Create a proxied CNAME for \`${hostname}\` pointing to \`${gatewayCname}\` if the portal was created through the API or Terraform.`,
-        `4. Add Access policies for the portal and for the \`${serverId}\` MCP server entry so allowed users can see the server in the portal.`,
-        '',
-        'Equivalent Cloudflare API endpoints:',
-        '',
-        codeBlock('text', 'POST /accounts/{account_id}/access/ai-controls/mcp/servers\nPOST /accounts/{account_id}/access/ai-controls/mcp/portals'),
-        '',
-        portal.accessNote ?? 'Use a Cloudflare token with Zero Trust Access/AI Controls write access before provisioning the managed portal.',
-        '',
-        'For Claude or other MCP clients that need browser-based portal auth, Cloudflare recommends `mcp-remote`:',
-        '',
-        codeBlock('json', JSON.stringify({ mcpServers: { [serverId]: { command: 'npx', args: ['-y', 'mcp-remote@latest', portal.url] } } }, null, 2)),
-    ];
-}
-function localRepositorySection(repository = {}, mcp) {
-    if (repository.enabled === false || !repository.remoteUrl || !repository.localPath)
-        return [];
-    const prompt = repositoryPrompt(repository, mcp.displayName, repository.remoteUrl);
-    const codexUrl = `codex://new?originUrl=${encodeURIComponent(repository.remoteUrl)}&prompt=${encodeURIComponent(prompt)}`;
-    const claudeUrl = `claude-cli://open?cwd=${encodeURIComponent(repository.localPath)}&q=${encodeURIComponent(prompt)}`;
-    const configuredServerDirectory = repository.localServerDirectory ?? 'mcp';
-    const serverDirectory = String(configuredServerDirectory).startsWith('/')
-        ? String(configuredServerDirectory)
-        : `${String(repository.localPath).replace(/\/+$/, '')}/${String(configuredServerDirectory).replace(/^\/+/, '')}`;
-    const localServerCommand = repository.localServerCommand ?? `node ${serverDirectory}/dist/server.js`;
-    return [
-        '## Local Repository Setup',
-        '',
-        'Use these links only when you want to open the Git-backed repository in an agent and configure the local MCP server from `mcp/`.',
-        '',
-        `- [Open in Codex](${codexUrl}): uses Codex \`originUrl\` matching to find a local workspace with the \`${repository.remoteUrl}\` remote.`,
-        `- [Open in Claude Code](${claudeUrl}): uses Claude Code \`cwd\` matching for this local clone. Claude Code's \`repo=\` deeplink is GitHub \`owner/name\` based, so use \`cwd=\` for non-GitHub repositories.`,
-        '',
-        'If the clone is not present locally:',
-        '',
-        codeBlock('bash', `git clone ${repository.remoteUrl}.git ${repository.localPath}`),
-        '',
-        'Configure the local stdio MCP server:',
-        '',
-        codeBlock('bash', [
-            `claude mcp add --transport stdio ${mcp.serverName} -- ${localServerCommand}`,
-            `codex mcp add ${mcp.serverName} -- ${localServerCommand}`,
-        ].join('\n')),
-    ];
-}
-function sourceSection(sources = defaultSources) {
-    return sources.length ? [`Sources checked: ${sources.map((source) => `[${source.text}](${source.url})`).join(', ')}.`] : [];
-}
-function renderInstallPage(config) {
-    const install = enabledInstallConfig(config);
-    if (!install)
-        return undefined;
-    const endpoints = mcpEndpoints(config);
-    const coreMcp = isObject(config.mcp) ? config.mcp : {};
-    const installMcp = isObject(install.mcp) ? install.mcp : {};
-    const mcp = {
-        description: installMcp.description ?? config.description ?? '',
-        displayName: installMcp.displayName ?? install.title ?? config.title ?? 'Index',
-        protectedUrl: endpoints.protected ?? '',
-        publicUrl: endpoints.public ?? '',
-        serverName: installMcp.serverName ?? coreMcp.serverName ?? config.name ?? 'index',
-        tools: Array.isArray(installMcp.tools) ? installMcp.tools.map(String) : [],
-        installMarkdownUrl: installMarkdownUrl(config),
-    };
-    if (!mcp.publicUrl)
-        throw new Error('mcp.endpoints.public or install.mcp.publicUrl is required when install is enabled');
-    const title = install.title ?? 'Install';
-    const description = install.description ?? `Connect ${mcp.displayName} MCP to Codex, Claude, Microsoft Teams, and Copilot.`;
-    const lines = [
-        frontmatter(title, description),
-        '',
-        `# ${title}`,
-        '',
-        ...quickStartSection(install.quickStart, mcp),
-        '',
-        'Use the public Cloudflare MCP endpoint when you want an agent to use this knowledge base without Git credentials or a local clone.',
-        '',
-        codeBlock('text', mcp.publicUrl),
-        '',
-        mcp.protectedUrl ? `The custom domain is protected by Cloudflare Access, so use \`${mcp.publicUrl}\` for no-creds agent setup.` : undefined,
-        '',
-        ...cloudflarePortalSection({
-            url: endpoints.portal,
-            upstreamUrl: endpoints.public,
-            ...install.cloudflarePortal,
-        }, mcp),
-        '',
-        '## Codex',
-        '',
-        'Add the hosted MCP server:',
-        '',
-        codeBlock('bash', `codex mcp add ${mcp.serverName} --url ${mcp.publicUrl}`),
-        '',
-        `Restart Codex Desktop or open a new thread, then run \`/mcp\` to confirm \`${mcp.serverName}\` is connected.`,
-        '',
-        '## Claude Code',
-        '',
-        'Add the hosted MCP server:',
-        '',
-        codeBlock('bash', `claude mcp add --transport http ${mcp.serverName} ${mcp.publicUrl}`),
-        '',
-        'Restart Claude Code or open a new session. The tools should appear as:',
-        '',
-        codeBlock('text', mcp.tools.map((tool) => `mcp__${mcp.serverName}__${tool}`).join('\n')),
-        '',
-        '## Microsoft Teams and Copilot',
-        '',
-        'Use the same public MCP endpoint for Microsoft 365 Copilot and Teams agent experiments:',
-        '',
-        codeBlock('text', mcp.publicUrl),
-        '',
-        'Fastest Copilot Studio path:',
-        '',
-        '1. Open the target agent in Copilot Studio.',
-        '2. Go to **Tools**.',
-        '3. Select **Add a tool** > **New tool** > **Model Context Protocol**.',
-        '4. Enter:',
-        `   - Server name: \`${mcp.displayName}\``,
-        `   - Server description: \`${mcp.description}\``,
-        `   - Server URL: \`${mcp.publicUrl}\``,
-        '   - Authentication: `None`',
-        '5. Create the tool, add the MCP tools to the agent, then test with: `Search CDP Index for MCP setup.`',
-        '',
-        'Teams / Microsoft 365 Copilot agent path:',
-        '',
-        '1. Use Microsoft 365 Agents Toolkit in VS Code.',
-        '2. Create a new declarative agent.',
-        '3. Add an action and choose **Start with an MCP server**.',
-        `4. Enter \`${mcp.publicUrl}\`.`,
-        '5. Select the tools to expose, usually:',
-        list(mcp.tools),
-        '6. Test locally through Microsoft 365 Copilot, then package and publish the agent to Teams/Microsoft 365 through the tenant approval flow.',
-        '',
-        mcp.protectedUrl ? `Do not use \`${mcp.protectedUrl}\` for Copilot or Teams unless the Microsoft connector is configured with Cloudflare Access service-token headers. Without that, Microsoft clients receive the Cloudflare Access login redirect instead of MCP JSON-RPC.` : undefined,
-        '',
-        ...localRepositorySection(install.repository, mcp),
-        '',
-        ...sourceSection(Array.isArray(install.sources) ? install.sources : defaultSources),
-        '',
-    ];
-    return `${lines.filter((line) => line !== undefined).join('\n').replace(/\n{3,}/g, '\n\n')}\n`;
-}
+import { installPageLink, installPageMarkdownPath, renderInstallPage, writeInstallPage as writeSharedInstallPage, } from '@raggle-ai/kennel-knowledge/install-page';
+export { installPageLink, installPageMarkdownPath, renderInstallPage, };
 export function writeInstallPage(root, config) {
-    const source = renderInstallPage(config);
-    if (!source)
-        return undefined;
-    const resolvedRoot = resolve(root);
-    const target = resolve(resolvedRoot, installPagePath(config));
-    if (target !== resolvedRoot && !target.startsWith(`${resolvedRoot}/`)) {
-        throw new Error(`install.path must resolve inside project root: ${relative(resolvedRoot, target)}`);
-    }
-    if (existsSync(target) && readFileSync(target, 'utf8') === source)
-        return target;
-    mkdirSync(dirname(target), { recursive: true });
-    writeFileSync(target, source);
-    return target;
+    return writeSharedInstallPage(config, root);
 }

package/dist/notifications/email-worker.js

@@ -27,7 +27,7 @@ export function notificationEmailConfig(config) {
     return email;
 }
 function workerSource(workerPath, configPath) {
-    return `import { createCloudflareEmailWorker } from '@raggle-ai/kennel-mcp/notifications/email-worker';
+    return `import { createCloudflareEmailWorker } from '@raggle-ai/kennel/mcp/notifications/email-worker';
 import indexConfig from '${relativeImport(dirname(workerPath), configPath)}';
 
 export default createCloudflareEmailWorker(indexConfig);

package/dist/package/preview.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Types for the node-runnable preview bundle.
+ *
+ * `cli/dist/package/preview.js` is produced by `bun build` from
+ * `packages/preview/src/share.ts` (see cli/scripts/build.mjs). This module is
+ * a type-only mirror so the plain-`node` CLI never imports the package's TS
+ * sources, while staying type-checked against that source of truth.
+ */
+export declare function share(input: string[]): Promise<void>;