@upstash/box-cli 0.1.3 → 0.1.5

package/dist/commands/init-demo.js

@@ -0,0 +1,197 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import readline from "node:readline";
+import { resolveToken } from "../auth.js";
+import { bold, cyan, green, dim, red, yellow } from "../utils/ansi.js";
+function generateEnvFile(flags, token) {
+    const lines = [
+        `UPSTASH_BOX_API_KEY=${token}`,
+        `AGENT_MODEL=${flags.agentModel ?? ""}`,
+        `AGENT_API_KEY=${flags.agentApiKey ?? ""}`,
+        `RUNTIME=${flags.runtime ?? "node"}`,
+        `GIT_TOKEN=${flags.gitToken ?? ""}`,
+    ];
+    return lines.join("\n") + "\n";
+}
+function generateMainTs(dir) {
+    return `import "dotenv/config";
+import { Box } from "@upstash/box";
+
+async function main() {
+  const config: Parameters<typeof Box.create>[0] = {
+    apiKey: process.env.UPSTASH_BOX_API_KEY!,
+  };
+
+  if (process.env.RUNTIME) {
+    config.runtime = process.env.RUNTIME;
+  }
+
+  if (process.env.AGENT_MODEL && process.env.AGENT_API_KEY) {
+    config.agent = {
+      model: process.env.AGENT_MODEL,
+      apiKey: process.env.AGENT_API_KEY,
+    };
+  }
+
+  if (process.env.GIT_TOKEN) {
+    config.git = { token: process.env.GIT_TOKEN };
+  }
+
+  console.log("Creating box...");
+  const box = await Box.create(config);
+  console.log(\`Box created: \${box.id}\`);
+
+  try {
+    // Write a file
+    console.log("\\nWriting hello.txt...");
+    await box.files.write({ path: "hello.txt", content: "Hello from Upstash Box!" });
+    console.log("File written.");
+
+    // Read it back
+    console.log("\\nReading hello.txt...");
+    const content = await box.files.read("hello.txt");
+    console.log(\`Content: \${content}\`);
+
+    // Execute a command
+    console.log("\\nRunning: ls -la");
+    const run = await box.exec("ls -la");
+    const output = await run.result();
+    console.log(output);
+
+    // List files
+    console.log("Listing files...");
+    const files = await box.files.list(".");
+    console.log(files.map((f: { name: string }) => f.name).join("  "));
+
+    // Agent demo (if configured)
+    if (process.env.AGENT_MODEL && process.env.AGENT_API_KEY) {
+      console.log("\\nRunning agent prompt...");
+      const stream = box.agent.stream({
+        prompt: "Create a file called demo.js that prints 'Hello World'",
+      });
+      for await (const chunk of stream) {
+        process.stdout.write(chunk);
+      }
+      console.log();
+    }
+
+    // Git demo (if configured)
+    if (process.env.GIT_TOKEN) {
+      console.log("\\nGit status:");
+      const gitRun = await box.exec("git status");
+      const gitOutput = await gitRun.result();
+      console.log(gitOutput);
+    }
+  } finally {
+    // Pause so you can check logs on the Upstash console
+    console.log("\\nPausing box...");
+    await box.pause();
+    console.log(\`Box \${box.id} paused. You can check your logs on the Upstash console.\`);
+    console.log(\`\\n\\x1b[2mTo reconnect to this box:\\x1b[22m\\n\\n  \\x1b[36mcd ${dir} && npx @upstash/box-cli connect \${box.id}\\x1b[39m\\n\`);
+  }
+}
+
+main().catch(console.error);
+`;
+}
+function generateReadme(dir) {
+    return `# Box Demo
+
+A standalone demo project for the [@upstash/box](https://www.npmjs.com/package/@upstash/box) SDK.
+
+## Environment Variables
+
+Configure these in the \`.env\` file:
+
+| Variable               | Description                                      | Required |
+| ---------------------- | ------------------------------------------------ | -------- |
+| \`UPSTASH_BOX_API_KEY\`  | Your Upstash Box API token                       | Yes      |
+| \`AGENT_MODEL\`          | Agent model identifier (e.g. \`claude/sonnet_4_5\`)  | No       |
+| \`AGENT_API_KEY\`        | API key for the agent model                      | No       |
+| \`RUNTIME\`              | Runtime environment (default: \`node\`)             | No       |
+| \`GIT_TOKEN\`            | GitHub personal access token                     | No       |
+
+## What the demo does
+
+1. Creates a new box
+2. Writes a file and reads it back
+3. Executes a shell command (\`ls -la\`)
+4. Lists files in the box
+5. (If agent configured) Runs an agent prompt with streaming
+6. (If git configured) Shows git status
+7. Pauses the box so you can check logs on the Upstash console
+
+## Running
+
+\`\`\`bash
+cd ${dir}
+npx tsx main.ts
+\`\`\`
+`;
+}
+function askQuestion(query) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(query, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase());
+        });
+    });
+}
+export async function initDemoCommand(flags) {
+    const token = resolveToken(flags.token);
+    if (flags.agentModel && !flags.agentApiKey) {
+        console.error(red("Error: --agent-api-key is required if --agent-model is set"));
+        process.exit(1);
+    }
+    const dir = flags.directory ?? "box-demo";
+    const absDir = path.resolve(dir);
+    if (fs.existsSync(absDir)) {
+        console.error(red(`Error: Directory "${dir}" already exists.`));
+        process.exit(1);
+    }
+    // Confirmation prompt
+    console.log(`\nThis command will:\n`);
+    console.log(`  ${cyan("1.")} Create a directory ${bold(cyan(dir))}`);
+    console.log(`  ${cyan("2.")} Install ${bold("@upstash/box")} and dependencies`);
+    console.log(`  ${cyan("3.")} Prepare an example script to showcase Upstash Box\n`);
+    const confirm = await askQuestion(`Proceed? ${dim("(Y/n)")} `);
+    if (confirm !== "" && confirm !== "y" && confirm !== "yes") {
+        console.log(dim("Aborted."));
+        return;
+    }
+    fs.mkdirSync(absDir, { recursive: true });
+    console.log(`\nInitializing demo project in ${cyan(dir)}/...`);
+    execSync('npm init -y && npm pkg set type="module"', {
+        cwd: absDir,
+        stdio: "ignore",
+    });
+    console.log(`Installing dependencies...`);
+    execSync("npm install @upstash/box dotenv", { cwd: absDir, stdio: "ignore" });
+    execSync("npm install --save-dev @types/node", {
+        cwd: absDir,
+        stdio: "ignore",
+    });
+    fs.writeFileSync(path.join(absDir, ".env"), generateEnvFile(flags, token));
+    fs.writeFileSync(path.join(absDir, "main.ts"), generateMainTs(dir));
+    fs.writeFileSync(path.join(absDir, "README.md"), generateReadme(dir));
+    console.log(`\n${green("Demo project created in")} ${bold(cyan(dir))}/`);
+    console.log(`  ${cyan(".env")}       ${dim("—")} environment variables`);
+    console.log(`  ${cyan("main.ts")}    ${dim("—")} demo script`);
+    console.log(`  ${cyan("README.md")}  ${dim("—")} documentation\n`);
+    console.log(`See ${cyan("README.md")} for details on configuration and usage.\n`);
+    const answer = await askQuestion(`Run the demo now? ${dim("(Y/n)")} `);
+    if (answer === "" || answer === "y" || answer === "yes") {
+        console.log(yellow("\nRunning demo...\n"));
+        execSync("npx tsx main.ts", { cwd: absDir, stdio: "inherit" });
+    }
+    else {
+        console.log(`\nTo run later:\n  ${cyan(`cd ${dir} && npx tsx main.ts`)}`);
+    }
+}
+export { generateEnvFile, generateMainTs, generateReadme };
+//# sourceMappingURL=init-demo.js.map

