opendevbrowser 0.0.27 → 0.0.29

package/dist/chunk-DBF5OKH3.js

@@ -0,0 +1,111 @@
+import {
+  generateSecureToken
+} from "./chunk-ASMHEEKY.js";
+import {
+  writeFileAtomic
+} from "./chunk-TBUCZX4A.js";
+
+// src/cli/templates/config.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+function buildConfigTemplate(relayToken, daemonToken) {
+  return `{
+  // OpenDevBrowser Plugin Configuration
+  // See: https://github.com/anthropics/opendevbrowser#configuration
+
+  "headless": false,
+  "profile": "default",
+  "persistProfile": true,
+
+  "snapshot": {
+    "maxChars": 16000,
+    "maxNodes": 1000
+  },
+
+  "export": {
+    "maxNodes": 1000,
+    "inlineStyles": true
+  },
+
+  "devtools": {
+    "showFullUrls": false,
+    "showFullConsole": false
+  },
+
+  "security": {
+    "allowRawCDP": false,
+    "allowNonLocalCdp": false,
+    "allowUnsafeExport": false
+  },
+
+  "skillPaths": [],
+  "skills": {
+    "nudge": {
+      "enabled": true,
+      "keywords": ["quick start", "getting started", "launch", "connect", "setup"],
+      "maxAgeMs": 60000
+    }
+  },
+
+  "continuity": {
+    "enabled": true,
+    "filePath": "opendevbrowser_continuity.md",
+    "nudge": {
+      "enabled": true,
+      "keywords": [
+        "plan",
+        "multi-step",
+        "multi step",
+        "long-running",
+        "long running",
+        "refactor",
+        "migration",
+        "rollout",
+        "release",
+        "upgrade",
+        "investigate",
+        "follow-up",
+        "continue"
+      ],
+      "maxAgeMs": 60000
+    }
+  },
+
+  "relayPort": 8787,
+  "relayToken": "${relayToken}",
+  "daemonPort": 8788,
+  "daemonToken": "${daemonToken}",
+
+  "flags": [],
+
+  "checkForUpdates": false
+}
+`;
+}
+function getPluginConfigPath(mode) {
+  if (mode === "global") {
+    const configDir = process.env.OPENCODE_CONFIG_DIR || path.join(os.homedir(), ".config", "opencode");
+    return path.join(configDir, "opendevbrowser.jsonc");
+  }
+  return path.join(process.cwd(), "opendevbrowser.jsonc");
+}
+function createPluginConfig(mode) {
+  const configPath = getPluginConfigPath(mode);
+  if (fs.existsSync(configPath)) {
+    return { created: false, path: configPath };
+  }
+  const dir = path.dirname(configPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  const relayToken = generateSecureToken();
+  const daemonToken = generateSecureToken();
+  writeFileAtomic(configPath, buildConfigTemplate(relayToken, daemonToken));
+  return { created: true, path: configPath };
+}
+
+export {
+  createPluginConfig
+};
+//# sourceMappingURL=chunk-DBF5OKH3.js.map

package/dist/chunk-DBF5OKH3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/templates/config.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport * as os from \"os\";\nimport { generateSecureToken } from \"../../utils/crypto\";\nimport { writeFileAtomic } from \"../../utils/fs\";\n\nfunction buildConfigTemplate(relayToken: string, daemonToken: string): string {\n  return `{\n  // OpenDevBrowser Plugin Configuration\n  // See: https://github.com/anthropics/opendevbrowser#configuration\n\n  \"headless\": false,\n  \"profile\": \"default\",\n  \"persistProfile\": true,\n\n  \"snapshot\": {\n    \"maxChars\": 16000,\n    \"maxNodes\": 1000\n  },\n\n  \"export\": {\n    \"maxNodes\": 1000,\n    \"inlineStyles\": true\n  },\n\n  \"devtools\": {\n    \"showFullUrls\": false,\n    \"showFullConsole\": false\n  },\n\n  \"security\": {\n    \"allowRawCDP\": false,\n    \"allowNonLocalCdp\": false,\n    \"allowUnsafeExport\": false\n  },\n\n  \"skillPaths\": [],\n  \"skills\": {\n    \"nudge\": {\n      \"enabled\": true,\n      \"keywords\": [\"quick start\", \"getting started\", \"launch\", \"connect\", \"setup\"],\n      \"maxAgeMs\": 60000\n    }\n  },\n\n  \"continuity\": {\n    \"enabled\": true,\n    \"filePath\": \"opendevbrowser_continuity.md\",\n    \"nudge\": {\n      \"enabled\": true,\n      \"keywords\": [\n        \"plan\",\n        \"multi-step\",\n        \"multi step\",\n        \"long-running\",\n        \"long running\",\n        \"refactor\",\n        \"migration\",\n        \"rollout\",\n        \"release\",\n        \"upgrade\",\n        \"investigate\",\n        \"follow-up\",\n        \"continue\"\n      ],\n      \"maxAgeMs\": 60000\n    }\n  },\n\n  \"relayPort\": 8787,\n  \"relayToken\": \"${relayToken}\",\n  \"daemonPort\": 8788,\n  \"daemonToken\": \"${daemonToken}\",\n\n  \"flags\": [],\n\n  \"checkForUpdates\": false\n}\n`;\n}\n\nexport function getPluginConfigPath(mode: \"global\" | \"local\"): string {\n  if (mode === \"global\") {\n    const configDir = process.env.OPENCODE_CONFIG_DIR\n      || path.join(os.homedir(), \".config\", \"opencode\");\n    return path.join(configDir, \"opendevbrowser.jsonc\");\n  }\n  return path.join(process.cwd(), \"opendevbrowser.jsonc\");\n}\n\nexport function createPluginConfig(mode: \"global\" | \"local\"): { created: boolean; path: string } {\n  const configPath = getPluginConfigPath(mode);\n\n  if (fs.existsSync(configPath)) {\n    return { created: false, path: configPath };\n  }\n\n  const dir = path.dirname(configPath);\n  if (!fs.existsSync(dir)) {\n    fs.mkdirSync(dir, { recursive: true });\n  }\n\n  const relayToken = generateSecureToken();\n  const daemonToken = generateSecureToken();\n  writeFileAtomic(configPath, buildConfigTemplate(relayToken, daemonToken));\n  return { created: true, path: configPath };\n}\n\nexport function getConfigTemplate(): string {\n  return buildConfigTemplate(generateSecureToken(), generateSecureToken());\n}\n"],"mappings":";;;;;;;;AAAA,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,YAAY,QAAQ;AAIpB,SAAS,oBAAoB,YAAoB,aAA6B;AAC5E,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBA+DU,UAAU;AAAA;AAAA,oBAET,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAO/B;AAEO,SAAS,oBAAoB,MAAkC;AACpE,MAAI,SAAS,UAAU;AACrB,UAAM,YAAY,QAAQ,IAAI,uBACpB,UAAQ,WAAQ,GAAG,WAAW,UAAU;AAClD,WAAY,UAAK,WAAW,sBAAsB;AAAA,EACpD;AACA,SAAY,UAAK,QAAQ,IAAI,GAAG,sBAAsB;AACxD;AAEO,SAAS,mBAAmB,MAA8D;AAC/F,QAAM,aAAa,oBAAoB,IAAI;AAE3C,MAAO,cAAW,UAAU,GAAG;AAC7B,WAAO,EAAE,SAAS,OAAO,MAAM,WAAW;AAAA,EAC5C;AAEA,QAAM,MAAW,aAAQ,UAAU;AACnC,MAAI,CAAI,cAAW,GAAG,GAAG;AACvB,IAAG,aAAU,KAAK,EAAE,WAAW,KAAK,CAAC;AAAA,EACvC;AAEA,QAAM,aAAa,oBAAoB;AACvC,QAAM,cAAc,oBAAoB;AACxC,kBAAgB,YAAY,oBAAoB,YAAY,WAAW,CAAC;AACxE,SAAO,EAAE,SAAS,MAAM,MAAM,WAAW;AAC3C;","names":[]}

