@cluesmith/codev 2.0.3 → 2.0.6

package/dist/agent-farm/servers/tower-messages.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Message routing, address resolution, and WebSocket message bus for Tower server.
+ * Spec 0110: Messaging Infrastructure — Phases 2 & 3
+ *
+ * Resolves `[project:]agent` addresses to terminal IDs by querying
+ * the workspace terminal registry maintained by tower-terminals.ts.
+ * Manages WebSocket subscribers and broadcasts structured message frames.
+ */
+import type { WebSocket } from 'ws';
+/**
+ * Structured message frame broadcast to WebSocket subscribers.
+ */
+export interface MessageFrame {
+    type: 'message';
+    timestamp: string;
+    from: {
+        project: string;
+        agent: string;
+    };
+    to: {
+        project: string;
+        agent: string;
+    };
+    content: string;
+    metadata: {
+        raw?: boolean;
+        source?: string;
+    };
+}
+/**
+ * Add a WebSocket subscriber to the message bus.
+ * @param ws - The WebSocket connection
+ * @param projectFilter - Optional project name to filter messages by
+ */
+export declare function addSubscriber(ws: WebSocket, projectFilter?: string): void;
+/**
+ * Remove a WebSocket subscriber from the message bus.
+ * @param ws - The WebSocket connection to remove
+ */
+export declare function removeSubscriber(ws: WebSocket): void;
+/**
+ * Get the count of active subscribers (for testing/monitoring).
+ */
+export declare function getSubscriberCount(): number;
+/**
+ * Result of resolving a target address to a terminal.
+ */
+export interface ResolveResult {
+    terminalId: string;
+    workspacePath: string;
+    agent: string;
+}
+/**
+ * Error from address resolution — distinguishes "not found" from "ambiguous".
+ */
+export interface ResolveError {
+    code: 'NOT_FOUND' | 'AMBIGUOUS' | 'NO_CONTEXT';
+    message: string;
+}
+/**
+ * Resolve a `[project:]agent` address to a terminal ID.
+ *
+ * Resolution logic:
+ * 1. Parse target using parseAddress() (case-insensitive)
+ * 2. If project specified: find workspace by basename match
+ *    - Multiple basename matches → AMBIGUOUS error
+ * 3. If no project: use fallbackWorkspace
+ *    - Missing fallbackWorkspace → NO_CONTEXT error
+ * 4. Within workspace: match agent against architect, then builders map
+ *    - Exact match (case-insensitive) first, then tail match
+ *    - Multiple tail matches → AMBIGUOUS error
+ *
+ * @param target - Address string: "agent" or "project:agent"
+ * @param fallbackWorkspace - Workspace path when no project: prefix is given
+ * @returns ResolveResult on success, ResolveError on failure
+ */
+export declare function resolveTarget(target: string, fallbackWorkspace?: string): ResolveResult | ResolveError;
+/**
+ * Broadcast a structured message frame to all WebSocket subscribers.
+ * Filters by project if the subscriber has a projectFilter set.
+ */
+export declare function broadcastMessage(message: MessageFrame): void;
+/**
+ * Helper to check if a resolve result is an error.
+ */
+export declare function isResolveError(result: ResolveResult | ResolveError): result is ResolveError;
+//# sourceMappingURL=tower-messages.d.ts.map

package/dist/agent-farm/servers/tower-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tower-messages.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/tower-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAQpC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAcD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAOpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,iBAAiB,CAAC,EAAE,MAAM,GACzB,aAAa,GAAG,YAAY,CA6B9B;AA8GD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAkB5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,IAAI,YAAY,CAE3F"}

package/dist/agent-farm/servers/tower-messages.js