package/dist/commands/init-demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-demo.js","sourceRoot":"","sources":["../../src/commands/init-demo.ts"],"names":[],"mappings":"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"}

package/dist/commands/list.d.ts

@@ -1,6 +1,6 @@
 interface ListFlags {
-  token?: string;
+    token?: string;
 }
 export declare function listCommand(flags: ListFlags): Promise<void>;
 export {};
-//# sourceMappingURL=list.d.ts.map
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAIA,UAAU,SAAS;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBjE"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAIA,UAAU,SAAS;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBjE"}

package/dist/commands/list.js

@@ -1,19 +1,19 @@
 import { Box } from "@upstash/box";
 import { resolveToken } from "../auth.js";
 export async function listCommand(flags) {
-  const apiKey = resolveToken(flags.token);
-  const boxes = await Box.list({ apiKey });
-  if (boxes.length === 0) {
-    console.log("No boxes found.");
-    return;
-  }
-  const headers = ["ID", "STATUS", "MODEL", "CREATED"];
-  const rows = boxes.map((b) => [b.id, b.status, b.model ?? "", String(b.created_at)]);
-  const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
-  const formatRow = (row) => row.map((val, i) => val.padEnd(colWidths[i])).join("  ");
-  console.log(formatRow(headers));
-  for (const row of rows) {
-    console.log(formatRow(row));
-  }
+    const apiKey = resolveToken(flags.token);
+    const boxes = await Box.list({ apiKey });
+    if (boxes.length === 0) {
+        console.log("No boxes found.");
+        return;
+    }
+    const headers = ["ID", "STATUS", "MODEL", "CREATED"];
+    const rows = boxes.map((b) => [b.id, b.status, b.model ?? "", String(b.created_at)]);
+    const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+    const formatRow = (row) => row.map((val, i) => val.padEnd(colWidths[i])).join("  ");
+    console.log(formatRow(headers));
+    for (const row of rows) {
+        console.log(formatRow(row));
+    }
 }
