@empiricalrun/test-gen 0.80.0 → 0.80.2

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @empiricalrun/test-gen
 
+## 0.80.2
+
+### Patch Changes
+
+- Updated dependencies [2d6f146]
+  - @empiricalrun/dashboard-client@0.2.1
+
+## 0.80.1
+
+### Patch Changes
+
+- Updated dependencies [3a315aa]
+  - @empiricalrun/reporter@0.28.1
+  - @empiricalrun/test-run@0.16.1
+
 ## 0.80.0
 
 ### Minor Changes

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

@@ -1,7 +1,7 @@
 export type { IChatModel } from "@empiricalrun/llm/chat";
 export { createChatModel } from "@empiricalrun/llm/chat";
 export { SUPPORTED_CHAT_MODELS } from "@empiricalrun/llm/chat/constants";
-export { getFileInfoFromGitHub, viewFileUsingGitHub, } from "../../file-info/adapters/github";
+export { getFileInfoFromGitHub } from "../../file-info/adapters/github/reader";
 export type { AgentParams, OnToolCallCallback } from "../base";
 export { BaseAgent } from "../base";
 export type { CodeReviewResultV0, CodeReviewResultV1, CodeReviewResultV2, CodeReviewVersionedResult, } from "../code-review";

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,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AACzE,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,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,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,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/agent/chat/exports.js

@@ -1,13 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractAttachments = exports.LATEST_CHAT_STATE_VERSION = exports.fetchToolCallFromId = exports.ChatAgent = exports.TriageAgent = exports.FastTriageAgent = exports.CodeReviewAgent = exports.BaseAgent = exports.viewFileUsingGitHub = exports.getFileInfoFromGitHub = exports.SUPPORTED_CHAT_MODELS = exports.createChatModel = void 0;
+exports.extractAttachments = exports.LATEST_CHAT_STATE_VERSION = exports.fetchToolCallFromId = exports.ChatAgent = exports.TriageAgent = exports.FastTriageAgent = exports.CodeReviewAgent = exports.BaseAgent = 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");
 Object.defineProperty(exports, "SUPPORTED_CHAT_MODELS", { enumerable: true, get: function () { return constants_1.SUPPORTED_CHAT_MODELS; } });
-var github_1 = require("../../file-info/adapters/github");
-Object.defineProperty(exports, "getFileInfoFromGitHub", { enumerable: true, get: function () { return github_1.getFileInfoFromGitHub; } });
-Object.defineProperty(exports, "viewFileUsingGitHub", { enumerable: true, get: function () { return github_1.viewFileUsingGitHub; } });
+var reader_1 = require("../../file-info/adapters/github/reader");
+Object.defineProperty(exports, "getFileInfoFromGitHub", { enumerable: true, get: function () { return reader_1.getFileInfoFromGitHub; } });
 var base_1 = require("../base");
 Object.defineProperty(exports, "BaseAgent", { enumerable: true, get: function () { return base_1.BaseAgent; } });
 var code_review_1 = require("../code-review");

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;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;IA2B3B,iBAAiB,CACrB,eAAe,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;CAwGnB"}
+{"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;AAOpC,qBAAa,SAAS,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAC5C,SAAS,CAAC,QAAQ,IAAI,WAAW;IA8B3B,iBAAiB,CACrB,eAAe,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;CA0GnB"}

package/dist/agent/chat/index.js

@@ -7,33 +7,35 @@ const analyse_video_1 = require("../../tools/definitions/analyse-video");
 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 test_gen_browser_1 = require("../../tools/definitions/test-gen-browser");
 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 slack_message_1 = require("../../tools/slack-message");
 const base_1 = require("../base");
 const pw_utils_docs_1 = require("./prompt/pw-utils-docs");
 const repo_1 = require("./prompt/repo");
+const skills_1 = require("./prompt/skills");
 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 useAPIClientTool = this.featureFlags.includes("useAPIClientTool");
