@hippodid/openclaw-plugin 1.0.0 → 1.0.2

package/dist/file-sync.d.ts

@@ -0,0 +1,18 @@
+import type { HippoDidClient } from './hippodid-client.js';
+import type { PluginConfig, WatchPath } from './types.js';
+export interface FileSync {
+    start(): void;
+    stop(): void;
+    flushNow(): Promise<{
+        synced: number;
+        changed: number;
+    }>;
+    hydrateFromCloud(): Promise<number>;
+}
+interface Logger {
+    info(message: string): void;
+    warn(message: string): void;
+}
+export declare function createFileSync(client: HippoDidClient, config: PluginConfig, watchPaths: WatchPath[], logger: Logger, effectiveSyncIntervalSeconds?: number): FileSync;
+export {};
+//# sourceMappingURL=file-sync.d.ts.map

package/dist/file-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sync.d.ts","sourceRoot":"","sources":["../src/file-sync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAqB,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7E,MAAM,WAAW,QAAQ;IACvB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,QAAQ,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACrC;AAED,UAAU,MAAM;IACd,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,SAAS,EAAE,EACvB,MAAM,EAAE,MAAM,EACd,4BAA4B,CAAC,EAAE,MAAM,GACpC,QAAQ,CAgOV"}

package/dist/file-sync.js

