openclaw-engram 0.2.0

package/dist/config.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+export declare const PluginConfigSchema: z.ZodObject<{
+    /** Engram server base URL, e.g. "http://localhost:37777". */
+    url: z.ZodDefault<z.ZodEffects<z.ZodString, string, string>>;
+    /** Bearer token for engram API authentication. Marked sensitive in UI hints. */
+    token: z.ZodString;
+    /**
+     * Project scope override. When set, all observations are stored under this
+     * project regardless of workspace identity.
+     */
+    project: z.ZodOptional<z.ZodString>;
+    /** Maximum observations to inject per prompt turn. */
+    contextLimit: z.ZodDefault<z.ZodNumber>;
+    /** Maximum observations to inject at session start. */
+    sessionContextLimit: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Token budget for context injection. Approximately 4 chars per token.
+     * Observations are trimmed to fit within this budget.
+     */
+    tokenBudget: z.ZodDefault<z.ZodNumber>;
+    /** Per-request HTTP timeout in milliseconds. */
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Enable automatic observation extraction on compaction and session end.
+     * When false, only explicit tool calls store memories.
+     */
+    autoExtract: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Workspace directory path for memory file discovery (MEMORY.md, memory/).
+     * Required for /migrate command when called from channel context (Telegram, Discord)
+     * where PluginCommandContext doesn't carry workspaceDir.
+     * Defaults to ~/.openclaw/workspace/ (default agent workspace).
+     */
+    workspaceDir: z.ZodOptional<z.ZodString>;
+    /** Log verbosity level. */
+    logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    token: string;
+    contextLimit: number;
+    sessionContextLimit: number;
+    tokenBudget: number;
+    timeoutMs: number;
+    autoExtract: boolean;
+    logLevel: "debug" | "info" | "warn" | "error";
+    project?: string | undefined;
+    workspaceDir?: string | undefined;
+}, {
+    token: string;
+    url?: string | undefined;
+    project?: string | undefined;
+    contextLimit?: number | undefined;
+    sessionContextLimit?: number | undefined;
+    tokenBudget?: number | undefined;
+    timeoutMs?: number | undefined;
+    autoExtract?: boolean | undefined;
+    workspaceDir?: string | undefined;
+    logLevel?: "debug" | "info" | "warn" | "error" | undefined;
+}>;
+export type PluginConfig = z.infer<typeof PluginConfigSchema>;
+/**
+ * Parse and validate raw config from the OpenClaw plugin manifest.
+ * Returns a fully-populated config with defaults applied.
+ * Throws a ZodError if validation fails.
+ */
+export declare function parseConfig(raw: Record<string, unknown>): PluginConfig;
+/**
+ * Export the config schema as a JSON Schema object for OpenClaw's manifest
+ * `configSchema` field. This is a minimal static representation — the authoritative
+ * validation is done by `parseConfig()` at runtime.
+ */
+export declare function getJsonSchema(): Record<string, unknown>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,kBAAkB;IAC7B,6DAA6D;;IAU7D,gFAAgF;;IAGhF;;;OAGG;;IAGH,sDAAsD;;IAGtD,uDAAuD;;IAGvD;;;OAGG;;IAGH,gDAAgD;;IAGhD;;;OAGG;;IAGH;;;;;OAKG;;IAGH,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;EAE3B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBvD"}

