@tekmidian/devon 3.0.0

package/dist/tools/records/set-record-properties.js

@@ -0,0 +1,76 @@
+/**
+ * set-record-properties.ts — Set properties on a DEVONthink record.
+ *
+ * Supports setting: comment, flagged, locking, and the six exclude* flags
+ * (excludeFromClassification, excludeFromSearch, excludeFromSeeAlso,
+ *  excludeFromTagging, excludeFromWikiLinking, excludeFromChat).
+ *
+ * Resolves the record via uuid, recordId, or recordPath before setting props.
+ */
+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";
+export const setRecordPropertiesTool = defineTool({
+    name: "set_record_properties",
+    description: "Set properties on a DEVONthink record. " +
+        "Settable properties: comment, flag (flagged), locked (locking), " +
+        "excludeFromChat, excludeFromClassification, excludeFromSearch, " +
+        "excludeFromSeeAlso, excludeFromTagging, excludeFromWikiLinking. " +
+        "Resolve record by uuid (preferred), recordId + databaseName, or recordPath + databaseName. " +
+        "Only provided properties are updated; others remain unchanged.",
+    schema: z.object({
+        uuid: z.string().optional().describe("UUID of the record"),
+        recordId: z.number().int().nonnegative().optional().describe("Numeric record ID (requires databaseName)"),
+        recordPath: z.string().optional().describe("Record path within the database (requires databaseName)"),
+        databaseName: z.string().optional().describe("Database name"),
+        comment: z.string().optional().describe("Set the record comment/annotation"),
+        flag: z.boolean().optional().describe("Set the flagged (starred) state"),
+        locked: z.boolean().optional().describe("Set the locked (locking) state"),
+        excludeFromChat: z.boolean().optional().describe("Exclude record from AI chat"),
+        excludeFromClassification: z.boolean().optional().describe("Exclude record from auto-classification"),
+        excludeFromSearch: z.boolean().optional().describe("Exclude record from search results"),
+        excludeFromSeeAlso: z.boolean().optional().describe("Exclude record from See Also suggestions"),
+        excludeFromTagging: z.boolean().optional().describe("Exclude record from auto-tagging"),
+        excludeFromWikiLinking: z.boolean().optional().describe("Exclude record from wiki-style auto-linking"),
+    }),
+    run: async (args, executor) => {
+        const { uuid, recordId, recordPath, databaseName, comment, flag, locked, excludeFromChat, excludeFromClassification, excludeFromSearch, excludeFromSeeAlso, excludeFromTagging, excludeFromWikiLinking, } = 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)};
+
+      ${JXA_RESOLVE_DB}
+      ${JXA_RESOLVE_RECORD}
+
+      var comment = ${jxaLiteral(comment ?? null)};
+      var flag = ${jxaLiteral(flag ?? null)};
+      var locked = ${jxaLiteral(locked ?? null)};
+      var excludeFromChat = ${jxaLiteral(excludeFromChat ?? null)};
+      var excludeFromClassification = ${jxaLiteral(excludeFromClassification ?? null)};
+      var excludeFromSearch = ${jxaLiteral(excludeFromSearch ?? null)};
+      var excludeFromSeeAlso = ${jxaLiteral(excludeFromSeeAlso ?? null)};
+      var excludeFromTagging = ${jxaLiteral(excludeFromTagging ?? null)};
+      var excludeFromWikiLinking = ${jxaLiteral(excludeFromWikiLinking ?? null)};
+
+      if (comment !== null) record.comment = comment;
+      if (flag !== null) record.flag = flag;
+      if (locked !== null) record.locking = locked;
+      if (excludeFromChat !== null) record.excludeFromChat = excludeFromChat;
+      if (excludeFromClassification !== null) record.excludeFromClassification = excludeFromClassification;
+      if (excludeFromSearch !== null) record.excludeFromSearch = excludeFromSearch;
+      if (excludeFromSeeAlso !== null) record.excludeFromSeeAlso = excludeFromSeeAlso;
+      if (excludeFromTagging !== null) record.excludeFromTagging = excludeFromTagging;
+      if (excludeFromWikiLinking !== null) record.excludeFromWikiLinking = excludeFromWikiLinking;
+
+      JSON.stringify(${JXA_RECORD_PROPS});
+    `;
+        const result = executor.run(script);
+        return JSON.parse(result.stdout);
+    },
+});
+//# sourceMappingURL=set-record-properties.js.map

package/dist/tools/records/set-record-properties.js.map

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

package/dist/tools/records/update-record-content.d.ts

@@ -0,0 +1,7 @@
+/**
+ * update-record-content.ts — Update the text content of a DEVONthink record.
+ *
+ * Sets plainText() for text-based records or source() for HTML/Markdown records.
+ * UUID is required. Returns confirmation with uuid and name.
+ */
+export declare const updateRecordContentTool: import("../../jxa/types.js").McpTool;

package/dist/tools/records/update-record-content.js

@@ -0,0 +1,43 @@
+/**
+ * update-record-content.ts — Update the text content of a DEVONthink record.
+ *
+ * Sets plainText() for text-based records or source() for HTML/Markdown records.
+ * UUID is required. Returns confirmation with uuid and name.
+ */
+import { z } from "zod";
+import { defineTool } from "../../jxa/types.js";
+import { jxaLiteral } from "../../jxa/escape.js";
+import { JXA_APP } from "../../jxa/helpers.js";
+export const updateRecordContentTool = defineTool({
+    name: "update_record_content",
+    description: "Updates the content of an existing record in DEVONthink. " +
+        "For text records, sets plain text. For HTML/Markdown records, sets the source. " +
+        "UUID is required. Returns updated: true with uuid and name on success.",
+    schema: z.object({
+        uuid: z.string().describe("UUID of the record to update"),
+        content: z.string().describe("New content to write to the record"),
+    }),
+    run: async (args, executor) => {
+        const { uuid, content } = args;
+        const script = `
+      ${JXA_APP}
+      var uuid = ${jxaLiteral(uuid)};
+      var content = ${jxaLiteral(content)};
+
+      var record = app.getRecordWithUuid(uuid);
+      if (!record || !record.uuid()) throw new Error("Record not found for UUID: " + uuid);
+
+      var recordType = record.type();
+      if (recordType === "html" || recordType === "markdown" || recordType === "feed") {
+        record.source = content;
+      } else {
+        record.plainText = content;
+      }
+
+      JSON.stringify({ updated: true, uuid: record.uuid(), name: record.name() });
+    `;
+        const result = executor.run(script);
+        return JSON.parse(result.stdout);
+    },
+});
+//# sourceMappingURL=update-record-content.js.map

package/dist/tools/records/update-record-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-record-content.js","sourceRoot":"","sources":["../../../src/tools/records/update-record-content.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;IAChD,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,2DAA2D;QAC3D,iFAAiF;QACjF,wEAAwE;IAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACzD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;KACnE,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC5B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAE/B,MAAM,MAAM,GAAG;QACX,OAAO;mBACI,UAAU,CAAC,IAAI,CAAC;sBACb,UAAU,CAAC,OAAO,CAAC;;;;;;;;;;;;;KAapC,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/search/lookup-record.d.ts

@@ -0,0 +1,7 @@
+/**
+ * lookup-record.ts — Look up DEVONthink records by a specific attribute.
+ *
+ * Supports looking up by filename, path, url, tags, comment, or contentHash.
+ * Returns an array of matching record summaries, optionally limited.
+ */
+export declare const lookupRecordTool: import("../../jxa/types.js").McpTool;

package/dist/tools/search/lookup-record.js

@@ -0,0 +1,160 @@
+/**
+ * lookup-record.ts — Look up DEVONthink records by a specific attribute.
+ *
+ * Supports looking up by filename, path, url, tags, comment, or contentHash.
+ * Returns an array of matching record summaries, optionally limited.
+ */
+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";
+const LOOKUP_TYPE_VALUES = [
+    "filename",
+    "path",
+    "url",
+    "tags",
+    "comment",
+    "contentHash",
+];
+export const lookupRecordTool = defineTool({
+    name: "lookup_record",
+    description: "Look up records in DEVONthink by a specific attribute.",
+    schema: z.object({
+        lookupType: z
+            .enum(LOOKUP_TYPE_VALUES)
+            .describe("The attribute to look up by"),
+        value: z
+            .string()
+            .describe("The value to match against the specified attribute"),
+        tags: z
+            .array(z.string())
+            .optional()
+            .describe("Additional tags to match (only used when lookupType is 'tags')"),
+        matchAnyTag: z
+            .boolean()
+            .optional()
+            .describe("When true, match records that have ANY of the specified tags; " +
+            "when false (default), match records that have ALL tags"),
+        databaseName: z
+            .string()
+            .optional()
+            .describe("Limit lookup to this database; uses all open databases if omitted"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Maximum number of results to return"),
+    }),
+    run: async (args, executor) => {
+        const { lookupType, value, tags, matchAnyTag, databaseName, limit } = args;
+        // Merge value into tags list when lookupType is 'tags'
+        const tagList = lookupType === "tags" ? [value, ...(tags ?? [])] : (tags ?? []);
+        const script = `
+      ${JXA_APP}
+      var lookupType = ${jxaLiteral(lookupType)};
+      var value = ${jxaLiteral(value)};
+      var tagList = ${jxaLiteral(tagList)};
+      var matchAnyTag = ${jxaLiteral(matchAnyTag ?? false)};
+      var dbName = ${jxaLiteral(databaseName ?? null)};
+      var limit = ${jxaLiteral(limit ?? null)};
+
+      ${JXA_RESOLVE_DB}
+
+      var results = [];
+
+      if (lookupType === "filename") {
+        // Search by name across the scoped database or all databases
+        var searchQuery = "name:" + value;
+        var searchOpts = {};
+        if (db) searchOpts["in"] = db.root();
+        results = app.search(searchQuery, searchOpts);
+        // Further filter to exact filename matches
+        results = results.filter(function(r) {
+          return r.name() === value;
+        });
+
+      } else if (lookupType === "path") {
+        // Look up by filesystem path
+        if (db) {
+          var rec = app.getRecordAt(value, {in: db});
+          if (rec && rec.uuid()) results = [rec];
+        } else {
+          // Try each open database
+          var dbs = app.databases();
+          for (var i = 0; i < dbs.length; i++) {
+            try {
+              var r = app.getRecordAt(value, {in: dbs[i]});
+              if (r && r.uuid()) { results.push(r); break; }
+            } catch(e) {}
+          }
+        }
+
+      } else if (lookupType === "url") {
+        // Search by URL
+        var urlResults = app.lookupRecordsWithURL(value);
+        if (urlResults) results = urlResults;
+
+      } else if (lookupType === "tags") {
+        // Look up by tags using DEVONthink's tag lookup
+        if (matchAnyTag) {
+          // Union: results that match any of the tags
+          var seen = {};
+          for (var t = 0; t < tagList.length; t++) {
+            var tagResults = app.lookupRecordsWithTags([tagList[t]]);
+            if (tagResults) {
+              for (var j = 0; j < tagResults.length; j++) {
+                var u = tagResults[j].uuid();
+                if (!seen[u]) {
+                  seen[u] = true;
+                  results.push(tagResults[j]);
+                }
+              }
+            }
+          }
+        } else {
+          // Intersection: results that match all of the tags
+          results = app.lookupRecordsWithTags(tagList) || [];
+        }
+
+      } else if (lookupType === "comment") {
+        // Search by comment using DEVONthink search
+        var commentQuery = "comment:" + value;
+        var commentOpts = {};
+        if (db) commentOpts["in"] = db.root();
+        results = app.search(commentQuery, commentOpts);
+        // Filter to actual comment matches
+        results = results.filter(function(r) {
+          var c = r.comment();
+          return c && c.indexOf(value) !== -1;
+        });
+
+      } else if (lookupType === "contentHash") {
+        // Look up by content hash (MD5/SHA)
+        var hashResults = app.lookupRecordsWithContentHash(value);
+        if (hashResults) results = hashResults;
+      }
+
+      // Filter by database if specified and not already scoped
+      if (dbName && lookupType !== "filename" && lookupType !== "path" && lookupType !== "comment") {
+        results = results.filter(function(r) {
+          try { return r.database().name() === dbName; } catch(e) { return false; }
+        });
+      }
+
+      // Apply limit
+      if (limit && limit > 0 && results.length > limit) {
+        results = results.slice(0, limit);
+      }
+
+      var summaries = results.map(function(record) {
+        return ${JXA_RECORD_SUMMARY};
+      });
+
+      JSON.stringify(summaries);
+    `;
+        const result = executor.run(script);
+        return JSON.parse(result.stdout);
+    },
+});
+//# sourceMappingURL=lookup-record.js.map

package/dist/tools/search/lookup-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-record.js","sourceRoot":"","sources":["../../../src/tools/search/lookup-record.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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,kBAAkB,GAAG;IACzB,UAAU;IACV,MAAM;IACN,KAAK;IACL,MAAM;IACN,SAAS;IACT,aAAa;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;IACzC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,wDAAwD;IACrE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,CAAC;aACV,IAAI,CAAC,kBAAkB,CAAC;aACxB,QAAQ,CAAC,6BAA6B,CAAC;QAC1C,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,CAAC,oDAAoD,CAAC;QACjE,IAAI,EAAE,CAAC;aACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,gEAAgE,CAAC;QAC7E,WAAW,EAAE,CAAC;aACX,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,gEAAgE;YAC9D,wDAAwD,CAC3D;QACH,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,mEAAmE,CAAC;QAChF,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,qCAAqC,CAAC;KACnD,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC5B,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAE3E,uDAAuD;QACvD,MAAM,OAAO,GAAG,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAEhF,MAAM,MAAM,GAAG;QACX,OAAO;yBACU,UAAU,CAAC,UAAU,CAAC;oBAC3B,UAAU,CAAC,KAAK,CAAC;sBACf,UAAU,CAAC,OAAO,CAAC;0BACf,UAAU,CAAC,WAAW,IAAI,KAAK,CAAC;qBACrC,UAAU,CAAC,YAAY,IAAI,IAAI,CAAC;oBACjC,UAAU,CAAC,KAAK,IAAI,IAAI,CAAC;;QAErC,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyFL,kBAAkB;;;;KAI9B,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/search/search.d.ts

@@ -0,0 +1,8 @@
+/**
+ * search.ts — Search DEVONthink records by query string with optional scope.
+ *
+ * Supports scoping to a specific group (by UUID, id, or path+database),
+ * filtering by record type, specifying comparison mode, and limiting results.
+ * Wildcards (* and ?) in the query are preserved as valid search operators.
+ */
+export declare const searchTool: import("../../jxa/types.js").McpTool;

package/dist/tools/search/search.js

@@ -0,0 +1,146 @@
+/**
+ * search.ts — Search DEVONthink records by query string with optional scope.
+ *
+ * Supports scoping to a specific group (by UUID, id, or path+database),
+ * filtering by record type, specifying comparison mode, and limiting results.
+ * Wildcards (* and ?) in the query are preserved as valid search operators.
+ */
+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";
+const RECORD_TYPE_VALUES = [
+    "group",
+    "markdown",
+    "PDF",
+    "bookmark",
+    "formatted note",
+    "txt",
+    "rtf",
+    "rtfd",
+    "webarchive",
+    "quicktime",
+    "picture",
+    "smart group",
+];
+const COMPARISON_VALUES = [
+    "no case",
+    "no umlauts",
+    "fuzzy",
+    "related",
+];
+export const searchTool = defineTool({
+    name: "search",
+    description: 'Search DEVONthink records. Examples: {"query": "invoice"} or ' +
+        '{"query": "project review", "groupPath": "/Meetings", "databaseName": "MyDB"}. ' +
+        "Note: groupPath requires databaseName and must be database-relative " +
+        '(e.g., "/Meetings" not "/MyDB/Meetings").',
+    schema: z.object({
+        query: z.string().describe("Search query (wildcards * and ? are supported)"),
+        groupUuid: z
+            .string()
+            .optional()
+            .describe("UUID of the group to search within"),
+        groupId: z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Numeric ID of the group to search within (requires databaseName)"),
+        groupPath: z
+            .string()
+            .optional()
+            .describe("Database-relative path of the group to search within (requires databaseName)"),
+        databaseName: z
+            .string()
+            .optional()
+            .describe("Database name (required for groupId or groupPath scoping)"),
+        useCurrentGroup: z
+            .boolean()
+            .optional()
+            .describe("Scope search to the currently selected group in DEVONthink"),
+        recordType: z
+            .enum(RECORD_TYPE_VALUES)
+            .optional()
+            .describe("Filter results to a specific record type"),
+        comparison: z
+            .enum(COMPARISON_VALUES)
+            .optional()
+            .describe("Comparison mode for the search"),
+        excludeSubgroups: z
+            .boolean()
+            .optional()
+            .describe("Exclude records from subgroups when scoping to a group"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Maximum number of results to return"),
+    }),
+    run: async (args, executor) => {
+        const { query, groupUuid, groupId, groupPath, databaseName, useCurrentGroup, recordType, comparison, excludeSubgroups, limit, } = args;
+        const script = `
+      ${JXA_APP}
+      var query = ${jxaLiteral(query)};
+      var groupUuid = ${jxaLiteral(groupUuid ?? null)};
+      var groupId = ${jxaLiteral(groupId ?? null)};
+      var groupPath = ${jxaLiteral(groupPath ?? null)};
+      var dbName = ${jxaLiteral(databaseName ?? null)};
+      var useCurrentGroup = ${jxaLiteral(useCurrentGroup ?? false)};
+      var recordType = ${jxaLiteral(recordType ?? null)};
+      var comparison = ${jxaLiteral(comparison ?? null)};
+      var excludeSubgroups = ${jxaLiteral(excludeSubgroups ?? false)};
+      var limit = ${jxaLiteral(limit ?? null)};
+
+      ${JXA_RESOLVE_DB}
+
+      // Resolve the search scope group if specified
+      var searchIn = null;
+      if (groupUuid) {
+        searchIn = app.getRecordWithUuid(groupUuid);
+        if (!searchIn || !searchIn.uuid()) throw new Error("Group not found for UUID: " + groupUuid);
+      } else if (typeof groupId === "number" && groupId >= 0) {
+        if (!db) throw new Error("databaseName is required when using groupId");
+        searchIn = db.getRecordAt(groupId);
+        if (!searchIn || !searchIn.uuid()) throw new Error("Group not found for ID: " + groupId);
+      } else if (groupPath) {
+        if (!db) throw new Error("databaseName is required when using groupPath");
+        searchIn = app.getRecordAt(groupPath, {in: db});
+        if (!searchIn || !searchIn.uuid()) throw new Error("Group not found at path: " + groupPath);
+      } else if (useCurrentGroup) {
+        searchIn = app.currentGroup();
+      }
+
+      // Build search options
+      var searchOpts = {};
+      if (searchIn) searchOpts["in"] = searchIn;
+      else if (db) searchOpts["in"] = db.root();
+      if (comparison) searchOpts["comparison"] = comparison;
+      if (excludeSubgroups) searchOpts["excludeSubgroups"] = true;
+
+      // Execute search
+      var results = app.search(query, searchOpts);
+
+      // Filter by record type if specified
+      if (recordType) {
+        results = results.filter(function(r) { return r.type() === recordType; });
+      }
+
+      // Apply limit
+      if (limit && limit > 0 && results.length > limit) {
+        results = results.slice(0, limit);
+      }
+
+      // Map to summaries
+      var summaries = results.map(function(record) {
+        return ${JXA_RECORD_SUMMARY};
+      });
+
+      JSON.stringify(summaries);
+    `;
+        const result = executor.run(script);
+        return JSON.parse(result.stdout);
+    },
+});
+//# sourceMappingURL=search.js.map

package/dist/tools/search/search.js.map

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

package/dist/tools/tags/add-tags.d.ts

@@ -0,0 +1,7 @@
+/**
+ * add-tags.ts — Add tags to a DEVONthink record.
+ *
+ * Retrieves the current tags on a record, merges the new tags (deduplicating),
+ * sets the updated tag list, and returns the record's updated tag state.
+ */
+export declare const addTagsTool: import("../../jxa/types.js").McpTool;

package/dist/tools/tags/add-tags.js

@@ -0,0 +1,47 @@
+/**
+ * add-tags.ts — Add tags to a DEVONthink record.
+ *
+ * Retrieves the current tags on a record, merges the new tags (deduplicating),
+ * sets the updated tag list, and returns the record's updated tag state.
+ */
+import { z } from "zod";
+import { defineTool } from "../../jxa/types.js";
+import { jxaLiteral } from "../../jxa/escape.js";
+import { JXA_APP } from "../../jxa/helpers.js";
+export const addTagsTool = defineTool({
+    name: "add_tags",
+    description: "Adds tags to a DEVONthink record.",
+    schema: z.object({
+        uuid: z.string().describe("UUID of the record to tag"),
+        tags: z.array(z.string()).min(1).describe("Tags to add to the record"),
+    }),
+    run: async (args, executor) => {
+        const { uuid, tags } = args;
+        const script = `
+      ${JXA_APP}
+      var uuid = ${jxaLiteral(uuid)};
+      var newTags = ${jxaLiteral(tags)};
+
+      var record = app.getRecordWithUuid(uuid);
+      if (!record || !record.uuid()) throw new Error("Record not found for UUID: " + uuid);
+
+      // Get current tags, merge new ones (deduplicating)
+      var currentTags = record.tags() || [];
+      var tagSet = {};
+      for (var i = 0; i < currentTags.length; i++) tagSet[currentTags[i]] = true;
+      for (var j = 0; j < newTags.length; j++) tagSet[newTags[j]] = true;
+      var merged = Object.keys(tagSet);
+
+      record.tags = merged;
+
+      JSON.stringify({
+        uuid: record.uuid(),
+        name: record.name(),
+        tags: record.tags()
+      });
+    `;
+        const result = executor.run(script);
+        return JSON.parse(result.stdout);
+    },
+});
+//# sourceMappingURL=add-tags.js.map

package/dist/tools/tags/add-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-tags.js","sourceRoot":"","sources":["../../../src/tools/tags/add-tags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;IACpC,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,mCAAmC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACtD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KACvE,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC5B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAE5B,MAAM,MAAM,GAAG;QACX,OAAO;mBACI,UAAU,CAAC,IAAI,CAAC;sBACb,UAAU,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;KAmBjC,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/tags/remove-tags.d.ts

@@ -0,0 +1,7 @@
+/**
+ * remove-tags.ts — Remove tags from a DEVONthink record.
+ *
+ * Retrieves the current tags on a record, filters out the specified tags,
+ * sets the updated tag list, and returns the record's updated tag state.
+ */
+export declare const removeTagsTool: import("../../jxa/types.js").McpTool;

package/dist/tools/tags/remove-tags.js

@@ -0,0 +1,53 @@
+/**
+ * remove-tags.ts — Remove tags from a DEVONthink record.
+ *
+ * Retrieves the current tags on a record, filters out the specified tags,
+ * sets the updated tag list, and returns the record's updated tag state.
+ */
+import { z } from "zod";
+import { defineTool } from "../../jxa/types.js";
+import { jxaLiteral } from "../../jxa/escape.js";
+import { JXA_APP } from "../../jxa/helpers.js";
+export const removeTagsTool = defineTool({
+    name: "remove_tags",
+    description: "Removes tags from a specific record in DEVONthink.",
+    schema: z.object({
+        uuid: z.string().describe("UUID of the record to remove tags from"),
+        tags: z.array(z.string()).min(1).describe("Tags to remove from the record"),
+        databaseName: z
+            .string()
+            .optional()
+            .describe("Database name (optional, for disambiguation)"),
+    }),
+    run: async (args, executor) => {
+        const { uuid, tags, databaseName } = args;
+        const script = `
+      ${JXA_APP}
+      var uuid = ${jxaLiteral(uuid)};
+      var tagsToRemove = ${jxaLiteral(tags)};
+      var dbName = ${jxaLiteral(databaseName ?? null)};
+
+      var record = app.getRecordWithUuid(uuid);
+      if (!record || !record.uuid()) throw new Error("Record not found for UUID: " + uuid);
+
+      // Build a set of tags to remove for O(1) lookup
+      var removeSet = {};
+      for (var i = 0; i < tagsToRemove.length; i++) removeSet[tagsToRemove[i]] = true;
+
+      // Filter current tags
+      var currentTags = record.tags() || [];
+      var updated = currentTags.filter(function(t) { return !removeSet[t]; });
+
+      record.tags = updated;
+
+      JSON.stringify({
+        uuid: record.uuid(),
+        name: record.name(),
+        tags: record.tags()
+      });
+    `;
+        const result = executor.run(script);
+        return JSON.parse(result.stdout);
+    },
+});
+//# sourceMappingURL=remove-tags.js.map

package/dist/tools/tags/remove-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-tags.js","sourceRoot":"","sources":["../../../src/tools/tags/remove-tags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACvC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,oDAAoD;IACjE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACnE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC3E,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8CAA8C,CAAC;KAC5D,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC5B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;QAE1C,MAAM,MAAM,GAAG;QACX,OAAO;mBACI,UAAU,CAAC,IAAI,CAAC;2BACR,UAAU,CAAC,IAAI,CAAC;qBACtB,UAAU,CAAC,YAAY,IAAI,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;KAoBhD,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/web/create-from-url.d.ts

@@ -0,0 +1,8 @@
+/**
+ * create-from-url.ts — Create a DEVONthink record from a web URL.
+ *
+ * Supports four capture formats: formatted_note, markdown, pdf, and web_document.
+ * Optionally places the new record in a specified group and supports readability
+ * mode, custom user-agent, referrer, and PDF pagination options.
+ */
+export declare const createFromUrlTool: import("../../jxa/types.js").McpTool;