@netlify/axis 0.2.0

package/dist/scoring/triage.js

@@ -0,0 +1,204 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { getAdapter } from "../adapters/registry.js";
+import { parseJsonFromText } from "./parse-json.js";
+/** Maximum interactions to flag for deep evaluation. */
+const MAX_FLAGS = 30;
+/** Maximum characters for the sparse index in the triage prompt. */
+const MAX_SPARSE_INDEX_CHARS = 60_000;
+/**
+ * Run the triage LLM pass on a sparse index.
+ * Scans the compressed transcript for patterns, classifies interactions,
+ * and flags areas of concern for deep evaluation.
+ *
+ * Returns an empty triage result on failure (no flags, no patterns).
+ */
+export async function runTriage(result, sparseIndex) {
+    const prompt = buildTriagePrompt(result, sparseIndex);
+    const responseText = await callJudge(result, prompt);
+    return parseTriageResponse(responseText);
+}
+function buildTriagePrompt(result, sparseIndex) {
+    const { stats } = sparseIndex;
+    return `You are an expert evaluator for AXIS, an AI agent testing framework.
+
+You are analyzing an agent's execution trace to identify areas that need deeper evaluation.
+
+SCENARIO: ${result.scenarioName}
+
+TASK GIVEN TO AGENT:
+${result.prompt}
+
+SPARSE INDEX (${stats.totalInteractions} interactions):
+${truncateSparseIndex(sparseIndex.lines)}
+
+STATS:
+- Environment interactions: ${stats.byCategory.environment}
+- Service interactions: ${stats.byCategory.service}
+- Agent interactions: ${stats.byCategory.agent}
+- Errors: ${stats.totalErrors}
+- Total duration: ${stats.totalDurationMs}ms
+
+CONTEXT FOR EVALUATION:
+- Tool discovery (e.g., ToolSearch, ListTools) and agent configuration reads are required infrastructure — do not flag as unnecessary unless genuinely redundant (same query repeated).
+- Byte counts in sparse lines show total I/O transferred, not file content size. Small results are normal for write/edit confirmations.
+- Tool durations include system overhead (SDK roundtrips, sandbox setup, process spawning) — do not flag interactions solely for being slow unless the agent caused the slowness through redundant or unnecessary work.
+- If a service call (API request, web fetch) returned structured, usable content and the agent used it to complete the task, do not flag it for concerns about hypothetical missing content or page size.
+
+INSTRUCTIONS:
+Analyze this agent execution trace and identify areas of concern.
+
+For each interaction you want to flag for deep evaluation, specify:
+1. The interaction ID (#N)
+2. Why it needs deeper review
+3. Which dimensions to evaluate: success, speed, weight, relevance, necessity
+
+Also identify any patterns across interactions:
+- Repeated failures or retries
+- Redundant service calls (same endpoint called multiple times)
+- Excessive environment operations for simple tasks
+- Wasted agent reasoning that didn't lead to progress
+- Unnecessary interactions given prior context
+
+Respond with ONLY valid JSON:
+{
+  "flaggedInteractions": [
+    {"id": 1, "reason": "description of concern", "concerns": ["success", "relevance"]},
+    ...
+  ],
+  "patterns": [
+    {"description": "pattern description", "interactionIds": [1, 2, 3], "severity": "high"},
+    ...
+  ],
+  "categoryNotes": {
+    "environment": "summary of environment interaction quality",
+    "service": "summary of service interaction quality",
+    "agent": "summary of agent reasoning quality"
+  }
+}
+
+Flag at most ${MAX_FLAGS} interactions. Focus on the most significant issues.
+Non-flagged interactions will receive default passing scores.`;
+}
+async function callJudge(runResult, prompt) {
+    const adapter = getAdapter(runResult.agentConfig.adapter);
+    const workspace = fs.mkdtempSync(path.join(os.tmpdir(), "axis-triage-"));
+    try {
+        const output = await adapter.run({
+            prompt,
+            config: runResult.agentConfig,
+            scenario: {
+                key: "__triage__",
+                name: "AXIS Triage",
+                prompt,
+                rubric: [],
+            },
+            workingDirectory: workspace,
+        });
+        return output.result ?? "";
+    }
+    finally {
+        try {
+            fs.rmSync(workspace, { recursive: true, force: true });
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+/**
+ * Parse the triage LLM response. Returns empty result on failure.
+ */
+export function parseTriageResponse(responseText) {
+    const empty = {
+        flaggedInteractions: [],
+        patterns: [],
+        categoryNotes: {
+            environment: "",
+            service: "",
+            agent: "",
+        },
+    };
+    const parsed = parseJsonFromText(responseText);
+    if (!parsed)
+        return empty;
+    const flaggedInteractions = parseFlags(parsed.flaggedInteractions);
+    const patterns = parsePatterns(parsed.patterns);
+    const categoryNotes = parseCategoryNotes(parsed.categoryNotes);
+    return { flaggedInteractions, patterns, categoryNotes };
+}
+function parseFlags(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const validConcerns = new Set(["success", "speed", "weight", "relevance", "necessity"]);
+    const flags = [];
+    for (const item of raw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const obj = item;
+        if (typeof obj.id !== "number" || typeof obj.reason !== "string")
+            continue;
+        const concerns = Array.isArray(obj.concerns)
+            ? obj.concerns.filter((c) => typeof c === "string" && validConcerns.has(c))
+            : [];
+        flags.push({
+            id: obj.id,
+            reason: obj.reason,
+            concerns: concerns.length > 0 ? concerns : ["success", "relevance"],
+        });
+        if (flags.length >= MAX_FLAGS)
+            break;
+    }
+    return flags;
+}
+function parsePatterns(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const validSeverities = new Set(["low", "medium", "high"]);
+    const patterns = [];
+    for (const item of raw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const obj = item;
+        if (typeof obj.description !== "string")
+            continue;
+        const interactionIds = Array.isArray(obj.interactionIds)
+            ? obj.interactionIds.filter((id) => typeof id === "number")
+            : [];
+        const severity = typeof obj.severity === "string" && validSeverities.has(obj.severity)
+            ? obj.severity
+            : "medium";
+        patterns.push({ description: obj.description, interactionIds, severity });
+    }
+    return patterns;
+}
+function parseCategoryNotes(raw) {
+    const defaults = {
+        environment: "",
+        service: "",
+        agent: "",
+    };
+    if (!raw || typeof raw !== "object")
+        return defaults;
+    const obj = raw;
+    return {
+        environment: typeof obj.environment === "string" ? obj.environment : "",
+        service: typeof obj.service === "string" ? obj.service : "",
+        agent: typeof obj.agent === "string" ? obj.agent : "",
+    };
+}
+function truncateSparseIndex(lines) {
+    let totalChars = 0;
+    const included = [];
+    for (const line of lines) {
+        if (totalChars + line.length > MAX_SPARSE_INDEX_CHARS) {
+            included.push(`... (${lines.length - included.length} more interactions omitted)`);
+            break;
+        }
+        included.push(line);
+        totalChars += line.length;
+    }
+    return included.join("\n");
+}
+//# sourceMappingURL=triage.js.map

package/dist/scoring/triage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.js","sourceRoot":"","sources":["../../src/scoring/triage.ts"],"names":[],"mappings":"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"}

package/dist/skills/resolver.d.ts

@@ -0,0 +1,19 @@
+import type { ResolvedSkill, SkillSource } from "../types/config.js";
+import type { Logger } from "../types/output.js";
+/** Extract the source string from a SkillSource entry. */
+export declare function skillSourceString(entry: SkillSource): string;
+export interface ResolveSkillsOptions {
+    sources: SkillSource[];
+    configDir: string;
+    cacheDir: string;
+    logger: Logger;
+    refresh?: boolean;
+}
+export declare function resolveSkills(options: ResolveSkillsOptions): Promise<ResolvedSkill[]>;
+/**
+ * Find the directory containing SKILL.md.
+ * Checks the root directory first, then one level of subdirectories
+ * (for repos where the skill lives in a subdirectory).
+ */
+export declare function findSkillDir(dir: string): string | null;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/skills/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/skills/resolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAKjD,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE5D;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAM3F;AAsCD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBvD"}

package/dist/skills/resolver.js

@@ -0,0 +1,95 @@
+import { execFileSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+const GITHUB_URL_RE = /^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?$/;
+const GITHUB_SHORTHAND_RE = /^([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+)$/;
+/** Extract the source string from a SkillSource entry. */
+export function skillSourceString(entry) {
+    return typeof entry === "string" ? entry : entry.source;
+}
+export async function resolveSkills(options) {
+    const results = [];
+    for (const entry of options.sources) {
+        results.push(resolveSkill(entry, options));
+    }
+    return results;
+}
+function resolveSkill(entry, options) {
+    const { configDir, cacheDir, logger, refresh } = options;
+    const source = skillSourceString(entry);
+    const axisCategory = typeof entry === "object" ? entry.axisCategory : undefined;
+    let dir;
+    let name;
+    if (source.startsWith("./") || source.startsWith("../") || source.startsWith("/")) {
+        // Local path — resolve relative to config directory
+        dir = path.resolve(configDir, source);
+        name = path.basename(dir);
+    }
+    else if (GITHUB_URL_RE.test(source)) {
+        const match = source.match(GITHUB_URL_RE);
+        const [, owner, repo] = match;
+        name = `${owner}-${repo}`;
+        dir = path.join(cacheDir, owner, repo);
+        cloneIfNeeded(source.replace(/\.git$/, "") + ".git", dir, logger, refresh);
+    }
+    else if (GITHUB_SHORTHAND_RE.test(source)) {
+        const [owner, repo] = source.split("/");
+        name = `${owner}-${repo}`;
+        dir = path.join(cacheDir, owner, repo);
+        cloneIfNeeded(`https://github.com/${owner}/${repo}.git`, dir, logger, refresh);
+    }
+    else {
+        throw new Error(`Invalid skill source: "${source}". Expected a local path (./...), GitHub shorthand (owner/repo), or GitHub URL.`);
+    }
+    const skillDir = findSkillDir(dir);
+    if (!skillDir) {
+        throw new Error(`No SKILL.md found in skill "${source}" (looked in ${dir})`);
+    }
+    return { name, path: skillDir, ...(axisCategory ? { axisCategory } : {}) };
+}
+/**
+ * Find the directory containing SKILL.md.
+ * Checks the root directory first, then one level of subdirectories
+ * (for repos where the skill lives in a subdirectory).
+ */
+export function findSkillDir(dir) {
+    if (fs.existsSync(path.join(dir, "SKILL.md"))) {
+        return dir;
+    }
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name.startsWith(".") || entry.name === "node_modules") {
+                continue;
+            }
+            const nested = path.join(dir, entry.name);
+            if (fs.existsSync(path.join(nested, "SKILL.md"))) {
+                return nested;
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or isn't readable
+    }
+    return null;
+}
+function cloneIfNeeded(url, targetDir, logger, refresh) {
+    if (fs.existsSync(targetDir) && !refresh) {
+        return;
+    }
+    if (fs.existsSync(targetDir)) {
+        fs.rmSync(targetDir, { recursive: true, force: true });
+    }
+    fs.mkdirSync(path.dirname(targetDir), { recursive: true });
+    logger.info(`Cloning skill: ${url}`);
+    try {
+        execFileSync("git", ["clone", "--depth", "1", "--single-branch", url, targetDir], {
+            stdio: ["ignore", "ignore", "pipe"],
+            timeout: 30_000,
+        });
+    }
+    catch (err) {
+        throw new Error(`Failed to clone skill from ${url}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=resolver.js.map

package/dist/skills/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/skills/resolver.ts"],"names":[],"mappings":"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"}

package/dist/transcript/categorize.d.ts

@@ -0,0 +1,24 @@
+import type { TranscriptEntry } from "../types/agent.js";
+import type { InteractionCategory, McpCategoryOverrides } from "../types/scoring.js";
+/** Optional context for richer classification of tool_use entries. */
+export interface CategorizationContext {
+    /** Summarized tool input (e.g. "file_path: src/index.ts"). */
+    toolInputSummary?: string | null;
+    /** Whether this entry was detected as a network call during normalization. */
+    isNetworkCall?: boolean;
+    /** MCP server category overrides from config. */
+    mcpCategoryOverrides?: McpCategoryOverrides;
+}
+/**
+ * Classify a transcript entry into one or more interaction categories.
+ *
+ * - **environment**: OS, filesystem, shell, dev tooling
+ * - **agent**: assistant reasoning, system messages, self-configuration
+ * - **service**: external APIs, MCP tools, network calls
+ *
+ * An interaction can belong to multiple categories (e.g. `Bash(curl ...)` is both
+ * environment and service). Classification is deterministic from tool name, entry type,
+ * and optional context.
+ */
+export declare function categorizeInteraction(entryType: TranscriptEntry["type"], toolName: string | null, context?: CategorizationContext): InteractionCategory[];
+//# sourceMappingURL=categorize.d.ts.map

package/dist/transcript/categorize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categorize.d.ts","sourceRoot":"","sources":["../../src/transcript/categorize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAuIrF,sEAAsE;AACtE,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC,EAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,mBAAmB,EAAE,CA8CvB"}

package/dist/transcript/categorize.js

@@ -0,0 +1,233 @@
+/**
+ * Tool names that represent environment interactions —
+ * OS, filesystem, shell, dev tooling, package managers, version control.
+ * All entries are lowercase; lookup is case-insensitive.
+ */
+const ENVIRONMENT_TOOL_NAMES = new Set([
+    // Shell / execution
+    "bash",
+    "shell",
+    "terminal",
+    "exec",
+    "command_execution",
+    // File operations
+    "read",
+    "write",
+    "edit",
+    "glob",
+    "grep",
+    "notebookedit",
+    "cat",
+    "head",
+    "tail",
+    "sed",
+    "awk",
+    "find",
+    "ls",
+    "mkdir",
+    "rm",
+    "cp",
+    "mv",
+    "touch",
+    "chmod",
+    "chown",
+    // Version control
+    "git",
+    // Package managers
+    "npm",
+    "npx",
+    "yarn",
+    "pnpm",
+    "pip",
+    "pip3",
+    "cargo",
+    "go",
+    "bundle",
+    "gem",
+    "composer",
+    "brew",
+    "apt",
+    "apt-get",
+    // Build / test tools
+    "make",
+    "cmake",
+    "tsc",
+    "node",
+    "python",
+    "python3",
+    "ruby",
+    "java",
+    "javac",
+    "docker",
+    "kubectl",
+    // File system navigation
+    "cd",
+    "pwd",
+    "which",
+    "whereis",
+    "file",
+    "stat",
+    "du",
+    "df",
+    // Text processing
+    "sort",
+    "uniq",
+    "wc",
+    "diff",
+    "patch",
+    "tr",
+    "cut",
+    "xargs",
+]);
+/**
+ * Prefixes for tool names that indicate environment interactions.
+ * Shell commands invoked via adapters often use these prefixes.
+ */
+const ENVIRONMENT_TOOL_PREFIXES = ["file_", "fs_", "dir_", "mcp__filesystem__"];
+/**
+ * Tool names that represent agent-internal operations —
+ * metacognition, planning, task management, tool discovery.
+ * These are the agent orchestrating itself, not interacting with external services.
+ * All entries are lowercase; lookup is case-insensitive.
+ */
+const AGENT_TOOL_NAMES = new Set([
+    // Tool discovery / selection
+    "toolsearch",
+    "tool_search",
+    "listtoolsets",
+    "list_tools",
+    // Task management
+    "task",
+    "taskcreate",
+    "taskupdate",
+    "taskget",
+    "tasklist",
+    "taskoutput",
+    "taskstop",
+    "todoread",
+    "todowrite",
+    "todo_read",
+    "todo_write",
+    // Planning / mode control
+    "enterplanmode",
+    "exitplanmode",
+    "enter_plan_mode",
+    "exit_plan_mode",
+    // User interaction
+    "askuserquestion",
+    "askfollowupquestion",
+    "ask_user_question",
+    "ask_followup_question",
+    // Skill invocation
+    "skill",
+]);
+/**
+ * Path patterns that indicate agent-internal file operations.
+ * When an environment tool (Read, Write, etc.) targets one of these paths,
+ * it's the agent configuring itself — not a meaningful environment interaction.
+ */
+const AGENT_INTERNAL_PATH_PATTERNS = [".claude/", ".codex/", ".gemini/", "CLAUDE.md", "AGENTS.md"];
+/**
+ * Classify a transcript entry into one or more interaction categories.
+ *
+ * - **environment**: OS, filesystem, shell, dev tooling
+ * - **agent**: assistant reasoning, system messages, self-configuration
+ * - **service**: external APIs, MCP tools, network calls
+ *
+ * An interaction can belong to multiple categories (e.g. `Bash(curl ...)` is both
+ * environment and service). Classification is deterministic from tool name, entry type,
+ * and optional context.
+ */
+export function categorizeInteraction(entryType, toolName, context) {
+    // Agent-internal: assistant reasoning and system messages
+    if (entryType === "assistant" || entryType === "system" || entryType === "user") {
+        return ["agent"];
+    }
+    // Error entries default to agent (agent encountered an error)
+    if (entryType === "error") {
+        return ["agent"];
+    }
+    // Tool-based entries: classify by tool name
+    if (toolName) {
+        if (isAgentTool(toolName)) {
+            return ["agent"];
+        }
+        // MCP category override: authoritative when set
+        const mcpOverride = resolveMcpCategoryOverride(toolName, context?.mcpCategoryOverrides);
+        if (mcpOverride) {
+            return [mcpOverride];
+        }
+        if (isEnvironmentTool(toolName)) {
+            // Environment tools targeting agent-internal paths are agent operations
+            if (context?.toolInputSummary && isAgentInternalPath(context.toolInputSummary)) {
+                return ["agent"];
+            }
+            // Environment tools that also make network calls belong to both categories
+            if (context?.isNetworkCall) {
+                return ["environment", "service"];
+            }
+            return ["environment"];
+        }
+        // Everything else is a service interaction
+        return ["service"];
+    }
+    // tool_result without a tool name — follow the pair's category
+    // (will be resolved during sparse index building via the paired tool_use)
+    // Default to service as the safest assumption for unknown tools
+    if (entryType === "tool_result") {
+        return ["service"];
+    }
+    return ["agent"];
+}
+/**
+ * Check if a tool name matches an MCP server with a category override.
+ * MCP tool names follow the pattern: mcp__<servername>__<toolname>
+ */
+function resolveMcpCategoryOverride(toolName, overrides) {
+    if (!overrides || overrides.size === 0)
+        return null;
+    const lower = toolName.toLowerCase();
+    if (!lower.startsWith("mcp__"))
+        return null;
+    const withoutPrefix = lower.slice(5); // remove "mcp__"
+    const separatorIdx = withoutPrefix.indexOf("__");
+    if (separatorIdx < 0)
+        return null;
+    const serverName = withoutPrefix.slice(0, separatorIdx);
+    for (const [name, category] of overrides) {
+        if (name.toLowerCase() === serverName) {
+            return category;
+        }
+    }
+    return null;
+}
+/**
+ * Check if the tool input summary references an agent-internal path.
+ * These are paths used for agent self-configuration (skills, settings, instructions).
+ */
+function isAgentInternalPath(inputSummary) {
+    const lower = inputSummary.toLowerCase();
+    return AGENT_INTERNAL_PATH_PATTERNS.some((pattern) => lower.includes(pattern.toLowerCase()));
+}
+/**
+ * Check if a tool name represents an environment tool.
+ * Case-insensitive: all entries in ENVIRONMENT_TOOL_NAMES are lowercase.
+ */
+function isEnvironmentTool(toolName) {
+    const lower = toolName.toLowerCase();
+    if (ENVIRONMENT_TOOL_NAMES.has(lower))
+        return true;
+    for (const prefix of ENVIRONMENT_TOOL_PREFIXES) {
+        if (lower.startsWith(prefix))
+            return true;
+    }
+    return false;
+}
+/**
+ * Check if a tool name represents an agent-internal operation.
+ * Case-insensitive: all entries in AGENT_TOOL_NAMES are lowercase.
+ */
+function isAgentTool(toolName) {
+    return AGENT_TOOL_NAMES.has(toolName.toLowerCase());
+}
+//# sourceMappingURL=categorize.js.map

package/dist/transcript/categorize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categorize.js","sourceRoot":"","sources":["../../src/transcript/categorize.ts"],"names":[],"mappings":"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"}

package/dist/transcript/classify.d.ts

@@ -0,0 +1,7 @@
+import type { ExtractedUrl } from "./types.js";
+/**
+ * Determine if a tool call represents a network-related action.
+ * Uses tool name matching and URL presence in tool input.
+ */
+export declare function isNetworkCall(toolName: string | null, urls: ExtractedUrl[]): boolean;
+//# sourceMappingURL=classify.d.ts.map

package/dist/transcript/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/transcript/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmB/C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,OAAO,CAUpF"}

package/dist/transcript/classify.js

@@ -0,0 +1,32 @@
+/** Tool names that are known to make network requests. */
+const NETWORK_TOOL_NAMES = new Set([
+    "WebFetch",
+    "Fetch",
+    "web_fetch",
+    "WebSearch",
+    "web_search",
+    "mcp_fetch",
+    "http_request",
+    "curl",
+    "wget",
+    "fetch",
+]);
+/** Prefixes that indicate MCP-proxied tools (often network-related). */
+const NETWORK_TOOL_PREFIXES = ["mcp__"];
+/**
+ * Determine if a tool call represents a network-related action.
+ * Uses tool name matching and URL presence in tool input.
+ */
+export function isNetworkCall(toolName, urls) {
+    if (toolName) {
+        if (NETWORK_TOOL_NAMES.has(toolName))
+            return true;
+        for (const prefix of NETWORK_TOOL_PREFIXES) {
+            if (toolName.startsWith(prefix))
+                return true;
+        }
+    }
+    // If the tool input contains URLs, it's likely a network call
+    return urls.length > 0;
+}
+//# sourceMappingURL=classify.js.map

package/dist/transcript/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/transcript/classify.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,UAAU;IACV,OAAO;IACP,WAAW;IACX,WAAW;IACX,YAAY;IACZ,WAAW;IACX,cAAc;IACd,MAAM;IACN,MAAM;IACN,OAAO;CACR,CAAC,CAAC;AAEH,wEAAwE;AACxE,MAAM,qBAAqB,GAAG,CAAC,OAAO,CAAC,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAuB,EAAE,IAAoB;IACzE,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAClD,KAAK,MAAM,MAAM,IAAI,qBAAqB,EAAE,CAAC;YAC3C,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AACzB,CAAC"}