@@ -0,0 +1,172 @@
+import { createHash } from 'node:crypto';
+import { readFile, writeFile, readdir, stat } from 'node:fs/promises';
+import { watch } from 'node:fs';
+import { resolve, join, extname } from 'node:path';
+export function createFileSync(client, config, watchPaths, logger, effectiveSyncIntervalSeconds) {
+    const syncIntervalMs = (effectiveSyncIntervalSeconds ?? config.syncIntervalSeconds) * 1000;
+    const tracking = new Map();
+    const watchers = [];
+    let debounceTimer = null;
+    let pendingChanges = new Set();
+    async function computeHash(filePath) {
+        const content = await readFile(filePath);
+        return createHash('sha256').update(content).digest('hex');
+    }
+    function toBase64(buffer) {
+        return buffer.toString('base64');
+    }
+    function fromBase64(content) {
+        return Buffer.from(content, 'base64').toString('utf-8');
+    }
+    async function resolveFilesForPath(wp) {
+        try {
+            const s = await stat(wp.path);
+            if (s.isDirectory()) {
+                const entries = await readdir(wp.path);
+                return entries
+                    .filter((e) => extname(e) === '.md')
+                    .map((e) => resolve(join(wp.path, e)));
+            }
+            return [resolve(wp.path)];
+        }
+        catch {
+            return [];
+        }
+    }
+    async function resolveAllFiles() {
+        const files = [];
+        const seen = new Set();
+        for (const wp of watchPaths) {
+            const resolved = await resolveFilesForPath(wp);
+            for (const filePath of resolved) {
+                if (!seen.has(filePath)) {
+                    seen.add(filePath);
+                    files.push({ filePath, label: wp.label });
+                }
+            }
+        }
+        return files;
+    }
+    async function syncFile(filePath, label) {
+        try {
+            const content = await readFile(filePath);
+            const hash = createHash('sha256').update(content).digest('hex');
+            const existing = tracking.get(filePath);
+            if (existing && existing.hash === hash) {
+                return false;
+            }
+            const base64Content = toBase64(content);
+            const result = await client.syncFile(config.characterId, filePath, label, base64Content, hash);
+            if (result.ok) {
+                tracking.set(filePath, { hash, lastSyncedAt: new Date() });
+                return result.value.changed;
+            }
+            logger.warn(`hippodid: sync failed for ${filePath}: ${result.error.message}`);
+            return false;
+        }
+        catch (e) {
+            logger.warn(`hippodid: error syncing ${filePath}: ${e instanceof Error ? e.message : 'unknown'}`);
+            return false;
+        }
+    }
+    async function runSync() {
+        const files = await resolveAllFiles();
+        let synced = 0;
+        let changed = 0;
+        for (const { filePath, label } of files) {
+            const wasChanged = await syncFile(filePath, label);
+            synced++;
+            if (wasChanged)
+                changed++;
+        }
+        logger.info(`hippodid: synced ${synced} files (${changed} changed, ${synced - changed} unchanged)`);
+        return { synced, changed };
+    }
+    function scheduleDebouncedSync() {
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+        debounceTimer = setTimeout(() => {
+            debounceTimer = null;
+            runSync().catch((e) => {
+                logger.warn(`hippodid: debounced sync error: ${e instanceof Error ? e.message : 'unknown'}`);
+            });
+        }, syncIntervalMs);
+    }
+    function onFileChange(filePath) {
+        pendingChanges.add(filePath);
+        scheduleDebouncedSync();
+    }
+    return {
+        start() {
+            for (const wp of watchPaths) {
+                try {
+                    const watcher = watch(wp.path, { persistent: false }, (_event, filename) => {
+                        if (filename && extname(filename) === '.md') {
+                            const fullPath = resolve(join(wp.path.endsWith('.md') ? resolve(wp.path, '..') : wp.path, filename));
+                            onFileChange(fullPath);
+                        }
+                        else if (wp.path.endsWith('.md')) {
+                            onFileChange(resolve(wp.path));
+                        }
+                    });
+                    watcher.on('error', (err) => {
+                        logger.warn(`hippodid: watcher error for ${wp.path}: ${err instanceof Error ? err.message : 'unknown'}`);
+                    });
+                    watchers.push(watcher);
+                }
+                catch (e) {
+                    logger.warn(`hippodid: failed to watch ${wp.path}: ${e instanceof Error ? e.message : 'unknown'}`);
+                }
+            }
+            scheduleDebouncedSync();
+        },
+        stop() {
+            for (const w of watchers) {
+                w.close();
+            }
+            watchers.length = 0;
+            if (debounceTimer) {
+                clearTimeout(debounceTimer);
+                debounceTimer = null;
+            }
+            pendingChanges.clear();
+        },
+        async flushNow() {
+            if (debounceTimer) {
+                clearTimeout(debounceTimer);
+                debounceTimer = null;
+            }
+            return runSync();
+        },
+        async hydrateFromCloud() {
+            const files = await resolveAllFiles();
+            let hydrated = 0;
+            for (const { filePath } of files) {
+                try {
+                    const result = await client.getLatestSync(config.characterId, filePath);
+                    if (!result.ok) {
+                        logger.warn(`hippodid: hydration lookup failed for ${filePath}: ${result.error.message}`);
+                        continue;
+                    }
+                    if (result.value === null) {
+                        continue;
+                    }
+                    const cloudContent = fromBase64(result.value.fileContent);
+                    await writeFile(filePath, cloudContent, 'utf-8');
+                    const hash = createHash('sha256')
+                        .update(Buffer.from(cloudContent))
+                        .digest('hex');
+                    tracking.set(filePath, { hash, lastSyncedAt: new Date() });
+                    hydrated++;
+                }
+                catch (e) {
+                    logger.warn(`hippodid: hydration error for ${filePath}: ${e instanceof Error ? e.message : 'unknown'}`);
+                }
+            }
+            logger.info(`hippodid: hydrated ${hydrated} files from cloud`);
+            return hydrated;
+        },
+    };
+}
+//# sourceMappingURL=file-sync.js.map