package/dist/chunk-DW4TX7MU.js

@@ -0,0 +1,54 @@
+// src/cli/onboarding-metadata.json
+var sectionTitle = "Agent Quick Start";
+var sectionSummary = 'Start with opendevbrowser_prompting_guide or opendevbrowser_skill_load opendevbrowser-best-practices "quick start" before low-level browser commands, then load validated capability lanes when you need the current transcript, evidence-gated research, shopping, browser replay, desktop observation, and browser-scoped computer-use workflows.';
+var skillName = "opendevbrowser-best-practices";
+var skillTopic = "quick start";
+var validatedSkillTopic = "validated capability lanes";
+var designSkillName = "opendevbrowser-design-agent";
+var designSkillTopic = "canvas-contract";
+var localOnlyToolNames = [
+  "opendevbrowser_prompting_guide",
+  "opendevbrowser_skill_list",
+  "opendevbrowser_skill_load"
+];
+var quickStartCommands = {
+  promptingGuide: "opendevbrowser_prompting_guide",
+  skillList: "opendevbrowser_skill_list",
+  skillLoad: 'opendevbrowser_skill_load opendevbrowser-best-practices "quick start"',
+  validatedLanes: 'opendevbrowser_skill_load opendevbrowser-best-practices "validated capability lanes"',
+  validatedResearch: 'npx opendevbrowser research run --topic "Chrome extension debugging workflows" --days 30 --sources web,community --browser-mode managed --mode json --output-format json',
+  validatedShopping: 'npx opendevbrowser shopping run --query "wireless ergonomic mouse" --providers shopping/bestbuy,shopping/ebay --budget 150 --browser-mode managed --use-cookies --challenge-automation-mode browser_with_helper --mode json --output-format json',
+  computerUseEntry: 'npx opendevbrowser research run --topic "account recovery flow" --sources web,community --challenge-automation-mode browser --mode json --output-format json',
+  happyPath: "npx opendevbrowser launch --no-extension --headless --start-url https://example.com --output-format json"
+};
+var referencePaths = {
+  onboardingDoc: "docs/FIRST_RUN_ONBOARDING.md",
+  skillDoc: "skills/opendevbrowser-best-practices/SKILL.md"
+};
+var onboarding_metadata_default = {
+  sectionTitle,
+  sectionSummary,
+  skillName,
+  skillTopic,
+  validatedSkillTopic,
+  designSkillName,
+  designSkillTopic,
+  localOnlyToolNames,
+  quickStartCommands,
+  referencePaths
+};
+
+export {
+  sectionTitle,
+  sectionSummary,
+  skillName,
+  skillTopic,
+  validatedSkillTopic,
+  designSkillName,
+  designSkillTopic,
+  localOnlyToolNames,
+  quickStartCommands,
+  referencePaths,
+  onboarding_metadata_default
+};
+//# sourceMappingURL=chunk-DW4TX7MU.js.map

