@upstash/box-cli 0.1.8 → 0.1.10

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/cli.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { Command } from "commander";
+import { createCommand } from "./commands/create.js";
+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 { snapshotCommand } from "./commands/snapshot.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));
+program
+    .command("snapshot [box-id]")
+    .description("Create a snapshot of a box")
+    .option("--token <token>", "Upstash Box API token")
+    .option("--name <name>", "Snapshot name")
+    .action((boxId, opts) => snapshotCommand(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=cli.js.map

package/dist/cli.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAMA,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA0Cf"}
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAMA,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA8Cf"}

package/dist/commands/connect.js

@@ -33,7 +33,12 @@ export async function connectCommand(boxId, flags) {
             targetId = selected;
         }
         else {
-            console.log("No box ID specified, connecting to most recent...");
+            if (active.length === 1) {
+                console.log("Only one box found, using it...");
+            }
+            else {
+                console.log("No box ID specified, connecting to most recent...");
+            }
             targetId = active[0].id;
         }
     }

package/dist/commands/connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAMvC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAyB,EACzB,KAAmB;IAEnB,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEzC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,wEAAwE;IACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAEnE,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC;gBACvC,MAAM,EAAE,6BAA6B;gBACrC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvB,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;oBAC3B,KAAK,EAAE,CAAC,CAAC,EAAE;oBACX,WAAW,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE;iBACjE,CAAC,CAAC;aACJ,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC7B,OAAO;YACT,CAAC;YACD,QAAQ,GAAG,QAAQ,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;YACjE,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,KAAK,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"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"}

package/dist/commands/snapshot.d.ts

@@ -0,0 +1,7 @@
+interface SnapshotFlags {
+    token?: string;
+    name?: string;
+}
+export declare function snapshotCommand(boxId: string | undefined, flags: SnapshotFlags): Promise<void>;
+export {};
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/commands/snapshot.ts"],"names":[],"mappings":"AAKA,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/commands/snapshot.js

@@ -0,0 +1,45 @@
+import { Box } from "@upstash/box";
+import { resolveToken } from "../auth.js";
+import { interactiveSelect } from "../utils/interactive-select.js";
+import { dim } from "../utils/ansi.js";
+export async function snapshotCommand(boxId, flags) {
+    const apiKey = resolveToken(flags.token);
+    let targetId = boxId;
+    // If no box ID provided, pick interactively or fall back to most recent
+    if (!targetId) {
+        const boxes = await Box.list({ apiKey });
+        const active = boxes.filter((b) => b.status !== "deleted");
+        if (active.length === 0) {
+            console.error("No boxes found.");
+            process.exit(1);
+        }
+        if (process.stdin.isTTY && active.length > 1) {
+            const items = active.slice(0, 10);
+            const idWidth = Math.max(...items.map((b) => b.id.length));
+            const statusWidth = Math.max(...items.map((b) => b.status.length));
+            const selected = await interactiveSelect({
+                prompt: "Select a box to snapshot:",
+                items: items.map((b) => ({
+                    label: b.id.padEnd(idWidth),
+                    value: b.id,
+                    description: `${b.status.padEnd(statusWidth)}  ${b.model ?? ""}`,
+                })),
+            });
+            if (!selected) {
+                console.log(dim("Aborted."));
+                return;
+            }
+            targetId = selected;
+        }
+        else {
+            console.log("Only one box found, using it...");
+            targetId = active[0].id;
+        }
+    }
+    const snapshotName = flags.name ?? `snapshot-${Date.now()}`;
+    console.log(`\nCreating snapshot of box ${targetId}...`);
+    const box = await Box.get(targetId, { apiKey });
+    const snapshot = await box.snapshot({ name: snapshotName });
+    console.log(`Snapshot created: ${snapshot.id} (${snapshot.name})`);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/commands/snapshot.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
-import "dotenv/config";
+export { BoxREPLClient, COMMAND_NAMES, COMMAND_DESCRIPTIONS } from "./repl/client.js";
+export type { BoxREPLEvent, BoxREPLCommand, BoxREPLCommandHandler, BoxREPLCommandName, } from "./repl/types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACtF,YAAY,EACV,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,66 +1,2 @@
-#!/usr/bin/env node
-import "dotenv/config";
-import { Command } from "commander";
-import { createCommand } from "./commands/create.js";
-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));
-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();
+export { BoxREPLClient, COMMAND_NAMES, COMMAND_DESCRIPTIONS } from "./repl/client.js";
 //# 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;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,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,CACL,iBAAiB,EACjB,mCAAmC,EACnC,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAC/C,EAAc,CACf;KACA,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,CACL,iBAAiB,EACjB,mCAAmC,EACnC,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAC/C,EAAc,CACf;KACA,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;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,qDAAqD,CAAC;KAClE,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,uBAAuB,EAAE,wBAAwB,CAAC;KACzD,MAAM,CAAC,uBAAuB,EAAE,kDAAkD,CAAC;KACnF,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,CAAC;KAC5D,MAAM,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;KAC7D,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,UAAU,CAAC;KAC3D,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;AAE3C,OAAO;KACJ,OAAO,CAAC,YAAY,CAAC;KACrB,WAAW,CAAC,2DAA2D,CAAC;KACxE,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAErC,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/repl/client.d.ts

