maestro-flow 0.3.14 → 0.3.16

package/dashboard/dist-server/dashboard/src/server/rooms/meeting-room-session.d.ts

@@ -0,0 +1,51 @@
+import type { DashboardEventBus } from '../state/event-bus.js';
+import type { AgentManager } from '../agents/agent-manager.js';
+import type { McpSdkServerConfigWithInstance, McpStdioServerConfig } from '@anthropic-ai/claude-agent-sdk';
+import { RoomMailbox } from './room-mailbox.js';
+import { RoomTaskBoard } from './room-task-board.js';
+import { RoomAgentRegistry } from './room-agent-registry.js';
+import type { MeetingRoomMcpServerInfo } from './mcp-server/meeting-room-mcp-server.js';
+import type { StdioMcpConfig } from './mcp-server/mcp-config-builder.js';
+import type { RoomSessionStatus, RoomSessionSnapshot, RoomMailboxMessage, RoomTask, RoomTaskCreate, RoomTaskUpdate, RoomAgent, RoomAgentStatus, MessagePriority } from './room-types.js';
+export type RoomMcpAgentType = 'claude-code' | 'codex' | 'agent-sdk';
+export declare class MeetingRoomSession {
+    private readonly eventBus;
+    readonly sessionId: string;
+    private status;
+    private readonly createdAt;
+    readonly mailbox: RoomMailbox;
+    readonly taskBoard: RoomTaskBoard;
+    readonly agentRegistry: RoomAgentRegistry;
+    private mcpServer;
+    private mcpServerInfo;
+    constructor(sessionId: string, eventBus: DashboardEventBus, agentManager: AgentManager);
+    addAgent(role: string, processId?: string): RoomAgent;
+    removeAgent(role: string): boolean;
+    setAgentStatus(role: string, status: RoomAgentStatus): boolean;
+    getAgents(): RoomAgent[];
+    /** Send a message to a specific agent, write to mailbox + emit event + wake agent */
+    sendMessage(from: string, to: string, content: string, priority?: MessagePriority): Promise<RoomMailboxMessage>;
+    /** Broadcast a message to all agents */
+    broadcastMessage(from: string, content: string, priority?: MessagePriority): Promise<RoomMailboxMessage>;
+    createTask(input: RoomTaskCreate): RoomTask;
+    updateTask(taskId: string, patch: RoomTaskUpdate): RoomTask | undefined;
+    getTasks(): RoomTask[];
+    /** Start the MCP TCP server. Must be called before getMcpConfig(). */
+    startMcp(): Promise<MeetingRoomMcpServerInfo>;
+    /** Stop the MCP TCP server and release resources. */
+    stopMcp(): Promise<void>;
+    /** Get MCP server info (port + token) for HTTP transport. */
+    getMcpInfo(): MeetingRoomMcpServerInfo | null;
+    /**
+     * Get MCP config for a specific adapter type and agent.
+     * - 'claude-code': returns McpStdioServerConfig for --mcp-config
+     * - 'codex': returns StdioMcpConfig with env vars
+     * - 'agent-sdk': returns McpSdkServerConfigWithInstance for in-process SDK
+     */
+    getMcpConfig(agentType: RoomMcpAgentType, agentId: string): McpStdioServerConfig | StdioMcpConfig | McpSdkServerConfigWithInstance;
+    getSnapshot(): RoomSessionSnapshot;
+    getStatus(): RoomSessionStatus;
+    pause(): void;
+    resume(): void;
+    destroy(): Promise<void>;
+}

package/dashboard/dist-server/dashboard/src/server/rooms/meeting-room-session.js

