@alexandrgreen/anchorclaw 0.0.3

package/dist/memory/get.test.js

@@ -0,0 +1,180 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { memoryGetFromDb } from "./get.js";
+vi.mock("./sessions.js", () => ({
+    memoryGetSessionFile: vi.fn(),
+}));
+vi.mock("./sessions-index-sync.js", () => ({
+    syncSessionsIndexDb: vi.fn(async () => undefined),
+}));
+import { memoryGetSessionFile } from "./sessions.js";
+import { syncSessionsIndexDb } from "./sessions-index-sync.js";
+const limits = {
+    maxResults: 10,
+    getMaxChars: 12_000,
+    getDefaultLines: 120,
+    sessionsMaxFileBytes: 2_000_000,
+    sessionsWrapChars: 800,
+};
+function createPool(rowsByCall) {
+    const query = vi.fn(async () => ({ rows: rowsByCall.shift() ?? [] }));
+    return { query };
+}
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+describe("memoryGetFromDb sessions visibility", () => {
+    it("rejects other-agent sessions lookup in current visibility", async () => {
+        const pool = createPool([]);
+        const got = await memoryGetFromDb({
+            pool,
+            userId: "u1",
+            workspaceId: "w1",
+            agentId: "main",
+            sessionsVisibility: "current",
+            limits,
+            lookup: "sessions/other/s1.jsonl",
+        });
+        expect(got.ok).toBe(false);
+        if (got.ok) {
+            throw new Error("expected failed result");
+        }
+        expect(got.error).toContain("restricted to current agent scope");
+        expect(pool.query).not.toHaveBeenCalled();
+    });
+    it("rejects other-agent sessions lookup in current visibility when runtime agentId is missing", async () => {
+        const pool = createPool([]);
+        const got = await memoryGetFromDb({
+            pool,
+            userId: "u1",
+            workspaceId: "w1",
+            sessionsVisibility: "current",
+            limits,
+            lookup: "sessions/other/s1.jsonl",
+        });
+        expect(got.ok).toBe(false);
+        if (got.ok) {
+            throw new Error("expected failed result");
+        }
+        expect(got.error).toContain("restricted to current agent scope");
+        expect(pool.query).not.toHaveBeenCalled();
+    });
+    it("allows other-agent lookup in visible visibility and can fallback to file", async () => {
+        const pool = createPool([[], []]);
+        vi.mocked(memoryGetSessionFile).mockResolvedValueOnce({
+            text: "User: hi",
+            path: "sessions/other/s1.jsonl",
+            from: 1,
+            lines: 1,
+        });
+        const got = await memoryGetFromDb({
+            pool,
+            userId: "u1",
+            workspaceId: "w1",
+            agentId: "main",
+            sessionsVisibility: "visible",
+            limits,
+            lookup: "sessions/other/s1.jsonl",
+        });
+        expect(got.ok).toBe(true);
+        if (!got.ok) {
+            throw new Error("expected successful result");
+        }
+        expect(got.path).toBe("sessions/other/s1.jsonl");
+        expect(got.content).toContain("User: hi");
+    });
+    it("reads indexed sessions content for current agent", async () => {
+        const pool = createPool([
+            [{ id: "f1" }],
+            [
+                { text: "User: hello", start_line: 3 },
+                { text: "Assistant: hi", start_line: 7 },
+            ],
+        ]);
+        const got = await memoryGetFromDb({
+            pool,
+            userId: "u1",
+            workspaceId: "w1",
+            agentId: "main",
+            sessionsVisibility: "current",
+            limits,
+            lookup: "sessions/main/s1.jsonl",
+        });
+        expect(got.ok).toBe(true);
+        if (!got.ok) {
+            throw new Error("expected successful result");
+        }
+        expect(got.path).toBe("sessions/main/s1.jsonl");
+        expect(got.content).toContain("User: hello");
+        expect(got.content).toContain("Assistant: hi");
+    });
+    it("applies upstream agent normalization for current-visibility sessions scope", async () => {
+        const pool = createPool([
+            [{ id: "f1" }],
+            [{ text: "User: hello", start_line: 2 }],
+        ]);
+        const got = await memoryGetFromDb({
+            pool,
+            userId: "u1",
+            workspaceId: "w1",
+            agentId: "Team.Alpha",
+            sessionsVisibility: "current",
+            limits,
+            lookup: "sessions/team-alpha/s1.jsonl",
+        });
+        expect(got.ok).toBe(true);
+        if (!got.ok) {
+            throw new Error("expected successful result");
+        }
+        expect(got.path).toBe("sessions/team-alpha/s1.jsonl");
+        expect(got.content).toContain("User: hello");
+    });
+    it("returns index_corrupt error when file row exists but indexed read is missing", async () => {
+        const pool = createPool([[], [{ id: "indexed-row" }]]);
+        const got = await memoryGetFromDb({
+            pool,
+            userId: "u1",
+            workspaceId: "w1",
+            agentId: "main",
+            sessionsVisibility: "current",
+            limits,
+            lookup: "sessions/main/s1.jsonl",
+        });
+        expect(got.ok).toBe(false);
+        if (got.ok) {
+            throw new Error("expected failed result");
+        }
+        expect(got.error).toContain("index corrupted");
+        expect(vi.mocked(memoryGetSessionFile)).not.toHaveBeenCalled();
+    });
+    it("on index_miss uses file fallback and enqueues targeted reindex", async () => {
+        const pool = createPool([[], []]);
+        vi.mocked(memoryGetSessionFile).mockResolvedValueOnce({
+            text: "User: fallback",
+            path: "sessions/main/s1.jsonl",
+            from: 1,
+            lines: 1,
+        });
+        const got = await memoryGetFromDb({
+            pool,
+            userId: "u1",
+            workspaceId: "w1",
+            agentId: "main",
+            sessionsVisibility: "current",
+            limits,
+            lookup: "sessions/main/s1.jsonl",
+        });
+        expect(got.ok).toBe(true);
+        if (!got.ok) {
+            throw new Error("expected successful result");
+        }
+        expect(got.content).toContain("fallback");
+        expect(vi.mocked(syncSessionsIndexDb)).toHaveBeenCalledTimes(1);
+        expect(vi.mocked(syncSessionsIndexDb)).toHaveBeenCalledWith(expect.objectContaining({
+            userId: "u1",
+            workspaceId: "w1",
+            agentId: "main",
+            sessionFiles: ["sessions/main/s1.jsonl"],
+        }));
+    });
+});
+//# sourceMappingURL=get.test.js.map

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

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

