@alexandrgreen/anchorclaw 0.0.3

package/dist/memory/read-file-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file-shared.d.ts","sourceRoot":"","sources":["../../src/memory/read-file-shared.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAsCF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,gBAAgB,CAiCnB"}

package/dist/memory/read-file-shared.js

@@ -0,0 +1,53 @@
+function buildContinuationNotice(params) {
+    const base = typeof params.nextFrom === "number"
+        ? `[More content available. Use from=${params.nextFrom} to continue.]`
+        : "[More content available. Requested excerpt exceeded the default maxChars budget.]";
+    return `\n\n${base}`;
+}
+function fitLinesToCharBudget(params) {
+    const { lines, maxChars } = params;
+    if (lines.length === 0) {
+        return { text: "", includedLines: 0, hardTruncatedSingleLine: false };
+    }
+    let includedLines = lines.length;
+    let text = lines.join("\n");
+    while (includedLines > 1 && text.length > maxChars) {
+        includedLines -= 1;
+        text = lines.slice(0, includedLines).join("\n");
+    }
+    if (text.length <= maxChars) {
+        return { text, includedLines, hardTruncatedSingleLine: false };
+    }
+    return {
+        text: text.slice(0, maxChars),
+        includedLines: 1,
+        hardTruncatedSingleLine: true,
+    };
+}
+export function buildMemoryReadResult(params) {
+    const fileLines = params.content.split("\n");
+    const start = Math.max(1, params.from ?? 1);
+    const requestedCount = Math.max(1, params.lines ?? params.defaultLines);
+    const selectedLines = fileLines.slice(start - 1, start - 1 + requestedCount);
+    const moreSourceLinesRemain = start - 1 + selectedLines.length < fileLines.length;
+    const fitted = fitLinesToCharBudget({
+        lines: selectedLines,
+        maxChars: Math.max(1, params.maxChars),
+    });
+    const charCapTruncated = fitted.hardTruncatedSingleLine || fitted.includedLines < selectedLines.length;
+    const nextFrom = !fitted.hardTruncatedSingleLine &&
+        (moreSourceLinesRemain || fitted.includedLines < selectedLines.length)
+        ? start + fitted.includedLines
+        : undefined;
+    const truncated = charCapTruncated || moreSourceLinesRemain;
+    const text = truncated && fitted.text ? `${fitted.text}${buildContinuationNotice({ nextFrom })}` : fitted.text;
+    return {
+        text,
+        path: params.relPath,
+        from: start,
+        lines: fitted.includedLines,
+        ...(truncated ? { truncated: true } : {}),
+        ...(typeof nextFrom === "number" ? { nextFrom } : {}),
+    };
+}
+//# sourceMappingURL=read-file-shared.js.map

package/dist/memory/read-file-shared.js.map

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

package/dist/memory/read-file-shared.test.d.ts

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

package/dist/memory/read-file-shared.test.d.ts.map

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

package/dist/memory/read-file-shared.test.js

