trailhound 0.2.1

package/dist/adapters/openclaw.d.ts

@@ -0,0 +1,49 @@
+/**
+ * OpenClaw Adapter
+ * Specific handling for OpenClaw sessions
+ */
+import { AgentEvent } from "../types/index.js";
+export interface OpenClawSession {
+    sessionKey?: string;
+    taskId?: string;
+    parentAgent?: string;
+    childAgents: Array<{
+        agent: string;
+        taskId: string;
+    }>;
+    chatSource?: string;
+}
+/**
+ * OpenClaw can delegate to coding agents and has structured task metadata.
+ * We track:
+ * - Main OpenClaw session
+ * - Delegated coding-agent subprocesses
+ * - Chat source (Discord, Telegram, Signal, WebChat)
+ * - Cross-domain actions (repo + email + calendar)
+ */
+export declare class OpenClawAdapter {
+    private session;
+    private eventLog;
+    /**
+     * Parse OpenClaw output for session metadata
+     */
+    parseOutput(line: string): AgentEvent | null;
+    /**
+     * Get the delegation tree for reporting
+     */
+    getDelegationTree(): OpenClawSession;
+    /**
+     * Get all logged events
+     */
+    getEvents(): AgentEvent[];
+    /**
+     * Enrich metadata with OpenClaw-specific info
+     */
+    enrichMetadata(metadata: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Format delegation tree for display
+     */
+    formatTree(): string;
+}
+export default OpenClawAdapter;
+//# sourceMappingURL=openclaw.d.ts.map

package/dist/adapters/openclaw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw.d.ts","sourceRoot":"","sources":["../../src/adapters/openclaw.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAEb;IACF,OAAO,CAAC,QAAQ,CAAoB;IAEpC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAsH5C;;OAEG;IACH,iBAAiB,IAAI,eAAe;IAIpC;;OAEG;IACH,SAAS,IAAI,UAAU,EAAE;IAIzB;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAY1E;;OAEG;IACH,UAAU,IAAI,MAAM;CAqBrB;AAED,eAAe,eAAe,CAAC"}

package/dist/adapters/openclaw.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * OpenClaw Adapter
+ * Specific handling for OpenClaw sessions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenClawAdapter = void 0;
+/**
+ * OpenClaw can delegate to coding agents and has structured task metadata.
+ * We track:
+ * - Main OpenClaw session
+ * - Delegated coding-agent subprocesses
+ * - Chat source (Discord, Telegram, Signal, WebChat)
+ * - Cross-domain actions (repo + email + calendar)
+ */
+class OpenClawAdapter {
+    session = {
+        childAgents: [],
+    };
+    eventLog = [];
+    /**
+     * Parse OpenClaw output for session metadata
+     */
+    parseOutput(line) {
+        // Detect OpenClaw session start
+        const sessionMatch = line.match(/OpenClaw.*Session[:\s]+([a-zA-Z0-9-_]+)/i);
+        if (sessionMatch) {
+            this.session.sessionKey = sessionMatch[1];
+            return {
+                ts: new Date().toISOString(),
+                type: "session.start",
+                runId: "",
+                sessionId: sessionMatch[1],
+                agent: "openclaw",
+                source: "openclaw",
+            };
+        }
+        // Detect chat source
+        const chatSourceMatch = line.match(/Source:\s*(discord|telegram|signal|webchat|slack)/i);
+        if (chatSourceMatch) {
+            this.session.chatSource = chatSourceMatch[1].toLowerCase();
+            return {
+                ts: new Date().toISOString(),
+                type: "process.exec",
+                runId: "",
+                action: "chat-received",
+                platform: chatSourceMatch[1].toLowerCase(),
+                agent: "openclaw",
+            };
+        }
+        // Detect coding-agent delegation
+        const delegateMatch = line.match(/(coding-agent|coding_agent|code-agent|code_agent).*?using\s+(codex|claude|claude-code|opencode)/i);
+        if (delegateMatch) {
+            const subAgent = delegateMatch[2] || delegateMatch[1];
+            const delegatedTaskId = `openclaw-${Date.now()}`;
+            this.session.childAgents.push({
+                agent: subAgent.toLowerCase(),
+                taskId: delegatedTaskId,
+            });
+            return {
+                ts: new Date().toISOString(),
+                type: "process.exec",
+                runId: "",
+                action: "delegate",
+                parentAgent: "openclaw",
+                childAgent: subAgent.toLowerCase(),
+                taskId: delegatedTaskId,
+            };
+        }
+        // Detect Pi planning
+        const piMatch = line.match(/Pi\s+(?:planned|planning|thinks|analyzing|selected plan)/i);
+        if (piMatch) {
+            return {
+                ts: new Date().toISOString(),
+                type: "process.exec",
+                runId: "",
+                toolName: "pi-plan",
+                agent: "pi",
+                parent: "openclaw",
+            };
+        }
+        // Detect tool calls
+        const toolCallMatch = line.match(/\[Tool:\s*(\w+)\]/i);
+        if (toolCallMatch) {
+            return {
+                ts: new Date().toISOString(),
+                type: "process.exec",
+                runId: "",
+                toolName: toolCallMatch[1],
+                agent: "openclaw",
+            };
+        }
+        // Detect web operations
+        const webMatch = line.match(/(web_search|browser_use|web_fetch|fetch_page)\s*[:-]?\s*(.+)?/i);
+        if (webMatch) {
+            return {
+                ts: new Date().toISOString(),
+                type: "network.http",
+                runId: "",
+                protocol: "https",
+                action: webMatch[1],
+                query: webMatch[2]?.trim(),
+                agent: "openclaw",
+            };
+        }
+        // Detect email/calendar operations
+        const crossDomainMatch = line.match(/(send_email|schedule_meeting|calendar_check|inbox_check)/i);
+        if (crossDomainMatch) {
+            return {
+                ts: new Date().toISOString(),
+                type: "process.exec",
+                runId: "",
+                action: crossDomainMatch[1],
+                crossDomain: true,
+                agent: "openclaw",
+            };
+        }
+        // Detect session end
+        const sessionEndMatch = line.match(/OpenClaw.*session.*(ended|complete|finished)/i);
+        if (sessionEndMatch) {
+            return {
+                ts: new Date().toISOString(),
+                type: "session.end",
+                runId: "",
+                sessionId: this.session.sessionKey,
+                agent: "openclaw",
+            };
+        }
+        return null;
+    }
+    /**
+     * Get the delegation tree for reporting
+     */
+    getDelegationTree() {
+        return { ...this.session };
+    }
+    /**
+     * Get all logged events
+     */
+    getEvents() {
+        return [...this.eventLog];
+    }
+    /**
+     * Enrich metadata with OpenClaw-specific info
+     */
+    enrichMetadata(metadata) {
+        return {
+            ...metadata,
+            openclaw: {
+                sessionKey: this.session.sessionKey,
+                chatSource: this.session.chatSource,
+                childAgents: this.session.childAgents,
+                delegationTree: this.session,
+            },
+        };
+    }
+    /**
+     * Format delegation tree for display
+     */
+    formatTree() {
+        const lines = [];
+        lines.push("OpenClaw Session");
+        if (this.session.chatSource) {
+            lines.push(`  📱 Source: ${this.session.chatSource}`);
+        }
+        if (this.session.sessionKey) {
+            lines.push(`  🔑 Session: ${this.session.sessionKey}`);
+        }
+        if (this.session.childAgents.length > 0) {
+            lines.push("  🔄 Delegated to:");
+            for (const child of this.session.childAgents) {
+                lines.push(`    - ${child.agent} (${child.taskId})`);
+            }
+        }
+        return lines.join("\n");
+    }
+}
+exports.OpenClawAdapter = OpenClawAdapter;
+exports.default = OpenClawAdapter;
+//# sourceMappingURL=openclaw.js.map

package/dist/adapters/openclaw.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Trailhound CLI
+ * Sniff out what your AI agent is doing
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/cli.js

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Trailhound CLI
+ * Sniff out what your AI agent is doing
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const trailhound_js_1 = require("./core/trailhound.js");
+const run_store_js_1 = require("./core/run-store.js");
+const report_generator_js_1 = require("./reports/report-generator.js");
+const program = new commander_1.Command();
+program
+    .name("trailhound")
+    .description("Sniff out what your AI agent is doing")
+    .version("0.1.0");
+program
+    .command("run")
+    .description("Record an agent session")
+    .option("-n, --name <name>", "Assign a name to this run")
+    .option("-a, --agent <agent>", "Specify agent type (codex, claude, opencode, openclaw)")
+    .option("-m, --mode <mode>", "Recording mode (record, warn, enforce)", "record")
+    .argument("<command...>", "Agent command to run")
+    .action(async (args, options) => {
+    const agentCommand = args.join(" ").trim();
+    if (!agentCommand) {
+        console.error(chalk_1.default.red("Error: No agent command specified"));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.blue("🐕 Trailhound"), "- Sniffing out agent behavior...\n");
+    const trailhound = new trailhound_js_1.Trailhound({
+        name: options.name,
+        agent: options.agent,
+        mode: options.mode,
+    });
+    try {
+        const result = await trailhound.run(agentCommand);
+        console.log("\n" + chalk_1.default.green("✅ Recording complete!"));
+        console.log(chalk_1.default.gray(`Run ID: ${result.runId}`));
+        console.log(chalk_1.default.gray(`Duration: ${formatDuration(result.durationMs)}`));
+        console.log(chalk_1.default.gray(`View report: trailhound report ${result.runId}`));
+        if (result.warnings.length > 0) {
+            console.log("\n" + chalk_1.default.yellow("⚠️  Warnings:"));
+            result.warnings.forEach(w => console.log(chalk_1.default.yellow(`  - ${w}`)));
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red("\n❌ Recording failed:"), error.message || error);
+        process.exit(1);
+    }
+});
+program
+    .command("report")
+    .description("Generate a report from a recorded session")
+    .argument("[run-id]", "Run ID (defaults to latest)")
+    .option("--html", "Generate HTML report")
+    .option("--json", "Output as JSON")
+    .action(async (runId, options) => {
+    const store = new run_store_js_1.RunStore();
+    const targetRunId = runId || await getLatestRunId();
+    if (!targetRunId) {
+        console.error(chalk_1.default.red("No runs found. Run 'trailhound run' first."));
+        process.exit(1);
+    }
+    const manifestPath = path.join(process.cwd(), ".trailhound", "runs", targetRunId, "manifest.json");
+    let manifest;
+    try {
+        const data = await fs.readFile(manifestPath, "utf-8");
+        manifest = JSON.parse(data);
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`Run not found: ${targetRunId}`));
+        process.exit(1);
+    }
+    const generator = new report_generator_js_1.ReportGenerator(manifest);
+    if (options.json) {
+        console.log(JSON.stringify(manifest, null, 2));
+    }
+    else if (options.html) {
+        const htmlPath = await generator.generateHtml();
+        console.log(chalk_1.default.green(`HTML report: ${htmlPath}`));
+    }
+    else {
+        const report = generator.generateMarkdown();
+        console.log(report);
+    }
+});
+program
+    .command("list")
+    .description("List recorded sessions")
+    .option("--json", "Output as JSON")
+    .action(async (options) => {
+    const runs = await listRuns();
+    if (options.json) {
+        console.log(JSON.stringify(runs, null, 2));
+        return;
+    }
+    if (runs.length === 0) {
+        console.log(chalk_1.default.gray("No recorded runs found."));
+        return;
+    }
+    console.log(chalk_1.default.bold("\nRecorded Sessions:\n"));
+    runs.forEach((run, i) => {
+        const indicator = i === 0 ? chalk_1.default.cyan("→ ") : "  ";
+        const date = new Date(run.timestamp).toLocaleString();
+        const agentName = run.agent ? chalk_1.default.gray(`[${run.agent}]`) : "";
+        console.log(`${indicator}${chalk_1.default.white(run.id)} ${chalk_1.default.gray(date)} ${agentName}`);
+        if (run.name) {
+            console.log(`     ${chalk_1.default.gray(run.name)}`);
+        }
+    });
+    console.log();
+});
+program
+    .command("replay")
+    .description("Replay a recorded session")
+    .argument("<run-id>", "Run ID to replay")
+    .action(async (runId) => {
+    console.log(chalk_1.default.blue("Replaying session...") + chalk_1.default.gray(` (${runId})`));
+    console.log(chalk_1.default.gray("Replay feature coming soon!"));
+});
+program
+    .command("compare")
+    .description("Compare two recorded sessions")
+    .argument("<run-id-1>", "First run ID")
+    .argument("<run-id-2>", "Second run ID")
+    .action(async (runId1, runId2) => {
+    console.log(chalk_1.default.blue("Comparing sessions..."));
+    console.log(chalk_1.default.gray("Comparison feature coming soon!"));
+});
+async function getLatestRunId() {
+    try {
+        const runsPath = path.join(process.cwd(), ".trailhound", "runs");
+        const entries = await fs.readdir(runsPath);
+        const runs = entries
+            .filter(e => !e.startsWith("."))
+            .sort()
+            .reverse();
+        return runs[0] || null;
+    }
+    catch {
+        return null;
+    }
+}
+async function listRuns() {
+    try {
+        const runsPath = path.join(process.cwd(), ".trailhound", "runs");
+        const entries = await fs.readdir(runsPath);
+        const runs = [];
+        for (const entry of entries) {
+            if (entry.startsWith("."))
+                continue;
+            const manifestPath = path.join(runsPath, entry, "manifest.json");
+            try {
+                const data = await fs.readFile(manifestPath, "utf-8");
+                const manifest = JSON.parse(data);
+                runs.push({
+                    id: manifest.run.id,
+                    name: manifest.run.name,
+                    timestamp: manifest.run.timestamp,
+                    agent: manifest.agent.name,
+                });
+            }
+            catch {
+                // Skip invalid manifests
+            }
+        }
+        return runs.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+    }
+    catch {
+        return [];
+    }
+}
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    return minutes > 0
+        ? `${minutes}m ${remainingSeconds}s`
+        : `${seconds}s`;
+}
+// Handle unhandled arguments
+if (process.argv.length <= 2) {
+    program.help();
+}
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/core/run-store.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Run Store
+ * Manages storage and retrieval of run metadata
+ *
+ * Trailhound stores runs in .trailhound/runs/
+ */
+import { RunEntry, RunManifest } from "../types/index.js";
+export declare class RunStore {
+    private runsPath;
+    constructor();
+    listRuns(): Promise<RunEntry[]>;
+    getLatestRunId(): string | null;
+    getRun(runId: string): RunManifest | null;
+}
+//# sourceMappingURL=run-store.d.ts.map

