pi-harness-runtime 1.1.95 → 1.1.97

package/packages/trajectory/dist/src/memory-store.js

@@ -0,0 +1,472 @@
+/**
+ * Memory Store - Persistent memory for agent notes and user preferences
+ *
+ * Based on Hermes Agent's memory system:
+ * - MEMORY.md: Agent's personal notes (environment facts, conventions, tool quirks)
+ * - USER.md: User preferences and patterns (Honcho dialectic modeling)
+ *
+ * Memory is injected into system prompt at session start.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+/**
+ * Default memory store configuration
+ */
+export const DEFAULT_MEMORY_CONFIG = {
+    memoryFile: "~/.pi-harness/memory/MEMORY.md",
+    userFile: "~/.pi-harness/memory/USER.md",
+    maxMemoryTokens: 1300,
+};
+/**
+ * Expand ~ in paths
+ */
+function expandPath(path) {
+    if (path.startsWith("~/")) {
+        return join(homedir(), path.slice(2));
+    }
+    return path;
+}
+/**
+ * Generate fingerprint for content deduplication
+ */
+function generateFingerprint(content) {
+    // Simple hash for fingerprinting
+    let hash = 0;
+    for (let i = 0; i < content.length; i++) {
+        const char = content.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    return Math.abs(hash).toString(16);
+}
+/**
+ * Memory Store class
+ */
+export class MemoryStore {
+    config;
+    memoryFile;
+    userFile;
+    memoryCache = [];
+    userCache = [];
+    dirty = false;
+    constructor(config) {
+        this.config = { ...DEFAULT_MEMORY_CONFIG, ...config };
+        this.memoryFile = expandPath(this.config.memoryFile);
+        this.userFile = expandPath(this.config.userFile);
+        this.load();
+    }
+    /**
+     * Load memory from files
+     */
+    load() {
+        this.memoryCache = this.loadMemoryFile(this.memoryFile);
+        this.userCache = this.loadUserFile(this.userFile);
+    }
+    /**
+     * Load memory entries from file
+     */
+    loadMemoryFile(filePath) {
+        if (!existsSync(filePath)) {
+            return [];
+        }
+        try {
+            const content = readFileSync(filePath, "utf-8");
+            return this.parseMemoryMarkdown(content);
+        }
+        catch (err) {
+            console.error(`[MemoryStore] Failed to load ${filePath}:`, err);
+            return [];
+        }
+    }
+    /**
+     * Load user profile from file
+     */
+    loadUserFile(filePath) {
+        if (!existsSync(filePath)) {
+            return [];
+        }
+        try {
+            const content = readFileSync(filePath, "utf-8");
+            return this.parseUserMarkdown(content);
+        }
+        catch (err) {
+            console.error(`[MemoryStore] Failed to load ${filePath}:`, err);
+            return [];
+        }
+    }
+    /**
+     * Parse memory markdown format
+     */
+    parseMemoryMarkdown(content) {
+        const entries = [];
+        const lines = content.split("\n");
+        let currentEntry = null;
+        let currentContent = [];
+        for (const line of lines) {
+            // Check for entry separator
+            if (line.startsWith("---")) {
+                if (currentEntry && currentContent.length > 0) {
+                    entries.push({
+                        id: currentEntry.id,
+                        content: currentContent.join("\n").trim(),
+                        source: currentEntry.source || "agent",
+                        created_at: currentEntry.created_at,
+                        updated_at: currentEntry.updated_at,
+                        tags: currentEntry.tags,
+                        fingerprint: generateFingerprint(currentContent.join("\n")),
+                    });
+                }
+                currentEntry = {};
+                currentContent = [];
+                continue;
+            }
+            // Parse metadata
+            if (line.includes(":") && currentEntry) {
+                const [key, ...valueParts] = line.split(":");
+                const value = valueParts.join(":").trim();
+                switch (key.trim()) {
+                    case "id":
+                        currentEntry.id = value;
+                        break;
+                    case "source":
+                        currentEntry.source = value;
+                        break;
+                    case "created":
+                    case "created_at":
+                        currentEntry.created_at = value;
+                        break;
+                    case "updated":
+                    case "updated_at":
+                        currentEntry.updated_at = value;
+                        break;
+                    case "tags":
+                        currentEntry.tags = value.split(",").map((t) => t.trim());
+                        break;
+                }
+            }
+            else if (currentEntry?.id) {
+                currentContent.push(line);
+            }
+        }
+        // Push last entry
+        if (currentEntry && currentContent.length > 0) {
+            entries.push({
+                id: currentEntry.id,
+                content: currentContent.join("\n").trim(),
+                source: currentEntry.source || "agent",
+                created_at: currentEntry.created_at,
+                updated_at: currentEntry.updated_at,
+                tags: currentEntry.tags,
+                fingerprint: generateFingerprint(currentContent.join("\n")),
+            });
+        }
+        return entries;
+    }
+    /**
+     * Parse user profile markdown format
+     */
+    parseUserMarkdown(content) {
+        const entries = [];
+        const lines = content.split("\n");
+        let currentEntry = null;
+        let currentContent = [];
+        let currentCategory = "preference";
+        for (const line of lines) {
+            // Check for category header
+            if (line.startsWith("## ")) {
+                currentCategory = line.slice(3).trim().toLowerCase();
+                continue;
+            }
+            // Check for entry separator
+            if (line.startsWith("---")) {
+                if (currentEntry && currentContent.length > 0) {
+                    entries.push({
+                        id: currentEntry.id,
+                        content: currentContent.join("\n").trim(),
+                        category: currentEntry.category || currentCategory,
+                        created_at: currentEntry.created_at,
+                        updated_at: currentEntry.updated_at,
+                        confidence: currentEntry.confidence ?? 0.8,
+                    });
+                }
+                currentEntry = {};
+                currentContent = [];
+                continue;
+            }
+            // Parse metadata
+            if (line.includes(":") && currentEntry) {
+                const [key, ...valueParts] = line.split(":");
+                const value = valueParts.join(":").trim();
+                switch (key.trim()) {
+                    case "id":
+                        currentEntry.id = value;
+                        break;
+                    case "confidence":
+                        currentEntry.confidence = parseFloat(value);
+                        break;
+                }
+            }
+            else if (currentEntry?.id) {
+                currentContent.push(line);
+            }
+        }
+        // Push last entry
+        if (currentEntry && currentContent.length > 0) {
+            entries.push({
+                id: currentEntry.id,
+                content: currentContent.join("\n").trim(),
+                category: currentEntry.category || currentCategory,
+                created_at: currentEntry.created_at,
+                updated_at: currentEntry.updated_at,
+                confidence: currentEntry.confidence ?? 0.8,
+            });
+        }
+        return entries;
+    }
+    /**
+     * Save memory to file
+     */
+    save() {
+        if (!this.dirty)
+            return;
+        // Ensure directory exists
+        const memoryDir = dirname(this.memoryFile);
+        mkdirSync(memoryDir, { recursive: true });
+        // Write memory file
+        writeFileSync(this.memoryFile, this.serializeMemory(), "utf-8");
+        // Write user file
+        writeFileSync(this.userFile, this.serializeUser(), "utf-8");
+        this.dirty = false;
+    }
+    /**
+     * Serialize memory entries to markdown
+     */
+    serializeMemory() {
+        if (this.memoryCache.length === 0) {
+            return "# Memory\n\nNo entries yet.\n";
+        }
+        const lines = ["# Memory", "", "---"];
+        for (const entry of this.memoryCache) {
+            lines.push(`id: ${entry.id}`);
+            lines.push(`source: ${entry.source}`);
+            lines.push(`created_at: ${entry.created_at}`);
+            lines.push(`updated_at: ${entry.updated_at}`);
+            if (entry.tags?.length) {
+                lines.push(`tags: ${entry.tags.join(", ")}`);
+            }
+            lines.push("---");
+            lines.push(entry.content);
+            lines.push("");
+            lines.push("---");
+            lines.push("");
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Serialize user entries to markdown
+     */
+    serializeUser() {
+        const categories = ["preference", "style", "workflow", "context"];
+        const lines = ["# User Preferences", ""];
+        for (const category of categories) {
+            const entries = this.userCache.filter((e) => e.category === category);
+            if (entries.length === 0)
+                continue;
+            lines.push(`## ${category.charAt(0).toUpperCase() + category.slice(1)}`, "");
+            for (const entry of entries) {
+                lines.push(`id: ${entry.id}`);
+                lines.push(`confidence: ${entry.confidence}`);
+                lines.push("---");
+                lines.push(entry.content);
+                lines.push("");
+            }
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Add memory entry
+     */
+    addMemory(content, source = "agent", tags) {
+        const now = new Date().toISOString();
+        const entry = {
+            id: `mem_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+            content,
+            source,
+            created_at: now,
+            updated_at: now,
+            tags,
+            fingerprint: generateFingerprint(content),
+        };
+        // Check for duplicate
+        const existing = this.memoryCache.findIndex((e) => e.fingerprint === entry.fingerprint);
+        if (existing >= 0) {
+            // Update existing entry
+            this.memoryCache[existing].updated_at = now;
+            this.memoryCache[existing].content = content;
+            this.dirty = true;
+            this.save();
+            return this.memoryCache[existing];
+        }
+        this.memoryCache.push(entry);
+        this.dirty = true;
+        this.save();
+        return entry;
+    }
+    /**
+     * Replace memory entry
+     */
+    replaceMemory(oldText, newContent) {
+        const index = this.memoryCache.findIndex((e) => e.content.includes(oldText));
+        if (index < 0) {
+            return false;
+        }
+        this.memoryCache[index].content = newContent;
+        this.memoryCache[index].updated_at = new Date().toISOString();
+        this.memoryCache[index].fingerprint = generateFingerprint(newContent);
+        this.dirty = true;
+        this.save();
+        return true;
+    }
+    /**
+     * Remove memory entry
+     */
+    removeMemory(oldText) {
+        const index = this.memoryCache.findIndex((e) => e.content.includes(oldText));
+        if (index < 0) {
+            return false;
+        }
+        this.memoryCache.splice(index, 1);
+        this.dirty = true;
+        this.save();
+        return true;
+    }
+    /**
+     * Add user profile entry
+     */
+    addUserProfile(content, category = "preference", confidence = 0.8) {
+        const now = new Date().toISOString();
+        const entry = {
+            id: `user_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+            content,
+            category,
+            created_at: now,
+            updated_at: now,
+            confidence,
+        };
+        this.userCache.push(entry);
+        this.dirty = true;
+        this.save();
+        return entry;
+    }
+    /**
+     * Get all memory entries
+     */
+    getMemory() {
+        return [...this.memoryCache];
+    }
+    /**
+     * Get all user profile entries
+     */
+    getUserProfile() {
+        return [...this.userCache];
+    }
+    /**
+     * Get memory as system prompt section
+     */
+    getMemorySection() {
+        if (this.memoryCache.length === 0) {
+            return "";
+        }
+        const lines = ["## Agent Memory", ""];
+        for (const entry of this.memoryCache) {
+            lines.push(`- ${entry.content}`);
+            if (entry.tags?.length) {
+                lines.push(`  Tags: ${entry.tags.join(", ")}`);
+            }
+        }
+        lines.push("");
+        return lines.join("\n");
+    }
+    /**
+     * Get user preferences as system prompt section
+     */
+    getUserSection() {
+        if (this.userCache.length === 0) {
+            return "";
+        }
+        const lines = ["## User Preferences", ""];
+        for (const entry of this.userCache) {
+            if (entry.confidence < 0.5)
+                continue; // Skip low confidence
+            lines.push(`- [${entry.category}] ${entry.content}`);
+        }
+        lines.push("");
+        return lines.join("\n");
+    }
+    /**
+     * Search memory entries
+     */
+    searchMemory(query) {
+        const queryLower = query.toLowerCase();
+        return this.memoryCache.filter((e) => e.content.toLowerCase().includes(queryLower) ||
+            e.tags?.some((t) => t.toLowerCase().includes(queryLower)));
+    }
+    /**
+     * List pending entries (for write approval)
+     */
+    listPending() {
+        return {
+            memory: this.memoryCache.filter((e) => e.source === "agent"),
+            user: this.userCache,
+        };
+    }
+    /**
+     * Get approximate token count
+     */
+    getApproxTokenCount() {
+        const memory = this.serializeMemory();
+        const user = this.serializeUser();
+        // Rough estimate: 1 token ≈ 4 chars
+        return Math.ceil((memory.length + user.length) / 4);
+    }
+    /**
+     * Check if memory exceeds max tokens
+     */
+    isOverTokenLimit() {
+        return this.getApproxTokenCount() > this.config.maxMemoryTokens;
+    }
+    /**
+     * Compact memory (keep most recent/important entries)
+     */
+    compact() {
+        // Sort by updated_at descending, keep top entries
+        this.memoryCache.sort((a, b) => b.updated_at.localeCompare(a.updated_at));
+        // Keep entries until under token limit
+        const targetTokens = this.config.maxMemoryTokens * 0.8; // 80% of limit
+        const keptEntries = [];
+        let tokenCount = 0;
+        for (const entry of this.memoryCache) {
+            const entryTokens = Math.ceil(entry.content.length / 4);
+            if (tokenCount + entryTokens <= targetTokens) {
+                keptEntries.push(entry);
+                tokenCount += entryTokens;
+            }
+        }
+        this.memoryCache = keptEntries;
+        this.dirty = true;
+        this.save();
+    }
+}
+// Global memory store instance
+let globalMemoryStore = null;
+export function getGlobalMemoryStore() {
+    if (!globalMemoryStore) {
+        globalMemoryStore = new MemoryStore();
+    }
+    return globalMemoryStore;
+}
+export function createMemoryStore(config) {
+    return new MemoryStore(config);
+}
+//# sourceMappingURL=memory-store.js.map

package/packages/trajectory/dist/src/memory-store.js.map

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

package/packages/trajectory/dist/src/review-fork.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Background Review Fork
+ *
+ * Background review that analyzes trajectories and suggests:
+ * - Memory entries to persist
+ * - Skills to create/update
+ * - User preferences to learn
+ *
+ * Based on Hermes Agent's closed learning loop.
+ */
+import type { Trajectory } from "./types.js";
+/**
+ * Background review configuration
+ */
+export interface BackgroundReviewConfig {
+    /** Enable background review */
+    enabled: boolean;
+    /** Cycles between reviews (1 = every cycle) */
+    nudgeInterval: number;
+    /** Reasoning effort for review */
+    reasoningEffort: "low" | "medium" | "high";
+    /** Route to cheaper model for review */
+    routeToCheaperModel: boolean;
+    /** Cheaper model to use */
+    cheaperModel?: string;
+    /** Require approval before writes */
+    writeApproval: boolean;
+    /** Defer review when GPU busy */
+    deferWhenGpuBusy: boolean;
+    /** Max age in seconds before running queued review */
+    deferMaxAgeSeconds: number;
+}
+/**
+ * Default background review configuration
+ */
+export declare const DEFAULT_REVIEW_CONFIG: BackgroundReviewConfig;
+/**
+ * Review suggestion types
+ */
+export type SuggestionType = "memory" | "skill_create" | "skill_patch" | "user_profile" | "pattern";
+/**
+ * Review suggestion
+ */
+export interface ReviewSuggestion {
+    id: string;
+    type: SuggestionType;
+    priority: "low" | "medium" | "high";
+    content: string;
+    reason: string;
+    trajectoryId?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Review result
+ */
+export interface ReviewResult {
+    trajectoryId: string;
+    suggestions: ReviewSuggestion[];
+    patterns: string[];
+    corrections: string[];
+    timestamp: number;
+}
+/**
+ * Review event types
+ */
+export type ReviewEvent = {
+    type: "review.started";
+    trajectoryId: string;
+} | {
+    type: "review.completed";
+    result: ReviewResult;
+} | {
+    type: "review.error";
+    error: string;
+    trajectoryId: string;
+} | {
+    type: "suggestion.created";
+    suggestion: ReviewSuggestion;
+} | {
+    type: "suggestion.approved";
+    suggestion: ReviewSuggestion;
+} | {
+    type: "suggestion.rejected";
+    suggestion: ReviewSuggestion;
+};
+/**
+ * Review event handler
+ */
+export type ReviewEventHandler = (event: ReviewEvent) => void;
+/**
+ * Background Review Fork
+ */
+export declare class BackgroundReviewFork {
+    private config;
+    private cycleCount;
+    private queuedReview;
+    private handlers;
+    private pendingSuggestions;
+    constructor(config?: Partial<BackgroundReviewConfig>);
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<BackgroundReviewConfig>): void;
+    /**
+     * Register event handler
+     */
+    on(handler: ReviewEventHandler): () => void;
+    /**
+     * Emit event to all handlers
+     */
+    private emit;
+    /**
+     * Process cycle end - check if review should run
+     */
+    onCycleEnd(trajectory: Trajectory): void;
+    /**
+     * Run review on trajectory
+     */
+    runReview(trajectory: Trajectory): Promise<ReviewResult>;
+    /**
+     * Analyze trajectory and generate suggestions
+     */
+    private analyzeTrajectory;
+    /**
+     * Generate skill content from trajectory
+     */
+    private generateSkillFromTrajectory;
+    /**
+     * Extract task type from request
+     */
+    private extractTaskType;
+    /**
+     * Extract user preferences from summary
+     */
+    private extractUserPreferences;
+    /**
+     * Get pending suggestions
+     */
+    getPendingSuggestions(): ReviewSuggestion[];
+    /**
+     * Approve suggestion
+     */
+    approveSuggestion(suggestionId: string): ReviewSuggestion | null;
+    /**
+     * Reject suggestion
+     */
+    rejectSuggestion(suggestionId: string): ReviewSuggestion | null;
+    /**
+     * Clear all pending suggestions
+     */
+    clearSuggestions(): void;
+    /**
+     * Get review stats
+     */
+    getStats(): {
+        cycleCount: number;
+        pendingCount: number;
+        enabled: boolean;
+        nudgeInterval: number;
+    };
+}
+export declare function getGlobalReviewFork(): BackgroundReviewFork;
+export declare function createReviewFork(config?: Partial<BackgroundReviewConfig>): BackgroundReviewFork;
+//# sourceMappingURL=review-fork.d.ts.map

package/packages/trajectory/dist/src/review-fork.d.ts.map

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