@canaryai/cli 0.2.9 → 0.2.13

package/dist/skill-2TXI3IKP.js

@@ -0,0 +1,424 @@
+import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
+import "./chunk-VKVL7WBN.js";
+
+// src/skill-templates/issue-log-xref.ts
+var issueLogXrefTemplate = {
+  name: "issue-log-xref",
+  description: "Cross-reference Canary issues with server logs to find root causes",
+  render: () => `---
+name: issue-log-xref
+description: Cross-reference Canary QA issues with server logs to identify root causes. Use when investigating why a test failed, correlating browser errors with backend logs, or debugging issues found by Canary.
+allowed-tools: Bash(canary issues:*), Bash(canary login:*), Grep, Read
+---
+
+# Issue Log Cross-Reference
+
+Cross-reference Canary-detected issues with server logs to identify root causes, correlate errors, and provide actionable debugging context.
+
+## Prerequisites
+
+- \`canary\` CLI installed and authenticated (\`canary login\`)
+- Access to server logs (see Log Source Configuration below)
+
+## Workflow
+
+### 1. Fetch issues from Canary
+
+List recent issues to find ones worth investigating:
+
+\`\`\`bash
+canary issues list --format markdown
+\`\`\`
+
+Use filters to narrow down:
+
+\`\`\`bash
+canary issues list --severity high --status open --format markdown
+\`\`\`
+
+### 2. Get issue details
+
+Once you identify an issue, fetch its full diagnostics:
+
+\`\`\`bash
+canary issues get <issue-id> --format markdown
+\`\`\`
+
+Note the following from the issue details:
+- **Timestamps** \u2014 when the issue was detected
+- **URLs / endpoints** \u2014 which pages or API routes were involved
+- **Error messages** \u2014 any visible error text captured in screenshots or DOM
+- **HTTP status codes** \u2014 failed network requests
+
+### 3. Access server logs
+
+<!-- ============================================================
+  LOG SOURCE CONFIGURATION
+
+  Replace {{LOG_SOURCE_INSTRUCTIONS}} below with instructions
+  specific to your infrastructure. The AI agent reading this
+  skill will use these instructions to fetch logs.
+
+  Examples:
+
+  **AWS CloudWatch:**
+  Query CloudWatch Logs Insights for the relevant log group:
+  \`\`\`bash
+  aws logs filter-log-events \\
+    --log-group-name /ecs/my-api \\
+    --start-time <epoch-ms> \\
+    --end-time <epoch-ms> \\
+    --filter-pattern "<error-text>"
+  \`\`\`
+
+  **Local log files:**
+  Search local log files for matching entries:
+  \`\`\`bash
+  grep -i "<error-text>" /var/log/my-app/*.log
+  \`\`\`
+
+  **Datadog:**
+  Use the Datadog CLI or API to query logs:
+  \`\`\`bash
+  dog logs list --query "service:my-api status:error" \\
+    --from <ISO-timestamp> --to <ISO-timestamp>
+  \`\`\`
+
+  **kubectl (Kubernetes):**
+  Fetch pod logs for the relevant service:
+  \`\`\`bash
+  kubectl logs -l app=my-api --since=1h | grep "<error-text>"
+  \`\`\`
+============================================================ -->
+
+{{LOG_SOURCE_INSTRUCTIONS}}
+
+### 4. Cross-reference and correlate
+
+Match the Canary issue with log entries using these correlation points:
+
+- **Timestamps** \u2014 find log entries within a few seconds of the issue detection time
+- **Error messages** \u2014 search logs for the same error text shown in the issue
+- **HTTP status codes** \u2014 look for 4xx/5xx responses matching the failed requests
+- **URLs / routes** \u2014 filter logs by the endpoint or page path from the issue
+- **Stack traces** \u2014 identify the code path that produced the error
+- **Request IDs** \u2014 if your app uses correlation/request IDs, trace the full request lifecycle
+
+## Analysis Guidelines
+
+When presenting findings:
+
+1. **State the match confidence** \u2014 clear match, likely match, or circumstantial
+2. **Show the timeline** \u2014 lay out events in chronological order across both sources
+3. **Identify the root cause** \u2014 distinguish between the symptom (what Canary caught) and the cause (what the logs reveal)
+4. **Suggest next steps** \u2014 point to the specific code, service, or configuration that needs attention
+5. **Note gaps** \u2014 if logs are missing or incomplete, say so explicitly rather than speculating
+`
+};
+
+// src/skill-templates/browser-testing.ts
+var browserTestingTemplate = {
+  name: "browser-testing",
+  description: "Use the Canary CLI to control a browser for testing web applications",
+  render: () => `---
+name: browser-testing
+description: Control a local browser via the Canary CLI to test web applications interactively. Use when the user asks to test, browse, interact with, or verify a web application using canary browser sessions.
+allowed-tools: Bash(canary session:*), Bash(canary login:*), Read
+---
+
+# Browser Testing with Canary
+
+Use the \`canary session\` CLI to launch and control a local browser for testing web applications. You interact with pages through **snapshots** (accessibility tree + screenshot), then issue commands to click, type, navigate, and assert.
+
+## Prerequisites
+
+- \`canary\` CLI installed and authenticated (\`canary login\`)
+- Run \`canary session --help\` for the full command reference
+
+## Environments & Authentication
+
+Canary credentials are stored remotely and belong to a **property** (an app with a base URL). When the user asks you to test, determine the environment:
+
+### Remote / Deployed environments (default)
+
+Credentials are pre-configured with storage state. Just use \`--credential\` to load one:
+
+\`\`\`bash
+# Interactive picker \u2014 shows credential name, property name, and base URL
+canary session start --credential
+
+# By name
+canary session start --credential "Admin User" --url https://staging.example.com
+\`\`\`
+
+### Local development
+
+Credentials stored in Canary won't work against localhost because session cookies are bound to the remote domain. When testing a local dev server:
+
+1. **Ask the user to log in manually.** Start a session without credentials and tell them to authenticate in the browser:
+
+\`\`\`bash
+canary session start --url http://localhost:5173
+\`\`\`
+
+Then tell the user: "I've opened a browser to your local app. Please log in, and let me know when you're ready for me to continue."
+
+2. **Wait for confirmation** before proceeding with testing.
+
+3. Alternatively, if the user has a **local storage state file**, use it:
+
+\`\`\`bash
+canary session start --storage-state ./local-auth.json --url http://localhost:5173
+\`\`\`
+
+**Rule:** If the URL is localhost or 127.0.0.1, do NOT use \`--credential\` \u2014 it will download remote session state that won't work locally. Instead, prompt the user to log in.
+
+## Core Workflow
+
+The fundamental loop is: **snapshot \u2192 read \u2192 act \u2192 snapshot \u2192 verify**.
+
+### 1. Start a session
+
+\`\`\`bash
+# Start a headed browser (you can watch it)
+canary session start --url https://your-app.com
+
+# Start with a saved credential (interactive picker shows property + base URL)
+canary session start --credential
+
+# Start with a specific credential by name
+canary session start --credential "Admin User" --url https://your-app.com
+
+# Load a credential into an already-running session
+canary session load-credential
+\`\`\`
+
+### 2. Take a snapshot to see the page
+
+Snapshots are your primary way to understand what's on the page. They return an **accessibility tree** with element references (refs) and a **screenshot**.
+
+\`\`\`bash
+# Full snapshot: accessibility tree + screenshot
+canary session snapshot
+
+# Search for specific elements (fastest way to find what you need)
+canary session snapshot --search "Submit"
+canary session snapshot --search "Email|Password"
+
+# Screenshot only (useful for visual verification)
+canary session snapshot --mode screenshot
+
+# Tree only (useful when you need ref details, no image)
+canary session snapshot --mode tree
+\`\`\`
+
+**Reading snapshot output:**
+
+The accessibility tree shows elements with refs like \`[ref=e15]\`. Use these refs in subsequent commands. The tree is structured to show the page hierarchy \u2014 forms, buttons, links, headings, etc.
+
+When you use \`--search\`, matching elements are highlighted in the output and on the screenshot. Search is OR-matched and case-insensitive. Use search to **locate** elements, not to validate visual states \u2014 search overlays can obscure subtle UI changes.
+
+### 3. Interact with the page
+
+Always reference elements by their **ref** from the snapshot.
+
+\`\`\`bash
+# Click an element
+canary session click --ref e15 --element "Submit button"
+
+# Type into an input field
+canary session type --ref e7 --text "user@example.com" --element "Email input"
+
+# Type and submit (presses Enter after typing)
+canary session type --ref e7 --text "search query" --element "Search box" --submit
+
+# Fill multiple form fields at once
+canary session fill --fields '[{"ref":"e3","value":"John"},{"ref":"e4","value":"john@example.com"}]'
+
+# Select a dropdown option
+canary session select --ref e12 --value "admin" --element "Role dropdown"
+
+# Press a keyboard key
+canary session press --key Enter
+canary session press --key Escape
+canary session press --key ArrowDown
+
+# Hover to reveal hidden content (tooltips, dropdowns)
+canary session hover --ref e8 --element "User menu"
+\`\`\`
+
+### 4. Navigate
+
+\`\`\`bash
+canary session navigate --url https://your-app.com/settings
+canary session back
+\`\`\`
+
+### 5. Scroll
+
+\`\`\`bash
+# Scroll down the page
+canary session scroll --direction down
+
+# Scroll with more intensity (1-10, default 3)
+canary session scroll --direction down --amount 8
+
+# Scroll up
+canary session scroll --direction up
+\`\`\`
+
+### 6. Verify results
+
+After every action, take a snapshot to verify the result:
+
+\`\`\`bash
+# Check what happened after clicking submit
+canary session snapshot
+
+# Search for a success message
+canary session snapshot --search "Success|saved"
+
+# Check for error messages
+canary session snapshot --search "Error|failed|invalid"
+
+# Check console for JavaScript errors
+canary session console --only-errors
+
+# Check network requests for failed API calls
+canary session network
+\`\`\`
+
+## Session Management
+
+\`\`\`bash
+# List all active sessions
+canary session list
+
+# Check session details
+canary session status
+
+# Stop a session
+canary session stop
+
+# Stop all sessions
+canary session stop --all
+
+# When multiple sessions are active, specify which one
+canary session snapshot --session s1
+canary session click --ref e5 --element "Button" --session s2
+\`\`\`
+
+## Advanced Techniques
+
+### Waiting for page changes
+
+\`\`\`bash
+# Wait for text to appear (after navigation or async action)
+canary session wait --text "Dashboard loaded"
+
+# Wait for text to disappear (loading spinner)
+canary session wait --text "Loading..."
+
+# Wait a fixed time (use sparingly)
+canary session wait --time 2
+\`\`\`
+
+### Coordinate-based clicking
+
+When ref-based clicking doesn't work (overlays, canvas elements), use coordinates. First take a snapshot, look at the screenshot, estimate coordinates, then click:
+
+\`\`\`bash
+# Click at specific coordinates
+canary session click --x 450 --y 300 --element "Canvas element"
+\`\`\`
+
+### Tab management
+
+\`\`\`bash
+canary session tabs --action list
+canary session tabs --action new
+canary session tabs --action select --index 0
+canary session tabs --action close --index 1
+\`\`\`
+
+### Evaluating JavaScript
+
+\`\`\`bash
+canary session evaluate --js "() => document.title"
+canary session evaluate --js "() => window.location.href"
+canary session evaluate --js "() => document.querySelectorAll('.error').length"
+\`\`\`
+
+### Taking labeled screenshots
+
+\`\`\`bash
+# Take a labeled screenshot for later reference
+canary session screenshot --label "before-submit"
+
+# Full page screenshot
+canary session screenshot --full-page --label "full-page-state"
+\`\`\`
+
+### File downloads
+
+\`\`\`bash
+# List downloaded files
+canary session evaluate --js "() => 'trigger download'"
+# ... after download completes:
+canary session list-downloads
+canary session read-download
+\`\`\`
+
+## Testing Guidelines
+
+1. **Always snapshot after actions** \u2014 never assume an action succeeded. Take a snapshot to verify.
+2. **Use search to locate elements** \u2014 \`--search "Submit"\` is faster than scanning the full tree.
+3. **Use refs, not coordinates** \u2014 ref-based interaction is more reliable. Only fall back to coordinates when refs fail.
+4. **Check for errors** \u2014 after form submissions or navigation, check both the page content and console/network for errors.
+5. **Wait for async operations** \u2014 if an action triggers an API call, use \`wait --text\` for the expected result rather than fixed delays.
+6. **Load credentials for authenticated testing** \u2014 use \`canary session start --credential\` or \`canary session load-credential\` to test as specific users.
+7. **Report what you find** \u2014 describe what you see in snapshots, what worked, what failed, and include relevant refs or error messages.
+`
+};
+
+// src/skill-templates/index.ts
+var SKILL_TEMPLATES = {
+  "issue-log-xref": issueLogXrefTemplate,
+  "browser-testing": browserTestingTemplate
+};
+
+// src/skill.ts
+function printSkillHelp() {
+  const lines = [
+    "Usage: canary skill <name>",
+    "",
+    "Output an AI agent skill template to stdout.",
+    "Install a skill:",
+    "  mkdir -p .claude/skills/<name> && canary skill <name> > .claude/skills/<name>/SKILL.md",
+    "",
+    "Available templates:"
+  ];
+  for (const [key, template] of Object.entries(SKILL_TEMPLATES)) {
+    lines.push(`  ${key.padEnd(24)} ${template.description}`);
+  }
+  console.log(lines.join("\n"));
+}
+async function runSkill(argv) {
+  const [name] = argv;
+  if (!name || name === "help" || name === "--help" || name === "-h") {
+    printSkillHelp();
+    return;
+  }
+  const template = SKILL_TEMPLATES[name];
+  if (!template) {
+    console.error(`Unknown skill template "${name}".
+`);
+    printSkillHelp();
+    process.exit(1);
+  }
+  process.stdout.write(template.render());
+}
+export {
+  runSkill
+};
+//# sourceMappingURL=skill-2TXI3IKP.js.map