package/dist/core/run-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-store.d.ts","sourceRoot":"","sources":["../../src/core/run-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE1D,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAS;;IAMnB,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IA+BrC,cAAc,IAAI,MAAM,GAAG,IAAI;IAK/B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;CAI1C"}

package/dist/core/run-store.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Run Store
+ * Manages storage and retrieval of run metadata
+ *
+ * Trailhound stores runs in .trailhound/runs/
+ */
+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.RunStore = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+class RunStore {
+    runsPath;
+    constructor() {
+        this.runsPath = path.join(process.cwd(), ".trailhound", "runs");
+    }
+    async listRuns() {
+        try {
+            const entries = await fs.readdir(this.runsPath);
+            const runs = [];
+            for (const entry of entries) {
+                const manifestPath = path.join(this.runsPath, entry, "manifest.json");
+                try {
+                    const manifestData = await fs.readFile(manifestPath, "utf-8");
+                    const manifest = JSON.parse(manifestData);
+                    runs.push({
+                        id: manifest.run.id,
+                        name: manifest.run.name,
+                        timestamp: manifest.run.timestamp,
+                        agent: manifest.agent.name,
+                        summary: manifest.summary,
+                    });
+                }
+                catch {
+                    // Skip entries without valid manifests
+                }
+            }
+            // Sort by timestamp descending
+            return runs.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+        }
+        catch {
+            return [];
+        }
+    }
+    getLatestRunId() {
+        // This needs async, simplified for now
+        return null;
+    }
+    getRun(runId) {
+        // This needs async, simplified for now
+        return null;
+    }
+}
+exports.RunStore = RunStore;
+//# sourceMappingURL=run-store.js.map

