@polpo-ai/core 0.15.132 → 0.15.134

package/dist/memory/learning.js

@@ -0,0 +1,310 @@
+import { createMemoryExtractionCandidate } from "./extraction.js";
+import { MemoryContractError } from "./errors.js";
+import { createMemoryItem } from "./item.js";
+import { detectSensitiveMemoryContent } from "./policy.js";
+import { memoryScopeKey } from "./scope.js";
+export const MAX_MEMORY_LEARNING_CANDIDATES = 20;
+export const MAX_MEMORY_LEARNING_TURN_CHARACTERS = 64_000;
+export const DEFAULT_AUTOMATIC_MEMORY_CONFIDENCE = 0.9;
+export function evaluateMemoryTurnEligibility(input) {
+    if (input.mode === "off")
+        return { eligible: false, reason: "learning_off" };
+    if (!input.surfaces.includes(input.turn.surface)) {
+        return { eligible: false, reason: "surface_disabled" };
+    }
+    if (input.turn.terminalStatus !== "succeeded") {
+        return { eligible: false, reason: "turn_not_succeeded" };
+    }
+    if (!input.turn.assistantMessage) {
+        return { eligible: false, reason: "missing_visible_messages" };
+    }
+    const externalUserId = input.turn.trustedInvocation.externalUserId;
+    if (!externalUserId) {
+        return { eligible: false, reason: "missing_external_user" };
+    }
+    return {
+        eligible: true,
+        scope: Object.freeze({
+            kind: "user",
+            subjectId: externalUserId,
+            agentName: input.turn.agentName,
+        }),
+    };
+}
+export class DeterministicMemoryConsolidationPolicy {
+    options;
+    revision;
+    threshold;
+    constructor(options) {
+        this.options = options;
+        this.revision = requiredRevision(options.revision ?? "deterministic-v1", "policy revision");
+        this.threshold = options.automaticConfidence ?? DEFAULT_AUTOMATIC_MEMORY_CONFIDENCE;
+        if (!Number.isFinite(this.threshold) || this.threshold < 0 || this.threshold > 1) {
+            throw new TypeError("automaticConfidence must be between 0 and 1");
+        }
+    }
+    async resolve(input) {
+        if (detectSensitiveMemoryContent(`${input.candidate.content}\n${input.candidate.summary ?? ""}`).length > 0) {
+            return {
+                proposal: { action: "create" },
+                decision: "reject",
+                reason: "sensitive_content",
+            };
+        }
+        const duplicate = await this.options.itemStore.findDedupeCandidate({
+            scope: input.scope,
+            kind: input.candidate.kind,
+            content: input.candidate.content,
+        }, input.itemContext);
+        if (duplicate) {
+            return {
+                proposal: { action: "duplicate", existingMemoryId: duplicate.id },
+                decision: "reject",
+                reason: "exact_duplicate",
+            };
+        }
+        let proposal = { action: "create" };
+        if (input.candidate.existingMemoryId) {
+            const existing = await this.options.itemStore.get(input.candidate.existingMemoryId, input.itemContext, { includeInactive: true, includeExpired: true });
+            proposal = {
+                action: "supersede",
+                existingMemoryId: input.candidate.existingMemoryId,
+            };
+            if (!existing
+                || existing.status !== "active"
+                || existing.kind !== input.candidate.kind
+                || memoryScopeKey(existing.scope) !== memoryScopeKey(input.scope)) {
+                return { proposal, decision: "reject", reason: "invalid_supersede_target" };
+            }
+            if (Date.parse(existing.updatedAt) > Date.parse(input.observedAt)) {
+                return { proposal, decision: "reject", reason: "stale_extraction" };
+            }
+        }
+        if (input.mode === "suggest")
+            return { proposal, decision: "pending" };
+        if ((input.candidate.confidence ?? 0) < this.threshold) {
+            return { proposal, decision: "pending", reason: "confidence_below_threshold" };
+        }
+        return { proposal, decision: "apply" };
+    }
+}
+export class MemoryLearningService {
+    options;
+    constructor(options) {
+        this.options = options;
+        requiredRevision(options.extractor.revision, "extractor revision");
+        requiredRevision(options.policy.revision, "policy revision");
+    }
+    async process(input) {
+        const eligibility = evaluateMemoryTurnEligibility(input);
+        if (!eligibility.eligible) {
+            return {
+                eligible: false,
+                reason: eligibility.reason,
+                candidates: [],
+                appliedMemoryIds: [],
+            };
+        }
+        assertBoundedVisibleContent(input.userContent, "userContent");
+        assertBoundedVisibleContent(input.assistantContent, "assistantContent");
+        const allowedKinds = [...new Set(input.kinds)];
+        const extraction = await this.options.extractor.extract({
+            turn: input.turn,
+            userContent: input.userContent,
+            assistantContent: input.assistantContent,
+            allowedKinds,
+            scope: eligibility.scope,
+            ...(input.signal ? { signal: input.signal } : {}),
+        });
+        if (!extraction || !Array.isArray(extraction.candidates)) {
+            throw new MemoryContractError("Memory extractor returned an invalid result");
+        }
+        if (extraction.candidates.length > MAX_MEMORY_LEARNING_CANDIDATES) {
+            throw new MemoryContractError(`Memory extractor returned more than ${MAX_MEMORY_LEARNING_CANDIDATES} candidates`);
+        }
+        const candidates = [];
+        const appliedMemoryIds = [];
+        for (const [index, extracted] of extraction.candidates.entries()) {
+            assertExtractorCandidate(extracted, allowedKinds, index);
+            const idempotencyKey = [
+                input.turn.turnId,
+                this.options.extractor.revision,
+                this.options.policy.revision,
+                index,
+            ].join(":");
+            const existingCandidate = await this.options.candidateStore.getByIdempotencyKey?.(idempotencyKey, eligibility.scope, input.candidateContext);
+            if (existingCandidate) {
+                let replayed = existingCandidate;
+                if (replayed.status === "approved") {
+                    const memoryId = await applyMemoryExtractionCandidate(replayed, this.options.itemStore, input.itemContext, this.options.now);
+                    replayed = await this.options.candidateStore.markApplied(replayed.id, {
+                        memoryId,
+                        expectedRevision: replayed.revision,
+                    }, input.candidateContext);
+                }
+                if (replayed.status === "applied" && replayed.appliedMemoryId) {
+                    appliedMemoryIds.push(replayed.appliedMemoryId);
+                }
+                candidates.push(replayed);
+                continue;
+            }
+            const resolution = await this.options.policy.resolve({
+                mode: input.mode,
+                candidate: extracted,
+                scope: eligibility.scope,
+                observedAt: input.turn.occurredAt,
+                itemContext: input.itemContext,
+            });
+            const proposed = await this.options.candidateStore.propose(createMemoryExtractionCandidate({
+                idempotencyKey,
+                scope: eligibility.scope,
+                kind: extracted.kind,
+                content: extracted.content,
+                ...(extracted.summary ? { summary: extracted.summary } : {}),
+                ...(extracted.confidence === undefined
+                    ? {}
+                    : { confidence: extracted.confidence }),
+                source: {
+                    sourceId: input.turn.turnId,
+                    turnId: input.turn.turnId,
+                    extractorRevision: this.options.extractor.revision,
+                    policyRevision: this.options.policy.revision,
+                    ...(input.turn.runId ? { runId: input.turn.runId } : {}),
+                    sessionId: input.turn.sessionId,
+                    messageIds: [input.turn.userMessage.id],
+                },
+                proposal: resolution.proposal,
+                metadata: {
+                    evidence: "user",
+                    ...(resolution.reason ? { policyReason: resolution.reason } : {}),
+                },
+            }, { now: this.options.now }), input.candidateContext);
+            let candidate = proposed.candidate;
+            if (candidate.status === "pending" && resolution.decision === "reject") {
+                candidate = await this.options.candidateStore.decide(candidate.id, {
+                    decision: "reject",
+                    decidedBy: { actor: "system", actorId: this.options.policy.revision },
+                    reason: resolution.reason ?? "rejected_by_policy",
+                    expectedRevision: candidate.revision,
+                }, input.candidateContext);
+            }
+            else if (candidate.status === "pending" && resolution.decision === "apply") {
+                candidate = await this.options.candidateStore.decide(candidate.id, {
+                    decision: "approve",
+                    decidedBy: { actor: "system", actorId: this.options.policy.revision },
+                    expectedRevision: candidate.revision,
+                }, input.candidateContext);
+            }
+            if (candidate.status === "approved") {
+                const memoryId = await applyMemoryExtractionCandidate(candidate, this.options.itemStore, input.itemContext, this.options.now);
+                candidate = await this.options.candidateStore.markApplied(candidate.id, {
+                    memoryId,
+                    expectedRevision: candidate.revision,
+                }, input.candidateContext);
+                appliedMemoryIds.push(memoryId);
+            }
+            else if (candidate.status === "applied" && candidate.appliedMemoryId) {
+                appliedMemoryIds.push(candidate.appliedMemoryId);
+            }
+            candidates.push(candidate);
+        }
+        return {
+            eligible: true,
+            candidates,
+            appliedMemoryIds,
+            ...(extraction.usage ? { usage: extraction.usage } : {}),
+            ...(extraction.providerMetadata
+                ? { providerMetadata: extraction.providerMetadata }
+                : {}),
+        };
+    }
+}
+export async function applyMemoryExtractionCandidate(candidate, itemStore, context, now) {
+    if (candidate.status !== "approved" && candidate.status !== "applied") {
+        throw new MemoryContractError("Only approved Memory candidates can be applied");
+    }
+    const memoryId = candidate.appliedMemoryId ?? `learned-${candidate.id}`;
+    const existingReplacement = await itemStore.get(memoryId, context, { includeInactive: true, includeExpired: true });
+    if (existingReplacement) {
+        if (existingReplacement.kind !== candidate.kind
+            || memoryScopeKey(existingReplacement.scope) !== memoryScopeKey(candidate.scope)
+            || existingReplacement.content !== candidate.content) {
+            throw new MemoryContractError("Learned Memory id conflicts with another item");
+        }
+        return memoryId;
+    }
+    const item = createMemoryItem({
+        id: memoryId,
+        scope: candidate.scope,
+        kind: candidate.kind,
+        content: candidate.content,
+        ...(candidate.summary ? { summary: candidate.summary } : {}),
+        ...(candidate.confidence === undefined ? {} : { confidence: candidate.confidence }),
+        status: "active",
+        provenance: {
+            source: "extraction",
+            actor: "system",
+            sourceId: candidate.source.turnId ?? candidate.id,
+            ...(candidate.source.runId ? { runId: candidate.source.runId } : {}),
+            ...(candidate.source.sessionId ? { sessionId: candidate.source.sessionId } : {}),
+            ...(candidate.source.messageIds?.[0]
+                ? { messageId: candidate.source.messageIds[0] }
+                : {}),
+        },
+    }, { now });
+    if (candidate.proposal.action === "supersede") {
+        const result = await itemStore.supersede(candidate.proposal.existingMemoryId, item, context);
+        if (!result)
+            throw new MemoryContractError("Superseded Memory no longer exists");
+    }
+    else {
+        await itemStore.create(item, context);
+    }
+    return memoryId;
+}
+function requiredRevision(value, label) {
+    if (typeof value !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u.test(value)) {
+        throw new TypeError(`${label} is invalid`);
+    }
+    return value;
+}
+function assertBoundedVisibleContent(value, path) {
+    if (typeof value !== "string" || value.length > MAX_MEMORY_LEARNING_TURN_CHARACTERS) {
+        throw new MemoryContractError(`${path} must be a string with at most ${MAX_MEMORY_LEARNING_TURN_CHARACTERS} characters`);
+    }
+}
+function assertExtractorCandidate(value, allowedKinds, index) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new MemoryContractError(`extractor candidate ${index} must be an object`);
+    }
+    const candidate = value;
+    const allowed = new Set(["kind", "content", "summary", "confidence", "evidence", "existingMemoryId"]);
+    const unknown = Object.keys(candidate).find((key) => !allowed.has(key));
+    if (unknown)
+        throw new MemoryContractError(`extractor candidate ${index}.${unknown} is unsupported`);
+    if (!allowedKinds.includes(candidate.kind)) {
+        throw new MemoryContractError(`extractor candidate ${index}.kind is not allowed`);
+    }
+    if (candidate.evidence !== "user") {
+        throw new MemoryContractError(`extractor candidate ${index} is not supported by the user message`);
+    }
+    if (typeof candidate.content !== "string" || candidate.content.trim().length === 0) {
+        throw new MemoryContractError(`extractor candidate ${index}.content is invalid`);
+    }
+    if (candidate.summary !== undefined && typeof candidate.summary !== "string") {
+        throw new MemoryContractError(`extractor candidate ${index}.summary is invalid`);
+    }
+    if (candidate.confidence !== undefined
+        && (typeof candidate.confidence !== "number"
+            || !Number.isFinite(candidate.confidence)
+            || candidate.confidence < 0
+            || candidate.confidence > 1)) {
+        throw new MemoryContractError(`extractor candidate ${index}.confidence is invalid`);
+    }
+    if (candidate.existingMemoryId !== undefined
+        && (typeof candidate.existingMemoryId !== "string"
+            || candidate.existingMemoryId.trim().length === 0)) {
+        throw new MemoryContractError(`extractor candidate ${index}.existingMemoryId is invalid`);
+    }
+}
+//# sourceMappingURL=learning.js.map