@@ -0,0 +1,82 @@
+import { describe, expect, it } from "vitest";
+import { buildMemoryReadResult } from "./read-file-shared.js";
+describe("buildMemoryReadResult", () => {
+    it("returns exact slice when within line+char budgets", () => {
+        const res = buildMemoryReadResult({
+            content: ["a", "b", "c", "d"].join("\n"),
+            relPath: "db-memory/items/1.md",
+            from: 2,
+            lines: 2,
+            defaultLines: 120,
+            maxChars: 12_000,
+        });
+        // Even when the requested excerpt fits within budgets, we mark it as truncated
+        // when the source file has more lines remaining, and provide a continuation hint.
+        expect(res.text).toContain(["b", "c"].join("\n"));
+        expect(res.path).toBe("db-memory/items/1.md");
+        expect(res.from).toBe(2);
+        expect(res.lines).toBe(2);
+        expect(res.truncated).toBe(true);
+        expect(res.nextFrom).toBe(4);
+        expect(res.text).toContain("Use from=4 to continue");
+    });
+    it("normalizes from/lines to be >= 1", () => {
+        const res = buildMemoryReadResult({
+            content: ["a", "b", "c"].join("\n"),
+            relPath: "x",
+            from: 0,
+            lines: 0,
+            defaultLines: 2,
+            maxChars: 100,
+        });
+        expect(res.from).toBe(1);
+        expect(res.lines).toBe(1);
+        expect(res.truncated).toBe(true);
+        expect(res.nextFrom).toBe(2);
+        expect(res.text).toContain("a");
+        expect(res.text).toContain("Use from=2 to continue");
+    });
+    it("marks truncated and sets nextFrom when more lines remain", () => {
+        const res = buildMemoryReadResult({
+            content: ["a", "b", "c", "d"].join("\n"),
+            relPath: "x",
+            from: 1,
+            lines: 2,
+            defaultLines: 120,
+            maxChars: 100,
+        });
+        expect(res.truncated).toBe(true);
+        expect(res.nextFrom).toBe(3);
+        expect(res.text).toContain("a\nb");
+        expect(res.text).toContain("Use from=3 to continue");
+    });
+    it("trims lines to fit maxChars and reports nextFrom for continuation", () => {
+        const res = buildMemoryReadResult({
+            content: ["12345", "67890", "abcde"].join("\n"),
+            relPath: "x",
+            from: 1,
+            lines: 3,
+            defaultLines: 120,
+            maxChars: 11, // fits "12345\n67890" (11 chars), but not + "\nabcde"
+        });
+        expect(res.lines).toBe(2);
+        expect(res.truncated).toBe(true);
+        expect(res.nextFrom).toBe(3);
+        expect(res.text).toContain("12345\n67890");
+    });
+    it("hard-truncates a single long line and omits nextFrom", () => {
+        const res = buildMemoryReadResult({
+            content: "0123456789",
+            relPath: "x",
+            from: 1,
+            lines: 1,
+            defaultLines: 120,
+            maxChars: 5,
+        });
+        expect(res.lines).toBe(1);
+        expect(res.truncated).toBe(true);
+        expect(res.nextFrom).toBeUndefined();
+        expect(res.text).toBe("01234\n\n[More content available. Requested excerpt exceeded the default maxChars budget.]");
+    });
+});
+//# sourceMappingURL=read-file-shared.test.js.map

package/dist/memory/read-file-shared.test.js.map

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

package/dist/memory/recall.d.ts

@@ -0,0 +1,22 @@
+import type { PostgresPool } from "../postgres.js";
+import type { MemoryLimits } from "./limits.js";
+import { type MemorySearchHit } from "./search.js";
+export type MemoryRecallResult = {
+    ok: true;
+    corpus: "memory";
+    retrievalMode: "fts" | "importance_recent";
+    results: MemorySearchHit[];
+    count: number;
+} | {
+    ok: false;
+    disabled?: boolean;
+    error: string;
+};
+export declare function memoryRecallDb(params: {
+    pool: PostgresPool;
+    userId: string;
+    workspaceId: string;
+    limits: MemoryLimits;
+    input: unknown;
+}): Promise<MemoryRecallResult>;
+//# sourceMappingURL=recall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/memory/recall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAUnE,MAAM,MAAM,kBAAkB,GAC1B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,QAAQ,CAAC;IACjB,aAAa,EAAE,KAAK,GAAG,mBAAmB,CAAC;IAC3C,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkE9B"}

package/dist/memory/recall.js

