@monoes/monomindcli 2.13.0 → 2.14.1

package/dist/src/mcp-tools/capture-resource-read.js

@@ -0,0 +1,296 @@
+/**
+ * GLU-07 — reading a capture as an MCP resource.
+ *
+ * A read has one job beyond handing over the text: make the text QUOTABLE.
+ * A model that receives 8kB of markdown with no idea where it came from will
+ * paraphrase it as its own; the same markdown with the url, the title, the
+ * capture time and the version in front of it gets cited. So every read is
+ * two parts —
+ *
+ *   contents[0]  text/markdown       provenance front matter, then the page
+ *   contents[1]  application/json    the same provenance, structured, plus
+ *                                    chunk spans and citation anchors
+ *
+ * — and `textStartsAt` says where the front matter ends, so the character
+ * offsets in the chunk list still line up with the document itself.
+ *
+ * `?chunk=` / `?anchor=` read ONE PASSAGE instead, straight through
+ * `resolveCitation` (RCL-10): same offsets, same anchor, same W3C text
+ * fragment link, and the same `stale: true` when the anchor was cut against a
+ * version this page no longer is. This module deliberately owns none of that
+ * logic — a second implementation of "which passage is this" is how a citation
+ * and its quote drift apart.
+ *
+ * @module v1/cli/mcp-tools/capture-resource-read
+ */
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { buildCaptureUri, CAPTURE_JSON_MIME_TYPE, CAPTURE_MIME_TYPE, captureLibraryIndex, captureStoreRoot, isCaptureUri, loadCaptureDocuments, parseCaptureUri, } from './capture-resources.js';
+/** A document longer than this is served truncated: an MCP client pastes the
+ *  whole resource into a context window, and a 5MB archive would blow it. */
+const MAX_TEXT_CHARS = 200_000;
+/** Chunk spans carried inline. Beyond this the list is cut and says so —
+ *  `?chunk=` still addresses every one of them. */
+const MAX_CHUNKS = 200;
+// ── Helpers ────────────────────────────────────────────────────────
+function fileEntry(absolutePath) {
+    const stat = fs.statSync(absolutePath);
+    return {
+        path: absolutePath,
+        absolutePath,
+        extension: path.extname(absolutePath).toLowerCase(),
+        size: stat.size,
+        modified: stat.mtime,
+        created: stat.birthtime,
+    };
+}
+const sha256 = (text) => crypto.createHash('sha256').update(text).digest('hex');
+/** YAML-safe scalar: quoted only when it would otherwise be ambiguous. */
+function scalar(value) {
+    return /^\s|\s$|[\n\r"']|:\s|^[-?[\]{}#&*!|>%@`]/.test(value) ? JSON.stringify(value) : value;
+}
+function frontMatter(fields) {
+    const lines = fields
+        .filter(([, v]) => v !== undefined && v !== '')
+        .map(([k, v]) => `${k}: ${typeof v === 'number' ? v : scalar(v)}`);
+    return `---\n${lines.join('\n')}\n---\n\n`;
+}
+async function readText(filePath) {
+    const { extractText } = await import('../capabilities/cap-documents.js');
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`source file is gone: ${filePath} (re-ingest the capture to read it)`);
+    }
+    const text = await extractText(fileEntry(filePath));
+    if (!text)
+        throw new Error(`no text could be extracted from ${filePath}`);
+    return text;
+}
+function provenanceOf(record) {
+    return record.provenance ?? {};
+}
+function urlOf(record) {
+    const prov = provenanceOf(record);
+    return record.canonicalUrl ?? prov.canonicalUrl ?? prov.url;
+}
+async function versionsOf(rootDir, identity, scope) {
+    const { listDocumentVersions } = await import('../knowledge/document-pipeline.js');
+    const seen = new Map();
+    for (const record of listDocumentVersions(rootDir, identity, scope)) {
+        if (!record.version)
+            continue;
+        seen.set(record.version, {
+            version: record.version,
+            uri: buildCaptureUri(scope, identity, { version: record.version }),
+            indexedAt: record.indexedAt,
+            contentHash: record.contentHash,
+            filePath: record.filePath,
+        });
+    }
+    return [...seen.values()].sort((a, b) => a.version - b.version);
+}
+// ── Reads ──────────────────────────────────────────────────────────
+/**
+ * Read a capture: the whole page, one stored version, or one passage.
+ *
+ * Throws with a message meant for a human — an unknown page, a file that has
+ * been deleted since it was indexed and a chunk that does not exist are all
+ * things a caller must see, not silently get an empty document for.
+ */
+export async function readCapture(uri, opts = {}) {
+    const parsed = parseCaptureUri(uri);
+    if (!parsed)
+        throw new Error(`not a capture uri: ${uri}`);
+    if (!parsed.identity) {
+        throw new Error(`${uri} is a library index, not a document — read it as JSON`);
+    }
+    if (parsed.version !== undefined && (parsed.chunkIndex !== undefined || parsed.anchor)) {
+        throw new Error('a passage read already names its version through the anchor: drop either v= or chunk=/anchor=');
+    }
+    const { scope, identity } = parsed;
+    const rootDir = await captureStoreRoot(scope, opts);
+    const { findDocumentRecord } = await import('../knowledge/document-pipeline.js');
+    if (parsed.chunkIndex !== undefined || parsed.anchor) {
+        return readPassage(uri, parsed.scope, identity, rootDir, {
+            ...(parsed.chunkIndex !== undefined ? { chunkIndex: parsed.chunkIndex } : {}),
+            ...(parsed.anchor ? { anchor: parsed.anchor } : {}),
+        });
+    }
+    let record = findDocumentRecord(rootDir, identity, scope);
+    const versions = await versionsOf(rootDir, identity, scope);
+    if (parsed.version !== undefined) {
+        const wanted = versions.find((v) => v.version === parsed.version);
+        if (!wanted) {
+            throw new Error(`version ${parsed.version} is not recorded for ${identity}` +
+                (versions.length ? ` (have ${versions.map((v) => v.version).join(', ')})` : ''));
+        }
+        const { listDocumentVersions } = await import('../knowledge/document-pipeline.js');
+        record = listDocumentVersions(rootDir, identity, scope).find((m) => m.version === parsed.version);
+    }
+    if (!record)
+        throw new Error(`not indexed: ${identity} (nothing at ${uri})`);
+    const text = await readText(record.filePath);
+    const contentHash = sha256(text);
+    const limit = Math.max(1, opts.maxChars ?? MAX_TEXT_CHARS);
+    const body = text.length > limit ? text.slice(0, limit) : text;
+    const { chunkSpans } = await import('../knowledge/document-pipeline.js');
+    const { citationAnchor } = await import('../knowledge/citation.js');
+    const spans = await chunkSpans(text);
+    const chunks = spans.slice(0, MAX_CHUNKS).map((span) => ({
+        chunkIndex: span.chunkIndex,
+        startChar: span.startChar,
+        endChar: span.endChar,
+        anchor: citationAnchor(contentHash, span.startChar, span.endChar),
+        uri: buildCaptureUri(scope, identity, { chunkIndex: span.chunkIndex }),
+    }));
+    const prov = provenanceOf(record);
+    const url = urlOf(record);
+    const { documentSite } = await import('../knowledge/library.js');
+    const stale = contentHash !== record.contentHash;
+    const matter = frontMatter([
+        ['uri', uri],
+        ['title', prov.title],
+        ['url', url],
+        ['byline', prov.byline],
+        ['capturedAt', prov.capturedAt],
+        ['publishedAt', prov.publishedAt],
+        ['version', record.version],
+        ['source', prov.source],
+        ['collection', prov.collection],
+        ['tags', prov.tags?.join(', ')],
+        ['contentHash', contentHash.slice(0, 12)],
+        ['scope', scope],
+        ['stale', stale ? 'true' : undefined],
+        ['truncated', text.length > limit ? 'true' : undefined],
+    ]);
+    const info = {
+        uri,
+        scope,
+        filePath: record.filePath,
+        ...(prov.title ? { title: prov.title } : {}),
+        ...(url ? { url } : {}),
+        ...(documentSite(record) ? { site: documentSite(record) } : {}),
+        ...(prov.capturedAt ? { capturedAt: prov.capturedAt } : {}),
+        indexedAt: record.indexedAt,
+        ...(prov.publishedAt ? { publishedAt: prov.publishedAt } : {}),
+        ...(prov.byline ? { byline: prov.byline } : {}),
+        ...(prov.httpStatus !== undefined ? { httpStatus: prov.httpStatus } : {}),
+        ...(prov.note ? { note: prov.note } : {}),
+        ...(prov.source ? { source: prov.source } : {}),
+        ...(prov.collection ? { collection: prov.collection } : {}),
+        tags: prov.tags ?? [],
+        ...(record.version ? { version: record.version } : {}),
+        ...(versions.length > 1 ? { versions } : {}),
+        contentHash,
+        indexedContentHash: record.contentHash,
+        ...(stale ? { stale: true } : {}),
+        chunkCount: record.chunkCount,
+        size: record.size,
+        textChars: text.length,
+        ...(text.length > limit ? { truncated: true } : {}),
+        textStartsAt: matter.length,
+        chunks,
+        ...(spans.length > chunks.length ? { chunksTruncated: true } : {}),
+    };
+    return { uri, markdown: `${matter}${body}`, info };
+}
+/** One passage, through `resolveCitation` so the quote, the anchor, the link
+ *  and the staleness verdict are the same ones `monomind doc cite` gives. */
+async function readPassage(uri, scope, identity, rootDir, where) {
+    const { resolveCitation } = await import('../knowledge/citation.js');
+    const citation = await resolveCitation(identity, { rootDir, scope, ...where });
+    const matter = frontMatter([
+        ['uri', uri],
+        ['title', citation.title],
+        ['url', citation.url],
+        ['capturedAt', citation.capturedAt],
+        ['version', citation.version],
+        ['source', citation.source],
+        ['chunk', citation.chunkIndex],
+        ['anchor', citation.anchor],
+        ['citeUrl', citation.citeUrl],
+        ['scope', citation.scope],
+        ['stale', citation.stale ? 'true' : undefined],
+    ]);
+    const markdown = `${matter}> ${citation.quote}\n\n${citation.passage}`;
+    const prov = citation.provenance ?? {};
+    return {
+        uri,
+        markdown,
+        info: {
+            uri,
+            scope: citation.scope,
+            filePath: citation.filePath,
+            ...(citation.title ? { title: citation.title } : {}),
+            ...(citation.url ? { url: citation.url } : {}),
+            ...(citation.capturedAt ? { capturedAt: citation.capturedAt } : {}),
+            indexedAt: '',
+            ...(prov.byline ? { byline: prov.byline } : {}),
+            ...(citation.source ? { source: citation.source } : {}),
+            ...(prov.collection ? { collection: prov.collection } : {}),
+            tags: prov.tags ?? [],
+            ...(citation.version ? { version: citation.version } : {}),
+            contentHash: citation.contentHash,
+            indexedContentHash: citation.contentHash,
+            ...(citation.stale ? { stale: true } : {}),
+            chunkCount: 0,
+            size: citation.passage.length,
+            textChars: citation.passage.length,
+            textStartsAt: matter.length,
+            chunks: [],
+            chunkIndex: citation.chunkIndex,
+            startChar: citation.startChar,
+            endChar: citation.endChar,
+            anchor: citation.anchor,
+            passage: citation.passage,
+            quote: citation.quote,
+            ...(citation.citeUrl ? { citeUrl: citation.citeUrl } : {}),
+        },
+    };
+}
+/**
+ * MCP `resources/read` contents for any `capture://` uri: the scope's library
+ * index as JSON, or a document as markdown plus its provenance.
+ */
+export async function captureResourceContents(uri, opts = {}) {
+    if (!isCaptureUri(uri))
+        throw new Error(`not a capture uri: ${uri}`);
+    const parsed = parseCaptureUri(uri);
+    if (!parsed)
+        throw new Error(`malformed capture uri: ${uri}`);
+    if (!parsed.identity) {
+        const docs = await loadCaptureDocuments(opts);
+        const index = captureLibraryIndex(docs, parsed.scope);
+        return {
+            contents: [{ uri, mimeType: CAPTURE_JSON_MIME_TYPE, text: JSON.stringify(index, null, 2) }],
+        };
+    }
+    const read = await readCapture(uri, opts);
+    return {
+        contents: [
+            { uri, mimeType: CAPTURE_MIME_TYPE, text: read.markdown },
+            { uri, mimeType: CAPTURE_JSON_MIME_TYPE, text: JSON.stringify(read.info, null, 2) },
+        ],
+    };
+}
+/** The uri for a page a caller names by url or path, searching both stores —
+ *  captures live in the global brain, so a project-only lookup would deny
+ *  knowing a page the user saved minutes ago. */
+export async function resolveCaptureUri(target, opts = {}) {
+    const { findDocumentRecord } = await import('../knowledge/document-pipeline.js');
+    const { captureUriFor } = await import('./capture-resources.js');
+    const { getGlobalBrainDir, getProjectRoot } = await import('../memory/memory-bridge.js');
+    const store = opts.store ?? 'all';
+    const roots = [];
+    if (store !== 'global')
+        roots.push(opts.rootDir ?? getProjectRoot());
+    if (store !== 'project')
+        roots.push(opts.globalRoot ?? getGlobalBrainDir());
+    for (const root of roots) {
+        const record = findDocumentRecord(root, target);
+        if (record)
+            return captureUriFor(record);
+    }
+    return undefined;
+}
+//# sourceMappingURL=capture-resource-read.js.map

