@ebowwa/coder 0.2.1 → 0.7.64

package/dist/core/config-loader.js

@@ -0,0 +1,219 @@
+/**
+ * Config Loader - Load Coder configuration files
+ *
+ * Loads from:
+ * 1. ~/.claude.json (MCP servers, project settings)
+ * 2. ~/.claude/settings.json (hooks, permissions)
+ * 3. ~/.claude/keybindings.json (keybindings)
+ * 4. .claude/settings.json (project-level overrides)
+ */
+import { readFile, access } from "fs/promises";
+import { join } from "path";
+// ============================================
+// PATHS
+// ============================================
+const HOME = process.env.HOME || "";
+const CLAUDE_DIR = join(HOME, ".claude");
+export const CONFIG_PATHS = {
+    main: join(HOME, ".claude.json"),
+    settings: join(CLAUDE_DIR, "settings.json"),
+    keybindings: join(CLAUDE_DIR, "keybindings.json"),
+    projectSettings: (projectDir) => join(projectDir, ".claude", "settings.json"),
+};
+// ============================================
+// HELPERS
+// ============================================
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function loadJsonFile(path, defaultValue) {
+    try {
+        if (await fileExists(path)) {
+            const content = await readFile(path, "utf-8");
+            return { config: JSON.parse(content), loaded: true };
+        }
+    }
+    catch (error) {
+        // File not readable or invalid JSON
+    }
+    return { config: defaultValue, loaded: false };
+}
+// ============================================
+// LOADERS
+// ============================================
+/**
+ * Load main ~/.claude.json config
+ */
+export async function loadMainConfig() {
+    return loadJsonFile(CONFIG_PATHS.main, {});
+}
+/**
+ * Load settings from ~/.claude/settings.json
+ */
+export async function loadSettings() {
+    return loadJsonFile(CONFIG_PATHS.settings, {});
+}
+/**
+ * Load keybindings from ~/.claude/keybindings.json
+ */
+export async function loadKeybindings() {
+    return loadJsonFile(CONFIG_PATHS.keybindings, { bindings: [] });
+}
+/**
+ * Load project-level settings
+ */
+export async function loadProjectSettings(projectDir) {
+    return loadJsonFile(CONFIG_PATHS.projectSettings(projectDir), {});
+}
+/**
+ * Get project-specific config from main config
+ */
+export function getProjectConfig(mainConfig, projectDir) {
+    return mainConfig.projects?.[projectDir];
+}
+/**
+ * Load all configs at once
+ */
+export async function loadAllConfigs(projectDir = process.cwd()) {
+    const sources = [];
+    const { config: main, loaded: mainLoaded } = await loadMainConfig();
+    if (mainLoaded)
+        sources.push(CONFIG_PATHS.main);
+    const { config: settings, loaded: settingsLoaded } = await loadSettings();
+    if (settingsLoaded)
+        sources.push(CONFIG_PATHS.settings);
+    const { config: keybindings, loaded: kbLoaded } = await loadKeybindings();
+    if (kbLoaded)
+        sources.push(CONFIG_PATHS.keybindings);
+    const { config: projectSettings, loaded: projLoaded } = await loadProjectSettings(projectDir);
+    if (projLoaded)
+        sources.push(CONFIG_PATHS.projectSettings(projectDir));
+    return {
+        main,
+        settings,
+        keybindings,
+        projectSettings,
+        sources,
+    };
+}
+// ============================================
+// MERGED CONFIG
+// ============================================
+/**
+ * Get merged settings (global + project overrides)
+ */
+export function getMergedSettings(global, project) {
+    return {
+        hooks: { ...global.hooks, ...project.hooks },
+        permissions: {
+            ...global.permissions,
+            ...project.permissions,
+        },
+    };
+}
+/**
+ * Get all MCP servers (global + project-specific)
+ */
+export function getAllMCPServers(mainConfig, projectDir) {
+    const servers = {};
+    // Global MCP servers
+    if (mainConfig.mcpServers) {
+        Object.assign(servers, mainConfig.mcpServers);
+    }
+    // Project-specific MCP servers
+    const projectConfig = getProjectConfig(mainConfig, projectDir);
+    if (projectConfig?.mcpServers) {
+        // Project servers can override global
+        Object.assign(servers, projectConfig.mcpServers);
+    }
+    return servers;
+}
+// Note: HookDefinition is imported at the top of the file
+/**
+ * Get hooks for a specific event and tool
+ */
+export function getHooksForEvent(settings, event, toolName) {
+    const eventHooks = settings.hooks?.[event];
+    if (!eventHooks)
+        return [];
+    // Find matching hooks
+    for (const hookConfig of eventHooks) {
+        if (!hookConfig.matcher) {
+            // No matcher = matches all
+            return hookConfig.hooks;
+        }
+        // Check if tool name matches
+        if (toolName) {
+            const regex = new RegExp(hookConfig.matcher);
+            if (regex.test(toolName)) {
+                return hookConfig.hooks;
+            }
+        }
+    }
+    return [];
+}
+/**
+ * Convert settings hooks to HookDefinitions for HookManager
+ */
+export function settingsToHookDefinitions(settings) {
+    const result = {};
+    if (!settings.hooks)
+        return result;
+    for (const [event, matcherConfigs] of Object.entries(settings.hooks)) {
+        const definitions = [];
+        const hookEvent = event;
+        for (const matcherConfig of matcherConfigs) {
+            for (const hook of matcherConfig.hooks) {
+                // Handle prompt-type hooks - they will be evaluated by LLM
+                if (hook.type === "prompt") {
+                    definitions.push({
+                        event: hookEvent,
+                        command: "", // Not used for prompt hooks
+                        prompt: hook.prompt || "",
+                        timeout: hook.timeout || 30000,
+                        enabled: true,
+                        // Store matcher for runtime filtering
+                        _matcher: matcherConfig.matcher,
+                    });
+                    continue;
+                }
+                definitions.push({
+                    event: hookEvent,
+                    command: hook.type === "command" ? hook.command || "" : "",
+                    timeout: hook.timeout || 60000,
+                    enabled: true,
+                    // Store matcher for runtime filtering
+                    _matcher: matcherConfig.matcher,
+                });
+            }
+        }
+        if (definitions.length > 0) {
+            result[hookEvent] = definitions;
+        }
+    }
+    return result;
+}
+/**
+ * Get permission mode from settings
+ */
+export function getPermissionMode(settings) {
+    return settings.permissions?.defaultMode || "default";
+}
+/**
+ * Get allowed tools from settings
+ */
+export function getAllowedTools(settings) {
+    return new Set(settings.permissions?.allowedTools || []);
+}
+/**
+ * Get disallowed tools from settings
+ */
+export function getDisallowedTools(settings) {
+    return new Set(settings.permissions?.disallowedTools || []);
+}

