@vibecodr/cli 1.0.10 → 1.0.13

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 Pre-1.0.0 history for the `@vibecodr/cli@0.2.x` and `0.1.x` lines lives at [`docs/legacy/CHANGELOG-mcp-cli.md`](docs/legacy/CHANGELOG-mcp-cli.md). The `@vibecodr/vc-tools@0.1.x` line was the other half of the May 2026 merge; its source history is preserved in the archived [`BradenHartsell/vc-tools`](https://github.com/BradenHartsell/vc-tools) repository.
 
+## 1.0.13
+
+Makes `browser snapshot` a plain capture command instead of a confusing ask-style lane.
+
+- `vibecodr browser snapshot <url>` no longer advertises or accepts `--instructions`; the help text now says plainly that snapshot captures page state and does not prompt an agent or model.
+- `vibecodr browser ask` is kept as an advanced compatibility alias, but its visible flag is now `--note`, and the help text says it saves that note with the snapshot rather than answering like chat.
+- The hosted MCP `browser.snapshot` tool schema no longer exposes `instructions` or `actions`; raw `browser.agent_task` remains the lower-level compatibility capability for advanced callers.
+
+## 1.0.12
+
+Makes hosted Agent Computer outputs visible and easy to save from the first command result.
+
+- `vibecodr browser ...`, `vibecodr computer ...`, and `vibecodr work follow` now accept `--local`, which waits for the hosted job and saves the completed artifact into `./vibecodr-proof`.
+- Completed output now includes the artifact handle plus ready-to-run `vibecodr proof show` and `vibecodr proof save` commands instead of returning only `{ "status": "completed" }`.
+- Root help, command help, docs, fixtures, and tests now advertise and lock the `--local` path for the simplest user flow.
+
+## 1.0.11
+
+Supersedes 1.0.10 with the same CLI auth guidance plus a release-packaging guard.
+
+- `prepack`, `publish:release`, and `verify:artifact` now remove and forbid `dist/dryrun/` so Wrangler dry-run output can never be swept into the npm package.
+- Published after the `vc-tools-api` worker read back `1.0.10`; the runtime behavior remains the first-run guidance from 1.0.10.
+
 ## 1.0.10
 
 Aligns the CLI first-run guidance with the Vibecodr CLI product pages without renaming Agent Computer, MCP Gateway, or the underlying credential lanes.

package/README.md

@@ -58,7 +58,7 @@ vibecodr install codex
 
 # 3. Set up the hosted Agent Computer when you want browser/computer work.
 vibecodr start
-vibecodr browser screenshot https://example.com --out ./proof
+vibecodr browser screenshot https://example.com --local
 ```
 
 Power users and automation should prefer the explicit surfaces and stable JSON:

package/dist/app/help.js

@@ -44,7 +44,7 @@ export function rootHelpText() {
         "",
         "Do useful things:",
         "  vibecodr browser read https://example.com",
-        "  vibecodr browser screenshot https://example.com --out ./proof",
+        "  vibecodr browser screenshot https://example.com --local",
         "  vibecodr upload --zip ./project.zip",
         "  vibecodr pulse list",
         "  vibecodr feedback \"This part was confusing\"",

package/dist/app/help.js.map

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

package/dist/legacy/cli/run.js

@@ -16,7 +16,7 @@ const VERSION = VC_TOOLS_VERSION;
 const MAX_CREDENTIAL_BYTES = 64 * 1024;
 const DEFAULT_AUTH_API_URL = "https://api.vibecodr.space";
 const GRANT_REFRESH_SKEW_SECONDS = 60;
-const ARTIFACT_OUTPUT_WORKSPACE_MESSAGE = "Artifact output is workspace-bounded so downloaded bytes can only be written to files you intentionally target inside this workspace. Use --out ./artifacts, --out ./artifacts/report.pdf, or cd to the intended workspace and use --out .";
+const ARTIFACT_OUTPUT_WORKSPACE_MESSAGE = "Artifact output is workspace-bounded so downloaded bytes can only be written to files you intentionally target inside this workspace. Use --local for ./vibecodr-proof, --out ./artifacts, --out ./artifacts/report.pdf, or cd to the intended workspace and use --out .";
 const ARTIFACT_INPUT_WORKSPACE_MESSAGE = "Artifact upload sources are workspace-bounded so the CLI only reads files you intentionally target inside this workspace. Move the file into this workspace, or cd to the workspace that contains it.";
 export async function runCli(argv, options = {}) {
     const stdout = options.stdout ?? process.stdout;
@@ -646,13 +646,16 @@ async function commandBrowser(context, subcommand, rest) {
             return submitHostedCapability(context, "browser.pdf", parsed, "Asked the hosted Browser to create a PDF.", { autoFollow: true });
         case "crawl":
             return submitHostedCapability(context, "browser.crawl", parsed, "Asked the hosted Browser to crawl the public site.", { autoFollow: true });
-        case "snapshot":
+        case "snapshot": {
+            const normalized = normalizeBrowserSnapshotOptions(parsed);
+            return submitHostedCapability(context, "browser.snapshot", normalized, "Captured a hosted Browser snapshot.", { autoFollow: true });
+        }
         case "ask": {
             const normalized = normalizeBrowserAskOptions(parsed);
-            return submitHostedCapability(context, "browser.ask", normalized, "Asked the hosted Browser to capture an inspection snapshot for your agent.", { autoFollow: true });
+            return submitHostedCapability(context, "browser.ask", normalized, "Captured a hosted Browser snapshot with your note attached.", { autoFollow: true });
         }
         default:
-            throw unknownSubcommandError("browser", subcommand, ["render", "screenshot", "read", "markdown", "pdf", "crawl", "snapshot", "ask"], "Use vibecodr browser screenshot <https-url>, browser read <https-url>, or browser snapshot <https-url> --instructions <text>.");
+            throw unknownSubcommandError("browser", subcommand, ["render", "screenshot", "read", "markdown", "pdf", "crawl", "snapshot", "ask"], "Use vibecodr browser screenshot <https-url>, browser read <https-url>, or browser snapshot <https-url> --local.");
     }
 }
 async function commandComputer(context, subcommand, rest) {
@@ -725,8 +728,12 @@ async function commandToolsTest(context, parsed) {
     }
     return submitHostedCapability(context, capabilityInput, { positionals: target === undefined ? [] : [target], flags: parsed.flags });
 }
+const DEFAULT_LOCAL_PROOF_DIR = "vibecodr-proof";
 async function submitHostedCapability(context, capabilityInput, parsed, successMessage, options = {}) {
     const capability = normalizeCapabilityName(capabilityInput);
+    if (getBooleanFlag(parsed.flags, "local") && shouldSkipWait(parsed)) {
+        throw new CliError("input.local_requires_wait", "--local saves the completed output, so it cannot be combined with --no-wait.", 2);
+    }
     const payload = buildToolTestPayload(capability, parsed.positionals[0], parsed, context.globals.timeoutMs === 30_000 ? undefined : context.globals.timeoutMs);
     const { profile } = await context.store.getProfile(context.globals.profile);
     const client = createClient(context, profile, await resolveToken(context, true));
@@ -757,8 +764,8 @@ async function followSubmittedWork(context, client, capability, submitted, parse
         ? submitted
         : await pollWorkUntilTerminal(client, jobId, parsed);
     const artifactId = artifactIdFromWork(terminal);
-    const proof = artifactId && getStringFlag(parsed.flags, "out") !== undefined
-        ? await saveArtifact(context, client, artifactId, parsed)
+    const proof = artifactId && shouldSaveArtifact(parsed)
+        ? await saveArtifact(context, client, artifactId, parsedWithLocalOutput(parsed))
         : undefined;
     return {
         message: formatCompletedWorkMessage(capability, terminal, proof),
@@ -772,8 +779,8 @@ async function commandWorkFollow(context, parsed) {
     const client = createClient(context, profile, await resolveToken(context, true));
     const job = await pollWorkUntilTerminal(client, jobId, parsed);
     const artifactId = artifactIdFromWork(job);
-    const proof = artifactId && getStringFlag(parsed.flags, "out") !== undefined
-        ? await saveArtifact(context, client, artifactId, parsed)
+    const proof = artifactId && shouldSaveArtifact(parsed)
+        ? await saveArtifact(context, client, artifactId, parsedWithLocalOutput(parsed))
         : undefined;
     return {
         message: formatCompletedWorkMessage(undefined, job, proof),
@@ -828,11 +835,69 @@ function artifactIdFromWork(value) {
     }
     return undefined;
 }
+function workArtifactSummary(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const source = isRecord(value.result) && typeof value.result.artifactId === "string"
+        ? value.result
+        : typeof value.artifactId === "string"
+            ? value
+            : undefined;
+    if (source) {
+        return {
+            id: String(source.artifactId),
+            ...(typeof source.kind === "string" ? { kind: source.kind } : {}),
+            ...(typeof source.contentType === "string" ? { contentType: source.contentType } : {}),
+            ...(typeof source.bytes === "number" ? { bytes: source.bytes } : {})
+        };
+    }
+    if (Array.isArray(value.artifacts)) {
+        const first = value.artifacts.find((item) => isRecord(item) && typeof item.id === "string");
+        if (isRecord(first) && typeof first.id === "string") {
+            return {
+                id: first.id,
+                ...(typeof first.kind === "string" ? { kind: first.kind } : {}),
+                ...(typeof first.contentType === "string" ? { contentType: first.contentType } : {}),
+                ...(typeof first.bytes === "number" ? { bytes: first.bytes } : {})
+            };
+        }
+    }
+    return undefined;
+}
+function shouldSaveArtifact(parsed) {
+    return getStringFlag(parsed.flags, "out") !== undefined || getBooleanFlag(parsed.flags, "local");
+}
+function parsedWithLocalOutput(parsed) {
+    if (getStringFlag(parsed.flags, "out") !== undefined || !getBooleanFlag(parsed.flags, "local")) {
+        return parsed;
+    }
+    return {
+        ...parsed,
+        flags: {
+            ...parsed.flags,
+            out: DEFAULT_LOCAL_PROOF_DIR
+        }
+    };
+}
 function formatCompletedWorkMessage(capability, work, proof) {
     const status = workStatus(work) ?? "completed";
     if (status === "completed") {
-        const saved = proof ? `\nProof saved: ${proof.path}` : "";
-        return `${completedCapabilityMessage(capability)}${saved}`;
+        if (proof) {
+            return `${completedCapabilityMessage(capability)}\nSaved output: ${proof.path}`;
+        }
+        const artifact = workArtifactSummary(work);
+        if (artifact) {
+            const details = [artifact.kind, formatByteCount(artifact.bytes)].filter(Boolean).join(", ");
+            return [
+                completedCapabilityMessage(capability),
+                `Output ready${details ? `: ${details}` : "."}`,
+                `View it: vibecodr proof show ${artifact.id}`,
+                `Save it: vibecodr proof save ${artifact.id} --out ./${DEFAULT_LOCAL_PROOF_DIR}`,
+                `Next time: add --local to save it automatically.`
+            ].join("\n");
+        }
+        return completedCapabilityMessage(capability);
     }
     if (status === "queued" || status === "running") {
         const id = jobIdFromWork(work);
@@ -866,16 +931,42 @@ function completedCapabilityMessage(capability) {
             return "Hosted work completed.";
     }
 }
+function formatByteCount(bytes) {
+    if (bytes === undefined || !Number.isFinite(bytes)) {
+        return undefined;
+    }
+    if (bytes < 1024) {
+        return `${bytes} B`;
+    }
+    const kib = bytes / 1024;
+    if (kib < 1024) {
+        return `${Math.round(kib * 10) / 10} KB`;
+    }
+    const mib = kib / 1024;
+    return `${Math.round(mib * 10) / 10} MB`;
+}
 function publicWorkResult(capability, work, parsed, proof) {
     const details = getBooleanFlag(parsed.flags, "details");
+    const artifact = workArtifactSummary(work);
     const result = {
         status: workStatus(work) ?? "completed"
     };
     if (capability) {
         result.tool = userToolName(capability);
     }
+    if (artifact) {
+        result.artifact = {
+            id: artifact.id,
+            ...(artifact.kind ? { kind: artifact.kind } : {}),
+            ...(artifact.contentType ? { contentType: artifact.contentType } : {}),
+            ...(artifact.bytes !== undefined ? { bytes: artifact.bytes } : {}),
+            showCommand: `vibecodr proof show ${artifact.id}`,
+            saveCommand: `vibecodr proof save ${artifact.id} --out ./${DEFAULT_LOCAL_PROOF_DIR}`
+        };
+    }
     if (proof) {
         result.proof = {
+            artifactId: proof.artifactId,
             path: proof.path,
             bytes: proof.bytes,
             contentType: proof.contentType
@@ -905,12 +996,31 @@ function userToolName(capability) {
         return "computer.test";
     return capability;
 }
+function normalizeBrowserSnapshotOptions(parsed) {
+    const [url, ...extraParts] = parsed.positionals;
+    if (extraParts.length > 0 || parsed.flags.instructions !== undefined || parsed.flags.note !== undefined) {
+        throw new CliError("input.snapshot_is_not_prompted", "browser snapshot captures the page state; it does not prompt an agent or model. Remove the note/instructions, or use `vibecodr browser ask <url> --note \"...\"` for the advanced compatibility lane.", 2);
+    }
+    return {
+        positionals: url === undefined ? [] : [url],
+        flags: parsed.flags
+    };
+}
 function normalizeBrowserAskOptions(parsed) {
     const [url, ...instructionParts] = parsed.positionals;
     const flags = { ...parsed.flags };
+    const note = getStringFlag(flags, "note");
+    const instructions = getStringFlag(flags, "instructions");
+    if (instructions === undefined && note !== undefined) {
+        flags.instructions = note;
+    }
+    delete flags.note;
     if (getStringFlag(flags, "instructions") === undefined && instructionParts.length > 0) {
         flags.instructions = instructionParts.join(" ");
     }
+    if (getStringFlag(flags, "instructions") === undefined) {
+        throw new CliError("input.ask_note_required", "browser ask is an advanced compatibility alias and needs a note. For a normal capture, use `vibecodr browser snapshot <url> --local`.", 2);
+    }
     return {
         positionals: url === undefined ? [] : [url],
         flags
@@ -2586,9 +2696,9 @@ Examples:
   vibecodr try
   vibecodr agent connect --client codex
   vibecodr computer status
-  vibecodr browser screenshot https://example.com --format png --out ./proof
+  vibecodr browser screenshot https://example.com --format png --local
   vibecodr browser read https://example.com
-  vibecodr computer run "npm test" --out ./proof
+  vibecodr computer run "npm test" --local
   vibecodr work follow job_123
   vibecodr proof save art_123 --out ./artifacts
 
@@ -2602,7 +2712,7 @@ Commands:
   try         Run a small browser, computer, proof, and usage check.
   agent       Connect an agent to the hosted computer or check readiness.
   computer    Start/status/run commands on the hosted Agent Computer.
-  browser     Ask the hosted Browser to render, read, screenshot, crawl, or inspect public HTTPS pages.
+  browser     Capture, read, render, crawl, or inspect public HTTPS pages with the hosted Browser.
   work        List, follow, show, or cancel hosted work.
   proof       List, show, save, or delete saved outputs and artifacts.
   usage       Show account-scoped Agent Computer capacity and quota progress.
@@ -2684,8 +2794,8 @@ Public HTTP(S) package/docs access is available by default; private, local, and
 Usage:
   vibecodr computer start
   vibecodr computer status
-  vibecodr computer run "<command>" [--timeout-ms <ms>] [--network public|off] [--out ./proof] [--no-wait] [--details]
-  vibecodr computer test "<command>" [--timeout-ms <ms>] [--network public|off] [--out ./proof] [--no-wait] [--details]
+  vibecodr computer run "<command>" [--timeout-ms <ms>] [--network public|off] [--local|--out ./proof] [--no-wait] [--details]
+  vibecodr computer test "<command>" [--timeout-ms <ms>] [--network public|off] [--local|--out ./proof] [--no-wait] [--details]
 `;
         case "browser":
             return `vibecodr browser
@@ -2693,16 +2803,20 @@ Usage:
 Use the hosted Browser against public HTTPS pages. Localhost, private networks, URL credentials, and internal hosts are blocked before hosted work is submitted.
 
 Usage:
-  vibecodr browser screenshot <https-url> [--format png] [--out ./proof] [--no-wait] [--details]
-  vibecodr browser read <https-url> [--out ./proof] [--no-wait] [--details]
-  vibecodr browser render <https-url> [--out ./proof] [--no-wait] [--details]
-  vibecodr browser pdf <https-url> [--out ./proof] [--no-wait] [--details]
-  vibecodr browser crawl <https-url> [--max-pages n] [--max-depth n]
-  vibecodr browser snapshot <https-url> [--instructions <text>]
-  vibecodr browser ask <https-url> --instructions <text>
+  vibecodr browser screenshot <https-url> [--format png] [--local|--out ./proof] [--no-wait] [--details]
+  vibecodr browser read <https-url> [--local|--out ./proof] [--no-wait] [--details]
+  vibecodr browser render <https-url> [--local|--out ./proof] [--no-wait] [--details]
+  vibecodr browser pdf <https-url> [--local|--out ./proof] [--no-wait] [--details]
+  vibecodr browser crawl <https-url> [--max-pages n] [--max-depth n] [--local|--out ./proof]
+  vibecodr browser snapshot <https-url> [--local|--out ./proof]
+
+Advanced compatibility:
+  vibecodr browser ask <https-url> --note <text> [--local|--out ./proof]
 
 Notes:
-  browser snapshot captures a bounded inspection snapshot for your agent to analyze. browser ask is a compatibility alias; it is not a separate chat answerer.
+  Add --local to save completed output into ./vibecodr-proof automatically.
+  browser snapshot captures page state; it does not prompt an agent or model.
+  browser ask saves your note with the snapshot; it is not a chat answerer.
 `;
         case "work":
             return `vibecodr work
@@ -2712,7 +2826,7 @@ Inspect hosted work the agent has submitted.
 Usage:
   vibecodr work list [--limit 20]
   vibecodr work show <jobId>
-  vibecodr work follow <jobId> [--out ./proof] [--details]
+  vibecodr work follow <jobId> [--local|--out ./proof] [--details]
   vibecodr work cancel <jobId> --yes
 `;
         case "proof":