n8n-nodes-engram 0.7.0 → 0.7.2

package/README.md

@@ -25,7 +25,7 @@
 
 <p align="center">
   <a href="#installation">Installation</a> &middot;
-  <a href="#upgrading-to-v070">Upgrade</a> &middot;
+  <a href="#upgrading-to-v072">Upgrade</a> &middot;
   <a href="#node-reference">Nodes</a> &middot;
   <a href="#storage-backends">Storage</a> &middot;
   <a href="#knowledge-extraction">Extraction</a> &middot;
@@ -101,8 +101,59 @@ npm install n8n-nodes-engram
 
 ---
 
+## Upgrading to v0.7.2
+
+Existing saved workflows retain their defaults and node versions. Installing this release does not enable automatic acceptance, change namespaces, rewrite historical memory or start a queue worker. New **Memory v3** and **Admin v3** nodes default to **Memory Behaviour > Existing / Custom**.
+
+### Back Up and Activate
+
+1. Take fresh, consistent workflow and backend backups before installing `n8n-nodes-engram@0.7.2`. Preserve exact namespaces, verified alias mappings, storage paths and producer workflow IDs. Restart n8n, refresh the editor and confirm the package version.
+2. Start with an inactive copy of one direct-conversation workflow and a separate restored store. Upgrade only the selected Memory/Admin nodes to **v3**. Preserve the current extraction route, model and provider-default temperature setting.
+3. In **Admin > Automatic Memory > Create Verified Actor Binding**, select the exact memory namespace and producer workflow ID. Bind a trusted application's stable issuer/actor reference to an **existing, explicitly accepted subject UUID**. Supply the operator and review reason. A name, phone number, session key or model confidence alone does not create this binding. Reassignment and revocation require the current binding revision.
+4. Select a profile deliberately. **Conservative Automatic** accepts supported source-grounded preferences; **Explicit Requests Only** additionally requires trusted save intent or an unquoted leading `Remember this:`; **Review First** proposes supported preferences. Use **Preview Memory Policy** to inspect the versioned effective policy, configured limits and identity readiness. Worker readiness is a separate check.
+5. On Memory v3, retain **Bounded** resolution, enable knowledge extraction and **Final Turns**, persist human episodes, and disable extraction from AI/system/tool content. Map the verified actor issuer/reference and a stable **Current Turn ID** from trusted application input. Keep tool audits separate. Extraction credentials/model remain required configuration, although this first profile implementation uses deterministic preference parsing rather than model requests.
+6. Supply the complete **Raw Current Human Content**. If agent input adds a display label, explicitly attest **Application-Owned Display Wrapper** and provide exact UTF-16 human-region offsets. This attestation is only for application display metadata; never use it to hide quotes, reports, conditions or other human context. No arbitrary label stripping occurs.
+
+### Supported Automatic Memory
+
+Profile version 1 supports complete literal first-person preferences such as `I prefer concise explanations.`, `I like bullet points.`, `I do not like long explanations.` when the value belongs to the supported language, explanation, presentation or format vocabulary. Supported negative preferences retain their polarity. Ambiguous, quoted, hypothetical, sensitive and unsupported statements remain in the episode history without being promoted to accepted facts. Complex preferences, nickname identity merging and dated commitments are outside this profile version. No **Personal Assistant** profile is offered yet.
+
+Exact repeated claims reuse the logical fact; a conflicting supported claim requires review. Rejected/manual decisions remain protected. Claim receipts distinguish accepted, proposed, rejected, deferred, unchanged and not-selected results, with persistence and mutation state. Source-episode acceptance is separate from fact acceptance. New budget diagnostics use a separate versioned `budget` field; the existing error categories remain unchanged.
+
+Current personalization suppresses revoked bindings, unsupported evidence and unresolved opposite claims. Historical modes may return intact source-grounded preference records with an explicit historical qualification: their recorded review state does not establish current identity or validity. As-of retrieval excludes new claims recorded after the requested date. Literal value nodes are never presented independently as personal facts.
+
+For an acknowledgement based on actual saving, put **Admin > Automatic Memory > Capture Human Memory** before the agent. Pass its **sourceId** into Memory v3's **Captured Human Source ID**, using the same backend, exact namespace, actor, turn ID, policy and formatted input. The current source is excluded from history, and the subsequent writer saves the final assistant/audits without saving or extracting the human turn again. Only `facts_accepted` confirms accepted graph knowledge; `review_required`, `not_saved`, `queued` and `unconfirmed` do not. A synchronous retry with a saved source but no recoverable receipt remains unconfirmed. An ordinary agent response generated before memory saving must not promise durable acceptance.
+
+Budget/execution settings are separate from acceptance. The deadline is one extraction work budget, not memory expiry or the whole workflow timeout. Increasing it does not broaden accepted evidence. Durable mode still requires an explicitly deployed matching **Admin v3** worker, route and profile; queued work is not already indexed. Extraction retries never resend an external chat message.
+
+### Verify and Roll Back
+
+Before expanding rollout, verify normal and tool-assisted writes, a supported preference without a save command, a negative/uncertain preference, duplicate turns, and a temporary question. Check accepted graph records and provenance, then verify graph-only recall on the separate restored store with recent conversation excluded. Test historical recall separately. Review active and passive group writers independently.
+
+**Recovery boundary:** once new profiles write bindings, envelopes, claims or role ownership, use consistent backend-native snapshots for recovery: the complete embedded graph file, or a Neo4j database backup. Preserve the original logical store mapping. Generic graph import and queue-aware JSON import deliberately reject restoration of new privileged bindings/ownership into a fresh store; a JSON export alone is not a supported recovery backup for these profiles. Retain queue-aware exports as additional inspection evidence when jobs exist.
+
+For rollback, keep this binary and restore **Existing / Custom** writer settings while its readers continue validating new claims. Old-package downgrade and mixed-version writers/workers are unsupported for new-profile stores. Keep newly appended conversations; never overwrite them with an older snapshot. No reset, purge, bulk re-extraction or automatic legacy repair is part of this upgrade.
+
+---
+
+## Upgrading to v0.7.1
+
+This patch fixes JSON-mode requests in bounded identity matching. It explicitly requests a valid JSON object and checks the trusted instruction before sending bounded extraction requests. Existing legacy extraction behavior and saved workflow defaults remain unchanged. No model, temperature or governance change is needed.
+
+1. Take fresh, consistent backups of your workflows and Engram stores. **Embedded:** preserve the original producer graph file and storage directory. **Neo4j:** use your normal consistent database backup. Keep existing namespace keys and alias mappings.
+2. Install `n8n-nodes-engram@0.7.1`, restart n8n, refresh the editor and confirm the installed version. Keep the existing Memory v2 bounded/quality/temperature settings. Node.js 20 or newer remains required. No schema migration, memory reset, purge, bulk re-extraction or queue activation is needed.
+3. Start with one conversation workflow. Test normal and tool-assisted turns, a durable preference, a temporary question and historical recall. Confirm explicit extraction success or documented deferral and inspect actual graph facts; overall workflow success alone is insufficient. Expand other namespaces only after this canary passes.
+
+Known JSON-instruction errors retain `kind=invalid_request` with fixed `reason=json_mode_instruction_missing` and `parameter=messages`. Deterministic HTTP 400 or authentication failures stop further equivalent comparisons in the extraction. Conversations remain saved while failed staged graph changes are discarded. No raw provider body is included in these diagnostics.
+
+For rollback, preserve legitimate messages written after the backup and follow the queue-aware backup/downgrade restrictions below when jobs exist. Prefer restoring the previous workflow settings while retaining current memory. Never overwrite newer conversations with an old snapshot as routine rollback. This patch does not repair old extracted facts or reclassify historical episodes. The [v0.7.0 controls and worker setup](#upgrading-to-v070) remain opt-in.
+
+---
+
 ## Upgrading to v0.7.0
 
+For bounded-mode installations, use v0.7.1 or newer for the JSON-mode comparison fix.
+
 These Memory v2 controls are optional. Existing workflows keep **Entity Resolution > Legacy**, **Knowledge Selection > Legacy**, **Extraction Execution > Synchronous** and **Graph Context Policy > Legacy**. Installing a newer package does not enable them or rewrite existing knowledge.
 
 ### Back Up and Install v0.7.0

package/dist/embeddings/EmbeddingService.js

@@ -39,7 +39,12 @@ class EmbeddingService {
             const controller = new AbortController();
             const abort = () => controller.abort();
             (_c = this.budget) === null || _c === void 0 ? void 0 : _c.controller.signal.addEventListener('abort', abort, { once: true });
-            const timeout = setTimeout(abort, Math.min(remaining !== null && remaining !== void 0 ? remaining : this.timeoutMs, this.timeoutMs));
+            const timeout = setTimeout(() => {
+                var _a;
+                if (remaining !== undefined && remaining <= this.timeoutMs)
+                    (_a = this.budget) === null || _a === void 0 ? void 0 : _a.controller.abort();
+                abort();
+            }, Math.min(remaining !== null && remaining !== void 0 ? remaining : this.timeoutMs, this.timeoutMs));
             const metric = (_d = this.diagnostics) === null || _d === void 0 ? void 0 : _d.beginRequest('embeddings');
             try {
                 let response;

package/dist/embeddings/EmbeddingService.js.map

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

package/dist/extraction/AutomaticClaims.d.ts

@@ -0,0 +1,10 @@
+import { type GraphData, type StagedExtraction, type ExtractionOutcome, type EntityEdge } from '../schemas';
+import { type AutomaticPolicy } from '../schemas/AutomaticMemory.schema';
+export declare const AUTOMATIC_ENVELOPE = "engram_source_envelope_v1";
+export declare const AUTOMATIC_CLAIM = "engram_claim_v1";
+export declare const AUTOMATIC_OWNER = "engram_write_owner_v1";
+export declare function validateStoredAutomaticClaim(graph: GraphData, edge: EntityEdge, check?: () => void, historicalEvidence?: boolean): boolean;
+export declare function planAutomaticClaims(graph: GraphData, group: string, sourceIds: string[], policy: AutomaticPolicy, baseOutcome: ExtractionOutcome, timestamp?: string, workCheck?: () => void): StagedExtraction;
+export declare function validateAutomaticPlan(graph: GraphData, plan: StagedExtraction): boolean;
+export declare function committedAutomaticReceipt(outcome: ExtractionOutcome, timestamp: string): void;
+export declare function failedAutomaticReceipt(outcome: ExtractionOutcome): void;

package/dist/extraction/AutomaticClaims.js

@@ -0,0 +1,401 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTOMATIC_OWNER = exports.AUTOMATIC_CLAIM = exports.AUTOMATIC_ENVELOPE = void 0;
+exports.validateStoredAutomaticClaim = validateStoredAutomaticClaim;
+exports.planAutomaticClaims = planAutomaticClaims;
+exports.validateAutomaticPlan = validateAutomaticPlan;
+exports.committedAutomaticReceipt = committedAutomaticReceipt;
+exports.failedAutomaticReceipt = failedAutomaticReceipt;
+const crypto_1 = require("crypto");
+const perf_hooks_1 = require("perf_hooks");
+const ExtractionDiagnostics_1 = require("./ExtractionDiagnostics");
+const uuid_1 = require("uuid");
+const schemas_1 = require("../schemas");
+const AutomaticMemory_schema_1 = require("../schemas/AutomaticMemory.schema");
+const AutomaticClaim_schema_1 = require("../schemas/AutomaticClaim.schema");
+const AutomaticEvidence_1 = require("./AutomaticEvidence");
+const AutomaticIdentity_1 = require("../storage/AutomaticIdentity");
+const QueueState_1 = require("./QueueState");
+exports.AUTOMATIC_ENVELOPE = 'engram_source_envelope_v1';
+exports.AUTOMATIC_CLAIM = 'engram_claim_v1';
+exports.AUTOMATIC_OWNER = 'engram_write_owner_v1';
+const hashText = (text) => (0, crypto_1.createHash)('sha256').update(text, 'utf8').digest('hex');
+const stableId = (key) => (0, uuid_1.v5)((0, QueueState_1.canonical)(key), uuid_1.v5.URL);
+function validateStoredAutomaticClaim(graph, edge, check = () => { }, historicalEvidence = false) {
+    var _a;
+    try {
+        check();
+        const meta = AutomaticClaim_schema_1.AutomaticClaimMetadataSchema.parse(edge.attributes[exports.AUTOMATIC_CLAIM]);
+        const source = graph.episodes.find((ep) => ep.uuid === meta.sourceId && ep.group_id === edge.group_id);
+        if (!source ||
+            source.role !== 'human' ||
+            !['active_human', 'passive_human'].includes(source.episode_kind) ||
+            source.review_status !== 'accepted' ||
+            !['standard', 'trusted'].includes(source.trust_level) ||
+            source.quoted_message_id)
+            return false;
+        (0, AutomaticIdentity_1.prepareAutomaticEpisodeInput)(source);
+        const envelope = AutomaticMemory_schema_1.AutomaticSourceEnvelopeSchema.parse(source.attributes[exports.AUTOMATIC_ENVELOPE]);
+        if (envelope.namespace !== edge.group_id ||
+            hashText(source.content) !== envelope.rawContentHash ||
+            (0, QueueState_1.canonical)(meta.binding) !== (0, QueueState_1.canonical)(envelope.bindingRef) ||
+            meta.issuer !== envelope.issuer ||
+            meta.actorReference !== envelope.actorReference ||
+            (0, QueueState_1.canonical)(meta.policy) !== (0, QueueState_1.canonical)(envelope.policy))
+            return false;
+        if (!historicalEvidence)
+            (0, AutomaticIdentity_1.assertAutomaticBinding)(graph, envelope, check);
+        const parsed = (0, AutomaticEvidence_1.parseAutomaticPreferences)(envelope, source.content.slice(envelope.humanRegion.start, envelope.humanRegion.end));
+        if (!parsed.claims.some((claim) => (0, QueueState_1.canonical)(claim) === (0, QueueState_1.canonical)(meta.claim)))
+            return false;
+        const valueKey = [
+            'literal-preference-v1',
+            edge.group_id,
+            'preference_value',
+            meta.claim.languageTag,
+            meta.claim.literal,
+        ];
+        const key = (0, QueueState_1.fingerprint)([...valueKey, envelope.bindingRef.subjectId, meta.claim.polarity]);
+        const target = graph.entities.find((entity) => entity.uuid === edge.target_node_uuid && entity.group_id === edge.group_id);
+        return (meta.key === key &&
+            meta.subjectId === envelope.bindingRef.subjectId &&
+            edge.uuid === stableId(['attributed-preference-v1', key]) &&
+            edge.source_node_uuid === meta.subjectId &&
+            edge.target_node_uuid === stableId(valueKey) &&
+            (target === null || target === void 0 ? void 0 : target.name) === meta.claim.literal &&
+            target.entity_type === 'preference_value' &&
+            edge.name === 'PREFERS' &&
+            edge.fact === meta.claim.clause &&
+            edge.episodes.includes(source.uuid) &&
+            ((_a = (0, schemas_1.extractionMetadataFromAttributes)(edge.attributes)) === null || _a === void 0 ? void 0 : _a.episode_uuids.includes(source.uuid)) ===
+                true);
+    }
+    catch (error) {
+        if (error instanceof ExtractionDiagnostics_1.ExtractionBudgetError)
+            throw error;
+        return false;
+    }
+}
+function planAutomaticClaims(graph, group, sourceIds, policy, baseOutcome, timestamp = new Date().toISOString(), workCheck) {
+    var _a, _b;
+    const expires = perf_hooks_1.performance.now() + 30000;
+    const check = workCheck !== null && workCheck !== void 0 ? workCheck : (() => {
+        if (perf_hooks_1.performance.now() >= expires)
+            throw new ExtractionDiagnostics_1.ExtractionBudgetError('deadline');
+    });
+    check();
+    if (graph.entities.length + graph.edges.length + graph.episodes.length > 100000)
+        throw new ExtractionDiagnostics_1.ExtractionBudgetError('snapshot_limit');
+    let snapshotBytes = 0;
+    for (const item of [...graph.entities, ...graph.edges, ...graph.episodes]) {
+        check();
+        snapshotBytes += Buffer.byteLength(JSON.stringify(item));
+        if (snapshotBytes > 100 * 1024 * 1024)
+            throw new ExtractionDiagnostics_1.ExtractionBudgetError('snapshot_limit');
+    }
+    const compiled = (0, AutomaticEvidence_1.compileAutomaticPolicy)({ profileId: policy.profileId });
+    if (policy.profileId === 'existing' || (0, QueueState_1.canonical)(compiled) !== (0, QueueState_1.canonical)(policy))
+        throw new Error('Engram automatic: unsupported_policy');
+    if (!sourceIds.length || sourceIds.length > 32 || new Set(sourceIds).size !== sourceIds.length)
+        throw new Error('Engram automatic: source_limit');
+    const entities = [], edges = [];
+    const outcome = JSON.parse(JSON.stringify(baseOutcome));
+    const receipt = {
+        version: 1,
+        policy,
+        sourceIds,
+        persisted: false,
+        commitAt: null,
+        items: [],
+        coverageComplete: true,
+    };
+    let hydrated = 0;
+    let conflictScans = 0;
+    let sourceBytes = 0;
+    let extensionBytes = 0;
+    for (const sourceId of sourceIds) {
+        check();
+        const source = graph.episodes.find((ep) => ep.uuid === sourceId && ep.group_id === group);
+        if (!source ||
+            source.role !== 'human' ||
+            !['active_human', 'passive_human'].includes(source.episode_kind) ||
+            !['standard', 'trusted'].includes(source.trust_level) ||
+            source.review_status !== 'accepted' ||
+            source.quoted_message_id)
+            throw new Error('Engram automatic: invalid_source');
+        (0, AutomaticIdentity_1.prepareAutomaticEpisodeInput)(source);
+        sourceBytes += Buffer.byteLength(source.content);
+        if (sourceBytes > 65536)
+            throw new ExtractionDiagnostics_1.ExtractionBudgetError('source_bytes');
+        extensionBytes += Buffer.byteLength(JSON.stringify({
+            envelope: source.attributes[exports.AUTOMATIC_ENVELOPE],
+            owner: source.attributes[exports.AUTOMATIC_OWNER],
+        }));
+        const envelope = AutomaticMemory_schema_1.AutomaticSourceEnvelopeSchema.parse(source.attributes[exports.AUTOMATIC_ENVELOPE]);
+        if (envelope.namespace !== group ||
+            (0, QueueState_1.canonical)(envelope.policy) !== (0, QueueState_1.canonical)(policy) ||
+            hashText(source.content) !== envelope.rawContentHash ||
+            Buffer.byteLength(source.content) > 65536)
+            throw new Error('Engram automatic: source_changed');
+        (0, AutomaticIdentity_1.assertAutomaticBinding)(graph, envelope, check);
+        const content = source.content.slice(envelope.humanRegion.start, envelope.humanRegion.end);
+        const parsed = (0, AutomaticEvidence_1.parseAutomaticPreferences)(envelope, content);
+        if (!parsed.claims.length) {
+            receipt.items.push({
+                state: 'not_selected',
+                persisted: false,
+                mutation: 'none',
+                reasons: parsed.reasons.length ? parsed.reasons : ['not_selected'],
+            });
+            outcome.counts.filtered++;
+            continue;
+        }
+        for (const claim of parsed.claims) {
+            check();
+            if (receipt.items.length >= 32)
+                throw new Error('Engram automatic: claim_limit');
+            const valueKey = [
+                'literal-preference-v1',
+                group,
+                'preference_value',
+                claim.languageTag,
+                claim.literal,
+            ];
+            const targetId = stableId(valueKey);
+            const key = (0, QueueState_1.fingerprint)([...valueKey, envelope.bindingRef.subjectId, claim.polarity]);
+            const edgeId = stableId(['attributed-preference-v1', key]);
+            const prior = [...graph.edges, ...edges].find((edge) => edge.uuid === edgeId);
+            if (prior) {
+                const priorClaim = AutomaticClaim_schema_1.AutomaticClaimMetadataSchema.safeParse(prior.attributes[exports.AUTOMATIC_CLAIM]);
+                if (!priorClaim.success ||
+                    priorClaim.data.key !== key ||
+                    prior.group_id !== group ||
+                    !validateStoredAutomaticClaim({
+                        ...graph,
+                        entities: [...graph.entities, ...entities],
+                        edges: [...graph.edges, ...edges],
+                    }, prior, check))
+                    throw new Error('Engram automatic: identity_collision');
+                const review = (_a = (0, schemas_1.extractionMetadataFromAttributes)(prior.attributes)) === null || _a === void 0 ? void 0 : _a.review_status;
+                if (!review)
+                    throw new Error('Engram automatic: missing_claim_review');
+                receipt.items.push({
+                    claimId: prior.uuid,
+                    state: review === 'rejected' ? 'rejected' : review === 'proposed' ? 'proposed' : 'unchanged',
+                    persisted: true,
+                    mutation: 'none',
+                    reasons: ['existing_claim'],
+                });
+                outcome.counts.unchanged++;
+                continue;
+            }
+            const candidates = [...graph.edges, ...edges].filter((edge) => {
+                check();
+                if (edge.group_id !== group ||
+                    edge.source_node_uuid !== envelope.bindingRef.subjectId ||
+                    edge.target_node_uuid !== targetId ||
+                    edge.attributes[exports.AUTOMATIC_CLAIM] === undefined)
+                    return false;
+                if (++conflictScans > 128)
+                    throw new ExtractionDiagnostics_1.ExtractionBudgetError('conflict_limit');
+                return true;
+            });
+            const references = candidates.reduce((total, edge) => {
+                var _a, _b;
+                return total +
+                    new Set([
+                        ...edge.episodes,
+                        ...((_b = (_a = (0, schemas_1.extractionMetadataFromAttributes)(edge.attributes)) === null || _a === void 0 ? void 0 : _a.episode_uuids) !== null && _b !== void 0 ? _b : []),
+                    ]).size;
+            }, 0);
+            hydrated += references;
+            if (references > 8 || hydrated > 512)
+                throw new ExtractionDiagnostics_1.ExtractionBudgetError('conflict_limit');
+            const conflict = candidates.some((edge) => {
+                var _a;
+                const other = AutomaticClaim_schema_1.AutomaticClaimMetadataSchema.safeParse(edge.attributes[exports.AUTOMATIC_CLAIM]);
+                return (other.success &&
+                    validateStoredAutomaticClaim({ ...graph, entities: [...graph.entities, ...entities] }, edge, check) &&
+                    other.data.claim.polarity !== claim.polarity &&
+                    ((_a = (0, schemas_1.extractionMetadataFromAttributes)(edge.attributes)) === null || _a === void 0 ? void 0 : _a.review_status) !== 'rejected');
+            });
+            const existingTarget = graph.entities.find((entity) => entity.uuid === targetId);
+            const targetReview = existingTarget
+                ? (_b = (0, schemas_1.extractionMetadataFromAttributes)(existingTarget.attributes)) === null || _b === void 0 ? void 0 : _b.review_status
+                : undefined;
+            const accepted = policy.autoAccept && !conflict && (!existingTarget || targetReview === 'accepted');
+            const metadata = {
+                version: 2,
+                source: 'policy',
+                confidence: null,
+                review_status: accepted ? 'accepted' : 'proposed',
+                threshold_decision: accepted ? 'auto_accepted' : 'pending_review',
+                extracted_at: timestamp,
+                episode_uuids: [sourceId],
+                reviewed_at: null,
+                reviewed_by: null,
+            };
+            const quality = {
+                version: 1,
+                category: 'preference',
+                policy: 'durableTemporal',
+                evidence: [
+                    { source_id: sourceId, start: claim.rawClauseSpan.start, end: claim.rawClauseSpan.end },
+                ],
+                temporal: { status: 'none', source_times: [source.reference_time], timezone: null },
+            };
+            const claimMetadata = AutomaticClaim_schema_1.AutomaticClaimMetadataSchema.parse({
+                version: 1,
+                generation: 'literal-parser-v1',
+                subjectId: envelope.bindingRef.subjectId,
+                binding: envelope.bindingRef,
+                issuer: envelope.issuer,
+                actorReference: envelope.actorReference,
+                policy,
+                claim,
+                sourceId,
+                key,
+            });
+            const target = [...graph.entities, ...entities].find((entity) => entity.uuid === targetId);
+            if (target &&
+                (target.group_id !== group ||
+                    target.entity_type !== 'preference_value' ||
+                    target.name !== claim.literal))
+                throw new Error('Engram automatic: identity_collision');
+            if (!target) {
+                entities.push(schemas_1.EntityNodeSchema.parse({
+                    uuid: targetId,
+                    group_id: group,
+                    name: claim.literal,
+                    entity_type: 'preference_value',
+                    summary: '',
+                    created_at: timestamp,
+                    updated_at: timestamp,
+                    attributes: {
+                        engram_extraction: metadata,
+                        engram_memory_quality: quality,
+                        engram_literal_v1: {
+                            version: 1,
+                            languageTag: claim.languageTag,
+                            literal: claim.literal,
+                            key: (0, QueueState_1.fingerprint)(valueKey),
+                        },
+                    },
+                }));
+                outcome.counts.entities_created++;
+            }
+            edges.push(schemas_1.EntityEdgeSchema.parse({
+                uuid: edgeId,
+                group_id: group,
+                source_node_uuid: envelope.bindingRef.subjectId,
+                target_node_uuid: targetId,
+                name: 'PREFERS',
+                fact: claim.clause,
+                episodes: [sourceId],
+                created_at: timestamp,
+                updated_at: timestamp,
+                attributes: {
+                    engram_extraction: metadata,
+                    engram_memory_quality: quality,
+                    [exports.AUTOMATIC_CLAIM]: claimMetadata,
+                },
+            }));
+            outcome.counts.edges_created++;
+            receipt.items.push({
+                claimId: edgeId,
+                state: accepted ? 'accepted' : 'proposed',
+                persisted: false,
+                mutation: 'pending',
+                reasons: [conflict ? 'conflicting_claim' : accepted ? 'selected' : 'review_required'],
+            });
+        }
+    }
+    outcome.automatic = AutomaticClaim_schema_1.AutomaticReceiptSchema.parse(receipt);
+    extensionBytes += Buffer.byteLength(JSON.stringify(receipt));
+    for (const item of [...entities, ...edges])
+        extensionBytes += Buffer.byteLength(JSON.stringify({
+            claim: item.attributes[exports.AUTOMATIC_CLAIM],
+            literal: item.attributes.engram_literal_v1,
+        }));
+    if (extensionBytes > 32 * 1024)
+        throw new ExtractionDiagnostics_1.ExtractionBudgetError('metadata_bytes');
+    check();
+    return {
+        version: 1,
+        group_id: group,
+        graph_hash: (0, QueueState_1.graphFingerprint)(graph, group),
+        source_guards: sourceIds.map((id) => ({
+            uuid: id,
+            hash: (0, QueueState_1.sourceFingerprint)(graph.episodes.find((ep) => ep.uuid === id)),
+        })),
+        entities,
+        edges,
+        outcome,
+    };
+}
+function validateAutomaticPlan(graph, plan) {
+    var _a, _b, _c, _d, _e;
+    const sources = plan.source_guards.map((guard) => graph.episodes.find((ep) => ep.uuid === guard.uuid && ep.group_id === plan.group_id));
+    const hasEnvelope = sources.some((source) => (source === null || source === void 0 ? void 0 : source.attributes[exports.AUTOMATIC_ENVELOPE]) !== undefined);
+    if (!hasEnvelope) {
+        if (plan.outcome.automatic ||
+            [...plan.entities, ...plan.edges].some((item) => {
+                var _a;
+                return item.attributes[exports.AUTOMATIC_CLAIM] ||
+                    ((_a = (0, schemas_1.extractionMetadataFromAttributes)(item.attributes)) === null || _a === void 0 ? void 0 : _a.source) === 'policy';
+            }))
+            throw new Error('Engram automatic: missing_source_authority');
+        return false;
+    }
+    if (plan.outcome.error_count || plan.outcome.errors.length || plan.outcome.status !== 'succeeded')
+        throw new Error('Engram automatic: failed_plan');
+    const first = AutomaticMemory_schema_1.AutomaticSourceEnvelopeSchema.parse((_a = sources[0]) === null || _a === void 0 ? void 0 : _a.attributes[exports.AUTOMATIC_ENVELOPE]);
+    if (!first.policy)
+        throw new Error('Engram automatic: missing_policy');
+    const timestamp = (_e = (_c = (_b = plan.edges[0]) === null || _b === void 0 ? void 0 : _b.created_at) !== null && _c !== void 0 ? _c : (_d = plan.entities[0]) === null || _d === void 0 ? void 0 : _d.created_at) !== null && _e !== void 0 ? _e : new Date().toISOString();
+    const empty = {
+        ...plan.outcome,
+        counts: {
+            entities_created: 0,
+            entities_updated: 0,
+            edges_created: 0,
+            edges_updated: 0,
+            edges_expired: 0,
+            unchanged: 0,
+            malformed: 0,
+            filtered: 0,
+        },
+    };
+    const expected = planAutomaticClaims(graph, plan.group_id, plan.source_guards.map((guard) => guard.uuid), first.policy, empty, timestamp);
+    if ((0, QueueState_1.canonical)(expected.entities) !== (0, QueueState_1.canonical)(plan.entities) ||
+        (0, QueueState_1.canonical)(expected.edges) !== (0, QueueState_1.canonical)(plan.edges) ||
+        (0, QueueState_1.canonical)(expected.outcome.automatic) !== (0, QueueState_1.canonical)(plan.outcome.automatic) ||
+        (0, QueueState_1.canonical)(expected.outcome.counts) !== (0, QueueState_1.canonical)(plan.outcome.counts))
+        throw new Error('Engram automatic: invalid_plan');
+    return true;
+}
+function committedAutomaticReceipt(outcome, timestamp) {
+    if (!outcome.automatic)
+        return;
+    outcome.automatic.persisted = true;
+    outcome.automatic.commitAt = timestamp;
+    for (const item of outcome.automatic.items)
+        if (item.mutation === 'pending') {
+            item.persisted = true;
+            item.mutation = 'created';
+        }
+}
+function failedAutomaticReceipt(outcome) {
+    if (!outcome.automatic)
+        return;
+    outcome.automatic.persisted = false;
+    outcome.automatic.commitAt = null;
+    for (const item of outcome.automatic.items)
+        if (item.mutation === 'pending') {
+            item.persisted = false;
+            item.mutation = 'none';
+            item.state = 'deferred';
+            item.reasons = ['interrupted'];
+        }
+}
+//# sourceMappingURL=AutomaticClaims.js.map

package/dist/extraction/AutomaticClaims.js.map

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

package/dist/extraction/AutomaticEvidence.d.ts

@@ -0,0 +1,10 @@
+import { type AutomaticActor, type AutomaticBindingReference, type AutomaticCaptureFailureReason, type AutomaticPolicy, type AutomaticPolicyInput, type AutomaticPreferenceParseResult, type AutomaticSourceEnvelope } from '../schemas/AutomaticMemory.schema';
+export declare function compileAutomaticPolicy(input?: AutomaticPolicyInput): AutomaticPolicy;
+export declare function captureEnvelope(content: string, rawContent: string, actor: AutomaticActor, bindingRef: AutomaticBindingReference, intent: boolean, policy?: AutomaticPolicy): {
+    ok: true;
+    envelope: AutomaticSourceEnvelope;
+} | {
+    ok: false;
+    reason: AutomaticCaptureFailureReason;
+};
+export declare function parseAutomaticPreferences(envelope: AutomaticSourceEnvelope, content: string): AutomaticPreferenceParseResult;