obsidian-anchor 0.2.0

package/dist/tools/cite.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+const CITATION_SHAPE = {
+    citation: z.string(),
+    path: z.string(),
+    anchor: z.string(),
+    quote: z.string(),
+    score: z.number(),
+};
+export function registerCite(server, ctx) {
+    server.registerTool("cite", {
+        title: "Cite",
+        description: "Attach forced citations to a statement about the vault. Returns the supporting note " +
+            "passages when the notes back the statement, or an honest 'no supporting notes found' " +
+            "otherwise. Use this to ground any claim you make about the user's notes; if it is not " +
+            "cited, do not state it as fact.",
+        inputSchema: { claim: z.string().min(1).max(8000) },
+        outputSchema: {
+            cited: z.boolean(),
+            statement: z.string(),
+            citations: z.array(z.object(CITATION_SHAPE)),
+            note: z.string(),
+        },
+    }, async ({ claim }) => {
+        if (ctx.indexing)
+            await ctx.indexing;
+        const result = await ctx.grounding.verify(claim);
+        const citations = result.perClaim
+            .filter((perClaim) => perClaim.verdict === "supported")
+            .flatMap((perClaim) => perClaim.evidence)
+            .map((evidence) => ({
+            citation: `${evidence.path}${evidence.anchor}`,
+            path: evidence.path,
+            anchor: evidence.anchor,
+            quote: evidence.quote,
+            score: evidence.score,
+        }));
+        const contradicted = result.perClaim.some((perClaim) => perClaim.verdict === "contradicted");
+        const cited = citations.length > 0 && result.verdict !== "refused";
+        const note = cited
+            ? `Supported by ${citations.length} note passage(s).`
+            : contradicted
+                ? "Your notes contradict this — do not state it as fact."
+                : "No supporting notes found — do not state this as fact.";
+        const payload = { cited, statement: claim, citations, note };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+            structuredContent: payload,
+        };
+    });
+}
+//# sourceMappingURL=cite.js.map

