opencarly 1.0.0

package/dist/formatter/formatter.js

@@ -0,0 +1,129 @@
+/**
+ * OpenCarly Rule Formatter
+ *
+ * Formats loaded rules into a text block for injection into the system prompt.
+ * Output is wrapped in <carly-rules> XML tags.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function formatRuleList(rules, indent = "  ") {
+    return rules.map((rule, i) => `${indent}${i + 1}. ${rule}`).join("\n");
+}
+function domainLabel(name) {
+    return name.toUpperCase();
+}
+// ---------------------------------------------------------------------------
+// Main formatter
+// ---------------------------------------------------------------------------
+/**
+ * Format loaded rules into an injectable text block.
+ *
+ * Output sections (in order):
+ * 1. Context bracket status
+ * 2. Bracket-specific rules
+ * 3. Active star-commands (prominent)
+ * 4. DEVMODE instruction
+ * 5. Loaded domains summary
+ * 6. Always-on domain rules
+ * 7. Keyword-matched domain rules
+ * 8. Exclusion notices
+ * 9. Available (not loaded) domains
+ */
+export function formatRules(loaded) {
+    const sections = [];
+    // 1. Context bracket status
+    if (loaded.contextEnabled) {
+        let bracketLine = `CONTEXT BRACKET: [${loaded.bracket}] (prompt ${loaded.promptCount})`;
+        if (loaded.bracket === "CRITICAL") {
+            bracketLine +=
+                "\nCONTEXT CRITICAL: Session is long. Recommend: compact session OR spawn fresh agent.";
+        }
+        sections.push(bracketLine);
+    }
+    // 2. Bracket-specific rules
+    if (loaded.contextEnabled && loaded.bracketRules.length > 0) {
+        sections.push(`[${loaded.bracket}] CONTEXT RULES:\n${formatRuleList(loaded.bracketRules)}`);
+    }
+    // 3. Active star-commands
+    const commandNames = Object.keys(loaded.commands);
+    if (commandNames.length > 0) {
+        const cmdSections = [];
+        cmdSections.push("--- ACTIVE COMMANDS ---");
+        for (const cmdName of commandNames) {
+            const rules = loaded.commands[cmdName];
+            cmdSections.push(`[*${cmdName}]:\n${formatRuleList(rules)}`);
+        }
+        cmdSections.push("--- END COMMANDS ---");
+        sections.push(cmdSections.join("\n"));
+    }
+    // 4. DEVMODE instruction
+    if (loaded.devmode) {
+        const statsInfo = loaded.injectionStats
+            ? `\nToken Efficiency: ${loaded.injectionStats.rulesThisPrompt} rules this prompt | avg ${loaded.injectionStats.avgRulesPerPrompt}/prompt over ${loaded.injectionStats.totalPromptsSession} prompts`
+            : "";
+        const savingsInfo = loaded.tokenSavings
+            ? `\nToken Savings: ~${loaded.tokenSavings.totalSaved.toLocaleString()} tokens saved this session (selection: ~${loaded.tokenSavings.skippedBySelection.toLocaleString()}, trimming: ~${loaded.tokenSavings.trimmedFromHistory.toLocaleString()})`
+            : "";
+        sections.push(`DEVMODE: on
+You MUST append the following debug block to EVERY response:
+
+CARLY DEVMODE
+Domains Loaded: [list all loaded domains]
+Rules Applied: [specific rule numbers from each domain]
+Star-Commands: [any active star-commands]
+Bracket: [current context bracket]
+Matched Keywords: [keywords that triggered domains]${statsInfo}${savingsInfo}`);
+    }
+    else {
+        sections.push("DEVMODE: off\nDo NOT append any debug blocks to your responses. Respond normally.");
+    }
+    // 5. Loaded domains summary
+    const summaryLines = [];
+    for (const [name, rules] of Object.entries(loaded.alwaysOn)) {
+        summaryLines.push(`  [${domainLabel(name)}] always_on (${rules.length} rules)`);
+    }
+    for (const [name, rules] of Object.entries(loaded.matched)) {
+        const paths = loaded.matchedPaths[name] || [];
+        if (paths.length > 0) {
+            const pathStr = paths.map((p) => `"${p}"`).join(", ");
+            summaryLines.push(`  [${domainLabel(name)}] matched path: ${pathStr} (${rules.length} rules)`);
+        }
+        else {
+            const keywords = loaded.matchedKeywords[name] || [];
+            const kwStr = keywords.map((k) => `"${k}"`).join(", ");
+            summaryLines.push(`  [${domainLabel(name)}] matched: ${kwStr} (${rules.length} rules)`);
+        }
+    }
+    if (summaryLines.length > 0) {
+        sections.push(`LOADED DOMAINS:\n${summaryLines.join("\n")}`);
+    }
+    // 6. Always-on domain rules
+    for (const [name, rules] of Object.entries(loaded.alwaysOn)) {
+        sections.push(`[${domainLabel(name)}] RULES:\n${formatRuleList(rules)}`);
+    }
+    // 7. Keyword-matched domain rules
+    for (const [name, rules] of Object.entries(loaded.matched)) {
+        sections.push(`[${domainLabel(name)}] RULES:\n${formatRuleList(rules)}`);
+    }
+    // 8. Exclusion notices
+    if (loaded.globalExcluded.length > 0) {
+        const kwStr = loaded.globalExcluded.map((k) => `"${k}"`).join(", ");
+        sections.push(`GLOBAL EXCLUSION ACTIVE: ${kwStr}\nAll domain matching was skipped for this prompt.`);
+    }
+    for (const [name, keywords] of Object.entries(loaded.excludedDomains)) {
+        const kwStr = keywords.map((k) => `"${k}"`).join(", ");
+        sections.push(`[${domainLabel(name)}] EXCLUDED by: ${kwStr}`);
+    }
+    // 9. Available (not loaded) domains
+    if (loaded.availableDomains.length > 0) {
+        const available = loaded.availableDomains
+            .map((d) => `  ${domainLabel(d.name)} (recall: ${d.recall.join(", ")})`)
+            .join("\n");
+        sections.push(`AVAILABLE (not loaded):\n${available}`);
+    }
+    // Wrap in XML tags
+    const body = sections.join("\n\n");
+    return `<carly-rules>\n${body}\n</carly-rules>`;
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter/formatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * OpenCarly - Context Augmentation & Reinforcement Layer for OpenCode
+ *
+ * Dynamic rules that load when relevant, disappear when not.
+ * Replicates CARL (https://github.com/ChristopherKahler/carl) for OpenCode.
+ *
+ * Hook flow per user message:
+ * 1. chat.message -> scan prompt for keywords + star-commands, update session
+ * 2. experimental.chat.system.transform -> load rules, format, inject into system prompt
+ * 3. experimental.chat.messages.transform -> smart trim stale tool outputs + carly-rules
+ */
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const OpenCarly: Plugin;
+export default OpenCarly;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAiOlD,eAAO,MAAM,SAAS,EAAE,MAgXvB,CAAC;AAGF,eAAe,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,484 @@
+/**
+ * OpenCarly - Context Augmentation & Reinforcement Layer for OpenCode
+ *
+ * Dynamic rules that load when relevant, disappear when not.
+ * Replicates CARL (https://github.com/ChristopherKahler/carl) for OpenCode.
+ *
+ * Hook flow per user message:
+ * 1. chat.message -> scan prompt for keywords + star-commands, update session
+ * 2. experimental.chat.system.transform -> load rules, format, inject into system prompt
+ * 3. experimental.chat.messages.transform -> smart trim stale tool outputs + carly-rules
+ */
+import { tool } from "@opencode-ai/plugin";
+import { discoverConfig } from "./config/discovery";
+import { loadConfig } from "./config/manifest";
+import { matchDomains } from "./engine/matcher";
+import { loadRules, calculateBaseline } from "./engine/loader";
+import { getBracket } from "./engine/brackets";
+import { trimMessageHistory } from "./engine/trimmer";
+import { formatRules } from "./formatter/formatter";
+import { getOrCreateSession, updateSessionActivity, saveSession, applySessionOverrides, cleanStaleSessions, loadCumulativeStats, updateCumulativeStats, clearAllStats, } from "./session/session";
+function createLogger(client) {
+    return async (level, message, extra) => {
+        try {
+            await client.app.log({
+                body: {
+                    service: "opencarly",
+                    level,
+                    message,
+                    extra,
+                },
+            });
+        }
+        catch {
+            // Logging failure should never crash the plugin
+        }
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extract plain text from message parts.
+ */
+function extractPromptText(parts) {
+    const textParts = [];
+    for (const part of parts) {
+        if (part.type === "text" && typeof part.text === "string") {
+            textParts.push(part.text);
+        }
+    }
+    return textParts.join("\n");
+}
+/**
+ * Count total rules across a record of domain -> rules[].
+ */
+function countRules(domains) {
+    let count = 0;
+    for (const rules of Object.values(domains)) {
+        count += rules.length;
+    }
+    return count;
+}
+/**
+ * Estimate tokens from a rule array (~4 chars per token).
+ */
+function estimateRuleTokens(rules) {
+    let chars = 0;
+    for (const ruleList of Object.values(rules)) {
+        for (const rule of ruleList) {
+            chars += rule.length;
+        }
+    }
+    return Math.ceil(chars / 4);
+}
+/**
+ * Estimate tokens from a string.
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+async function generateStatsReport(configPath, activeSessionId, activeModel) {
+    const stats = loadCumulativeStats(configPath);
+    let currentSessionSummary = activeSessionId
+        ? stats.sessions.find(s => s.sessionId === activeSessionId)
+        : stats.sessions[stats.sessions.length - 1];
+    let currentTokenStats = {
+        tokensSkippedBySelection: 0,
+        tokensTrimmedFromHistory: 0,
+        tokensTrimmedCarlyBlocks: 0,
+        tokensInjected: 0,
+    };
+    const targetSessionId = activeSessionId || currentSessionSummary?.sessionId;
+    if (targetSessionId) {
+        const path = await import("path");
+        const sessionPath = path.join(configPath, "sessions", `${targetSessionId}.json`);
+        try {
+            const fs = await import("fs");
+            const sessionData = JSON.parse(await fs.promises.readFile(sessionPath, "utf-8"));
+            currentTokenStats = {
+                tokensSkippedBySelection: sessionData.tokenStats?.tokensSkippedBySelection || 0,
+                tokensTrimmedFromHistory: sessionData.tokenStats?.tokensTrimmedFromHistory || 0,
+                tokensTrimmedCarlyBlocks: sessionData.tokenStats?.tokensTrimmedCarlyBlocks || 0,
+                tokensInjected: sessionData.tokenStats?.tokensInjected || 0,
+            };
+            if (!currentSessionSummary) {
+                currentSessionSummary = {
+                    sessionId: targetSessionId,
+                    date: sessionData.started || new Date().toISOString(),
+                    tokensSaved: (currentTokenStats.tokensSkippedBySelection + currentTokenStats.tokensTrimmedFromHistory + currentTokenStats.tokensTrimmedCarlyBlocks),
+                    promptsProcessed: sessionData.promptCount || 0,
+                    tokensSkippedBySelection: currentTokenStats.tokensSkippedBySelection,
+                    tokensTrimmedFromHistory: currentTokenStats.tokensTrimmedFromHistory,
+                    tokensTrimmedCarlyBlocks: currentTokenStats.tokensTrimmedCarlyBlocks,
+                    tokensInjected: currentTokenStats.tokensInjected,
+                    rulesInjected: sessionData.tokenStats?.rulesInjected || 0,
+                };
+            }
+        }
+        catch {
+            // Ignore file not found or invalid JSON
+        }
+    }
+    const formatNumber = (n) => {
+        if (n >= 1000000)
+            return `${(n / 1000000).toFixed(1)}M`;
+        if (n >= 1000)
+            return `${(n / 1000).toFixed(1)}K`;
+        return n.toString();
+    };
+    const historyTrimmed = currentTokenStats.tokensTrimmedFromHistory + currentTokenStats.tokensTrimmedCarlyBlocks;
+    let output = `# OPENCARLY TOKEN SAVINGS REPORT\n\n`;
+    output += `## 📊 CURRENT SESSION\n`;
+    output += `**Prompts Processed**: ${currentSessionSummary?.promptsProcessed || 0}\n`;
+    output += `**Total Tokens Saved**: ${formatNumber(currentSessionSummary?.tokensSaved || 0)}\n\n`;
+    output += `### Savings Breakdown\n`;
+    output += `| Category | Tokens Saved |\n|---|---|\n`;
+    output += `| **Selective Rule Injection** | ${formatNumber(currentTokenStats.tokensSkippedBySelection)} |\n`;
+    output += `| **History Trimming (Total)** | ${formatNumber(historyTrimmed)} |\n`;
+    output += `| ↳ *Tool Output Trimming* | ${formatNumber(currentTokenStats.tokensTrimmedFromHistory)} |\n`;
+    output += `| ↳ *Stale Carly-Blocks* | ${formatNumber(currentTokenStats.tokensTrimmedCarlyBlocks)} |\n\n`;
+    output += `## 🕒 RECENT SESSION HISTORY\n`;
+    output += `| Date | Session ID | Prompts | Tokens Saved |\n|---|---|---|---|\n`;
+    for (const session of stats.sessions.slice().reverse().slice(0, 10)) {
+        const shortId = session.sessionId.replace("ses_", "").slice(0, 8) + "...";
+        output += `| ${session.date?.split("T")[0] || "Unknown"} | \`${shortId}\` | ${session.promptsProcessed} | ${formatNumber(session.tokensSaved || 0)} |\n`;
+    }
+    if (stats.sessions.length > 10) {
+        output += `| ... | ... | ... | ... |\n`;
+    }
+    output += `\n`;
+    const totalPrompts = stats.sessions.reduce((sum, s) => sum + (s.promptsProcessed || 0), 0);
+    output += `## 🌎 ALL-TIME TOTALS\n`;
+    output += `| Metric | Value |\n|--------|-------|\n`;
+    output += `| **Total Tokens Saved** | **${formatNumber(stats.cumulative.totalTokensSaved)}** |\n`;
+    output += `| - From Selective Injection | ${formatNumber(stats.cumulative.tokensSkippedBySelection)} |\n`;
+    output += `| - From History Trimming | ${formatNumber(stats.cumulative.tokensTrimmedFromHistory + stats.cumulative.tokensTrimmedCarlyBlocks)} |\n`;
+    output += `| Total Tokens Injected | ${formatNumber(stats.cumulative.tokensInjected)} |\n`;
+    output += `| Total Prompts Processed | ${totalPrompts} |\n`;
+    output += `| Total Sessions | ${stats.sessions.length} |\n`;
+    output += `| Avg Savings / Session | ${formatNumber(Math.round(stats.cumulative.totalTokensSaved / Math.max(1, stats.sessions.length)))} |\n\n`;
+    if (activeModel) {
+        output += `> **System Instruction for AI Assistant:**\n`;
+        output += `> To finalize this report, please execute a web search to find both the "standard input token pricing" and "context caching input token pricing" (if applicable) for your current model: \`${activeModel}\`.\n`;
+        output += `> Calculate a savings range based on the "Total Tokens Saved":\n`;
+        output += `> - Minimum Savings: Assume 100% of the saved tokens would have been cached.\n`;
+        output += `> - Maximum Savings: Assume 0% of the saved tokens would have been cached.\n`;
+        output += `> Append an "Estimated Dollar Savings Range: $X.XX - $Y.YY" section to your response, and add a brief 1-sentence note explaining that the lower bound accounts for context caching.\n\n`;
+    }
+    return output;
+}
+// Plugin entry point
+// ---------------------------------------------------------------------------
+export const OpenCarly = async ({ directory, client }) => {
+    const log = createLogger(client);
+    // Discover config
+    const discovery = discoverConfig(directory);
+    if (!discovery) {
+        await log("info", "No .opencarly/ config found - plugin inactive", {
+            searchedFrom: directory,
+        });
+        return {};
+    }
+    await log("info", `Config found at ${discovery.configPath} (${discovery.scope})`, {
+        configPath: discovery.configPath,
+        scope: discovery.scope,
+    });
+    // Load config
+    let config;
+    try {
+        config = loadConfig(discovery.configPath);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        await log("error", `Config loading failed: ${message}`, {
+            configPath: discovery.configPath,
+            error: message,
+        });
+        return {};
+    }
+    // Log warnings
+    for (const warning of config.warnings) {
+        await log("warn", warning, { configPath: discovery.configPath });
+    }
+    // Calculate baseline (all rules loaded every prompt)
+    const baselineTokensPerPrompt = calculateBaseline(config);
+    // Log startup summary
+    const domainNames = Object.keys(config.manifest.domains);
+    const commandNames = Object.keys(config.commands);
+    await log("info", "OpenCarly initialized", {
+        domains: domainNames,
+        domainCount: domainNames.length,
+        commands: commandNames,
+        commandCount: commandNames.length,
+        devmode: config.manifest.devmode,
+        contextBrackets: config.manifest.context.state,
+        commandsSystem: config.manifest.commands.state,
+        baselineTokensPerPrompt,
+    });
+    // Initialize state
+    const cumulativeStats = loadCumulativeStats(discovery.configPath);
+    const state = {
+        config,
+        sessions: new Map(),
+        lastMatch: new Map(),
+        lastPrompt: new Map(),
+        activeSessionID: null,
+        activeModel: null,
+        baselineTokensPerPrompt,
+        cumulativeStats,
+    };
+    // Clean stale sessions on startup
+    try {
+        const cleaned = cleanStaleSessions(discovery.configPath);
+        if (cleaned > 0) {
+            await log("debug", `Cleaned ${cleaned} stale session(s)`);
+        }
+    }
+    catch {
+        // Non-critical
+    }
+    return {
+        // -----------------------------------------------------------------
+        // Event hook: track session lifecycle and intercept commands
+        // -----------------------------------------------------------------
+        event: async ({ event }) => {
+            if (event.type === "session.created") {
+                try {
+                    cleanStaleSessions(discovery.configPath);
+                }
+                catch {
+                    // ignore
+                }
+            }
+        },
+        // -----------------------------------------------------------------
+        // chat.message: scan prompt, detect keywords + star-commands
+        // -----------------------------------------------------------------
+        "chat.message": async (input, output) => {
+            const { sessionID, model } = input;
+            // Capture the active model ID for stats reporting
+            if (model?.modelID) {
+                state.activeModel = model.modelID;
+            }
+            const promptText = extractPromptText(output.parts);
+            if (!promptText)
+                return;
+            // Get or create session
+            const { session, isNew } = getOrCreateSession(discovery.configPath, sessionID, directory);
+            if (isNew || !state.sessions.has(sessionID)) {
+                state.sessions.set(sessionID, session);
+            }
+            const currentSession = state.sessions.get(sessionID);
+            // Set baseline on session if not set
+            if (currentSession.tokenStats.baselineTokensPerPrompt === 0) {
+                currentSession.tokenStats.baselineTokensPerPrompt = state.baselineTokensPerPrompt;
+            }
+            // Update session activity
+            updateSessionActivity(currentSession, promptText);
+            // Apply session overrides
+            const effectiveManifest = applySessionOverrides(state.config.manifest, currentSession);
+            // Run domain matcher
+            const matchResult = matchDomains(promptText, effectiveManifest);
+            // Cache for system.transform hook
+            state.lastMatch.set(sessionID, matchResult);
+            state.lastPrompt.set(sessionID, promptText);
+            state.activeSessionID = sessionID;
+            // Log match results
+            await log("debug", "Prompt matched", {
+                sessionID,
+                promptCount: currentSession.promptCount,
+                alwaysOn: matchResult.alwaysOn,
+                matched: Object.keys(matchResult.matched),
+                excluded: Object.keys(matchResult.excluded),
+                globalExcluded: matchResult.globalExcluded,
+                starCommands: matchResult.starCommands,
+            });
+            // Persist session
+            try {
+                saveSession(discovery.configPath, currentSession);
+            }
+            catch {
+                // Non-critical
+            }
+        },
+        // -----------------------------------------------------------------
+        // experimental.chat.system.transform: inject rules into system prompt
+        // -----------------------------------------------------------------
+        "experimental.chat.system.transform": async (input, output) => {
+            const sessionID = input.sessionID;
+            if (!sessionID)
+                return;
+            const matchResult = state.lastMatch.get(sessionID);
+            if (!matchResult)
+                return;
+            const session = state.sessions.get(sessionID);
+            const promptCount = session?.promptCount ?? 1;
+            const tokenStats = session?.tokenStats ?? {
+                tokensSkippedBySelection: 0,
+                tokensInjected: 0,
+                tokensTrimmedFromHistory: 0,
+                tokensTrimmedCarlyBlocks: 0,
+                promptsProcessed: 0,
+                rulesInjected: 0,
+                baselineTokensPerPrompt: state.baselineTokensPerPrompt,
+            };
+            // Apply session overrides
+            const effectiveManifest = session
+                ? applySessionOverrides(state.config.manifest, session)
+                : state.config.manifest;
+            // Determine context bracket
+            const bracket = getBracket(promptCount, state.config.context);
+            // Build effective config
+            const effectiveConfig = {
+                ...state.config,
+                manifest: effectiveManifest,
+            };
+            // Load rules
+            const loaded = loadRules(matchResult, effectiveConfig, bracket, promptCount);
+            // Override devmode from effective manifest
+            loaded.devmode = effectiveManifest.devmode;
+            loaded.contextEnabled = effectiveManifest.context.state === "active";
+            loaded.commandsEnabled = effectiveManifest.commands.state === "active";
+            // --- Token stats calculation ---
+            const totalRulesThisPrompt = countRules(loaded.alwaysOn) +
+                countRules(loaded.matched) +
+                countRules(loaded.commands) +
+                loaded.bracketRules.length;
+            const tokensInjectedThisPrompt = estimateRuleTokens(loaded.alwaysOn) +
+                estimateRuleTokens(loaded.matched) +
+                estimateRuleTokens(loaded.commands) +
+                estimateTokens(loaded.bracketRules.join(""));
+            const tokensSkippedThisPrompt = Math.max(0, state.baselineTokensPerPrompt - tokensInjectedThisPrompt);
+            // Accumulate stats
+            tokenStats.tokensInjected += tokensInjectedThisPrompt;
+            tokenStats.tokensSkippedBySelection += tokensSkippedThisPrompt;
+            tokenStats.promptsProcessed += 1;
+            tokenStats.rulesInjected = (tokenStats.rulesInjected || 0) + totalRulesThisPrompt;
+            // Update session
+            if (session) {
+                session.tokenStats = tokenStats;
+                try {
+                    saveSession(discovery.configPath, session);
+                    state.cumulativeStats = updateCumulativeStats(discovery.configPath, session);
+                }
+                catch {
+                    // Non-critical
+                }
+            }
+            // Attach injection stats for DEVMODE display
+            loaded.injectionStats = {
+                rulesThisPrompt: totalRulesThisPrompt,
+                totalRulesSession: tokenStats.rulesInjected || totalRulesThisPrompt,
+                totalPromptsSession: tokenStats.promptsProcessed,
+                avgRulesPerPrompt: tokenStats.promptsProcessed > 0
+                    ? Math.round((tokenStats.rulesInjected || 0) / tokenStats.promptsProcessed)
+                    : totalRulesThisPrompt,
+            };
+            // Format and inject
+            const formatted = formatRules(loaded);
+            output.system.push(formatted);
+            // Persist session with updated stats
+            if (session) {
+                try {
+                    saveSession(discovery.configPath, session);
+                }
+                catch {
+                    // Non-critical
+                }
+            }
+            // Cleanup cached match
+            state.lastMatch.delete(sessionID);
+            state.lastPrompt.delete(sessionID);
+        },
+        // -----------------------------------------------------------------
+        // experimental.chat.messages.transform: smart tool output trimming
+        // -----------------------------------------------------------------
+        "experimental.chat.messages.transform": async (_input, output) => {
+            const trimConfig = state.config.context.trimming;
+            const trimStats = trimMessageHistory(output.messages, trimConfig);
+            // Accumulate trim stats to the session
+            if (trimStats.tokensSaved > 0 || trimStats.carlyBlocksStripped > 0) {
+                const sessionID = state.activeSessionID;
+                const session = sessionID ? state.sessions.get(sessionID) : undefined;
+                if (session) {
+                    session.tokenStats.tokensTrimmedFromHistory += trimStats.tokensSaved;
+                    session.tokenStats.tokensTrimmedCarlyBlocks += trimStats.carlyTokensSaved;
+                    try {
+                        saveSession(discovery.configPath, session);
+                    }
+                    catch {
+                        // Non-critical
+                    }
+                }
+                await log("debug", "History trimmed", {
+                    partsTrimmed: trimStats.partsTrimmed,
+                    tokensSaved: trimStats.tokensSaved,
+                    carlyBlocksStripped: trimStats.carlyBlocksStripped,
+                    mode: trimConfig.mode,
+                });
+            }
+            // Always update cumulative stats after messages transform completes
+            const sessionID = state.activeSessionID;
+            const session = sessionID ? state.sessions.get(sessionID) : undefined;
+            if (session) {
+                try {
+                    state.cumulativeStats = updateCumulativeStats(discovery.configPath, session);
+                }
+                catch {
+                    // Non-critical
+                }
+            }
+        },
+        // -----------------------------------------------------------------
+        // Compaction hook: preserve CARLY context across compaction
+        // -----------------------------------------------------------------
+        "experimental.session.compacting": async (_input, output) => {
+            output.context.push("OpenCarly (dynamic rule injection) is active. " +
+                "Rules are injected per-prompt based on keyword matching. " +
+                "Preserve awareness that <carly-rules> blocks contain mandatory instructions.");
+        },
+        tool: {
+            stats: tool({
+                description: "Get OpenCarly token savings statistics",
+                args: {},
+                execute: async (_args, _context) => {
+                    return generateStatsReport(discovery.configPath, state.activeSessionID || undefined, state.activeModel);
+                },
+            }),
+            clear_stats: tool({
+                description: "Clear all OpenCarly token savings statistics",
+                args: {},
+                execute: async (_args, _context) => {
+                    clearAllStats(discovery.configPath);
+                    state.cumulativeStats = {
+                        version: 1,
+                        cumulative: {
+                            tokensSkippedBySelection: 0,
+                            tokensInjected: 0,
+                            tokensTrimmedFromHistory: 0,
+                            tokensTrimmedCarlyBlocks: 0,
+                            totalTokensSaved: 0,
+                        },
+                        sessions: [],
+                    };
+                    for (const session of state.sessions.values()) {
+                        session.tokenStats = {
+                            tokensSkippedBySelection: 0,
+                            tokensInjected: 0,
+                            tokensTrimmedFromHistory: 0,
+                            tokensTrimmedCarlyBlocks: 0,
+                            promptsProcessed: 0,
+                            rulesInjected: 0,
+                            baselineTokensPerPrompt: state.baselineTokensPerPrompt,
+                        };
+                    }
+                    return "All OpenCarly token savings statistics have been successfully reset to zero.";
+                },
+            }),
+        },
+    };
+};
+// Default export for single-export plugin files
+export default OpenCarly;
+//# sourceMappingURL=index.js.map