package/dist/src/mcp-tools/capture-resource-read.js.map

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

package/dist/src/mcp-tools/capture-resource-tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * GLU-07 — the tool half of captures-as-resources.
+ *
+ * Resources are the point (`resource-router.ts`), but two things they cannot
+ * do are worth a tool each:
+ *
+ *  - `resources/list` has no filter parameters in the protocol, and a library
+ *    of thousands of pages needs "from this site, tagged that, since last
+ *    week" rather than a cursor walk. `knowledge_captures` is that query, and
+ *    it hands back the resource URI of every hit so the agent can switch to
+ *    the resource surface for the actual read.
+ *  - a client that does not implement resources at all still deserves the
+ *    provenance-carrying read: `knowledge_capture_read`.
+ *
+ * Both are thin: the work lives in `capture-resources.ts`, `library.ts` and
+ * `citation.ts`.
+ *
+ * @module v1/cli/mcp-tools/capture-resource-tools
+ */
+import type { MCPTool } from './types.js';
+export declare const captureResourceTools: MCPTool[];
+//# sourceMappingURL=capture-resource-tools.d.ts.map

package/dist/src/mcp-tools/capture-resource-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-resource-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/capture-resource-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,YAAY,CAAC;AAmLzD,eAAO,MAAM,oBAAoB,EAAE,OAAO,EAA8C,CAAC"}