package/dist/tools/cite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cite.js","sourceRoot":"","sources":["../../src/tools/cite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,cAAc,GAAG;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAAiB,EAAE,GAAe;IAC7D,MAAM,CAAC,YAAY,CACjB,MAAM,EACN;QACE,KAAK,EAAE,MAAM;QACb,WAAW,EACT,sFAAsF;YACtF,uFAAuF;YACvF,wFAAwF;YACxF,iCAAiC;QACnC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACnD,YAAY,EAAE;YACZ,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;YAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;YAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;SACjB;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,IAAI,GAAG,CAAC,QAAQ;YAAE,MAAM,GAAG,CAAC,QAAQ,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ;aAC9B,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,KAAK,WAAW,CAAC;aACtD,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;aACxC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAClB,QAAQ,EAAE,GAAG,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE;YAC9C,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC,CAAC,CAAC;QACN,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,KAAK,cAAc,CAAC,CAAC;QAC7F,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC;QACnE,MAAM,IAAI,GAAG,KAAK;YAChB,CAAC,CAAC,gBAAgB,SAAS,CAAC,MAAM,mBAAmB;YACrD,CAAC,CAAC,YAAY;gBACZ,CAAC,CAAC,uDAAuD;gBACzD,CAAC,CAAC,wDAAwD,CAAC;QAE/D,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC7D,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACnE,iBAAiB,EAAE,OAAO;SAC3B,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/restoreNote.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+export function registerRestoreNote(server, ctx) {
+    server.registerTool("restore_note", {
+        title: "Restore note",
+        description: "Roll a note back to a rollback snapshot saved by safe_edit (pass the snapshot path from " +
+            "a previous safe_edit result). The current content is snapshotted first, so the restore is " +
+            "itself undoable, and the note is re-indexed.",
+        inputSchema: {
+            path: z.string().min(1).max(1024),
+            snapshot: z.string().min(1).max(1024),
+        },
+        outputSchema: {
+            path: z.string(),
+            restoredFrom: z.string(),
+            preRestoreSnapshot: z.string().nullable(),
+            reindexedChunks: z.number().nullable(),
+            message: z.string(),
+        },
+    }, async ({ path, snapshot }) => {
+        if (ctx.indexing)
+            await ctx.indexing;
+        try {
+            const result = await ctx.safeEdit.restore(path, snapshot);
+            const payload = {
+                ...result,
+                message: `Restored ${result.path} from ${result.restoredFrom}.`,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+                structuredContent: payload,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `restore_note error: ${message}` }],
+                structuredContent: {
+                    path,
+                    restoredFrom: snapshot,
+                    preRestoreSnapshot: null,
+                    reindexedChunks: null,
+                    message: `Error: ${message}`,
+                },
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=restoreNote.js.map

package/dist/tools/restoreNote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreNote.js","sourceRoot":"","sources":["../../src/tools/restoreNote.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,GAAe;IACpE,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,0FAA0F;YAC1F,4FAA4F;YAC5F,8CAA8C;QAChD,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;YACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;SACtC;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;YACxB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACzC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;SACpB;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC3B,IAAI,GAAG,CAAC,QAAQ;YAAE,MAAM,GAAG,CAAC,QAAQ,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG;gBACd,GAAG,MAAM;gBACT,OAAO,EAAE,YAAY,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,YAAY,GAAG;aAChE,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACnE,iBAAiB,EAAE,OAAO;aAC3B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,OAAO,EAAE,EAAE,CAAC;gBACnE,iBAAiB,EAAE;oBACjB,IAAI;oBACJ,YAAY,EAAE,QAAQ;oBACtB,kBAAkB,EAAE,IAAI;oBACxB,eAAe,EAAE,IAAI;oBACrB,OAAO,EAAE,UAAU,OAAO,EAAE;iBAC7B;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/safeEdit.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+export function registerSafeEdit(server, ctx) {
+    server.registerTool("safe_edit", {
+        title: "Safe edit",
+        description: "Edit a note by replacing an exact snippet. Called WITHOUT `confirm`, it returns a dry-run " +
+            "diff and a confirmation token without touching the file. Call it again with the same arguments " +
+            "plus `confirm` set to that token to apply the change — a rollback snapshot is saved and the note " +
+            "is re-indexed. The token also rejects the edit if the note changed since the preview.",
+        inputSchema: {
+            path: z.string().min(1).max(1024),
+            oldText: z.string().min(1).max(50_000),
+            newText: z.string().max(50_000),
+            confirm: z.string().optional(),
+        },
+        outputSchema: {
+            mode: z.enum(["dry-run", "applied"]),
+            path: z.string(),
+            message: z.string(),
+            diff: z.string().optional(),
+            token: z.string().optional(),
+            snapshot: z.string().optional(),
+            reindexedChunks: z.number().nullable().optional(),
+        },
+    }, async ({ path, oldText, newText, confirm }) => {
+        if (ctx.indexing)
+            await ctx.indexing;
+        try {
+            const result = await ctx.safeEdit.edit(path, oldText, newText, confirm);
+            if (result.mode === "dry-run") {
+                const payload = {
+                    mode: "dry-run",
+                    path: result.path,
+                    diff: result.diff,
+                    token: result.token,
+                    message: "Dry run — review the diff. To apply, call safe_edit again with the same arguments plus " +
+                        `confirm: "${result.token}".`,
+                };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+                    structuredContent: payload,
+                };
+            }
+            const payload = {
+                mode: "applied",
+                path: result.path,
+                snapshot: result.snapshot,
+                reindexedChunks: result.reindexedChunks,
+                message: `Applied. Rollback snapshot saved at ${result.snapshot}.`,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+                structuredContent: payload,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `safe_edit error: ${message}` }],
+                structuredContent: { mode: "dry-run", path, message: `Error: ${message}` },
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=safeEdit.js.map

package/dist/tools/safeEdit.js.map

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

package/dist/tools/searchNotes.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+const RESULT_SHAPE = {
+    /** Ready-to-use Obsidian citation, e.g. "Projects/Auth.md#^k93a". */
+    citation: z.string(),
+    path: z.string(),
+    anchor: z.string(),
+    heading: z.string().nullable(),
+    blockId: z.string().nullable(),
+    /** Relevance score in 0..1 (cosine similarity). */
+    score: z.number(),
+    /** Verbatim chunk text (the citable evidence span). */
+    quote: z.string(),
+};
+export function registerSearchNotes(server, ctx) {
+    server.registerTool("search_notes", {
+        title: "Search notes",
+        description: "Semantic search over the Obsidian vault. Returns matching chunks, each with a precise " +
+            "Obsidian citation (note path + heading/block anchor) and a relevance score. Use this to " +
+            "find evidence, then verify_grounding before asserting anything as fact.",
+        inputSchema: {
+            query: z.string().min(1).max(1000),
+            limit: z.number().int().min(1).max(50).optional(),
+        },
+        outputSchema: { results: z.array(z.object(RESULT_SHAPE)) },
+    }, async ({ query, limit }) => {
+        if (ctx.indexing)
+            await ctx.indexing;
+        const hits = await ctx.search.search(query, limit ?? ctx.config.knn);
+        const payload = { results: hits.map(toResult) };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+            structuredContent: payload,
+        };
+    });
+}
+function toResult(chunk) {
+    return {
+        citation: `${chunk.notePath}${chunk.anchor}`,
+        path: chunk.notePath,
+        anchor: chunk.anchor,
+        heading: chunk.headingPath,
+        blockId: chunk.blockId,
+        score: Math.round(chunk.score * 1000) / 1000,
+        quote: chunk.text.replace(/\r/g, ""),
+    };
+}
+//# sourceMappingURL=searchNotes.js.map

package/dist/tools/searchNotes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchNotes.js","sourceRoot":"","sources":["../../src/tools/searchNotes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,YAAY,GAAG;IACnB,qEAAqE;IACrE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,mDAAmD;IACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,uDAAuD;IACvD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,GAAe;IACpE,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,wFAAwF;YACxF,0FAA0F;YAC1F,yEAAyE;QAC3E,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;YAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SAClD;QACD,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE;KAC3D,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,IAAI,GAAG,CAAC,QAAQ;YAAE,MAAM,GAAG,CAAC,QAAQ,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACnE,iBAAiB,EAAE,OAAO;SAC3B,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAkB;IAClC,OAAO;QACL,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE;QAC5C,IAAI,EAAE,KAAK,CAAC,QAAQ;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,WAAW;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI;QAC5C,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/tools/verifyGrounding.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+const EVIDENCE_SHAPE = {
+    path: z.string(),
+    anchor: z.string(),
+    blockId: z.string().nullable(),
+    heading: z.string().nullable(),
+    quote: z.string(),
+    score: z.number(),
+};
+const PER_CLAIM_SHAPE = {
+    claim: z.string(),
+    verdict: z.enum(["supported", "contradicted", "neutral"]),
+    score: z.number(),
+    evidence: z.array(z.object(EVIDENCE_SHAPE)),
+};
+export function registerVerifyGrounding(server, ctx) {
+    server.registerTool("verify_grounding", {
+        title: "Verify grounding",
+        description: "Check whether a claim (or short answer) is actually supported by the user's notes. " +
+            "Returns a grounding score 0-1 and a per-claim verdict (supported / contradicted / " +
+            "neutral) with Obsidian-cited evidence, and lists claims the notes do not support. " +
+            "Call this BEFORE asserting anything about the vault as fact; treat a refusal as " +
+            "'this is not in the notes'. Optionally pass `sources` (note passages, e.g. from " +
+            "search_notes) to verify against directly instead of retrieving.",
+        inputSchema: {
+            claim: z.string().min(1).max(8000),
+            sources: z
+                .array(z.object({ path: z.string(), anchor: z.string(), text: z.string().max(50_000) }))
+                .max(50)
+                .optional(),
+        },
+        outputSchema: {
+            grounded: z.boolean(),
+            score: z.number(),
+            verdict: z.enum(["grounded", "flagged", "refused"]),
+            summary: z.string(),
+            perClaim: z.array(z.object(PER_CLAIM_SHAPE)),
+            refusedClaims: z.array(z.string()),
+        },
+    }, async ({ claim, sources }) => {
+        if (ctx.indexing)
+            await ctx.indexing;
+        const provided = sources?.map((source, index) => toScoredChunk(source, index));
+        const result = await ctx.grounding.verify(claim, provided);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            structuredContent: { ...result },
+        };
+    });
+}
+function toScoredChunk(source, index) {
+    return {
+        chunkId: -1 - index,
+        notePath: source.path,
+        headingPath: null,
+        blockId: null,
+        anchor: source.anchor,
+        ordinal: index,
+        charStart: 0,
+        charEnd: source.text.length,
+        text: source.text,
+        distance: 0,
+        score: 1,
+    };
+}
+//# sourceMappingURL=verifyGrounding.js.map

package/dist/tools/verifyGrounding.js.map

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

package/dist/util/hash.js

@@ -0,0 +1,6 @@
+import { createHash } from "node:crypto";
+/** Stable content hash used to skip re-indexing unchanged notes. */
+export function sha256(text) {
+    return createHash("sha256").update(text).digest("hex");
+}
+//# sourceMappingURL=hash.js.map

package/dist/util/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/util/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,oEAAoE;AACpE,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/util/logger.js

@@ -0,0 +1,41 @@
+// Structured stderr logger.
+//
+// stdout is reserved exclusively for the MCP stdio transport (JSON-RPC). Any
+// stray write to stdout corrupts the protocol stream, so every diagnostic
+// message Anchor emits MUST go to stderr. This module is the only sanctioned
+// way to log; `console.*` is banned in src/ via ESLint.
+const LEVEL_ORDER = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+function resolveThreshold() {
+    const raw = (process.env.ANCHOR_LOG_LEVEL ?? "info").toLowerCase();
+    return LEVEL_ORDER[raw] ?? LEVEL_ORDER.info;
+}
+const threshold = resolveThreshold();
+function safeJson(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function write(level, message, fields) {
+    if (LEVEL_ORDER[level] < threshold)
+        return;
+    let line = `[anchor] ${level.toUpperCase()} ${message}`;
+    if (fields && Object.keys(fields).length > 0) {
+        line += ` ${safeJson(fields)}`;
+    }
+    process.stderr.write(`${line}\n`);
+}
+export const logger = {
+    debug: (message, fields) => write("debug", message, fields),
+    info: (message, fields) => write("info", message, fields),
+    warn: (message, fields) => write("warn", message, fields),
+    error: (message, fields) => write("error", message, fields),
+};
+//# sourceMappingURL=logger.js.map

package/dist/util/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,wDAAwD;AAIxD,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,SAAS,gBAAgB;IACvB,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IACnE,OAAO,WAAW,CAAC,GAAe,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;AAErC,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,KAAe,EAAE,OAAe,EAAE,MAAe;IAC9D,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,SAAS;QAAE,OAAO;IAC3C,IAAI,IAAI,GAAG,YAAY,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC;IACxD,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,IAAI,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,OAAe,EAAE,MAAe,EAAQ,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;IAClF,IAAI,EAAE,CAAC,OAAe,EAAE,MAAe,EAAQ,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;IAChF,IAAI,EAAE,CAAC,OAAe,EAAE,MAAe,EAAQ,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;IAChF,KAAK,EAAE,CAAC,OAAe,EAAE,MAAe,EAAQ,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;CACnF,CAAC"}

package/dist/util/timeout.js

@@ -0,0 +1,19 @@
+/**
+ * Rejects if `promise` does not settle within `ms`. The underlying work is not
+ * cancelled (JS has no general cancellation), but the caller is unblocked.
+ */
+export function withTimeout(promise, ms, label) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`${label} timed out after ${String(ms)}ms`));
+        }, ms);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timer);
+            reject(error instanceof Error ? error : new Error(String(error)));
+        });
+    });
+}
+//# sourceMappingURL=timeout.js.map