package/dist/memory/limits.d.ts

@@ -0,0 +1,10 @@
+import type { AnchorClawConfig } from "../config.js";
+export type MemoryLimits = {
+    maxResults: number;
+    getMaxChars: number;
+    getDefaultLines: number;
+    sessionsMaxFileBytes: number;
+    sessionsWrapChars: number;
+};
+export declare function resolveMemoryLimits(cfg: AnchorClawConfig): MemoryLimits;
+//# sourceMappingURL=limits.d.ts.map

package/dist/memory/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/memory/limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAUF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,YAAY,CASvE"}

package/dist/memory/limits.js

@@ -0,0 +1,18 @@
+const DEFAULT_LIMITS = {
+    maxResults: 10,
+    getMaxChars: 12_000,
+    getDefaultLines: 120,
+    sessionsMaxFileBytes: 2_000_000,
+    sessionsWrapChars: 800,
+};
+export function resolveMemoryLimits(cfg) {
+    const overrides = cfg.limits;
+    return {
+        maxResults: overrides?.maxResults ?? DEFAULT_LIMITS.maxResults,
+        getMaxChars: overrides?.getMaxChars ?? DEFAULT_LIMITS.getMaxChars,
+        getDefaultLines: overrides?.getDefaultLines ?? DEFAULT_LIMITS.getDefaultLines,
+        sessionsMaxFileBytes: DEFAULT_LIMITS.sessionsMaxFileBytes,
+        sessionsWrapChars: DEFAULT_LIMITS.sessionsWrapChars,
+    };
+}
+//# sourceMappingURL=limits.js.map

package/dist/memory/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/memory/limits.ts"],"names":[],"mappings":"AAUA,MAAM,cAAc,GAAiB;IACnC,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,MAAM;IACnB,eAAe,EAAE,GAAG;IACpB,oBAAoB,EAAE,SAAS;IAC/B,iBAAiB,EAAE,GAAG;CACvB,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,GAAqB;IACvD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC;IAC7B,OAAO;QACL,UAAU,EAAE,SAAS,EAAE,UAAU,IAAI,cAAc,CAAC,UAAU;QAC9D,WAAW,EAAE,SAAS,EAAE,WAAW,IAAI,cAAc,CAAC,WAAW;QACjE,eAAe,EAAE,SAAS,EAAE,eAAe,IAAI,cAAc,CAAC,eAAe;QAC7E,oBAAoB,EAAE,cAAc,CAAC,oBAAoB;QACzD,iBAAiB,EAAE,cAAc,CAAC,iBAAiB;KACpD,CAAC;AACJ,CAAC"}