package/dist/chunk-DW4TX7MU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/onboarding-metadata.json"],"sourcesContent":["{\n  \"sectionTitle\": \"Agent Quick Start\",\n  \"sectionSummary\": \"Start with opendevbrowser_prompting_guide or opendevbrowser_skill_load opendevbrowser-best-practices \\\"quick start\\\" before low-level browser commands, then load validated capability lanes when you need the current transcript, evidence-gated research, shopping, browser replay, desktop observation, and browser-scoped computer-use workflows.\",\n  \"skillName\": \"opendevbrowser-best-practices\",\n  \"skillTopic\": \"quick start\",\n  \"validatedSkillTopic\": \"validated capability lanes\",\n  \"designSkillName\": \"opendevbrowser-design-agent\",\n  \"designSkillTopic\": \"canvas-contract\",\n  \"localOnlyToolNames\": [\n    \"opendevbrowser_prompting_guide\",\n    \"opendevbrowser_skill_list\",\n    \"opendevbrowser_skill_load\"\n  ],\n  \"quickStartCommands\": {\n    \"promptingGuide\": \"opendevbrowser_prompting_guide\",\n    \"skillList\": \"opendevbrowser_skill_list\",\n    \"skillLoad\": \"opendevbrowser_skill_load opendevbrowser-best-practices \\\"quick start\\\"\",\n    \"validatedLanes\": \"opendevbrowser_skill_load opendevbrowser-best-practices \\\"validated capability lanes\\\"\",\n    \"validatedResearch\": \"npx opendevbrowser research run --topic \\\"Chrome extension debugging workflows\\\" --days 30 --sources web,community --browser-mode managed --mode json --output-format json\",\n    \"validatedShopping\": \"npx opendevbrowser shopping run --query \\\"wireless ergonomic mouse\\\" --providers shopping/bestbuy,shopping/ebay --budget 150 --browser-mode managed --use-cookies --challenge-automation-mode browser_with_helper --mode json --output-format json\",\n    \"computerUseEntry\": \"npx opendevbrowser research run --topic \\\"account recovery flow\\\" --sources web,community --challenge-automation-mode browser --mode json --output-format json\",\n    \"happyPath\": \"npx opendevbrowser launch --no-extension --headless --start-url https://example.com --output-format json\"\n  },\n  \"referencePaths\": {\n    \"onboardingDoc\": \"docs/FIRST_RUN_ONBOARDING.md\",\n    \"skillDoc\": \"skills/opendevbrowser-best-practices/SKILL.md\"\n  }\n}\n"],"mappings":";AACE,mBAAgB;AAChB,qBAAkB;AAClB,gBAAa;AACb,iBAAc;AACd,0BAAuB;AACvB,sBAAmB;AACnB,uBAAoB;AACpB,yBAAsB;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AACF;AACA,yBAAsB;AAAA,EACpB,gBAAkB;AAAA,EAClB,WAAa;AAAA,EACb,WAAa;AAAA,EACb,gBAAkB;AAAA,EAClB,mBAAqB;AAAA,EACrB,mBAAqB;AAAA,EACrB,kBAAoB;AAAA,EACpB,WAAa;AACf;AACA,qBAAkB;AAAA,EAChB,eAAiB;AAAA,EACjB,UAAY;AACd;AA1BF;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAKA;AAAA,EAUA;AAIF;","names":[]}