@@ -0,0 +1,58 @@
+import { memorySearchDb } from "./search.js";
+function clampInteger(value, min, max) {
+    if (!Number.isFinite(value)) {
+        return min;
+    }
+    const rounded = Math.floor(value);
+    return Math.min(max, Math.max(min, rounded));
+}
+export async function memoryRecallDb(params) {
+    const raw = (params.input ?? {});
+    const query = typeof raw?.query === "string" ? raw.query : "";
+    const maxResults = typeof raw?.maxResults === "number" ? raw.maxResults : undefined;
+    const q = query.trim();
+    const limit = clampInteger(maxResults ?? params.limits.maxResults, 1, params.limits.maxResults);
+    // Recall is a shortcut: if a query is provided, behave like search; otherwise return the most important recent items.
+    if (q) {
+        const hits = await memorySearchDb({
+            pool: params.pool,
+            userId: params.userId,
+            workspaceId: params.workspaceId,
+            limits: params.limits,
+            query: q,
+            ...(typeof maxResults === "number" ? { maxResults } : {}),
+        });
+        return { ok: true, corpus: "memory", retrievalMode: "fts", results: hits, count: hits.length };
+    }
+    const result = await params.pool.query(`
+    SELECT
+      id,
+      title,
+      type,
+      content,
+      updated_at,
+      0::float AS score
+    FROM memory_items
+    WHERE user_id = $1
+      AND workspace_id = $2
+      AND status = 'active'
+    ORDER BY importance DESC, updated_at DESC, id ASC
+    LIMIT $3
+  `, [params.userId, params.workspaceId, limit]);
+    const rows = result.rows;
+    const results = rows.map((row) => {
+        const snippet = row.content.length > 240 ? `${row.content.slice(0, 240)}…` : row.content;
+        return {
+            corpus: "memory",
+            path: `db-memory/items/${row.id}.md`,
+            id: row.id,
+            title: row.title ?? undefined,
+            kind: row.type,
+            score: Number.isFinite(row.score) ? row.score : 0,
+            snippet,
+            updatedAt: row.updated_at,
+        };
+    });
+    return { ok: true, corpus: "memory", retrievalMode: "importance_recent", results, count: results.length };
+}
+//# sourceMappingURL=recall.js.map

package/dist/memory/recall.js.map

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

package/dist/memory/search.d.ts

@@ -0,0 +1,30 @@
+import type { PostgresPool } from "../postgres.js";
+import type { MemoryLimits } from "./limits.js";
+export type MemorySearchParams = {
+    query: string;
+    maxResults?: number;
+    corpus?: string;
+};
+export type MemorySearchHit = {
+    corpus: "memory" | "sessions";
+    path: string;
+    title?: string;
+    kind?: string;
+    score: number;
+    snippet: string;
+    id?: string;
+    startLine?: number;
+    endLine?: number;
+    citation?: string;
+    updatedAt?: string;
+    relaxedQuery?: string;
+};
+export declare function memorySearchDb(params: {
+    pool: PostgresPool;
+    userId: string;
+    workspaceId: string;
+    limits: MemoryLimits;
+    query: string;
+    maxResults?: number;
+}): Promise<MemorySearchHit[]>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/memory/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AA2FF,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAkD7B"}

package/dist/memory/search.js