package/dist/memory/manager.d.ts

@@ -0,0 +1,93 @@
+import type { OpenClawPluginApi } from "../api.js";
+import type { AnchorClawConfig } from "../config.js";
+import type { PostgresPool } from "../postgres.js";
+type MemorySource = "memory" | "sessions";
+type MemorySearchResult = {
+    path: string;
+    startLine: number;
+    endLine: number;
+    score: number;
+    snippet: string;
+    source: MemorySource;
+    citation?: string;
+};
+type MemoryReadResult = {
+    text: string;
+    path: string;
+    truncated?: boolean;
+    from?: number;
+    lines?: number;
+    nextFrom?: number;
+};
+type MemoryProviderStatus = {
+    backend: "builtin" | "qmd";
+    provider: string;
+    model?: string;
+    dirty?: boolean;
+    workspaceDir?: string;
+    sources?: MemorySource[];
+    sourceCounts?: Array<{
+        source: MemorySource;
+        files: number;
+        chunks: number;
+    }>;
+    custom?: Record<string, unknown>;
+};
+type MemoryEmbeddingProbeResult = {
+    ok: boolean;
+    error?: string;
+    checked?: boolean;
+    cached?: boolean;
+    checkedAtMs?: number;
+    cacheExpiresAtMs?: number;
+};
+type MemorySearchRuntimeDebug = {
+    backend: "builtin" | "qmd";
+    configuredMode?: string;
+    effectiveMode?: string;
+    fallback?: string;
+};
+type MemorySyncProgressUpdate = {
+    completed: number;
+    total: number;
+    label?: string;
+};
+export type MemorySearchManager = {
+    search: (query: string, opts?: {
+        maxResults?: number;
+        minScore?: number;
+        sessionKey?: string;
+        qmdSearchModeOverride?: "query" | "search" | "vsearch";
+        onDebug?: (debug: MemorySearchRuntimeDebug) => void;
+        sources?: MemorySource[];
+    }) => Promise<MemorySearchResult[]>;
+    readFile: (params: {
+        relPath: string;
+        from?: number;
+        lines?: number;
+    }) => Promise<MemoryReadResult>;
+    status: () => MemoryProviderStatus;
+    sync?: (params?: {
+        reason?: string;
+        force?: boolean;
+        sessionFiles?: string[];
+        progress?: (update: MemorySyncProgressUpdate) => void;
+    }) => Promise<void>;
+    getCachedEmbeddingAvailability?: () => MemoryEmbeddingProbeResult | null;
+    probeEmbeddingAvailability: () => Promise<MemoryEmbeddingProbeResult>;
+    probeVectorStoreAvailability?: () => Promise<boolean>;
+    probeVectorAvailability: () => Promise<boolean>;
+    close?: () => Promise<void>;
+};
+export type AnchorClawMemorySearchManagerOptions = {
+    api: OpenClawPluginApi;
+    cfg: AnchorClawConfig;
+    ensureReady: () => Promise<void>;
+    ensureSessionsIndexBootstrapped?: () => Promise<void>;
+    getPool: () => PostgresPool;
+    agentId: string;
+    purpose?: "default" | "status" | "cli";
+};
+export declare function createAnchorClawMemorySearchManager(params: AnchorClawMemorySearchManagerOptions): MemorySearchManager;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/memory/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/memory/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAiBnD,KAAK,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1C,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE,SAAS,GAAG,KAAK,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,OAAO,EAAE,SAAS,GAAG,KAAK,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,CACN,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,qBAAqB,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;QACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;QACpD,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;KAC1B,KACE,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpG,MAAM,EAAE,MAAM,oBAAoB,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;KACvD,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,8BAA8B,CAAC,EAAE,MAAM,0BAA0B,GAAG,IAAI,CAAC;IACzE,0BAA0B,EAAE,MAAM,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACtE,4BAA4B,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,uBAAuB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,GAAG,EAAE,iBAAiB,CAAC;IACvB,GAAG,EAAE,gBAAgB,CAAC;IACtB,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,+BAA+B,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,YAAY,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;CACxC,CAAC;AA+BF,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,oCAAoC,GAC3C,mBAAmB,CAoUrB"}

package/dist/memory/manager.js

