openclaw-engram 2.0.6 → 2.0.11

package/dist/tools/engram-find-by-file.d.ts

@@ -0,0 +1,11 @@
+/**
+ * engram_find_by_file — find observations related to a specific file.
+ *
+ * WHEN TO USE: BEFORE modifying any file. Returns what engram knows about it —
+ * past bugs, decisions, patterns, and important context that should inform your changes.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { AnyAgentTool, OpenClawPluginToolContext } from '../types/openclaw.js';
+export declare function createEngramFindByFileTool(ctx: OpenClawPluginToolContext, client: EngramRestClient, config: PluginConfig): AnyAgentTool;
+//# sourceMappingURL=engram-find-by-file.d.ts.map

package/dist/tools/engram-find-by-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-find-by-file.d.ts","sourceRoot":"","sources":["../../src/tools/engram-find-by-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAYpF,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,yBAAyB,EAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,GACnB,YAAY,CAmCd"}

package/dist/tools/engram-find-by-file.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * engram_find_by_file — find observations related to a specific file.
+ *
+ * WHEN TO USE: BEFORE modifying any file. Returns what engram knows about it —
+ * past bugs, decisions, patterns, and important context that should inform your changes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEngramFindByFileTool = createEngramFindByFileTool;
+const zod_1 = require("zod");
+const typebox_1 = require("@sinclair/typebox");
+const identity_js_1 = require("../identity.js");
+const FindByFileParamsSchema = zod_1.z.object({
+    file: zod_1.z.string().min(1),
+    limit: zod_1.z.number().int().min(1).max(20).optional().default(5),
+});
+const findByFileParameters = typebox_1.Type.Object({
+    file: typebox_1.Type.String({ description: 'File path to look up (absolute or relative)' }),
+    limit: typebox_1.Type.Optional(typebox_1.Type.Number({ description: 'Max observations to return (default: 5)' })),
+});
+function createEngramFindByFileTool(ctx, client, config) {
+    return {
+        name: 'engram_find_by_file',
+        description: 'Find observations related to a specific file. ' +
+            'Call BEFORE modifying any file to check what engram knows about it — ' +
+            'past bugs, decisions, patterns, and context that should inform your changes.',
+        parameters: findByFileParameters,
+        async execute(_toolCallId, params) {
+            const parsed = FindByFileParamsSchema.safeParse(params);
+            if (!parsed.success) {
+                return `Invalid parameters: ${parsed.error.message}`;
+            }
+            if (!client.isAvailable()) {
+                return 'engram is currently unreachable — file context unavailable';
+            }
+            const identity = (0, identity_js_1.resolveIdentity)(ctx.agentId ?? '', ctx.workspaceDir);
+            const project = config.project ?? identity.projectId;
+            const observations = await client.getFileContext(parsed.data.file, project, parsed.data.limit);
+            if (observations.length === 0) {
+                return `No observations found for file: ${parsed.data.file}`;
+            }
+            return formatFileContext(parsed.data.file, observations);
+        },
+    };
+}
+function formatFileContext(file, observations) {
+    let out = `# Known Context for ${file}\n\n`;
+    observations.forEach((obs, i) => {
+        const typeLabel = (obs.type ?? 'observation').toUpperCase();
+        out += `## ${i + 1}. [${typeLabel}] ${obs.title ?? 'Untitled'}\n`;
+        if (obs.narrative)
+            out += `${obs.narrative}\n`;
+        out += '\n';
+    });
+    return out.trimEnd();
+}
+//# sourceMappingURL=engram-find-by-file.js.map

package/dist/tools/engram-find-by-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-find-by-file.js","sourceRoot":"","sources":["../../src/tools/engram-find-by-file.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAmBH,gEAuCC;AAxDD,6BAAwB;AACxB,+CAAyC;AAGzC,gDAAiD;AAGjD,MAAM,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAC7D,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,cAAI,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,cAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6CAA6C,EAAE,CAAC;IACjF,KAAK,EAAE,cAAI,CAAC,QAAQ,CAAC,cAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC,CAAC;CAC9F,CAAC,CAAC;AAEH,SAAgB,0BAA0B,CACxC,GAA8B,EAC9B,MAAwB,EACxB,MAAoB;IAEpB,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,gDAAgD;YAChD,uEAAuE;YACvE,8EAA8E;QAChF,UAAU,EAAE,oBAAoB;QAEhC,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAA+B;YAChE,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACvD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,OAAO,4DAA4D,CAAC;YACtE,CAAC;YAED,MAAM,QAAQ,GAAG,IAAA,6BAAe,EAAC,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;YACtE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC;YAErD,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,cAAc,CAC9C,MAAM,CAAC,IAAI,CAAC,IAAI,EAChB,OAAO,EACP,MAAM,CAAC,IAAI,CAAC,KAAK,CAClB,CAAC;YAEF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,mCAAmC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/D,CAAC;YAED,OAAO,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,YAA2B;IAClE,IAAI,GAAG,GAAG,uBAAuB,IAAI,MAAM,CAAC;IAC5C,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC9B,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5D,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,SAAS,KAAK,GAAG,CAAC,KAAK,IAAI,UAAU,IAAI,CAAC;QAClE,IAAI,GAAG,CAAC,SAAS;YAAE,GAAG,IAAI,GAAG,GAAG,CAAC,SAAS,IAAI,CAAC;QAC/C,GAAG,IAAI,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC;AACvB,CAAC"}

package/dist/tools/engram-outcome.d.ts

@@ -0,0 +1,11 @@
+/**
+ * engram_outcome — record session outcome for closed-loop learning.
+ *
+ * WHEN TO USE: At the end of a session or task. Records whether the goal was achieved,
+ * enabling engram to learn which observations lead to successful outcomes.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { AnyAgentTool, OpenClawPluginToolContext } from '../types/openclaw.js';
+export declare function createEngramOutcomeTool(ctx: OpenClawPluginToolContext, client: EngramRestClient, config: PluginConfig): AnyAgentTool;
+//# sourceMappingURL=engram-outcome.d.ts.map

package/dist/tools/engram-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-outcome.d.ts","sourceRoot":"","sources":["../../src/tools/engram-outcome.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAepF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,yBAAyB,EAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,GACnB,YAAY,CAoCd"}

package/dist/tools/engram-outcome.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * engram_outcome — record session outcome for closed-loop learning.
+ *
+ * WHEN TO USE: At the end of a session or task. Records whether the goal was achieved,
+ * enabling engram to learn which observations lead to successful outcomes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEngramOutcomeTool = createEngramOutcomeTool;
+const zod_1 = require("zod");
+const typebox_1 = require("@sinclair/typebox");
+const OutcomeParamsSchema = zod_1.z.object({
+    outcome: zod_1.z.enum(['success', 'partial', 'failure', 'abandoned']),
+    reason: zod_1.z.string().optional(),
+});
+const outcomeParameters = typebox_1.Type.Object({
+    outcome: typebox_1.Type.String({
+        description: 'Session outcome: success, partial, failure, or abandoned',
+        enum: ['success', 'partial', 'failure', 'abandoned'],
+    }),
+    reason: typebox_1.Type.Optional(typebox_1.Type.String({ description: 'Brief explanation of the outcome' })),
+});
+function createEngramOutcomeTool(ctx, client, config) {
+    return {
+        name: 'engram_outcome',
+        description: 'Record the outcome of the current session (success/partial/failure/abandoned). ' +
+            'Call at the END of a task or session. Enables closed-loop learning — engram uses outcomes ' +
+            'to learn which observations lead to better results.',
+        parameters: outcomeParameters,
+        async execute(_toolCallId, params) {
+            const parsed = OutcomeParamsSchema.safeParse(params);
+            if (!parsed.success) {
+                return `Invalid parameters: ${parsed.error.message}`;
+            }
+            if (!client.isAvailable()) {
+                return 'engram is currently unreachable — outcome recording unavailable';
+            }
+            // Server endpoint accepts Claude session ID string directly
+            const claudeSessionId = ctx.sessionId ?? ctx.sessionKey ?? '';
+            if (!claudeSessionId) {
+                return 'Cannot record outcome — no session ID available';
+            }
+            const success = await client.setSessionOutcome(claudeSessionId, parsed.data.outcome, parsed.data.reason);
+            return success
+                ? `Session outcome recorded: ${parsed.data.outcome}${parsed.data.reason ? ` (${parsed.data.reason})` : ''}`
+                : 'Failed to record session outcome';
+        },
+    };
+}
+//# sourceMappingURL=engram-outcome.js.map

package/dist/tools/engram-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-outcome.js","sourceRoot":"","sources":["../../src/tools/engram-outcome.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAqBH,0DAwCC;AA3DD,6BAAwB;AACxB,+CAAyC;AAKzC,MAAM,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAC/D,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,cAAI,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,cAAI,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,0DAA0D;QACvE,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC;KACrD,CAAC;IACF,MAAM,EAAE,cAAI,CAAC,QAAQ,CAAC,cAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC,CAAC;CACxF,CAAC,CAAC;AAEH,SAAgB,uBAAuB,CACrC,GAA8B,EAC9B,MAAwB,EACxB,MAAoB;IAEpB,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,iFAAiF;YACjF,4FAA4F;YAC5F,qDAAqD;QACvD,UAAU,EAAE,iBAAiB;QAE7B,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAA+B;YAChE,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACvD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,OAAO,iEAAiE,CAAC;YAC3E,CAAC;YAED,4DAA4D;YAC5D,MAAM,eAAe,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;YAC9D,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,OAAO,iDAAiD,CAAC;YAC3D,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAC5C,eAAe,EACf,MAAM,CAAC,IAAI,CAAC,OAAO,EACnB,MAAM,CAAC,IAAI,CAAC,MAAM,CACnB,CAAC;YAEF,OAAO,OAAO;gBACZ,CAAC,CAAC,6BAA6B,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3G,CAAC,CAAC,kCAAkC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/engram-presets.d.ts

@@ -0,0 +1,12 @@
+/**
+ * engram_changes and engram_how_it_works — search preset wrappers.
+ *
+ * These are thin wrappers around searchContext with preset parameters,
+ * providing shortcut access to common query patterns.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { AnyAgentTool, OpenClawPluginToolContext } from '../types/openclaw.js';
+export declare function createEngramChangesTool(ctx: OpenClawPluginToolContext, client: EngramRestClient, config: PluginConfig): AnyAgentTool;
+export declare function createEngramHowItWorksTool(ctx: OpenClawPluginToolContext, client: EngramRestClient, config: PluginConfig): AnyAgentTool;
+//# sourceMappingURL=engram-presets.d.ts.map

package/dist/tools/engram-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-presets.d.ts","sourceRoot":"","sources":["../../src/tools/engram-presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AA6DpF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,yBAAyB,EAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,GACnB,YAAY,CAUd;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,yBAAyB,EAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,GACnB,YAAY,CAUd"}

package/dist/tools/engram-presets.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * engram_changes and engram_how_it_works — search preset wrappers.
+ *
+ * These are thin wrappers around searchContext with preset parameters,
+ * providing shortcut access to common query patterns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEngramChangesTool = createEngramChangesTool;
+exports.createEngramHowItWorksTool = createEngramHowItWorksTool;
+const zod_1 = require("zod");
+const typebox_1 = require("@sinclair/typebox");
+const identity_js_1 = require("../identity.js");
+const PresetParamsSchema = zod_1.z.object({
+    query: zod_1.z.string().min(1),
+});
+const presetParameters = typebox_1.Type.Object({
+    query: typebox_1.Type.String({ description: 'Search query' }),
+});
+function createPresetTool(name, description, preset, ctx, client, config) {
+    return {
+        name,
+        description,
+        parameters: presetParameters,
+        async execute(_toolCallId, params) {
+            const parsed = PresetParamsSchema.safeParse(params);
+            if (!parsed.success) {
+                return `Invalid parameters: ${parsed.error.message}`;
+            }
+            if (!client.isAvailable()) {
+                return `engram is currently unreachable — ${name} unavailable`;
+            }
+            const identity = (0, identity_js_1.resolveIdentity)(ctx.agentId ?? '', ctx.workspaceDir);
+            const project = config.project ?? identity.projectId;
+            const response = await client.searchContext({
+                project,
+                query: parsed.data.query,
+                cwd: ctx.workspaceDir,
+                agent_id: ctx.agentId,
+                preset,
+            });
+            const observations = response?.observations ?? [];
+            if (observations.length === 0) {
+                return `No results found for: ${parsed.data.query}`;
+            }
+            let out = `# ${preset === 'changes' ? 'Recent Changes' : 'How It Works'}\n\n`;
+            observations.forEach((obs, i) => {
+                const typeLabel = (obs.type ?? 'observation').toUpperCase();
+                out += `## ${i + 1}. [${typeLabel}] ${obs.title ?? 'Untitled'}\n`;
+                if (obs.narrative)
+                    out += `${obs.narrative}\n`;
+                out += '\n';
+            });
+            return out.trimEnd();
+        },
+    };
+}
+function createEngramChangesTool(ctx, client, config) {
+    return createPresetTool('engram_changes', 'Find recent code changes, refactorings, and modifications. ' +
+        'Use when you need to understand what changed recently in the codebase.', 'changes', ctx, client, config);
+}
+function createEngramHowItWorksTool(ctx, client, config) {
+    return createPresetTool('engram_how_it_works', 'Understand system architecture, design patterns, and implementation details. ' +
+        'Use when exploring unfamiliar code to get a high-level understanding.', 'how_it_works', ctx, client, config);
+}
+//# sourceMappingURL=engram-presets.js.map

package/dist/tools/engram-presets.js.map

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

package/dist/tools/engram-rate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * engram_rate — rate an observation as useful or not useful.
+ *
+ * WHEN TO USE: After recalling a memory that influenced your work.
+ * Rate it so engram learns what to prioritize in future sessions.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { AnyAgentTool, OpenClawPluginToolContext } from '../types/openclaw.js';
+export declare function createEngramRateTool(_ctx: OpenClawPluginToolContext, client: EngramRestClient, _config: PluginConfig): AnyAgentTool;
+//# sourceMappingURL=engram-rate.d.ts.map

package/dist/tools/engram-rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-rate.d.ts","sourceRoot":"","sources":["../../src/tools/engram-rate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAYpF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,yBAAyB,EAC/B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,YAAY,CAyBd"}

package/dist/tools/engram-rate.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * engram_rate — rate an observation as useful or not useful.
+ *
+ * WHEN TO USE: After recalling a memory that influenced your work.
+ * Rate it so engram learns what to prioritize in future sessions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEngramRateTool = createEngramRateTool;
+const zod_1 = require("zod");
+const typebox_1 = require("@sinclair/typebox");
+const RateParamsSchema = zod_1.z.object({
+    id: zod_1.z.number().int().positive(),
+    useful: zod_1.z.boolean(),
+});
+const rateParameters = typebox_1.Type.Object({
+    id: typebox_1.Type.Number({ description: 'Observation ID to rate' }),
+    useful: typebox_1.Type.Boolean({ description: 'true if the observation was helpful, false if not' }),
+});
+function createEngramRateTool(_ctx, client, _config) {
+    return {
+        name: 'engram_rate',
+        description: 'Rate a recalled observation as useful or not useful. ' +
+            'Call this AFTER using a memory that influenced your response — helps engram learn what to prioritize.',
+        parameters: rateParameters,
+        async execute(_toolCallId, params) {
+            const parsed = RateParamsSchema.safeParse(params);
+            if (!parsed.success) {
+                return `Invalid parameters: ${parsed.error.message}`;
+            }
+            if (!client.isAvailable()) {
+                return 'engram is currently unreachable — rating unavailable';
+            }
+            const success = await client.rateObservation(parsed.data.id, parsed.data.useful);
+            const label = parsed.data.useful ? 'useful' : 'not useful';
+            return success
+                ? `Rated observation ${parsed.data.id} as ${label}`
+                : `Failed to rate observation ${parsed.data.id}`;
+        },
+    };
+}
+//# sourceMappingURL=engram-rate.js.map

package/dist/tools/engram-rate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-rate.js","sourceRoot":"","sources":["../../src/tools/engram-rate.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAkBH,oDA6BC;AA7CD,6BAAwB;AACxB,+CAAyC;AAKzC,MAAM,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,cAAI,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,cAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;IAC1D,MAAM,EAAE,cAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,mDAAmD,EAAE,CAAC;CAC3F,CAAC,CAAC;AAEH,SAAgB,oBAAoB,CAClC,IAA+B,EAC/B,MAAwB,EACxB,OAAqB;IAErB,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,uDAAuD;YACvD,uGAAuG;QACzG,UAAU,EAAE,cAAc;QAE1B,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAA+B;YAChE,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACvD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,OAAO,sDAAsD,CAAC;YAChE,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;YAC3D,OAAO,OAAO;gBACZ,CAAC,CAAC,qBAAqB,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,EAAE;gBACnD,CAAC,CAAC,8BAA8B,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/engram-suppress.d.ts

@@ -0,0 +1,11 @@
+/**
+ * engram_suppress — suppress an observation from future search results.
+ *
+ * WHEN TO USE: When an observation is outdated, wrong, or no longer relevant.
+ * Suppression is reversible — the observation stays in the database but is hidden from search.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { AnyAgentTool, OpenClawPluginToolContext } from '../types/openclaw.js';
+export declare function createEngramSuppressTool(_ctx: OpenClawPluginToolContext, client: EngramRestClient, _config: PluginConfig): AnyAgentTool;
+//# sourceMappingURL=engram-suppress.d.ts.map

package/dist/tools/engram-suppress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-suppress.d.ts","sourceRoot":"","sources":["../../src/tools/engram-suppress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAUpF,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,yBAAyB,EAC/B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,YAAY,CAwBd"}

package/dist/tools/engram-suppress.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * engram_suppress — suppress an observation from future search results.
+ *
+ * WHEN TO USE: When an observation is outdated, wrong, or no longer relevant.
+ * Suppression is reversible — the observation stays in the database but is hidden from search.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEngramSuppressTool = createEngramSuppressTool;
+const zod_1 = require("zod");
+const typebox_1 = require("@sinclair/typebox");
+const SuppressParamsSchema = zod_1.z.object({
+    id: zod_1.z.number().int().positive(),
+});
+const suppressParameters = typebox_1.Type.Object({
+    id: typebox_1.Type.Number({ description: 'Observation ID to suppress' }),
+});
+function createEngramSuppressTool(_ctx, client, _config) {
+    return {
+        name: 'engram_suppress',
+        description: 'Suppress an observation from future search results (reversible). ' +
+            'Use when an observation is outdated, wrong, or no longer relevant.',
+        parameters: suppressParameters,
+        async execute(_toolCallId, params) {
+            const parsed = SuppressParamsSchema.safeParse(params);
+            if (!parsed.success) {
+                return `Invalid parameters: ${parsed.error.message}`;
+            }
+            if (!client.isAvailable()) {
+                return 'engram is currently unreachable — suppress unavailable';
+            }
+            const success = await client.suppressObservation(parsed.data.id);
+            return success
+                ? `Suppressed observation ${parsed.data.id} — it will no longer appear in search results`
+                : `Failed to suppress observation ${parsed.data.id}`;
+        },
+    };
+}
+//# sourceMappingURL=engram-suppress.js.map

package/dist/tools/engram-suppress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-suppress.js","sourceRoot":"","sources":["../../src/tools/engram-suppress.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAgBH,4DA4BC;AA1CD,6BAAwB;AACxB,+CAAyC;AAKzC,MAAM,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,cAAI,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,cAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;CAC/D,CAAC,CAAC;AAEH,SAAgB,wBAAwB,CACtC,IAA+B,EAC/B,MAAwB,EACxB,OAAqB;IAErB,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,mEAAmE;YACnE,oEAAoE;QACtE,UAAU,EAAE,kBAAkB;QAE9B,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAA+B;YAChE,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACvD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,OAAO,wDAAwD,CAAC;YAClE,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjE,OAAO,OAAO;gBACZ,CAAC,CAAC,0BAA0B,MAAM,CAAC,IAAI,CAAC,EAAE,+CAA+C;gBACzF,CAAC,CAAC,kCAAkC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/engram-timeline.d.ts

@@ -0,0 +1,11 @@
+/**
+ * engram_timeline — fetch timeline of observations.
+ *
+ * WHEN TO USE: When exploring what happened recently in a project,
+ * or when you need temporal context around a specific event.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { AnyAgentTool, OpenClawPluginToolContext } from '../types/openclaw.js';
+export declare function createEngramTimelineTool(ctx: OpenClawPluginToolContext, client: EngramRestClient, config: PluginConfig): AnyAgentTool;
+//# sourceMappingURL=engram-timeline.d.ts.map

package/dist/tools/engram-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/engram-timeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAmBpF,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,yBAAyB,EAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,GACnB,YAAY,CAkCd"}

package/dist/tools/engram-timeline.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * engram_timeline — fetch timeline of observations.
+ *
+ * WHEN TO USE: When exploring what happened recently in a project,
+ * or when you need temporal context around a specific event.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEngramTimelineTool = createEngramTimelineTool;
+const zod_1 = require("zod");
+const typebox_1 = require("@sinclair/typebox");
+const identity_js_1 = require("../identity.js");
+const TimelineParamsSchema = zod_1.z.object({
+    mode: zod_1.z.enum(['recent', 'anchor', 'query']).optional().default('recent'),
+    query: zod_1.z.string().optional(),
+    anchor_id: zod_1.z.number().int().positive().optional(),
+    limit: zod_1.z.number().int().min(1).max(50).optional().default(20),
+});
+const timelineParameters = typebox_1.Type.Object({
+    mode: typebox_1.Type.Optional(typebox_1.Type.String({
+        description: 'Timeline mode: recent (default), anchor (around specific ID), query (search + timeline)',
+        enum: ['recent', 'anchor', 'query'],
+    })),
+    query: typebox_1.Type.Optional(typebox_1.Type.String({ description: 'Search query (for query mode)' })),
+    anchor_id: typebox_1.Type.Optional(typebox_1.Type.Number({ description: 'Observation ID (for anchor mode)' })),
+    limit: typebox_1.Type.Optional(typebox_1.Type.Number({ description: 'Max observations to return (default: 20)' })),
+});
+function createEngramTimelineTool(ctx, client, config) {
+    return {
+        name: 'engram_timeline',
+        description: 'Fetch a timeline of observations. Modes: recent (what happened lately), ' +
+            'anchor (context around a specific observation), query (search + timeline).',
+        parameters: timelineParameters,
+        async execute(_toolCallId, params) {
+            const parsed = TimelineParamsSchema.safeParse(params);
+            if (!parsed.success) {
+                return `Invalid parameters: ${parsed.error.message}`;
+            }
+            if (!client.isAvailable()) {
+                return 'engram is currently unreachable — timeline unavailable';
+            }
+            const identity = (0, identity_js_1.resolveIdentity)(ctx.agentId ?? '', ctx.workspaceDir);
+            const project = config.project ?? identity.projectId;
+            const observations = await client.getTimeline(project, parsed.data.mode, {
+                query: parsed.data.query,
+                anchor_id: parsed.data.anchor_id,
+                limit: parsed.data.limit,
+            });
+            if (observations.length === 0) {
+                return 'No observations found in timeline.';
+            }
+            return formatTimeline(observations);
+        },
+    };
+}
+function formatTimeline(observations) {
+    let out = '# Timeline\n\n';
+    observations.forEach((obs, i) => {
+        const typeLabel = (obs.type ?? 'observation').toUpperCase();
+        out += `${i + 1}. [${typeLabel}] ${obs.title ?? 'Untitled'}\n`;
+        if (obs.narrative)
+            out += `   ${obs.narrative.slice(0, 200)}\n`;
+    });
+    return out.trimEnd();
+}
+//# sourceMappingURL=engram-timeline.js.map

package/dist/tools/engram-timeline.js.map

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

package/dist/tools/engram-vault.d.ts

@@ -0,0 +1,12 @@
+/**
+ * engram_vault_store and engram_vault_get — credential management.
+ *
+ * Securely store and retrieve encrypted credentials via engram's vault.
+ * Encryption happens server-side (AES-256-GCM). Credentials never leave the server unencrypted.
+ */
+import type { EngramRestClient } from '../client.js';
+import type { PluginConfig } from '../config.js';
+import type { AnyAgentTool, OpenClawPluginToolContext } from '../types/openclaw.js';
+export declare function createEngramVaultStoreTool(ctx: OpenClawPluginToolContext, client: EngramRestClient, config: PluginConfig): AnyAgentTool;
+export declare function createEngramVaultGetTool(_ctx: OpenClawPluginToolContext, client: EngramRestClient, _config: PluginConfig): AnyAgentTool;
+//# sourceMappingURL=engram-vault.d.ts.map

