@edda-business/mcp 0.67.0 → 0.69.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edda-business/mcp",
-  "version": "0.67.0",
+  "version": "0.69.0",
   "description": "Edda — the company data layer for AI agents.",
   "license": "Apache-2.0",
   "publishConfig": {

package/src/server.js

@@ -278,6 +278,36 @@ export function createServer() {
     },
   );
 
+  // ===========================================================================
+  // TOOL: inbox  —  GET /v2/company/inbox
+  // The waiting room the agent-run ingest reads (Decision Log 2026-09-04: the agent is
+  // the analyst; the app is the filing clerk).
+  // ===========================================================================
+  server.tool(
+    "inbox",
+    "LIST what is waiting in the company Inbox — each staged item with its id, submitter, the " +
+    "submitter's suggested destination (if any), and a content preview. This is the start of the " +
+    "company ingest: read each item (use `read` for the full text if the preview is not enough), " +
+    "decide where it belongs among the real projects, then file it with " +
+    "reconcile { stagingId, path }. Admin/ambassador only.",
+    {},
+    async () => {
+      try {
+        const r = await get("/v2/company/inbox");
+        const pending = r?.pending ?? [];
+        if (!pending.length) return text("The company Inbox is empty — nothing waiting.");
+        const lines = pending.map((f) =>
+          `• ${f.name}  (stagingId: ${f.id})\n  staged ${String(f.created_at).slice(0, 10)}` +
+          `${f.suggested ? ` · suggested: ${f.suggested}` : ""}\n  ${String(f.preview || "").replace(/\s+/g, " ").slice(0, 240)}`);
+        return text(`${pending.length} item(s) waiting in the company Inbox:\n\n${lines.join("\n\n")}`);
+      } catch (e) {
+        const msg = String(e?.message || e);
+        if (msg.includes("admins_only") || msg.includes("(403)")) return text("Only an admin or ambassador can read the company Inbox.");
+        throw e;
+      }
+    },
+  );
+
   // ===========================================================================
   // TOOL: reconcile  —  POST /v2/company/river/reconcile
   // Process the company Edda's Inbox: the River classifies + places each staged item into the
@@ -285,14 +315,19 @@ export function createServer() {
   // ===========================================================================
   server.tool(
     "reconcile",
-    "PROCESS the company Inbox — have the company file every item waiting in its Inbox into the " +
-    "right folder (classify → place → make searchable). Run this after staging, or when the person " +
-    "says 'process the company inbox'. Optionally pass a single `stagingId` to file just that item. " +
-    "Returns where each item landed.",
-    { stagingId: z.string().optional().describe("Optional id of one staged item to file (from a submit_company_candidate receipt). Omit to process the whole Inbox.") },
-    async ({ stagingId }) => {
+    "FILE items from the company Inbox — NOTHING files without an explicit per-item action " +
+    "(company ruling). Without arguments this only REPORTS what is waiting (each with a proposed " +
+    "destination). The ingest flow: list items with `inbox`, read and analyze each, then call this " +
+    "with that item's `stagingId` — plus an explicit `path` to place it exactly where you decided " +
+    "(omit `path` to accept the proposed destination). YOU are the analyst; your call is the review.",
+    {
+      stagingId: z.string().optional().describe("Id of one staged item to file (from an `inbox` row or a submit receipt). Omit to sweep the whole Inbox."),
+      path: z.string().optional().describe("Explicit destination folder path for THAT item (requires stagingId). Missing folders are created."),
+    },
+    async ({ stagingId, path }) => {
       try {
-        const r = await post("/v2/company/river/reconcile", { stagingId });
+        if (path && !stagingId) return text("An explicit `path` files ONE analyzed item — pass its stagingId too.");
+        const r = await post("/v2/company/river/reconcile", { stagingId, forcePath: path });
         const receipts = r?.receipts ?? [];
         if (!receipts.length) return text("Nothing waiting in the company Inbox.");
         const lines = receipts.map((x) => `  ${x.filed ? "✓ filed" : x.status} → ${x.location}${x.audience && x.audience !== "company" ? ` [${x.audience}]` : ""}  (${x.reason})`);