package/dist/file-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sync.js","sourceRoot":"","sources":["../src/file-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,KAAK,EAAkB,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBnD,MAAM,UAAU,cAAc,CAC5B,MAAsB,EACtB,MAAoB,EACpB,UAAuB,EACvB,MAAc,EACd,4BAAqC;IAErC,MAAM,cAAc,GAAG,CAAC,4BAA4B,IAAI,MAAM,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC;IAC3F,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IACtD,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,IAAI,aAAa,GAAyC,IAAI,CAAC;IAC/D,IAAI,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,KAAK,UAAU,WAAW,CAAC,QAAgB;QACzC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,SAAS,QAAQ,CAAC,MAAc;QAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,UAAU,CAAC,OAAe;QACjC,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,UAAU,mBAAmB,CAAC,EAAa;QAC9C,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBACvC,OAAO,OAAO;qBACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC;qBACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,UAAU,eAAe;QAG5B,MAAM,KAAK,GAA+C,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,EAAE,CAAC,CAAC;YAC/C,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;gBAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACnB,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,UAAU,QAAQ,CACrB,QAAgB,EAChB,KAAa;QAEb,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChE,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAExC,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACvC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAClC,MAAM,CAAC,WAAW,EAClB,QAAQ,EACR,KAAK,EACL,aAAa,EACb,IAAI,CACL,CAAC;YAEF,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC3D,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;YAC9B,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,6BAA6B,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9E,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CACT,2BAA2B,QAAQ,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CACrF,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,UAAU,OAAO;QACpB,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;QACtC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACnD,MAAM,EAAE,CAAC;YACT,IAAI,UAAU;gBAAE,OAAO,EAAE,CAAC;QAC5B,CAAC;QAED,MAAM,CAAC,IAAI,CACT,oBAAoB,MAAM,WAAW,OAAO,aAAa,MAAM,GAAG,OAAO,aAAa,CACvF,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,SAAS,qBAAqB;QAC5B,IAAI,aAAa,EAAE,CAAC;YAClB,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QACD,aAAa,GAAG,UAAU,CACxB,GAAG,EAAE;YACH,aAAa,GAAG,IAAI,CAAC;YACrB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;gBACpB,MAAM,CAAC,IAAI,CACT,mCAAmC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAChF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,EACD,cAAc,CACf,CAAC;IACJ,CAAC;IAED,SAAS,YAAY,CAAC,QAAgB;QACpC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,qBAAqB,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,KAAK;YACH,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;wBACzE,IAAI,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;4BAC5C,MAAM,QAAQ,GAAG,OAAO,CACtB,IAAI,CACF,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAC1D,QAAQ,CACT,CACF,CAAC;4BACF,YAAY,CAAC,QAAQ,CAAC,CAAC;wBACzB,CAAC;6BAAM,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;4BACnC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;wBACjC,CAAC;oBACH,CAAC,CAAC,CAAC;oBACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;wBAC1B,MAAM,CAAC,IAAI,CACT,+BAA+B,EAAE,CAAC,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAC5F,CAAC;oBACJ,CAAC,CAAC,CAAC;oBACH,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACzB,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,CAAC,IAAI,CACT,6BAA6B,EAAE,CAAC,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CACtF,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,qBAAqB,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI;YACF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,CAAC,CAAC,KAAK,EAAE,CAAC;YACZ,CAAC;YACD,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YAEpB,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,aAAa,GAAG,IAAI,CAAC;YACvB,CAAC;YAED,cAAc,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,QAAQ;YACZ,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,aAAa,GAAG,IAAI,CAAC;YACvB,CAAC;YACD,OAAO,OAAO,EAAE,CAAC;QACnB,CAAC;QAED,KAAK,CAAC,gBAAgB;YACpB,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;YACtC,IAAI,QAAQ,GAAG,CAAC,CAAC;YAEjB,KAAK,MAAM,EAAE,QAAQ,EAAE,IAAI,KAAK,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CACvC,MAAM,CAAC,WAAW,EAClB,QAAQ,CACT,CAAC;oBACF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;wBACf,MAAM,CAAC,IAAI,CACT,yCAAyC,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAC7E,CAAC;wBACF,SAAS;oBACX,CAAC;oBAED,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;wBAC1B,SAAS;oBACX,CAAC;oBAED,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;oBAC1D,MAAM,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;oBAEjD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;yBAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;yBACjC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACjB,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;oBAC3D,QAAQ,EAAE,CAAC;gBACb,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,CAAC,IAAI,CACT,iCAAiC,QAAQ,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAC3F,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,sBAAsB,QAAQ,mBAAmB,CAAC,CAAC;YAC/D,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/hippodid-client.d.ts

