@tekmidian/devon 3.0.0

package/dist/jxa/executor.js

@@ -0,0 +1,65 @@
+/**
+ * executor.ts — JXA (JavaScript for Automation) execution via osascript.
+ *
+ * Provides a JxaExecutor interface for testability (mock in tests)
+ * and an OsascriptExecutor implementation that shells out to osascript.
+ */
+import { execSync } from "node:child_process";
+import { shellQuote } from "./escape.js";
+/** Default buffer limit: 50 MB (prevents OOM on large DB queries) */
+const MAX_BUFFER = 50 * 1024 * 1024;
+/** Default timeout: 60 seconds */
+const DEFAULT_TIMEOUT = 60_000;
+/**
+ * Production executor that runs JXA via `osascript -l JavaScript`.
+ */
+export class OsascriptExecutor {
+    timeout;
+    maxBuffer;
+    constructor(opts) {
+        this.timeout = opts?.timeout ?? DEFAULT_TIMEOUT;
+        this.maxBuffer = opts?.maxBuffer ?? MAX_BUFFER;
+    }
+    run(script) {
+        try {
+            const stdout = execSync(`osascript -l JavaScript -e ${shellQuote(script)}`, {
+                encoding: "utf-8",
+                timeout: this.timeout,
+                maxBuffer: this.maxBuffer,
+                // Capture stderr separately so DEVONthink deprecation warnings don't crash
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            return { stdout: stdout.trimEnd(), stderr: "" };
+        }
+        catch (err) {
+            // execSync throws on non-zero exit. Extract stderr if available.
+            if (err && typeof err === "object" && "stderr" in err) {
+                const execErr = err;
+                const stderr = (typeof execErr.stderr === "string" ? execErr.stderr : "").trim();
+                const stdout = (typeof execErr.stdout === "string" ? execErr.stdout : "").trim();
+                // If we got stdout despite non-zero exit, the script may have succeeded
+                // but osascript returned a warning on stderr. Treat as success if stdout is non-empty.
+                if (stdout && stderr && !stderr.includes("Error")) {
+                    return { stdout, stderr };
+                }
+                throw new Error(stderr || execErr.message || "JXA execution failed");
+            }
+            throw err;
+        }
+    }
+}
+/** Singleton executor for production use */
+let defaultExecutor = null;
+export function getDefaultExecutor() {
+    if (!defaultExecutor) {
+        defaultExecutor = new OsascriptExecutor();
+    }
+    return defaultExecutor;
+}
+/**
+ * Override the default executor (for testing).
+ */
+export function setDefaultExecutor(executor) {
+    defaultExecutor = executor;
+}
+//# sourceMappingURL=executor.js.map

package/dist/jxa/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/jxa/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAazC,qEAAqE;AACrE,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpC,kCAAkC;AAClC,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,OAAO,CAAS;IAChB,SAAS,CAAS;IAE1B,YAAY,IAA+C;QACzD,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,eAAe,CAAC;QAChD,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,UAAU,CAAC;IACjD,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CACrB,8BAA8B,UAAU,CAAC,MAAM,CAAC,EAAE,EAClD;gBACE,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,2EAA2E;gBAC3E,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CACF,CAAC;YACF,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAClD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,iEAAiE;YACjE,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,IAAI,GAAG,EAAE,CAAC;gBACtD,MAAM,OAAO,GAAG,GAA6D,CAAC;gBAC9E,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACjF,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAEjF,wEAAwE;gBACxE,uFAAuF;gBACvF,IAAI,MAAM,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBAClD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;gBAC5B,CAAC;gBAED,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC;YACvE,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAED,4CAA4C;AAC5C,IAAI,eAAe,GAAuB,IAAI,CAAC;AAE/C,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAqB;IACtD,eAAe,GAAG,QAAQ,CAAC;AAC7B,CAAC"}

package/dist/jxa/helpers.d.ts

@@ -0,0 +1,51 @@
+/**
+ * helpers.ts — Reusable JXA code fragments injected into tool scripts.
+ *
+ * These are JavaScript strings that get embedded into osascript calls.
+ * They handle common operations like finding records by various identifiers,
+ * looking up databases, and detecting the DEVONthink version.
+ */
+/**
+ * JXA helper: Get a reference to the DEVONthink application.
+ * Tries "DEVONthink 3" first (v3.x), falls back to "DEVONthink" (v4.x).
+ */
+export declare const JXA_APP: string;
+/**
+ * JXA helper: Find a record by UUID.
+ * Expects `uuid` variable to be defined. Sets `record` variable.
+ */
+export declare const JXA_FIND_BY_UUID = "\nvar record = app.getRecordWithUuid(uuid);\nif (!record || !record.uuid()) throw new Error(\"Record not found for UUID: \" + uuid);\n";
+/**
+ * JXA helper: Find a record by ID within a database.
+ * Expects `recordId` (number) and `db` (database ref) variables. Sets `record` variable.
+ */
+export declare const JXA_FIND_BY_ID = "\nvar record = db.getRecordAt(recordId);\nif (!record || !record.uuid()) throw new Error(\"Record not found for ID: \" + recordId);\n";
+/**
+ * JXA helper: Find a record by path within a database.
+ * Expects `recordPath` (string) and `db` (database ref) variables. Sets `record` variable.
+ */
+export declare const JXA_FIND_BY_PATH = "\nvar record = app.getRecordAt(recordPath, {in: db});\nif (!record || !record.uuid()) throw new Error(\"Record not found at path: \" + recordPath);\n";
+/**
+ * JXA helper: Resolve a database by name.
+ * Expects `dbName` variable (string). Sets `db` variable.
+ * If dbName is falsy, uses the current database.
+ */
+export declare const JXA_RESOLVE_DB = "\nvar db;\nif (dbName) {\n  var dbs = app.databases();\n  db = null;\n  for (var i = 0; i < dbs.length; i++) {\n    if (dbs[i].name() === dbName) { db = dbs[i]; break; }\n  }\n  if (!db) throw new Error(\"Database not found: \" + dbName);\n} else {\n  db = app.currentDatabase();\n}\n";
+/**
+ * JXA helper: Resolve a record from uuid, recordId, recordPath, or recordName.
+ * Expects the identifying variables to be defined (set to null if not provided).
+ * Uses `db` if available for ID/path lookups.
+ * Sets `record` variable.
+ */
+export declare const JXA_RESOLVE_RECORD = "\nvar record;\nif (uuid) {\n  record = app.getRecordWithUuid(uuid);\n  if (!record || !record.uuid()) throw new Error(\"Record not found for UUID: \" + uuid);\n} else if (typeof recordId === \"number\" && recordId >= 0) {\n  if (!db) throw new Error(\"databaseName is required when using recordId\");\n  record = db.getRecordAt(recordId);\n  if (!record || !record.uuid()) throw new Error(\"Record not found for ID: \" + recordId);\n} else if (recordPath) {\n  if (!db) throw new Error(\"databaseName is required when using recordPath\");\n  record = app.getRecordAt(recordPath, {in: db});\n  if (!record || !record.uuid()) throw new Error(\"Record not found at path: \" + recordPath);\n} else if (recordName) {\n  throw new Error(\"recordName lookup requires using the search tool instead\");\n} else {\n  throw new Error(\"One of uuid, recordId, or recordPath must be provided\");\n}\n";
+/**
+ * JXA helper: Extract standard record properties into a plain object.
+ * Expects `record` variable to be defined.
+ * Returns a string expression that evaluates to the properties object.
+ */
+export declare const JXA_RECORD_PROPS = "(function() {\n  var mimeType = null;\n  try { mimeType = record.mime(); } catch(e) {}\n  return {\n    uuid: record.uuid(),\n    name: record.name(),\n    type: record.type(),\n    path: record.path(),\n    location: record.location(),\n    database: record.database().name(),\n    size: record.size(),\n    creationDate: record.creationDate() ? record.creationDate().toISOString() : null,\n    modificationDate: record.modificationDate() ? record.modificationDate().toISOString() : null,\n    additionDate: record.additionDate() ? record.additionDate().toISOString() : null,\n    score: record.score(),\n    tags: record.tags(),\n    comment: record.comment(),\n    url: record.url(),\n    referenceUrl: record.referenceURL(),\n    kind: record.kind(),\n    mimeType: mimeType,\n    flagged: record.flag(),\n    locking: record.locking(),\n    wordCount: record.wordCount(),\n    characterCount: record.characterCount(),\n    numberOfDuplicates: record.numberOfDuplicates(),\n    numberOfReplicants: record.numberOfReplicants(),\n    label: record.label(),\n    rating: record.rating()\n  };\n})()";
+/**
+ * JXA helper: Extract basic record properties (for lists/search results).
+ * Lighter than full props — used when returning arrays of records.
+ */
+export declare const JXA_RECORD_SUMMARY = "({\n  uuid: record.uuid(),\n  name: record.name(),\n  type: record.type(),\n  location: record.location(),\n  database: record.database().name(),\n  tags: record.tags(),\n  score: record.score(),\n  flagged: record.flag(),\n  label: record.label(),\n  modificationDate: record.modificationDate() ? record.modificationDate().toISOString() : null\n})";

package/dist/jxa/helpers.js

@@ -0,0 +1,136 @@
+/**
+ * helpers.ts — Reusable JXA code fragments injected into tool scripts.
+ *
+ * These are JavaScript strings that get embedded into osascript calls.
+ * They handle common operations like finding records by various identifiers,
+ * looking up databases, and detecting the DEVONthink version.
+ */
+/**
+ * JXA helper: Get a reference to the DEVONthink application.
+ * Tries "DEVONthink 3" first (v3.x), falls back to "DEVONthink" (v4.x).
+ */
+export const JXA_APP = `
+var app;
+try { app = Application("DEVONthink 3"); app.name(); }
+catch(e) { app = Application("DEVONthink"); }
+`.trim();
+/**
+ * JXA helper: Find a record by UUID.
+ * Expects `uuid` variable to be defined. Sets `record` variable.
+ */
+export const JXA_FIND_BY_UUID = `
+var record = app.getRecordWithUuid(uuid);
+if (!record || !record.uuid()) throw new Error("Record not found for UUID: " + uuid);
+`;
+/**
+ * JXA helper: Find a record by ID within a database.
+ * Expects `recordId` (number) and `db` (database ref) variables. Sets `record` variable.
+ */
+export const JXA_FIND_BY_ID = `
+var record = db.getRecordAt(recordId);
+if (!record || !record.uuid()) throw new Error("Record not found for ID: " + recordId);
+`;
+/**
+ * JXA helper: Find a record by path within a database.
+ * Expects `recordPath` (string) and `db` (database ref) variables. Sets `record` variable.
+ */
+export const JXA_FIND_BY_PATH = `
+var record = app.getRecordAt(recordPath, {in: db});
+if (!record || !record.uuid()) throw new Error("Record not found at path: " + recordPath);
+`;
+/**
+ * JXA helper: Resolve a database by name.
+ * Expects `dbName` variable (string). Sets `db` variable.
+ * If dbName is falsy, uses the current database.
+ */
+export const JXA_RESOLVE_DB = `
+var db;
+if (dbName) {
+  var dbs = app.databases();
+  db = null;
+  for (var i = 0; i < dbs.length; i++) {
+    if (dbs[i].name() === dbName) { db = dbs[i]; break; }
+  }
+  if (!db) throw new Error("Database not found: " + dbName);
+} else {
+  db = app.currentDatabase();
+}
+`;
+/**
+ * JXA helper: Resolve a record from uuid, recordId, recordPath, or recordName.
+ * Expects the identifying variables to be defined (set to null if not provided).
+ * Uses `db` if available for ID/path lookups.
+ * Sets `record` variable.
+ */
+export const JXA_RESOLVE_RECORD = `
+var record;
+if (uuid) {
+  record = app.getRecordWithUuid(uuid);
+  if (!record || !record.uuid()) throw new Error("Record not found for UUID: " + uuid);
+} else if (typeof recordId === "number" && recordId >= 0) {
+  if (!db) throw new Error("databaseName is required when using recordId");
+  record = db.getRecordAt(recordId);
+  if (!record || !record.uuid()) throw new Error("Record not found for ID: " + recordId);
+} else if (recordPath) {
+  if (!db) throw new Error("databaseName is required when using recordPath");
+  record = app.getRecordAt(recordPath, {in: db});
+  if (!record || !record.uuid()) throw new Error("Record not found at path: " + recordPath);
+} else if (recordName) {
+  throw new Error("recordName lookup requires using the search tool instead");
+} else {
+  throw new Error("One of uuid, recordId, or recordPath must be provided");
+}
+`;
+/**
+ * JXA helper: Extract standard record properties into a plain object.
+ * Expects `record` variable to be defined.
+ * Returns a string expression that evaluates to the properties object.
+ */
+export const JXA_RECORD_PROPS = `(function() {
+  var mimeType = null;
+  try { mimeType = record.mime(); } catch(e) {}
+  return {
+    uuid: record.uuid(),
+    name: record.name(),
+    type: record.type(),
+    path: record.path(),
+    location: record.location(),
+    database: record.database().name(),
+    size: record.size(),
+    creationDate: record.creationDate() ? record.creationDate().toISOString() : null,
+    modificationDate: record.modificationDate() ? record.modificationDate().toISOString() : null,
+    additionDate: record.additionDate() ? record.additionDate().toISOString() : null,
+    score: record.score(),
+    tags: record.tags(),
+    comment: record.comment(),
+    url: record.url(),
+    referenceUrl: record.referenceURL(),
+    kind: record.kind(),
+    mimeType: mimeType,
+    flagged: record.flag(),
+    locking: record.locking(),
+    wordCount: record.wordCount(),
+    characterCount: record.characterCount(),
+    numberOfDuplicates: record.numberOfDuplicates(),
+    numberOfReplicants: record.numberOfReplicants(),
+    label: record.label(),
+    rating: record.rating()
+  };
+})()`;
+/**
+ * JXA helper: Extract basic record properties (for lists/search results).
+ * Lighter than full props — used when returning arrays of records.
+ */
+export const JXA_RECORD_SUMMARY = `({
+  uuid: record.uuid(),
+  name: record.name(),
+  type: record.type(),
+  location: record.location(),
+  database: record.database().name(),
+  tags: record.tags(),
+  score: record.score(),
+  flagged: record.flag(),
+  label: record.label(),
+  modificationDate: record.modificationDate() ? record.modificationDate().toISOString() : null
+})`;
+//# sourceMappingURL=helpers.js.map

package/dist/jxa/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/jxa/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;;;;CAItB,CAAC,IAAI,EAAE,CAAC;AAET;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;CAG/B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;CAG7B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;CAG/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;CAY7B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;CAkBjC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA8B3B,CAAC;AAEN;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;GAW/B,CAAC"}

package/dist/jxa/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * types.ts — McpTool interface and defineTool() factory.
+ *
+ * Each tool is created via defineTool(), which:
+ *   - Takes a Zod schema for input validation
+ *   - Converts it to JSON Schema for MCP's inputSchema
+ *   - Wraps the run function with safeParse for readable errors
+ */
+import { z } from "zod";
+import type { JxaExecutor } from "./executor.js";
+/** The shape registered with the MCP server */
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    run: (args: Record<string, unknown>) => Promise<unknown>;
+}
+/** Options for defineTool */
+interface DefineToolOptions<T extends z.ZodTypeAny> {
+    name: string;
+    description: string;
+    schema: T;
+    run: (args: z.infer<T>, executor: JxaExecutor) => Promise<unknown>;
+}
+/**
+ * Factory that creates an McpTool from a Zod schema and a run function.
+ *
+ * The Zod schema is converted to JSON Schema for the MCP inputSchema.
+ * At runtime, args are validated with safeParse — invalid args get a
+ * readable error message instead of throwing.
+ */
+export declare function defineTool<T extends z.ZodTypeAny>(opts: DefineToolOptions<T>): McpTool;
+export {};

package/dist/jxa/types.js

@@ -0,0 +1,43 @@
+/**
+ * types.ts — McpTool interface and defineTool() factory.
+ *
+ * Each tool is created via defineTool(), which:
+ *   - Takes a Zod schema for input validation
+ *   - Converts it to JSON Schema for MCP's inputSchema
+ *   - Wraps the run function with safeParse for readable errors
+ */
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { getDefaultExecutor } from "./executor.js";
+/**
+ * Factory that creates an McpTool from a Zod schema and a run function.
+ *
+ * The Zod schema is converted to JSON Schema for the MCP inputSchema.
+ * At runtime, args are validated with safeParse — invalid args get a
+ * readable error message instead of throwing.
+ */
+export function defineTool(opts) {
+    const jsonSchema = zodToJsonSchema(opts.schema, {
+        $refStrategy: "none",
+        target: "openApi3",
+    });
+    // Remove the top-level $schema and additionalProperties keys that
+    // zodToJsonSchema adds — MCP servers typically don't include these.
+    const { $schema: _, ...schemaBody } = jsonSchema;
+    return {
+        name: opts.name,
+        description: opts.description,
+        inputSchema: schemaBody,
+        run: async (args) => {
+            const result = opts.schema.safeParse(args);
+            if (!result.success) {
+                const issues = result.error.issues
+                    .map((i) => `${i.path.join(".")}: ${i.message}`)
+                    .join("; ");
+                return { error: `Invalid arguments: ${issues}` };
+            }
+            const executor = getDefaultExecutor();
+            return opts.run(result.data, executor);
+        },
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/jxa/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/jxa/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAkBnD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,IAA0B;IAE1B,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE;QAC9C,YAAY,EAAE,MAAM;QACpB,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;IAEH,kEAAkE;IAClE,oEAAoE;IACpE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,UAAqC,CAAC;IAE5E,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,UAAU;QACvB,GAAG,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;qBAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;qBAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO,EAAE,KAAK,EAAE,sBAAsB,MAAM,EAAE,EAAE,CAAC;YACnD,CAAC;YACD,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+/**
+ * server.ts — In-process MCP server for DEVONthink.
+ *
+ * All 33 tools are our own code under MIT — zero upstream dependency.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare const createExtendedServer: () => Promise<{
+    server: Server;
+    cleanup: () => Promise<void>;
+}>;

package/dist/server.js

@@ -0,0 +1,65 @@
+/**
+ * server.ts — In-process MCP server for DEVONthink.
+ *
+ * All 33 tools are our own code under MIT — zero upstream dependency.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListPromptsRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { allTools } from "./tools/index.js";
+export const createExtendedServer = async () => {
+    const server = new Server({
+        name: "@tekmidian/devon",
+        version: "3.0.0",
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {},
+        },
+    });
+    // ---- ListTools handler ----
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return { tools: allTools };
+    });
+    // ---- Empty resource/prompt handlers (required by MCP spec) ----
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return { resources: [] };
+    });
+    server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+        return { resources: [] };
+    });
+    server.setRequestHandler(ListPromptsRequestSchema, async () => {
+        return { prompts: [] };
+    });
+    // ---- CallTool handler ----
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args = {} } = request.params;
+        const tool = allTools.find((t) => t.name === name);
+        if (!tool) {
+            throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+        }
+        try {
+            const result = await tool.run(args);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            throw error instanceof McpError
+                ? error
+                : new McpError(ErrorCode.InternalError, error instanceof Error ? error.message : String(error));
+        }
+    });
+    return {
+        server,
+        cleanup: async () => {
+            // No persistent resources to clean up
+        },
+    };
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,kCAAkC,EAClC,wBAAwB,EACxB,SAAS,EACT,QAAQ,GACT,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,IAGtC,EAAE;IACH,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,8BAA8B;IAC9B,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,kEAAkE;IAClE,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QAC9D,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QACtE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QAC5D,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEtD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAA+B,CAAC,CAAC;YAC/D,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,YAAY,QAAQ;gBAC7B,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,IAAI,QAAQ,CACV,SAAS,CAAC,aAAa,EACvB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACR,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,sCAAsC;QACxC,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,12 @@
+/**
+ * setup.ts — Interactive first-time setup for devon
+ *
+ * Run with: npx @tekmidian/devon setup
+ *
+ * Walks the user through:
+ *   1. Prerequisites check (macOS, Node version, DEVONthink installed)
+ *   2. Update ~/.claude.json mcpServers
+ *   3. Update ~/.claude/settings.json enabledMcpjsonServers (if present)
+ *   4. Done summary with next steps
+ */
+export declare function runSetup(): Promise<void>;