@@ -0,0 +1,110 @@
+function clampInteger(value, min, max) {
+    if (!Number.isFinite(value)) {
+        return min;
+    }
+    const rounded = Math.floor(value);
+    return Math.min(max, Math.max(min, rounded));
+}
+function mapRowsToHits(rows, relaxedQuery) {
+    return rows.map((row) => {
+        const snippet = row.content.length > 240 ? `${row.content.slice(0, 240)}…` : row.content;
+        return {
+            corpus: "memory",
+            path: `db-memory/items/${row.id}.md`,
+            id: row.id,
+            title: row.title ?? undefined,
+            kind: row.type,
+            score: Number.isFinite(row.score) ? row.score : 0,
+            snippet,
+            updatedAt: row.updated_at,
+            ...(relaxedQuery ? { relaxedQuery } : {}),
+        };
+    });
+}
+function deriveRelaxedQueries(query) {
+    const tokens = Array.from(new Set((query.toLowerCase().match(/[a-z0-9_@.-]+/g) ?? []).filter((token) => token.length >= 3)));
+    if (tokens.length < 2) {
+        return [];
+    }
+    const candidates = [];
+    for (let index = 0; index < tokens.length - 1; index += 1) {
+        candidates.push(`${tokens[index]} ${tokens[index + 1]}`);
+    }
+    candidates.push(...tokens);
+    const normalizedOriginal = query.trim().toLowerCase();
+    return Array.from(new Set(candidates)).filter((candidate) => candidate !== normalizedOriginal).slice(0, 6);
+}
+async function queryMemoryItems(params) {
+    const { rows } = await params.pool.query(`
+    SELECT
+      id,
+      title,
+      type,
+      content,
+      updated_at,
+      (
+        ts_rank_cd(search_vector, plainto_tsquery('simple', $3))
+        + CASE
+            WHEN lower(coalesce(title, '')) = lower($3) THEN 3.0
+            WHEN lower(content) = lower($3) THEN 2.5
+            ELSE 0
+          END
+      ) AS score
+    FROM memory_items
+    WHERE user_id = $1
+      AND workspace_id = $2
+      AND status = 'active'
+      AND search_vector @@ plainto_tsquery('simple', $3)
+    ORDER BY score DESC, importance DESC, updated_at DESC, id ASC
+    LIMIT $4
+  `, [params.userId, params.workspaceId, params.query, params.limit]);
+    return mapRowsToHits(rows);
+}
+export async function memorySearchDb(params) {
+    const q = params.query.trim();
+    if (!q) {
+        return [];
+    }
+    const limit = clampInteger(params.maxResults ?? params.limits.maxResults, 1, params.limits.maxResults);
+    const strictHits = await queryMemoryItems({
+        pool: params.pool,
+        userId: params.userId,
+        workspaceId: params.workspaceId,
+        query: q,
+        limit,
+    });
+    if (strictHits.length > 0) {
+        return strictHits;
+    }
+    const relaxedQueries = deriveRelaxedQueries(q);
+    if (relaxedQueries.length === 0) {
+        return [];
+    }
+    const merged = new Map();
+    for (const relaxedQuery of relaxedQueries) {
+        const relaxedHits = await queryMemoryItems({
+            pool: params.pool,
+            userId: params.userId,
+            workspaceId: params.workspaceId,
+            query: relaxedQuery,
+            limit,
+        });
+        for (const hit of relaxedHits) {
+            const key = hit.id ?? hit.path;
+            const previous = merged.get(key);
+            const taggedHit = { ...hit, relaxedQuery };
+            if (!previous || taggedHit.score > previous.score) {
+                merged.set(key, taggedHit);
+            }
+        }
+    }
+    return Array.from(merged.values())
+        .sort((left, right) => {
+        if (right.score !== left.score) {
+            return right.score - left.score;
+        }
+        return left.path.localeCompare(right.path);
+    })
+        .slice(0, limit);
+}
+//# sourceMappingURL=search.js.map

package/dist/memory/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/memory/search.ts"],"names":[],"mappings":"AAiCA,SAAS,YAAY,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC3D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,aAAa,CAAC,IAAuB,EAAE,YAAqB;IACnE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;QACzF,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,mBAAmB,GAAG,CAAC,EAAE,KAAK;YACpC,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,SAAS;YAC7B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACjD,OAAO;YACP,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CACvB,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAClG,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAE3B,MAAM,kBAAkB,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,kBAAkB,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7G,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,MAM/B;IACC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CACtC;;;;;;;;;;;;;;;;;;;;;;GAsBD,EACC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAChE,CAAC;IAEF,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAOpC;IACC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEvG,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC;QACxC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,CAAC;QACR,KAAK;KACN,CAAC,CAAC;IACH,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,cAAc,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,KAAK,MAAM,YAAY,IAAI,cAAc,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC;YACzC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,YAAY;YACnB,KAAK;SACN,CAAC,CAAC;QACH,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC;YAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjC,MAAM,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,YAAY,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAClD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;SAC/B,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACrB,CAAC"}

package/dist/memory/search.test.d.ts

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

package/dist/memory/search.test.d.ts.map

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

package/dist/memory/search.test.js