@@ -1,30 +1,17 @@
 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;
-};
+import type { BoxREPLEvent, BoxREPLCommand, BoxREPLCommandName } from "./types.js";
 /** All available command names (without / prefix). */
-export declare const COMMAND_NAMES: string[];
+export declare const COMMAND_NAMES: BoxREPLCommandName[];
 /** Command descriptions for completer/preview. */
-export declare const COMMAND_DESCRIPTIONS: Record<string, string>;
+export declare const COMMAND_DESCRIPTIONS: Record<BoxREPLCommandName, 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>;
+    constructor(box: Box);
+    /** Parse input and return the matching command + args, or null. */
+    private getCommand;
+    /** Return commands whose name starts with the given prefix. */
+    static suggestCommands(prefix: string): BoxREPLCommand[];
+    /** Process a single line of input and yield events. */
+    handleInput(input: string): AsyncGenerator<BoxREPLEvent>;
 }
 //# sourceMappingURL=client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/repl/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAWxC,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;AAgBF,sDAAsD;AACtD,eAAO,MAAM,aAAa,UAAwB,CAAC;AAEnD,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASvD,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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/repl/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAyBnF,sDAAsD;AACtD,eAAO,MAAM,aAAa,EAA4B,kBAAkB,EAAE,CAAC;AAE3E,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAE7B,CAAC;AAoBxC,qBAAa,aAAa;IACxB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;gBAEN,GAAG,EAAE,GAAG;IAIpB,mEAAmE;IACnE,OAAO,CAAC,UAAU;IAelB,+DAA+D;IAC/D,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAOxD,uDAAuD;IAChD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC;CA8ChE"}

package/dist/repl/client.js

@@ -8,30 +8,24 @@ import { handleDelete } from "./commands/delete.js";
 import { handleConsole } from "./commands/console.js";
 import { fuzzyMatch } from "../utils/fuzzy.js";
 const COMMANDS = {
-    run: handleRun,
-    exec: handleExec,
-    files: handleFiles,
-    git: handleGit,
-    snapshot: handleSnapshot,
-    pause: handlePause,
-    delete: handleDelete,
-    console: handleConsole,
+    run: { description: "Run the agent with a prompt", handler: handleRun },
+    exec: { description: "Execute a shell command", handler: handleExec },
+    files: {
+        description: "File operations (read, write, list, upload, download)",
+        handler: handleFiles,
+    },
+    git: { description: "Git operations (clone, diff, create-pr)", handler: handleGit },
+    snapshot: { description: "Create a snapshot of the current box", handler: handleSnapshot },
+    pause: { description: "Pause the box and exit", handler: handlePause },
+    delete: { description: "Delete the box and exit", handler: handleDelete },
+    console: { description: "Open the box in Upstash console", handler: handleConsole },
 };
 /** 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",
-    console: "Open the box in Upstash console",
-};
+export const COMMAND_DESCRIPTIONS = Object.fromEntries(COMMAND_NAMES.map((name) => [name, COMMANDS[name].description]));
 /** Context-aware suggestion after a command completes. */