package/dist/tools/engram-vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-vault.d.ts","sourceRoot":"","sources":["../../src/tools/engram-vault.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAyBpF,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,yBAAyB,EAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,GACnB,YAAY,CAiCd;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,yBAAyB,EAC/B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,YAAY,CA4Bd"}

package/dist/tools/engram-vault.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * engram_vault_store and engram_vault_get — credential management.
+ *
+ * Securely store and retrieve encrypted credentials via engram's vault.
+ * Encryption happens server-side (AES-256-GCM). Credentials never leave the server unencrypted.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEngramVaultStoreTool = createEngramVaultStoreTool;
+exports.createEngramVaultGetTool = createEngramVaultGetTool;
+const zod_1 = require("zod");
+const typebox_1 = require("@sinclair/typebox");
+const identity_js_1 = require("../identity.js");
+const StoreParamsSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1),
+    value: zod_1.z.string().min(1),
+    scope: zod_1.z.enum(['project', 'global']).optional().default('project'),
+});
+const storeParameters = typebox_1.Type.Object({
+    name: typebox_1.Type.String({ description: 'Credential name (e.g., OPENAI_API_KEY)' }),
+    value: typebox_1.Type.String({ description: 'Credential value to encrypt and store' }),
+    scope: typebox_1.Type.Optional(typebox_1.Type.String({
+        description: 'Scope: project (default) or global',
+        enum: ['project', 'global'],
+    })),
+});
+const GetParamsSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1),
+});
+const getParameters = typebox_1.Type.Object({
+    name: typebox_1.Type.String({ description: 'Credential name to retrieve' }),
+});
+function createEngramVaultStoreTool(ctx, client, config) {
+    return {
+        name: 'engram_vault_store',
+        description: 'Securely store an encrypted credential in engram vault. ' +
+            'Server-side AES-256-GCM encryption. Use for API keys, tokens, passwords.',
+        parameters: storeParameters,
+        async execute(_toolCallId, params) {
+            const parsed = StoreParamsSchema.safeParse(params);
+            if (!parsed.success) {
+                return `Invalid parameters: ${parsed.error.message}`;
+            }
+            if (!client.isAvailable()) {
+                return 'engram is currently unreachable — vault store unavailable';
+            }
+            const identity = (0, identity_js_1.resolveIdentity)(ctx.agentId ?? '', ctx.workspaceDir);
+            const project = config.project ?? identity.projectId;
+            const success = await client.storeCredential(parsed.data.name, parsed.data.value, parsed.data.scope, project);
+            return success
+                ? `Credential "${parsed.data.name}" stored securely (scope: ${parsed.data.scope})`
+                : `Failed to store credential "${parsed.data.name}" — server may be unavailable or vault not configured`;
+        },
+    };
+}
+function createEngramVaultGetTool(_ctx, client, _config) {
+    return {
+        name: 'engram_vault_get',
+        description: 'Retrieve and decrypt a credential from engram vault by name. ' +
+            'Returns the decrypted value. Use for accessing stored API keys and tokens.',
+        parameters: getParameters,
+        async execute(_toolCallId, params) {
+            const parsed = GetParamsSchema.safeParse(params);
+            if (!parsed.success) {
+                return `Invalid parameters: ${parsed.error.message}`;
+            }
+            if (!client.isAvailable()) {
+                return 'engram is currently unreachable — vault get unavailable';
+            }
+            const cred = await client.getCredential(parsed.data.name);
+            if (!cred) {
+                return `Credential "${parsed.data.name}" not found — check name and scope`;
+            }
+            // Note: credential value is in tool output (conversation history).
+            // Ensure session transcripts handle sensitive data appropriately.
+            return `${cred.name}: ${cred.value}`;
+        },
+    };
+}
+//# sourceMappingURL=engram-vault.js.map

package/dist/tools/engram-vault.js.map

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

package/dist/tools/memory-forget.d.ts

@@ -1,7 +1,8 @@
 /**
- * memory_forget — delete observations from engram by ID.
+ * memory_forget — suppress or permanently delete observations from engram by ID.
  *
- * Maps to engram's bulk_delete_observations endpoint.
+ * Default: suppress (reversible soft-hide from search results).
+ * With permanent=true: archive (permanent removal).
  */
 import type { EngramRestClient } from '../client.js';
 import type { PluginConfig } from '../config.js';

package/dist/tools/memory-forget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-forget.d.ts","sourceRoot":"","sources":["../../src/tools/memory-forget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAUpF,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,yBAAyB,EAC/B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,YAAY,CA2Bd"}
+{"version":3,"file":"memory-forget.d.ts","sourceRoot":"","sources":["../../src/tools/memory-forget.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAgBpF,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,yBAAyB,EAC/B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,YAAY,CAwCd"}