replicas-cli 0.2.407 → 0.2.408

package/dist/index.mjs

@@ -22655,7 +22655,7 @@ replicas computer browser-state /tmp/after-click.png
 replicas computer record start /tmp/demo.mp4 --fps 60
 # ... do stuff ...
 replicas computer record stop
-replicas media upload /tmp/demo.mp4
+replicas media upload /tmp/demo.mp4 --name "Demo recording"
 \`\`\`
 
 ## Command reference
@@ -22745,7 +22745,7 @@ Starts an ffmpeg screen recorder and returns only after ffmpeg has written the f
 Only one recording at a time. Re-running \`start\` while one is active fails - call \`stop\` first.
 
 ### \`replicas computer record stop\`
-SIGINTs ffmpeg, verifies that the process has finalized the MP4, then prints the output path. A finalization timeout preserves the recording state so \`stop\` can be retried safely. Upload it with \`replicas media upload <path>\` to share it.
+SIGINTs ffmpeg, verifies that the process has finalized the MP4, then prints the output path. A finalization timeout preserves the recording state so \`stop\` can be retried safely. Upload it with \`replicas media upload <path> --name "<name>"\` to share it.
 
 ## Patterns
 
@@ -22790,7 +22790,7 @@ For tasks the user wants proof of:
 replicas computer record start /tmp/walkthrough.mp4
 # ... your work ...
 replicas computer record stop
-replicas media upload /tmp/walkthrough.mp4
+replicas media upload /tmp/walkthrough.mp4 --name "Walkthrough recording"
 \`\`\`
 Then embed the printed \`![\u2026](\u2026)\` line in your chat reply. See \`MEDIA.md\`.
 
@@ -22991,7 +22991,7 @@ gh pr review 123 --request-changes --body "Changes needed"
 GitHub does NOT have a public API for uploading images to PRs/issues. When you need to include images:
 - Do NOT use placeholder image URLs
 - Do NOT commit screenshots as files to the repository
-- Run \`replicas media upload <image> --share\` and put the printed \`Forge embed\` Markdown in the PR body or comment
+- Run \`replicas media upload <image> --name "<display name>" --share\` and put the printed \`Forge embed\` Markdown in the PR body or comment
 - For video, embed a shared poster image linked to the recording's **View in Replicas** URL; GitHub does not reliably render externally hosted video inline
 - Treat the public URL as an opt-in bearer capability; revoke it with \`replicas media revoke <media-id>\` only when the user asks or the media should stop rendering \u2014 revoking breaks embeds already posted on the PR
 - If you were triggered from Slack, also upload the image to the Slack thread so the user can see it directly
@@ -23572,10 +23572,26 @@ If none of these apply, don't upload.
 ## Uploading to Replicas
 
 \`\`\`bash
-replicas media upload <path-to-file> [<path-to-file> ...]
+replicas media upload <path-to-file> --name "<display name>" [<path-to-file> --name "<display name>" ...]
 \`\`\`
 
-Pass one or more file paths. Uploading several files in a single invocation is preferred over running the command repeatedly \u2014 it's faster and keeps the output grouped.
+Pass one or more file paths, each with a required \`--name\` (see below). Uploading several files in a single invocation is preferred over running the command repeatedly: it's faster and keeps the output grouped.
+
+### Name each upload
+
+\`--name\` is **required** and sets the short, human-readable display name shown in the Replicas dashboard (the backend still tracks the asset by UUID). Make it descriptive of the content, e.g. \`login-page\`, \`checkout-error\`, or \`db-latency-chart\`. Never use a generic value like \`screenshot\` or \`image\`.
+
+\`\`\`bash
+replicas media upload /tmp/shot.png --name "Login page after fix"
+\`\`\`
+
+Pass one \`--name\` per file, in the same order as the file paths:
+
+\`\`\`bash
+replicas media upload /tmp/before.png /tmp/after.png --name "Before fix" --name "After fix"
+\`\`\`
+
+Names are normalized to hyphen-case (spaces become hyphens, e.g. \`Login page\` is stored as \`login-page\`). Give every asset a **distinct** name \u2014 duplicates are not rejected, but Replicas keeps the first as-is and adds a \`-1\`, \`-2\` suffix to later collisions, which produces confusing lists, so pick unique names yourself.
 
 For each file, the CLI prints two lines:
 
@@ -23587,7 +23603,7 @@ Match each "View in Replicas" line to the embed line directly above it \u2014 th
 Pass \`--share\` only when the media must render on an external forge:
 
 \`\`\`bash
-replicas media upload screenshot.png --share
+replicas media upload screenshot.png --name "Login page" --share
 \`\`\`
 
 This prints an additional \`Forge embed\` Markdown line backed by an opt-in public bearer URL. Anyone with that unguessable URL can view the asset until it is rotated or revoked. Use \`replicas media share <media-id>\` to rotate it and \`replicas media revoke <media-id>\` to revoke it.
@@ -23757,7 +23773,7 @@ Never paste the \`api.tryreplicas.com/v1/media/<id>\` URL into a Linear body or
 GitHub has **no public API** for uploading attachments to PRs or issues. Its web UI uses an undocumented internal endpoint that API clients must not emulate. For screenshots, explicitly create a forge share and put the printed \`Forge embed\` Markdown directly in the PR body or comment, followed by the dashboard link:
 
 \`\`\`bash
-replicas media upload /tmp/screenshot.png --share
+replicas media upload /tmp/screenshot.png --name "PR screenshot" --share
 \`\`\`
 
 GitHub does not reliably render arbitrary external videos as inline players. For a recording:
@@ -23811,13 +23827,14 @@ Auto-detected from the filename extension:
 For other extensions, pass \`--kind image|video|audio\` explicitly. The kind applies to every file in that invocation, so group files of the same kind together:
 
 \`\`\`bash
-replicas media upload diagram.svg --kind image
-replicas media upload chart-a.svg chart-b.svg --kind image
+replicas media upload diagram.svg --name "Architecture diagram" --kind image
+replicas media upload chart-a.svg chart-b.svg --name "Latency chart" --name "Error rate chart" --kind image
 \`\`\`
 
 ## Options
 
 - \`--kind <image|video|audio>\` \u2014 override auto-detection
+- \`--name <name>\`: required display name shown in the dashboard, one per file in order
 - \`--session-id <id>\` \u2014 associate the upload with a specific session
 - \`--share\`: create a revocable public bearer URL for a forge image embed
 `;
