@poncho-ai/cli 0.39.0 → 0.40.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/cli@0.39.0 build /home/runner/work/poncho-ai/poncho-ai/packages/cli
+> @poncho-ai/cli@0.40.0 build /home/runner/work/poncho-ai/poncho-ai/packages/cli
 > tsup src/index.ts src/cli.ts --format esm --dts
 
 CLI Building entry: src/cli.ts, src/index.ts
@@ -8,11 +8,11 @@
 CLI Target: es2022
 ESM Build start
 ESM dist/cli.js                          94.00 B
-ESM dist/run-interactive-ink-W5YJS7UH.js 23.38 KB
 ESM dist/index.js                        3.10 KB
-ESM dist/chunk-XCDN62XL.js               673.51 KB
-ESM ⚡️ Build success in 88ms
+ESM dist/run-interactive-ink-LJTKUUV4.js 23.38 KB
+ESM dist/chunk-KVGMTYDD.js               674.92 KB
+ESM ⚡️ Build success in 84ms
 DTS Build start
-DTS ⚡️ Build success in 4452ms
+DTS ⚡️ Build success in 4409ms
 DTS dist/cli.d.ts   20.00 B
-DTS dist/index.d.ts 13.24 KB
+DTS dist/index.d.ts 13.25 KB

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @poncho-ai/cli
 
