@fathippo/fathippo-context-engine 0.1.1

package/README.md

@@ -0,0 +1,76 @@
+# @fathippo/fathippo-context-engine
+
+FatHippo Context Engine for OpenClaw — persistent agent memory with hosted cognition or private local mode.
+
+## Installation
+
+```bash
+openclaw plugins install @fathippo/fathippo-context-engine
+```
+
+## Configuration
+
+```yaml
+# ~/.openclaw/config.yaml
+plugins:
+  slots:
+    contextEngine: "fathippo-context-engine"
+  entries:
+    fathippo-context-engine:
+      enabled: true
+      config:
+        mode: hosted                # hosted or local
+        apiKey: "${FATHIPPO_API_KEY}" # Hosted mode only
+        baseUrl: "https://fathippo.ai/api"
+        # Optional settings
+        injectCritical: true        # Auto-inject critical memories (default: true)
+        injectLimit: 20             # Max memories per turn (default: 20)
+        captureUserOnly: true       # Only capture user messages (default: true)
+        dreamCycleOnCompact: true   # Run Dream Cycle on /compact in hosted mode
+```
+
+## What It Does
+
+Instead of bolting memory onto OpenClaw, this makes FatHippo the **entire context layer**:
+
+| Hook | What Happens |
+|------|-------------|
+| **bootstrap** | Loads hosted critical context or initializes local workspace memory |
+| **ingest** | Captures user messages, filters noise, stores hosted or local memory |
+| **assemble** | Queries hosted FatHippo or local store and injects relevant context per turn |
+| **compact** | Runs hosted Dream Cycle or skips hosted compaction in local mode |
+| **afterTurn** | Invalidates caches and captures hosted or local learning signals |
+| **prepareSubagentSpawn** | Scopes memories for spawned agents |
+| **onSubagentEnded** | Absorbs learnings from completed subagents |
+
+## Features
+
+- **Hosted mode** — Full FatHippo retrieval, cognition, sync, and receipts
+- **Local mode** — Private on-device memory plus lightweight local workflow/fix learning
+- **Semantic search** — Hosted hybrid search or local memory ranking
+- **Dream Cycle** — Automatic synthesis, decay, and cleanup in hosted mode
+- **Cross-device** — Hosted mode follows your account across devices
+
+## API Key
+
+Get your API key at [fathippo.ai](https://fathippo.ai)
+
+## OpenClaw CLI Setup
+
+```bash
+openclaw plugins install @fathippo/fathippo-context-engine
+openclaw config set plugins.slots.contextEngine=fathippo-context-engine
+openclaw config set plugins.entries.fathippo-context-engine.config.mode=hosted
+openclaw config set plugins.entries.fathippo-context-engine.config.apiKey=mem_xxx
+openclaw config set plugins.entries.fathippo-context-engine.config.baseUrl=https://fathippo.ai/api
+openclaw config set plugins.entries.fathippo-context-engine.config.injectCritical=true
+openclaw gateway restart
+```
+
+If you previously installed `@fathippo/context-engine`, reinstall from `@fathippo/fathippo-context-engine` so OpenClaw discovers a matching package name and plugin id.
+
+## Links
+
+- [FatHippo Docs](https://fathippo.ai/docs)
+- [OpenClaw Plugins](https://docs.openclaw.ai/tools/plugin)
+- [GitHub](https://github.com/jscianna/fathippo)

package/dist/api/client.d.ts

@@ -0,0 +1,75 @@
+/**
+ * FatHippo API Client
+ */
+import type { FatHippoConfig, Memory, SearchResult, CriticalMemoriesResponse, RememberParams, SearchParams, DreamCycleParams, IndexedMemory, IndexedMemoriesResponse } from "../types.js";
+export declare class FatHippoClient {
+    private apiKey;
+    private baseUrl;
+    private pluginHeaders;
+    constructor(config: FatHippoConfig);
+    private request;
+    /**
+     * Store a memory
+     */
+    remember(params: RememberParams): Promise<Memory>;
+    /**
+     * Search memories
+     */
+    search(params: SearchParams): Promise<SearchResult[]>;
+    /**
+     * Get critical-tier memories (for injection)
+     */
+    getCriticalMemories(options?: {
+        limit?: number;
+        excludeAbsorbed?: boolean;
+    }): Promise<CriticalMemoriesResponse>;
+    /**
+     * Get recent memories (for context)
+     */
+    getRecentMemories(options?: {
+        hours?: number;
+        limit?: number;
+    }): Promise<Memory[]>;
+    /**
+     * Run Dream Cycle (synthesis, decay, cleanup)
+     */
+    runDreamCycle(params?: DreamCycleParams): Promise<{
+        ok: boolean;
+        synthesized?: number;
+        decayed?: number;
+    }>;
+    /**
+     * Get context for injection (optimized endpoint)
+     */
+    getContext(query?: string): Promise<{
+        memories: Memory[];
+        syntheses?: Array<{
+            id: string;
+            title: string;
+            content: string;
+        }>;
+        tokenEstimate?: number;
+    }>;
+    /**
+     * Get indexed memory summaries (compact, for agent context)
+     */
+    getIndexedSummaries(): Promise<IndexedMemoriesResponse>;
+    /**
+     * Dereference an indexed memory to get full content
+     */
+    dereferenceIndex(indexKey: string): Promise<IndexedMemory>;
+    /**
+     * Store an indexed memory
+     */
+    storeIndexed(params: {
+        index: string;
+        summary: string;
+        content: string;
+        contentType?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        stored: boolean;
+        index: string;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,MAAM,EACN,YAAY,EACZ,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAoCrB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAyB;gBAElC,MAAM,EAAE,cAAc;YAUpB,OAAO;IAyBrB;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAQvD;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAsC3D;;OAEG;IACG,mBAAmB,CAAC,OAAO,CAAC,EAAE;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA6BrC;;OAEG;IACG,iBAAiB,CAAC,OAAO,CAAC,EAAE;QAChC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAerB;;OAEG;IACG,aAAa,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC;QACtD,EAAE,EAAE,OAAO,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAYF;;OAEG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,CAAC,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAClE,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IAqBF;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAI7D;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIhE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAMhD"}

package/dist/api/client.js

@@ -0,0 +1,176 @@
+/**
+ * FatHippo API Client
+ */
+const DEFAULT_BASE_URL = "https://fathippo.ai/api";
+function mapMemoryRecord(record) {
+    return {
+        id: record.id,
+        title: record.title,
+        content: record.text,
+        userId: record.userId ?? "",
+        memoryType: record.memoryType ?? record.type,
+        importanceTier: record.importanceTier ??
+            record.tier ??
+            "normal",
+        createdAt: record.createdAt,
+        updatedAt: record.createdAt,
+        accessCount: record.accessCount,
+        absorbed: record.absorbed,
+        absorbedIntoSynthesisId: record.absorbedIntoSynthesisId,
+    };
+}
+export class FatHippoClient {
+    apiKey;
+    baseUrl;
+    pluginHeaders;
+    constructor(config) {
+        this.apiKey = config.apiKey ?? "";
+        this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
+        this.pluginHeaders = {
+            "X-Fathippo-Plugin-Id": config.pluginId ?? "fathippo-context-engine",
+            "X-Fathippo-Plugin-Version": config.pluginVersion ?? "unknown",
+            "X-Fathippo-Plugin-Mode": config.mode === "local" ? "local" : "hosted",
+        };
+    }
+    async request(path, options = {}) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+            ...this.pluginHeaders,
+            ...options.headers,
+        };
+        const response = await fetch(url, {
+            ...options,
+            headers,
+        });
+        if (!response.ok) {
+            const error = await response.text().catch(() => "Unknown error");
+            throw new Error(`FatHippo API error: ${response.status} - ${error}`);
+        }
+        return response.json();
+    }
+    /**
+     * Store a memory
+     */
+    async remember(params) {
+        const response = await this.request("/v1/memories", {
+            method: "POST",
+            body: JSON.stringify(params),
+        });
+        return mapMemoryRecord(response.memory);
+    }
+    /**
+     * Search memories
+     */
+    async search(params) {
+        const response = await this.request("/v1/search", {
+            method: "POST",
+            body: JSON.stringify(params),
+        });
+        return response.map((result) => ({
+            memory: mapMemoryRecord(result.memory),
+            score: result.score,
+            matchType: result.vectorScore && result.bm25Score
+                ? "hybrid"
+                : result.vectorScore
+                    ? "vector"
+                    : "bm25",
+        }));
+    }
+    /**
+     * Get critical-tier memories (for injection)
+     */
+    async getCriticalMemories(options) {
+        const response = await this.request("/v1/context", {
+            method: "POST",
+            body: JSON.stringify({
+                message: "",
+                includeHigh: false,
+                highLimit: 0,
+            }),
+        });
+        const memories = response.critical
+            .map(mapMemoryRecord)
+            .filter((memory) => (options?.excludeAbsorbed ? !memory.absorbed : true))
+            .slice(0, options?.limit ?? 30);
+        const syntheses = response.working.slice(0, options?.limit ?? 30).map((item) => ({
+            id: item.id,
+            userId: "",
+            title: item.title,
+            content: item.text,
+            sourceMemoryIds: item.synthesizedFrom ?? [],
+            createdAt: new Date().toISOString(),
+        }));
+        return { memories, syntheses };
+    }
+    /**
+     * Get recent memories (for context)
+     */
+    async getRecentMemories(options) {
+        const params = new URLSearchParams();
+        if (options?.limit)
+            params.set("limit", String(options.limit));
+        const response = await this.request(`/v1/memories?${params}`);
+        let memories = response.memories.map(mapMemoryRecord);
+        if (options?.hours) {
+            const cutoff = Date.now() - options.hours * 60 * 60 * 1000;
+            memories = memories.filter((memory) => Date.parse(memory.createdAt) >= cutoff);
+        }
+        return memories;
+    }
+    /**
+     * Run Dream Cycle (synthesis, decay, cleanup)
+     */
+    async runDreamCycle(params) {
+        const response = await this.request("/v1/lifecycle", {
+            method: "POST",
+            body: JSON.stringify(params || {}),
+        });
+        return {
+            ok: true,
+            synthesized: 0,
+            decayed: (response.maintenance?.archived ?? 0) + (response.maintenance?.deleted ?? 0),
+        };
+    }
+    /**
+     * Get context for injection (optimized endpoint)
+     */
+    async getContext(query) {
+        const response = await this.request("/v1/context", {
+            method: "POST",
+            body: JSON.stringify({ message: query || "" }),
+        });
+        return {
+            memories: [...response.critical, ...response.high].map(mapMemoryRecord),
+            syntheses: response.working?.map((item) => ({
+                id: item.id,
+                title: item.title,
+                content: item.text,
+            })),
+            tokenEstimate: response.stats?.totalTokensEstimate,
+        };
+    }
+    /**
+     * Get indexed memory summaries (compact, for agent context)
+     */
+    async getIndexedSummaries() {
+        return this.request("/v1/indexed");
+    }
+    /**
+     * Dereference an indexed memory to get full content
+     */
+    async dereferenceIndex(indexKey) {
+        return this.request(`/v1/indexed/${encodeURIComponent(indexKey)}`);
+    }
+    /**
+     * Store an indexed memory
+     */
+    async storeIndexed(params) {
+        return this.request("/v1/indexed", {
+            method: "POST",
+            body: JSON.stringify(params),
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/cognitive/sanitize.d.ts

@@ -0,0 +1,3 @@
+export declare function sanitizeCognitiveText(text: string): string;
+export declare function isShareEligible(text: string): boolean;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/cognitive/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/cognitive/sanitize.ts"],"names":[],"mappings":"AAOA,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/cognitive/sanitize.js

@@ -0,0 +1,17 @@
+const SECRET_PATTERNS = [
+    /sk-[a-zA-Z0-9]{20,}/g,
+    /ghp_[a-zA-Z0-9]{20,}/g,
+    /AKIA[A-Z0-9]{16}/g,
+    /(['"]?)(?:api[_-]?key|secret|password|token)(['"]?\s*[:=]\s*)(['"]?)[^\s'"]+\3/gi,
+];
+export function sanitizeCognitiveText(text) {
+    let sanitized = text;
+    for (const pattern of SECRET_PATTERNS) {
+        sanitized = sanitized.replace(pattern, "[REDACTED]");
+    }
+    return sanitized;
+}
+export function isShareEligible(text) {
+    return !SECRET_PATTERNS.some((pattern) => pattern.test(text));
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/cognitive/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/cognitive/sanitize.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG;IACtB,sBAAsB;IACtB,uBAAuB;IACvB,mBAAmB;IACnB,kFAAkF;CACnF,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/cognitive/trace-capture.d.ts

@@ -0,0 +1,51 @@
+import type { AgentMessage } from "@mariozechner/pi-agent-core";
+export type StructuredTracePayload = {
+    sessionId: string;
+    type: string;
+    problem: string;
+    context: {
+        technologies: string[];
+        errorMessages?: string[];
+    };
+    reasoning: string;
+    approaches: Array<{
+        description: string;
+        result: "worked" | "failed" | "partial";
+        learnings?: string;
+    }>;
+    solution?: string;
+    outcome: "success" | "partial" | "failed";
+    heuristicOutcome: "success" | "partial" | "failed";
+    automatedOutcome?: "success" | "failed";
+    automatedSignals: Record<string, unknown>;
+    errorMessage?: string;
+    toolsUsed: string[];
+    toolCalls: Array<Record<string, unknown>>;
+    toolResults: Array<Record<string, unknown>>;
+    verificationCommands: string[];
+    retryCount: number;
+    repoSignals: {
+        filesModified: string[];
+        languages: string[];
+        diffSummary: string;
+        workspaceRoot?: string;
+    };
+    resolutionKind: "tests_passed" | "build_passed" | "lint_passed" | "manual_only" | "failed";
+    filesModified: string[];
+    durationMs: number;
+    sanitized: true;
+    sanitizedAt: string;
+    shareEligible: boolean;
+};
+export declare function shouldCaptureCodingTrace(messages: AgentMessage[]): boolean;
+export declare function buildStructuredTrace(params: {
+    sessionId: string;
+    messages: AgentMessage[];
+    toolsUsed?: string[];
+    filesModified?: string[];
+    workspaceRoot?: string;
+    startTime: number;
+    endTime: number;
+}): StructuredTracePayload | null;
+export declare function getMessageText(message: AgentMessage): string;
+//# sourceMappingURL=trace-capture.d.ts.map

package/dist/cognitive/trace-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-capture.d.ts","sourceRoot":"","sources":["../../src/cognitive/trace-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,gBAAgB,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACnD,gBAAgB,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACxC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5C,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE;QACX,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,cAAc,EAAE,cAAc,GAAG,cAAc,GAAG,aAAa,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC3F,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAiEF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAM1E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,sBAAsB,GAAG,IAAI,CAsEhC;AA8lBD,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAwB5D"}