@agentskit/chat-cli 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 AgentsKit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,12 @@
+# @agentskit/chat-cli
+
+```bash
+agentskit-chat init my-chat --renderer react --yes
+```
+
+Supported targets are `react`, `react-native`, `ink`, `vue`, `svelte`, `solid`,
+and `angular`. The command detects a host package manifest when unambiguous,
+prompts only on an interactive TTY, and atomically publishes only to a target
+path that does not already exist.
+
+Generated projects contain a shared definition, Web-standard server handler, native renderer, test, and architecture README. They use only published AgentsKit and AgentsKit Chat packages.

package/dist/bin.cjs

@@ -0,0 +1,407 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/bin.ts
+var import_node_util = require("util");
+var import_promises2 = require("readline/promises");
+var import_node_process = require("process");
+
+// src/index.ts
+var import_promises = require("fs/promises");
+var import_node_path = __toESM(require("path"), 1);
+var import_chat = require("@agentskit/chat");
+var import_zod = require("zod");
+var CHAT_RENDERERS = ["react", "react-native", "ink", "vue", "svelte", "solid", "angular"];
+var ChatRendererSchema = import_zod.z.enum(CHAT_RENDERERS);
+var ChatCliError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "ChatCliError";
+  }
+  code;
+};
+var packageJson = (renderer) => JSON.stringify({
+  name: "agentskit-chat-app",
+  private: true,
+  version: "0.0.0",
+  type: "module",
+  ...renderer === "react-native" ? { main: "expo/AppEntry.js" } : {},
+  scripts: { typecheck: renderer === "svelte" ? "svelte-check --tsconfig ./tsconfig.json" : "tsc --noEmit", test: "vitest run", ...["react", "vue", "svelte", "solid", "angular"].includes(renderer) ? { dev: "vite", build: "vite build" } : renderer === "react-native" ? { dev: "expo start", build: "expo export --platform web" } : { dev: "tsx src/index.tsx" } },
+  dependencies: {
+    "@agentskit/chat": "latest",
+    "@agentskit/chat-protocol": "latest",
+    "@agentskit/chat-server": "latest",
+    "@agentskit/core": "^1.12.2",
+    zod: "^4.3.6",
+    ...renderer === "react" ? { "@agentskit/chat-react": "latest", "@agentskit/react": "^0.7.1", react: "^19.0.0", "react-dom": "^19.0.0" } : renderer === "react-native" ? { "@agentskit/chat-react-native": "latest", "@agentskit/react-native": "^0.4.4", expo: "^57.0.4", react: "19.2.3", "react-dom": "19.2.3", "react-native": "^0.86.0", "react-native-web": "^0.21.2" } : renderer === "ink" ? { "@agentskit/chat-ink": "latest", "@agentskit/ink": "^0.10.1", ink: "^7.0.0", react: "^19.0.0" } : renderer === "vue" ? { "@agentskit/chat-vue": "latest", "@agentskit/vue": "^0.4.4", vue: "^3.5.0" } : renderer === "svelte" ? { "@agentskit/chat-svelte": "latest", "@agentskit/svelte": "^0.4.4", svelte: "^5.0.0" } : renderer === "solid" ? { "@agentskit/chat-solid": "latest", "@agentskit/solid": "^0.4.4", "solid-js": "^1.9.0" } : { "@agentskit/chat-angular": "latest", "@agentskit/angular": "^0.4.6", "@angular/common": "^21.0.0", "@angular/compiler": "^21.0.0", "@angular/core": "^21.0.0", "@angular/platform-browser": "^21.0.0", rxjs: "^7.8.0", tslib: "^2.8.0", "zone.js": "^0.16.0" }
+  },
+  devDependencies: { "@types/node": "^25.0.0", tsx: "^4.20.0", typescript: renderer === "angular" ? "^5.9.0" : "^6.0.0", vitest: "^4.0.0", ...["react", "react-native", "ink"].includes(renderer) ? { "@types/react": "^19.0.0" } : {}, ...renderer === "react" ? { "@types/react-dom": "^19.0.0", "@vitejs/plugin-react": "^5.0.0", vite: "^8.0.0" } : renderer === "vue" ? { "@vitejs/plugin-vue": "^6.0.0", vite: "^8.0.0" } : renderer === "svelte" ? { "@sveltejs/vite-plugin-svelte": "^7.0.0", "svelte-check": "^4.0.0", vite: "^8.0.0" } : renderer === "solid" ? { "vite-plugin-solid": "^2.11.0", vite: "^8.0.0" } : renderer === "angular" ? { vite: "^8.0.0" } : {} }
+}, null, 2) + "\n";
+var sharedFiles = () => ({
+  "src/chat.ts": `import type { AdapterFactory } from '@agentskit/core'
+import { defineChat } from '@agentskit/chat'
+
+const demoAdapter: AdapterFactory = {
+  createSource: request => ({
+    async *stream() {
+      const input = request.messages.filter(message => message.role === 'user').at(-1)?.content ?? ''
+      yield { type: 'text', content: \`Echo: \${input}\` }
+      yield { type: 'done' }
+    },
+    abort() {},
+  }),
+}
+
+export const chat = defineChat({ id: 'starter', chat: { adapter: demoAdapter } })
+`,
+  "src/server.ts": `import type { SessionSnapshot } from '@agentskit/chat-protocol'
+import type { SessionStorage } from '@agentskit/chat'
+import { createChatHandler } from '@agentskit/chat-server'
+import { chat } from './chat.js'
+
+let snapshot: SessionSnapshot | undefined
+const storage: SessionStorage = {
+  load: () => snapshot,
+  save: (next, expected) => {
+    if (snapshot?.cursor !== expected) return false
+    snapshot = structuredClone(next)
+    return true
+  },
+}
+
+export const handleChat = createChatHandler({ resolveDefinition: () => chat, sessionStorage: () => storage })
+`,
+  "tests/chat.test.ts": `import { describe, expect, it } from 'vitest'
+import { chat } from '../src/chat.js'
+import { handleChat } from '../src/server.js'
+
+describe('generated chat', () => {
+  it('exports one runnable shared definition', () => expect(chat.id).toBe('starter'))
+  it('serves one complete turn through the Web handler', async () => {
+    const event = { protocol: 'agentskit.chat.turn', version: 1, eventId: 'submit', sessionId: 'session', turnId: 'turn', sequence: 0, emittedAt: new Date(0).toISOString(), event: 'client.turn.submit', payload: { input: 'hello' } }
+    const response = await handleChat(new Request('http://localhost/chat', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(event) }))
+    expect(response.status).toBe(200)
+    expect(await response.text()).toContain('Echo: hello')
+  })
+})
+`,
+  "README.md": `# AgentsKit Chat starter
+
+The shared definition lives in \`src/chat.ts\`, the Web-standard server seam in \`src/server.ts\`, and the native renderer entry under \`src\`.
+
+Run \`pnpm typecheck && pnpm test\`, then \`pnpm dev\`. Replace the demo adapter in the shared definition with any published AgentsKit adapter.
+`,
+  ".gitignore": "node_modules\ndist\n.expo\n.env\n",
+  "vitest.config.ts": `import { defineConfig } from 'vitest/config'
+export default defineConfig({ test: { environment: 'node' } })
+`
+});
+var rendererFiles = (renderer) => renderer === "react" ? {
+  "index.html": '<!doctype html><html><body><div id="root"></div><script type="module" src="/src/main.tsx"></script></body></html>\n',
+  "src/main.tsx": `import '@agentskit/react/theme'
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import { AgentChat } from '@agentskit/chat-react'
+import { chat } from './chat.js'
+
+createRoot(document.getElementById('root')!).render(<StrictMode><AgentChat definition={chat} /></StrictMode>)
+`,
+  "src/vite-env.d.ts": `/// <reference types="vite/client" />
+declare module '@agentskit/react/theme'
+`,
+  "vite.config.ts": `import react from '@vitejs/plugin-react'
+import { defineConfig } from 'vite'
+export default defineConfig({ plugins: [react()] })
+`
+} : renderer === "react-native" ? {
+  "App.tsx": `import { AgentChatNative } from '@agentskit/chat-react-native'
+import { chat } from './src/chat'
+export default function App() { return <AgentChatNative definition={chat} /> }
+`,
+  "app.json": JSON.stringify({ expo: { name: "AgentsKit Chat", slug: "agentskit-chat" } }, null, 2) + "\n"
+} : renderer === "ink" ? {
+  "src/index.tsx": `import { AgentChat } from '@agentskit/chat-ink'
+import { render } from 'ink'
+import { chat } from './chat.js'
+const app = render(<AgentChat definition={chat} />)
+if (process.env.CI) setTimeout(() => app.unmount(), 0)
+`
+} : renderer === "vue" ? {
+  "index.html": '<!doctype html><html><body><div id="app"></div><script type="module" src="/src/main.ts"></script></body></html>\n',
+  "src/main.ts": `import { createApp, h } from 'vue'
+import { AgentChat } from '@agentskit/chat-vue'
+import { chat } from './chat.js'
+createApp({ render: () => h(AgentChat, { definition: chat }) }).mount('#app')
+`,
+  "vite.config.ts": `import vue from '@vitejs/plugin-vue'
+import { defineConfig } from 'vite'
+export default defineConfig({ plugins: [vue()] })
+`
+} : renderer === "svelte" ? {
+  "index.html": '<!doctype html><html><body><div id="app"></div><script type="module" src="/src/main.ts"></script></body></html>\n',
+  "src/App.svelte": `<script lang="ts">
+  import { AgentChat } from '@agentskit/chat-svelte'
+  import { chat } from './chat.js'
+</script>
+<AgentChat definition={chat} />
+`,
+  "src/main.ts": `import { mount } from 'svelte'
+import App from './App.svelte'
+mount(App, { target: document.getElementById('app')! })
+`,
+  "src/vite-env.d.ts": `/// <reference types="svelte" />
+`,
+  "vite.config.ts": `import { svelte } from '@sveltejs/vite-plugin-svelte'
+import { defineConfig } from 'vite'
+export default defineConfig({ plugins: [svelte()] })
+`
+} : renderer === "solid" ? {
+  "index.html": '<!doctype html><html><body><div id="app"></div><script type="module" src="/src/main.tsx"></script></body></html>\n',
+  "src/main.tsx": `import { render } from 'solid-js/web'
+import { AgentChat } from '@agentskit/chat-solid'
+import { chat } from './chat.js'
+render(() => <AgentChat definition={chat} />, document.getElementById('app')!)
+`,
+  "vite.config.ts": `import { defineConfig } from 'vite'
+import solid from 'vite-plugin-solid'
+export default defineConfig({ plugins: [solid()] })
+`
+} : {
+  "index.html": '<!doctype html><html><body><app-root></app-root><script type="module" src="/src/main.ts"></script></body></html>\n',
+  "src/main.ts": `import 'zone.js'
+import '@angular/compiler'
+import { Component } from '@angular/core'
+import { bootstrapApplication } from '@angular/platform-browser'
+import { AgentChatComponent } from '@agentskit/chat-angular'
+import { chat } from './chat.js'
+@Component({ selector: 'app-root', standalone: true, imports: [AgentChatComponent], template: '<ak-agent-chat [definition]="chat" />' })
+class AppComponent { readonly chat = chat }
+void bootstrapApplication(AppComponent)
+`
+};
+var tsconfig = (renderer) => JSON.stringify({ compilerOptions: {
+  target: "ES2022",
+  module: "ESNext",
+  moduleResolution: "bundler",
+  jsx: "react-jsx",
+  strict: true,
+  noEmit: true,
+  skipLibCheck: true,
+  ...renderer === "solid" ? { jsx: "preserve", jsxImportSource: "solid-js" } : {},
+  ...["react", "vue", "svelte", "solid", "angular"].includes(renderer) ? { lib: ["ES2022", "DOM"] } : {},
+  ...renderer === "ink" ? { types: ["node"] } : {}
+}, include: renderer === "react-native" ? ["App.tsx", "src", "tests"] : ["src", "tests"] }, null, 2) + "\n";
+var detectRenderer = async (targetDir) => {
+  try {
+    const input = JSON.parse(await (0, import_promises.readFile)(import_node_path.default.join(targetDir, "package.json"), "utf8"));
+    const manifest = import_zod.z.object({ dependencies: import_zod.z.record(import_zod.z.string(), import_zod.z.string()).optional(), devDependencies: import_zod.z.record(import_zod.z.string(), import_zod.z.string()).optional() }).passthrough().parse(input);
+    const dependencies = { ...manifest.dependencies, ...manifest.devDependencies };
+    if (dependencies.expo || dependencies["react-native"]) return "react-native";
+    if (dependencies.ink) return "ink";
+    if (dependencies["@angular/core"]) return "angular";
+    if (dependencies.svelte) return "svelte";
+    if (dependencies.vue) return "vue";
+    if (dependencies["solid-js"]) return "solid";
+    return dependencies.react ? "react" : void 0;
+  } catch (error) {
+    if (error.code === "ENOENT") return void 0;
+    throw new ChatCliError("MANIFEST_INVALID", "Could not read a valid package.json for renderer detection.");
+  }
+};
+var initChatProject = async (options) => {
+  const targetDir = import_node_path.default.resolve(options.targetDir);
+  const candidate = options.renderer ?? await detectRenderer(options.detectFromDir ?? targetDir);
+  if (!candidate) throw new ChatCliError("RENDERER_REQUIRED", `Choose a renderer with --renderer ${CHAT_RENDERERS.join(", ")}.`);
+  const renderer = ChatRendererSchema.parse(candidate);
+  const files = { ...sharedFiles(), ...rendererFiles(renderer), "package.json": packageJson(renderer), "tsconfig.json": tsconfig(renderer) };
+  const parent = import_node_path.default.dirname(targetDir);
+  await (0, import_promises.mkdir)(parent, { recursive: true });
+  const staging = await (0, import_promises.mkdtemp)(import_node_path.default.join(parent, `.${import_node_path.default.basename(targetDir)}-`));
+  try {
+    const writes = await Promise.allSettled(Object.entries(files).map(async ([relative, content]) => {
+      const destination = import_node_path.default.join(staging, relative);
+      await (0, import_promises.mkdir)(import_node_path.default.dirname(destination), { recursive: true });
+      await (0, import_promises.writeFile)(destination, content, { encoding: "utf8", flag: "wx" });
+    }));
+    const failure = writes.find((result) => result.status === "rejected");
+    if (failure?.status === "rejected") throw failure.reason;
+    await (0, import_promises.rename)(staging, targetDir);
+  } catch (error) {
+    await (0, import_promises.rm)(staging, { recursive: true, force: true });
+    const code = error.code;
+    if (code === "EEXIST" || code === "ENOTEMPTY" || code === "EISDIR" || code === "ENOTDIR") throw new ChatCliError("TARGET_EXISTS", `Refusing to overwrite existing path: ${targetDir}`);
+    throw error;
+  }
+  return Object.keys(files).sort();
+};
+var componentName = (input) => {
+  const kebab = input.trim().replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[^A-Za-z0-9]+/g, "-").replace(/^-|-$/g, "").toLowerCase();
+  if (!/^[a-z][a-z0-9-]{0,63}$/.test(kebab)) throw new ChatCliError("COMPONENT_INVALID", "Component name must start with a letter and contain only letters, numbers, or dashes.");
+  if (import_chat.STANDARD_COMPONENT_KEYS.includes(kebab)) throw new ChatCliError("COMPONENT_INVALID", "Component name is reserved by the standard catalog.");
+  return { kebab, pascal: kebab.split("-").map((part) => part[0].toUpperCase() + part.slice(1)).join("") };
+};
+var componentFiles = (name, renderers) => {
+  const { kebab, pascal } = componentName(name);
+  const shared = `import { z } from 'zod'
+import type { ComponentDefinition } from '@agentskit/chat'
+
+export const ${pascal}PropsSchema = z.object({ label: z.string().min(1).max(256) }).strict().readonly()
+export type ${pascal}Props = z.infer<typeof ${pascal}PropsSchema>
+export const ${pascal}Component = { key: '${kebab}', propsSchema: ${pascal}PropsSchema, events: [], accessibility: { role: 'group', keyboard: false, live: 'none' }, capabilities: ['display'], fallback: props => props.label } satisfies ComponentDefinition<${pascal}Props>
+`;
+  const files = { [`src/components/${kebab}.ts`]: shared };
+  for (const renderer of [...new Set(renderers)]) {
+    const relative = `src/components/${renderer}/${kebab}.${renderer === "svelte" ? "svelte" : renderer === "vue" || renderer === "angular" ? "ts" : "tsx"}`;
+    files[relative] = renderer === "svelte" ? `<script lang="ts">
+  import { StandardComponent } from '@agentskit/chat-svelte'
+  import type { ComponentManifest } from '@agentskit/chat'
+  import type { ComponentInteractionEvent, ComponentRenderFrame } from '@agentskit/chat-protocol'
+  import { ${pascal}PropsSchema } from '../${kebab}.js'
+  let { frame, manifest, onInteract, disabled = false }: { frame: ComponentRenderFrame; manifest: ComponentManifest; onInteract: (event: ComponentInteractionEvent) => void; disabled?: boolean } = $props()
+  const value = $derived(frame.componentKey === '${kebab}' ? ${pascal}PropsSchema.parse(frame.props) : undefined)
+</script>
+{#if value}<section aria-label={value.label}>{value.label}</section>{:else}<StandardComponent {frame} {manifest} {onInteract} {disabled} />{/if}
+` : renderer === "vue" ? `import { h, type VNode } from 'vue'
+import { StandardComponent, type StandardComponentProps } from '@agentskit/chat-vue'
+import { ${pascal}PropsSchema } from '../${kebab}.js'
+export const ${pascal} = (slot: StandardComponentProps): VNode[] => { if (slot.frame.componentKey !== '${kebab}') return [h(StandardComponent, slot)]; const props = ${pascal}PropsSchema.parse(slot.frame.props); return [h('section', { 'aria-label': props.label }, props.label)] }
+` : renderer === "angular" ? `import { Component, Input } from '@angular/core'
+import { StandardComponentComponent } from '@agentskit/chat-angular'
+import type { ComponentManifest } from '@agentskit/chat'
+import type { ComponentInteractionEvent, ComponentRenderFrame } from '@agentskit/chat-protocol'
+import { ${pascal}PropsSchema } from '../${kebab}.js'
+@Component({ selector: 'ak-${kebab}', standalone: true, imports: [StandardComponentComponent], template: '@if (value; as item) { <section [attr.aria-label]="item.label">{{ item.label }}</section> } @else { <ak-standard-component [frame]="frame" [manifest]="manifest" [onInteract]="onInteract" [disabled]="disabled" /> }' })
+export class ${pascal}Component { @Input({ required: true }) frame!: ComponentRenderFrame; @Input({ required: true }) manifest!: ComponentManifest; @Input({ required: true }) onInteract!: (event: ComponentInteractionEvent) => void; @Input() disabled = false; get value() { return this.frame.componentKey === '${kebab}' ? ${pascal}PropsSchema.parse(this.frame.props) : undefined } }
+` : renderer === "solid" ? `import { StandardComponent, type StandardComponentProps } from '@agentskit/chat-solid'
+import { ${pascal}PropsSchema } from '../${kebab}.js'
+export const ${pascal} = (slot: StandardComponentProps) => { if (slot.frame.componentKey !== '${kebab}') return <StandardComponent {...slot} />; const props = ${pascal}PropsSchema.parse(slot.frame.props); return <section aria-label={props.label}>{props.label}</section> }
+` : `import { ${renderer === "react-native" ? "StandardComponentNative as DefaultStandardComponent, type StandardComponentNativeProps" : "StandardComponent as DefaultStandardComponent, type StandardComponentProps"} } from '@agentskit/chat-${renderer}'
+import { ${pascal}PropsSchema } from '../${kebab}.js'
+${renderer === "react-native" ? "import { Text } from 'react-native'\n" : renderer === "ink" ? "import { Text } from 'ink'\n" : ""}export const ${pascal} = (slot: ${renderer === "react-native" ? "StandardComponentNativeProps" : "StandardComponentProps"}) => { if (slot.frame.componentKey !== '${kebab}') return <DefaultStandardComponent {...slot} />; const props = ${pascal}PropsSchema.parse(slot.frame.props); return <${renderer === "react-native" || renderer === "ink" ? "Text" : "section"}${renderer === "react-native" ? " accessibilityLabel={props.label}" : renderer === "ink" ? "" : " aria-label={props.label}"}>{props.label}</${renderer === "react-native" || renderer === "ink" ? "Text" : "section"}> }
+`;
+  }
+  return files;
+};
+var addChatComponent = async (options) => {
+  const projectDir = await (0, import_promises.realpath)(import_node_path.default.resolve(options.projectDir)).catch(() => {
+    throw new ChatCliError("MANIFEST_INVALID", "Component generation requires an existing project directory.");
+  });
+  const renderers = import_zod.z.array(ChatRendererSchema).min(1).parse(options.renderers);
+  const files = componentFiles(options.name, renderers);
+  const destinations = Object.keys(files).map((relative) => import_node_path.default.join(projectDir, relative));
+  for (const destination of destinations) {
+    let current = import_node_path.default.dirname(destination);
+    while (current !== projectDir) {
+      const status = await (0, import_promises.lstat)(current).catch((error) => error.code === "ENOENT" ? void 0 : Promise.reject(error));
+      if (status?.isSymbolicLink()) throw new ChatCliError("MANIFEST_INVALID", "Refusing to write through a symbolic-link component directory.");
+      current = import_node_path.default.dirname(current);
+    }
+  }
+  const checks = await Promise.all(destinations.map((destination) => (0, import_promises.readFile)(destination).then(() => true, (error) => error.code === "ENOENT" ? false : Promise.reject(error))));
+  if (checks.some(Boolean)) throw new ChatCliError("COMPONENT_EXISTS", "Refusing to overwrite an existing component file.");
+  const created = [];
+  try {
+    for (const [relative, content] of Object.entries(files)) {
+      const destination = import_node_path.default.join(projectDir, relative);
+      await (0, import_promises.mkdir)(import_node_path.default.dirname(destination), { recursive: true });
+      await (0, import_promises.writeFile)(destination, content, { encoding: "utf8", flag: "wx" });
+      created.push(destination);
+    }
+  } catch (error) {
+    await Promise.all(created.map((destination) => (0, import_promises.rm)(destination, { force: true })));
+    if (error.code === "EEXIST") throw new ChatCliError("COMPONENT_EXISTS", "Refusing to overwrite an existing component file.");
+    throw error;
+  }
+  return Object.keys(files).sort();
+};
+
+// src/bin.ts
+var help = `Usage: agentskit-chat init [directory] [--renderer ${CHAT_RENDERERS.join("|")}] [--yes]
+       agentskit-chat add component <name> --renderer react,vue [--directory .] [--yes]
+       agentskit-chat completion bash|zsh|fish
+       agentskit-chat --help
+       agentskit-chat --version
+`;
+var completion = (shell) => {
+  if (shell === "bash") return `_agentskit_chat_complete() { local words="--renderer --directory --yes"; [[ $COMP_CWORD == 1 ]] && words="init add completion --help --version"; [[ \${COMP_WORDS[COMP_CWORD-1]} == add ]] && words="component"; [[ \${COMP_WORDS[COMP_CWORD-1]} == --renderer ]] && words="${CHAT_RENDERERS.join(" ")}"; COMPREPLY=($(compgen -W "$words" -- "\${COMP_WORDS[COMP_CWORD]}")); }
+complete -F _agentskit_chat_complete agentskit-chat
+`;
+  if (shell === "zsh") return `#compdef agentskit-chat
+_arguments "1:command:(init add completion)" "2:subcommand:(component)" "3:component name:" "--renderer[renderer]:renderer:(${CHAT_RENDERERS.join(" ")})" "--directory[project directory]:directory:_directories" "--yes[non-interactive]"
+`;
+  if (shell === "fish") return `complete -c agentskit-chat -f -n '__fish_use_subcommand' -a 'init add completion'
+complete -c agentskit-chat -f -n '__fish_seen_subcommand_from add' -a 'component'
+complete -c agentskit-chat -l renderer -a "${CHAT_RENDERERS.join(" ")}"
+complete -c agentskit-chat -l directory -r
+complete -c agentskit-chat -l yes
+`;
+  throw new Error(`Expected completion shell bash, zsh, or fish.
+${help}`);
+};
+var main = async () => {
+  const parsed = (0, import_node_util.parseArgs)({ allowPositionals: true, strict: true, options: { renderer: { type: "string" }, directory: { type: "string", short: "d" }, yes: { type: "boolean", short: "y" }, help: { type: "boolean", short: "h" }, version: { type: "boolean", short: "v" } } });
+  if (parsed.values.help) return void import_node_process.stdout.write(help);
+  if (parsed.values.version) return void import_node_process.stdout.write(`${"0.1.0"}
+`);
+  if (parsed.positionals[0] === "completion") {
+    if (parsed.positionals.length !== 2) throw new Error(`Expected one completion shell.
+${help}`);
+    return void import_node_process.stdout.write(completion(parsed.positionals[1]));
+  }
+  if (parsed.positionals[0] === "add") {
+    if (parsed.positionals[1] !== "component" || parsed.positionals.length !== 3) throw new Error(`Expected add component <name>.
+${help}`);
+    const renderers = parsed.values.renderer?.split(",").filter(Boolean).map((renderer2) => ChatRendererSchema.parse(renderer2));
+    if (!renderers?.length) throw new Error(`Expected --renderer with one or more comma-separated targets.
+${help}`);
+    const files2 = await addChatComponent({ projectDir: parsed.values.directory ?? process.cwd(), name: parsed.positionals[2], renderers });
+    return void import_node_process.stdout.write(`${JSON.stringify({ ok: true, files: files2 })}
+`);
+  }
+  if (parsed.positionals[0] !== "init") throw new Error(`Expected init command.
+${help}`);
+  if (parsed.values.directory !== void 0) throw new Error(`--directory is only valid with add component.
+${help}`);
+  if (parsed.positionals.length > 2) throw new Error(`Expected at most one target directory.
+${help}`);
+  let renderer = parsed.values.renderer ?? await detectRenderer(process.cwd());
+  if (!renderer && !parsed.values.yes && import_node_process.stdin.isTTY && import_node_process.stdout.isTTY) {
+    const prompt = (0, import_promises2.createInterface)({ input: import_node_process.stdin, output: import_node_process.stdout });
+    try {
+      renderer = await prompt.question(`Renderer (${CHAT_RENDERERS.join(", ")}): `);
+    } finally {
+      prompt.close();
+    }
+  }
+  const files = await initChatProject({ targetDir: parsed.positionals[1] ?? "agentskit-chat-app", detectFromDir: process.cwd(), ...renderer ? { renderer: ChatRendererSchema.parse(renderer) } : {} });
+  import_node_process.stdout.write(`${JSON.stringify({ ok: true, files })}
+`);
+};
+main().catch((error) => {
+  import_node_process.stderr.write(`${error instanceof Error ? error.message : String(error)}
+`);
+  process.exitCode = 1;
+});

