@burtson-labs/host-kit 0.3.1

package/dist/tools/testRunTool.d.ts

@@ -0,0 +1,59 @@
+/**
+ * test_run — the highest-leverage missing tool flagged in Bandit's
+ * 2026-05-10 self-eval. Closes the round-trip where the agent has to
+ * guess the test framework and shell out via raw run_command, fish
+ * through the output, and report fuzzily. Instead:
+ *
+ *   1. Auto-detect the framework from workspace files (vitest, jest,
+ *      pytest, go, cargo, dotnet, npm-script fallback).
+ *   2. Run the appropriate command (with an optional `pattern` to
+ *      scope to specific tests / files).
+ *   3. Parse the output into a tight summary: framework, cwd,
+ *      `N passed, M failed`, the first few failure messages.
+ *
+ * Why a dedicated tool rather than "tell the model to run pnpm test":
+ * (a) detection is opinionated, doing it once is cheaper than the model
+ *     guessing; (b) parsed output keeps tool-result size bounded so big
+ *     suites don't flood the context with 5000 lines of pass logs;
+ *     (c) the model gets a deterministic shape to react to, making
+ *     fix-it loops actually closeable.
+ */
+import type { AgentTool, ToolExecutionContext } from '@burtson-labs/agent-core';
+export type TestFramework = 'vitest' | 'jest' | 'pytest' | 'go' | 'cargo' | 'dotnet' | 'npm-script';
+/**
+ * Detect the test framework by inspecting the workspace at `cwd`. Tries
+ * config files first, then dependency lookups, finally falls back to a
+ * generic `npm test` script if one exists. Returns `null` if nothing
+ * looks runnable — the tool surfaces a clear "I don't know how to test
+ * this" message rather than blindly running `npm test` and hanging.
+ */
+export declare function detectTestFramework(ctx: ToolExecutionContext, cwd: string): Promise<TestFramework | null>;
+/**
+ * Build the command + args for a given framework. `pattern` is the
+ * user-supplied test name / file filter. Each framework's filter flag
+ * is different — handled here so the agent doesn't have to know.
+ */
+export declare function buildTestCommand(framework: TestFramework, pattern?: string): {
+    cmd: string;
+    args: string[];
+};
+/**
+ * Parse stdout+stderr from a test run into a structured summary. We
+ * extract the `N passed, M failed` headline plus the first few
+ * failure snippets. Best-effort per framework — when parsing fails,
+ * we fall back to "(unable to parse summary, see raw output)" and
+ * the agent still gets the raw text.
+ */
+export interface ParsedTestSummary {
+    passed?: number;
+    failed?: number;
+    skipped?: number;
+    /** Brief one-line description of each failed test (first MAX_FAILURE_SNIPPETS). */
+    failureNames: string[];
+}
+export declare function parseTestOutput(framework: TestFramework, stdout: string, stderr: string): ParsedTestSummary;
+/**
+ * The agent-facing tool.
+ */
+export declare function buildTestRunTool(): AgentTool;
+//# sourceMappingURL=testRunTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testRunTool.d.ts","sourceRoot":"","sources":["../../src/tools/testRunTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAc,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAE5F,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,IAAI,GACJ,OAAO,GACP,QAAQ,GACR,YAAY,CAAC;AAKjB;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,oBAAoB,EACzB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAkD/B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA4B5G;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAqF3G;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,CAoE5C"}

package/dist/tools/testRunTool.js

