@phuetz/code-buddy 0.1.25 → 0.2.0

package/dist/context/precompaction-flush.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pre-compaction Memory Flush — OpenClaw-inspired NO_REPLY pattern
+ *
+ * Before the context manager compacts (summarises/drops) old messages,
+ * this module runs a silent background LLM turn that asks the model to
+ * extract and save important facts to MEMORY.md.
+ *
+ * The `NO_REPLY` sentinel at the start of the response suppresses
+ * user-facing delivery, preventing notification spam. Only the extracted
+ * facts are written to disk; the LLM output is never shown to the user.
+ *
+ * This prevents the information loss that normally occurs when old turns
+ * are summarised away or dropped from the context window.
+ *
+ * Ref: OpenClaw session management compaction docs
+ * https://docs.openclaw.ai/reference/session-management-compaction
+ */
+export interface FlushMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface FlushResult {
+    /** Whether any facts were extracted and saved */
+    flushed: boolean;
+    /** Number of fact lines saved */
+    factsCount: number;
+    /** Path written to (or null if nothing written) */
+    writtenTo: string | null;
+    /** Whether the LLM returned NO_REPLY sentinel */
+    suppressed: boolean;
+}
+export declare class PrecompactionFlusher {
+    /** Run a silent flush before context compaction. */
+    flush(messages: FlushMessage[], 
+    /** Simple chat function: (messages) → string */
+    chatFn: (msgs: FlushMessage[]) => Promise<string>, workDir?: string): Promise<FlushResult>;
+    private buildSnapshot;
+    private saveFacts;
+}
+export declare function getPrecompactionFlusher(): PrecompactionFlusher;

package/dist/context/precompaction-flush.js

