@alexandrgreen/anchorclaw 0.0.3

package/dist/plugin/tools/memory-search.js

@@ -0,0 +1,332 @@
+import { resolveUserAndWorkspaceScope } from "../../identity.js";
+import { resolveMemoryLimits } from "../../memory/limits.js";
+import { memorySearchDb } from "../../memory/search.js";
+import { memorySearchSessions } from "../../memory/sessions.js";
+import { hasSessionsIndexRows, memorySearchSessionsIndexDb } from "../../memory/sessions-index.js";
+import { filterSessionHitsByVisibility } from "../../memory/sessions-visibility.js";
+import { formatSearchLikeVisibleOutput } from "./memory-visible-output.js";
+function normalizeExact(value) {
+    return typeof value === "string" ? value.trim().toLowerCase() : "";
+}
+function classifyQueryMode(query) {
+    const normalized = query.trim().toLowerCase();
+    if (!normalized) {
+        return "contextual";
+    }
+    const broadSignals = [
+        "summarize",
+        "summary",
+        "overview",
+        "around",
+        "what values",
+        "какие",
+        "кратко",
+        "обзор",
+        "сгруппируй",
+        "вокруг",
+    ];
+    if (broadSignals.some((signal) => normalized.includes(signal))) {
+        return "contextual";
+    }
+    const exactSignals = [
+        "exact",
+        "top-1",
+        "only",
+        "value only",
+        "string only",
+        "id",
+        "key",
+        "marker",
+        "token",
+        "uuid",
+        "login",
+        "точн",
+        "только",
+        "значени",
+    ];
+    return exactSignals.some((signal) => normalized.includes(signal)) ? "exact_value" : "contextual";
+}
+function isMarkerLike(value) {
+    const text = value.trim();
+    if (!text) {
+        return false;
+    }
+    if (/^[A-Z0-9]+(?:_[A-Z0-9]+){2,}$/.test(text)) {
+        return true;
+    }
+    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(text)) {
+        return true;
+    }
+    if (/^@\w{3,}$/.test(text)) {
+        return true;
+    }
+    return /^[0-9]{6,}$/.test(text);
+}
+function markerBoostForHit(hit) {
+    const title = typeof hit?.title === "string" ? hit.title : "";
+    const snippet = typeof hit?.snippet === "string" ? hit.snippet : "";
+    return isMarkerLike(title) || isMarkerLike(snippet) ? 2 : 0;
+}
+export function registerMemorySearchTool({ ctx, ensureSessionsIndexBootstrapped, }) {
+    const api = ctx.api;
+    api.registerTool({
+        name: "memory_search",
+        label: "Memory Search",
+        description: "Search memory.\n\nBehavior contract:\n- corpus defaults to \"memory\" (durable items in Postgres).\n- For corpus=\"memory\", retrieval is lexical Postgres FTS (tsquery/ts_rank), not vector semantic retrieval.\n- corpus=\"sessions\" uses Postgres-backed sessions index (DB-first) and returns paths like sessions/<agentId>/<session>.jsonl.\n- Results contain synthetic paths. Use memory_get to read them.\n- If the top result is an exact literal match, content includes \"Top exact match: <value>\" and details.meta.exactTop1/exactTop1Value.\n- Do not claim semantic/vector retrieval unless details.meta explicitly reports it in a future implementation.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                query: { type: "string", description: "Search query text." },
+                corpus: {
+                    type: "string",
+                    description: "Memory corpus (memory|sessions|all). Defaults to memory.",
+                    enum: ["memory", "sessions", "all", "wiki"],
+                },
+                maxResults: { type: "number", description: "Max results (capped by configured limits)." },
+                minScore: { type: "number", description: "Optional minimum score threshold." },
+            },
+        },
+        async execute(_toolCallId, params) {
+            if (ctx.disabledReason) {
+                return {
+                    content: [{ type: "text", text: `anchorclaw: disabled until configured (${ctx.disabledReason})` }],
+                    details: { disabled: true, error: ctx.disabledReason },
+                };
+            }
+            await ctx.ensureReady();
+            const scope = await resolveUserAndWorkspaceScope({
+                api,
+                pool: ctx.getPool(),
+                agentId: api?.runtime?.agentId,
+                sessionKey: api?.runtime?.sessionKey,
+                configuredExternalId: ctx.cfg?.identity?.externalId,
+            });
+            const limits = resolveMemoryLimits(ctx.cfg);
+            const record = (params ?? {});
+            const query = typeof record.query === "string" ? String(record.query) : "";
+            const corpus = typeof record.corpus === "string" ? String(record.corpus) : "memory";
+            const maxResults = typeof record.maxResults === "number" ? record.maxResults : undefined;
+            const minScore = typeof record.minScore === "number" ? record.minScore : undefined;
+            const effectiveMax = typeof maxResults === "number" ? maxResults : limits.maxResults;
+            const trimmedCorpus = corpus.trim();
+            const sessionsVisibility = ctx.cfg?.sessions?.visibility ?? "current";
+            const sessionsEnabled = sessionsVisibility !== "off";
+            if (trimmedCorpus === "wiki") {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "anchorclaw: corpus=wiki is not implemented yet. Use the memory-wiki tools (wiki_search/wiki_get) for now.",
+                        },
+                    ],
+                    details: { disabled: true, error: "corpus=wiki not implemented" },
+                };
+            }
+            let hits = [];
+            let retrievalMode = "fts_memory";
+            try {
+                if (trimmedCorpus === "sessions") {
+                    if (!sessionsEnabled) {
+                        return {
+                            content: [{ type: "text", text: "anchorclaw: sessions corpus is disabled by config (sessions.visibility=off)" }],
+                            details: { disabled: true, error: "sessions corpus disabled", visibility: sessionsVisibility },
+                        };
+                    }
+                    await ensureSessionsIndexBootstrapped();
+                    const indexedHits = await memorySearchSessionsIndexDb({
+                        pool: ctx.getPool(),
+                        userId: scope.userId,
+                        workspaceId: scope.workspaceId,
+                        limits,
+                        query,
+                        maxResults: effectiveMax,
+                        ...(sessionsVisibility === "current" ? { currentAgentId: String(api?.runtime?.agentId ?? "main") } : {}),
+                    });
+                    if (indexedHits.length > 0) {
+                        hits = indexedHits;
+                        retrievalMode = "sessions_index";
+                    }
+                    else {
+                        const hasIndex = await hasSessionsIndexRows({
+                            pool: ctx.getPool(),
+                            userId: scope.userId,
+                            workspaceId: scope.workspaceId,
+                            ...(sessionsVisibility === "current" ? { currentAgentId: String(api?.runtime?.agentId ?? "main") } : {}),
+                        });
+                        hits = hasIndex
+                            ? []
+                            : await memorySearchSessions({
+                                query,
+                                maxResults: effectiveMax,
+                                agentId: api?.runtime?.agentId,
+                                limits,
+                            });
+                        retrievalMode = hasIndex ? "sessions_index" : "sessions_fallback";
+                    }
+                    hits = await filterSessionHitsByVisibility({ api, hits });
+                }
+                else if (trimmedCorpus === "memory") {
+                    hits = await memorySearchDb({
+                        pool: ctx.getPool(),
+                        userId: scope.userId,
+                        workspaceId: scope.workspaceId,
+                        limits,
+                        query,
+                        ...(typeof maxResults === "number" ? { maxResults } : {}),
+                    });
+                    retrievalMode = "fts_memory";
+                }
+                else if (trimmedCorpus === "all") {
+                    if (sessionsEnabled) {
+                        await ensureSessionsIndexBootstrapped();
+                    }
+                    const merged = [
+                        ...(await memorySearchDb({
+                            pool: ctx.getPool(),
+                            userId: scope.userId,
+                            workspaceId: scope.workspaceId,
+                            limits,
+                            query,
+                            maxResults: effectiveMax,
+                        })),
+                        ...(sessionsEnabled
+                            ? await memorySearchSessionsIndexDb({
+                                pool: ctx.getPool(),
+                                userId: scope.userId,
+                                workspaceId: scope.workspaceId,
+                                limits,
+                                query,
+                                maxResults: effectiveMax,
+                                ...(sessionsVisibility === "current" ? { currentAgentId: String(api?.runtime?.agentId ?? "main") } : {}),
+                            })
+                            : []),
+                    ];
+                    if (sessionsEnabled) {
+                        const hasSessionsHits = merged.some((item) => item?.corpus === "sessions");
+                        if (!hasSessionsHits) {
+                            const hasIndex = await hasSessionsIndexRows({
+                                pool: ctx.getPool(),
+                                userId: scope.userId,
+                                workspaceId: scope.workspaceId,
+                                ...(sessionsVisibility === "current" ? { currentAgentId: String(api?.runtime?.agentId ?? "main") } : {}),
+                            });
+                            if (!hasIndex) {
+                                merged.push(...(await memorySearchSessions({
+                                    query,
+                                    maxResults: effectiveMax,
+                                    agentId: api?.runtime?.agentId,
+                                    limits,
+                                })));
+                            }
+                        }
+                    }
+                    const mergedForOutput = sessionsEnabled
+                        ? await filterSessionHitsByVisibility({ api, hits: merged })
+                        : merged;
+                    mergedForOutput.sort((left, right) => {
+                        const ls = typeof left?.score === "number" ? left.score : 0;
+                        const rs = typeof right?.score === "number" ? right.score : 0;
+                        if (rs !== ls) {
+                            return rs - ls;
+                        }
+                        const lc = left?.corpus === "sessions" ? "sessions" : "memory";
+                        const rc = right?.corpus === "sessions" ? "sessions" : "memory";
+                        if (lc !== rc) {
+                            return lc === "memory" ? -1 : 1;
+                        }
+                        const lp = typeof left?.path === "string" ? left.path : "";
+                        const rp = typeof right?.path === "string" ? right.path : "";
+                        return lp.localeCompare(rp);
+                    });
+                    hits = mergedForOutput.slice(0, effectiveMax);
+                    retrievalMode = "all_merge_lexical";
+                }
+                ctx.markSdkSuccess();
+            }
+            catch (error) {
+                ctx.markSdkError(`memory_search:${trimmedCorpus || "unknown"}`, error);
+                const message = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [{ type: "text", text: `anchorclaw: memory_search degraded (sdk/runtime error: ${message})` }],
+                    details: {
+                        disabled: true,
+                        error: message,
+                        degraded: true,
+                        degradedReason: "sdk_error",
+                        sdk: { ...ctx.sdkHealth },
+                    },
+                };
+            }
+            if (trimmedCorpus !== "memory" && trimmedCorpus !== "sessions" && trimmedCorpus !== "all") {
+                return {
+                    content: [{ type: "text", text: `anchorclaw: unsupported corpus (${trimmedCorpus || "empty"})` }],
+                    details: { disabled: true, error: "unsupported corpus", corpus: trimmedCorpus },
+                };
+            }
+            if (typeof minScore === "number" && Number.isFinite(minScore)) {
+                hits = hits.filter((hit) => typeof hit?.score === "number" && hit.score >= minScore);
+            }
+            const normalizedQuery = normalizeExact(query);
+            const queryMode = classifyQueryMode(query);
+            if (queryMode === "exact_value") {
+                hits.sort((left, right) => {
+                    const ls = (typeof left?.score === "number" ? left.score : 0) + markerBoostForHit(left);
+                    const rs = (typeof right?.score === "number" ? right.score : 0) + markerBoostForHit(right);
+                    if (rs !== ls) {
+                        return rs - ls;
+                    }
+                    const lp = typeof left?.path === "string" ? left.path : "";
+                    const rp = typeof right?.path === "string" ? right.path : "";
+                    return lp.localeCompare(rp);
+                });
+            }
+            const topHit = hits[0];
+            const topTitle = normalizeExact(topHit?.title);
+            const topSnippet = normalizeExact(topHit?.snippet);
+            const exactTop1 = Boolean(normalizedQuery &&
+                topHit &&
+                (topTitle === normalizedQuery || topSnippet === normalizedQuery));
+            const exactTop1Value = exactTop1
+                ? (typeof topHit?.title === "string" && topHit.title.trim()) ||
+                    (typeof topHit?.snippet === "string" && topHit.snippet.trim()) ||
+                    null
+                : null;
+            const recommendedAction = exactTop1 ? "return_exact" : hits.length > 0 ? "inspect_top" : "stop_not_found";
+            const visible = formatSearchLikeVisibleOutput({
+                hits,
+                retrievalMode,
+                queryMode,
+                exactTop1,
+                exactTop1Value,
+                recommendedAction,
+                provider: "anchorclaw",
+                model: "postgres-fts",
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: visible,
+                    },
+                ],
+                details: {
+                    results: hits,
+                    count: hits.length,
+                    meta: {
+                        retrievalMode,
+                        queryMode,
+                        semantic: false,
+                        exactTop1,
+                        exactTop1Value,
+                        recommendedAction,
+                    },
+                    ...(ctx.sdkHealth.degraded
+                        ? { degraded: true, degradedReason: "sdk_error", sdk: { ...ctx.sdkHealth } }
+                        : {}),
+                },
+            };
+        },
+    });
+}
+//# sourceMappingURL=memory-search.js.map

