@tekmidian/devon 3.0.0

package/dist/tools/custom/column-layout.js

@@ -0,0 +1,244 @@
+/**
+ * column-layout.ts — Read and copy DEVONthink column layouts for smart groups/rules.
+ *
+ * Column layouts are stored in ~/Library/Preferences/com.devon-technologies.think.plist
+ * under three related keys per smart group or rule.
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { plistRead, parsePlistBuddyArray, parsePlistBuddyDict, getPlistKeysByPrefix, copyPlistKeys, } from "../../shared/plist/reader.js";
+const PLIST_PATH = join(homedir(), "Library", "Preferences", "com.devon-technologies.think.plist");
+const LAYOUT_PREFIXES = [
+    "ListColumnsHorizontal-",
+    "TableView Columns ListColumnsHorizontal-",
+    "TableView Column Widths ListColumnsHorizontal-",
+];
+const LAYOUT_SUFFIXES = [
+    "ListColumnsHorizontal",
+    "TableView Columns ListColumnsHorizontal",
+    "TableView Column Widths ListColumnsHorizontal",
+];
+function keysForName(name) {
+    return {
+        columnsKey: `ListColumnsHorizontal-${name}`,
+        tableViewColumnsKey: `TableView Columns ListColumnsHorizontal-${name}`,
+        tableViewWidthsKey: `TableView Column Widths ListColumnsHorizontal-${name}`,
+    };
+}
+function readLayoutForName(baseName) {
+    const { columnsKey, tableViewColumnsKey, tableViewWidthsKey } = keysForName(baseName);
+    const rawColumns = plistRead(PLIST_PATH, `Print ':${columnsKey}'`);
+    const rawTableViewColumns = plistRead(PLIST_PATH, `Print ':${tableViewColumnsKey}'`);
+    const rawWidths = plistRead(PLIST_PATH, `Print ':${tableViewWidthsKey}'`);
+    if (!rawColumns && !rawTableViewColumns && !rawWidths) {
+        return null;
+    }
+    const keysFound = [];
+    if (rawColumns)
+        keysFound.push(columnsKey);
+    if (rawTableViewColumns)
+        keysFound.push(tableViewColumnsKey);
+    if (rawWidths)
+        keysFound.push(tableViewWidthsKey);
+    return {
+        found: true,
+        name: baseName,
+        resolvedKey: baseName,
+        columns: rawColumns ? parsePlistBuddyArray(rawColumns) : null,
+        tableViewColumns: rawTableViewColumns ? parsePlistBuddyArray(rawTableViewColumns) : null,
+        widths: rawWidths ? parsePlistBuddyDict(rawWidths) : null,
+        keysFound,
+    };
+}
+function getExistingNames(limit = 20) {
+    return getPlistKeysByPrefix(PLIST_PATH, LAYOUT_PREFIXES, limit);
+}
+function findMatchingNames(searchTerm) {
+    const allNames = getExistingNames(200);
+    const lower = searchTerm.toLowerCase();
+    return allNames.filter((n) => n.toLowerCase().includes(lower));
+}
+// ---------------------------------------------------------------------------
+// get_column_layout
+// ---------------------------------------------------------------------------
+const getColumnLayout = async (args) => {
+    const name = args.name;
+    const uuid = args.uuid;
+    if (!name || typeof name !== "string") {
+        return { success: false, error: "name parameter is required" };
+    }
+    const exactResult = readLayoutForName(name);
+    if (exactResult) {
+        return { success: true, ...exactResult };
+    }
+    if (uuid && typeof uuid === "string") {
+        const uuidResult = readLayoutForName(uuid);
+        if (uuidResult) {
+            return { success: true, ...uuidResult, name };
+        }
+    }
+    const fuzzyMatches = findMatchingNames(name);
+    if (fuzzyMatches.length === 1) {
+        const fuzzyResult = readLayoutForName(fuzzyMatches[0]);
+        if (fuzzyResult) {
+            return {
+                success: true,
+                ...fuzzyResult,
+                nameSearched: name,
+                note: `Exact name not found; matched "${fuzzyMatches[0]}" via partial search`,
+            };
+        }
+    }
+    const examples = getExistingNames(15);
+    if (fuzzyMatches.length > 1) {
+        return {
+            success: false,
+            name,
+            error: `No exact match for "${name}". Multiple partial matches found — be more specific.`,
+            partialMatches: fuzzyMatches,
+        };
+    }
+    return {
+        success: false,
+        name,
+        error: `No column layout found for "${name}". ` +
+            "This smart group may not have a custom layout yet (it will use defaults). " +
+            "Use copy_column_layout to copy an existing layout to it.",
+        exampleNames: examples,
+    };
+};
+export const getColumnLayoutTool = {
+    name: "get_column_layout",
+    description: "Read the column layout for a DEVONthink smart group or smart rule from preferences. " +
+        "Returns the ordered visible columns, all table view columns, and column widths. " +
+        "Looks up by name (or UUID). Supports partial name matching. " +
+        'Input: { "name": "Archivieren - Jobs" } or { "name": "Jobs", "uuid": "4A469368-..." }',
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                description: "Name of the smart group or smart rule whose column layout to read",
+            },
+            uuid: {
+                type: "string",
+                description: "Optional UUID of the smart group (fallback if name not found). " +
+                    "DEVONthink sometimes stores layouts under the UUID rather than the display name.",
+            },
+        },
+        required: ["name"],
+    },
+    run: getColumnLayout,
+};
+const copyColumnLayout = async (args) => {
+    const sourceName = args.sourceName;
+    const targetName = args.targetName;
+    const sourceUuid = args.sourceUuid;
+    const targetUuid = args.targetUuid;
+    if (!sourceName || typeof sourceName !== "string") {
+        return { success: false, error: "sourceName parameter is required" };
+    }
+    if (!targetName || typeof targetName !== "string") {
+        return { success: false, error: "targetName parameter is required" };
+    }
+    let resolvedSourceKey = null;
+    if (readLayoutForName(sourceName)) {
+        resolvedSourceKey = sourceName;
+    }
+    else if (sourceUuid && readLayoutForName(sourceUuid)) {
+        resolvedSourceKey = sourceUuid;
+    }
+    else {
+        const fuzzy = findMatchingNames(sourceName);
+        if (fuzzy.length === 1 && readLayoutForName(fuzzy[0])) {
+            resolvedSourceKey = fuzzy[0];
+        }
+        else if (fuzzy.length > 1) {
+            return {
+                success: false,
+                sourceName,
+                targetName,
+                error: `Ambiguous source name "${sourceName}". Multiple matches: ${fuzzy.slice(0, 8).join(", ")}`,
+            };
+        }
+    }
+    if (!resolvedSourceKey) {
+        const examples = getExistingNames(10);
+        return {
+            success: false,
+            sourceName,
+            targetName,
+            error: `Source column layout for "${sourceName}" not found. ` +
+                "This smart group may not have a custom layout saved yet. " +
+                `Known layouts include: ${examples.slice(0, 8).join(", ")}`,
+        };
+    }
+    const resolvedTargetKey = targetUuid ?? targetName;
+    const copyResult = copyPlistKeys(PLIST_PATH, LAYOUT_SUFFIXES, resolvedSourceKey, resolvedTargetKey);
+    if (!copyResult.ok) {
+        return {
+            success: false,
+            sourceName,
+            targetName,
+            resolvedSourceKey,
+            resolvedTargetKey,
+            error: `Copy failed: ${copyResult.error}`,
+        };
+    }
+    const verification = readLayoutForName(resolvedTargetKey);
+    if (!verification) {
+        return {
+            success: false,
+            sourceName,
+            targetName,
+            resolvedSourceKey,
+            resolvedTargetKey,
+            error: "Copy appeared to succeed but target keys not readable after write",
+        };
+    }
+    return {
+        success: true,
+        sourceName,
+        targetName,
+        resolvedSourceKey,
+        resolvedTargetKey,
+        keysCopied: copyResult.keysCopied,
+        message: `Copied column layout from "${sourceName}" to "${targetName}". ` +
+            `Keys written: ${copyResult.keysCopied.join(", ")}. ` +
+            `Columns: [${verification.columns?.join(", ") ?? "n/a"}]. ` +
+            "Restart DEVONthink or close/reopen the smart group window for the change to take effect.",
+    };
+};
+export const copyColumnLayoutTool = {
+    name: "copy_column_layout",
+    description: "Copy the column layout (column order, visible columns, and column widths) from one " +
+        "DEVONthink smart group or smart rule to another. " +
+        "All three layout keys are copied atomically. Supports partial name matching. " +
+        'Input: { "sourceName": "Archivieren - Jobs", "targetName": "Jobs - To Review" }',
+    inputSchema: {
+        type: "object",
+        properties: {
+            sourceName: {
+                type: "string",
+                description: "Name of the source smart group or smart rule (must have a saved layout)",
+            },
+            targetName: {
+                type: "string",
+                description: "Name of the target smart group or smart rule to copy the layout to",
+            },
+            sourceUuid: {
+                type: "string",
+                description: "Optional UUID of the source smart group (fallback if name lookup fails). " +
+                    "DEVONthink sometimes stores layouts under the UUID.",
+            },
+            targetUuid: {
+                type: "string",
+                description: "Optional UUID of the target smart group. If supplied, the layout is written " +
+                    "under the UUID key (which DEVONthink prefers for smart groups).",
+            },
+        },
+        required: ["sourceName", "targetName"],
+    },
+    run: copyColumnLayout,
+};
+//# sourceMappingURL=column-layout.js.map

package/dist/tools/custom/column-layout.js.map

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

package/dist/tools/custom/list-smart-groups.d.ts

@@ -0,0 +1,8 @@
+/**
+ * list-smart-groups.ts — Parse DEVONthink SmartGroups.plist to enumerate all smart groups.
+ *
+ * Smart groups are NOT accessible via the standard AppleScript scripting dictionary.
+ * This tool reads the plist file directly using `plutil -convert xml1`.
+ */
+import type { McpTool } from "../../jxa/types.js";
+export declare const listSmartGroupsTool: McpTool;

