openclaw-engram 0.2.0

package/dist/hooks/before-prompt-build.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleBeforePromptBuild = handleBeforePromptBuild;
+const identity_js_1 = require("../identity.js");
+const formatter_js_1 = require("../context/formatter.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.
+ */
+async function handleBeforePromptBuild(event, client, config, logger) {
+    try {
+        if (!client.isAvailable())
+            return;
+        if (!event.prompt || event.prompt.trim() === '')
+            return;
+        const agentId = event.agentId ?? '';
+        const identity = (0, identity_js_1.resolveIdentity)(agentId, event.workspaceDir);
+        const project = config.project ?? identity.projectId;
+        let response;
+        try {
+            response = await client.searchContext({
+                project,
+                query: event.prompt,
+                cwd: event.workspaceDir,
+                agent_id: agentId,
+            });
+        }
+        catch (err) {
+            (logger ?? console).warn('[engram] before-prompt-build: searchContext failed', err);
+            return;
+        }
+        if (!response || !Array.isArray(response.observations) || response.observations.length === 0) {
+            return;
+        }
+        const { context, injectedIds, trimmedCount } = (0, formatter_js_1.formatContext)(response.observations, { tokenBudget: config.tokenBudget });
+        if (trimmedCount > 0) {
+            (logger ?? console).warn(`[engram] before-prompt-build: trimmed ${trimmedCount} observations to fit token budget`);
+        }
+        if (!context)
+            return;
+        (logger ?? console).warn(`[engram] before-prompt-build: injecting ${injectedIds.length} observations for project ${project}`);
+        // Mark injected observations (fire-and-forget)
+        if (injectedIds.length > 0) {
+            try {
+                const sessionResp = await client.initSession({
+                    claudeSessionId: event.sessionId ?? agentId,
+                    project,
+                    prompt: event.prompt,
+                });
+                if (sessionResp && !sessionResp.skipped && sessionResp.sessionDbId) {
+                    void client.markInjected(sessionResp.sessionDbId, injectedIds)
+                        .catch(() => { });
+                }
+            }
+            catch {
+                // Non-critical — context was already injected
+            }
+        }
+        return { prependContext: context };
+    }
+    catch (err) {
+        (logger ?? console).error('[engram] hook error:', err);
+    }
+}
+//# sourceMappingURL=before-prompt-build.js.map

package/dist/hooks/before-prompt-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"before-prompt-build.js","sourceRoot":"","sources":["../../src/hooks/before-prompt-build.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAoBH,0DAqEC;AArFD,gDAAiD;AACjD,0DAAwD;AAOxD;;;;;;;GAOG;AACI,KAAK,UAAU,uBAAuB,CAC3C,KAA6B,EAC7B,MAAwB,EACxB,MAAoB,EACpB,MAAqB;IAErB,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;YAAE,OAAO;QAClC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO;QAExD,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,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;gBACpC,OAAO;gBACP,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,GAAG,EAAE,KAAK,CAAC,YAAY;gBACvB,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,oDAAoD,EAAE,GAAG,CAAC,CAAC;YACpF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7F,OAAO;QACT,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,IAAA,4BAAa,EAC1D,QAAQ,CAAC,YAAY,EACrB,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CACpC,CAAC;QAEF,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,CACtB,yCAAyC,YAAY,mCAAmC,CACzF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,CACtB,2CAA2C,WAAW,CAAC,MAAM,6BAA6B,OAAO,EAAE,CACpG,CAAC;QAEF,+CAA+C;QAC/C,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;oBAC3C,eAAe,EAAE,KAAK,CAAC,SAAS,IAAI,OAAO;oBAC3C,OAAO;oBACP,MAAM,EAAE,KAAK,CAAC,MAAM;iBACrB,CAAC,CAAC;gBACH,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;oBACnE,KAAK,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC;yBAC3D,KAAK,CAAC,GAAG,EAAE,GAAmC,CAAC,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;QACH,CAAC;QAED,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * session_end hook — final backfill and session statistics.
+ *
+ * Submits any remaining conversation content to engram for extraction.
+ * This is the last chance to persist observations from the session.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { SessionEndEvent, PluginLogger } from '../types/openclaw.js';
+/**
+ * Handle the session_end hook.
+ *
+ * @param event  - The session_end event from OpenClaw.
+ * @param client - Shared engram REST client.
+ * @param config - Resolved plugin config.
+ */
+export declare function handleSessionEnd(event: SessionEndEvent, client: EngramRestClient, config: PluginConfig, logger?: PluginLogger): void;
+//# sourceMappingURL=session-end.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-end.d.ts","sourceRoot":"","sources":["../../src/hooks/session-end.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAuB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAK/F;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,YAAY,GACpB,IAAI,CAwCN"}

package/dist/hooks/session-end.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * session_end hook — final backfill and session statistics.
+ *
+ * Submits any remaining conversation content to engram for extraction.
+ * This is the last chance to persist observations from the session.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSessionEnd = handleSessionEnd;
+const identity_js_1 = require("../identity.js");
+const MAX_MESSAGES = 20;
+const CONTENT_MAX_CHARS = 6000;
+/**
+ * Handle the session_end hook.
+ *
+ * @param event  - The session_end event from OpenClaw.
+ * @param client - Shared engram REST client.
+ * @param config - Resolved plugin config.
+ */
+function handleSessionEnd(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 : [];
+        if (messages.length === 0)
+            return;
+        const recent = messages.slice(-MAX_MESSAGES);
+        const content = recent
+            .map((m) => `[${m.role}]: ${m.content}`)
+            .join('\n\n');
+        if (!content)
+            return;
+        const truncated = content.length > CONTENT_MAX_CHARS
+            ? content.slice(0, CONTENT_MAX_CHARS)
+            : content;
+        const sessionId = event.sessionId ?? '';
+        if (!sessionId)
+            return;
+        // Fire-and-forget — do not await
+        void client.backfillSession({
+            session_id: sessionId,
+            project,
+            content: truncated,
+        });
+        (logger ?? console).warn(`[engram] session-end: submitted ${recent.length} messages for backfill` +
+            ` (project ${project}, reason: ${event.reason ?? 'unknown'})`);
+    }
+    catch (err) {
+        (logger ?? console).error('[engram] hook error:', err);
+    }
+}
+//# sourceMappingURL=session-end.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-end.js","sourceRoot":"","sources":["../../src/hooks/session-end.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAiBH,4CA6CC;AA1DD,gDAAiD;AAGjD,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,KAAsB,EACtB,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,GAA0B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAElC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM;aACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;aACvC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,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,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,iCAAiC;QACjC,KAAK,MAAM,CAAC,eAAe,CAAC;YAC1B,UAAU,EAAE,SAAS;YACrB,OAAO;YACP,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;QAEH,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,CACtB,mCAAmC,MAAM,CAAC,MAAM,wBAAwB;YACtE,aAAa,OAAO,aAAa,KAAK,CAAC,MAAM,IAAI,SAAS,GAAG,CAChE,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"}

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

@@ -0,0 +1,17 @@
+/**
+ * session_start hook — fetches static session context from engram and injects
+ * it as appendSystemContext so it is available for the entire session.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { SessionStartEvent, SessionStartResult, PluginLogger } from '../types/openclaw.js';
+/**
+ * Handle the session_start hook.
+ *
+ * @param event  - The session_start event from OpenClaw.
+ * @param client - Shared engram REST client.
+ * @param config - Resolved plugin config.
+ * @returns      Append-system-context result or void.
+ */
+export declare function handleSessionStart(event: SessionStartEvent, client: EngramRestClient, config: PluginConfig, logger?: PluginLogger): Promise<SessionStartResult | void>;
+//# sourceMappingURL=session-start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAyDpC"}

package/dist/hooks/session-start.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * session_start hook — fetches static session context from engram and injects
+ * it as appendSystemContext so it is available for the entire session.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSessionStart = handleSessionStart;
+const identity_js_1 = require("../identity.js");
+const formatter_js_1 = require("../context/formatter.js");
+/**
+ * Handle the session_start hook.
+ *
+ * @param event  - The session_start event from OpenClaw.
+ * @param client - Shared engram REST client.
+ * @param config - Resolved plugin config.
+ * @returns      Append-system-context result or void.
+ */
+async function handleSessionStart(event, client, config, logger) {
+    try {
+        if (!client.isAvailable())
+            return;
+        const agentId = event.agentId ?? '';
+        const identity = (0, identity_js_1.resolveIdentity)(agentId, event.workspaceDir);
+        const project = config.project ?? identity.projectId;
+        const response = await client.getContextInject(agentId, event.workspaceDir);
+        if (!response || !Array.isArray(response.observations) || response.observations.length === 0) {
+            return;
+        }
+        const { context, injectedIds, trimmedCount } = (0, formatter_js_1.formatContext)(response.observations, { tokenBudget: config.tokenBudget });
+        if (trimmedCount > 0) {
+            (logger ?? console).warn(`[engram] session-start: trimmed ${trimmedCount} observations to fit token budget`);
+        }
+        if (!context)
+            return;
+        // Mark observations as injected (fire-and-forget)
+        if (injectedIds.length > 0 && response.sessionId) {
+            void client.markInjected(response.sessionId, injectedIds);
+        }
+        // Initialize session tracking (fire-and-forget)
+        const claudeSessionId = event.sessionId ?? agentId;
+        if (!claudeSessionId) {
+            (logger ?? console).warn('[engram] session-start: no sessionId or agentId available — skipping session init');
+        }
+        else {
+            void client.initSession({
+                claudeSessionId,
+                project,
+                prompt: event.initialPrompt,
+            });
+        }
+        (logger ?? console).warn(`[engram] session-start: injected ${injectedIds.length} observations for project ${project}`);
+        // Build static instructions + dynamic session context
+        const staticInstructions = buildStaticInstructions(project);
+        const fullContext = staticInstructions + '\n\n' + context;
+        return { appendSystemContext: fullContext };
+    }
+    catch (err) {
+        (logger ?? console).error('[engram] hook error:', err);
+    }
+}
+/**
+ * Build cacheable static instructions injected once per session.
+ * These describe available engram capabilities to the agent.
+ */
+function buildStaticInstructions(project) {
+    return [
+        '# Engram Persistent Memory',
+        '',
+        'You have access to persistent memory via engram. Available tools:',
+        '- `engram_search` — search prior observations, decisions, and patterns',
+        '- `engram_remember` — store new observations for future sessions',
+        '- `engram_decisions` — query architectural decisions',
+        '',
+        `Memory is scoped to project "${project}". Use \`engram_remember\` to store important insights, decisions, and discoveries.`,
+    ].join('\n');
+}
+//# sourceMappingURL=session-start.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAoBH,gDA8DC;AA9ED,gDAAiD;AACjD,0DAAwD;AAOxD;;;;;;;GAOG;AACI,KAAK,UAAU,kBAAkB,CACtC,KAAwB,EACxB,MAAwB,EACxB,MAAoB,EACpB,MAAqB;IAErB,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;YAAE,OAAO;QAElC,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,MAAM,MAAM,CAAC,gBAAgB,CAC5C,OAAO,EACP,KAAK,CAAC,YAAY,CACnB,CAAC;QAEF,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7F,OAAO;QACT,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,IAAA,4BAAa,EAC1D,QAAQ,CAAC,YAAY,EACrB,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CACpC,CAAC;QAEF,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,mCAAmC,YAAY,mCAAmC,CAAC,CAAC;QAC/G,CAAC;QAED,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,kDAAkD;QAClD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACjD,KAAK,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAC5D,CAAC;QAED,gDAAgD;QAChD,MAAM,eAAe,GAAG,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC;QACnD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAC;QAChH,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,WAAW,CAAC;gBACtB,eAAe;gBACf,OAAO;gBACP,MAAM,EAAE,KAAK,CAAC,aAAa;aAC5B,CAAC,CAAC;QACL,CAAC;QAED,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,CACtB,oCAAoC,WAAW,CAAC,MAAM,6BAA6B,OAAO,EAAE,CAC7F,CAAC;QAEF,sDAAsD;QACtD,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,WAAW,GAAG,kBAAkB,GAAG,MAAM,GAAG,OAAO,CAAC;QAE1D,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC;IAC9C,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;;;GAGG;AACH,SAAS,uBAAuB,CAAC,OAAe;IAC9C,OAAO;QACL,4BAA4B;QAC5B,EAAE;QACF,mEAAmE;QACnE,wEAAwE;QACxE,kEAAkE;QAClE,sDAAsD;QACtD,EAAE;QACF,gCAAgC,OAAO,qFAAqF;KAC7H,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/identity.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Project identity resolution.
+ *
+ * Priority order:
+ *   1. agentId (always available from OpenClaw, stable per session)
+ *   2. Git remote origin URL + relative path (cross-platform, cross-OS-path stable)
+ *   3. Absolute workspace path hash (fallback for non-git directories)
+ *
+ * The agentId is the PRIMARY scope for OpenClaw — every agent session has a unique
+ * stable identifier. Git-based ID is computed when workspaceDir is available so that
+ * observations can be shared across agents working in the same repository.
+ */
+export interface ProjectIdentity {
+    /** Primary project identifier used for engram scoping. */
+    projectId: string;
+    /** The agentId from OpenClaw (always set). */
+    agentId: string;
+    /** Git remote URL if the workspace is a git repo with a remote. */
+    gitRemote?: string;
+    /** Relative path within the git repo, if applicable. */
+    relativePath?: string;
+}
+/**
+ * Compute the canonical project ID for the given working directory.
+ * Prefers git-remote-based ID; falls back to path-based ID.
+ */
+export declare function projectIDFromWorkspace(workspaceDir: string): string;
+/**
+ * Resolve the full project identity for an agent session.
+ *
+ * @param agentId    - The unique agent session ID from OpenClaw (primary scope).
+ * @param workspaceDir - Optional workspace directory for git-based ID resolution.
+ * @returns          A ProjectIdentity with the resolved projectId.
+ */
+export declare function resolveIdentity(agentId: string, workspaceDir?: string): ProjectIdentity;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA6DD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGnE;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,eAAe,CAoBjB"}

package/dist/identity.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Project identity resolution.
+ *
+ * Priority order:
+ *   1. agentId (always available from OpenClaw, stable per session)
+ *   2. Git remote origin URL + relative path (cross-platform, cross-OS-path stable)
+ *   3. Absolute workspace path hash (fallback for non-git directories)
+ *
+ * The agentId is the PRIMARY scope for OpenClaw — every agent session has a unique
+ * stable identifier. Git-based ID is computed when workspaceDir is available so that
+ * observations can be shared across agents working in the same repository.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectIDFromWorkspace = projectIDFromWorkspace;
+exports.resolveIdentity = resolveIdentity;
+const node_crypto_1 = require("node:crypto");
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = require("node:path");
+// Module-level memoization cache — keyed by resolved cwd path
+const gitRemoteCache = new Map();
+/**
+ * Compute a stable project ID from the git remote origin URL and relative path.
+ * Returns null if the directory is not a git repository or has no remote.
+ */
+function getGitRemoteID(cwd) {
+    const cacheKey = (0, node_path_1.resolve)(cwd);
+    if (gitRemoteCache.has(cacheKey))
+        return gitRemoteCache.get(cacheKey);
+    try {
+        const opts = {
+            cwd,
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 3000,
+        };
+        const remoteURL = (0, node_child_process_1.execSync)('git remote get-url origin', opts).toString().trim();
+        if (!remoteURL) {
+            gitRemoteCache.set(cacheKey, null);
+            return null;
+        }
+        const relativePath = (0, node_child_process_1.execSync)('git rev-parse --show-prefix', opts).toString().trim();
+        const key = remoteURL + '/' + relativePath;
+        const hash = (0, node_crypto_1.createHash)('sha256').update(key).digest('hex');
+        // Derive repo name from remote URL so projectId is stable across checkouts
+        const repoName = remoteURL.replace(/\/$/, '').split('/').pop()?.replace(/\.git$/, '') || 'repo';
+        const result = {
+            projectId: repoName + '_' + hash.slice(0, 8),
+            gitRemote: remoteURL,
+            relativePath,
+        };
+        gitRemoteCache.set(cacheKey, result);
+        return result;
+    }
+    catch {
+        gitRemoteCache.set(cacheKey, null);
+        return null;
+    }
+}
+/**
+ * Legacy path-based project ID (6-char hash of absolute path).
+ * Used as a fallback for directories without a git remote.
+ */
+function legacyProjectID(cwd) {
+    const resolvedPath = (0, node_path_1.resolve)(cwd);
+    const dirName = (0, node_path_1.basename)(resolvedPath);
+    const hash = (0, node_crypto_1.createHash)('sha256').update(resolvedPath).digest('hex');
+    return dirName + '_' + hash.slice(0, 6);
+}
+/**
+ * Compute the canonical project ID for the given working directory.
+ * Prefers git-remote-based ID; falls back to path-based ID.
+ */
+function projectIDFromWorkspace(workspaceDir) {
+    const gitResult = getGitRemoteID(workspaceDir);
+    return gitResult ? gitResult.projectId : legacyProjectID(workspaceDir);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the full project identity for an agent session.
+ *
+ * @param agentId    - The unique agent session ID from OpenClaw (primary scope).
+ * @param workspaceDir - Optional workspace directory for git-based ID resolution.
+ * @returns          A ProjectIdentity with the resolved projectId.
+ */
+function resolveIdentity(agentId, workspaceDir) {
+    // agentId-first: when no workspace directory is available, use agentId as scope
+    if (!workspaceDir) {
+        return { projectId: agentId, agentId };
+    }
+    const gitResult = getGitRemoteID(workspaceDir);
+    if (gitResult) {
+        return {
+            projectId: gitResult.projectId,
+            agentId,
+            gitRemote: gitResult.gitRemote,
+            relativePath: gitResult.relativePath,
+        };
+    }
+    return {
+        projectId: legacyProjectID(workspaceDir),
+        agentId,
+    };
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * OpenClaw Engram Plugin
+ *
+ * Connects OpenClaw agents to engram persistent memory via REST API.
+ * Provides:
+ *   - Session-level static context injection (appendSystemContext)
+ *   - Per-turn dynamic context search (prependContext)
+ *   - Automatic self-learning via tool event ingestion
+ *   - Transcript backfill on compaction / session end
+ *   - Agent tools: engram_search, engram_remember, engram_decisions,
+ *                  memory_search, memory_store, memory_forget, memory_get,
+ *                  memory_migrate
+ *   - Slash commands: /memory, /remember, /migrate
+ *   - CLI: openclaw memory status|search|store|migrate
+ */
+import type { OpenClawPluginDefinition } from './types/openclaw.js';
+declare const plugin: OpenClawPluginDefinition;
+export default plugin;
+export { EngramRestClient } from './client.js';
+export { parseConfig, getJsonSchema } from './config.js';
+export { resolveIdentity, projectIDFromWorkspace } from './identity.js';
+export { formatContext } from './context/formatter.js';
+export { AvailabilityTracker } from './availability.js';
+//# 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":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,wBAAwB,EAIzB,MAAM,qBAAqB,CAAC;AA4B7B,QAAA,MAAM,MAAM,EAAE,wBAsLb,CAAC;AAEF,eAAe,MAAM,CAAC;AAGtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}