package/dist/core/run-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-store.js","sourceRoot":"","sources":["../../src/core/run-store.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,gDAAkC;AAClC,2CAA6B;AAG7B,MAAa,QAAQ;IACX,QAAQ,CAAS;IAEzB;QACE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,IAAI,GAAe,EAAE,CAAC;YAE5B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;gBACtE,IAAI,CAAC;oBACH,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;oBAC9D,MAAM,QAAQ,GAAgB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;oBACvD,IAAI,CAAC,IAAI,CAAC;wBACR,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE;wBACnB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI;wBACvB,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS;wBACjC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI;wBAC1B,OAAO,EAAE,QAAQ,CAAC,OAAO;qBAC1B,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,uCAAuC;gBACzC,CAAC;YACH,CAAC;YAED,+BAA+B;YAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACxB,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAClE,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,cAAc;QACZ,uCAAuC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,uCAAuC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA/CD,4BA+CC"}

package/dist/core/trace-writer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Trace Writer
+ * Manages writing events to the trace store
+ *
+ * Trailhound uses .trailhound/ directory for all traces
+ */
+import { AgentEvent, RunManifest } from "../types/index.js";
+export declare class TraceWriter {
+    private workspacePath;
+    private eventsPath;
+    private manifestPath;
+    private writeQueue;
+    private flushInterval?;
+    private closed;
+    constructor(workspacePath: string);
+    initialize(): Promise<void>;
+    writeEvent(event: AgentEvent): Promise<void>;
+    writeManifest(manifest: RunManifest): Promise<void>;
+    close(): Promise<void>;
+    private flush;
+}
+//# sourceMappingURL=trace-writer.d.ts.map

package/dist/core/trace-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-writer.d.ts","sourceRoot":"","sources":["../../src/core/trace-writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5D,qBAAa,WAAW;IAOV,OAAO,CAAC,aAAa;IANjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAS;gBAEH,aAAa,EAAE,MAAM;IAKnC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAWd,KAAK;CAYpB"}