maestro-flow 0.3.10 → 0.3.12

package/dist/src/tools/team-mailbox.js

@@ -0,0 +1,384 @@
+/**
+ * Team Mailbox - MCP tools for agent-to-agent messaging with delivery tracking
+ *
+ * Tools:
+ * - team_send_message:    Send a message to a team role (persists to JSONL + broker inject)
+ * - team_read_mailbox:    Read unread messages for a role, mark as delivered
+ * - team_mailbox_status:  Per-role unread/pending/delivered counts
+ *
+ * Storage: .workflow/.team/{session-id}/.msg/mailbox.jsonl
+ *
+ * Integration points for TASK-001 (team-msg dispatch upgrade):
+ * - opReadMailbox: reads messages addressed to a role
+ * - opGetMailboxStatus: aggregates per-role delivery counts
+ * - delivery_method field on opLog messages
+ */
+import { z } from 'zod';
+import { existsSync, mkdirSync, readFileSync, appendFileSync, writeFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { getProjectRoot } from '../utils/path-validator.js';
+import { createDefaultDelegateBroker } from '../async/delegate-broker.js';
+// --- Storage helpers ---
+function getMailboxDir(sessionId) {
+    const root = getProjectRoot();
+    return join(root, '.workflow', '.team', sessionId, '.msg');
+}
+function getMailboxPath(sessionId) {
+    return join(getMailboxDir(sessionId), 'mailbox.jsonl');
+}
+function ensureMailboxFile(sessionId) {
+    const mailboxPath = getMailboxPath(sessionId);
+    const dir = dirname(mailboxPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    if (!existsSync(mailboxPath)) {
+        appendFileSync(mailboxPath, '', 'utf-8');
+    }
+    return mailboxPath;
+}
+function readAllMailboxMessages(sessionId) {
+    const mailboxPath = getMailboxPath(sessionId);
+    if (!existsSync(mailboxPath))
+        return [];
+    const content = readFileSync(mailboxPath, 'utf-8').trim();
+    if (!content)
+        return [];
+    return content.split('\n').map(line => {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            return null;
+        }
+    }).filter((m) => m !== null);
+}
+function writeAllMailboxMessages(sessionId, messages) {
+    const mailboxPath = ensureMailboxFile(sessionId);
+    writeFileSync(mailboxPath, messages.map(m => JSON.stringify(m)).join('\n') + (messages.length > 0 ? '\n' : ''), 'utf-8');
+}
+function getNextMailboxId(messages) {
+    const maxNum = messages.reduce((max, m) => {
+        const match = m.id.match(/^MBX-(\d+)$/);
+        return match ? Math.max(max, parseInt(match[1], 10)) : max;
+    }, 0);
+    return `MBX-${String(maxNum + 1).padStart(3, '0')}`;
+}
+function nowISO() {
+    return new Date().toISOString().replace('Z', '+00:00');
+}
+// --- Broker integration ---
+/**
+ * Attempt to inject a message into a running delegate agent via the broker.
+ * Returns true if injection was attempted (even if the job was not found),
+ * false only if broker itself was unavailable.
+ */
+function attemptBrokerInject(jobId, message) {
+    try {
+        const broker = createDefaultDelegateBroker();
+        const job = broker.getJob(jobId);
+        if (!job) {
+            return { attempted: false, result: `No running job found for: ${jobId}` };
+        }
+        if (job.status === 'completed' || job.status === 'failed' || job.status === 'cancelled') {
+            return { attempted: false, result: `Job ${jobId} is ${job.status}, message persisted for polling` };
+        }
+        const queued = broker.queueMessage({
+            jobId,
+            message,
+            delivery: 'inject',
+        });
+        return { attempted: true, result: `Injected into job ${jobId} as ${queued.messageId}` };
+    }
+    catch (error) {
+        return { attempted: false, result: `Broker error: ${error.message}` };
+    }
+}
+// --- Zod Schemas ---
+const SendMessageSchema = z.object({
+    session_id: z.string().describe('Session ID that determines mailbox storage path'),
+    from: z.string().describe('Sender role name'),
+    to: z.string().describe('Recipient role name'),
+    message: z.string().describe('Message content to send'),
+    type: z.string().optional().describe('Message type (default: "message")'),
+    delivery_method: z.enum(['inject', 'poll', 'broadcast']).optional().default('inject').describe('Delivery method (default: "inject")'),
+    data: z.record(z.string(), z.unknown()).optional().describe('Structured data payload'),
+});
+const ReadMailboxSchema = z.object({
+    session_id: z.string().describe('Session ID that determines mailbox storage path'),
+    role: z.string().describe('Role name to read mailbox for'),
+    limit: z.number().min(1).max(100).optional().default(50).describe('Max messages to return (default: 50)'),
+    mark_delivered: z.boolean().optional().default(true).describe('Mark returned messages as delivered (default: true)'),
+});
+const MailboxStatusSchema = z.object({
+    session_id: z.string().describe('Session ID that determines mailbox storage path'),
+});
+// --- Operations ---
+function opSendMessage(params) {
+    const { session_id, from, to, message, type, delivery_method, data } = params;
+    ensureMailboxFile(session_id);
+    const messages = readAllMailboxMessages(session_id);
+    const id = getNextMailboxId(messages);
+    const ts = nowISO();
+    const mailboxMsg = {
+        id,
+        ts,
+        from,
+        to,
+        type: type || 'message',
+        message,
+        delivery_method,
+        delivery_status: 'pending',
+    };
+    if (data)
+        mailboxMsg.data = data;
+    // Persist to JSONL
+    const mailboxPath = ensureMailboxFile(session_id);
+    appendFileSync(mailboxPath, JSON.stringify(mailboxMsg) + '\n', 'utf-8');
+    // Attempt broker injection for 'inject' delivery method
+    let injectResult = null;
+    if (delivery_method === 'inject') {
+        // Derive job ID from role name convention: {session_id}-{role}
+        const jobId = `${session_id}-${to}`;
+        injectResult = attemptBrokerInject(jobId, message);
+        // Update delivery status based on injection result
+        if (injectResult.attempted) {
+            const allMessages = readAllMailboxMessages(session_id);
+            const saved = allMessages.find(m => m.id === id);
+            if (saved) {
+                saved.delivery_status = 'notified';
+                writeAllMailboxMessages(session_id, allMessages);
+            }
+        }
+    }
+    const statusLine = injectResult
+        ? ` | inject: ${injectResult.result}`
+        : '';
+    return {
+        success: true,
+        result: {
+            id,
+            message: `Sent ${id}: [${from} -> ${to}] ${message.substring(0, 80)}${message.length > 80 ? '...' : ''}${statusLine}`,
+            delivery_method,
+            delivery_status: injectResult?.attempted ? 'notified' : 'pending',
+        },
+    };
+}
+function opReadMailbox(params) {
+    const { session_id, role, limit, mark_delivered } = params;
+    const allMessages = readAllMailboxMessages(session_id);
+    const unread = allMessages.filter(m => m.to === role && m.delivery_status !== 'delivered');
+    const toReturn = unread.slice(0, limit || 50);
+    if (mark_delivered && toReturn.length > 0) {
+        const now = nowISO();
+        const deliveredIds = new Set(toReturn.map(m => m.id));
+        for (const msg of allMessages) {
+            if (deliveredIds.has(msg.id)) {
+                msg.delivery_status = 'delivered';
+                msg.delivered_at = now;
+            }
+        }
+        writeAllMailboxMessages(session_id, allMessages);
+    }
+    const formatted = toReturn.map(m => `${m.id} [${m.ts.substring(11, 19)}] ${m.from} -> ${m.to} (${m.type}) ${m.message.substring(0, 100)}`);
+    return {
+        success: true,
+        result: {
+            role,
+            unread_count: toReturn.length,
+            total_pending: unread.length,
+            messages: toReturn,
+            formatted: formatted.join('\n'),
+        },
+    };
+}
+function opMailboxStatus(params) {
+    const { session_id } = params;
+    const allMessages = readAllMailboxMessages(session_id);
+    if (allMessages.length === 0) {
+        return {
+            success: true,
+            result: {
+                roles: [],
+                total_messages: 0,
+                summary: 'No mailbox messages recorded yet.',
+            },
+        };
+    }
+    // Aggregate per-role counts
+    const roleMap = new Map();
+    for (const msg of allMessages) {
+        // Count by recipient role
+        if (!roleMap.has(msg.to)) {
+            roleMap.set(msg.to, { role: msg.to, pending: 0, notified: 0, delivered: 0, failed: 0 });
+        }
+        const entry = roleMap.get(msg.to);
+        switch (msg.delivery_status) {
+            case 'pending':
+                entry.pending++;
+                break;
+            case 'notified':
+                entry.notified++;
+                break;
+            case 'delivered':
+                entry.delivered++;
+                break;
+            case 'failed':
+                entry.failed++;
+                break;
+        }
+    }
+    const roles = Array.from(roleMap.values());
+    const formatted = roles.map(r => `${r.role.padEnd(12)} | pending: ${r.pending} | notified: ${r.notified} | delivered: ${r.delivered} | failed: ${r.failed}`).join('\n');
+    return {
+        success: true,
+        result: {
+            roles,
+            total_messages: allMessages.length,
+            formatted,
+        },
+    };
+}
+// --- Tool Schema ---
+export const schema = {
+    name: 'team_mailbox',
+    description: `Team mailbox - agent-to-agent messaging with delivery tracking and broker injection.
+
+**Storage Location:** .workflow/.team/{session-id}/.msg/mailbox.jsonl
+
+**Operations & Required Parameters:**
+
+*   **send**: Send a message to a team role.
+    *   **session_id** (string, **REQUIRED**): Session ID.
+    *   **from** (string, **REQUIRED**): Sender role name.
+    *   **to** (string, **REQUIRED**): Recipient role name.
+    *   **message** (string, **REQUIRED**): Message content.
+    *   *type* (string): Message type (default: "message").
+    *   *delivery_method* (string): "inject" | "poll" | "broadcast" (default: "inject").
+    *   *data* (object): Structured data payload.
+
+*   **read**: Read unread messages for a role and mark as delivered.
+    *   **session_id** (string, **REQUIRED**): Session ID.
+    *   **role** (string, **REQUIRED**): Role name to read mailbox for.
+    *   *limit* (number): Max messages to return (default: 50).
+    *   *mark_delivered* (boolean): Mark messages as delivered (default: true).
+
+*   **status**: Per-role unread/delivered counts.
+    *   **session_id** (string, **REQUIRED**): Session ID.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['send', 'read', 'status'],
+                description: 'Operation to perform',
+            },
+            session_id: {
+                type: 'string',
+                description: 'Session ID (e.g., TLS-my-project-2026-02-27)',
+            },
+            from: {
+                type: 'string',
+                description: '[send] Sender role name',
+            },
+            to: {
+                type: 'string',
+                description: '[send] Recipient role name',
+            },
+            message: {
+                type: 'string',
+                description: '[send] Message content',
+            },
+            type: {
+                type: 'string',
+                description: '[send] Message type (default: "message")',
+            },
+            delivery_method: {
+                type: 'string',
+                enum: ['inject', 'poll', 'broadcast'],
+                description: '[send] Delivery method (default: "inject")',
+            },
+            data: {
+                type: 'object',
+                description: '[send] Structured data payload',
+            },
+            role: {
+                type: 'string',
+                description: '[read] Role name to read mailbox for',
+            },
+            limit: {
+                type: 'number',
+                description: '[read] Max messages to return (default: 50)',
+                minimum: 1,
+                maximum: 100,
+            },
+            mark_delivered: {
+                type: 'boolean',
+                description: '[read] Mark returned messages as delivered (default: true)',
+            },
+        },
+        required: ['operation'],
+    },
+};
+// --- Unified Params Schema for dispatch ---
+const DispatchParamsSchema = z.object({
+    operation: z.enum(['send', 'read', 'status']),
+    // send params
+    session_id: z.string().optional(),
+    from: z.string().optional(),
+    to: z.string().optional(),
+    message: z.string().optional(),
+    type: z.string().optional(),
+    delivery_method: z.enum(['inject', 'poll', 'broadcast']).optional(),
+    data: z.record(z.string(), z.unknown()).optional(),
+    // read params
+    role: z.string().optional(),
+    limit: z.number().min(1).max(100).optional(),
+    mark_delivered: z.boolean().optional(),
+});
+// --- Handler ---
+export async function handler(params) {
+    const parsed = DispatchParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        return { success: false, error: `Invalid params: ${parsed.error.message}` };
+    }
+    const p = parsed.data;
+    if (!p.session_id) {
+        return { success: false, error: 'Missing required parameter: session_id' };
+    }
+    switch (p.operation) {
+        case 'send': {
+            if (!p.from)
+                return { success: false, error: 'send requires "from"' };
+            if (!p.to)
+                return { success: false, error: 'send requires "to"' };
+            if (!p.message)
+                return { success: false, error: 'send requires "message"' };
+            return opSendMessage({
+                session_id: p.session_id,
+                from: p.from,
+                to: p.to,
+                message: p.message,
+                type: p.type || 'message',
+                delivery_method: p.delivery_method || 'inject',
+                data: p.data,
+            });
+        }
+        case 'read': {
+            if (!p.role)
+                return { success: false, error: 'read requires "role"' };
+            return opReadMailbox({
+                session_id: p.session_id,
+                role: p.role,
+                limit: p.limit || 50,
+                mark_delivered: p.mark_delivered !== false,
+            });
+        }
+        case 'status': {
+            return opMailboxStatus({ session_id: p.session_id });
+        }
+        default:
+            return { success: false, error: `Unknown operation: ${p.operation}` };
+    }
+}
+//# sourceMappingURL=team-mailbox.js.map

package/dist/src/tools/team-mailbox.js.map

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

package/dist/src/tools/team-msg.d.ts

@@ -2,14 +2,16 @@
  * Team Message Bus - JSONL-based persistent message log for Agent Teams
  *
  * Operations:
- * - log:       Append a message (to defaults to "coordinator", summary auto-generated if omitted)
- * - read:      Read message(s) by ID
- * - list:      List recent messages with optional filters (from/to/type/last N)
- * - status:    Summarize team member activity from message history
- * - delete:    Delete a specific message by ID
- * - clear:     Clear all messages for a team
- * - broadcast: Log a message with to="all"
- * - get_state: Read role state from meta.json
+ * - log:            Append a message (to defaults to "coordinator", summary auto-generated if omitted)
+ * - read:           Read message(s) by ID
+ * - list:           List recent messages with optional filters (from/to/type/last N)
+ * - status:         Summarize team member activity from message history
+ * - delete:         Delete a specific message by ID
+ * - clear:          Clear all messages for a team
+ * - broadcast:      Log a message with to="all"
+ * - get_state:      Read role state from meta.json
+ * - read_mailbox:   Read unread messages for a role and mark them as delivered
+ * - mailbox_status: Return counts of pending/notified/delivered/failed per role
  */
 import type { ToolSchema, CcwToolResult } from '../types/tool-schema.js';
 export interface TeamMeta {
@@ -29,6 +31,8 @@ export declare function readTeamMeta(team: string): TeamMeta | null;
 export declare function writeTeamMeta(team: string, meta: TeamMeta): void;
 export declare function inferTeamStatus(team: string): TeamMeta['status'];
 export declare function getEffectiveTeamMeta(team: string): TeamMeta;
+/** Dispatch status lifecycle: pending -> notified -> delivered (or failed) */
+export type DispatchStatus = 'pending' | 'notified' | 'delivered' | 'failed';
 export interface TeamMessage {
     id: string;
     ts: string;
@@ -37,6 +41,11 @@ export interface TeamMessage {
     type: string;
     summary: string;
     data?: Record<string, unknown>;
+    dispatch_status?: DispatchStatus;
+    delivery_method?: string;
+    notified_at?: string;
+    delivered_at?: string;
+    failed_at?: string;
 }
 export interface StatusEntry {
     member: string;

package/dist/src/tools/team-msg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"team-msg.d.ts","sourceRoot":"","sources":["../../../src/tools/team-msg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAOzE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQ1D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAMhE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAKhE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA4C3D;AA+CD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AA4BD,eAAO,MAAM,MAAM,EAAE,UAmEpB,CAAC;AAIF,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAO/D;AAkBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAc7D;AAoMD,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAyBrF"}
+{"version":3,"file":"team-msg.d.ts","sourceRoot":"","sources":["../../../src/tools/team-msg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAOzE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQ1D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAMhE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAKhE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA4C3D;AA+CD,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AA6BD,eAAO,MAAM,MAAM,EAAE,UA4EpB,CAAC;AAIF,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAO/D;AAkBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAc7D;AAqSD,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CA2BrF"}

package/dist/src/tools/team-msg.js

@@ -2,14 +2,16 @@
  * Team Message Bus - JSONL-based persistent message log for Agent Teams
  *
  * Operations:
- * - log:       Append a message (to defaults to "coordinator", summary auto-generated if omitted)
- * - read:      Read message(s) by ID
- * - list:      List recent messages with optional filters (from/to/type/last N)
- * - status:    Summarize team member activity from message history
- * - delete:    Delete a specific message by ID
- * - clear:     Clear all messages for a team
- * - broadcast: Log a message with to="all"
- * - get_state: Read role state from meta.json
+ * - log:            Append a message (to defaults to "coordinator", summary auto-generated if omitted)
+ * - read:           Read message(s) by ID
+ * - list:           List recent messages with optional filters (from/to/type/last N)
+ * - status:         Summarize team member activity from message history
+ * - delete:         Delete a specific message by ID
+ * - clear:          Clear all messages for a team
+ * - broadcast:      Log a message with to="all"
+ * - get_state:      Read role state from meta.json
+ * - read_mailbox:   Read unread messages for a role and mark them as delivered
+ * - mailbox_status: Return counts of pending/notified/delivered/failed per role
  */
 import { z } from 'zod';
 import { existsSync, mkdirSync, readFileSync, appendFileSync, writeFileSync, rmSync, statSync } from 'fs';
@@ -136,7 +138,7 @@ function readLegacyFiles(team) {
 }
 // --- Zod Schema ---
 const ParamsSchema = z.object({
-    operation: z.enum(['log', 'read', 'list', 'status', 'delete', 'clear', 'broadcast', 'get_state']).describe('Operation to perform'),
+    operation: z.enum(['log', 'read', 'list', 'status', 'delete', 'clear', 'broadcast', 'get_state', 'read_mailbox', 'mailbox_status']).describe('Operation to perform'),
     session_id: z.string().optional().describe('Session ID that determines message storage path'),
     team_session_id: z.string().optional().describe('[deprecated] Use session_id'),
     team: z.string().optional().describe('[deprecated] Use session_id'),
@@ -147,8 +149,9 @@ const ParamsSchema = z.object({
     data: z.record(z.string(), z.unknown()).optional().describe('[log/broadcast] Structured data payload'),
     id: z.string().optional().describe('[read/delete] Message ID'),
     last: z.number().min(1).max(100).optional().describe('[list] Return last N messages'),
-    role: z.string().optional().describe('[get_state] Role name to query'),
+    role: z.string().optional().describe('[get_state/read_mailbox] Role name to query'),
     ref: z.string().optional().describe('[deprecated] Use data.ref instead'),
+    delivery_method: z.string().optional().describe('[log] Delivery method for dispatch tracking'),
 });
 function resolveTeamId(params) {
     return params.session_id || params.team_session_id || params.team || null;
@@ -169,6 +172,7 @@ export const schema = {
     *   *type* (string): Message type (default: "message").
     *   *summary* (string): One-line summary (auto-generated if omitted).
     *   *data* (object): Structured data payload.
+    *   *delivery_method* (string): Delivery method for dispatch tracking.
 
 *   **broadcast**: Send message to all team members.
     *   **session_id** (string, **REQUIRED**): Session ID.
@@ -189,6 +193,13 @@ export const schema = {
     *   **session_id** (string, **REQUIRED**): Session ID.
     *   *role* (string): Role name to query.
 
+*   **read_mailbox**: Read unread messages for a role and mark them delivered.
+    *   **session_id** (string, **REQUIRED**): Session ID.
+    *   **role** (string, **REQUIRED**): Role name whose mailbox to read.
+
+*   **mailbox_status**: Return dispatch status counts per role.
+    *   **session_id** (string, **REQUIRED**): Session ID.
+
 *   **delete**: Delete a message by ID.
     *   **session_id** (string, **REQUIRED**): Session ID.
     *   **id** (string, **REQUIRED**): Message ID.
@@ -200,7 +211,7 @@ export const schema = {
         properties: {
             operation: {
                 type: 'string',
-                enum: ['log', 'read', 'list', 'status', 'delete', 'clear', 'broadcast', 'get_state'],
+                enum: ['log', 'read', 'list', 'status', 'delete', 'clear', 'broadcast', 'get_state', 'read_mailbox', 'mailbox_status'],
                 description: 'Operation to perform',
             },
             session_id: {
@@ -214,7 +225,8 @@ export const schema = {
             data: { type: 'object', description: '[log/broadcast] Structured data' },
             id: { type: 'string', description: '[read/delete] Message ID' },
             last: { type: 'number', description: '[list] Last N messages', minimum: 1, maximum: 100 },
-            role: { type: 'string', description: '[get_state] Role name to query' },
+            role: { type: 'string', description: '[get_state/read_mailbox] Role name to query' },
+            delivery_method: { type: 'string', description: '[log] Delivery method for dispatch tracking' },
             team_session_id: { type: 'string', description: '[deprecated] Use session_id' },
             team: { type: 'string', description: '[deprecated] Use session_id' },
             ref: { type: 'string', description: '[deprecated] Use data.ref instead' },
@@ -290,16 +302,27 @@ function opLog(params, teamId) {
     const logPath = ensureLogFile(teamId);
     const messages = readAllMessages(teamId);
     const id = getNextId(messages);
+    const now = nowISO();
+    // When delivery_method is provided, the message starts as 'pending' (explicit delivery).
+    // When no delivery_method, it's a legacy direct message and defaults to 'delivered'.
+    const dispatchStatus = params.delivery_method ? 'pending' : 'delivered';
     const msg = {
         id,
-        ts: nowISO(),
+        ts: now,
         from: params.from,
         to,
         type: params.type || 'message',
         summary,
+        dispatch_status: dispatchStatus,
     };
     if (params.data)
         msg.data = params.data;
+    if (params.delivery_method)
+        msg.delivery_method = params.delivery_method;
+    // Set delivered_at for legacy messages (backward compat)
+    if (dispatchStatus === 'delivered') {
+        msg.delivered_at = now;
+    }
     appendFileSync(logPath, JSON.stringify(msg) + '\n', 'utf-8');
     if (params.type === 'state_update' && params.data) {
         const meta = getEffectiveTeamMeta(teamId);
@@ -422,6 +445,78 @@ function opClear(params, teamId) {
     rmSync(dir, { recursive: true, force: true });
     return { success: true, result: { cleared: count, message: `Cleared ${count} messages for team "${teamId}".` } };
 }
+/** Rewrite all messages to the JSONL file (used for batch status updates). */
+function writeAllMessages(teamId, messages) {
+    const logPath = ensureLogFile(teamId);
+    writeFileSync(logPath, messages.map(m => JSON.stringify(m)).join('\n') + (messages.length > 0 ? '\n' : ''), 'utf-8');
+}
+function opReadMailbox(params, teamId) {
+    if (!params.role)
+        return { success: false, error: 'read_mailbox requires "role"' };
+    const messages = readAllMessages(teamId);
+    const now = nowISO();
+    // Find messages addressed to this role that are pending or notified (unread)
+    const unreadStatuses = ['pending', 'notified'];
+    const unreadIndices = [];
+    const unreadMessages = [];
+    for (let i = 0; i < messages.length; i++) {
+        const m = messages[i];
+        if (m.to === params.role && unreadStatuses.includes(m.dispatch_status ?? 'delivered')) {
+            unreadIndices.push(i);
+            unreadMessages.push(m);
+        }
+    }
+    // Batch-update dispatch_status to 'delivered' with delivered_at timestamp
+    if (unreadIndices.length > 0) {
+        for (const idx of unreadIndices) {
+            messages[idx] = {
+                ...messages[idx],
+                dispatch_status: 'delivered',
+                delivered_at: now,
+            };
+        }
+        writeAllMessages(teamId, messages);
+    }
+    return {
+        success: true,
+        result: {
+            role: params.role,
+            count: unreadMessages.length,
+            messages: unreadMessages,
+            formatted: unreadMessages.length > 0
+                ? unreadMessages.map(m => `${m.id} [${m.ts.substring(11, 19)}] ${m.from} → ${m.to} (${m.type}) ${m.summary}`).join('\n')
+                : `No unread messages for role "${params.role}".`,
+        },
+    };
+}
+function opMailboxStatus(params, teamId) {
+    const messages = readAllMessages(teamId);
+    // Group dispatch counts by role (using the "to" field)
+    const counts = {};
+    for (const msg of messages) {
+        const role = msg.to;
+        if (!counts[role]) {
+            counts[role] = { pending: 0, notified: 0, delivered: 0, failed: 0 };
+        }
+        // Backward compat: messages without dispatch_status default to 'delivered'
+        const status = msg.dispatch_status ?? 'delivered';
+        counts[role][status]++;
+    }
+    // Format as a summary table
+    const roles = Object.keys(counts).sort();
+    const formatted = roles.map(role => {
+        const c = counts[role];
+        return `${role.padEnd(12)} | pending: ${c.pending} | notified: ${c.notified} | delivered: ${c.delivered} | failed: ${c.failed}`;
+    }).join('\n');
+    return {
+        success: true,
+        result: {
+            roles: counts,
+            total_messages: messages.length,
+            formatted: formatted || 'No messages recorded yet.',
+        },
+    };
+}
 // --- Handler ---
 export async function handler(params) {
     const parsed = ParamsSchema.safeParse(params);
@@ -442,6 +537,8 @@ export async function handler(params) {
         case 'clear': return opClear(p, teamId);
         case 'broadcast': return opBroadcast(p, teamId);
         case 'get_state': return opGetState(p, teamId);
+        case 'read_mailbox': return opReadMailbox(p, teamId);
+        case 'mailbox_status': return opMailboxStatus(p, teamId);
         default:
             return { success: false, error: `Unknown operation: ${p.operation}` };
     }