@uvl000/claude-trace 3.0.13-workflowexp.1

package/dist/tools/opencode.js

@@ -0,0 +1,401 @@
+"use strict";
+/**
+ * @file tools/opencode.ts
+ * @description Tool profile for OpenCode CLI tracing.
+ *
+ * This module implements the {@link ToolProfile} interface for OpenCode.
+ * Unlike Claude Code, OpenCode **always** uses reverse-proxy interception —
+ * there is no Node.js `fetch` hook path.
+ *
+ * Key responsibilities:
+ *
+ * - **Binary resolution** — locate `opencode` on PATH with the same
+ *   MSYS/alias handling used by the Claude profile.
+ * - **Config discovery** — read `opencode.json` following OpenCode's
+ *   precedence: `OPENCODE_CONFIG` → `OPENCODE_CONFIG_DIR` → global → project.
+ * - **Model-based routing** — build a `Record<string, ModelRoute>` from
+ *   configured providers/models so `reverse-proxy.ts` can pick the correct
+ *   upstream and API format (`anthropic` vs `openai`) per request.
+ * - **Runtime config injection** — set `OPENCODE_CONFIG_CONTENT` with all
+ *   provider `baseURL` values rewritten to the local proxy, without touching
+ *   the user's on-disk config file.
+ *
+ * Built-in `models.dev` providers not listed in `opencode.json` are outside
+ * the scope of interception; only explicitly configured providers are routed.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNativeBinary = exports.opencodeProfile = void 0;
+exports.getOpenCodeBinaryPath = getOpenCodeBinaryPath;
+exports.buildModelRouteMap = buildModelRouteMap;
+exports.inferApiFormat = inferApiFormat;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const api_format_1 = require("../adapt/api-format");
+const binary_utils_1 = require("./binary-utils");
+Object.defineProperty(exports, "isNativeBinary", { enumerable: true, get: function () { return binary_utils_1.isNativeBinary; } });
+const cli_common_1 = require("../cli/cli-common");
+/**
+ * Locate the OpenCode CLI executable on PATH or in common install locations.
+ *
+ * @param customPath - Optional explicit path from `--opencode-path`.
+ * @returns Resolved path to the OpenCode launcher.
+ * @throws Exits the process with code 1 if no binary is found.
+ */
+function findOpenCodePath(customPath) {
+    if (customPath) {
+        if (!fs.existsSync(customPath)) {
+            (0, cli_common_1.log)(`OpenCode binary not found at specified path: ${customPath}`, "red");
+            process.exit(1);
+        }
+        return customPath;
+    }
+    const isWindows = process.platform === "win32";
+    try {
+        const findCmd = isWindows ? "where.exe opencode" : "which opencode";
+        let opencodePath = (0, child_process_1.execSync)(findCmd, { encoding: "utf-8" }).trim().split(/\r?\n/)[0];
+        // Normalize MSYS/Git Bash drive-letter paths.
+        const msysMatch = opencodePath.match(/^\/([a-zA-Z])\//);
+        if (msysMatch) {
+            opencodePath = msysMatch[1].toUpperCase() + ":/" + opencodePath.slice(3);
+        }
+        // Expand shell alias output from zsh/fish.
+        const aliasMatch = opencodePath.match(/:\s*aliased to\s+(.+)$/);
+        if (aliasMatch && aliasMatch[1]) {
+            opencodePath = aliasMatch[1];
+        }
+        return opencodePath;
+    }
+    catch {
+        const possiblePaths = isWindows
+            ? [
+                path.join(os.homedir(), ".local", "bin", "opencode.exe"),
+                path.join(process.env.APPDATA || "", "npm", "opencode.cmd"),
+                path.join(process.env.APPDATA || "", "npm", "opencode"),
+            ]
+            : [
+                path.join(os.homedir(), ".local", "bin", "opencode"),
+                "/opt/homebrew/bin/opencode",
+                "/usr/local/bin/opencode",
+                "/usr/bin/opencode",
+            ];
+        for (const p of possiblePaths) {
+            if (fs.existsSync(p)) {
+                return p;
+            }
+        }
+        (0, cli_common_1.log)(`OpenCode CLI not found in PATH or common locations`, "red");
+        (0, cli_common_1.log)(`Please install OpenCode first: https://opencode.ai`, "red");
+        process.exit(1);
+    }
+}
+/**
+ * Resolve symlinks to the real OpenCode executable path.
+ *
+ * @param customPath - Optional explicit path from `--opencode-path`.
+ * @returns Canonical binary path.
+ */
+function getOpenCodeBinaryPath(customPath) {
+    const opencodePath = findOpenCodePath(customPath);
+    try {
+        return fs.realpathSync(opencodePath);
+    }
+    catch {
+        return opencodePath;
+    }
+}
+/**
+ * Resolve which `opencode.json` file to read, following OpenCode precedence.
+ *
+ * Order: `OPENCODE_CONFIG` → `OPENCODE_CONFIG_DIR/opencode.json` →
+ * `~/.config/opencode/opencode.json` → `.opencode/opencode.json`.
+ *
+ * @returns Absolute path to config file, or null if none exists.
+ */
+function resolveOpenCodeConfigPath() {
+    if (process.env.OPENCODE_CONFIG && fs.existsSync(process.env.OPENCODE_CONFIG)) {
+        return process.env.OPENCODE_CONFIG;
+    }
+    if (process.env.OPENCODE_CONFIG_DIR) {
+        const configPath = path.join(process.env.OPENCODE_CONFIG_DIR, "opencode.json");
+        if (fs.existsSync(configPath)) {
+            return configPath;
+        }
+    }
+    const globalConfig = path.join(os.homedir(), ".config", "opencode", "opencode.json");
+    if (fs.existsSync(globalConfig)) {
+        return globalConfig;
+    }
+    const projectConfig = path.join(process.cwd(), ".opencode", "opencode.json");
+    if (fs.existsSync(projectConfig)) {
+        return projectConfig;
+    }
+    return null;
+}
+/**
+ * Load and parse OpenCode config, returning an empty object on missing/invalid file.
+ *
+ * @returns Parsed OpenCode config or `{}`.
+ */
+function readOpenCodeConfig() {
+    const configPath = resolveOpenCodeConfigPath();
+    if (!configPath) {
+        return {};
+    }
+    try {
+        return JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Map an OpenCode SDK npm package name to the wire API format.
+ *
+ * Delegates to `api-format.ts` which recognizes `@ai-sdk/anthropic`,
+ * `@ai-sdk/openai`, `@ai-sdk/openai-compatible`, etc.
+ *
+ * @param npm - Package name from provider/model config (e.g. "@ai-sdk/anthropic").
+ * @returns Detected API format for proxy parsing.
+ */
+function inferApiFormat(npm) {
+    return (0, api_format_1.inferApiFormatFromNpm)(npm);
+}
+/**
+ * Resolve the upstream base URL for a single OpenCode provider.
+ *
+ * Uses explicit `options.baseURL` when set; falls back to built-in defaults
+ * for well-known provider IDs (`anthropic`, `openai`). Providers without a
+ * resolvable URL are skipped during route building.
+ *
+ * @param providerId - Provider key from `opencode.json`.
+ * @param provider - Provider configuration block.
+ * @returns Upstream base URL or null if the provider cannot be routed.
+ */
+function resolveProviderBaseUrl(providerId, provider) {
+    if (provider?.options?.baseURL) {
+        return provider.options.baseURL;
+    }
+    if (providerId === "anthropic") {
+        return process.env.ANTHROPIC_BASE_URL || "https://api.anthropic.com";
+    }
+    if (providerId === "openai") {
+        return process.env.OPENAI_BASE_URL || "https://api.openai.com/v1";
+    }
+    return null;
+}
+/**
+ * Build a model-keyed routing map for the reverse proxy.
+ *
+ * Keys include bare `modelId`, `providerId/modelId`, and `providerId/*`
+ * fallback entries. Providers without explicit models get a wildcard-only route.
+ * The proxy looks up routes by model name at request time.
+ *
+ * @param config - Parsed OpenCode configuration.
+ * @returns Map from model lookup keys to {@link ModelRoute} entries.
+ */
+function buildModelRouteMap(config) {
+    const map = {};
+    for (const [providerId, provider] of Object.entries(config.provider || {})) {
+        const baseURL = resolveProviderBaseUrl(providerId, provider);
+        if (!baseURL) {
+            continue;
+        }
+        const providerNpm = typeof provider.npm === "string" ? provider.npm : "";
+        const modelIds = Object.keys(provider.models || {});
+        if (modelIds.length === 0) {
+            // Provider configured but no per-model entries — route everything via wildcard.
+            const apiFormat = inferApiFormat(providerNpm);
+            const fallbackRoute = {
+                providerId,
+                modelId: "*",
+                upstreamBaseUrl: baseURL,
+                npm: providerNpm,
+                apiFormat,
+                isProviderFallback: true,
+            };
+            map[`${providerId}/*`] = fallbackRoute;
+            continue;
+        }
+        for (const modelId of modelIds) {
+            const modelConfig = provider.models?.[modelId];
+            // Model-level npm overrides provider-level npm for format detection.
+            const modelNpm = typeof modelConfig?.npm === "string" ? modelConfig.npm : providerNpm;
+            const route = {
+                providerId,
+                modelId,
+                upstreamBaseUrl: baseURL,
+                npm: modelNpm,
+                apiFormat: inferApiFormat(modelNpm),
+            };
+            map[modelId] = route;
+            map[`${providerId}/${modelId}`] = route;
+        }
+        // Wildcard fallback for models not explicitly listed in config.
+        const providerFallback = {
+            providerId,
+            modelId: "*",
+            upstreamBaseUrl: baseURL,
+            npm: providerNpm,
+            apiFormat: inferApiFormat(providerNpm),
+            isProviderFallback: true,
+        };
+        map[`${providerId}/*`] = providerFallback;
+    }
+    return map;
+}
+/**
+ * List provider-level upstream routes for display and proxy bootstrap.
+ *
+ * @param config - Parsed OpenCode configuration.
+ * @returns Array of provider routes with resolvable base URLs.
+ */
+function listRoutesFromConfig(config) {
+    const routes = [];
+    for (const [id, provider] of Object.entries(config.provider || {})) {
+        const baseURL = resolveProviderBaseUrl(id, provider);
+        if (baseURL) {
+            routes.push({ id, upstreamBaseUrl: baseURL });
+        }
+    }
+    return routes;
+}
+/**
+ * Ensure localhost bypasses system HTTP proxy so OpenCode talks to our local reverse proxy.
+ *
+ * Corporate proxies often intercept `HTTP_PROXY`; without `NO_PROXY` for
+ * `127.0.0.1`, OpenCode would route through the corporate proxy instead of
+ * hitting our local listener.
+ *
+ * @param existing - Current `NO_PROXY` env value, if any.
+ * @returns Merged comma-separated NO_PROXY list including 127.0.0.1 and localhost.
+ */
+function appendNoProxy(existing) {
+    const required = ["127.0.0.1", "localhost"];
+    const current = (existing || "")
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    const merged = [...new Set([...current, ...required])];
+    return merged.join(",");
+}
+/**
+ * OpenCode tool profile consumed by `trace-runner.ts`.
+ *
+ * Always uses reverse-proxy mode. Config injection is inline via
+ * `OPENCODE_CONFIG_CONTENT` — no filesystem overlay to clean up.
+ */
+exports.opencodeProfile = {
+    name: "opencode",
+    displayName: "OpenCode",
+    logDirectory: ".opencode-trace",
+    /** @inheritdoc ToolProfile.findBinary */
+    findBinary(customPath) {
+        return findOpenCodePath(customPath);
+    },
+    /** @inheritdoc ToolProfile.getBinaryPath */
+    getBinaryPath(customPath) {
+        return getOpenCodeBinaryPath(customPath);
+    },
+    /** @inheritdoc ToolProfile.listProviderRoutes */
+    listProviderRoutes() {
+        return listRoutesFromConfig(readOpenCodeConfig());
+    },
+    /** @inheritdoc ToolProfile.listModelRoutes */
+    listModelRoutes() {
+        return buildModelRouteMap(readOpenCodeConfig());
+    },
+    /**
+     * Summarize upstream URLs for CLI startup logging.
+     *
+     * Returns a single URL when one provider is configured, a comma-separated
+     * `id → url` list for multiple providers, or the Anthropic default when
+     * no providers are configured.
+     */
+    readUpstreamBaseUrl() {
+        const routes = listRoutesFromConfig(readOpenCodeConfig());
+        if (routes.length === 0) {
+            return process.env.ANTHROPIC_BASE_URL || "https://api.anthropic.com";
+        }
+        if (routes.length === 1) {
+            return routes[0].upstreamBaseUrl;
+        }
+        return routes.map((route) => `${route.id} → ${route.upstreamBaseUrl}`).join(", ");
+    },
+    /**
+     * Inject runtime OpenCode config so all providers point at the local proxy.
+     *
+     * Serializes a minimal `{ provider: { id: { options: { baseURL } } } }`
+     * object into `OPENCODE_CONFIG_CONTENT`. Removes `OPENCODE_CONFIG` from
+     * the child env because a file path would take precedence over the inline
+     * content override.
+     *
+     * @param proxyUrl - Local proxy URL (e.g. `http://127.0.0.1:PORT`).
+     */
+    prepareSpawnEnv(proxyUrl) {
+        const config = readOpenCodeConfig();
+        const routes = listRoutesFromConfig(config);
+        const proxyBase = proxyUrl.replace(/\/$/, "");
+        if (routes.length === 0) {
+            (0, cli_common_1.log)("Warning: no provider.options.baseURL found in OpenCode config — proxy may not intercept traffic", "yellow");
+        }
+        // All providers share one proxy URL; routing is done by model name at request time.
+        const providerOverrides = {};
+        for (const route of routes) {
+            providerOverrides[route.id] = {
+                options: { baseURL: proxyBase },
+            };
+        }
+        // OPENCODE_CONFIG on disk would override OPENCODE_CONFIG_CONTENT — drop it.
+        const { OPENCODE_CONFIG: _removedConfig, ...restEnv } = process.env;
+        const spawnEnv = {
+            ...restEnv,
+            OPENCODE_CONFIG_CONTENT: JSON.stringify({ provider: providerOverrides }),
+            NO_PROXY: appendNoProxy(process.env.NO_PROXY),
+        };
+        return { tmpDir: null, spawnEnv };
+    },
+    /** No filesystem overlay — `OPENCODE_CONFIG_CONTENT` is ephemeral. */
+    cleanupTempConfig(_tmpDir) {
+        // OPENCODE_CONFIG_CONTENT is inline — nothing to clean up.
+    },
+    /** OpenCode has no Node.js fetch hook; proxy mode only. */
+    supportsNodeInterceptor() {
+        return false;
+    },
+};
+//# sourceMappingURL=opencode.js.map

package/dist/tools/opencode.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @file tools/types.ts
+ * @description Core abstractions for multi-tool tracing via Tool Profiles.
+ *
+ * Each supported CLI (Claude Code, OpenCode, Codex) implements `ToolProfile`
+ * so `trace-runner.ts` can launch the tool with either a Node.js fetch hook
+ * or a local reverse proxy without tool-specific branching in the runner.
+ */
+/** Upstream API endpoint configuration for a single provider (Codex multi-upstream). */
+export interface ProviderRoute {
+    /** Stable route identifier used for path-based dispatch. */
+    id: string;
+    /** Real upstream base URL before proxy rewrite. */
+    upstreamBaseUrl: string;
+    /** Request path prefixes that select this route (Codex multi-upstream). */
+    matchPathPrefixes?: string[];
+    /**
+     * When set, forward to this exact upstream path instead of concatenating
+     * {@link upstreamBaseUrl} path prefix with the request path (Codex Apps MCP remapping).
+     */
+    fixedUpstreamPath?: string;
+}
+/**
+ * Wire format of the upstream LLM API.
+ * Used for parsing, display labels, and adapter selection in the reverse proxy.
+ */
+export type ApiFormat = "anthropic" | "openai" | "openai-responses" | "unknown";
+/**
+ * Model-specific routing entry for OpenCode-style `provider/model` keys.
+ * Maps a configured model to its upstream URL and expected API format.
+ */
+export interface ModelRoute {
+    providerId: string;
+    modelId: string;
+    upstreamBaseUrl: string;
+    /** npm package name hint from OpenCode config (e.g. "@ai-sdk/anthropic"). */
+    npm: string;
+    apiFormat: ApiFormat;
+    /** True when this route matches any model under providerId (e.g. providerId/*). */
+    isProviderFallback?: boolean;
+}
+/**
+ * Pluggable profile describing how to find, configure, and spawn a coding CLI.
+ * Implemented by `claude.ts`, `opencode.ts`, and `codex.ts`.
+ */
+export interface ToolProfile {
+    /** Short machine name: "claude" | "opencode" | "codex". */
+    name: string;
+    /** Human-readable label for CLI output. */
+    displayName: string;
+    /** Relative log directory under cwd (e.g. ".claude-trace"). */
+    logDirectory: string;
+    /** Resolve binary path on PATH or from optional custom override. */
+    findBinary(customPath?: string): string;
+    /** Resolve wrapper scripts/symlinks to the executable used for spawn. */
+    getBinaryPath(customPath?: string): string;
+    /** Default upstream base URL when no per-provider routes exist. */
+    readUpstreamBaseUrl(): string;
+    /** Optional list of provider routes (Codex, multi-provider setups). */
+    listProviderRoutes?(): ProviderRoute[];
+    /** Optional model-keyed routes for OpenCode proxy routing. */
+    listModelRoutes?(): Record<string, ModelRoute>;
+    /**
+     * Build process environment for spawning the tool against the local proxy.
+     * @param proxyUrl - Full local proxy URL (e.g. http://127.0.0.1:PORT)
+     * @returns tmpDir - Overlay config directory to clean up, or null if none
+     * @returns spawnEnv - Complete env vars for child process
+     */
+    prepareSpawnEnv(proxyUrl: string): {
+        tmpDir: string | null;
+        spawnEnv: NodeJS.ProcessEnv;
+    };
+    /** Remove temporary overlay directory created by prepareSpawnEnv. */
+    cleanupTempConfig(tmpDir: string | null): void;
+    /** Whether V1 Node `--require interceptor` mode is supported for this tool. */
+    supportsNodeInterceptor(): boolean;
+}
+/** Runtime options passed from CLI entry points to trace-runner. */
+export interface TraceOptions {
+    /** Log all proxied/fetched requests, not only primary message endpoints. */
+    includeAllRequests?: boolean;
+    /** Open the generated HTML report when the session ends. */
+    openInBrowser?: boolean;
+    /** Custom log file base name (without extension) under logDirectory. */
+    logBaseName?: string;
+    /** Disable redaction of Authorization, Cookie, and similar headers. */
+    logSensitiveHeaders?: boolean;
+    /** User-supplied path to the tool binary (--claude-path, etc.). */
+    customBinaryPath?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC7B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,SAAS,CAAC;IACrB,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,yEAAyE;IACzE,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,mEAAmE;IACnE,mBAAmB,IAAI,MAAM,CAAC;IAC9B,uEAAuE;IACvE,kBAAkB,CAAC,IAAI,aAAa,EAAE,CAAC;IACvC,8DAA8D;IAC9D,eAAe,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/C;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,CAAC;IAC1F,qEAAqE;IACrE,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/C,+EAA+E;IAC/E,uBAAuB,IAAI,OAAO,CAAC;CACnC;AAED,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC5B,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/tools/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * @file tools/types.ts
+ * @description Core abstractions for multi-tool tracing via Tool Profiles.
+ *
+ * Each supported CLI (Claude Code, OpenCode, Codex) implements `ToolProfile`
+ * so `trace-runner.ts` can launch the tool with either a Node.js fetch hook
+ * or a local reverse proxy without tool-specific branching in the runner.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}