@@ -0,0 +1,185 @@
+// ---------------------------------------------------------------------------
+// MeetingRoomSession — thin coordinator composing subsystems + EventBus
+// ---------------------------------------------------------------------------
+import { RoomMailbox } from './room-mailbox.js';
+import { RoomTaskBoard } from './room-task-board.js';
+import { RoomAgentRegistry } from './room-agent-registry.js';
+import { MeetingRoomMcpServer } from './mcp-server/meeting-room-mcp-server.js';
+import { getStdioConfig, getClaudeCodeConfig, getSdkMcpServer, } from './mcp-server/mcp-config-builder.js';
+export class MeetingRoomSession {
+    eventBus;
+    sessionId;
+    status = 'active';
+    createdAt;
+    mailbox;
+    taskBoard;
+    agentRegistry;
+    mcpServer = null;
+    mcpServerInfo = null;
+    constructor(sessionId, eventBus, agentManager) {
+        this.eventBus = eventBus;
+        this.sessionId = sessionId;
+        this.createdAt = new Date().toISOString();
+        this.mailbox = new RoomMailbox();
+        this.taskBoard = new RoomTaskBoard();
+        this.agentRegistry = new RoomAgentRegistry(agentManager);
+    }
+    // --- Agent management ---
+    addAgent(role, processId) {
+        const agent = this.agentRegistry.register(this.sessionId, role, processId);
+        this.eventBus.emit('team:agent_status', {
+            role: agent.role,
+            status: agent.status,
+            lastActivity: agent.lastActivityAt,
+        });
+        return agent;
+    }
+    removeAgent(role) {
+        const removed = this.agentRegistry.unregister(this.sessionId, role);
+        if (removed) {
+            this.eventBus.emit('team:agent_status', {
+                role,
+                status: 'offline',
+                lastActivity: new Date().toISOString(),
+            });
+        }
+        return removed;
+    }
+    setAgentStatus(role, status) {
+        const updated = this.agentRegistry.setStatus(this.sessionId, role, status);
+        if (updated) {
+            const agent = this.agentRegistry.getAgentByRole(this.sessionId, role);
+            if (agent) {
+                this.eventBus.emit('team:agent_status', {
+                    role: agent.role,
+                    status: agent.status,
+                    lastActivity: agent.lastActivityAt,
+                });
+            }
+        }
+        return updated;
+    }
+    getAgents() {
+        return this.agentRegistry.getAgents(this.sessionId);
+    }
+    // --- Messaging ---
+    /** Send a message to a specific agent, write to mailbox + emit event + wake agent */
+    async sendMessage(from, to, content, priority = 'normal') {
+        const msg = this.mailbox.write(this.sessionId, from, to, content, priority);
+        this.eventBus.emit('team:message', {
+            id: msg.id,
+            from: msg.from,
+            to: msg.to,
+            content: msg.content,
+            dispatch_status: 'pending',
+            timestamp: msg.createdAt,
+        });
+        // Wake the target agent
+        if (to !== '*') {
+            await this.agentRegistry.wake(this.sessionId, to, content);
+        }
+        return msg;
+    }
+    /** Broadcast a message to all agents */
+    async broadcastMessage(from, content, priority = 'normal') {
+        const msg = this.mailbox.write(this.sessionId, from, '*', content, priority);
+        this.eventBus.emit('team:dispatch', {
+            id: msg.id,
+            from: msg.from,
+            to: '*',
+            content: msg.content,
+            dispatch_status: 'pending',
+            timestamp: msg.createdAt,
+        });
+        // Wake all agents
+        const agents = this.agentRegistry.getAgents(this.sessionId);
+        await Promise.allSettled(agents.map((agent) => this.agentRegistry.wake(this.sessionId, agent.role, content)));
+        return msg;
+    }
+    // --- Task management ---
+    createTask(input) {
+        return this.taskBoard.create(this.sessionId, input);
+    }
+    updateTask(taskId, patch) {
+        const task = this.taskBoard.update(this.sessionId, taskId, patch);
+        // If task was marked completed, cascade unblocks
+        if (task && patch.status === 'completed') {
+            this.taskBoard.checkUnblocks(this.sessionId, taskId);
+        }
+        return task;
+    }
+    getTasks() {
+        return this.taskBoard.list(this.sessionId);
+    }
+    // --- MCP server lifecycle ---
+    /** Start the MCP TCP server. Must be called before getMcpConfig(). */
+    async startMcp() {
+        if (this.mcpServer) {
+            return this.mcpServer.getInfo();
+        }
+        this.mcpServer = new MeetingRoomMcpServer(this);
+        this.mcpServerInfo = await this.mcpServer.start();
+        return this.mcpServerInfo;
+    }
+    /** Stop the MCP TCP server and release resources. */
+    async stopMcp() {
+        if (this.mcpServer) {
+            await this.mcpServer.destroy();
+            this.mcpServer = null;
+            this.mcpServerInfo = null;
+        }
+    }
+    /** Get MCP server info (port + token) for HTTP transport. */
+    getMcpInfo() {
+        return this.mcpServerInfo;
+    }
+    /**
+     * Get MCP config for a specific adapter type and agent.
+     * - 'claude-code': returns McpStdioServerConfig for --mcp-config
+     * - 'codex': returns StdioMcpConfig with env vars
+     * - 'agent-sdk': returns McpSdkServerConfigWithInstance for in-process SDK
+     */
+    getMcpConfig(agentType, agentId) {
+        if (agentType === 'agent-sdk') {
+            // SDK adapter uses in-process server -- no TCP needed
+            return getSdkMcpServer(this, agentId);
+        }
+        // CLI adapters need the TCP server running
+        if (!this.mcpServerInfo) {
+            throw new Error('MCP server not started. Call startMcp() first.');
+        }
+        if (agentType === 'claude-code') {
+            return getClaudeCodeConfig(agentId, this.mcpServerInfo);
+        }
+        // Default: stdio config (codex and other CLI adapters)
+        return getStdioConfig(agentId, this.mcpServerInfo);
+    }
+    // --- Session lifecycle ---
+    getSnapshot() {
+        return {
+            sessionId: this.sessionId,
+            status: this.status,
+            agents: this.agentRegistry.getAgents(this.sessionId),
+            messages: this.mailbox.getHistory(this.sessionId),
+            tasks: this.taskBoard.list(this.sessionId),
+            createdAt: this.createdAt,
+        };
+    }
+    getStatus() {
+        return this.status;
+    }
+    pause() {
+        this.status = 'paused';
+    }
+    resume() {
+        this.status = 'active';
+    }
+    async destroy() {
+        this.status = 'destroyed';
+        await this.stopMcp();
+        this.mailbox.clear(this.sessionId);
+        this.taskBoard.clear(this.sessionId);
+        this.agentRegistry.clear(this.sessionId);
+    }
+}
+//# sourceMappingURL=meeting-room-session.js.map

