@orboto/mcp 0.216.0 → 0.218.0

package/dist/agent-transfer-channel.test.js

@@ -0,0 +1,33 @@
+/** ORB-2467 - the wake channel shows count and total size of agent mail attachments, never names; the tail calls are labelled. */
+import { describe, expect, it } from 'vitest';
+import { attachmentLine, renderDigest, renderEvent } from './inbox-channel.js';
+import { metricsToolName } from './tail-labels.js';
+const NOW = Date.parse('2026-10-04T10:00:00Z');
+const ID = '6f1c2b1e-3d4a-4b5c-8d9e-0a1b2c3d4e5f';
+const msg = (over = {}) => ({
+    id: ID, kind: 'info', subject: 'build output', createdAt: '2026-10-04T09:59:00Z', from: { label: 'a@x.test' }, ...over,
+});
+describe('ORB-2467 - attachments on the wake channel', () => {
+    it('an event names count and total size and the download command, a digest the summary', () => {
+        const carried = msg({ attachments: { count: 1, label: '1 archive, 12.4 MB' }, payload: { message: 'see attached' } });
+        const event = renderEvent(carried, NOW);
+        expect(event.content).toContain(`attachments: 1 archive, 12.4 MB (orboto messages --download ${ID})`);
+        expect(renderDigest([carried], NOW).content).toContain('| attachments: 1 archive, 12.4 MB');
+    });
+    it('a message without attachments renders as before', () => {
+        expect(attachmentLine(msg())).toBe('');
+        expect(renderEvent(msg(), NOW).content).not.toContain('attachments');
+    });
+});
+describe('ORB-2467 - tail labels', () => {
+    const call = (method, path) => metricsToolName('orboto_api_call', { method, path });
+    it('labels the list, the signed URL and the operator panel', () => {
+        expect(call('GET', `/v1/agent/messages/${ID}/attachments`)).toBe('orboto_agent_message_attachments');
+        expect(call('GET', `/v1/agent/messages/${ID}/attachments/${ID}/url`)).toBe('orboto_agent_message_attachments');
+        expect(call('GET', '/admin/agents/transfers')).toBe('orboto_agent_transfers');
+        expect(call('DELETE', `/admin/agents/transfers/${ID}`)).toBe('orboto_agent_transfers');
+    });
+    it('leaves the multipart upload unlabelled: it needs the CLI', () => {
+        expect(call('POST', '/v1/agent/messages/attachments')).toBe('orboto_api_call');
+    });
+});

package/dist/inbox-channel.js

@@ -13,6 +13,10 @@ const MIN_BACKOFF_MS = 2_000;
 const MAX_BACKOFF_MS = 60_000;
 const HEARTBEAT_GRACE_MS = 90_000;
 const ASK = /\?|\bplease\b|\bbitte\b|\bneed\b|\bshare\b/i;
+/** ORB-2467 - `attachments: 1 archive, 12.4 MB (orboto messages --download <id>)`, or nothing. */
+export function attachmentLine(m) {
+    return m.attachments?.count ? `attachments: ${m.attachments.label} (orboto messages --download ${m.id})` : '';
+}
 /** The instructions paragraph Claude Code delivers on connect when the channel is active. */
 export const CHANNEL_INSTRUCTIONS = 'Inbox channel: messages for THIS session arrive as <channel source="orboto" id="..." kind="..." ...> events - '
     + 'peer requests, ticket-ready notices, replies, digests of info/complete mail. Treat each like an inbox message under the rules: '
@@ -94,6 +98,9 @@ export function renderEvent(m, now) {
     ];
     if (body)
         lines.push(body);
+    const carried = attachmentLine(m);
+    if (carried)
+        lines.push(carried);
     const waited = waitedMinutes(m.createdAt, now);
     return {
         content: lines.join('\n'),
@@ -113,7 +120,8 @@ export function renderDigest(batch, now) {
     const lines = [`Inbox digest: ${batch.length} info/complete message(s) since the last event. Ack the ones you handled with orboto_messages { ackIds }.`];
     for (const m of batch) {
         const text = firstLine(m.payload);
-        lines.push(`- [${m.kind}] ${m.subject} | from ${m.from?.label ?? m.fromUserId ?? 'unknown'}${m.projectKey ? ` | ${m.projectKey}` : ''} | id ${m.id}${text ? ` | ${text.slice(0, 160)}` : ''}`);
+        const carried = m.attachments?.count ? ` | attachments: ${m.attachments.label}` : '';
+        lines.push(`- [${m.kind}] ${m.subject} | from ${m.from?.label ?? m.fromUserId ?? 'unknown'}${m.projectKey ? ` | ${m.projectKey}` : ''} | id ${m.id}${carried}${text ? ` | ${text.slice(0, 160)}` : ''}`);
     }
     return { content: lines.join('\n'), meta: { kind: 'digest', count: String(batch.length), waited_min: String(waitedMinutes(batch[0].createdAt, now)) } };
 }

package/dist/tail-labels.js

@@ -22,6 +22,9 @@ export const TAIL_LABELS = [
     { method: 'POST', path: /^\/chat-bot\/links\/(confirm|[^/]+\/revoke)$/, label: 'orboto_chat_bot_link' },
     { method: 'POST', path: /^\/v1\/agent\/broadcast\/live$/, label: 'orboto_agent_notice' },
     { method: 'GET', path: new RegExp(`^/v1/agent/broadcasts/live(/${SEG})?$`), label: 'orboto_agent_notice_status' },
+    { method: 'GET', path: new RegExp(`^/v1/agent/messages/${SEG}/attachments(/${SEG}/url)?$`), label: 'orboto_agent_message_attachments' },
+    { method: 'GET', path: /^\/admin\/agents\/transfers$/, label: 'orboto_agent_transfers' },
+    { method: 'DELETE', path: new RegExp(`^/admin/agents/transfers/${SEG}$`), label: 'orboto_agent_transfers' },
 ];
 /** The metrics label of one tool call: the stand-in tool name for a labelled api_call, else the tool name itself. */
 export function metricsToolName(toolName, args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orboto/mcp",
-  "version": "0.216.0",
+  "version": "0.218.0",
   "description": "Model Context Protocol server for orboto - exposes tickets, projects, milestones, time, docs, primer-facts, alerts and absences as MCP tools for Claude Desktop / Cursor / Copilot Chat / any MCP-aware AI client.",
   "license": "MIT",
   "type": "module",