@trylucy/agent-memory 0.1.2 → 0.1.3

package/contracts/agent-memory-api.contract.json

@@ -92,7 +92,8 @@
     "fact",
     "preference",
     "decision",
-    "rule"
+    "rule",
+    "context"
   ],
   "memory_lifecycle": [
     "active",

package/contracts/hashes.json

@@ -2,18 +2,18 @@
   "algorithm": "sha256",
   "contract": {
     "path": "contracts/agent-memory-api.contract.json",
-    "sha256": "aa16ca4d91536f029e19084fce43510e7c44dc2ccb4aebd7c3f27900a6073584"
+    "sha256": "664b3a9e079f6173a8d779d88f6bcd9cae70b642d41124e4ff2d31ac71c93990"
   },
   "schemas": {
-    "schemas/v1/common.schema.json": "04934ec2ccbb6742c8bb3b0c787574788810a1f52b90689f1da757c58b16fe1c",
-    "schemas/v1/contract-document.schema.json": "526ada10476ca31d6faf91841b39dab2fa4293e6a7a3e93b15c769de52b37b4c",
+    "schemas/v1/common.schema.json": "2b84bbb652bb5ea05e53b64eb81ce2f71eea6a038cf88b0c224c126493e55c02",
+    "schemas/v1/contract-document.schema.json": "b7371f43c493d69cf9d2599b1d376d8a9a679b2bfe7f48bcc2275f0419328fb9",
     "schemas/v1/create-proposal-request.schema.json": "cc0c90de7243f9f1a7040831d0ddaa644d896747c567b79c340fb42a64fc3637",
     "schemas/v1/error.schema.json": "07dac4fea8be5ce2c09ee2b5924e870d353645ff83fca66bf657018c57b43b23",
     "schemas/v1/memory-version-state.schema.json": "09353978ddca519bc6238306c466be1ec6994248f04071562537658bac76567c",
     "schemas/v1/memory.schema.json": "559c992d6041dd49f3a9fcc969f313ffaa318679f44fdac20ecf9a50242bdc29",
     "schemas/v1/proposal-status.schema.json": "909d901ba9ab2bbcfe39e6b2e41b7828ed957fd1e877cbea2a3155a460804adb",
     "schemas/v1/public-surface.schema.json": "fd0bda7dfbe4f3b779c79e7b1edc6cfc26ec0bde8709ccf7235eba81b30cce91",
-    "schemas/v1/recall-request.schema.json": "1c696b36e2d20daf329075f58f5ae56a0607c6c5f023665c1c58fdedf4161da6",
+    "schemas/v1/recall-request.schema.json": "72f898f94dfd7ea77c8f56196725138193dcc85627a81a4162d3bc637f218e69",
     "schemas/v1/recall-response.schema.json": "51c3fd68cd6157c07766144c2533edbd440eb7621727ea463c88910186c2458f",
     "schemas/v1/receipt.schema.json": "16b2a739f3c4e175f69b9273f28541b51a5ba303c2f842a095487d773779911f",
     "schemas/v1/replace-proposal-request.schema.json": "020c1a18017ce68897fae2b1edbe2dcae31bdb4aa1bab0445df137be6a499940",

package/package.json

@@ -73,7 +73,7 @@
     "verify:hashes": "node scripts/generate-hashes.mjs --check"
   },
   "type": "module",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "dependencies": {
     "@modelcontextprotocol/server": "2.3.1",
     "ajv": "8.20.0",

package/schemas/v1/common.schema.json

@@ -44,7 +44,8 @@
         "fact",
         "preference",
         "decision",
-        "rule"
+        "rule",
+        "context"
       ]
     },
     "memoryLifecycle": {

package/schemas/v1/contract-document.schema.json

@@ -117,7 +117,8 @@
         "fact",
         "preference",
         "decision",
-        "rule"
+        "rule",
+        "context"
       ]
     },
     "memory_lifecycle": {

package/schemas/v1/recall-request.schema.json

@@ -16,7 +16,7 @@
       "items": {
         "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryKind"
       },
-      "maxItems": 4,
+      "maxItems": 5,
       "minItems": 1,
       "type": "array",
       "uniqueItems": true

package/src/client/index.d.ts

@@ -1,4 +1,4 @@
-export type MemoryKind = 'fact' | 'preference' | 'decision' | 'rule';
+export type MemoryKind = 'fact' | 'preference' | 'decision' | 'rule' | 'context';
 export type MemoryLifecycle = 'active' | 'superseded' | 'revoked' | 'forgotten';
 export type ProposalLifecycle = 'pending' | 'approved' | 'rejected' | 'expired' | 'superseded';
 export type PublicPermission = 'memory:read' | 'memory:propose';

package/src/client/validation.mjs

@@ -4,7 +4,7 @@ import {
   ProposalContractIncompatibilityError, ValidationFailureError,
 } from './errors.mjs';
 
-export const MEMORY_KINDS = Object.freeze(['fact', 'preference', 'decision', 'rule']);
+export const MEMORY_KINDS = Object.freeze(['fact', 'preference', 'decision', 'rule', 'context']);
 export const MEMORY_LIFECYCLES = Object.freeze(['active', 'superseded', 'revoked', 'forgotten']);
 export const PROPOSAL_LIFECYCLES = Object.freeze(['pending', 'approved', 'rejected', 'expired', 'superseded']);
 export const SCOPE_KINDS = Object.freeze(['user', 'workspace', 'project']);
@@ -81,7 +81,7 @@ export function validateRecallRequest(request) {
   allowed(request, new Set(['query', 'scope', 'keys', 'kinds', 'limit']), 'recall request');
   bounded(request.query, 'query', { max: 1024 }); validateScope(request.scope);
   if (request.keys !== undefined) unique(request.keys, 'keys', 20, validateKey);
-  if (request.kinds !== undefined) unique(request.kinds, 'kinds', 4, validateKind);
+  if (request.kinds !== undefined) unique(request.kinds, 'kinds', MEMORY_KINDS.length, validateKind);
   if (request.limit !== undefined && (!Number.isInteger(request.limit) || request.limit < 1 || request.limit > 5)) throw new ValidationFailureError('limit must be an integer between 1 and 5.');
   return request;
 }

package/src/mcp/schemas.mjs

@@ -57,6 +57,14 @@ function bundled(name) {
   const definitions = definitionsFor([name]);
   return { ...structuredClone(definitions[name]), $defs: definitions };
 }
+function publishScope(value) {
+  if (Array.isArray(value)) return value.map(publishScope);
+  if (!value || typeof value !== 'object') return value;
+  if (value.$ref === '#/$defs/common/$defs/scope') {
+    return structuredClone(documents.get('common').$defs.scope);
+  }
+  return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, publishScope(child)]));
+}
 function deepFreeze(value) {
   if (value && typeof value === 'object' && !Object.isFrozen(value)) {
     Object.freeze(value);
@@ -73,12 +81,12 @@ const proposalBranch = (name) => {
 };
 const statusDefinitions = definitionsFor(['common']);
 export const MCP_SCHEMAS = deepFreeze({
-  recallInput: bundled('recall-request'),
-  proposalInput: {
+  recallInput: publishScope(bundled('recall-request')),
+  proposalInput: publishScope({
     type: 'object',
     oneOf: [proposalBranch('create-proposal-request'), proposalBranch('replace-proposal-request')],
     $defs: proposalDefinitions,
-  },
+  }),
   proposalStatusInput: {
     type: 'object',
     additionalProperties: false,

package/src/mcp/server.mjs

@@ -19,7 +19,7 @@ export const LUCY_MEMORY_TOOL_NAMES = Object.freeze([
 const SAFE_ERROR_MESSAGES = Object.freeze({
   authentication_failure: 'Lucy authentication failed.',
   authorization_failure: 'Lucy authorization failed.',
-  invalid_scope: 'The memory scope is invalid.',
+  invalid_scope: 'The memory scope is invalid. Use {"kind":"user"}, {"kind":"workspace"}, or {"kind":"project","id":"project_..."}.',
   invalid_key: 'The memory key is invalid.',
   invalid_kind: 'The memory kind is invalid.',
   validation_failure: 'The memory request is invalid.',
@@ -126,7 +126,7 @@ async function requireClient(client) {
   }
 }
 
-export async function createLucyMemoryMcpServer({ client, name = 'lucy-memory-mcp', version = '0.1.2' } = {}) {
+export async function createLucyMemoryMcpServer({ client, name = 'lucy-memory-mcp', version = '0.1.3' } = {}) {
   const memoryClient = await requireClient(client);
   const server = new Server(
     { name, version },