@dsh-enhanced/personal-memory 0.1.47 → 0.1.49

package/lib/store.d.ts

@@ -1,4 +1,5 @@
 import { MemoryEvidenceLedger } from './evidence-ledger.js';
+import { type MemoryLearningAdoptionCommit, type MemoryLearningAdoptionGrant, type MemoryLearningAdoptionAvailability, type MemoryLearningAdoptionResult, type MemoryLearningManagedSource, type MemoryLearningSourceInvalidation, type MemoryLearningTarget, type MemoryLearningTargetInput, type MemoryLearningValidatedRef } from './learning-adoptions.js';
 import type { ApprovedMemoryMutation, MemoryAgentContext, MemoryExportDocument, MemoryIdentity, MemoryMutation, MemoryOwnerNamespace, MemoryPromotionCancellationInput, MemoryPromotionCancellationResult, MemoryPromotionReference, MemoryPromotionSettlement, MemoryProposalInput, MemoryRecord, MemorySearchHit, MemorySearchRequest, MemorySnapshot, MemorySnapshotRequest, StoredMemoryProposal, StoredMemoryProposalIntent, StoredMemoryPromotionResult } from './types.js';
 export type MemoryStoreErrorCode = 'content-too-large' | 'duplicate-content' | 'idempotency-conflict' | 'invalid-entry' | 'invalid-identity' | 'invalid-path' | 'not-found' | 'record-limit' | 'schema-too-new' | 'unsafe-file' | 'version-conflict';
 export declare class MemoryStoreError extends Error {
@@ -72,6 +73,26 @@ export declare class MemoryStore {
     readonly evidence: MemoryEvidenceLedger;
     constructor(options: MemoryStoreOptions);
     close(): void;
+    /** Register a frozen Host grant; reusing its id with different authority never resets quota. */
+    registerLearningGrant(input: MemoryLearningAdoptionGrant): Readonly<{
+        authorityId: string;
+        grantDigest: string;
+    }>;
+    /** Read the already registered grant without creating it or reserving budget. */
+    inspectLearningAdoptionAvailability(input: MemoryLearningAdoptionGrant): MemoryLearningAdoptionAvailability;
+    lookupLearningAdoption(input: Readonly<{
+        authorityId: string;
+        operationId: string;
+        requestDigest: string;
+    }>): Readonly<MemoryLearningAdoptionResult> | undefined;
+    applyLearningAdoption(input: MemoryLearningAdoptionCommit): Readonly<MemoryLearningAdoptionResult>;
+    /** This synchronous Host view admits only source-validated exact versions. */
+    withLearningVisibility<T>(validatedExactRefs: readonly MemoryLearningValidatedRef[], callback: () => T): T;
+    inspectLearningTarget(input: MemoryLearningTargetInput): MemoryLearningTarget | undefined;
+    listManagedLearningSources(contextInput: MemoryAgentContext): readonly Readonly<MemoryLearningManagedSource>[];
+    invalidateManagedLearningSource(input: MemoryLearningSourceInvalidation): Readonly<{
+        invalidated: boolean;
+    }>;
     resolveProposalNotAfter(namespace: MemoryOwnerNamespace, idempotencyKey: string, ttlMs: number, requested?: number): number;
     get(namespace: MemoryOwnerNamespace, identity: MemoryIdentity, id: string): MemoryRecord | undefined;
     list(namespace: MemoryOwnerNamespace, identity: MemoryIdentity, options?: {

package/lib/store.d.ts.map

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

package/lib/store.js

@@ -1,11 +1,12 @@
 import { createHash, randomUUID } from 'node:crypto';
 import { isAbsolute } from 'node:path';
-import { validatePreferenceMemoryPromotionCancellationRequest, withPreferenceMemoryPromotionCancellationReceiptDigest, withPreferenceMemoryPromotionResultDigest, } from '@dsh-enhanced/assistant-growth-contract';
+import { growthObjectDigest, memoryLearningRequestDigest, validateMemoryLearningOwner, validatePreferenceMemoryPromotionCancellationRequest, withPreferenceMemoryPromotionCancellationReceiptDigest, withPreferenceMemoryPromotionResultDigest, } from '@dsh-enhanced/assistant-growth-contract';
 import { APPROVAL_DISPLAY_BUDGET } from '@dsh-enhanced/assistant-policy';
 import { MemoryDatabaseError, openMemoryDatabase } from './sqlite.js';
 import { MemoryEvidenceLedger } from './evidence-ledger.js';
 import { tokenizeMemory } from './tokenize.js';
 import { memoryKnowledgeText, normalizeMemoryKnowledge } from './knowledge.js';
+import { learningGrantDigest, learningRecordDigest, learningResultDigest, validateLearningGrant, validateLearningRequest, validateLearningReviewReceipt, } from './learning-adoptions.js';
 export class MemoryStoreError extends Error {
     code;
     constructor(code, message) {
@@ -289,6 +290,7 @@ export class MemoryStore {
     #now;
     #closed = false;
     #reading = false;
+    #learningVisibility;
     evidence;
     constructor(options) {
         this.#maxContentBytes = options.maxContentBytes ?? 4_096;
@@ -316,6 +318,262 @@ export class MemoryStore {
         this.#closed = true;
         this.#database.close();
     }
+    #learningNamespace(owner) {
+        return Object.freeze({ mode: 'delivery', principalDigest: memoryPrincipalDigest(owner.principalId),
+            principalRecordId: owner.principalRecordId, principalVersion: owner.principalVersion });
+    }
+    #learningIdentity(owner) {
+        return Object.freeze({ owner: 'agent', scope: 'workspace', workspace: owner.workspace, agentPreset: owner.agentPreset });
+    }
+    #learningGrantRow(authorityId) {
+        return this.#database.prepare(`SELECT grant_json, grant_digest, used_mutations, used_content_bytes
+      FROM memory_learning_adoptions WHERE authority_id = ? AND operation_id = '' AND row_kind = 'grant'`)
+            .get(authorityId);
+    }
+    /** Register a frozen Host grant; reusing its id with different authority never resets quota. */
+    registerLearningGrant(input) {
+        const grant = validateLearningGrant(input);
+        const digest = learningGrantDigest(grant);
+        return this.#transaction(() => {
+            const existing = this.#learningGrantRow(grant.authorityId);
+            if (existing === undefined)
+                this.#database.prepare(`INSERT INTO memory_learning_adoptions(
+        authority_id, operation_id, row_kind, grant_json, grant_digest, used_mutations, used_content_bytes)
+        VALUES (?, '', 'grant', ?, ?, 0, 0)`).run(grant.authorityId, JSON.stringify(grant), digest);
+            else if (existing.grant_digest !== digest || growthObjectDigest(JSON.parse(existing.grant_json)) !== digest) {
+                throw new MemoryStoreError('idempotency-conflict', 'learning grant authority changed');
+            }
+            return Object.freeze({ authorityId: grant.authorityId, grantDigest: digest });
+        });
+    }
+    /** Read the already registered grant without creating it or reserving budget. */
+    inspectLearningAdoptionAvailability(input) {
+        const grant = validateLearningGrant(input);
+        const grantDigest = learningGrantDigest(grant);
+        const row = this.#learningGrantRow(grant.authorityId);
+        if (row === undefined || row.grant_digest !== grantDigest
+            || growthObjectDigest(JSON.parse(row.grant_json)) !== grantDigest) {
+            throw new MemoryStoreError('idempotency-conflict', 'learning grant is absent or changed');
+        }
+        const remainingMutations = Math.max(0, grant.maxMutations - row.used_mutations);
+        const remainingContentBytes = Math.max(0, grant.maxTotalContentBytes - row.used_content_bytes);
+        return Object.freeze({ authorityId: grant.authorityId, grantDigest, expiresAt: grant.expiresAt,
+            remainingMutations, remainingContentBytes,
+            available: this.#now() < grant.expiresAt && remainingMutations > 0
+                && (remainingContentBytes > 0 || grant.operations.includes('remove')) });
+    }
+    lookupLearningAdoption(input) {
+        if (typeof input.authorityId !== 'string' || typeof input.operationId !== 'string'
+            || !SHA_256.test(input.requestDigest))
+            throw new MemoryStoreError('invalid-entry', 'learning adoption lookup is invalid');
+        const row = this.#database.prepare(`SELECT request_digest, result_json FROM memory_learning_adoptions
+      WHERE authority_id = ? AND operation_id = ? AND row_kind = 'operation'`).get(input.authorityId, input.operationId);
+        if (row === undefined)
+            return undefined;
+        if (row.request_digest !== input.requestDigest)
+            throw new MemoryStoreError('idempotency-conflict', 'learning operation was reused');
+        return Object.freeze(JSON.parse(row.result_json));
+    }
+    applyLearningAdoption(input) {
+        const grant = validateLearningGrant(input.grant);
+        const request = validateLearningRequest(input.request);
+        const requestDigest = memoryLearningRequestDigest(request);
+        const review = validateLearningReviewReceipt(input.reviewReceipt, request, grant);
+        if (growthObjectDigest(request.owner) !== growthObjectDigest(grant.owner)
+            || !grant.operations.includes(request.mutation.op)
+            || (request.mutation.op !== 'remove' && !grant.kinds.includes(request.mutation.entry.kind))
+            || !Number.isSafeInteger(input.sourceObservedAt) || input.sourceObservedAt < 0) {
+            throw new MemoryStoreError('invalid-entry', 'learning operation exceeds grant scope');
+        }
+        const contentBytes = request.mutation.op === 'remove' ? 0
+            : Buffer.byteLength(request.mutation.entry.content, 'utf8')
+                + (request.mutation.entry.knowledge === undefined ? 0 : Buffer.byteLength(JSON.stringify(request.mutation.entry.knowledge), 'utf8'));
+        const namespace = this.#learningNamespace(request.owner);
+        const identity = this.#learningIdentity(request.owner);
+        return this.#transaction(() => {
+            const prior = this.lookupLearningAdoption({ authorityId: grant.authorityId, operationId: request.operationId, requestDigest });
+            if (prior !== undefined)
+                return prior;
+            const current = this.#learningGrantRow(grant.authorityId);
+            if (current === undefined || current.grant_digest !== learningGrantDigest(grant)
+                || growthObjectDigest(JSON.parse(current.grant_json)) !== current.grant_digest) {
+                throw new MemoryStoreError('idempotency-conflict', 'learning grant is absent or changed');
+            }
+            const now = this.#now();
+            if (now >= grant.expiresAt)
+                throw new MemoryStoreError('invalid-entry', 'learning grant expired');
+            if (current.used_mutations >= grant.maxMutations || current.used_content_bytes + contentBytes > grant.maxTotalContentBytes) {
+                throw new MemoryStoreError('record-limit', 'learning adoption quota exceeded');
+            }
+            if (request.mutation.op !== 'add') {
+                const target = this.inspectLearningTarget({ owner: request.owner, id: request.mutation.id,
+                    expectedVersion: request.mutation.expectedVersion });
+                if (target === undefined)
+                    throw new MemoryStoreError('version-conflict', 'learning target is no longer managed');
+            }
+            const operationKey = growthObjectDigest([grant.authorityId, request.operationId]);
+            const idempotencyKey = `memory-learning:${operationKey}`;
+            const reservedAudit = this.#database.prepare(`SELECT 1 AS used FROM memory_audit
+        WHERE namespace_key = ? AND idempotency_key = ?`).get(memoryOwnerNamespaceKey(namespace), idempotencyKey);
+            if (reservedAudit !== undefined)
+                throw new MemoryStoreError('idempotency-conflict', 'learning audit key was already used');
+            const entry = request.mutation.op === 'remove' ? undefined
+                : { kind: request.mutation.entry.kind, content: request.mutation.entry.content,
+                    sensitivity: 'private', trust: 'agent-observed', confidence: 0.5,
+                    provenance: { source: 'assistant-memory-learning', observedAt: input.sourceObservedAt,
+                        uri: `delivery:foreground:${request.source.inboxId}` },
+                    expiresAt: now + grant.maxRecordTtlMs,
+                    ...(request.mutation.entry.knowledge === undefined ? {} : { knowledge: request.mutation.entry.knowledge }) };
+            const mutation = request.mutation.op === 'remove'
+                ? { op: 'remove', namespace, identity, id: request.mutation.id, expectedVersion: request.mutation.expectedVersion, idempotencyKey }
+                : request.mutation.op === 'replace'
+                    ? { op: 'replace', namespace, identity, id: request.mutation.id, expectedVersion: request.mutation.expectedVersion,
+                        idempotencyKey, entry: entry }
+                    : { op: 'add', namespace, identity, idempotencyKey, entry: entry };
+            const record = this.#applyMutationInCurrentTransaction(mutation);
+            const body = { protocol: 'memory-learning-adoption/v1', authorityId: grant.authorityId,
+                operationId: request.operationId, requestDigest, reviewReceiptDigest: review.receiptDigest,
+                record, recordDigest: learningRecordDigest(record), adoptedAt: now };
+            const result = Object.freeze({ ...body, receiptDigest: learningResultDigest(body) });
+            const updated = this.#database.prepare(`UPDATE memory_learning_adoptions
+        SET used_mutations = used_mutations + 1, used_content_bytes = used_content_bytes + ?
+        WHERE authority_id = ? AND operation_id = '' AND row_kind = 'grant'
+          AND grant_digest = ? AND used_mutations = ? AND used_content_bytes = ?`).run(contentBytes, grant.authorityId, current.grant_digest, current.used_mutations, current.used_content_bytes);
+            if (updated.changes !== 1)
+                throw new MemoryStoreError('version-conflict', 'learning quota changed');
+            this.#database.prepare(`INSERT INTO memory_learning_adoptions(
+        authority_id, operation_id, row_kind, request_json, request_digest, review_receipt_json,
+        source_digest, result_json, record_id, record_version, record_digest)
+        VALUES (?, ?, 'operation', ?, ?, ?, ?, ?, ?, ?, ?)`).run(grant.authorityId, request.operationId, JSON.stringify(request), requestDigest, JSON.stringify(review), request.source.sourceDigest, JSON.stringify(result), record.id, record.version, body.recordDigest);
+            return result;
+        });
+    }
+    #learningOperationForRecord(record) {
+        return this.#database.prepare(`SELECT authority_id, operation_id, request_json, source_digest,
+      record_digest, invalidated_at FROM memory_learning_adoptions
+      WHERE row_kind = 'operation' AND record_id = ? AND record_version = ? LIMIT 1`).get(record.id, record.version);
+    }
+    #learningVisible(record) {
+        const managed = this.#learningOperationForRecord(record);
+        if (managed === undefined)
+            return true;
+        return managed.invalidated_at === null && managed.record_digest === learningRecordDigest(record)
+            && this.#learningVisibility?.has(`${record.id}:${record.version}:${managed.record_digest}`) === true;
+    }
+    /** This synchronous Host view admits only source-validated exact versions. */
+    withLearningVisibility(validatedExactRefs, callback) {
+        if (!Array.isArray(validatedExactRefs) || validatedExactRefs.length > 10_000
+            || typeof callback !== 'function' || this.#learningVisibility !== undefined) {
+            throw new MemoryStoreError('invalid-entry', 'learning visibility requires a bounded synchronous view');
+        }
+        const refs = new Set();
+        for (const ref of validatedExactRefs) {
+            if (!ref || typeof ref.id !== 'string' || !Number.isSafeInteger(ref.version) || ref.version < 1
+                || !SHA_256.test(ref.recordDigest))
+                throw new MemoryStoreError('invalid-entry', 'learning visibility ref is invalid');
+            const key = `${ref.id}:${ref.version}:${ref.recordDigest}`;
+            if (refs.has(key))
+                throw new MemoryStoreError('invalid-entry', 'duplicate learning visibility ref');
+            refs.add(key);
+        }
+        this.#learningVisibility = refs;
+        try {
+            const result = callback();
+            if ((typeof result === 'object' || typeof result === 'function') && result !== null && 'then' in result) {
+                try {
+                    Promise.prototype.then.call(result, undefined, () => undefined);
+                }
+                catch { /* Not a native Promise. */ }
+                throw new MemoryStoreError('invalid-entry', 'learning visibility callback must be synchronous');
+            }
+            return result;
+        }
+        finally {
+            this.#learningVisibility = undefined;
+        }
+    }
+    inspectLearningTarget(input) {
+        const owner = validateMemoryLearningOwner(input.owner);
+        if (typeof input.id !== 'string' || !Number.isSafeInteger(input.expectedVersion) || input.expectedVersion < 1) {
+            throw new MemoryStoreError('invalid-entry', 'learning target is invalid');
+        }
+        const record = this.#selectRecord(normalizeIdentity(this.#learningIdentity(owner), this.#learningNamespace(owner)), input.id);
+        if (record === undefined || record.status !== 'active' || this.#expired(record)
+            || record.version !== input.expectedVersion)
+            return undefined;
+        const actual = this.#toRecord(record);
+        const managed = this.#learningOperationForRecord(actual);
+        if (managed === undefined || managed.invalidated_at !== null || managed.record_digest !== learningRecordDigest(actual))
+            return undefined;
+        const request = validateLearningRequest(JSON.parse(managed.request_json));
+        if (growthObjectDigest(request.owner) !== growthObjectDigest(owner) || request.mutation.op === 'remove'
+            || (actual.kind !== 'fact' && actual.kind !== 'experience'))
+            return undefined;
+        return Object.freeze({ id: actual.id, version: actual.version, managed: true,
+            kind: actual.kind, content: actual.content,
+            ...(actual.knowledge === undefined ? {} : { knowledge: actual.knowledge }) });
+    }
+    listManagedLearningSources(contextInput) {
+        const context = normalizeAgentContext(contextInput);
+        if (context.namespace.mode !== 'delivery')
+            return Object.freeze([]);
+        const identity = normalizeIdentity({ owner: 'agent', scope: 'workspace', workspace: context.workspace,
+            agentPreset: context.agentPreset }, context.namespace);
+        const rows = this.#database.prepare(`SELECT adoption.authority_id, adoption.request_json,
+      adoption.record_id, adoption.record_version, adoption.record_digest, adoption.source_digest
+      FROM memory_learning_adoptions adoption JOIN memory_records record ON record.id = adoption.record_id
+      WHERE adoption.row_kind = 'operation' AND adoption.invalidated_at IS NULL
+        AND record.version = adoption.record_version AND record.status = 'active'
+        AND record.namespace_key = ? AND record.owner = 'agent' AND record.scope = 'workspace'
+        AND record.workspace = ? AND record.agent_preset = ?
+        AND (record.expires_at IS NULL OR record.expires_at > ?)
+      ORDER BY adoption.authority_id, adoption.operation_id`).all(identity.namespaceKey, identity.workspace, identity.agentPreset, this.#now());
+        return Object.freeze(rows.flatMap(row => {
+            const record = this.#selectRecord(identity, row.record_id);
+            if (record === undefined || row.record_digest !== learningRecordDigest(this.#toRecord(record)))
+                return [];
+            const request = validateLearningRequest(JSON.parse(row.request_json));
+            return [Object.freeze({ authorityId: row.authority_id, request, id: row.record_id,
+                    version: row.record_version, recordDigest: row.record_digest, sourceDigest: row.source_digest })];
+        }));
+    }
+    invalidateManagedLearningSource(input) {
+        const owner = validateMemoryLearningOwner(input.owner);
+        if (input.reason !== 'withdrawn' && input.reason !== 'source-changed')
+            throw new MemoryStoreError('invalid-entry', 'invalid source invalidation reason');
+        if (typeof input.id !== 'string' || !Number.isSafeInteger(input.version) || input.version < 1
+            || !SHA_256.test(input.recordDigest) || !SHA_256.test(input.sourceDigest)) {
+            throw new MemoryStoreError('invalid-entry', 'invalid source invalidation ref');
+        }
+        const namespace = this.#learningNamespace(owner);
+        const identity = this.#learningIdentity(owner);
+        return this.#transaction(() => {
+            const row = this.#selectRecord(normalizeIdentity(identity, namespace), input.id);
+            if (row === undefined || row.status !== 'active' || row.version !== input.version)
+                return Object.freeze({ invalidated: false });
+            const actual = this.#toRecord(row);
+            const managed = this.#learningOperationForRecord(actual);
+            if (!managed || managed.invalidated_at !== null || managed.record_digest !== input.recordDigest
+                || managed.source_digest !== input.sourceDigest || learningRecordDigest(actual) !== input.recordDigest) {
+                return Object.freeze({ invalidated: false });
+            }
+            const request = validateLearningRequest(JSON.parse(managed.request_json));
+            if (growthObjectDigest(request.owner) !== growthObjectDigest(owner))
+                return Object.freeze({ invalidated: false });
+            const invalidationKey = `memory-learning-invalidated:${growthObjectDigest([managed.authority_id, managed.operation_id])}`;
+            const reservedAudit = this.#database.prepare(`SELECT 1 AS used FROM memory_audit
+        WHERE namespace_key = ? AND idempotency_key = ?`).get(memoryOwnerNamespaceKey(namespace), invalidationKey);
+            if (reservedAudit !== undefined)
+                throw new MemoryStoreError('idempotency-conflict', 'learning invalidation audit key was already used');
+            this.#applyMutationInCurrentTransaction({ op: 'remove', namespace, identity, id: input.id,
+                expectedVersion: input.version, idempotencyKey: invalidationKey });
+            const changed = this.#database.prepare(`UPDATE memory_learning_adoptions SET invalidated_at = ?, invalidation_reason = ?
+        WHERE authority_id = ? AND operation_id = ? AND invalidated_at IS NULL`).run(this.#now(), input.reason, managed.authority_id, managed.operation_id);
+            if (changed.changes !== 1)
+                throw new MemoryStoreError('version-conflict', 'learning invalidation changed');
+            return Object.freeze({ invalidated: true });
+        });
+    }
     resolveProposalNotAfter(namespace, idempotencyKey, ttlMs, requested) {
         const key = memoryOwnerNamespaceKey(namespace);
         const existing = this.#proposalByIdempotencyKey(key, idempotencyKey)
@@ -347,7 +605,8 @@ export class MemoryStore {
         const row = this.#selectRecord(columns, id);
         if (row === undefined || row.status !== 'active' || this.#expired(row))
             return undefined;
-        return this.#toRecord(row);
+        const record = this.#toRecord(row);
+        return this.#learningVisible(record) ? record : undefined;
     }
     list(namespace, identity, options = {}) {
         const columns = normalizeIdentity(identity, namespace);
@@ -358,7 +617,8 @@ export class MemoryStore {
     `).all(columns.namespaceKey, columns.owner, columns.scope, columns.workspace, columns.agentPreset);
         return rows
             .filter(row => row.status === 'removed' ? options.includeRemoved === true : !this.#expired(row))
-            .map(row => this.#toRecord(row));
+            .map(row => this.#toRecord(row))
+            .filter(record => this.#learningVisible(record));
     }
     read(context, ids) {
         const normalized = normalizeAgentContext(context);