package/dist/util/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/util/timeout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAI,OAAmB,EAAE,EAAU,EAAE,KAAa;IAC3E,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAChE,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,OAAO,CAAC,IAAI,CACV,CAAC,KAAK,EAAE,EAAE;YACR,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpE,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/verify/anthropic.js

@@ -0,0 +1,126 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { logger } from "../util/logger.js";
+// Haiku is a deliberate choice (locked in the plan): the verifier runs a narrow,
+// high-volume, closed entailment classification where Haiku's speed/cost win —
+// not an arbitrary downgrade of the default model.
+const MODEL = "claude-haiku-4-5";
+const MAX_TOKENS = 1024;
+const SYSTEM_PROMPT = [
+    "You are a strict grounding verifier.",
+    "Given a CLAIM and a list of numbered PASSAGES from the user's notes, decide for EACH passage whether it",
+    "SUPPORTS (entails) the claim, CONTRADICTS (refutes) it, or is NEUTRAL (unrelated or insufficient to decide).",
+    "Judge ONLY from the passage text — never use outside knowledge.",
+    "Return one judgement per passage with a confidence in [0,1].",
+].join(" ");
+// Raw JSON Schema (avoids coupling to any zod-helper version).
+const OUTPUT_FORMAT = {
+    type: "json_schema",
+    schema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+            judgements: {
+                type: "array",
+                items: {
+                    type: "object",
+                    additionalProperties: false,
+                    properties: {
+                        passageIndex: { type: "integer" },
+                        label: { type: "string", enum: ["supported", "contradicted", "neutral"] },
+                        confidence: { type: "number" },
+                    },
+                    required: ["passageIndex", "label", "confidence"],
+                },
+            },
+        },
+        required: ["judgements"],
+    },
+};
+/**
+ * Anthropic-backed grounding verifier (Claude Haiku). Auto-selected when an API
+ * key is present; the local NLI verifier is the no-key default. Same closed
+ * entailment task, higher accuracy.
+ */
+export class AnthropicVerifier {
+    id = "anthropic-haiku";
+    client;
+    constructor(client) {
+        this.client = client ?? new Anthropic();
+    }
+    async entail(input) {
+        if (input.passages.length === 0)
+            return [];
+        const passageBlock = input.passages.map((p) => `[${String(p.index)}] ${p.text}`).join("\n\n");
+        const userText = `CLAIM: ${input.claim}\n\nPASSAGES:\n${passageBlock}`;
+        let judgements;
+        try {
+            const response = await this.client.messages.create({
+                model: MODEL,
+                max_tokens: MAX_TOKENS,
+                temperature: 0,
+                system: SYSTEM_PROMPT,
+                messages: [{ role: "user", content: userText }],
+                output_config: { format: OUTPUT_FORMAT },
+            });
+            judgements = parseJudgements(response.content);
+        }
+        catch (error) {
+            // Conservative on failure: unverified => not grounded (neutral). The SDK
+            // already retries transient 429/5xx, so this is for persistent failures.
+            logger.warn("Anthropic verifier call failed; treating passages as neutral", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return input.passages.map((p) => neutral(p.index));
+        }
+        const byIndex = new Map();
+        for (const judgement of judgements) {
+            byIndex.set(judgement.passageIndex, {
+                label: judgement.label,
+                confidence: clamp01(judgement.confidence),
+            });
+        }
+        return input.passages.map((passage) => {
+            const judgement = byIndex.get(passage.index);
+            return judgement === undefined
+                ? neutral(passage.index)
+                : { passageIndex: passage.index, label: judgement.label, confidence: judgement.confidence };
+        });
+    }
+}
+const LABELS = new Set(["supported", "contradicted", "neutral"]);
+/** Extracts and validates the judgements array from the model's JSON response. */
+function parseJudgements(content) {
+    const text = content.find((block) => block.type === "text" && typeof block.text === "string")?.text;
+    if (text === undefined)
+        return [];
+    const parsed = JSON.parse(text);
+    if (typeof parsed !== "object" || parsed === null)
+        return [];
+    const rawList = parsed.judgements;
+    if (!Array.isArray(rawList))
+        return [];
+    const out = [];
+    for (const item of rawList) {
+        if (typeof item !== "object" || item === null)
+            continue;
+        const record = item;
+        const passageIndex = record.passageIndex;
+        const label = record.label;
+        const confidence = record.confidence;
+        if (typeof passageIndex === "number" && typeof label === "string" && LABELS.has(label)) {
+            out.push({
+                passageIndex,
+                label: label,
+                confidence: typeof confidence === "number" ? confidence : 0,
+            });
+        }
+    }
+    return out;
+}
+function neutral(passageIndex) {
+    return { passageIndex, label: "neutral", confidence: 0 };
+}
+function clamp01(value) {
+    return Math.max(0, Math.min(1, value));
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/verify/anthropic.js.map

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

package/dist/verify/decompose.js

@@ -0,0 +1,100 @@
+/**
+ * Splits a free-text answer into atomic, individually-verifiable claims.
+ *
+ * Deliberately conservative: it prefers a few well-formed claims over many
+ * fragments (over-splitting hurts grounding accuracy). No model is used — the
+ * built-in sentence segmenter plus light heuristics.
+ */
+export function decompose(text) {
+    const trimmed = text.trim();
+    if (trimmed === "")
+        return [];
+    const claims = [];
+    for (const sentence of segmentSentences(trimmed)) {
+        for (const clause of splitConjunctions(sentence.trim())) {
+            const cleaned = clause.trim();
+            if (isVerifiable(cleaned)) {
+                claims.push({ id: claims.length, text: cleaned });
+            }
+        }
+    }
+    // Fallback: a terse, punctuation-free line is still a claim worth checking.
+    if (claims.length === 0)
+        claims.push({ id: 0, text: trimmed });
+    return claims;
+}
+function segmentSentences(text) {
+    const ctor = Intl.Segmenter;
+    if (ctor) {
+        return Array.from(new ctor("en", { granularity: "sentence" }).segment(text), (s) => s.segment);
+    }
+    // Fallback for runtimes without Intl.Segmenter.
+    return text.split(/(?<=[.!?])\s+/);
+}
+function isVerifiable(sentence) {
+    if (sentence.length < 3)
+        return false;
+    if (sentence.endsWith("?"))
+        return false; // questions assert nothing
+    return sentence.split(/\s+/).filter(Boolean).length >= 2;
+}
+// Common verbs/copulas — enough to tell a clause from a fragment in note prose.
+const VERBS = new Set([
+    "is", "are", "was", "were", "be", "been", "being", "do", "does", "did",
+    "use", "uses", "used", "using", "have", "has", "had",
+    "run", "runs", "ran", "running", "deploy", "deploys", "deployed",
+    "cost", "costs", "lead", "leads", "led", "support", "supports", "supported",
+    "require", "requires", "required", "include", "includes", "included",
+    "offer", "offers", "offered", "generate", "generates", "generated",
+    "schedule", "schedules", "scheduled", "send", "sends", "sent",
+    "work", "works", "worked", "choose", "chooses", "chose", "chosen",
+    "add", "adds", "added", "hash", "hashes", "hashed", "store", "stores", "stored",
+    "expire", "expires", "expired", "encrypt", "encrypts", "encrypted",
+    "slip", "slips", "slipped", "ship", "ships", "shipped", "build", "builds", "built",
+    "handle", "handles", "handled", "process", "processes", "processed",
+    "collect", "collects", "collected", "limit", "limits", "limited",
+    "make", "makes", "made", "provide", "provides", "provided", "lives", "live",
+]);
+function hasVerb(clause) {
+    return (clause.match(/[A-Za-z'-]+/g) ?? []).some((word) => VERBS.has(word.toLowerCase()));
+}
+/** The leading "subject + verb" of a clause, e.g. "We use ..." → "We use". */
+function subjectVerbPrefix(clause) {
+    const words = clause.split(/\s+/);
+    for (let i = 0; i < words.length; i += 1) {
+        const bare = (words[i] ?? "").replace(/[^A-Za-z'-]/g, "").toLowerCase();
+        if (VERBS.has(bare))
+            return words.slice(0, i + 1).join(" ");
+    }
+    return null;
+}
+/**
+ * Splits a coordinated sentence ("We use Redis for caching and Stripe for
+ * payments") into independently-verifiable clauses, distributing the leading
+ * subject+verb to any verbless fragment. Conservative: if a clean clause can't
+ * be formed it keeps the sentence whole. Splitting can only make grounding
+ * harder (every clause must ground on its own), never invent a false grounding.
+ */
+function splitConjunctions(sentence) {
+    const parts = sentence
+        .split(/\s*,?\s+and\s+/i)
+        .map((part) => part.trim())
+        .filter(Boolean);
+    if (parts.length < 2)
+        return [sentence];
+    const prefix = subjectVerbPrefix(parts[0] ?? "");
+    const clauses = [];
+    for (let i = 0; i < parts.length; i += 1) {
+        let clause = parts[i] ?? "";
+        if (i > 0 && !hasVerb(clause)) {
+            if (prefix === null)
+                return [sentence]; // can't repair the fragment → don't split
+            clause = `${prefix} ${clause}`;
+        }
+        if (!hasVerb(clause))
+            return [sentence]; // still not a clause → abort the split
+        clauses.push(clause);
+    }
+    return clauses;
+}
+//# sourceMappingURL=decompose.js.map

package/dist/verify/decompose.js.map

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