@runtypelabs/cli 2.14.0 → 2.15.1

package/dist/index.js

@@ -26255,7 +26255,8 @@ var BuiltInToolCategory = {
   DATA_MANAGEMENT: "data_management",
   COMMERCE: "commerce",
   BROWSER: "browser",
-  SANDBOX: "sandbox"
+  SANDBOX: "sandbox",
+  MESSAGING: "messaging"
 };
 var BuiltInToolIdPrefix = {
   BUILTIN: "builtin",
@@ -26651,7 +26652,15 @@ var CORE_BUILTIN_TOOLS_REGISTRY = [
     modelCompatibility: [
       {
         provider: BuiltInToolProvider.ANTHROPIC,
-        models: ["claude-opus-4", "claude-sonnet-4", "claude-opus-4-5", "claude-sonnet-4-5", "claude-opus-4-6", "claude-sonnet-4-6", "claude-haiku-4-5"]
+        models: [
+          "claude-opus-4",
+          "claude-sonnet-4",
+          "claude-opus-4-5",
+          "claude-sonnet-4-5",
+          "claude-opus-4-6",
+          "claude-sonnet-4-6",
+          "claude-haiku-4-5"
+        ]
       }
     ],
     documentationUrl: "https://sdk.vercel.ai/providers/ai-sdk-providers/anthropic#web-search",
@@ -26742,7 +26751,10 @@ var CORE_BUILTIN_TOOLS_REGISTRY = [
                 type: "string",
                 enum: ["web", "x", "news", "rss"]
               },
-              country: { type: "string", description: "ISO 3166-1 alpha-2 country code (web/news)." },
+              country: {
+                type: "string",
+                description: "ISO 3166-1 alpha-2 country code (web/news)."
+              },
               allowedWebsites: {
                 type: "array",
                 description: "Up to 5 domains to restrict search to (web only).",
@@ -28231,7 +28243,10 @@ var CORE_BUILTIN_TOOLS_REGISTRY = [
                             city: { type: "string", description: "City" },
                             province_code: { type: "string", description: "State/province code" },
                             postal_code: { type: "string", description: "Postal/ZIP code" },
-                            country_code: { type: "string", description: "ISO 3166-1 alpha-2 country code" }
+                            country_code: {
+                              type: "string",
+                              description: "ISO 3166-1 alpha-2 country code"
+                            }
                           }
                         },
                         phone_number: { type: "string", description: "Recipient phone number" }
@@ -28349,7 +28364,10 @@ var CORE_BUILTIN_TOOLS_REGISTRY = [
                             city: { type: "string", description: "City" },
                             province_code: { type: "string", description: "State/province code" },
                             postal_code: { type: "string", description: "Postal/ZIP code" },
-                            country_code: { type: "string", description: "ISO 3166-1 alpha-2 country code" }
+                            country_code: {
+                              type: "string",
+                              description: "ISO 3166-1 alpha-2 country code"
+                            }
                           }
                         },
                         phone_number: { type: "string", description: "Recipient phone number" }
@@ -28556,7 +28574,10 @@ var CORE_BUILTIN_TOOLS_REGISTRY = [
             intent: { type: "string", description: "Buyer intent description" }
           }
         },
-        bearerToken: { type: "string", description: "Bearer token for authenticated session (optional)" }
+        bearerToken: {
+          type: "string",
+          description: "Bearer token for authenticated session (optional)"
+        }
       },
       required: ["domain", "items"]
     },
