opencarly 1.0.0

package/dist/engine/matcher.js

@@ -0,0 +1,174 @@
+/**
+ * OpenCarly Domain Matcher
+ *
+ * Scans user prompts for domain recall keywords and star-commands.
+ * Handles global and per-domain exclusions.
+ */
+// ---------------------------------------------------------------------------
+// Star-command detection
+// ---------------------------------------------------------------------------
+/**
+ * Detect star-commands in the prompt.
+ * e.g. "*brief *dev explain this" -> ["brief", "dev"]
+ */
+export function detectStarCommands(prompt) {
+    const commands = [];
+    // Use matchAll to avoid global RegExp state mutation race conditions
+    const matches = prompt.matchAll(/\*([a-zA-Z]\w*)/g);
+    for (const match of matches) {
+        commands.push(match[1].toLowerCase());
+    }
+    return [...new Set(commands)]; // deduplicate
+}
+// ---------------------------------------------------------------------------
+// Path and Glob Matching
+// ---------------------------------------------------------------------------
+const globRegexCache = new Map();
+function globToRegExp(glob) {
+    if (globRegexCache.has(glob))
+        return globRegexCache.get(glob);
+    let escaped = "";
+    for (let i = 0; i < glob.length; i++) {
+        const c = glob[i];
+        if (/[.+^${}()|[\]\\]/.test(c)) {
+            escaped += "\\" + c;
+        }
+        else {
+            escaped += c;
+        }
+    }
+    const regexStr = "^" + escaped.replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*").replace(/\?/g, ".") + "$";
+    const regex = new RegExp(regexStr);
+    globRegexCache.set(glob, regex);
+    return regex;
+}
+/**
+ * Check if a file path matches any of the given glob patterns.
+ */
+export function isPathMatch(filePath, patterns) {
+    for (const pattern of patterns) {
+        if (globToRegExp(pattern).test(filePath)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Extracts possible file paths from a user prompt.
+ * Looks for words containing `/` or a file extension (like `.ts`).
+ */
+function extractPathsFromPrompt(prompt) {
+    const words = prompt.split(/\s+/);
+    const paths = [];
+    for (const word of words) {
+        // Strip trailing punctuation
+        const cleanWord = word.replace(/[.,;:!?)$'"]+$/, "").replace(/^['"(]+/, "");
+        if (cleanWord.includes("/") || /\.[a-z0-9]{1,4}$/i.test(cleanWord)) {
+            paths.push(cleanWord);
+        }
+    }
+    return [...new Set(paths)];
+}
+// ---------------------------------------------------------------------------
+// Keyword matching
+// ---------------------------------------------------------------------------
+/**
+ * Check if any keywords from the list appear in the prompt (case-insensitive substring match).
+ * Returns the list of matching keywords.
+ */
+function findMatchingKeywords(prompt, keywords) {
+    const promptLower = prompt.toLowerCase();
+    const matches = [];
+    for (const keyword of keywords) {
+        const keywordLower = keyword.toLowerCase().trim();
+        if (keywordLower === "")
+            continue;
+        // Escape regex special chars and do boundary match
+        const escaped = keywordLower.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        if (new RegExp(`(^|\\W)${escaped}($|\\W)`, "i").test(promptLower)) {
+            matches.push(keyword);
+        }
+    }
+    return matches;
+}
+// ---------------------------------------------------------------------------
+// Main matching function
+// ---------------------------------------------------------------------------
+/**
+ * Match domains against a user prompt.
+ *
+ * Algorithm:
+ * 1. Check globalExclude - if any match, skip all domain matching
+ * 2. Collect always-on active domains
+ * 3. For each active, non-alwaysOn domain:
+ *    a. Check per-domain exclude keywords
+ *    b. Check recall keywords
+ * 4. Detect star-commands
+ */
+export function matchDomains(prompt, manifest, activeFiles = []) {
+    const result = {
+        matched: {},
+        matchedPaths: {},
+        excluded: {},
+        globalExcluded: [],
+        starCommands: [],
+        alwaysOn: [],
+    };
+    // 1. Check global exclusions
+    if (manifest.globalExclude.length > 0) {
+        const globalMatches = findMatchingKeywords(prompt, manifest.globalExclude);
+        if (globalMatches.length > 0) {
+            result.globalExcluded = globalMatches;
+            // Still detect star-commands even when globally excluded
+            result.starCommands = detectStarCommands(prompt);
+            return result;
+        }
+    }
+    // Extract possible paths from user prompt and combine with activeFiles
+    const promptPaths = extractPathsFromPrompt(prompt);
+    const allActiveFiles = [...new Set([...activeFiles, ...promptPaths])];
+    // 2-3. Process each domain
+    for (const [name, domain] of Object.entries(manifest.domains)) {
+        // Skip inactive domains
+        if (domain.state === "inactive")
+            continue;
+        // Collect always-on domains
+        if (domain.alwaysOn) {
+            result.alwaysOn.push(name);
+            continue; // always-on domains don't need keyword matching
+        }
+        // Check per-domain exclusions
+        if (domain.exclude.length > 0) {
+            const excludeMatches = findMatchingKeywords(prompt, domain.exclude);
+            if (excludeMatches.length > 0) {
+                result.excluded[name] = excludeMatches;
+                continue;
+            }
+        }
+        // Check file paths first
+        if (domain.paths && domain.paths.length > 0) {
+            const pathMatches = [];
+            for (const file of allActiveFiles) {
+                if (isPathMatch(file, domain.paths)) {
+                    pathMatches.push(file);
+                }
+            }
+            if (pathMatches.length > 0) {
+                result.matchedPaths[name] = pathMatches;
+                // Skip keyword recall check if path triggered it
+                continue;
+            }
+        }
+        // Check recall keywords
+        if (domain.recall.length > 0) {
+            const recallMatches = findMatchingKeywords(prompt, domain.recall);
+            if (recallMatches.length > 0) {
+                result.matched[name] = recallMatches;
+            }
+        }
+    }
+    // 4. Detect star-commands
+    result.starCommands = detectStarCommands(prompt);
+    return result;
+}
+//# sourceMappingURL=matcher.js.map

package/dist/engine/matcher.js.map

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

package/dist/engine/trimmer.d.ts

@@ -0,0 +1,91 @@
+/**
+ * OpenCarly Smart Tool Output Trimmer
+ *
+ * Multi-factor scoring system that determines which tool outputs in
+ * conversation history are safe to trim. Replaces stale outputs with
+ * compact summaries to reduce token usage without degrading AI quality.
+ *
+ * Factors considered:
+ * - Age (turns since message)
+ * - Superseded file reads (same file read again more recently)
+ * - Post-read file edits (file was modified after being read)
+ * - Output size (larger = better trim candidate)
+ * - Tool type (ephemeral tools like bash/glob are safer to trim)
+ * - Tiny output protection (don't bother trimming small outputs)
+ */
+import { type TrimmingConfig } from "../config/schema";
+/**
+ * Minimal types mirroring the OpenCode SDK Part/Message shapes.
+ * We use structural typing so we don't need to import the SDK directly.
+ */
+interface ToolStateCompleted {
+    status: "completed";
+    input: Record<string, unknown>;
+    output: string;
+    title: string;
+    metadata: Record<string, unknown>;
+    time: {
+        start: number;
+        end: number;
+        compacted?: number;
+    };
+}
+interface ToolStateOther {
+    status: "pending" | "running" | "error";
+    input: Record<string, unknown>;
+    [key: string]: unknown;
+}
+type ToolState = ToolStateCompleted | ToolStateOther;
+interface ToolPart {
+    type: "tool";
+    tool: string;
+    callID: string;
+    state: ToolState;
+    [key: string]: unknown;
+}
+interface TextPart {
+    type: "text";
+    text: string;
+    [key: string]: unknown;
+}
+type AnyPart = ToolPart | TextPart | {
+    type: string;
+    [key: string]: unknown;
+};
+interface TransformMessage {
+    info: {
+        role: "user" | "assistant";
+        time: {
+            created: number;
+        };
+        [key: string]: unknown;
+    };
+    parts: AnyPart[];
+}
+export interface TrimStats {
+    /** Number of tool outputs trimmed */
+    partsTrimmed: number;
+    /** Estimated tokens saved from tool output trimming (excludes carly blocks) */
+    tokensSaved: number;
+    /** Number of carly-rules blocks stripped */
+    carlyBlocksStripped: number;
+    /** Estimated tokens saved from carly-rules block removal */
+    carlyTokensSaved: number;
+    /** Files read or edited in the last 5 turns */
+    activeFiles: string[];
+}
+/**
+ * Trim stale tool outputs and carly-rules blocks from message history.
+ *
+ * Algorithm:
+ * 1. Build TrimContext (catalog all file operations for cross-referencing)
+ * 2. For each message (except the last preserveLastN):
+ *    - Strip <carly-rules> from text parts
+ *    - For each completed tool part without a compacted timestamp:
+ *      - Calculate relevance score
+ *      - If score < threshold: replace output with compact summary
+ * 3. Return stats for logging
+ */
+export declare function trimMessageHistory(messages: TransformMessage[], config: TrimmingConfig): TrimStats;
+export {};
+//# sourceMappingURL=trimmer.d.ts.map

package/dist/engine/trimmer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trimmer.d.ts","sourceRoot":"","sources":["../../src/engine/trimmer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMxE;;;GAGG;AAEH,UAAU,kBAAkB;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,KAAK,SAAS,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAErD,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,KAAK,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE9E,UAAU,gBAAgB;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAC3B,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAyMD,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,MAAM,EAAE,cAAc,GACrB,SAAS,CAoEX"}

package/dist/engine/trimmer.js

@@ -0,0 +1,236 @@
+/**
+ * OpenCarly Smart Tool Output Trimmer
+ *
+ * Multi-factor scoring system that determines which tool outputs in
+ * conversation history are safe to trim. Replaces stale outputs with
+ * compact summaries to reduce token usage without degrading AI quality.
+ *
+ * Factors considered:
+ * - Age (turns since message)
+ * - Superseded file reads (same file read again more recently)
+ * - Post-read file edits (file was modified after being read)
+ * - Output size (larger = better trim candidate)
+ * - Tool type (ephemeral tools like bash/glob are safer to trim)
+ * - Tiny output protection (don't bother trimming small outputs)
+ */
+import { TRIM_THRESHOLDS } from "../config/schema";
+class TrimContext {
+    fileOps = new Map();
+    constructor(messages) {
+        for (let mi = 0; mi < messages.length; mi++) {
+            for (const part of messages[mi].parts) {
+                if (part.type !== "tool")
+                    continue;
+                const toolPart = part;
+                if (toolPart.state.status !== "completed" && toolPart.state.status !== "error")
+                    continue;
+                const filePath = toolPart.state.input.filePath;
+                if (!filePath)
+                    continue;
+                if (toolPart.tool === "read" || toolPart.tool === "edit" || toolPart.tool === "write") {
+                    const ops = this.fileOps.get(filePath);
+                    const entry = { messageIndex: mi, op: toolPart.tool };
+                    if (ops) {
+                        ops.push(entry);
+                    }
+                    else {
+                        this.fileOps.set(filePath, [entry]);
+                    }
+                }
+            }
+        }
+    }
+    /** Check if the same file was read in a later message */
+    hasNewerRead(filePath, messageIndex) {
+        const ops = this.fileOps.get(filePath);
+        if (!ops)
+            return false;
+        return ops.some((op) => op.op === "read" && op.messageIndex > messageIndex);
+    }
+    /** Check if the file was edited or written after this message */
+    wasEditedAfter(filePath, messageIndex) {
+        const ops = this.fileOps.get(filePath);
+        if (!ops)
+            return false;
+        return ops.some((op) => (op.op === "edit" || op.op === "write") &&
+            op.messageIndex > messageIndex);
+    }
+    /** Get unique file paths operated on in the last N messages */
+    getRecentFiles(totalMessages, lastN) {
+        const recentPaths = new Set();
+        const startIdx = Math.max(0, totalMessages - lastN);
+        for (const [filePath, ops] of this.fileOps.entries()) {
+            if (ops.some(op => op.messageIndex >= startIdx)) {
+                recentPaths.add(filePath);
+            }
+        }
+        return Array.from(recentPaths);
+    }
+}
+// ---------------------------------------------------------------------------
+// Scoring
+// ---------------------------------------------------------------------------
+/** Ephemeral tool types that are cheap to re-run */
+const EPHEMERAL_TOOLS = new Set(["bash", "glob", "grep"]);
+/** Minimum token estimate to bother trimming */
+const MIN_TRIM_TOKENS = 100;
+/**
+ * Rough token estimate from string length.
+ * ~4 chars per token is a reasonable approximation for code/text.
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Score a tool part for trimming relevance.
+ *
+ * Returns 0-100 where lower = more trimmable.
+ * Parts that should never be trimmed return 100+.
+ */
+function scoreToolPart(toolPart, messageIndex, totalMessages, context) {
+    const state = toolPart.state;
+    // Only trim completed tool outputs
+    if (state.status !== "completed")
+        return 200;
+    const completed = state;
+    // Already trimmed by us or by OpenCode's own compaction
+    if (completed.time.compacted)
+        return 200;
+    // Don't bother trimming tiny outputs
+    const tokenEstimate = estimateTokens(completed.output);
+    if (tokenEstimate < MIN_TRIM_TOKENS)
+        return 200;
+    let score = 100;
+    const turnsAgo = totalMessages - 1 - messageIndex;
+    // --- Factor 1: Age decay (6 points per turn) ---
+    score -= turnsAgo * 6;
+    // --- Factor 2: Superseded file reads ---
+    if (toolPart.tool === "read") {
+        const filePath = toolPart.state.input.filePath;
+        if (filePath && context.hasNewerRead(filePath, messageIndex)) {
+            score -= 60;
+        }
+    }
+    // --- Factor 3: File was edited after this read ---
+    if (toolPart.tool === "read") {
+        const filePath = toolPart.state.input.filePath;
+        if (filePath && context.wasEditedAfter(filePath, messageIndex)) {
+            score -= 50;
+        }
+    }
+    // --- Factor 4: Output size (larger = better trim candidate) ---
+    if (tokenEstimate > 2000) {
+        score -= 15;
+    }
+    else if (tokenEstimate > 500) {
+        score -= 8;
+    }
+    // --- Factor 5: Ephemeral tool types ---
+    if (EPHEMERAL_TOOLS.has(toolPart.tool)) {
+        score -= 10;
+    }
+    return Math.max(0, score);
+}
+// ---------------------------------------------------------------------------
+// Trim summary generation
+// ---------------------------------------------------------------------------
+/**
+ * Build a compact summary to replace trimmed tool output.
+ */
+function buildTrimSummary(toolPart, tokensSaved) {
+    const completed = toolPart.state;
+    const title = completed.title || toolPart.tool;
+    if (toolPart.tool === "read") {
+        const filePath = toolPart.state.input.filePath || "unknown file";
+        const lineCount = completed.output.split("\n").length;
+        return (`[Trimmed by OpenCarly] Read ${filePath} (${lineCount} lines, ~${tokensSaved} tokens saved)\n` +
+            `Re-read this file if its contents are needed.`);
+    }
+    if (toolPart.tool === "bash") {
+        const command = toolPart.state.input.command || "unknown command";
+        // Show first 80 chars of command
+        const shortCmd = command.length > 80 ? command.slice(0, 77) + "..." : command;
+        return (`[Trimmed by OpenCarly] Ran: ${shortCmd} (~${tokensSaved} tokens saved)\n` +
+            `Re-run this command if output is needed.`);
+    }
+    if (toolPart.tool === "glob" || toolPart.tool === "grep") {
+        const pattern = toolPart.state.input.pattern || "";
+        return (`[Trimmed by OpenCarly] ${toolPart.tool}: ${pattern} (~${tokensSaved} tokens saved)\n` +
+            `Re-run this search if results are needed.`);
+    }
+    // Generic fallback
+    return (`[Trimmed by OpenCarly] ${title} (~${tokensSaved} tokens saved)\n` +
+        `Tool output trimmed from history.`);
+}
+/**
+ * Trim stale tool outputs and carly-rules blocks from message history.
+ *
+ * Algorithm:
+ * 1. Build TrimContext (catalog all file operations for cross-referencing)
+ * 2. For each message (except the last preserveLastN):
+ *    - Strip <carly-rules> from text parts
+ *    - For each completed tool part without a compacted timestamp:
+ *      - Calculate relevance score
+ *      - If score < threshold: replace output with compact summary
+ * 3. Return stats for logging
+ */
+export function trimMessageHistory(messages, config) {
+    // Step 1: Build context for cross-referencing file operations
+    const context = new TrimContext(messages);
+    const totalMessages = messages.length;
+    const stats = {
+        partsTrimmed: 0,
+        tokensSaved: 0,
+        carlyBlocksStripped: 0,
+        carlyTokensSaved: 0,
+        activeFiles: context.getRecentFiles(totalMessages, 5),
+    };
+    if (!config.enabled)
+        return stats;
+    const threshold = TRIM_THRESHOLDS[config.mode] ?? 40;
+    const protectedStart = Math.max(0, totalMessages - config.preserveLastN);
+    // Step 2: Process each message
+    for (let mi = 0; mi < totalMessages; mi++) {
+        const message = messages[mi];
+        for (let pi = 0; pi < message.parts.length; pi++) {
+            const part = message.parts[pi];
+            // --- Strip <carly-rules> from text parts (all messages) ---
+            if (part.type === "text") {
+                const textPart = part;
+                if (typeof textPart.text === "string" && textPart.text.includes("<carly-rules>")) {
+                    const tokensBefore = estimateTokens(textPart.text);
+                    const textBefore = textPart.text;
+                    textPart.text = textPart.text
+                        .replace(/<carly-rules>[\s\S]*?<\/carly-rules>/g, "")
+                        .trim();
+                    if (textPart.text !== textBefore) {
+                        const tokensAfter = estimateTokens(textPart.text);
+                        stats.carlyBlocksStripped++;
+                        stats.carlyTokensSaved += Math.max(0, tokensBefore - tokensAfter);
+                    }
+                }
+                continue;
+            }
+            // --- Tool output trimming (skip protected messages) ---
+            if (mi >= protectedStart)
+                continue;
+            if (part.type !== "tool")
+                continue;
+            const toolPart = part;
+            const score = scoreToolPart(toolPart, mi, totalMessages, context);
+            if (score < threshold) {
+                const completed = toolPart.state;
+                const tokensBefore = estimateTokens(completed.output);
+                const summary = buildTrimSummary(toolPart, tokensBefore);
+                const tokensAfter = estimateTokens(summary);
+                // Replace output with summary
+                completed.output = summary;
+                completed.time.compacted = Date.now();
+                stats.partsTrimmed++;
+                stats.tokensSaved += Math.max(0, tokensBefore - tokensAfter);
+            }
+        }
+    }
+    return stats;
+}
+//# sourceMappingURL=trimmer.js.map

package/dist/engine/trimmer.js.map

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

package/dist/formatter/formatter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * OpenCarly Rule Formatter
+ *
+ * Formats loaded rules into a text block for injection into the system prompt.
+ * Output is wrapped in <carly-rules> XML tags.
+ */
+import type { LoadedRules } from "../engine/loader";
+/**
+ * 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 declare function formatRules(loaded: LoadedRules): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/formatter/formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAkBpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA8HvD"}