replicas-engine 0.1.497 → 0.1.498

package/dist/src/index.js

@@ -609,7 +609,7 @@ var WORKSPACE_SIZES = ["small", "large"];
 var INVALID_WORKSPACE_SIZE_ERROR = `Invalid size: must be one of ${WORKSPACE_SIZES.join(", ")}`;
 
 // ../shared/src/e2b.ts
-var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-07-24-v5";
+var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-07-24-v6";
 
 // ../shared/src/runtime-env.ts
 function shellQuotePosix(value) {
@@ -872,7 +872,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
@@ -962,7 +962,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
 
@@ -1007,7 +1007,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\`.
 
@@ -1208,7 +1208,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
@@ -1789,10 +1789,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:
 
@@ -1804,7 +1820,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.
@@ -1974,7 +1990,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:
@@ -2028,13 +2044,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
 `;
@@ -9917,7 +9934,7 @@ var DEFAULT_CODEX_ARGS = ["app-server", "--listen", "stdio://"];
 var MIN_CODEX_CLI_VERSION = "0.144.6";
 var CODEX_UPGRADE_TIMEOUT_MS = 12e4;
 var codexCliVersionEnsured = null;
-var ENGINE_PACKAGE_VERSION = "0.1.497";
+var ENGINE_PACKAGE_VERSION = "0.1.498";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-engine",
-  "version": "0.1.497",
+  "version": "0.1.498",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",