-function getSuggestion(cmdName) {
+function getNextCommandSuggestion(cmdName) {
     switch (cmdName) {
         case "exec":
             return "/files list .";
@@ -49,82 +43,78 @@ function getSuggestion(cmdName) {
 }
 export class BoxREPLClient {
     box;
-    promptUser;
-    hooks;
-    constructor({ box, promptUser, hooks, }) {
+    constructor(box) {
         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
+    /** Parse input and return the matching command + args, or null. */
+    getCommand(input) {
+        const trimmed = input.trim();
+        if (!trimmed.startsWith("/"))
+            return null;
+        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 entry = COMMANDS[cmdName];
+        if (!entry)
+            return null;
+        return { command: { name: cmdName, ...entry }, args };
+    }
+    /** Return commands whose name starts with the given prefix. */
+    static suggestCommands(prefix) {
+        return COMMAND_NAMES.filter((name) => name.startsWith(prefix)).map((name) => ({
+            name,
+            ...COMMANDS[name],
+        }));
+    }
+    /** Process a single line of input and yield events. */
+    async *handleInput(input) {
+        const trimmed = input.trim();
+        if (!trimmed)
+            return;
+        if (trimmed === "exit" || trimmed === "/exit") {
+            yield { type: "exit", message: "Goodbye." };
+            return;
+        }
+        if (trimmed.startsWith("/")) {
+            const parsed = this.getCommand(trimmed);
+            if (parsed) {
+                const { command, args } = parsed;
+                yield { type: "command:start", command: command.name, args };
                 const start = Date.now();
-                const stopLoading = hooks.onLoadingStart?.();
                 try {
-                    await handleRun(this.box, trimmed, hooks);
-                    stopLoading?.();
+                    yield* command.handler(this.box, args);
                     const durationMs = Date.now() - start;
-                    hooks.onCommandComplete?.("run", durationMs);
-                    hooks.onSuggestion?.("/snapshot");
+                    yield { type: "command:complete", command: command.name, durationMs };
+                    const suggestion = getNextCommandSuggestion(command.name);
+                    if (suggestion)
+                        yield { type: "suggestion", text: suggestion };
                 }
                 catch (err) {
-                    stopLoading?.();
-                    hooks.onError(`Error: ${err instanceof Error ? err.message : err}`);
+                    yield { type: "error", message: `Error: ${err instanceof Error ? err.message : err}` };
                 }
             }
+            else {
+                const withoutSlash = trimmed.slice(1);
+                const spaceIdx = withoutSlash.indexOf(" ");
+                const cmdName = spaceIdx === -1 ? withoutSlash : withoutSlash.slice(0, spaceIdx);
+                const suggestions = fuzzyMatch(cmdName, COMMAND_NAMES);
+                yield { type: "command:not-found", typed: cmdName, suggestions };
+            }
+        }
+        else {
+            // No / prefix — treat as agent prompt
+            yield { type: "command:start", command: "run", args: trimmed };
+            const start = Date.now();
+            try {
+                yield* handleRun(this.box, trimmed);
+                const durationMs = Date.now() - start;
+                yield { type: "command:complete", command: "run", durationMs };
+                yield { type: "suggestion", text: "/snapshot" };
+            }
+            catch (err) {
+                yield { type: "error", message: `Error: ${err instanceof Error ? err.message : err}` };
+            }
         }
     }
 }

package/dist/repl/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/repl/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAuB/C,MAAM,QAAQ,GAGV;IACF,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,cAAc;IACxB,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,aAAa;CACvB,CAAC;AAEF,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAEnD,kDAAkD;AAClD,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,GAAG,EAAE,6BAA6B;IAClC,IAAI,EAAE,yBAAyB;IAC/B,KAAK,EAAE,uDAAuD;IAC9D,GAAG,EAAE,yCAAyC;IAC9C,QAAQ,EAAE,sCAAsC;IAChD,KAAK,EAAE,wBAAwB;IAC/B,MAAM,EAAE,yBAAyB;IACjC,OAAO,EAAE,iCAAiC;CAC3C,CAAC;AAEF,0DAA0D;AAC1D,SAAS,aAAa,CAAC,OAAe;IACpC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,OAAO;YACV,OAAO,UAAU,CAAC;QACpB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,aAAa;IACf,GAAG,CAAM;IACT,UAAU,CAAsC;IACxC,KAAK,CAAY;IAElC,YAAY,EACV,GAAG,EACH,UAAU,EACV,KAAK,GAKN;QACC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvB,KAAK,CAAC,KAAK,CAAC,sBAAsB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,KAAK,CAAC,KAAK,CACT,oDAAoD,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAC5G,CAAC;QAEF,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;YACxD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;gBAC9C,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBACxB,MAAM;YACR,CAAC;YAED,4BAA4B;YAC5B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC3C,MAAM,OAAO,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;gBACjF,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAE5E,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAClC,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBACzB,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;oBAC7C,IAAI,CAAC;wBACH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;wBACxD,WAAW,EAAE,EAAE,CAAC;wBAChB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;wBACtC,KAAK,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;wBAC/C,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;wBAC1C,IAAI,UAAU;4BAAE,KAAK,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC;wBACjD,IAAI,UAAU,KAAK,IAAI;4BAAE,MAAM;oBACjC,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,WAAW,EAAE,EAAE,CAAC;wBAChB,KAAK,CAAC,OAAO,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;oBACtE,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,gCAAgC;oBAChC,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;oBACvD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;wBAC5B,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;oBAChD,CAAC;yBAAM,CAAC;wBACN,MAAM,GAAG,GACP,WAAW,CAAC,MAAM,GAAG,CAAC;4BACpB,CAAC,CAAC,qBAAqB,OAAO,mBAAmB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;4BAC9F,CAAC,CAAC,qBAAqB,OAAO,gBAAgB,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;wBACjG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBACrB,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,sCAAsC;gBACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACzB,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC7C,IAAI,CAAC;oBACH,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;oBAC1C,WAAW,EAAE,EAAE,CAAC;oBAChB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;oBACtC,KAAK,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;oBAC7C,KAAK,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,WAAW,EAAE,EAAE,CAAC;oBAChB,KAAK,CAAC,OAAO,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/repl/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,QAAQ,GAA6D;IACzE,GAAG,EAAE,EAAE,WAAW,EAAE,6BAA6B,EAAE,OAAO,EAAE,SAAS,EAAE;IACvE,IAAI,EAAE,EAAE,WAAW,EAAE,yBAAyB,EAAE,OAAO,EAAE,UAAU,EAAE;IACrE,KAAK,EAAE;QACL,WAAW,EAAE,uDAAuD;QACpE,OAAO,EAAE,WAAW;KACrB;IACD,GAAG,EAAE,EAAE,WAAW,EAAE,yCAAyC,EAAE,OAAO,EAAE,SAAS,EAAE;IACnF,QAAQ,EAAE,EAAE,WAAW,EAAE,sCAAsC,EAAE,OAAO,EAAE,cAAc,EAAE;IAC1F,KAAK,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,OAAO,EAAE,WAAW,EAAE;IACtE,MAAM,EAAE,EAAE,WAAW,EAAE,yBAAyB,EAAE,OAAO,EAAE,YAAY,EAAE;IACzE,OAAO,EAAE,EAAE,WAAW,EAAE,iCAAiC,EAAE,OAAO,EAAE,aAAa,EAAE;CACpF,CAAC;AAEF,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAyB,CAAC;AAE3E,kDAAkD;AAClD,MAAM,CAAC,MAAM,oBAAoB,GAAuC,MAAM,CAAC,WAAW,CACxF,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAC1B,CAAC;AAExC,0DAA0D;AAC1D,SAAS,wBAAwB,CAAC,OAA2B;IAC3D,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,OAAO;YACV,OAAO,UAAU,CAAC;QACpB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,aAAa;IACf,GAAG,CAAM;IAElB,YAAY,GAAQ;QAClB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,mEAAmE;IAC3D,UAAU,CAAC,KAAa;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAE1C,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE5E,MAAM,KAAK,GAAG,QAAQ,CAAC,OAA6B,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAA6B,EAAE,GAAG,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC;IAC9E,CAAC;IAED,+DAA+D;IAC/D,MAAM,CAAC,eAAe,CAAC,MAAc;QACnC,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5E,IAAI;YACJ,GAAG,QAAQ,CAAC,IAAI,CAAC;SAClB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,CAAC,WAAW,CAAC,KAAa;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YAC9C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAExC,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;gBACjC,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;gBAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;oBACvC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;oBACtC,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;oBACtE,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC1D,IAAI,UAAU;wBAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;gBACjE,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;gBACzF,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC3C,MAAM,OAAO,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;gBACjF,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,EAAE,aAAa,CAAyB,CAAC;gBAC/E,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;YACnE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,sCAAsC;YACtC,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBACpC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;gBACtC,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;gBAC/D,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YAClD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;YACzF,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

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

@@ -1,7 +1,8 @@
 import type { Box } from "@upstash/box";
-import type { REPLHooks } from "../client.js";
+import type { BoxREPLEvent } from "../types.js";
 /**
  * Open the Upstash console for the current box in the default browser.
+ * Yields an open-url event; the consumer handles actually opening the browser.
  */
-export declare function handleConsole(box: Box, _args: string, hooks: REPLHooks): Promise<void>;
+export declare function handleConsole(box: Box, _args: string): AsyncGenerator<BoxREPLEvent>;
 //# sourceMappingURL=console.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/repl/commands/console.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9C;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAc5F"}
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/repl/commands/console.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;;GAGG;AACH,wBAAuB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,CAI1F"}

package/dist/repl/commands/console.js

@@ -1,17 +1,11 @@
-import { exec } from "node:child_process";
-const UPSTASH_CONSOLE_URL = "http://localhost:3000/box/resolve";
+const UPSTASH_CONSOLE_URL = "https://console.upstash.com/box/resolve";
 /**
  * Open the Upstash console for the current box in the default browser.
+ * Yields an open-url event; the consumer handles actually opening the browser.
  */
-export async function handleConsole(box, _args, hooks) {
+export async function* handleConsole(box, _args) {
     const url = `${UPSTASH_CONSOLE_URL}/${box.id}`;
-    const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-    exec(`${openCmd} ${url}`, (err) => {
-        if (err) {
-            hooks.onError(`Failed to open browser: ${err.message}`);
-            return;
-        }
-    });
-    hooks.onLog(`Opening ${url}`);
+    yield { type: "open-url", url };
+    yield { type: "log", message: `Opening ${url}` };
 }
 //# sourceMappingURL=console.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/repl/commands/console.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAI1C,MAAM,mBAAmB,GAAG,mCAAmC,CAAC;AAEhE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAQ,EAAE,KAAa,EAAE,KAAgB;IAC3E,MAAM,GAAG,GAAG,GAAG,mBAAmB,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;IAE/C,MAAM,OAAO,GACX,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;IAE/F,IAAI,CAAC,GAAG,OAAO,IAAI,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE;QAChC,IAAI,GAAG,EAAE,CAAC;YACR,KAAK,CAAC,OAAO,CAAC,2BAA2B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/repl/commands/console.ts"],"names":[],"mappings":"AAGA,MAAM,mBAAmB,GAAG,yCAAyC,CAAC;AAEtE;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,aAAa,CAAC,GAAQ,EAAE,KAAa;IAC1D,MAAM,GAAG,GAAG,GAAG,mBAAmB,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;IAC/C,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IAChC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,GAAG,EAAE,EAAE,CAAC;AACnD,CAAC"}