@tekmidian/devon 3.0.0

package/dist/tools/database/get-current-database.js

@@ -0,0 +1,29 @@
+/**
+ * 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.
+ */
+import { z } from "zod";
+import { defineTool } from "../../jxa/types.js";
+import { JXA_APP } from "../../jxa/helpers.js";
+export const currentDatabaseTool = defineTool({
+    name: "current_database",
+    description: "Get information about the currently selected database in DEVONthink.",
+    schema: z.object({}),
+    run: async (_args, executor) => {
+        const script = `
+${JXA_APP}
+var db = app.currentDatabase();
+if (!db || !db.uuid()) throw new Error("No current database found");
+JSON.stringify({
+  uuid: db.uuid(),
+  name: db.name(),
+  path: db.path()
+});
+`.trim();
+        const { stdout } = executor.run(script);
+        return JSON.parse(stdout);
+    },
+});
+//# sourceMappingURL=get-current-database.js.map

package/dist/tools/database/get-current-database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-current-database.js","sourceRoot":"","sources":["../../../src/tools/database/get-current-database.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;IAC5C,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,sEAAsE;IACxE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG;EACjB,OAAO;;;;;;;;CAQR,CAAC,IAAI,EAAE,CAAC;QAEL,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAIvB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/database/get-open-databases.d.ts

@@ -0,0 +1,6 @@
+/**
+ * get-open-databases.ts — List all currently open databases in DEVONthink.
+ *
+ * Returns uuid, name, path, and record count for each open database.
+ */
+export declare const getOpenDatabasesTool: import("../../jxa/types.js").McpTool;

package/dist/tools/database/get-open-databases.js

@@ -0,0 +1,32 @@
+/**
+ * get-open-databases.ts — List all currently open databases in DEVONthink.
+ *
+ * Returns uuid, name, path, and record count for each open database.
+ */
+import { z } from "zod";
+import { defineTool } from "../../jxa/types.js";
+import { JXA_APP } from "../../jxa/helpers.js";
+export const getOpenDatabasesTool = defineTool({
+    name: "get_open_databases",
+    description: "Get a list of all currently open databases in DEVONthink.",
+    schema: z.object({}),
+    run: async (_args, executor) => {
+        const script = `
+${JXA_APP}
+var dbs = app.databases();
+var result = [];
+for (var i = 0; i < dbs.length; i++) {
+  var db = dbs[i];
+  result.push({
+    uuid: db.uuid(),
+    name: db.name(),
+    path: db.path()
+  });
+}
+JSON.stringify(result);
+`.trim();
+        const { stdout } = executor.run(script);
+        return JSON.parse(stdout);
+    },
+});
+//# sourceMappingURL=get-open-databases.js.map

package/dist/tools/database/get-open-databases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-open-databases.js","sourceRoot":"","sources":["../../../src/tools/database/get-open-databases.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;IAC7C,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,2DAA2D;IACxE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG;EACjB,OAAO;;;;;;;;;;;;CAYR,CAAC,IAAI,EAAE,CAAC;QAEL,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAItB,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/groups/get-selected-records.d.ts

@@ -0,0 +1,8 @@
+/**
+ * get-selected-records.ts — Get information about currently selected records.
+ *
+ * Returns summary properties for each record currently selected in the
+ * DEVONthink UI. Uses JXA_RECORD_SUMMARY for a lightweight property set
+ * suitable for lists.
+ */
+export declare const selectedRecordsTool: import("../../jxa/types.js").McpTool;

package/dist/tools/groups/get-selected-records.js

@@ -0,0 +1,30 @@
+/**
+ * get-selected-records.ts — Get information about currently selected records.
+ *
+ * Returns summary properties for each record currently selected in the
+ * DEVONthink UI. Uses JXA_RECORD_SUMMARY for a lightweight property set
+ * suitable for lists.
+ */
+import { z } from "zod";
+import { defineTool } from "../../jxa/types.js";
+import { JXA_APP, JXA_RECORD_SUMMARY } from "../../jxa/helpers.js";
+export const selectedRecordsTool = defineTool({
+    name: "selected_records",
+    description: "Get information about currently selected records in DEVONthink.",
+    schema: z.object({}),
+    run: async (_args, executor) => {
+        const script = `
+${JXA_APP}
+var records = app.selectedRecords();
+var result = [];
+for (var i = 0; i < records.length; i++) {
+  var record = records[i];
+  result.push(${JXA_RECORD_SUMMARY});
+}
+JSON.stringify(result);
+`.trim();
+        const { stdout } = executor.run(script);
+        return JSON.parse(stdout);
+    },
+});
+//# sourceMappingURL=get-selected-records.js.map