@@ -0,0 +1,202 @@
+/**
+ * Message routing, address resolution, and WebSocket message bus for Tower server.
+ * Spec 0110: Messaging Infrastructure — Phases 2 & 3
+ *
+ * Resolves `[project:]agent` addresses to terminal IDs by querying
+ * the workspace terminal registry maintained by tower-terminals.ts.
+ * Manages WebSocket subscribers and broadcasts structured message frames.
+ */
+import path from 'node:path';
+import { parseAddress, stripLeadingZeros } from '../utils/agent-names.js';
+import { getWorkspaceTerminals } from './tower-terminals.js';
+/** Active WebSocket subscribers for the message bus. */
+const messageSubscribers = new Set();
+/**
+ * Add a WebSocket subscriber to the message bus.
+ * @param ws - The WebSocket connection
+ * @param projectFilter - Optional project name to filter messages by
+ */
+export function addSubscriber(ws, projectFilter) {
+    messageSubscribers.add({ ws, projectFilter });
+}
+/**
+ * Remove a WebSocket subscriber from the message bus.
+ * @param ws - The WebSocket connection to remove
+ */
+export function removeSubscriber(ws) {
+    for (const sub of messageSubscribers) {
+        if (sub.ws === ws) {
+            messageSubscribers.delete(sub);
+            return;
+        }
+    }
+}
+/**
+ * Get the count of active subscribers (for testing/monitoring).
+ */
+export function getSubscriberCount() {
+    return messageSubscribers.size;
+}
+/**
+ * Resolve a `[project:]agent` address to a terminal ID.
+ *
+ * Resolution logic:
+ * 1. Parse target using parseAddress() (case-insensitive)
+ * 2. If project specified: find workspace by basename match
+ *    - Multiple basename matches → AMBIGUOUS error
+ * 3. If no project: use fallbackWorkspace
+ *    - Missing fallbackWorkspace → NO_CONTEXT error
+ * 4. Within workspace: match agent against architect, then builders map
+ *    - Exact match (case-insensitive) first, then tail match
+ *    - Multiple tail matches → AMBIGUOUS error
+ *
+ * @param target - Address string: "agent" or "project:agent"
+ * @param fallbackWorkspace - Workspace path when no project: prefix is given
+ * @returns ResolveResult on success, ResolveError on failure
+ */
+export function resolveTarget(target, fallbackWorkspace) {
+    const { project, agent } = parseAddress(target);
+    // Validate: empty or whitespace-only agent is a malformed address
+    if (!agent || !agent.trim()) {
+        return {
+            code: 'NO_CONTEXT',
+            message: 'Malformed address: agent name is empty.',
+        };
+    }
+    // Determine the workspace path
+    let workspacePath;
+    if (project) {
+        const result = findWorkspaceByBasename(project);
+        if ('code' in result)
+            return result;
+        workspacePath = result.workspacePath;
+    }
+    else {
+        if (!fallbackWorkspace) {
+            return {
+                code: 'NO_CONTEXT',
+                message: 'Cannot resolve agent without project context.',
+            };
+        }
+        workspacePath = fallbackWorkspace;
+    }
+    // Resolve agent within the workspace
+    return resolveAgentInWorkspace(agent, workspacePath);
+}
+/**
+ * Find a workspace path by matching the basename of registered workspace paths.
+ */
+function findWorkspaceByBasename(projectName) {
+    const allWorkspaces = getWorkspaceTerminals();
+    const matches = [];
+    for (const wsPath of allWorkspaces.keys()) {
+        if (path.basename(wsPath).toLowerCase() === projectName) {
+            matches.push(wsPath);
+        }
+    }
+    if (matches.length === 0) {
+        return {
+            code: 'NOT_FOUND',
+            message: `Project '${projectName}' not found. No workspace with that basename is registered.`,
+        };
+    }
+    if (matches.length > 1) {
+        return {
+            code: 'AMBIGUOUS',
+            message: `Project '${projectName}' is ambiguous — matches ${matches.length} workspaces: ${matches.join(', ')}`,
+        };
+    }
+    return { workspacePath: matches[0] };
+}
+/**
+ * Resolve an agent name to a terminal ID within a specific workspace.
+ *
+ * Checks architect first, then builders by exact match, then builders by tail match.
+ */
+function resolveAgentInWorkspace(agent, workspacePath) {
+    const allWorkspaces = getWorkspaceTerminals();
+    const entry = allWorkspaces.get(workspacePath);
+    if (!entry) {
+        return {
+            code: 'NOT_FOUND',
+            message: `Workspace '${workspacePath}' has no registered terminals.`,
+        };
+    }
+    // Check architect
+    if (agent === 'architect' || agent === 'arch') {
+        if (!entry.architect) {
+            return {
+                code: 'NOT_FOUND',
+                message: `No architect terminal found in workspace '${path.basename(workspacePath)}'.`,
+            };
+        }
+        return { terminalId: entry.architect, workspacePath, agent: 'architect' };
+    }
+    // Check builders — exact match (case-insensitive)
+    for (const [builderId, terminalId] of entry.builders) {
+        if (builderId.toLowerCase() === agent) {
+            return { terminalId, workspacePath, agent: builderId };
+        }
+    }
+    // Check builders — tail match with leading-zero stripping
+    const strippedAgent = stripLeadingZeros(agent).toLowerCase();
+    const tailMatches = [];
+    for (const [builderId, terminalId] of entry.builders) {
+        if (builderId.toLowerCase().endsWith(`-${strippedAgent}`)) {
+            tailMatches.push({ builderId, terminalId });
+        }
+    }
+    if (tailMatches.length === 1) {
+        return {
+            terminalId: tailMatches[0].terminalId,
+            workspacePath,
+            agent: tailMatches[0].builderId,
+        };
+    }
+    if (tailMatches.length > 1) {
+        const candidates = tailMatches.map(m => m.builderId).join(', ');
+        return {
+            code: 'AMBIGUOUS',
+            message: `Agent '${agent}' is ambiguous — matches ${tailMatches.length} builders: ${candidates}. Use the full name.`,
+        };
+    }
+    // Check shells — exact match
+    for (const [shellId, terminalId] of entry.shells) {
+        if (shellId.toLowerCase() === agent) {
+            return { terminalId, workspacePath, agent: shellId };
+        }
+    }
+    return {
+        code: 'NOT_FOUND',
+        message: `Agent '${agent}' not found in workspace '${path.basename(workspacePath)}'.`,
+    };
+}
+/**
+ * Broadcast a structured message frame to all WebSocket subscribers.
+ * Filters by project if the subscriber has a projectFilter set.
+ */
+export function broadcastMessage(message) {
+    const payload = JSON.stringify(message);
+    for (const sub of messageSubscribers) {
+        // Apply project filter: message must involve the filtered project (from or to)
+        if (sub.projectFilter) {
+            if (message.from.project !== sub.projectFilter && message.to.project !== sub.projectFilter) {
+                continue;
+            }
+        }
+        try {
+            sub.ws.send(payload);
+        }
+        catch {
+            // If send fails, subscriber is likely disconnected — remove it
+            messageSubscribers.delete(sub);
+        }
+    }
+}
+/**
+ * Helper to check if a resolve result is an error.
+ */
+export function isResolveError(result) {
+    return 'code' in result;
+}
+//# sourceMappingURL=tower-messages.js.map

