@edda-business/mcp 0.66.1 → 0.68.0

package/package.json

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

package/src/server.js

@@ -197,6 +197,43 @@ export function createServer() {
 
   // EfB read-only seat mode stops here: tools/list is exactly search + read, and the write
   // tools below don't exist for the seat at all (unavailable, not merely rejected).
+  // ===========================================================================
+  // TOOL: orientation  —  GET /v2/company/orientation
+  // The served hot-cache: what is active right now, before you search.
+  // ===========================================================================
+  server.tool(
+    "orientation",
+    "START HERE at the beginning of a session: one cheap call that answers 'what is active in " +
+    "this company right now?' — each project with its status and its Current-state excerpt " +
+    "(from the project's index.md), the most recently updated pages, and how many items wait in " +
+    "the Inbox. Use it to orient BEFORE searching; then open the relevant project's index.md or " +
+    "search for specifics.",
+    {},
+    async () => {
+      try {
+        const r = await get("/v2/company/orientation");
+        const lines = [];
+        const projects = r?.projects ?? [];
+        lines.push(`Active projects (${projects.length}):`);
+        for (const p of projects) {
+          lines.push(`\n• ${p.name}${p.status ? ` [${p.status}]` : ""}`);
+          lines.push(p.current_state ? `  ${p.current_state.replace(/\n/g, "\n  ")}` : "  (no current-state entries yet)");
+        }
+        const recent = r?.recent_pages ?? [];
+        if (recent.length) {
+          lines.push(`\nRecently updated:`);
+          for (const pg of recent) lines.push(`  · ${[pg.folder, pg.name].filter(Boolean).join("/")} (${String(pg.updated_at).slice(0, 10)})`);
+        }
+        lines.push(`\nInbox: ${r?.inbox_pending ?? 0} item(s) waiting.`);
+        return text(lines.join("\n"));
+      } catch (e) {
+        const msg = String(e?.message || e);
+        if (msg.includes("(404)")) return text("Orientation isn't available on this company's server yet — fall back to search.");
+        throw e;
+      }
+    },
+  );
+
   if (readOnly) return server;
 
   // ===========================================================================
@@ -241,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
@@ -248,14 +315,20 @@ 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. " +
+    "PROCESS the company Inbox. Two modes. (1) Sweep: no arguments — the company auto-files items " +
+    "with a clear destination and leaves ambiguous ones waiting. (2) ANALYZED FILING — the ingest " +
+    "flow: list waiting items with `inbox`, read and analyze each one, then call this with that " +
+    "item's `stagingId` AND an explicit `path` (e.g. 'Projects/Whitehay AI/Working Documents') to " +
+    "file it exactly there. YOU are the analyst; the company only files what you tell it. " +
     "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 }) => {
+    {
+      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})`);