package/dist/chunk-IPE7TF2P.js

@@ -0,0 +1,54 @@
+// src/cli/errors.ts
+var EXIT_SUCCESS = 0;
+var EXIT_USAGE = 1;
+var EXIT_EXECUTION = 2;
+var EXIT_DISCONNECTED = 10;
+var CliError = class extends Error {
+  exitCode;
+  constructor(message, exitCode) {
+    super(message);
+    this.exitCode = exitCode;
+  }
+};
+function createUsageError(message) {
+  return new CliError(message, EXIT_USAGE);
+}
+function createDisconnectedError(message) {
+  return new CliError(message, EXIT_DISCONNECTED);
+}
+function toCliError(error, fallbackExitCode = EXIT_EXECUTION) {
+  if (error instanceof CliError) {
+    return error;
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  return new CliError(message, fallbackExitCode);
+}
+function formatErrorPayload(error) {
+  return {
+    success: false,
+    error: error.message,
+    exitCode: error.exitCode
+  };
+}
+function resolveExitCode(result) {
+  if (result.exitCode === null) {
+    return null;
+  }
+  if (typeof result.exitCode === "number") {
+    return result.exitCode;
+  }
+  return result.success ? EXIT_SUCCESS : EXIT_EXECUTION;
+}
+
+export {
+  EXIT_USAGE,
+  EXIT_EXECUTION,
+  EXIT_DISCONNECTED,
+  CliError,
+  createUsageError,
+  createDisconnectedError,
+  toCliError,
+  formatErrorPayload,
+  resolveExitCode
+};
+//# sourceMappingURL=chunk-IPE7TF2P.js.map

package/dist/chunk-IPE7TF2P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/errors.ts"],"sourcesContent":["import type { CommandResult } from \"./commands/types\";\n\nexport const EXIT_SUCCESS = 0;\nexport const EXIT_USAGE = 1;\nexport const EXIT_EXECUTION = 2;\nexport const EXIT_DISCONNECTED = 10;\n\nexport class CliError extends Error {\n  exitCode: number;\n\n  constructor(message: string, exitCode: number) {\n    super(message);\n    this.exitCode = exitCode;\n  }\n}\n\nexport function createUsageError(message: string): CliError {\n  return new CliError(message, EXIT_USAGE);\n}\n\nexport function createDisconnectedError(message: string): CliError {\n  return new CliError(message, EXIT_DISCONNECTED);\n}\n\nexport function toCliError(error: unknown, fallbackExitCode = EXIT_EXECUTION): CliError {\n  if (error instanceof CliError) {\n    return error;\n  }\n  const message = error instanceof Error ? error.message : String(error);\n  return new CliError(message, fallbackExitCode);\n}\n\nexport type ErrorPayload = {\n  success: false;\n  error: string;\n  exitCode: number;\n};\n\nexport function formatErrorPayload(error: CliError): ErrorPayload {\n  return {\n    success: false,\n    error: error.message,\n    exitCode: error.exitCode\n  };\n}\n\nexport function resolveExitCode(result: CommandResult): number | null {\n  if (result.exitCode === null) {\n    return null;\n  }\n  if (typeof result.exitCode === \"number\") {\n    return result.exitCode;\n  }\n  return result.success ? EXIT_SUCCESS : EXIT_EXECUTION;\n}\n"],"mappings":";AAEO,IAAM,eAAe;AACrB,IAAM,aAAa;AACnB,IAAM,iBAAiB;AACvB,IAAM,oBAAoB;AAE1B,IAAM,WAAN,cAAuB,MAAM;AAAA,EAClC;AAAA,EAEA,YAAY,SAAiB,UAAkB;AAC7C,UAAM,OAAO;AACb,SAAK,WAAW;AAAA,EAClB;AACF;AAEO,SAAS,iBAAiB,SAA2B;AAC1D,SAAO,IAAI,SAAS,SAAS,UAAU;AACzC;AAEO,SAAS,wBAAwB,SAA2B;AACjE,SAAO,IAAI,SAAS,SAAS,iBAAiB;AAChD;AAEO,SAAS,WAAW,OAAgB,mBAAmB,gBAA0B;AACtF,MAAI,iBAAiB,UAAU;AAC7B,WAAO;AAAA,EACT;AACA,QAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,SAAO,IAAI,SAAS,SAAS,gBAAgB;AAC/C;AAQO,SAAS,mBAAmB,OAA+B;AAChE,SAAO;AAAA,IACL,SAAS;AAAA,IACT,OAAO,MAAM;AAAA,IACb,UAAU,MAAM;AAAA,EAClB;AACF;AAEO,SAAS,gBAAgB,QAAsC;AACpE,MAAI,OAAO,aAAa,MAAM;AAC5B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,OAAO,aAAa,UAAU;AACvC,WAAO,OAAO;AAAA,EAChB;AACA,SAAO,OAAO,UAAU,eAAe;AACzC;","names":[]}