package/dist/agent-farm/servers/tower-messages.js.map

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

package/dist/agent-farm/servers/tower-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tower-routes.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/tower-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAuClD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IAChD,qBAAqB,EAAE,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjH,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AA6CD,wBAAsB,aAAa,CACjC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,IAAI,CAAC,CAuEf"}
+{"version":3,"file":"tower-routes.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/tower-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA8ClD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IAChD,qBAAqB,EAAE,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjH,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAgDD,wBAAsB,aAAa,CACjC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,IAAI,CAAC,CAuEf"}

package/dist/agent-farm/servers/tower-routes.js

@@ -14,16 +14,24 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import crypto from 'node:crypto';
-import { execSync } from 'node:child_process';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
 import { homedir, tmpdir } from 'node:os';
 import { fileURLToPath } from 'node:url';
+const execAsync = promisify(exec);
+import { DEFAULT_COLS, defaultSessionOptions } from '../../terminal/index.js';
 import { parseJsonBody, isRequestAllowed } from '../utils/server-utils.js';
 import { isRateLimited, normalizeWorkspacePath, getLanguageForExt, getMimeTypeForFile, serveStaticFile, } from './tower-utils.js';
 import { handleTunnelEndpoint } from './tower-tunnel.js';
+import { resolveTarget, broadcastMessage, isResolveError } from './tower-messages.js';
+import { formatArchitectMessage, formatBuilderMessage } from '../utils/message-format.js';
 import { getKnownWorkspacePaths, getInstances, getDirectorySuggestions, launchInstance, killTerminalWithShellper, stopInstance, } from './tower-instances.js';