package/dist/tools/custom/list-smart-groups.js

@@ -0,0 +1,79 @@
+/**
+ * list-smart-groups.ts — Parse DEVONthink SmartGroups.plist to enumerate all smart groups.
+ *
+ * Smart groups are NOT accessible via the standard AppleScript scripting dictionary.
+ * This tool reads the plist file directly using `plutil -convert xml1`.
+ */
+import { execSync } from "node:child_process";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { extractTopLevelDicts, extractStringAfterKey, extractDateAfterKey, extractBoolAfterKey, extractSubDictAfterKey, } from "../../shared/plist/parser.js";
+const PLIST_PATH = join(homedir(), "Library", "Application Support", "DEVONthink", "SmartGroups.plist");
+function parsePlistXmlToSmartGroups(xml) {
+    const topLevelDicts = extractTopLevelDicts(xml);
+    const results = [];
+    for (const dictContent of topLevelDicts) {
+        const name = extractStringAfterKey(dictContent, "name");
+        const useUuidKey = extractBoolAfterKey(dictContent, "UseUUIDKey");
+        const syncContent = extractSubDictAfterKey(dictContent, "sync");
+        const uuid = syncContent ? extractStringAfterKey(syncContent, "UUID") : null;
+        const syncDate = syncContent ? extractDateAfterKey(syncContent, "date") : null;
+        if (!name && !uuid)
+            continue;
+        results.push({
+            name: name ?? "(unnamed)",
+            uuid: uuid ?? "",
+            syncDate: syncDate ?? null,
+            useUuidKey,
+        });
+    }
+    return results;
+}
+const listSmartGroups = async () => {
+    if (!existsSync(PLIST_PATH)) {
+        return {
+            success: false,
+            error: `SmartGroups.plist not found at: ${PLIST_PATH}. Ensure DEVONthink has been run at least once.`,
+        };
+    }
+    let xml;
+    try {
+        xml = execSync(`plutil -convert xml1 -o - "${PLIST_PATH}"`, {
+            encoding: "utf-8",
+            timeout: 10000,
+        });
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Failed to parse SmartGroups.plist: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    let smartGroups;
+    try {
+        smartGroups = parsePlistXmlToSmartGroups(xml);
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Failed to parse XML output from plutil: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    smartGroups.sort((a, b) => a.name.localeCompare(b.name));
+    return { success: true, smartGroups, totalCount: smartGroups.length };
+};
+export const listSmartGroupsTool = {
+    name: "list_smart_groups",
+    description: "List all DEVONthink smart groups by parsing SmartGroups.plist. " +
+        "Returns name, UUID (from sync.UUID), sync date, and UseUUIDKey flag for each smart group. " +
+        "Smart groups are NOT accessible via the standard AppleScript API — this is the only way to enumerate them. " +
+        "Use the returned uuid with the search tool (groupUuid parameter) to query the contents of a smart group.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+    },
+    run: listSmartGroups,
+};
+//# sourceMappingURL=list-smart-groups.js.map

package/dist/tools/custom/list-smart-groups.js.map

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

package/dist/tools/custom/list-smart-rules.d.ts

@@ -0,0 +1,8 @@
+/**
+ * list-smart-rules.ts — Parse DEVONthink SmartRules.plist to enumerate all smart rules.
+ *
+ * Smart rules are NOT accessible via the standard AppleScript scripting dictionary.
+ * This tool reads the plist file directly using `plutil -convert xml1`.
+ */
+import type { McpTool } from "../../jxa/types.js";
+export declare const listSmartRulesTool: McpTool;

package/dist/tools/custom/list-smart-rules.js

@@ -0,0 +1,85 @@
+/**
+ * list-smart-rules.ts — Parse DEVONthink SmartRules.plist to enumerate all smart rules.
+ *
+ * Smart rules are NOT accessible via the standard AppleScript scripting dictionary.
+ * This tool reads the plist file directly using `plutil -convert xml1`.
+ */
+import { execSync } from "node:child_process";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { extractTopLevelDicts, extractStringAfterKey, extractDateAfterKey, extractBoolAfterKey, extractIntegerAfterKey, extractRealAfterKey, extractSubDictAfterKey, } from "../../shared/plist/parser.js";
+const PLIST_PATH = join(homedir(), "Library", "Application Support", "DEVONthink", "SmartRules.plist");
+function parsePlistXmlToSmartRules(xml) {
+    const topLevelDicts = extractTopLevelDicts(xml);
+    const results = [];
+    for (const dictContent of topLevelDicts) {
+        const name = extractStringAfterKey(dictContent, "name");
+        const enabled = extractBoolAfterKey(dictContent, "Enabled");
+        const indexOffset = extractIntegerAfterKey(dictContent, "IndexOffset");
+        const lastExecution = extractRealAfterKey(dictContent, "LastExecution");
+        const useUuidKey = extractBoolAfterKey(dictContent, "UseUUIDKey");
+        const syncContent = extractSubDictAfterKey(dictContent, "sync");
+        const uuid = syncContent ? extractStringAfterKey(syncContent, "UUID") : null;
+        const syncDate = syncContent ? extractDateAfterKey(syncContent, "date") : null;
+        if (!name && !uuid)
+            continue;
+        results.push({
+            name: name ?? "(unnamed)",
+            uuid: uuid ?? "",
+            enabled,
+            indexOffset,
+            lastExecution,
+            syncDate: syncDate ?? null,
+            useUuidKey,
+        });
+    }
+    return results;
+}
+const listSmartRules = async () => {
+    if (!existsSync(PLIST_PATH)) {
+        return {
+            success: false,
+            error: `SmartRules.plist not found at: ${PLIST_PATH}. Ensure DEVONthink has been run at least once and smart rules have been created.`,
+        };
+    }
+    let xml;
+    try {
+        xml = execSync(`plutil -convert xml1 -o - "${PLIST_PATH}"`, {
+            encoding: "utf-8",
+            timeout: 10000,
+        });
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Failed to parse SmartRules.plist: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    let smartRules;
+    try {
+        smartRules = parsePlistXmlToSmartRules(xml);
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Failed to parse XML output from plutil: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    smartRules.sort((a, b) => a.name.localeCompare(b.name));
+    return { success: true, smartRules, totalCount: smartRules.length };
+};
+export const listSmartRulesTool = {
+    name: "list_smart_rules",
+    description: "List all DEVONthink smart rules by parsing SmartRules.plist. " +
+        "Returns name, UUID (from sync.UUID), enabled state, indexOffset, lastExecution timestamp, " +
+        "and sync date for each rule. " +
+        "Smart rules are NOT accessible via the standard AppleScript API — this is the only way to enumerate them.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+    },
+    run: listSmartRules,
+};
+//# sourceMappingURL=list-smart-rules.js.map

package/dist/tools/custom/list-smart-rules.js.map

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

package/dist/tools/custom/parse-eml-headers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * parse-eml-headers.ts — Extract MIME headers from .eml files.
+ *
+ * Reads an RFC 2822 email file and returns key headers for thread correlation.
+ * Handles CRLF/LF line endings, folded headers, and RFC 2047 encoded words.
+ */
+import type { McpTool } from "../../jxa/types.js";
+export declare const parseEmlHeadersTool: McpTool;

package/dist/tools/custom/parse-eml-headers.js

@@ -0,0 +1,155 @@
+/**
+ * parse-eml-headers.ts — Extract MIME headers from .eml files.
+ *
+ * Reads an RFC 2822 email file and returns key headers for thread correlation.
+ * Handles CRLF/LF line endings, folded headers, and RFC 2047 encoded words.
+ */
+import { existsSync, createReadStream } from "node:fs";
+function decodeEncodedWords(input) {
+    return input.replace(/=\?([^?]+)\?([BbQq])\?([^?]*)\?=/g, (_match, charset, encoding, text) => {
+        try {
+            const enc = encoding.toUpperCase();
+            let bytes;
+            if (enc === "B") {
+                bytes = Buffer.from(text, "base64");
+            }
+            else {
+                const decoded = text
+                    .replace(/_/g, " ")
+                    .replace(/=([0-9A-Fa-f]{2})/g, (_m, h) => String.fromCharCode(parseInt(h, 16)));
+                bytes = Buffer.from(decoded, "binary");
+            }
+            const csLower = charset.toLowerCase();
+            const csNorm = csLower === "us-ascii" ? "ascii" :
+                csLower === "iso-8859-1" || csLower === "iso-8859-15" ? "latin1" :
+                    csLower || "utf-8";
+            return bytes.toString(csNorm);
+        }
+        catch {
+            return _match;
+        }
+    });
+}
+function parseHeaders(headerSection) {
+    const headers = new Map();
+    const normalised = headerSection.replace(/\r\n/g, "\n");
+    const lines = normalised.split("\n");
+    let currentName = null;
+    let currentValue = "";
+    const flush = () => {
+        if (currentName !== null) {
+            const unfolded = currentValue.replace(/\n[ \t]+/g, " ").trim();
+            const key = currentName.toLowerCase();
+            if (headers.has(key)) {
+                headers.set(key, headers.get(key) + "\n" + unfolded);
+            }
+            else {
+                headers.set(key, unfolded);
+            }
+        }
+    };
+    for (const line of lines) {
+        if (line === "")
+            break;
+        if (line[0] === " " || line[0] === "\t") {
+            if (currentName !== null) {
+                currentValue += "\n" + line;
+            }
+        }
+        else {
+            flush();
+            const colonIdx = line.indexOf(":");
+            if (colonIdx > 0) {
+                currentName = line.slice(0, colonIdx).trim();
+                currentValue = line.slice(colonIdx + 1);
+            }
+            else {
+                currentName = null;
+                currentValue = "";
+            }
+        }
+    }
+    flush();
+    return headers;
+}
+function parseReferences(raw) {
+    const matches = raw.match(/<[^>]+>/g);
+    return matches ?? [];
+}
+const parseEmlHeaders = async (args) => {
+    const filePath = args.filePath;
+    if (!filePath || typeof filePath !== "string") {
+        return { success: false, error: "filePath parameter is required and must be a string" };
+    }
+    if (!existsSync(filePath)) {
+        return { success: false, filePath, error: `File not found: ${filePath}` };
+    }
+    let rawContent;
+    try {
+        const HEADER_READ_LIMIT = 65536;
+        const fd = await new Promise((resolve, reject) => {
+            const stream = createReadStream(filePath, { start: 0, end: HEADER_READ_LIMIT - 1 });
+            const chunks = [];
+            stream.on("data", (chunk) => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));
+            stream.on("end", () => resolve(Buffer.concat(chunks)));
+            stream.on("error", reject);
+        });
+        rawContent = fd.toString("utf-8");
+    }
+    catch (err) {
+        return {
+            success: false,
+            filePath,
+            error: `Failed to read file: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    const crlf = rawContent.indexOf("\r\n\r\n");
+    const lf = rawContent.indexOf("\n\n");
+    let headerSection;
+    if (crlf !== -1 && (lf === -1 || crlf < lf)) {
+        headerSection = rawContent.slice(0, crlf);
+    }
+    else if (lf !== -1) {
+        headerSection = rawContent.slice(0, lf);
+    }
+    else {
+        headerSection = rawContent;
+    }
+    const headers = parseHeaders(headerSection);
+    const get = (name) => {
+        const val = headers.get(name);
+        return val !== undefined ? decodeEncodedWords(val.trim()) : null;
+    };
+    const referencesRaw = get("references");
+    return {
+        success: true,
+        filePath,
+        messageId: get("message-id"),
+        inReplyTo: get("in-reply-to"),
+        references: referencesRaw ? parseReferences(referencesRaw) : [],
+        subject: get("subject"),
+        from: get("from"),
+        to: get("to"),
+        cc: get("cc"),
+        date: get("date"),
+    };
+};
+export const parseEmlHeadersTool = {
+    name: "parse_eml_headers",
+    description: "Extract MIME headers from an .eml file for email thread correlation. " +
+        "Returns message_id, in_reply_to, references (array), subject, from, to, cc, and date. " +
+        "Handles CRLF/LF line endings, folded headers, and RFC 2047 encoded words in Subject/From/To. " +
+        'Input: { "filePath": "/path/to/email.eml" }',
+    inputSchema: {
+        type: "object",
+        properties: {
+            filePath: {
+                type: "string",
+                description: "Absolute path to the .eml file to parse",
+            },
+        },
+        required: ["filePath"],
+    },
+    run: parseEmlHeaders,
+};
+//# sourceMappingURL=parse-eml-headers.js.map

package/dist/tools/custom/parse-eml-headers.js.map

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

package/dist/tools/database/get-current-database.d.ts

@@ -0,0 +1,7 @@
+/**
+ * get-current-database.ts — Get information about the currently selected database.
+ *
+ * Returns name, uuid, path, and record count for whichever database is currently
+ * active in the DEVONthink UI.
+ */
+export declare const currentDatabaseTool: import("../../jxa/types.js").McpTool;