maestro-flow 0.3.9 → 0.3.11

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

@@ -0,0 +1,362 @@
+/**
+ * Team Agents - MCP tools for agent lifecycle management via delegate broker
+ *
+ * Tools:
+ * - team_spawn_agent:    Spawn a new agent (register session + create job)
+ * - team_shutdown_agent: Cancel a running agent's delegate job
+ * - team_remove_agent:   Remove agent from team config
+ * - team_members:        List team members with live status from broker
+ *
+ * Storage: .workflow/.team/{session-id}/members.json
+ *
+ * Integration:
+ * - Delegate broker for job lifecycle (registerSession, publishEvent, requestCancel)
+ * - Team config (members.json) for persistent member registry
+ */
+import { z } from 'zod';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { getProjectRoot } from '../utils/path-validator.js';
+import { createDefaultDelegateBroker } from '../async/delegate-broker.js';
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+function getTeamDir(sessionId) {
+    const dir = join(getProjectRoot(), '.workflow', '.team', sessionId);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+function getMembersPath(sessionId) {
+    return join(getTeamDir(sessionId), 'members.json');
+}
+function readMembers(sessionId) {
+    const path = getMembersPath(sessionId);
+    if (!existsSync(path))
+        return [];
+    try {
+        const raw = readFileSync(path, 'utf-8');
+        const config = JSON.parse(raw);
+        return Array.isArray(config.members) ? config.members : [];
+    }
+    catch {
+        return [];
+    }
+}
+function writeMembers(sessionId, members) {
+    const path = getMembersPath(sessionId);
+    writeFileSync(path, JSON.stringify({ members }, null, 2), 'utf-8');
+}
+/** Derive a deterministic job ID from session + role. */
+function deriveJobId(sessionId, role) {
+    return `${sessionId}-${role}`;
+}
+function nowISO() {
+    return new Date().toISOString();
+}
+// ---------------------------------------------------------------------------
+// Broker helpers (lazy initialization)
+// ---------------------------------------------------------------------------
+function getBroker() {
+    return createDefaultDelegateBroker();
+}
+// ---------------------------------------------------------------------------
+// Operations
+// ---------------------------------------------------------------------------
+function opSpawnAgent(params) {
+    const { session_id, role, prompt } = params;
+    const tool = params.tool || 'gemini';
+    // Ensure session is registered with broker
+    const broker = getBroker();
+    broker.registerSession({
+        sessionId: session_id,
+        metadata: { source: 'team-agents', role },
+    });
+    // Derive deterministic job ID
+    const jobId = deriveJobId(session_id, role);
+    // Create a 'queued' event to register the job with the broker
+    const event = broker.publishEvent({
+        jobId,
+        type: 'queued',
+        payload: {
+            summary: `Agent spawned: ${role}`,
+            prompt: prompt.substring(0, 200),
+            tool,
+        },
+        jobMetadata: {
+            role,
+            tool,
+            sessionId: session_id,
+        },
+    });
+    const execId = `agent-${event.eventId}`;
+    // Persist member entry
+    const members = readMembers(session_id);
+    const existing = members.find(m => m.role === role);
+    if (existing) {
+        return {
+            success: false,
+            error: `Agent with role "${role}" already exists in session ${session_id}`,
+        };
+    }
+    const member = {
+        role,
+        tool,
+        prompt,
+        job_id: jobId,
+        exec_id: execId,
+        spawned_at: nowISO(),
+    };
+    members.push(member);
+    writeMembers(session_id, members);
+    return {
+        success: true,
+        result: {
+            job_id: jobId,
+            exec_id: execId,
+            role,
+            tool,
+        },
+    };
+}
+function opShutdownAgent(params) {
+    const { session_id, role } = params;
+    const members = readMembers(session_id);
+    const member = members.find(m => m.role === role);
+    if (!member) {
+        return {
+            success: false,
+            error: `Agent with role "${role}" not found in session ${session_id}`,
+        };
+    }
+    const broker = getBroker();
+    const job = broker.getJob(member.job_id);
+    if (!job) {
+        return {
+            success: false,
+            error: `No delegate job found for ${role} (${member.job_id})`,
+        };
+    }
+    // Skip if already terminal or cancel already requested
+    const terminalStatuses = new Set(['completed', 'failed', 'cancelled']);
+    if (terminalStatuses.has(job.status)) {
+        return {
+            success: true,
+            result: {
+                job_id: member.job_id,
+                role,
+                status: job.status,
+                message: `Job ${member.job_id} is already ${job.status}`,
+            },
+        };
+    }
+    if (job.metadata?.cancelRequestedAt) {
+        return {
+            success: true,
+            result: {
+                job_id: member.job_id,
+                role,
+                status: job.status,
+                message: `Job ${member.job_id} already has a pending cancel request`,
+            },
+        };
+    }
+    broker.requestCancel({
+        jobId: member.job_id,
+        requestedBy: 'team-agents',
+        reason: `Shutdown requested for agent role: ${role}`,
+    });
+    return {
+        success: true,
+        result: {
+            job_id: member.job_id,
+            role,
+            status: 'cancelling',
+            message: `Shutdown requested for agent "${role}"`,
+        },
+    };
+}
+function opRemoveAgent(params) {
+    const { session_id, role } = params;
+    const members = readMembers(session_id);
+    const idx = members.findIndex(m => m.role === role);
+    if (idx === -1) {
+        return {
+            success: false,
+            error: `Agent with role "${role}" not found in session ${session_id}`,
+        };
+    }
+    const removed = members.splice(idx, 1)[0];
+    writeMembers(session_id, members);
+    return {
+        success: true,
+        result: {
+            role: removed.role,
+            job_id: removed.job_id,
+            message: `Removed agent "${role}" from session ${session_id}`,
+        },
+    };
+}
+function opMembers(params) {
+    const { session_id } = params;
+    const members = readMembers(session_id);
+    if (members.length === 0) {
+        return {
+            success: true,
+            result: {
+                members: [],
+                total: 0,
+                formatted: `No agents registered in session ${session_id}.`,
+            },
+        };
+    }
+    const broker = getBroker();
+    const terminalStatuses = new Set(['completed', 'failed', 'cancelled']);
+    const result = members.map(m => {
+        const job = broker.getJob(m.job_id);
+        let status = 'offline';
+        if (job) {
+            if (terminalStatuses.has(job.status)) {
+                status = 'idle';
+            }
+            else if (job.metadata?.cancelRequestedAt) {
+                // Cancel was requested but job not yet terminal
+                status = 'idle';
+            }
+            else if (job.status === 'running' || job.status === 'queued' || job.status === 'input_required') {
+                status = 'running';
+            }
+        }
+        return {
+            role: m.role,
+            status,
+            tool: m.tool,
+            job_id: m.job_id,
+            spawned_at: m.spawned_at,
+        };
+    });
+    const formatted = result.map(m => `${m.role.padEnd(16)} | status: ${m.status.padEnd(7)} | tool: ${m.tool} | job: ${m.job_id}`).join('\n');
+    return {
+        success: true,
+        result: {
+            members: result,
+            total: result.length,
+            formatted,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Zod Schema
+// ---------------------------------------------------------------------------
+const ParamsSchema = z.object({
+    operation: z
+        .enum(['spawn_agent', 'shutdown_agent', 'remove_agent', 'members'])
+        .describe('Operation to perform'),
+    session_id: z.string().describe('Session ID for team namespace scoping'),
+    // spawn_agent params
+    role: z.string().optional().describe('[spawn/shutdown/remove] Agent role name'),
+    prompt: z.string().optional().describe('[spawn] Prompt/instructions for the agent'),
+    tool: z.string().optional().describe('[spawn] CLI tool to use (default: gemini)'),
+});
+// ---------------------------------------------------------------------------
+// Tool Schema
+// ---------------------------------------------------------------------------
+export const schema = {
+    name: 'team_agent',
+    description: `Team agent lifecycle management - spawn, shutdown, remove agents via delegate broker.
+
+**Storage Location:** .workflow/.team/{session_id}/members.json
+
+**Operations & Required Parameters:**
+
+*   **spawn_agent**: Spawn a new agent in the team.
+    *   **session_id** (string, **REQUIRED**): Session ID.
+    *   **role** (string, **REQUIRED**): Unique role name for the agent.
+    *   **prompt** (string, **REQUIRED**): Instructions for the agent.
+    *   *tool* (string): CLI tool to use (default: "gemini").
+
+*   **shutdown_agent**: Cancel a running agent's delegate job.
+    *   **session_id** (string, **REQUIRED**): Session ID.
+    *   **role** (string, **REQUIRED**): Role name of the agent to shut down.
+
+*   **remove_agent**: Remove agent from team config.
+    *   **session_id** (string, **REQUIRED**): Session ID.
+    *   **role** (string, **REQUIRED**): Role name to remove.
+
+*   **members**: List team members with live status from broker.
+    *   **session_id** (string, **REQUIRED**): Session ID.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['spawn_agent', 'shutdown_agent', 'remove_agent', 'members'],
+                description: 'Operation to perform',
+            },
+            session_id: {
+                type: 'string',
+                description: 'Session ID for team namespace scoping',
+            },
+            role: {
+                type: 'string',
+                description: '[spawn/shutdown/remove] Agent role name',
+            },
+            prompt: {
+                type: 'string',
+                description: '[spawn] Prompt/instructions for the agent',
+            },
+            tool: {
+                type: 'string',
+                description: '[spawn] CLI tool to use (default: "gemini")',
+            },
+        },
+        required: ['operation', 'session_id'],
+    },
+};
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export async function handler(params) {
+    const parsed = ParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        return { success: false, error: `Invalid params: ${parsed.error.message}` };
+    }
+    const p = parsed.data;
+    switch (p.operation) {
+        case 'spawn_agent': {
+            if (!p.role)
+                return { success: false, error: 'spawn_agent requires "role"' };
+            if (!p.prompt)
+                return { success: false, error: 'spawn_agent requires "prompt"' };
+            return opSpawnAgent({
+                session_id: p.session_id,
+                role: p.role,
+                prompt: p.prompt,
+                tool: p.tool,
+            });
+        }
+        case 'shutdown_agent': {
+            if (!p.role)
+                return { success: false, error: 'shutdown_agent requires "role"' };
+            return opShutdownAgent({
+                session_id: p.session_id,
+                role: p.role,
+            });
+        }
+        case 'remove_agent': {
+            if (!p.role)
+                return { success: false, error: 'remove_agent requires "role"' };
+            return opRemoveAgent({
+                session_id: p.session_id,
+                role: p.role,
+            });
+        }
+        case 'members': {
+            return opMembers({ session_id: p.session_id });
+        }
+        default:
+            return { success: false, error: `Unknown operation: ${p.operation}` };
+    }
+}
+//# sourceMappingURL=team-agents.js.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * 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 type { ToolSchema, CcwToolResult } from '../types/tool-schema.js';
+export type DeliveryMethod = 'inject' | 'poll' | 'broadcast';
+export type DeliveryStatus = 'pending' | 'notified' | 'delivered' | 'failed';
+export interface MailboxMessage {
+    id: string;
+    ts: string;
+    from: string;
+    to: string;
+    type: string;
+    message: string;
+    delivery_method: DeliveryMethod;
+    delivery_status: DeliveryStatus;
+    delivered_at?: string;
+    data?: Record<string, unknown>;
+}
+export interface MailboxRoleStatus {
+    role: string;
+    pending: number;
+    notified: number;
+    delivered: number;
+    failed: number;
+}
+export declare const schema: ToolSchema;
+export declare function handler(params: Record<string, unknown>): Promise<CcwToolResult>;
+//# sourceMappingURL=team-mailbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team-mailbox.d.ts","sourceRoot":"","sources":["../../../src/tools/team-mailbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAQzE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAC7D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,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,eAAe,EAAE,cAAc,CAAC;IAChC,eAAe,EAAE,cAAc,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAuQD,eAAO,MAAM,MAAM,EAAE,UA+EpB,CAAC;AAwBF,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CA0CrF"}