package/dist/plugin/tools/memory-search.js.map

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

package/dist/plugin/tools/memory-search.test.d.ts

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

package/dist/plugin/tools/memory-search.test.d.ts.map

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

package/dist/plugin/tools/memory-search.test.js

@@ -0,0 +1,205 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { registerMemorySearchTool } from "./memory-search.js";
+const { resolveScopeMock, resolveLimitsMock, memorySearchDbMock, memorySearchSessionsMock, hasSessionsIndexRowsMock, memorySearchSessionsIndexDbMock, filterSessionHitsByVisibilityMock, } = vi.hoisted(() => ({
+    resolveScopeMock: vi.fn(async () => ({ userId: "u1", workspaceId: "w1" })),
+    resolveLimitsMock: vi.fn(() => ({ maxResults: 10 })),
+    memorySearchDbMock: vi.fn(async () => []),
+    memorySearchSessionsMock: vi.fn(async () => []),
+    hasSessionsIndexRowsMock: vi.fn(async () => false),
+    memorySearchSessionsIndexDbMock: vi.fn(async () => []),
+    filterSessionHitsByVisibilityMock: vi.fn(async ({ hits }) => hits),
+}));
+vi.mock("../../identity.js", () => ({
+    resolveUserAndWorkspaceScope: resolveScopeMock,
+}));
+vi.mock("../../memory/limits.js", () => ({
+    resolveMemoryLimits: resolveLimitsMock,
+}));
+vi.mock("../../memory/search.js", () => ({
+    memorySearchDb: memorySearchDbMock,
+}));
+vi.mock("../../memory/sessions.js", () => ({
+    memorySearchSessions: memorySearchSessionsMock,
+}));
+vi.mock("../../memory/sessions-index.js", () => ({
+    hasSessionsIndexRows: hasSessionsIndexRowsMock,
+    memorySearchSessionsIndexDb: memorySearchSessionsIndexDbMock,
+}));
+vi.mock("../../memory/sessions-visibility.js", () => ({
+    filterSessionHitsByVisibility: filterSessionHitsByVisibilityMock,
+}));
+function buildCtx() {
+    const registerTool = vi.fn();
+    return {
+        ctx: {
+            api: {
+                registerTool,
+                runtime: { agentId: "main", sessionKey: "agent:main:main" },
+            },
+            disabledReason: null,
+            cfg: { sessions: { visibility: "current" } },
+            ensureReady: vi.fn(async () => undefined),
+            getPool: vi.fn(() => ({ query: vi.fn() })),
+            sdkHealth: { degraded: false, reason: null, affectedOperation: null },
+            markSdkSuccess: vi.fn(),
+            markSdkError: vi.fn(),
+        },
+        registerTool,
+    };
+}
+describe("memory_search tool exactTop1 metadata", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("emits exactTop1 metadata and top exact line for literal top-1 match", async () => {
+        memorySearchDbMock.mockResolvedValueOnce([
+            {
+                corpus: "memory",
+                path: "db-memory/items/1.md",
+                id: "1",
+                title: "ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515",
+                kind: "note",
+                score: 6.7,
+                snippet: "ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515",
+            },
+        ]);
+        const { ctx, registerTool } = buildCtx();
+        registerMemorySearchTool({
+            ctx,
+            refreshPromptCache: vi.fn(),
+            ensureSessionsIndexBootstrapped: vi.fn(async () => undefined),
+        });
+        const def = registerTool.mock.calls[0]?.[0];
+        const result = await def.execute("toolcall-1", {
+            query: "ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515",
+            corpus: "memory",
+        });
+        const visible = JSON.parse(result.content[0].text);
+        expect(visible.results).toHaveLength(1);
+        expect(visible.queryMode).toBe("exact_value");
+        expect(visible.topCandidates[0]).toBe("ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515");
+        expect(visible.results[0].snippet).toContain("ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515");
+        expect(visible.meta.recommendedAction).toBe("return_exact");
+        expect(visible.meta.exactTop1Value).toBe("ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515");
+        expect(result.details.meta).toMatchObject({
+            exactTop1: true,
+            exactTop1Value: "ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515",
+            recommendedAction: "return_exact",
+        });
+    });
+    it("does not emit exactTop1 metadata for non-literal top-1", async () => {
+        memorySearchDbMock.mockResolvedValueOnce([
+            {
+                corpus: "memory",
+                path: "db-memory/items/2.md",
+                id: "2",
+                title: "RETRIEVAL_MARKER_20260515_D gamma grape",
+                kind: "note",
+                score: 1.4,
+                snippet: "RETRIEVAL_MARKER_20260515_D gamma grape",
+            },
+        ]);
+        const { ctx, registerTool } = buildCtx();
+        registerMemorySearchTool({
+            ctx,
+            refreshPromptCache: vi.fn(),
+            ensureSessionsIndexBootstrapped: vi.fn(async () => undefined),
+        });
+        const def = registerTool.mock.calls[0]?.[0];
+        const result = await def.execute("toolcall-2", { query: "smoke", corpus: "memory" });
+        const visible = JSON.parse(result.content[0].text);
+        expect(visible.results).toHaveLength(1);
+        expect(visible.queryMode).toBe("contextual");
+        expect(visible.meta.recommendedAction).toBe("inspect_top");
+        expect(result.details.meta).toMatchObject({
+            exactTop1: false,
+            exactTop1Value: null,
+            recommendedAction: "inspect_top",
+        });
+    });
+    it("emits stop_not_found recommendation when there are no hits", async () => {
+        memorySearchDbMock.mockResolvedValueOnce([]);
+        const { ctx, registerTool } = buildCtx();
+        registerMemorySearchTool({
+            ctx,
+            refreshPromptCache: vi.fn(),
+            ensureSessionsIndexBootstrapped: vi.fn(async () => undefined),
+        });
+        const def = registerTool.mock.calls[0]?.[0];
+        const result = await def.execute("toolcall-3", { query: "nothing-here", corpus: "memory" });
+        const visible = JSON.parse(result.content[0].text);
+        expect(visible.results).toHaveLength(0);
+        expect(visible.queryMode).toBe("contextual");
+        expect(visible.meta.recommendedAction).toBe("stop_not_found");
+        expect(result.details.meta).toMatchObject({
+            exactTop1: false,
+            exactTop1Value: null,
+            recommendedAction: "stop_not_found",
+        });
+    });
+    it("boosts marker-like candidates in exact_value mode", async () => {
+        memorySearchDbMock.mockResolvedValueOnce([
+            {
+                corpus: "memory",
+                path: "db-memory/items/desc.md",
+                id: "desc",
+                title: "anchorclaw post-restart smoke",
+                kind: "note",
+                score: 2.0,
+                snippet: "anchorclaw post-restart smoke",
+            },
+            {
+                corpus: "memory",
+                path: "db-memory/items/marker.md",
+                id: "marker",
+                title: "ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515",
+                kind: "note",
+                score: 1.0,
+                snippet: "ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515",
+            },
+        ]);
+        const { ctx, registerTool } = buildCtx();
+        registerMemorySearchTool({
+            ctx,
+            refreshPromptCache: vi.fn(),
+            ensureSessionsIndexBootstrapped: vi.fn(async () => undefined),
+        });
+        const def = registerTool.mock.calls[0]?.[0];
+        const result = await def.execute("toolcall-4", {
+            query: "What exact marker did I save?",
+            corpus: "memory",
+        });
+        const visible = JSON.parse(result.content[0].text);
+        expect(visible.queryMode).toBe("exact_value");
+        expect(visible.topCandidates[0]).toBe("ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515");
+        expect(visible.results[0].snippet).toContain("ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515");
+    });
+    it("keeps contextual mode for broad marker/id/key summary prompts", async () => {
+        memorySearchDbMock.mockResolvedValueOnce([
+            {
+                corpus: "memory",
+                path: "db-memory/items/desc.md",
+                id: "desc",
+                title: "anchorclaw post-restart smoke",
+                kind: "note",
+                score: 2.0,
+                snippet: "anchorclaw post-restart smoke",
+            },
+        ]);
+        const { ctx, registerTool } = buildCtx();
+        registerMemorySearchTool({
+            ctx,
+            refreshPromptCache: vi.fn(),
+            ensureSessionsIndexBootstrapped: vi.fn(async () => undefined),
+        });
+        const def = registerTool.mock.calls[0]?.[0];
+        const result = await def.execute("toolcall-5", {
+            query: "What marker/id/key values do we have around tests? Summarize briefly.",
+            corpus: "memory",
+        });
+        const visible = JSON.parse(result.content[0].text);
+        expect(visible.queryMode).toBe("contextual");
+        expect(visible.meta.queryMode).toBe("contextual");
+    });
+});
+//# sourceMappingURL=memory-search.test.js.map

package/dist/plugin/tools/memory-search.test.js.map

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

package/dist/plugin/tools/memory-status.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRegistrationParams } from "./common.js";
+export declare function registerMemoryStatusTool({ ctx }: ToolRegistrationParams): void;
+//# sourceMappingURL=memory-status.d.ts.map

package/dist/plugin/tools/memory-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-status.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/memory-status.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAK1D,wBAAgB,wBAAwB,CAAC,EAAE,GAAG,EAAE,EAAE,sBAAsB,QA8IvE"}