package/dist/skill-2TXI3IKP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/skill-templates/issue-log-xref.ts","../src/skill-templates/browser-testing.ts","../src/skill-templates/index.ts","../src/skill.ts"],"sourcesContent":["export type SkillTemplate = {\n  name: string;\n  description: string;\n  render: () => string;\n};\n\nexport const issueLogXrefTemplate: SkillTemplate = {\n  name: \"issue-log-xref\",\n  description:\n    \"Cross-reference Canary issues with server logs to find root causes\",\n  render: () => `---\nname: issue-log-xref\ndescription: Cross-reference Canary QA issues with server logs to identify root causes. Use when investigating why a test failed, correlating browser errors with backend logs, or debugging issues found by Canary.\nallowed-tools: Bash(canary issues:*), Bash(canary login:*), Grep, Read\n---\n\n# Issue Log Cross-Reference\n\nCross-reference Canary-detected issues with server logs to identify root causes, correlate errors, and provide actionable debugging context.\n\n## Prerequisites\n\n- \\`canary\\` CLI installed and authenticated (\\`canary login\\`)\n- Access to server logs (see Log Source Configuration below)\n\n## Workflow\n\n### 1. Fetch issues from Canary\n\nList recent issues to find ones worth investigating:\n\n\\`\\`\\`bash\ncanary issues list --format markdown\n\\`\\`\\`\n\nUse filters to narrow down:\n\n\\`\\`\\`bash\ncanary issues list --severity high --status open --format markdown\n\\`\\`\\`\n\n### 2. Get issue details\n\nOnce you identify an issue, fetch its full diagnostics:\n\n\\`\\`\\`bash\ncanary issues get <issue-id> --format markdown\n\\`\\`\\`\n\nNote the following from the issue details:\n- **Timestamps** — when the issue was detected\n- **URLs / endpoints** — which pages or API routes were involved\n- **Error messages** — any visible error text captured in screenshots or DOM\n- **HTTP status codes** — failed network requests\n\n### 3. Access server logs\n\n<!-- ============================================================\n  LOG SOURCE CONFIGURATION\n\n  Replace {{LOG_SOURCE_INSTRUCTIONS}} below with instructions\n  specific to your infrastructure. The AI agent reading this\n  skill will use these instructions to fetch logs.\n\n  Examples:\n\n  **AWS CloudWatch:**\n  Query CloudWatch Logs Insights for the relevant log group:\n  \\`\\`\\`bash\n  aws logs filter-log-events \\\\\n    --log-group-name /ecs/my-api \\\\\n    --start-time <epoch-ms> \\\\\n    --end-time <epoch-ms> \\\\\n    --filter-pattern \"<error-text>\"\n  \\`\\`\\`\n\n  **Local log files:**\n  Search local log files for matching entries:\n  \\`\\`\\`bash\n  grep -i \"<error-text>\" /var/log/my-app/*.log\n  \\`\\`\\`\n\n  **Datadog:**\n  Use the Datadog CLI or API to query logs:\n  \\`\\`\\`bash\n  dog logs list --query \"service:my-api status:error\" \\\\\n    --from <ISO-timestamp> --to <ISO-timestamp>\n  \\`\\`\\`\n\n  **kubectl (Kubernetes):**\n  Fetch pod logs for the relevant service:\n  \\`\\`\\`bash\n  kubectl logs -l app=my-api --since=1h | grep \"<error-text>\"\n  \\`\\`\\`\n============================================================ -->\n\n{{LOG_SOURCE_INSTRUCTIONS}}\n\n### 4. Cross-reference and correlate\n\nMatch the Canary issue with log entries using these correlation points:\n\n- **Timestamps** — find log entries within a few seconds of the issue detection time\n- **Error messages** — search logs for the same error text shown in the issue\n- **HTTP status codes** — look for 4xx/5xx responses matching the failed requests\n- **URLs / routes** — filter logs by the endpoint or page path from the issue\n- **Stack traces** — identify the code path that produced the error\n- **Request IDs** — if your app uses correlation/request IDs, trace the full request lifecycle\n\n## Analysis Guidelines\n\nWhen presenting findings:\n\n1. **State the match confidence** — clear match, likely match, or circumstantial\n2. **Show the timeline** — lay out events in chronological order across both sources\n3. **Identify the root cause** — distinguish between the symptom (what Canary caught) and the cause (what the logs reveal)\n4. **Suggest next steps** — point to the specific code, service, or configuration that needs attention\n5. **Note gaps** — if logs are missing or incomplete, say so explicitly rather than speculating\n`,\n};\n","type SkillTemplate = {\n  name: string;\n  description: string;\n  render: () => string;\n};\n\nexport const browserTestingTemplate: SkillTemplate = {\n  name: 'browser-testing',\n  description: 'Use the Canary CLI to control a browser for testing web applications',\n  render: () => `---\nname: browser-testing\ndescription: Control a local browser via the Canary CLI to test web applications interactively. Use when the user asks to test, browse, interact with, or verify a web application using canary browser sessions.\nallowed-tools: Bash(canary session:*), Bash(canary login:*), Read\n---\n\n# Browser Testing with Canary\n\nUse the \\`canary session\\` CLI to launch and control a local browser for testing web applications. You interact with pages through **snapshots** (accessibility tree + screenshot), then issue commands to click, type, navigate, and assert.\n\n## Prerequisites\n\n- \\`canary\\` CLI installed and authenticated (\\`canary login\\`)\n- Run \\`canary session --help\\` for the full command reference\n\n## Environments & Authentication\n\nCanary credentials are stored remotely and belong to a **property** (an app with a base URL). When the user asks you to test, determine the environment:\n\n### Remote / Deployed environments (default)\n\nCredentials are pre-configured with storage state. Just use \\`--credential\\` to load one:\n\n\\`\\`\\`bash\n# Interactive picker — shows credential name, property name, and base URL\ncanary session start --credential\n\n# By name\ncanary session start --credential \"Admin User\" --url https://staging.example.com\n\\`\\`\\`\n\n### Local development\n\nCredentials stored in Canary won't work against localhost because session cookies are bound to the remote domain. When testing a local dev server:\n\n1. **Ask the user to log in manually.** Start a session without credentials and tell them to authenticate in the browser:\n\n\\`\\`\\`bash\ncanary session start --url http://localhost:5173\n\\`\\`\\`\n\nThen tell the user: \"I've opened a browser to your local app. Please log in, and let me know when you're ready for me to continue.\"\n\n2. **Wait for confirmation** before proceeding with testing.\n\n3. Alternatively, if the user has a **local storage state file**, use it:\n\n\\`\\`\\`bash\ncanary session start --storage-state ./local-auth.json --url http://localhost:5173\n\\`\\`\\`\n\n**Rule:** If the URL is localhost or 127.0.0.1, do NOT use \\`--credential\\` — it will download remote session state that won't work locally. Instead, prompt the user to log in.\n\n## Core Workflow\n\nThe fundamental loop is: **snapshot → read → act → snapshot → verify**.\n\n### 1. Start a session\n\n\\`\\`\\`bash\n# Start a headed browser (you can watch it)\ncanary session start --url https://your-app.com\n\n# Start with a saved credential (interactive picker shows property + base URL)\ncanary session start --credential\n\n# Start with a specific credential by name\ncanary session start --credential \"Admin User\" --url https://your-app.com\n\n# Load a credential into an already-running session\ncanary session load-credential\n\\`\\`\\`\n\n### 2. Take a snapshot to see the page\n\nSnapshots are your primary way to understand what's on the page. They return an **accessibility tree** with element references (refs) and a **screenshot**.\n\n\\`\\`\\`bash\n# Full snapshot: accessibility tree + screenshot\ncanary session snapshot\n\n# Search for specific elements (fastest way to find what you need)\ncanary session snapshot --search \"Submit\"\ncanary session snapshot --search \"Email|Password\"\n\n# Screenshot only (useful for visual verification)\ncanary session snapshot --mode screenshot\n\n# Tree only (useful when you need ref details, no image)\ncanary session snapshot --mode tree\n\\`\\`\\`\n\n**Reading snapshot output:**\n\nThe accessibility tree shows elements with refs like \\`[ref=e15]\\`. Use these refs in subsequent commands. The tree is structured to show the page hierarchy — forms, buttons, links, headings, etc.\n\nWhen you use \\`--search\\`, matching elements are highlighted in the output and on the screenshot. Search is OR-matched and case-insensitive. Use search to **locate** elements, not to validate visual states — search overlays can obscure subtle UI changes.\n\n### 3. Interact with the page\n\nAlways reference elements by their **ref** from the snapshot.\n\n\\`\\`\\`bash\n# Click an element\ncanary session click --ref e15 --element \"Submit button\"\n\n# Type into an input field\ncanary session type --ref e7 --text \"user@example.com\" --element \"Email input\"\n\n# Type and submit (presses Enter after typing)\ncanary session type --ref e7 --text \"search query\" --element \"Search box\" --submit\n\n# Fill multiple form fields at once\ncanary session fill --fields '[{\"ref\":\"e3\",\"value\":\"John\"},{\"ref\":\"e4\",\"value\":\"john@example.com\"}]'\n\n# Select a dropdown option\ncanary session select --ref e12 --value \"admin\" --element \"Role dropdown\"\n\n# Press a keyboard key\ncanary session press --key Enter\ncanary session press --key Escape\ncanary session press --key ArrowDown\n\n# Hover to reveal hidden content (tooltips, dropdowns)\ncanary session hover --ref e8 --element \"User menu\"\n\\`\\`\\`\n\n### 4. Navigate\n\n\\`\\`\\`bash\ncanary session navigate --url https://your-app.com/settings\ncanary session back\n\\`\\`\\`\n\n### 5. Scroll\n\n\\`\\`\\`bash\n# Scroll down the page\ncanary session scroll --direction down\n\n# Scroll with more intensity (1-10, default 3)\ncanary session scroll --direction down --amount 8\n\n# Scroll up\ncanary session scroll --direction up\n\\`\\`\\`\n\n### 6. Verify results\n\nAfter every action, take a snapshot to verify the result:\n\n\\`\\`\\`bash\n# Check what happened after clicking submit\ncanary session snapshot\n\n# Search for a success message\ncanary session snapshot --search \"Success|saved\"\n\n# Check for error messages\ncanary session snapshot --search \"Error|failed|invalid\"\n\n# Check console for JavaScript errors\ncanary session console --only-errors\n\n# Check network requests for failed API calls\ncanary session network\n\\`\\`\\`\n\n## Session Management\n\n\\`\\`\\`bash\n# List all active sessions\ncanary session list\n\n# Check session details\ncanary session status\n\n# Stop a session\ncanary session stop\n\n# Stop all sessions\ncanary session stop --all\n\n# When multiple sessions are active, specify which one\ncanary session snapshot --session s1\ncanary session click --ref e5 --element \"Button\" --session s2\n\\`\\`\\`\n\n## Advanced Techniques\n\n### Waiting for page changes\n\n\\`\\`\\`bash\n# Wait for text to appear (after navigation or async action)\ncanary session wait --text \"Dashboard loaded\"\n\n# Wait for text to disappear (loading spinner)\ncanary session wait --text \"Loading...\"\n\n# Wait a fixed time (use sparingly)\ncanary session wait --time 2\n\\`\\`\\`\n\n### Coordinate-based clicking\n\nWhen ref-based clicking doesn't work (overlays, canvas elements), use coordinates. First take a snapshot, look at the screenshot, estimate coordinates, then click:\n\n\\`\\`\\`bash\n# Click at specific coordinates\ncanary session click --x 450 --y 300 --element \"Canvas element\"\n\\`\\`\\`\n\n### Tab management\n\n\\`\\`\\`bash\ncanary session tabs --action list\ncanary session tabs --action new\ncanary session tabs --action select --index 0\ncanary session tabs --action close --index 1\n\\`\\`\\`\n\n### Evaluating JavaScript\n\n\\`\\`\\`bash\ncanary session evaluate --js \"() => document.title\"\ncanary session evaluate --js \"() => window.location.href\"\ncanary session evaluate --js \"() => document.querySelectorAll('.error').length\"\n\\`\\`\\`\n\n### Taking labeled screenshots\n\n\\`\\`\\`bash\n# Take a labeled screenshot for later reference\ncanary session screenshot --label \"before-submit\"\n\n# Full page screenshot\ncanary session screenshot --full-page --label \"full-page-state\"\n\\`\\`\\`\n\n### File downloads\n\n\\`\\`\\`bash\n# List downloaded files\ncanary session evaluate --js \"() => 'trigger download'\"\n# ... after download completes:\ncanary session list-downloads\ncanary session read-download\n\\`\\`\\`\n\n## Testing Guidelines\n\n1. **Always snapshot after actions** — never assume an action succeeded. Take a snapshot to verify.\n2. **Use search to locate elements** — \\`--search \"Submit\"\\` is faster than scanning the full tree.\n3. **Use refs, not coordinates** — ref-based interaction is more reliable. Only fall back to coordinates when refs fail.\n4. **Check for errors** — after form submissions or navigation, check both the page content and console/network for errors.\n5. **Wait for async operations** — if an action triggers an API call, use \\`wait --text\\` for the expected result rather than fixed delays.\n6. **Load credentials for authenticated testing** — use \\`canary session start --credential\\` or \\`canary session load-credential\\` to test as specific users.\n7. **Report what you find** — describe what you see in snapshots, what worked, what failed, and include relevant refs or error messages.\n`,\n};\n","import type { SkillTemplate } from './issue-log-xref.js';\nimport { issueLogXrefTemplate } from './issue-log-xref.js';\nimport { browserTestingTemplate } from './browser-testing.js';\n\n// SkillTemplate kept file-local (defined in issue-log-xref.ts)\n\nexport const SKILL_TEMPLATES: Record<string, SkillTemplate> = {\n  'issue-log-xref': issueLogXrefTemplate,\n  'browser-testing': browserTestingTemplate,\n};\n","import { SKILL_TEMPLATES } from \"./skill-templates/index.js\";\n\nfunction printSkillHelp() {\n  const lines = [\n    \"Usage: canary skill <name>\",\n    \"\",\n    \"Output an AI agent skill template to stdout.\",\n    \"Install a skill:\",\n    \"  mkdir -p .claude/skills/<name> && canary skill <name> > .claude/skills/<name>/SKILL.md\",\n    \"\",\n    \"Available templates:\",\n  ];\n\n  for (const [key, template] of Object.entries(SKILL_TEMPLATES)) {\n    lines.push(`  ${key.padEnd(24)} ${template.description}`);\n  }\n\n  console.log(lines.join(\"\\n\"));\n}\n\nexport async function runSkill(argv: string[]) {\n  const [name] = argv;\n\n  if (!name || name === \"help\" || name === \"--help\" || name === \"-h\") {\n    printSkillHelp();\n    return;\n  }\n\n  const template = SKILL_TEMPLATES[name];\n  if (!template) {\n    console.error(`Unknown skill template \"${name}\".\\n`);\n    printSkillHelp();\n    process.exit(1);\n  }\n\n  process.stdout.write(template.render());\n}\n"],"mappings":"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","names":[]}

