@playdrop/playdrop-cli 0.12.20 → 0.12.22

package/config/client-meta.json

@@ -1,6 +1,6 @@
 {
   "version": "0.12.8",
-  "build": 13,
+  "build": 15,
   "runtimeSdkVersion": "0.12.5",
   "runtimeSdkBuild": 2,
   "clients": {

package/dist/commands/worker/instrument-evidence.d.ts

@@ -9,7 +9,7 @@ export declare function saveInstrumentEvidenceCapture(input: {
     evidenceDir: string;
     groupId: string;
     name: string;
-    screenshotId: string;
+    screenshotId?: string;
 }): Promise<InstrumentEvidenceCapture>;
 export declare function readAndValidateInstrumentEvidenceManifest(input: {
     workspaceDir: string;

package/dist/commands/worker/instrument-evidence.js

@@ -99,6 +99,35 @@ function createWorkerInstrumentScreenshotCollector(workspaceDir) {
         finish: () => chromeParser.finish() + playwrightParser.finish(),
     };
 }
+function resolveLatestUnusedScreenshotId(workspaceDir, index) {
+    const used = new Set();
+    const evidenceRoot = node_path_1.default.resolve(workspaceDir);
+    const walk = (dir) => {
+        for (const entry of (0, node_fs_1.existsSync)(dir) ? (0, node_fs_1.readdirSync)(dir, { withFileTypes: true }) : []) {
+            const entryPath = node_path_1.default.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(entryPath);
+            }
+            else if (entry.name === exports.INSTRUMENT_EVIDENCE_MANIFEST_FILE) {
+                const manifest = readJsonRecord(entryPath, 'invalid_instrument_evidence_manifest');
+                for (const capture of Object.values(manifest.captures ?? {})) {
+                    if (capture?.screenshotId) {
+                        used.add(capture.screenshotId);
+                    }
+                }
+            }
+        }
+    };
+    walk(evidenceRoot);
+    const candidates = Object.values(index.screenshots)
+        .filter((screenshot) => !used.has(screenshot.screenshotId))
+        .sort((a, b) => a.capturedAt.localeCompare(b.capturedAt));
+    const latest = candidates.at(-1);
+    if (!latest) {
+        throw new Error('instrument_screenshot_none_available');
+    }
+    return latest.screenshotId;
+}
 function normalizeEvidenceName(value) {
     const normalized = value.trim();
     if (!types_1.INSTRUMENT_EVIDENCE_NAMES.includes(normalized)) {
@@ -131,8 +160,11 @@ function readManifestIfPresent(evidenceDir) {
 async function saveInstrumentEvidenceCapture(input) {
     const evidenceName = normalizeEvidenceName(input.name);
     const groupId = normalizeGroupId(input.groupId);
-    const screenshotId = input.screenshotId.trim();
     const index = readScreenshotIndex(input.workspaceDir);
+    const requestedId = input.screenshotId?.trim() ?? '';
+    // With no id, persist the capture the judge just took: the most recent one not already used as
+    // evidence. The judge never has to track ids, and a failed capture simply is not there to pick.
+    const screenshotId = requestedId || resolveLatestUnusedScreenshotId(input.workspaceDir, index);
     const screenshot = index.screenshots[screenshotId];
     if (!screenshot) {
         throw new Error(`instrument_screenshot_not_found:${screenshotId}`);

package/dist/commands/worker.js

@@ -4892,9 +4892,10 @@ async function saveTaskEvidence(options) {
     }
     const evidenceDir = options.evidenceDir?.trim();
     const name = options.name?.trim();
+    // --screenshot-id is optional: with no id the worker persists the capture the agent just took.
     const screenshotId = options.screenshotId?.trim();
     const groupId = options.group?.trim() || (taskContext.kind === 'GAME_REVIEW' ? 'review' : '');
-    if (!evidenceDir || !name || !screenshotId || !groupId) {
+    if (!evidenceDir || !name || !groupId) {
         throw new Error('task_evidence_options_required');
     }
     const capture = await (0, instrument_evidence_1.saveInstrumentEvidenceCapture)({
@@ -4902,9 +4903,9 @@ async function saveTaskEvidence(options) {
         evidenceDir,
         groupId,
         name,
-        screenshotId,
+        ...(screenshotId ? { screenshotId } : {}),
     });
-    (0, output_1.printSuccess)(`Saved ${capture.name} evidence from Chrome screenshot ${capture.screenshotId} on controlled tab ${capture.tabId} to ${capture.fileName}.`);
+    (0, output_1.printSuccess)(`Saved ${capture.name} evidence from screenshot ${capture.screenshotId} to ${capture.fileName}.`);
 }
 const INSTRUMENT_ERROR_REASONS = new Set([
     'auth_state',

package/dist/index.js

@@ -287,9 +287,9 @@ task
 });
 task
     .command('evidence')
-    .description('Persist a Claude Chrome screenshot as task evidence')
+    .description('Persist the screenshot you just took as task evidence')
     .requiredOption('--name <name>', 'Evidence state: first-frame, core, win, or loss')
-    .requiredOption('--screenshot-id <id>', 'Claude Chrome screenshot id')
+    .option('--screenshot-id <id>', 'Screenshot id; omit to persist the capture you just took')
     .requiredOption('--evidence-dir <path>', 'Evidence output directory')
     .option('--group <id>', 'Evidence group id; required for GAME_EVAL')
     .action(async (opts) => {

package/node_modules/@playdrop/config/client-meta.json

@@ -1,6 +1,6 @@
 {
   "version": "0.12.8",
-  "build": 13,
+  "build": 15,
   "runtimeSdkVersion": "0.12.5",
   "runtimeSdkBuild": 2,
   "clients": {

package/node_modules/@playdrop/types/dist/instrument-evidence.d.ts

@@ -30,7 +30,6 @@ export declare const PLAYWRIGHT_MCP_SCREENSHOT_TOOL = "mcp__playwright__browser_
 export declare const PLAYWRIGHT_MCP_CONTROLLED_TAB_ID = 1;
 export declare const PLAYWRIGHT_MCP_SCREENSHOT_BUDGET = 100;
 export declare function isInstrumentScreenshotId(value: string): boolean;
-export declare function normalizePlaywrightScreenshotId(value: unknown): string | null;
 export declare class ClaudeChromeScreenshotStreamParser {
     private readonly onScreenshot;
     private buffer;
@@ -46,9 +45,10 @@ export declare class ClaudeChromeScreenshotStreamParser {
 export declare class PlaywrightMcpScreenshotStreamParser {
     private readonly onScreenshot;
     private buffer;
-    private readonly pendingScreenshotFilenames;
+    private readonly pendingScreenshotToolUseIds;
     private readonly handledToolUseIds;
     private screenshotCallCount;
+    private sequence;
     constructor(onScreenshot: (screenshot: ClaudeChromeScreenshot) => void);
     push(chunk: string): number;
     finish(): number;

package/node_modules/@playdrop/types/dist/instrument-evidence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrument-evidence.d.ts","sourceRoot":"","sources":["../src/instrument-evidence.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,iDAK5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,YAAY,GAAG,WAAW,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,YAAY,GAAG,WAAW,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,yBAAyB,CAAC,CAAC,CAAC;CAC9E,CAAC;AAMF,eAAO,MAAM,8BAA8B,6CAA6C,CAAC;AACzF,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAGlD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAKpD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG7E;AA+CD,qBAAa,kCAAkC;IAKjC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJzC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA+B;IACzE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqB;gBAE7B,YAAY,EAAE,CAAC,UAAU,EAAE,sBAAsB,KAAK,IAAI;IAEvF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAqB3B,MAAM,IAAI,MAAM;IAMhB,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,iBAAiB;CAiE1B;AAMD,qBAAa,mCAAmC;IAMlC,OAAO,CAAC,QAAQ,CAAC,YAAY;IALzC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAA6B;IACxE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqB;IACvD,OAAO,CAAC,mBAAmB,CAAK;gBAEH,YAAY,EAAE,CAAC,UAAU,EAAE,sBAAsB,KAAK,IAAI;IAEvF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAqB3B,MAAM,IAAI,MAAM;IAMhB,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,iBAAiB;CA+C1B"}
+{"version":3,"file":"instrument-evidence.d.ts","sourceRoot":"","sources":["../src/instrument-evidence.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,iDAK5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,YAAY,GAAG,WAAW,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,YAAY,GAAG,WAAW,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,yBAAyB,CAAC,CAAC,CAAC;CAC9E,CAAC;AAMF,eAAO,MAAM,8BAA8B,6CAA6C,CAAC;AACzF,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAGlD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAKpD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/D;AAiDD,qBAAa,kCAAkC;IAKjC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJzC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA+B;IACzE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqB;gBAE7B,YAAY,EAAE,CAAC,UAAU,EAAE,sBAAsB,KAAK,IAAI;IAEvF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAqB3B,MAAM,IAAI,MAAM;IAMhB,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,iBAAiB;CAiE1B;AAMD,qBAAa,mCAAmC;IAOlC,OAAO,CAAC,QAAQ,CAAC,YAAY;IANzC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAqB;IACjE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqB;IACvD,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAK;gBAEQ,YAAY,EAAE,CAAC,UAAU,EAAE,sBAAsB,KAAK,IAAI;IAEvF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAqB3B,MAAM,IAAI,MAAM;IAMhB,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,iBAAiB;CA+C1B"}

package/node_modules/@playdrop/types/dist/instrument-evidence.js

@@ -23,8 +23,7 @@ __export(instrument_evidence_exports, {
   PLAYWRIGHT_MCP_SCREENSHOT_BUDGET: () => PLAYWRIGHT_MCP_SCREENSHOT_BUDGET,
   PLAYWRIGHT_MCP_SCREENSHOT_TOOL: () => PLAYWRIGHT_MCP_SCREENSHOT_TOOL,
   PlaywrightMcpScreenshotStreamParser: () => PlaywrightMcpScreenshotStreamParser,
-  isInstrumentScreenshotId: () => isInstrumentScreenshotId,
-  normalizePlaywrightScreenshotId: () => normalizePlaywrightScreenshotId
+  isInstrumentScreenshotId: () => isInstrumentScreenshotId
 });
 module.exports = __toCommonJS(instrument_evidence_exports);
 const INSTRUMENT_EVIDENCE_NAMES = [
@@ -39,14 +38,10 @@ const MAX_STREAM_LINE_LENGTH = 20 * 1024 * 1024;
 const PLAYWRIGHT_MCP_SCREENSHOT_TOOL = "mcp__playwright__browser_take_screenshot";
 const PLAYWRIGHT_MCP_CONTROLLED_TAB_ID = 1;
 const PLAYWRIGHT_MCP_SCREENSHOT_BUDGET = 100;
-const PLAYWRIGHT_SCREENSHOT_ID_PATTERN = /^[a-z0-9][a-z0-9._-]{0,63}\.(png|jpe?g)$/;
+const PLAYWRIGHT_SCREENSHOT_ID_PATTERN = /^pw-[1-9][0-9]*$/;
 function isInstrumentScreenshotId(value) {
   return SCREENSHOT_ID_PATTERN.test(value) || PLAYWRIGHT_SCREENSHOT_ID_PATTERN.test(value);
 }
-function normalizePlaywrightScreenshotId(value) {
-  const id = typeof value === "string" ? value.trim().toLowerCase() : "";
-  return PLAYWRIGHT_SCREENSHOT_ID_PATTERN.test(id) ? id : null;
-}
 function asRecord(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
@@ -228,9 +223,10 @@ class ClaudeChromeScreenshotStreamParser {
 class PlaywrightMcpScreenshotStreamParser {
   onScreenshot;
   buffer = "";
-  pendingScreenshotFilenames = /* @__PURE__ */ new Map();
+  pendingScreenshotToolUseIds = /* @__PURE__ */ new Set();
   handledToolUseIds = /* @__PURE__ */ new Set();
   screenshotCallCount = 0;
+  sequence = 0;
   constructor(onScreenshot) {
     this.onScreenshot = onScreenshot;
   }
@@ -298,12 +294,7 @@ class PlaywrightMcpScreenshotStreamParser {
       if (this.screenshotCallCount > PLAYWRIGHT_MCP_SCREENSHOT_BUDGET) {
         throw new Error(`playwright_screenshot_budget_exceeded:${PLAYWRIGHT_MCP_SCREENSHOT_BUDGET}`);
       }
-      const input = asRecord(item?.["input"]);
-      const filename = normalizePlaywrightScreenshotId(input?.["filename"]);
-      if (!filename) {
-        continue;
-      }
-      this.pendingScreenshotFilenames.set(id, filename);
+      this.pendingScreenshotToolUseIds.add(id);
     }
   }
   recordToolResults(payload) {
@@ -316,12 +307,11 @@ class PlaywrightMcpScreenshotStreamParser {
         continue;
       }
       const toolUseId = typeof toolResult["tool_use_id"] === "string" ? toolResult["tool_use_id"].trim() : "";
-      const screenshotId = this.pendingScreenshotFilenames.get(toolUseId);
-      if (!screenshotId || this.handledToolUseIds.has(toolUseId)) {
+      if (!this.pendingScreenshotToolUseIds.has(toolUseId) || this.handledToolUseIds.has(toolUseId)) {
         continue;
       }
       this.handledToolUseIds.add(toolUseId);
-      this.pendingScreenshotFilenames.delete(toolUseId);
+      this.pendingScreenshotToolUseIds.delete(toolUseId);
       const resultContent = Array.isArray(toolResult["content"]) ? toolResult["content"] : [];
       const images = resultContent.map(asRecord).filter((item) => item?.["type"] === "image");
       if (images.length === 0) {
@@ -336,8 +326,9 @@ class PlaywrightMcpScreenshotStreamParser {
       if (mediaType !== "image/jpeg" && mediaType !== "image/png" || !dataBase64) {
         throw new Error(`invalid_playwright_screenshot_payload:${toolUseId}`);
       }
+      this.sequence += 1;
       this.onScreenshot({
-        screenshotId,
+        screenshotId: `pw-${this.sequence}`,
         tabId: PLAYWRIGHT_MCP_CONTROLLED_TAB_ID,
         toolUseId,
         mediaType,
@@ -358,6 +349,5 @@ class PlaywrightMcpScreenshotStreamParser {
   PLAYWRIGHT_MCP_SCREENSHOT_BUDGET,
   PLAYWRIGHT_MCP_SCREENSHOT_TOOL,
   PlaywrightMcpScreenshotStreamParser,
-  isInstrumentScreenshotId,
-  normalizePlaywrightScreenshotId
+  isInstrumentScreenshotId
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playdrop/playdrop-cli",
-  "version": "0.12.20",
+  "version": "0.12.22",
   "description": "Official Playdrop CLI for publishing browser games, creator apps, and AI-generated game assets on playdrop.ai",
   "homepage": "https://www.playdrop.ai",
   "repository": {