package/dashboard/dist-server/dashboard/src/server/rooms/meeting-room-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meeting-room-session.js","sourceRoot":"","sources":["../../../../../src/server/rooms/meeting-room-session.ts"],"names":[],"mappings":"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"}

package/dashboard/dist-server/dashboard/src/server/rooms/room-agent-registry.d.ts

@@ -0,0 +1,29 @@
+import type { AgentManager } from '../agents/agent-manager.js';
+import type { RoomAgent, RoomAgentStatus } from './room-types.js';
+export declare class RoomAgentRegistry {
+    private readonly agentManager;
+    private readonly wakeTimeoutMs;
+    private readonly agents;
+    private readonly activeWakes;
+    private readonly wakeTimeouts;
+    constructor(agentManager: AgentManager, wakeTimeoutMs?: number);
+    /** Register an agent in a session */
+    register(sessionId: string, role: string, processId?: string): RoomAgent;
+    /** Unregister an agent from a session */
+    unregister(sessionId: string, role: string): boolean;
+    /** Get all agents in a session */
+    getAgents(sessionId: string): RoomAgent[];
+    /** Get a specific agent by role in a session */
+    getAgentByRole(sessionId: string, role: string): RoomAgent | undefined;
+    /** Update agent status */
+    setStatus(sessionId: string, role: string, status: RoomAgentStatus): boolean;
+    /**
+     * Wake an agent by sending a message to its process.
+     * Uses an activeWakes guard set to prevent concurrent wake calls for the same agent.
+     * Guard auto-clears after wakeTimeoutMs.
+     */
+    wake(sessionId: string, role: string, message: string): Promise<boolean>;
+    /** Clear all agents for a session */
+    clear(sessionId: string): void;
+    private clearWakeGuard;
+}

package/dashboard/dist-server/dashboard/src/server/rooms/room-agent-registry.js

