agent-relay 8.8.5 → 8.9.1

package/dist/cli/mcp/messaging-tools.js

@@ -0,0 +1,315 @@
+import { z } from 'zod';
+import { jsonContent, jsonResult, textContent } from './tool-results.js';
+import { identityOverrideInputShape, messageResult } from './tool-shapes.js';
+function resolveEmoji(input) {
+    const normalized = input.trim().replace(/^:/, '').replace(/:$/, '').toLowerCase();
+    const aliases = {
+        '+1': '👍',
+        thumbsup: '👍',
+        thumbs_up: '👍',
+        check: '✅',
+        white_check_mark: '✅',
+        rocket: '🚀',
+        eyes: '👀',
+        heart: '❤️',
+        clap: '👏',
+    };
+    return aliases[normalized] ?? input;
+}
+/**
+ * Register the channel, message, thread, DM, reaction, search, and inbox MCP
+ * tools. These all act through a single agent client resolved per-call from the
+ * optional `as` identity override.
+ */
+export function registerMessagingTools(server, getAgentClient) {
+    server.registerTool('create_channel', {
+        title: 'Create Channel',
+        description: 'Create a new workspace channel.',
+        inputSchema: {
+            name: z.string().describe('Unique channel name'),
+            topic: z.string().optional().describe('Optional channel topic'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: jsonResult,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ name, topic, as }) => jsonContent(await getAgentClient(as).channels.create({ name, topic })));
+    server.registerTool('list_channels', {
+        title: 'List Channels',
+        description: 'List channels available in the workspace.',
+        inputSchema: {
+            include_archived: z.boolean().optional().describe('Include archived channels'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: {
+            channels: z.array(z.object({}).passthrough()).describe('Channels'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ include_archived, as }) => {
+        const channels = await getAgentClient(as).channels.list(include_archived ? { includeArchived: include_archived } : undefined);
+        return jsonContent({ channels });
+    });
+    server.registerTool('join_channel', {
+        title: 'Join Channel',
+        description: 'Join an existing channel.',
+        inputSchema: {
+            channel: z.string().describe('Channel name'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: messageResult,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ channel, as }) => {
+        await getAgentClient(as).channels.join(channel);
+        return textContent(`Joined channel #${channel}`);
+    });
+    server.registerTool('leave_channel', {
+        title: 'Leave Channel',
+        description: 'Leave a channel.',
+        inputSchema: {
+            channel: z.string().describe('Channel name'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: messageResult,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ channel, as }) => {
+        await getAgentClient(as).channels.leave(channel);
+        return textContent(`Left channel #${channel}`);
+    });
+    server.registerTool('invite_to_channel', {
+        title: 'Invite to Channel',
+        description: 'Invite another agent to a channel.',
+        inputSchema: {
+            channel: z.string().describe('Channel name'),
+            agent: z.string().describe('Agent name to invite'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: messageResult,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ channel, agent, as }) => {
+        await getAgentClient(as).channels.invite(channel, agent);
+        return textContent(`Invited ${agent} to #${channel}`);
+    });
+    server.registerTool('set_channel_topic', {
+        title: 'Set Channel Topic',
+        description: 'Update a channel topic.',
+        inputSchema: {
+            channel: z.string().describe('Channel name'),
+            topic: z.string().describe('New topic'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: jsonResult,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ channel, topic, as }) => jsonContent(await getAgentClient(as).channels.setTopic(channel, topic)));
+    server.registerTool('archive_channel', {
+        title: 'Archive Channel',
+        description: 'Archive a channel.',
+        inputSchema: {
+            channel: z.string().describe('Channel name'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: messageResult,
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true },
+    }, async ({ channel, as }) => {
+        await getAgentClient(as).channels.archive(channel);
+        return textContent(`Archived channel #${channel}`);
+    });
+    server.registerTool('post_message', {
+        title: 'Post Message',
+        description: 'Post a new message to a channel as the current agent.',
+        inputSchema: {
+            channel: z.string().describe('Channel name'),
+            text: z.string().describe('Message text'),
+            attachments: z.array(z.string()).optional().describe('File attachment IDs'),
+            mode: z.enum(['wait', 'steer']).optional().describe('Delivery mode'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: jsonResult,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ channel, text, attachments, mode, as }) => jsonContent(await getAgentClient(as).send(channel, text, { attachments, mode })));
+    server.registerTool('list_messages', {
+        title: 'Get Messages',
+        description: 'Retrieve message history from a channel.',
+        inputSchema: {
+            channel: z.string().describe('Channel name'),
+            limit: z.number().optional().describe('Maximum messages to return'),
+            before: z.string().optional().describe('Older-than cursor'),
+            after: z.string().optional().describe('Newer-than cursor'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: {
+            messages: z.array(z.object({}).passthrough()).describe('Messages'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ channel, limit, before, after, as }) => {
+        const messages = await getAgentClient(as).messages(channel, { limit, before, after });
+        return jsonContent({ messages });
+    });
+    server.registerTool('reply_to_thread', {
+        title: 'Reply to Thread',
+        description: 'Reply to an existing message thread.',
+        inputSchema: {
+            message_id: z.string().describe('Parent message ID'),
+            text: z.string().describe('Reply text'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: jsonResult,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ message_id, text, as }) => jsonContent(await getAgentClient(as).reply(message_id, text)));
+    server.registerTool('get_message_thread', {
+        title: 'Get Thread',
+        description: 'Retrieve a message thread.',
+        inputSchema: {
+            message_id: z.string().describe('Parent message ID'),
+            limit: z.number().optional().describe('Maximum replies to return'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: jsonResult,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ message_id, limit, as }) => jsonContent(await getAgentClient(as).thread(message_id, limit ? { limit } : undefined)));
+    server.registerTool('send_dm', {
+        title: 'Send Direct Message',
+        description: 'Send a private direct message to another agent.',
+        inputSchema: {
+            to: z.string().describe('Recipient agent name'),
+            text: z.string().describe('DM text'),
+            mode: z.enum(['wait', 'steer']).optional().describe('Delivery mode'),
+            attachments: z.array(z.string()).optional().describe('File attachment IDs'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: jsonResult,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ to, text, mode, attachments, as }) => jsonContent(await getAgentClient(as).dm(to, text, { mode, attachments })));
+    server.registerTool('list_dms', {
+        title: 'List DM Conversations',
+        description: 'List direct message conversations for the current agent.',
+        inputSchema: {
+            ...identityOverrideInputShape,
+        },
+        outputSchema: {
+            conversations: z.array(z.object({}).passthrough()).describe('DM conversations'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ as }) => jsonContent({ conversations: await getAgentClient(as).dms.conversations() }));
+    server.registerTool('send_group_dm', {
+        title: 'Send Group DM',
+        description: 'Create a group DM and send the first message.',
+        inputSchema: {
+            participants: z.array(z.string()).describe('Participant agent names'),
+            name: z.string().optional().describe('Optional group name'),
+            text: z.string().describe('Initial message'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: jsonResult,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ participants, name, text, as }) => {
+        const client = getAgentClient(as);
+        const conversation = await client.dms.createGroup({ participants, name });
+        const message = await client.dms.sendMessage(conversation.id, text);
+        return jsonContent({ conversation, message });
+    });
+    server.registerTool('add_reaction', {
+        title: 'Add Reaction',
+        description: 'Add an emoji reaction to a message.',
+        inputSchema: {
+            message_id: z.string().describe('Message ID'),
+            emoji: z.string().describe('Emoji character or shortcode'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: messageResult,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ message_id, emoji, as }) => {
+        const resolved = resolveEmoji(emoji);
+        await getAgentClient(as).react(message_id, resolved);
+        return textContent(`Reacted with ${resolved}`);
+    });
+    server.registerTool('remove_reaction', {
+        title: 'Remove Reaction',
+        description: 'Remove an emoji reaction from a message.',
+        inputSchema: {
+            message_id: z.string().describe('Message ID'),
+            emoji: z.string().describe('Emoji character or shortcode'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: messageResult,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ message_id, emoji, as }) => {
+        const resolved = resolveEmoji(emoji);
+        await getAgentClient(as).unreact(message_id, resolved);
+        return textContent(`Removed reaction ${resolved}`);
+    });
+    server.registerTool('search_messages', {
+        title: 'Search Messages',
+        description: 'Search messages across the workspace.',
+        inputSchema: {
+            query: z.string().describe('Text search query'),
+            channel: z.string().optional().describe('Optional channel filter'),
+            from: z.string().optional().describe('Optional sender filter'),
+            limit: z.number().optional().describe('Maximum results'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: {
+            results: z.array(z.object({}).passthrough()).describe('Search results'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ query, channel, from, limit, as }) => jsonContent({ results: await getAgentClient(as).search(query, { channel, from, limit }) }));
+    server.registerTool('check_inbox', {
+        title: 'Check Inbox',
+        description: 'Check unread messages, mentions, DMs, and reactions for the current agent.',
+        inputSchema: {
+            limit: z.number().optional().describe('Maximum inbox items'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: jsonResult,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ limit, as }) => jsonContent(await getAgentClient(as).inbox(limit != null ? { limit } : undefined)));
+    server.registerTool('mark_message_read', {
+        title: 'Mark as Read',
+        description: 'Mark a message as read for the current agent.',
+        inputSchema: {
+            message_id: z.string().describe('Message ID'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: messageResult,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ message_id, as }) => {
+        await getAgentClient(as).markRead(message_id);
+        return textContent(`Marked message ${message_id} as read`);
+    });
+    server.registerTool('get_message_readers', {
+        title: 'Get Readers',
+        description: 'List agents who have read a message.',
+        inputSchema: {
+            message_id: z.string().describe('Message ID'),
+            ...identityOverrideInputShape,
+        },
+        outputSchema: {
+            readers: z.array(z.object({}).passthrough()).describe('Readers'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ message_id, as }) => jsonContent({ readers: await getAgentClient(as).readers(message_id) }));
+}
+//# sourceMappingURL=messaging-tools.js.map

package/dist/cli/mcp/messaging-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-tools.js","sourceRoot":"","sources":["../../../src/cli/mcp/messaging-tools.ts"],"names":[],"mappings":"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"}

package/dist/cli/mcp/resources.d.ts

@@ -0,0 +1,39 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type AgentClient, type RelayCast, type WsClient } from '@relaycast/sdk';
+/**
+ * Tracks the set of `relay://` resource URIs the MCP client has subscribed to,
+ * so realtime events can be filtered down to only the resources that matter.
+ */
+export declare class SubscriptionManager {
+    private readonly subscriptions;
+    subscribe(uri: string): void;
+    unsubscribe(uri: string): void;
+    getMatchingSubscriptions(uris: string[]): string[];
+    getAll(): string[];
+    clear(): void;
+}
+/**
+ * Map a realtime workspace event to the `relay://` resource URIs whose contents
+ * it invalidates, so subscribers can be notified to re-fetch.
+ */
+export declare function eventToResourceUris(event: unknown): string[];
+/**
+ * Bridges the realtime WebSocket event stream to MCP resource notifications:
+ * for each workspace event, notifies any subscribed `relay://` resource URIs
+ * that the event invalidates.
+ */
+export declare class RealtimeResourceBridge {
+    private readonly wsClient;
+    private readonly subscriptions;
+    private readonly notifyCallback;
+    private unsubscribeFn;
+    constructor(wsClient: WsClient, subscriptions: SubscriptionManager, notifyCallback: (uri: string) => void);
+    start(): void;
+    stop(): void;
+}
+/**
+ * Register the read-only `relay://` resources (inbox, agents, channels, channel
+ * messages, message threads, and DM conversations) on the MCP server.
+ */
+export declare function registerResourceDefinitions(server: McpServer, getAgentClient: (asIdentity?: string) => AgentClient, getRelay: () => RelayCast): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/cli/mcp/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEjF;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IAEnD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI9B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAIlD,MAAM,IAAI,MAAM,EAAE;IAIlB,KAAK,IAAI,IAAI;CAGd;AAUD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAwC5D;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IAI/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,OAAO,CAAC,aAAa,CAA6B;gBAG/B,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,mBAAmB,EAClC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI;IAGxD,KAAK,IAAI,IAAI;IAoBb,IAAI,IAAI,IAAI;CAOb;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,WAAW,EACpD,QAAQ,EAAE,MAAM,SAAS,GACxB,IAAI,CAwEN"}

package/dist/cli/mcp/resources.js

@@ -0,0 +1,158 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Tracks the set of `relay://` resource URIs the MCP client has subscribed to,
+ * so realtime events can be filtered down to only the resources that matter.
+ */
+export class SubscriptionManager {
+    subscriptions = new Set();
+    subscribe(uri) {
+        this.subscriptions.add(uri);
+    }
+    unsubscribe(uri) {
+        this.subscriptions.delete(uri);
+    }
+    getMatchingSubscriptions(uris) {
+        return uris.filter((uri) => this.subscriptions.has(uri));
+    }
+    getAll() {
+        return [...this.subscriptions];
+    }
+    clear() {
+        this.subscriptions.clear();
+    }
+}
+function getStringEventField(event, field) {
+    if (typeof event !== 'object' || event === null) {
+        return null;
+    }
+    const candidate = event[field];
+    return typeof candidate === 'string' ? candidate : null;
+}
+/**
+ * Map a realtime workspace event to the `relay://` resource URIs whose contents
+ * it invalidates, so subscribers can be notified to re-fetch.
+ */
+export function eventToResourceUris(event) {
+    const type = getStringEventField(event, 'type');
+    switch (type) {
+        case 'message.created': {
+            const channel = getStringEventField(event, 'channel');
+            return channel ? ['relay://inbox', `relay://channels/${channel}/messages`] : ['relay://inbox'];
+        }
+        case 'message.updated': {
+            const channel = getStringEventField(event, 'channel');
+            return channel ? [`relay://channels/${channel}/messages`] : [];
+        }
+        case 'thread.reply': {
+            const parentId = getStringEventField(event, 'parentId');
+            return parentId ? ['relay://inbox', `relay://messages/${parentId}/thread`] : ['relay://inbox'];
+        }
+        case 'dm.received':
+        case 'group_dm.received': {
+            const conversationId = getStringEventField(event, 'conversationId');
+            return conversationId ? ['relay://inbox', `relay://dm/${conversationId}`] : ['relay://inbox'];
+        }
+        case 'agent.online':
+        case 'agent.offline':
+            return ['relay://agents'];
+        case 'channel.created':
+        case 'channel.updated':
+        case 'channel.archived':
+        case 'member.joined':
+        case 'member.left':
+            return ['relay://channels'];
+        case 'webhook.received':
+        case 'command.invoked': {
+            const channel = getStringEventField(event, 'channel');
+            return channel ? [`relay://channels/${channel}/messages`] : [];
+        }
+        case 'reaction.added':
+        case 'reaction.removed':
+            return ['relay://inbox'];
+        default:
+            return [];
+    }
+}
+/**
+ * Bridges the realtime WebSocket event stream to MCP resource notifications:
+ * for each workspace event, notifies any subscribed `relay://` resource URIs
+ * that the event invalidates.
+ */
+export class RealtimeResourceBridge {
+    wsClient;
+    subscriptions;
+    notifyCallback;
+    unsubscribeFn = null;
+    constructor(wsClient, subscriptions, notifyCallback) {
+        this.wsClient = wsClient;
+        this.subscriptions = subscriptions;
+        this.notifyCallback = notifyCallback;
+    }
+    start() {
+        this.unsubscribeFn = this.wsClient.on('*', (event) => {
+            const type = getStringEventField(event, 'type');
+            if (type === 'open' ||
+                type === 'close' ||
+                type === 'error' ||
+                type === 'reconnecting' ||
+                type === 'permanently_disconnected') {
+                return;
+            }
+            const matched = this.subscriptions.getMatchingSubscriptions(eventToResourceUris(event));
+            for (const uri of matched) {
+                this.notifyCallback(uri);
+            }
+        });
+        this.wsClient.connect();
+    }
+    stop() {
+        if (this.unsubscribeFn) {
+            this.unsubscribeFn();
+            this.unsubscribeFn = null;
+        }
+        this.wsClient.disconnect();
+    }
+}
+/**
+ * Register the read-only `relay://` resources (inbox, agents, channels, channel
+ * messages, message threads, and DM conversations) on the MCP server.
+ */
+export function registerResourceDefinitions(server, getAgentClient, getRelay) {
+    server.registerResource('inbox', 'relay://inbox', { title: 'Inbox', description: 'Unread messages, mentions, and DMs', mimeType: 'application/json' }, async (uri) => {
+        const inbox = await getAgentClient().inbox();
+        return { contents: [{ uri: uri.href, text: JSON.stringify(inbox) }] };
+    });
+    server.registerResource('agents', 'relay://agents', {
+        title: 'Agents',
+        description: 'Online and offline agents in the workspace',
+        mimeType: 'application/json',
+    }, async (uri) => {
+        const agents = await getRelay().agents.list();
+        return { contents: [{ uri: uri.href, text: JSON.stringify(agents) }] };
+    });
+    server.registerResource('channels', 'relay://channels', { title: 'Channels', description: 'Available channels in the workspace', mimeType: 'application/json' }, async (uri) => {
+        const channels = await getAgentClient().channels.list();
+        return { contents: [{ uri: uri.href, text: JSON.stringify(channels) }] };
+    });
+    server.registerResource('channel-messages', new ResourceTemplate('relay://channels/{name}/messages', { list: undefined }), {
+        title: 'Channel Messages',
+        description: 'Messages in a specific channel',
+        mimeType: 'application/json',
+    }, async (uri, params) => {
+        const messages = await getAgentClient().messages(String(params.name));
+        return { contents: [{ uri: uri.href, text: JSON.stringify(messages) }] };
+    });
+    server.registerResource('message-thread', new ResourceTemplate('relay://messages/{id}/thread', { list: undefined }), { title: 'Message Thread', description: 'Thread replies on a message', mimeType: 'application/json' }, async (uri, params) => {
+        const thread = await getAgentClient().thread(String(params.id));
+        return { contents: [{ uri: uri.href, text: JSON.stringify(thread) }] };
+    });
+    server.registerResource('dm-conversation', new ResourceTemplate('relay://dm/{conversation_id}', { list: undefined }), {
+        title: 'DM Conversation',
+        description: 'Direct message conversation',
+        mimeType: 'application/json',
+    }, async (uri, params) => {
+        const messages = await getAgentClient().dms.messages(String(params.conversation_id));
+        return { contents: [{ uri: uri.href, text: JSON.stringify(messages) }] };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/cli/mcp/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../src/cli/mcp/resources.ts"],"names":[],"mappings":"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"}

package/dist/cli/mcp/telemetry.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentClientLike, AgentRelayMcpServerOptions, SessionState } from './types.js';
+/**
+ * Wrap `server.registerTool` so every owned tool emits `agent_relay_tool_call`
+ * telemetry, surfaces invalid-agent-token errors as recoverable results, and
+ * piggybacks a compact inbox summary onto successful results.
+ */
+export declare function enableInboxPiggyback(mcpServer: McpServer, getSession: () => SessionState, getAgentClient: (asIdentity?: string) => AgentClientLike, invalidateAgentToken: (asIdentity?: string) => void, telemetryTransport?: AgentRelayMcpServerOptions['telemetryTransport'], actionToolNames?: Set<string>): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/cli/mcp/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAsF5F;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,YAAY,EAC9B,cAAc,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,eAAe,EACxD,oBAAoB,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,EACnD,kBAAkB,CAAC,EAAE,0BAA0B,CAAC,oBAAoB,CAAC,EACrE,eAAe,cAAoB,GAClC,IAAI,CA0GN"}