cmdr-agent 2.1.1 → 2.2.0

package/dist/src/memory/consolidation.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Memory Consolidation — the "auto-dream" system for cmdr.
+ *
+ * After a session ends, consolidation reviews the conversation to extract
+ * learnings and update MEMORY.md files. This follows a 4-stage pipeline:
+ *
+ *  1. Orient  — Identify what the session was about (project, topic, scope)
+ *  2. Gather  — Extract actionable learnings from the conversation
+ *  3. Consolidate — Merge new learnings with existing memory, dedup
+ *  4. Prune   — Remove stale or contradicted entries, enforce size budget
+ *
+ * Triggered automatically at session end or via /compact command.
+ */
+import type { LLMAdapter, LLMMessage } from '../core/types.js';
+import type { MemoryManager } from './memory-manager.js';
+interface ConsolidationResult {
+    learningsFound: number;
+    memoryUpdated: boolean;
+    scope: 'project' | 'user';
+}
+export declare class MemoryConsolidator {
+    private readonly memoryManager;
+    private readonly adapter;
+    private readonly model;
+    constructor(memoryManager: MemoryManager, adapter: LLMAdapter, model: string);
+    /**
+     * Run the full consolidation pipeline on a completed session's messages.
+     * Returns info about what was updated.
+     */
+    consolidate(messages: LLMMessage[], scope?: 'project' | 'user'): Promise<ConsolidationResult>;
+    /** Stage 2: Extract learnings from conversation messages. */
+    private gatherLearnings;
+    /** Stage 3 & 4: Merge new learnings with existing memory. */
+    private consolidateMemory;
+}
+export {};
+//# sourceMappingURL=consolidation.d.ts.map

package/dist/src/memory/consolidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation.d.ts","sourceRoot":"","sources":["../../../src/memory/consolidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAA6B,MAAM,kBAAkB,CAAA;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA+BxD,UAAU,mBAAmB;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,OAAO,CAAA;IACtB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;CAC1B;AAED,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFL,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,MAAM;IAGhC;;;OAGG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,GAAE,SAAS,GAAG,MAAkB,GACpC,OAAO,CAAC,mBAAmB,CAAC;IAgC/B,6DAA6D;YAC/C,eAAe;IAyC7B,6DAA6D;YAC/C,iBAAiB;CA+BhC"}

package/dist/src/memory/consolidation.js