package/dist/bin.d.cts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/bin.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import {
+  CHAT_RENDERERS,
+  ChatRendererSchema,
+  addChatComponent,
+  detectRenderer,
+  initChatProject
+} from "./chunk-SWALGE4D.js";
+
+// src/bin.ts
+import { parseArgs } from "util";
+import { createInterface } from "readline/promises";
+import { stdin, stderr, stdout } from "process";
+var help = `Usage: agentskit-chat init [directory] [--renderer ${CHAT_RENDERERS.join("|")}] [--yes]
+       agentskit-chat add component <name> --renderer react,vue [--directory .] [--yes]
+       agentskit-chat completion bash|zsh|fish
+       agentskit-chat --help
+       agentskit-chat --version
+`;
+var completion = (shell) => {
+  if (shell === "bash") return `_agentskit_chat_complete() { local words="--renderer --directory --yes"; [[ $COMP_CWORD == 1 ]] && words="init add completion --help --version"; [[ \${COMP_WORDS[COMP_CWORD-1]} == add ]] && words="component"; [[ \${COMP_WORDS[COMP_CWORD-1]} == --renderer ]] && words="${CHAT_RENDERERS.join(" ")}"; COMPREPLY=($(compgen -W "$words" -- "\${COMP_WORDS[COMP_CWORD]}")); }
+complete -F _agentskit_chat_complete agentskit-chat
+`;
+  if (shell === "zsh") return `#compdef agentskit-chat
+_arguments "1:command:(init add completion)" "2:subcommand:(component)" "3:component name:" "--renderer[renderer]:renderer:(${CHAT_RENDERERS.join(" ")})" "--directory[project directory]:directory:_directories" "--yes[non-interactive]"
+`;
+  if (shell === "fish") return `complete -c agentskit-chat -f -n '__fish_use_subcommand' -a 'init add completion'
+complete -c agentskit-chat -f -n '__fish_seen_subcommand_from add' -a 'component'
+complete -c agentskit-chat -l renderer -a "${CHAT_RENDERERS.join(" ")}"
+complete -c agentskit-chat -l directory -r
+complete -c agentskit-chat -l yes
+`;
+  throw new Error(`Expected completion shell bash, zsh, or fish.
+${help}`);
+};
+var main = async () => {
+  const parsed = parseArgs({ allowPositionals: true, strict: true, options: { renderer: { type: "string" }, directory: { type: "string", short: "d" }, yes: { type: "boolean", short: "y" }, help: { type: "boolean", short: "h" }, version: { type: "boolean", short: "v" } } });
+  if (parsed.values.help) return void stdout.write(help);
+  if (parsed.values.version) return void stdout.write(`${"0.1.0"}
+`);
+  if (parsed.positionals[0] === "completion") {
+    if (parsed.positionals.length !== 2) throw new Error(`Expected one completion shell.
+${help}`);
+    return void stdout.write(completion(parsed.positionals[1]));
+  }
+  if (parsed.positionals[0] === "add") {
+    if (parsed.positionals[1] !== "component" || parsed.positionals.length !== 3) throw new Error(`Expected add component <name>.
+${help}`);
+    const renderers = parsed.values.renderer?.split(",").filter(Boolean).map((renderer2) => ChatRendererSchema.parse(renderer2));
+    if (!renderers?.length) throw new Error(`Expected --renderer with one or more comma-separated targets.
+${help}`);
+    const files2 = await addChatComponent({ projectDir: parsed.values.directory ?? process.cwd(), name: parsed.positionals[2], renderers });
+    return void stdout.write(`${JSON.stringify({ ok: true, files: files2 })}
+`);
+  }
+  if (parsed.positionals[0] !== "init") throw new Error(`Expected init command.
+${help}`);
+  if (parsed.values.directory !== void 0) throw new Error(`--directory is only valid with add component.
+${help}`);
+  if (parsed.positionals.length > 2) throw new Error(`Expected at most one target directory.
+${help}`);
+  let renderer = parsed.values.renderer ?? await detectRenderer(process.cwd());
+  if (!renderer && !parsed.values.yes && stdin.isTTY && stdout.isTTY) {
+    const prompt = createInterface({ input: stdin, output: stdout });
+    try {
+      renderer = await prompt.question(`Renderer (${CHAT_RENDERERS.join(", ")}): `);
+    } finally {
+      prompt.close();
+    }
+  }
+  const files = await initChatProject({ targetDir: parsed.positionals[1] ?? "agentskit-chat-app", detectFromDir: process.cwd(), ...renderer ? { renderer: ChatRendererSchema.parse(renderer) } : {} });
+  stdout.write(`${JSON.stringify({ ok: true, files })}
+`);
+};
+main().catch((error) => {
+  stderr.write(`${error instanceof Error ? error.message : String(error)}
+`);
+  process.exitCode = 1;
+});