package/dist/tools/groups/get-selected-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-selected-records.js","sourceRoot":"","sources":["../../../src/tools/groups/get-selected-records.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;IAC5C,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,iEAAiE;IACnE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG;EACjB,OAAO;;;;;gBAKO,kBAAkB;;;CAGjC,CAAC,IAAI,EAAE,CAAC;QAEL,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAWtB,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/groups/list-group-content.d.ts

@@ -0,0 +1,8 @@
+/**
+ * list-group-content.ts — List the direct children of a DEVONthink group.
+ *
+ * If a UUID is supplied, that group is fetched directly. Otherwise the root
+ * of the current (or named) database is used. Returns an array of record
+ * summaries using the lightweight JXA_RECORD_SUMMARY property set.
+ */
+export declare const listGroupContentTool: import("../../jxa/types.js").McpTool;

package/dist/tools/groups/list-group-content.js

@@ -0,0 +1,65 @@
+/**
+ * list-group-content.ts — List the direct children of a DEVONthink group.
+ *
+ * If a UUID is supplied, that group is fetched directly. Otherwise the root
+ * of the current (or named) database is used. Returns an array of record
+ * summaries using the lightweight JXA_RECORD_SUMMARY property set.
+ */
+import { z } from "zod";
+import { defineTool } from "../../jxa/types.js";
+import { jxaLiteral } from "../../jxa/escape.js";
+import { JXA_APP, JXA_RESOLVE_DB, JXA_RECORD_SUMMARY, } from "../../jxa/helpers.js";
+export const listGroupContentTool = defineTool({
+    name: "list_group_content",
+    description: "Lists the content of a specific group in DEVONthink. " +
+        "Supply a group UUID to list any group directly, or omit uuid to list " +
+        "the root of the current (or named) database.",
+    schema: z.object({
+        uuid: z
+            .string()
+            .optional()
+            .describe("UUID of the group to list. If omitted, the database root is listed"),
+        databaseName: z
+            .string()
+            .optional()
+            .describe("Name of the database to use when resolving the root group. " +
+            "If omitted, the current database is used. Ignored when uuid is provided"),
+    }),
+    run: async (args, executor) => {
+        const { uuid, databaseName } = args;
+        const script = `
+      ${JXA_APP}
+      var uuid = ${jxaLiteral(uuid ?? null)};
+      var dbName = ${jxaLiteral(databaseName ?? null)};
+
+      var group;
+      if (uuid) {
+        // Fetch the group directly by UUID
+        group = app.getRecordWithUuid(uuid);
+        if (!group || !group.uuid()) {
+          throw new Error("Group not found for UUID: " + uuid);
+        }
+      } else {
+        // Fall back to the database root
+        ${JXA_RESOLVE_DB}
+        group = db.root();
+        if (!group || !group.uuid()) {
+          throw new Error("Could not retrieve database root");
+        }
+      }
+
+      // List the direct children
+      var children = group.children();
+      var result = [];
+      for (var i = 0; i < children.length; i++) {
+        var record = children[i];
+        result.push(${JXA_RECORD_SUMMARY});
+      }
+
+      JSON.stringify(result);
+    `;
+        const result = executor.run(script);
+        return JSON.parse(result.stdout);
+    },
+});
+//# sourceMappingURL=list-group-content.js.map