@@ -0,0 +1,148 @@
+/**
+ * Memory Consolidation — the "auto-dream" system for cmdr.
+ *
+ * After a session ends, consolidation reviews the conversation to extract
+ * learnings and update MEMORY.md files. This follows a 4-stage pipeline:
+ *
+ *  1. Orient  — Identify what the session was about (project, topic, scope)
+ *  2. Gather  — Extract actionable learnings from the conversation
+ *  3. Consolidate — Merge new learnings with existing memory, dedup
+ *  4. Prune   — Remove stale or contradicted entries, enforce size budget
+ *
+ * Triggered automatically at session end or via /compact command.
+ */
+const GATHER_PROMPT = `You are a memory consolidation agent. Analyze this conversation and extract key learnings.
+
+Focus on:
+- Project conventions discovered (naming, structure, patterns)
+- User preferences observed (style, tools, workflow)
+- Technical decisions made and their rationale
+- Bugs found and solutions applied
+- Common patterns that should be remembered
+
+Output a bulleted list of concise, actionable learnings. Each item should be self-contained.
+Do NOT include conversation-specific details that won't be useful in future sessions.
+Do NOT include transient information (file paths of temporary files, specific error messages that were fixed).
+
+If there are no meaningful learnings to extract, output exactly: NO_LEARNINGS`;
+const CONSOLIDATE_PROMPT = `You are a memory manager. Given existing memory and new learnings, produce a consolidated MEMORY.md.
+
+Rules:
+- Merge duplicates: if a new learning matches an existing entry, keep the more specific/recent one
+- Remove contradictions: if a new learning contradicts an old one, keep the new one
+- Group by topic: use ## headers (preferences, conventions, patterns, decisions)
+- Keep each entry as a concise bullet point
+- Stay under {MAX_LINES} lines total
+- Preserve date annotations where useful
+
+Output the final consolidated markdown content. No preamble, just the content.`;
+const MAX_MEMORY_LINES = 150;
+export class MemoryConsolidator {
+    memoryManager;
+    adapter;
+    model;
+    constructor(memoryManager, adapter, model) {
+        this.memoryManager = memoryManager;
+        this.adapter = adapter;
+        this.model = model;
+    }
+    /**
+     * Run the full consolidation pipeline on a completed session's messages.
+     * Returns info about what was updated.
+     */
+    async consolidate(messages, scope = 'project') {
+        // Skip tiny sessions — not enough to learn from
+        if (messages.length < 4) {
+            return { learningsFound: 0, memoryUpdated: false, scope };
+        }
+        // Stage 1 & 2: Gather learnings from conversation
+        const learnings = await this.gatherLearnings(messages);
+        if (!learnings || learnings === 'NO_LEARNINGS') {
+            return { learningsFound: 0, memoryUpdated: false, scope };
+        }
+        const learningsList = learnings.split('\n').filter(l => l.trim().startsWith('-') || l.trim().startsWith('*'));
+        if (learningsList.length === 0) {
+            return { learningsFound: 0, memoryUpdated: false, scope };
+        }
+        // Stage 3 & 4: Consolidate with existing memory
+        const existingMemory = await this.memoryManager.read(scope);
+        const consolidated = await this.consolidateMemory(existingMemory, learnings);
+        if (consolidated && consolidated.trim()) {
+            await this.memoryManager.write(scope, consolidated);
+        }
+        return {
+            learningsFound: learningsList.length,
+            memoryUpdated: true,
+            scope,
+        };
+    }
+    /** Stage 2: Extract learnings from conversation messages. */
+    async gatherLearnings(messages) {
+        // Build a condensed transcript for the LLM
+        const transcript = messages
+            .filter(m => !m.isMeta && !m.isVisibleInTranscriptOnly)
+            .map(m => {
+            const texts = m.content
+                .filter((b) => b.type === 'text')
+                .map(b => b.text)
+                .join('');
+            return `[${m.role}]: ${texts.slice(0, 2000)}`;
+        })
+            .join('\n\n');
+        // Limit transcript size for the LLM call
+        const truncated = transcript.length > 12_000
+            ? transcript.slice(0, 6000) + '\n\n...(middle omitted)...\n\n' + transcript.slice(-6000)
+            : transcript;
+        const chatMessages = [
+            { role: 'user', content: [{ type: 'text', text: `Here is the conversation to analyze:\n\n${truncated}` }] },
+        ];
+        const options = {
+            model: this.model,
+            systemPrompt: GATHER_PROMPT,
+            maxTokens: 1024,
+            temperature: 0.3,
+        };
+        try {
+            const response = await this.adapter.chat(chatMessages, options);
+            const text = response.content
+                .filter((b) => b.type === 'text')
+                .map(b => b.text)
+                .join('');
+            return text.trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Stage 3 & 4: Merge new learnings with existing memory. */
+    async consolidateMemory(existing, newLearnings) {
+        const prompt = CONSOLIDATE_PROMPT.replace('{MAX_LINES}', String(MAX_MEMORY_LINES));
+        const chatMessages = [
+            {
+                role: 'user',
+                content: [{
+                        type: 'text',
+                        text: `## Existing Memory\n\n${existing || '(empty — first session)'}\n\n## New Learnings\n\n${newLearnings}`,
+                    }],
+            },
+        ];
+        const options = {
+            model: this.model,
+            systemPrompt: prompt,
+            maxTokens: 2048,
+            temperature: 0.2,
+        };
+        try {
+            const response = await this.adapter.chat(chatMessages, options);
+            const text = response.content
+                .filter((b) => b.type === 'text')
+                .map(b => b.text)
+                .join('');
+            return text.trim();
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=consolidation.js.map

package/dist/src/memory/consolidation.js.map

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

package/dist/src/memory/memory-manager.d.ts

@@ -0,0 +1,39 @@
+/**
+ * MemoryManager — persistent cross-session learning for cmdr.
+ *
+ * Manages MEMORY.md files at two scopes:
+ *   - Project: .cmdr/MEMORY.md (per-repo knowledge)
+ *   - User:    ~/.cmdr/MEMORY.md (global patterns, preferences)
+ *
+ * Memory is injected into the system prompt each session so the agent
+ * retains learned patterns, project conventions, and user preferences.
+ */
+export interface MemoryScope {
+    readonly scope: 'project' | 'user';
+    readonly path: string;
+    content: string;
+}
+export declare class MemoryManager {
+    private projectDir;
+    private caches;
+    constructor(projectDir: string);
+    /** Path to the project-level memory file. */
+    get projectMemoryPath(): string;
+    /** Path to the user-level memory file. */
+    get userMemoryPath(): string;
+    /** Read a memory file, returning empty string if not found. */
+    private readMemoryFile;
+    /** Write content to a memory file, creating directories as needed. */
+    private writeMemoryFile;
+    /** Load all memory scopes. */
+    loadAll(): Promise<MemoryScope[]>;
+    /** Get combined memory as a prompt-injectable string. */
+    getMemoryPrompt(): Promise<string>;
+    /** Read memory for a given scope. */
+    read(scope: 'project' | 'user'): Promise<string>;
+    /** Write (overwrite) memory for a given scope. */
+    write(scope: 'project' | 'user', content: string): Promise<void>;
+    /** Append to memory for a given scope (most common operation). */
+    append(scope: 'project' | 'user', entry: string): Promise<void>;
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/src/memory/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,MAAM,CAAiC;gBAEnC,UAAU,EAAE,MAAM;IAI9B,6CAA6C;IAC7C,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,0CAA0C;IAC1C,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,+DAA+D;YACjD,cAAc;IAU5B,sEAAsE;YACxD,eAAe;IAU7B,8BAA8B;IACxB,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAYvC,yDAAyD;IACnD,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAaxC,qCAAqC;IAC/B,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtD,kDAAkD;IAC5C,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtE,kEAAkE;IAC5D,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQtE"}

package/dist/src/memory/memory-manager.js

@@ -0,0 +1,96 @@
+/**
+ * MemoryManager — persistent cross-session learning for cmdr.
+ *
+ * Manages MEMORY.md files at two scopes:
+ *   - Project: .cmdr/MEMORY.md (per-repo knowledge)
+ *   - User:    ~/.cmdr/MEMORY.md (global patterns, preferences)
+ *
+ * Memory is injected into the system prompt each session so the agent
+ * retains learned patterns, project conventions, and user preferences.
+ */
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+const MAX_MEMORY_SIZE = 8192; // chars — prevent context bloat
+export class MemoryManager {
+    projectDir;
+    caches = new Map();
+    constructor(projectDir) {
+        this.projectDir = projectDir;
+    }
+    /** Path to the project-level memory file. */
+    get projectMemoryPath() {
+        return join(this.projectDir, '.cmdr', 'MEMORY.md');
+    }
+    /** Path to the user-level memory file. */
+    get userMemoryPath() {
+        return join(homedir(), '.cmdr', 'MEMORY.md');
+    }
+    /** Read a memory file, returning empty string if not found. */
+    async readMemoryFile(path) {
+        try {
+            const content = await readFile(path, 'utf-8');
+            this.caches.set(path, content);
+            return content;
+        }
+        catch {
+            return '';
+        }
+    }
+    /** Write content to a memory file, creating directories as needed. */
+    async writeMemoryFile(path, content) {
+        // Enforce size limit
+        const trimmed = content.length > MAX_MEMORY_SIZE
+            ? content.slice(0, MAX_MEMORY_SIZE) + '\n\n<!-- Memory truncated at 8KB limit -->\n'
+            : content;
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, trimmed, 'utf-8');
+        this.caches.set(path, trimmed);
+    }
+    /** Load all memory scopes. */
+    async loadAll() {
+        const [project, user] = await Promise.all([
+            this.readMemoryFile(this.projectMemoryPath),
+            this.readMemoryFile(this.userMemoryPath),
+        ]);
+        const scopes = [];
+        if (user)
+            scopes.push({ scope: 'user', path: this.userMemoryPath, content: user });
+        if (project)
+            scopes.push({ scope: 'project', path: this.projectMemoryPath, content: project });
+        return scopes;
+    }
+    /** Get combined memory as a prompt-injectable string. */
+    async getMemoryPrompt() {
+        const scopes = await this.loadAll();
+        if (scopes.length === 0)
+            return '';
+        const parts = [];
+        for (const scope of scopes) {
+            if (scope.content.trim()) {
+                parts.push(`<memory scope="${scope.scope}">\n${scope.content.trim()}\n</memory>`);
+            }
+        }
+        return parts.join('\n\n');
+    }
+    /** Read memory for a given scope. */
+    async read(scope) {
+        const path = scope === 'project' ? this.projectMemoryPath : this.userMemoryPath;
+        return this.readMemoryFile(path);
+    }
+    /** Write (overwrite) memory for a given scope. */
+    async write(scope, content) {
+        const path = scope === 'project' ? this.projectMemoryPath : this.userMemoryPath;
+        await this.writeMemoryFile(path, content);
+    }
+    /** Append to memory for a given scope (most common operation). */
+    async append(scope, entry) {
+        const existing = await this.read(scope);
+        const timestamp = new Date().toISOString().split('T')[0];
+        const newContent = existing
+            ? `${existing.trimEnd()}\n\n## ${timestamp}\n${entry.trim()}\n`
+            : `# CMDR Memory\n\n## ${timestamp}\n${entry.trim()}\n`;
+        await this.write(scope, newContent);
+    }
+}
+//# sourceMappingURL=memory-manager.js.map

package/dist/src/memory/memory-manager.js.map

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

package/dist/src/plugins/mcp-client.d.ts

@@ -1,8 +1,10 @@
 /**
  * MCP Client — connects to external Model Context Protocol servers for tool expansion.
  *
- * MCP servers expose tools over HTTP (SSE or REST).
- * This client registers remote tools as local tool definitions.
+ * Supports multiple transports:
+ *  - HTTP REST: GET /tools, POST /tools/{name}
+ *  - stdio: Spawn a child process, communicate via JSON-RPC over stdin/stdout
+ *  - SSE: Server-Sent Events for streaming tool discovery and execution
  */
 import type { McpServerConfig, ToolResult } from '../core/types.js';
 import type { ToolRegistry } from '../tools/registry.js';
@@ -13,18 +15,25 @@ interface McpTool {
 }
 export declare class McpClient {
     private connections;
-    /** Connect to an MCP server and discover its tools. */
+    /** Connect to an MCP server. Auto-detects transport from config. */
     connect(config: McpServerConfig): Promise<McpTool[]>;
+    private connectHttp;
+    private callToolHttp;
+    private connectStdio;
+    private callToolStdio;
+    private connectSse;
+    private callToolSse;
     /** Disconnect from an MCP server. */
     disconnect(name: string): boolean;
     /** List connected MCP servers. */
     listConnections(): Array<{
         name: string;
-        url: string;
+        url: string | undefined;
         tools: number;
         connected: boolean;
+        transport: string;
     }>;
-    /** Call a tool on an MCP server. */
+    /** Call a tool on an MCP server. Dispatches to the appropriate transport. */
     callTool(serverName: string, toolName: string, input: Record<string, unknown>): Promise<ToolResult>;
     /**
      * Register all tools from connected MCP servers into a ToolRegistry.

package/dist/src/plugins/mcp-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../../src/plugins/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,UAAU,EAAkB,MAAM,kBAAkB,CAAA;AACnG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGxD,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAQD,qBAAa,SAAS;IACpB,OAAO,CAAC,WAAW,CAAmC;IAEtD,uDAAuD;IACjD,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA8B1D,qCAAqC;IACrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,kCAAkC;IAClC,eAAe,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAS1F,oCAAoC;IAC9B,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC;IAmCtB;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;IAyB7C,0CAA0C;IAC1C,IAAI,cAAc,IAAI,OAAO,CAE5B;CACF"}
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../../src/plugins/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,UAAU,EAAkB,MAAM,kBAAkB,CAAA;AACnG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAKxD,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AA8BD,qBAAa,SAAS;IACpB,OAAO,CAAC,WAAW,CAAmC;IAEtD,oEAAoE;IAC9D,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;YAY5C,WAAW;YAgBX,YAAY;YAuBZ,YAAY;YAmEZ,aAAa;YAuCb,UAAU;YAkCV,WAAW;IAKzB,qCAAqC;IACrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUjC,kCAAkC;IAClC,eAAe,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAUzH,6EAA6E;IACvE,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC;IAgBtB;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;IAyB7C,0CAA0C;IAC1C,IAAI,cAAc,IAAI,OAAO,CAE5B;CACF"}