package/dist/{src-2WSMYBMJ.js → src-F7LQ5PY2.js}

@@ -29,6 +29,7 @@ import {
   detectModalFromYaml,
   detectPaginationInfo,
   dispatchBrowserTool,
+  dispatchConsolidatedBrowserTool,
   downsampleImage,
   ensureAllowedHost,
   estimateTextTokens,
@@ -54,6 +55,8 @@ import {
   formatSemanticSnapshot,
   getBrowserToolDefinitions,
   getBrowserToolDefinitionsWithLifecycle,
+  getConsolidatedBrowserToolDefinitions,
+  getConsolidatedBrowserToolDefinitionsWithLifecycle,
   gridInfoToRows,
   guessMimeType,
   hasDiffChanges,
@@ -73,7 +76,7 @@ import {
   sortMatchesByContext,
   withRecoveryNotice,
   withRecoveryNoticeMCP
-} from "./chunk-XGO62PO2.js";
+} from "./chunk-IFOJT3A5.js";
 import "./chunk-XAA5VQ5N.js";
 import {
   consoleLogger,
@@ -113,6 +116,7 @@ export {
   detectModalFromYaml,
   detectPaginationInfo,
   dispatchBrowserTool,
+  dispatchConsolidatedBrowserTool,
   downsampleImage,
   ensureAllowedHost,
   estimateTextTokens,
@@ -140,6 +144,8 @@ export {
   formatSemanticSnapshot,
   getBrowserToolDefinitions,
   getBrowserToolDefinitionsWithLifecycle,
+  getConsolidatedBrowserToolDefinitions,
+  getConsolidatedBrowserToolDefinitionsWithLifecycle,
   gridInfoToRows,
   guessMimeType,
   hasDiffChanges,
@@ -161,4 +167,4 @@ export {
   withRecoveryNotice,
   withRecoveryNoticeMCP
 };
-//# sourceMappingURL=src-2WSMYBMJ.js.map
+//# sourceMappingURL=src-F7LQ5PY2.js.map

package/dist/start-ZOMUD6LW.js

@@ -0,0 +1,112 @@
+import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
+import {
+  downloadStorageState,
+  fetchList,
+  promptChoice,
+  selectProperty
+} from "./chunk-BOS2YLKH.js";
+import {
+  createSession
+} from "./chunk-Z3F373YR.js";
+import {
+  resolveConfig
+} from "./chunk-ACRIE2YR.js";
+import "./chunk-XAA5VQ5N.js";
+import "./chunk-VKVL7WBN.js";
+
+// src/local/start.ts
+import process from "process";
+async function runLocalStart(argv) {
+  const config = await resolveConfig(argv);
+  const property = await selectProperty(config.apiUrl, config.token);
+  if (!property) {
+    process.exitCode = 1;
+    return;
+  }
+  const envs = await fetchList(
+    config.apiUrl,
+    config.token,
+    `/org/properties/${property.id}/environments/local`,
+    "items"
+  );
+  if (envs.length === 0) {
+    console.error("No local environments found. Run `canary local init` first.");
+    process.exitCode = 1;
+    return;
+  }
+  let selectedEnv;
+  if (envs.length === 1) {
+    selectedEnv = envs[0];
+  } else {
+    const picked = await promptChoice(
+      "Select a local environment:",
+      envs.map((e) => ({ label: `${e.name} \u2014 ${e.url}`, value: e }))
+    );
+    if (!picked) {
+      process.exitCode = 1;
+      return;
+    }
+    selectedEnv = picked;
+  }
+  const allCredentials = await fetchList(
+    config.apiUrl,
+    config.token,
+    "/org/credentials",
+    "items"
+  );
+  const envCredentials = allCredentials.filter(
+    (c) => c.propertyId === property.id
+  );
+  let storageStatePath;
+  let credentialName;
+  if (envCredentials.length > 0) {
+    let credential;
+    if (envCredentials.length === 1) {
+      credential = envCredentials[0];
+    } else {
+      const picked = await promptChoice(
+        "Select a credential:",
+        envCredentials.map((c) => ({ label: c.name, value: c }))
+      );
+      if (!picked) {
+        process.exitCode = 1;
+        return;
+      }
+      credential = picked;
+    }
+    credentialName = credential.name;
+    if (credential.storageStateS3Key) {
+      console.log("Loading saved login state...");
+      storageStatePath = await downloadStorageState({
+        apiUrl: config.apiUrl,
+        token: config.token,
+        propertyId: property.id,
+        credentialId: credential.id,
+        prefix: "local"
+      });
+    }
+  }
+  console.log(`Starting session at ${selectedEnv.url}...`);
+  const result = await createSession({
+    name: `local-${property.name}`,
+    url: selectedEnv.url,
+    storageStatePath,
+    credentialName
+  });
+  if (!result.ok || !result.data) {
+    console.error(`Failed to start session: ${result.error ?? "Unknown error"}`);
+    process.exitCode = 1;
+    return;
+  }
+  console.log(`
+Session started: ${result.data.id}`);
+  console.log(`  URL: ${selectedEnv.url}`);
+  if (credentialName) console.log(`  Credential: ${credentialName}`);
+  if (storageStatePath) console.log(`  Login state: loaded`);
+  console.log(`
+Use \`canary session\` commands to interact with the browser.`);
+}
+export {
+  runLocalStart
+};
+//# sourceMappingURL=start-ZOMUD6LW.js.map

package/dist/start-ZOMUD6LW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/local/start.ts"],"sourcesContent":["/**\n * `canary local start` — Start a headed session for a local environment.\n *\n * @module\n */\n\nimport process from 'node:process';\nimport { resolveConfig } from '../auth.js';\nimport {\n  selectProperty,\n  promptChoice,\n  fetchList,\n  downloadStorageState,\n} from '../cli-helpers.js';\nimport { createSession } from '../session/daemon-client.js';\nimport type { CredentialListItem } from '../cli-helpers.js';\n\ninterface LocalEnvironment {\n  id: string;\n  name: string;\n  url: string;\n  propertyId: string;\n}\n\nexport async function runLocalStart(argv: string[]) {\n  const config = await resolveConfig(argv);\n\n  // Select property\n  const property = await selectProperty(config.apiUrl, config.token);\n  if (!property) {\n    process.exitCode = 1;\n    return;\n  }\n\n  // Get local environments for this property\n  const envs = await fetchList<LocalEnvironment>(\n    config.apiUrl,\n    config.token,\n    `/org/properties/${property.id}/environments/local`,\n    'items'\n  );\n\n  if (envs.length === 0) {\n    console.error('No local environments found. Run `canary local init` first.');\n    process.exitCode = 1;\n    return;\n  }\n\n  let selectedEnv: LocalEnvironment;\n  if (envs.length === 1) {\n    selectedEnv = envs[0];\n  } else {\n    const picked = await promptChoice(\n      'Select a local environment:',\n      envs.map((e) => ({ label: `${e.name} — ${e.url}`, value: e }))\n    );\n    if (!picked) {\n      process.exitCode = 1;\n      return;\n    }\n    selectedEnv = picked;\n  }\n\n  // Look up credentials for this environment\n  const allCredentials = await fetchList<CredentialListItem>(\n    config.apiUrl,\n    config.token,\n    '/org/credentials',\n    'items'\n  );\n\n  const envCredentials = allCredentials.filter(\n    (c) => c.propertyId === property.id\n  );\n\n  let storageStatePath: string | undefined;\n  let credentialName: string | undefined;\n\n  if (envCredentials.length > 0) {\n    // Pick a credential if multiple\n    let credential: CredentialListItem;\n    if (envCredentials.length === 1) {\n      credential = envCredentials[0];\n    } else {\n      const picked = await promptChoice(\n        'Select a credential:',\n        envCredentials.map((c) => ({ label: c.name, value: c }))\n      );\n      if (!picked) {\n        process.exitCode = 1;\n        return;\n      }\n      credential = picked;\n    }\n\n    credentialName = credential.name;\n\n    // Download storage state if available\n    if (credential.storageStateS3Key) {\n      console.log('Loading saved login state...');\n      storageStatePath = await downloadStorageState({\n        apiUrl: config.apiUrl,\n        token: config.token,\n        propertyId: property.id,\n        credentialId: credential.id,\n        prefix: 'local',\n      });\n    }\n  }\n\n  // Create headed session\n  console.log(`Starting session at ${selectedEnv.url}...`);\n  const result = await createSession({\n    name: `local-${property.name}`,\n    url: selectedEnv.url,\n    storageStatePath,\n    credentialName,\n  });\n\n  if (!result.ok || !result.data) {\n    console.error(`Failed to start session: ${result.error ?? 'Unknown error'}`);\n    process.exitCode = 1;\n    return;\n  }\n\n  console.log(`\\nSession started: ${result.data.id}`);\n  console.log(`  URL: ${selectedEnv.url}`);\n  if (credentialName) console.log(`  Credential: ${credentialName}`);\n  if (storageStatePath) console.log(`  Login state: loaded`);\n  console.log(`\\nUse \\`canary session\\` commands to interact with the browser.`);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAMA,OAAO,aAAa;AAkBpB,eAAsB,cAAc,MAAgB;AAClD,QAAM,SAAS,MAAM,cAAc,IAAI;AAGvC,QAAM,WAAW,MAAM,eAAe,OAAO,QAAQ,OAAO,KAAK;AACjE,MAAI,CAAC,UAAU;AACb,YAAQ,WAAW;AACnB;AAAA,EACF;AAGA,QAAM,OAAO,MAAM;AAAA,IACjB,OAAO;AAAA,IACP,OAAO;AAAA,IACP,mBAAmB,SAAS,EAAE;AAAA,IAC9B;AAAA,EACF;AAEA,MAAI,KAAK,WAAW,GAAG;AACrB,YAAQ,MAAM,6DAA6D;AAC3E,YAAQ,WAAW;AACnB;AAAA,EACF;AAEA,MAAI;AACJ,MAAI,KAAK,WAAW,GAAG;AACrB,kBAAc,KAAK,CAAC;AAAA,EACtB,OAAO;AACL,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA,KAAK,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,EAAE,IAAI,WAAM,EAAE,GAAG,IAAI,OAAO,EAAE,EAAE;AAAA,IAC/D;AACA,QAAI,CAAC,QAAQ;AACX,cAAQ,WAAW;AACnB;AAAA,IACF;AACA,kBAAc;AAAA,EAChB;AAGA,QAAM,iBAAiB,MAAM;AAAA,IAC3B,OAAO;AAAA,IACP,OAAO;AAAA,IACP;AAAA,IACA;AAAA,EACF;AAEA,QAAM,iBAAiB,eAAe;AAAA,IACpC,CAAC,MAAM,EAAE,eAAe,SAAS;AAAA,EACnC;AAEA,MAAI;AACJ,MAAI;AAEJ,MAAI,eAAe,SAAS,GAAG;AAE7B,QAAI;AACJ,QAAI,eAAe,WAAW,GAAG;AAC/B,mBAAa,eAAe,CAAC;AAAA,IAC/B,OAAO;AACL,YAAM,SAAS,MAAM;AAAA,QACnB;AAAA,QACA,eAAe,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,EAAE,EAAE;AAAA,MACzD;AACA,UAAI,CAAC,QAAQ;AACX,gBAAQ,WAAW;AACnB;AAAA,MACF;AACA,mBAAa;AAAA,IACf;AAEA,qBAAiB,WAAW;AAG5B,QAAI,WAAW,mBAAmB;AAChC,cAAQ,IAAI,8BAA8B;AAC1C,yBAAmB,MAAM,qBAAqB;AAAA,QAC5C,QAAQ,OAAO;AAAA,QACf,OAAO,OAAO;AAAA,QACd,YAAY,SAAS;AAAA,QACrB,cAAc,WAAW;AAAA,QACzB,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,EACF;AAGA,UAAQ,IAAI,uBAAuB,YAAY,GAAG,KAAK;AACvD,QAAM,SAAS,MAAM,cAAc;AAAA,IACjC,MAAM,SAAS,SAAS,IAAI;AAAA,IAC5B,KAAK,YAAY;AAAA,IACjB;AAAA,IACA;AAAA,EACF,CAAC;AAED,MAAI,CAAC,OAAO,MAAM,CAAC,OAAO,MAAM;AAC9B,YAAQ,MAAM,4BAA4B,OAAO,SAAS,eAAe,EAAE;AAC3E,YAAQ,WAAW;AACnB;AAAA,EACF;AAEA,UAAQ,IAAI;AAAA,mBAAsB,OAAO,KAAK,EAAE,EAAE;AAClD,UAAQ,IAAI,UAAU,YAAY,GAAG,EAAE;AACvC,MAAI,eAAgB,SAAQ,IAAI,iBAAiB,cAAc,EAAE;AACjE,MAAI,iBAAkB,SAAQ,IAAI,uBAAuB;AACzD,UAAQ,IAAI;AAAA,8DAAiE;AAC/E;","names":[]}

package/dist/test.js

@@ -7,7 +7,7 @@ import {
   setEventLogPath,
   wrapExpect,
   wrapPage
-} from "./chunk-A44B2PEA.js";
+} from "./chunk-SYPQF57S.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/test.ts

package/dist/test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/test.ts","../src/runner/wrapper.ts"],"sourcesContent":["import * as playwright from \"@playwright/test\";\nimport { loadCanaryConfig } from \"./runner/config\";\nimport { getEventLog, markPatched, recordHealingEvent, setEventLogPath } from \"./runner/state\";\nimport { wrapPlaywright, type PlaywrightExports } from \"./runner/wrapper\";\n\nconst config = loadCanaryConfig();\nsetEventLogPath(config.eventLogPath);\ngetEventLog();\n\nconst patched = wrapPlaywright(playwright as unknown as PlaywrightExports, { debug: !!config.debug });\nmarkPatched();\n\nrecordHealingEvent({\n  kind: \"unknown\",\n  action: \"module_wrap_ready\",\n  healed: false,\n});\n\nconst {\n  test,\n  expect,\n  chromium,\n  firefox,\n  webkit,\n  devices,\n  request,\n  selectors,\n  defineConfig,\n} = patched as typeof import(\"@playwright/test\");\n\nexport { test, expect, chromium, firefox, webkit, devices, request, selectors, defineConfig };\nexport type * from \"@playwright/test\";\n","/**\n * Direct Playwright wrapper for the `canary/test` import path.\n *\n * Wraps `test`, `expect`, and the `page` fixture with healing-aware proxies.\n * Delegates all proxy/healing logic to `healing-helpers.ts`.\n */\n\nimport { recordHealingEvent } from \"./state\";\nimport {\n  wrapExpect,\n  wrapPage,\n  type PlaywrightExports,\n  type WrapOptions,\n} from \"./healing-helpers\";\n\nexport type { PlaywrightExports, WrapOptions };\n\nexport function wrapPlaywright(real: PlaywrightExports, options: WrapOptions): PlaywrightExports {\n  if ((real as { __canaryPatched?: boolean }).__canaryPatched) return real;\n\n  const patchedTest = real.test.extend({\n    page: async ({ page }, use) => {\n      recordHealingEvent({\n        kind: \"page\",\n        action: \"fixture_initialized\",\n        healed: false,\n      });\n      const wrappedPage = wrapPage(page, options);\n      await use(wrappedPage);\n    },\n  });\n\n  const patched: PlaywrightExports = {\n    ...real,\n    test: patchedTest,\n    expect: wrapExpect(real.expect, options),\n  };\n\n  (patched as { __canaryPatched?: boolean }).__canaryPatched = true;\n  if (options.debug) {\n    // eslint-disable-next-line no-console\n    console.log(`[canary][debug] playwright surface wrapped`);\n  }\n  return patched;\n}\n"],"mappings":";;;;;;;;;;;;;AAAA,YAAY,gBAAgB;;;ACiBrB,SAAS,eAAe,MAAyB,SAAyC;AAC/F,MAAK,KAAuC,gBAAiB,QAAO;AAEpE,QAAM,cAAc,KAAK,KAAK,OAAO;AAAA,IACnC,MAAM,OAAO,EAAE,KAAK,GAAG,QAAQ;AAC7B,yBAAmB;AAAA,QACjB,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV,CAAC;AACD,YAAM,cAAc,SAAS,MAAM,OAAO;AAC1C,YAAM,IAAI,WAAW;AAAA,IACvB;AAAA,EACF,CAAC;AAED,QAAMA,WAA6B;AAAA,IACjC,GAAG;AAAA,IACH,MAAM;AAAA,IACN,QAAQ,WAAW,KAAK,QAAQ,OAAO;AAAA,EACzC;AAEA,EAACA,SAA0C,kBAAkB;AAC7D,MAAI,QAAQ,OAAO;AAEjB,YAAQ,IAAI,4CAA4C;AAAA,EAC1D;AACA,SAAOA;AACT;;;ADvCA,IAAM,SAAS,iBAAiB;AAChC,gBAAgB,OAAO,YAAY;AACnC,YAAY;AAEZ,IAAM,UAAU,eAAe,YAA4C,EAAE,OAAO,CAAC,CAAC,OAAO,MAAM,CAAC;AACpG,YAAY;AAEZ,mBAAmB;AAAA,EACjB,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AACV,CAAC;AAED,IAAM;AAAA,EACJ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,IAAI;","names":["patched"]}
+{"version":3,"sources":["../src/test.ts","../src/runner/wrapper.ts"],"sourcesContent":["import * as playwright from \"@playwright/test\";\nimport { loadCanaryConfig } from \"./runner/config\";\nimport { getEventLog, markPatched, recordHealingEvent, setEventLogPath } from \"./runner/state\";\nimport { wrapPlaywright, type PlaywrightExports } from \"./runner/wrapper\";\n\nconst config = loadCanaryConfig();\nsetEventLogPath(config.eventLogPath);\ngetEventLog();\n\nconst patched = wrapPlaywright(playwright as unknown as PlaywrightExports, { debug: !!config.debug });\nmarkPatched();\n\nrecordHealingEvent({\n  kind: \"unknown\",\n  action: \"module_wrap_ready\",\n  healed: false,\n});\n\nconst {\n  test,\n  expect,\n  chromium,\n  firefox,\n  webkit,\n  devices,\n  request,\n  selectors,\n  defineConfig,\n} = patched as typeof import(\"@playwright/test\");\n\nexport { test, expect, chromium, firefox, webkit, devices, request, selectors, defineConfig };\nexport type * from \"@playwright/test\";\n","/**\n * Direct Playwright wrapper for the `canary/test` import path.\n *\n * Wraps `test`, `expect`, and the `page` fixture with healing-aware proxies.\n * Delegates all proxy/healing logic to `healing-helpers.ts`.\n */\n\nimport { recordHealingEvent } from './state';\nimport { wrapExpect, wrapPage, type PlaywrightExports, type WrapOptions } from './healing-helpers';\n\nexport type { PlaywrightExports };\n\nexport function wrapPlaywright(real: PlaywrightExports, options: WrapOptions): PlaywrightExports {\n  if ((real as { __canaryPatched?: boolean }).__canaryPatched) return real;\n\n  const patchedTest = real.test.extend({\n    page: async ({ page }, use) => {\n      recordHealingEvent({\n        kind: 'page',\n        action: 'fixture_initialized',\n        healed: false,\n      });\n      const wrappedPage = wrapPage(page, options);\n      await use(wrappedPage);\n    },\n  });\n\n  const patched: PlaywrightExports = {\n    ...real,\n    test: patchedTest,\n    expect: wrapExpect(real.expect, options),\n  };\n\n  (patched as { __canaryPatched?: boolean }).__canaryPatched = true;\n  if (options.debug) {\n    // eslint-disable-next-line no-console\n    console.log(`[canary][debug] playwright surface wrapped`);\n  }\n  return patched;\n}\n"],"mappings":";;;;;;;;;;;;;AAAA,YAAY,gBAAgB;;;ACYrB,SAAS,eAAe,MAAyB,SAAyC;AAC/F,MAAK,KAAuC,gBAAiB,QAAO;AAEpE,QAAM,cAAc,KAAK,KAAK,OAAO;AAAA,IACnC,MAAM,OAAO,EAAE,KAAK,GAAG,QAAQ;AAC7B,yBAAmB;AAAA,QACjB,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV,CAAC;AACD,YAAM,cAAc,SAAS,MAAM,OAAO;AAC1C,YAAM,IAAI,WAAW;AAAA,IACvB;AAAA,EACF,CAAC;AAED,QAAMA,WAA6B;AAAA,IACjC,GAAG;AAAA,IACH,MAAM;AAAA,IACN,QAAQ,WAAW,KAAK,QAAQ,OAAO;AAAA,EACzC;AAEA,EAACA,SAA0C,kBAAkB;AAC7D,MAAI,QAAQ,OAAO;AAEjB,YAAQ,IAAI,4CAA4C;AAAA,EAC1D;AACA,SAAOA;AACT;;;ADlCA,IAAM,SAAS,iBAAiB;AAChC,gBAAgB,OAAO,YAAY;AACnC,YAAY;AAEZ,IAAM,UAAU,eAAe,YAA4C,EAAE,OAAO,CAAC,CAAC,OAAO,MAAM,CAAC;AACpG,YAAY;AAEZ,mBAAmB;AAAA,EACjB,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AACV,CAAC;AAED,IAAM;AAAA,EACJ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,IAAI;","names":["patched"]}