@allourthings/mcp-server 0.5.2 → 1.0.0

package/dist/index.js

@@ -11142,13 +11142,57 @@ class StdioServerTransport {
 
 // src/backends/native.ts
 import { createRequire } from "module";
+
+// src/config.ts
+import { createHash } from "crypto";
+import { homedir, platform } from "os";
+import { join } from "path";
+function expandTilde(p) {
+  if (p === "~" || p.startsWith("~/")) {
+    return join(homedir(), p.slice(2));
+  }
+  return p;
+}
+function platformCacheBase() {
+  if (platform() === "win32") {
+    return join(process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local"), "allourthings");
+  }
+  if (platform() === "darwin") {
+    return join(homedir(), "Library", "Caches", "allourthings");
+  }
+  const xdg = process.env.XDG_CACHE_HOME;
+  return join(xdg ? expandTilde(xdg) : join(homedir(), ".cache"), "allourthings");
+}
+function resolveDataDir(argv = process.argv, env = process.env) {
+  const argIndex = argv.indexOf("--data-dir");
+  if (argIndex !== -1 && argv[argIndex + 1]) {
+    return expandTilde(argv[argIndex + 1]);
+  }
+  if (env.ALLOURTHINGS_DATA_DIR) {
+    return expandTilde(env.ALLOURTHINGS_DATA_DIR);
+  }
+  return join(homedir(), "Documents", "AllOurThings");
+}
+function resolveCacheDir(dataDir) {
+  const hash = createHash("sha256").update(dataDir).digest("hex").slice(0, 16);
+  return join(platformCacheBase(), hash);
+}
+
+// src/backends/native.ts
 var require2 = createRequire(import.meta.url);
 var { JsCatalogStore } = require2("@allourthings/core");
 
 class NativeBackend {
   store;
   constructor(dataDir) {
-    this.store = new JsCatalogStore(dataDir);
+    this.store = new JsCatalogStore(dataDir, resolveCacheDir(dataDir));
+  }
+  refresh() {
+    try {
+      this.store.refresh();
+    } catch (e) {
+      console.error("[allourthings] cache refresh failed:", e);
+    }
   }
   async addItem(newItem) {
     return this.store.addItem(newItem);
@@ -11157,6 +11201,7 @@ class NativeBackend {
     return this.store.getItem(idOrName);
   }
   async listItems(filter) {
+    this.refresh();
     return this.store.listItems(filter ?? null);
   }
   async updateItem(id, updates) {
@@ -11166,8 +11211,12 @@ class NativeBackend {
     return this.store.deleteItem(id);
   }
   async searchItems(query) {
+    this.refresh();
     return this.store.searchItems(query);
   }
+  async getItemFields() {
+    return this.store.getItemFields();
+  }
   async addAttachment(itemId, filename, kind, data, label) {
     const result = this.store.addAttachment(itemId, filename, kind, data, label ?? null);
     if (result instanceof Error)
@@ -17854,7 +17903,7 @@ async function getItem(backend, input) {
 // src/tools/list-items.ts
 var listItemsInputSchema = exports_external.object({
   category: exports_external.string().optional().describe("Filter by category"),
-  location: exports_external.string().optional().describe("Filter by location/room"),
+  subcategory: exports_external.string().optional().describe("Filter by subcategory"),
   tags: exports_external.array(exports_external.string()).optional().describe("Filter by tags (all must match)")
 });
 async function listItems(backend, input) {
@@ -17865,7 +17914,7 @@ async function listItems(backend, input) {
     };
   }
   const summary = items.map((item) => {
-    const meta = [item.category, item.location].filter(Boolean).join(", ");
+    const meta = [item.category, item.subcategory].filter(Boolean).join(" › ");
     return `- ${item.name}${meta ? ` [${meta}]` : ""} (${item.id})`;
   }).join(`
 `);
@@ -17877,7 +17926,7 @@ ${summary}` }]
 
 // src/tools/update-item.ts
 var updateItemInputSchema = exports_external.object({
-  id: exports_external.string().regex(/^[0-9a-f]{8}$/).describe("Item ID to update (8-character hex, from the id field on the item)"),
+  id: exports_external.string().describe("Item ID to update (8-character hex, from the id field on the item)"),
   updates: exports_external.record(exports_external.unknown()).describe("Fields to update. Any item field can be updated: name, category, brand, model, purchase_date, purchase_price, currency, warranty_expires, retailer, location, features, notes, tags, serial_number. Custom fields are also accepted.")
 });
 async function updateItem(backend, input) {
@@ -17894,7 +17943,7 @@ async function updateItem(backend, input) {
 
 // src/tools/delete-item.ts
 var deleteItemInputSchema = exports_external.object({
-  id: exports_external.string().regex(/^[0-9a-f]{8}$/).describe("Item ID to delete")
+  id: exports_external.string().describe("Item ID to delete")
 });
 async function deleteItem(backend, input) {
   const deleted = await backend.deleteItem(input.id);
@@ -18042,6 +18091,27 @@ async function attachFromUrl(backend, input) {
   };
 }
 
+// src/tools/get-item-fields.ts
+var getItemFieldsInputSchema = exports_external.object({});
+async function getItemFields(backend) {
+  const fields = await backend.getItemFields();
+  if (fields.length === 0) {
+    return {
+      content: [{ type: "text", text: "No items in catalog yet." }]
+    };
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: `Fields in use across your catalog:
+${fields.map((f) => `- ${f}`).join(`
+`)}`
+      }
+    ]
+  };
+}
+
 // src/server.ts
 function createServer(backend) {
   const server = new Server({ name: "allourthings", version: "0.1.0" }, { capabilities: { tools: {} } });
@@ -18049,7 +18119,7 @@ function createServer(backend) {
     tools: [
       {
         name: "add_item",
-        description: "Add a new item to the household inventory",
+        description: "Add a new item to the inventory",
         inputSchema: zodToJsonSchema(addItemInputSchema)
       },
       {
@@ -18059,7 +18129,7 @@ function createServer(backend) {
       },
       {
         name: "list_items",
-        description: "List all items, optionally filtered by category or tags",
+        description: "List all items, optionally filtered by category, subcategory, or tags",
         inputSchema: zodToJsonSchema(listItemsInputSchema)
       },
       {
@@ -18096,6 +18166,11 @@ function createServer(backend) {
         name: "attach_from_url",
         description: "Download a file from a URL and attach it to an item (e.g. a PDF manual or warranty document)",
         inputSchema: zodToJsonSchema(attachFromUrlInputSchema)
+      },
+      {
+        name: "get_item_fields",
+        description: "Return all field names currently in use across your catalog. Call this before adding or updating items to discover what fields exist and use consistent naming.",
+        inputSchema: zodToJsonSchema(getItemFieldsInputSchema)
       }
     ]
   }));
@@ -18122,6 +18197,8 @@ function createServer(backend) {
         return deleteAttachment(backend, deleteAttachmentInputSchema.parse(args));
       case "attach_from_url":
         return attachFromUrl(backend, attachFromUrlInputSchema.parse(args));
+      case "get_item_fields":
+        return getItemFields(backend);
       default:
         throw new Error(`Unknown tool: ${name}`);
     }
@@ -18129,26 +18206,6 @@ function createServer(backend) {
   return server;
 }
 
-// src/config.ts
-import { homedir } from "os";
-import { join } from "path";
-function expandTilde(p) {
-  if (p === "~" || p.startsWith("~/")) {
-    return join(homedir(), p.slice(2));
-  }
-  return p;
-}
-function resolveDataDir(argv = process.argv, env = process.env) {
-  const argIndex = argv.indexOf("--data-dir");
-  if (argIndex !== -1 && argv[argIndex + 1]) {
-    return expandTilde(argv[argIndex + 1]);
-  }
-  if (env.ALLOURTHINGS_DATA_DIR) {
-    return expandTilde(env.ALLOURTHINGS_DATA_DIR);
-  }
-  return join(homedir(), "Documents", "AllOurThings");
-}
-
 // src/index.ts
 var dataDir = resolveDataDir();
 console.error(`[allourthings] data directory: ${dataDir}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allourthings/mcp-server",
-  "version": "0.5.2",
+  "version": "1.0.0",
   "mcpName": "io.allourthings/mcp-server",
   "description": "AllOurThings — Your things, understood by AI.",
   "license": "MIT",
@@ -23,8 +23,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
+    "@allourthings/core": "^1.0.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@allourthings/core": "^0.1.10",
     "zod": "^3.24.0",
     "zod-to-json-schema": "^3.25.1"
   },