@cluesmith/codev 2.0.2 → 2.0.6

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

@@ -25,7 +25,7 @@ export interface RouteContext {
         type: string;
         title: string;
         body: string;
-        project?: string;
+        workspace?: string;
     }) => void;
     addSseClient: (client: SSEClient) => void;
     removeSseClient: (id: string) => void;

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,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/G,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"}