agenthub-multiagent-mcp 1.26.2 → 1.28.0

package/dist/tools/index.js

@@ -239,6 +239,14 @@ export function registerTools() {
                 properties: {},
             },
         },
+        {
+            name: "brain_flush_session",
+            description: "Flush this session's accumulated activity into the local searchable brain (.mv2) and the server brain_sessions table WITHOUT disconnecting the agent. Call this at session close (e.g. from /close-session) so the brain is current even where the on-process-exit flush is unreliable (notably Windows, where SIGTERM never fires). Idempotent and best-effort.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+            },
+        },
         // Time orientation (add-time-aware-agents §1.3)
         {
             name: "now",
@@ -1977,6 +1985,110 @@ export function registerTools() {
                 required: ["project_id", "tour_id"],
             },
         },
+        // ── Product Roadmap (add-product-roadmap §1.5) ──
+        {
+            name: "roadmap_get",
+            description: "Read the per-project Product Roadmap. Returns the live view (or the latest snapshot when audience+full is requested via the dashboard share path). Defaults: audience=full (org-member only), format=json. Set format='markdown' for a CommonMark render suitable for emails, brain notes, A2A replies.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project_id: { type: "string", description: "Project ID" },
+                    audience: {
+                        type: "string",
+                        enum: ["investor", "leadership", "customer", "product"],
+                        description: "Audience filter. Omit for the full (unfiltered) view. Phase 1 returns the full view regardless; Phase 3 enforces filtering.",
+                    },
+                    format: {
+                        type: "string",
+                        enum: ["json", "markdown"],
+                        description: "Output format (default json)",
+                    },
+                },
+                required: ["project_id"],
+            },
+        },
+        {
+            name: "roadmap_set_field",
+            description: "Upsert one Product Roadmap field with source='manual'. value is JSON-encoded by the caller (e.g. \"\\\"4.2L\\\"\", \"9\", '{\"caption\":\"Payments\"}'). Sensitive sections (snapshot.finance.*, snapshot.partners.*) require the roadmap_admin role.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project_id: { type: "string", description: "Project ID" },
+                    section: {
+                        type: "string",
+                        description: "Section id, e.g. 'snapshot.finance', 'shipped', 'timeline', 'commentary.highlights'",
+                    },
+                    key: {
+                        type: "string",
+                        description: "Field key within the section (e.g. 'mrr', 'runway_months', an openspec change id, a partner slug). May be empty for singleton sections.",
+                    },
+                    value: {
+                        type: "string",
+                        description: "JSON-encoded value. Strings: '\"...\"'. Numbers: '42'. Objects: '{\"k\":\"v\"}'.",
+                    },
+                    sensitive: {
+                        type: "boolean",
+                        description: "Mark this entry as sensitive (stripped from customer/public renderers in Phase 3).",
+                    },
+                },
+                required: ["project_id", "section", "value"],
+            },
+        },
+        {
+            name: "roadmap_publish_snapshot",
+            description: "Freeze the current roadmap into an immutable snapshot. Returns { id, slug, project_id, audience, created_at }. Phase 3 publishes one snapshot per audience under the same per-day slug; Phase 1 publishes one (audience-agnostic) snapshot per call.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project_id: { type: "string", description: "Project ID" },
+                    audience: {
+                        type: "string",
+                        enum: ["investor", "leadership", "customer", "product"],
+                        description: "Audience to stamp on the snapshot. Omit for full view.",
+                    },
+                },
+                required: ["project_id"],
+            },
+        },
+        {
+            name: "roadmap_add_evidence",
+            description: "Attach an evidence row to a roadmap entry (drill-down surface). kind is one of openspec | pr | brain | task | pdf | sheet | url | note. (entry_id, kind, ref) is idempotent — duplicates return the existing row.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project_id: { type: "string", description: "Project ID" },
+                    entry_id: { type: "string", description: "Roadmap entry id (from roadmap_get)" },
+                    kind: {
+                        type: "string",
+                        enum: ["openspec", "pr", "brain", "task", "pdf", "sheet", "url", "note"],
+                    },
+                    ref: { type: "string", description: "Reference (URL, openspec id, brain knowledge id, etc.)" },
+                    label: { type: "string", description: "Optional human label" },
+                    sort_order: { type: "number", description: "Optional sort hint" },
+                },
+                required: ["project_id", "entry_id", "kind", "ref"],
+            },
+        },
+        {
+            name: "roadmap_share_to_slack",
+            description: "One-click share: publish a snapshot, mint a public share token, render Slack Block Kit, post to the channel. Returns { snapshot_id, slug, share_token, permalink, delivered }.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project_id: { type: "string", description: "Project ID" },
+                    channel: {
+                        type: "string",
+                        description: "Slack channel (e.g. #leadership). Empty = notifier default.",
+                    },
+                    audience: {
+                        type: "string",
+                        enum: ["investor", "leadership", "customer", "product"],
+                        description: "Audience filter applied before render.",
+                    },
+                },
+                required: ["project_id"],
+            },
+        },
         // ── Secrets Vault ──
         {
             name: "secret_set",
@@ -2478,6 +2590,19 @@ export async function handleToolCall(name, args, client, context) {
                 } : null,
             };
         }
