fixo-cli 1.0.0

package/dist/agent/conversation.js

@@ -0,0 +1,547 @@
+/**
+ * ConversationManager — manages multi-turn chat context for the FixO CLI agent.
+ *
+ * Provides automatic context window management inspired by OpenCode:
+ *   1. Tracks estimated token usage per model's context window limit
+ *   2. Auto-compacts when the next request would overflow the context
+ *   3. Uses a structured summary template to preserve critical information
+ *   4. Preserves the N most-recent turns verbatim for continuity
+ *   5. Prunes old tool outputs to free space before full compaction
+ */
+import { countMessagesTokens, countTokens } from './tokenizer.js';
+import { ContextBudgetEnforcer } from './context-budget.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Known context window limits (input tokens) for models/providers.
+ * These are conservative estimates — we leave headroom for output tokens.
+ * Format: pattern → max input tokens (context minus output reservation).
+ */
+const MODEL_CONTEXT_LIMITS = [
+    // Google Gemini — huge contexts
+    [/gemini-2\.5-flash/i, 900_000],
+    [/gemini-2\.5-pro/i, 900_000],
+    [/gemini-2\.0/i, 900_000],
+    [/gemini/i, 900_000],
+    // Groq — standard
+    [/llama-3\.3-70b/i, 120_000],
+    [/llama-4/i, 120_000],
+    [/deepseek-r1/i, 120_000],
+    [/compound/i, 120_000],
+    [/gpt-oss/i, 120_000],
+    // Cerebras
+    [/qwen-3-235b/i, 8_000], // Very small on free tier
+    [/llama3\.1-8b/i, 8_000],
+    // SambaNova
+    [/deepseek-v3/i, 120_000],
+    [/qwen3-coder/i, 120_000],
+    // Mistral
+    [/mistral-large/i, 120_000],
+    [/codestral/i, 250_000],
+    [/devstral/i, 120_000],
+    [/magistral/i, 120_000],
+    // OpenRouter — varies by model
+    [/openrouter/i, 120_000],
+    // Cloudflare — depends on model
+    [/cloudflare/i, 120_000],
+    // Cohere
+    [/command-r/i, 120_000],
+    // Zen / NVIDIA
+    [/zen|nvidia/i, 120_000],
+];
+/** Default context limit when model is unknown */
+const DEFAULT_CONTEXT_LIMIT = 120_000;
+/** Reserve this many tokens for the output response */
+const OUTPUT_TOKEN_RESERVATION = 8_000;
+/**
+ * Resolve the *usable input* context limit for a model identifier.
+ * The result is the model's full window minus {@link OUTPUT_TOKEN_RESERVATION}
+ * so callers that only care about how much room they have left for input
+ * tokens (predictive gate, budget planner) can use the answer directly.
+ */
+export function resolveModelContextLimit(model) {
+    if (!model)
+        return DEFAULT_CONTEXT_LIMIT - OUTPUT_TOKEN_RESERVATION;
+    for (const [pattern, limit] of MODEL_CONTEXT_LIMITS) {
+        if (pattern.test(model))
+            return limit - OUTPUT_TOKEN_RESERVATION;
+    }
+    return DEFAULT_CONTEXT_LIMIT - OUTPUT_TOKEN_RESERVATION;
+}
+/** Maximum token budget for conversation history (usable input space) */
+const DEFAULT_MAX_TOKEN_BUDGET = 100_000;
+/** Minimum number of individual messages to keep (2 turn-pairs = 4 messages). */
+const MIN_MESSAGES_TO_KEEP = 4;
+/** Number of recent turn-pairs to preserve verbatim during compaction */
+const TAIL_TURNS = 2;
+/** Maximum characters for tool output in old messages before truncation */
+const TOOL_OUTPUT_MAX_CHARS = 2_000;
+/** Structured summary template (inspired by OpenCode) */
+const SUMMARY_TEMPLATE = `Output exactly the Markdown structure shown below. Keep every section even when empty.
+
+## Goal
+- [single-sentence task summary]
+
+## Constraints & Preferences
+- [user constraints, preferences, specs, or "(none)"]
+
+## Progress
+### Done
+- [completed work or "(none)"]
+
+### In Progress
+- [current work or "(none)"]
+
+## Key Decisions
+- [decision and why, or "(none)"]
+
+## Next Steps
+- [ordered next actions or "(none)"]
+
+## Critical Context
+- [important technical facts, errors, open questions, or "(none)"]
+
+## Relevant Files
+- [file or directory path: why it matters, or "(none)"]
+
+Rules:
+- Use terse bullets, not prose paragraphs.
+- Preserve exact file paths, commands, error strings, and identifiers.
+- Do not mention the summary process or that context was compacted.`;
+// ---------------------------------------------------------------------------
+// ConversationManager
+// ---------------------------------------------------------------------------
+export class ConversationManager {
+    history = [];
+    maxTokenBudget;
+    summary = '';
+    contextLimit = DEFAULT_CONTEXT_LIMIT;
+    _lastCompactionInfo = null;
+    /**
+     * When set (>0), `getTotalTokens()` returns this value instead of
+     * summing the history. Used by `--resume` so the restored session
+     * shows the same token count the user saw at save time.
+     */
+    tokenOverride = 0;
+    constructor(maxTokenBudget = DEFAULT_MAX_TOKEN_BUDGET) {
+        this.maxTokenBudget = maxTokenBudget;
+    }
+    // ---------------------------------------------------------------------------
+    // Model-aware context limits
+    // ---------------------------------------------------------------------------
+    /**
+     * Auto-configure the context budget based on the model being used.
+     * Call this whenever the model changes.
+     */
+    setContextLimit(model) {
+        for (const [pattern, limit] of MODEL_CONTEXT_LIMITS) {
+            if (pattern.test(model)) {
+                this.contextLimit = limit - OUTPUT_TOKEN_RESERVATION;
+                this.maxTokenBudget = Math.min(this.maxTokenBudget, this.contextLimit);
+                return;
+            }
+        }
+        this.contextLimit = DEFAULT_CONTEXT_LIMIT - OUTPUT_TOKEN_RESERVATION;
+    }
+    getContextLimit() {
+        return this.contextLimit;
+    }
+    /** Returns info about the last compaction (for UX display). */
+    getLastCompactionInfo() {
+        const info = this._lastCompactionInfo;
+        this._lastCompactionInfo = null;
+        return info;
+    }
+    // ---------------------------------------------------------------------------
+    // Token estimation
+    // ---------------------------------------------------------------------------
+    /**
+     * Real BPE token count for a piece of text. Uses the OpenAI cl100k
+     * encoding by default (good proxy for llama-3, mistral, qwen,
+     * deepseek, gemini etc. that the FreeLLMAPI proxy fronts). Pass the
+     * model name for an encoder-tuned count.
+     */
+    estimateTokens(text, model) {
+        return countTokens(text, model);
+    }
+    /**
+     * Estimate tokens consumed by a single message, accounting for both its
+     * `content` and any attached `tool_calls`.
+     */
+    estimateMessageTokens(message) {
+        return countMessagesTokens([message]);
+    }
+    /**
+     * Calculate the total estimated token count across the entire history.
+     */
+    getTotalTokens() {
+        if (this.tokenOverride > 0)
+            return this.tokenOverride;
+        return this.history.reduce((sum, msg) => sum + this.estimateMessageTokens(msg), 0);
+    }
+    /**
+     * Restore the conversation from a previously-saved snapshot. Replaces
+     * the entire history, summary, and token override atomically. The
+     * `tokens` argument is the value recorded at save time; subsequent
+     * reads of `getTotalTokens()` will prefer this override so the
+     * resumed session shows the same context-usage meter the user saw
+     * when they saved.
+     */
+    restoreFromSnapshot(messages, summary, tokens) {
+        this.history = [...messages];
+        this.summary = summary;
+        this.tokenOverride = Math.max(0, tokens);
+    }
+    /**
+     * Estimate the total token count for the NEXT LLM request.
+     * This is what actually matters for context overflow detection.
+     */
+    estimateNextRequestTokens(systemPrompt, userMessage) {
+        const systemTokens = this.estimateTokens(systemPrompt);
+        const historyTokens = this.getTotalTokens();
+        const userTokens = this.estimateTokens(userMessage);
+        const summaryTokens = this.summary ? this.estimateTokens(this.summary) : 0;
+        return systemTokens + summaryTokens + historyTokens + userTokens;
+    }
+    // ---------------------------------------------------------------------------
+    // Budget enforcement (Pillar 4)
+    // ---------------------------------------------------------------------------
+    /**
+     * Proactively trim the conversation to fit a token budget, using the
+     * tiered {@link ContextBudgetEnforcer} strategy. The `model` argument
+     * is forwarded to the BPE encoder so the counts are tuned to the
+     * downstream provider.
+     *
+     * If the enforcer cannot fit the budget even after pruning tool
+     * outputs, dropping old turns, and truncating tool arguments, it
+     * sets `report.markForCompaction = true`; the caller should then
+     * invoke {@link ConversationManager.compact} to summarise the
+     * oldest turns via an LLM.
+     *
+     * Returns a report describing the actions taken and the new total
+     * token count.
+     */
+    enforceBudget(maxTokens, model) {
+        const enforcer = new ContextBudgetEnforcer(model);
+        const { messages, report } = enforcer.enforce(this.history, { maxTokens, model });
+        if (report.actions[0] !== 'none') {
+            this.history = messages;
+        }
+        return {
+            trimmed: report.actions[0] !== 'none',
+            report: {
+                tokensBefore: report.tokensBefore,
+                tokensAfter: report.tokensAfter,
+                actions: report.actions,
+                markForCompaction: report.markForCompaction,
+                withinBudget: report.withinBudget,
+            },
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Mutation helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Add a user message and the corresponding assistant response as a single
+     * conversational turn, then prune if the budget is exceeded.
+     */
+    addTurn(userMessage, assistantResponse) {
+        this.history.push({ role: 'user', content: userMessage }, { role: 'assistant', content: assistantResponse });
+        this.pruneToFitBudget();
+    }
+    /**
+     * Add a raw {@link ChatMessage} (useful for tool-call results or other
+     * non-standard messages), then prune if the budget is exceeded.
+     */
+    addMessage(message) {
+        this.history.push(message);
+        this.pruneToFitBudget();
+    }
+    // ---------------------------------------------------------------------------
+    // Accessors
+    // ---------------------------------------------------------------------------
+    /**
+     * Return all messages for injection into the LLM context.
+     * If a compacted summary exists, it is prepended as the first message.
+     */
+    getMessages() {
+        const msgs = [];
+        if (this.summary) {
+            msgs.push({
+                role: 'assistant',
+                content: `[Previous conversation context]\n\n${this.summary}`,
+            });
+        }
+        msgs.push(...this.history);
+        return msgs;
+    }
+    /** Number of complete user/assistant turn pairs in the history. */
+    getTurnCount() {
+        return Math.floor(this.history.length / 2);
+    }
+    /** Total number of messages in history (excluding summary). */
+    getMessageCount() {
+        return this.history.length;
+    }
+    // ---------------------------------------------------------------------------
+    // Pruning
+    // ---------------------------------------------------------------------------
+    /**
+     * Remove the oldest user/assistant pairs until the total token estimate
+     * fits within {@link maxTokenBudget}.
+     */
+    pruneToFitBudget() {
+        while (this.getTotalTokens() > this.maxTokenBudget &&
+            this.history.length > MIN_MESSAGES_TO_KEEP) {
+            let nextUserIndex = -1;
+            for (let i = 1; i < this.history.length; i++) {
+                if (this.history[i].role === 'user') {
+                    nextUserIndex = i;
+                    break;
+                }
+            }
+            if (nextUserIndex !== -1 && (this.history.length - nextUserIndex) >= MIN_MESSAGES_TO_KEEP) {
+                this.history.splice(0, nextUserIndex);
+            }
+            else {
+                break;
+            }
+        }
+    }
+    /**
+     * Prune large tool outputs in older messages to free context space.
+     * Keeps the last TAIL_TURNS * 2 messages untouched.
+     */
+    pruneToolOutputs() {
+        let freedChars = 0;
+        const keepFrom = Math.max(0, this.history.length - TAIL_TURNS * 2);
+        for (let i = 0; i < keepFrom; i++) {
+            const msg = this.history[i];
+            if (msg.role === 'tool' && msg.content && msg.content.length > TOOL_OUTPUT_MAX_CHARS) {
+                const original = msg.content.length;
+                msg.content = msg.content.slice(0, TOOL_OUTPUT_MAX_CHARS) +
+                    `\n\n... [truncated: ${original} → ${TOOL_OUTPUT_MAX_CHARS} chars to save context]`;
+                freedChars += original - TOOL_OUTPUT_MAX_CHARS;
+            }
+            // Also truncate large assistant tool_calls arguments
+            if (msg.role === 'assistant' && msg.tool_calls) {
+                for (const tc of msg.tool_calls) {
+                    if (tc.function?.arguments && tc.function.arguments.length > TOOL_OUTPUT_MAX_CHARS * 2) {
+                        const original = tc.function.arguments.length;
+                        tc.function.arguments = tc.function.arguments.slice(0, TOOL_OUTPUT_MAX_CHARS) + '...}';
+                        freedChars += original - TOOL_OUTPUT_MAX_CHARS;
+                    }
+                }
+            }
+        }
+        return Math.ceil(freedChars / 4); // Return estimated tokens freed
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    /** Clear all conversation history and summary. */
+    clear() {
+        this.history = [];
+        this.summary = '';
+    }
+    // ---------------------------------------------------------------------------
+    // Serialisation — session persistence / recovery
+    // ---------------------------------------------------------------------------
+    /** Export a deep copy of the raw history for external persistence. */
+    exportHistory() {
+        return this.history.map((msg) => ({ ...msg }));
+    }
+    /**
+     * Import a previously-exported history, replacing the current one.
+     * Automatically prunes to fit the current token budget after import.
+     */
+    importHistory(messages) {
+        this.history = messages.map((msg) => ({ ...msg }));
+        this.pruneToFitBudget();
+    }
+    // ---------------------------------------------------------------------------
+    // Compaction & Summarization
+    // ---------------------------------------------------------------------------
+    getSummary() {
+        return this.summary;
+    }
+    setSummary(summary) {
+        this.summary = summary;
+    }
+    /**
+     * Check if the conversation should be compacted before the next request.
+     * Uses the estimated next request size vs the model's context limit.
+     * If systemPrompt/userMessage are not provided, uses a simpler history-only check.
+     */
+    shouldCompact(systemPrompt, userMessage) {
+        if (this.history.length <= MIN_MESSAGES_TO_KEEP)
+            return false;
+        if (systemPrompt && userMessage) {
+            // Predictive check: will the next request overflow the context window?
+            const estimated = this.estimateNextRequestTokens(systemPrompt, userMessage);
+            // Trigger compaction at 75% of context limit to leave headroom
+            return estimated > this.contextLimit * 0.75;
+        }
+        // Fallback: simple history-based check
+        return this.getTotalTokens() > this.maxTokenBudget * 0.7;
+    }
+    /**
+     * Compact the conversation using a structured summary.
+     * - Preserves the last TAIL_TURNS turn-pairs verbatim
+     * - Summarizes everything else using the SUMMARY_TEMPLATE
+     * - Prunes old tool outputs before summarizing
+     *
+     * Returns true if compaction succeeded.
+     */
+    async compact(client, model) {
+        if (this.history.length <= MIN_MESSAGES_TO_KEEP) {
+            return false;
+        }
+        const messagesBefore = this.history.length;
+        const tokensBefore = this.getTotalTokens();
+        // Step 1: Prune tool outputs to free immediate space
+        this.pruneToolOutputs();
+        // Step 2: Identify what to compact vs preserve
+        // Preserve: last TAIL_TURNS turn-pairs (user+assistant = 2 messages each)
+        const tailMessages = TAIL_TURNS * 2;
+        const keepCount = Math.min(tailMessages, this.history.length);
+        const toCompact = this.history.slice(0, this.history.length - keepCount);
+        const preserved = this.history.slice(this.history.length - keepCount);
+        if (toCompact.length === 0) {
+            return false;
+        }
+        // Step 3: Format history for summarization
+        const formattedHistory = toCompact
+            .map((msg) => {
+            const role = msg.role.toUpperCase();
+            if (msg.role === 'tool') {
+                const content = (msg.content ?? '').slice(0, 500);
+                return `TOOL_RESULT (${msg.tool_call_id ?? 'unknown'}): ${content}`;
+            }
+            if (msg.tool_calls && msg.tool_calls.length > 0) {
+                const tools = msg.tool_calls.map(tc => `  → ${tc.function?.name}(${(tc.function?.arguments ?? '').slice(0, 100)}...)`).join('\n');
+                return `${role}: ${msg.content || '(tool calls)'}\n${tools}`;
+            }
+            return `${role}: ${msg.content || '(empty)'}`;
+        })
+            .join('\n\n');
+        // Step 4: Build compaction prompt
+        const previousSummarySection = this.summary
+            ? `Here is the previous summary to UPDATE (preserve still-true details, remove stale details, merge new facts):\n<previous-summary>\n${this.summary}\n</previous-summary>\n\n`
+            : '';
+        const compactionPrompt = `${previousSummarySection}Create a comprehensive summary from the conversation history above.\n\n${SUMMARY_TEMPLATE}`;
+        try {
+            const response = await client.chat([
+                {
+                    role: 'system',
+                    content: 'You are a technical context summarization engine. You produce structured summaries that preserve every critical fact needed to continue a coding conversation.',
+                },
+                {
+                    role: 'user',
+                    content: `Here is the conversation history to summarize:\n\n${formattedHistory}\n\n${compactionPrompt}`,
+                },
+            ], model, { max_tokens: 4000, agent_task_type: 'investigation', required_capabilities: ['fast'] });
+            this.summary = response.content?.trim() || '';
+            // Replace history with only the preserved tail messages
+            this.history = [...preserved];
+            const tokensAfter = this.getTotalTokens() + this.estimateTokens(this.summary);
+            this._lastCompactionInfo = {
+                messagesBefore,
+                tokensFreed: Math.max(0, tokensBefore - tokensAfter),
+            };
+            return true;
+        }
+        catch (error) {
+            console.warn(`[Context Compaction] Failed to compact: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
+    /**
+     * Check if an error indicates context window overflow from the provider.
+     * If true, the caller should auto-compact and retry.
+     */
+    static isContextOverflowError(error) {
+        const msg = (error?.message ?? '').toLowerCase();
+        return msg.includes('too many tokens')
+            || msg.includes('context length')
+            || msg.includes('context_length_exceeded')
+            || msg.includes('maximum context')
+            || msg.includes('token limit')
+            || msg.includes('input too long')
+            || msg.includes('request too large')
+            || (msg.includes('413') && (msg.includes('token') || msg.includes('too large')))
+            || (msg.includes('400') && msg.includes('token'));
+    }
+}
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { getConfigDir } from '../config.js';
+export class SessionManager {
+    static getSessionsDir() {
+        const dir = path.join(getConfigDir(), 'sessions');
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        return dir;
+    }
+    static saveSession(conversation, model, modifiedFiles, tokenUsage, sessionId) {
+        const id = sessionId || crypto.randomUUID();
+        const dir = this.getSessionsDir();
+        const filePath = path.join(dir, `session_${id}.json`);
+        const data = {
+            sessionId: id,
+            timestamp: new Date().toISOString(),
+            model,
+            history: conversation.exportHistory(),
+            summary: conversation.getSummary(),
+            modifiedFiles,
+            tokenUsage,
+        };
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2), { encoding: 'utf-8', mode: 0o600 });
+        return id;
+    }
+    static listSessions() {
+        const dir = this.getSessionsDir();
+        const results = [];
+        try {
+            const files = fs.readdirSync(dir);
+            for (const file of files) {
+                if (file.startsWith('session_') && file.endsWith('.json')) {
+                    try {
+                        const raw = fs.readFileSync(path.join(dir, file), 'utf-8');
+                        const data = JSON.parse(raw);
+                        results.push({
+                            sessionId: data.sessionId,
+                            timestamp: data.timestamp,
+                            model: data.model,
+                            messageCount: data.history.length,
+                            summary: data.summary,
+                            totalTokens: data.tokenUsage?.total_tokens || 0,
+                        });
+                    }
+                    catch (err) {
+                        console.warn(`[Debug Warning] Failed to parse session file ${file}:`, err.message || err);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                console.warn(`[Debug Warning] Failed to list sessions in ${dir}:`, err.message || err);
+            }
+        }
+        return results.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+    }
+    static loadSession(id) {
+        const dir = this.getSessionsDir();
+        const filePath = path.join(dir, `session_${id}.json`);
+        if (!fs.existsSync(filePath)) {
+            throw new Error(`Session file not found for ID: ${id}`);
+        }
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+}
+//# sourceMappingURL=conversation.js.map

package/dist/agent/conversation.js.map

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

package/dist/agent/hooks.d.ts

@@ -0,0 +1,72 @@
+export type HookEvent = 'PreToolUse' | 'PostToolUse';
+export type HookDecision = 'allow' | 'deny' | 'modify';
+export interface HookPayload {
+    event: HookEvent;
+    tool: string;
+    args: Record<string, unknown>;
+    sessionId: string;
+    /** Cwd at the time the hook fired. */
+    cwd: string;
+}
+export interface HookCommandResult {
+    decision: HookDecision;
+    reason?: string;
+    modifiedArgs?: Record<string, unknown>;
+}
+export interface HookSpec {
+    /** Stable identifier for the hook (used in telemetry). */
+    id: string;
+    /** Event this hook listens to. */
+    event: HookEvent;
+    /** Command to run, including args. */
+    command: string;
+    /** Args passed to the command. */
+    args?: string[];
+    /** When false, the hook is skipped. Default: true. */
+    enabled?: boolean;
+    /** Per-hook timeout in ms. Default: 5000. */
+    timeoutMs?: number;
+}
+export interface HooksFile {
+    version: 1;
+    hooks: HookSpec[];
+}
+export interface HookExecutionResult {
+    fired: boolean;
+    decision: HookDecision;
+    reason?: string;
+    modifiedArgs?: Record<string, unknown>;
+    durationMs: number;
+    hookId: string | null;
+}
+/** Read `.fixo/hooks.json` from cwd. Returns null if absent. */
+export declare function loadHooksFile(cwd: string): HooksFile | null;
+/** Save the hooks file. Used by /hooks slash command. */
+export declare function saveHooksFile(cwd: string, file: HooksFile): {
+    ok: boolean;
+    error?: string;
+};
+/** Hooks for a given event. */
+export declare function getHooksForEvent(cwd: string, event: HookEvent): HookSpec[];
+/**
+ * Fire all hooks for an event, in declaration order. The
+ * first non-`allow` decision wins. Returns the aggregated
+ * result.
+ */
+export declare function fireHooks(cwd: string, event: HookEvent, payload: Omit<HookPayload, 'event' | 'cwd'>): HookExecutionResult;
+/**
+ * Apply a pre-hook's `modify` decision: re-validate
+ * `modifiedArgs` through `WorkspaceGuard.resolve()` to
+ * prevent an attacker-controlled hook from writing outside
+ * the workspace. The check is a *best-effort* scan: any
+ * `path`/`filePath`/`cwd` field in the args must resolve
+ * inside `cwd` (relative paths are fine).
+ */
+export declare function applyModifiedArgs(cwd: string, original: Record<string, unknown>, modified: Record<string, unknown>): {
+    ok: boolean;
+    args: Record<string, unknown>;
+    reason?: string;
+};
+/** Get the hooks file path for a cwd (test-only introspection). */
+export declare function getHooksPath(cwd: string): string;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/agent/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/agent/hooks.ts"],"names":[],"mappings":"AAoCA,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,aAAa,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,QAAQ;IACvB,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,KAAK,EAAE,SAAS,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAMD,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAU3D;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAS3F;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,CAI1E;AAsDD;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,KAAK,CAAC,GAC1C,mBAAmB,CAyCrB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAwBjE;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}