@@ -0,0 +1,344 @@
+import { resolveUserAndWorkspaceScope } from "../identity.js";
+import { resolveMemoryLimits } from "./limits.js";
+import { memoryGetFromDb } from "./get.js";
+import { memorySearchDb } from "./search.js";
+import { memorySearchSessions } from "./sessions.js";
+import { listKnownAgentIds } from "./sessions.js";
+import { hasSessionsIndexRows, memorySearchSessionsIndexDb, } from "./sessions-index.js";
+import { syncSessionsIndexDb, syncVisibleSessionsIndexDb } from "./sessions-index-sync.js";
+import { canAccessSessionPathByVisibility, filterSessionHitsByVisibility } from "./sessions-visibility.js";
+import { buildMemoryReadResult } from "./read-file-shared.js";
+import fs from "node:fs/promises";
+import path from "node:path";
+function stableScoreSort(left, right) {
+    if (right.score !== left.score) {
+        return right.score - left.score;
+    }
+    // Prefer durable memory over sessions when equal.
+    if (left.source !== right.source) {
+        return left.source === "memory" ? -1 : 1;
+    }
+    return left.path.localeCompare(right.path);
+}
+function mapHitToManagerResult(hit) {
+    const source = hit.corpus === "sessions" ? "sessions" : "memory";
+    const startLine = typeof hit.startLine === "number" && Number.isFinite(hit.startLine) && hit.startLine > 0 ? Math.floor(hit.startLine) : 1;
+    const endLine = typeof hit.endLine === "number" && Number.isFinite(hit.endLine) && hit.endLine >= startLine
+        ? Math.floor(hit.endLine)
+        : startLine;
+    return {
+        path: hit.path,
+        startLine,
+        endLine,
+        score: hit.score,
+        snippet: hit.snippet,
+        source,
+        ...(typeof hit.citation === "string" && hit.citation.trim() ? { citation: hit.citation } : {}),
+    };
+}
+export function createAnchorClawMemorySearchManager(params) {
+    const { api, cfg } = params;
+    const sessionsVisibility = cfg.sessions?.visibility ?? "current";
+    const sessionsEnabled = sessionsVisibility !== "off";
+    const resolveWorkspaceDir = () => {
+        const candidate = api?.runtime?.workspaceDir;
+        if (typeof candidate === "string" && candidate.trim()) {
+            return path.resolve(candidate);
+        }
+        return path.resolve(process.cwd());
+    };
+    const resolveWorkspaceRelativePath = (relPath) => {
+        const trimmed = relPath.trim().replaceAll("\\", "/");
+        if (!trimmed) {
+            return null;
+        }
+        if (trimmed.startsWith("/") || trimmed.includes("..")) {
+            return null;
+        }
+        if (trimmed === "MEMORY.md") {
+            return trimmed;
+        }
+        if (trimmed.startsWith("memory/")) {
+            return trimmed;
+        }
+        return null;
+    };
+    const listVisibleAgentIds = async () => {
+        const currentAgentId = params.agentId;
+        const agentIds = await listKnownAgentIds();
+        return [currentAgentId, ...agentIds.filter((agentId) => agentId !== currentAgentId)];
+    };
+    return {
+        async search(query, opts) {
+            const q = query.trim();
+            if (!q) {
+                return [];
+            }
+            await params.ensureReady();
+            const scope = await resolveUserAndWorkspaceScope({
+                api,
+                pool: params.getPool(),
+                agentId: params.agentId,
+                sessionKey: opts?.sessionKey ?? api?.runtime?.sessionKey,
+                configuredExternalId: cfg.identity?.externalId,
+            });
+            const limits = resolveMemoryLimits(cfg);
+            const requestedSources = Array.isArray(opts?.sources) && opts.sources.length > 0 ? opts.sources : ["memory", "sessions"];
+            const effectiveSources = sessionsEnabled
+                ? requestedSources
+                : requestedSources.filter((source) => source !== "sessions");
+            const maxResults = typeof opts?.maxResults === "number" && Number.isFinite(opts.maxResults) ? Math.floor(opts.maxResults) : limits.maxResults;
+            const results = [];
+            if (effectiveSources.includes("memory")) {
+                const hits = await memorySearchDb({
+                    pool: params.getPool(),
+                    userId: scope.userId,
+                    workspaceId: scope.workspaceId,
+                    limits,
+                    query: q,
+                    maxResults,
+                });
+                results.push(...hits.map(mapHitToManagerResult));
+            }
+            if (effectiveSources.includes("sessions")) {
+                if (typeof params.ensureSessionsIndexBootstrapped === "function") {
+                    await params.ensureSessionsIndexBootstrapped();
+                }
+                const indexedSessionHits = await memorySearchSessionsIndexDb({
+                    pool: params.getPool(),
+                    userId: scope.userId,
+                    workspaceId: scope.workspaceId,
+                    limits,
+                    query: q,
+                    maxResults,
+                    ...(sessionsVisibility === "current" ? { currentAgentId: params.agentId } : {}),
+                });
+                let sessionHits = indexedSessionHits;
+                if (sessionHits.length === 0) {
+                    const hasIndex = await hasSessionsIndexRows({
+                        pool: params.getPool(),
+                        userId: scope.userId,
+                        workspaceId: scope.workspaceId,
+                        ...(sessionsVisibility === "current" ? { currentAgentId: params.agentId } : {}),
+                    });
+                    if (!hasIndex) {
+                        sessionHits = await memorySearchSessions({
+                            query: q,
+                            maxResults,
+                            agentId: params.agentId,
+                            limits,
+                        });
+                    }
+                }
+                const mappedSessionHits = sessionHits.map(mapHitToManagerResult);
+                const filteredSessionHits = await filterSessionHitsByVisibility({
+                    api,
+                    hits: mappedSessionHits,
+                });
+                results.push(...filteredSessionHits);
+            }
+            // No semantic/vector layer yet.
+            if (typeof opts?.onDebug === "function") {
+                opts.onDebug({ backend: "builtin", configuredMode: "postgres", effectiveMode: "postgres" });
+            }
+            // Filter by minScore if provided (mostly relevant for vector search; keep behavior consistent).
+            const minScore = typeof opts?.minScore === "number" && Number.isFinite(opts.minScore) ? opts.minScore : undefined;
+            const filtered = minScore !== undefined ? results.filter((item) => item.score >= minScore) : results;
+            return filtered.slice().sort(stableScoreSort).slice(0, maxResults);
+        },
+        async readFile(readParams) {
+            await params.ensureReady();
+            const relPath = readParams.relPath.trim();
+            const scope = await resolveUserAndWorkspaceScope({
+                api,
+                pool: params.getPool(),
+                agentId: params.agentId,
+                sessionKey: api?.runtime?.sessionKey,
+                configuredExternalId: cfg.identity?.externalId,
+            });
+            const limits = resolveMemoryLimits(cfg);
+            const fromLine = readParams.from ?? 1;
+            const lineCount = readParams.lines ?? limits.getDefaultLines;
+            if (relPath.startsWith("sessions/")) {
+                if (!sessionsEnabled) {
+                    return { text: "", path: readParams.relPath };
+                }
+                const verdict = await canAccessSessionPathByVisibility({
+                    api,
+                    path: relPath,
+                });
+                if (!verdict.allowed) {
+                    return { text: "", path: readParams.relPath };
+                }
+                const got = await memoryGetFromDb({
+                    pool: params.getPool(),
+                    userId: scope.userId,
+                    workspaceId: scope.workspaceId,
+                    agentId: params.agentId,
+                    sessionsVisibility,
+                    limits,
+                    lookup: relPath,
+                    fromLine,
+                    lineCount,
+                });
+                if (!got.ok) {
+                    return { text: "", path: readParams.relPath };
+                }
+                return {
+                    text: got.content,
+                    path: got.path,
+                    from: got.fromLine,
+                    lines: got.lineCount,
+                };
+            }
+            if (relPath === "MEMORY.md") {
+                const got = await memoryGetFromDb({
+                    pool: params.getPool(),
+                    userId: scope.userId,
+                    workspaceId: scope.workspaceId,
+                    agentId: params.agentId,
+                    sessionsVisibility,
+                    limits,
+                    lookup: "db-memory/export/MEMORY.md",
+                    fromLine,
+                    lineCount,
+                });
+                if (!got.ok) {
+                    return { text: "", path: relPath };
+                }
+                return {
+                    text: got.content,
+                    path: relPath,
+                    from: got.fromLine,
+                    lines: got.lineCount,
+                };
+            }
+            const workspaceRelative = resolveWorkspaceRelativePath(relPath);
+            if (workspaceRelative) {
+                const workspaceDir = resolveWorkspaceDir();
+                const absPath = path.resolve(workspaceDir, workspaceRelative);
+                const relative = path.relative(workspaceDir, absPath);
+                if (relative.startsWith("..") || path.isAbsolute(relative)) {
+                    return { text: "", path: relPath };
+                }
+                try {
+                    const content = await fs.readFile(absPath, "utf8");
+                    const read = buildMemoryReadResult({
+                        content,
+                        relPath: workspaceRelative,
+                        from: fromLine,
+                        lines: lineCount,
+                        defaultLines: limits.getDefaultLines,
+                        maxChars: limits.getMaxChars,
+                    });
+                    return {
+                        text: read.text,
+                        path: read.path,
+                        ...(read.truncated ? { truncated: true } : {}),
+                        ...(typeof read.from === "number" ? { from: read.from } : {}),
+                        ...(typeof read.lines === "number" ? { lines: read.lines } : {}),
+                        ...(typeof read.nextFrom === "number" ? { nextFrom: read.nextFrom } : {}),
+                    };
+                }
+                catch {
+                    return { text: "", path: relPath };
+                }
+            }
+            const got = await memoryGetFromDb({
+                pool: params.getPool(),
+                userId: scope.userId,
+                workspaceId: scope.workspaceId,
+                agentId: params.agentId,
+                sessionsVisibility,
+                limits,
+                lookup: readParams.relPath,
+                fromLine,
+                lineCount,
+            });
+            if (!got.ok) {
+                return { text: "", path: readParams.relPath };
+            }
+            return {
+                text: got.content,
+                path: got.path,
+                from: got.fromLine,
+                lines: got.lineCount,
+            };
+        },
+        status() {
+            const limits = resolveMemoryLimits(cfg);
+            const workspaceDir = resolveWorkspaceDir();
+            return {
+                backend: "builtin",
+                provider: "anchorclaw-postgres",
+                workspaceDir,
+                sources: sessionsEnabled ? ["memory", "sessions"] : ["memory"],
+                custom: {
+                    backend: "postgres",
+                    postgresHost: cfg.postgres.host,
+                    postgresDatabase: cfg.postgres.database,
+                    limits,
+                    sessionsMaxFileBytes: limits.sessionsMaxFileBytes,
+                    sessionsVisibility,
+                    purpose: params.purpose ?? "default",
+                },
+            };
+        },
+        async sync(syncParams) {
+            if (!sessionsEnabled) {
+                if (typeof syncParams?.progress === "function") {
+                    syncParams.progress({ completed: 1, total: 1, label: "sessions disabled" });
+                }
+                return;
+            }
+            await params.ensureReady();
+            const scope = await resolveUserAndWorkspaceScope({
+                api,
+                pool: params.getPool(),
+                agentId: params.agentId,
+                sessionKey: api?.runtime?.sessionKey,
+                configuredExternalId: cfg.identity?.externalId,
+            });
+            if (typeof syncParams?.progress === "function") {
+                syncParams.progress({ completed: 0, total: 1, label: "syncing sessions index" });
+            }
+            const sessionFiles = Array.isArray(syncParams?.sessionFiles) && syncParams.sessionFiles.length > 0
+                ? syncParams.sessionFiles
+                : undefined;
+            if (!sessionFiles && sessionsVisibility === "visible") {
+                const visibleAgentIds = await listVisibleAgentIds();
+                await syncVisibleSessionsIndexDb({
+                    pool: params.getPool(),
+                    userId: scope.userId,
+                    workspaceId: scope.workspaceId,
+                    agentId: params.agentId,
+                    otherAgentIds: visibleAgentIds.filter((agentId) => agentId !== params.agentId),
+                    force: syncParams?.force === true,
+                });
+            }
+            else {
+                await syncSessionsIndexDb({
+                    pool: params.getPool(),
+                    userId: scope.userId,
+                    workspaceId: scope.workspaceId,
+                    agentId: params.agentId,
+                    force: syncParams?.force === true,
+                    ...(sessionFiles ? { sessionFiles } : {}),
+                });
+            }
+            if (typeof syncParams?.progress === "function") {
+                syncParams.progress({ completed: 1, total: 1, label: "done" });
+            }
+        },
+        getCachedEmbeddingAvailability() {
+            return { ok: false, cached: true, checked: true, error: "semantic layer not configured" };
+        },
+        async probeEmbeddingAvailability() {
+            return { ok: false, checked: true, checkedAtMs: Date.now(), error: "semantic layer not configured" };
+        },
+        async probeVectorAvailability() {
+            return false;
+        },
+    };
+}
+//# sourceMappingURL=manager.js.map