rubien-mcp-server 0.1.0

package/dist/tools/pdf.js

@@ -0,0 +1,147 @@
+import { z } from "zod";
+import { CliError, invokeCliTyped } from "../cli.js";
+import { flagsFromOptions, runCliAsTool } from "../toolHelpers.js";
+export function registerPdfTools(server) {
+    server.registerTool("rubien_pdf_info", {
+        title: "Probe PDF metadata + outline",
+        description: "Return page count, hasTextLayer (sampled across first/middle/last page), file size, isEncrypted, documentTitle, and the flattened outline `sections` (or null when the PDF has no outline). Each section carries title, level (1=top), startPage, and endPage; parent ranges span their descendants. Call this before `rubien_pdf_text` so you know whether to use sections or page ranges.",
+        inputSchema: {
+            id: z.number().int().describe("Reference ID"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ id }) => runCliAsTool(["pdf", "info", String(id)]));
+    server.registerTool("rubien_pdf_text", {
+        title: "Extract text from a PDF",
+        description: "Extract page-keyed text from a reference's attached PDF. Two mutually-exclusive selection modes: `pages` (e.g. '1-3' or '1-3,8-10') or `sections` (array of section title substrings; case-insensitive). When neither is provided the whole document is returned (subject to maxChars). Each returned page carries `text` and `sectionPath` (breadcrumb of containing sections). Errors with `no-outline` when `sections` is requested but the PDF has no outline — fall back to `pages` in that case.",
+        inputSchema: {
+            id: z.number().int().describe("Reference ID"),
+            pages: z
+                .string()
+                .optional()
+                .describe("Page range string, e.g. '1-3' or '1-3,8-10' or '12-'. Mutually exclusive with `sections`."),
+            sections: z
+                .array(z.string().min(1))
+                .optional()
+                .describe("Section title substrings (case-insensitive, repeatable). Mutually exclusive with `pages`. Use after `rubien_pdf_info` confirms `sections != null`."),
+            maxChars: z
+                .number()
+                .int()
+                .positive()
+                .max(500_000)
+                .optional()
+                .describe("Cap total returned characters (default 50000). Truncation is at page boundary."),
+        },
+        annotations: { readOnlyHint: true },
+    }, async (args) => {
+        if (args.pages && args.sections && args.sections.length > 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "pages-and-sections-mutually-exclusive",
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const cliArgs = ["pdf", "text", String(args.id)];
+        if (args.pages)
+            cliArgs.push("--pages", args.pages);
+        if (args.sections) {
+            for (const s of args.sections)
+                cliArgs.push("--section", s);
+        }
+        cliArgs.push(...flagsFromOptions({
+            "--max-chars": args.maxChars,
+        }));
+        return runCliAsTool(cliArgs);
+    });
+    server.registerTool("rubien_pdf_page_image", {
+        title: "Render a PDF page as an image",
+        description: "Render a single PDF page (1-indexed) and return it as an MCP image content block. Use this when text extraction is empty/garbled (scanned page, dense math) or when a figure/table is referenced in the surrounding text. Defaults: JPEG at scale=2.0 (~192 DPI) with quality stepdown to honor maxBytes. PNG mode is opt-in for lossless output but hard-fails on maxBytes.",
+        inputSchema: {
+            id: z.number().int().describe("Reference ID"),
+            page: z.number().int().positive().describe("Page number (1-indexed)"),
+            scale: z
+                .number()
+                .positive()
+                .max(8)
+                .optional()
+                .describe("Render scale (default 2.0; 1.0 ≈ 96 DPI)"),
+            maxBytes: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("Hard cap on rendered image bytes (default 2000000)"),
+            format: z
+                .enum(["jpeg", "png"])
+                .optional()
+                .describe("Output format (default jpeg)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async (args) => {
+        const cliArgs = [
+            "pdf",
+            "page-image",
+            String(args.id),
+            "--page",
+            String(args.page),
+            ...flagsFromOptions({
+                "--scale": args.scale,
+                "--max-bytes": args.maxBytes,
+                "--format": args.format,
+            }),
+        ];
+        try {
+            const result = await invokeCliTyped(cliArgs);
+            const meta = JSON.stringify({
+                id: result.id,
+                page: result.page,
+                widthPx: result.widthPx,
+                heightPx: result.heightPx,
+                qualityUsed: result.qualityUsed,
+                mimeType: result.mimeType,
+            }, null, 2);
+            return {
+                content: [
+                    { type: "text", text: meta },
+                    {
+                        type: "image",
+                        data: result.data,
+                        mimeType: result.mimeType,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            if (err instanceof CliError) {
+                return {
+                    content: [{ type: "text", text: err.message }],
+                    isError: true,
+                };
+            }
+            throw err;
+        }
+    });
+    server.registerTool("rubien_pdf_download", {
+        title: "Download the open-access PDF for a reference",
+        description: "Fetch the open-access PDF (via DOI or arXiv resolution) and attach it to the reference. Skip-if-attached by default; pass `force: true` to detach the existing PDF and re-download. Side effects: writes a file under the library's PDF storage and inserts a pdfCache row + pdfUploadQueue row (so the running app's sync engine will push to CloudKit). Returns `{ id, ok, action, filename? }` where `action` is `\"downloaded\" | \"replaced\" | \"already-attached\" | \"already-pending\"`. Errors (isError) when the reference is missing, has no DOI/arXiv, or the network fetch fails. Long-running — up to 5 minutes.",
+        inputSchema: {
+            id: z.number().int().describe("Reference ID"),
+            force: z
+                .boolean()
+                .optional()
+                .describe("Replace an existing attached PDF instead of skipping."),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false },
+    }, async ({ id, force }) => {
+        const args = ["pdf", "download", String(id)];
+        if (force)
+            args.push("--force");
+        return runCliAsTool(args, { timeoutMs: 300_000 });
+    });
+}
+//# sourceMappingURL=pdf.js.map

package/dist/tools/pdf.js.map

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

package/dist/tools/properties.js

@@ -0,0 +1,247 @@
+import { z } from "zod";
+import { flagsFromOptions, runCliAsTool } from "../toolHelpers.js";
+const PROPERTY_TYPES = [
+    "string",
+    "url",
+    "number",
+    "singleSelect",
+    "multiSelect",
+    "date",
+    "checkbox",
+];
+/// Tags are exposed as the seeded built-in PropertyDefinition with
+/// `defaultFieldKey == "tags"`. All operations below treat Tags as a regular
+/// multiSelect property — `set` / `add_values` / `remove_values` accept tag
+/// IDs (stringified), `add_option` creates a new Tag from a name + color,
+/// `rename_option` / `delete_option` operate by tag ID. The retired
+/// rubien_tags_* tool family folded into this surface.
+function tagsContractNote(extra = "") {
+    return ("For the built-in Tags property (defaultFieldKey == 'tags'): values are " +
+        "tag IDs (stringified). Create new tags via rubien_properties_add_option " +
+        "(value=name, color=hex)." +
+        (extra ? " " + extra : ""));
+}
+export function registerPropertyTools(server) {
+    server.registerTool("rubien_properties_list", {
+        title: "List property definitions (incl. Tags)",
+        description: "List property definitions. Returns PropertyDefinitionDTO[] with options inlined: " +
+            "{value, label, color}. For the built-in Tags property each option is one Tag row " +
+            "(value = stringified tag id, label = name). " +
+            "Pass `ids` and/or `names` to filter; selectors are unioned, exact case-sensitive on names, " +
+            "and override `visible`. Unresolved selectors fail loudly with an `unresolved-selectors` error envelope.",
+        inputSchema: {
+            ids: z
+                .array(z.string())
+                .optional()
+                .describe("Repeatable property IDs to include. Errors if any ID does not exist."),
+            names: z
+                .array(z.string())
+                .optional()
+                .describe("Repeatable property names (exact, case-sensitive) to include. Errors if any name does not exist."),
+            visible: z
+                .boolean()
+                .optional()
+                .describe("Restrict to user-visible properties. Ignored when ids/names are supplied."),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ ids, names, visible }) => {
+        const args = ["properties"];
+        if (visible)
+            args.push("--visible");
+        for (const id of ids ?? [])
+            args.push("--id", id);
+        for (const n of names ?? [])
+            args.push("--name", n);
+        return runCliAsTool(args);
+    });
+    server.registerTool("rubien_properties_create", {
+        title: "Create custom property",
+        description: "Create a new custom property definition. To create a new tag instead, use rubien_properties_add_option against the built-in Tags property.",
+        inputSchema: {
+            name: z.string(),
+            type: z.enum(PROPERTY_TYPES),
+            options: z
+                .string()
+                .optional()
+                .describe("For singleSelect/multiSelect, comma-separated option labels."),
+        },
+    }, async ({ name, type, options }) => runCliAsTool([
+        "properties",
+        "--create",
+        ...flagsFromOptions({
+            "--name": name,
+            "--type": type,
+            "--options": options,
+        }),
+    ]));
+    server.registerTool("rubien_properties_delete", {
+        title: "Delete custom property",
+        description: "Remove a property definition and all its values on references. Cannot delete default/built-in properties (Tags included — use rubien_properties_delete_option to remove individual tags).",
+        inputSchema: { id: z.string() },
+        annotations: { destructiveHint: true },
+    }, async ({ id }) => runCliAsTool(["properties", "--delete", id]));
+    server.registerTool("rubien_properties_rename", {
+        title: "Rename custom property",
+        description: "Change a property's display name. Built-in properties (incl. Tags) cannot be renamed.",
+        inputSchema: { id: z.string(), name: z.string() },
+    }, async ({ id, name }) => runCliAsTool(["properties", "--rename", "--id", id, "--name", name]));
+    server.registerTool("rubien_properties_show", {
+        title: "Show property in UI",
+        description: "Mark a property as visible in the app UI.",
+        inputSchema: { id: z.string() },
+    }, async ({ id }) => runCliAsTool(["properties", "--show", "--id", id]));
+    server.registerTool("rubien_properties_hide", {
+        title: "Hide property in UI",
+        description: "Mark a property as hidden in the app UI.",
+        inputSchema: { id: z.string() },
+    }, async ({ id }) => runCliAsTool(["properties", "--hide", "--id", id]));
+    server.registerTool("rubien_properties_add_option", {
+        title: "Add option to select property (creates a Tag for the Tags property)",
+        description: "Append an option to a singleSelect/multiSelect property. " +
+            "For the built-in Tags property, this creates a new Tag row with `value` as the tag name " +
+            "and `color` as the tag color; the returned option's `value` is the new tag's stable id.",
+        inputSchema: {
+            id: z.string().describe("Property ID"),
+            value: z
+                .string()
+                .describe("Option label (or, for Tags, the new tag's display name)"),
+            color: z.string().optional().describe("Optional hex color"),
+        },
+    }, async ({ id, value, color }) => runCliAsTool([
+        "properties",
+        "--add-option",
+        "--id",
+        id,
+        ...flagsFromOptions({ "--value": value, "--color": color }),
+    ]));
+    server.registerTool("rubien_properties_rename_option", {
+        title: "Rename a select option (renames the underlying Tag for Tags)",
+        description: "Rename an existing option on a singleSelect/multiSelect property and bulk-update affected references. " +
+            "For Tags: `from` is the stringified tag id (identity-stable), `to` is the new display name. " +
+            "Pivots are not touched. For other multiSelect: rewrites the JSON arrays in every affected propertyValue row.",
+        inputSchema: {
+            id: z.string().describe("Property ID"),
+            from: z.string().describe("Existing option value (tag id for Tags)"),
+            to: z.string().describe("New option value (new tag name for Tags)"),
+        },
+    }, async ({ id, from, to }) => runCliAsTool([
+        "properties",
+        "--rename-option",
+        "--id",
+        id,
+        "--from",
+        from,
+        "--to",
+        to,
+    ]));
+    server.registerTool("rubien_properties_delete_option", {
+        title: "Delete a select option (deletes the underlying Tag for Tags)",
+        description: "Remove a select option from a property. " + tagsContractNote("For Tags, deleting a tag with attached references requires `replaceWith` (the stringified id of another tag) — affected references are re-tagged before the old tag is removed. Without `replaceWith`, in-use options surface an `optionInUse` error.") +
+            " To delete an in-use option without migrating, set `clearInUse: true` — affected references have the option cleared from their value (singleSelect loses its value; multiSelect drops just this option). `clearInUse` and `replaceWith` are mutually exclusive.",
+        inputSchema: {
+            id: z.string().describe("Property ID"),
+            value: z.string().describe("Option value to delete (tag id for Tags)"),
+            replaceWith: z
+                .string()
+                .optional()
+                .describe("Replacement option value for affected rows (required when the option is in use)"),
+            clearInUse: z
+                .boolean()
+                .optional()
+                .describe("Clear the option from affected references instead of migrating. Mutually exclusive with replaceWith."),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ id, value, replaceWith, clearInUse }) => runCliAsTool([
+        "properties",
+        "--delete-option",
+        "--id",
+        id,
+        "--value",
+        value,
+        ...flagsFromOptions({
+            "--replace-with": replaceWith,
+            "--clear-in-use": clearInUse,
+        }),
+    ]));
+    server.registerTool("rubien_properties_set", {
+        title: "Set property value on reference (replace semantics)",
+        description: "Assign a property value to a reference using replace semantics. For multiSelect (incl. Tags), pass comma-separated values — the existing set is overwritten. " +
+            "Use rubien_properties_add_values / rubien_properties_remove_values for incremental edits. " +
+            tagsContractNote(),
+        inputSchema: {
+            reference: z.number().int(),
+            id: z.string().describe("Property ID"),
+            value: z.string(),
+        },
+    }, async ({ reference, id, value }) => runCliAsTool([
+        "properties",
+        "--set",
+        "--reference",
+        String(reference),
+        "--id",
+        id,
+        "--value",
+        value,
+    ]));
+    server.registerTool("rubien_properties_add_values", {
+        title: "Add values to a multiSelect property (additive, idempotent)",
+        description: "Append one or more values to a multiSelect property on a reference without disturbing existing selections. " +
+            "Idempotent: re-adding a present value is a no-op (no sync churn). " +
+            tagsContractNote("For Tags this inserts ReferenceTag pivots."),
+        inputSchema: {
+            reference: z.number().int(),
+            id: z.string().describe("Property ID"),
+            value: z.string().describe("Comma-separated values (tag IDs for Tags)"),
+        },
+    }, async ({ reference, id, value }) => runCliAsTool([
+        "properties",
+        "--set",
+        "--add-value",
+        "--reference",
+        String(reference),
+        "--id",
+        id,
+        "--value",
+        value,
+    ]));
+    server.registerTool("rubien_properties_remove_values", {
+        title: "Remove values from a multiSelect property (subtractive, idempotent)",
+        description: "Remove one or more values from a multiSelect property on a reference without disturbing other selections. " +
+            "Idempotent: removing an absent value is a no-op. " +
+            tagsContractNote("For Tags this deletes ReferenceTag pivots."),
+        inputSchema: {
+            reference: z.number().int(),
+            id: z.string().describe("Property ID"),
+            value: z.string().describe("Comma-separated values (tag IDs for Tags)"),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ reference, id, value }) => runCliAsTool([
+        "properties",
+        "--set",
+        "--remove-value",
+        "--reference",
+        String(reference),
+        "--id",
+        id,
+        "--value",
+        value,
+    ]));
+    server.registerTool("rubien_properties_clear", {
+        title: "Clear property value on reference",
+        description: "Remove a property value from a reference. " +
+            tagsContractNote("For Tags this removes all of the reference's tag assignments."),
+        inputSchema: {
+            reference: z.number().int(),
+            id: z.string().describe("Property ID"),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ reference, id }) => runCliAsTool([
+        "properties",
+        "--clear",
+        "--reference",
+        String(reference),
+        "--id",
+        id,
+    ]));
+}
+//# sourceMappingURL=properties.js.map

package/dist/tools/properties.js.map

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

package/dist/tools/references.js

@@ -0,0 +1,207 @@
+import { z } from "zod";
+import { flagsFromOptions, runCliAsTool } from "../toolHelpers.js";
+export function registerReferenceTools(server) {
+    server.registerTool("rubien_search", {
+        title: "Full-text search",
+        description: "Full-text search across the Rubien library. By default searches all 12 indexed FTS columns (title, authors, abstract, notes, journal, doi, publisher, isbn, issn, institution, webContent, siteName). Use `in` to constrain to specific columns — e.g. `in: ['title','abstract']` for topic searches that should ignore notes/web content. Use `op: 'or'` when looking for any of several alternative terms instead of all of them. Returns an array of ReferenceDTO.",
+        inputSchema: {
+            query: z.string().describe("Search query (space-separated tokens)"),
+            limit: z.number().int().positive().max(500).optional()
+                .describe("Maximum results (default 20)"),
+            in: z
+                .array(z.enum([
+                "title",
+                "abstract",
+                "notes",
+                "authors",
+                "journal",
+                "doi",
+                "publisher",
+                "isbn",
+                "issn",
+                "institution",
+                "webContent",
+                "siteName",
+            ]))
+                .optional()
+                .describe("Restrict FTS to these columns (default: all 12 indexed columns)."),
+            op: z
+                .enum(["and", "or"])
+                .optional()
+                .describe("Combine multiple query tokens with AND (every token must match) or OR (any token). Default: and."),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ query, limit, in: inFields, op }) => runCliAsTool([
+        "search",
+        query,
+        ...flagsFromOptions({
+            "--limit": limit,
+            "--in": inFields && inFields.length > 0 ? inFields.join(",") : undefined,
+            "--op": op,
+        }),
+    ]));
+    server.registerTool("rubien_list", {
+        title: "List references",
+        description: "List references with filters and sorting. Returns ReferenceDTO[]. Use this for 'most recent', 'by author', 'by year range' queries.",
+        inputSchema: {
+            limit: z.number().int().nonnegative().optional()
+                .describe("Maximum results (0 = all)"),
+            offset: z.number().int().nonnegative().optional().describe("Skip first N"),
+            tag: z.number().int().optional().describe("Filter by tag ID"),
+            author: z.string().optional().describe("Filter by author name (fuzzy)"),
+            yearFrom: z.number().int().optional(),
+            yearTo: z.number().int().optional(),
+            journal: z.string().optional().describe("Filter by journal name (fuzzy)"),
+            type: z.string().optional().describe("Reference type, e.g. 'Journal Article'"),
+            hasPdf: z.boolean().optional(),
+            keyword: z.string().optional().describe("Keyword across title/abstract/notes"),
+            readingStatus: z
+                .enum(["unread", "reading", "skimmed", "read"])
+                .optional(),
+            sortBy: z
+                .enum(["year", "dateAdded", "title"])
+                .optional(),
+            asc: z.boolean().optional().describe("Sort ascending (default is descending)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async (args) => runCliAsTool([
+        "list",
+        ...flagsFromOptions({
+            "--limit": args.limit,
+            "--offset": args.offset,
+            "--tag": args.tag,
+            "--author": args.author,
+            "--year-from": args.yearFrom,
+            "--year-to": args.yearTo,
+            "--journal": args.journal,
+            "--type": args.type,
+            "--has-pdf": args.hasPdf,
+            "--keyword": args.keyword,
+            "--reading-status": args.readingStatus,
+            "--sort-by": args.sortBy,
+            "--asc": args.asc,
+        }),
+    ]));
+    server.registerTool("rubien_get", {
+        title: "Get reference by ID",
+        description: "Fetch a single reference by ID. Returns ReferenceDTO.",
+        inputSchema: {
+            id: z.number().int().describe("Reference ID"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ id }) => runCliAsTool(["get", String(id)]));
+    server.registerTool("rubien_add", {
+        title: "Add reference",
+        description: "Create a reference (or surface an existing one). Choose one input method: identifier (DOI/arXiv/PMID/ISBN, triggers metadata lookup, slow), bibtex (inline BibTeX/BibLaTeX string, returns array of envelopes for multi-entry), or title (minimal manual entry). Output is an envelope: `{ reference: ReferenceDTO, status: 'created' | 'existing', pdfDownload: { ok, action?, filename?, error? } | null }`. `status='existing'` means the input matched an existing row (deduped by normalized DOI / PMID / PMCID / ISBN / URL / ISSN+title+year); `mergedReference` folded any non-empty incoming fields into the existing row, and `reference.id` is the existing row's id. `pdfDownload` is always present: `null` unless `downloadPdf: true` was set (identifier only). For `method='bibtex'`, output is an array of envelopes, one per parsed entry.",
+        inputSchema: {
+            method: z.enum(["identifier", "bibtex", "title"]),
+            value: z
+                .string()
+                .describe("The identifier / BibTeX source / title, depending on method."),
+            downloadPdf: z
+                .boolean()
+                .optional()
+                .describe("Only valid with method='identifier'. After metadata lookup, attempt to fetch the open-access PDF. Reference is still saved if the PDF fetch fails. Adds up to ~3min to the timeout."),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false },
+    }, async ({ method, value, downloadPdf }) => {
+        if (downloadPdf && method !== "identifier") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "downloadPdf requires method='identifier'",
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const flag = method === "identifier"
+            ? "--identifier"
+            : method === "bibtex"
+                ? "--bibtex"
+                : "--title";
+        const args = ["add", flag, value];
+        if (downloadPdf)
+            args.push("--download-pdf");
+        const timeoutMs = downloadPdf
+            ? 300_000
+            : method === "identifier"
+                ? 120_000
+                : undefined;
+        return runCliAsTool(args, { timeoutMs });
+    });
+    server.registerTool("rubien_update", {
+        title: "Update reference fields",
+        description: "Modify fields on an existing reference. Pass only the fields to change. Use `clearField` (repeatable) to null out a field entirely.",
+        inputSchema: {
+            id: z.number().int(),
+            title: z.string().optional(),
+            year: z.number().int().optional(),
+            authors: z.string().optional(),
+            type: z.string().optional(),
+            journal: z.string().optional(),
+            volume: z.string().optional(),
+            issue: z.string().optional(),
+            pages: z.string().optional(),
+            doi: z.string().optional(),
+            url: z.string().optional(),
+            abstract: z.string().optional(),
+            notes: z.string().optional(),
+            publisher: z.string().optional(),
+            isbn: z.string().optional(),
+            issn: z.string().optional(),
+            language: z.string().optional(),
+            edition: z.string().optional(),
+            readingStatus: z
+                .enum(["unread", "reading", "skimmed", "read"])
+                .optional(),
+            clearField: z.array(z.string()).optional()
+                .describe("Field names to clear (set to NULL). Repeatable."),
+        },
+        annotations: { destructiveHint: true },
+    }, async (args) => {
+        const flags = flagsFromOptions({
+            "--title": args.title,
+            "--year": args.year,
+            "--authors": args.authors,
+            "--type": args.type,
+            "--journal": args.journal,
+            "--volume": args.volume,
+            "--issue": args.issue,
+            "--pages": args.pages,
+            "--doi": args.doi,
+            "--url": args.url,
+            "--abstract": args.abstract,
+            "--notes": args.notes,
+            "--publisher": args.publisher,
+            "--isbn": args.isbn,
+            "--issn": args.issn,
+            "--language": args.language,
+            "--edition": args.edition,
+            "--reading-status": args.readingStatus,
+        });
+        if (args.clearField) {
+            for (const f of args.clearField)
+                flags.push("--clear-field", f);
+        }
+        return runCliAsTool(["update", String(args.id), ...flags]);
+    });
+    server.registerTool("rubien_delete", {
+        title: "Delete references",
+        description: "Permanently delete references by ID. Accepts one or many IDs. Returns { deleted: 'id1,id2,...' }.",
+        inputSchema: {
+            ids: z
+                .array(z.number().int())
+                .min(1)
+                .describe("One or more reference IDs to delete"),
+        },
+        annotations: { destructiveHint: true, idempotentHint: false },
+    }, 
+    // Always passes --force: the MCP client's permission layer is the user
+    // confirmation point for destructive tools, not the CLI's TTY prompt.
+    async ({ ids }) => runCliAsTool(["delete", "--force", ...ids.map((n) => String(n))]));
+}
+//# sourceMappingURL=references.js.map

package/dist/tools/references.js.map

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

package/dist/tools/sync.js

@@ -0,0 +1,10 @@
+import { runCliAsTool } from "../toolHelpers.js";
+export function registerSyncTools(server) {
+    server.registerTool("rubien_sync_status", {
+        title: "CloudKit sync status",
+        description: "Report the current CloudKit sync state without starting the engine. Shows entitlement presence, iCloud account availability, dirty counts per entity type, tombstones, and engine state snapshot.",
+        inputSchema: {},
+        annotations: { readOnlyHint: true },
+    }, async () => runCliAsTool(["sync", "status"]));
+}
+//# sourceMappingURL=sync.js.map