package/dist/core/context-compaction.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Context Compaction - Reduces context size while preserving important information
+ *
+ * When the context window fills up, we need to compact messages to continue.
+ * This module provides token estimation, summarization, and compaction utilities.
+ */
+import type { Message } from "../types/index.js";
+/**
+ * Estimate the number of tokens in a text string.
+ * Uses a simple heuristic of ~4 characters per token.
+ * This is a rough estimate; actual tokenization varies by model.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Get total estimated tokens across all messages
+ */
+export declare function estimateMessagesTokens(messages: Message[]): number;
+/**
+ * Summarize a range of messages into a single text.
+ * This is a simple implementation that concatenates and truncates.
+ * Can be enhanced later with LLM-based summarization.
+ */
+export declare function summarizeMessages(messages: Message[]): Promise<string>;
+export interface LLMSummarizationOptions {
+    /** API key for the LLM */
+    apiKey?: string;
+    /** Model to use for summarization (default: haiku) */
+    model?: string;
+    /** Base URL for API (for non-Anthropic providers) */
+    baseUrl?: string;
+    /** Timeout in ms (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Summarize messages using an LLM for better context preservation.
+ * Falls back to simple truncation if LLM fails or no API key provided.
+ */
+export declare function summarizeWithLLM(messages: Message[], options?: LLMSummarizationOptions): Promise<string>;
+export interface CompactionOptions {
+    /** Number of initial messages to keep unchanged */
+    keepFirst?: number;
+    /** Number of recent messages to keep unchanged */
+    keepLast?: number;
+    /** Whether to preserve tool_use/tool_result pairs */
+    preserveToolPairs?: boolean;
+    /** Use LLM for summarization (default: true if API key available) */
+    useLLMSummarization?: boolean;
+    /** API key for LLM summarization (falls back to env) */
+    apiKey?: string;
+    /** Base URL for API (for non-Anthropic providers like Z.AI) */
+    baseUrl?: string;
+}
+export interface CompactionResult {
+    /** The compacted messages */
+    messages: Message[];
+    /** Number of messages removed */
+    messagesRemoved: number;
+    /** Estimated tokens before compaction */
+    tokensBefore: number;
+    /** Estimated tokens after compaction */
+    tokensAfter: number;
+    /** Whether compaction actually occurred */
+    didCompact: boolean;
+}
+/**
+ * Compact messages to fit within a token limit.
+ *
+ * Strategy:
+ * 1. Always keep the first N messages (original query)
+ * 2. Always keep the last M messages (recent context)
+ * 3. Summarize middle messages into a single "context summary" user message
+ * 4. Preserve tool_use/tool_result pairs when possible
+ */
+export declare function compactMessages(messages: Message[], maxTokens: number, options?: CompactionOptions): Promise<CompactionResult>;
+/**
+ * Check if compaction is needed proactively.
+ * Returns true if current token usage exceeds the threshold AND there are enough messages to compact.
+ */
+export declare function needsCompaction(messages: Message[], maxTokens: number, threshold?: number): boolean;
+/**
+ * Get compaction statistics for logging/metrics
+ */
+export declare function getCompactionStats(result: CompactionResult): {
+    reductionPercent: number;
+    tokensSaved: number;
+};
+//# sourceMappingURL=context-compaction.d.ts.map

package/dist/core/context-compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compaction.d.ts","sourceRoot":"","sources":["../../packages/src/core/context-compaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAA+C,MAAM,mBAAmB,CAAC;AAkE9F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AA8CD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAGlE;AAqED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmD5E;AAMD,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,CAAC,CAyGjB;AAMD,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAwG3B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAqC,GAC/C,OAAO,CAST;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB,CAYA"}