@@ -0,0 +1,11 @@
+import type { Result, TierInfo, SyncResponse, SyncLatestResponse, SyncStatusResponse, SearchResult } from './types.js';
+export interface HippoDidClient {
+    getTier(characterId: string): Promise<Result<TierInfo>>;
+    syncFile(characterId: string, sourcePath: string, label: string, fileContent: string, checksum: string): Promise<Result<SyncResponse>>;
+    getLatestSync(characterId: string, sourcePath: string): Promise<Result<SyncLatestResponse | null>>;
+    getSyncStatus(characterId: string): Promise<Result<SyncStatusResponse>>;
+    searchMemories(characterId: string, query: string, topK?: number): Promise<Result<SearchResult[]>>;
+    addMemory(characterId: string, content: string, source?: string): Promise<Result<void>>;
+}
+export declare function createClient(apiKey: string, baseUrl: string): HippoDidClient;
+//# sourceMappingURL=hippodid-client.d.ts.map

package/dist/hippodid-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hippodid-client.d.ts","sourceRoot":"","sources":["../src/hippodid-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,MAAM,EACN,QAAQ,EAER,YAAY,EAEZ,kBAAkB,EAGlB,kBAAkB,EAClB,YAAY,EAEb,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxD,QAAQ,CACN,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IACjC,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9C,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACxE,cAAc,CACZ,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IACnC,SAAS,CACP,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAuO5E"}

package/dist/hippodid-client.js

