kennel 0.2.0 → 0.2.2

package/dist/site/viewer.js

@@ -2,7 +2,6 @@ import { execFile, 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 { fileURLToPath } from "node:url";
 import { previewKind } from "./kinds.js";
 export function viewerFolder(root, value) {
     return resolve(value ?? root);
@@ -197,7 +196,11 @@ async function runningViewer(url) {
             typeof body.root === "string" &&
             typeof body.viewer === "string" &&
             (body.viewer === "kennel-core" || body.viewer === "kennel-vite")) {
-            return { root: body.root, viewer: body.viewer };
+            return {
+                kernelKey: typeof body.kernelKey === "string" ? body.kernelKey : "core",
+                root: body.root,
+                viewer: body.viewer,
+            };
         }
     }
     catch {
@@ -256,12 +259,18 @@ function tailscaleHost() {
 export async function viewer(input) {
     const portExplicit = viewerPortWasExplicit(input);
     const options = splitViewerArgs(input);
-    if (options.hot) {
+    const { ensureKernel, readExternalPlugins } = await import("../plugins/external.js");
+    const externalPlugins = readExternalPlugins();
+    if (options.hot && externalPlugins.length === 0) {
         const { hotViewer } = await import("./hot-viewer.js");
         await hotViewer(options);
         return;
     }
-    const web = resolve(dirname(fileURLToPath(import.meta.url)), "../../web");
+    if (options.hot && externalPlugins.length > 0) {
+        console.log("Kennel hot viewer is disabled for external plugin kernels; using the composed static kernel.");
+    }
+    const kernel = await ensureKernel(externalPlugins);
+    const web = kernel.webRoot;
     if (!existsSync(resolve(web, "index.html"))) {
         throw new Error(`Kennel web app not found. Run the CLI build first.`);
     }
@@ -289,7 +298,9 @@ export async function viewer(input) {
             .join(",");
     const initialViewerUrl = `http://${options.host}:${options.port}`;
     const existing = await runningViewer(initialViewerUrl);
-    if (existing && isSameOrDescendant(existing.root, options.root)) {
+    if (existing &&
+        existing.kernelKey === kernel.key &&
+        isSameOrDescendant(existing.root, options.root)) {
         const viewerUrl = popUrl(displayHost, options.port, options);
         console.log(viewerUrl);
         console.log(`Kennel is already running at ${viewerUrl}`);
@@ -300,6 +311,8 @@ export async function viewer(input) {
     if (!portExplicit) {
         options.port = String(await availableViewerPort(Number(options.port), options.host));
     }
+    process.env.KENNEL_KERNEL_KEY = kernel.key;
+    process.env.KENNEL_EXTERNAL_SERVER_ENTRIES = JSON.stringify(kernel.serverEntries);
     const api = createKennelApi({
         root: options.root,
         host: options.host,

package/kernel/apps/web/.env.example

@@ -0,0 +1,11 @@
+# Since the ".env" file is gitignored, you can use the ".env.example" file to
+# build a new ".env" file when you clone the repo. Keep this file up-to-date
+# when you add new variables to `.env`.
+
+# This file will be committed to version control, so make sure not to have any
+# secrets in it. If you are cloning this repo, create a copy of this file named
+# ".env" and populate it with your secrets.
+
+# Convex
+VITE_PUBLIC_CONVEX_URL=
+

package/kernel/apps/web/components.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "../../tooling/tailwind/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "@/components",
+    "hooks": "@/hooks",
+    "lib": "@/lib",
+    "utils": "@raggle-ai/ui/lib/utils",
+    "ui": "@raggle-ai/ui/components"
+  }
+}

package/kernel/apps/web/eslint.config.mjs

@@ -0,0 +1,60 @@
+import baseConfig from "@raggle-ai/eslint-config/base"
+import reactConfig from "@raggle-ai/eslint-config/react"
+import tanstackConfig from "@raggle-ai/eslint-config/tanstack"
+
+/** @type {import('@typescript-eslint/utils').TSESLint.FlatConfig.ConfigFile} */
+export default [
+  {
+    ignores: ["dist/**", ".output/**"],
+  },
+  ...baseConfig,
+  ...reactConfig,
+  {
+    files: ["src/**/*.{ts,tsx}"],
+    rules: {
+      "no-restricted-imports": [
+        "error",
+        {
+          patterns: [
+            {
+              group: [
+                "**/api/client",
+                "**/api/errors",
+                "**/lib/entity-folder",
+                "@raggle-ai/kennel-api/client*",
+                "@raggle-ai/kennel-api/server/*",
+              ],
+              message:
+                "Import API operations and DTOs from ~/api-client, not legacy shims or server modules.",
+            },
+          ],
+        },
+      ],
+    },
+  },
+  {
+    files: ["src/**/*.{ts,tsx}", "server/core-plugin.ts"],
+    // Legacy session/ACP protocols are migrated separately from the core JSON contract.
+    ignores: [
+      "src/live-session-controls.tsx",
+      "src/use-annotations.ts",
+      "src/session-transcript-page.tsx",
+      "src/use-linked-session.ts",
+    ],
+    rules: {
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector: "CallExpression[callee.name='fetch']",
+          message:
+            "Use ~/api-client for server actions; keep HTTP contracts in packages/api.",
+        },
+        {
+          selector:
+            "CallExpression[callee.type='MemberExpression'][callee.property.name='fetch']",
+          message: "Use ~/api-client instead of a per-screen transport.",
+        },
+      ],
+    },
+  },
+]

package/kernel/apps/web/index.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0, viewport-fit=cover, interactive-widget=resizes-content"
+    />
+    <meta name="theme-color" content="#f7f6f2" />
+    <link rel="icon" href="/favicon.svg" />
+    <title>Kennel</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/kernel/apps/web/package.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@raggle-ai/web",
+  "private": true,
+  "type": "module",
+  "prettier": "@raggle-ai/prettier-config",
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "dev": "vite dev",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier . --check --cache --cache-location .cache/.prettiercache --ignore-path ../../.prettierignore",
+    "format:fix": "prettier . --write --cache --cache-location .cache/.prettiercache --ignore-path ../../.prettierignore",
+    "lint": "eslint . --cache --cache-location .cache/.eslintcache",
+    "lint:fix": "eslint . --fix --cache --cache-location .cache/.eslintcache",
+    "clean": "git clean -xdf dist node_modules .cache"
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^1.3.0",
+    "@lexical/code": "0.49.0",
+    "@lexical/link": "0.49.0",
+    "@lexical/list": "0.49.0",
+    "@lexical/markdown": "0.49.0",
+    "@lexical/react": "0.49.0",
+    "@lexical/rich-text": "0.49.0",
+    "@raggle-ai/agents": "workspace:*",
+    "@raggle-ai/calendar": "workspace:*",
+    "@raggle-ai/folder-plugin": "workspace:*",
+    "@raggle-ai/kennel-api": "workspace:*",
+    "@raggle-ai/kennel-preview": "workspace:*",
+    "@raggle-ai/local": "0.14.0",
+    "@raggle-ai/mail": "workspace:*",
+    "@raggle-ai/markdown": "workspace:*",
+    "@raggle-ai/notes": "workspace:*",
+    "@raggle-ai/projects": "workspace:*",
+    "@raggle-ai/schemas": "workspace:*",
+    "@raggle-ai/scout-ui": "0.1.3",
+    "@raggle-ai/session-finding": "workspace:*",
+    "@raggle-ai/tasks": "workspace:*",
+    "@raggle-ai/ui": "workspace:*",
+    "@tanstack/react-query": "catalog:tanstack",
+    "@tanstack/react-router": "catalog:tanstack",
+    "kennel-client": "workspace:*",
+    "lexical": "0.49.0",
+    "lucide-react": "^0.562.0",
+    "pi-acp": "0.0.33",
+    "react": "catalog:react19",
+    "react-dom": "catalog:react19",
+    "react-markdown": "^10.1.0",
+    "rehype-highlight": "^7.0.2",
+    "rehype-katex": "^7.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-math": "^6.0.0",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@ianvs/prettier-plugin-sort-imports": "catalog:prettier",
+    "@raggle-ai/barkdown": "0.6.1",
+    "@raggle-ai/eslint-config": "workspace:*",
+    "@raggle-ai/prettier-config": "workspace:*",
+    "@raggle-ai/tsconfig": "workspace:*",
+    "@tailwindcss/oxide": "catalog:tailwind",
+    "@tailwindcss/vite": "catalog:tailwind",
+    "@types/bun": "catalog:",
+    "@types/node": "catalog:",
+    "@types/react": "catalog:react19",
+    "@types/react-dom": "catalog:react19",
+    "@vitejs/plugin-react": "catalog:vite",
+    "eslint": "catalog:eslint",
+    "jsdom": "^30.1.1",
+    "prettier": "catalog:prettier",
+    "prettier-plugin-classnames": "catalog:prettier",
+    "prettier-plugin-merge": "catalog:prettier",
+    "prettier-plugin-tailwindcss": "catalog:prettier",
+    "tailwindcss": "catalog:tailwind",
+    "typescript": "catalog:",
+    "typescript-eslint": "catalog:eslint",
+    "vite": "catalog:vite"
+  }
+}

package/kernel/apps/web/public/favicon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
+  <rect x="1" y="1" width="30" height="30" rx="7" fill="#f7f6f2"/>
+  <path d="M7 12a3 3 0 0 1 3-3h2.2l1.3-1.6A2 2 0 0 1 15.05 6.5h1.9a2 2 0 0 1 1.55.9L19.8 9H22a3 3 0 0 1 3 3v8a3 3 0 0 1-3 3H10a3 3 0 0 1-3-3z" fill="#57534e"/>
+  <circle cx="12.5" cy="15" r="1.4" fill="#f7f6f2"/>
+  <circle cx="19.5" cy="15" r="1.4" fill="#f7f6f2"/>
+</svg>

package/kernel/apps/web/public/providers/claude.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg"><path d="M447.957 233.579H512v66.176h-64v64.597h-31.723v62.315H384v-62.315h-31.723v62.315H320v-62.315H192v62.315h-32.256v-62.315H128v62.315H95.723v-62.315H64v-64.619H0V233.6h64V106.667h383.957v126.912zm-319.957 0h31.744v-60.736H128v60.736zm224.213 0H384v-60.736h-31.787v60.736z" fill="#d97757"/></svg>

package/kernel/apps/web/public/providers/codex.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg"><path d="M416.096 0H95.904C42.844 0 0 42.844 0 95.904v320.192C0 469.156 42.844 512 95.904 512h320.192C469.156 512 512 469.156 512 416.096V95.904C512 42.844 469.156 0 416.096 0z" fill="#fff"/><path d="M193.365 114.817a97.67 97.67 0 0 1 48.746-6.656c21.333 2.453 40.342 11.52 57.024 27.2.214.213.512.362.789.448.299.085.598.085.918 0a97.195 97.195 0 0 1 64.981 5.866l1.003.47 2.474 1.216a97.813 97.813 0 0 1 46.678 51.179 98.24 98.24 0 0 1 6.72 34.027c.32 8.789-.64 17.579-2.859 26.09a2.645 2.645 0 0 0 .64 2.453c12.672 12.95 21.077 28.374 25.237 46.294 6.166 30.4-.149 57.813-18.923 82.219l-2.901 3.541a97.024 97.024 0 0 1-46.955 29.611 2.56 2.56 0 0 0-1.728 1.622c-4.075 11.755-8.171 21.824-15.787 31.872-19.2 25.323-47.403 39.381-79.168 39.21-25.323-.128-47.765-9.386-67.349-27.776a2.325 2.325 0 0 0-2.24-.512c-8.277 2.667-16.64 3.051-25.685 2.944a94.677 94.677 0 0 1-41.493-9.941 97.131 97.131 0 0 1-34.347-28.48c-3.243-4.309-6.464-8.363-8.832-13.163a123.669 123.669 0 0 1-7.893-20.501 97.6 97.6 0 0 1-.299-49.024 2.837 2.837 0 0 0 .128-1.195 1.771 1.771 0 0 0-.576-1.024 95.296 95.296 0 0 1-22.059-35.221 83.157 83.157 0 0 1-5.355-25.429 110.784 110.784 0 0 1 3.008-34.134c7.189-23.723 20.949-42.347 41.237-55.851 4.523-3.008 8.811-5.355 12.821-7.04a134.187 134.187 0 0 1 13.781-4.843 2.133 2.133 0 0 0 1.386-1.408 96.256 96.256 0 0 1 17.685-34.453 96.853 96.853 0 0 1 39.211-29.611zm74.283 225.387a13.653 13.653 0 0 0-12.821 13.568 13.653 13.653 0 0 0 12.821 13.568h77.568l.768.021a13.653 13.653 0 0 0 13.589-13.589 13.653 13.653 0 0 0-13.589-13.589l-.768.021h-77.568zm-87.125-99.818a13.653 13.653 0 0 0-11.584-6.486 13.653 13.653 0 0 0-12.011 19.947l27.136 47.445-27.008 45.568a13.611 13.611 0 0 0 23.36 13.845l31.019-52.373a13.589 13.589 0 0 0 .107-13.653l-31.019-54.293z" fill="url(#g)"/><defs><linearGradient id="g" x1="256" y1="64" x2="256" y2="448" gradientUnits="userSpaceOnUse"><stop stop-color="#b1a7ff"/><stop offset=".5" stop-color="#7a9dff"/><stop offset="1" stop-color="#3941ff"/></linearGradient></defs></svg>

package/kernel/apps/web/public/providers/cursor.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg"><rect width="512" height="512" rx="122" fill="#000"/><path d="m255.428 423 148.991-83.5L255.428 256l-148.99 83.5 148.99 83.5z" fill="url(#b)"/><path d="M404.419 339.5v-167L255.428 89v167l148.991 83.5z" fill="url(#r)"/><path d="m255.428 89 148.991 83.5v167l-148.99-83.5V89z" fill="url(#l)"/><path d="M404.419 172.5 255.428 423V256l148.991-83.5z" fill="#e4e4e4"/><path d="m255.428 256-148.991 83.5v167l148.991-83.5h297.981z" fill="#fff"/><defs><linearGradient id="b" x1="255.428" y1="256" x2="255.428" y2="423" gradientUnits="userSpaceOnUse"><stop offset=".16" stop-color="#fff" stop-opacity=".39"/><stop offset=".658" stop-color="#fff" stop-opacity=".8"/><stop offset="1" stop-color="#fff" stop-opacity="0"/></linearGradient><linearGradient id="r" x1="404.419" y1="256" x2="257.482" y2="339.5" gradientUnits="userSpaceOnUse"><stop offset=".182" stop-color="#fff" stop-opacity=".31"/><stop offset=".715" stop-color="#fff" stop-opacity="0"/></linearGradient><linearGradient id="l" x1="255.428" y1="89" x2="112.292" y2="342.802" gradientUnits="userSpaceOnUse"><stop stop-color="#fff" stop-opacity=".6"/><stop offset=".667" stop-color="#fff" stop-opacity=".22"/></linearGradient></defs></svg>

package/kernel/apps/web/public/providers/opencode.svg

@@ -0,0 +1 @@
+<svg width="300" height="300" viewBox="0 0 300 300" fill="none" xmlns="http://www.w3.org/2000/svg"><g transform="translate(30, 0)"><g clip-path="url(#clip0_1401_86274)"><mask id="mask0_1401_86274" style="mask-type:luminance" maskUnits="userSpaceOnUse" x="0" y="0" width="240" height="300"><path d="M240 0H0V300H240V0Z" fill="white"/></mask><g mask="url(#mask0_1401_86274)"><path d="M180 240H60V120H180V240Z" fill="#CFCECD"/><path d="M180 60H60V240H180V60ZM240 300H0V0H240V300Z" fill="#211E1E"/></g></g></g><defs><clipPath id="clip0_1401_86274"><rect width="240" height="300" fill="white"/></clipPath></defs></svg>

package/kernel/apps/web/public/providers/pi.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M7 7.6h10v2.8h-2.5V20h-3V10.4H9.8V20H7V7.6Zm0-3.5h10v2.4H7V4.1Z" fill="#3f4a42"/></svg>

package/kernel/apps/web/server/acp/index.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/acp/index"

package/kernel/apps/web/server/acp/live-agent-connection.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/acp/live-agent-connection"

package/kernel/apps/web/server/acp/process-manager.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/acp/process-manager"

package/kernel/apps/web/server/acp/registry.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/acp/registry"

package/kernel/apps/web/server/acp/sdk.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/acp/sdk"

package/kernel/apps/web/server/acp/transport.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/acp/transport"

package/kernel/apps/web/server/acp/types.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/acp/types"

package/kernel/apps/web/server/acp-live-plugin.ts

@@ -0,0 +1,30 @@
+import type { Plugin } from "vite"
+
+import { createAcpApi } from "@raggle-ai/kennel-api/server/acp-live-plugin"
+import { isLoopbackServerHost } from "@raggle-ai/kennel-api/server/folder-metadata-plugin"
+
+export function acpLivePlugin(
+  options: { remoteAccess?: boolean } = {},
+): Plugin {
+  return {
+    name: "kennel-acp-live",
+    configureServer(server) {
+      const api = createAcpApi({
+        remoteAccess:
+          (options.remoteAccess ?? false) ||
+          !isLoopbackServerHost(server.config?.server?.host),
+      })
+      api.attach({
+        use: (handler) => {
+          server.middlewares.use(handler)
+        },
+        watch() {},
+        onChange() {},
+        emit() {},
+      })
+      server.httpServer?.once("close", () => {
+        void api.close()
+      })
+    },
+  }
+}

package/kernel/apps/web/server/api/document-edit.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/api/document-edit"

package/kernel/apps/web/server/api/open-path.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/api/open-path"

package/kernel/apps/web/server/core-plugin.ts

@@ -0,0 +1,49 @@
+import type { Plugin } from "vite"
+
+// Vite loads this while evaluating its config, before application aliases exist.
+import { createKennelClient } from "../../../packages/api-client/src/index"
+import { isLoopbackServerHost } from "../../../packages/api/src/server/folder-metadata-plugin"
+import { createKennelApi } from "../../../packages/api/src/server/index"
+
+/** Embedded core for `knl view`; KENNEL_CORE_URL instead connects Vite to `knl core`. */
+export function corePlugin(
+  options: Parameters<typeof createKennelApi>[0],
+): Plugin {
+  return {
+    name: "kennel-core",
+    async configureServer(server) {
+      const host = server.config.server.host
+      if (process.env.KENNEL_CORE_URL) {
+        if (options.remoteAccess || !isLoopbackServerHost(host)) {
+          const client = createKennelClient({
+            baseUrl: process.env.KENNEL_CORE_URL,
+          })
+          const capabilities = await client.capabilities({
+            signal: AbortSignal.timeout(3000),
+          })
+          if (
+            capabilities.local !== false ||
+            capabilities.acp !== false ||
+            capabilities.hostActions !== "none"
+          )
+            throw new Error(
+              "A remote Vite proxy requires a remote/restricted core. Start knl core with a non-loopback --host.",
+            )
+        }
+        return
+      }
+      const api = createKennelApi({
+        ...options,
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- vite-style host: `false`, `""` and undefined all mean loopback, so a truthy fallback is intentional
+        host: host === true ? "0.0.0.0" : host || "127.0.0.1",
+      })
+      server.middlewares.use((request, response, next) => {
+        if (!request.url?.startsWith("/api/")) return next()
+        void api.handle(request, response, next)
+      })
+      server.httpServer?.once("close", () => {
+        void api.close()
+      })
+    },
+  }
+}

package/kernel/apps/web/server/folder-favicon.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/folder-favicon"

package/kernel/apps/web/server/folder-icons.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/folder-icons"

package/kernel/apps/web/server/folder-metadata-plugin.ts

@@ -0,0 +1,31 @@
+import type { Plugin } from "vite"
+
+import type { FolderMetadataPluginOptions } from "@raggle-ai/kennel-api/server/folder-metadata-plugin"
+import { createFolderApi } from "@raggle-ai/kennel-api/server/folder-metadata-plugin"
+
+/** Compatibility adapter for existing route tests. Production uses core. */
+export function folderMetadataPlugin(
+  options: FolderMetadataPluginOptions,
+): Plugin {
+  return {
+    name: "kennel-folder-metadata",
+    configureServer(server) {
+      const api = createFolderApi({ viewerName: "kennel-vite", ...options })
+      server.httpServer?.once("close", () => api.close())
+      api.attach({
+        host: server.config?.server?.host,
+        use: (handler) => {
+          server.middlewares.use(handler)
+        },
+        watch: (paths) => {
+          server.watcher.add(paths)
+        },
+        onChange: (listener) => {
+          for (const event of ["add", "change", "unlink"] as const)
+            server.watcher.on(event, listener)
+        },
+        emit: (event) => server.ws.send(event),
+      })
+    },
+  }
+}

package/kernel/apps/web/server/plugins.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-api/server/plugins"

package/kernel/apps/web/server/preview-kinds.ts

@@ -0,0 +1 @@
+export * from "@raggle-ai/kennel-preview/kinds"

package/kernel/apps/web/src/ai-input.tsx

@@ -0,0 +1,62 @@
+import type { ComponentType } from "react"
+import { useEffect, useState } from "react"
+import { api } from "~/api-client"
+
+import type { SelectionRequest, SelectionResult } from "./selection-context"
+
+export type AiInputAdapter = {
+  Composer: ComponentType
+  install?: () => void | Promise<void>
+  // Selection requests must be read-only. Kennel alone applies approved edits.
+  selection?: (
+    request: SelectionRequest,
+    signal: AbortSignal,
+  ) => Promise<SelectionResult>
+}
+
+const adapterPromises = new Map<string, Promise<AiInputAdapter>>()
+
+async function loadAiInput(folder?: string) {
+  const config = await api.config(folder)
+  const moduleUrl = config.aiInputModule
+  if (typeof moduleUrl !== "string" || !moduleUrl) return null
+  const existing = adapterPromises.get(moduleUrl)
+  if (existing) return existing
+
+  const adapterPromise = import(/* @vite-ignore */ moduleUrl).then((module) => {
+    const adapter = module.default as AiInputAdapter | undefined
+    if (!adapter?.Composer) {
+      throw new Error(
+        "The AI input module must default-export an adapter with a Composer component.",
+      )
+    }
+    return adapter
+  })
+  adapterPromises.set(moduleUrl, adapterPromise)
+  return adapterPromise
+}
+
+export function useAiInput(folder?: string) {
+  const [loaded, setLoaded] = useState<{
+    folder?: string
+    adapter: AiInputAdapter | null
+  }>()
+
+  useEffect(() => {
+    let active = true
+    void loadAiInput(folder)
+      .then(async (value) => {
+        if (!active) return
+        await value?.install?.()
+        if (active) setLoaded({ folder, adapter: value })
+      })
+      .catch((error: unknown) => {
+        console.error("Could not load the configured AI input adapter.", error)
+      })
+    return () => {
+      active = false
+    }
+  }, [folder])
+
+  return loaded?.folder === folder ? (loaded?.adapter ?? null) : null
+}