+        case "brain_flush_session": {
+            // Flush the current session to the local .mv2 + server WITHOUT
+            // disconnecting. Mirrors gracefulShutdown's agent-id resolution so it
+            // works even if agent_register was never called this process. The agent
+            // stays registered for the next reconnect.
+            const workingDir = context.getWorkingDir();
+            const flushAgentId = agentId || (workingDir ? state.readHookAgentId(workingDir) : null);
+            if (!flushAgentId) {
+                return { flushed: false, reason: "no agent id resolved" };
+            }
+            const { mv2Written } = await brainCapture.flushSessionToBrain(client, flushAgentId);
+            return { flushed: true, agent_id: flushAgentId, mv2_written: mv2Written };
+        }
         case "now": {
             // No wrapping — server_time would otherwise overshadow the explicit
             // tool result. Force-refresh past the cache so the agent gets a fresh
@@ -3787,6 +3912,72 @@ export async function handleToolCall(name, args, client, context) {
             const projectId = args.project_id;
             return client.del(`/projects/${projectId}/features/tours/${args.tour_id}`);
         }
+        // ── Product Roadmap (add-product-roadmap §1.5) ──
+        case "roadmap_get": {
+            const projectId = args.project_id;
+            if (!projectId)
+                throw new Error("project_id is required");
+            const audience = args.audience || "";
+            const format = (args.format || "json").toLowerCase();
+            const query = new URLSearchParams();
+            if (format)
+                query.set("format", format);
+            if (audience)
+                query.set("audience", audience);
+            const suffix = query.toString() ? `?${query.toString()}` : "";
+            return client.get(`/projects/${projectId}/roadmap${suffix}`);
+        }
+        case "roadmap_set_field": {
+            const projectId = args.project_id;
+            if (!projectId)
+                throw new Error("project_id is required");
+            const section = args.section;
+            if (!section)
+                throw new Error("section is required");
+            const body = {
+                section,
+                key: args.key || "",
+                value: args.value ?? "",
+            };
+            if (args.sensitive !== undefined)
+                body.sensitive = !!args.sensitive;
+            return client.put(`/projects/${projectId}/roadmap/entries`, body);
+        }
+        case "roadmap_publish_snapshot": {
+            const projectId = args.project_id;
+            if (!projectId)
+                throw new Error("project_id is required");
+            const body = {};
+            if (args.audience)
+                body.audience = args.audience;
+            return client.post(`/projects/${projectId}/roadmap/snapshots`, body);
+        }
+        case "roadmap_add_evidence": {
+            const projectId = args.project_id;
+            const entryId = args.entry_id;
+            if (!projectId || !entryId)
+                throw new Error("project_id and entry_id are required");
+            const body = {
+                kind: args.kind,
+                ref: args.ref,
+            };
+            if (args.label !== undefined)
+                body.label = args.label;
+            if (args.sort_order !== undefined)
+                body.sort_order = args.sort_order;
+            return client.post(`/projects/${projectId}/roadmap/entries/${entryId}/evidence`, body);
+        }
+        case "roadmap_share_to_slack": {
+            const projectId = args.project_id;
+            if (!projectId)
+                throw new Error("project_id is required");
+            const body = {};
+            if (args.channel !== undefined)
+                body.channel = args.channel;
+            if (args.audience !== undefined)
+                body.audience = args.audience;
+            return client.post(`/projects/${projectId}/roadmap/share/slack`, body);
+        }
         // ── Capabilities (add-agent-capabilities Phase 2 §2.3) ──
         case "capability_list": {
             if (!agentId) {