@orboto/mcp 0.213.0 → 0.214.0

package/dist/response-budget.js

@@ -239,7 +239,7 @@ export const TruncationBlockSchema = z.object({
  */
 export const TruncationBlockAdvertisedSchema = z.object({ handle: z.string() })
     .passthrough()
-    .describe('Response was cut; pass `handle` to orboto_response_expand.');
+    .describe('Response cut; pass `handle` to orboto_response_expand.');
 function stringMarker(omitted, handle, path) {
     return `... [truncated ${omitted} chars - full value: orboto_response_expand handle="${handle}" path="${path}"]`;
 }

package/dist/tools/agent-coordination.js

@@ -10,7 +10,7 @@ import { mcpInstanceToken } from './shared.js';
 import { AgentSessionScopeSchema } from './agent-session-scope.js';
 export const agentHeartbeatToolConfig = {
     title: 'Agent heartbeat (Multi-Agent Coordination)',
-    description: 'Register or refresh this agent\'s presence with status detail. A live connection already counts as online (an open MCP event stream, `orboto messages --follow`, the agent WebSocket) - the heartbeat adds status: idle (default) | working (+workingOnTicketId) | blocked, capabilities (free-form strings for operator filters) and clientInfo.name (the runtime), and is the only presence path for turn-based clients without a standing connection. Rows older than 90 s count as offline; persist the returned sessionToken and send it on later heartbeats. `scope` { projectKeys, ticketKeys, role } declares this session\'s responsibility (ORB-2136); an empty object clears it.',
+    description: 'Register or refresh this agent\'s presence with status detail. A live connection already counts as online (an open MCP event stream, `orboto messages --follow`, the agent WebSocket) - the heartbeat adds status: idle (default) | working (+workingOnTicketId) | blocked, capabilities (free-form strings for operator filters) and clientInfo.name (the runtime), and is the only presence path for turn-based clients without a standing connection. Rows older than 90 s count as offline; persist the returned sessionToken and send it on later heartbeats. `scope` { projectKeys, ticketKeys, role } declares this session\'s responsibility (ORB-2136); an empty object clears it. `startedBy`: starter session id, same account.',
     inputSchema: z.object({
         sessionToken: z.string().nullable().optional(),
         scope: AgentSessionScopeSchema.optional(),
@@ -23,11 +23,13 @@ export const agentHeartbeatToolConfig = {
             host: z.string().optional(),
             user_agent: z.string().optional(),
         }).optional(),
+        startedBy: z.string().uuid().optional(),
     }).shape,
     outputSchema: z.object({
         sessionToken: z.string(),
         sessionId: z.string().uuid(),
         scope: AgentSessionScopeSchema.nullable(),
+        startedBy: z.string().uuid().nullable().optional(),
     }).shape,
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
 };
@@ -37,7 +39,7 @@ export function makeAgentHeartbeatHandler(client) {
         const scope = res.scope ? ` scope=${JSON.stringify(res.scope)}` : '';
         return {
             content: [{ type: 'text', text: `heartbeat ack - sessionToken=${res.sessionToken.slice(0, 8)}… session ${res.sessionId.slice(0, 8)}${scope}` }],
-            structuredContent: { sessionToken: res.sessionToken, sessionId: res.sessionId, scope: res.scope ?? null },
+            structuredContent: { sessionToken: res.sessionToken, sessionId: res.sessionId, scope: res.scope ?? null, ...(res.startedBy !== undefined ? { startedBy: res.startedBy } : {}) },
         };
     };
 }

package/dist/tools/agent-coordination.test.js

@@ -266,6 +266,17 @@ describe('ORB-2136 - session addressing', () => {
         expect(seen[0].headers['x-orboto-agent-session']).toBe('mcp-abc123');
         expect(result.structuredContent).toMatchObject({ scope: { role: 'integrator', projectKeys: ['ORB'] } });
     });
+    it('agent_heartbeat names the starter and answers the recorded one (ORB-2449)', async () => {
+        const starter = '5a1c0d2e-7b3f-4c11-9e2a-0c0ffee00001';
+        const seen = [];
+        vi.spyOn(globalThis, 'fetch').mockImplementation(async (_url, init) => {
+            seen.push(JSON.parse(init?.body ?? '{}'));
+            return { ok: true, status: 200, statusText: 'OK', json: async () => ({ sessionToken: 'mcp-abc123', sessionId: 'cbb52195-0000-4000-8000-000000000000', scope: { role: 'worker' }, startedBy: starter }), text: async () => '' };
+        });
+        const result = await makeAgentHeartbeatHandler(client)({ scope: { role: 'worker' }, startedBy: starter }, { sessionId: 'abc123' });
+        expect(seen[0]).toMatchObject({ startedBy: starter });
+        expect(result.structuredContent).toMatchObject({ startedBy: starter });
+    });
 });
 describe('orboto_agent_notify role addresses (ORB-2264)', () => {
     it('sends `to` as written, lists every recipient and needs no targetEmail', async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orboto/mcp",
-  "version": "0.213.0",
+  "version": "0.214.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",