package/dist/config.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginConfigSchema = void 0;
+exports.parseConfig = parseConfig;
+exports.getJsonSchema = getJsonSchema;
+const zod_1 = require("zod");
+// ---------------------------------------------------------------------------
+// Config schema
+// ---------------------------------------------------------------------------
+exports.PluginConfigSchema = zod_1.z.object({
+    /** Engram server base URL, e.g. "http://localhost:37777". */
+    url: zod_1.z
+        .string()
+        .url('url must be a valid HTTP URL')
+        .refine((u) => /^https?:\/\//i.test(u), { message: 'url must use http or https scheme' })
+        .default('http://localhost:37777'),
+    /** Bearer token for engram API authentication. Marked sensitive in UI hints. */
+    token: zod_1.z.string().min(1, 'token is required for engram API authentication'),
+    /**
+     * Project scope override. When set, all observations are stored under this
+     * project regardless of workspace identity.
+     */
+    project: zod_1.z.string().optional(),
+    /** Maximum observations to inject per prompt turn. */
+    contextLimit: zod_1.z.number().int().positive().default(10),
+    /** Maximum observations to inject at session start. */
+    sessionContextLimit: zod_1.z.number().int().positive().default(20),
+    /**
+     * Token budget for context injection. Approximately 4 chars per token.
+     * Observations are trimmed to fit within this budget.
+     */
+    tokenBudget: zod_1.z.number().int().positive().default(2000),
+    /** Per-request HTTP timeout in milliseconds. */
+    timeoutMs: zod_1.z.number().int().positive().default(5000),
+    /**
+     * Enable automatic observation extraction on compaction and session end.
+     * When false, only explicit tool calls store memories.
+     */
+    autoExtract: zod_1.z.boolean().default(true),
+    /**
+     * Workspace directory path for memory file discovery (MEMORY.md, memory/).
+     * Required for /migrate command when called from channel context (Telegram, Discord)
+     * where PluginCommandContext doesn't carry workspaceDir.
+     * Defaults to ~/.openclaw/workspace/ (default agent workspace).
+     */
+    workspaceDir: zod_1.z.string().optional(),
+    /** Log verbosity level. */
+    logLevel: zod_1.z.enum(['debug', 'info', 'warn', 'error']).default('warn'),
+});
+/**
+ * Parse and validate raw config from the OpenClaw plugin manifest.
+ * Returns a fully-populated config with defaults applied.
+ * Throws a ZodError if validation fails.
+ */
+function parseConfig(raw) {
+    return exports.PluginConfigSchema.parse(raw);
+}
+/**
+ * Export the config schema as a JSON Schema object for OpenClaw's manifest
+ * `configSchema` field. This is a minimal static representation — the authoritative
+ * validation is done by `parseConfig()` at runtime.
+ */
+function getJsonSchema() {
+    return {
+        type: 'object',
+        properties: {
+            url: { type: 'string', description: 'Engram server URL', default: 'http://localhost:37777' },
+            token: { type: 'string', description: 'Bearer token for API authentication', uiHints: { sensitive: true } },
+            project: { type: 'string', description: 'Project scope override' },
+            contextLimit: { type: 'number', description: 'Max observations per prompt', default: 10 },
+            sessionContextLimit: { type: 'number', description: 'Max observations at session start', default: 20 },
+            tokenBudget: { type: 'number', description: 'Token budget for context injection', default: 2000 },
+            timeoutMs: { type: 'number', description: 'Per-request timeout (ms)', default: 5000 },
+            autoExtract: { type: 'boolean', description: 'Auto-extract on compaction/session-end', default: true },
+            workspaceDir: { type: 'string', description: 'Workspace dir for /migrate (default: ~/.openclaw/workspace/)' },
+            logLevel: { type: 'string', enum: ['debug', 'info', 'warn', 'error'], default: 'warn' },
+        },
+        required: ['url', 'token'],
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context/formatter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Context formatter — converts engram observations into an XML context block
+ * suitable for injection into agent prompts.
+ *
+ * Faithfully ported from plugin/engram/hooks/user-prompt.js with TypeScript types.
+ */
+import type { Observation } from '../client.js';
+interface FormatterOptions {
+    /** Token budget (~4 chars per token). Default: 2000. */
+    tokenBudget?: number;
+}
+export interface FormatResult {
+    /** Formatted XML context string, or empty string if nothing to inject. */
+    context: string;
+    /** IDs of observations that made it into the context (after dedup + budget trim). */
+    injectedIds: number[];
+    /** Number of observations trimmed by token budget. */
+    trimmedCount: number;
+}
+/**
+ * Format an array of engram observations into an XML context block.
+ *
+ * Steps:
+ *   1. Filter credentials
+ *   2. Sort by similarity (descending)
+ *   3. Jaccard dedup (>0.8 title word overlap)
+ *   4. Group by type (decisions → patterns → changes → general)
+ *   5. Apply token budget
+ *   6. Re-group and render XML
+ */
+export declare function formatContext(observations: Observation[], options?: FormatterOptions): FormatResult;
+export {};
+//# sourceMappingURL=formatter.d.ts.map

package/dist/context/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/context/formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD,UAAU,gBAAgB;IACxB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoBD,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,WAAW,EAAE,EAC3B,OAAO,GAAE,gBAAqB,GAC7B,YAAY,CA6Cd"}

package/dist/context/formatter.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Context formatter — converts engram observations into an XML context block
+ * suitable for injection into agent prompts.
+ *
+ * Faithfully ported from plugin/engram/hooks/user-prompt.js with TypeScript types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatContext = formatContext;
+const SECTION_DEFS = [
+    { key: 'decisions', label: 'Decisions' },
+    { key: 'patterns', label: 'Patterns & Best Practices' },
+    { key: 'changes', label: 'Recent Changes' },
+    { key: 'general', label: 'General Context' },
+];
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Format an array of engram observations into an XML context block.
+ *
+ * Steps:
+ *   1. Filter credentials
+ *   2. Sort by similarity (descending)
+ *   3. Jaccard dedup (>0.8 title word overlap)
+ *   4. Group by type (decisions → patterns → changes → general)
+ *   5. Apply token budget
+ *   6. Re-group and render XML
+ */
+function formatContext(observations, options = {}) {
+    const tokenBudget = options.tokenBudget ?? 2000;
+    // 1. Filter credentials
+    const safe = observations.filter((obs) => asString(obs.type).toLowerCase() !== 'credential');
+    if (safe.length === 0) {
+        return { context: '', injectedIds: [], trimmedCount: 0 };
+    }
+    // 2. Sort by similarity (highest first)
+    const sorted = [...safe].sort((a, b) => (b.similarity ?? 0) - (a.similarity ?? 0));
+    // 3. Jaccard dedup
+    const deduped = jaccardDedup(sorted);
+    // 4. Group and priority-order
+    const grouped = groupByType(deduped);
+    const ordered = [
+        ...grouped.decisions,
+        ...grouped.patterns,
+        ...grouped.changes,
+        ...grouped.general,
+    ];
+    // 5. Token budget
+    const { budgeted, trimmedCount } = applyTokenBudget(ordered, tokenBudget);
+    // Collect injected IDs
+    const injectedIds = [];
+    for (const obs of budgeted) {
+        if (obs.id > 0)
+            injectedIds.push(obs.id);
+    }
+    if (budgeted.length === 0) {
+        return { context: '', injectedIds: [], trimmedCount };
+    }
+    // 6. Re-group and render
+    const finalGroups = groupByType(budgeted);
+    const context = renderXml(finalGroups);
+    return { context, injectedIds, trimmedCount };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function asString(value) {
+    return typeof value === 'string' ? value : '';
+}
+function escapeXml(value) {
+    return asString(value)
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+/**
+ * Deduplicate observations by title word overlap (Jaccard > 0.8 = near-duplicate).
+ * Preserves the higher-similarity observation (input is already sorted).
+ */
+function jaccardDedup(observations) {
+    const kept = [];
+    for (const obs of observations) {
+        const title = asString(obs.title).toLowerCase();
+        const words = new Set(title.split(/\s+/).filter((w) => w.length > 2));
+        let isDup = false;
+        for (const k of kept) {
+            const kTitle = asString(k.title).toLowerCase();
+            const kWords = new Set(kTitle.split(/\s+/).filter((w) => w.length > 2));
+            if (words.size === 0 || kWords.size === 0)
+                continue;
+            const intersection = [...words].filter((w) => kWords.has(w)).length;
+            const union = new Set([...words, ...kWords]).size;
+            if (union > 0 && intersection / union > 0.8) {
+                isDup = true;
+                break;
+            }
+        }
+        if (!isDup)
+            kept.push(obs);
+    }
+    return kept;
+}
+function groupByType(observations) {
+    const groups = {
+        decisions: [],
+        patterns: [],
+        changes: [],
+        general: [],
+    };
+    for (const obs of observations) {
+        const t = asString(obs.type).toLowerCase();
+        if (t === 'decision') {
+            groups.decisions.push(obs);
+        }
+        else if (t === 'feature' || t === 'discovery') {
+            groups.patterns.push(obs);
+        }
+        else if (t === 'change' || t === 'refactor') {
+            groups.changes.push(obs);
+        }
+        else {
+            groups.general.push(obs);
+        }
+    }
+    return groups;
+}
+function applyTokenBudget(observations, tokenBudget) {
+    let tokenCount = 0;
+    const budgeted = [];
+    for (const obs of observations) {
+        const title = asString(obs.title);
+        const narrative = asString(obs.narrative);
+        const facts = Array.isArray(obs.facts) ? obs.facts : [];
+        let chars = title.length + narrative.length + 50;
+        for (const f of facts) {
+            if (typeof f === 'string')
+                chars += f.length;
+        }
+        const tokens = Math.ceil(chars / 4);
+        if (tokenCount + tokens > tokenBudget)
+            continue;
+        tokenCount += tokens;
+        budgeted.push(obs);
+    }
+    return { budgeted, trimmedCount: observations.length - budgeted.length };
+}
+function renderXml(groups) {
+    let out = '<relevant-memory>\n';
+    out += '# Relevant Knowledge From Previous Sessions\n';
+    out +=
+        'IMPORTANT: Use this information to answer the question directly. Do NOT explore the codebase if the answer is here.\n\n';
+    let idx = 1;
+    for (const { key, label } of SECTION_DEFS) {
+        const sectionObs = groups[key];
+        if (sectionObs.length === 0)
+            continue;
+        out += `### ${label}\n`;
+        for (const obs of sectionObs) {
+            const title = escapeXml(obs.title);
+            const obsType = escapeXml(asString(obs.type).toUpperCase());
+            const score = typeof obs.similarity === 'number' ? obs.similarity.toFixed(2) : '';
+            const scoreTag = score ? ` [relevance: ${score}]` : '';
+            const scopeTag = typeof obs.scope === 'string' && obs.scope === 'global' ? ' [GLOBAL]' : '';
+            out += `## ${idx}. [${obsType}] ${title}${scopeTag}${scoreTag}\n`;
+            const facts = Array.isArray(obs.facts) ? obs.facts : [];
+            if (facts.length > 0) {
+                out += 'Key facts:\n';
+                let hasFacts = false;
+                for (const fact of facts) {
+                    if (typeof fact === 'string' && fact !== '') {
+                        hasFacts = true;
+                        out += `- ${escapeXml(fact)}\n`;
+                    }
+                }
+                if (hasFacts)
+                    out += '\n';
+            }
+            const narrative = escapeXml(obs.narrative);
+            if (narrative !== '')
+                out += `${narrative}\n\n`;
+            idx++;
+        }
+    }
+    out += '\n---\n';
+    out +=
+        'REMINDER: Before modifying any file mentioned above, call `engram_search(query="path")` to check for additional context. ';
+    out +=
+        'Before architectural decisions, call `engram_decisions(query="...")`. These engram tools are available and MUST be used.\n';
+    out += '</relevant-memory>\n';
+    return out;
+}
+//# sourceMappingURL=formatter.js.map

package/dist/context/formatter.js.map

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

package/dist/hooks/after-tool-call.d.ts

@@ -0,0 +1,19 @@
+/**
+ * after_tool_call hook — self-learning via tool event ingestion.
+ *
+ * Every tool call is sent to engram's /api/events/ingest endpoint so that
+ * the server can extract patterns and update its observation store over time.
+ * This is fire-and-forget: the hook never blocks on a response.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { AfterToolCallEvent } from '../types/openclaw.js';
+/**
+ * Handle the after_tool_call hook.
+ *
+ * @param event  - The after_tool_call event from OpenClaw.
+ * @param client - Shared engram REST client.
+ * @param config - Resolved plugin config.
+ */
+export declare function handleAfterToolCall(event: AfterToolCallEvent, client: EngramRestClient, config: PluginConfig): void;
+//# sourceMappingURL=after-tool-call.d.ts.map

package/dist/hooks/after-tool-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"after-tool-call.d.ts","sourceRoot":"","sources":["../../src/hooks/after-tool-call.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAK/D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,GACnB,IAAI,CA0BN"}

package/dist/hooks/after-tool-call.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * after_tool_call hook — self-learning via tool event ingestion.
+ *
+ * Every tool call is sent to engram's /api/events/ingest endpoint so that
+ * the server can extract patterns and update its observation store over time.
+ * This is fire-and-forget: the hook never blocks on a response.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAfterToolCall = handleAfterToolCall;
+const identity_js_1 = require("../identity.js");
+const TOOL_INPUT_MAX_CHARS = 500;
+const TOOL_RESULT_MAX_CHARS = 500;
+/**
+ * Handle the after_tool_call hook.
+ *
+ * @param event  - The after_tool_call event from OpenClaw.
+ * @param client - Shared engram REST client.
+ * @param config - Resolved plugin config.
+ */
+function handleAfterToolCall(event, client, config) {
+    if (!client.isAvailable())
+        return;
+    if (!config.autoExtract)
+        return;
+    const agentId = event.agentId ?? '';
+    const identity = (0, identity_js_1.resolveIdentity)(agentId, event.workspaceDir);
+    const project = config.project ?? identity.projectId;
+    let toolInput;
+    let toolResult;
+    try {
+        toolInput = truncate(JSON.stringify(event.toolInput ?? ''), TOOL_INPUT_MAX_CHARS);
+        toolResult = truncate(JSON.stringify(event.toolResult ?? ''), TOOL_RESULT_MAX_CHARS);
+    }
+    catch {
+        toolInput = '[unserializable]';
+        toolResult = '[unserializable]';
+    }
+    // Fire-and-forget — do not await
+    void client.ingestEvent({
+        session_id: agentId,
+        project,
+        tool_name: event.toolName ?? 'unknown',
+        tool_input: toolInput,
+        tool_result: toolResult,
+    }).catch(() => { });
+}
+function truncate(value, maxChars) {
+    if (value.length <= maxChars)
+        return value;
+    return value.slice(0, maxChars);
+}
+//# sourceMappingURL=after-tool-call.js.map

package/dist/hooks/after-tool-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"after-tool-call.js","sourceRoot":"","sources":["../../src/hooks/after-tool-call.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAiBH,kDA8BC;AA3CD,gDAAiD;AAGjD,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACjC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,KAAyB,EACzB,MAAwB,EACxB,MAAoB;IAEpB,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;QAAE,OAAO;IAClC,IAAI,CAAC,MAAM,CAAC,WAAW;QAAE,OAAO;IAEhC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAA,6BAAe,EAAC,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC;IAErD,IAAI,SAAiB,CAAC;IACtB,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAClF,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,qBAAqB,CAAC,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,SAAS,GAAG,kBAAkB,CAAC;QAC/B,UAAU,GAAG,kBAAkB,CAAC;IAClC,CAAC;IAED,iCAAiC;IACjC,KAAK,MAAM,CAAC,WAAW,CAAC;QACtB,UAAU,EAAE,OAAO;QACnB,OAAO;QACP,SAAS,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS;QACtC,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,UAAU;KACxB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAmC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,QAAgB;IAC/C,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/hooks/before-compaction.d.ts

@@ -0,0 +1,19 @@
+/**
+ * before_compaction hook — transcript backfill before context window compaction.
+ *
+ * Serializes the recent conversation messages and submits them to engram's
+ * /api/backfill/session endpoint for server-side observation extraction.
+ * This is fire-and-forget: the hook must never block compaction.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { BeforeCompactionEvent, PluginLogger } from '../types/openclaw.js';
+/**
+ * Handle the before_compaction hook.
+ *
+ * @param event  - The before_compaction event from OpenClaw.
+ * @param client - Shared engram REST client.
+ * @param config - Resolved plugin config.
+ */
+export declare function handleBeforeCompaction(event: BeforeCompactionEvent, client: EngramRestClient, config: PluginConfig, logger?: PluginLogger): void;
+//# sourceMappingURL=before-compaction.d.ts.map

package/dist/hooks/before-compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"before-compaction.d.ts","sourceRoot":"","sources":["../../src/hooks/before-compaction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,qBAAqB,EAAuB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOrG;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,YAAY,GACpB,IAAI,CA+BN"}

package/dist/hooks/before-compaction.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * before_compaction hook — transcript backfill before context window compaction.
+ *
+ * Serializes the recent conversation messages and submits them to engram's
+ * /api/backfill/session endpoint for server-side observation extraction.
+ * This is fire-and-forget: the hook must never block compaction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleBeforeCompaction = handleBeforeCompaction;
+const identity_js_1 = require("../identity.js");
+/** Maximum recent messages to include in the backfill payload. */
+const MAX_MESSAGES = 20;
+/** Soft character limit for the content field (server hard limit: 10,000). */
+const CONTENT_MAX_CHARS = 6000;
+/**
+ * Handle the before_compaction hook.
+ *
+ * @param event  - The before_compaction event from OpenClaw.
+ * @param client - Shared engram REST client.
+ * @param config - Resolved plugin config.
+ */
+function handleBeforeCompaction(event, client, config, logger) {
+    try {
+        if (!client.isAvailable())
+            return;
+        if (!config.autoExtract)
+            return;
+        const agentId = event.agentId ?? '';
+        const identity = (0, identity_js_1.resolveIdentity)(agentId, event.workspaceDir);
+        const project = config.project ?? identity.projectId;
+        const messages = Array.isArray(event.messages) ? event.messages : [];
+        const recent = messages.slice(-MAX_MESSAGES);
+        const content = serializeMessages(recent);
+        if (!content)
+            return;
+        const truncated = content.length > CONTENT_MAX_CHARS
+            ? content.slice(0, CONTENT_MAX_CHARS)
+            : content;
+        // Fire-and-forget — do not await
+        void client.backfillSession({
+            session_id: agentId,
+            project,
+            content: truncated,
+        });
+        (logger ?? console).warn(`[engram] before-compaction: submitting ${recent.length} messages for backfill (project ${project})`);
+    }
+    catch (err) {
+        (logger ?? console).error('[engram] hook error:', err);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function serializeMessages(messages) {
+    return messages
+        .map((m) => `[${m.role}]: ${m.content}`)
+        .join('\n\n');
+}
+//# sourceMappingURL=before-compaction.js.map

package/dist/hooks/before-compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"before-compaction.js","sourceRoot":"","sources":["../../src/hooks/before-compaction.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAmBH,wDAoCC;AAnDD,gDAAiD;AAGjD,kEAAkE;AAClE,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,8EAA8E;AAC9E,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B;;;;;;GAMG;AACH,SAAgB,sBAAsB,CACpC,KAA4B,EAC5B,MAAwB,EACxB,MAAoB,EACpB,MAAqB;IAErB,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;YAAE,OAAO;QAClC,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO;QAEhC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAA,6BAAe,EAAC,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC;QAErD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,iBAAiB;YAClD,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC;YACrC,CAAC,CAAC,OAAO,CAAC;QAEZ,iCAAiC;QACjC,KAAK,MAAM,CAAC,eAAe,CAAC;YAC1B,UAAU,EAAE,OAAO;YACnB,OAAO;YACP,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;QAEH,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,CACtB,0CAA0C,MAAM,CAAC,MAAM,mCAAmC,OAAO,GAAG,CACrG,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,iBAAiB,CAAC,QAA+B;IACxD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;SACvC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/dist/hooks/before-prompt-build.d.ts

@@ -0,0 +1,20 @@
+/**
+ * before_prompt_build hook — per-turn dynamic context search.
+ *
+ * Queries engram with the current user prompt and injects the top matching
+ * observations as prependContext so they appear immediately before the user's
+ * message in each turn.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { BeforePromptBuildEvent, PromptBuildResult, PluginLogger } from '../types/openclaw.js';
+/**
+ * Handle the before_prompt_build hook.
+ *
+ * @param event  - The before_prompt_build event from OpenClaw.
+ * @param client - Shared engram REST client.
+ * @param config - Resolved plugin config.
+ * @returns      Context to prepend, or void if nothing to inject.
+ */
+export declare function handleBeforePromptBuild(event: BeforePromptBuildEvent, client: EngramRestClient, config: PluginConfig, logger?: PluginLogger): Promise<PromptBuildResult | void>;
+//# sourceMappingURL=before-prompt-build.d.ts.map

package/dist/hooks/before-prompt-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"before-prompt-build.d.ts","sourceRoot":"","sources":["../../src/hooks/before-prompt-build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAgEnC"}