@empiricalrun/test-gen 0.79.2 → 0.79.4

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @empiricalrun/test-gen
 
+## 0.79.4
+
+### Patch Changes
+
+- dc2e6c9: feat: dashboard api client upgrade
+
+## 0.79.3
+
+### Patch Changes
+
+- Updated dependencies [92254ba]
+  - @empiricalrun/r2-uploader@0.9.1
+  - @empiricalrun/test-run@0.14.2
+
 ## 0.79.2
 
 ### Patch Changes

package/dist/agent/chat/exports.d.ts

@@ -6,6 +6,7 @@ export type { AgentParams, OnToolCallCallback } from "../base";
 export { BaseAgent } from "../base";
 export type { CodeReviewResultV0, CodeReviewResultV1, CodeReviewResultV2, CodeReviewVersionedResult, } from "../code-review";
 export { CodeReviewAgent } from "../code-review";
+export { FastTriageAgent } from "../fast-triage";
 export { TriageAgent } from "../triage";
 export { ChatAgent } from "./index";
 export { fetchToolCallFromId, getLatestDownloadBuildUrl, LATEST_CHAT_STATE_VERSION, } from "./state";

package/dist/agent/chat/exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/exports.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/exports.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/agent/chat/exports.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractAttachments = exports.LATEST_CHAT_STATE_VERSION = exports.getLatestDownloadBuildUrl = exports.fetchToolCallFromId = exports.ChatAgent = exports.TriageAgent = exports.CodeReviewAgent = exports.BaseAgent = exports.viewFileUsingGitHub = exports.getFileInfoFromGitHub = exports.SUPPORTED_CHAT_MODELS = exports.createChatModel = void 0;
+exports.extractAttachments = exports.LATEST_CHAT_STATE_VERSION = exports.getLatestDownloadBuildUrl = exports.fetchToolCallFromId = exports.ChatAgent = exports.TriageAgent = exports.FastTriageAgent = exports.CodeReviewAgent = exports.BaseAgent = exports.viewFileUsingGitHub = exports.getFileInfoFromGitHub = exports.SUPPORTED_CHAT_MODELS = exports.createChatModel = void 0;
 var chat_1 = require("@empiricalrun/llm/chat");
 Object.defineProperty(exports, "createChatModel", { enumerable: true, get: function () { return chat_1.createChatModel; } });
 var constants_1 = require("@empiricalrun/llm/chat/constants");
@@ -12,6 +12,8 @@ var base_1 = require("../base");
 Object.defineProperty(exports, "BaseAgent", { enumerable: true, get: function () { return base_1.BaseAgent; } });
 var code_review_1 = require("../code-review");
 Object.defineProperty(exports, "CodeReviewAgent", { enumerable: true, get: function () { return code_review_1.CodeReviewAgent; } });
+var fast_triage_1 = require("../fast-triage");
+Object.defineProperty(exports, "FastTriageAgent", { enumerable: true, get: function () { return fast_triage_1.FastTriageAgent; } });
 var triage_1 = require("../triage");
 Object.defineProperty(exports, "TriageAgent", { enumerable: true, get: function () { return triage_1.TriageAgent; } });
 var index_1 = require("./index");

package/dist/agent/chat/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAapE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAKpC,qBAAa,SAAS,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAC5C,SAAS,CAAC,QAAQ,IAAI,WAAW;IAiB3B,iBAAiB,CACrB,eAAe,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;CAsGnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAsBpE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMpC,qBAAa,SAAS,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAC5C,SAAS,CAAC,QAAQ,IAAI,WAAW;IA0B3B,iBAAiB,CACrB,eAAe,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;CAyGnB"}

package/dist/agent/chat/index.js

@@ -3,32 +3,49 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChatAgent = void 0;
 const tools_1 = require("../../tools");
 const analyse_video_1 = require("../../tools/definitions/analyse-video");
+const download_build_1 = require("../../tools/definitions/download-build");
+const grep_1 = require("../../tools/definitions/grep");
+const list_tests_and_projects_1 = require("../../tools/definitions/list-tests-and-projects");
+const run_test_1 = require("../../tools/definitions/run-test");
 const diagnosis_fetcher_1 = require("../../tools/diagnosis-fetcher");
+const fetch_file_1 = require("../../tools/fetch-file");
+const list_environments_1 = require("../../tools/list-environments");
 const test_run_fetcher_1 = require("../../tools/test-run-fetcher");
 const base_1 = require("../base");
 const pw_utils_docs_1 = require("./prompt/pw-utils-docs");
 const repo_1 = require("./prompt/repo");
 const test_case_def_1 = require("./prompt/test-case-def");
