@botbotgo/agent-harness 0.0.474 → 0.0.476

package/dist/knowledge/module.js

@@ -1,909 +1,12 @@
-import { createPersistentId } from "../utils/id.js";
-import { findMemoryRecordById, getMemoryRecord, listMemoryRecordsForScopes, persistStructuredMemoryRecords, removeMemoryRecord, updateMemoryRecord, } from "../runtime/harness/system/runtime-memory-records.js";
-import { consolidateStructuredMemoryScope } from "../runtime/harness/system/runtime-memory-consolidation.js";
-import { renderMemoryCandidatesMarkdown } from "../runtime/harness/system/runtime-memory-candidates.js";
-import { shouldRecallDurableMemory, normalizeLangMemMemoryKind, shouldStoreMemoryCandidate, isNonDurableTranscriptWorkflowMemory, } from "../runtime/harness/system/runtime-memory-policy.js";
-const ALL_SCOPES = ["session", "agent", "workspace", "user", "project"];
-const TITLE_BY_SCOPE = {
-    session: "Session Structured Memory",
-    agent: "Agent Structured Memory",
-    workspace: "Workspace Structured Memory",
-    user: "User Structured Memory",
-    project: "Project Structured Memory",
-};
-function normalizeRuntimeContext(context) {
-    if (typeof context.agentId !== "string" || context.agentId.trim().length === 0) {
-        throw new Error("knowledge operations require agentId in runtime context.");
-    }
-    return {
-        ...context,
-        agentId: context.agentId,
-        userId: context.userId ?? "default",
-        projectId: context.projectId ?? context.workspaceId,
-    };
-}
-function summarizeMemoryContent(content) {
-    return (content.trim().split("\n")[0] || content.trim()).slice(0, 240);
-}
-function normalizeMemoryScope(scope) {
-    if (scope === "agent" || scope === "workspace" || scope === "user" || scope === "project") {
-        return scope;
-    }
-    return "session";
-}
-function extractCandidateScopeOptions(candidate) {
-    if (candidate.scope) {
-        return [normalizeMemoryScope(candidate.scope)];
-    }
-    const provenance = typeof candidate.provenance === "object" && candidate.provenance !== null && !Array.isArray(candidate.provenance)
-        ? candidate.provenance
-        : undefined;
-    const scopeOptions = Array.isArray(provenance?.scopeOptions)
-        ? provenance.scopeOptions.filter((item) => item === "session" || item === "agent" || item === "workspace" || item === "user" || item === "project")
-        : [];
-    return scopeOptions.length > 0 ? Array.from(new Set(scopeOptions)) : ["session"];
-}
-function resolveRecallScopes(input, context) {
-    if (Array.isArray(input.scopes) && input.scopes.length > 0) {
-        return Array.from(new Set(input.scopes));
-    }
-    const scopes = new Set(["session", "agent", "workspace"]);
-    if (context.userId) {
-        scopes.add("user");
-    }
-    if (context.projectId) {
-        scopes.add("project");
-    }
-    return Array.from(scopes);
-}
-function matchesMemoryFilters(record, filters) {
-    const sessionId = String(record.provenance.sessionId ?? "");
-    if (filters.sessionId && sessionId !== filters.sessionId) {
-        return false;
-    }
-    if (filters.agentId && record.provenance.agentId !== filters.agentId) {
-        return false;
-    }
-    if (filters.workspaceId && record.provenance.workspaceId !== filters.workspaceId) {
-        return false;
-    }
-    if (filters.userId && record.provenance.userId !== filters.userId) {
-        return false;
-    }
-    if (filters.projectId && record.provenance.projectId !== filters.projectId) {
-        return false;
-    }
-    return true;
-}
-function matchesRecallScope(record, filters) {
-    if (record.scope === "session") {
-        return typeof filters.sessionId === "string"
-            && String(record.provenance.sessionId ?? "") === filters.sessionId;
-    }
-    if (record.scope === "agent") {
-        return String(record.provenance.agentId ?? "") === filters.agentId;
-    }
-    if (record.scope === "workspace") {
-        return String(record.provenance.workspaceId ?? filters.workspaceId) === filters.workspaceId;
-    }
-    if (record.scope === "user") {
-        return String(record.provenance.userId ?? "default") === filters.userId;
-    }
-    return String(record.provenance.projectId ?? filters.workspaceId) === filters.projectId;
-}
-function getMemoryScopeBoost(scope) {
-    if (scope === "session") {
-        return 4;
-    }
-    if (scope === "agent") {
-        return 2;
-    }
-    if (scope === "workspace") {
-        return 1;
-    }
-    return 0;
-}
-function memoryFreshnessBoost(value) {
-    return Math.max(0, 1 - ((Date.now() - Date.parse(value)) / (1000 * 60 * 60 * 24 * 365)));
-}
-function scoreStructuredRecord(record) {
-    return (getMemoryScopeBoost(record.scope) +
-        memoryFreshnessBoost(record.lastConfirmedAt) +
-        record.confidence);
-}
-function characterGramSet(value) {
-    const normalized = normalizeCompareText(value).replace(/\s+/g, "");
-    const grams = new Set();
-    if (normalized.length < 2) {
-        if (normalized.length > 0) {
-            grams.add(normalized);
-        }
-        return grams;
-    }
-    for (let index = 0; index < normalized.length - 1; index += 1) {
-        grams.add(normalized.slice(index, index + 2));
-    }
-    return grams;
-}
-function characterGramSimilarity(left, right) {
-    const leftGrams = characterGramSet(left);
-    const rightGrams = characterGramSet(right);
-    if (leftGrams.size === 0 || rightGrams.size === 0) {
-        return 0;
-    }
-    let intersection = 0;
-    for (const gram of leftGrams) {
-        if (rightGrams.has(gram)) {
-            intersection += 1;
-        }
-    }
-    const union = new Set([...leftGrams, ...rightGrams]).size;
-    return union === 0 ? 0 : intersection / union;
-}
-function textSimilarity(left, right) {
-    return Math.max(jaccardTextSimilarity(left, right), characterGramSimilarity(left, right));
-}
-function scoreStructuredRecordForQuery(record, query) {
-    let score = scoreStructuredRecord(record);
-    score += textSimilarity(record.summary, query) * 5;
-    score += textSimilarity(record.content, query) * 4;
-    if (record.knowledgeIdentity) {
-        score += textSimilarity(record.knowledgeIdentity, query) * 2;
-    }
-    if (record.operationalRule) {
-        score += textSimilarity(record.operationalRule.trigger, query) * 3;
-        score += textSimilarity(record.operationalRule.target, query) * 2;
-        if (record.operationalRule.effect === "invalidate" || record.knowledgeOperation === "delete") {
-            score += 0.5;
-        }
-    }
-    return score;
-}
-function normalizeMemoryDedupKey(record) {
-    return `${record.scope}::${record.summary.toLowerCase().replace(/\s+/g, " ").trim()}::${record.content.toLowerCase().replace(/\s+/g, " ").trim()}`;
-}
-function normalizeCompareText(value) {
-    return value.toLowerCase().replace(/\s+/g, " ").trim();
-}
-function tokenizeText(value) {
-    return new Set(value
-        .toLowerCase()
-        .split(/[^a-z0-9_]+/i)
-        .map((token) => token.trim())
-        .filter((token) => token.length > 2));
-}
-function jaccardTextSimilarity(left, right) {
-    const leftTokens = tokenizeText(left);
-    const rightTokens = tokenizeText(right);
-    if (leftTokens.size === 0 || rightTokens.size === 0) {
-        return 0;
-    }
-    let intersection = 0;
-    for (const token of leftTokens) {
-        if (rightTokens.has(token)) {
-            intersection += 1;
-        }
-    }
-    const union = new Set([...leftTokens, ...rightTokens]).size;
-    return union === 0 ? 0 : intersection / union;
-}
-function containsDeletionSignal(value) {
-    const normalized = normalizeCompareText(value);
-    if (!normalized) {
-        return false;
-    }
-    return [
-        "delete",
-        "deleted",
-        "remove",
-        "removed",
-        "revoked",
-        "forbidden",
-        "not allowed",
-        "no longer",
-        "unavailable",
-        "disabled",
-        "deprecated",
-        "取消",
-        "撤销",
-        "删除",
-        "已删除",
-        "删掉",
-        "移除",
-        "不再",
-        "不可用",
-        "不能",
-        "无法",
-        "禁用",
-        "废弃",
-    ].some((signal) => normalized.includes(signal));
-}
-function extractSalientLiterals(value) {
-    const results = new Set();
-    const normalized = value.trim();
-    if (!normalized) {
-        return results;
-    }
-    for (const match of normalized.matchAll(/[`'"]([^`'"]{1,64})[`'"]/g)) {
-        const literal = match[1]?.trim().toLowerCase();
-        if (literal && literal.length >= 2) {
-            results.add(literal);
-        }
-    }
-    for (const match of normalized.matchAll(/\b[a-z][a-z0-9._/-]{1,63}\b/gi)) {
-        const token = match[0]?.trim().toLowerCase();
-        if (token && !["system", "startup", "command", "memory", "instruction", "user", "deleted"].includes(token)) {
-            results.add(token);
-        }
-    }
-    return results;
-}
-function sharesSalientLiteral(left, right) {
-    const leftLiterals = extractSalientLiterals(left);
-    const rightLiterals = extractSalientLiterals(right);
-    if (leftLiterals.size === 0 || rightLiterals.size === 0) {
-        return false;
-    }
-    for (const literal of leftLiterals) {
-        if (rightLiterals.has(literal)) {
-            return true;
-        }
-    }
-    return false;
-}
-function mergeScoredRecords(...groups) {
-    const merged = new Map();
-    for (const group of groups) {
-        for (const item of group) {
-            const existing = merged.get(item.record.id);
-            if (!existing || item.score > existing.score) {
-                merged.set(item.record.id, item);
-            }
-        }
-    }
-    return Array.from(merged.values())
-        .sort((left, right) => right.score - left.score || right.record.lastConfirmedAt.localeCompare(left.record.lastConfirmedAt))
-        .map((item) => item.record);
-}
-function selectRelevantExistingRecords(candidates, existingRecords) {
-    const scored = new Map();
-    for (const candidate of candidates) {
-        const candidateScopes = new Set(extractCandidateScopeOptions(candidate));
-        const content = normalizeCompareText(candidate.content);
-        const summary = normalizeCompareText(candidate.summary ?? summarizeMemoryContent(candidate.content));
-        const sourceRef = typeof candidate.sourceRef === "string" ? candidate.sourceRef.trim() : "";
-        const candidateText = `${candidate.summary ?? ""}\n${candidate.content}`;
-        const deletionSignal = containsDeletionSignal(candidateText);
-        for (const record of existingRecords) {
-            if (!candidateScopes.has(record.scope)) {
-                continue;
-            }
-            let score = 0;
-            let deterministicMatch = false;
-            if (sourceRef && record.sourceRefs.includes(sourceRef)) {
-                score += 10;
-                deterministicMatch = true;
-            }
-            if (normalizeCompareText(record.content) === content) {
-                score += 9;
-                deterministicMatch = true;
-            }
-            if (normalizeCompareText(record.summary) === summary) {
-                score += 8;
-                deterministicMatch = true;
-            }
-            const similarityScore = textSimilarity(record.summary, candidate.summary ?? candidate.content) * 4
-                + textSimilarity(record.content, candidate.content) * 3;
-            score += similarityScore;
-            if (deletionSignal) {
-                const ruleTarget = record.operationalRule?.target?.trim().toLowerCase();
-                if (ruleTarget && candidateText.toLowerCase().includes(ruleTarget)) {
-                    score += 12;
-                    deterministicMatch = true;
-                }
-                if (sharesSalientLiteral(candidateText, `${record.summary}\n${record.content}`)) {
-                    score += 8;
-                    deterministicMatch = true;
-                }
-            }
-            if (!deterministicMatch && similarityScore < 1) {
-                continue;
-            }
-            if (score <= 0) {
-                continue;
-            }
-            const existing = scored.get(record.id);
-            if (!existing || score > existing.score) {
-                scored.set(record.id, { record, score });
-            }
-        }
-    }
-    return Array.from(scored.values())
-        .sort((left, right) => right.score - left.score || right.record.lastConfirmedAt.localeCompare(left.record.lastConfirmedAt))
-        .map((item) => item.record);
-}
-async function selectVectorRelevantExistingRecords(input) {
-    const vectorStore = await input.resolveVectorStore();
-    if (!vectorStore) {
-        return [];
-    }
-    const existingById = new Map(input.existingRecords.map((record) => [record.id, record]));
-    const scored = new Map();
-    try {
-        for (const candidate of input.candidates) {
-            const candidateScopes = new Set(extractCandidateScopeOptions(candidate));
-            const query = [candidate.summary?.trim(), candidate.content.trim()].filter((value) => !!value && value.length > 0).join("\n");
-            if (!query) {
-                continue;
-            }
-            const hits = await vectorStore.similaritySearch(query, 8);
-            for (const hit of hits) {
-                const metadata = typeof hit.metadata === "object" && hit.metadata !== null && !Array.isArray(hit.metadata)
-                    ? hit.metadata
-                    : {};
-                const recordId = typeof metadata.recordId === "string" ? metadata.recordId : undefined;
-                if (!recordId) {
-                    continue;
-                }
-                const record = existingById.get(recordId);
-                if (!record || record.status !== "active" || !candidateScopes.has(record.scope)) {
-                    continue;
-                }
-                const score = (typeof hit.score === "number" ? hit.score : 0) + scoreStructuredRecordForQuery(record, query);
-                const existing = scored.get(record.id);
-                if (!existing || score > existing.score) {
-                    scored.set(record.id, { record, score });
-                }
-            }
-        }
-    }
-    catch {
-        return [];
-    }
-    return Array.from(scored.values())
-        .sort((left, right) => right.score - left.score || right.record.lastConfirmedAt.localeCompare(left.record.lastConfirmedAt));
-}
-function sortPromptRecallRecords(items) {
-    return [...items].sort((left, right) => left.record.observedAt.localeCompare(right.record.observedAt)
-        || left.record.createdAt.localeCompare(right.record.createdAt)
-        || left.record.id.localeCompare(right.record.id));
-}
-function inferMem0MemoryKind(hit) {
-    const candidates = [
-        ...hit.categories,
-        typeof hit.metadata.kind === "string" ? hit.metadata.kind : undefined,
-        typeof hit.metadata.memoryType === "string" ? hit.metadata.memoryType : undefined,
-    ].filter((value) => typeof value === "string" && value.trim().length > 0);
-    for (const candidate of candidates) {
-        const kind = normalizeLangMemMemoryKind(candidate);
-        if (kind === "semantic" || kind === "episodic" || kind === "procedural") {
-            return kind;
-        }
-    }
-    return "semantic";
-}
-function inferMem0MemoryScope(hit, filters) {
-    const metadataScope = typeof hit.metadata.scope === "string" ? hit.metadata.scope : undefined;
-    if (metadataScope === "session" || metadataScope === "agent" || metadataScope === "workspace" || metadataScope === "user" || metadataScope === "project") {
-        return metadataScope;
-    }
-    if (typeof hit.metadata.sessionId === "string" && filters.sessionId && hit.metadata.sessionId === filters.sessionId) {
-        return "session";
-    }
-    if (hit.agentId === filters.agentId || hit.metadata.agentId === filters.agentId) {
-        return "agent";
-    }
-    return "workspace";
-}
-function createMem0MemoryRecord(hit, filters) {
-    const scope = inferMem0MemoryScope(hit, filters);
-    const kind = inferMem0MemoryKind(hit);
-    const summary = hit.memory.split("\n")[0]?.trim() || hit.memory;
-    return {
-        id: `mem0:${hit.id}`,
-        canonicalKey: `mem0:${hit.id}`,
-        kind,
-        scope,
-        content: hit.memory,
-        summary: summary.slice(0, 240),
-        status: "active",
-        confidence: Math.max(0, Math.min(1, hit.score || 0.5)),
-        createdAt: hit.createdAt,
-        observedAt: hit.createdAt,
-        lastConfirmedAt: hit.updatedAt,
-        sourceType: "mem0-search",
-        sourceRefs: [`mem0:${hit.id}`],
-        tags: hit.categories,
-        provenance: {
-            source: "mem0",
-            sessionId: typeof hit.metadata.sessionId === "string" ? hit.metadata.sessionId : filters.sessionId,
-            requestId: typeof hit.metadata.requestId === "string" ? hit.metadata.requestId : undefined,
-            agentId: hit.agentId ?? (typeof hit.metadata.agentId === "string" ? hit.metadata.agentId : filters.agentId),
-            workspaceId: filters.workspaceId,
-            userId: filters.userId,
-            projectId: filters.projectId,
-            ...hit.metadata,
-        },
-        revision: 1,
-        supersedes: [],
-        conflictsWith: [],
-    };
-}
-export class DefaultKnowledgeModule {
-    deps;
-    constructor(deps) {
-        this.deps = deps;
-    }
-    async memorize(input, context) {
-        if (!Array.isArray(input.records)) {
-            throw new Error("memorize requires input.records to be an array.");
-        }
-        const normalizedContext = normalizeRuntimeContext(context);
-        const candidates = input.records
-            .filter((record) => typeof record === "object" && record !== null)
-            .filter((record) => record.noStore !== true);
-        if (candidates.length === 0) {
-            return { records: [], decisions: [] };
-        }
-        if (candidates.some((record) => typeof record.content !== "string" || record.content.trim().length === 0)) {
-            throw new Error("memorize requires every record to include non-empty content.");
-        }
-        if (candidates.some((record) => (record.scope ?? "session") === "session") && !normalizedContext.sessionId) {
-            throw new Error("memorize requires sessionId when storing session-scoped memory.");
-        }
-        const recordedAt = normalizedContext.recordedAt ?? new Date().toISOString();
-        const requestId = normalizedContext.requestId ?? createPersistentId(new Date(recordedAt));
-        const sessionId = normalizedContext.sessionId ?? `memory-api-${requestId}`;
-        return this.memorizeCandidates(candidates.map((record) => ({ ...record, content: record.content.trim() })), {
-            ...normalizedContext,
-            requestId,
-            sessionId,
-            recordedAt,
-        }, {
-            storeCandidateLog: input.storeCandidateLog !== false,
-            forceStore: input.forceStore === true,
-        });
-    }
-    async recall(input, context) {
-        if (typeof input.query !== "string" || input.query.trim().length === 0) {
-            throw new Error("recall requires a non-empty query.");
-        }
-        const normalizedContext = normalizeRuntimeContext(context);
-        const scopes = resolveRecallScopes(input, normalizedContext);
-        const topK = typeof input.topK === "number" && Number.isInteger(input.topK) && input.topK > 0
-            ? input.topK
-            : (this.deps.policy?.retrieval.defaultTopK ?? 5);
-        const kinds = input.kinds?.length ? new Set(input.kinds) : null;
-        const items = (await this.rankRecallCandidates({
-            query: input.query.trim(),
-            scopes,
-            kinds,
-            topK,
-            includeStale: input.includeStale === true,
-            context: normalizedContext,
-        }))
-            .slice(0, topK)
-            .map(({ record }) => record);
-        return { items };
-    }
-    async buildPromptRecall(input, context) {
-        if (!shouldRecallDurableMemory(input.query)) {
-            return { items: [] };
-        }
-        const normalizedContext = normalizeRuntimeContext(context);
-        const ranked = (await this.rankRecallCandidates({
-            query: input.query,
-            scopes: input.scopes ?? ALL_SCOPES,
-            kinds: input.kinds?.length ? new Set(input.kinds) : null,
-            topK: input.topK ?? this.deps.policy?.retrieval.maxPromptMemories ?? 8,
-            includeStale: input.includeStale === true,
-            context: normalizedContext,
-        }))
-            .filter(({ record }) => !isNonDurableTranscriptWorkflowMemory(record))
-            .map((item) => {
-            const scopeBoost = item.record.scope === "session"
-                ? 4
-                : item.record.scope === "agent"
-                    ? 3
-                    : item.record.scope === "user"
-                        ? 2
-                        : 1;
-            return {
-                record: item.record,
-                scope: item.record.scope,
-                content: [
-                    `# Durable ${item.record.scope[0].toUpperCase()}${item.record.scope.slice(1)} Memory`,
-                    "",
-                    `- summary: ${item.record.summary}`,
-                    `- kind: ${item.record.kind}`,
-                    `- scope: ${item.record.scope}`,
-                    `- confidence: ${item.record.confidence.toFixed(2)}`,
-                    ...(item.record.knowledgeIdentity
-                        ? [
-                            `- knowledge_identity: ${item.record.knowledgeIdentity}`,
-                            `- knowledge_operation: ${item.record.knowledgeOperation ?? "create"}`,
-                        ]
-                        : []),
-                    "",
-                    item.record.content,
-                ].join("\n"),
-                score: scopeBoost +
-                    memoryFreshnessBoost(item.record.lastConfirmedAt) +
-                    item.record.confidence,
-            };
-        })
-            .sort((left, right) => right.score - left.score);
-        if (ranked.length === 0) {
-            return { items: [] };
-        }
-        const maxPromptMemories = this.deps.policy?.retrieval.maxPromptMemories ?? 8;
-        const selected = ranked.slice(0, maxPromptMemories);
-        if (selected.length === 0) {
-            return { items: [] };
-        }
-        const orderedSelected = sortPromptRecallRecords(selected);
-        return {
-            items: orderedSelected.map((entry) => entry.record),
-            context: orderedSelected.map((entry) => entry.content).join("\n\n"),
-        };
-    }
-    async buildPromptContext(input, context) {
-        const promptRecall = await this.buildPromptRecall(input, context);
-        return promptRecall.context;
-    }
-    async list(input = {}, context) {
-        const normalizedContext = { ...context };
-        const scopes = Array.isArray(input.scopes) && input.scopes.length > 0
-            ? Array.from(new Set(input.scopes))
-            : ALL_SCOPES;
-        const kinds = input.kinds?.length ? new Set(input.kinds) : null;
-        const statuses = input.status?.length ? new Set(input.status) : new Set(["active"]);
-        const limit = typeof input.limit === "number" && Number.isInteger(input.limit) && input.limit > 0
-            ? input.limit
-            : Number.POSITIVE_INFINITY;
-        const items = (await listMemoryRecordsForScopes(this.deps.store, scopes))
-            .filter((record) => statuses.has(record.status))
-            .filter((record) => !kinds || kinds.has(record.kind))
-            .filter((record) => matchesMemoryFilters(record, {
-            sessionId: normalizedContext.sessionId,
-            agentId: normalizedContext.agentId,
-            workspaceId: normalizedContext.workspaceId,
-            userId: normalizedContext.userId,
-            projectId: normalizedContext.projectId,
-        }))
-            .sort((left, right) => right.lastConfirmedAt.localeCompare(left.lastConfirmedAt))
-            .slice(0, limit);
-        return { items };
-    }
-    async update(input, context) {
-        if (typeof input.memoryId !== "string" || input.memoryId.trim().length === 0) {
-            throw new Error("updateMemory requires a non-empty memoryId.");
-        }
-        const existing = await findMemoryRecordById(this.deps.store, input.memoryId.trim());
-        if (!existing) {
-            throw new Error(`Memory record not found: ${input.memoryId}`);
-        }
-        const updatedAt = new Date().toISOString();
-        const nextContent = typeof input.content === "string" ? input.content.trim() : existing.content;
-        if (nextContent.length === 0) {
-            throw new Error("updateMemory requires content to remain non-empty.");
-        }
-        const next = {
-            ...existing,
-            content: nextContent,
-            summary: typeof input.summary === "string"
-                ? input.summary.trim() || summarizeMemoryContent(nextContent)
-                : (typeof input.content === "string" ? summarizeMemoryContent(nextContent) : existing.summary),
-            status: input.status ?? existing.status,
-            confidence: typeof input.confidence === "number" ? Math.max(0, Math.min(1, input.confidence)) : existing.confidence,
-            expiresAt: input.expiresAt === undefined ? existing.expiresAt : (input.expiresAt ?? undefined),
-            sourceType: typeof input.sourceType === "string" && input.sourceType.trim().length > 0 ? input.sourceType.trim() : existing.sourceType,
-            sourceRefs: Array.isArray(input.sourceRefs)
-                ? Array.from(new Set(input.sourceRefs.map((item) => item.trim()).filter((item) => item.length > 0)))
-                : existing.sourceRefs,
-            tags: Array.isArray(input.tags)
-                ? Array.from(new Set(input.tags.map((item) => item.trim()).filter((item) => item.length > 0)))
-                : existing.tags,
-            knowledgeIdentity: typeof input.knowledgeIdentity === "string" && input.knowledgeIdentity.trim().length > 0
-                ? input.knowledgeIdentity.trim()
-                : existing.knowledgeIdentity,
-            knowledgeOperation: input.knowledgeOperation === "create" || input.knowledgeOperation === "update" || input.knowledgeOperation === "delete"
-                ? input.knowledgeOperation
-                : existing.knowledgeOperation,
-            observedAt: typeof input.observedAt === "string" && input.observedAt.trim().length > 0 ? input.observedAt : existing.observedAt,
-            lastConfirmedAt: typeof input.lastConfirmedAt === "string" && input.lastConfirmedAt.trim().length > 0
-                ? input.lastConfirmedAt
-                : updatedAt,
-            provenance: input.provenance ? { ...existing.provenance, ...input.provenance } : existing.provenance,
-            revision: existing.revision + 1,
-        };
-        await updateMemoryRecord(this.deps.store, next, updatedAt);
-        await this.rebuildVectorIndex();
-        await this.refreshStructuredMemoryScope(next, context);
-        return next;
-    }
-    async remove(input, context) {
-        if (typeof input.memoryId !== "string" || input.memoryId.trim().length === 0) {
-            throw new Error("removeMemory requires a non-empty memoryId.");
-        }
-        const existing = await findMemoryRecordById(this.deps.store, input.memoryId.trim());
-        if (!existing) {
-            throw new Error(`Memory record not found: ${input.memoryId}`);
-        }
-        await removeMemoryRecord(this.deps.store, existing.scope, existing.id);
-        await this.rebuildVectorIndex();
-        await this.refreshStructuredMemoryScope(existing, context);
-        return existing;
-    }
-    async memorizeCandidates(candidates, context, options) {
-        const normalizedContext = normalizeRuntimeContext(context);
-        const validCandidates = candidates
-            .filter((candidate) => candidate.noStore !== true)
-            .filter((candidate) => typeof candidate.content === "string" && candidate.content.trim().length > 0)
-            .map((candidate) => ({ ...candidate, content: candidate.content.trim() }));
-        if (validCandidates.length === 0) {
-            return { records: [], decisions: [] };
-        }
-        const relevantScopes = Array.from(new Set(validCandidates.flatMap((candidate) => extractCandidateScopeOptions(candidate))));
-        const existingRecords = await listMemoryRecordsForScopes(this.deps.store, relevantScopes);
-        const vectorRelatedExistingRecords = await selectVectorRelevantExistingRecords({
-            candidates: validCandidates,
-            existingRecords,
-            resolveVectorStore: this.deps.resolveVectorStore,
-        });
-        const deterministicRelatedExistingRecords = selectRelevantExistingRecords(validCandidates, existingRecords)
-            .map((record) => ({
-            record,
-            score: scoreStructuredRecord(record),
-        }));
-        const relatedExistingRecords = mergeScoredRecords(vectorRelatedExistingRecords, deterministicRelatedExistingRecords);
-        const transformedCandidates = this.deps.transformCandidates
-            ? await this.deps.transformCandidates({ candidates: validCandidates, context: normalizedContext, existingRecords: relatedExistingRecords })
-            : validCandidates;
-        const storedCandidates = options.forceStore === true
-            ? transformedCandidates
-            : transformedCandidates.filter((candidate) => shouldStoreMemoryCandidate(this.deps.policy, candidate));
-        if (storedCandidates.length === 0) {
-            return { records: [], decisions: [] };
-        }
-        if (options.storeCandidateLog) {
-            await this.deps.store.put(["memories", "candidates", normalizedContext.sessionId ?? `memory-api-${normalizedContext.requestId ?? "unknown"}`], `${normalizedContext.requestId}.json`, {
-                requestId: normalizedContext.requestId,
-                sessionId: normalizedContext.sessionId,
-                storedAt: normalizedContext.recordedAt,
-                candidates: storedCandidates,
-            });
-        }
-        const persisted = await persistStructuredMemoryRecords({
-            store: this.deps.store,
-            candidates: storedCandidates,
-            sessionId: normalizedContext.sessionId ?? `memory-api-${normalizedContext.requestId ?? "unknown"}`,
-            requestId: normalizedContext.requestId ?? createPersistentId(new Date(normalizedContext.recordedAt ?? new Date().toISOString())),
-            agentId: normalizedContext.agentId,
-            workspaceId: normalizedContext.workspaceId,
-            userId: normalizedContext.userId ?? "default",
-            projectId: normalizedContext.projectId ?? normalizedContext.workspaceId,
-            recordedAt: normalizedContext.recordedAt ?? new Date().toISOString(),
-        });
-        await this.rebuildVectorIndex();
-        await this.refreshAfterWrite(storedCandidates, normalizedContext);
-        return persisted;
-    }
-    async refreshAfterWrite(candidates, context) {
-        const buckets = {
-            session: candidates.filter((candidate) => (candidate.scope ?? "session") === "session"),
-            agent: candidates.filter((candidate) => (candidate.scope ?? "session") === "agent"),
-            workspace: candidates.filter((candidate) => (candidate.scope ?? "session") === "workspace"),
-            user: candidates.filter((candidate) => (candidate.scope ?? "session") === "user"),
-            project: candidates.filter((candidate) => (candidate.scope ?? "session") === "project"),
-        };
-        const writes = [];
-        for (const scope of ALL_SCOPES) {
-            if (buckets[scope].length === 0) {
-                continue;
-            }
-            const maxEntries = scope === "session" ? 12 : 20;
-            writes.push(this.appendMemoryDigest(this.deps.resolveNamespace(scope, context), "tool-memory.md", buckets[scope], maxEntries, TITLE_BY_SCOPE[scope].replace("Structured", "Tool")));
-            writes.push(consolidateStructuredMemoryScope({
-                store: this.deps.store,
-                namespace: this.deps.resolveNamespace(scope, context),
-                title: TITLE_BY_SCOPE[scope],
-                scope,
-                maxEntries,
-                config: this.deps.maintenanceConfig ?? undefined,
-            }));
-        }
-        await Promise.all(writes);
-    }
-    async appendMemoryDigest(namespace, key, candidates, maxEntries, title) {
-        const existing = await this.deps.store.get(namespace, key);
-        const existingItems = Array.isArray(existing?.value?.items)
-            ? ((existing?.value).items ?? [])
-            : [];
-        const merged = [...existingItems];
-        for (const candidate of candidates) {
-            if (merged.some((entry) => entry.content === candidate.content && (entry.scope ?? "session") === (candidate.scope ?? "session"))) {
-                continue;
-            }
-            merged.push(candidate);
-        }
-        const recent = merged.slice(-maxEntries);
-        const taxonomyGroups = new Map();
-        for (const candidate of recent) {
-            const kind = normalizeLangMemMemoryKind(candidate.kind);
-            const current = taxonomyGroups.get(kind) ?? [];
-            current.push({ ...candidate, kind });
-            taxonomyGroups.set(kind, current);
-        }
-        await this.deps.store.put(namespace, key, {
-            content: `${renderMemoryCandidatesMarkdown(title, recent)}\n`,
-            items: recent,
-        });
-        await Promise.all(Array.from(taxonomyGroups.entries()).map(async ([kind, items]) => {
-            await this.deps.store.put(namespace, `${kind}.md`, {
-                content: `${renderMemoryCandidatesMarkdown(`${title} (${kind})`, items)}\n`,
-                items,
-            });
-        }));
-    }
-    async refreshStructuredMemoryScope(record, context) {
-        const provenance = record.provenance;
-        const namespaceContext = {
-            sessionId: provenance.sessionId,
-            agentId: provenance.agentId ?? context.agentId,
-            workspaceId: provenance.workspaceId ?? context.workspaceId,
-            userId: provenance.userId ?? context.userId,
-            projectId: provenance.projectId ?? context.projectId,
-        };
-        const maxEntries = record.scope === "session" ? 12 : 20;
-        await consolidateStructuredMemoryScope({
-            store: this.deps.store,
-            namespace: this.deps.resolveNamespace(record.scope, normalizeRuntimeContext(namespaceContext)),
-            title: TITLE_BY_SCOPE[record.scope],
-            scope: record.scope,
-            maxEntries,
-            config: this.deps.maintenanceConfig ?? undefined,
-        });
-    }
-    async rebuildVectorIndex() {
-        const vectorStore = await this.deps.resolveVectorStore();
-        if (!vectorStore) {
-            return;
-        }
-        const records = (await listMemoryRecordsForScopes(this.deps.store, ALL_SCOPES))
-            .filter((record) => record.status === "active");
-        try {
-            await vectorStore.delete({ deleteAll: true });
-            if (records.length === 0) {
-                return;
-            }
-            await vectorStore.addDocuments(records.map((record) => ({
-                pageContent: `${record.summary}\n${record.content}`,
-                metadata: {
-                    recordId: record.id,
-                    scope: record.scope,
-                    kind: record.kind,
-                    status: record.status,
-                    sessionId: record.provenance.sessionId,
-                    agentId: record.provenance.agentId,
-                    workspaceId: record.provenance.workspaceId,
-                    userId: record.provenance.userId,
-                    projectId: record.provenance.projectId,
-                    confidence: record.confidence,
-                    lastConfirmedAt: record.lastConfirmedAt,
-                },
-            })));
-        }
-        catch {
-            // Fail open: vector indexing must not break durable memory writes.
-        }
-    }
-    async rankRecallCandidates(input) {
-        const structuredRecords = await listMemoryRecordsForScopes(this.deps.store, input.scopes);
-        const ranked = structuredRecords
-            .filter((record) => matchesRecallScope(record, {
-            sessionId: input.context.sessionId,
-            agentId: input.context.agentId,
-            workspaceId: input.context.workspaceId,
-            userId: input.context.userId ?? "default",
-            projectId: input.context.projectId ?? input.context.workspaceId,
-        }))
-            .filter((record) => (input.includeStale ? record.status === "active" || record.status === "stale" : record.status === "active"))
-            .filter((record) => (input.kinds ? input.kinds.has(record.kind) : true))
-            .map((record) => ({
-            record,
-            score: scoreStructuredRecordForQuery(record, input.query),
-        }));
-        const deduped = new Map();
-        for (const item of ranked) {
-            deduped.set(normalizeMemoryDedupKey(item.record), item);
-        }
-        const vectorStore = await this.deps.resolveVectorStore();
-        if (vectorStore) {
-            try {
-                const vectorHits = await vectorStore.similaritySearch(input.query, Math.max(input.topK, this.deps.policy?.retrieval.maxPromptMemories ?? input.topK));
-                for (const hit of vectorHits) {
-                    const metadata = typeof hit.metadata === "object" && hit.metadata && !Array.isArray(hit.metadata)
-                        ? hit.metadata
-                        : {};
-                    const recordId = typeof metadata.recordId === "string" ? metadata.recordId : undefined;
-                    const scope = metadata.scope;
-                    if (!recordId || (scope !== "session" && scope !== "agent" && scope !== "workspace" && scope !== "user" && scope !== "project")) {
-                        continue;
-                    }
-                    const canonical = await getMemoryRecord(this.deps.store, scope, recordId);
-                    if (!canonical) {
-                        continue;
-                    }
-                    if (!matchesRecallScope(canonical, {
-                        sessionId: input.context.sessionId,
-                        agentId: input.context.agentId,
-                        workspaceId: input.context.workspaceId,
-                        userId: input.context.userId ?? "default",
-                        projectId: input.context.projectId ?? input.context.workspaceId,
-                    })) {
-                        continue;
-                    }
-                    if (input.includeStale ? canonical.status !== "active" && canonical.status !== "stale" : canonical.status !== "active") {
-                        continue;
-                    }
-                    if (input.kinds && !input.kinds.has(canonical.kind)) {
-                        continue;
-                    }
-                    const key = normalizeMemoryDedupKey(canonical);
-                    const score = scoreStructuredRecordForQuery(canonical, input.query) + (typeof hit.score === "number" ? hit.score : 0);
-                    const existing = deduped.get(key);
-                    if (!existing || score > existing.score) {
-                        deduped.set(key, { record: canonical, score });
-                    }
-                }
-            }
-            catch {
-                // Fail open to lexical/runtime ranking.
-            }
-        }
-        const supportsMem0Scope = input.scopes.some((scope) => scope === "session" || scope === "agent" || scope === "workspace");
-        const mem0SemanticRecall = this.deps.getMem0SemanticRecall?.() ?? null;
-        if (!mem0SemanticRecall || !supportsMem0Scope) {
-            return Array.from(deduped.values()).sort((left, right) => right.score - left.score);
-        }
-        try {
-            const hits = await mem0SemanticRecall.search({
-                query: input.query,
-                topK: Math.max(input.topK, this.deps.policy?.retrieval.maxPromptMemories ?? input.topK),
-                agentId: input.context.agentId,
-                sessionId: input.context.sessionId,
-            });
-            for (const hit of hits) {
-                const record = createMem0MemoryRecord(hit, {
-                    sessionId: input.context.sessionId,
-                    agentId: input.context.agentId,
-                    workspaceId: input.context.workspaceId,
-                    userId: input.context.userId ?? "default",
-                    projectId: input.context.projectId ?? input.context.workspaceId,
-                });
-                if (!input.scopes.includes(record.scope)) {
-                    continue;
-                }
-                if (input.kinds && !input.kinds.has(record.kind)) {
-                    continue;
-                }
-                const key = normalizeMemoryDedupKey(record);
-                if (deduped.has(key)) {
-                    continue;
-                }
-                deduped.set(key, {
-                    record,
-                    score: scoreStructuredRecordForQuery(record, input.query) + Math.max(0, Math.min(1, hit.score)) * 4,
-                });
-            }
-            return Array.from(deduped.values()).sort((left, right) => right.score - left.score);
-        }
-        catch {
-            return Array.from(deduped.values()).sort((left, right) => right.score - left.score);
-        }
-    }
-}
-export function createKnowledgeModule(dependencies) {
-    return new DefaultKnowledgeModule(dependencies);
-}
+import{createPersistentId as R}from"../utils/id.js";import{findMemoryRecordById as j,getMemoryRecord as D,listMemoryRecordsForScopes as h,persistStructuredMemoryRecords as P,removeMemoryRecord as V,updateMemoryRecord as N}from"../runtime/harness/system/runtime-memory-records.js";import{consolidateStructuredMemoryScope as b}from"../runtime/harness/system/runtime-memory-consolidation.js";import{renderMemoryCandidatesMarkdown as z}from"../runtime/harness/system/runtime-memory-candidates.js";import{shouldRecallDurableMemory as _,normalizeLangMemMemoryKind as q,shouldStoreMemoryCandidate as B,isNonDurableTranscriptWorkflowMemory as F}from"../runtime/harness/system/runtime-memory-policy.js";const k=["session","agent","workspace","user","project"],v={session:"Session Structured Memory",agent:"Agent Structured Memory",workspace:"Workspace Structured Memory",user:"User Structured Memory",project:"Project Structured Memory"};function w(t){if(typeof t.agentId!="string"||t.agentId.trim().length===0)throw new Error("knowledge operations require agentId in runtime context.");return{...t,agentId:t.agentId,userId:t.userId??"default",projectId:t.projectId??t.workspaceId}}function A(t){return(t.trim().split(`
+`)[0]||t.trim()).slice(0,240)}function G(t){return t==="agent"||t==="workspace"||t==="user"||t==="project"?t:"session"}function x(t){if(t.scope)return[G(t.scope)];const e=typeof t.provenance=="object"&&t.provenance!==null&&!Array.isArray(t.provenance)?t.provenance:void 0,o=Array.isArray(e?.scopeOptions)?e.scopeOptions.filter(r=>r==="session"||r==="agent"||r==="workspace"||r==="user"||r==="project"):[];return o.length>0?Array.from(new Set(o)):["session"]}function W(t,e){if(Array.isArray(t.scopes)&&t.scopes.length>0)return Array.from(new Set(t.scopes));const o=new Set(["session","agent","workspace"]);return e.userId&&o.add("user"),e.projectId&&o.add("project"),Array.from(o)}function U(t,e){const o=String(t.provenance.sessionId??"");return!(e.sessionId&&o!==e.sessionId||e.agentId&&t.provenance.agentId!==e.agentId||e.workspaceId&&t.provenance.workspaceId!==e.workspaceId||e.userId&&t.provenance.userId!==e.userId||e.projectId&&t.provenance.projectId!==e.projectId)}function $(t,e){return t.scope==="session"?typeof e.sessionId=="string"&&String(t.provenance.sessionId??"")===e.sessionId:t.scope==="agent"?String(t.provenance.agentId??"")===e.agentId:t.scope==="workspace"?String(t.provenance.workspaceId??e.workspaceId)===e.workspaceId:t.scope==="user"?String(t.provenance.userId??"default")===e.userId:String(t.provenance.projectId??e.workspaceId)===e.projectId}function Y(t){return t==="session"?4:t==="agent"?2:t==="workspace"?1:0}function T(t){return Math.max(0,1-(Date.now()-Date.parse(t))/(1e3*60*60*24*365))}function E(t){return Y(t.scope)+T(t.lastConfirmedAt)+t.confidence}function K(t){const e=I(t).replace(/\s+/g,""),o=new Set;if(e.length<2)return e.length>0&&o.add(e),o;for(let r=0;r<e.length-1;r+=1)o.add(e.slice(r,r+2));return o}function H(t,e){const o=K(t),r=K(e);if(o.size===0||r.size===0)return 0;let n=0;for(const m of o)r.has(m)&&(n+=1);const a=new Set([...o,...r]).size;return a===0?0:n/a}function y(t,e){return Math.max(Q(t,e),H(t,e))}function S(t,e){let o=E(t);return o+=y(t.summary,e)*5,o+=y(t.content,e)*4,t.knowledgeIdentity&&(o+=y(t.knowledgeIdentity,e)*2),t.operationalRule&&(o+=y(t.operationalRule.trigger,e)*3,o+=y(t.operationalRule.target,e)*2,(t.operationalRule.effect==="invalidate"||t.knowledgeOperation==="delete")&&(o+=.5)),o}function M(t){return`${t.scope}::${t.summary.toLowerCase().replace(/\s+/g," ").trim()}::${t.content.toLowerCase().replace(/\s+/g," ").trim()}`}function I(t){return t.toLowerCase().replace(/\s+/g," ").trim()}function L(t){return new Set(t.toLowerCase().split(/[^a-z0-9_]+/i).map(e=>e.trim()).filter(e=>e.length>2))}function Q(t,e){const o=L(t),r=L(e);if(o.size===0||r.size===0)return 0;let n=0;for(const m of o)r.has(m)&&(n+=1);const a=new Set([...o,...r]).size;return a===0?0:n/a}function J(t){const e=I(t);return e?["delete","deleted","remove","removed","revoked","forbidden","not allowed","no longer","unavailable","disabled","deprecated","\u53D6\u6D88","\u64A4\u9500","\u5220\u9664","\u5DF2\u5220\u9664","\u5220\u6389","\u79FB\u9664","\u4E0D\u518D","\u4E0D\u53EF\u7528","\u4E0D\u80FD","\u65E0\u6CD5","\u7981\u7528","\u5E9F\u5F03"].some(o=>e.includes(o)):!1}function O(t){const e=new Set,o=t.trim();if(!o)return e;for(const r of o.matchAll(/[`'"]([^`'"]{1,64})[`'"]/g)){const n=r[1]?.trim().toLowerCase();n&&n.length>=2&&e.add(n)}for(const r of o.matchAll(/\b[a-z][a-z0-9._/-]{1,63}\b/gi)){const n=r[0]?.trim().toLowerCase();n&&!["system","startup","command","memory","instruction","user","deleted"].includes(n)&&e.add(n)}return e}function X(t,e){const o=O(t),r=O(e);if(o.size===0||r.size===0)return!1;for(const n of o)if(r.has(n))return!0;return!1}function Z(...t){const e=new Map;for(const o of t)for(const r of o){const n=e.get(r.record.id);(!n||r.score>n.score)&&e.set(r.record.id,r)}return Array.from(e.values()).sort((o,r)=>r.score-o.score||r.record.lastConfirmedAt.localeCompare(o.record.lastConfirmedAt)).map(o=>o.record)}function ee(t,e){const o=new Map;for(const r of t){const n=new Set(x(r)),a=I(r.content),m=I(r.summary??A(r.content)),f=typeof r.sourceRef=="string"?r.sourceRef.trim():"",s=`${r.summary??""}
+${r.content}`,c=J(s);for(const d of e){if(!n.has(d.scope))continue;let i=0,l=!1;f&&d.sourceRefs.includes(f)&&(i+=10,l=!0),I(d.content)===a&&(i+=9,l=!0),I(d.summary)===m&&(i+=8,l=!0);const p=y(d.summary,r.summary??r.content)*4+y(d.content,r.content)*3;if(i+=p,c){const g=d.operationalRule?.target?.trim().toLowerCase();g&&s.toLowerCase().includes(g)&&(i+=12,l=!0),X(s,`${d.summary}
+${d.content}`)&&(i+=8,l=!0)}if(!l&&p<1||i<=0)continue;const u=o.get(d.id);(!u||i>u.score)&&o.set(d.id,{record:d,score:i})}}return Array.from(o.values()).sort((r,n)=>n.score-r.score||n.record.lastConfirmedAt.localeCompare(r.record.lastConfirmedAt)).map(r=>r.record)}async function te(t){const e=await t.resolveVectorStore();if(!e)return[];const o=new Map(t.existingRecords.map(n=>[n.id,n])),r=new Map;try{for(const n of t.candidates){const a=new Set(x(n)),m=[n.summary?.trim(),n.content.trim()].filter(s=>!!s&&s.length>0).join(`
+`);if(!m)continue;const f=await e.similaritySearch(m,8);for(const s of f){const c=typeof s.metadata=="object"&&s.metadata!==null&&!Array.isArray(s.metadata)?s.metadata:{},d=typeof c.recordId=="string"?c.recordId:void 0;if(!d)continue;const i=o.get(d);if(!i||i.status!=="active"||!a.has(i.scope))continue;const l=(typeof s.score=="number"?s.score:0)+S(i,m),p=r.get(i.id);(!p||l>p.score)&&r.set(i.id,{record:i,score:l})}}}catch{return[]}return Array.from(r.values()).sort((n,a)=>a.score-n.score||a.record.lastConfirmedAt.localeCompare(n.record.lastConfirmedAt))}function re(t){return[...t].sort((e,o)=>e.record.observedAt.localeCompare(o.record.observedAt)||e.record.createdAt.localeCompare(o.record.createdAt)||e.record.id.localeCompare(o.record.id))}function oe(t){const e=[...t.categories,typeof t.metadata.kind=="string"?t.metadata.kind:void 0,typeof t.metadata.memoryType=="string"?t.metadata.memoryType:void 0].filter(o=>typeof o=="string"&&o.trim().length>0);for(const o of e){const r=q(o);if(r==="semantic"||r==="episodic"||r==="procedural")return r}return"semantic"}function se(t,e){const o=typeof t.metadata.scope=="string"?t.metadata.scope:void 0;return o==="session"||o==="agent"||o==="workspace"||o==="user"||o==="project"?o:typeof t.metadata.sessionId=="string"&&e.sessionId&&t.metadata.sessionId===e.sessionId?"session":t.agentId===e.agentId||t.metadata.agentId===e.agentId?"agent":"workspace"}function ne(t,e){const o=se(t,e),r=oe(t),n=t.memory.split(`
+`)[0]?.trim()||t.memory;return{id:`mem0:${t.id}`,canonicalKey:`mem0:${t.id}`,kind:r,scope:o,content:t.memory,summary:n.slice(0,240),status:"active",confidence:Math.max(0,Math.min(1,t.score||.5)),createdAt:t.createdAt,observedAt:t.createdAt,lastConfirmedAt:t.updatedAt,sourceType:"mem0-search",sourceRefs:[`mem0:${t.id}`],tags:t.categories,provenance:{source:"mem0",sessionId:typeof t.metadata.sessionId=="string"?t.metadata.sessionId:e.sessionId,requestId:typeof t.metadata.requestId=="string"?t.metadata.requestId:void 0,agentId:t.agentId??(typeof t.metadata.agentId=="string"?t.metadata.agentId:e.agentId),workspaceId:e.workspaceId,userId:e.userId,projectId:e.projectId,...t.metadata},revision:1,supersedes:[],conflictsWith:[]}}class ae{deps;constructor(e){this.deps=e}async memorize(e,o){if(!Array.isArray(e.records))throw new Error("memorize requires input.records to be an array.");const r=w(o),n=e.records.filter(s=>typeof s=="object"&&s!==null).filter(s=>s.noStore!==!0);if(n.length===0)return{records:[],decisions:[]};if(n.some(s=>typeof s.content!="string"||s.content.trim().length===0))throw new Error("memorize requires every record to include non-empty content.");if(n.some(s=>(s.scope??"session")==="session")&&!r.sessionId)throw new Error("memorize requires sessionId when storing session-scoped memory.");const a=r.recordedAt??new Date().toISOString(),m=r.requestId??R(new Date(a)),f=r.sessionId??`memory-api-${m}`;return this.memorizeCandidates(n.map(s=>({...s,content:s.content.trim()})),{...r,requestId:m,sessionId:f,recordedAt:a},{storeCandidateLog:e.storeCandidateLog!==!1,forceStore:e.forceStore===!0})}async recall(e,o){if(typeof e.query!="string"||e.query.trim().length===0)throw new Error("recall requires a non-empty query.");const r=w(o),n=W(e,r),a=typeof e.topK=="number"&&Number.isInteger(e.topK)&&e.topK>0?e.topK:this.deps.policy?.retrieval.defaultTopK??5,m=e.kinds?.length?new Set(e.kinds):null;return{items:(await this.rankRecallCandidates({query:e.query.trim(),scopes:n,kinds:m,topK:a,includeStale:e.includeStale===!0,context:r})).slice(0,a).map(({record:s})=>s)}}async buildPromptRecall(e,o){if(!_(e.query))return{items:[]};const r=w(o),n=(await this.rankRecallCandidates({query:e.query,scopes:e.scopes??k,kinds:e.kinds?.length?new Set(e.kinds):null,topK:e.topK??this.deps.policy?.retrieval.maxPromptMemories??8,includeStale:e.includeStale===!0,context:r})).filter(({record:s})=>!F(s)).map(s=>{const c=s.record.scope==="session"?4:s.record.scope==="agent"?3:s.record.scope==="user"?2:1;return{record:s.record,scope:s.record.scope,content:[`# Durable ${s.record.scope[0].toUpperCase()}${s.record.scope.slice(1)} Memory`,"",`- summary: ${s.record.summary}`,`- kind: ${s.record.kind}`,`- scope: ${s.record.scope}`,`- confidence: ${s.record.confidence.toFixed(2)}`,...s.record.knowledgeIdentity?[`- knowledge_identity: ${s.record.knowledgeIdentity}`,`- knowledge_operation: ${s.record.knowledgeOperation??"create"}`]:[],"",s.record.content].join(`
+`),score:c+T(s.record.lastConfirmedAt)+s.record.confidence}}).sort((s,c)=>c.score-s.score);if(n.length===0)return{items:[]};const a=this.deps.policy?.retrieval.maxPromptMemories??8,m=n.slice(0,a);if(m.length===0)return{items:[]};const f=re(m);return{items:f.map(s=>s.record),context:f.map(s=>s.content).join(`
+
+`)}}async buildPromptContext(e,o){return(await this.buildPromptRecall(e,o)).context}async list(e={},o){const r={...o},n=Array.isArray(e.scopes)&&e.scopes.length>0?Array.from(new Set(e.scopes)):k,a=e.kinds?.length?new Set(e.kinds):null,m=e.status?.length?new Set(e.status):new Set(["active"]),f=typeof e.limit=="number"&&Number.isInteger(e.limit)&&e.limit>0?e.limit:Number.POSITIVE_INFINITY;return{items:(await h(this.deps.store,n)).filter(c=>m.has(c.status)).filter(c=>!a||a.has(c.kind)).filter(c=>U(c,{sessionId:r.sessionId,agentId:r.agentId,workspaceId:r.workspaceId,userId:r.userId,projectId:r.projectId})).sort((c,d)=>d.lastConfirmedAt.localeCompare(c.lastConfirmedAt)).slice(0,f)}}async update(e,o){if(typeof e.memoryId!="string"||e.memoryId.trim().length===0)throw new Error("updateMemory requires a non-empty memoryId.");const r=await j(this.deps.store,e.memoryId.trim());if(!r)throw new Error(`Memory record not found: ${e.memoryId}`);const n=new Date().toISOString(),a=typeof e.content=="string"?e.content.trim():r.content;if(a.length===0)throw new Error("updateMemory requires content to remain non-empty.");const m={...r,content:a,summary:typeof e.summary=="string"?e.summary.trim()||A(a):typeof e.content=="string"?A(a):r.summary,status:e.status??r.status,confidence:typeof e.confidence=="number"?Math.max(0,Math.min(1,e.confidence)):r.confidence,expiresAt:e.expiresAt===void 0?r.expiresAt:e.expiresAt??void 0,sourceType:typeof e.sourceType=="string"&&e.sourceType.trim().length>0?e.sourceType.trim():r.sourceType,sourceRefs:Array.isArray(e.sourceRefs)?Array.from(new Set(e.sourceRefs.map(f=>f.trim()).filter(f=>f.length>0))):r.sourceRefs,tags:Array.isArray(e.tags)?Array.from(new Set(e.tags.map(f=>f.trim()).filter(f=>f.length>0))):r.tags,knowledgeIdentity:typeof e.knowledgeIdentity=="string"&&e.knowledgeIdentity.trim().length>0?e.knowledgeIdentity.trim():r.knowledgeIdentity,knowledgeOperation:e.knowledgeOperation==="create"||e.knowledgeOperation==="update"||e.knowledgeOperation==="delete"?e.knowledgeOperation:r.knowledgeOperation,observedAt:typeof e.observedAt=="string"&&e.observedAt.trim().length>0?e.observedAt:r.observedAt,lastConfirmedAt:typeof e.lastConfirmedAt=="string"&&e.lastConfirmedAt.trim().length>0?e.lastConfirmedAt:n,provenance:e.provenance?{...r.provenance,...e.provenance}:r.provenance,revision:r.revision+1};return await N(this.deps.store,m,n),await this.rebuildVectorIndex(),await this.refreshStructuredMemoryScope(m,o),m}async remove(e,o){if(typeof e.memoryId!="string"||e.memoryId.trim().length===0)throw new Error("removeMemory requires a non-empty memoryId.");const r=await j(this.deps.store,e.memoryId.trim());if(!r)throw new Error(`Memory record not found: ${e.memoryId}`);return await V(this.deps.store,r.scope,r.id),await this.rebuildVectorIndex(),await this.refreshStructuredMemoryScope(r,o),r}async memorizeCandidates(e,o,r){const n=w(o),a=e.filter(u=>u.noStore!==!0).filter(u=>typeof u.content=="string"&&u.content.trim().length>0).map(u=>({...u,content:u.content.trim()}));if(a.length===0)return{records:[],decisions:[]};const m=Array.from(new Set(a.flatMap(u=>x(u)))),f=await h(this.deps.store,m),s=await te({candidates:a,existingRecords:f,resolveVectorStore:this.deps.resolveVectorStore}),c=ee(a,f).map(u=>({record:u,score:E(u)})),d=Z(s,c),i=this.deps.transformCandidates?await this.deps.transformCandidates({candidates:a,context:n,existingRecords:d}):a,l=r.forceStore===!0?i:i.filter(u=>B(this.deps.policy,u));if(l.length===0)return{records:[],decisions:[]};r.storeCandidateLog&&await this.deps.store.put(["memories","candidates",n.sessionId??`memory-api-${n.requestId??"unknown"}`],`${n.requestId}.json`,{requestId:n.requestId,sessionId:n.sessionId,storedAt:n.recordedAt,candidates:l});const p=await P({store:this.deps.store,candidates:l,sessionId:n.sessionId??`memory-api-${n.requestId??"unknown"}`,requestId:n.requestId??R(new Date(n.recordedAt??new Date().toISOString())),agentId:n.agentId,workspaceId:n.workspaceId,userId:n.userId??"default",projectId:n.projectId??n.workspaceId,recordedAt:n.recordedAt??new Date().toISOString()});return await this.rebuildVectorIndex(),await this.refreshAfterWrite(l,n),p}async refreshAfterWrite(e,o){const r={session:e.filter(a=>(a.scope??"session")==="session"),agent:e.filter(a=>(a.scope??"session")==="agent"),workspace:e.filter(a=>(a.scope??"session")==="workspace"),user:e.filter(a=>(a.scope??"session")==="user"),project:e.filter(a=>(a.scope??"session")==="project")},n=[];for(const a of k){if(r[a].length===0)continue;const m=a==="session"?12:20;n.push(this.appendMemoryDigest(this.deps.resolveNamespace(a,o),"tool-memory.md",r[a],m,v[a].replace("Structured","Tool"))),n.push(b({store:this.deps.store,namespace:this.deps.resolveNamespace(a,o),title:v[a],scope:a,maxEntries:m,config:this.deps.maintenanceConfig??void 0}))}await Promise.all(n)}async appendMemoryDigest(e,o,r,n,a){const m=await this.deps.store.get(e,o),s=[...Array.isArray(m?.value?.items)?(m?.value).items??[]:[]];for(const i of r)s.some(l=>l.content===i.content&&(l.scope??"session")===(i.scope??"session"))||s.push(i);const c=s.slice(-n),d=new Map;for(const i of c){const l=q(i.kind),p=d.get(l)??[];p.push({...i,kind:l}),d.set(l,p)}await this.deps.store.put(e,o,{content:`${z(a,c)}
+`,items:c}),await Promise.all(Array.from(d.entries()).map(async([i,l])=>{await this.deps.store.put(e,`${i}.md`,{content:`${z(`${a} (${i})`,l)}
+`,items:l})}))}async refreshStructuredMemoryScope(e,o){const r=e.provenance,n={sessionId:r.sessionId,agentId:r.agentId??o.agentId,workspaceId:r.workspaceId??o.workspaceId,userId:r.userId??o.userId,projectId:r.projectId??o.projectId},a=e.scope==="session"?12:20;await b({store:this.deps.store,namespace:this.deps.resolveNamespace(e.scope,w(n)),title:v[e.scope],scope:e.scope,maxEntries:a,config:this.deps.maintenanceConfig??void 0})}async rebuildVectorIndex(){const e=await this.deps.resolveVectorStore();if(!e)return;const o=(await h(this.deps.store,k)).filter(r=>r.status==="active");try{if(await e.delete({deleteAll:!0}),o.length===0)return;await e.addDocuments(o.map(r=>({pageContent:`${r.summary}
+${r.content}`,metadata:{recordId:r.id,scope:r.scope,kind:r.kind,status:r.status,sessionId:r.provenance.sessionId,agentId:r.provenance.agentId,workspaceId:r.provenance.workspaceId,userId:r.provenance.userId,projectId:r.provenance.projectId,confidence:r.confidence,lastConfirmedAt:r.lastConfirmedAt}})))}catch{}}async rankRecallCandidates(e){const r=(await h(this.deps.store,e.scopes)).filter(s=>$(s,{sessionId:e.context.sessionId,agentId:e.context.agentId,workspaceId:e.context.workspaceId,userId:e.context.userId??"default",projectId:e.context.projectId??e.context.workspaceId})).filter(s=>e.includeStale?s.status==="active"||s.status==="stale":s.status==="active").filter(s=>e.kinds?e.kinds.has(s.kind):!0).map(s=>({record:s,score:S(s,e.query)})),n=new Map;for(const s of r)n.set(M(s.record),s);const a=await this.deps.resolveVectorStore();if(a)try{const s=await a.similaritySearch(e.query,Math.max(e.topK,this.deps.policy?.retrieval.maxPromptMemories??e.topK));for(const c of s){const d=typeof c.metadata=="object"&&c.metadata&&!Array.isArray(c.metadata)?c.metadata:{},i=typeof d.recordId=="string"?d.recordId:void 0,l=d.scope;if(!i||l!=="session"&&l!=="agent"&&l!=="workspace"&&l!=="user"&&l!=="project")continue;const p=await D(this.deps.store,l,i);if(!p||!$(p,{sessionId:e.context.sessionId,agentId:e.context.agentId,workspaceId:e.context.workspaceId,userId:e.context.userId??"default",projectId:e.context.projectId??e.context.workspaceId})||(e.includeStale?p.status!=="active"&&p.status!=="stale":p.status!=="active")||e.kinds&&!e.kinds.has(p.kind))continue;const u=M(p),g=S(p,e.query)+(typeof c.score=="number"?c.score:0),C=n.get(u);(!C||g>C.score)&&n.set(u,{record:p,score:g})}}catch{}const m=e.scopes.some(s=>s==="session"||s==="agent"||s==="workspace"),f=this.deps.getMem0SemanticRecall?.()??null;if(!f||!m)return Array.from(n.values()).sort((s,c)=>c.score-s.score);try{const s=await f.search({query:e.query,topK:Math.max(e.topK,this.deps.policy?.retrieval.maxPromptMemories??e.topK),agentId:e.context.agentId,sessionId:e.context.sessionId});for(const c of s){const d=ne(c,{sessionId:e.context.sessionId,agentId:e.context.agentId,workspaceId:e.context.workspaceId,userId:e.context.userId??"default",projectId:e.context.projectId??e.context.workspaceId});if(!e.scopes.includes(d.scope)||e.kinds&&!e.kinds.has(d.kind))continue;const i=M(d);n.has(i)||n.set(i,{record:d,score:S(d,e.query)+Math.max(0,Math.min(1,c.score))*4})}return Array.from(n.values()).sort((c,d)=>d.score-c.score)}catch{return Array.from(n.values()).sort((s,c)=>c.score-s.score)}}}function fe(t){return new ae(t)}export{ae as DefaultKnowledgeModule,fe as createKnowledgeModule};