@@ -0,0 +1,125 @@
+// ---------------------------------------------------------------------------
+// RoomAgentRegistry — agent lifecycle management with activeWakes guard
+// ---------------------------------------------------------------------------
+const DEFAULT_WAKE_TIMEOUT_MS = 5_000;
+export class RoomAgentRegistry {
+    agentManager;
+    wakeTimeoutMs;
+    agents = new Map();
+    activeWakes = new Set(); // "sessionId:role" keys
+    wakeTimeouts = new Map();
+    constructor(agentManager, wakeTimeoutMs = DEFAULT_WAKE_TIMEOUT_MS) {
+        this.agentManager = agentManager;
+        this.wakeTimeoutMs = wakeTimeoutMs;
+    }
+    /** Register an agent in a session */
+    register(sessionId, role, processId) {
+        const now = new Date().toISOString();
+        const agent = {
+            role,
+            processId,
+            status: 'idle',
+            joinedAt: now,
+            lastActivityAt: now,
+        };
+        let list = this.agents.get(sessionId);
+        if (!list) {
+            list = [];
+            this.agents.set(sessionId, list);
+        }
+        // Replace existing agent with same role if present
+        const existingIdx = list.findIndex((a) => a.role === role);
+        if (existingIdx !== -1) {
+            list[existingIdx] = agent;
+        }
+        else {
+            list.push(agent);
+        }
+        return agent;
+    }
+    /** Unregister an agent from a session */
+    unregister(sessionId, role) {
+        const list = this.agents.get(sessionId);
+        if (!list)
+            return false;
+        const idx = list.findIndex((a) => a.role === role);
+        if (idx === -1)
+            return false;
+        list.splice(idx, 1);
+        // Clean up wake guard
+        const wakeKey = `${sessionId}:${role}`;
+        this.clearWakeGuard(wakeKey);
+        return true;
+    }
+    /** Get all agents in a session */
+    getAgents(sessionId) {
+        return this.agents.get(sessionId) ?? [];
+    }
+    /** Get a specific agent by role in a session */
+    getAgentByRole(sessionId, role) {
+        const list = this.agents.get(sessionId);
+        if (!list)
+            return undefined;
+        return list.find((a) => a.role === role);
+    }
+    /** Update agent status */
+    setStatus(sessionId, role, status) {
+        const agent = this.getAgentByRole(sessionId, role);
+        if (!agent)
+            return false;
+        agent.status = status;
+        agent.lastActivityAt = new Date().toISOString();
+        return true;
+    }
+    /**
+     * Wake an agent by sending a message to its process.
+     * Uses an activeWakes guard set to prevent concurrent wake calls for the same agent.
+     * Guard auto-clears after wakeTimeoutMs.
+     */
+    async wake(sessionId, role, message) {
+        const agent = this.getAgentByRole(sessionId, role);
+        if (!agent?.processId)
+            return false;
+        const wakeKey = `${sessionId}:${role}`;
+        // Guard: prevent concurrent wakes for the same agent
+        if (this.activeWakes.has(wakeKey)) {
+            return false;
+        }
+        this.activeWakes.add(wakeKey);
+        // Auto-clear guard after timeout
+        const timer = setTimeout(() => {
+            this.clearWakeGuard(wakeKey);
+        }, this.wakeTimeoutMs);
+        this.wakeTimeouts.set(wakeKey, timer);
+        try {
+            await this.agentManager.sendMessage(agent.processId, message);
+            agent.lastActivityAt = new Date().toISOString();
+            return true;
+        }
+        catch {
+            // Clear guard on failure so retry is possible
+            this.clearWakeGuard(wakeKey);
+            return false;
+        }
+    }
+    /** Clear all agents for a session */
+    clear(sessionId) {
+        const list = this.agents.get(sessionId);
+        if (list) {
+            for (const agent of list) {
+                const wakeKey = `${sessionId}:${agent.role}`;
+                this.clearWakeGuard(wakeKey);
+            }
+        }
+        this.agents.delete(sessionId);
+    }
+    clearWakeGuard(wakeKey) {
+        this.activeWakes.delete(wakeKey);
+        const timer = this.wakeTimeouts.get(wakeKey);
+        if (timer) {
+            clearTimeout(timer);
+            this.wakeTimeouts.delete(wakeKey);
+        }
+    }
+}
+//# sourceMappingURL=room-agent-registry.js.map

package/dashboard/dist-server/dashboard/src/server/rooms/room-agent-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-agent-registry.js","sourceRoot":"","sources":["../../../../../src/server/rooms/room-agent-registry.ts"],"names":[],"mappings":"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"}

package/dashboard/dist-server/dashboard/src/server/rooms/room-mailbox.d.ts