+## 0.40.0
+
+### Minor Changes
+
+- [`496b684`](https://github.com/cesr/poncho-ai/commit/496b6848288cab564e0ff617495f5c34f5c07702) Thanks [@cesr](https://github.com/cesr)! - cli: add `poncho build railway` deploy target
+
+  Scaffolds `Dockerfile`, `server.js`, and `railway.toml` for deploying a
+  poncho agent to Railway. The `railway.toml` pins the builder to
+  `dockerfile`, so Railway doesn't fall back to Nixpacks (which misreads
+  `pnpm-workspace.yaml` and missing lockfiles, then fails the build before
+  producing useful logs — a common gotcha when migrating from Vercel).
+  Also accepts `railway` as a `DeployTarget` in the onboarding flow and
+  documents the new target in the README and AGENT.md template.
+
+### Patch Changes
+
+- [`496b684`](https://github.com/cesr/poncho-ai/commit/496b6848288cab564e0ff617495f5c34f5c07702) Thanks [@cesr](https://github.com/cesr)! - cli: fix `poncho build` Dockerfile scaffolds for docker/railway/fly
+
+  Three issues with the scaffolded Dockerfiles:
+  1. **Base image was `node:20-slim`**, but `isolated-vm@6.1.2` (used by
+     the bash sandbox / `run_code`) only ships prebuilt binaries for Node
+     22+ ABIs. On Node 20, npm fell back to compiling from source, which
+     fails because the C++ code references `v8::SourceLocation` — a V8 12
+     API not present in Node 20's V8 11. Bumped to `node:22-slim`.
+  2. **Server entrypoint couldn't find `@poncho-ai/cli`.** The Dockerfile
+     ran `npm install -g @poncho-ai/cli` but `server.js` does
+     `import { startDevServer } from "@poncho-ai/cli"`. Globally installed
+     packages aren't on Node's ESM resolution path without `NODE_PATH`,
+     so the import failed at runtime. Replaced with `npm install --omit=dev`
+     so the CLI (and any other deps in the user's `package.json`) is
+     installed locally in `/app/node_modules`.
+  3. **Browser tools didn't work.** When `browser: true` is set in
+     `poncho.config.js`, Playwright needs system Chromium libs that
+     `node:22-slim` doesn't include. The scaffold now detects browser
+     config and conditionally adds an `apt-get install` layer with the
+     required libs (`libnss3`, `libxkbcommon0`, etc.) — only when needed,
+     so users without browser keep a lean image.
+
+  Also reordered `COPY package.json` + `RUN npm install` to run before
+  copying app code, so `npm install` is cached across edits to `AGENT.md`,
+  skills, and tests.
+
 ## 0.39.0
 
 ### Minor Changes

package/dist/{chunk-XCDN62XL.js → chunk-KVGMTYDD.js}

@@ -12372,7 +12372,7 @@ cron:
 
 - \`poncho dev\`: jobs run via an in-process scheduler.
 - \`poncho build vercel\`: generates \`vercel.json\` cron entries. Set \`CRON_SECRET\` to the same value as \`PONCHO_AUTH_TOKEN\` so Vercel can authenticate.
-- Docker/Fly.io: scheduler runs automatically.
+- Docker/Fly.io/Railway: scheduler runs automatically.
 - Lambda: use AWS EventBridge to trigger \`GET /api/cron/<jobName>\` with \`Authorization: Bearer <token>\`.
 - Trigger manually: \`curl http://localhost:3000/api/cron/daily-report\`
 
@@ -12496,6 +12496,10 @@ poncho build lambda
 # Fly.io
 poncho build fly
 fly deploy
+
+# Railway
+poncho build railway
+railway up
 \`\`\`
 
 Set environment variables on your deployment platform:
@@ -12577,7 +12581,7 @@ var ensureFile = async (path, content) => {
 };
 var normalizeDeployTarget = (target) => {
   const normalized = target.toLowerCase();
-  if (normalized === "vercel" || normalized === "docker" || normalized === "lambda" || normalized === "fly") {
+  if (normalized === "vercel" || normalized === "docker" || normalized === "lambda" || normalized === "fly" || normalized === "railway") {
     return normalized;
   }
   throw new Error(`Unsupported build target: ${target}`);
@@ -12738,14 +12742,21 @@ var scaffoldDeployTarget = async (projectDir, target, options) => {
 const port = Number.parseInt(process.env.PORT ?? "3000", 10);
 await startDevServer(Number.isNaN(port) ? 3000 : port, { workingDir: process.cwd() });
 `;
+  let browserEnabled = false;
+  try {
+    const cfg = await loadPonchoConfig(projectDir);
+    browserEnabled = !!cfg?.browser;
+  } catch {
+  }
+  const chromiumLibsLayer = browserEnabled ? `RUN apt-get update && apt-get install -y --no-install-recommends \\
+    ca-certificates fonts-liberation libnss3 libatk1.0-0 libatk-bridge2.0-0 \\
+    libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 \\
+    libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libasound2 \\
+  && rm -rf /var/lib/apt/lists/*
+
+` : "";
   if (target === "vercel") {
     const traceHints = [];
-    let browserEnabled = false;
-    try {
-      const cfg = await loadPonchoConfig(projectDir);
-      browserEnabled = !!cfg?.browser;
-    } catch {
-    }
     if (browserEnabled) {
       traceHints.push(`import("@poncho-ai/browser").catch(() => {});`);
       const projectPkgPath = resolve4(projectDir, "package.json");
@@ -12850,16 +12861,19 @@ export default async function handler(req, res) {
     const dockerfilePath = resolve4(projectDir, "Dockerfile");
     await writeScaffoldFile(
       dockerfilePath,
-      `FROM node:20-slim
+      `FROM node:22-slim
 WORKDIR /app
-COPY package.json package.json
+
+${chromiumLibsLayer}COPY package.json package.json
+RUN npm install --omit=dev
+
 COPY AGENT.md AGENT.md
 COPY poncho.config.js poncho.config.js
 COPY skills skills
 COPY tests tests
 COPY .env.example .env.example
-RUN corepack enable && npm install -g @poncho-ai/cli@^${cliVersion}
 COPY server.js server.js
+
 EXPOSE 3000
 CMD ["node","server.js"]
 `,
@@ -12893,6 +12907,45 @@ export const handler = async (event = {}) => {
 //
 // Reminders: Create a CloudWatch Events rule that triggers GET /api/reminders/check
 // every 10 minutes (or your preferred interval) with Authorization: Bearer <PONCHO_AUTH_TOKEN>.
+`,
+      { force: options?.force, writtenPaths, baseDir: projectDir }
+    );
+  } else if (target === "railway") {
+    await writeScaffoldFile(
+      resolve4(projectDir, "Dockerfile"),
+      `FROM node:22-slim
+WORKDIR /app
+
+${chromiumLibsLayer}COPY package.json package.json
+RUN npm install --omit=dev
+
+COPY AGENT.md AGENT.md
+COPY poncho.config.js poncho.config.js
+COPY skills skills
+COPY tests tests
+COPY .env.example .env.example
+COPY server.js server.js
+
+EXPOSE 3000
+CMD ["node","server.js"]
+`,
+      { force: options?.force, writtenPaths, baseDir: projectDir }
+    );
+    await writeScaffoldFile(resolve4(projectDir, "server.js"), sharedServerEntrypoint, {
+      force: options?.force,
+      writtenPaths,
+      baseDir: projectDir
+    });
+    await writeScaffoldFile(
+      resolve4(projectDir, "railway.toml"),
+      `[build]
+builder = "dockerfile"
+dockerfilePath = "Dockerfile"
+
+[deploy]
+startCommand = "node server.js"
+restartPolicyType = "on_failure"
+restartPolicyMaxRetries = 3
 `,
       { force: options?.force, writtenPaths, baseDir: projectDir }
     );
@@ -12913,15 +12966,18 @@ export const handler = async (event = {}) => {
     );
     await writeScaffoldFile(
       resolve4(projectDir, "Dockerfile"),
-      `FROM node:20-slim
+      `FROM node:22-slim
 WORKDIR /app
-COPY package.json package.json
+
+${chromiumLibsLayer}COPY package.json package.json
+RUN npm install --omit=dev
+
 COPY AGENT.md AGENT.md
 COPY poncho.config.js poncho.config.js
 COPY skills skills
 COPY tests tests
-RUN npm install -g @poncho-ai/cli@^${cliVersion}
 COPY server.js server.js
+
 EXPOSE 3000
 CMD ["node","server.js"]
 `,
@@ -13501,7 +13557,7 @@ var askOnboardingQuestions = async (options) => {
 var getProviderModelName = (provider) => provider === "openai" || provider === "openai-codex" ? "gpt-5.3-codex" : "claude-opus-4-5";
 var normalizeDeployTarget2 = (value) => {
   const target = typeof value === "string" ? value.toLowerCase() : "";
-  if (target === "vercel" || target === "docker" || target === "fly" || target === "lambda") {
+  if (target === "vercel" || target === "docker" || target === "fly" || target === "lambda" || target === "railway") {
     return target;
   }
   return "none";
@@ -14205,7 +14261,7 @@ var runInteractive = async (workingDir, params) => {
   await harness.initialize();
   const identity = await ensureAgentIdentity2(workingDir);
   try {
-    const { runInteractiveInk } = await import("./run-interactive-ink-W5YJS7UH.js");
+    const { runInteractiveInk } = await import("./run-interactive-ink-LJTKUUV4.js");
     await runInteractiveInk({
       harness,
       params,
@@ -18068,7 +18124,7 @@ var buildCli = () => {
       process.exitCode = 1;
     }
   });
-  program.command("build").argument("[target]", "vercel|docker|lambda|fly").option("--force", "overwrite existing deployment files").description("Scaffold deployment files for a target").action(async (target, options) => {
+  program.command("build").argument("[target]", "vercel|docker|lambda|fly|railway").option("--force", "overwrite existing deployment files").description("Scaffold deployment files for a target").action(async (target, options) => {
     if (!target) {
       return;
     }

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   main
-} from "./chunk-XCDN62XL.js";
+} from "./chunk-KVGMTYDD.js";
 
 // src/cli.ts
 void main();

package/dist/index.d.ts

@@ -78,7 +78,7 @@ declare const TEST_TEMPLATE = "tests:\n  - name: \"Basic sanity\"\n    task: \"W
 declare const SKILL_TEMPLATE = "---\nname: starter-skill\ndescription: Starter local skill template\nallowed-tools:\n  - ./scripts/starter-echo.ts\n---\n\n# Starter Skill\n\nThis is a starter local skill created by `poncho init`.\n\n## Authoring Notes\n\n- Put executable JavaScript/TypeScript files in `scripts/`.\n- Ask the agent to call `run_skill_script` with `skill`, `script`, and optional `input`.\n";
 declare const SKILL_TOOL_TEMPLATE = "export default async function run(input) {\n  const message = typeof input?.message === \"string\" ? input.message : \"\";\n  return { echoed: message };\n}\n";
 
-type DeployTarget = "none" | "vercel" | "docker" | "fly" | "lambda";
+type DeployTarget = "none" | "vercel" | "docker" | "fly" | "lambda" | "railway";
 type InitOnboardingOptions = {
     yes?: boolean;
     interactive?: boolean;

package/dist/index.js

@@ -77,7 +77,7 @@ import {
   writeHtml,
   writeJson,
   writeScaffoldFile
-} from "./chunk-XCDN62XL.js";
+} from "./chunk-KVGMTYDD.js";
 export {
   AGENT_TEMPLATE,
   ENV_TEMPLATE,

package/dist/{run-interactive-ink-W5YJS7UH.js → run-interactive-ink-LJTKUUV4.js}

@@ -3,7 +3,7 @@ import {
   getMascotLines,
   inferConversationTitle,
   resolveHarnessEnvironment
-} from "./chunk-XCDN62XL.js";
+} from "./chunk-KVGMTYDD.js";
 
 // src/run-interactive-ink.ts
 import * as readline from "readline";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/cli",
-  "version": "0.39.0",
+  "version": "0.40.0",
   "description": "CLI for building and deploying AI agents",
   "repository": {
     "type": "git",

package/src/index.ts

@@ -4741,7 +4741,7 @@ export const buildCli = (): Command => {
 
   program
     .command("build")
-    .argument("[target]", "vercel|docker|lambda|fly")
+    .argument("[target]", "vercel|docker|lambda|fly|railway")
     .option("--force", "overwrite existing deployment files")
     .description("Scaffold deployment files for a target")
     .action(async (target: string | undefined, options: { force?: boolean }) => {

package/src/init-onboarding.ts

@@ -21,7 +21,7 @@ const bold = (s: string): string => `${C.bold}${s}${C.reset}`;
 const INPUT_CARET = "»";
 
 type OnboardingAnswers = Record<string, string | number | boolean>;
-export type DeployTarget = "none" | "vercel" | "docker" | "fly" | "lambda";
+export type DeployTarget = "none" | "vercel" | "docker" | "fly" | "lambda" | "railway";
 
 export type InitOnboardingOptions = {
   yes?: boolean;
@@ -282,7 +282,13 @@ const getProviderModelName = (provider: string): string =>
 
 const normalizeDeployTarget = (value: unknown): DeployTarget => {
   const target = typeof value === "string" ? value.toLowerCase() : "";
-  if (target === "vercel" || target === "docker" || target === "fly" || target === "lambda") {
+  if (
+    target === "vercel" ||
+    target === "docker" ||
+    target === "fly" ||
+    target === "lambda" ||
+    target === "railway"
+  ) {
     return target;
   }
   return "none";

package/src/scaffolding.ts

@@ -25,7 +25,8 @@ export const normalizeDeployTarget = (target: string): DeployScaffoldTarget => {
     normalized === "vercel" ||
     normalized === "docker" ||
     normalized === "lambda" ||
-    normalized === "fly"
+    normalized === "fly" ||
+    normalized === "railway"
   ) {
     return normalized;
   }
@@ -223,6 +224,25 @@ const port = Number.parseInt(process.env.PORT ?? "3000", 10);
 await startDevServer(Number.isNaN(port) ? 3000 : port, { workingDir: process.cwd() });
 `;
 
+  let browserEnabled = false;
+  try {
+    const cfg = await loadPonchoConfig(projectDir);
+    browserEnabled = !!cfg?.browser;
+  } catch { /* best-effort */ }
+
+  // Chromium runtime libs for Playwright when `browser: true`. Built as a
+  // single apt-get layer so it can be inserted verbatim into Dockerfiles
+  // for docker/railway/fly targets and stripped out otherwise.
+  const chromiumLibsLayer = browserEnabled
+    ? `RUN apt-get update && apt-get install -y --no-install-recommends \\
+    ca-certificates fonts-liberation libnss3 libatk1.0-0 libatk-bridge2.0-0 \\
+    libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 \\
+    libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libasound2 \\
+  && rm -rf /var/lib/apt/lists/*
+
+`
+    : "";
+
   if (target === "vercel") {
     // Build @vercel/nft trace hints for packages that are dynamically loaded
     // at runtime.  Bare `import("pkg")` with a string literal is enough for
@@ -231,12 +251,6 @@ await startDevServer(Number.isNaN(port) ? 3000 : port, { workingDir: process.cwd
     // an optional package isn't installed.
     const traceHints: string[] = [];
 
-    let browserEnabled = false;
-    try {
-      const cfg = await loadPonchoConfig(projectDir);
-      browserEnabled = !!cfg?.browser;
-    } catch { /* best-effort */ }
-
     if (browserEnabled) {
       traceHints.push(`import("@poncho-ai/browser").catch(() => {});`);
 
@@ -346,16 +360,19 @@ export default async function handler(req, res) {
     const dockerfilePath = resolve(projectDir, "Dockerfile");
     await writeScaffoldFile(
       dockerfilePath,
-      `FROM node:20-slim
+      `FROM node:22-slim
 WORKDIR /app
-COPY package.json package.json
+
+${chromiumLibsLayer}COPY package.json package.json
+RUN npm install --omit=dev
+
 COPY AGENT.md AGENT.md
 COPY poncho.config.js poncho.config.js
 COPY skills skills
 COPY tests tests
 COPY .env.example .env.example
-RUN corepack enable && npm install -g @poncho-ai/cli@^${cliVersion}
 COPY server.js server.js
+
 EXPOSE 3000
 CMD ["node","server.js"]
 `,
@@ -389,6 +406,48 @@ export const handler = async (event = {}) => {
 //
 // Reminders: Create a CloudWatch Events rule that triggers GET /api/reminders/check
 // every 10 minutes (or your preferred interval) with Authorization: Bearer <PONCHO_AUTH_TOKEN>.
+`,
+      { force: options?.force, writtenPaths, baseDir: projectDir },
+    );
+  } else if (target === "railway") {
+    await writeScaffoldFile(
+      resolve(projectDir, "Dockerfile"),
+      `FROM node:22-slim
+WORKDIR /app
+
+${chromiumLibsLayer}COPY package.json package.json
+RUN npm install --omit=dev
+
+COPY AGENT.md AGENT.md
+COPY poncho.config.js poncho.config.js
+COPY skills skills
+COPY tests tests
+COPY .env.example .env.example
+COPY server.js server.js
+
+EXPOSE 3000
+CMD ["node","server.js"]
+`,
+      { force: options?.force, writtenPaths, baseDir: projectDir },
+    );
+    await writeScaffoldFile(resolve(projectDir, "server.js"), sharedServerEntrypoint, {
+      force: options?.force,
+      writtenPaths,
+      baseDir: projectDir,
+    });
+    // Pin Railway to the Dockerfile builder so it doesn't try Nixpacks (which
+    // misreads pnpm-workspace.yaml or missing lockfiles and fails the build
+    // before producing useful logs).
+    await writeScaffoldFile(
+      resolve(projectDir, "railway.toml"),
+      `[build]
+builder = "dockerfile"
+dockerfilePath = "Dockerfile"
+
+[deploy]
+startCommand = "node server.js"
+restartPolicyType = "on_failure"
+restartPolicyMaxRetries = 3
 `,
       { force: options?.force, writtenPaths, baseDir: projectDir },
     );
@@ -409,15 +468,18 @@ export const handler = async (event = {}) => {
     );
     await writeScaffoldFile(
       resolve(projectDir, "Dockerfile"),
-      `FROM node:20-slim
+      `FROM node:22-slim
 WORKDIR /app
-COPY package.json package.json
+
+${chromiumLibsLayer}COPY package.json package.json
+RUN npm install --omit=dev
+
 COPY AGENT.md AGENT.md
 COPY poncho.config.js poncho.config.js
 COPY skills skills
 COPY tests tests
-RUN npm install -g @poncho-ai/cli@^${cliVersion}
 COPY server.js server.js
+
 EXPOSE 3000
 CMD ["node","server.js"]
 `,

package/src/templates.ts

@@ -369,7 +369,7 @@ cron:
 
 - \`poncho dev\`: jobs run via an in-process scheduler.
 - \`poncho build vercel\`: generates \`vercel.json\` cron entries. Set \`CRON_SECRET\` to the same value as \`PONCHO_AUTH_TOKEN\` so Vercel can authenticate.
-- Docker/Fly.io: scheduler runs automatically.
+- Docker/Fly.io/Railway: scheduler runs automatically.
 - Lambda: use AWS EventBridge to trigger \`GET /api/cron/<jobName>\` with \`Authorization: Bearer <token>\`.
 - Trigger manually: \`curl http://localhost:3000/api/cron/daily-report\`
 
@@ -493,6 +493,10 @@ poncho build lambda
 # Fly.io
 poncho build fly
 fly deploy
+
+# Railway
+poncho build railway
+railway up
 \`\`\`
 
 Set environment variables on your deployment platform: