@duvoai/cli 0.0.1 → 0.1.0

package/dist/commands/runs/start.js

@@ -0,0 +1,54 @@
+import { startRunResponseSchema } from "../../api/run-schemas.js";
+import { httpRequest } from "../../client/client.js";
+import { CliError } from "../../errors.js";
+import { green } from "../../output/green.js";
+import { printJson } from "../../output/json.js";
+import { renderKeyValue } from "../../output/text.js";
+import { requireAuthenticatedConfig } from "../shared/require-auth.js";
+export function registerRunsStart(runs) {
+    runs
+        .command("start")
+        .description("Start a new agent run")
+        .requiredOption("--agent <id>", "ID of the agent to run")
+        .option("--message <text>", "optional initial message to start the run with")
+        .option("--sandbox-id <id>", "optional sandbox ID with pre-uploaded files")
+        .option("--webhook-url <url>", "optional webhook URL to POST run events to")
+        .option("--json", "output raw JSON from the API")
+        .action(async function startAction(options) {
+        const { apiKey, apiBaseUrl } = await requireAuthenticatedConfig(this);
+        const body = {
+            agent_id: options.agent,
+            ...(options.message !== undefined ? { message: options.message } : {}),
+            ...(options.sandboxId !== undefined
+                ? { sandbox_id: options.sandboxId }
+                : {}),
+            ...(options.webhookUrl !== undefined
+                ? { webhook_url: options.webhookUrl }
+                : {}),
+        };
+        const raw = await httpRequest({
+            method: "POST",
+            path: "/v1/runs",
+            apiKey,
+            apiBaseUrl,
+            body,
+        });
+        if (options.json) {
+            printJson(raw);
+            return;
+        }
+        const parsed = startRunResponseSchema.safeParse(raw);
+        if (!parsed.success) {
+            throw new CliError(`Unexpected response from the API: ${parsed.error.message}`);
+        }
+        const { run } = parsed.data;
+        console.log(green("Run started!"));
+        console.log(renderKeyValue([
+            { label: "ID", value: run.id },
+            { label: "Agent", value: run.agent_id },
+            { label: "Build", value: run.build_id },
+            { label: "Status", value: run.status },
+            { label: "Created", value: run.created_at },
+        ]));
+    });
+}

package/dist/commands/runs/stop.d.ts

@@ -0,0 +1,2 @@
+import { type Command } from "commander";
+export declare function registerRunsStop(runs: Command): void;

package/dist/commands/runs/stop.js

@@ -0,0 +1,41 @@
+import { stopRunResponseSchema } from "../../api/run-schemas.js";
+import { httpRequest } from "../../client/client.js";
+import { CliError } from "../../errors.js";
+import { green } from "../../output/green.js";
+import { printJson } from "../../output/json.js";
+import { confirmDestructive } from "../shared/confirm.js";
+import { requireAuthenticatedConfig } from "../shared/require-auth.js";
+export function registerRunsStop(runs) {
+    runs
+        .command("stop <id>")
+        .description("Stop a running agent run")
+        .option("-y, --yes", "skip the confirmation prompt")
+        .option("--json", "output raw JSON from the API")
+        .action(async function stopAction(id, options) {
+        const { apiKey, apiBaseUrl } = await requireAuthenticatedConfig(this);
+        await confirmDestructive({
+            message: `Stop run "${id}"?`,
+            skip: options.yes ?? false,
+        });
+        const raw = await httpRequest({
+            method: "POST",
+            path: `/v1/runs/${encodeURIComponent(id)}/stop`,
+            apiKey,
+            apiBaseUrl,
+        });
+        if (options.json) {
+            printJson(raw);
+            return;
+        }
+        const parsed = stopRunResponseSchema.safeParse(raw);
+        if (!parsed.success) {
+            throw new CliError(`Unexpected response from the API: ${parsed.error.message}`);
+        }
+        const { success, message } = parsed.data;
+        if (!success) {
+            throw new CliError(message ?? `Failed to stop run "${id}".`);
+        }
+        const label = message ?? `Run "${id}" stopped.`;
+        console.log(green(label));
+    });
+}