@@ -0,0 +1,18 @@
+import type { RoomMailboxMessage, MessagePriority } from './room-types.js';
+export declare class RoomMailbox {
+    private readonly messages;
+    /** Write a message into the session mailbox. Returns the generated message. */
+    write(sessionId: string, from: string, to: string, content: string, priority?: MessagePriority): RoomMailboxMessage;
+    /**
+     * Atomically read all unread messages for an agent in a session.
+     * Marks returned messages as read so subsequent calls won't return them again.
+     * Pass `to = '*'` to read broadcast messages only.
+     */
+    readUnread(sessionId: string, agentRole: string): RoomMailboxMessage[];
+    /** Get full message history for a session */
+    getHistory(sessionId: string): RoomMailboxMessage[];
+    /** Get message history filtered to a specific agent (sent or received) */
+    getHistoryForAgent(sessionId: string, agentRole: string): RoomMailboxMessage[];
+    /** Clear all messages for a session */
+    clear(sessionId: string): void;
+}

package/dashboard/dist-server/dashboard/src/server/rooms/room-mailbox.js

@@ -0,0 +1,63 @@
+// ---------------------------------------------------------------------------
+// RoomMailbox — in-memory message store with atomic readUnread
+// ---------------------------------------------------------------------------
+import { randomUUID } from 'node:crypto';
+export class RoomMailbox {
+    messages = new Map();
+    /** Write a message into the session mailbox. Returns the generated message. */
+    write(sessionId, from, to, content, priority = 'normal') {
+        const msg = {
+            id: randomUUID(),
+            sessionId,
+            from,
+            to,
+            content,
+            priority,
+            read: false,
+            createdAt: new Date().toISOString(),
+        };
+        let list = this.messages.get(sessionId);
+        if (!list) {
+            list = [];
+            this.messages.set(sessionId, list);
+        }
+        list.push(msg);
+        return msg;
+    }
+    /**
+     * Atomically read all unread messages for an agent in a session.
+     * Marks returned messages as read so subsequent calls won't return them again.
+     * Pass `to = '*'` to read broadcast messages only.
+     */
+    readUnread(sessionId, agentRole) {
+        const list = this.messages.get(sessionId);
+        if (!list)
+            return [];
+        const unread = [];
+        for (const msg of list) {
+            if (msg.read)
+                continue;
+            if (msg.to === agentRole || msg.to === '*') {
+                msg.read = true;
+                unread.push(msg);
+            }
+        }
+        return unread;
+    }
+    /** Get full message history for a session */
+    getHistory(sessionId) {
+        return this.messages.get(sessionId) ?? [];
+    }
+    /** Get message history filtered to a specific agent (sent or received) */
+    getHistoryForAgent(sessionId, agentRole) {
+        const list = this.messages.get(sessionId);
+        if (!list)
+            return [];
+        return list.filter((msg) => msg.from === agentRole || msg.to === agentRole || msg.to === '*');
+    }
+    /** Clear all messages for a session */
+    clear(sessionId) {
+        this.messages.delete(sessionId);
+    }
+}
+//# sourceMappingURL=room-mailbox.js.map

package/dashboard/dist-server/dashboard/src/server/rooms/room-mailbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-mailbox.js","sourceRoot":"","sources":["../../../../../src/server/rooms/room-mailbox.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,OAAO,WAAW;IACL,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IAEpE,+EAA+E;IAC/E,KAAK,CACH,SAAiB,EACjB,IAAY,EACZ,EAAU,EACV,OAAe,EACf,WAA4B,QAAQ;QAEpC,MAAM,GAAG,GAAuB;YAC9B,EAAE,EAAE,UAAU,EAAE;YAChB,SAAS;YACT,IAAI;YACJ,EAAE;YACF,OAAO;YACP,QAAQ;YACR,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,IAAI,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;YACV,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEf,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,SAAiB,EAAE,SAAiB;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QAErB,MAAM,MAAM,GAAyB,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,IAAI;gBAAE,SAAS;YACvB,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC;gBAC3C,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6CAA6C;IAC7C,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,0EAA0E;IAC1E,kBAAkB,CAAC,SAAiB,EAAE,SAAiB;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAChB,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,CAC1E,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,SAAiB;QACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dashboard/dist-server/dashboard/src/server/rooms/room-session-manager.d.ts