+        const hasSlackTool = this.featureFlags.includes("has_slack_tool");
+        const hasSkills = this.featureFlags.includes("useSkills");
+        const hasAnalyseVideoTool = this.featureFlags.includes("has_analyse_video_tool");
         const custom = [
-            analyse_video_1.analyseVideo,
+            ...(hasAnalyseVideoTool ? [analyse_video_1.analyseVideo] : []),
             run_test_1.runTestTool,
             grep_1.grepTool,
-            ...(useAPIClientTool
-                ? [api_client_1.apiClientTool]
-                : [list_environments_1.listEnvironmentsTool, test_run_fetcher_1.fetchTestRunDetailsTool]),
+            ...(hasSlackTool ? [slack_message_1.slackMessageTool] : []),
             fetch_file_1.fetchFileTool,
             list_tests_and_projects_1.listProjectsTool,
             list_tests_and_projects_1.listTestsForProjectTool,
-            ...tools_1.testGenerationTools,
             diagnosis_fetcher_1.fetchDiagnosisReportTool,
             ...(0, tools_1.textEditorToolsForModel)(this.selectedModel),
             tools_1.safeBashTool,
             ...(!(0, tools_1.hasBuiltInWebFetch)(this.selectedModel) ? [tools_1.scrapeHtmlTool] : []),
+            ...tools_1.testGenerationToolsWithoutBrowserAgent,
+            ...(!hasSkills ? [api_client_1.apiClientTool, test_gen_browser_1.generateTestWithBrowserAgent] : []),
         ];
         return {
             custom,
@@ -46,6 +48,8 @@ class ChatAgent extends base_1.BaseAgent {
     async buildSystemPrompt(repoInfoBuilder) {
         const repoInfo = await repoInfoBuilder();
         const repoContext = await (0, repo_1.getRepoContextPrompt)(repoInfo);
+        const hasSkills = this.featureFlags.includes("useSkills");
+        const skillsInToolsPrompt = hasSkills ? skills_1.skillsToolsPrompt : "";
         const preamble = `
 You are a helpful assistant that can answer questions and help with tasks related to writing and maintaining Playwright tests.
 
@@ -71,7 +75,7 @@ fixed with modifications to the test code, and it is your job to do that.
 
 You are given a set of tools (= functions) to help you fulfill the user's request. Read their descriptions
 to understand what each tool does. You are HIGHLY encouraged to use tools and generate a high quality output.
-
+${skillsInToolsPrompt}
 For example,
 
 1. If you are adding or modifying a test, run the test to ensure it works well.

package/dist/agent/chat/prompt/skills.d.ts

@@ -0,0 +1,3 @@
+export declare const skillsToolsPrompt: string;
+export declare const skillsProactivenessPrompt = "\nIf your listed tools don't seem sufficient for a task, load a relevant skill file using the bash tool to learn how to accomplish the task with your existing tools.\n";
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../../src/agent/chat/prompt/skills.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,iBAAiB,QAO7B,CAAC;AAEF,eAAO,MAAM,yBAAyB,4KAErC,CAAC"}

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillsProactivenessPrompt = exports.skillsToolsPrompt = void 0;
+const availableSkills = [
+    {
+        name: "empirical-api",
+        description: "Interact with the Empirical dashboard via API. Load this skill whenever you need to access dashboard data such as test runs, resources, or any project-level information.",
+        location: "/opt/skills/empirical-api/SKILL.md",
+    },
+    {
+        name: "playwright-cli",
+        description: "Interact with browsers via playwright-cli for test generation, debugging, and exploration. Use when asked to generate, modify, or fix Playwright tests, explore a website or debug test failures.",
+        location: "/opt/skills/playwright-cli/SKILL.md",
+    },
+];
+const skillToXml = (s) => {
+    return `<skill>
+    <name>${s.name}</name>
+    <description>${s.description}</description>
+    <location>${s.location}</location>
+</skill>`;
+};
+const skillCatalogXml = `<available_skills>
+  ${availableSkills.map(skillToXml).join("\n")}
+</available_skills>`;
+exports.skillsToolsPrompt = `
+You have access to **skill files** — documentation that teaches you how to accomplish tasks using your existing safeBash tool.
+Skills are NOT callable functions. To use a skill, read its file with bash, then follow the instructions inside.
+
+${skillCatalogXml}
+
+To use a skill: run \`cat <location>\` using the bash tool, then follow the instructions in the output.
+`;
+exports.skillsProactivenessPrompt = `
+If your listed tools don't seem sufficient for a task, load a relevant skill file using the bash tool to learn how to accomplish the task with your existing tools.
+`;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/triage/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAepE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIpC,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAC9C,SAAS,CAAC,QAAQ,IAAI,WAAW;cA0BjB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;CAgEnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/triage/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAepE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIpC,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAC9C,SAAS,CAAC,QAAQ,IAAI,WAAW;cA6BjB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;CAgEnB"}

package/dist/agent/triage/index.js

@@ -19,6 +19,7 @@ const repo_1 = require("../chat/prompt/repo");
 const test_case_def_1 = require("../chat/prompt/test-case-def");
 class TriageAgent extends base_1.BaseAgent {
     getTools() {
+        const hasAnalyseVideoTool = this.featureFlags.includes("has_analyse_video_tool");
         const tools = [
             // Tools to understand test run (open report)
             diagnosis_fetcher_1.fetchDiagnosisReportTool,
@@ -26,7 +27,7 @@ class TriageAgent extends base_1.BaseAgent {
             list_environments_1.listEnvironmentsTool,
             // Tools to analyse report artifacts
             fetch_file_1.fetchFileTool,
-            analyse_video_1.analyseVideo,
+            ...(hasAnalyseVideoTool ? [analyse_video_1.analyseVideo] : []),
             trace_dot_zip_1.traceDotZip,
             // Tools to get test case context from the repo
             grep_1.grepTool,

package/dist/file-info/adapters/github/reader.d.ts

@@ -1,12 +1,4 @@
 import { IDashboardAPIClient } from "@empiricalrun/shared-types/api/base";
-import { FileInfo, FileReadResult } from "@empiricalrun/shared-types/test-gen";
-export declare class GitHubFileReader {
-    private repoName;
-    private apiClient;
-    constructor(repoName: string, apiClient: IDashboardAPIClient);
-    resolveBranchName(branchName: string | undefined, baseBranch: string): Promise<string>;
-    readFile(filePath: string, branchName: string, baseBranch: string): Promise<FileReadResult | null>;
-    private readDirectory;
-}
+import { FileInfo } from "@empiricalrun/shared-types/test-gen";
 export declare function getFileInfoFromGitHub(repoName: string, apiClient: IDashboardAPIClient, branchName: string, baseBranchName: string): Promise<FileInfo>;
 //# sourceMappingURL=reader.d.ts.map

package/dist/file-info/adapters/github/reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../../src/file-info/adapters/github/reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAwB/E,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;gBADT,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,mBAAmB;IAGlC,iBAAiB,CACrB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;IAoBZ,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;YAoDnB,aAAa;CAoD5B;AAyED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,mBAAmB,EAC9B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,QAAQ,CAAC,CAwFnB"}
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../../src/file-info/adapters/github/reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAqF/D,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,mBAAmB,EAC9B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,QAAQ,CAAC,CAyFnB"}

package/dist/file-info/adapters/github/reader.js

@@ -3,134 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GitHubFileReader = void 0;
 exports.getFileInfoFromGitHub = getFileInfoFromGitHub;
 const path_1 = __importDefault(require("path"));
-function isDotfile(filename) {
-    const base = path_1.default.basename(filename);
-    return base.startsWith(".") && base !== "." && base !== "..";
-}
-function isDirectory(filename) {
-    const hasFileExtension = path_1.default.extname(filename) !== "";
-    return !isDotfile(filename) && !hasFileExtension;
-}
-class GitHubFileReader {
-    repoName;
-    apiClient;
-    constructor(repoName, apiClient) {
-        this.repoName = repoName;
-        this.apiClient = apiClient;
-    }
-    async resolveBranchName(branchName, baseBranch) {
-        if (!branchName || branchName === baseBranch) {
-            return baseBranch;
-        }
-        try {
-            await this.apiClient.callGitHubProxy({
-                method: "GET",
-                url: `/repos/empirical-run/${this.repoName}/branches/${branchName}`,
-            });
-            console.log(`[GitHubFileReader] Branch ${branchName} exists`);
-            return branchName;
-        }
-        catch {
-            console.log(`[GitHubFileReader] Branch ${branchName} not found, falling back to ${baseBranch}`);
-            return baseBranch;
-        }
-    }
-    async readFile(filePath, branchName, baseBranch) {
-        const resolvedBranch = await this.resolveBranchName(branchName, baseBranch);
-        if (isDirectory(filePath)) {
-            console.log(`[GitHubFileReader] Reading as directory: ${filePath}`);
-            return this.readDirectory(filePath, resolvedBranch);
-        }
-        // For dotfiles without extensions (e.g. .empiricalrun, .github), we can't
-        // tell if they're files or directories by name alone. Try directory first
-        // since that API is faster and won't hang for misclassified paths.
-        if (isDotfile(filePath) && !path_1.default.extname(filePath)) {
-            console.log(`[GitHubFileReader] Dotfile without extension, trying directory first: ${filePath}`);
-            const dirResult = await this.readDirectory(filePath, resolvedBranch);
-            if (dirResult) {
-                return dirResult;
-            }
-        }
-        try {
-            console.log(`[GitHubFileReader] Reading as file: ${filePath}, resolved branch: ${resolvedBranch}`);
-            const params = {
-                repo: this.repoName,
-                path: filePath,
-                ref: resolvedBranch,
-            };
-            const response = await this.apiClient.request(`/api/github/files`, {
-                method: "GET",
-                params,
-            });
-            if (response.data?.fileContents.available) {
-                return {
-                    content: response.data.fileContents.content,
-                    isDirectory: false,
-                };
-            }
-            console.log(`[GitHubFileReader] File not available: ${filePath}`);
-            return null;
-        }
-        catch (error) {
-            console.log(`[GitHubFileReader] Error reading file ${filePath}:`, error);
-            return null;
-        }
-    }
-    async readDirectory(filePath, resolvedBranch) {
-        try {
-            console.log(`[GitHubFileReader] Reading directory: ${filePath}, resolved branch: ${resolvedBranch}`);
-            const params = {
-                repo: this.repoName,
-                path: filePath || ".", // Handle empty path
-                ref: resolvedBranch,
-            };
-            const treeResponse = await this.apiClient.request(`/api/github/tree`, {
-                method: "GET",
-                params,
-            });
-            if (treeResponse.data?.tree) {
-                const targetPath = filePath === "." || filePath === "" ? "" : filePath;
-                const files = treeResponse.data.tree.tree
-                    .map((item) => item.path)
-                    .filter((itemPath) => {
-                    if (!itemPath)
-                        return false;
-                    // Check if item is a direct child of the target directory
-                    const itemDir = path_1.default.dirname(itemPath);
-                    // Normalize "." to "" for root directory comparison
-                    const normalizedItemDir = itemDir === "." ? "" : itemDir;
-                    return normalizedItemDir === targetPath;
-                })
-                    .map((itemPath) => path_1.default.basename(itemPath))
-                    .sort()
-                    .join("\n");
-                if (files.length === 0) {
-                    // No files means directory is invalid
-                    return null;
-                }
-                else {
-                    return { content: files, isDirectory: true };
-                }
-            }
-        }
-        catch (error) {
-            console.log(`[GitHubFileReader] Error reading directory ${filePath}:`, error);
-        }
-        return null;
-    }
-}
-exports.GitHubFileReader = GitHubFileReader;
-async function getFileContent(repoName, path, apiClient, branchName) {
+async function getFileContent(repoName, path, apiClient, branchName, baseBranch) {
     const params = {
         repo: repoName,
         path: path,
+        ref: branchName,
+        baseBranch,
     };
-    if (branchName) {
-        params.ref = branchName;
-    }
     const response = await apiClient.request(`/api/github/files`, {
         method: "GET",
         params,
@@ -140,14 +21,13 @@ async function getFileContent(repoName, path, apiClient, branchName) {
     }
     return response.data.fileContents.content;
 }
-async function getContentsForDirectory({ repo, path, }, apiClient, branchName) {
+async function getContentsForDirectory({ repo, path, }, apiClient, branchName, baseBranch) {
     const params = {
         repo: repo,
         path: path,
+        ref: branchName,
+        baseBranch,
     };
-    if (branchName) {
-        params.ref = branchName;
-    }
     const response = await apiClient.request(`/api/github/tree`, {
         method: "GET",
         params,
@@ -158,9 +38,7 @@ async function getContentsForDirectory({ repo, path, }, apiClient, branchName) {
     return response.data.tree;
 }
 async function getFileInfoFromGitHub(repoName, apiClient, branchName, baseBranchName) {
-    const fileReader = new GitHubFileReader(repoName, apiClient);
-    const resolvedBranch = await fileReader.resolveBranchName(branchName, baseBranchName);
-    const files = await getContentsForDirectory({ repo: repoName, path: "" }, apiClient, resolvedBranch);
+    const files = await getContentsForDirectory({ repo: repoName, path: "" }, apiClient, branchName, baseBranchName);
     const root = [];
     const nodeMap = {};
     if (!files) {
@@ -184,7 +62,7 @@ async function getFileInfoFromGitHub(repoName, apiClient, branchName, baseBranch
                 type: "file",
                 path: currentPath,
                 name: fileName,
-                getContent: async () => getFileContent(repoName, currentPath, apiClient, resolvedBranch),
+                getContent: async () => getFileContent(repoName, currentPath, apiClient, branchName, baseBranchName),
             }
             : {
                 type: "directory",

package/dist/file-info/index.d.ts

@@ -1,4 +1,3 @@
 export { viewFileUsingFileSystem } from "./adapters/file-system";
 export { FilesystemFileReader, getFileInfoFromFS, } from "./adapters/file-system/reader";
-export { viewFileUsingGitHub } from "./adapters/github";
 //# sourceMappingURL=index.d.ts.map

package/dist/file-info/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file-info/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file-info/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,+BAA+B,CAAC"}

package/dist/file-info/index.js

@@ -1,10 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.viewFileUsingGitHub = exports.getFileInfoFromFS = exports.FilesystemFileReader = exports.viewFileUsingFileSystem = void 0;
+exports.getFileInfoFromFS = exports.FilesystemFileReader = exports.viewFileUsingFileSystem = void 0;
 var file_system_1 = require("./adapters/file-system");
 Object.defineProperty(exports, "viewFileUsingFileSystem", { enumerable: true, get: function () { return file_system_1.viewFileUsingFileSystem; } });
 var reader_1 = require("./adapters/file-system/reader");
 Object.defineProperty(exports, "FilesystemFileReader", { enumerable: true, get: function () { return reader_1.FilesystemFileReader; } });
 Object.defineProperty(exports, "getFileInfoFromFS", { enumerable: true, get: function () { return reader_1.getFileInfoFromFS; } });
-var github_1 = require("./adapters/github");
-Object.defineProperty(exports, "viewFileUsingGitHub", { enumerable: true, get: function () { return github_1.viewFileUsingGitHub; } });

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,KAAK,EACN,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAM3E,MAAM,MAAM,YAAY,GAAG;IACzB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAsB,UAAU,CAC9B,KAAK,EAAE,cAAc,EACrB,GAAG,CAAC,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,eAAe,EACzB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,eAAe,EAAE,MAAM,EACvB,GAAG,CAAC,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,EACxB,GAAG,CAAC,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,CAAC,EAAE,YAAY,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBhB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,KAAK,EACN,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAM3E,MAAM,MAAM,YAAY,GAAG;IACzB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAsB,UAAU,CAC9B,KAAK,EAAE,cAAc,EACrB,GAAG,CAAC,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,eAAe,EACzB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,eAAe,EAAE,MAAM,EACvB,GAAG,CAAC,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,EACxB,GAAG,CAAC,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,CAAC,EAAE,YAAY,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB"}

package/dist/telemetry/index.js

@@ -80,6 +80,8 @@ async function trackLLMResponse(opts) {
             tokens_output: opts.usage.tokens?.output || 0,
             cost_input: opts.usage.cost?.input || 0,
             cost_output: opts.usage.cost?.output || 0,
+            tokens_cache_read: opts.usage.tokens?.cache_read || 0,
+            tokens_cache_creation: opts.usage.tokens?.cache_creation || 0,
             // Moving project_repo_name -> repo_name for consistency with other events
             project_repo_name: opts.projectRepoName,
             repo_name: opts.projectRepoName,

package/dist/tools/api-client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/api-client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uCAAuC,CAAC;AAkBlE,eAAO,MAAM,aAAa,EAAE,IAwD3B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/api-client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uCAAuC,CAAC;AAkBlE,eAAO,MAAM,aAAa,EAAE,IA2I3B,CAAC"}

package/dist/tools/api-client/index.js

@@ -39,6 +39,94 @@ Returns: { data: { test_runs: [...], total, limit, offset } }
 \`GET /api/test-runs/:id\`
 
 Returns: { data: { test_run: { testRun: { id, state, duration, environment_name, environment_slug, build_url, build_branch, commit, run_started_at, run_ended_at, ... } } } }
+
+### List files
+\`GET /api/files\`
+
+Returns uploaded project files (docs, videos, etc).
+
+Query params:
+- page: Page number (1-indexed, default 1)
+- per_page: Items per page (default 20)
+
+Returns: { data: { files: [{ id, name, url, description, mime_type, size_bytes, status, access_level, created_at, ... }] }, pagination: { page, per_page, total, total_pages } }
+For link-type files (e.g. Google Sheets), access_level is "read_write", "read", or "none".
+
+### Get a file by ID
+\`GET /api/files/:id\`
+
+Returns: { data: { file: { id, name, url, description, mime_type, size_bytes, status, created_at, ... } } }
+
+### Create a file
+\`POST /api/files\`
+
+Body: { project_id: number, name: string, mime_type?: string, size_bytes?: number, url?: string, description?: string }
+
+Returns: { data: { file: { id, name, upload_url, ... } } }
+The upload_url is a presigned URL for uploading the file content via PUT.
+
+**Link-type files (e.g. Google Sheets):** Pass \`url\` to create a link file instead of uploading. The file is immediately marked as "uploaded" with no R2 storage needed.
+Example: { "name": "Test Cases Sheet", "url": "https://docs.google.com/spreadsheets/d/abc123/edit", "description": "Main test cases tracking sheet" }
+
+### Update a file
+\`PATCH /api/files/:id\`
+
+Body: { name?: string, description?: string, status?: "uploaded" }
+After uploading file content, set status to "uploaded" to make it visible.
+
+Returns: { data: { file: { ... } } }
+
+### Delete a file
+\`DELETE /api/files/:id\`
+
+Returns: { data: { result: { success: true } } }
+
+### Google Sheets proxy
+\`POST /api/gsheet/proxy\`
+
+Read, write, or append to a Google Sheet via the dashboard's service account.
+
+Body:
+- action: "read" | "write" | "append"
+- spreadsheet_id: The spreadsheet ID (from the Google Sheet URL between /d/ and /edit)
+- range: Sheet range (e.g. "Sheet1", "Sheet1!A1:D10")
+- values: 2D array of strings (required for write and append actions)
+
+**Read example:**
+\`\`\`json
+{ "action": "read", "spreadsheet_id": "abc123", "range": "Sheet1!A1:D10" }
+\`\`\`
+Returns: { data: { values: [["row1col1", "row1col2"], ...] } }
+
+**Write (overwrite) example:**
+\`\`\`json
+{ "action": "write", "spreadsheet_id": "abc123", "range": "Sheet1!A1:B2", "values": [["a","b"],["c","d"]] }
+\`\`\`
+Returns: { data: { updated_cells: 4 } }
+
+**Append rows example:**
+\`\`\`json
+{ "action": "append", "spreadsheet_id": "abc123", "range": "Sheet1", "values": [["new","row"]] }
+\`\`\`
+Returns: { data: { updated_cells: 2 } }
+
+**Important:** The append action auto-detects table boundaries and may place data in unexpected columns. For precise cell placement, use the "write" action with an explicit cell range (e.g. "Sheet1!D6") instead.
+
+## Using curl via bash
+
+You can also make these API calls using curl in the bash tool. The API key is available as \`$EMPIRICALRUN_API_KEY\` and the dashboard base URL is \`https://dash.empirical.run\` (or \`$DASHBOARD_DOMAIN\` if set).
+
+Example - list files:
+\`\`\`
+curl -s -H "Authorization: Bearer $EMPIRICALRUN_API_KEY" "https://dash.empirical.run/api/files"
+\`\`\`
+
+Example - download a file (use the signed \`url\` from a file response):
+\`\`\`
+curl -s -o output_file "<signed_url>"
+\`\`\`
+
+This is especially useful for downloading files (via signed URLs) to the local filesystem for processing.
 `,
         parameters: APIClientSchema,
     },
@@ -55,9 +143,6 @@ Returns: { data: { test_run: { testRun: { id, state, duration, environment_name,
                 params,
                 ...(input.body && { body: input.body }),
             });
-            if (response?.data?.test_run?.flattenedSummaryDetails) {
-                delete response.data.test_run.flattenedSummaryDetails;
-            }
             return {
                 isError: false,
                 result: JSON.stringify(response, null, 2),

package/dist/tools/executor/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/executor/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAEjE,YAAY,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,YAAa,SAAQ,gBAAgB;gBACpC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC;CA2BzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/executor/index.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAEjE,YAAY,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,YAAa,SAAQ,gBAAgB;gBACpC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC;CAiCzD"}

package/dist/tools/executor/index.js

@@ -2,14 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolExecutor = exports.gitPushChanges = exports.BaseToolExecutor = void 0;
 const analyse_video_1 = require("../analyse-video");
+const api_client_1 = require("../api-client");
 const create_pull_request_1 = require("../create-pull-request");
 const delete_file_1 = require("../delete-file");
 const diagnosis_fetcher_1 = require("../diagnosis-fetcher");
 const fetch_file_1 = require("../fetch-file");
 const fetch_session_diff_1 = require("../fetch-session-diff");
 const file_operations_1 = require("../file-operations");
+const firecrawl_scrape_1 = require("../firecrawl-scrape");
 const grep_1 = require("../grep");
 const issues_v1_1 = require("../issues-v1");
+const create_issue_1 = require("../issues-v2/create-issue");
+const set_issue_description_1 = require("../issues-v2/set-issue-description");
+const update_issue_1 = require("../issues-v2/update-issue");
 const list_environments_1 = require("../list-environments");
 const list_tests_and_projects_1 = require("../list-tests-and-projects");
 const merge_conflicts_1 = require("../merge-conflicts");
@@ -17,6 +22,7 @@ const publish_markdown_report_1 = require("../publish-markdown-report");
 const rename_file_1 = require("../rename-file");
 const run_test_1 = require("../run-test");
 const safe_bash_1 = require("../safe-bash");
+const slack_message_1 = require("../slack-message");
 const test_gen_browser_1 = require("../test-gen-browser");
 const test_run_fetcher_1 = require("../test-run-fetcher");
 const trace_dot_zip_1 = require("../trace-dot-zip");
@@ -50,6 +56,12 @@ class ToolExecutor extends base_1.BaseToolExecutor {
             fetch_session_diff_1.fetchSessionDiffTool,
             list_tests_and_projects_1.listTestsForProjectTool,
             safe_bash_1.safeBashTool,
+            api_client_1.apiClientTool,
+            create_issue_1.createIssueTool,
+            set_issue_description_1.setIssueDescriptionTool,
+            update_issue_1.updateIssueTool,
+            firecrawl_scrape_1.scrapeHtmlTool,
+            slack_message_1.slackMessageTool,
             ...file_operations_1.textEditorTools,
         ];
         super({ ...params, tools });

package/dist/tools/fetch-file/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/fetch-file/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,IAAI,EAGL,MAAM,uCAAuC,CAAC;AAG/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuGxB,QAAA,MAAM,eAAe;;iBAEnB,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAqJ/D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/fetch-file/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,IAAI,EAGL,MAAM,uCAAuC,CAAC;AAG/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmGxB,QAAA,MAAM,eAAe;;iBAEnB,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAqJ/D,CAAC"}

package/dist/tools/fetch-file/index.js

@@ -8,6 +8,7 @@ const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
 const zod_1 = require("zod");
 const url_validation_1 = require("../../utils/url-validation");
+const apply_line_limit_1 = require("../utils/apply-line-limit");
 const utils_1 = require("./utils");
 const SUPPORTED_IMAGE_TYPES = [
     "image/png",
@@ -16,15 +17,6 @@ const SUPPORTED_IMAGE_TYPES = [
     "image/webp",
 ];
 const SUPPORTED_TEXT_TYPES = ["text/markdown", "text/plain"];
-function applyLineLimit(text, url) {
-    const lines = text.split("\n");
-    if (lines.length <= 100) {
-        return text;
-    }
-    const trimmedText = lines.slice(0, 100).join("\n");
-    const message = `\n\n[Output trimmed: This file contains ${lines.length} lines, showing first 100 lines. To get the full output, use the Bash tool to fetch via curl and search the response: curl "${url}"]`;
-    return trimmedText + message;
-}
 async function handleLocalFile(filePath, logger, featureFlags) {
     const ext = path_1.default.extname(filePath).toLowerCase();
     const isImage = [".png", ".jpg", ".jpeg", ".gif", ".webp"].includes(ext);
@@ -64,7 +56,7 @@ async function handleLocalFile(filePath, logger, featureFlags) {
         }
         else {
             const text = buffer.toString("utf-8");
-            const processedText = applyLineLimit(text, `file://${filePath}`);
+            const processedText = (0, apply_line_limit_1.applyLineLimit)(text, (0, apply_line_limit_1.fetchFileTrimMessage)(`file://${filePath}`));
             logger.info("Successfully read local text file", {
                 tool: "fetchFileTool",
                 filePath,
@@ -200,7 +192,7 @@ time of test failures. Both of these are available in the attachments section of
                 // Handle text/markdown files
                 const contentResponse = await fetch(url);
                 const text = await contentResponse.text();
-                const processedText = applyLineLimit(text, url);
+                const processedText = (0, apply_line_limit_1.applyLineLimit)(text, (0, apply_line_limit_1.fetchFileTrimMessage)(url));
                 logger.info("Successfully fetched text file", {
                     tool: "fetchFileTool",
                     url,