@fathippo/fathippo-context-engine 0.1.1 → 0.1.3

package/README.md

@@ -1,17 +1,37 @@
 # @fathippo/fathippo-context-engine
 
-FatHippo Context Engine for OpenClaw — persistent agent memory with hosted cognition or private local mode.
+FatHippo Context Engine for OpenClaw.
 
-## Installation
+## Install
+
+Hosted:
+
+```bash
+npx @fathippo/connect openclaw
+```
+
+Local:
+
+```bash
+npx @fathippo/connect openclaw --local
+```
+
+The one-command installer installs the plugin, configures OpenClaw, and uses a browser-link login flow for hosted mode.
+
+## Manual fallback
 
 ```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 gateway restart
 ```
 
 ## Configuration
 
 ```yaml
-# ~/.openclaw/config.yaml
 plugins:
   slots:
     contextEngine: "fathippo-context-engine"
@@ -19,58 +39,37 @@ plugins:
     fathippo-context-engine:
       enabled: true
       config:
-        mode: hosted                # hosted or local
-        apiKey: "${FATHIPPO_API_KEY}" # Hosted mode only
+        mode: hosted
+        apiKey: "${FATHIPPO_API_KEY}"
         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
+        namespace: "my-project"
+        installationId: "oc_machine_01"
+        injectCritical: true
+        injectLimit: 20
+        dreamCycleOnCompact: true
 ```
 
-## What It Does
+`captureUserOnly: true` is still supported as a legacy escape hatch, but full-turn capture is now the default.
 
-Instead of bolting memory onto OpenClaw, this makes FatHippo the **entire context layer**:
+## Runtime behavior
 
-| 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 |
+| Hook | Behavior |
+| --- | --- |
+| `bootstrap` | Starts a hosted FatHippo session or initializes local workspace memory |
+| `assemble` | Builds memory context before every non-trivial reply |
+| `afterTurn` | Records the completed exchange, stores durable memories, and captures learning signals |
+| `compact` | Runs Dream Cycle in hosted mode when enabled |
+| `prepareSubagentSpawn` | Reuses the same memory scope for spawned agents |
+| `onSubagentEnded` | Best-effort closes hosted child sessions |
 
-## 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
+Hosted mode uses the runtime session APIs (`startSession`, `buildContext`, `recordTurn`, `endSession`) instead of direct one-off memory calls.
 
-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.
+## Features
 
-## Links
+- Hosted mode with account-backed retrieval, cognition, and dashboard receipts
+- Local mode with on-device memory and lightweight local workflow learning
+- Per-turn context recall before replies
+- Full-turn capture after replies
+- Dream Cycle compaction in hosted mode
 
-- [FatHippo Docs](https://fathippo.ai/docs)
-- [OpenClaw Plugins](https://docs.openclaw.ai/tools/plugin)
-- [GitHub](https://github.com/jscianna/fathippo)
+If you previously installed `@fathippo/context-engine`, reinstall from `@fathippo/fathippo-context-engine` so OpenClaw discovers the matching package name and plugin id cleanly.

package/dist/api/client.d.ts

@@ -1,75 +1,2 @@
-/**
- * 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;
-    }>;
-}
+export { FatHippoClient, type CriticalMemoriesResponse, type DreamCycleParams, type FatHippoClientOptions, type IndexedMemoriesResponse, type IndexedMemory, type Memory, type RememberParams, type SearchParams, type SearchResult, type SynthesizedMemory, } from "@fathippo/hosted";
 //# sourceMappingURL=client.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/api/client.js

@@ -1,176 +1,2 @@
-/**
- * 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),
-        });
-    }
-}
+export { FatHippoClient, } from "@fathippo/hosted";
 //# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAWf,MAAM,kBAAkB,CAAC"}

package/dist/engine.d.ts

@@ -12,18 +12,16 @@ import type { FatHippoConfig } from "./types.js";
 export declare class FatHippoContextEngine implements ContextEngine {
     readonly info: ContextEngineInfo;
     private client;
+    private runtimeClient;
     private config;
     private mode;
     private localStore;
-    private cachedCritical;
+    private hostedSessions;
     private sessionStartTimes;
-    private sessionApplicationIds;
     private sessionLocalProfiles;
     private sessionHippoNodState;
     private cognitiveEnabled;
     private static readonly TRIVIAL_ACKS;
-    private static readonly MIN_VECTOR_SIMILARITY;
-    private static readonly MIN_CRITICAL_RELEVANCE;
     private static readonly HIPPO_NOD_COOLDOWN_MS;
     private static readonly HIPPO_NOD_MIN_MESSAGE_GAP;
     constructor(config: FatHippoConfig);
@@ -73,23 +71,7 @@ export declare class FatHippoContextEngine implements ContextEngine {
         tokenBudget?: number;
     }): Promise<AssembleResult>;
     private assembleLocalContext;
-    /**
-     * Check if query looks like a coding task
-     */
-    private looksLikeCodingQuery;
-    /**
-     * Fetch active constraints (always injected)
-     */
-    private fetchConstraints;
-    /**
-     * Auto-detect and store constraints from user message
-     */
-    private maybeStoreConstraint;
-    /**
-     * Fetch relevant traces and patterns from cognitive API
-     */
-    private fetchCognitiveContext;
-    private captureStructuredTrace;
+    private buildRuntimeAwarenessInstruction;
     private runCognitiveHeartbeat;
     private detectFilesModified;
     private detectWorkspaceRoot;
@@ -99,8 +81,6 @@ export declare class FatHippoContextEngine implements ContextEngine {
     private mapLocalMemory;
     private toLocalToolSignals;
     private captureLocalTrace;
-    private getApiBaseUrl;
-    private getHostedHeaders;
     private buildHippoNodInstruction;
     private isHighUrgencyOrFormalMoment;
     /**
@@ -127,7 +107,7 @@ export declare class FatHippoContextEngine implements ContextEngine {
     /**
      * Handle subagent completion
      */
-    onSubagentEnded(_params: {
+    onSubagentEnded(params: {
         childSessionKey: string;
         reason: SubagentEndReason;
     }): Promise<void>;
@@ -136,6 +116,12 @@ export declare class FatHippoContextEngine implements ContextEngine {
      */
     dispose(): Promise<void>;
     private extractContent;
+    private buildHostedRuntimeMetadata;
+    private toRuntimeMessages;
+    private extractTurnMessages;
+    private captureLocalTurnMemories;
+    private mapHostedOutcomeFromReason;
+    private endHostedSession;
     private findLastUserMessage;
     private isTrivialQuery;
     private isRoleMessage;

package/dist/engine.d.ts.map

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