@@ -0,0 +1,134 @@
+/**
+ * Pre-compaction Memory Flush — OpenClaw-inspired NO_REPLY pattern
+ *
+ * Before the context manager compacts (summarises/drops) old messages,
+ * this module runs a silent background LLM turn that asks the model to
+ * extract and save important facts to MEMORY.md.
+ *
+ * The `NO_REPLY` sentinel at the start of the response suppresses
+ * user-facing delivery, preventing notification spam. Only the extracted
+ * facts are written to disk; the LLM output is never shown to the user.
+ *
+ * This prevents the information loss that normally occurs when old turns
+ * are summarised away or dropped from the context window.
+ *
+ * Ref: OpenClaw session management compaction docs
+ * https://docs.openclaw.ai/reference/session-management-compaction
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const NO_REPLY_SENTINEL = 'NO_REPLY';
+const ACK_MAX_CHARS = 300;
+const FLUSH_SYSTEM_PROMPT = `You are a memory archivist. Your ONLY job is to extract
+important, durable facts from a conversation that is about to be compressed.
+
+OUTPUT FORMAT:
+- Start with exactly "${NO_REPLY_SENTINEL}" on the first line if there is nothing worth saving.
+- Otherwise output a compact Markdown bullet list of facts to remember. Each bullet should be
+  a self-contained statement under 120 chars. No meta-commentary. No repetition.
+
+SAVE if: decisions made, user preferences stated, key file paths, API contracts,
+architectural choices, project goals, error patterns discovered, credentials
+configuration (NOT the secret values), important URLs.
+
+SKIP if: small talk, debugging tangents, transient data, already-known facts.`;
+// ============================================================================
+// PrecompactionFlusher
+// ============================================================================
+export class PrecompactionFlusher {
+    /** Run a silent flush before context compaction. */
+    async flush(messages, 
+    /** Simple chat function: (messages) → string */
+    chatFn, workDir = process.cwd()) {
+        if (messages.length < 4) {
+            // Not enough history to bother flushing
+            return { flushed: false, factsCount: 0, writtenTo: null, suppressed: false };
+        }
+        // Build a compact snapshot of the conversation to flush
+        const snapshot = this.buildSnapshot(messages);
+        const flushMessages = [
+            { role: 'system', content: FLUSH_SYSTEM_PROMPT },
+            { role: 'user', content: `Conversation to analyse:\n\n${snapshot}` },
+        ];
+        let response;
+        try {
+            response = await chatFn(flushMessages);
+        }
+        catch (err) {
+            logger.debug('PrecompactionFlusher: LLM call failed', { err });
+            return { flushed: false, factsCount: 0, writtenTo: null, suppressed: false };
+        }
+        const trimmed = response.trim();
+        // Detect NO_REPLY sentinel
+        if (trimmed.startsWith(NO_REPLY_SENTINEL) &&
+            trimmed.length - NO_REPLY_SENTINEL.length <= ACK_MAX_CHARS) {
+            return { flushed: false, factsCount: 0, writtenTo: null, suppressed: true };
+        }
+        // Strip NO_REPLY prefix if present with additional content
+        const content = trimmed.startsWith(NO_REPLY_SENTINEL)
+            ? trimmed.slice(NO_REPLY_SENTINEL.length).trim()
+            : trimmed;
+        if (!content) {
+            return { flushed: false, factsCount: 0, writtenTo: null, suppressed: true };
+        }
+        // Save facts to MEMORY.md
+        const writtenTo = await this.saveFacts(content, workDir);
+        const factsCount = content.split('\n').filter(l => l.startsWith('-')).length;
+        return { flushed: true, factsCount, writtenTo, suppressed: false };
+    }
+    // --------------------------------------------------------------------------
+    // Helpers
+    // --------------------------------------------------------------------------
+    buildSnapshot(messages) {
+        // Take last 60 messages at most, stripping tool call internals
+        const slice = messages.slice(-60);
+        return slice
+            .filter(m => m.role !== 'system')
+            .map(m => {
+            const prefix = m.role === 'user' ? 'User' : 'Assistant';
+            const body = typeof m.content === 'string'
+                ? m.content.slice(0, 800)
+                : '[non-text content]';
+            return `**${prefix}:** ${body}`;
+        })
+            .join('\n\n---\n\n');
+    }
+    async saveFacts(content, workDir) {
+        const memoryPath = path.join(workDir, 'MEMORY.md');
+        const datestamp = new Date().toISOString().split('T')[0];
+        const header = `\n\n## Facts extracted ${datestamp} (pre-compaction flush)\n\n`;
+        const block = header + content + '\n';
+        try {
+            fs.appendFileSync(memoryPath, block, 'utf-8');
+            logger.debug('PrecompactionFlusher: facts saved', { memoryPath });
+            return memoryPath;
+        }
+        catch (err) {
+            // Try global fallback
+            const globalPath = path.join(process.env.HOME ?? process.env.USERPROFILE ?? '~', '.codebuddy', 'MEMORY.md');
+            try {
+                fs.mkdirSync(path.dirname(globalPath), { recursive: true });
+                fs.appendFileSync(globalPath, block, 'utf-8');
+                return globalPath;
+            }
+            catch {
+                logger.debug('PrecompactionFlusher: could not write facts', { err });
+                return memoryPath; // report intended path even on failure
+            }
+        }
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let _instance = null;
+export function getPrecompactionFlusher() {
+    if (!_instance)
+        _instance = new PrecompactionFlusher();
+    return _instance;
+}
+//# sourceMappingURL=precompaction-flush.js.map

package/dist/context/precompaction-flush.js.map

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

package/dist/context/restorable-compression.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Restorable Compression — Manus AI context engineering pattern
+ *
+ * Instead of lossy summarisation (which discards content permanently),
+ * this module extracts structural identifiers (file paths, URLs, tool
+ * call IDs, line ranges) from messages that are about to be dropped,
+ * then stores the original content indexed by those identifiers.
+ *
+ * The agent can later call `restore_context(identifier)` to re-fetch
+ * the full content on demand, making context compression reversible.
+ *
+ * This is complementary to summarisation: a short summary of a long
+ * file-read result is kept in the context, while the full content is
+ * recoverable via its file path identifier.
+ *
+ * Ref: "Context Engineering for AI Agents: Lessons from Building Manus"
+ * https://manus.im/blog/Context-Engineering-for-AI-Agents-Lessons-from-Building-Manus
+ */
+export interface CompressibleMessage {
+    role: string;
+    content: string | null;
+    tool_call_id?: string;
+    name?: string;
+}
+export interface CompressionResult {
+    /** Compressed messages (identifiers preserved, full content dropped) */
+    messages: CompressibleMessage[];
+    /** Identifiers that were extracted and stored */
+    identifiers: string[];
+    /** Number of tokens saved (estimated) */
+    tokensSaved: number;
+}
+export interface RestoreResult {
+    found: boolean;
+    content: string;
+    identifier: string;
+}
+export declare class RestorableCompressor {
+    /** identifier → original content */
+    private store;
+    /**
+     * Compress a slice of messages that are about to be dropped.
+     *
+     * For each message, identifiers are extracted and the full content is
+     * stored. The message content is replaced with a compact stub listing
+     * the available identifiers.
+     */
+    compress(messages: CompressibleMessage[]): CompressionResult;
+    /**
+     * Restore the original content for an identifier.
+     *
+     * For file path identifiers, attempts to read from disk as a fallback.
+     * For URLs, returns a hint to use web_fetch.
+     */
+    restore(identifier: string): RestoreResult;
+    /**
+     * Persist a tool result to disk under `.codebuddy/tool-results/<callId>.txt`.
+     * This gives the restore_context tool a reliable disk-backed source and enables
+     * the compact/full dual-representation pattern (Manus AI #19).
+     *
+     * @param callId  - Tool call ID (e.g. call_abc123 or toolu_xyz)
+     * @param content - Full tool output
+     * @param workDir - Working directory (defaults to process.cwd())
+     */
+    writeToolResult(callId: string, content: string, workDir?: string): void;
+    /**
+     * Read a tool result from disk (`.codebuddy/tool-results/<callId>.txt`).
+     * Used by restore_context when the in-memory store has been evicted.
+     */
+    private readToolResultFromDisk;
+    /** List all stored identifiers */
+    listIdentifiers(): string[];
+    /** Total number of bytes stored */
+    storeSize(): number;
+    /** Evict oldest entries if store exceeds maxBytes (default 10 MB) */
+    evict(maxBytes?: number): void;
+}
+export declare function getRestorableCompressor(): RestorableCompressor;
+/** Reset singleton (for tests) */
+export declare function resetRestorableCompressor(): void;

package/dist/context/restorable-compression.js

@@ -0,0 +1,228 @@
+/**
+ * Restorable Compression — Manus AI context engineering pattern
+ *
+ * Instead of lossy summarisation (which discards content permanently),
+ * this module extracts structural identifiers (file paths, URLs, tool
+ * call IDs, line ranges) from messages that are about to be dropped,
+ * then stores the original content indexed by those identifiers.
+ *
+ * The agent can later call `restore_context(identifier)` to re-fetch
+ * the full content on demand, making context compression reversible.
+ *
+ * This is complementary to summarisation: a short summary of a long
+ * file-read result is kept in the context, while the full content is
+ * recoverable via its file path identifier.
+ *
+ * Ref: "Context Engineering for AI Agents: Lessons from Building Manus"
+ * https://manus.im/blog/Context-Engineering-for-AI-Agents-Lessons-from-Building-Manus
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Identifier extractors
+// ============================================================================
+// File paths: absolute or relative, with extensions
+const FILE_PATH_RE = /(?:^|\s|["'`(])(\/?(?:[\w.-]+\/)*[\w.-]+\.(?:ts|js|py|json|md|txt|yaml|yml|sh|go|rs|java|cpp|c|h|rb|php|swift|kt|cs|html|css|sql|env|toml|cfg|conf|xml)(?::\d+(?:-\d+)?)?)/g;
+// URLs
+const URL_RE = /https?:\/\/[^\s"'<>)]+/g;
+// Tool call IDs (Anthropic/OpenAI style)
+const TOOL_CALL_ID_RE = /\b(call_[a-zA-Z0-9]+|toolu_[a-zA-Z0-9]+)\b/g;
+function extractIdentifiers(text) {
+    const ids = new Set();
+    for (const m of text.matchAll(FILE_PATH_RE)) {
+        const raw = m[1].trim().replace(/['"`:]/g, '');
+        if (raw.length > 3)
+            ids.add(raw);
+    }
+    for (const m of text.matchAll(URL_RE)) {
+        const url = m[0].replace(/[.,;)]+$/, ''); // strip trailing punctuation
+        ids.add(url);
+    }
+    for (const m of text.matchAll(TOOL_CALL_ID_RE)) {
+        ids.add(m[1]);
+    }
+    return [...ids];
+}
+// ============================================================================
+// RestorableCompressor
+// ============================================================================
+export class RestorableCompressor {
+    /** identifier → original content */
+    store = new Map();
+    /**
+     * Compress a slice of messages that are about to be dropped.
+     *
+     * For each message, identifiers are extracted and the full content is
+     * stored. The message content is replaced with a compact stub listing
+     * the available identifiers.
+     */
+    compress(messages) {
+        const compressed = [];
+        const allIdentifiers = [];
+        let tokensSaved = 0;
+        for (const msg of messages) {
+            const content = msg.content ?? '';
+            if (!content || content.length < 200) {
+                // Short messages: keep as-is
+                compressed.push(msg);
+                continue;
+            }
+            const ids = extractIdentifiers(content);
+            if (ids.length === 0) {
+                // No identifiers to preserve — keep original
+                compressed.push(msg);
+                continue;
+            }
+            // Store original content indexed by each identifier
+            for (const id of ids) {
+                if (!this.store.has(id)) {
+                    this.store.set(id, content);
+                }
+            }
+            allIdentifiers.push(...ids);
+            tokensSaved += Math.floor(content.length / 4); // rough token estimate
+            // Replace with a compact stub
+            const stub = `[Content compressed — identifiers: ${ids.slice(0, 5).join(', ')}${ids.length > 5 ? ` +${ids.length - 5} more` : ''}. Use restore_context(identifier) to retrieve.]`;
+            compressed.push({ ...msg, content: stub });
+            logger.debug('RestorableCompressor: compressed message', {
+                identifiers: ids.length,
+                originalLen: content.length,
+                stubLen: stub.length,
+            });
+        }
+        return {
+            messages: compressed,
+            identifiers: [...new Set(allIdentifiers)],
+            tokensSaved,
+        };
+    }
+    /**
+     * Restore the original content for an identifier.
+     *
+     * For file path identifiers, attempts to read from disk as a fallback.
+     * For URLs, returns a hint to use web_fetch.
+     */
+    restore(identifier) {
+        // 1. Check in-memory store
+        const stored = this.store.get(identifier);
+        if (stored) {
+            return { found: true, content: stored, identifier };
+        }
+        // 2. Tool call ID — check disk-backed store
+        if (identifier.startsWith('call_') || identifier.startsWith('toulu_') || identifier.startsWith('toolu_')) {
+            const diskContent = this.readToolResultFromDisk(identifier);
+            if (diskContent) {
+                return { found: true, content: diskContent, identifier };
+            }
+        }
+        // 3. File path fallback — try reading from disk
+        if (!identifier.startsWith('http') && !identifier.startsWith('call_') && !identifier.startsWith('toolu_')) {
+            try {
+                // Strip line range if present (file.ts:10-50 → file.ts)
+                const filePath = identifier.split(':')[0];
+                if (fs.existsSync(filePath)) {
+                    const content = fs.readFileSync(filePath, 'utf-8');
+                    this.store.set(identifier, content); // cache for future
+                    return { found: true, content, identifier };
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+        // 3. URL hint
+        if (identifier.startsWith('http')) {
+            return {
+                found: false,
+                content: `URL content not cached. Use web_fetch("${identifier}") to retrieve it.`,
+                identifier,
+            };
+        }
+        return {
+            found: false,
+            content: `Identifier "${identifier}" not found in restoration store.`,
+            identifier,
+        };
+    }
+    /**
+     * Persist a tool result to disk under `.codebuddy/tool-results/<callId>.txt`.
+     * This gives the restore_context tool a reliable disk-backed source and enables
+     * the compact/full dual-representation pattern (Manus AI #19).
+     *
+     * @param callId  - Tool call ID (e.g. call_abc123 or toolu_xyz)
+     * @param content - Full tool output
+     * @param workDir - Working directory (defaults to process.cwd())
+     */
+    writeToolResult(callId, content, workDir = process.cwd()) {
+        try {
+            const dir = path.join(workDir, '.codebuddy', 'tool-results');
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            const filePath = path.join(dir, `${callId}.txt`);
+            fs.writeFileSync(filePath, content, 'utf-8');
+            // Also store in memory for fast access
+            this.store.set(callId, content);
+        }
+        catch (err) {
+            // Non-critical: disk write failure should not break tool execution
+            logger.debug('RestorableCompressor: failed to write tool result to disk', { callId, err });
+        }
+    }
+    /**
+     * Read a tool result from disk (`.codebuddy/tool-results/<callId>.txt`).
+     * Used by restore_context when the in-memory store has been evicted.
+     */
+    readToolResultFromDisk(callId, workDir = process.cwd()) {
+        try {
+            const filePath = path.join(workDir, '.codebuddy', 'tool-results', `${callId}.txt`);
+            if (fs.existsSync(filePath)) {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                this.store.set(callId, content); // cache back into memory
+                return content;
+            }
+        }
+        catch {
+            // ignore
+        }
+        return null;
+    }
+    /** List all stored identifiers */
+    listIdentifiers() {
+        return [...this.store.keys()];
+    }
+    /** Total number of bytes stored */
+    storeSize() {
+        let total = 0;
+        for (const v of this.store.values())
+            total += v.length;
+        return total;
+    }
+    /** Evict oldest entries if store exceeds maxBytes (default 10 MB) */
+    evict(maxBytes = 10 * 1024 * 1024) {
+        while (this.storeSize() > maxBytes && this.store.size > 0) {
+            const firstKey = this.store.keys().next().value;
+            if (firstKey !== undefined) {
+                this.store.delete(firstKey);
+            }
+            else {
+                break;
+            }
+        }
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let _instance = null;
+export function getRestorableCompressor() {
+    if (!_instance)
+        _instance = new RestorableCompressor();
+    return _instance;
+}
+/** Reset singleton (for tests) */
+export function resetRestorableCompressor() {
+    _instance = null;
+}
+//# sourceMappingURL=restorable-compression.js.map

package/dist/context/restorable-compression.js.map

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

package/dist/daemon/daily-reset.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Daily Session Reset — OpenClaw-inspired context boundary
+ *
+ * Automatically resets the conversation context at a configurable time
+ * each day (default: 04:00 local time). This prevents unbounded context
+ * growth in long-running daemon sessions and mirrors the daily boundary
+ * reset pattern in OpenClaw.
+ *
+ * What is reset:
+ * - In-memory conversation history (messages array)
+ * - Cached tool selection results
+ *
+ * What is PRESERVED:
+ * - MEMORY.md (durable facts)
+ * - HEARTBEAT.md (task checklist)
+ * - Session metadata (model, cost counters)
+ * - All files on disk (todo.md, PLAN.md, etc.)
+ *
+ * After reset the agent posts a summary message noting the daily boundary
+ * so the conversation log remains intelligible.
+ *
+ * Ref: OpenClaw session management compaction docs
+ * https://docs.openclaw.ai/reference/session-management-compaction
+ */
+import { EventEmitter } from 'events';
+export interface DailyResetConfig {
+    /** Hour of the day for the reset (0-23). Default: 4 */
+    resetHour: number;
+    /** Minute of the reset (0-59). Default: 0 */
+    resetMinute: number;
+    /** IANA timezone identifier. Default: system local */
+    timezone?: string;
+    /** Whether the daily reset is enabled. Default: true */
+    enabled: boolean;
+    /** Post a summary message after reset. Default: true */
+    postSummary: boolean;
+}
+export interface ResetResult {
+    triggeredAt: Date;
+    /** Number of messages cleared */
+    messagesCleared: number;
+    /** Summary message posted to conversation (or null if postSummary is false) */
+    summaryMessage: string | null;
+}
+export declare class DailyResetManager extends EventEmitter {
+    private config;
+    private timer;
+    private lastResetDate;
+    constructor(config?: Partial<DailyResetConfig>);
+    /**
+     * Start the daily reset scheduler.
+     * Call this once when the daemon starts.
+     */
+    start(): void;
+    stop(): void;
+    /** Returns milliseconds until the next reset window. */
+    msUntilNextReset(): number;
+    private scheduleNext;
+    /**
+     * Perform the daily reset on the provided messages array (modified in-place).
+     *
+     * @param messages - The agent's LLM messages array to clear
+     * @param systemMessage - Optional system message to keep at position [0]
+     */
+    runReset(messages: Array<{
+        role: string;
+        content: string | null;
+    }>, systemMessage?: {
+        role: string;
+        content: string;
+    }): Promise<ResetResult>;
+    private buildSummaryMessage;
+    getConfig(): Readonly<DailyResetConfig>;
+    isEnabled(): boolean;
+}
+export declare function getDailyResetManager(config?: Partial<DailyResetConfig>): DailyResetManager;
+export declare function resetDailyResetManager(): void;