openclaw-engram 3.8.0 → 3.9.1

package/dist/project-identity-v3.test.js

@@ -0,0 +1,160 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = __importDefault(require("node:test"));
+const v3 = __importStar(require("./project-identity-v3.js"));
+const here = __dirname;
+const vectorsPath = node_path_1.default.resolve(here, '../../../contracts/testdata/project_identity_v3_vectors.json');
+const corpus = JSON.parse(node_fs_1.default.readFileSync(vectorsPath, 'utf8'));
+const helpers = [
+    'parseProjectAnchorV3',
+    'discoverProjectAnchorV3',
+    'normalizeGitRemoteV3',
+    'buildProjectIdentityV3',
+];
+function descriptorInput(anchor, descriptor) {
+    return {
+        anchor,
+        version: descriptor.version,
+        anchor_project_id: descriptor.anchor_project_id,
+        name: descriptor.name,
+        scope: descriptor.scope,
+        normalized_git_remotes: descriptor.normalized_git_remotes,
+        legacy_identifiers: descriptor.legacy_identifiers,
+        client_instance_id: descriptor.client_instance_id,
+        ...(Object.hasOwn(descriptor, 'project_key') ? { project_key: descriptor.project_key } : {}),
+    };
+}
+for (const helper of helpers) {
+    (0, node_test_1.default)(`OpenClaw V3 descriptor seam exports ${helper}`, () => {
+        strict_1.default.equal(typeof v3[helper], 'function', `${helper} is required by the frozen V3 vectors`);
+    });
+}
+(0, node_test_1.default)('OpenClaw V3 descriptor helpers consume the frozen shared vectors', () => {
+    strict_1.default.equal(corpus.contract, 'project_identity_v3');
+    strict_1.default.equal(corpus.identity_version, 3);
+    strict_1.default.equal(corpus.vectors.length, corpus.vector_counts.accepted + corpus.vector_counts.refused);
+    for (const vector of corpus.vectors) {
+        const anchor = vector.input.anchor;
+        const descriptor = vector.input.descriptor;
+        const remotes = vector.input.remote_observations ?? [];
+        if (anchor) {
+            const invalidAnchor = vector.expected.outcome === 'PROJECT_ANCHOR_INVALID';
+            if (invalidAnchor) {
+                strict_1.default.throws(() => v3.parseProjectAnchorV3(anchor), /PROJECT_ANCHOR_INVALID/, vector.id);
+            }
+            else {
+                strict_1.default.deepEqual(v3.parseProjectAnchorV3(anchor), anchor, vector.id);
+            }
+        }
+        for (const remote of remotes) {
+            const normalized = v3.normalizeGitRemoteV3(remote);
+            const disposition = remote.disposition ?? 'normalized';
+            strict_1.default.equal(normalized.disposition, disposition, vector.id);
+            if (disposition === 'normalized')
+                strict_1.default.equal(normalized.value, remote.normalized, vector.id);
+            if (disposition !== 'normalized') {
+                strict_1.default.equal(Object.hasOwn(normalized, 'raw_value'), false, vector.id);
+                strict_1.default.equal(Object.hasOwn(normalized, 'source'), false, vector.id);
+            }
+        }
+        if (!descriptor || !anchor || anchor.version !== 3)
+            continue;
+        const hasClientKey = Object.hasOwn(descriptor, 'project_key');
+        const unsupportedVersion = descriptor.version !== 3;
+        const missingClientID = typeof descriptor.client_instance_id !== 'string' || descriptor.client_instance_id === '';
+        const mismatchedAnchor = descriptor.name !== anchor.name || descriptor.scope !== anchor.scope ||
+            descriptor.anchor_project_id !== anchor.project_id;
+        const expectedDescriptorRefusal = vector.expected.outcome === 'PROJECT_DESCRIPTOR_INVALID';
+        if (hasClientKey || unsupportedVersion || missingClientID || mismatchedAnchor || expectedDescriptorRefusal) {
+            strict_1.default.throws(() => v3.buildProjectIdentityV3(descriptorInput(anchor, descriptor)), /PROJECT_(?:KEY_CLIENT_ASSERTION_FORBIDDEN|DESCRIPTOR_INVALID|SCOPE_MISMATCH)/, vector.id);
+        }
+        else {
+            strict_1.default.deepEqual(v3.buildProjectIdentityV3(descriptorInput(anchor, descriptor)), descriptor, vector.id);
+        }
+    }
+});
+(0, node_test_1.default)('OpenClaw V3 directory discovery never searches upward from the selected root', (t) => {
+    const parent = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'openclaw-v3-discovery-'));
+    const selectedRoot = node_path_1.default.join(parent, 'selected');
+    node_fs_1.default.mkdirSync(selectedRoot);
+    node_fs_1.default.writeFileSync(node_path_1.default.join(parent, '.engram-project'), JSON.stringify(corpus.vectors[0].input.anchor));
+    t.after(() => node_fs_1.default.rmSync(parent, { recursive: true, force: true }));
+    strict_1.default.equal(v3.discoverProjectAnchorV3(selectedRoot), null);
+});
+(0, node_test_1.default)('OpenClaw V3 rejects credential-shaped SCP remotes without retaining input', () => {
+    strict_1.default.deepEqual(v3.normalizeGitRemoteV3('git:pa:ss@GIT.EXAMPLE.TEST:Platform/Widget.git'), { disposition: 'refused' });
+});
+(0, node_test_1.default)('OpenClaw V3 rejects non-canonical descriptor evidence', () => {
+    const anchor = corpus.vectors[0].input.anchor;
+    const base = {
+        anchor,
+        normalized_git_remotes: [],
+        legacy_identifiers: [],
+        client_instance_id: 'fixture-install-edge',
+    };
+    strict_1.default.throws(() => v3.buildProjectIdentityV3({ ...base, normalized_git_remotes: ['git.example.test//Platform/Widget'] }), /PROJECT_DESCRIPTOR_INVALID/);
+    for (const value of ['legacy widget alias', 'legacy-widget\u0007alias']) {
+        strict_1.default.throws(() => v3.buildProjectIdentityV3({
+            ...base,
+            legacy_identifiers: [{ scheme: 'manual_alias', value, provenance: 'operator_import' }],
+        }), /PROJECT_DESCRIPTOR_INVALID/);
+    }
+});
+(0, node_test_1.default)('OpenClaw V3 rejects non-opaque client instance IDs', () => {
+    const anchor = corpus.vectors[0].input.anchor;
+    const base = {
+        anchor,
+        normalized_git_remotes: [],
+        legacy_identifiers: [],
+    };
+    for (const client_instance_id of [
+        '/private/operator/path',
+        'C:\\private\\operator',
+        'install / private',
+        'install\u0007private',
+        'credential@private',
+    ]) {
+        strict_1.default.throws(() => v3.buildProjectIdentityV3({ ...base, client_instance_id }), /PROJECT_DESCRIPTOR_INVALID/, client_instance_id);
+    }
+});
+//# sourceMappingURL=project-identity-v3.test.js.map

