@edda-business/mcp 0.66.0 → 0.67.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edda-business/mcp",
-  "version": "0.66.0",
+  "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;
 
   // ===========================================================================
@@ -213,7 +250,9 @@ export function createServer() {
     "itself (on the next reconcile). You may optionally `suggest` a destination as a hint. Use " +
     "this to promote a finished note from your own work into the shared company brain. Only stage " +
     "what the person has approved sharing — this leaves their private vault. (Their private files " +
-    "stay on their disk; this is the shared company layer.)",
+    "stay on their disk; this is the shared company layer.) This stages PAGES (content) only — " +
+    "NEVER folders: if the person asks to create a folder, call `create` instead; folder creation " +
+    "is direct and immediate, it does not go through the Inbox.",
     {
       name: z.string().describe("File/page name, e.g. 'MCP Overview EFB'. A '.md' suffix is added if missing."),
       content: z.string().describe("The full markdown content of the item to share."),
@@ -322,9 +361,10 @@ export function createServer() {
     "are FIXED (Company · Projects · Decisions · Companies · People · Raw Documents · Archive) — you " +
     "cannot add new ones. A bare name (or a path not starting with a fixed folder) becomes a PROJECT " +
     "under Projects: 'Agency' → Projects/Agency. To nest under a specific top-level folder, start the " +
-    "path with it, e.g. 'Company/Policies' or 'Projects/Data Centre/Specs'. A write role is required; " +
-    "the folder appears immediately, and you can suggest it as a destination when you " +
-    "submit_company_candidate. Returns the folder id.",
+    "path with it, e.g. 'Company/Policies' or 'Projects/Data Centre/Specs'. When the person asks to " +
+    "create a folder, ALWAYS call this tool directly — never stage a folder request into the Inbox " +
+    "(the Inbox is for page content only). A write role is required; the folder appears immediately, " +
+    "and you can suggest it as a destination when you submit_company_candidate. Returns the folder id.",
     { path: z.string().describe("Folder name or path. A bare name → a project under Projects; 'Top-Level/Sub' nests under a fixed top-level folder.") },
     async ({ path }) => {
       try {