@flowrelay/mcp-server 1.0.0 → 1.0.2

package/README.md

@@ -29,7 +29,7 @@ The server currently exposes these tools:
 - list_events
 - list_untracked_resources (lists event-producing resources not scoped to any project – useful for discovering untracked activity)
 - discord_list_channels
-- discord_send_message
+- discord_send_message (plain text, or a handoff/insight by id or `last_*` rendered to Markdown and attached as a `.md` file)
 
 ## Environment Variables
 

package/dist/api.d.ts

@@ -58,6 +58,8 @@ export interface HandoffResult {
     next_steps: string[];
     created_at: string;
     updated_at?: string;
+    /** Canonical Markdown rendered server-side – identical to the dashboard copy button. */
+    markdown?: string;
 }
 export interface InsightResult {
     id: string;
@@ -77,6 +79,8 @@ export interface InsightResult {
     related_event_ids: string[];
     created_at: string;
     updated_at?: string;
+    /** Canonical Markdown rendered server-side – identical to the dashboard copy button. */
+    markdown?: string;
 }
 export interface UntrackedResource {
     source: string;
@@ -180,7 +184,13 @@ export declare class FlowRelayAPI {
             topic: string;
         }>;
     }>;
-    discordSendMessage(channelId: string, content: string): Promise<{
+    discordSendMessage(channelId: string, payload: {
+        content?: string;
+        handoff_id?: string;
+        insight_id?: string;
+        artifact?: 'last_handoff' | 'last_correlation' | 'last_onboarding' | 'last_architecture';
+        project_id?: string;
+    }): Promise<{
         ok: boolean;
         message_id: string;
     }>;

package/dist/api.js

@@ -109,10 +109,10 @@ export class FlowRelayAPI {
     async discordListChannels() {
         return this.request('/discord/channels');
     }
-    async discordSendMessage(channelId, content) {
+    async discordSendMessage(channelId, payload) {
         return this.request('/discord/send', {
             method: 'POST',
-            body: JSON.stringify({ channel_id: channelId, content }),
+            body: JSON.stringify({ channel_id: channelId, ...payload }),
         });
     }
     async listUntrackedResources() {

package/dist/index.js

@@ -222,16 +222,8 @@ server.tool('generate_handoff', 'Generate a new context handoff for personal sco
             return { content: [{ type: 'text', text: `Could not generate handoff: ${reason}` }] };
         }
         const handoff = result;
-        let text = `# ${handoff.title}\n\n${handoff.summary}\n`;
-        if (handoff.project_name)
-            text += `\n**Project:** ${handoff.project_name}\n`;
-        text += `\n**Sources:** ${handoff.sources.join(', ')}\n`;
-        if (handoff.key_changes?.length)
-            text += `\n**Key changes:**\n${handoff.key_changes.map((c) => `- ${c}`).join('\n')}\n`;
-        if (handoff.decisions.length)
-            text += `\n**Decisions:**\n${handoff.decisions.map((d) => `- ${d}`).join('\n')}\n`;
-        if (handoff.next_steps.length)
-            text += `\n**Next steps:**\n${handoff.next_steps.map((s) => `- ${s}`).join('\n')}\n`;
+        // Server renders the canonical Markdown; fall back for pre-markdown servers.
+        const text = handoff.markdown ?? `# ${handoff.title}\n\n${handoff.summary}\n`;
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
@@ -326,12 +318,22 @@ server.tool('discord_list_channels', 'List text channels in your connected Disco
     }
 });
 // ── Tool: discord send message ──────────────────────────────────────
-server.tool('discord_send_message', 'Send a message to a Discord channel in your connected server.', {
-    channel_id: z.string().describe('The Discord channel ID to send the message to'),
-    content: z.string().describe('The message content to send'),
-}, async ({ channel_id, content }) => {
+server.tool('discord_send_message', 'Send to a Discord channel in your connected server. Provide exactly one of: content (inline text); handoff_id or insight_id (sends that artifact, rendered to Markdown, as a .md file attachment); or artifact (last_handoff / last_correlation / last_onboarding / last_architecture, with project_id) to send the latest active artifact of that kind.', {
+    channel_id: z.string().describe('The Discord channel ID to send to'),
+    content: z.string().optional().describe('Inline message text. Mutually exclusive with handoff_id / insight_id / artifact'),
+    handoff_id: z.string().optional().describe('UUID of a handoff to render and attach as a .md file'),
+    insight_id: z.string().optional().describe('UUID of an insight to render and attach as a .md file'),
+    artifact: z
+        .enum(['last_handoff', 'last_correlation', 'last_onboarding', 'last_architecture'])
+        .optional()
+        .describe('Send the latest active artifact of this kind. Requires project_id'),
+    project_id: z.string().optional().describe('Project UUID. Required only when artifact is set'),
+}, async ({ channel_id, content, handoff_id, insight_id, artifact, project_id, }) => {
+    if (!content && !handoff_id && !insight_id && !artifact) {
+        return { content: [{ type: 'text', text: 'Provide content, handoff_id, insight_id, or artifact.' }] };
+    }
     try {
-        const result = await api.discordSendMessage(channel_id, content);
+        const result = await api.discordSendMessage(channel_id, { content, handoff_id, insight_id, artifact, project_id });
         return { content: [{ type: 'text', text: `Message sent (ID: ${result.message_id})` }] };
     }
     catch (err) {
@@ -359,7 +361,7 @@ server.tool('generate_correlation_insight', 'Generate a cross-source correlation
             return { content: [{ type: 'text', text: `Could not generate correlation insight: ${reason}` }] };
         }
         const insight = result;
-        return { content: [{ type: 'text', text: `# ${insight.title}\n\n${insight.summary}` }] };
+        return { content: [{ type: 'text', text: insight.markdown ?? `# ${insight.title}\n\n${insight.summary}` }] };
     }
     catch (err) {
         return { content: [{ type: 'text', text: `Failed: ${err.message}` }] };
@@ -390,7 +392,7 @@ server.tool('generate_onboarding_brief', 'Generate an onboarding brief AI insigh
             return { content: [{ type: 'text', text: `Could not generate onboarding brief: ${reason}` }] };
         }
         const insight = result;
-        return { content: [{ type: 'text', text: `# ${insight.title}\n\n${insight.summary}` }] };
+        return { content: [{ type: 'text', text: insight.markdown ?? `# ${insight.title}\n\n${insight.summary}` }] };
     }
     catch (err) {
         return { content: [{ type: 'text', text: `Failed: ${err.message}` }] };
@@ -419,7 +421,7 @@ server.tool('generate_architecture_insight', 'Generate an architecture insight A
             return { content: [{ type: 'text', text: `Could not generate architecture insight: ${reason}` }] };
         }
         const insight = result;
-        return { content: [{ type: 'text', text: `# ${insight.title}\n\n${insight.summary}` }] };
+        return { content: [{ type: 'text', text: insight.markdown ?? `# ${insight.title}\n\n${insight.summary}` }] };
     }
     catch (err) {
         return { content: [{ type: 'text', text: `Failed: ${err.message}` }] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowrelay/mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Flow Relay MCP Server for Claude Desktop and Claude Code – handoffs, integrations, and context events via natural conversation.",
   "type": "module",
   "license": "MIT",