-//# sourceMappingURL=list.js.map
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAgB;IAChD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAEzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAErF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACrC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,CACrD,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,GAAa,EAAE,EAAE,CAClC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5D,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAgB;IAChD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAEzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAErF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE9F,MAAM,SAAS,GAAG,CAAC,GAAa,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE/F,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 import "dotenv/config";
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -6,45 +6,61 @@ import { connectCommand } from "./commands/connect.js";
 import { fromSnapshotCommand } from "./commands/from-snapshot.js";
 import { listCommand } from "./commands/list.js";
 import { getCommand } from "./commands/get.js";
+import { initDemoCommand } from "./commands/init-demo.js";
+import { completionCommand } from "./commands/completion.js";
 const program = new Command();
 program
-  .name("box")
-  .description("CLI for Upstash Box — REPL-first interface for AI coding agents")
-  .version("0.1.0");
-program
-  .command("create")
-  .description("Create a new box and enter the REPL")
-  .option("--token <token>", "Upstash Box API token")
-  .option("--runtime <runtime>", "Runtime environment (node, python, golang, ruby, rust)")
-  .option("--agent-model <model>", "Agent model identifier")
-  .option("--agent-api-key <key>", "Agent API key (Anthropic or OpenAI)")
-  .option("--git-token <token>", "GitHub personal access token")
-  .option("--env <KEY=VAL>", "Environment variable (repeatable)", (val, prev) => [...prev, val], [])
-  .action((opts) => createCommand(opts));
-program
-  .command("connect [box-id]")
-  .description("Connect to an existing box (or most recent) and enter the REPL")
-  .option("--token <token>", "Upstash Box API token")
-  .action((boxId, opts) => connectCommand(boxId, opts));
-program
-  .command("from-snapshot <snapshot-id>")
-  .description("Create a new box from a snapshot and enter the REPL")
-  .option("--token <token>", "Upstash Box API token")
-  .option("--runtime <runtime>", "Runtime environment")
-  .option("--agent-model <model>", "Agent model identifier")
-  .option("--agent-api-key <key>", "Agent API key")
-  .option("--git-token <token>", "GitHub personal access token")
-  .option("--env <KEY=VAL>", "Environment variable (repeatable)", (val, prev) => [...prev, val], [])
-  .action((snapshotId, opts) => fromSnapshotCommand(snapshotId, opts));
-program
-  .command("list")
-  .description("List all boxes")
-  .option("--token <token>", "Upstash Box API token")
-  .action((opts) => listCommand(opts));
-program
-  .command("get <box-id>")
-  .description("Get details about a box")
-  .option("--token <token>", "Upstash Box API token")
-  .action((boxId, opts) => getCommand(boxId, opts));
+    .name("box")
+    .description("CLI for Upstash Box — REPL-first interface for AI coding agents")
+    .version("0.1.0");
+program
+    .command("create")
+    .description("Create a new box and enter the REPL")
+    .option("--token <token>", "Upstash Box API token")
+    .option("--runtime <runtime>", "Runtime environment (node, python, golang, ruby, rust)")
+    .option("--agent-model <model>", "Agent model identifier")
+    .option("--agent-api-key <key>", "Agent API key (Anthropic or OpenAI)")
+    .option("--git-token <token>", "GitHub personal access token")
+    .option("--env <KEY=VAL>", "Environment variable (repeatable)", (val, prev) => [...prev, val], [])
+    .action((opts) => createCommand(opts));
+program
+    .command("connect [box-id]")
+    .description("Connect to an existing box (or most recent) and enter the REPL")
+    .option("--token <token>", "Upstash Box API token")
+    .action((boxId, opts) => connectCommand(boxId, opts));
+program
+    .command("from-snapshot <snapshot-id>")
+    .description("Create a new box from a snapshot and enter the REPL")
+    .option("--token <token>", "Upstash Box API token")
+    .option("--runtime <runtime>", "Runtime environment")
+    .option("--agent-model <model>", "Agent model identifier")
+    .option("--agent-api-key <key>", "Agent API key")
+    .option("--git-token <token>", "GitHub personal access token")
+    .option("--env <KEY=VAL>", "Environment variable (repeatable)", (val, prev) => [...prev, val], [])
+    .action((snapshotId, opts) => fromSnapshotCommand(snapshotId, opts));
+program
+    .command("list")
+    .description("List all boxes")
+    .option("--token <token>", "Upstash Box API token")
+    .action((opts) => listCommand(opts));
+program
+    .command("get <box-id>")
+    .description("Get details about a box")
+    .option("--token <token>", "Upstash Box API token")
+    .action((boxId, opts) => getCommand(boxId, opts));
+program
+    .command("init-demo")
+    .description("Scaffold a standalone demo project for @upstash/box")
+    .option("--token <token>", "Upstash Box API token")
+    .option("--agent-model <model>", "Agent model identifier")
+    .option("--agent-api-key <key>", "Agent API key (required if --agent-model is set)")
+    .option("--runtime <runtime>", "Runtime environment", "node")
+    .option("--git-token <token>", "GitHub personal access token")
+    .option("--directory <dir>", "Output directory", "box-demo")
+    .action((opts) => initDemoCommand(opts));
+program
+    .command("completion")
+    .description('Output shell completion script (eval "$(box completion)")')
+    .action(() => completionCommand());
 program.parse();
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,iEAAiE,CAAC;KAC9E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,qCAAqC,CAAC;KAClD,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,qBAAqB,EAAE,wDAAwD,CAAC;KACvF,MAAM,CAAC,uBAAuB,EAAE,wBAAwB,CAAC;KACzD,MAAM,CAAC,uBAAuB,EAAE,qCAAqC,CAAC;KACtE,MAAM,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;KAC7D,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,EAAc,CAAC;KAC/H,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AAEzC,OAAO;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAExD,OAAO;KACJ,OAAO,CAAC,6BAA6B,CAAC;KACtC,WAAW,CAAC,qDAAqD,CAAC;KAClE,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;KACpD,MAAM,CAAC,uBAAuB,EAAE,wBAAwB,CAAC;KACzD,MAAM,CAAC,uBAAuB,EAAE,eAAe,CAAC;KAChD,MAAM,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;KAC7D,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,EAAc,CAAC;KAC/H,MAAM,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;AAEvE,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gBAAgB,CAAC;KAC7B,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AAEvC,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,yBAAyB,CAAC;KACtC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAEpD,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/output.d.ts