@@ -0,0 +1,19 @@
+import type { AgentManager } from '../agents/agent-manager.js';
+import type { DashboardEventBus } from '../state/event-bus.js';
+import { MeetingRoomSession } from './meeting-room-session.js';
+export declare class RoomSessionManager {
+    private readonly agentManager;
+    private readonly eventBus;
+    private readonly sessions;
+    constructor(agentManager: AgentManager, eventBus: DashboardEventBus);
+    /** Create a new meeting room session */
+    createSession(sessionId: string): MeetingRoomSession;
+    /** Get an existing session by ID */
+    getSession(sessionId: string): MeetingRoomSession | undefined;
+    /** List all active session IDs */
+    listSessions(): string[];
+    /** Destroy a specific session and clean up resources */
+    destroySession(sessionId: string): Promise<boolean>;
+    /** Destroy all sessions — used during server shutdown */
+    destroyAll(): Promise<void>;
+}

package/dashboard/dist-server/dashboard/src/server/rooms/room-session-manager.js

@@ -0,0 +1,45 @@
+// ---------------------------------------------------------------------------
+// RoomSessionManager — manages all MeetingRoomSession instances
+// ---------------------------------------------------------------------------
+import { MeetingRoomSession } from './meeting-room-session.js';
+export class RoomSessionManager {
+    agentManager;
+    eventBus;
+    sessions = new Map();
+    constructor(agentManager, eventBus) {
+        this.agentManager = agentManager;
+        this.eventBus = eventBus;
+    }
+    /** Create a new meeting room session */
+    createSession(sessionId) {
+        if (this.sessions.has(sessionId)) {
+            throw new Error(`Room session already exists: ${sessionId}`);
+        }
+        const session = new MeetingRoomSession(sessionId, this.eventBus, this.agentManager);
+        this.sessions.set(sessionId, session);
+        return session;
+    }
+    /** Get an existing session by ID */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /** List all active session IDs */
+    listSessions() {
+        return Array.from(this.sessions.keys());
+    }
+    /** Destroy a specific session and clean up resources */
+    async destroySession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return false;
+        await session.destroy();
+        this.sessions.delete(sessionId);
+        return true;
+    }
+    /** Destroy all sessions — used during server shutdown */
+    async destroyAll() {
+        await Promise.allSettled(Array.from(this.sessions.values()).map((session) => session.destroy()));
+        this.sessions.clear();
+    }
+}
+//# sourceMappingURL=room-session-manager.js.map

package/dashboard/dist-server/dashboard/src/server/rooms/room-session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-session-manager.js","sourceRoot":"","sources":["../../../../../src/server/rooms/room-session-manager.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAI9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,OAAO,kBAAkB;IAIV;IACA;IAJF,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;IAElE,YACmB,YAA0B,EAC1B,QAA2B;QAD3B,iBAAY,GAAZ,YAAY,CAAc;QAC1B,aAAQ,GAAR,QAAQ,CAAmB;IAC3C,CAAC;IAEJ,wCAAwC;IACxC,aAAa,CAAC,SAAiB;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACpF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,oCAAoC;IACpC,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,kCAAkC;IAClC,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,cAAc,CAAC,SAAiB;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAE3B,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,UAAU;QACd,MAAM,OAAO,CAAC,UAAU,CACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CACvE,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dashboard/dist-server/dashboard/src/server/rooms/room-task-board.d.ts

@@ -0,0 +1,25 @@
+import type { RoomTask, RoomTaskCreate, RoomTaskUpdate } from './room-types.js';
+export declare class RoomTaskBoard {
+    private readonly tasks;
+    /**
+     * Create a task in the session. Auto-links bidirectional blockedBy/blocks.
+     * Returns the created task.
+     */
+    create(sessionId: string, input: RoomTaskCreate): RoomTask;
+    /**
+     * Update a task by ID. Returns the updated task or undefined if not found.
+     */
+    update(sessionId: string, taskId: string, patch: RoomTaskUpdate): RoomTask | undefined;
+    /** List all tasks in a session */
+    list(sessionId: string): RoomTask[];
+    /** Get tasks owned by a specific agent role */
+    getByOwner(sessionId: string, owner: string): RoomTask[];
+    /**
+     * Check which tasks become unblocked after a task completes.
+     * Removes the completed task from dependents' blockedBy arrays.
+     * Returns the list of tasks that became newly unblocked (transitioned from blocked to pending).
+     */
+    checkUnblocks(sessionId: string, completedTaskId: string): RoomTask[];
+    /** Clear all tasks for a session */
+    clear(sessionId: string): void;
+}