qlogicagent 2.13.5 → 2.13.6

package/dist/cli/handlers/memory-handler.js

@@ -1,792 +0,0 @@
-/**
- * Memory CRUD + search handlers extracted from StdioServer.
- * Handles: memory.list, memory.read, memory.write, memory.search, memory.delete
- */
-import { AGENT_RPC_ERROR_CODES } from "../../protocol/wire/index.js";
-import { buildMemoryCandidateProposal, buildMemoryCandidates as buildMemoryCandidatesFromService, normalizeInputCandidate as normalizeInputCandidateFromService, } from "../memory-candidate-service.js";
-const MEMORY_CATEGORIES = new Set(["fact", "preference", "insight", "lesson", "decision", "plan", "event", "general"]);
-function asRecord(value) {
-    return value && typeof value === "object" ? value : {};
-}
-function clamp(n, min, max, fallback) {
-    const value = typeof n === "number" && Number.isFinite(n) ? n : fallback;
-    return Math.max(min, Math.min(max, value));
-}
-function normalizeCategory(category) {
-    return typeof category === "string" && MEMORY_CATEGORIES.has(category) ? category : "general";
-}
-function normalizeTags(tags) {
-    if (!Array.isArray(tags))
-        return [];
-    const seen = new Set();
-    for (const tag of tags) {
-        if (typeof tag !== "string")
-            continue;
-        const value = tag.trim().replace(/\s+/g, "-").slice(0, 48);
-        if (value)
-            seen.add(value);
-    }
-    return Array.from(seen).slice(0, 12);
-}
-async function commitMemoryCandidates(ctx, userId, candidates, attachmentIds = []) {
-    let memoriesAdded = 0;
-    let observationsAdded = 0;
-    let proposalsAdded = 0;
-    let claimsAdded = 0;
-    let conflictsAdded = 0;
-    const claimIds = [];
-    const conflictIds = [];
-    const provider = ctx.memoryProvider;
-    if (typeof provider?.ingestExtracted !== "function") {
-        throw new Error("Memory provider must expose the consolidation entrypoint ingestExtracted.");
-    }
-    let attachmentsConsumed = false;
-    for (const candidate of candidates) {
-        const text = typeof candidate?.text === "string" ? candidate.text.trim() : "";
-        if (!text)
-            continue;
-        const tags = normalizeTags([
-            ...(candidate.tags ?? []),
-            ...(candidate.relatedMemoryIds ?? []).map((id) => `related:${id}`),
-        ]);
-        // Link all uploaded attachments to the first committed memory of this action.
-        const linkIds = !attachmentsConsumed && attachmentIds.length > 0 ? attachmentIds : undefined;
-        if (linkIds)
-            attachmentsConsumed = true;
-        const item = {
-            text,
-            category: normalizeCategory(candidate.category),
-            importance: clamp(candidate.importance, 0.1, 1, 0.6),
-            event_date: typeof candidate.eventDate === "string" ? candidate.eventDate : "",
-            tags,
-            attachmentIds: linkIds,
-        };
-        const result = await provider.ingestExtracted([item], userId, {
-            source: typeof candidate.source === "string" && candidate.source.trim() ? candidate.source.trim() : "manual",
-        });
-        memoriesAdded += result?.memoriesAdded ?? 0;
-        observationsAdded += result?.observationsAdded ?? 0;
-        proposalsAdded += result?.proposalsAdded ?? 0;
-        claimsAdded += result?.claimsAdded ?? 0;
-        conflictsAdded += result?.conflictsAdded ?? 0;
-        claimIds.push(...(result?.claimIds ?? []));
-        conflictIds.push(...(result?.conflictIds ?? []));
-    }
-    return { memoriesAdded, observationsAdded, proposalsAdded, claimsAdded, conflictsAdded, claimIds, conflictIds };
-}
-function resolveMemoryUserId(ctx) {
-    const raw = typeof ctx.memoryUserId === "string" && ctx.memoryUserId.trim()
-        ? ctx.memoryUserId
-        : "";
-    const userId = raw.trim();
-    return userId ? userId : null;
-}
-function emptyAtlas() {
-    return {
-        totalCount: 0,
-        records: [],
-        buckets: [],
-        clusters: [],
-        windowCursor: null,
-        timeRange: null,
-        stats: { formed: 0, insights: 0, preferences: 0 },
-    };
-}
-function toAtlasWireRecord(r) {
-    return {
-        id: r.id,
-        text: r.text,
-        category: r.category,
-        importance: r.importance,
-        confidence: r.confidence,
-        source: r.source,
-        sessionId: r.sessionId,
-        eventDate: r.eventDate,
-        tags: r.tags,
-        createdAt: r.createdAt,
-        updatedAt: r.updatedAt,
-        accessCount: r.accessCount,
-        lastAccessedAt: r.lastAccessedAt,
-        isArchived: r.isArchived,
-        attachments: r.attachments ?? [],
-    };
-}
-function statsFromAtlas(totalCount, clusters) {
-    let insights = 0;
-    let preferences = 0;
-    for (const cluster of clusters ?? []) {
-        const entry = asRecord(cluster);
-        if (entry.kind !== "category")
-            continue;
-        if (entry.label === "insight" || entry.label === "lesson")
-            insights += Number(entry.count ?? 0);
-        if (entry.label === "preference")
-            preferences += Number(entry.count ?? 0);
-    }
-    return { formed: totalCount, insights, preferences };
-}
-export async function handleMemoryList(msg) {
-    const sources = [];
-    if (this.memdir) {
-        sources.push({ id: "memdir", type: "file", path: this.memdir.getRootPath() });
-    }
-    if (this.memoryProvider) {
-        sources.push({ id: "local", type: "vector" });
-    }
-    if (msg.id !== undefined) {
-        this.sendResponse(msg.id, { sources });
-    }
-}
-/** memory.list-files: returns actual topic files from memdir. */
-export async function handleMemoryListFiles(msg) {
-    const params = msg.params;
-    const projectId = params?.projectId;
-    let memdirInstance = this.memdir;
-    // If projectId provided, resolve memdir for that project
-    if (projectId && this.projectLocator) {
-        const projRoot = this.projectLocator.resolveProjectRoot(projectId);
-        if (projRoot) {
-            memdirInstance = this.projectMemoryStoreFactory.create(projRoot);
-        }
-    }
-    if (!memdirInstance) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, { files: [] });
-        return;
-    }
-    try {
-        const files = await memdirInstance.listFiles();
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { files });
-        }
-    }
-    catch {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, { files: [] });
-    }
-}
-/**
- * memory.atlas: returns full L2 vector-memory records (wire-safe, no embedding
- * blob) plus category roll-ups, for the 3D memory atlas visualization.
- */
-export async function handleMemoryAtlas(msg) {
-    const params = msg.params;
-    this.ensureMemoryProvider?.();
-    if (!this.memoryProvider || typeof this.memoryProvider.getAtlas !== "function") {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, emptyAtlas());
-        }
-        return;
-    }
-    try {
-        const userId = resolveMemoryUserId(this);
-        if (!userId) {
-            if (msg.id !== undefined)
-                this.sendResponse(msg.id, emptyAtlas());
-            return;
-        }
-        const atlas = this.memoryProvider.getAtlas(userId, {
-            pageSize: params?.pageSize ?? 360,
-            windowStartAt: params?.windowStartAt,
-            windowEndAt: params?.windowEndAt,
-            windowCenterAt: params?.windowCenterAt,
-            bucketCount: params?.bucketCount ?? 96,
-            clusterLimit: params?.clusterLimit ?? 48,
-            activeOnly: true,
-        });
-        // Strip the embedding Float32Array: it is not JSON-serializable and not
-        // needed client-side (layout is time/confidence based, not embedding based).
-        const wire = (atlas.records ?? []).map(toAtlasWireRecord);
-        const totalCount = Number(atlas.totalCount ?? wire.length);
-        const clusters = atlas.clusters ?? [];
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, {
-                totalCount,
-                records: wire,
-                buckets: atlas.buckets ?? [],
-                clusters,
-                windowCursor: atlas.windowCursor ?? null,
-                timeRange: atlas.timeRange ?? null,
-                stats: statsFromAtlas(totalCount, clusters),
-            });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-/**
- * memory.activity: daily activity counts + highlights over the recent window,
- * powering the atlas timeline ticks and the "memory digest" panel.
- */
-export async function handleMemoryActivity(msg) {
-    const params = msg.params;
-    this.ensureMemoryProvider?.();
-    if (!this.memoryProvider || typeof this.memoryProvider.getActivitySummary !== "function") {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, { dailyCounts: [], highlights: [] });
-        return;
-    }
-    try {
-        const userId = resolveMemoryUserId(this);
-        if (!userId) {
-            if (msg.id !== undefined)
-                this.sendResponse(msg.id, { dailyCounts: [], highlights: [] });
-            return;
-        }
-        const summary = this.memoryProvider.getActivitySummary(userId, params?.days ?? 180);
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, summary);
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleMemoryObserve(msg) {
-    const params = msg.params;
-    this.ensureMemoryProvider?.();
-    if (!this.memoryProvider || typeof this.memoryProvider.observeExtracted !== "function") {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: "Long-term memory provider does not support observations.",
-            });
-        }
-        return;
-    }
-    const text = typeof params?.text === "string" ? params.text.trim() : "";
-    if (!text) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "text is required.",
-            });
-        return;
-    }
-    const userId = resolveMemoryUserId(this);
-    if (!userId) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "llmrouter user id is required for long-term memory.",
-            });
-        return;
-    }
-    try {
-        const result = await this.memoryProvider.observeExtracted([{
-                text,
-                category: normalizeCategory(params?.category),
-                importance: clamp(params?.importance, 0.1, 1, 0.5),
-                tags: normalizeTags(params?.tags ?? []),
-            }], userId, { source: params?.source ?? "turn" });
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, { ok: true, ...result });
-    }
-    catch (err) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-    }
-}
-export async function handleMemoryPropose(msg) {
-    const params = msg.params;
-    this.ensureMemoryProvider?.();
-    if (!this.memoryProvider || typeof this.memoryProvider.proposeExtracted !== "function") {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: "Long-term memory provider does not support proposals.",
-            });
-        return;
-    }
-    const userId = resolveMemoryUserId(this);
-    if (!userId) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "llmrouter user id is required for long-term memory.",
-            });
-        return;
-    }
-    try {
-        const built = await buildMemoryCandidateProposal(this, params ?? {}, userId);
-        const items = built.candidates.map((candidate) => ({
-            text: typeof candidate?.text === "string" ? candidate.text.trim() : "",
-            category: normalizeCategory(candidate.category),
-            importance: clamp(candidate.importance, 0.1, 1, 0.6),
-            event_date: typeof candidate.eventDate === "string" ? candidate.eventDate : "",
-            tags: normalizeTags([...(candidate.tags ?? []), ...(candidate.relatedMemoryIds ?? []).map((id) => `related:${id}`)]),
-        })).filter((item) => item.text);
-        const result = await this.memoryProvider.proposeExtracted(items, userId, { source: params?.source ?? "manual" });
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, {
-                ok: true,
-                candidates: built.candidates,
-                relatedMemories: built.relatedMemories,
-                extractor: built.extractor,
-                ...result,
-            });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-    }
-}
-export async function handleMemoryConsolidate(msg) {
-    const params = msg.params;
-    this.ensureMemoryProvider?.();
-    if (!this.memoryProvider || typeof this.memoryProvider.ingestExtracted !== "function") {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: "Long-term memory provider is not initialized.",
-            });
-        }
-        return;
-    }
-    const userId = resolveMemoryUserId(this);
-    if (!userId) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "llmrouter user id is required for long-term memory.",
-            });
-        }
-        return;
-    }
-    const inputCandidates = Array.isArray(params?.candidates)
-        ? params.candidates.map(normalizeInputCandidateFromService).filter((candidate) => candidate !== null)
-        : [];
-    const text = typeof params?.text === "string" ? params.text.trim() : "";
-    const attachments = Array.isArray(params?.attachments) ? params.attachments : [];
-    if (inputCandidates.length === 0 && !text && attachments.length === 0) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "candidates, text, or attachments are required.",
-            });
-        }
-        return;
-    }
-    try {
-        if (inputCandidates.length === 0) {
-            const built = await buildMemoryCandidatesFromService(this, {
-                ...params,
-                text,
-                source: typeof params?.source === "string" && params.source.trim() ? params.source.trim() : "manual",
-                autoExtract: params?.autoExtract ?? true,
-            }, userId);
-            inputCandidates.push(...built.candidates);
-        }
-        if (inputCandidates.length === 0) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: "no memory candidates were produced.",
-                });
-            }
-            return;
-        }
-        const attachmentIds = Array.isArray(params?.attachmentIds)
-            ? params.attachmentIds.filter((id) => typeof id === "string" && id.trim().length > 0)
-            : [];
-        const commit = await commitMemoryCandidates(this, userId, inputCandidates, attachmentIds);
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, { ok: true, ...commit });
-        this.sendNotification?.("memory.updated", { source: "local", target: "atlas" });
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleMemoryRead(msg) {
-    const params = msg.params;
-    const source = params?.source ?? "memdir";
-    const target = params?.target ?? "index";
-    if (source === "memdir" || source === "local") {
-        if (!this.memdir) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, { source: "memdir", target, content: "" });
-            }
-            return;
-        }
-        try {
-            if (target === "index") {
-                const content = this.memdir.getIndexRaw();
-                if (msg.id !== undefined) {
-                    this.sendResponse(msg.id, { source: "memdir", target: "index", content });
-                }
-            }
-            else {
-                const result = await this.memdir.readFile(target);
-                if (msg.id !== undefined) {
-                    this.sendResponse(msg.id, {
-                        source: "memdir",
-                        target,
-                        content: result.content ?? "",
-                    });
-                }
-            }
-        }
-        catch {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, { source: "memdir", target, content: "" });
-            }
-        }
-    }
-    else {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: `Unknown memory source: ${source}`,
-            });
-        }
-    }
-}
-export async function handleMemoryWrite(msg) {
-    const params = msg.params;
-    const target = params?.target ?? "index";
-    const content = params?.content;
-    if (content == null) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "content is required.",
-            });
-        }
-        return;
-    }
-    if (!this.memdir) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: "Memory system not initialized.",
-            });
-        }
-        return;
-    }
-    try {
-        if (target === "index") {
-            const result = await this.memdir.addToIndex(content);
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, { ok: result.ok, target: "index", message: result.message });
-            }
-        }
-        else {
-            const result = await this.memdir.writeFile(target, content);
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, { ok: result.ok, target, message: result.message });
-            }
-        }
-        this.sendNotification("memory.updated", { target, source: "rpc" });
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleMemorySearch(msg) {
-    const params = msg.params;
-    if (!params?.query) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "query is required.",
-            });
-        }
-        return;
-    }
-    if (this.memoryProvider?.search) {
-        const userId = resolveMemoryUserId(this);
-        if (!userId) {
-            if (msg.id !== undefined)
-                this.sendResponse(msg.id, { results: [] });
-            return;
-        }
-        try {
-            const results = await this.memoryProvider.search(params.query, userId, { limit: params.limit ?? 10 });
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, {
-                    results: results.map((r) => ({
-                        id: r.blockId ?? "",
-                        text: r.text,
-                        score: r.score,
-                        source: "local",
-                        metadata: r.metadata,
-                    })),
-                });
-            }
-        }
-        catch (err) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                    message: err instanceof Error ? err.message : String(err),
-                });
-            }
-        }
-    }
-    else if (this.memdir) {
-        try {
-            const results = await this.memdir.searchLocal(params.query);
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, {
-                    results: results.slice(0, params.limit ?? 10).map((r, i) => ({
-                        id: `memdir-${i}`,
-                        text: r.snippet,
-                        score: r.score,
-                        source: "memdir",
-                        metadata: { file: r.file },
-                    })),
-                });
-            }
-        }
-        catch {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, { results: [] });
-            }
-        }
-    }
-    else {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { results: [] });
-        }
-    }
-}
-export async function handleMemoryDelete(msg) {
-    const params = msg.params;
-    if (!params?.match) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "match is required.",
-            });
-        }
-        return;
-    }
-    const source = params.source ?? "memdir";
-    if (source === "memdir" || source === "local") {
-        if (!this.memdir) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                    message: "Memory system not initialized.",
-                });
-            }
-            return;
-        }
-        const target = params.target ?? "index";
-        try {
-            if (target === "index") {
-                const result = await this.memdir.removeFromIndex(params.match);
-                if (msg.id !== undefined) {
-                    this.sendResponse(msg.id, { ok: result.ok, removedCount: result.ok ? 1 : 0, message: result.message });
-                }
-                if (result.ok) {
-                    this.sendNotification("memory.updated", { source: "memdir", target: "index" });
-                }
-            }
-            else {
-                const result = await this.memdir.deleteFile(target);
-                if (msg.id !== undefined) {
-                    this.sendResponse(msg.id, { ok: result.ok, removedCount: result.ok ? 1 : 0, message: result.message });
-                }
-                if (result.ok) {
-                    this.sendNotification("memory.updated", { source: "memdir", target });
-                }
-            }
-        }
-        catch (err) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                    message: err instanceof Error ? err.message : String(err),
-                });
-            }
-        }
-    }
-    else if (source === "vector" && this.memoryProvider?.remove) {
-        try {
-            await this.memoryProvider.remove(params.match);
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, { ok: true, removedCount: 1, message: "Removed from local memory." });
-            }
-            this.sendNotification("memory.updated", { source: "local" });
-        }
-        catch (err) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                    message: err instanceof Error ? err.message : String(err),
-                });
-            }
-        }
-    }
-    else {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: `Unknown or unavailable source: ${source}`,
-            });
-        }
-    }
-}
-export async function handleMemoryUpdate(msg) {
-    const params = msg.params;
-    const id = typeof params?.id === "string" ? params.id.trim() : "";
-    if (!id) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "id is required.",
-            });
-        }
-        return;
-    }
-    this.ensureMemoryProvider?.();
-    if (!this.memoryProvider || typeof this.memoryProvider.update !== "function") {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: "Long-term memory provider does not support updates.",
-            });
-        }
-        return;
-    }
-    try {
-        const ok = await this.memoryProvider.update(id, {
-            text: typeof params?.text === "string" ? params.text : undefined,
-            category: typeof params?.category === "string" ? normalizeCategory(params.category) : undefined,
-            importance: typeof params?.importance === "number" ? clamp(params.importance, 0.1, 1, 0.6) : undefined,
-            source: typeof params?.source === "string" ? params.source.trim().slice(0, 80) : undefined,
-            eventDate: typeof params?.eventDate === "string" ? params.eventDate.trim().slice(0, 32) : undefined,
-            tags: Array.isArray(params?.tags) ? normalizeTags(params.tags) : undefined,
-        });
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { ok, updated: ok ? 1 : 0 });
-        }
-        if (ok)
-            this.sendNotification("memory.updated", { source: "local", target: "atlas" });
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-/**
- * memory.attachment.adopt: persist an uploaded attachment into the long-term-memory
- * attachment store from a transient source URL (the gateway's temp MediaStore).
- * The attachment is an orphan until linked to a memory at consolidate time.
- */
-export async function handleMemoryAttachmentAdopt(msg) {
-    const params = msg.params;
-    this.ensureMemoryProvider?.();
-    if (!this.memoryProvider || typeof this.memoryProvider.adoptAttachment !== "function") {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: "Long-term memory provider does not support attachments.",
-            });
-        return;
-    }
-    const userId = resolveMemoryUserId(this);
-    if (!userId) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "llmrouter user id is required for long-term memory.",
-            });
-        return;
-    }
-    const tempUrl = typeof params?.tempUrl === "string" ? params.tempUrl.trim() : "";
-    if (!tempUrl) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "tempUrl is required.",
-            });
-        return;
-    }
-    try {
-        const attachment = await this.memoryProvider.adoptAttachment({
-            sourceUrl: tempUrl,
-            filename: typeof params?.filename === "string" && params.filename.trim() ? params.filename.trim() : "attachment",
-            mimeType: typeof params?.mimeType === "string" ? params.mimeType : "application/octet-stream",
-            userId,
-        });
-        void this.memoryProvider.purgeOrphanAttachments?.();
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, { ok: true, attachment });
-    }
-    catch (err) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-    }
-}
-/** memory.attachment.locate: resolve an attachment id to its on-disk path (for serving). */
-export async function handleMemoryAttachmentLocate(msg) {
-    const params = msg.params;
-    this.ensureMemoryProvider?.();
-    if (!this.memoryProvider || typeof this.memoryProvider.locateAttachment !== "function") {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: "Long-term memory provider does not support attachments.",
-            });
-        return;
-    }
-    const id = typeof params?.id === "string" ? params.id.trim() : "";
-    if (!id) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "id is required.",
-            });
-        return;
-    }
-    try {
-        const located = await this.memoryProvider.locateAttachment(id);
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, located ? { ok: true, ...located } : { ok: false });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-    }
-}