-import { getWorkspaceTerminals, getTerminalManager, getWorkspaceTerminalsEntry, getNextShellId, saveTerminalSession, isSessionPersistent, deleteTerminalSession, deleteWorkspaceTerminalSessions, saveFileTab, deleteFileTab, getTerminalsForWorkspace, } from './tower-terminals.js';
+import { OverviewCache } from './overview.js';
+import { getWorkspaceTerminals, getTerminalManager, getWorkspaceTerminalsEntry, getNextShellId, saveTerminalSession, isSessionPersistent, deleteTerminalSession, removeTerminalFromRegistry, deleteWorkspaceTerminalSessions, saveFileTab, deleteFileTab, getTerminalsForWorkspace, } from './tower-terminals.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+// Singleton cache for overview endpoint (Spec 0126 Phase 4)
+const overviewCache = new OverviewCache();
 // ============================================================================
 // Helper: read raw request body
 // ============================================================================
@@ -40,12 +48,15 @@ const ROUTES = {
     'POST /api/terminals': (req, res, _url, ctx) => handleTerminalCreate(req, res, ctx),
     'GET /api/terminals': (_req, res) => handleTerminalList(res),
     'GET /api/status': (_req, res) => handleStatus(res),
+    'GET /api/overview': (_req, res, url) => handleOverview(res, url),
+    'POST /api/overview/refresh': (_req, res) => handleOverviewRefresh(res),
     'GET /api/events': (req, res, _url, ctx) => handleSSEEvents(req, res, ctx),
     'POST /api/notify': (req, res, _url, ctx) => handleNotify(req, res, ctx),
     'GET /api/browse': (_req, res, url) => handleBrowse(res, url),
     'POST /api/create': (req, res, _url, ctx) => handleCreateWorkspace(req, res, ctx),
     'POST /api/launch': (req, res) => handleLaunchInstance(req, res),
     'POST /api/stop': (req, res) => handleStopInstance(req, res),
+    'POST /api/send': (req, res, _url, ctx) => handleSend(req, res, ctx),
     'GET /': (_req, res, _url, ctx) => handleDashboard(res, ctx),
     'GET /index.html': (_req, res, _url, ctx) => handleDashboard(res, ctx),
 };
@@ -171,7 +182,6 @@ async function handleWorkspaceAction(req, res, ctx, match) {
             name: instance.workspaceName,
             active: instance.running,
             terminals: instance.terminals,
-            gateStatus: instance.gateStatus,
         }));
         return;
     }
@@ -244,9 +254,8 @@ async function handleTerminalCreate(req, res, ctx) {
                     args: args || [],
                     cwd,
                     env: sessionEnv,
-                    cols: cols || 200,
-                    rows: 50,
-                    restartOnExit: false,
+                    ...defaultSessionOptions(),
+                    cols: cols || DEFAULT_COLS,
                 });
                 const replayData = client.getReplayData() ?? Buffer.alloc(0);
                 const shellperInfo = shellperManager.getSessionInfo(sessionId);
@@ -333,6 +342,9 @@ async function handleTerminalRoutes(req, res, url, match) {
         }
         // TICK-001: Delete from SQLite
         deleteTerminalSession(terminalId);
+        // Bugfix #290: Also remove from in-memory registry so dashboard
+        // stops showing tabs for cleaned-up builders
+        removeTerminalFromRegistry(terminalId);
         res.writeHead(204);
         res.end();
         return;
@@ -406,6 +418,36 @@ async function handleStatus(res) {
     res.writeHead(200, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify({ instances }));
 }
