@edda-business/mcp 0.66.1 → 0.67.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edda-business/mcp",
-  "version": "0.66.1",
+  "version": "0.67.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;
 
   // ===========================================================================