package/dist/memory/learning.js.map

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

package/dist/memory/learning.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=learning.test.d.ts.map

package/dist/memory/learning.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.test.d.ts","sourceRoot":"","sources":["../../src/memory/learning.test.ts"],"names":[],"mappings":""}

package/dist/memory/learning.test.js

@@ -0,0 +1,274 @@
+import { describe, expect, it, vi } from "vitest";
+import { DeterministicMemoryConsolidationPolicy, InMemoryMemoryExtractionStore, InMemoryMemoryItemStore, MemoryContractError, MemoryLearningService, createMemoryItem, evaluateMemoryTurnEligibility, } from "./index.js";
+const now = "2026-08-30T12:00:00.000Z";
+function turn(overrides = {}) {
+    return {
+        turnId: "turn-1",
+        requestId: "request-1",
+        runId: "run-1",
+        sessionId: "session-1",
+        agentName: "assistant",
+        surface: "chat",
+        terminalStatus: "succeeded",
+        userMessage: { id: "user-message-1", role: "user" },
+        assistantMessage: { id: "assistant-message-1", role: "assistant" },
+        trustedInvocation: { externalUserId: "user-1" },
+        occurredAt: now,
+        ...overrides,
+    };
+}
+const itemContext = {
+    namespace: "project-1",
+    access: {
+        projectId: "project-1",
+        agentName: "assistant",
+        externalUserId: "user-1",
+        sessionId: "session-1",
+    },
+    surface: "chat",
+    now,
+};
+const candidateContext = {
+    namespace: "project-1",
+    access: itemContext.access,
+};
+function extractor(candidates) {
+    return {
+        revision: "extractor-v1",
+        extract: vi.fn(async () => ({ candidates })),
+    };
+}
+function service(candidateValues, itemStore = new InMemoryMemoryItemStore()) {
+    const candidateStore = new InMemoryMemoryExtractionStore({ now: () => now });
+    const memoryExtractor = extractor(candidateValues);
+    return {
+        candidateStore,
+        itemStore,
+        memoryExtractor,
+        learning: new MemoryLearningService({
+            extractor: memoryExtractor,
+            policy: new DeterministicMemoryConsolidationPolicy({ itemStore }),
+            candidateStore,
+            itemStore,
+            now: () => now,
+        }),
+    };
+}
+function processInput(overrides = {}) {
+    return {
+        turn: turn(),
+        userContent: "I prefer concise weekly summaries.",
+        assistantContent: "I will keep them concise.",
+        mode: "suggest",
+        surfaces: ["chat", "channel"],
+        kinds: ["fact", "preference", "style", "open_thread"],
+        candidateContext,
+        itemContext,
+        ...overrides,
+    };
+}
+describe("automatic Memory turn eligibility", () => {
+    it.each([
+        ["learning_off", { mode: "off" }],
+        ["surface_disabled", { surfaces: ["channel"] }],
+        ["turn_not_succeeded", { turn: turn({ terminalStatus: "failed" }) }],
+        ["missing_external_user", { turn: turn({ trustedInvocation: {} }) }],
+        ["missing_visible_messages", {
+                turn: turn({ assistantMessage: undefined }),
+            }],
+    ])("rejects %s turns", (reason, override) => {
+        const values = override;
+        expect(evaluateMemoryTurnEligibility({
+            turn: values.turn ?? turn(),
+            mode: values.mode ?? "suggest",
+            surfaces: values.surfaces ?? ["chat", "channel"],
+        })).toMatchObject({ eligible: false, reason });
+    });
+    it("creates only the trusted external-user plus agent scope", () => {
+        expect(evaluateMemoryTurnEligibility({
+            turn: turn(),
+            mode: "automatic",
+            surfaces: ["chat"],
+        })).toEqual({
+            eligible: true,
+            scope: { kind: "user", subjectId: "user-1", agentName: "assistant" },
+        });
+    });
+});
+describe("MemoryLearningService", () => {
+    const preference = {
+        kind: "preference",
+        content: "Prefers concise weekly summaries.",
+        confidence: 0.96,
+        evidence: "user",
+    };
+    it("keeps valid suggestions pending without mutating active Memory", async () => {
+        const { learning, candidateStore, itemStore } = service([preference]);
+        const result = await learning.process(processInput());
+        expect(result).toMatchObject({ eligible: true, appliedMemoryIds: [] });
+        expect(result.candidates).toHaveLength(1);
+        expect(result.candidates[0]).toMatchObject({
+            status: "pending",
+            idempotencyKey: "turn-1:extractor-v1:deterministic-v1:0",
+            source: {
+                turnId: "turn-1",
+                extractorRevision: "extractor-v1",
+                policyRevision: "deterministic-v1",
+            },
+            scope: { kind: "user", subjectId: "user-1", agentName: "assistant" },
+        });
+        expect(await candidateStore.list({}, candidateContext)).toHaveLength(1);
+        expect(await itemStore.list({}, itemContext)).toEqual([]);
+    });
+    it("auto-applies only high-confidence safe user evidence", async () => {
+        const { learning, itemStore } = service([preference]);
+        const result = await learning.process(processInput({ mode: "automatic" }));
+        expect(result.candidates[0]?.status).toBe("applied");
+        expect(result.appliedMemoryIds).toHaveLength(1);
+        expect(await itemStore.list({}, itemContext)).toEqual([
+            expect.objectContaining({
+                id: result.appliedMemoryIds[0],
+                status: "active",
+                content: preference.content,
+                provenance: expect.objectContaining({
+                    source: "extraction",
+                    sourceId: "turn-1",
+                    messageId: "user-message-1",
+                }),
+            }),
+        ]);
+    });
+    it("makes an automatically learned Memory available to hybrid retrieval and reranking", async () => {
+        const embeddingProvider = {
+            identity: async () => ({
+                provider: "fixture",
+                model: "meaning-v1",
+                dimensions: 2,
+                revision: "r1",
+            }),
+            embed: async ({ texts, task }) => ({
+                identity: {
+                    provider: "fixture",
+                    model: "meaning-v1",
+                    dimensions: 2,
+                    revision: "r1",
+                },
+                vectors: texts.map((text) => (/concise|short|format/i.test(text) ? [1, 0] : [0, 1])),
+                usage: { inputTokens: texts.length },
+                providerMetadata: { task },
+            }),
+        };
+        const reranker = {
+            rerank: vi.fn(async ({ candidates }) => ({
+                ranking: candidates.map(({ id }) => ({ id, score: 0.99 })),
+            })),
+        };
+        const itemStore = new InMemoryMemoryItemStore({}, undefined, {
+            embeddingProvider,
+            reranker,
+            rerankLimit: 5,
+            rerankFailureMode: "strict",
+        });
+        const { learning } = service([preference], itemStore);
+        const learned = await learning.process(processInput({ mode: "automatic" }));
+        const results = await itemStore.search({
+            query: "How should the weekly report be formatted?",
+            kinds: ["preference"],
+            scope: { kind: "user", subjectId: "user-1", agentName: "assistant" },
+            maxResults: 5,
+            tokenBudget: 1_000,
+        }, itemContext);
+        expect(learned.appliedMemoryIds).toHaveLength(1);
+        expect(results).toHaveLength(1);
+        expect(results[0]).toMatchObject({
+            item: {
+                id: learned.appliedMemoryIds[0],
+                provenance: {
+                    source: "extraction",
+                    sourceId: "turn-1",
+                },
+            },
+            retrievalMode: "hybrid",
+            scores: { rerank: 0.99 },
+        });
+        expect(reranker.rerank).toHaveBeenCalledOnce();
+    });
+    it("rejects secret-like content and never creates active Memory", async () => {
+        const { learning, itemStore } = service([{
+                ...preference,
+                content: "Use api_key=abcdefghijklmnop1234 for deployments.",
+            }]);
+        const result = await learning.process(processInput({ mode: "automatic" }));
+        expect(result.candidates[0]).toMatchObject({
+            status: "rejected",
+            decision: { reason: "sensitive_content" },
+        });
+        expect(await itemStore.list({}, itemContext)).toEqual([]);
+    });
+    it("rejects exact duplicates without producing a second active item", async () => {
+        const itemStore = new InMemoryMemoryItemStore();
+        await itemStore.create(createMemoryItem({
+            id: "existing-1",
+            scope: { kind: "user", subjectId: "user-1", agentName: "assistant" },
+            kind: "preference",
+            content: preference.content,
+            provenance: { source: "explicit", actor: "user", sourceId: "request-0" },
+        }, { now: () => now }), itemContext);
+        const { learning } = service([preference], itemStore);
+        const result = await learning.process(processInput({ mode: "automatic" }));
+        expect(result.candidates[0]).toMatchObject({
+            status: "rejected",
+            proposal: { action: "duplicate", existingMemoryId: "existing-1" },
+            decision: { reason: "exact_duplicate" },
+        });
+        expect(await itemStore.list({}, itemContext)).toHaveLength(1);
+    });
+    it("rejects a delayed supersede after a newer explicit correction", async () => {
+        const itemStore = new InMemoryMemoryItemStore();
+        await itemStore.create(createMemoryItem({
+            id: "newer-preference",
+            scope: { kind: "user", subjectId: "user-1", agentName: "assistant" },
+            kind: "preference",
+            content: "Prefers detailed summaries.",
+            provenance: { source: "explicit", actor: "user", sourceId: "request-new" },
+        }, { now: () => "2026-08-30T12:05:00.000Z" }), itemContext);
+        const { learning } = service([{
+                ...preference,
+                existingMemoryId: "newer-preference",
+            }], itemStore);
+        const result = await learning.process(processInput({ mode: "automatic" }));
+        expect(result.candidates[0]).toMatchObject({
+            status: "rejected",
+            decision: { reason: "stale_extraction" },
+        });
+        expect((await itemStore.get("newer-preference", itemContext))?.status).toBe("active");
+    });
+    it("is idempotent across duplicate jobs and extractor retries", async () => {
+        const { learning, candidateStore, itemStore } = service([preference]);
+        const first = await learning.process(processInput({ mode: "automatic" }));
+        const replay = await learning.process(processInput({ mode: "automatic" }));
+        expect(replay.appliedMemoryIds).toEqual(first.appliedMemoryIds);
+        expect(await candidateStore.list({}, candidateContext)).toHaveLength(1);
+        expect(await itemStore.list({}, itemContext)).toHaveLength(1);
+    });
+    it.each([
+        ["assistant-only evidence", [{ ...preference, evidence: "assistant" }]],
+        ["unknown kind", [{ ...preference, kind: "instruction" }]],
+        ["NaN confidence", [{ ...preference, confidence: Number.NaN }]],
+        ["unknown field", [{ ...preference, scope: { kind: "org" } }]],
+        ["too many candidates", Array.from({ length: 21 }, () => preference)],
+    ])("fails closed on malformed extractor output: %s", async (_label, values) => {
+        const { learning } = service(values);
+        await expect(learning.process(processInput({ mode: "automatic" })))
+            .rejects.toThrow(MemoryContractError);
+    });
+    it("does not invoke the extractor for an untrusted end-user", async () => {
+        const { learning, memoryExtractor } = service([preference]);
+        const result = await learning.process(processInput({
+            turn: turn({ trustedInvocation: {} }),
+        }));
+        expect(result).toMatchObject({ eligible: false, reason: "missing_external_user" });
+        expect(memoryExtractor.extract).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=learning.test.js.map

package/dist/memory/learning.test.js.map

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