@@ -0,0 +1,155 @@
+import { ok, err } from './types.js';
+const MAX_RETRIES = 3;
+const REQUEST_TIMEOUT_MS = 10_000;
+const TIER_CACHE_TTL_MS = 5 * 60 * 1000;
+export function createClient(apiKey, baseUrl) {
+    let tierCache = null;
+    function headers() {
+        return {
+            'X-Api-Key': apiKey,
+            'Content-Type': 'application/json',
+        };
+    }
+    function isRetryable(status) {
+        return status === 429 || status >= 500;
+    }
+    function toApiError(status, message) {
+        return { status, message, retryable: isRetryable(status) };
+    }
+    async function fetchWithTimeout(url, init) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        try {
+            return await fetch(url, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async function request(method, path, body) {
+        const url = `${baseUrl}${path}`;
+        let lastError = null;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            if (attempt > 0) {
+                const delay = Math.min(1000 * Math.pow(2, attempt - 1), 8000);
+                await new Promise((r) => setTimeout(r, delay));
+            }
+            try {
+                const resp = await fetchWithTimeout(url, {
+                    method,
+                    headers: headers(),
+                    body: body !== undefined ? JSON.stringify(body) : undefined,
+                });
+                if (!resp.ok) {
+                    const errorText = await resp.text().catch(() => 'Unknown error');
+                    lastError = toApiError(resp.status, errorText);
+                    if (!isRetryable(resp.status)) {
+                        return err(lastError);
+                    }
+                    continue;
+                }
+                if (resp.status === 204) {
+                    return ok(undefined);
+                }
+                const data = (await resp.json());
+                return ok(data);
+            }
+            catch (e) {
+                const message = e instanceof Error ? e.message : 'Unknown network error';
+                lastError = toApiError(0, message);
+                if (attempt < MAX_RETRIES) {
+                    continue;
+                }
+            }
+        }
+        return err(lastError ?? toApiError(0, 'Request failed after retries'));
+    }
+    function mapTierResponse(raw) {
+        return {
+            tier: raw.tier,
+            features: {
+                autoRecallAvailable: raw.features.auto_recall_available,
+                autoCaptureAvailable: raw.features.auto_capture_available,
+                minSyncIntervalSeconds: raw.features.min_sync_interval_seconds,
+            },
+        };
+    }
+    function mapSyncResponse(raw) {
+        return {
+            status: raw.status,
+            snapshotId: raw.snapshot_id,
+            changed: raw.changed,
+        };
+    }
+    function mapSyncLatestResponse(raw) {
+        return {
+            sourcePath: raw.source_path,
+            fileContent: raw.file_content,
+            snapshotId: raw.snapshot_id,
+            syncedAt: raw.synced_at,
+        };
+    }
+    return {
+        async getTier(characterId) {
+            const now = Date.now();
+            if (tierCache && now - tierCache.fetchedAt < TIER_CACHE_TTL_MS) {
+                return ok(tierCache.info);
+            }
+            const result = await request('GET', `/v1/tier?characterId=${encodeURIComponent(characterId)}`);
+            if (!result.ok)
+                return result;
+            const info = mapTierResponse(result.value);
+            tierCache = { info, fetchedAt: now };
+            return ok(info);
+        },
+        async syncFile(characterId, sourcePath, label, fileContent, checksum) {
+            const result = await request('POST', `/v1/characters/${encodeURIComponent(characterId)}/sync`, {
+                source_path: sourcePath,
+                label,
+                file_content: fileContent,
+                checksum,
+            });
+            if (!result.ok)
+                return result;
+            return ok(mapSyncResponse(result.value));
+        },
+        async getLatestSync(characterId, sourcePath) {
+            const result = await request('GET', `/v1/characters/${encodeURIComponent(characterId)}/sync/latest?source_path=${encodeURIComponent(sourcePath)}`);
+            if (!result.ok) {
+                if (result.error.status === 404) {
+                    return ok(null);
+                }
+                return result;
+            }
+            return ok(mapSyncLatestResponse(result.value));
+        },
+        async getSyncStatus(characterId) {
+            const result = await request('GET', `/v1/characters/${encodeURIComponent(characterId)}/sync/status`);
+            if (!result.ok)
+                return result;
+            return ok({
+                entries: result.value.entries.map((e) => ({
+                    sourcePath: e.source_path,
+                    label: e.label,
+                    lastSyncedAt: e.last_synced_at,
+                    snapshotId: e.snapshot_id,
+                })),
+            });
+        },
+        async searchMemories(characterId, query, topK) {
+            const result = await request('POST', `/v1/characters/${encodeURIComponent(characterId)}/search`, { query, top_k: topK ?? 5 });
+            if (!result.ok)
+                return result;
+            return ok(result.value.map((r) => ({
+                content: r.content,
+                category: r.category,
+                score: r.score,
+                createdAt: r.created_at,
+            })));
+        },
+        async addMemory(characterId, content, source) {
+            return request('POST', `/v1/characters/${encodeURIComponent(characterId)}/memories`, { content, source: source ?? 'openclaw-plugin' });
+        },
+    };
+}
+//# sourceMappingURL=hippodid-client.js.map

package/dist/hippodid-client.js.map

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

package/dist/hooks/auto-capture.d.ts

@@ -0,0 +1,7 @@
+import type { HippoDidClient } from '../hippodid-client.js';
+import type { PluginConfig, OpenClawPluginAPI } from '../types.js';
+export declare function createAutoCaptureHook(client: HippoDidClient, config: PluginConfig, logger: {
+    info(msg: string): void;
+    warn(msg: string): void;
+}): (api: OpenClawPluginAPI) => void;
+//# sourceMappingURL=auto-capture.d.ts.map

package/dist/hooks/auto-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-capture.d.ts","sourceRoot":"","sources":["../../src/hooks/auto-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEnE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE;IAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CA8BlC"}

package/dist/hooks/auto-capture.js

@@ -0,0 +1,45 @@
+export function createAutoCaptureHook(client, config, logger) {
+    return (api) => {
+        api.hooks.on('agent_end', (...args) => {
+            try {
+                const exchange = extractExchange(args);
+                if (!exchange)
+                    return;
+                client
+                    .addMemory(config.characterId, exchange, 'openclaw-auto-capture')
+                    .then((result) => {
+                    if (result.ok) {
+                        logger.info('hippodid: captured exchange for memory extraction');
+                    }
+                    else {
+                        logger.warn(`hippodid: capture failed: ${result.error.message}`);
+                    }
+                })
+                    .catch((e) => {
+                    logger.warn(`hippodid: capture error: ${e instanceof Error ? e.message : 'unknown'}`);
+                });
+            }
+            catch (e) {
+                logger.warn(`hippodid: capture hook error: ${e instanceof Error ? e.message : 'unknown'}`);
+            }
+        });
+    };
+}
+function extractExchange(args) {
+    if (args.length > 0 && typeof args[0] === 'object' && args[0] !== null) {
+        const event = args[0];
+        const userMsg = typeof event['userMessage'] === 'string' ? event['userMessage'] : '';
+        const agentResp = typeof event['agentResponse'] === 'string' ? event['agentResponse'] : '';
+        if (userMsg || agentResp) {
+            return `User: ${userMsg}\n\nAgent: ${agentResp}`;
+        }
+        if (typeof event['content'] === 'string')
+            return event['content'];
+        if (typeof event['text'] === 'string')
+            return event['text'];
+    }
+    if (typeof args[0] === 'string')
+        return args[0];
+    return null;
+}
+//# sourceMappingURL=auto-capture.js.map

package/dist/hooks/auto-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-capture.js","sourceRoot":"","sources":["../../src/hooks/auto-capture.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,qBAAqB,CACnC,MAAsB,EACtB,MAAoB,EACpB,MAA4D;IAE5D,OAAO,CAAC,GAAsB,EAAE,EAAE;QAChC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YAC/C,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;gBACvC,IAAI,CAAC,QAAQ;oBAAE,OAAO;gBAEtB,MAAM;qBACH,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,uBAAuB,CAAC;qBAChE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;oBACf,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;wBACd,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;oBACnE,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,IAAI,CACT,6BAA6B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACpD,CAAC;oBACJ,CAAC;gBACH,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBACX,MAAM,CAAC,IAAI,CACT,4BAA4B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CACzE,CAAC;gBACJ,CAAC,CAAC,CAAC;YACP,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CACT,iCAAiC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAC9E,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAe;IACtC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAA4B,CAAC;QAEjD,MAAM,OAAO,GACX,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,MAAM,SAAS,GACb,OAAO,KAAK,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3E,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;YACzB,OAAO,SAAS,OAAO,cAAc,SAAS,EAAE,CAAC;QACnD,CAAC;QAED,IAAI,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/hooks/auto-recall.d.ts

@@ -0,0 +1,7 @@
+import type { HippoDidClient } from '../hippodid-client.js';
+import type { PluginConfig, OpenClawPluginAPI } from '../types.js';
+export declare function createAutoRecallHook(client: HippoDidClient, config: PluginConfig, logger: {
+    info(msg: string): void;
+    warn(msg: string): void;
+}): (api: OpenClawPluginAPI) => void;
+//# sourceMappingURL=auto-recall.d.ts.map

package/dist/hooks/auto-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-recall.d.ts","sourceRoot":"","sources":["../../src/hooks/auto-recall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEnE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE;IAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAoClC"}

package/dist/hooks/auto-recall.js

@@ -0,0 +1,46 @@
+export function createAutoRecallHook(client, config, logger) {
+    return (api) => {
+        api.hooks.on('before_agent_start', async (...args) => {
+            try {
+                const userMessage = extractUserMessage(args);
+                if (!userMessage)
+                    return;
+                const result = await client.searchMemories(config.characterId, userMessage, 5);
+                if (!result.ok) {
+                    logger.warn(`hippodid: recall search failed: ${result.error.message}`);
+                    return;
+                }
+                const memories = result.value;
+                if (memories.length === 0) {
+                    logger.info('hippodid: no relevant memories found');
+                    return;
+                }
+                const contextBlock = formatMemoriesBlock(memories);
+                api.context.prepend(contextBlock);
+                logger.info(`hippodid: recalled ${memories.length} memories for context`);
+            }
+            catch (e) {
+                logger.warn(`hippodid: recall hook error: ${e instanceof Error ? e.message : 'unknown'}`);
+            }
+        });
+    };
+}
+function extractUserMessage(args) {
+    if (args.length > 0 && typeof args[0] === 'object' && args[0] !== null) {
+        const event = args[0];
+        if (typeof event['message'] === 'string')
+            return event['message'];
+        if (typeof event['content'] === 'string')
+            return event['content'];
+        if (typeof event['text'] === 'string')
+            return event['text'];
+    }
+    if (typeof args[0] === 'string')
+        return args[0];
+    return null;
+}
+function formatMemoriesBlock(memories) {
+    const lines = memories.map((m) => `- [Category: ${m.category}] ${m.content}`);
+    return `<hippodid-memories>\n${lines.join('\n')}\n</hippodid-memories>`;
+}
+//# sourceMappingURL=auto-recall.js.map

package/dist/hooks/auto-recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-recall.js","sourceRoot":"","sources":["../../src/hooks/auto-recall.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,oBAAoB,CAClC,MAAsB,EACtB,MAAoB,EACpB,MAA4D;IAE5D,OAAO,CAAC,GAAsB,EAAE,EAAE;QAChC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;YAC9D,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBAC7C,IAAI,CAAC,WAAW;oBAAE,OAAO;gBAEzB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CACxC,MAAM,CAAC,WAAW,EAClB,WAAW,EACX,CAAC,CACF,CAAC;gBAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CACT,mCAAmC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAC1D,CAAC;oBACF,OAAO;gBACT,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC9B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;oBACpD,OAAO;gBACT,CAAC;gBAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;gBACnD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,sBAAsB,QAAQ,CAAC,MAAM,uBAAuB,CAAC,CAAC;YAC5E,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CACT,gCAAgC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAC7E,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAe;IACzC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAA4B,CAAC;QACjD,IAAI,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAOD,SAAS,mBAAmB,CAAC,QAAuB;IAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAClD,CAAC;IACF,OAAO,wBAAwB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC;AAC1E,CAAC"}

package/dist/hooks/memory-flush.d.ts

@@ -0,0 +1,7 @@
+import type { FileSync } from '../file-sync.js';
+import type { OpenClawPluginAPI } from '../types.js';
+export declare function createMemoryFlushHook(fileSync: FileSync, logger: {
+    info(msg: string): void;
+    warn(msg: string): void;
+}): (api: OpenClawPluginAPI) => void;
+//# sourceMappingURL=memory-flush.d.ts.map

package/dist/hooks/memory-flush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-flush.d.ts","sourceRoot":"","sources":["../../src/hooks/memory-flush.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE;IAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAelC"}

package/dist/hooks/memory-flush.js

@@ -0,0 +1,14 @@
+export function createMemoryFlushHook(fileSync, logger) {
+    return (api) => {
+        api.hooks.on('memoryFlush', async () => {
+            try {
+                const { synced, changed } = await fileSync.flushNow();
+                logger.info(`hippodid: pre-compaction flush — synced ${synced} files (${changed} changed)`);
+            }
+            catch (e) {
+                logger.warn(`hippodid: pre-compaction flush failed: ${e instanceof Error ? e.message : 'unknown'}`);
+            }
+        });
+    };
+}
+//# sourceMappingURL=memory-flush.js.map

package/dist/hooks/memory-flush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-flush.js","sourceRoot":"","sources":["../../src/hooks/memory-flush.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,qBAAqB,CACnC,QAAkB,EAClB,MAA4D;IAE5D,OAAO,CAAC,GAAsB,EAAE,EAAE;QAChC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,IAAI,EAAE;YACrC,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtD,MAAM,CAAC,IAAI,CACT,2CAA2C,MAAM,WAAW,OAAO,WAAW,CAC/E,CAAC;YACJ,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CACT,0CAA0C,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CACvF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/hooks/session-lifecycle.d.ts

@@ -0,0 +1,8 @@
+import type { FileSync } from '../file-sync.js';
+import type { TierManager } from '../tier-manager.js';
+import type { OpenClawPluginAPI } from '../types.js';
+export declare function createSessionHooks(fileSync: FileSync, tierManager: TierManager, autoRecallEnabled: boolean, logger: {
+    info(msg: string): void;
+    warn(msg: string): void;
+}): (api: OpenClawPluginAPI) => void;
+//# sourceMappingURL=session-lifecycle.d.ts.map

package/dist/hooks/session-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle.d.ts","sourceRoot":"","sources":["../../src/hooks/session-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,OAAO,EAC1B,MAAM,EAAE;IAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAgClC"}

package/dist/hooks/session-lifecycle.js

@@ -0,0 +1,29 @@
+export function createSessionHooks(fileSync, tierManager, autoRecallEnabled, logger) {
+    return (api) => {
+        api.hooks.on('session:start', async () => {
+            try {
+                await tierManager.initialize();
+                if (tierManager.shouldHydrateOnStart(autoRecallEnabled)) {
+                    const count = await fileSync.hydrateFromCloud();
+                    logger.info(`hippodid: session started, hydrated ${count} files from cloud`);
+                }
+                else {
+                    logger.info('hippodid: session started, hydration skipped (autoRecall active)');
+                }
+            }
+            catch (e) {
+                logger.warn(`hippodid: session start error: ${e instanceof Error ? e.message : 'unknown'}`);
+            }
+        });
+        api.hooks.on('session:end', async () => {
+            try {
+                const { synced, changed } = await fileSync.flushNow();
+                logger.info(`hippodid: session ended, final sync — ${synced} files (${changed} changed)`);
+            }
+            catch (e) {
+                logger.warn(`hippodid: session end flush failed: ${e instanceof Error ? e.message : 'unknown'}`);
+            }
+        });
+    };
+}
+//# sourceMappingURL=session-lifecycle.js.map

package/dist/hooks/session-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle.js","sourceRoot":"","sources":["../../src/hooks/session-lifecycle.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,kBAAkB,CAChC,QAAkB,EAClB,WAAwB,EACxB,iBAA0B,EAC1B,MAA4D;IAE5D,OAAO,CAAC,GAAsB,EAAE,EAAE;QAChC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;YACvC,IAAI,CAAC;gBACH,MAAM,WAAW,CAAC,UAAU,EAAE,CAAC;gBAE/B,IAAI,WAAW,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,CAAC;oBACxD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,gBAAgB,EAAE,CAAC;oBAChD,MAAM,CAAC,IAAI,CAAC,uCAAuC,KAAK,mBAAmB,CAAC,CAAC;gBAC/E,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;gBAClF,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CACT,kCAAkC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAC/E,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,IAAI,EAAE;YACrC,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtD,MAAM,CAAC,IAAI,CACT,yCAAyC,MAAM,WAAW,OAAO,WAAW,CAC7E,CAAC;YACJ,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CACT,uCAAuC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CACpF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { OpenClawPluginAPI } from './types.js';
+export declare const id = "hippodid";
+export default function register(api: OpenClawPluginAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,YAAY,CAAC;AAUlE,eAAO,MAAM,EAAE,aAAa,CAAC;AAI7B,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CA+D7D"}