package/dist/project-identity-v3.test.js.map

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

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

@@ -1 +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;AAEjD,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"}
+{"version":3,"file":"engram-outcome.d.ts","sourceRoot":"","sources":["../../src/tools/engram-outcome.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,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;AAepF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,yBAAyB,EAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,GACnB,YAAY,CAwCd"}

package/dist/tools/engram-outcome.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createEngramOutcomeTool = createEngramOutcomeTool;
 const zod_1 = require("zod");
 const typebox_1 = require("@sinclair/typebox");
+const client_js_1 = require("../client.js");
 const formatter_js_1 = require("../context/formatter.js");
 const OutcomeParamsSchema = zod_1.z.object({
     outcome: zod_1.z.enum(['success', 'partial', 'failure', 'abandoned']),
@@ -41,8 +42,11 @@ function createEngramOutcomeTool(ctx, client, config) {
             if (!claudeSessionId) {
                 return 'Cannot record outcome — no session ID available';
             }
-            const success = await client.setSessionOutcome(claudeSessionId, parsed.data.outcome, parsed.data.reason);
-            return success
+            const result = await client.setSessionOutcome(claudeSessionId, parsed.data.outcome, parsed.data.reason);
+            if ((0, client_js_1.isOutcomeRetirement)(result)) {
+                return `Session outcome callback retired: contract_version=${result.contract_version} code=${result.code} action=${result.action}`;
+            }
+            return result
                 ? `Session outcome recorded: ${(0, formatter_js_1.quotedPromptScalar)(parsed.data.outcome)}${parsed.data.reason ? ` reason=${(0, formatter_js_1.quotedPromptScalar)(parsed.data.reason)}` : ''}`
                 : 'Failed to record session outcome';
         },

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

@@ -1 +1 @@
-{"version":3,"file":"engram-outcome.js","sourceRoot":"","sources":["../../src/tools/engram-outcome.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAsBH,0DAwCC;AA5DD,6BAAwB;AACxB,+CAAyC;AAGzC,0DAA6D;AAG7D,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,IAAA,iCAAkB,EAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAA,iCAAkB,EAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;gBACxJ,CAAC,CAAC,kCAAkC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"engram-outcome.js","sourceRoot":"","sources":["../../src/tools/engram-outcome.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAuBH,0DA4CC;AAjED,6BAAwB;AACxB,+CAAyC;AACzC,4CAAmD;AAGnD,0DAA6D;AAG7D,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,MAAM,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAC3C,eAAe,EACf,MAAM,CAAC,IAAI,CAAC,OAAO,EACnB,MAAM,CAAC,IAAI,CAAC,MAAM,CACnB,CAAC;YAEF,IAAI,IAAA,+BAAmB,EAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,OAAO,sDAAsD,MAAM,CAAC,gBAAgB,SAAS,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC;YACrI,CAAC;YAED,OAAO,MAAM;gBACX,CAAC,CAAC,6BAA6B,IAAA,iCAAkB,EAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAA,iCAAkB,EAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;gBACxJ,CAAC,CAAC,kCAAkC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "engram",
   "id": "engram",
-  "version": "3.8.0",
+  "version": "3.9.1",
   "displayName": "Engram Memory",
   "description": "Connects OpenClaw agents to engram persistent memory server for long-term context retention",
   "kind": "memory",
@@ -18,12 +18,18 @@
       "token": {
         "type": "string",
         "description": "Bearer token for engram API authentication",
-        "uiHints": { "sensitive": true }
+        "uiHints": {
+          "sensitive": true
+        }
       },
       "project": {
         "type": "string",
         "description": "Project scope override (defaults to auto-detected from workspace)"
       },
+      "clientInstanceId": {
+        "type": "string",
+        "description": "Opaque non-secret installation reference for V3 identity"
+      },
       "contextLimit": {
         "type": "number",
         "description": "Maximum observations to inject per prompt",
@@ -51,12 +57,20 @@
       },
       "logLevel": {
         "type": "string",
-        "enum": ["debug", "info", "warn", "error"],
+        "enum": [
+          "debug",
+          "info",
+          "warn",
+          "error"
+        ],
         "description": "Log verbosity level",
         "default": "warn"
       }
     },
-    "required": ["url", "token"]
+    "required": [
+      "url",
+      "token"
+    ]
   },
   "hooks": [
     "session_start",
@@ -83,6 +97,8 @@
     "migrate"
   ],
   "cli": {
-    "commands": ["memory"]
+    "commands": [
+      "memory"
+    ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-engram",
-  "version": "3.8.0",
+  "version": "3.9.1",
   "description": "OpenClaw plugin that connects to engram persistent memory server",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",