package/dist/commands/shared/require-auth.d.ts

@@ -0,0 +1,12 @@
+import { type Command } from "commander";
+import { type ResolvedConfig } from "../../config/resolve.js";
+export type AuthenticatedConfig = ResolvedConfig & {
+    apiKey: string;
+};
+/**
+ * Resolves the effective profile for this invocation and guarantees an
+ * API key is present. Intended for every command that hits the API —
+ * throws `AuthCliError` (exit code 2) if no key is stored or passed via
+ * env, so callers can assume `apiKey` is a non-null string.
+ */
+export declare function requireAuthenticatedConfig(command: Command): Promise<AuthenticatedConfig>;

package/dist/commands/shared/require-auth.js

@@ -0,0 +1,18 @@
+import { resolveConfig } from "../../config/resolve.js";
+import { AuthCliError } from "../../errors.js";
+import { getProfileFlag } from "./profile-flag.js";
+/**
+ * Resolves the effective profile for this invocation and guarantees an
+ * API key is present. Intended for every command that hits the API —
+ * throws `AuthCliError` (exit code 2) if no key is stored or passed via
+ * env, so callers can assume `apiKey` is a non-null string.
+ */
+export async function requireAuthenticatedConfig(command) {
+    const resolved = await resolveConfig({
+        profileFlag: getProfileFlag(command),
+    });
+    if (!resolved.apiKey) {
+        throw new AuthCliError("Not logged in. Run `duvo login` to save an API key.");
+    }
+    return { ...resolved, apiKey: resolved.apiKey };
+}

package/dist/commands/whoami.js

@@ -1,18 +1,11 @@
-import { resolveConfig } from "../config/resolve.js";
-import { AuthCliError } from "../errors.js";
 import { truncateApiKey } from "../output/format.js";
-import { getProfileFlag } from "./shared/profile-flag.js";
+import { requireAuthenticatedConfig } from "./shared/require-auth.js";
 export function registerWhoami(program) {
     program
         .command("whoami")
         .description("Print the default profile, truncated API key, and base URL")
         .action(async function whoamiAction() {
-        const resolved = await resolveConfig({
-            profileFlag: getProfileFlag(this),
-        });
-        if (!resolved.apiKey) {
-            throw new AuthCliError("Not logged in. Run `duvo login` to save an API key.");
-        }
+        const resolved = await requireAuthenticatedConfig(this);
         const profileLabel = resolved.profileName ?? "(env-only, no stored profile)";
         console.log(`Profile  ${profileLabel}`);
         console.log(`API key  ${truncateApiKey(resolved.apiKey)}`);

package/dist/output/green.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Wrap text in ANSI green. Honors `NO_COLOR` and skips styling when
+ * stdout is not a TTY so piped output stays clean.
+ */
+export declare function green(text: string): string;

package/dist/output/green.js

@@ -0,0 +1,18 @@
+const GREEN = "\x1b[32m";
+const RESET = "\x1b[0m";
+/**
+ * Wrap text in ANSI green. Honors `NO_COLOR` and skips styling when
+ * stdout is not a TTY so piped output stays clean.
+ */
+export function green(text) {
+    if (!shouldColor()) {
+        return text;
+    }
+    return `${GREEN}${text}${RESET}`;
+}
+function shouldColor() {
+    if (process.env.NO_COLOR !== undefined && process.env.NO_COLOR !== "") {
+        return false;
+    }
+    return Boolean(process.stdout.isTTY);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duvoai/cli",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Command-line interface for the Duvo public API",
   "type": "module",
   "main": "dist/bin/duvo.js",
@@ -8,7 +8,8 @@
     "duvo": "./dist/bin/duvo.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json && tsc-alias -p tsconfig.json && node scripts/make-bin-executable.mjs",
@@ -20,6 +21,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.8.2",
+    "@taskcrew/shared": "workspace:*",
     "commander": "^12.1.0",
     "zod": "^3.25.76"
   },