package/dist/chunk-IQTJHXZJ.js

@@ -0,0 +1,126 @@
+// src/annotate/output.ts
+import { randomUUID } from "crypto";
+import { promises as fs } from "fs";
+import path from "path";
+import os from "os";
+var MAX_SCREENSHOT_BYTES = 8 * 1024 * 1024;
+var sanitizeScreenshotLabel = (label) => {
+  const safe = label.replace(/[^a-z0-9-_]+/gi, "-").slice(0, 40);
+  return safe || "annotation";
+};
+var writeAnnotationScreenshots = async (screenshots) => {
+  const results = [];
+  for (const screenshot of screenshots) {
+    if (!screenshot.base64) continue;
+    const buffer = Buffer.from(screenshot.base64, "base64");
+    if (buffer.length > MAX_SCREENSHOT_BYTES) {
+      continue;
+    }
+    const safeLabel = sanitizeScreenshotLabel(screenshot.label);
+    const fileName = `opendevbrowser-annotate-${safeLabel}-${randomUUID().slice(0, 8)}.png`;
+    const filePath = path.join(os.tmpdir(), fileName);
+    await fs.writeFile(filePath, buffer);
+    results.push({ id: screenshot.id, path: filePath });
+  }
+  return results;
+};
+var roundNumber = (value) => {
+  return Math.round(value).toString();
+};
+var formatRect = (rect) => {
+  return `x=${roundNumber(rect.x)}, y=${roundNumber(rect.y)}, w=${roundNumber(rect.width)}, h=${roundNumber(rect.height)}`;
+};
+var truncateText = (value, max) => {
+  if (value.length <= max) return value;
+  return `${value.slice(0, max)}...`;
+};
+var isSensitiveKey = (key) => {
+  const lowered = key.toLowerCase();
+  return ["password", "passwd", "token", "secret", "api-key", "apikey", "auth", "session", "csrf", "value"].some((term) => lowered.includes(term));
+};
+var looksSensitive = (value) => {
+  const trimmed = value.trim();
+  if (trimmed.length < 12) return false;
+  if (/[A-Z0-9]{20,}/.test(trimmed)) return true;
+  if (/(token|secret|apikey|password)/i.test(trimmed)) return true;
+  if (/^[A-Za-z0-9+/_-]{24,}={0,2}$/.test(trimmed)) return true;
+  return false;
+};
+var redactAnnotationItem = (item) => {
+  const attributes = {};
+  for (const [key, value] of Object.entries(item.attributes)) {
+    if (isSensitiveKey(key)) {
+      continue;
+    }
+    if (looksSensitive(value)) {
+      continue;
+    }
+    attributes[key] = value;
+  }
+  const note = item.note && looksSensitive(item.note) ? "[redacted]" : item.note;
+  const text = item.text && looksSensitive(item.text) ? "[redacted]" : item.text;
+  return {
+    ...item,
+    attributes,
+    note,
+    text
+  };
+};
+var redactAnnotationPayload = (payload) => {
+  const redacted = {
+    ...payload,
+    annotations: payload.annotations.map((item) => redactAnnotationItem(item))
+  };
+  return redacted;
+};
+var formatAnnotationMarkdown = (payload, screenshotPaths) => {
+  const screenshotIndex = new Map(screenshotPaths.map((entry) => [entry.id, entry.path]));
+  const lines = [];
+  lines.push("# Annotation Summary");
+  lines.push("");
+  lines.push(`- URL: ${payload.url}`);
+  if (payload.title) {
+    lines.push(`- Title: ${payload.title}`);
+  }
+  lines.push(`- Timestamp: ${payload.timestamp}`);
+  lines.push(`- Screenshot mode: ${payload.screenshotMode}`);
+  if (payload.context) {
+    lines.push(`- Context: ${payload.context}`);
+  }
+  lines.push("");
+  payload.annotations.forEach((annotation, index) => {
+    lines.push(`## ${index + 1}. ${annotation.tag}${annotation.idAttr ? `#${annotation.idAttr}` : ""}`);
+    if (annotation.note) {
+      lines.push(`> ${annotation.note}`);
+    }
+    lines.push(`- Selector: \`${annotation.selector}\``);
+    lines.push(`- Rect: ${formatRect(annotation.rect)}`);
+    if (annotation.a11y.role || annotation.a11y.label) {
+      lines.push(`- A11y: role=${annotation.a11y.role ?? "n/a"}, label=${annotation.a11y.label ?? "n/a"}`);
+    }
+    if (annotation.text) {
+      lines.push(`- Text: ${truncateText(annotation.text, 160)}`);
+    }
+    const shot = annotation.screenshotId ? screenshotIndex.get(annotation.screenshotId) : null;
+    if (shot) {
+      lines.push(`- Screenshot: ${shot}`);
+    }
+    lines.push("");
+  });
+  return lines.join("\n");
+};
+var buildAnnotateResult = async (payload) => {
+  const redacted = redactAnnotationPayload(payload);
+  const screenshots = await writeAnnotationScreenshots(redacted.screenshots ?? []);
+  const message = formatAnnotationMarkdown(redacted, screenshots);
+  return {
+    message,
+    details: redacted,
+    screenshots
+  };
+};
+
+export {
+  buildAnnotateResult
+};
+//# sourceMappingURL=chunk-IQTJHXZJ.js.map

package/dist/chunk-IQTJHXZJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/annotate/output.ts"],"sourcesContent":["import { randomUUID } from \"crypto\";\nimport { promises as fs } from \"fs\";\nimport path from \"path\";\nimport os from \"os\";\nimport type { AnnotationPayload, AnnotationItem, AnnotationScreenshot } from \"../relay/protocol\";\n\nconst MAX_SCREENSHOT_BYTES = 8 * 1024 * 1024;\n\nconst sanitizeScreenshotLabel = (label: string): string => {\n  const safe = label.replace(/[^a-z0-9-_]+/gi, \"-\").slice(0, 40);\n  return safe || \"annotation\";\n};\n\nconst writeAnnotationScreenshots = async (\n  screenshots: AnnotationScreenshot[]\n): Promise<Array<{ id: string; path: string }>> => {\n  const results: Array<{ id: string; path: string }> = [];\n  for (const screenshot of screenshots) {\n    if (!screenshot.base64) continue;\n    const buffer = Buffer.from(screenshot.base64, \"base64\");\n    if (buffer.length > MAX_SCREENSHOT_BYTES) {\n      continue;\n    }\n    const safeLabel = sanitizeScreenshotLabel(screenshot.label);\n    const fileName = `opendevbrowser-annotate-${safeLabel}-${randomUUID().slice(0, 8)}.png`;\n    const filePath = path.join(os.tmpdir(), fileName);\n    await fs.writeFile(filePath, buffer);\n    results.push({ id: screenshot.id, path: filePath });\n  }\n  return results;\n};\n\nconst roundNumber = (value: number): string => {\n  return Math.round(value).toString();\n};\n\nconst formatRect = (rect: AnnotationPayload[\"annotations\"][number][\"rect\"]): string => {\n  return `x=${roundNumber(rect.x)}, y=${roundNumber(rect.y)}, w=${roundNumber(rect.width)}, h=${roundNumber(rect.height)}`;\n};\n\nconst truncateText = (value: string, max: number): string => {\n  if (value.length <= max) return value;\n  return `${value.slice(0, max)}...`;\n};\n\nconst isSensitiveKey = (key: string): boolean => {\n  const lowered = key.toLowerCase();\n  return [\"password\", \"passwd\", \"token\", \"secret\", \"api-key\", \"apikey\", \"auth\", \"session\", \"csrf\", \"value\"].some((term) => lowered.includes(term));\n};\n\nconst looksSensitive = (value: string): boolean => {\n  const trimmed = value.trim();\n  if (trimmed.length < 12) return false;\n  if (/[A-Z0-9]{20,}/.test(trimmed)) return true;\n  if (/(token|secret|apikey|password)/i.test(trimmed)) return true;\n  if (/^[A-Za-z0-9+/_-]{24,}={0,2}$/.test(trimmed)) return true;\n  return false;\n};\n\nconst redactAnnotationItem = (item: AnnotationItem): AnnotationItem => {\n  const attributes: Record<string, string> = {};\n  for (const [key, value] of Object.entries(item.attributes)) {\n    if (isSensitiveKey(key)) {\n      continue;\n    }\n    if (looksSensitive(value)) {\n      continue;\n    }\n    attributes[key] = value;\n  }\n  const note = item.note && looksSensitive(item.note) ? \"[redacted]\" : item.note;\n  const text = item.text && looksSensitive(item.text) ? \"[redacted]\" : item.text;\n  return {\n    ...item,\n    attributes,\n    note,\n    text\n  };\n};\n\nconst redactAnnotationPayload = (payload: AnnotationPayload): AnnotationPayload => {\n  const redacted: AnnotationPayload = {\n    ...payload,\n    annotations: payload.annotations.map((item) => redactAnnotationItem(item))\n  };\n  return redacted;\n};\n\nconst formatAnnotationMarkdown = (\n  payload: AnnotationPayload,\n  screenshotPaths: Array<{ id: string; path: string }>\n): string => {\n  const screenshotIndex = new Map(screenshotPaths.map((entry) => [entry.id, entry.path]));\n\n  const lines: string[] = [];\n  lines.push(\"# Annotation Summary\");\n  lines.push(\"\");\n  lines.push(`- URL: ${payload.url}`);\n  if (payload.title) {\n    lines.push(`- Title: ${payload.title}`);\n  }\n  lines.push(`- Timestamp: ${payload.timestamp}`);\n  lines.push(`- Screenshot mode: ${payload.screenshotMode}`);\n  if (payload.context) {\n    lines.push(`- Context: ${payload.context}`);\n  }\n  lines.push(\"\");\n\n  payload.annotations.forEach((annotation, index) => {\n    lines.push(`## ${index + 1}. ${annotation.tag}${annotation.idAttr ? `#${annotation.idAttr}` : \"\"}`);\n    if (annotation.note) {\n      lines.push(`> ${annotation.note}`);\n    }\n    lines.push(`- Selector: \\`${annotation.selector}\\``);\n    lines.push(`- Rect: ${formatRect(annotation.rect)}`);\n    if (annotation.a11y.role || annotation.a11y.label) {\n      lines.push(`- A11y: role=${annotation.a11y.role ?? \"n/a\"}, label=${annotation.a11y.label ?? \"n/a\"}`);\n    }\n    if (annotation.text) {\n      lines.push(`- Text: ${truncateText(annotation.text, 160)}`);\n    }\n    const shot = annotation.screenshotId ? screenshotIndex.get(annotation.screenshotId) : null;\n    if (shot) {\n      lines.push(`- Screenshot: ${shot}`);\n    }\n    lines.push(\"\");\n  });\n\n  return lines.join(\"\\n\");\n};\n\nexport const buildAnnotateResult = async (\n  payload: AnnotationPayload\n): Promise<{ message: string; details: AnnotationPayload; screenshots: Array<{ id: string; path: string }> }> => {\n  const redacted = redactAnnotationPayload(payload);\n  const screenshots = await writeAnnotationScreenshots(redacted.screenshots ?? []);\n  const message = formatAnnotationMarkdown(redacted, screenshots);\n  return {\n    message,\n    details: redacted,\n    screenshots\n  };\n};\n"],"mappings":"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","names":[]}