package/dist/tools/groups/list-group-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-group-content.js","sourceRoot":"","sources":["../../../src/tools/groups/list-group-content.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,OAAO,EACP,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;IAC7C,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,uDAAuD;QACvD,uEAAuE;QACvE,8CAA8C;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,oEAAoE,CACrE;QACH,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,6DAA6D;YAC7D,yEAAyE,CAC1E;KACJ,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC5B,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;QAEpC,MAAM,MAAM,GAAG;QACX,OAAO;mBACI,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC;qBACtB,UAAU,CAAC,YAAY,IAAI,IAAI,CAAC;;;;;;;;;;;UAW3C,cAAc;;;;;;;;;;;;sBAYF,kBAAkB;;;;KAInC,CAAC;QAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAW7B,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * tools/index.ts — Barrel export of all 33 MCP tools.
+ *
+ * Collects all tools into a single allTools array for registration
+ * with the MCP server.
+ */
+import type { McpTool } from "../jxa/types.js";
+/** All 33 tools in registration order */
+export declare const allTools: McpTool[];

package/dist/tools/index.js

@@ -0,0 +1,87 @@
+/**
+ * tools/index.ts — Barrel export of all 33 MCP tools.
+ *
+ * Collects all tools into a single allTools array for registration
+ * with the MCP server.
+ */
+// Application
+import { isRunningTool } from "./application/is-running.js";
+// Database
+import { getOpenDatabasesTool } from "./database/get-open-databases.js";
+import { currentDatabaseTool } from "./database/get-current-database.js";
+// Records
+import { getRecordByIdTool } from "./records/get-record-by-id.js";
+import { getRecordPropertiesTool } from "./records/get-record-properties.js";
+import { getRecordContentTool } from "./records/get-record-content.js";
+import { createRecordTool } from "./records/create-record.js";
+import { deleteRecordTool } from "./records/delete-record.js";
+import { updateRecordContentTool } from "./records/update-record-content.js";
+import { setRecordPropertiesTool } from "./records/set-record-properties.js";
+import { renameRecordTool } from "./records/rename-record.js";
+import { moveRecordTool } from "./records/move-record.js";
+import { replicateRecordTool } from "./records/replicate-record.js";
+import { duplicateRecordTool } from "./records/duplicate-record.js";
+import { convertRecordTool } from "./records/convert-record.js";
+// Groups
+import { listGroupContentTool } from "./groups/list-group-content.js";
+import { selectedRecordsTool } from "./groups/get-selected-records.js";
+// Search
+import { searchTool } from "./search/search.js";
+import { lookupRecordTool } from "./search/lookup-record.js";
+// Tags
+import { addTagsTool } from "./tags/add-tags.js";
+import { removeTagsTool } from "./tags/remove-tags.js";
+// Web
+import { createFromUrlTool } from "./web/create-from-url.js";
+// Intelligence
+import { classifyTool } from "./intelligence/classify.js";
+import { compareTool } from "./intelligence/compare.js";
+// AI
+import { askAiAboutDocumentsTool } from "./ai/ask-ai-about-documents.js";
+import { checkAiHealthTool } from "./ai/check-ai-health.js";
+import { createSummaryDocumentTool } from "./ai/create-summary-document.js";
+import { getAiToolDocumentationTool } from "./ai/get-ai-tool-documentation.js";
+// Custom (our extensions, not from upstream)
+import { listSmartGroupsTool } from "./custom/list-smart-groups.js";
+import { listSmartRulesTool } from "./custom/list-smart-rules.js";
+import { parseEmlHeadersTool } from "./custom/parse-eml-headers.js";
+import { getColumnLayoutTool, copyColumnLayoutTool } from "./custom/column-layout.js";
+/** All 33 tools in registration order */
+export const allTools = [
+    // Core (28 tools matching upstream API surface)
+    isRunningTool,
+    createRecordTool,
+    deleteRecordTool,
+    moveRecordTool,
+    getRecordPropertiesTool,
+    getRecordByIdTool,
+    searchTool,
+    lookupRecordTool,
+    createFromUrlTool,
+    getOpenDatabasesTool,
+    currentDatabaseTool,
+    selectedRecordsTool,
+    listGroupContentTool,
+    getRecordContentTool,
+    renameRecordTool,
+    addTagsTool,
+    removeTagsTool,
+    classifyTool,
+    compareTool,
+    replicateRecordTool,
+    duplicateRecordTool,
+    convertRecordTool,
+    updateRecordContentTool,
+    setRecordPropertiesTool,
+    askAiAboutDocumentsTool,
+    checkAiHealthTool,
+    createSummaryDocumentTool,
+    getAiToolDocumentationTool,
+    // Custom extensions (5 tools)
+    listSmartGroupsTool,
+    listSmartRulesTool,
+    parseEmlHeadersTool,
+    getColumnLayoutTool,
+    copyColumnLayoutTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/tools/intelligence/classify.d.ts

@@ -0,0 +1,8 @@
+/**
+ * classify.ts — Get DEVONthink's classification proposals for a record.
+ *
+ * Returns an array of suggested destination groups with their scores,
+ * ordered by relevance. DEVONthink's classifier uses content analysis
+ * and/or tag comparison depending on the comparison option.
+ */
+export declare const classifyTool: import("../../jxa/types.js").McpTool;

package/dist/tools/intelligence/classify.js

@@ -0,0 +1,83 @@
+/**
+ * classify.ts — Get DEVONthink's classification proposals for a record.
+ *
+ * Returns an array of suggested destination groups with their scores,
+ * ordered by relevance. DEVONthink's classifier uses content analysis
+ * and/or tag comparison depending on the comparison option.
+ */
+import { z } from "zod";
+import { defineTool } from "../../jxa/types.js";
+import { jxaLiteral } from "../../jxa/escape.js";
+import { JXA_APP } from "../../jxa/helpers.js";
+const COMPARISON_VALUES = ["data comparison", "tags comparison"];
+export const classifyTool = defineTool({
+    name: "classify",
+    description: "Get classification proposals for a DEVONthink record.",
+    schema: z.object({
+        recordUuid: z.string().describe("UUID of the record to classify"),
+        databaseName: z
+            .string()
+            .optional()
+            .describe("Database name (optional, for disambiguation)"),
+        comparison: z
+            .enum(COMPARISON_VALUES)
+            .optional()
+            .describe("Comparison mode: 'data comparison' (content-based) or 'tags comparison'"),
+        tags: z
+            .boolean()
+            .optional()
+            .describe("Include tag-based proposals in the results"),
+    }),
+    run: async (args, executor) => {
+        const { recordUuid, databaseName, comparison, tags } = args;
+        const script = `
+      ${JXA_APP}
+      var uuid = ${jxaLiteral(recordUuid)};
+      var dbName = ${jxaLiteral(databaseName ?? null)};
+      var comparison = ${jxaLiteral(comparison ?? null)};
+      var includeTags = ${jxaLiteral(tags ?? false)};
+
+      var record = app.getRecordWithUuid(uuid);
+      if (!record || !record.uuid()) throw new Error("Record not found for UUID: " + uuid);
+
+      // Build classify options
+      var opts = {};
+      if (comparison) opts["comparison"] = comparison;
+      if (includeTags) opts["tags"] = true;
+
+      var proposals;
+      try {
+        proposals = app.classify(record, opts);
+      } catch(e) {
+        // Fallback: try without options (older DEVONthink API)
+        try {
+          proposals = app.classify(record);
+        } catch(e2) {
+          proposals = [];
+        }
+      }
+
+      if (!proposals || proposals.length === 0) {
+        JSON.stringify([]);
+      } else {
+        var results = proposals.map(function(proposal) {
+          try {
+            return {
+              uuid: proposal.uuid ? proposal.uuid() : null,
+              name: proposal.name ? proposal.name() : null,
+              location: proposal.location ? proposal.location() : null,
+              database: proposal.database ? proposal.database().name() : null,
+              score: proposal.score ? proposal.score() : null
+            };
+          } catch(e) {
+            return { raw: String(proposal) };
+          }
+        });
+        JSON.stringify(results);
+      }
+    `;
+        const result = executor.run(script);
+        return JSON.parse(result.stdout);
+    },
+});
+//# sourceMappingURL=classify.js.map

package/dist/tools/intelligence/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../../src/tools/intelligence/classify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,MAAM,iBAAiB,GAAG,CAAC,iBAAiB,EAAE,iBAAiB,CAAU,CAAC;AAE1E,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;IACrC,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,uDAAuD;IACpE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QACjE,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8CAA8C,CAAC;QAC3D,UAAU,EAAE,CAAC;aACV,IAAI,CAAC,iBAAiB,CAAC;aACvB,QAAQ,EAAE;aACV,QAAQ,CACP,yEAAyE,CAC1E;QACH,IAAI,EAAE,CAAC;aACJ,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,4CAA4C,CAAC;KAC1D,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC5B,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAE5D,MAAM,MAAM,GAAG;QACX,OAAO;mBACI,UAAU,CAAC,UAAU,CAAC;qBACpB,UAAU,CAAC,YAAY,IAAI,IAAI,CAAC;yBAC5B,UAAU,CAAC,UAAU,IAAI,IAAI,CAAC;0BAC7B,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwC9C,CAAC;QAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/intelligence/compare.d.ts

@@ -0,0 +1,8 @@
+/**
+ * compare.ts — Compare DEVONthink records for content similarity.
+ *
+ * When compareWithUuid is provided, performs a pairwise comparison between
+ * two specific records. Otherwise returns similar records for the source record
+ * (similar to "See Also" in DEVONthink). Results are ordered by similarity score.
+ */
+export declare const compareTool: import("../../jxa/types.js").McpTool;

package/dist/tools/intelligence/compare.js

@@ -0,0 +1,121 @@
+/**
+ * compare.ts — Compare DEVONthink records for content similarity.
+ *
+ * When compareWithUuid is provided, performs a pairwise comparison between
+ * two specific records. Otherwise returns similar records for the source record
+ * (similar to "See Also" in DEVONthink). Results are ordered by similarity score.
+ */
+import { z } from "zod";
+import { defineTool } from "../../jxa/types.js";
+import { jxaLiteral } from "../../jxa/escape.js";
+import { JXA_APP } from "../../jxa/helpers.js";
+const COMPARISON_VALUES = ["data comparison", "tags comparison"];
+export const compareTool = defineTool({
+    name: "compare",
+    description: "Compare DEVONthink records for similarities.",
+    schema: z.object({
+        recordUuid: z
+            .string()
+            .describe("UUID of the source record to compare"),
+        compareWithUuid: z
+            .string()
+            .optional()
+            .describe("UUID of a second record to compare against; if omitted, returns similar records"),
+        databaseName: z
+            .string()
+            .optional()
+            .describe("Database name (optional, for disambiguation)"),
+        comparison: z
+            .enum(COMPARISON_VALUES)
+            .optional()
+            .describe("Comparison mode: 'data comparison' (content-based) or 'tags comparison'"),
+    }),
+    run: async (args, executor) => {
+        const { recordUuid, compareWithUuid, databaseName, comparison } = args;
+        const script = `
+      ${JXA_APP}
+      var uuid = ${jxaLiteral(recordUuid)};
+      var compareWithUuid = ${jxaLiteral(compareWithUuid ?? null)};
+      var dbName = ${jxaLiteral(databaseName ?? null)};
+      var comparison = ${jxaLiteral(comparison ?? null)};
+
+      var record = app.getRecordWithUuid(uuid);
+      if (!record || !record.uuid()) throw new Error("Record not found for UUID: " + uuid);
+
+      var opts = {};
+      if (comparison) opts["comparison"] = comparison;
+
+      if (compareWithUuid) {
+        // Pairwise comparison between two specific records
+        var recordB = app.getRecordWithUuid(compareWithUuid);
+        if (!recordB || !recordB.uuid()) throw new Error("Comparison record not found for UUID: " + compareWithUuid);
+
+        var score = null;
+        try {
+          // Try compareContent which returns a score
+          score = app.compareContent(record, recordB, opts);
+        } catch(e) {
+          try {
+            score = app.compare(record, {to: recordB, comparison: comparison || "data comparison"});
+          } catch(e2) {
+            score = null;
+          }
+        }
+
+        JSON.stringify({
+          recordA: {
+            uuid: record.uuid(),
+            name: record.name(),
+            database: record.database().name()
+          },
+          recordB: {
+            uuid: recordB.uuid(),
+            name: recordB.name(),
+            database: recordB.database().name()
+          },
+          score: score,
+          comparison: comparison || "data comparison"
+        });
+
+      } else {
+        // Get similar records (See Also)
+        var similar = null;
+        try {
+          similar = app.compare(record, opts);
+        } catch(e) {
+          try {
+            similar = app.seeAlso(record);
+          } catch(e2) {
+            similar = [];
+          }
+        }
+
+        if (!similar || similar.length === 0) {
+          JSON.stringify([]);
+        } else {
+          var results = similar.map(function(r) {
+            try {
+              return {
+                uuid: r.uuid ? r.uuid() : null,
+                name: r.name ? r.name() : null,
+                type: r.type ? r.type() : null,
+                location: r.location ? r.location() : null,
+                database: r.database ? r.database().name() : null,
+                score: r.score ? r.score() : null,
+                modificationDate: r.modificationDate && r.modificationDate()
+                  ? r.modificationDate().toISOString()
+                  : null
+              };
+            } catch(e) {
+              return { raw: String(r) };
+            }
+          });
+          JSON.stringify(results);
+        }
+      }
+    `;
+        const result = executor.run(script);
+        return JSON.parse(result.stdout);
+    },
+});
+//# sourceMappingURL=compare.js.map

package/dist/tools/intelligence/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../../src/tools/intelligence/compare.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,MAAM,iBAAiB,GAAG,CAAC,iBAAiB,EAAE,iBAAiB,CAAU,CAAC;AAE1E,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;IACpC,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,8CAA8C;IAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,CAAC,sCAAsC,CAAC;QACnD,eAAe,EAAE,CAAC;aACf,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,iFAAiF,CAClF;QACH,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8CAA8C,CAAC;QAC3D,UAAU,EAAE,CAAC;aACV,IAAI,CAAC,iBAAiB,CAAC;aACvB,QAAQ,EAAE;aACV,QAAQ,CACP,yEAAyE,CAC1E;KACJ,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC5B,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAEvE,MAAM,MAAM,GAAG;QACX,OAAO;mBACI,UAAU,CAAC,UAAU,CAAC;8BACX,UAAU,CAAC,eAAe,IAAI,IAAI,CAAC;qBAC5C,UAAU,CAAC,YAAY,IAAI,IAAI,CAAC;yBAC5B,UAAU,CAAC,UAAU,IAAI,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4ElD,CAAC;QAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/records/convert-record.d.ts

@@ -0,0 +1,10 @@
+/**
+ * convert-record.ts — Convert a DEVONthink record to a different format.
+ *
+ * Creates a new record in the target format. The original record is unaffected.
+ * If destinationGroupUuid is provided, the new record is placed in that group;
+ * otherwise it is placed in the same group as the original.
+ *
+ * Uses app.convert({record: record, to: format}) — the converted record is a new object.
+ */
+export declare const convertRecordTool: import("../../jxa/types.js").McpTool;

package/dist/tools/records/convert-record.js

@@ -0,0 +1,77 @@
+/**
+ * convert-record.ts — Convert a DEVONthink record to a different format.
+ *
+ * Creates a new record in the target format. The original record is unaffected.
+ * If destinationGroupUuid is provided, the new record is placed in that group;
+ * otherwise it is placed in the same group as the original.
+ *
+ * Uses app.convert({record: record, to: format}) — the converted record is a new object.
+ */
+import { z } from "zod";
+import { defineTool } from "../../jxa/types.js";
+import { jxaLiteral } from "../../jxa/escape.js";
+import { JXA_APP, JXA_RESOLVE_DB, JXA_RESOLVE_RECORD, JXA_RECORD_PROPS } from "../../jxa/helpers.js";
+const CONVERT_FORMATS = [
+    "bookmark",
+    "simple",
+    "rich",
+    "note",
+    "markdown",
+    "HTML",
+    "webarchive",
+    "PDF document",
+    "single page PDF document",
+    "PDF without annotations",
+    "PDF with annotations burnt in",
+];
+export const convertRecordTool = defineTool({
+    name: "convert_record",
+    description: "Convert a record to a different format, creating a new record. " +
+        "The original record is not modified. " +
+        "Supported formats: bookmark, simple, rich, note, markdown, HTML, webarchive, " +
+        "'PDF document', 'single page PDF document', 'PDF without annotations', 'PDF with annotations burnt in'. " +
+        "Optionally place the converted record in a specific destination group. " +
+        "Returns the properties of the newly created converted record.",
+    schema: z.object({
+        uuid: z.string().optional().describe("UUID of the record to convert"),
+        recordId: z.number().int().nonnegative().optional().describe("Numeric record ID (requires databaseName)"),
+        recordPath: z.string().optional().describe("Record path within the database (requires databaseName)"),
+        format: z.enum(CONVERT_FORMATS).describe("Target format for conversion: bookmark, simple, rich, note, markdown, HTML, webarchive, " +
+            "'PDF document', 'single page PDF document', 'PDF without annotations', or 'PDF with annotations burnt in'"),
+        destinationGroupUuid: z.string().optional().describe("UUID of the destination group for the converted record (optional)"),
+        databaseName: z.string().optional().describe("Database name (required for recordId or recordPath lookups)"),
+    }),
+    run: async (args, executor) => {
+        const { uuid, recordId, recordPath, format, destinationGroupUuid, databaseName } = args;
+        const script = `
+      ${JXA_APP}
+      var uuid = ${jxaLiteral(uuid ?? null)};
+      var recordId = ${jxaLiteral(recordId ?? null)};
+      var recordPath = ${jxaLiteral(recordPath ?? null)};
+      var recordName = null;
+      var dbName = ${jxaLiteral(databaseName ?? null)};
+      var targetFormat = ${jxaLiteral(format)};
+      var destinationGroupUuid = ${jxaLiteral(destinationGroupUuid ?? null)};
+
+      ${JXA_RESOLVE_DB}
+      ${JXA_RESOLVE_RECORD}
+
+      var convertOpts = {record: record, to: targetFormat};
+
+      if (destinationGroupUuid) {
+        var destGroup = app.getRecordWithUuid(destinationGroupUuid);
+        if (!destGroup || !destGroup.uuid()) throw new Error("Destination group not found for UUID: " + destinationGroupUuid);
+        convertOpts.in = destGroup;
+      }
+
+      var converted = app.convert(convertOpts);
+      if (!converted || !converted.uuid()) throw new Error("Convert operation failed");
+
+      var record = converted;
+      JSON.stringify(${JXA_RECORD_PROPS});
+    `;
+        const result = executor.run(script);
+        return JSON.parse(result.stdout);
+    },
+});
+//# sourceMappingURL=convert-record.js.map

package/dist/tools/records/convert-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-record.js","sourceRoot":"","sources":["../../../src/tools/records/convert-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAErG,MAAM,eAAe,GAAG;IACtB,UAAU;IACV,QAAQ;IACR,MAAM;IACN,MAAM;IACN,UAAU;IACV,MAAM;IACN,YAAY;IACZ,cAAc;IACd,0BAA0B;IAC1B,yBAAyB;IACzB,+BAA+B;CACvB,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,iEAAiE;QACjE,uCAAuC;QACvC,+EAA+E;QAC/E,0GAA0G;QAC1G,yEAAyE;QACzE,+DAA+D;IACjE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACrE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QACzG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;QACrG,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,CACtC,0FAA0F;YAC1F,2GAA2G,CAC5G;QACD,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;QACzH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;KAC5G,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC5B,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;QAExF,MAAM,MAAM,GAAG;QACX,OAAO;mBACI,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC;uBACpB,UAAU,CAAC,QAAQ,IAAI,IAAI,CAAC;yBAC1B,UAAU,CAAC,UAAU,IAAI,IAAI,CAAC;;qBAElC,UAAU,CAAC,YAAY,IAAI,IAAI,CAAC;2BAC1B,UAAU,CAAC,MAAM,CAAC;mCACV,UAAU,CAAC,oBAAoB,IAAI,IAAI,CAAC;;QAEnE,cAAc;QACd,kBAAkB;;;;;;;;;;;;;;uBAcH,gBAAgB;KAClC,CAAC;QAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/records/create-record.d.ts

@@ -0,0 +1,8 @@
+/**
+ * create-record.ts — Create a new record in DEVONthink.
+ *
+ * Creates a record in the specified database and parent group.
+ * If parentGroupUuid is provided, the record is created inside that group.
+ * If no parentGroupUuid, the record is created in the root of the database.
+ */
+export declare const createRecordTool: import("../../jxa/types.js").McpTool;