contextos-mcp 0.4.0

package/dist/agents/provider.js

@@ -0,0 +1,31 @@
+/**
+ * Agent provider interface and registry.
+ *
+ * Each agent backend (OpenCode, Claude Code, etc.) implements AgentProvider.
+ * The registry maps backend names to providers.
+ */
+const registry = new Map();
+export function registerAgent(provider) {
+    registry.set(provider.name, provider);
+}
+export function getAgent(name) {
+    const provider = registry.get(name);
+    if (!provider) {
+        const available = [...registry.keys()].join(", ");
+        throw new Error(`Unknown agent backend "${name}". Available: ${available || "none"}`);
+    }
+    return provider;
+}
+export function listAgents() {
+    return [...registry.keys()];
+}
+export async function getAvailableAgents() {
+    const results = [];
+    for (const [name, provider] of registry) {
+        if (await provider.isAvailable()) {
+            results.push(name);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=provider.js.map

package/dist/agents/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/agents/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAElD,MAAM,UAAU,aAAa,CAAC,QAAuB;IACpD,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,iBAAiB,SAAS,IAAI,MAAM,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU;IACzB,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACvC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzC,IAAI,MAAM,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACF,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/dist/compression/compressor.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Context compression — compresses thread output before returning to the orchestrator.
+ *
+ * Strategies:
+ *   - structured (default): status + files + diff stats + key hunks + tail output
+ *   - diff-only: just the git diff
+ *   - truncate: raw truncation
+ *   - llm-summary: use a cheap LLM to summarize thread work
+ *
+ * Episode quality: All strategies apply filterToSuccessfulOutput() first,
+ * stripping failed attempts, retries, and error noise so the orchestrator
+ * only sees what contributed to the final result (Slate-style episodes).
+ */
+import type { SwarmConfig } from "../core/types.js";
+export interface CompressionInput {
+    agentOutput: string;
+    diff: string;
+    diffStats: string;
+    filesChanged: string[];
+    success: boolean;
+    durationMs: number;
+    error?: string;
+}
+/** Optional LLM summarizer for llm-summary strategy. */
+export type LlmSummarizer = (text: string, instruction: string) => Promise<string>;
+/** Register an LLM summarizer for the llm-summary compression strategy. */
+export declare function setSummarizer(fn: LlmSummarizer): void;
+export declare function compressResult(input: CompressionInput, strategy?: SwarmConfig["compression_strategy"], maxChars?: number): Promise<string>;

package/dist/compression/compressor.js

@@ -0,0 +1,268 @@
+/**
+ * Context compression — compresses thread output before returning to the orchestrator.
+ *
+ * Strategies:
+ *   - structured (default): status + files + diff stats + key hunks + tail output
+ *   - diff-only: just the git diff
+ *   - truncate: raw truncation
+ *   - llm-summary: use a cheap LLM to summarize thread work
+ *
+ * Episode quality: All strategies apply filterToSuccessfulOutput() first,
+ * stripping failed attempts, retries, and error noise so the orchestrator
+ * only sees what contributed to the final result (Slate-style episodes).
+ */
+import { redactSecrets } from "../security/secret-filter.js";
+// Module-level summarizer — set once by the swarm orchestrator
+let _summarizer;
+/** Register an LLM summarizer for the llm-summary compression strategy. */
+export function setSummarizer(fn) {
+    _summarizer = fn;
+}
+// ── Episode quality filter ────────────────────────────────────────────────
+/**
+ * Patterns that indicate failed attempts, retries, or noise in agent output.
+ * These lines are stripped so the orchestrator only sees successful conclusions.
+ */
+const FAILURE_NOISE_PATTERNS = [
+    // Error/retry indicators (anchored to avoid matching "Error handling added")
+    /^error: /i,
+    /^Error: /,
+    /^failed to /i,
+    /^retrying/i,
+    /^retry attempt/i,
+    /^warning: /i,
+    /^timed? ?out/i,
+    // Common agent noise: stack traces
+    /^\s+at\s+\S+\s+\(/,
+    /^Traceback \(most recent/,
+    /^\s+File ".*", line \d+/,
+    // Agent internal chatter
+    /^Thinking\.\.\./i,
+    /^Searching\.\.\./i,
+    /^Reading\.\.\./i,
+    /^Running command\.\.\./i,
+    // Reverted / undone actions (anchored to start of line)
+    /^reverted /i,
+    /^undoing /i,
+    /^rolling back/i,
+];
+/** Patterns that indicate successful, conclusive output worth keeping. */
+const SUCCESS_SIGNAL_PATTERNS = [
+    /^Applied edit to/i,
+    /^Wrote /,
+    /^Created /i,
+    /^Updated /i,
+    /^Added /i,
+    /^Removed /i,
+    /^Fixed /i,
+    /^Committing /,
+    /tests? pass/i,
+    /✓|✔|PASS/,
+    /^DONE/i,
+    /^SUCCESS/i,
+    /^Result:/i,
+    /^Summary:/i,
+    /^Completed/i,
+];
+/**
+ * Filter agent output to only include lines that contributed to the final result.
+ * Strips failed attempts, retries, stack traces, and noise.
+ * Keeps: success signals, file-change confirmations, final conclusions, and
+ * any line that doesn't match a known noise pattern.
+ *
+ * Strategy: remove known-bad lines rather than keep only known-good,
+ * so novel agent output is preserved by default.
+ */
+function filterToSuccessfulOutput(agentOutput) {
+    if (!agentOutput)
+        return agentOutput;
+    const lines = agentOutput.split("\n");
+    const filtered = [];
+    let inStackTrace = false;
+    for (const line of lines) {
+        const trimmed = line.trimStart();
+        // Detect start of stack trace blocks (test untrimmed `line` for JS stack traces with leading whitespace)
+        if (/^Traceback \(most recent/.test(trimmed) || /^\s+at\s+\S+\s+\(/.test(line)) {
+            inStackTrace = true;
+            continue;
+        }
+        // End stack trace on blank line or non-indented line
+        if (inStackTrace) {
+            if (trimmed === "" || (!trimmed.startsWith(" ") && !trimmed.startsWith("\t"))) {
+                inStackTrace = false;
+                // Still check if this line itself is noise
+            }
+            else {
+                continue; // Skip stack trace continuation
+            }
+        }
+        // Always keep lines with success signals
+        if (SUCCESS_SIGNAL_PATTERNS.some((p) => p.test(trimmed))) {
+            filtered.push(line);
+            continue;
+        }
+        // Skip lines matching failure/noise patterns
+        if (FAILURE_NOISE_PATTERNS.some((p) => p.test(trimmed))) {
+            continue;
+        }
+        // Keep everything else (default: preserve novel output)
+        filtered.push(line);
+    }
+    // Collapse runs of blank lines to max 2
+    const collapsed = [];
+    let blankRun = 0;
+    for (const line of filtered) {
+        if (line.trim() === "") {
+            blankRun++;
+            if (blankRun <= 2)
+                collapsed.push(line);
+        }
+        else {
+            blankRun = 0;
+            collapsed.push(line);
+        }
+    }
+    return collapsed.join("\n").trim();
+}
+export async function compressResult(input, strategy = "structured", maxChars = 1000) {
+    // Episode quality: filter agent output to successful conclusions only
+    // Security: redact secrets from diff and agent output before any compression
+    const filtered = {
+        ...input,
+        agentOutput: filterToSuccessfulOutput(input.agentOutput),
+        diff: redactSecrets(input.diff),
+    };
+    switch (strategy) {
+        case "structured":
+            return compressStructured(filtered, maxChars);
+        case "diff-only":
+            return compressDiffOnly(filtered, maxChars);
+        case "truncate":
+            return compressTruncate(filtered, maxChars);
+        case "llm-summary":
+            return compressLlmSummary(filtered, maxChars);
+        default:
+            return compressStructured(filtered, maxChars);
+    }
+}
+function compressStructured(input, maxChars) {
+    const parts = [];
+    // Status line
+    parts.push(`Status: ${input.success ? "SUCCESS" : "FAILED"} (${(input.durationMs / 1000).toFixed(1)}s)`);
+    if (input.error) {
+        parts.push(`Error: ${input.error}`);
+    }
+    // Files changed
+    if (input.filesChanged.length > 0) {
+        parts.push(`Files changed (${input.filesChanged.length}):`);
+        for (const f of input.filesChanged.slice(0, 20)) {
+            parts.push(`  - ${f}`);
+        }
+        if (input.filesChanged.length > 20) {
+            parts.push(`  ... and ${input.filesChanged.length - 20} more`);
+        }
+    }
+    // Diff stats
+    if (input.diffStats && input.diffStats !== "(no changes)") {
+        parts.push(`\nDiff stats:\n${input.diffStats}`);
+    }
+    // Key diff hunks (first portion)
+    if (input.diff && input.diff !== "(no changes)") {
+        const diffBudget = Math.floor(maxChars * 0.4);
+        const truncatedDiff = input.diff.length > diffBudget ? `${input.diff.slice(0, diffBudget)}\n... [diff truncated]` : input.diff;
+        parts.push(`\nKey changes:\n${truncatedDiff}`);
+    }
+    // Agent output tail
+    if (input.agentOutput) {
+        const outputBudget = Math.floor(maxChars * 0.3);
+        const lines = input.agentOutput.split("\n");
+        const tail = lines.slice(-30).join("\n");
+        const truncatedOutput = tail.length > outputBudget ? tail.slice(-outputBudget) : tail;
+        parts.push(`\nAgent output (last 30 lines):\n${truncatedOutput}`);
+    }
+    const result = parts.join("\n");
+    // Final truncation safety (4x maxChars is the hard cap for combined sections)
+    if (result.length > maxChars * 4) {
+        return `${result.slice(0, maxChars * 4)}\n... [compressed output truncated]`;
+    }
+    return result;
+}
+function compressDiffOnly(input, maxChars) {
+    const status = `Status: ${input.success ? "SUCCESS" : "FAILED"} (${(input.durationMs / 1000).toFixed(1)}s)`;
+    if (!input.diff || input.diff === "(no changes)") {
+        return `${status}\n(no changes)`;
+    }
+    if (input.diff.length > maxChars * 4) {
+        return `${status}\n${input.diff.slice(0, maxChars * 4)}\n... [diff truncated]`;
+    }
+    return `${status}\n${input.diff}`;
+}
+function compressTruncate(input, maxChars) {
+    const raw = [`Status: ${input.success ? "SUCCESS" : "FAILED"}`, input.agentOutput, input.diff]
+        .filter(Boolean)
+        .join("\n\n");
+    if (raw.length > maxChars * 4) {
+        // Preserve status line at the head, truncate from the middle
+        const statusEnd = raw.indexOf("\n");
+        const statusLine = statusEnd !== -1 ? raw.slice(0, statusEnd) : "";
+        const remaining = maxChars * 4 - statusLine.length - 20;
+        return `${statusLine}\n... [truncated]\n${raw.slice(-remaining)}`;
+    }
+    return raw;
+}
+/**
+ * LLM-based compression — uses a cheap model to summarize the thread's work.
+ * Falls back to structured compression if no summarizer is registered.
+ */
+async function compressLlmSummary(input, maxChars) {
+    if (!_summarizer) {
+        // Fall back to structured if no summarizer available
+        return compressStructured(input, maxChars);
+    }
+    // Build the text to summarize
+    const parts = [];
+    parts.push(`Task outcome: ${input.success ? "SUCCESS" : "FAILED"} (${(input.durationMs / 1000).toFixed(1)}s)`);
+    if (input.error) {
+        parts.push(`Error: ${input.error}`);
+    }
+    if (input.filesChanged.length > 0) {
+        parts.push(`Files changed: ${input.filesChanged.join(", ")}`);
+    }
+    if (input.diffStats && input.diffStats !== "(no changes)") {
+        parts.push(`Diff stats:\n${input.diffStats}`);
+    }
+    // Include truncated diff for context
+    if (input.diff && input.diff !== "(no changes)") {
+        const diffSlice = input.diff.slice(0, maxChars * 2);
+        parts.push(`Diff:\n${diffSlice}`);
+    }
+    // Include truncated agent output
+    if (input.agentOutput) {
+        const outputSlice = input.agentOutput.slice(-maxChars);
+        parts.push(`Agent output (tail):\n${outputSlice}`);
+    }
+    const textToSummarize = parts.join("\n\n");
+    const instruction = [
+        "Summarize this coding agent thread result concisely.",
+        "Include: what was done, which files were changed, whether it succeeded, and any key details.",
+        `Keep the summary under ${maxChars} characters.`,
+        "Be specific about code changes — mention function names, patterns, and key decisions.",
+    ].join(" ");
+    try {
+        const summary = await _summarizer(textToSummarize, instruction);
+        // Prepend status line
+        const status = `Status: ${input.success ? "SUCCESS" : "FAILED"} (${(input.durationMs / 1000).toFixed(1)}s)`;
+        const filesLine = input.filesChanged.length > 0 ? `\nFiles: ${input.filesChanged.join(", ")}` : "";
+        const result = `${status}${filesLine}\n\n${summary}`;
+        // Safety cap
+        if (result.length > maxChars * 2) {
+            return `${result.slice(0, maxChars * 2)}\n... [summary truncated]`;
+        }
+        return result;
+    }
+    catch {
+        // Fall back to structured on LLM failure
+        return compressStructured(input, maxChars);
+    }
+}
+//# sourceMappingURL=compressor.js.map

package/dist/compression/compressor.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Configuration loader for swarm-code.
+ *
+ * Reads swarm_config.yaml (or rlm_config.yaml fallback) from project root or cwd.
+ * Extends RLM config with swarm-specific fields.
+ */
+/** Named model slot overrides — lets users assign specific models per task type. */
+export interface ModelSlots {
+    execution: string;
+    search: string;
+    reasoning: string;
+    planning: string;
+}
+export interface SwarmConfig {
+    max_iterations: number;
+    max_depth: number;
+    max_sub_queries: number;
+    truncate_len: number;
+    metadata_preview_lines: number;
+    max_threads: number;
+    max_total_threads: number;
+    thread_timeout_ms: number;
+    max_thread_budget_usd: number;
+    max_session_budget_usd: number;
+    default_agent: string;
+    default_model: string;
+    auto_model_selection: boolean;
+    compression_strategy: "structured" | "llm-summary" | "diff-only" | "truncate";
+    compression_max_tokens: number;
+    worktree_base_dir: string;
+    auto_cleanup_worktrees: boolean;
+    episodic_memory_enabled: boolean;
+    memory_dir: string;
+    thread_retries: number;
+    model_slots: ModelSlots;
+    thread_cache_persist: boolean;
+    thread_cache_dir: string;
+    thread_cache_ttl_hours: number;
+    opencode_server_mode: boolean;
+    allow_hooks: boolean;
+}
+export type RlmConfig = SwarmConfig;
+export declare function loadConfig(cwd?: string): SwarmConfig;

package/dist/config.js

@@ -0,0 +1,172 @@
+/**
+ * Configuration loader for swarm-code.
+ *
+ * Reads swarm_config.yaml (or rlm_config.yaml fallback) from project root or cwd.
+ * Extends RLM config with swarm-specific fields.
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+const DEFAULTS = {
+    // RLM defaults
+    max_iterations: 20,
+    max_depth: 3,
+    max_sub_queries: 50,
+    truncate_len: 5000,
+    metadata_preview_lines: 20,
+    // Swarm defaults
+    max_threads: 5,
+    max_total_threads: 20,
+    thread_timeout_ms: 300000,
+    max_thread_budget_usd: 1.0,
+    max_session_budget_usd: 10.0,
+    default_agent: "opencode",
+    default_model: "anthropic/claude-sonnet-4-6",
+    auto_model_selection: true,
+    compression_strategy: "structured",
+    compression_max_tokens: 1000,
+    worktree_base_dir: ".swarm-worktrees",
+    auto_cleanup_worktrees: true,
+    episodic_memory_enabled: false,
+    memory_dir: path.join(os.homedir(), ".swarm", "memory"),
+    thread_retries: 1,
+    model_slots: {
+        execution: "", // empty = use agent's default based on complexity
+        search: "",
+        reasoning: "",
+        planning: "",
+    },
+    thread_cache_persist: false,
+    thread_cache_dir: path.join(os.homedir(), ".swarm", "cache"),
+    thread_cache_ttl_hours: 24,
+    opencode_server_mode: true,
+    allow_hooks: false,
+};
+function parseYaml(text) {
+    // Minimal YAML parser for flat key:value files (no nested objects, no arrays)
+    const result = {};
+    for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const colonIdx = trimmed.indexOf(":");
+        if (colonIdx === -1)
+            continue;
+        const key = trimmed.slice(0, colonIdx).trim();
+        const rawVal = trimmed.slice(colonIdx + 1).trim();
+        // Strip inline comments (but not inside quoted strings)
+        let val;
+        if ((rawVal.startsWith('"') && rawVal.includes('"', 1)) || (rawVal.startsWith("'") && rawVal.includes("'", 1))) {
+            // Quoted value — don't strip inline comments
+            val = rawVal;
+        }
+        else {
+            val = rawVal.replace(/\s+#.*$/, "");
+        }
+        // Parse number
+        const num = Number(val);
+        if (!Number.isNaN(num) && val !== "") {
+            result[key] = num;
+        }
+        else if (val === "true") {
+            result[key] = true;
+        }
+        else if (val === "false") {
+            result[key] = false;
+        }
+        else {
+            // Strip quotes
+            result[key] = val.replace(/^["']|["']$/g, "");
+        }
+    }
+    return result;
+}
+export function loadConfig(cwd) {
+    // Search order: cwd swarm_config, cwd rlm_config, package root swarm_config, package root rlm_config
+    // User prefs (~/.swarm/config.yaml) are overlaid on top of the first found project config
+    const projectDir = cwd || process.cwd();
+    const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+    const userConfigPath = path.join(os.homedir(), ".swarm", "config.yaml");
+    const candidates = [
+        path.resolve(projectDir, "swarm_config.yaml"),
+        path.resolve(projectDir, "rlm_config.yaml"),
+        path.resolve(pkgRoot, "swarm_config.yaml"),
+        path.resolve(pkgRoot, "rlm_config.yaml"),
+    ];
+    for (const configPath of candidates) {
+        if (fs.existsSync(configPath)) {
+            try {
+                const raw = fs.readFileSync(configPath, "utf-8");
+                let parsed = parseYaml(raw);
+                // Overlay user preferences from ~/.swarm/config.yaml
+                if (fs.existsSync(userConfigPath)) {
+                    try {
+                        const userRaw = fs.readFileSync(userConfigPath, "utf-8");
+                        const userParsed = parseYaml(userRaw);
+                        parsed = { ...parsed, ...userParsed };
+                    }
+                    catch {
+                        /* ignore malformed user config */
+                    }
+                }
+                const clamp = (v, min, max, def) => typeof v === "number" && Number.isFinite(v) ? Math.max(min, Math.min(max, Math.round(v))) : def;
+                const str = (v, def) => (typeof v === "string" && v.length > 0 ? v : def);
+                const bool = (v, def) => (typeof v === "boolean" ? v : def);
+                const validStrategies = ["structured", "llm-summary", "diff-only", "truncate"];
+                const strategyVal = str(parsed.compression_strategy, DEFAULTS.compression_strategy);
+                const strategy = validStrategies.includes(strategyVal)
+                    ? strategyVal
+                    : DEFAULTS.compression_strategy;
+                return {
+                    // RLM fields
+                    max_iterations: clamp(parsed.max_iterations, 1, 100, DEFAULTS.max_iterations),
+                    max_depth: clamp(parsed.max_depth, 1, 10, DEFAULTS.max_depth),
+                    max_sub_queries: clamp(parsed.max_sub_queries, 1, 500, DEFAULTS.max_sub_queries),
+                    truncate_len: clamp(parsed.truncate_len, 500, 50000, DEFAULTS.truncate_len),
+                    metadata_preview_lines: clamp(parsed.metadata_preview_lines, 5, 100, DEFAULTS.metadata_preview_lines),
+                    // Swarm fields
+                    max_threads: clamp(parsed.max_threads, 1, 20, DEFAULTS.max_threads),
+                    max_total_threads: clamp(parsed.max_total_threads, 1, 100, DEFAULTS.max_total_threads),
+                    thread_timeout_ms: clamp(parsed.thread_timeout_ms, 10000, 3600000, DEFAULTS.thread_timeout_ms),
+                    max_thread_budget_usd: typeof parsed.max_thread_budget_usd === "number" &&
+                        Number.isFinite(parsed.max_thread_budget_usd) &&
+                        parsed.max_thread_budget_usd > 0
+                        ? parsed.max_thread_budget_usd
+                        : DEFAULTS.max_thread_budget_usd,
+                    max_session_budget_usd: typeof parsed.max_session_budget_usd === "number" &&
+                        Number.isFinite(parsed.max_session_budget_usd) &&
+                        parsed.max_session_budget_usd > 0
+                        ? parsed.max_session_budget_usd
+                        : DEFAULTS.max_session_budget_usd,
+                    default_agent: str(parsed.default_agent, DEFAULTS.default_agent),
+                    default_model: str(parsed.default_model, DEFAULTS.default_model),
+                    auto_model_selection: bool(parsed.auto_model_selection, DEFAULTS.auto_model_selection),
+                    compression_strategy: strategy,
+                    compression_max_tokens: clamp(parsed.compression_max_tokens, 100, 10000, DEFAULTS.compression_max_tokens),
+                    worktree_base_dir: str(parsed.worktree_base_dir, DEFAULTS.worktree_base_dir),
+                    auto_cleanup_worktrees: bool(parsed.auto_cleanup_worktrees, DEFAULTS.auto_cleanup_worktrees),
+                    episodic_memory_enabled: bool(parsed.episodic_memory_enabled, DEFAULTS.episodic_memory_enabled),
+                    memory_dir: str(parsed.memory_dir, DEFAULTS.memory_dir),
+                    thread_retries: clamp(parsed.thread_retries, 0, 3, DEFAULTS.thread_retries),
+                    model_slots: {
+                        execution: str(parsed.model_slot_execution, DEFAULTS.model_slots.execution),
+                        search: str(parsed.model_slot_search, DEFAULTS.model_slots.search),
+                        reasoning: str(parsed.model_slot_reasoning, DEFAULTS.model_slots.reasoning),
+                        planning: str(parsed.model_slot_planning, DEFAULTS.model_slots.planning),
+                    },
+                    thread_cache_persist: bool(parsed.thread_cache_persist, DEFAULTS.thread_cache_persist),
+                    thread_cache_dir: str(parsed.thread_cache_dir, DEFAULTS.thread_cache_dir),
+                    thread_cache_ttl_hours: clamp(parsed.thread_cache_ttl_hours, 1, 720, DEFAULTS.thread_cache_ttl_hours),
+                    opencode_server_mode: bool(parsed.opencode_server_mode, DEFAULTS.opencode_server_mode),
+                    allow_hooks: bool(parsed.allow_hooks, DEFAULTS.allow_hooks),
+                };
+            }
+            catch {
+                // Fall through to defaults
+            }
+        }
+    }
+    return { ...DEFAULTS };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/contextos/loader.d.ts

@@ -0,0 +1,46 @@
+import { type SelectorOptions } from "./selector.js";
+/** Soft compatibility budget; selected bodies are never sliced. */
+export declare const MAX_TOTAL_SKILLS_CHARS = 14000;
+export declare function findAgentsDir(projectRoot: string): string | null;
+export interface BuildPromptOptions extends SelectorOptions {
+    /** Soft limit for selected skill bodies; overflow is reported, never truncated. */
+    maxTotalSkillsChars?: number;
+    /** Hard limit for the entire assembled prompt. Overflow throws with a report. */
+    hardLimitChars?: number;
+}
+export interface ContextSource {
+    kind: "bootstrap" | "rule" | "skill";
+    id: string;
+    path: string;
+    sha256: string;
+    bytes: number;
+    chars: number;
+}
+export interface ContextAssemblyReport {
+    sources: ContextSource[];
+    warnings: Array<{
+        code: string;
+        message: string;
+    }>;
+    omissions: Array<{
+        id: string;
+        reasonCode: string;
+    }>;
+    totalChars: number;
+    skillChars: number;
+    /** Character estimate, not provider token telemetry. */
+    estimatedTokens: number;
+    softSkillLimitChars: number;
+    hardLimitChars?: number;
+}
+export declare class ContextAssemblyError extends Error {
+    readonly code: string;
+    readonly report: ContextAssemblyReport;
+    constructor(code: string, message: string, report: ContextAssemblyReport);
+}
+export declare function assembleContextPrompt(projectRoot: string, task: string, options?: BuildPromptOptions): {
+    prompt: string;
+    report: ContextAssemblyReport;
+};
+/** Compatibility wrapper for existing agent call sites. */
+export declare function buildContextPrompt(projectRoot: string, task: string, options?: BuildPromptOptions): string;