@@ -0,0 +1,308 @@
+"use strict";
+/**
+ * test_run — the highest-leverage missing tool flagged in Bandit's
+ * 2026-05-10 self-eval. Closes the round-trip where the agent has to
+ * guess the test framework and shell out via raw run_command, fish
+ * through the output, and report fuzzily. Instead:
+ *
+ *   1. Auto-detect the framework from workspace files (vitest, jest,
+ *      pytest, go, cargo, dotnet, npm-script fallback).
+ *   2. Run the appropriate command (with an optional `pattern` to
+ *      scope to specific tests / files).
+ *   3. Parse the output into a tight summary: framework, cwd,
+ *      `N passed, M failed`, the first few failure messages.
+ *
+ * Why a dedicated tool rather than "tell the model to run pnpm test":
+ * (a) detection is opinionated, doing it once is cheaper than the model
+ *     guessing; (b) parsed output keeps tool-result size bounded so big
+ *     suites don't flood the context with 5000 lines of pass logs;
+ *     (c) the model gets a deterministic shape to react to, making
+ *     fix-it loops actually closeable.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectTestFramework = detectTestFramework;
+exports.buildTestCommand = buildTestCommand;
+exports.parseTestOutput = parseTestOutput;
+exports.buildTestRunTool = buildTestRunTool;
+const MAX_OUTPUT_BYTES = 16 * 1024;
+const MAX_FAILURE_SNIPPETS = 8;
+/**
+ * Detect the test framework by inspecting the workspace at `cwd`. Tries
+ * config files first, then dependency lookups, finally falls back to a
+ * generic `npm test` script if one exists. Returns `null` if nothing
+ * looks runnable — the tool surfaces a clear "I don't know how to test
+ * this" message rather than blindly running `npm test` and hanging.
+ */
+async function detectTestFramework(ctx, cwd) {
+    // Read package.json once — used by vitest/jest detection AND by the
+    // npm-script fallback. Tolerate JSON parse errors silently; some
+    // monorepo roots have package.json with comments / pragma lines.
+    let pkg;
+    try {
+        const raw = await ctx.readFile(`${cwd}/package.json`);
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        // No package.json or invalid — that's fine, try the non-JS frameworks.
+    }
+    // ── JS/TS frameworks (vitest first since it's strict superset of
+    // jest's matcher API on this codebase and more common in 2026) ────
+    if (pkg) {
+        const allDeps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
+        if (allDeps.vitest)
+            return 'vitest';
+        if (allDeps.jest || allDeps['ts-jest'])
+            return 'jest';
+    }
+    // Config-file probes for the (rare) case of zero-dep test setups.
+    for (const candidate of ['vitest.config.ts', 'vitest.config.js', 'vitest.config.mjs']) {
+        if (await fileExists(ctx, `${cwd}/${candidate}`))
+            return 'vitest';
+    }
+    for (const candidate of ['jest.config.ts', 'jest.config.js', 'jest.config.mjs']) {
+        if (await fileExists(ctx, `${cwd}/${candidate}`))
+            return 'jest';
+    }
+    // ── Python ──────────────────────────────────────────────────────────
+    if ((await fileExists(ctx, `${cwd}/pytest.ini`)) ||
+        (await fileExists(ctx, `${cwd}/pyproject.toml`)) ||
+        (await fileExists(ctx, `${cwd}/setup.cfg`))) {
+        return 'pytest';
+    }
+    // ── Go ──────────────────────────────────────────────────────────────
+    if (await fileExists(ctx, `${cwd}/go.mod`))
+        return 'go';
+    // ── Rust ────────────────────────────────────────────────────────────
+    if (await fileExists(ctx, `${cwd}/Cargo.toml`))
+        return 'cargo';
+    // ── .NET — sln OR any csproj at the root ───────────────────────────
+    if (await hasFileMatching(ctx, cwd, '*.sln'))
+        return 'dotnet';
+    if (await hasFileMatching(ctx, cwd, '*.csproj'))
+        return 'dotnet';
+    // ── Generic npm-script fallback ─────────────────────────────────────
+    if (pkg?.scripts?.test)
+        return 'npm-script';
+    return null;
+}
+/**
+ * Build the command + args for a given framework. `pattern` is the
+ * user-supplied test name / file filter. Each framework's filter flag
+ * is different — handled here so the agent doesn't have to know.
+ */
+function buildTestCommand(framework, pattern) {
+    switch (framework) {
+        case 'vitest':
+            // `vitest run` is non-watch; --reporter=default produces the
+            // summary line we parse. `pnpm test` would also work in
+            // workspaces that wrap vitest, but invoking vitest directly is
+            // more deterministic and avoids the workspace's prepush hooks.
+            return { cmd: 'npx', args: ['vitest', 'run', ...(pattern ? [pattern] : [])] };
+        case 'jest':
+            return { cmd: 'npx', args: ['jest', '--ci', ...(pattern ? [pattern] : [])] };
+        case 'pytest':
+            // -q for short output; pytest's default is too verbose to fit
+            // a useful failure list inside MAX_OUTPUT_BYTES.
+            return { cmd: 'pytest', args: ['-q', ...(pattern ? ['-k', pattern] : [])] };
+        case 'go':
+            // `./...` recurses; pattern goes as `-run` regex.
+            return { cmd: 'go', args: ['test', ...(pattern ? ['-run', pattern] : []), './...'] };
+        case 'cargo':
+            return { cmd: 'cargo', args: ['test', ...(pattern ? [pattern] : [])] };
+        case 'dotnet':
+            return { cmd: 'dotnet', args: ['test', '--nologo', '--verbosity', 'quiet', ...(pattern ? ['--filter', pattern] : [])] };
+        case 'npm-script':
+            // Generic fallback: respect the project's own `test` script.
+            // Pattern isn't standardized for `npm test`, so we ignore it
+            // and tell the agent to use a framework-specific override
+            // if needed.
+            return { cmd: 'npm', args: ['test', '--silent'] };
+    }
+}
+function parseTestOutput(framework, stdout, stderr) {
+    const combined = `${stdout}\n${stderr}`;
+    const result = { failureNames: [] };
+    // vitest: `Tests  N passed (N)` or `Tests  M failed | N passed (N+M)`
+    if (framework === 'vitest') {
+        const m = combined.match(/Tests\s+(?:(\d+)\s+failed\s*\|\s*)?(\d+)\s+passed(?:\s*\|\s*(\d+)\s+skipped)?\s*\((\d+)\)/);
+        if (m) {
+            result.failed = m[1] ? parseInt(m[1], 10) : 0;
+            result.passed = parseInt(m[2], 10);
+            result.skipped = m[3] ? parseInt(m[3], 10) : 0;
+        }
+        // Failure rows look like `FAIL  test/foo.test.ts > nested > test name`.
+        const fails = [...combined.matchAll(/FAIL\s+(.+?)(?:\n|$)/g)];
+        result.failureNames = fails.slice(0, MAX_FAILURE_SNIPPETS).map((m2) => m2[1].trim());
+    }
+    // jest: `Tests:       N passed, M failed, K total`
+    if (framework === 'jest') {
+        const m = combined.match(/Tests:\s+(?:(\d+)\s+failed,\s+)?(\d+)\s+passed,\s+(\d+)\s+total/);
+        if (m) {
+            result.failed = m[1] ? parseInt(m[1], 10) : 0;
+            result.passed = parseInt(m[2], 10);
+        }
+        const fails = [...combined.matchAll(/●\s+(.+?)(?:\n|$)/g)];
+        result.failureNames = fails.slice(0, MAX_FAILURE_SNIPPETS).map((m2) => m2[1].trim());
+    }
+    // pytest: `N failed, M passed in T.Ts` or `M passed in T.Ts`
+    if (framework === 'pytest') {
+        const m = combined.match(/(?:(\d+)\s+failed[,\s])?\s*(\d+)\s+passed(?:[,\s]+(\d+)\s+skipped)?\s+in\s+[\d.]+s/);
+        if (m) {
+            result.failed = m[1] ? parseInt(m[1], 10) : 0;
+            result.passed = parseInt(m[2], 10);
+            result.skipped = m[3] ? parseInt(m[3], 10) : 0;
+        }
+        // pytest's failed-list lines look like `FAILED path::testname` or
+        // `FAILED path::testname - <reason>`. The `::` separator is the
+        // marker — without it we end up matching the `FAILED` token in the
+        // dashed summary banner (e.g. `======== 1 failed ...`) and capture
+        // `========` as the "failure name."
+        const fails = [...combined.matchAll(/FAILED\s+(\S+::\S+)/g)];
+        result.failureNames = fails.slice(0, MAX_FAILURE_SNIPPETS).map((m2) => m2[1].trim());
+    }
+    // go: `--- FAIL: TestName` rows; summary is `ok` per package.
+    if (framework === 'go') {
+        const fails = [...combined.matchAll(/---\s+FAIL:\s+(\S+)/g)];
+        result.failureNames = fails.slice(0, MAX_FAILURE_SNIPPETS).map((m2) => m2[1].trim());
+        result.failed = result.failureNames.length;
+        // `PASS: TestName` lines, optionally with subtests.
+        const passes = [...combined.matchAll(/---\s+PASS:\s+/g)];
+        result.passed = passes.length;
+    }
+    // cargo: `test result: FAILED. N passed; M failed; ...` or `ok. N passed`.
+    if (framework === 'cargo') {
+        const m = combined.match(/test result:\s+(?:ok|FAILED)\.\s+(\d+)\s+passed;\s+(\d+)\s+failed(?:;\s+(\d+)\s+ignored)?/);
+        if (m) {
+            result.passed = parseInt(m[1], 10);
+            result.failed = parseInt(m[2], 10);
+            result.skipped = m[3] ? parseInt(m[3], 10) : 0;
+        }
+        const fails = [...combined.matchAll(/test\s+(\S+)\s+\.\.\.\s+FAILED/g)];
+        result.failureNames = fails.slice(0, MAX_FAILURE_SNIPPETS).map((m2) => m2[1].trim());
+    }
+    // dotnet: `Passed!  - Failed:     M, Passed:     N, ...`
+    if (framework === 'dotnet') {
+        const m = combined.match(/Failed:\s+(\d+),\s+Passed:\s+(\d+)(?:,\s+Skipped:\s+(\d+))?/);
+        if (m) {
+            result.failed = parseInt(m[1], 10);
+            result.passed = parseInt(m[2], 10);
+            result.skipped = m[3] ? parseInt(m[3], 10) : 0;
+        }
+        const fails = [...combined.matchAll(/Failed\s+(\S+)/g)];
+        result.failureNames = fails.slice(0, MAX_FAILURE_SNIPPETS).map((m2) => m2[1].trim());
+    }
+    // npm-script: no standard parser — we don't know which framework the
+    // user's `test` script wraps. Leave the summary blank; the agent reads
+    // the raw output. (If the project wires a real framework, the
+    // dedicated branch above already caught it.)
+    return result;
+}
+/**
+ * The agent-facing tool.
+ */
+function buildTestRunTool() {
+    return {
+        name: 'test_run',
+        description: 'Run the project\'s test suite and report a parsed summary. Auto-detects the framework (vitest, jest, pytest, go test, cargo test, dotnet test, or the package.json `test` script). Use this after editing code to verify nothing broke — the result tells you exactly how many tests passed/failed and which failed by name, so you can react without re-reading thousands of lines of test output. Pass `pattern` to scope to specific tests when iterating on a fix. Pass `cwd` for monorepos where the framework lives in a subdirectory (e.g. `packages/agent-core`).',
+        parameters: [
+            { name: 'pattern', description: 'Optional test name / file filter. Each framework maps it to its native flag (vitest/cargo/jest/dotnet: positional; pytest: -k; go: -run regex). Skipped for npm-script.', required: false },
+            { name: 'cwd', description: 'Optional subdirectory of the workspace to run in. Defaults to the workspace root. Useful in monorepos to scope to one package.', required: false },
+            { name: 'framework', description: 'Optional override when auto-detection picks the wrong one (e.g. monorepos with both jest and vitest). Must be one of: vitest, jest, pytest, go, cargo, dotnet, npm-script.', required: false }
+        ],
+        async execute(params, ctx) {
+            const cwd = params.cwd?.trim()
+                ? resolveCwd(ctx.workspaceRoot, params.cwd.trim())
+                : ctx.workspaceRoot;
+            const forced = params.framework?.trim();
+            const framework = forced ?? (await detectTestFramework(ctx, cwd));
+            if (!framework) {
+                return {
+                    output: `Could not detect a test framework in ${displayCwd(cwd, ctx.workspaceRoot)}. ` +
+                        `No vitest/jest/pytest/Cargo.toml/go.mod/*.csproj/sln found, and no \`test\` script in package.json. ` +
+                        `If a framework is present, pass it via the \`framework\` parameter (one of: vitest, jest, pytest, go, cargo, dotnet, npm-script).`,
+                    isError: true
+                };
+            }
+            const { cmd, args } = buildTestCommand(framework, params.pattern?.trim() || undefined);
+            const run = await ctx.runCommand(cmd, args, cwd);
+            const stdout = truncate(run.stdout, MAX_OUTPUT_BYTES);
+            const stderr = truncate(run.stderr, MAX_OUTPUT_BYTES);
+            const summary = parseTestOutput(framework, stdout, stderr);
+            const lines = [];
+            const cwdLabel = displayCwd(cwd, ctx.workspaceRoot);
+            const status = run.exitCode === 0 ? 'PASS' : 'FAIL';
+            lines.push(`${status} · ${framework} in ${cwdLabel}`);
+            if (summary.passed != null || summary.failed != null) {
+                const parts = [];
+                if (summary.passed != null)
+                    parts.push(`${summary.passed} passed`);
+                if (summary.failed != null && summary.failed > 0)
+                    parts.push(`${summary.failed} failed`);
+                if (summary.skipped != null && summary.skipped > 0)
+                    parts.push(`${summary.skipped} skipped`);
+                lines.push(parts.join(', '));
+            }
+            if (summary.failureNames.length > 0) {
+                lines.push('');
+                lines.push('Failures:');
+                for (const name of summary.failureNames)
+                    lines.push(`  - ${name}`);
+            }
+            // Always tail the raw output (truncated) so the agent has the
+            // actual stack/diagnostic when summary parsing missed something.
+            // Cap the appended raw block tightly — the parsed summary is the
+            // primary product; raw text is the fallback.
+            const rawTail = (stdout + (stderr ? `\n[stderr]\n${stderr}` : '')).slice(-4 * 1024);
+            lines.push('');
+            lines.push('--- raw output (tail) ---');
+            lines.push(rawTail);
+            return {
+                output: lines.join('\n'),
+                // Non-zero exit OR any failed-count from parsed summary marks it
+                // as an error so the loop's existing tool-error handling kicks in
+                // (e.g. the model knows to fix-then-retry rather than treat the
+                // tool call as a clean success).
+                isError: run.exitCode !== 0 || (summary.failed != null && summary.failed > 0)
+            };
+        }
+    };
+}
+// ── helpers ────────────────────────────────────────────────────────────
+async function fileExists(ctx, absPath) {
+    try {
+        await ctx.readFile(absPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function hasFileMatching(ctx, cwd, glob) {
+    try {
+        const matches = await ctx.listFiles(glob, cwd);
+        return matches.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+function resolveCwd(workspaceRoot, cwd) {
+    if (cwd.startsWith('/'))
+        return cwd;
+    return `${workspaceRoot}/${cwd}`.replace(/\/+/g, '/');
+}
+function displayCwd(absolute, workspaceRoot) {
+    if (absolute === workspaceRoot)
+        return '.';
+    if (absolute.startsWith(workspaceRoot + '/'))
+        return absolute.slice(workspaceRoot.length + 1);
+    return absolute;
+}
+function truncate(text, max) {
+    if (!text)
+        return '';
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max) + '\n… (truncated)';
+}
+//# sourceMappingURL=testRunTool.js.map

package/dist/tools/testRunTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testRunTool.js","sourceRoot":"","sources":["../../src/tools/testRunTool.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;AAuBH,kDAqDC;AAOD,4CA4BC;AAiBD,0CAqFC;AAKD,4CAoEC;AAjRD,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,CAAC;AACnC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B;;;;;;GAMG;AACI,KAAK,UAAU,mBAAmB,CACvC,GAAyB,EACzB,GAAW;IAEX,oEAAoE;IACpE,iEAAiE;IACjE,iEAAiE;IACjE,IAAI,GAAsI,CAAC;IAC3I,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,eAAe,CAAC,CAAC;QACtD,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;IAED,kEAAkE;IAClE,oEAAoE;IACpE,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,OAAO,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;QAChF,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC;QACpC,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC;YAAE,OAAO,MAAM,CAAC;IACxD,CAAC;IACD,kEAAkE;IAClE,KAAK,MAAM,SAAS,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,EAAE,CAAC;QACtF,IAAI,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;YAAE,OAAO,QAAQ,CAAC;IACpE,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,EAAE,CAAC;QAChF,IAAI,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;YAAE,OAAO,MAAM,CAAC;IAClE,CAAC;IAED,uEAAuE;IACvE,IACE,CAAC,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAAC,CAAC;QAC5C,CAAC,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,iBAAiB,CAAC,CAAC;QAChD,CAAC,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,YAAY,CAAC,CAAC,EAC3C,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,uEAAuE;IACvE,IAAI,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAExD,uEAAuE;IACvE,IAAI,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAAC;QAAE,OAAO,OAAO,CAAC;IAE/D,sEAAsE;IACtE,IAAI,MAAM,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9D,IAAI,MAAM,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAC;IAEjE,uEAAuE;IACvE,IAAI,GAAG,EAAE,OAAO,EAAE,IAAI;QAAE,OAAO,YAAY,CAAC;IAE5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,SAAwB,EAAE,OAAgB;IACzE,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,6DAA6D;YAC7D,wDAAwD;YACxD,+DAA+D;YAC/D,+DAA+D;YAC/D,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAChF,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC/E,KAAK,QAAQ;YACX,8DAA8D;YAC9D,iDAAiD;YACjD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC9E,KAAK,IAAI;YACP,kDAAkD;YAClD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;QACvF,KAAK,OAAO;YACV,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACzE,KAAK,QAAQ;YACX,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC1H,KAAK,YAAY;YACf,6DAA6D;YAC7D,6DAA6D;YAC7D,0DAA0D;YAC1D,aAAa;YACb,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAiBD,SAAgB,eAAe,CAAC,SAAwB,EAAE,MAAc,EAAE,MAAc;IACtF,MAAM,QAAQ,GAAG,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC;IACxC,MAAM,MAAM,GAAsB,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAEvD,sEAAsE;IACtE,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,2FAA2F,CAAC,CAAC;QACtH,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,wEAAwE;QACxE,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,mDAAmD;IACnD,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QAC5F,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,6DAA6D;IAC7D,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,oFAAoF,CAAC,CAAC;QAC/G,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,kEAAkE;QAClE,gEAAgE;QAChE,mEAAmE;QACnE,mEAAmE;QACnE,oCAAoC;QACpC,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,8DAA8D;IAC9D,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;QAC3C,oDAAoD;QACpD,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,2EAA2E;IAC3E,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,2FAA2F,CAAC,CAAC;QACtH,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC,CAAC;QACxE,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,yDAAyD;IACzD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACxF,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACxD,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,qEAAqE;IACrE,uEAAuE;IACvE,8DAA8D;IAC9D,6CAA6C;IAE7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,2iBAA2iB;QAC7iB,UAAU,EAAE;YACV,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yKAAyK,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC5N,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,gIAAgI,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC/K,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,4KAA4K,EAAE,QAAQ,EAAE,KAAK,EAAE;SAClO;QACD,KAAK,CAAC,OAAO,CAAC,MAA8B,EAAE,GAAyB;YACrE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE;gBAC5B,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBAClD,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;YAEtB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,EAA+B,CAAC;YACrE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAClE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO;oBACL,MAAM,EACJ,wCAAwC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI;wBAC9E,sGAAsG;wBACtG,mIAAmI;oBACrI,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC,CAAC;YACvF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAE3D,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,SAAS,OAAO,QAAQ,EAAE,CAAC,CAAC;YACtD,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;gBACrD,MAAM,KAAK,GAAa,EAAE,CAAC;gBAC3B,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;gBACnE,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;gBACzF,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,UAAU,CAAC,CAAC;gBAC7F,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBACxB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,YAAY;oBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,8DAA8D;YAC9D,iEAAiE;YACjE,iEAAiE;YACjE,6CAA6C;YAC7C,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACpF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEpB,OAAO;gBACL,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;gBACxB,iEAAiE;gBACjE,kEAAkE;gBAClE,gEAAgE;gBAChE,iCAAiC;gBACjC,OAAO,EAAE,GAAG,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;aAC9E,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,0EAA0E;AAE1E,KAAK,UAAU,UAAU,CAAC,GAAyB,EAAE,OAAe;IAClE,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,GAAyB,EAAE,GAAW,EAAE,IAAY;IACjF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,aAAqB,EAAE,GAAW;IACpD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,OAAO,GAAG,aAAa,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB,EAAE,aAAqB;IACzD,IAAI,QAAQ,KAAK,aAAa;QAAE,OAAO,GAAG,CAAC;IAC3C,IAAI,QAAQ,CAAC,UAAU,CAAC,aAAa,GAAG,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9F,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAW;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC;AAChD,CAAC"}

package/dist/turnLog.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Tool-use transcript logger — records every LLM response, tool call, and
+ * tool result to a JSONL file under the workspace's .bandit/turns/ folder.
+ *
+ * Motivation: the agent occasionally claims to have done something it
+ * didn't. Without a record of what it emitted, diagnosis is impossible.
+ * This writes a per-turn log we can point at later to answer "what did
+ * the model actually try?".
+ *
+ * Format: one JSON object per line. Events:
+ *   { t, type: 'user-prompt', prompt }
+ *   { t, type: 'llm-response', iteration, textPreview }
+ *   { t, type: 'tool-execute', iteration, name, params }
+ *   { t, type: 'tool-result', iteration, name, isError, outputPreview }
+ *   { t, type: 'tool-error', iteration, name, error }
+ *   { t, type: 'tool-blocked', iteration, name, reason }
+ *   { t, type: 'permission-request', name, primary, risk }
+ *   { t, type: 'permission-decision', name, primary, choice }
+ *   { t, type: 'permission-denied', name, primary, source, reason }
+ *   { t, type: 'final-response', iterations, hitLimit, finalPreview }
+ *
+ * Keeping this in host-kit so both CLI and extension can use the same
+ * logger without duplicating code.
+ */
+export interface TurnLogger {
+    append(event: Record<string, unknown>): Promise<void>;
+    readonly filePath: string;
+}
+export interface TurnLogEvent {
+    t?: string;
+    type: string;
+    [key: string]: unknown;
+}
+export interface TurnTrace {
+    id: string;
+    filePath: string;
+    events: TurnLogEvent[];
+    summary: TurnTraceSummary;
+}
+export type TurnTraceScope = 'workspace' | 'global' | 'external';
+export interface TurnTraceSummary {
+    id: string;
+    filePath: string;
+    scope: TurnTraceScope;
+    workspace: string;
+    startedAt?: string;
+    prompt?: string;
+    finalPreview?: string;
+    iterations: number;
+    hitLimit: boolean;
+    toolCalls: number;
+    tools: string[];
+    blockedTools: number;
+    errors: number;
+    retries: number;
+    nativeFallbacks: number;
+    permissionRequests: number;
+    permissionDecisions: number;
+    permissionDenials: number;
+    compactions: number;
+    checkpoints: number;
+    status: 'completed' | 'failed' | 'blocked' | 'cancelled' | 'unknown';
+}
+export interface TurnTraceListOptions {
+    limit?: number;
+    includeGlobal?: boolean;
+    status?: TurnTraceSummary['status'] | TurnTraceSummary['status'][];
+}
+interface ReadTurnTraceOptions {
+    workspaceRoot?: string;
+}
+/**
+ * Open a log file for a single agent turn. The filename includes a UTC
+ * timestamp and a random suffix so parallel turns (rare) can't collide.
+ */
+export declare function openTurnLog(workspaceRoot: string): Promise<TurnLogger>;
+/** Truncate a string for log preview — protects against multi-MB tool outputs. */
+export declare function previewText(s: unknown): string;
+export declare function listTurnTraceFiles(workspaceRoot: string, optionsOrLimit?: number | TurnTraceListOptions): Promise<string[]>;
+export declare function listTurnTraces(workspaceRoot: string, optionsOrLimit?: number | TurnTraceListOptions): Promise<TurnTrace[]>;
+export declare function readTurnTrace(filePath: string, options?: ReadTurnTraceOptions): Promise<TurnTrace | null>;
+export declare function readTurnTraceById(workspaceRoot: string, idOrPath: string, optionsOrLimit?: number | TurnTraceListOptions): Promise<TurnTrace | null>;
+export declare function parseTurnLog(text: string): TurnLogEvent[];
+export declare function summarizeTurnTrace(id: string, filePath: string, events: TurnLogEvent[], options?: ReadTurnTraceOptions): TurnTraceSummary;
+export declare function formatTurnTraceMarkdown(trace: TurnTrace, options?: {
+    maxEvents?: number;
+}): string;
+export {};
+//# sourceMappingURL=turnLog.d.ts.map

package/dist/turnLog.d.ts.map

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