+const trace_utils_docs_1 = require("./prompt/trace-utils-docs");
 class ChatAgent extends base_1.BaseAgent {
     getTools() {
         const custom = [
             analyse_video_1.analyseVideo,
-            ...tools_1.commonTools,
+            run_test_1.runTestTool,
+            grep_1.grepTool,
+            list_environments_1.listEnvironmentsTool,
+            download_build_1.downloadBuildTool,
+            fetch_file_1.fetchFileTool,
+            list_tests_and_projects_1.listProjectsTool,
+            list_tests_and_projects_1.listTestsForProjectTool,
             ...tools_1.testGenerationTools,
             test_run_fetcher_1.fetchTestRunDetailsTool,
             diagnosis_fetcher_1.fetchDiagnosisReportTool,
             ...(0, tools_1.textEditorToolsForModel)(this.selectedModel),
-            ...(this.featureFlags.includes("useSafeBash") ? [tools_1.safeBashTool] : []),
-            ...(this.featureFlags.includes("useScrapeHtml") ? [tools_1.scrapeHtmlTool] : []),
+            tools_1.safeBashTool,
+            ...(!(0, tools_1.hasBuiltInWebFetch)(this.selectedModel) ? [tools_1.scrapeHtmlTool] : []),
         ];
         return {
             custom,
             builtInTextEditor: (0, tools_1.hasBuiltInTextEditor)(this.selectedModel),
+            builtInWebFetch: (0, tools_1.hasBuiltInWebFetch)(this.selectedModel)
+                ? { enabled: true, max_uses: 1 }
+                : undefined,
         };
     }
     async buildSystemPrompt(repoInfoBuilder) {
         const repoInfo = await repoInfoBuilder();
         const repoContext = await (0, repo_1.getRepoContextPrompt)(repoInfo);
+        const hasTraceUtils = this.featureFlags.includes("enableTraceUtilsViaBash");
         const preamble = `
 You are a helpful assistant that can answer questions and help with tasks related to writing and maintaining Playwright tests.
 
@@ -121,6 +138,8 @@ ${test_case_def_1.testCasesDefinitionPrompt}
 # Recipes
 ${pw_utils_docs_1.playwrightUtilsDocs}
 
+${trace_utils_docs_1.traceUtilsDoc}
+
 # Repo context
 ${repoContext}
 

package/dist/agent/chat/prompt/pw-utils-docs.d.ts

@@ -1,2 +1,2 @@
-export declare const playwrightUtilsDocs = "\nYou can refer to the following recipes to learn how to write tests for different scenarios.\n\n<email-automation>\n\n# Email automation\n\n## Example usage\n\n### Dynamic email\n\nThis dynamically generates a random email address that can \nbe used for the test (e.g. invite a new user).\n\n```ts\nimport { EmailClient } from \"@empiricalrun/playwright-utils\";\nimport { expect } from \"@playwright/test\";\n\nconst client = new EmailClient();\nconst address = client.getAddress();\n\n// Input the `address` in the application\n// that sends the email.\n\n// Get email received on the `address`\nconst email = await client.waitForEmail();\nexpect(\n  email.links.find((l) => l.text === \"Join your team\")\n).toBeTruthy();\n```\n\n### Static email\n\nThis uses a known (static) email that can be used to login\ninto an application.\n\nThis needs an email id (e.g. `test-login-user`). The email id\nis appended with the domain (managed internally) to get the full\nemail address.\n\n```ts\nimport { EmailClient } from \"@empiricalrun/playwright-utils\";\n\nconst emailId = `test-login-user`;\n\nconst client = new EmailClient({ emailId });\nconst address = client.getAddress(); // Returns full address with domain\n\n// Get email received on the `address`\nconst email = await client.waitForEmail();\n\n// Get login OTP\nconst loginCode = email.codes[0];\n```\n\n</email-automation>\n\n<fixtures>\n\nThe playwright-utils package provides fixtures that wrap around Playwright's built-in\n`page`, `context` fixtures to provide a mouse highlighter (which makes it easier to\nsee actions taken in a video).\n\nTo use this, you can use the `baseTestFixture` and `extendExpect` imports\nin your fixtures file.\n\n```ts\nimport { test as base, expect as baseExpect } from \"@playwright/test\";\nimport { baseTestFixture, extendExpect } from \"@empiricalrun/playwright-utils/test\";\n\nexport const test = baseTestFixture(base);\nexport const expect = extendExpect(baseExpect);\n```\n\n### Get a new browser context\n\nThis package provides a fixture `customContextPageProvider` which is a good way to create\na fresh, new browser context, and a page inside it.\n\nThere are two benefits of using this to create contexts or pages:\n1. Videos get recorded and attached to the test report\n2. Mouse highlights are available\n\n```ts\nimport { test, expect } from \"./fixtures\";\n\ntest(\"Example test\", async ({ page: builtInPage, customContextPageProvider }) => {\n  // builtInPage is from default browser context\n  const { page: newPage, context } = await customContextPageProvider();\n  // newPage is from this other browser context\n});\n```\n\ncustomContextPageProvider can accept options to customize the browser context.\n\n```\n  customContextPageProvider: (\n    options?: BrowserContextOptions,\n  ) => Promise<{ context: BrowserContext; page: Page }>;\n```\n\nFor example, pass { storageState: undefined } to create a new browser context without\nthe auth state of the current browser context. This is useful for multi-user scenarios.\n\n</fixtures>\n\n<video-labels>\n\n# Video Labels\n\nPages generate video recordings after test execution, with 1 page generating 1 video file (webm). \n\nIf your test case relies on multiple pages (e.g. for multi-user or multi-app flows), it can get difficult to\nknow which page does \"video-1.webm\" belong to.\n\nTo solve this, you should set video labels for pages. This will enable you to identify videos faster.\n\n## Usage\n\n```typescript\nimport { setVideoLabel } from '@empiricalrun/playwright-utils/test';\n\ntest('my test', async ({ page }) => {\n  setVideoLabel(page, 'checkout-flow');\n  // Video will be saved as 'checkout-flow.webm'\n});\n```\n\n## Multiple Contexts\n\n```typescript\ntest('multi-user scenario', async ({ page, customContextPageProvider }) => {\n  setVideoLabel(page, 'host-page');\n\n  const { page: guestPage } = await customContextPageProvider({ storageState: undefined });\n  setVideoLabel(guestPage, 'guest-page');\n  // Videos saved as 'guest-page.webm' and 'host-page.webm'\n});\n```\n\n## Notes\n\n- The default behavior is to label videos for multiple pages as: `video-0.webm`, `video-1.webm`, etc.\n- If setVideoLabel is called twice for the same page, the last label will be set\n\n</video-labels>\n\n";
+export declare const playwrightUtilsDocs = "\nYou can refer to the following recipes to learn how to write or diagnose tests for different scenarios.\n\n<email-automation>\n\n# Email automation\n\n## Example usage\n\n### Dynamic email\n\nThis dynamically generates a random email address that can \nbe used for the test (e.g. invite a new user).\n\n```ts\nimport { EmailClient } from \"@empiricalrun/playwright-utils\";\nimport { expect } from \"@playwright/test\";\n\nconst client = new EmailClient();\nconst address = client.getAddress();\n\n// Input the `address` in the application\n// that sends the email.\n\n// Get email received on the `address`\nconst email = await client.waitForEmail();\nexpect(\n  email.links.find((l) => l.text === \"Join your team\")\n).toBeTruthy();\n```\n\n### Static email\n\nThis uses a known (static) email that can be used to login\ninto an application.\n\nThis needs an email id (e.g. `test-login-user`). The email id\nis appended with the domain (managed internally) to get the full\nemail address.\n\n```ts\nimport { EmailClient } from \"@empiricalrun/playwright-utils\";\n\nconst emailId = `test-login-user`;\n\nconst client = new EmailClient({ emailId });\nconst address = client.getAddress(); // Returns full address with domain\n\n// Get email received on the `address`\nconst email = await client.waitForEmail();\n\n// Get login OTP\nconst loginCode = email.codes[0];\n```\n\n</email-automation>\n\n<fixtures>\n\nThe playwright-utils package provides fixtures that wrap around Playwright's built-in\n`page`, `context` fixtures to provide a mouse highlighter (which makes it easier to\nsee actions taken in a video).\n\nTo use this, you can use the `baseTestFixture` and `extendExpect` imports\nin your fixtures file.\n\n```ts\nimport { test as base, expect as baseExpect } from \"@playwright/test\";\nimport { baseTestFixture, extendExpect } from \"@empiricalrun/playwright-utils/test\";\n\nexport const test = baseTestFixture(base);\nexport const expect = extendExpect(baseExpect);\n```\n\n### Get a new browser context\n\nThis package provides a fixture `customContextPageProvider` which is a good way to create\na fresh, new browser context, and a page inside it.\n\nThere are two benefits of using this to create contexts or pages:\n1. Videos get recorded and attached to the test report\n2. Mouse highlights are available\n\n```ts\nimport { test, expect } from \"./fixtures\";\n\ntest(\"Example test\", async ({ page: builtInPage, customContextPageProvider }) => {\n  // builtInPage is from default browser context\n  const { page: newPage, context } = await customContextPageProvider();\n  // newPage is from this other browser context\n});\n```\n\ncustomContextPageProvider can accept options to customize the browser context.\n\n```\n  customContextPageProvider: (\n    options?: BrowserContextOptions,\n  ) => Promise<{ context: BrowserContext; page: Page }>;\n```\n\nFor example, pass { storageState: undefined } to create a new browser context without\nthe auth state of the current browser context. This is useful for multi-user scenarios.\n\n</fixtures>\n\n<video-labels>\n\n# Video Labels\n\nPages generate video recordings after test execution, with 1 page generating 1 video file (webm). \n\nIf your test case relies on multiple pages (e.g. for multi-user or multi-app flows), it can get difficult to\nknow which page does \"video-1.webm\" belong to.\n\nTo solve this, you should set video labels for pages. This will enable you to identify videos faster.\n\n## Usage\n\n```typescript\nimport { setVideoLabel } from '@empiricalrun/playwright-utils/test';\n\ntest('my test', async ({ page }) => {\n  setVideoLabel(page, 'checkout-flow');\n  // Video will be saved as 'checkout-flow.webm'\n});\n```\n\n## Multiple Contexts\n\n```typescript\ntest('multi-user scenario', async ({ page, customContextPageProvider }) => {\n  setVideoLabel(page, 'host-page');\n\n  const { page: guestPage } = await customContextPageProvider({ storageState: undefined });\n  setVideoLabel(guestPage, 'guest-page');\n  // Videos saved as 'guest-page.webm' and 'host-page.webm'\n});\n```\n\n## Notes\n\n- The default behavior is to label videos for multiple pages as: `video-0.webm`, `video-1.webm`, etc.\n- If setVideoLabel is called twice for the same page, the last label will be set\n\n</video-labels>\n\n";
 //# sourceMappingURL=pw-utils-docs.d.ts.map

package/dist/agent/chat/prompt/pw-utils-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pw-utils-docs.d.ts","sourceRoot":"","sources":["../../../../src/agent/chat/prompt/pw-utils-docs.ts"],"names":[],"mappings":"AA4IA,eAAO,MAAM,mBAAmB,qsIAe/B,CAAC"}
+{"version":3,"file":"pw-utils-docs.d.ts","sourceRoot":"","sources":["../../../../src/agent/chat/prompt/pw-utils-docs.ts"],"names":[],"mappings":"AA4IA,eAAO,MAAM,mBAAmB,itIAe/B,CAAC"}

package/dist/agent/chat/prompt/pw-utils-docs.js

@@ -139,7 +139,7 @@ test('multi-user scenario', async ({ page, customContextPageProvider }) => {
 - If setVideoLabel is called twice for the same page, the last label will be set
 `;
 exports.playwrightUtilsDocs = `
-You can refer to the following recipes to learn how to write tests for different scenarios.
+You can refer to the following recipes to learn how to write or diagnose tests for different scenarios.
 
 <email-automation>
 ${emailRecipe}

package/dist/agent/chat/prompt/repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../../../src/agent/chat/prompt/repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAuD/D,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,mBA2B5D"}
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../../../src/agent/chat/prompt/repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAuD/D,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,mBA4B5D"}

package/dist/agent/chat/prompt/repo.js

@@ -56,9 +56,10 @@ Here is the repo directory structure:
 
 ${(0, repo_tree_1.generateAsciiTree)(repoInfo)}
 
-While specifying paths to files, use relative paths from the current working directory. For example:
-- Correct path: "tests/lesson.spec.ts"
-- Incorrect path: "/repo/tests/lesson.spec.ts" or "${repoInfo.name}/tests/lesson.spec.ts"
+While specifying paths to files, prefer using absolute paths with the /repo/ prefix. Both absolute and relative paths are supported. For example:
+- Preferred: "/repo/tests/lesson.spec.ts" (absolute path with /repo/ prefix)
+- Also supported: "tests/lesson.spec.ts" (relative path from repository root)
+- Incorrect: "/${repoInfo.name}/tests/lesson.spec.ts" (wrong prefix)
 `;
     const knowledge = await knowledgeContext(repoInfo);
     if (knowledge.length > 0) {

package/dist/agent/chat/prompt/trace-utils-docs.d.ts

@@ -0,0 +1,2 @@
+export declare const traceUtilsDoc = "\n<trace-utils-cli>\n# Trace Utils\n\nCLI and library for inspecting Playwright `trace.zip` files.\n\n## Usage\n\nVia sandbox-cli:\n```bash\nsandbox-cli trace-utils <command> [options]\n```\n\n---\n\n## `steps`\n\nList all test steps from a trace.\n\n```bash\nsandbox-cli trace-utils steps --file <path> [--json]\n```\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| `--file` | Path or URL to trace.zip | *required* |\n| `--json` | Output as JSON | `false` |\n\n---\n\n## `screenshots`\n\nExtract screenshots from a trace. Use either `--step` or `--start`/`--end` (one is required).\n\n```bash\n# By step ID\nsandbox-cli trace-utils screenshots --file <path> --step <id> [options]\n\n# By time range\nsandbox-cli trace-utils screenshots --file <path> --start <time> --end <time> [options]\n```\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| `--file` | Path or URL to trace.zip | *required* |\n| `--step` | Step callId to extract around | - |\n| `--start` | Start time (HH:MM:SS.mmm) | - |\n| `--end` | End time (HH:MM:SS.mmm) | - |\n| `--page` | Page ID to filter by (required for multi-page traces with time-based extraction) | - |\n| `--before` | Milliseconds before step (only with --step) | `2000` |\n| `--after` | Milliseconds after step (only with --step) | `2000` |\n| `--max` | Maximum screenshots | `10` |\n| `--output` | Output directory | auto-generated in `/tmp` |\n\n**Examples:**\n\n```bash\n# 1. List steps to find callId or timestamps\nsandbox-cli trace-utils steps --file ./trace.zip\n\n# Output:\n# [test.step@36] locator.click(getByRole('button', { name: 'Create' })) (page@abc123)\n#   00:02:06.434 \u2192 00:02:06.543 (110ms)\n\n# 2a. Extract by step ID\nsandbox-cli trace-utils screenshots --file ./trace.zip --step \"test.step@36\"\n\n# 2b. Extract by time range (for multi-page traces, --page is required)\nsandbox-cli trace-utils screenshots --file ./trace.zip --start 00:02:06.000 --end 00:02:07.000 --page \"page@abc123\"\n```\n\n---\n\n## `network`\n\nSearch network requests. For multi-page traces, either `--step` or `--page` is required.\n\n```bash\nsandbox-cli trace-utils network --file <path> [filters] [options]\n```\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| `--file` | Path or URL to trace.zip | *required* |\n| `--step <callId>` | Filter to requests during a specific step | - |\n| `--page` | Page ID to filter by (required for multi-page traces without --step) | - |\n| `--before <ms>` | Time before step to include (with --step) | `2000` |\n| `--after <ms>` | Time after step to include (with --step) | `2000` |\n| `--errors` | Show only failed requests (4xx, 5xx, no response) | - |\n| `--url <pattern>` | Filter by URL pattern (regex) | - |\n| `--method <method>` | Filter by HTTP method | - |\n| `--status <codes>` | Filter by status codes (e.g., `404,500`) | - |\n| `--json` | Output as JSON | `false` |\n\n**Examples:**\n\n```bash\n# Show all failed requests (for multi-page traces, specify --page)\nsandbox-cli trace-utils network --file ./trace.zip --errors --page \"page@abc123\"\n\n# Search for specific API calls\nsandbox-cli trace-utils network --file ./trace.zip --url \"/api/v1/users\" --page \"page@abc123\"\n\n# Failed POST requests\nsandbox-cli trace-utils network --file ./trace.zip --errors --method POST --page \"page@abc123\"\n\n# Network requests during a specific step (--page not required)\nsandbox-cli trace-utils network --file ./trace.zip --step \"pw:api@32\"\n```\n\n---\n\n## `console`\n\nView browser console output. For multi-page traces, `--page` is required.\n\n```bash\nsandbox-cli trace-utils console --file <path> [options]\n```\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| `--file` | Path or URL to trace.zip | *required* |\n| `--page` | Page ID to filter by (required for multi-page traces) | - |\n| `--level` | Minimum level: `error`, `warning`, `info`, `debug` | `error` |\n| `--json` | Output as JSON | `false` |\n| `--search` | Filter logs containing text | - |\n\n---\n\n## `dom-snapshot`\n\nExtract DOM snapshot from a trace. Use either `--step` or `--time` (one is required).\n\n```bash\n# By step ID\nsandbox-cli trace-utils dom-snapshot --file <path> --step <id> [options]\n\n# By time (for multi-page traces, --page is required)\nsandbox-cli trace-utils dom-snapshot --file <path> --time <time> --page <pageId> [options]\n```\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| `--file` | Path or URL to trace.zip | *required* |\n| `--step` | Step callId to extract snapshot for | - |\n| `--time` | Time to extract snapshot at (HH:MM:SS.mmm) | - |\n| `--page` | Page ID to filter by (required for multi-page traces with --time) | - |\n| `--type` | Snapshot type: `before`, `after`, `input` (only with --step) | `before` |\n| `--output` | Output file path | - |\n| `--json` | Output as JSON | `false` |\n\n**Snapshot types:**\n\n- `before` - DOM state when the step starts (default)\n- `after` - DOM state when the step completes\n- `input` - DOM state at the moment of user input (for click/fill actions)\n\n> **Tip for assertions:** For `expect` steps like `toBeVisible`, use `--type after` to see the DOM state when the assertion passed. The `before` snapshot may show a loading state if the test was waiting for an element to appear.\n\n**Examples:**\n\n```bash\n# 1. List steps to find callId\nsandbox-cli trace-utils steps --file ./trace.zip\n\n# 2. Extract DOM snapshot before a click step\nsandbox-cli trace-utils dom-snapshot --file ./trace.zip --step \"pw:api@32\" --type before\n\n# 3. Extract DOM snapshot after a step and save to file\nsandbox-cli trace-utils dom-snapshot --file ./trace.zip --step \"pw:api@32\" --type after --output ./snapshot.html\n\n# 4. For assertions, use --type after to see the DOM when assertion passed\nsandbox-cli trace-utils dom-snapshot --file ./trace.zip --step \"expect@43\" --type after\n\n# 5. Extract DOM snapshot at a specific time\nsandbox-cli trace-utils dom-snapshot --file ./trace.zip --time 00:02:06.434\n\n# 6. Get snapshot as JSON\nsandbox-cli trace-utils dom-snapshot --file ./trace.zip --step \"pw:api@32\" --json\n```\n\n**Output (default):**\n```\n# DOM Snapshot: locator.click\n# Step: pw:api@32\n# URL: https://example.com/dashboard\n# Viewport: 1280x720\n# Snapshot type: before\n\n<!DOCTYPE html>\n<html>\n  <head>\n    <title>Dashboard</title>\n    ...\n  </head>\n  <body>\n    ...\n  </body>\n</html>\n```\n\n</trace-utils-cli>\n";
+//# sourceMappingURL=trace-utils-docs.d.ts.map

package/dist/agent/chat/prompt/trace-utils-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-utils-docs.d.ts","sourceRoot":"","sources":["../../../../src/agent/chat/prompt/trace-utils-docs.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa,w4MA2MzB,CAAC"}

package/dist/agent/chat/prompt/trace-utils-docs.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traceUtilsDoc = void 0;
+// TODO: Need a better way to keep this in sync with trace-utils/README.md
+exports.traceUtilsDoc = `
+<trace-utils-cli>
+# Trace Utils
+
+CLI and library for inspecting Playwright \`trace.zip\` files.
+
+## Usage
+
+Via sandbox-cli:
+\`\`\`bash
+sandbox-cli trace-utils <command> [options]
+\`\`\`
+
+---
+
+## \`steps\`
+
+List all test steps from a trace.
+
+\`\`\`bash
+sandbox-cli trace-utils steps --file <path> [--json]
+\`\`\`
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`--file\` | Path or URL to trace.zip | *required* |
+| \`--json\` | Output as JSON | \`false\` |
+
+---
+
+## \`screenshots\`
+
+Extract screenshots from a trace. Use either \`--step\` or \`--start\`/\`--end\` (one is required).
+
+\`\`\`bash
+# By step ID
+sandbox-cli trace-utils screenshots --file <path> --step <id> [options]
+
+# By time range
+sandbox-cli trace-utils screenshots --file <path> --start <time> --end <time> [options]
+\`\`\`
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`--file\` | Path or URL to trace.zip | *required* |
+| \`--step\` | Step callId to extract around | - |
+| \`--start\` | Start time (HH:MM:SS.mmm) | - |
+| \`--end\` | End time (HH:MM:SS.mmm) | - |
+| \`--page\` | Page ID to filter by (required for multi-page traces with time-based extraction) | - |
+| \`--before\` | Milliseconds before step (only with --step) | \`2000\` |
+| \`--after\` | Milliseconds after step (only with --step) | \`2000\` |
+| \`--max\` | Maximum screenshots | \`10\` |
+| \`--output\` | Output directory | auto-generated in \`/tmp\` |
+
+**Examples:**
+
+\`\`\`bash
+# 1. List steps to find callId or timestamps
+sandbox-cli trace-utils steps --file ./trace.zip
+
+# Output:
+# [test.step@36] locator.click(getByRole('button', { name: 'Create' })) (page@abc123)
+#   00:02:06.434 → 00:02:06.543 (110ms)
+
+# 2a. Extract by step ID
+sandbox-cli trace-utils screenshots --file ./trace.zip --step "test.step@36"
+
+# 2b. Extract by time range (for multi-page traces, --page is required)
+sandbox-cli trace-utils screenshots --file ./trace.zip --start 00:02:06.000 --end 00:02:07.000 --page "page@abc123"
+\`\`\`
+
+---
+
+## \`network\`
+
+Search network requests. For multi-page traces, either \`--step\` or \`--page\` is required.
+
+\`\`\`bash
+sandbox-cli trace-utils network --file <path> [filters] [options]
+\`\`\`
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`--file\` | Path or URL to trace.zip | *required* |
+| \`--step <callId>\` | Filter to requests during a specific step | - |
+| \`--page\` | Page ID to filter by (required for multi-page traces without --step) | - |
+| \`--before <ms>\` | Time before step to include (with --step) | \`2000\` |
+| \`--after <ms>\` | Time after step to include (with --step) | \`2000\` |
+| \`--errors\` | Show only failed requests (4xx, 5xx, no response) | - |
+| \`--url <pattern>\` | Filter by URL pattern (regex) | - |
+| \`--method <method>\` | Filter by HTTP method | - |
+| \`--status <codes>\` | Filter by status codes (e.g., \`404,500\`) | - |
+| \`--json\` | Output as JSON | \`false\` |
+
+**Examples:**
+
+\`\`\`bash
+# Show all failed requests (for multi-page traces, specify --page)
+sandbox-cli trace-utils network --file ./trace.zip --errors --page "page@abc123"
+
+# Search for specific API calls
+sandbox-cli trace-utils network --file ./trace.zip --url "/api/v1/users" --page "page@abc123"
+
+# Failed POST requests
+sandbox-cli trace-utils network --file ./trace.zip --errors --method POST --page "page@abc123"
+
+# Network requests during a specific step (--page not required)
+sandbox-cli trace-utils network --file ./trace.zip --step "pw:api@32"
+\`\`\`
+
+---
+
+## \`console\`
+
+View browser console output. For multi-page traces, \`--page\` is required.
+
+\`\`\`bash
+sandbox-cli trace-utils console --file <path> [options]
+\`\`\`
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`--file\` | Path or URL to trace.zip | *required* |
+| \`--page\` | Page ID to filter by (required for multi-page traces) | - |
+| \`--level\` | Minimum level: \`error\`, \`warning\`, \`info\`, \`debug\` | \`error\` |
+| \`--json\` | Output as JSON | \`false\` |
+| \`--search\` | Filter logs containing text | - |
+
+---
+
+## \`dom-snapshot\`
+
+Extract DOM snapshot from a trace. Use either \`--step\` or \`--time\` (one is required).
+
+\`\`\`bash
+# By step ID
+sandbox-cli trace-utils dom-snapshot --file <path> --step <id> [options]
+
+# By time (for multi-page traces, --page is required)
+sandbox-cli trace-utils dom-snapshot --file <path> --time <time> --page <pageId> [options]
+\`\`\`
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`--file\` | Path or URL to trace.zip | *required* |
+| \`--step\` | Step callId to extract snapshot for | - |
+| \`--time\` | Time to extract snapshot at (HH:MM:SS.mmm) | - |
+| \`--page\` | Page ID to filter by (required for multi-page traces with --time) | - |
+| \`--type\` | Snapshot type: \`before\`, \`after\`, \`input\` (only with --step) | \`before\` |
+| \`--output\` | Output file path | - |
+| \`--json\` | Output as JSON | \`false\` |
+
+**Snapshot types:**
+
+- \`before\` - DOM state when the step starts (default)
+- \`after\` - DOM state when the step completes
+- \`input\` - DOM state at the moment of user input (for click/fill actions)
+
+> **Tip for assertions:** For \`expect\` steps like \`toBeVisible\`, use \`--type after\` to see the DOM state when the assertion passed. The \`before\` snapshot may show a loading state if the test was waiting for an element to appear.
+
+**Examples:**
+
+\`\`\`bash
+# 1. List steps to find callId
+sandbox-cli trace-utils steps --file ./trace.zip
+
+# 2. Extract DOM snapshot before a click step
+sandbox-cli trace-utils dom-snapshot --file ./trace.zip --step "pw:api@32" --type before
+
+# 3. Extract DOM snapshot after a step and save to file
+sandbox-cli trace-utils dom-snapshot --file ./trace.zip --step "pw:api@32" --type after --output ./snapshot.html
+
+# 4. For assertions, use --type after to see the DOM when assertion passed
+sandbox-cli trace-utils dom-snapshot --file ./trace.zip --step "expect@43" --type after
+
+# 5. Extract DOM snapshot at a specific time
+sandbox-cli trace-utils dom-snapshot --file ./trace.zip --time 00:02:06.434
+
+# 6. Get snapshot as JSON
+sandbox-cli trace-utils dom-snapshot --file ./trace.zip --step "pw:api@32" --json
+\`\`\`
+
+**Output (default):**
+\`\`\`
+# DOM Snapshot: locator.click
+# Step: pw:api@32
+# URL: https://example.com/dashboard
+# Viewport: 1280x720
+# Snapshot type: before
+
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Dashboard</title>
+    ...
+  </head>
+  <body>
+    ...
+  </body>
+</html>
+\`\`\`
+
+</trace-utils-cli>
+`;

package/dist/agent/code-review/index.d.ts

@@ -4,7 +4,7 @@ import { BaseAgent } from "../base";
 import { type CodeReviewResultV0, type CodeReviewResultV1, type CodeReviewResultV2, CodeReviewSeverity, CodeReviewVerdict } from "./types";
 export type { CodeReviewResultV1, CodeReviewResultV0, CodeReviewResultV2 };
 export { CodeReviewVerdict, CodeReviewSeverity };
-export { convertXmlToV2Format } from "./parser";
+export { convertXmlToV2Format } from "./xml-parser";
 export type CodeReviewVersionedResult = CodeReviewResultV0 | CodeReviewResultV1 | CodeReviewResultV2;
 export declare class CodeReviewAgent<T> extends BaseAgent<T> {
     protected getTools(): ToolsForLLM;

package/dist/agent/code-review/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/code-review/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,yBAAyB,GACjC,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB,qBAAa,eAAe,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAClD,SAAS,CAAC,QAAQ,IAAI,WAAW;IAWjC,SAAS,IAAI,yBAAyB,GAAG,SAAS;cAmBlC,iBAAiB,CAC/B,eAAe,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;CAiInB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/code-review/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,MAAM,yBAAyB,GACjC,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB,qBAAa,eAAe,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAClD,SAAS,CAAC,QAAQ,IAAI,WAAW;IAWjC,SAAS,IAAI,yBAAyB,GAAG,SAAS;cAmBlC,iBAAiB,CAC/B,eAAe,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;CAiInB"}

package/dist/agent/code-review/index.js

@@ -5,12 +5,12 @@ const tools_1 = require("../../tools");
 const fetch_session_diff_1 = require("../../tools/fetch-session-diff");
 const base_1 = require("../base");
 const repo_1 = require("../chat/prompt/repo");
-const parser_1 = require("./parser");
 const types_1 = require("./types");
 Object.defineProperty(exports, "CodeReviewSeverity", { enumerable: true, get: function () { return types_1.CodeReviewSeverity; } });
 Object.defineProperty(exports, "CodeReviewVerdict", { enumerable: true, get: function () { return types_1.CodeReviewVerdict; } });
-var parser_2 = require("./parser");
-Object.defineProperty(exports, "convertXmlToV2Format", { enumerable: true, get: function () { return parser_2.convertXmlToV2Format; } });
+const xml_parser_1 = require("./xml-parser");
+var xml_parser_2 = require("./xml-parser");
+Object.defineProperty(exports, "convertXmlToV2Format", { enumerable: true, get: function () { return xml_parser_2.convertXmlToV2Format; } });
 class CodeReviewAgent extends base_1.BaseAgent {
     getTools() {
         const custom = [
@@ -35,7 +35,7 @@ class CodeReviewAgent extends base_1.BaseAgent {
         if (!text) {
             return undefined;
         }
-        return (0, parser_1.convertXmlToV2Format)(text);
+        return (0, xml_parser_1.convertXmlToV2Format)(text);
     }
     async buildSystemPrompt(repoInfoBuilder) {
         const repoInfo = await repoInfoBuilder();

package/dist/agent/code-review/{parser.d.ts → xml-parser.d.ts}

@@ -2,4 +2,4 @@ import { type CodeReviewResultV2 } from "./types";
 export type { CodeReviewLineComment, CodeReviewResultV0, CodeReviewResultV1, CodeReviewResultV2, } from "./types";
 export { CodeReviewSeverity, CodeReviewVerdict } from "./types";
 export declare function convertXmlToV2Format(output: string): CodeReviewResultV2;
-//# sourceMappingURL=parser.d.ts.map
+//# sourceMappingURL=xml-parser.d.ts.map

package/dist/agent/code-review/xml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-parser.d.ts","sourceRoot":"","sources":["../../../src/agent/code-review/xml-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAchE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAmFvE"}

package/dist/agent/code-review/{parser.js → xml-parser.js}

@@ -41,7 +41,7 @@ function convertXmlToV2Format(output) {
                             : null;
                     if (severity !== null) {
                         lineComments.push({
-                            file: fileMatch[1].trim(),
+                            file: fileMatch[1].trim().replace(/^\/repo\//, ""),
                             line_start: parseInt(lineStartMatch[1].trim(), 10),
                             line_end: parseInt(lineEndMatch[1].trim(), 10),
                             severity: severity,

package/dist/agent/fast-triage/index.d.ts

@@ -0,0 +1,8 @@
+import type { ToolsForLLM } from "@empiricalrun/shared-types/chat-agent";
+import type { FileInfo } from "@empiricalrun/shared-types/test-gen";
+import { BaseAgent } from "../base";
+export declare class FastTriageAgent<T> extends BaseAgent<T> {
+    protected getTools(): ToolsForLLM;
+    protected buildSystemPrompt(repoInfoBuilder: () => Promise<FileInfo>): Promise<string>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/fast-triage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/fast-triage/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAapE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,qBAAa,eAAe,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAClD,SAAS,CAAC,QAAQ,IAAI,WAAW;cAkBjB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;CA+CnB"}

package/dist/agent/fast-triage/index.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FastTriageAgent = void 0;
+const tools_1 = require("../../tools");
+// import { grepTool } from "../../tools/definitions/grep";
+const diagnosis_fetcher_1 = require("../../tools/diagnosis-fetcher");
+const fetch_file_1 = require("../../tools/fetch-file");
+const list_environments_1 = require("../../tools/list-environments");
+const publish_markdown_report_1 = require("../../tools/publish-markdown-report");
+const test_run_fetcher_1 = require("../../tools/test-run-fetcher");
+const base_1 = require("../base");
+const trace_utils_docs_1 = require("../chat/prompt/trace-utils-docs");
+class FastTriageAgent extends base_1.BaseAgent {
+    getTools() {
+        const tools = [
+            diagnosis_fetcher_1.fetchDiagnosisReportTool,
+            test_run_fetcher_1.fetchTestRunDetailsTool,
+            list_environments_1.listEnvironmentsTool,
+            fetch_file_1.fetchFileTool,
+            tools_1.safeBashTool,
+            publish_markdown_report_1.publishMarkdownReportTool,
+            // TODO: Do we need grep?
+            // grepTool,
+            ...(0, tools_1.textEditorToolsForModel)(this.selectedModel),
+        ];
+        return {
+            custom: tools,
+            builtInTextEditor: (0, tools_1.hasBuiltInTextEditor)(this.selectedModel),
+        };
+    }
+    async buildSystemPrompt(repoInfoBuilder) {
+        const _repoInfo = await repoInfoBuilder();
+        // TODO: Use repo knowledge - can that also replace "issues" as memory?
+        return `
+You are a fast triage agent that quickly analyzes test failures. [PLACEHOLDER - to be refined]
+
+Your goal is to analyze the provided test failure and identify the root cause as quickly as possible.
+
+Use the available tools to:
+1. Fetch the diagnosis report for the failing test
+2. Fetch test run details to understand the context
+3. Review the test code and related files to understand what the test is doing
+4. Identify the root cause of the failure
+
+Provide a concise summary of:
+- What failed
+- Why it failed (root cause)
+- Whether this is an app issue or a test issue
+
+Use the bash tool to make use of trace-utils and fetch steps from traces,
+errors in network calls, and screenshots around failures.
+
+${trace_utils_docs_1.traceUtilsDoc}
+
+# Expected output
+
+A well-structured markdown report published via the publishMarkdownReport tool.
+
+Your report must include:
+- What failed and why (root cause analysis)
+- Whether this is an app issue or a test issue
+- Evidence from the failure: include screenshots (as file:// URLs), network logs, console logs, etc.
+- Evidence from the last passing run when available: include screenshots showing the expected behavior
+
+Use trace-utils to extract screenshots from both failing and passing runs. Reference them in your
+markdown using file:// URLs (e.g. file:///path/to/screenshot.png). The publishMarkdownReport tool
+will upload these files and replace them with public URLs automatically.
+
+As your final step, always call the publishMarkdownReport tool with your complete markdown report.
+
+# Things to keep in mind
+
+Follow the action, not just the assertion - The console showed deletePlayer error. I should have immediately looked at screenshots around the click that triggered it (test.step@126 - the "Yes" click) rather than the failing expect (expect@92).
+
+Today's date is ${new Date().toDateString()}
+`;
+    }
+}
+exports.FastTriageAgent = FastTriageAgent;

package/dist/agent/index.d.ts

@@ -2,8 +2,9 @@ import type { AgentModeEnum } from "@empiricalrun/shared-types/chat-agent";
 import { type AgentParams, BaseAgent } from "./base";
 import { ChatAgent } from "./chat";
 import { CodeReviewAgent } from "./code-review";
+import { FastTriageAgent } from "./fast-triage";
 import { TriageAgent } from "./triage";
 export declare function createAgent<T>(mode: AgentModeEnum, params: AgentParams<T>): BaseAgent<T>;
-export { BaseAgent, ChatAgent, CodeReviewAgent, TriageAgent };
+export { BaseAgent, ChatAgent, CodeReviewAgent, FastTriageAgent, TriageAgent };
 export type { AgentParams };
 //# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,KAAK,WAAW,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAUvC,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,SAAS,CAAC,CAAC,CAAC,CAMd;AAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,KAAK,WAAW,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAWvC,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,SAAS,CAAC,CAAC,CAAC,CAMd;AAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/dist/agent/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TriageAgent = exports.CodeReviewAgent = exports.ChatAgent = exports.BaseAgent = void 0;
+exports.TriageAgent = exports.FastTriageAgent = exports.CodeReviewAgent = exports.ChatAgent = exports.BaseAgent = void 0;
 exports.createAgent = createAgent;
 const base_1 = require("./base");
 Object.defineProperty(exports, "BaseAgent", { enumerable: true, get: function () { return base_1.BaseAgent; } });
@@ -8,12 +8,15 @@ const chat_1 = require("./chat");
 Object.defineProperty(exports, "ChatAgent", { enumerable: true, get: function () { return chat_1.ChatAgent; } });
 const code_review_1 = require("./code-review");
 Object.defineProperty(exports, "CodeReviewAgent", { enumerable: true, get: function () { return code_review_1.CodeReviewAgent; } });
+const fast_triage_1 = require("./fast-triage");
+Object.defineProperty(exports, "FastTriageAgent", { enumerable: true, get: function () { return fast_triage_1.FastTriageAgent; } });
 const triage_1 = require("./triage");
 Object.defineProperty(exports, "TriageAgent", { enumerable: true, get: function () { return triage_1.TriageAgent; } });
 const agentRegistry = {
     chat: chat_1.ChatAgent,
     triage: triage_1.TriageAgent,
     "code-review": code_review_1.CodeReviewAgent,
+    "fast-triage": fast_triage_1.FastTriageAgent,
 };
 function createAgent(mode, params) {
     const AgentClass = agentRegistry[mode];

package/dist/agent/master/element-annotation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-annotation.d.ts","sourceRoot":"","sources":["../../../src/agent/master/element-annotation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,GAAG,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAQlC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AA2DjD,wBAAsB,oBAAoB,CAAC,EACzC,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,KAAK,EACL,GAAG,EACH,OAAO,EACP,UAAU,GACX,EAAE;IACD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,UAAU,EAAE,oBAAoB,CAAC;CAClC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA8C9B;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EACN,KAAK,GACL,UAAU,CAAC,IAAI,GACf,UAAU,CAAC,WAAW,GACtB,UAAU,CAAC,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAgBF,wBAAsB,iBAAiB,CAAC,EACtC,IAAI,EACJ,UAAU,EACV,KAAK,GACN,EAAE;IACD,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,oBAAoB,CAAC;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,GAAG,OAAO,CAAC;IACV,cAAc,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC,CAmFD"}
+{"version":3,"file":"element-annotation.d.ts","sourceRoot":"","sources":["../../../src/agent/master/element-annotation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,GAAG,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAQlC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AA0DjD,wBAAsB,oBAAoB,CAAC,EACzC,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,KAAK,EACL,GAAG,EACH,OAAO,EACP,UAAU,GACX,EAAE;IACD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,UAAU,EAAE,oBAAoB,CAAC;CAClC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA8C9B;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EACN,KAAK,GACL,UAAU,CAAC,IAAI,GACf,UAAU,CAAC,WAAW,GACtB,UAAU,CAAC,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAgBF,wBAAsB,iBAAiB,CAAC,EACtC,IAAI,EACJ,UAAU,EACV,KAAK,GACN,EAAE;IACD,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,oBAAoB,CAAC;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,GAAG,OAAO,CAAC;IACV,cAAc,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC,CAmFD"}