npm - @agentskit/cli - Versions diffs - 0.7.1 → 0.9.0 - Mend

@agentskit/cli 0.7.1 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/README.md +2 -2
package/dist/bin.cjs +826 -2
package/dist/bin.cjs.map +1 -1
package/dist/bin.js +1 -1
package/dist/{chunk-72XFU2X2.js → chunk-ZEESHYST.js} +828 -4
package/dist/chunk-ZEESHYST.js.map +1 -0
package/dist/index.cjs +826 -2
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +1 -1
package/dist/index.d.ts +1 -1
package/dist/index.js +1 -1
package/package.json +22 -11
package/dist/chunk-72XFU2X2.js.map +0 -1

package/dist/index.cjs CHANGED Viewed

@@ -22,6 +22,7 @@ var prompts = require('@inquirer/prompts');
 var kleur = require('kleur');
 var chokidar = require('chokidar');
 var rag = require('@agentskit/rag');
+var agentSchema = require('@agentskit/core/agent-schema');
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -2078,6 +2079,635 @@ console.log(\`\\n\u2014 \${result.steps} steps \xB7 \${result.toolCalls.length}
     "README.md": readmeFor(ctx)
   };
 }
+function buildAdapterServerImport(provider) {
+  if (provider === "demo") return "";
+  return `import { ${PROVIDER_IMPORT[provider]} } from '@agentskit/adapters'
+`;
+}
+function envExampleFor(provider) {
+  const envKey = PROVIDER_ENV_KEY[provider];
+  return envKey ? `${envKey}=
+` : "# No API key required for the demo provider\n";
+}
+function sveltekitStarter(ctx) {
+  const deps = {
+    "@agentskit/svelte": "^0.4.0",
+    "@sveltejs/kit": "^2.0.0",
+    svelte: "^5.0.0"
+  };
+  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
+  const adapterCallStr = adapterCall(ctx.provider);
+  const adapterImport2 = buildAdapterServerImport(ctx.provider);
+  const demoSnippet = ctx.provider === "demo" ? demoAdapterSnippet() : "";
+  return {
+    "package.json": JSON.stringify(
+      {
+        name: "agentskit-sveltekit-app",
+        private: true,
+        type: "module",
+        scripts: {
+          dev: "vite dev",
+          build: "vite build",
+          preview: "vite preview",
+          check: "svelte-check --tsconfig ./tsconfig.json"
+        },
+        dependencies: deps,
+        devDependencies: {
+          "@sveltejs/adapter-auto": "^4.0.0",
+          "@sveltejs/vite-plugin-svelte": "^6.0.0",
+          "svelte-check": "^4.0.0",
+          typescript: "^5.5.0",
+          vite: "^7.0.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "svelte.config.js": `import adapter from '@sveltejs/adapter-auto'
+import { vitePreprocess } from '@sveltejs/vite-plugin-svelte'
+export default {
+  preprocess: vitePreprocess(),
+  kit: { adapter: adapter() },
+}
+`,
+    "vite.config.ts": `import { sveltekit } from '@sveltejs/kit/vite'
+import { defineConfig } from 'vite'
+export default defineConfig({ plugins: [sveltekit()] })
+`,
+    "tsconfig.json": JSON.stringify(
+      {
+        extends: "./.svelte-kit/tsconfig.json",
+        compilerOptions: {
+          allowJs: true,
+          checkJs: true,
+          esModuleInterop: true,
+          forceConsistentCasingInFileNames: true,
+          resolveJsonModule: true,
+          skipLibCheck: true,
+          sourceMap: true,
+          strict: true,
+          moduleResolution: "bundler"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "src/app.html": `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    %sveltekit.head%
+  </head>
+  <body>%sveltekit.body%</body>
+</html>
+`,
+    "src/routes/+page.svelte": `<script lang="ts">
+  import { useChat } from '@agentskit/svelte'
+  import '@agentskit/svelte/theme'
+  const chat = useChat({ endpoint: '/api/chat' })
+</script>
+<main>
+  {#each $chat.messages as message (message.id)}
+    <article data-ak-message data-role={message.role}>{message.content}</article>
+  {/each}
+  <form on:submit|preventDefault={() => chat.send($chat.input)}>
+    <input bind:value={$chat.input} />
+    <button>Send</button>
+  </form>
+</main>
+`,
+    "src/routes/api/chat/+server.ts": `import type { RequestHandler } from './$types'
+${adapterImport2}${demoSnippet}export const POST: RequestHandler = async ({ request }) => {
+  const { messages } = await request.json()
+  const adapter = ${adapterCallStr}
+  const source = adapter.createSource({ messages: messages.map((m: { role: string; content: string }, i: number) => ({
+    id: String(i), role: m.role, content: m.content,
+    status: 'complete' as const, createdAt: new Date(0),
+  })) })
+  const stream = new ReadableStream<Uint8Array>({
+    async start(controller) {
+      const encoder = new TextEncoder()
+      for await (const chunk of source.stream()) {
+        if (chunk.type === 'text') controller.enqueue(encoder.encode(chunk.content))
+      }
+      controller.close()
+    },
+  })
+  return new Response(stream, { headers: { 'content-type': 'text/plain; charset=utf-8' } })
+}
+`,
+    ".env.example": envExampleFor(ctx.provider),
+    ".gitignore": "node_modules\n.svelte-kit\nbuild\n.env\n.env.local\n",
+    "README.md": readmeFor(ctx)
+  };
+}
+function nuxtStarter(ctx) {
+  const deps = {
+    "@agentskit/vue": "^0.4.0",
+    nuxt: "^4.0.0",
+    vue: "^3.5.0"
+  };
+  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
+  const adapterCallStr = adapterCall(ctx.provider);
+  const adapterImport2 = buildAdapterServerImport(ctx.provider);
+  const demoSnippet = ctx.provider === "demo" ? demoAdapterSnippet() : "";
+  return {
+    "package.json": JSON.stringify(
+      {
+        name: "agentskit-nuxt-app",
+        private: true,
+        type: "module",
+        scripts: {
+          dev: "nuxt dev",
+          build: "nuxt build",
+          preview: "nuxt preview",
+          generate: "nuxt generate"
+        },
+        dependencies: deps,
+        devDependencies: { typescript: "^5.5.0" }
+      },
+      null,
+      2
+    ) + "\n",
+    "nuxt.config.ts": `export default defineNuxtConfig({
+  compatibilityDate: '2026-04-01',
+  modules: [],
+  typescript: { strict: true },
+})
+`,
+    "tsconfig.json": JSON.stringify(
+      { extends: "./.nuxt/tsconfig.json" },
+      null,
+      2
+    ) + "\n",
+    "app.vue": `<script setup lang="ts">
+import { useChat } from '@agentskit/vue'
+import '@agentskit/vue/theme'
+const { messages, input, send } = useChat({ endpoint: '/api/chat' })
+</script>
+<template>
+  <main>
+    <article v-for="message in messages" :key="message.id" :data-role="message.role">
+      {{ message.content }}
+    </article>
+    <form @submit.prevent="send(input)">
+      <input v-model="input" />
+      <button>Send</button>
+    </form>
+  </main>
+</template>
+`,
+    "server/api/chat.post.ts": `${adapterImport2}${demoSnippet}export default defineEventHandler(async (event) => {
+  const { messages } = await readBody<{ messages: Array<{ role: string; content: string }> }>(event)
+  const adapter = ${adapterCallStr}
+  const source = adapter.createSource({ messages: messages.map((m, i) => ({
+    id: String(i), role: m.role as 'user' | 'assistant' | 'system',
+    content: m.content, status: 'complete' as const, createdAt: new Date(0),
+  })) })
+  setHeader(event, 'content-type', 'text/plain; charset=utf-8')
+  return sendStream(event, new ReadableStream<Uint8Array>({
+    async start(controller) {
+      const encoder = new TextEncoder()
+      for await (const chunk of source.stream()) {
+        if (chunk.type === 'text') controller.enqueue(encoder.encode(chunk.content))
+      }
+      controller.close()
+    },
+  }))
+})
+`,
+    ".env.example": envExampleFor(ctx.provider),
+    ".gitignore": "node_modules\n.nuxt\n.output\n.env\n.env.local\n",
+    "README.md": readmeFor(ctx)
+  };
+}
+function viteInkStarter(ctx) {
+  const deps = {
+    "@agentskit/ink": "^0.4.0",
+    ink: "^7.0.0",
+    react: "^19.0.0"
+  };
+  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
+  if (ctx.tools.length > 0) deps["@agentskit/tools"] = "^0.4.0";
+  return {
+    "package.json": JSON.stringify(
+      {
+        name: "agentskit-vite-ink-app",
+        private: true,
+        type: "module",
+        scripts: {
+          dev: "vite-node --watch src/index.tsx",
+          start: "vite-node src/index.tsx",
+          build: "vite build"
+        },
+        dependencies: deps,
+        devDependencies: {
+          "@types/react": "^19.0.0",
+          "vite-node": "^4.0.0",
+          vite: "^7.0.0",
+          typescript: "^5.5.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "vite.config.ts": `import { defineConfig } from 'vite'
+export default defineConfig({
+  build: { ssr: true, target: 'node22', rollupOptions: { input: 'src/index.tsx' } },
+})
+`,
+    "tsconfig.json": JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          jsx: "react-jsx",
+          strict: true,
+          noEmit: true,
+          skipLibCheck: true
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    ) + "\n",
+    "src/index.tsx": `import React from 'react'
+import { render } from 'ink'
+import { ChatContainer, InputBar, Message, useChat } from '@agentskit/ink'
+${adapterImport(ctx.provider)}${toolImports(ctx.tools)}
+${ctx.provider === "demo" ? demoAdapterSnippet() : ""}function App() {
+  const chat = useChat({
+    adapter: ${adapterCall(ctx.provider)},${ctx.tools.length > 0 ? `
+    tools: ${toolList(ctx.tools)},` : ""}
+  })
+  return (
+    <ChatContainer>
+      {chat.messages.map(message => (
+        <Message key={message.id} message={message} />
+      ))}
+      <InputBar chat={chat} />
+    </ChatContainer>
+  )
+}
+render(<App />)
+`,
+    ".env.example": envExampleFor(ctx.provider),
+    ".gitignore": "node_modules\ndist\n.env\n.env.local\n.agentskit-history.*\n",
+    "README.md": readmeFor(ctx)
+  };
+}
+function cloudflareWorkersStarter(ctx) {
+  const deps = {
+    "itty-router": "^5.0.0"
+  };
+  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
+  const adapterCallEdge = ctx.provider === "demo" ? "demoAdapter()" : ctx.provider === "ollama" ? `ollama({ model: '${PROVIDER_DEFAULT_MODEL[ctx.provider]}' })` : `${PROVIDER_IMPORT[ctx.provider]}({ apiKey: env.${PROVIDER_ENV_KEY[ctx.provider]} ?? '', model: '${PROVIDER_DEFAULT_MODEL[ctx.provider]}' })`;
+  const adapterImport2 = buildAdapterServerImport(ctx.provider);
+  const demoSnippet = ctx.provider === "demo" ? demoAdapterSnippet() : "";
+  const envKey = PROVIDER_ENV_KEY[ctx.provider];
+  return {
+    "package.json": JSON.stringify(
+      {
+        name: "agentskit-cf-worker",
+        private: true,
+        type: "module",
+        scripts: {
+          dev: "wrangler dev",
+          deploy: "wrangler deploy"
+        },
+        dependencies: deps,
+        devDependencies: {
+          "@cloudflare/workers-types": "^4.0.0",
+          typescript: "^5.5.0",
+          wrangler: "^3.0.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "wrangler.toml": `name = "agentskit-cf-worker"
+main = "src/worker.ts"
+compatibility_date = "2026-04-01"
+compatibility_flags = ["nodejs_compat"]
+# Bind D1 + KV when you wire memory:
+# [[d1_databases]]
+# binding = "DB"
+# database_name = "agentskit"
+#
+# [[kv_namespaces]]
+# binding = "KV"
+# id = "..."
+[vars]
+${envKey ? `# Set ${envKey} via 'wrangler secret put ${envKey}'` : "# No API key required for the demo provider"}
+`,
+    "tsconfig.json": JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          lib: ["ES2022"],
+          types: ["@cloudflare/workers-types"],
+          strict: true,
+          noEmit: true,
+          skipLibCheck: true
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    ) + "\n",
+    "src/worker.ts": `import { Router } from 'itty-router'
+${adapterImport2}
+${demoSnippet}interface Env {
+  ${envKey ? `${envKey}: string` : "/* no env vars */"}
+}
+const router = Router()
+router.post('/chat', async (request: Request, env: Env) => {
+  const { messages } = await request.json() as { messages: Array<{ role: string; content: string }> }
+  const adapter = ${adapterCallEdge}
+  const source = adapter.createSource({ messages: messages.map((m, i) => ({
+    id: String(i), role: m.role as 'user' | 'assistant' | 'system',
+    content: m.content, status: 'complete' as const, createdAt: new Date(0),
+  })) })
+  const stream = new ReadableStream<Uint8Array>({
+    async start(controller) {
+      const encoder = new TextEncoder()
+      for await (const chunk of source.stream()) {
+        if (chunk.type === 'text') controller.enqueue(encoder.encode(chunk.content))
+      }
+      controller.close()
+    },
+  })
+  return new Response(stream, { headers: { 'content-type': 'text/plain; charset=utf-8' } })
+})
+router.all('*', () => new Response('not found', { status: 404 }))
+export default {
+  fetch: (req: Request, env: Env, ctx: ExecutionContext) => router.handle(req, env, ctx),
+} satisfies ExportedHandler<Env>
+`,
+    ".env.example": envExampleFor(ctx.provider),
+    ".gitignore": "node_modules\n.wrangler\n.dev.vars\n.env\n.env.local\n",
+    "README.md": readmeFor(ctx)
+  };
+}
+function bunStarter(ctx) {
+  const deps = {};
+  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
+  const adapterCallStr = adapterCall(ctx.provider);
+  const adapterImport2 = buildAdapterServerImport(ctx.provider);
+  const demoSnippet = ctx.provider === "demo" ? demoAdapterSnippet() : "";
+  return {
+    "package.json": JSON.stringify(
+      {
+        name: "agentskit-bun-server",
+        private: true,
+        type: "module",
+        scripts: {
+          dev: "bun --hot src/server.ts",
+          start: "bun src/server.ts"
+        },
+        dependencies: deps,
+        devDependencies: { typescript: "^5.5.0" }
+      },
+      null,
+      2
+    ) + "\n",
+    "tsconfig.json": JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          types: ["bun-types"],
+          strict: true,
+          noEmit: true,
+          skipLibCheck: true
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    ) + "\n",
+    "src/server.ts": `${adapterImport2}${demoSnippet}const adapter = ${adapterCallStr}
+const server = Bun.serve({
+  port: Number(process.env.PORT ?? 3000),
+  async fetch(request) {
+    const url = new URL(request.url)
+    if (request.method === 'POST' && url.pathname === '/chat') {
+      const { messages } = await request.json() as { messages: Array<{ role: string; content: string }> }
+      const source = adapter.createSource({ messages: messages.map((m, i) => ({
+        id: String(i), role: m.role as 'user' | 'assistant' | 'system',
+        content: m.content, status: 'complete' as const, createdAt: new Date(0),
+      })) })
+      const stream = new ReadableStream<Uint8Array>({
+        async start(controller) {
+          const encoder = new TextEncoder()
+          for await (const chunk of source.stream()) {
+            if (chunk.type === 'text') controller.enqueue(encoder.encode(chunk.content))
+          }
+          controller.close()
+        },
+      })
+      return new Response(stream, { headers: { 'content-type': 'text/plain; charset=utf-8' } })
+    }
+    if (url.pathname === '/') {
+      return new Response(\`<!doctype html><title>AgentsKit Bun starter</title>
+<body><pre>POST /chat with { messages: [...] }</pre></body>\`, {
+        headers: { 'content-type': 'text/html' },
+      })
+    }
+    return new Response('not found', { status: 404 })
+  },
+})
+console.log(\`Listening on http://localhost:\${server.port}\`)
+`,
+    ".env.example": envExampleFor(ctx.provider),
+    ".gitignore": "node_modules\n.env\n.env.local\nbun.lockb\n",
+    "README.md": readmeFor(ctx)
+  };
+}
+function nextjsStarter(ctx) {
+  const deps = {
+    "@agentskit/react": "^0.4.0",
+    next: "^15.0.0",
+    react: "^19.0.0",
+    "react-dom": "^19.0.0"
+  };
+  if (ctx.provider !== "demo") deps["@agentskit/adapters"] = "^0.4.0";
+  if (ctx.tools.length > 0) deps["@agentskit/tools"] = "^0.4.0";
+  const envKey = PROVIDER_ENV_KEY[ctx.provider];
+  const adapter = adapterCall(ctx.provider);
+  const apiAdapterImport = ctx.provider === "demo" ? "" : `import { ${PROVIDER_IMPORT[ctx.provider]} } from '@agentskit/adapters'
+`;
+  const apiDemoSnippet = ctx.provider === "demo" ? demoAdapterSnippet() : "";
+  return {
+    "package.json": JSON.stringify(
+      {
+        name: "agentskit-nextjs-app",
+        private: true,
+        type: "module",
+        scripts: {
+          dev: "next dev",
+          build: "next build",
+          start: "next start",
+          lint: "next lint"
+        },
+        dependencies: deps,
+        devDependencies: {
+          "@types/node": "^22.0.0",
+          "@types/react": "^19.0.0",
+          "@types/react-dom": "^19.0.0",
+          typescript: "^5.5.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "next.config.mjs": `/** @type {import('next').NextConfig} */
+const nextConfig = {}
+export default nextConfig
+`,
+    "tsconfig.json": JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          lib: ["dom", "dom.iterable", "ES2022"],
+          allowJs: true,
+          skipLibCheck: true,
+          strict: true,
+          noEmit: true,
+          esModuleInterop: true,
+          module: "ESNext",
+          moduleResolution: "bundler",
+          resolveJsonModule: true,
+          isolatedModules: true,
+          jsx: "preserve",
+          incremental: true,
+          plugins: [{ name: "next" }],
+          paths: { "@/*": ["./*"] }
+        },
+        include: ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+        exclude: ["node_modules"]
+      },
+      null,
+      2
+    ) + "\n",
+    "app/layout.tsx": `import type { ReactNode } from 'react'
+import '@agentskit/react/theme'
+export const metadata = { title: 'AgentsKit \xB7 Next.js Starter' }
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}
+`,
+    "app/page.tsx": `'use client'
+import { ChatContainer, InputBar, Message, useChat } from '@agentskit/react'
+import { genericAdapter } from './chat-adapter'
+export default function Page() {
+  const chat = useChat({ adapter: genericAdapter('/api/chat') })
+  return (
+    <main style={{ display: 'grid', placeItems: 'center', minHeight: '100dvh' }}>
+      <ChatContainer>
+        {chat.messages.map(message => (
+          <Message key={message.id} message={message} />
+        ))}
+        <InputBar chat={chat} />
+      </ChatContainer>
+    </main>
+  )
+}
+`,
+    "app/chat-adapter.ts": `import { generic } from '@agentskit/adapters'
+export const genericAdapter = (route: string) => generic({
+  fetch: async ({ messages, signal }) => {
+    const response = await fetch(route, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ messages }),
+      signal,
+    })
+    if (!response.body) throw new Error('No body returned from /api/chat')
+    return response
+  },
+})
+`,
+    "app/api/chat/route.ts": `${apiAdapterImport}${apiDemoSnippet}export const runtime = 'edge'
+export async function POST(request: Request) {
+  const { messages } = await request.json() as { messages: Array<{ role: string; content: string }> }
+  const adapter = ${adapter}
+  const source = adapter.createSource({ messages: messages.map((message, index) => ({
+    id: String(index),
+    role: message.role as 'user' | 'assistant' | 'system',
+    content: message.content,
+    status: 'complete' as const,
+    createdAt: new Date(0),
+  })) })
+  const stream = new ReadableStream<Uint8Array>({
+    async start(controller) {
+      const encoder = new TextEncoder()
+      try {
+        for await (const chunk of source.stream()) {
+          if (chunk.type === 'text') controller.enqueue(encoder.encode(chunk.content))
+        }
+      } catch (err) {
+        controller.error(err)
+        return
+      }
+      controller.close()
+    },
+  })
+  return new Response(stream, {
+    headers: { 'Content-Type': 'text/plain; charset=utf-8', 'Cache-Control': 'no-cache' },
+  })
+}
+`,
+    ".env.example": envKey ? `${envKey}=
+` : "# No API key required for the demo provider\n",
+    ".gitignore": `node_modules
+.next
+out
+.env
+.env.local
+.agentskit-history.*
+`,
+    "README.md": readmeFor(ctx)
+  };
+}
 function readmeFor(ctx) {
   const installCmd = ctx.pm === "npm" ? "npm install" : `${ctx.pm} install`;
   const runCmd = ctx.pm === "npm" ? "npm run dev" : `${ctx.pm} dev`;
@@ -2115,9 +2745,15 @@ ISC
 }
 var TEMPLATE_FN = {
   react: reactStarter,
+  nextjs: nextjsStarter,
   ink: inkStarter,
   runtime: runtimeStarter,
-  "multi-agent": multiAgentStarter
+  "multi-agent": multiAgentStarter,
+  sveltekit: sveltekitStarter,
+  nuxt: nuxtStarter,
+  "vite-ink": viteInkStarter,
+  "cloudflare-workers": cloudflareWorkersStarter,
+  bun: bunStarter
 };
 async function writeStarterProject(options) {
   const ctx = {
@@ -2158,7 +2794,13 @@ ${kleur__default.default.bold().green("\u25B2")} ${kleur__default.default.bold("
       default: defaults.template ?? "react",
       choices: [
         { name: "React chat (Vite + browser)", value: "react", description: "Streaming UI with @agentskit/react" },
+        { name: "Next.js chat (App Router + Route Handler)", value: "nextjs", description: "app/api/chat streams to a useChat client" },
+        { name: "SvelteKit chat", value: "sveltekit", description: "@agentskit/svelte client + server route streaming" },
+        { name: "Nuxt chat", value: "nuxt", description: "@agentskit/vue composable + Nitro server route streaming" },
         { name: "Ink chat (terminal UI)", value: "ink", description: "Same chat but in your terminal" },
+        { name: "Vite + Ink (terminal, hot-reload)", value: "vite-ink", description: "Ink chat with vite-node hot reload" },
+        { name: "Cloudflare Workers (edge)", value: "cloudflare-workers", description: "Edge runtime with itty-router + streaming" },
+        { name: "Bun server", value: "bun", description: "Bun.serve with hot reload" },
         { name: "Runtime (headless agent, no UI)", value: "runtime", description: "Autonomous task \u2192 result" },
         { name: "Multi-agent (planner + delegates)", value: "multi-agent", description: "Supervisor pattern, ready to extend" }
       ]
@@ -2267,7 +2909,7 @@ function printNextSteps(options) {
 // src/commands/init.ts
 function registerInitCommand(program) {
-  program.command("init").description("Generate a starter project. Run with no flags for interactive mode.").option("--template <template>", "Starter template (react|ink|runtime|multi-agent)").option("--dir <directory>", "Target directory", "agentskit-app").option("--provider <provider>", "LLM provider (openai|anthropic|gemini|ollama|demo)").option("--tools <tools>", "Comma-separated tools (web_search,filesystem,shell)").option("--memory <backend>", "Memory backend (none|file|sqlite)").option("--pm <packageManager>", "Package manager (pnpm|npm|yarn|bun)").option("-y, --yes", "Skip interactive prompts; use flag values + defaults").action(async (rawOptions) => {
+  program.command("init").description("Generate a starter project. Run with no flags for interactive mode.").option("--template <template>", "Starter template (react|nextjs|sveltekit|nuxt|ink|vite-ink|cloudflare-workers|bun|runtime|multi-agent)").option("--dir <directory>", "Target directory", "agentskit-app").option("--provider <provider>", "LLM provider (openai|anthropic|gemini|ollama|demo)").option("--tools <tools>", "Comma-separated tools (web_search,filesystem,shell)").option("--memory <backend>", "Memory backend (none|file|sqlite)").option("--pm <packageManager>", "Package manager (pnpm|npm|yarn|bun)").option("-y, --yes", "Skip interactive prompts; use flag values + defaults").action(async (rawOptions) => {
     const isCi = !process.stdout.isTTY || rawOptions.yes || rawOptions.template;
     let resolved;
     if (isCi) {
@@ -2959,6 +3601,187 @@ function registerRagCommand(program) {
   });
 }
+// src/ai/scaffold.ts
+function snakeToCamel(name) {
+  return name.replace(/[-_](\w)/g, (_, c) => c.toUpperCase());
+}
+function toolStub(tool) {
+  const fnName = snakeToCamel(tool.name);
+  const schema = tool.schema ? JSON.stringify(tool.schema, null, 2) : '{ type: "object", properties: {} }';
+  return `import { defineTool } from '@agentskit/core'
+/**
+ * ${tool.description ?? tool.name}
+ * ${tool.implementation ? `
+ * Implementation hint: ${tool.implementation}` : ""}
+ */
+export const ${fnName} = defineTool({
+  name: '${tool.name}',
+  description: ${JSON.stringify(tool.description ?? "")},
+  schema: ${schema} as const,
+  ${tool.requiresConfirmation ? "requiresConfirmation: true," : ""}
+  async execute(args) {
+    // TODO: implement ${tool.name}
+    return { args }
+  },
+})
+`;
+}
+function indexTs(schema) {
+  const toolImports2 = (schema.tools ?? []).map((t) => `import { ${snakeToCamel(t.name)} } from './tools/${t.name}'`).join("\n");
+  const toolList2 = (schema.tools ?? []).map((t) => snakeToCamel(t.name)).join(", ");
+  return `import { createRuntime } from '@agentskit/runtime'
+${toolImports2}
+export const agent = {
+  name: '${schema.name}',
+  systemPrompt: ${JSON.stringify(schema.systemPrompt ?? "")},
+  tools: [${toolList2}],
+}
+export function createAgent(adapter: Parameters<typeof createRuntime>[0]['adapter']) {
+  return createRuntime({
+    adapter,
+    systemPrompt: agent.systemPrompt,
+    tools: agent.tools,
+  })
+}
+`;
+}
+function readme(schema) {
+  const lines = [];
+  lines.push(`# ${schema.name}`);
+  lines.push("");
+  if (schema.description) lines.push(schema.description, "");
+  lines.push(`## Model`);
+  lines.push("");
+  lines.push(`- Provider: \`${schema.model.provider}\``);
+  if (schema.model.model) lines.push(`- Model: \`${schema.model.model}\``);
+  lines.push("");
+  if (schema.tools && schema.tools.length > 0) {
+    lines.push("## Tools");
+    lines.push("");
+    for (const t of schema.tools) {
+      lines.push(`- \`${t.name}\` \u2014 ${t.description ?? ""}`);
+    }
+    lines.push("");
+  }
+  if (schema.skills && schema.skills.length > 0) {
+    lines.push("## Skills");
+    lines.push("");
+    for (const s of schema.skills) lines.push(`- ${s}`);
+    lines.push("");
+  }
+  lines.push("## Generated by");
+  lines.push("");
+  lines.push('`npx agentskit ai "<description>"`');
+  lines.push("");
+  return lines.join("\n");
+}
+function scaffoldAgent(schema) {
+  const files = [
+    { path: "agent.json", content: JSON.stringify(schema, null, 2) + "\n" },
+    { path: "agent.ts", content: indexTs(schema) },
+    { path: "README.md", content: readme(schema) }
+  ];
+  for (const tool of schema.tools ?? []) {
+    files.push({ path: `tools/${tool.name}.ts`, content: toolStub(tool) });
+  }
+  return files;
+}
+async function writeScaffold(files, outDir, opts = {}) {
+  const { writeFile: writeFile2, mkdir: mkdir2, access } = await import('fs/promises');
+  const { dirname, join: join5 } = await import('path');
+  const written = [];
+  for (const f of files) {
+    const full = join5(outDir, f.path);
+    await mkdir2(dirname(full), { recursive: true });
+    if (!opts.overwrite) {
+      try {
+        await access(full);
+        continue;
+      } catch {
+      }
+    }
+    await writeFile2(full, f.content, "utf8");
+    written.push(f.path);
+  }
+  return written;
+}
+var PLANNER_SYSTEM_PROMPT = `You design AI agents for the AgentsKit framework.
+Given a user's plain-language description, return a single JSON object
+matching the AgentsKit AgentSchema type. Do not include commentary or
+markdown fences \u2014 emit raw JSON only.
+Schema:
+{
+  "name": "kebab-or-snake-case",
+  "description": "short summary",
+  "systemPrompt": "you are...",
+  "model": { "provider": "anthropic"|"openai"|"gemini"|..., "model": "..." },
+  "tools": [{ "name": "search", "description": "...", "schema": {...}, "implementation": "fetch('/api/search?q=...')" }],
+  "memory": { "kind": "inMemory"|"localStorage", "key": "..." },
+  "skills": ["researcher", "critic"]
+}
+Prefer fewer well-scoped tools over many overlapping ones. Name tools
+in snake_case.`;
+function extractJson(text) {
+  const fenced = text.match(/```(?:json)?\s*([\s\S]+?)```/);
+  const raw = fenced?.[1] ?? text;
+  const start = raw.indexOf("{");
+  const end = raw.lastIndexOf("}");
+  if (start < 0 || end <= start) throw new Error("Planner response did not contain a JSON object");
+  return raw.slice(start, end + 1);
+}
+function createAdapterPlanner(adapter) {
+  return async (description) => {
+    const messages = [
+      { id: "sys", role: "system", content: PLANNER_SYSTEM_PROMPT, status: "complete", createdAt: /* @__PURE__ */ new Date(0) },
+      { id: "user", role: "user", content: description, status: "complete", createdAt: /* @__PURE__ */ new Date(0) }
+    ];
+    const request = { messages, context: { temperature: 0 } };
+    const source = adapter.createSource(request);
+    let text = "";
+    for await (const chunk of source.stream()) {
+      if (chunk.type === "text" && chunk.content) text += chunk.content;
+    }
+    const json = extractJson(text);
+    return agentSchema.validateAgentSchema(JSON.parse(json));
+  };
+}
+// src/commands/ai.ts
+function registerAiCommand(program) {
+  program.command("ai <description...>").description("Generate an agent (config + tools + skill wiring) from a natural-language description.").option("-o, --out <dir>", "Output directory", "./my-agent").option("--provider <provider>", "Planner provider (openai | anthropic | ...)", "anthropic").option("--model <model>", "Planner model id").option("--api-key <key>", "API key (falls back to env)").option("--base-url <url>", "Override base URL (for OpenAI-compatible endpoints)").option("--overwrite", "Overwrite existing files", false).option("--dry-run", "Print the plan + files without writing", false).action(async (descriptionWords, options) => {
+    const description = descriptionWords.join(" ").trim();
+    if (!description) {
+      process.stderr.write("agentskit ai: missing description.\n");
+      process.exit(1);
+    }
+    const resolved = resolveChatProvider({
+      provider: options.provider,
+      model: options.model,
+      apiKey: options.apiKey,
+      baseUrl: options.baseUrl
+    });
+    const planner2 = createAdapterPlanner(resolved.adapter);
+    process.stderr.write(`Planning agent for: "${description}"
+`);
+    const schema = await planner2(description);
+    const files = scaffoldAgent(schema);
+    if (options.dryRun) {
+      process.stdout.write(JSON.stringify({ schema, files: files.map((f) => f.path) }, null, 2) + "\n");
+      return;
+    }
+    const written = await writeScaffold(files, options.out, { overwrite: options.overwrite });
+    process.stderr.write(`Wrote ${written.length} file(s) to ${options.out}
+`);
+    for (const f of written) process.stderr.write(`  + ${f}
+`);
+  });
+}
 // src/commands/index.ts
 function createCli() {
   const program = new commander.Command();
@@ -2971,6 +3794,7 @@ function createCli() {
   registerConfigCommand(program);
   registerTunnelCommand(program);
   registerRagCommand(program);
+  registerAiCommand(program);
   return program;
 }