@@ -24401,7 +24418,7 @@ function formatTurnElapsed(ms) {
 }
 
 // ../shared/src/cli-version.ts
-var CLI_VERSION = "0.2.407";
+var CLI_VERSION = "0.2.408";
 
 // ../shared/src/version.ts
 function compareVersions(v1, v2) {
@@ -29690,9 +29707,12 @@ function mediaInfo(ext) {
   if (kind !== "image" && kind !== "video" && kind !== "audio") return void 0;
   return { kind, contentType: mimeType };
 }
+function isMediaKind(value) {
+  return MEDIA_KINDS.some((kind) => kind === value);
+}
 function resolveKind(ext, override) {
   if (override) {
-    if (!MEDIA_KINDS.includes(override)) {
+    if (!isMediaKind(override)) {
       throw new Error(`Invalid kind '${override}'. Must be one of: ${MEDIA_KINDS.join(", ")}`);
     }
     return override;
@@ -29703,7 +29723,7 @@ function resolveKind(ext, override) {
   }
   return inferred;
 }
-async function uploadOne(filePath, options) {
+async function uploadOne(filePath, displayName, options) {
   const absPath = path5.resolve(filePath);
   if (!fs4.existsSync(absPath)) {
     throw new Error(`File not found: ${absPath}`);
@@ -29723,6 +29743,7 @@ async function uploadOne(filePath, options) {
   form.append("file", new Blob([fs4.readFileSync(absPath)], { type: contentType }), fileName);
   form.append("kind", kind);
   if (options.sessionId) form.append("session_id", options.sessionId);
+  form.append("display_name", displayName);
   const { media } = await agentFetch("/v1/engine/media", {
     method: "POST",
     body: form
@@ -29733,10 +29754,19 @@ async function mediaUploadCommand(filePaths, options) {
   if (filePaths.length === 0) {
     throw new Error("No files specified");
   }
-  if (options.kind && !MEDIA_KINDS.includes(options.kind)) {
+  if (options.kind && !isMediaKind(options.kind)) {
     throw new Error(`Invalid kind '${options.kind}'. Must be one of: ${MEDIA_KINDS.join(", ")}`);
   }
-  const results = await Promise.allSettled(filePaths.map((p) => uploadOne(p, options)));
+  const names = options.name ?? [];
+  if (names.length !== filePaths.length) {
+    throw new Error(
+      `Each file needs a --name. Got ${filePaths.length} file(s) and ${names.length} --name value(s); pass one --name per file, in order.`
+    );
+  }
+  if (names.some((name) => !name.trim())) {
+    throw new Error("--name must not be empty.");
+  }
+  const results = await Promise.allSettled(filePaths.map((p, i) => uploadOne(p, names[i], options)));
   const config3 = readAgentConfig();
   const failures = [];
   for (let i = 0; i < results.length; i++) {
@@ -37267,7 +37297,12 @@ if (isAgentMode()) {
     }
   });
   const media = program.command("media").description("Share workspace media (screenshots, videos, audio) inline in chat");
-  media.command("upload <files...>").description("Upload one or more screenshot, video, or audio files. Multiple files are uploaded concurrently. Prints a markdown embed per file for the assistant reply.").option("-k, --kind <kind>", "Media kind: image, video, or audio (inferred from extension if omitted)").option("-s, --session-id <id>", "Session ID to associate the asset with").option("--share", "Create an opt-in public forge embed URL for each asset").action(async (files, options) => {
+  media.command("upload <files...>").description("Upload one or more screenshot, video, or audio files. Multiple files are uploaded concurrently. Prints a markdown embed per file for the assistant reply.").option("-k, --kind <kind>", "Media kind: image, video, or audio (inferred from extension if omitted)").option("-s, --session-id <id>", "Session ID to associate the asset with").option(
+    "-n, --name <name>",
+    "Required human-facing display name shown in the dashboard. Pass one --name per file, in order.",
+    (value, previous) => [...previous, value],
+    []
+  ).option("--share", "Create an opt-in public forge embed URL for each asset").action(async (files, options) => {
     try {
       await mediaUploadCommand(files, options);
     } catch (error51) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-cli",
-  "version": "0.2.407",
+  "version": "0.2.408",
   "description": "CLI for managing Replicas workspaces - SSH into cloud dev environments with automatic port forwarding",
   "main": "dist/index.mjs",
   "bin": {