@@ -6,4 +6,4 @@ export declare function formatJSON(data: unknown): string;
  * Format raw text for display.
  */
 export declare function formatRaw(text: string): string;
-//# sourceMappingURL=output.d.ts.map
+//# sourceMappingURL=output.d.ts.map

package/dist/output.js

@@ -2,12 +2,12 @@
  * Format data as JSON for display.
  */
 export function formatJSON(data) {
-  return JSON.stringify(data, null, 2);
+    return JSON.stringify(data, null, 2);
 }
 /**
  * Format raw text for display.
  */
 export function formatRaw(text) {
-  return text;
+    return text;
 }
-//# sourceMappingURL=output.js.map
+//# sourceMappingURL=output.js.map

package/dist/repl/client.d.ts

@@ -0,0 +1,30 @@
+import type { Box } from "@upstash/box";
+export type REPLHooks = {
+    onLog: (message: string) => void;
+    onError: (message: string) => void;
+    onStream: (message: string) => void;
+    /** Loading indicator. Return a stop() function. */
+    onLoadingStart?: () => () => void;
+    /** Post-command suggestion (e.g. "try: /snapshot"). */
+    onSuggestion?: (text: string) => void;
+    /** Timing info after each command. */
+    onCommandComplete?: (command: string, durationMs: number) => void;
+    /** Unknown /command with fuzzy suggestions. Falls back to onError if absent. */
+    onCommandNotFound?: (typed: string, suggestions: string[]) => void;
+};
+/** All available command names (without / prefix). */
+export declare const COMMAND_NAMES: string[];
+/** Command descriptions for completer/preview. */
+export declare const COMMAND_DESCRIPTIONS: Record<string, string>;
+export declare class BoxREPLClient {
+    readonly box: Box;
+    readonly promptUser: (prompt: string) => Promise<string>;
+    private readonly hooks;
+    constructor({ box, promptUser, hooks, }: {
+        box: Box;
+        promptUser: (prompt: string) => Promise<string>;
+        hooks: REPLHooks;
+    });
+    startLoop(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/repl/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/repl/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAUxC,MAAM,MAAM,SAAS,GAAG;IAEtB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAIpC,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,MAAM,IAAI,CAAC;IAElC,uDAAuD;IACvD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAElE,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACpE,CAAC;AAeF,sDAAsD;AACtD,eAAO,MAAM,aAAa,UAAwB,CAAC;AAEnD,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQvD,CAAC;AAoBF,qBAAa,aAAa;IACxB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAEtB,EACV,GAAG,EACH,UAAU,EACV,KAAK,GACN,EAAE;QACD,GAAG,EAAE,GAAG,CAAC;QACT,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAChD,KAAK,EAAE,SAAS,CAAC;KAClB;IAMK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAuEjC"}

package/dist/repl/client.js

@@ -0,0 +1,128 @@
+import { handleRun } from "./commands/run.js";
+import { handleExec } from "./commands/exec.js";
+import { handleFiles } from "./commands/files.js";
+import { handleGit } from "./commands/git.js";
+import { handleSnapshot } from "./commands/snapshot.js";
+import { handlePause } from "./commands/pause.js";
+import { handleDelete } from "./commands/delete.js";
+import { fuzzyMatch } from "../utils/fuzzy.js";
+const COMMANDS = {
+    run: handleRun,
+    exec: handleExec,
+    files: handleFiles,
+    git: handleGit,
+    snapshot: handleSnapshot,
+    pause: handlePause,
+    delete: handleDelete,
+};
+/** All available command names (without / prefix). */
+export const COMMAND_NAMES = Object.keys(COMMANDS);
+/** Command descriptions for completer/preview. */
+export const COMMAND_DESCRIPTIONS = {
+    run: "Run the agent with a prompt",
+    exec: "Execute a shell command",
+    files: "File operations (read, write, list, upload, download)",
+    git: "Git operations (clone, diff, create-pr)",
+    snapshot: "Create a snapshot of the current box",
+    pause: "Pause the box and exit",
+    delete: "Delete the box and exit",
+};
+/** Context-aware suggestion after a command completes. */
+function getSuggestion(cmdName) {
+    switch (cmdName) {
+        case "exec":
+            return "/files list .";
+        case "run":
+            return "/snapshot";
+        case "files":
+            return "/exec ls";
+        case "git":
+            return "/snapshot";
+        case "snapshot":
+            return "/pause";
+        default:
+            return undefined;
+    }
+}
+export class BoxREPLClient {
+    box;
+    promptUser;
+    hooks;
+    constructor({ box, promptUser, hooks, }) {
+        this.box = box;
+        this.promptUser = promptUser;
+        this.hooks = hooks;
+    }
+    async startLoop() {
+        const { hooks } = this;
+        hooks.onLog(`\nConnected to box ${this.box.id}`);
+        hooks.onLog(`Type a prompt to run the agent, or use commands: ${COMMAND_NAMES.map((c) => `/${c}`).join(", ")}, /exit\n`);
+        while (true) {
+            const input = await this.promptUser(`${this.box.id}> `);
+            const trimmed = input.trim();
+            if (!trimmed)
+                continue;
+            if (trimmed === "exit" || trimmed === "/exit") {
+                hooks.onLog("Goodbye.");
+                break;
+            }
+            // Commands require / prefix
+            if (trimmed.startsWith("/")) {
+                const withoutSlash = trimmed.slice(1);
+                const spaceIdx = withoutSlash.indexOf(" ");
+                const cmdName = spaceIdx === -1 ? withoutSlash : withoutSlash.slice(0, spaceIdx);
+                const args = spaceIdx === -1 ? "" : withoutSlash.slice(spaceIdx + 1).trim();
+                const handler = COMMANDS[cmdName];
+                if (handler) {
+                    const start = Date.now();
+                    const stopLoading = hooks.onLoadingStart?.();
+                    try {
+                        const shouldExit = await handler(this.box, args, hooks);
+                        stopLoading?.();
+                        const durationMs = Date.now() - start;
+                        hooks.onCommandComplete?.(cmdName, durationMs);
+                        const suggestion = getSuggestion(cmdName);
+                        if (suggestion)
+                            hooks.onSuggestion?.(suggestion);
+                        if (shouldExit === true)
+                            break;
+                    }
+                    catch (err) {
+                        stopLoading?.();
+                        hooks.onError(`Error: ${err instanceof Error ? err.message : err}`);
+                    }
+                }
+                else {
+                    // Unknown command — fuzzy match
+                    const suggestions = fuzzyMatch(cmdName, COMMAND_NAMES);
+                    if (hooks.onCommandNotFound) {
+                        hooks.onCommandNotFound(cmdName, suggestions);
+                    }
+                    else {
+                        const msg = suggestions.length > 0
+                            ? `Unknown command: /${cmdName}. Did you mean: ${suggestions.map((s) => `/${s}`).join(", ")}?`
+                            : `Unknown command: /${cmdName}. Available: ${COMMAND_NAMES.map((c) => `/${c}`).join(", ")}`;
+                        hooks.onError(msg);
+                    }
+                }
+            }
+            else {
+                // No / prefix — treat as agent prompt
+                const start = Date.now();
+                const stopLoading = hooks.onLoadingStart?.();
+                try {
+                    await handleRun(this.box, trimmed, hooks);
+                    stopLoading?.();
+                    const durationMs = Date.now() - start;
+                    hooks.onCommandComplete?.("run", durationMs);
+                    hooks.onSuggestion?.("/snapshot");
+                }
+                catch (err) {
+                    stopLoading?.();
+                    hooks.onError(`Error: ${err instanceof Error ? err.message : err}`);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/repl/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/repl/client.ts"],"names":[],"mappings":"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"}

package/dist/repl/commands/delete.d.ts

@@ -0,0 +1,7 @@
+import type { Box } from "@upstash/box";
+import type { REPLHooks } from "../client.js";
+/**
+ * Delete the box. Returns true to signal the REPL to exit.
+ */
+export declare function handleDelete(box: Box, _args: string, hooks: REPLHooks): Promise<boolean>;
+//# sourceMappingURL=delete.d.ts.map

package/dist/repl/commands/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/repl/commands/delete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAI9F"}

package/dist/repl/commands/delete.js

@@ -0,0 +1,9 @@
+/**
+ * Delete the box. Returns true to signal the REPL to exit.
+ */
+export async function handleDelete(box, _args, hooks) {
+    await box.delete();
+    hooks.onLog(`Box ${box.id} deleted.`);
+    return true;
+}
+//# sourceMappingURL=delete.js.map

package/dist/repl/commands/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/repl/commands/delete.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAQ,EAAE,KAAa,EAAE,KAAgB;IAC1E,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/repl/commands/exec.d.ts

@@ -0,0 +1,7 @@
+import type { Box } from "@upstash/box";
+import type { REPLHooks } from "../client.js";
+/**
+ * Execute a shell command in the box.
+ */
+export declare function handleExec(box: Box, command: string, hooks: REPLHooks): Promise<void>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/repl/commands/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/repl/commands/exec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ3F"}

package/dist/repl/commands/exec.js

@@ -0,0 +1,14 @@
+/**
+ * Execute a shell command in the box.
+ */
+export async function handleExec(box, command, hooks) {
+    if (!command) {
+        hooks.onLog("Usage: exec <command>");
+        return;
+    }
+    const run = await box.exec(command);
+    const result = await run.result();
+    if (result)
+        hooks.onLog(result);
+}
+//# sourceMappingURL=exec.js.map