@@ -29180,6 +29201,81 @@ var CORE_BUILTIN_TOOLS_REGISTRY = [
     executionHint: "platform",
     requiresApiKey: false,
     platformKeySupport: true
+  },
+  // Send email via Resend. Mirrors the send-email context step so agents can
+  // dispatch transactional email without wrapping it in a flow.
+  {
+    id: "send_email",
+    name: "Send Email",
+    description: 'Send a transactional email via Resend. Leave "from" blank to use the platform-managed sender; set it to send from your own verified domain (requires a custom Resend key configured in Settings > Integrations).',
+    category: BuiltInToolCategory.MESSAGING,
+    providers: [BuiltInToolProvider.MULTI],
+    parametersSchema: {
+      type: "object",
+      properties: {
+        to: {
+          type: "string",
+          description: "Recipient email address. Multiple addresses can be provided comma-separated.",
+          minLength: 1
+        },
+        subject: {
+          type: "string",
+          description: "Email subject line.",
+          minLength: 1
+        },
+        html: {
+          type: "string",
+          description: "HTML body of the email. Provide either html or text (or both); at least one is required."
+        },
+        text: {
+          type: "string",
+          description: "Plain-text body of the email. Provide either html or text (or both); at least one is required."
+        },
+        from: {
+          type: "string",
+          description: "Optional sender address. Leave blank to use the platform-managed sender (e.g. agent_id@<platform-domain>). Custom values require your own Resend API key and a verified domain."
+        },
+        cc: {
+          type: "string",
+          description: "Optional CC recipients, comma-separated."
+        },
+        bcc: {
+          type: "string",
+          description: "Optional BCC recipients, comma-separated."
+        },
+        replyTo: {
+          type: "string",
+          description: "Optional Reply-To address."
+        },
+        attachments: {
+          type: "array",
+          description: "Optional file attachments. Each item must include a filename and base64-encoded content.",
+          items: {
+            type: "object",
+            properties: {
+              filename: {
+                type: "string",
+                description: "Attachment filename, including extension."
+              },
+              content: {
+                type: "string",
+                description: "Base64-encoded file contents."
+              },
+              contentType: {
+                type: "string",
+                description: "Optional MIME type (e.g. application/pdf)."
+              }
+            },
+            required: ["filename", "content"]
+          }
+        }
+      },
+      required: ["to", "subject"]
+    },
+    documentationUrl: "https://resend.com/docs/api-reference/emails/send-email",
+    requiresApiKey: false,
+    executionHint: "platform",
+    platformKeySupport: true
   }
 ];
 var BUILTIN_TOOLS_REGISTRY = [
@@ -34687,7 +34783,8 @@ var CATEGORY_DISPLAY_NAMES = {
   [BuiltInToolCategory.THIRD_PARTY_API]: "Third-Party API",
   [BuiltInToolCategory.ARTIFACT]: "Artifact",
   [BuiltInToolCategory.DATA_MANAGEMENT]: "Data Management",
-  [BuiltInToolCategory.COMMERCE]: "Commerce"
+  [BuiltInToolCategory.COMMERCE]: "Commerce",
+  [BuiltInToolCategory.MESSAGING]: "Messaging"
 };
 var TOOL_CATALOG_FOR_FLOW_GENERATION = (() => {
   const providerNativeSearchIds = /* @__PURE__ */ new Set([
@@ -35408,15 +35505,17 @@ var FlowInputSchema = external_exports.object({
   id: external_exports.string().min(1).optional(),
   name: external_exports.string().min(1).optional(),
   description: external_exports.string().optional(),
-  steps: external_exports.array(external_exports.any()).optional()
+  steps: external_exports.array(external_exports.any()).optional(),
+  contentHash: external_exports.string().length(64).optional()
 }).refine(
   (data) => {
     const hasFlowId = !!data.id;
     const hasSteps = !!(data.name && data.steps && data.steps.length > 0);
-    return hasFlowId || hasSteps;
+    const hasPersistedFlow = !!(data.name && data.contentHash);
+    return hasFlowId || hasSteps || hasPersistedFlow;
   },
   {
-    message: "Either 'id' or flow definition with 'name' and 'steps' must be provided."
+    message: "Either 'id', flow definition with 'name' and 'steps', or persisted flow with 'name' and 'contentHash' must be provided."
   }
 );
 var AgentLoopConfigSchema = external_exports.object({
@@ -53970,6 +54069,612 @@ gcloud run deploy runtype-deploy \\
 \`GET /health\` returns \`{"status":"ok","agents":[...]}\`.
 `;
 }
+function workerIndexTs(agentSlugs) {
+  const imports = agentSlugs.map((slug, i) => `import agent${i}Json from '../agents/${slug}.json'`).join("\n");
+  const agentFiles = agentSlugs.map((slug, i) => `  ['${slug}.json', agent${i}Json],`).join("\n");
+  return `/**
+ * Generated by \`runtype deploy --target cloudflare\`.
+ *
+ * Routes:
+ *   GET  /health           \u2014 liveness probe (lists registered agent names)
+ *   POST /agent/:name      \u2014 SSE stream of the agent event schema
+ *
+ * Agent definitions are statically imported so Wrangler bundles them.
+ * To add a new agent:
+ *   1. Export it with \`runtype deploy --agent <id> --target cloudflare\`
+ *   2. Or drop a JSON file under agents/ and add an import + entry below
+ *   3. Run \`wrangler deploy\`
+ */
+import {
+  CloudflareAdapter,
+  createRuntime,
+  exportedAgentSchema,
+  type ExportedAgent,
+} from '@runtypelabs/runtime'
+
+// ---------------------------------------------------------------------------
+// Agent registry \u2014 static imports bundled by Wrangler at deploy time
+// ---------------------------------------------------------------------------
+
+${imports}
+
+function parseAgent(json: unknown, filename: string): ExportedAgent {
+  try {
+    return exportedAgentSchema.parse(json)
+  } catch (err) {
+    throw new Error(
+      \`[runtype] invalid agent JSON in \${filename}: \${
+        err instanceof Error ? err.message : String(err)
+      }\`
+    )
+  }
+}
+
+const agentFiles: Array<[string, unknown]> = [
+${agentFiles}
+]
+
+const agentRegistry: Record<string, ExportedAgent> = {}
+for (const [filename, json] of agentFiles) {
+  const agent = parseAgent(json, filename)
+  if (agentRegistry[agent.name]) {
+    throw new Error(\`[runtype] duplicate agent name "\${agent.name}" in \${filename}\`)
+  }
+  agentRegistry[agent.name] = agent
+}
+
+// ---------------------------------------------------------------------------
+// Env \u2014 Wrangler injects secrets + bindings here
+// ---------------------------------------------------------------------------
+
+export interface Env {
+  // Secrets \u2014 set via \`wrangler secret put <NAME>\`
+  ANTHROPIC_API_KEY?: string
+  OPENAI_API_KEY?: string
+  GOOGLE_API_KEY?: string
+  MIXLAYER_API_KEY?: string
+  // Optional: narrow CORS from * to specific origins (comma-separated)
+  ALLOWED_ORIGINS?: string
+  // Optional: KV namespace binding for durable cross-request caching
+  CACHE_KV?: KVNamespace
+}
+
+// ---------------------------------------------------------------------------
+// Worker
+// ---------------------------------------------------------------------------
+
+export default {
+  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
+    const url = new URL(request.url)
+    const cors = corsHeaders(request, env.ALLOWED_ORIGINS)
+
+    if (request.method === 'OPTIONS') {
+      return new Response(null, { status: 204, headers: cors })
+    }
+
+    if (request.method === 'GET' && url.pathname === '/health') {
+      return json({ status: 'ok', agents: Object.keys(agentRegistry) }, 200, cors)
+    }
+
+    const agentMatch = url.pathname.match(/^\\/agent\\/([^/]+)$/)
+    if (request.method === 'POST' && agentMatch) {
+      const name = decodeURIComponent(agentMatch[1])
+      if (!agentRegistry[name]) {
+        return json({ error: \`unknown agent: \${name}\` }, 404, cors)
+      }
+
+      const runtime = createRuntime({
+        agents: agentRegistry,
+        keys: { mode: 'own' },
+        adapter: new CloudflareAdapter(env, {
+          kvNamespace: env.CACHE_KV,
+          waitUntil: ctx.waitUntil.bind(ctx),
+        }),
+      })
+
+      let body: { messages?: Array<{ role: string; content: string }> } = {}
+      try {
+        body = (await request.json()) as typeof body
+      } catch {
+        return json({ error: 'request body must be JSON' }, 400, cors)
+      }
+      const messages = Array.isArray(body.messages) ? body.messages : []
+
+      try {
+        const response = await runtime.executeAgent(name, {
+          messages: messages as Array<{
+            role: 'system' | 'user' | 'assistant'
+            content: string
+          }>,
+          signal: request.signal,
+        })
+        const headers = new Headers(response.headers)
+        for (const [k, v] of Object.entries(cors)) headers.set(k, v)
+        return new Response(response.body, { status: response.status, headers })
+      } catch (err) {
+        return json({ error: err instanceof Error ? err.message : 'unknown error' }, 500, cors)
+      }
+    }
+
+    return json({ error: 'not found' }, 404, cors)
+  },
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function json(body: unknown, status: number, extra: Record<string, string>): Response {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { 'Content-Type': 'application/json', ...extra },
+  })
+}
+
+function corsHeaders(request: Request, allowedOriginsEnv?: string): Record<string, string> {
+  const origin = request.headers.get('Origin') ?? ''
+  let allow = '*'
+  if (allowedOriginsEnv) {
+    const list = allowedOriginsEnv.split(',').map((o) => o.trim()).filter(Boolean)
+    allow = list.includes(origin) ? origin : (list[0] ?? '*')
+  }
+  const headers: Record<string, string> = {
+    'Access-Control-Allow-Origin': allow,
+    'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type, Authorization',
+    'Access-Control-Max-Age': '86400',
+  }
+  if (allow !== '*') headers['Vary'] = 'Origin'
+  return headers
+}
+`;
+}
+function wranglerToml(projectName) {
+  return `name = "${projectName}"
+main = "src/index.ts"
+compatibility_date = "2025-01-01"
+
+# Secrets \u2014 set via \`wrangler secret put <NAME>\`
+# Run this for each API key your agents need:
+#   wrangler secret put ANTHROPIC_API_KEY
+#   wrangler secret put OPENAI_API_KEY
+#   wrangler secret put GOOGLE_API_KEY
+#   wrangler secret put MIXLAYER_API_KEY
+
+# Optional: KV namespace for durable cross-request caching.
+# Without this the adapter uses a per-isolate in-memory Map (ephemeral).
+# To enable:
+#   1. wrangler kv namespace create CACHE_KV
+#   2. Uncomment the block below and paste the generated id.
+# [[kv_namespaces]]
+# binding = "CACHE_KV"
+# id = "<paste your KV namespace id here>"
+
+# Optional: Workers AI binding (for @cf/* and workers-ai/* model ids).
+# [ai]
+# binding = "AI"
+
+# CORS: narrow from * to specific origins via ALLOWED_ORIGINS env var.
+# [vars]
+# ALLOWED_ORIGINS = "https://yourapp.com,https://persona-chat.dev"
+`;
+}
+function workerPackageJson(name, runtimeDep) {
+  return JSON.stringify(
+    {
+      name,
+      version: "0.0.0",
+      private: true,
+      scripts: {
+        dev: "wrangler dev",
+        deploy: "wrangler deploy",
+        typecheck: "tsc --noEmit"
+      },
+      dependencies: {
+        "@runtypelabs/runtime": runtimeDep
+      },
+      devDependencies: {
+        "@cloudflare/workers-types": "^4.0.0",
+        typescript: "^5.3.3",
+        wrangler: "^4.0.0"
+      }
+    },
+    null,
+    2
+  );
+}
+function workerTsconfigJson() {
+  return JSON.stringify(
+    {
+      compilerOptions: {
+        target: "ES2022",
+        module: "ES2022",
+        moduleResolution: "bundler",
+        strict: true,
+        resolveJsonModule: true,
+        types: ["@cloudflare/workers-types"]
+      },
+      include: ["src"]
+    },
+    null,
+    2
+  );
+}
+function workerSetupSh(monorepoRoot) {
+  return `#!/usr/bin/env bash
+# Generated by \`runtype deploy --target cloudflare\`.
+#
+# Builds and packs @runtypelabs/runtime from your local monorepo, then
+# installs all dependencies so you can run \`wrangler dev\` or deploy with
+# \`wrangler deploy\`.
+#
+# Usage (from this directory):
+#   ./setup.sh
+
+set -euo pipefail
+
+DEPLOY_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+MONOREPO_ROOT=${bashSingleQuote(monorepoRoot)}
+TARBALL_DIR="\${DEPLOY_DIR}/packages"
+
+echo "[setup] building @runtypelabs/runtime..."
+pnpm --dir "\${MONOREPO_ROOT}" --filter @runtypelabs/runtime build
+
+mkdir -p "\${TARBALL_DIR}"
+
+echo "[setup] packing @runtypelabs/runtime tarball..."
+pnpm --dir "\${MONOREPO_ROOT}/packages/runtime" pack \\
+  --pack-destination "\${TARBALL_DIR}"
+
+RUNTIME_TGZ="$(ls "\${TARBALL_DIR}"/runtypelabs-runtime-*.tgz | head -n 1)"
+if [ -z "\${RUNTIME_TGZ}" ]; then
+  echo "[setup] error: no tarball produced by pnpm pack" >&2
+  exit 1
+fi
+RUNTIME_TGZ_NAME="$(basename "\${RUNTIME_TGZ}")"
+
+echo "[setup] updating package.json with file: dependency..."
+node -e "
+const fs = require('fs');
+const pkg = JSON.parse(fs.readFileSync('\${DEPLOY_DIR}/package.json', 'utf8'));
+pkg.dependencies['@runtypelabs/runtime'] = 'file:./packages/\${RUNTIME_TGZ_NAME}';
+fs.writeFileSync('\${DEPLOY_DIR}/package.json', JSON.stringify(pkg, null, 2) + '\\\\n');
+"
+
+echo "[setup] installing dependencies..."
+npm install --no-audit --no-fund
+
+echo ""
+echo "[setup] Done! Next steps:"
+echo "  wrangler dev             \u2014 preview locally"
+echo "  wrangler deploy          \u2014 deploy to Cloudflare Workers"
+`;
+}
+function workerReadme(agentNames, secretNames) {
+  const agentList = agentNames.map((n) => `  - ${n}`).join("\n");
+  const secretList = secretNames.length > 0 ? secretNames.map((s) => `  wrangler secret put ${s}`).join("\n") : "  (none detected)";
+  return `# Runtype Cloudflare Workers Deployment
+
+Generated by \`runtype deploy --target cloudflare\`. Contains the following agents:
+
+${agentList}
+
+## Setup
+
+\`\`\`bash
+chmod +x setup.sh && ./setup.sh   # build runtime + install deps
+\`\`\`
+
+## Secrets
+
+Set each API key your agents use:
+
+\`\`\`bash
+${secretList}
+\`\`\`
+
+## Run locally
+
+\`\`\`bash
+wrangler dev
+\`\`\`
+
+## Deploy
+
+\`\`\`bash
+wrangler deploy
+\`\`\`
+
+## Health check
+
+\`GET /health\` returns \`{"status":"ok","agents":[...]}\`.
+
+## Call an agent
+
+\`\`\`bash
+curl https://<worker-subdomain>.workers.dev/agent/<name> \\
+  -H 'Content-Type: application/json' \\
+  -d '{"messages":[{"role":"user","content":"Hello"}]}'
+\`\`\`
+`;
+}
+function vercelRouteTs(agentSlugs) {
+  const imports = agentSlugs.map((slug, i) => `import agent${i}Json from '../agents/${slug}.json'`).join("\n");
+  const agentFiles = agentSlugs.map((slug, i) => `  ['${slug}.json', agent${i}Json],`).join("\n");
+  return `/**
+ * Generated by \`runtype deploy --target vercel\`.
+ *
+ * Catch-all Vercel Function. All traffic is rewritten here by vercel.json.
+ * Routes:
+ *   GET  /health           \u2014 liveness probe (lists registered agent names)
+ *   POST /agent/:name      \u2014 SSE stream of the agent event schema
+ *
+ * Agent definitions are statically imported and bundled by Vercel.
+ * To add a new agent:
+ *   1. Export it with \`runtype deploy --agent <id> --target vercel\`
+ *   2. Or drop a JSON file under agents/ and add an import + entry below
+ *   3. Run \`vercel deploy\`
+ */
+import { Hono } from 'hono'
+import { handle } from 'hono/vercel'
+import { cors } from 'hono/cors'
+import {
+  VercelAdapter,
+  createRuntime,
+  exportedAgentSchema,
+  type ExportedAgent,
+} from '@runtypelabs/runtime'
+
+// ---------------------------------------------------------------------------
+// Agent registry \u2014 built at module load, cached across warm invocations
+// ---------------------------------------------------------------------------
+
+${imports}
+
+function parseAgent(json: unknown, filename: string): ExportedAgent {
+  try {
+    return exportedAgentSchema.parse(json)
+  } catch (err) {
+    throw new Error(
+      \`[runtype] invalid agent JSON in \${filename}: \${
+        err instanceof Error ? err.message : String(err)
+      }\`
+    )
+  }
+}
+
+const agentFiles: Array<[string, unknown]> = [
+${agentFiles}
+]
+
+const agentRegistry: Record<string, ExportedAgent> = {}
+for (const [filename, json] of agentFiles) {
+  const agent = parseAgent(json, filename)
+  if (agentRegistry[agent.name]) {
+    throw new Error(\`[runtype] duplicate agent name "\${agent.name}" in \${filename}\`)
+  }
+  agentRegistry[agent.name] = agent
+}
+
+// ---------------------------------------------------------------------------
+// Runtime \u2014 constructed at module scope (warm across invocations)
+// ---------------------------------------------------------------------------
+
+const runtime = createRuntime({
+  agents: agentRegistry,
+  keys: { mode: 'own' },
+  adapter: new VercelAdapter(),
+})
+
+// ---------------------------------------------------------------------------
+// Hono app
+// ---------------------------------------------------------------------------
+
+const app = new Hono()
+
+const allowedOriginsEnv = process.env.ALLOWED_ORIGINS?.trim()
+const allowedOrigins = allowedOriginsEnv
+  ? allowedOriginsEnv.split(',').map((o) => o.trim()).filter(Boolean)
+  : '*'
+
+app.use(
+  '*',
+  cors({
+    origin: allowedOrigins,
+    allowMethods: ['GET', 'POST', 'OPTIONS'],
+    allowHeaders: ['Content-Type', 'Authorization'],
+    maxAge: 86400,
+  })
+)
+
+app.get('/health', (c) => c.json({ status: 'ok', agents: Object.keys(agentRegistry) }))
+
+app.post('/agent/:name', async (c) => {
+  const name = c.req.param('name')
+  if (!runtime.getAgent(name)) {
+    return c.json({ error: \`unknown agent: \${name}\` }, 404)
+  }
+
+  let body: { messages?: Array<{ role: string; content: string }> } = {}
+  try {
+    body = (await c.req.json()) as typeof body
+  } catch {
+    return c.json({ error: 'request body must be JSON' }, 400)
+  }
+  const messages = Array.isArray(body.messages) ? body.messages : []
+
+  try {
+    const response = await runtime.executeAgent(name, {
+      messages: messages as Array<{
+        role: 'system' | 'user' | 'assistant'
+        content: string
+      }>,
+      signal: c.req.raw.signal,
+    })
+    return response
+  } catch (err) {
+    return c.json({ error: err instanceof Error ? err.message : 'unknown error' }, 500)
+  }
+})
+
+export const GET = handle(app)
+export const POST = handle(app)
+`;
+}
+function vercelJson() {
+  return JSON.stringify(
+    {
+      rewrites: [{ source: "/(.*)", destination: "/api/[[...route]]" }],
+      functions: {
+        "api/[[...route]].ts": { maxDuration: 60 }
+      }
+    },
+    null,
+    2
+  );
+}
+function vercelPackageJson(name, runtimeDep) {
+  return JSON.stringify(
+    {
+      name,
+      version: "0.0.0",
+      private: true,
+      scripts: {
+        dev: "vercel dev",
+        deploy: "vercel deploy",
+        typecheck: "tsc --noEmit"
+      },
+      dependencies: {
+        "@runtypelabs/runtime": runtimeDep,
+        hono: "^4.12.16"
+      },
+      devDependencies: {
+        "@types/node": "^22.0.0",
+        "@vercel/node": "^5.0.0",
+        typescript: "^5.3.3",
+        vercel: "^44.0.0"
+      }
+    },
+    null,
+    2
+  );
+}
+function vercelTsconfigJson() {
+  return JSON.stringify(
+    {
+      compilerOptions: {
+        target: "ES2022",
+        module: "ESNext",
+        moduleResolution: "bundler",
+        strict: true,
+        resolveJsonModule: true,
+        esModuleInterop: true,
+        skipLibCheck: true
+      },
+      include: ["api"]
+    },
+    null,
+    2
+  );
+}
+function vercelSetupSh(monorepoRoot) {
+  return `#!/usr/bin/env bash
+# Generated by \`runtype deploy --target vercel\`.
+#
+# Builds and packs @runtypelabs/runtime from your local monorepo, then
+# installs all dependencies so you can run \`vercel dev\` or deploy with
+# \`vercel deploy\`.
+#
+# Usage (from this directory):
+#   ./setup.sh
+
+set -euo pipefail
+
+DEPLOY_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+MONOREPO_ROOT=${bashSingleQuote(monorepoRoot)}
+TARBALL_DIR="\${DEPLOY_DIR}/packages"
+
+echo "[setup] building @runtypelabs/runtime..."
+pnpm --dir "\${MONOREPO_ROOT}" --filter @runtypelabs/runtime build
+
+mkdir -p "\${TARBALL_DIR}"
+
+echo "[setup] packing @runtypelabs/runtime tarball..."
+pnpm --dir "\${MONOREPO_ROOT}/packages/runtime" pack \\
+  --pack-destination "\${TARBALL_DIR}"
+
+RUNTIME_TGZ="$(ls "\${TARBALL_DIR}"/runtypelabs-runtime-*.tgz | head -n 1)"
+if [ -z "\${RUNTIME_TGZ}" ]; then
+  echo "[setup] error: no tarball produced by pnpm pack" >&2
+  exit 1
+fi
+RUNTIME_TGZ_NAME="$(basename "\${RUNTIME_TGZ}")"
+
+echo "[setup] updating package.json with file: dependency..."
+node -e "
+const fs = require('fs');
+const pkg = JSON.parse(fs.readFileSync('\${DEPLOY_DIR}/package.json', 'utf8'));
+pkg.dependencies['@runtypelabs/runtime'] = 'file:./packages/\${RUNTIME_TGZ_NAME}';
+fs.writeFileSync('\${DEPLOY_DIR}/package.json', JSON.stringify(pkg, null, 2) + '\\\\n');
+"
+
+echo "[setup] installing dependencies..."
+npm install --no-audit --no-fund
+
+echo ""
+echo "[setup] Done! Next steps:"
+echo "  vercel dev              \u2014 preview locally"
+echo "  vercel deploy           \u2014 deploy to Vercel Functions"
+`;
+}
+function vercelReadme(agentNames, secretNames) {
+  const agentList = agentNames.map((n) => `  - ${n}`).join("\n");
+  const secretList = secretNames.length > 0 ? secretNames.map((s) => `  vercel env add ${s}`).join("\n") : "  (none detected)";
+  return `# Runtype Vercel Functions Deployment
+
+Generated by \`runtype deploy --target vercel\`. Contains the following agents:
+
+${agentList}
+
+## Setup
+
+\`\`\`bash
+chmod +x setup.sh && ./setup.sh   # build runtime + install deps
+\`\`\`
+
+## Secrets
+
+Set each API key your agents use via the Vercel dashboard or CLI:
+
+\`\`\`bash
+${secretList}
+\`\`\`
+
+## Run locally
+
+\`\`\`bash
+vercel dev
+\`\`\`
+
+## Deploy
+
+\`\`\`bash
+vercel deploy
+\`\`\`
+
+## Health check
+
+\`GET /health\` returns \`{"status":"ok","agents":[...]}\`.
+
+## Call an agent
+
+\`\`\`bash
+curl https://<your-project>.vercel.app/agent/<name> \\
+  -H 'Content-Type: application/json' \\
+  -d '{"messages":[{"role":"user","content":"Hello"}]}'
+\`\`\`
+`;
+}
 function collectSecretNames(agentDef) {
   const names = /* @__PURE__ */ new Set();
   const model = agentDef.config?.model?.toLowerCase();
@@ -53992,13 +54697,13 @@ function collectSecretNames(agentDef) {
 function slugify2(s) {
   return s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 63);
 }
-var deployCommand = new Command24("deploy").description("Export an agent or flow and scaffold a Cloud Run deployment").option("--agent <id>", "Agent ID to export (may be repeated)", (v, acc) => {
+var deployCommand = new Command24("deploy").description("Export an agent or flow and scaffold a deployment (cloud-run, cloudflare, or vercel)").option("--agent <id>", "Agent ID to export (may be repeated)", (v, acc) => {
   acc.push(v);
   return acc;
 }, []).option("--flow <id>", "Flow ID to export (may be repeated)", (v, acc) => {
   acc.push(v);
   return acc;
-}, []).option("--output <dir>", "Output directory for the scaffold (default: ./runtype-deploy)", "./runtype-deploy").option("--name <name>", "Project name used in package.json (default: derived from output dir)").action(
+}, []).option("--output <dir>", "Output directory for the scaffold (default: ./runtype-deploy)", "./runtype-deploy").option("--name <name>", "Project name used in package.json (default: derived from output dir)").option("--target <target>", "Deployment target: cloud-run, cloudflare, or vercel (default: cloud-run)", "cloud-run").action(
   async (options) => {
     const agentIds = options.agent;
     const flowIds = options.flow;
@@ -54006,13 +54711,18 @@ var deployCommand = new Command24("deploy").description("Export an agent or flow
       console.error(chalk30.red("Error: provide at least one --agent <id> or --flow <id>"));
       process.exit(1);
     }
+    const target = options.target;
+    if (target !== "cloud-run" && target !== "cloudflare" && target !== "vercel") {
+      console.error(chalk30.red(`Error: unknown --target "${target}". Must be one of: cloud-run, cloudflare, vercel`));
+      process.exit(1);
+    }
     const apiKey = await ensureAuth();
     if (!apiKey) return;
     const client = new ApiClient(apiKey);
     const outDir = path14.resolve(options.output);
     const projectName = options.name ?? slugify2(path14.basename(outDir));
     console.log(chalk30.cyan(`
-Scaffolding deployment to ${outDir}
+Scaffolding ${target} deployment to ${outDir}
 `));
     const agentDefs = [];
     for (const id of agentIds) {
@@ -54063,36 +54773,26 @@ Scaffolding deployment to ${outDir}
         process.exit(1);
       }
     }
+    const agentSlugs = agentDefs.map(({ name }) => slugify2(name));
+    const slugSet = /* @__PURE__ */ new Set();
+    for (let i = 0; i < agentSlugs.length; i++) {
+      const slug = agentSlugs[i];
+      if (slugSet.has(slug)) {
+        const colliders = agentDefs.filter(({ name }) => slugify2(name) === slug).map(({ name }) => `"${name}"`).join(" and ");
+        console.error(chalk30.red(`Error: agents ${colliders} produce the same slug "${slug}".`));
+        console.error(chalk30.yellow("  Rename one of them in the Runtype dashboard to make slugs unique."));
+        process.exit(1);
+      }
+      slugSet.add(slug);
+    }
     fs14.mkdirSync(path14.join(outDir, "agents"), { recursive: true });
     fs14.mkdirSync(path14.join(outDir, "packages"), { recursive: true });
     for (const { name, def } of agentDefs) {
       const filename = `${slugify2(name)}.json`;
-      fs14.writeFileSync(
-        path14.join(outDir, "agents", filename),
-        JSON.stringify(def, null, 2)
-      );
+      fs14.writeFileSync(path14.join(outDir, "agents", filename), JSON.stringify(def, null, 2));
       console.log(`  Wrote agents/${filename}`);
     }
-    fs14.writeFileSync(
-      path14.join(outDir, "server.ts"),
-      serverTs()
-    );
-    fs14.writeFileSync(
-      path14.join(outDir, "Dockerfile"),
-      dockerfile()
-    );
-    fs14.writeFileSync(
-      path14.join(outDir, ".dockerignore"),
-      dockerignore()
-    );
-    fs14.writeFileSync(
-      path14.join(outDir, "tsconfig.json"),
-      tsconfigJson()
-    );
-    fs14.writeFileSync(
-      path14.join(outDir, "package.json"),
-      packageJson(projectName, "workspace:*")
-    );
+    const agentNames = agentDefs.map((a) => a.name);
     let monorepoRoot = process.cwd();
     for (let i = 0; i < 8; i++) {
       if (fs14.existsSync(path14.join(monorepoRoot, "pnpm-workspace.yaml"))) break;
@@ -54100,46 +54800,90 @@ Scaffolding deployment to ${outDir}
       if (parent === monorepoRoot) break;
       monorepoRoot = parent;
     }
-    const setupScript = setupSh(monorepoRoot);
-    const setupPath = path14.join(outDir, "setup.sh");
-    fs14.writeFileSync(setupPath, setupScript);
-    fs14.chmodSync(setupPath, 493);
     const allSecrets = /* @__PURE__ */ new Set();
     for (const { def } of agentDefs) {
       for (const s of collectSecretNames(def)) allSecrets.add(s);
     }
     const secretNames = Array.from(allSecrets);
-    fs14.writeFileSync(
-      path14.join(outDir, "README.md"),
-      readme(
-        agentDefs.map((a) => a.name),
-        secretNames
-      )
-    );
+    if (target === "cloudflare") {
+      fs14.mkdirSync(path14.join(outDir, "src"), { recursive: true });
+      fs14.writeFileSync(path14.join(outDir, "src", "index.ts"), workerIndexTs(agentSlugs));
+      fs14.writeFileSync(path14.join(outDir, "wrangler.toml"), wranglerToml(projectName));
+      fs14.writeFileSync(path14.join(outDir, "package.json"), workerPackageJson(projectName, "workspace:*"));
+      fs14.writeFileSync(path14.join(outDir, "tsconfig.json"), workerTsconfigJson());
+      const setupPath = path14.join(outDir, "setup.sh");
+      fs14.writeFileSync(setupPath, workerSetupSh(monorepoRoot));
+      fs14.chmodSync(setupPath, 493);
+      fs14.writeFileSync(path14.join(outDir, "README.md"), workerReadme(agentNames, secretNames));
+    } else if (target === "vercel") {
+      fs14.mkdirSync(path14.join(outDir, "api"), { recursive: true });
+      fs14.writeFileSync(path14.join(outDir, "api", "[[...route]].ts"), vercelRouteTs(agentSlugs));
+      fs14.writeFileSync(path14.join(outDir, "vercel.json"), vercelJson());
+      fs14.writeFileSync(path14.join(outDir, "package.json"), vercelPackageJson(projectName, "workspace:*"));
+      fs14.writeFileSync(path14.join(outDir, "tsconfig.json"), vercelTsconfigJson());
+      const setupPath = path14.join(outDir, "setup.sh");
+      fs14.writeFileSync(setupPath, vercelSetupSh(monorepoRoot));
+      fs14.chmodSync(setupPath, 493);
+      fs14.writeFileSync(path14.join(outDir, "README.md"), vercelReadme(agentNames, secretNames));
+    } else {
+      fs14.writeFileSync(path14.join(outDir, "server.ts"), serverTs());
+      fs14.writeFileSync(path14.join(outDir, "Dockerfile"), dockerfile());
+      fs14.writeFileSync(path14.join(outDir, ".dockerignore"), dockerignore());
+      fs14.writeFileSync(path14.join(outDir, "tsconfig.json"), tsconfigJson());
+      fs14.writeFileSync(path14.join(outDir, "package.json"), packageJson(projectName, "workspace:*"));
+      const setupPath = path14.join(outDir, "setup.sh");
+      fs14.writeFileSync(setupPath, setupSh(monorepoRoot));
+      fs14.chmodSync(setupPath, 493);
+      fs14.writeFileSync(path14.join(outDir, "README.md"), readme(agentNames, secretNames));
+    }
     console.log("");
     console.log(chalk30.green(`\u2713 Scaffold written to ${outDir}`));
     console.log("");
     console.log(chalk30.bold("Next steps:"));
     console.log(`  cd ${options.output}`);
     console.log("  chmod +x setup.sh && ./setup.sh   # pack runtime + install deps");
-    console.log("  npm run dev                        # test locally");
-    console.log("");
-    if (secretNames.length > 0) {
-      console.log(chalk30.yellow("Required secrets (set before deploying):"));
-      for (const s of secretNames) {
-        console.log(`  ${chalk30.cyan(s)}`);
+    if (target === "cloudflare") {
+      console.log("  wrangler dev                       # test locally");
+      console.log("");
+      if (secretNames.length > 0) {
+        console.log(chalk30.yellow("Required secrets (set via wrangler):"));
+        for (const s of secretNames) {
+          console.log(`  wrangler secret put ${chalk30.cyan(s)}`);
+        }
+        console.log("");
       }
+      console.log("Deploy to Cloudflare Workers:");
+      console.log("  wrangler deploy");
+    } else if (target === "vercel") {
+      console.log("  vercel dev                         # test locally");
       console.log("");
-      console.log("  Set via Cloud Run:  gcloud run deploy \u2026 --set-secrets KEY=NAME:latest");
-      console.log("  Or export locally:  export KEY=<value>");
+      if (secretNames.length > 0) {
+        console.log(chalk30.yellow("Required secrets (set via Vercel):"));
+        for (const s of secretNames) {
+          console.log(`  vercel env add ${chalk30.cyan(s)}`);
+        }
+        console.log("");
+      }
+      console.log("Deploy to Vercel Functions:");
+      console.log("  vercel deploy");
+    } else {
+      console.log("  npm run dev                        # test locally");
       console.log("");
+      if (secretNames.length > 0) {
+        console.log(chalk30.yellow("Required secrets (set before deploying):"));
+        for (const s of secretNames) {
+          console.log(`  ${chalk30.cyan(s)}`);
+        }
+        console.log("");
+        console.log("  Set via Cloud Run:  gcloud run deploy \u2026 --set-secrets KEY=NAME:latest");
+        console.log("  Or export locally:  export KEY=<value>");
+        console.log("");
+      }
+      console.log("Deploy to Cloud Run:");
+      console.log(`  gcloud run deploy ${projectName} --source ${options.output} \\`);
+      console.log("    --region us-central1 --platform managed \\");
+      console.log("    --allow-unauthenticated --port 8080");
     }
-    console.log("Deploy to Cloud Run:");
-    console.log(
-      `  gcloud run deploy ${projectName} --source ${options.output} \\`
-    );
-    console.log("    --region us-central1 --platform managed \\");
-    console.log("    --allow-unauthenticated --port 8080");
   }
 );
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/cli",
-  "version": "2.14.0",
+  "version": "2.15.1",
   "description": "Command-line interface for Runtype AI platform",
   "type": "module",
   "main": "dist/index.js",
@@ -21,7 +21,7 @@
     "micromatch": "^4.0.8",
     "yaml": "^2.8.3",
     "@runtypelabs/ink-components": "0.3.1",
-    "@runtypelabs/sdk": "1.23.0",
+    "@runtypelabs/sdk": "1.24.1",
     "@runtypelabs/terminal-animations": "0.2.0"
   },
   "devDependencies": {