@agentskit/chat-cli 0.1.0

package/dist/index.cjs

@@ -0,0 +1,358 @@
+#!/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 __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+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
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  CHAT_RENDERERS: () => CHAT_RENDERERS,
+  ChatCliError: () => ChatCliError,
+  ChatRendererSchema: () => ChatRendererSchema,
+  addChatComponent: () => addChatComponent,
+  detectRenderer: () => detectRenderer,
+  initChatProject: () => initChatProject
+});
+module.exports = __toCommonJS(src_exports);
+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();
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CHAT_RENDERERS,
+  ChatCliError,
+  ChatRendererSchema,
+  addChatComponent,
+  detectRenderer,
+  initChatProject
+});

package/dist/index.d.cts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+
+declare const CHAT_RENDERERS: readonly ["react", "react-native", "ink", "vue", "svelte", "solid", "angular"];
+declare const ChatRendererSchema: z.ZodEnum<{
+    react: "react";
+    "react-native": "react-native";
+    ink: "ink";
+    vue: "vue";
+    svelte: "svelte";
+    solid: "solid";
+    angular: "angular";
+}>;
+type ChatRenderer = z.infer<typeof ChatRendererSchema>;
+interface InitChatProjectOptions {
+    readonly targetDir: string;
+    readonly renderer?: ChatRenderer;
+    readonly detectFromDir?: string;
+}
+interface AddComponentOptions {
+    readonly projectDir: string;
+    readonly name: string;
+    readonly renderers: readonly ChatRenderer[];
+}
+declare class ChatCliError extends Error {
+    readonly code: 'RENDERER_REQUIRED' | 'TARGET_EXISTS' | 'MANIFEST_INVALID' | 'COMPONENT_INVALID' | 'COMPONENT_EXISTS';
+    constructor(code: 'RENDERER_REQUIRED' | 'TARGET_EXISTS' | 'MANIFEST_INVALID' | 'COMPONENT_INVALID' | 'COMPONENT_EXISTS', message: string);
+}
+declare const detectRenderer: (targetDir: string) => Promise<ChatRenderer | undefined>;
+declare const initChatProject: (options: InitChatProjectOptions) => Promise<readonly string[]>;
+declare const addChatComponent: (options: AddComponentOptions) => Promise<readonly string[]>;
+
+export { type AddComponentOptions, CHAT_RENDERERS, ChatCliError, type ChatRenderer, ChatRendererSchema, type InitChatProjectOptions, addChatComponent, detectRenderer, initChatProject };

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+
+declare const CHAT_RENDERERS: readonly ["react", "react-native", "ink", "vue", "svelte", "solid", "angular"];
+declare const ChatRendererSchema: z.ZodEnum<{
+    react: "react";
+    "react-native": "react-native";
+    ink: "ink";
+    vue: "vue";
+    svelte: "svelte";
+    solid: "solid";
+    angular: "angular";
+}>;
+type ChatRenderer = z.infer<typeof ChatRendererSchema>;
+interface InitChatProjectOptions {
+    readonly targetDir: string;
+    readonly renderer?: ChatRenderer;
+    readonly detectFromDir?: string;
+}
+interface AddComponentOptions {
+    readonly projectDir: string;
+    readonly name: string;
+    readonly renderers: readonly ChatRenderer[];
+}
+declare class ChatCliError extends Error {
+    readonly code: 'RENDERER_REQUIRED' | 'TARGET_EXISTS' | 'MANIFEST_INVALID' | 'COMPONENT_INVALID' | 'COMPONENT_EXISTS';
+    constructor(code: 'RENDERER_REQUIRED' | 'TARGET_EXISTS' | 'MANIFEST_INVALID' | 'COMPONENT_INVALID' | 'COMPONENT_EXISTS', message: string);
+}
+declare const detectRenderer: (targetDir: string) => Promise<ChatRenderer | undefined>;
+declare const initChatProject: (options: InitChatProjectOptions) => Promise<readonly string[]>;
+declare const addChatComponent: (options: AddComponentOptions) => Promise<readonly string[]>;
+
+export { type AddComponentOptions, CHAT_RENDERERS, ChatCliError, type ChatRenderer, ChatRendererSchema, type InitChatProjectOptions, addChatComponent, detectRenderer, initChatProject };

package/dist/index.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import {
+  CHAT_RENDERERS,
+  ChatCliError,
+  ChatRendererSchema,
+  addChatComponent,
+  detectRenderer,
+  initChatProject
+} from "./chunk-SWALGE4D.js";
+export {
+  CHAT_RENDERERS,
+  ChatCliError,
+  ChatRendererSchema,
+  addChatComponent,
+  detectRenderer,
+  initChatProject
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@agentskit/chat-cli",
+  "version": "0.1.0",
+  "description": "Safe scaffolding for AgentsKit Chat applications.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentsKit-io/agentskit-chat.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/AgentsKit-io/agentskit-chat#readme",
+  "bugs": {
+    "url": "https://github.com/AgentsKit-io/agentskit-chat/issues"
+  },
+  "type": "module",
+  "bin": {
+    "agentskit-chat": "./dist/bin.js"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^4.3.6",
+    "@agentskit/chat": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.0",
+    "node-pty": "^1.1.0",
+    "tsup": "^8.5.1"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "tsc --noEmit",
+    "test": "vitest run --coverage"
+  }
+}