@@ -0,0 +1,103 @@
+import { describe, expect, it } from "vitest";
+import { memorySearchDb } from "./search.js";
+describe("memorySearchDb ranking contract", () => {
+    it("uses exact-only boost and does not use broad LIKE boost", async () => {
+        let capturedSql = "";
+        let capturedParams = [];
+        const pool = {
+            query: async (sql, params) => {
+                capturedSql = sql;
+                capturedParams = params;
+                return { rows: [] };
+            },
+        };
+        await memorySearchDb({
+            pool,
+            userId: "u1",
+            workspaceId: "w1",
+            limits: { maxResults: 10 },
+            query: "ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515",
+            maxResults: 5,
+        });
+        expect(capturedSql).toContain("WHEN lower(coalesce(title, '')) = lower($3) THEN 3.0");
+        expect(capturedSql).toContain("WHEN lower(content) = lower($3) THEN 2.5");
+        expect(capturedSql).not.toContain("LIKE ('%' || lower($3) || '%')");
+        expect(capturedSql).toContain("ORDER BY score DESC, importance DESC, updated_at DESC, id ASC");
+        expect(capturedParams).toEqual(["u1", "w1", "ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515", 5]);
+    });
+    it("keeps lexical FTS ranking path for broad queries", async () => {
+        let capturedSql = "";
+        const pool = {
+            query: async (sql) => {
+                capturedSql = sql;
+                return { rows: [] };
+            },
+        };
+        await memorySearchDb({
+            pool,
+            userId: "u1",
+            workspaceId: "w1",
+            limits: { maxResults: 10 },
+            query: "alpha",
+            maxResults: 10,
+        });
+        expect(capturedSql).toContain("plainto_tsquery('simple', $3)");
+        expect(capturedSql).toContain("ts_rank_cd(search_vector, plainto_tsquery('simple', $3))");
+        expect(capturedSql).not.toContain("LIKE ('%' || lower($3) || '%')");
+    });
+    it("falls back to relaxed phrase/token queries when strict multi-term FTS returns no hits", async () => {
+        const queried = [];
+        const pool = {
+            query: async (_sql, params) => {
+                const query = String(params[2]);
+                queried.push(query);
+                if (query === "active memory") {
+                    return {
+                        rows: [
+                            {
+                                id: "marker",
+                                title: "ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515",
+                                type: "note",
+                                content: "ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515",
+                                updated_at: "2026-05-15T17:28:07.403Z",
+                                score: 1.54,
+                            },
+                        ],
+                    };
+                }
+                if (query === "smoke") {
+                    return {
+                        rows: [
+                            {
+                                id: "smoke",
+                                title: "anchorclaw post-restart smoke",
+                                type: "note",
+                                content: "anchorclaw post-restart smoke",
+                                updated_at: "2026-05-12T00:00:38.583Z",
+                                score: 1.4,
+                            },
+                        ],
+                    };
+                }
+                return { rows: [] };
+            },
+        };
+        const hits = await memorySearchDb({
+            pool,
+            userId: "u1",
+            workspaceId: "w1",
+            limits: { maxResults: 10 },
+            query: "active memory smoke",
+            maxResults: 5,
+        });
+        expect(queried).toContain("active memory smoke");
+        expect(queried).toContain("active memory");
+        expect(queried).toContain("smoke");
+        expect(hits.map((hit) => hit.title)).toEqual([
+            "ANCHORCLAW_ACTIVE_MEMORY_MARKER_20260515",
+            "anchorclaw post-restart smoke",
+        ]);
+        expect(hits[0]?.relaxedQuery).toBe("active memory");
+    });
+});
+//# sourceMappingURL=search.test.js.map

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

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

package/dist/memory/sessions-index-sync.d.ts

@@ -0,0 +1,28 @@
+import type { PostgresPool } from "../postgres.js";
+export declare function syncSessionsIndexDb(params: {
+    pool: PostgresPool;
+    userId: string;
+    workspaceId: string;
+    agentId: string;
+    force?: boolean;
+    sessionFiles?: string[];
+}): Promise<{
+    indexedFiles: number;
+    updatedFiles: number;
+    skippedFiles: number;
+    removedFiles: number;
+}>;
+export declare function syncVisibleSessionsIndexDb(params: {
+    pool: PostgresPool;
+    userId: string;
+    workspaceId: string;
+    agentId: string;
+    otherAgentIds?: string[];
+    force?: boolean;
+}): Promise<{
+    indexedFiles: number;
+    updatedFiles: number;
+    skippedFiles: number;
+    removedFiles: number;
+}>;
+//# sourceMappingURL=sessions-index-sync.d.ts.map

package/dist/memory/sessions-index-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-index-sync.d.ts","sourceRoot":"","sources":["../../src/memory/sessions-index-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA4EnD,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,OAAO,CAAC;IACV,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAsLD;AAED,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC;IACV,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CA+BD"}