package/dist/src/mcp-tools/capture-resource-tools.js

@@ -0,0 +1,182 @@
+/**
+ * GLU-07 — the tool half of captures-as-resources.
+ *
+ * Resources are the point (`resource-router.ts`), but two things they cannot
+ * do are worth a tool each:
+ *
+ *  - `resources/list` has no filter parameters in the protocol, and a library
+ *    of thousands of pages needs "from this site, tagged that, since last
+ *    week" rather than a cursor walk. `knowledge_captures` is that query, and
+ *    it hands back the resource URI of every hit so the agent can switch to
+ *    the resource surface for the actual read.
+ *  - a client that does not implement resources at all still deserves the
+ *    provenance-carrying read: `knowledge_capture_read`.
+ *
+ * Both are thin: the work lives in `capture-resources.ts`, `library.ts` and
+ * `citation.ts`.
+ *
+ * @module v1/cli/mcp-tools/capture-resource-tools
+ */
+const json = (data, isError = false) => ({
+    content: [{ type: 'text', text: JSON.stringify(data) }],
+    ...(isError ? { isError: true } : {}),
+});
+const fail = (error) => json({ success: false, error }, true);
+/** A repeated string filter, from a string or an array of them. */
+function strList(value) {
+    const items = Array.isArray(value) ? value : typeof value === 'string' ? [value] : [];
+    const out = items.filter((v) => typeof v === 'string' && v.trim() !== '');
+    return out.length ? out : undefined;
+}
+const str = (value) => typeof value === 'string' && value.trim() ? value.trim() : undefined;
+const MAX_TARGET_CHARS = 2048;
+const knowledgeCaptures = {
+    name: 'knowledge_captures',
+    description: 'Browse captured pages in the second brain (the MCP `capture://` resources), filtered by ' +
+        'site, tag, collection, source or capture date. Returns each page with its resource URI, ' +
+        'title, URL, capture time and version — read one with knowledge_capture_read or by ' +
+        'reading its resource URI directly. Searches both the project store and the personal ' +
+        'global brain, which is where browser captures land.',
+    category: 'knowledge',
+    tags: ['captures', 'library', 'resources', 'second-brain'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            site: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Host, or a parent domain of it (example.com matches docs.example.com)',
+            },
+            tag: { type: 'array', items: { type: 'string' }, description: 'Capture tags (OR)' },
+            collection: { type: 'array', items: { type: 'string' }, description: 'Collections (OR)' },
+            source: {
+                type: 'array',
+                items: { type: 'string' },
+                description: "'extension' | 'monobrowse' | 'crawl'",
+            },
+            since: { type: 'string', description: 'ISO date/time, or an age: 7d, 24h, 30m' },
+            until: { type: 'string', description: 'ISO date/time, or an age' },
+            text: { type: 'string', description: 'Substring over title, URL, path and note' },
+            scope: { type: 'string', description: 'Knowledge scope (e.g. global, shared)' },
+            store: { type: 'string', description: "'project' | 'global' | 'all' (default: all)" },
+            sort: { type: 'string', description: 'captured (default) | indexed | title | path | size' },
+            order: { type: 'string', description: "'desc' (default) | 'asc'" },
+            limit: { type: 'number', description: 'Page size (default 50, max 200)' },
+            cursor: { type: 'string', description: 'nextCursor from a previous call' },
+            includeLocal: {
+                type: 'boolean',
+                description: 'Also list ordinary indexed files, which are not captures',
+            },
+            facets: { type: 'boolean', description: 'Include site/tag/collection/source counts' },
+        },
+    },
+    handler: async (input) => {
+        try {
+            const { listCaptureResources, loadCaptureDocuments, selectCaptureDocuments } = await import('./capture-resources.js');
+            const store = str(input.store);
+            const docs = await loadCaptureDocuments(store === 'project' || store === 'global' || store === 'all' ? { store } : {});
+            const opts = {
+                ...(strList(input.site) ? { site: strList(input.site) } : {}),
+                ...(strList(input.tag) ? { tag: strList(input.tag) } : {}),
+                ...(strList(input.collection) ? { collection: strList(input.collection) } : {}),
+                ...(strList(input.source) ? { source: strList(input.source) } : {}),
+                ...(str(input.since) ? { since: str(input.since) } : {}),
+                ...(str(input.until) ? { until: str(input.until) } : {}),
+                ...(str(input.text) ? { text: str(input.text) } : {}),
+                ...(str(input.scope) ? { scope: str(input.scope) } : {}),
+                ...(str(input.sort) ? { sort: str(input.sort) } : {}),
+                ...(input.order === 'asc' ? { order: 'asc' } : {}),
+                ...(typeof input.limit === 'number' ? { pageSize: input.limit } : {}),
+                ...(str(input.cursor) ? { cursor: str(input.cursor) } : {}),
+                ...(input.includeLocal === true ? { includeLocal: true } : {}),
+            };
+            const page = listCaptureResources(docs, opts);
+            const body = {
+                success: true,
+                total: page.total,
+                captures: page.rows,
+                ...(page.nextCursor ? { nextCursor: page.nextCursor } : {}),
+            };
+            if (input.facets === true) {
+                const { libraryFacets } = await import('../knowledge/library.js');
+                body.facets = libraryFacets(selectCaptureDocuments(docs, opts));
+            }
+            return json(body);
+        }
+        catch (err) {
+            return fail(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+const knowledgeCaptureRead = {
+    name: 'knowledge_capture_read',
+    description: 'Read one captured page with its provenance: the readable Markdown plus url, title, ' +
+        'capture time, version and citation anchors, so a quote can be cited. Takes a ' +
+        'capture:// resource URI, or the page URL / indexed file path. `chunk` or `anchor` ' +
+        'returns one passage with a link that lands on it; a passage or page whose file ' +
+        'changed since it was indexed comes back flagged stale.',
+    category: 'knowledge',
+    tags: ['captures', 'citation', 'provenance', 'second-brain'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            uri: { type: 'string', description: 'capture://<scope>/<percent-encoded url>' },
+            url: { type: 'string', description: 'The page URL or indexed file path, instead of a uri' },
+            version: { type: 'number', description: 'A stored version (default: the current one)' },
+            chunk: { type: 'number', description: 'Return only this chunk, as a citable passage' },
+            anchor: { type: 'string', description: 'Citation anchor <hash12>#<start>-<end>' },
+            maxChars: { type: 'number', description: 'Truncate the document text (default 200000)' },
+            includeText: {
+                type: 'boolean',
+                description: 'Include the Markdown itself (default true)',
+            },
+        },
+    },
+    handler: async (input) => {
+        try {
+            const { buildCaptureUri, isCaptureUri, parseCaptureUri } = await import('./capture-resources.js');
+            const { readCapture, resolveCaptureUri } = await import('./capture-resource-read.js');
+            const rawUri = str(input.uri);
+            const target = str(input.url);
+            if (!rawUri && !target)
+                return fail('pass either uri or url');
+            if ((rawUri ?? target ?? '').length > MAX_TARGET_CHARS) {
+                return fail(`uri/url is longer than ${MAX_TARGET_CHARS} characters`);
+            }
+            let uri = rawUri;
+            if (!uri) {
+                uri = await resolveCaptureUri(target);
+                if (!uri)
+                    return fail(`not indexed: ${target}`);
+            }
+            else if (!isCaptureUri(uri)) {
+                return fail(`not a capture uri: ${uri}`);
+            }
+            // Extras given as arguments win over anything already in the uri.
+            const parsed = parseCaptureUri(uri);
+            if (!parsed)
+                return fail(`malformed capture uri: ${uri}`);
+            const extras = {
+                ...(typeof input.version === 'number' ? { version: input.version } : {}),
+                ...(typeof input.chunk === 'number' ? { chunkIndex: input.chunk } : {}),
+                ...(str(input.anchor) ? { anchor: str(input.anchor) } : {}),
+            };
+            const finalUri = Object.keys(extras).length
+                ? buildCaptureUri(parsed.scope, parsed.identity, extras)
+                : uri;
+            const read = await readCapture(finalUri, {
+                ...(typeof input.maxChars === 'number' ? { maxChars: input.maxChars } : {}),
+            });
+            return json({
+                success: true,
+                ...read.info,
+                ...(input.includeText === false ? {} : { markdown: read.markdown }),
+            });
+        }
+        catch (err) {
+            return fail(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+export const captureResourceTools = [knowledgeCaptures, knowledgeCaptureRead];
+//# sourceMappingURL=capture-resource-tools.js.map

package/dist/src/mcp-tools/capture-resource-tools.js.map

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