+async function handleOverview(res, url, workspaceOverride) {
+    // Accept workspace from: explicit override (workspace-scoped route), ?workspace= param, or first known path.
+    let workspaceRoot = workspaceOverride || url.searchParams.get('workspace');
+    if (!workspaceRoot) {
+        const knownPaths = getKnownWorkspacePaths();
+        workspaceRoot = knownPaths.find(p => !p.includes('/.builders/')) || null;
+    }
+    if (!workspaceRoot) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ builders: [], pendingPRs: [], backlog: [] }));
+        return;
+    }
+    // Build set of active builder role_ids (lowercased) from live terminal sessions
+    const wsTerminals = getWorkspaceTerminals();
+    const entry = wsTerminals.get(normalizeWorkspacePath(workspaceRoot));
+    const activeBuilderRoleIds = new Set();
+    if (entry) {
+        for (const key of entry.builders.keys()) {
+            activeBuilderRoleIds.add(key.toLowerCase());
+        }
+    }
+    const data = await overviewCache.getOverview(workspaceRoot, activeBuilderRoleIds);
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(data));
+}
+function handleOverviewRefresh(res) {
+    overviewCache.invalidate();
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ ok: true }));
+}
 function handleSSEEvents(req, res, ctx) {
     const clientId = crypto.randomBytes(8).toString('hex');
     res.writeHead(200, {
@@ -446,6 +488,107 @@ async function handleNotify(req, res, ctx) {
     res.writeHead(200, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify({ success: true }));
 }
+// ============================================================================
+// POST /api/send — send a message to a resolved agent terminal
+// ============================================================================
+async function handleSend(req, res, ctx) {
+    const body = await parseJsonBody(req);
+    // Validate required fields
+    const to = typeof body.to === 'string' ? body.to.trim() : '';
+    const message = typeof body.message === 'string' ? body.message.trim() : '';
+    if (!to) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'INVALID_PARAMS', message: 'Missing or empty "to" field' }));
+        return;
+    }
+    if (!message) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'INVALID_PARAMS', message: 'Missing or empty "message" field' }));
+        return;
+    }
+    // Optional fields
+    const from = typeof body.from === 'string' ? body.from : undefined;
+    const workspace = typeof body.workspace === 'string' ? body.workspace : undefined;
+    const fromWorkspace = typeof body.fromWorkspace === 'string' ? body.fromWorkspace : undefined;
+    const options = typeof body.options === 'object' && body.options !== null
+        ? body.options
+        : {};
+    const raw = options.raw === true;
+    const noEnter = options.noEnter === true;
+    const interrupt = options.interrupt === true;
+    // Resolve the target address to a terminal ID
+    const result = resolveTarget(to, workspace);
+    if (isResolveError(result)) {
+        const statusCode = result.code === 'AMBIGUOUS' ? 409
+            : result.code === 'NO_CONTEXT' ? 400
+                : 404;
+        // Map NO_CONTEXT to INVALID_PARAMS per plan's error contract
+        const errorCode = result.code === 'NO_CONTEXT' ? 'INVALID_PARAMS' : result.code;
+        res.writeHead(statusCode, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: errorCode, message: result.message }));
+        return;
+    }
+    // Get the terminal session
+    const manager = getTerminalManager();
+    const session = manager.getSession(result.terminalId);
+    if (!session) {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+            error: 'NOT_FOUND',
+            message: `Terminal session ${result.terminalId} not found (agent '${result.agent}' resolved but terminal is gone).`,
+        }));
+        return;
+    }
+    // Format the message based on sender/target
+    const isArchitectTarget = result.agent === 'architect';
+    let formattedMessage;
+    if (isArchitectTarget && from) {
+        // Builder → Architect
+        formattedMessage = formatBuilderMessage(from, message, undefined, raw);
+    }
+    else if (!isArchitectTarget) {
+        // Architect → Builder (or any → builder)
+        formattedMessage = formatArchitectMessage(message, undefined, raw);
+    }
+    else {
+        // Unknown sender to architect — use raw
+        formattedMessage = raw ? message : formatArchitectMessage(message, undefined, false);
+    }
+    // Optionally interrupt first
+    if (interrupt) {
+        session.write('\x03'); // Ctrl+C
+        await new Promise(resolve => setTimeout(resolve, 100));
+    }
+    // Write the message to the terminal
+    session.write(formattedMessage);
+    // Send Enter to submit (unless noEnter)
+    if (!noEnter) {
+        session.write('\r');
+    }
+    // Broadcast structured message to WebSocket subscribers
+    const senderWorkspace = fromWorkspace ?? workspace ?? 'unknown';
+    broadcastMessage({
+        type: 'message',
+        from: {
+            project: path.basename(senderWorkspace),
+            agent: from ?? 'unknown',
+        },
+        to: {
+            project: path.basename(result.workspacePath),
+            agent: result.agent,
+        },
+        content: message,
+        metadata: { raw, source: 'api' },
+        timestamp: new Date().toISOString(),
+    });
+    ctx.log('INFO', `Message sent: ${from ?? 'unknown'} → ${result.agent} (terminal ${result.terminalId.slice(0, 8)}...)`);
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({
+        ok: true,
+        terminalId: result.terminalId,
+        resolvedTo: result.agent,
+    }));
+}
 async function handleBrowse(res, url) {
     const inputPath = url.searchParams.get('path') || '';
     try {
@@ -493,9 +636,8 @@ async function handleCreateWorkspace(req, res, ctx) {
     }
     try {
         // Run codev init (it creates the directory)
-        execSync(`codev init --yes "${workspaceName}"`, {
+        await execAsync(`codev init --yes "${workspaceName}"`, {
             cwd: expandedParent,
-            stdio: 'pipe',
             timeout: 60000,
         });
         // Launch the instance
@@ -618,7 +760,7 @@ async function handleWorkspaceRoutes(req, res, ctx, url) {
         await handleTunnelEndpoint(req, res, tunnelSub);
         return;
     }
-    // GET /file?path=<relative-path> — Read workspace file by path (for StatusPanel workspace list)
+    // GET /file?path=<relative-path> — Read workspace file by path
     if (req.method === 'GET' && subPath === 'file' && url.searchParams.has('path')) {
         const relPath = url.searchParams.get('path');
         const fullPath = path.resolve(workspacePath, relPath);
@@ -771,6 +913,14 @@ async function handleWorkspaceRoutes(req, res, ctx, url) {
             });
             return;
         }
+        // GET /api/overview - Work view overview data (Spec 0126 Phase 4)
+        if (req.method === 'GET' && apiPath === 'overview') {
+            return handleOverview(res, url, workspacePath);
+        }
+        // POST /api/overview/refresh - Invalidate overview cache (Spec 0126 Phase 4)
+        if (req.method === 'POST' && apiPath === 'overview/refresh') {
+            return handleOverviewRefresh(res);
+        }
         // Unhandled API route
         res.writeHead(404, { 'Content-Type': 'application/json' });
         res.end(JSON.stringify({ error: 'API endpoint not found', path: apiPath }));
@@ -801,7 +951,7 @@ async function handleWorkspaceState(res, workspacePath) {
     // and shellper reconnection in one place)
     const encodedPath = Buffer.from(workspacePath).toString('base64url');
     const proxyUrl = `/workspace/${encodedPath}/`;
-    const { gateStatus } = await getTerminalsForWorkspace(workspacePath, proxyUrl);
+    await getTerminalsForWorkspace(workspacePath, proxyUrl);
     // Now read from the refreshed cache
     const entry = getWorkspaceTerminalsEntry(workspacePath);
     const manager = getTerminalManager();
@@ -811,7 +961,6 @@ async function handleWorkspaceState(res, workspacePath) {
         utils: [],
         annotations: [],
         workspaceName: path.basename(workspacePath),
-        gateStatus,
     };
     // Add architect if exists
     if (entry.architect) {
@@ -845,7 +994,7 @@ async function handleWorkspaceState(res, workspacePath) {
         if (session) {
             state.builders.push({
                 id: builderId,
-                name: `Builder ${builderId}`,
+                name: builderId,
                 port: 0,
                 pid: session.pid || 0,
                 status: 'running',
@@ -891,9 +1040,7 @@ async function handleWorkspaceShellCreate(res, ctx, workspacePath) {
                     args: shellArgs,
                     cwd: workspacePath,
                     env: shellEnv,
-                    cols: 200,
-                    rows: 50,
-                    restartOnExit: false,
+                    ...defaultSessionOptions(),
                 });
                 const replayData = client.getReplayData() ?? Buffer.alloc(0);
                 const shellperInfo = shellperManager.getSessionInfo(sessionId);
@@ -1241,10 +1388,10 @@ function handleWorkspaceFiles(res, url, workspacePath) {
     res.writeHead(200, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify(tree));
 }
-function handleWorkspaceGitStatus(res, ctx, workspacePath) {
+async function handleWorkspaceGitStatus(res, ctx, workspacePath) {
     try {
         // Get git status in porcelain format for parsing
-        const result = execSync('git status --porcelain', {
+        const { stdout: result } = await execAsync('git status --porcelain', {
             cwd: workspacePath,
             encoding: 'utf-8',
             timeout: 5000,