@botbotgo/agent-harness 0.0.475 → 0.0.476

package/dist/runtime/harness/system/runtime-memory-manager.js

@@ -1,693 +1,10 @@
-import path from "node:path";
-import { extractMessageText } from "../../../utils/message-content.js";
-import { createResolvedModel } from "../../adapter/model/model-providers.js";
-import { FileBackedStore } from "./store.js";
-import { compileModel } from "../../../workspace/resource-compilers.js";
-import { resolvePromptValue, resolveRefId } from "../../../workspace/support/workspace-ref-utils.js";
-import { renderRuntimeMemoryManagerPrompt, renderRuntimeMemoryMutationReconciliationPrompt } from "../../prompts/runtime-prompts.js";
-import { isNonDurableTranscriptWorkflowMemory } from "./runtime-memory-policy.js";
-const FORMATION_EVENT_TYPES = new Set([
-    "request.state.changed",
-    "approval.resolved",
-]);
-function asRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
-}
-function asBoolean(value) {
-    return typeof value === "boolean" ? value : undefined;
-}
-function asPositiveInteger(value) {
-    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : undefined;
-}
-function asNonEmptyString(value) {
-    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
-}
-function asMemoryScopes(value) {
-    if (!Array.isArray(value)) {
-        return undefined;
-    }
-    const scopes = value
-        .filter((item) => typeof item === "string")
-        .filter((item) => ["session", "agent", "workspace", "user", "project"].includes(item));
-    return scopes.length > 0 ? Array.from(new Set(scopes)) : undefined;
-}
-function normalizeScopeList(scopes) {
-    return Array.from(new Set(scopes));
-}
-function asStrategy(value) {
-    return value === "rules" || value === "model" ? value : undefined;
-}
-export function readRuntimeMemoryFormationConfig(runtimeMemory, workspaceRoot) {
-    if (runtimeMemory?.enabled !== true) {
-        return undefined;
-    }
-    const formation = asRecord(runtimeMemory.formation);
-    const hotPath = asRecord(formation?.hotPath);
-    const manager = asRecord(formation?.manager);
-    const background = asRecord(formation?.background);
-    const ingestion = asRecord(runtimeMemory.ingestion);
-    const workspaceBaseName = path.basename(workspaceRoot) || "agent-harness";
-    const resolved = {
-        enabled: true,
-        hotPath: {
-            enabled: asBoolean(hotPath?.enabled) ?? true,
-        },
-        manager: {
-            enabled: asBoolean(manager?.enabled) ?? true,
-            strategy: asStrategy(manager?.strategy) ?? "model",
-            modelRef: asNonEmptyString(manager?.modelRef),
-            prompt: resolvePromptValue(manager?.prompt, workspaceRoot),
-            maxContextRecords: asPositiveInteger(manager?.maxContextRecords) ?? 12,
-        },
-        background: {
-            enabled: asBoolean(background?.enabled) ?? true,
-            maxMessagesPerRequest: asPositiveInteger(background?.maxMessagesPerRequest) ?? asPositiveInteger(ingestion?.maxMessagesPerRequest) ?? 40,
-            scopes: normalizeScopeList(asMemoryScopes(background?.scopes) ?? ["user", "project", "workspace"]),
-            stateStorePath: asNonEmptyString(background?.stateStorePath) ?? `knowledge/${workspaceBaseName}-memory-formation-state.json`,
-            writeOnApprovalResolution: asBoolean(background?.writeOnApprovalResolution) ?? asBoolean(ingestion?.writeOnApprovalResolution) ?? true,
-            writeOnRequestCompletion: asBoolean(background?.writeOnRequestCompletion) ?? asBoolean(ingestion?.writeOnRequestCompletion) ?? true,
-        },
-    };
-    if (!resolved.hotPath.enabled && !resolved.background.enabled) {
-        return undefined;
-    }
-    return resolved;
-}
-function excerpt(message) {
-    if (!message?.content) {
-        return undefined;
-    }
-    const normalized = extractMessageText(message.content).replace(/\s+/g, " ").trim();
-    if (!normalized) {
-        return undefined;
-    }
-    return normalized.length > 240 ? `${normalized.slice(0, 237)}...` : normalized;
-}
-function summarizeApprovals(approvals) {
-    if (approvals.length === 0) {
-        return "No approvals were recorded in this run.";
-    }
-    return approvals
-        .map((approval) => `${approval.toolName} (${approval.status})`)
-        .join(", ");
-}
-export function createBackgroundMemoryCandidates(input) {
-    const latestUser = excerpt(input.messages.filter((message) => message.role === "user").at(-1));
-    const latestAssistant = excerpt(input.messages.filter((message) => message.role === "assistant").at(-1));
-    const userContext = latestUser ?? "(none)";
-    const assistantContext = latestAssistant ?? "(none)";
-    const approvals = summarizeApprovals(input.approvals);
-    const summarySeed = latestUser ?? latestAssistant ?? `Run ${input.requestId}`;
-    const baseSummary = summarySeed.length > 120 ? `${summarySeed.slice(0, 117)}...` : summarySeed;
-    const sourceRefBase = `runtime://sessions/${input.session.sessionId}/requests/${input.requestId}/background-reflection`;
-    return [{
-            kind: "episodic",
-            sourceType: "runtime-transcript",
-            sourceRef: sourceRefBase,
-            summary: baseSummary,
-            content: [
-                "Transcript evidence for durable knowledge extraction.",
-                `Trigger: ${input.trigger}`,
-                "",
-                "Latest user message:",
-                userContext,
-                "",
-                "Latest assistant response:",
-                assistantContext,
-                "",
-                "Approval snapshot:",
-                approvals,
-            ].join("\n"),
-            confidence: 0.72,
-            observedAt: input.recordedAt,
-            provenance: {
-                scopeOptions: input.scopes,
-                trigger: input.trigger,
-            },
-            tags: ["background-extraction", "langmem-aligned", "reusable_summaries", input.trigger],
-        }];
-}
-function normalizeKind(value, fallback) {
-    if (value === "semantic" || value === "episodic" || value === "procedural") {
-        return value;
-    }
-    return fallback;
-}
-function normalizeScope(value, fallback) {
-    if (value === "session" || value === "agent" || value === "workspace" || value === "user" || value === "project") {
-        return value;
-    }
-    return fallback;
-}
-function extractAllowedScopes(candidate) {
-    const provenance = typeof candidate.provenance === "object" && candidate.provenance !== null && !Array.isArray(candidate.provenance)
-        ? candidate.provenance
-        : undefined;
-    const scopeOptions = provenance?.scopeOptions;
-    if (!Array.isArray(scopeOptions)) {
-        return undefined;
-    }
-    const allowed = scopeOptions
-        .filter((item) => item === "session" || item === "agent" || item === "workspace" || item === "user" || item === "project");
-    return allowed.length > 0 ? Array.from(new Set(allowed)) : undefined;
-}
-function normalizeScopeWithAllowedSet(value, fallback, allowedScopes) {
-    const normalized = normalizeScope(value, fallback);
-    if (!allowedScopes || allowedScopes.length === 0) {
-        return normalized;
-    }
-    if (normalized && allowedScopes.includes(normalized)) {
-        return normalized;
-    }
-    if (fallback && allowedScopes.includes(fallback)) {
-        return fallback;
-    }
-    return allowedScopes[0];
-}
-function normalizeTags(value, fallback) {
-    const fallbackTags = Array.isArray(fallback)
-        ? fallback.filter((item) => typeof item === "string" && item.trim().length > 0)
-        : [];
-    if (!Array.isArray(value)) {
-        return fallbackTags.length > 0 ? fallbackTags : fallback;
-    }
-    const tags = value.filter((item) => typeof item === "string" && item.trim().length > 0);
-    const merged = Array.from(new Set([...fallbackTags, ...tags]));
-    return merged.length > 0 ? merged : fallback;
-}
-function normalizeConfidence(value, fallback) {
-    if (typeof value !== "number" || Number.isNaN(value)) {
-        return fallback;
-    }
-    return Math.min(1, Math.max(0, value));
-}
-function normalizeOperationalRule(value, fallback) {
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        return fallback;
-    }
-    const typed = value;
-    const trigger = typeof typed.trigger === "string" && typed.trigger.trim().length > 0 ? typed.trigger.trim() : undefined;
-    const action = typeof typed.action === "string" && typed.action.trim().length > 0 ? typed.action.trim() : undefined;
-    const target = typeof typed.target === "string" && typed.target.trim().length > 0 ? typed.target.trim() : undefined;
-    const effect = typed.effect === "apply" || typed.effect === "invalidate"
-        ? typed.effect
-        : undefined;
-    if (!trigger || !action || !target) {
-        return fallback;
-    }
-    return { trigger, action, target, ...(effect ? { effect } : {}) };
-}
-function normalizeKnowledgeMutation(value, fallback) {
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        return fallback;
-    }
-    const typed = value;
-    const identity = typeof typed.identity === "string" && typed.identity.trim().length > 0 ? typed.identity.trim() : undefined;
-    const operation = typed.operation === "create" || typed.operation === "update" || typed.operation === "delete"
-        ? typed.operation
-        : undefined;
-    if (!identity) {
-        return fallback;
-    }
-    return { identity, ...(operation ? { operation } : {}) };
-}
-function asCandidateOutputs(parsed, candidate, allowedScopes, recordedAt) {
-    const rawMutations = Array.isArray(parsed.mutations) ? parsed.mutations : undefined;
-    const outputs = rawMutations && rawMutations.length > 0
-        ? rawMutations.filter((item) => typeof item === "object" && item !== null && !Array.isArray(item))
-        : [parsed];
-    return outputs.map((output) => ({
-        ...candidate,
-        content: typeof output.content === "string" && output.content.trim().length > 0 ? output.content.trim() : candidate.content,
-        summary: typeof output.summary === "string" && output.summary.trim().length > 0 ? output.summary.trim() : candidate.summary,
-        kind: normalizeKind(output.kind, normalizeKind(candidate.kind, undefined)),
-        scope: normalizeScopeWithAllowedSet(output.scope, normalizeScope(candidate.scope, undefined), allowedScopes),
-        tags: normalizeTags(output.tags, candidate.tags),
-        confidence: normalizeConfidence(output.confidence, candidate.confidence),
-        knowledgeMutation: normalizeKnowledgeMutation(output.knowledgeMutation, candidate.knowledgeMutation),
-        operationalRule: normalizeOperationalRule(output.operationalRule, candidate.operationalRule),
-        observedAt: candidate.observedAt ?? recordedAt,
-    }));
-}
-function extractText(value) {
-    if (typeof value === "string") {
-        return value;
-    }
-    if (typeof value !== "object" || value === null) {
-        return undefined;
-    }
-    if ("content" in value && typeof value.content === "string") {
-        return String(value.content);
-    }
-    const kwargs = "kwargs" in value && typeof value.kwargs === "object" && value.kwargs !== null
-        ? value.kwargs
-        : undefined;
-    if (typeof kwargs?.content === "string") {
-        return kwargs.content;
-    }
-    return undefined;
-}
-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 containsRuleTarget(candidate, record) {
-    const target = record.operationalRule?.target?.trim().toLowerCase();
-    if (!target) {
-        return false;
-    }
-    const candidateText = `${candidate.summary ?? ""}\n${candidate.content}`.toLowerCase();
-    return candidateText.includes(target);
-}
-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(candidate, record) {
-    const candidateLiterals = extractSalientLiterals(`${candidate.summary ?? ""}\n${candidate.content}`);
-    const recordLiterals = extractSalientLiterals(`${record.summary}\n${record.content}`);
-    if (candidateLiterals.size === 0 || recordLiterals.size === 0) {
-        return false;
-    }
-    for (const literal of candidateLiterals) {
-        if (recordLiterals.has(literal)) {
-            return true;
-        }
-    }
-    return false;
-}
-function selectMutationFallbackMatch(candidate, existingRecords) {
-    const candidateScope = normalizeScope(candidate.scope, undefined);
-    return existingRecords
-        .filter((record) => record.status === "active" && !!record.knowledgeIdentity && record.knowledgeOperation !== "delete")
-        .map((record) => {
-        let score = 0;
-        if (candidateScope && record.scope === candidateScope) {
-            score += 2;
-        }
-        if (containsRuleTarget(candidate, record)) {
-            score += 10;
-        }
-        if (sharesSalientLiteral(candidate, record)) {
-            score += 6;
-        }
-        if (record.operationalRule) {
-            score += 2;
-        }
-        return { record, score };
-    })
-        .filter((item) => item.score > 0)
-        .sort((left, right) => right.score - left.score || right.record.lastConfirmedAt.localeCompare(left.record.lastConfirmedAt))
-        .map((item) => item.record)
-        .at(0);
-}
-function applyDeterministicMutationFallback(candidate, existingRecords) {
-    const currentMutation = candidate.knowledgeMutation;
-    if (currentMutation && currentMutation.operation !== "create") {
-        return candidate;
-    }
-    if (!containsDeletionSignal(`${candidate.summary ?? ""}\n${candidate.content}`)) {
-        return candidate;
-    }
-    const matchingRule = selectMutationFallbackMatch(candidate, existingRecords);
-    if (!matchingRule?.knowledgeIdentity) {
-        return candidate;
-    }
-    return {
-        ...candidate,
-        scope: matchingRule.scope,
-        knowledgeMutation: {
-            identity: matchingRule.knowledgeIdentity,
-            operation: "delete",
-        },
-        ...(matchingRule.operationalRule
-            ? {
-                operationalRule: {
-                    ...matchingRule.operationalRule,
-                    effect: "invalidate",
-                },
-            }
-            : {}),
-    };
-}
-function selectRelatedContextRecords(candidate, existingRecords, maxRecords) {
-    const candidateScope = normalizeScope(candidate.scope, undefined);
-    const candidateSummary = normalizeCompareText(candidate.summary?.trim() || candidate.content);
-    const candidateContent = normalizeCompareText(candidate.content);
-    const candidateSourceRef = typeof candidate.sourceRef === "string" ? candidate.sourceRef.trim() : "";
-    return existingRecords
-        .filter((record) => record.status === "active")
-        .map((record) => {
-        let score = 0;
-        if (candidateScope && record.scope === candidateScope) {
-            score += 4;
-        }
-        if (candidateSourceRef && record.sourceRefs.includes(candidateSourceRef)) {
-            score += 12;
-        }
-        if (normalizeCompareText(record.summary) === candidateSummary) {
-            score += 10;
-        }
-        if (normalizeCompareText(record.content) === candidateContent) {
-            score += 9;
-        }
-        score += jaccardTextSimilarity(record.summary, candidate.summary ?? candidate.content) * 4;
-        score += jaccardTextSimilarity(record.content, candidate.content) * 3;
-        if (score > 0 && record.lastConfirmedAt) {
-            score += Math.max(0, 1 - ((Date.now() - Date.parse(record.lastConfirmedAt)) / (1000 * 60 * 60 * 24 * 365)));
-        }
-        return { record, score };
-    })
-        .filter((item) => item.score > 0)
-        .sort((left, right) => right.score - left.score || right.record.lastConfirmedAt.localeCompare(left.record.lastConfirmedAt))
-        .slice(0, maxRecords)
-        .map((item) => item.record);
-}
-function tryParseJsonObject(text) {
-    try {
-        const parsed = JSON.parse(text);
-        return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null;
-    }
-    catch {
-        const match = text.match(/\{[\s\S]*\}/);
-        if (!match) {
-            return null;
-        }
-        try {
-            const parsed = JSON.parse(match[0]);
-            return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null;
-        }
-        catch {
-            return null;
-        }
-    }
-}
-async function reconcileKnowledgeMutation(input) {
-    const eligibleExisting = input.existingRecords.filter((record) => typeof record.knowledgeIdentity === "string" && record.knowledgeIdentity.trim().length > 0);
-    if (eligibleExisting.length === 0) {
-        return input.candidate;
-    }
-    const currentMutation = input.candidate.knowledgeMutation;
-    if (!currentMutation || currentMutation.operation !== "create") {
-        return input.candidate;
-    }
-    try {
-        const response = await input.invoker.invoke(renderRuntimeMemoryMutationReconciliationPrompt({
-            candidate: input.candidate,
-            existingRecords: eligibleExisting,
-        }), {});
-        const parsed = tryParseJsonObject(extractText(response) ?? "");
-        if (!parsed || parsed.reuseExistingIdentity !== true) {
-            return input.candidate;
-        }
-        const identity = typeof parsed.identity === "string" ? parsed.identity.trim() : "";
-        const matched = eligibleExisting.find((record) => record.knowledgeIdentity === identity);
-        if (!matched) {
-            return input.candidate;
-        }
-        const operation = parsed.operation === "update" || parsed.operation === "delete"
-            ? parsed.operation
-            : currentMutation.operation;
-        const reconciledScope = normalizeScopeWithAllowedSet(parsed.scope, matched.scope, extractAllowedScopes(input.candidate));
-        return {
-            ...input.candidate,
-            knowledgeMutation: {
-                identity,
-                operation,
-            },
-            scope: reconciledScope ?? input.candidate.scope ?? matched.scope,
-            operationalRule: operation === "delete" && matched.operationalRule
-                ? {
-                    ...matched.operationalRule,
-                    effect: "invalidate",
-                }
-                : input.candidate.operationalRule,
-        };
-    }
-    catch {
-        return input.candidate;
-    }
-}
-export async function runModelMemoryManager(input) {
-    let resolvedModel;
-    try {
-        resolvedModel = await createResolvedModel(input.model, input.modelResolver);
-    }
-    catch {
-        return input.candidates;
-    }
-    const invoker = resolvedModel;
-    if (typeof invoker.invoke !== "function") {
-        return input.candidates;
-    }
-    const callableInvoker = invoker;
-    const transformed = [];
-    for (const candidate of input.candidates) {
-        const allowedScopes = extractAllowedScopes(candidate);
-        const prompt = renderRuntimeMemoryManagerPrompt({
-            candidate,
-            sessionId: input.sessionId,
-            requestId: input.requestId,
-            existingRecords: selectRelatedContextRecords(candidate, input.existingRecords, input.maxContextRecords ?? input.existingRecords.length),
-            template: input.promptTemplate,
-        });
-        let response;
-        try {
-            response = await callableInvoker.invoke(prompt, {});
-        }
-        catch {
-            transformed.push(candidate);
-            continue;
-        }
-        const parsed = tryParseJsonObject(extractText(response) ?? "");
-        if (!parsed) {
-            transformed.push(candidate);
-            continue;
-        }
-        if (parsed.store === false) {
-            continue;
-        }
-        const refinedCandidates = asCandidateOutputs(parsed, candidate, allowedScopes, input.recordedAt);
-        for (const refinedCandidate of refinedCandidates) {
-            if (isNonDurableTranscriptWorkflowMemory(refinedCandidate, candidate)) {
-                continue;
-            }
-            const reconciledCandidate = await reconcileKnowledgeMutation({
-                invoker: callableInvoker,
-                candidate: refinedCandidate,
-                existingRecords: selectRelatedContextRecords(refinedCandidate, input.existingRecords, input.maxContextRecords ?? input.existingRecords.length),
-            });
-            transformed.push(applyDeterministicMutationFallback(reconciledCandidate, input.existingRecords));
-        }
-    }
-    return transformed;
-}
-export function createRuntimeMemoryManager(input) {
-    return {
-        async transform({ candidates, binding, sessionId, requestId, recordedAt, existingRecords }) {
-            if (input.config.manager.enabled !== true || candidates.length === 0) {
-                return candidates;
-            }
-            const contextRecords = existingRecords
-                .filter((record) => record.status === "active");
-            if (input.config.manager.strategy === "rules") {
-                return candidates;
-            }
-            if (!binding.langchainAgentParams?.model) {
-                return candidates;
-            }
-            const primaryModel = (() => {
-                if (!input.config.manager.modelRef) {
-                    return binding.langchainAgentParams.model;
-                }
-                const configured = input.workspace.models.get(resolveRefId(input.config.manager.modelRef));
-                return configured ? compileModel(configured) : binding.langchainAgentParams.model;
-            })();
-            return runModelMemoryManager({
-                workspace: input.workspace,
-                binding,
-                model: primaryModel,
-                candidates,
-                sessionId,
-                requestId,
-                recordedAt,
-                existingRecords: contextRecords,
-                maxContextRecords: input.config.manager.maxContextRecords,
-                promptTemplate: input.config.manager.prompt,
-                modelResolver: input.modelResolver,
-            });
-        },
-    };
-}
-function fingerprintMessages(messages, scopes) {
-    const serialized = messages
-        .map((message) => `${message.role}\n${message.createdAt}\n${extractMessageText(message.content)}`)
-        .join("\n---\n");
-    return `${scopes.join(",")}::${serialized}`;
-}
-export class RuntimeMemoryFormationSync {
-    persistence;
-    config;
-    writer;
-    stateStore;
-    options;
-    pending = new Set();
-    syncChain = Promise.resolve();
-    name = "runtime-memory-formation-sync";
-    constructor(persistence, config, writer, runtimeRoot, stateStore = new FileBackedStore(path.join(runtimeRoot, config.background.stateStorePath)), options = {}) {
-        this.persistence = persistence;
-        this.config = config;
-        this.writer = writer;
-        this.stateStore = stateStore;
-        this.options = options;
-    }
-    shouldHandle(event) {
-        if (!this.config.background.enabled || !FORMATION_EVENT_TYPES.has(event.eventType)) {
-            return false;
-        }
-        if (event.eventType === "approval.resolved") {
-            return this.config.background.writeOnApprovalResolution;
-        }
-        return this.config.background.writeOnRequestCompletion && event.payload.state === "completed";
-    }
-    async handleEvent(event) {
-        if (!this.shouldHandle(event)) {
-            return;
-        }
-        const trigger = event.eventType === "approval.resolved" ? "approval.resolved" : "request.completed";
-        const task = this.syncChain
-            .then(() => this.reflectRun(event.sessionId, event.requestId, trigger, event.timestamp))
-            .catch(() => {
-            // Fail open: reflection should not block runtime progress.
-        });
-        this.syncChain = task
-            .catch(() => {
-            // Fail open: reflection should not block runtime progress.
-        })
-            .finally(() => {
-            this.pending.delete(task);
-        });
-        this.pending.add(task);
-    }
-    async reflectRun(sessionId, requestId, trigger, recordedAt) {
-        const [session, run, allMessages, approvals] = await Promise.all([
-            this.persistence.getSession(sessionId),
-            this.persistence.getRequest(requestId),
-            this.persistence.listSessionMessages(sessionId, this.config.background.maxMessagesPerRequest),
-            this.persistence.getRequestApprovals(sessionId, requestId),
-        ]);
-        if (!session || !run) {
-            return;
-        }
-        const messages = allMessages.filter((message) => message.requestId === requestId);
-        if (messages.length === 0) {
-            return;
-        }
-        const fingerprint = fingerprintMessages(messages, this.config.background.scopes);
-        const namespace = ["memories", "formation", "sessions", sessionId, "requests"];
-        const cursor = await this.stateStore.get(namespace, requestId);
-        const existing = cursor?.value;
-        if (existing?.fingerprint === fingerprint && existing.trigger === trigger) {
-            return;
-        }
-        const candidates = createBackgroundMemoryCandidates({
-            session,
-            requestId,
-            agentId: run.agentId ?? session.agentId,
-            trigger,
-            recordedAt,
-            messages,
-            approvals,
-            scopes: this.config.background.scopes,
-        });
-        if (candidates.length === 0) {
-            return;
-        }
-        await this.writer({
-            candidates,
-            sessionId,
-            requestId,
-            agentId: run.agentId ?? session.agentId,
-            userId: this.options.userId,
-            projectId: this.options.projectId,
-            recordedAt,
-        });
-        await this.stateStore.put(namespace, requestId, {
-            fingerprint,
-            candidateCount: candidates.length,
-            syncedAt: new Date().toISOString(),
-            trigger,
-        });
-    }
-    async close() {
-        await Promise.allSettled(Array.from(this.pending));
-    }
-}
+import k from"node:path";import{extractMessageText as A}from"../../../utils/message-content.js";import{createResolvedModel as v}from"../../adapter/model/model-providers.js";import{FileBackedStore as q}from"./store.js";import{compileModel as L}from"../../../workspace/resource-compilers.js";import{resolvePromptValue as N,resolveRefId as E}from"../../../workspace/support/workspace-ref-utils.js";import{renderRuntimeMemoryManagerPrompt as B,renderRuntimeMemoryMutationReconciliationPrompt as D}from"../../prompts/runtime-prompts.js";import{isNonDurableTranscriptWorkflowMemory as F}from"./runtime-memory-policy.js";const _=new Set(["request.state.changed","approval.resolved"]);function u(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0}function f(e){return typeof e=="boolean"?e:void 0}function h(e){return typeof e=="number"&&Number.isInteger(e)&&e>0?e:void 0}function x(e){return typeof e=="string"&&e.trim().length>0?e.trim():void 0}function J(e){if(!Array.isArray(e))return;const t=e.filter(n=>typeof n=="string").filter(n=>["session","agent","workspace","user","project"].includes(n));return t.length>0?Array.from(new Set(t)):void 0}function K(e){return Array.from(new Set(e))}function H(e){return e==="rules"||e==="model"?e:void 0}function pe(e,t){if(e?.enabled!==!0)return;const n=u(e.formation),r=u(n?.hotPath),o=u(n?.manager),i=u(n?.background),s=u(e.ingestion),a=k.basename(t)||"agent-harness",c={enabled:!0,hotPath:{enabled:f(r?.enabled)??!0},manager:{enabled:f(o?.enabled)??!0,strategy:H(o?.strategy)??"model",modelRef:x(o?.modelRef),prompt:N(o?.prompt,t),maxContextRecords:h(o?.maxContextRecords)??12},background:{enabled:f(i?.enabled)??!0,maxMessagesPerRequest:h(i?.maxMessagesPerRequest)??h(s?.maxMessagesPerRequest)??40,scopes:K(J(i?.scopes)??["user","project","workspace"]),stateStorePath:x(i?.stateStorePath)??`knowledge/${a}-memory-formation-state.json`,writeOnApprovalResolution:f(i?.writeOnApprovalResolution)??f(s?.writeOnApprovalResolution)??!0,writeOnRequestCompletion:f(i?.writeOnRequestCompletion)??f(s?.writeOnRequestCompletion)??!0}};if(!(!c.hotPath.enabled&&!c.background.enabled))return c}function b(e){if(!e?.content)return;const t=A(e.content).replace(/\s+/g," ").trim();if(t)return t.length>240?`${t.slice(0,237)}...`:t}function V(e){return e.length===0?"No approvals were recorded in this run.":e.map(t=>`${t.toolName} (${t.status})`).join(", ")}function W(e){const t=b(e.messages.filter(l=>l.role==="user").at(-1)),n=b(e.messages.filter(l=>l.role==="assistant").at(-1)),r=t??"(none)",o=n??"(none)",i=V(e.approvals),s=t??n??`Run ${e.requestId}`,a=s.length>120?`${s.slice(0,117)}...`:s;return[{kind:"episodic",sourceType:"runtime-transcript",sourceRef:`runtime://sessions/${e.session.sessionId}/requests/${e.requestId}/background-reflection`,summary:a,content:["Transcript evidence for durable knowledge extraction.",`Trigger: ${e.trigger}`,"","Latest user message:",r,"","Latest assistant response:",o,"","Approval snapshot:",i].join(`
+`),confidence:.72,observedAt:e.recordedAt,provenance:{scopeOptions:e.scopes,trigger:e.trigger},tags:["background-extraction","langmem-aligned","reusable_summaries",e.trigger]}]}function S(e,t){return e==="semantic"||e==="episodic"||e==="procedural"?e:t}function p(e,t){return e==="session"||e==="agent"||e==="workspace"||e==="user"||e==="project"?e:t}function M(e){const n=(typeof e.provenance=="object"&&e.provenance!==null&&!Array.isArray(e.provenance)?e.provenance:void 0)?.scopeOptions;if(!Array.isArray(n))return;const r=n.filter(o=>o==="session"||o==="agent"||o==="workspace"||o==="user"||o==="project");return r.length>0?Array.from(new Set(r)):void 0}function C(e,t,n){const r=p(e,t);return!n||n.length===0||r&&n.includes(r)?r:t&&n.includes(t)?t:n[0]}function U(e,t){const n=Array.isArray(t)?t.filter(i=>typeof i=="string"&&i.trim().length>0):[];if(!Array.isArray(e))return n.length>0?n:t;const r=e.filter(i=>typeof i=="string"&&i.trim().length>0),o=Array.from(new Set([...n,...r]));return o.length>0?o:t}function Y(e,t){return typeof e!="number"||Number.isNaN(e)?t:Math.min(1,Math.max(0,e))}function G(e,t){if(typeof e!="object"||e===null||Array.isArray(e))return t;const n=e,r=typeof n.trigger=="string"&&n.trigger.trim().length>0?n.trigger.trim():void 0,o=typeof n.action=="string"&&n.action.trim().length>0?n.action.trim():void 0,i=typeof n.target=="string"&&n.target.trim().length>0?n.target.trim():void 0,s=n.effect==="apply"||n.effect==="invalidate"?n.effect:void 0;return!r||!o||!i?t:{trigger:r,action:o,target:i,...s?{effect:s}:{}}}function Q(e,t){if(typeof e!="object"||e===null||Array.isArray(e))return t;const n=e,r=typeof n.identity=="string"&&n.identity.trim().length>0?n.identity.trim():void 0,o=n.operation==="create"||n.operation==="update"||n.operation==="delete"?n.operation:void 0;return r?{identity:r,...o?{operation:o}:{}}:t}function X(e,t,n,r){const o=Array.isArray(e.mutations)?e.mutations:void 0;return(o&&o.length>0?o.filter(s=>typeof s=="object"&&s!==null&&!Array.isArray(s)):[e]).map(s=>({...t,content:typeof s.content=="string"&&s.content.trim().length>0?s.content.trim():t.content,summary:typeof s.summary=="string"&&s.summary.trim().length>0?s.summary.trim():t.summary,kind:S(s.kind,S(t.kind,void 0)),scope:C(s.scope,p(t.scope,void 0),n),tags:U(s.tags,t.tags),confidence:Y(s.confidence,t.confidence),knowledgeMutation:Q(s.knowledgeMutation,t.knowledgeMutation),operationalRule:G(s.operationalRule,t.operationalRule),observedAt:t.observedAt??r}))}function z(e){if(typeof e=="string")return e;if(typeof e!="object"||e===null)return;if("content"in e&&typeof e.content=="string")return String(e.content);const t="kwargs"in e&&typeof e.kwargs=="object"&&e.kwargs!==null?e.kwargs:void 0;if(typeof t?.content=="string")return t.content}function m(e){return e.toLowerCase().replace(/\s+/g," ").trim()}function T(e){return new Set(e.toLowerCase().split(/[^a-z0-9_]+/i).map(t=>t.trim()).filter(t=>t.length>2))}function j(e,t){const n=T(e),r=T(t);if(n.size===0||r.size===0)return 0;let o=0;for(const s of n)r.has(s)&&(o+=1);const i=new Set([...n,...r]).size;return i===0?0:o/i}function Z(e){const t=m(e);return t?["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(n=>t.includes(n)):!1}function ee(e,t){const n=t.operationalRule?.target?.trim().toLowerCase();return n?`${e.summary??""}
+${e.content}`.toLowerCase().includes(n):!1}function I(e){const t=new Set,n=e.trim();if(!n)return t;for(const r of n.matchAll(/[`'"]([^`'"]{1,64})[`'"]/g)){const o=r[1]?.trim().toLowerCase();o&&o.length>=2&&t.add(o)}for(const r of n.matchAll(/\b[a-z][a-z0-9._/-]{1,63}\b/gi)){const o=r[0]?.trim().toLowerCase();o&&!["system","startup","command","memory","instruction","user","deleted"].includes(o)&&t.add(o)}return t}function te(e,t){const n=I(`${e.summary??""}
+${e.content}`),r=I(`${t.summary}
+${t.content}`);if(n.size===0||r.size===0)return!1;for(const o of n)if(r.has(o))return!0;return!1}function ne(e,t){const n=p(e.scope,void 0);return t.filter(r=>r.status==="active"&&!!r.knowledgeIdentity&&r.knowledgeOperation!=="delete").map(r=>{let o=0;return n&&r.scope===n&&(o+=2),ee(e,r)&&(o+=10),te(e,r)&&(o+=6),r.operationalRule&&(o+=2),{record:r,score:o}}).filter(r=>r.score>0).sort((r,o)=>o.score-r.score||o.record.lastConfirmedAt.localeCompare(r.record.lastConfirmedAt)).map(r=>r.record).at(0)}function re(e,t){const n=e.knowledgeMutation;if(n&&n.operation!=="create"||!Z(`${e.summary??""}
+${e.content}`))return e;const r=ne(e,t);return r?.knowledgeIdentity?{...e,scope:r.scope,knowledgeMutation:{identity:r.knowledgeIdentity,operation:"delete"},...r.operationalRule?{operationalRule:{...r.operationalRule,effect:"invalidate"}}:{}}:e}function P(e,t,n){const r=p(e.scope,void 0),o=m(e.summary?.trim()||e.content),i=m(e.content),s=typeof e.sourceRef=="string"?e.sourceRef.trim():"";return t.filter(a=>a.status==="active").map(a=>{let c=0;return r&&a.scope===r&&(c+=4),s&&a.sourceRefs.includes(s)&&(c+=12),m(a.summary)===o&&(c+=10),m(a.content)===i&&(c+=9),c+=j(a.summary,e.summary??e.content)*4,c+=j(a.content,e.content)*3,c>0&&a.lastConfirmedAt&&(c+=Math.max(0,1-(Date.now()-Date.parse(a.lastConfirmedAt))/(1e3*60*60*24*365))),{record:a,score:c}}).filter(a=>a.score>0).sort((a,c)=>c.score-a.score||c.record.lastConfirmedAt.localeCompare(a.record.lastConfirmedAt)).slice(0,n).map(a=>a.record)}function $(e){try{const t=JSON.parse(e);return typeof t=="object"&&t!==null&&!Array.isArray(t)?t:null}catch{const t=e.match(/\{[\s\S]*\}/);if(!t)return null;try{const n=JSON.parse(t[0]);return typeof n=="object"&&n!==null&&!Array.isArray(n)?n:null}catch{return null}}}async function oe(e){const t=e.existingRecords.filter(r=>typeof r.knowledgeIdentity=="string"&&r.knowledgeIdentity.trim().length>0);if(t.length===0)return e.candidate;const n=e.candidate.knowledgeMutation;if(!n||n.operation!=="create")return e.candidate;try{const r=await e.invoker.invoke(D({candidate:e.candidate,existingRecords:t}),{}),o=$(z(r)??"");if(!o||o.reuseExistingIdentity!==!0)return e.candidate;const i=typeof o.identity=="string"?o.identity.trim():"",s=t.find(l=>l.knowledgeIdentity===i);if(!s)return e.candidate;const a=o.operation==="update"||o.operation==="delete"?o.operation:n.operation,c=C(o.scope,s.scope,M(e.candidate));return{...e.candidate,knowledgeMutation:{identity:i,operation:a},scope:c??e.candidate.scope??s.scope,operationalRule:a==="delete"&&s.operationalRule?{...s.operationalRule,effect:"invalidate"}:e.candidate.operationalRule}}catch{return e.candidate}}async function se(e){let t;try{t=await v(e.model,e.modelResolver)}catch{return e.candidates}const n=t;if(typeof n.invoke!="function")return e.candidates;const r=n,o=[];for(const i of e.candidates){const s=M(i),a=B({candidate:i,sessionId:e.sessionId,requestId:e.requestId,existingRecords:P(i,e.existingRecords,e.maxContextRecords??e.existingRecords.length),template:e.promptTemplate});let c;try{c=await r.invoke(a,{})}catch{o.push(i);continue}const l=$(z(c)??"");if(!l){o.push(i);continue}if(l.store===!1)continue;const g=X(l,i,s,e.recordedAt);for(const d of g){if(F(d,i))continue;const R=await oe({invoker:r,candidate:d,existingRecords:P(d,e.existingRecords,e.maxContextRecords??e.existingRecords.length)});o.push(re(R,e.existingRecords))}}return o}function ye(e){return{async transform({candidates:t,binding:n,sessionId:r,requestId:o,recordedAt:i,existingRecords:s}){if(e.config.manager.enabled!==!0||t.length===0)return t;const a=s.filter(l=>l.status==="active");if(e.config.manager.strategy==="rules"||!n.langchainAgentParams?.model)return t;const c=(()=>{if(!e.config.manager.modelRef)return n.langchainAgentParams.model;const l=e.workspace.models.get(E(e.config.manager.modelRef));return l?L(l):n.langchainAgentParams.model})();return se({workspace:e.workspace,binding:n,model:c,candidates:t,sessionId:r,requestId:o,recordedAt:i,existingRecords:a,maxContextRecords:e.config.manager.maxContextRecords,promptTemplate:e.config.manager.prompt,modelResolver:e.modelResolver})}}}function ie(e,t){const n=e.map(r=>`${r.role}
+${r.createdAt}
+${A(r.content)}`).join(`
+---
+`);return`${t.join(",")}::${n}`}class he{persistence;config;writer;stateStore;options;pending=new Set;syncChain=Promise.resolve();name="runtime-memory-formation-sync";constructor(t,n,r,o,i=new q(k.join(o,n.background.stateStorePath)),s={}){this.persistence=t,this.config=n,this.writer=r,this.stateStore=i,this.options=s}shouldHandle(t){return!this.config.background.enabled||!_.has(t.eventType)?!1:t.eventType==="approval.resolved"?this.config.background.writeOnApprovalResolution:this.config.background.writeOnRequestCompletion&&t.payload.state==="completed"}async handleEvent(t){if(!this.shouldHandle(t))return;const n=t.eventType==="approval.resolved"?"approval.resolved":"request.completed",r=this.syncChain.then(()=>this.reflectRun(t.sessionId,t.requestId,n,t.timestamp)).catch(()=>{});this.syncChain=r.catch(()=>{}).finally(()=>{this.pending.delete(r)}),this.pending.add(r)}async reflectRun(t,n,r,o){const[i,s,a,c]=await Promise.all([this.persistence.getSession(t),this.persistence.getRequest(n),this.persistence.listSessionMessages(t,this.config.background.maxMessagesPerRequest),this.persistence.getRequestApprovals(t,n)]);if(!i||!s)return;const l=a.filter(O=>O.requestId===n);if(l.length===0)return;const g=ie(l,this.config.background.scopes),d=["memories","formation","sessions",t,"requests"],w=(await this.stateStore.get(d,n))?.value;if(w?.fingerprint===g&&w.trigger===r)return;const y=W({session:i,requestId:n,agentId:s.agentId??i.agentId,trigger:r,recordedAt:o,messages:l,approvals:c,scopes:this.config.background.scopes});y.length!==0&&(await this.writer({candidates:y,sessionId:t,requestId:n,agentId:s.agentId??i.agentId,userId:this.options.userId,projectId:this.options.projectId,recordedAt:o}),await this.stateStore.put(d,n,{fingerprint:g,candidateCount:y.length,syncedAt:new Date().toISOString(),trigger:r}))}async close(){await Promise.allSettled(Array.from(this.pending))}}export{he as RuntimeMemoryFormationSync,W as createBackgroundMemoryCandidates,ye as createRuntimeMemoryManager,pe as readRuntimeMemoryFormationConfig,se as runModelMemoryManager};