@bradygaster/squad-sdk 0.7.0 → 0.8.2

package/dist/coordinator/coordinator.js

@@ -0,0 +1,192 @@
+/**
+ * Squad Coordinator (M3-1, Issue #135)
+ *
+ * The brain of Squad — receives user messages, decides how to handle them,
+ * and orchestrates agent spawning. Wires together:
+ *   - DirectResponseHandler (no-spawn fast path)
+ *   - Routing rules (matchRoute / compileRoutingRules)
+ *   - Charter compilation (compileCharter)
+ *   - Model selection (resolveModel)
+ *   - Fan-out spawning (spawnParallel)
+ *   - Event bus (observability)
+ */
+import { DirectResponseHandler, } from './direct-response.js';
+import { matchRoute, compileRoutingRules, } from '../config/routing.js';
+import { spawnParallel } from './fan-out.js';
+import { trace, SpanStatusCode } from '@opentelemetry/api';
+const tracer = trace.getTracer('squad-sdk');
+// --- Coordinator Class ---
+/**
+ * Main coordinator entry point.
+ *
+ * Pipeline:
+ * 1. Direct response check (no-spawn fast path)
+ * 2. Route analysis (message → routing rules → agent selection)
+ * 3. Spawn strategy (single vs multi vs fallback)
+ * 4. Fan-out spawn
+ * 5. Collect results + emit events
+ */
+export class SquadCoordinator {
+    config;
+    eventBus;
+    directHandler;
+    compiledRouter;
+    fanOutDeps;
+    constructor(options) {
+        this.config = options.config;
+        this.eventBus = options.eventBus;
+        this.fanOutDeps = options.fanOutDeps;
+        this.directHandler = options.directHandler ?? new DirectResponseHandler();
+        // Compile routing rules from config or use provided router
+        if (options.compiledRouter) {
+            this.compiledRouter = options.compiledRouter;
+        }
+        else {
+            this.compiledRouter = this.compileRouter(this.config);
+        }
+    }
+    /**
+     * Main dispatch — handle an incoming user message.
+     */
+    async handleMessage(message, context) {
+        const span = tracer.startSpan('squad.coordinator.handleMessage');
+        span.setAttribute('message.length', message.length);
+        try {
+            const start = Date.now();
+            // Emit coordinator.route event
+            await this.emit('coordinator:routing', context.sessionId, {
+                phase: 'start',
+                messageLength: message.length,
+            });
+            // --- Step 1: Direct response check ---
+            if (this.directHandler.shouldHandleDirectly(message, this.config)) {
+                const directResult = this.directHandler.handleDirect(message, context);
+                await this.emit('coordinator:routing', context.sessionId, {
+                    phase: 'complete',
+                    strategy: 'direct',
+                    category: directResult.category,
+                });
+                span.setAttribute('routing.strategy', 'direct');
+                return {
+                    strategy: 'direct',
+                    directResponse: directResult,
+                    durationMs: Date.now() - start,
+                };
+            }
+            // --- Step 2: Route analysis ---
+            const routing = matchRoute(message, this.compiledRouter);
+            await this.emit('coordinator:routing', context.sessionId, {
+                phase: 'routed',
+                agents: routing.agents,
+                confidence: routing.confidence,
+                reason: routing.reason,
+            });
+            span.setAttribute('target.agents', routing.agents.join(','));
+            span.setAttribute('routing.confidence', routing.confidence);
+            // --- Step 3: Determine spawn strategy ---
+            const strategy = this.determineStrategy(routing);
+            span.setAttribute('routing.strategy', strategy);
+            // --- Step 4: Spawn agents ---
+            let spawnResults;
+            if (this.fanOutDeps && (strategy === 'single' || strategy === 'multi')) {
+                const spawnConfigs = this.buildSpawnConfigs(routing, message, context);
+                await this.emit('coordinator:routing', context.sessionId, {
+                    phase: 'spawning',
+                    strategy,
+                    agentCount: spawnConfigs.length,
+                });
+                spawnResults = await spawnParallel(spawnConfigs, this.fanOutDeps);
+                // If all spawns failed in single mode, mark as fallback
+                if (strategy === 'single' && spawnResults.every(r => r.status === 'failed')) {
+                    return {
+                        strategy: 'fallback',
+                        routing,
+                        spawnResults,
+                        durationMs: Date.now() - start,
+                    };
+                }
+            }
+            // --- Step 5: Complete ---
+            await this.emit('coordinator:routing', context.sessionId, {
+                phase: 'complete',
+                strategy,
+                spawnCount: spawnResults?.length ?? 0,
+                successCount: spawnResults?.filter(r => r.status === 'success').length ?? 0,
+            });
+            return {
+                strategy,
+                routing,
+                spawnResults,
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            span.setStatus({ code: SpanStatusCode.ERROR, message: err instanceof Error ? err.message : String(err) });
+            span.recordException(err instanceof Error ? err : new Error(String(err)));
+            throw err;
+        }
+        finally {
+            span.end();
+        }
+    }
+    /**
+     * Get the compiled router (for inspection / testing).
+     */
+    getRouter() {
+        return this.compiledRouter;
+    }
+    /**
+     * Get the direct response handler (for inspection / testing).
+     */
+    getDirectHandler() {
+        return this.directHandler;
+    }
+    /**
+     * Update configuration at runtime.
+     */
+    updateConfig(config) {
+        this.config = config;
+        this.compiledRouter = this.compileRouter(config);
+    }
+    // --- Private helpers ---
+    determineStrategy(routing) {
+        if (routing.agents.length === 0)
+            return 'fallback';
+        if (routing.agents.length === 1)
+            return 'single';
+        return 'multi';
+    }
+    buildSpawnConfigs(routing, message, context) {
+        return routing.agents.map((agentName) => ({
+            agentName: agentName.replace(/^@/, ''),
+            task: message,
+            priority: routing.confidence === 'high' ? 'normal' : 'low',
+            context: context.metadata ? JSON.stringify(context.metadata) : undefined,
+        }));
+    }
+    compileRouter(config) {
+        // Convert config routing rules → runtime routing rules for the compiler
+        const runtimeRules = (config.routing?.rules ?? []).map((rule) => ({
+            workType: rule.workType ?? rule.pattern ?? 'unknown',
+            agents: rule.agents,
+            examples: rule.examples,
+            confidence: rule.confidence,
+        }));
+        const routingConfig = {
+            rules: runtimeRules,
+            governance: config.routing?.governance,
+        };
+        return compileRoutingRules(routingConfig);
+    }
+    async emit(type, sessionId, payload) {
+        if (!this.eventBus)
+            return;
+        await this.eventBus.emit({
+            type: type,
+            sessionId,
+            payload,
+            timestamp: new Date(),
+        });
+    }
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/coordinator/coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.js","sourceRoot":"","sources":["../../src/coordinator/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EACL,qBAAqB,GAGtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,UAAU,EACV,mBAAmB,GAGpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAoE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AAuC5C,4BAA4B;AAE5B;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAc;IACpB,QAAQ,CAAY;IACpB,aAAa,CAAwB;IACrC,cAAc,CAAiB;IAC/B,UAAU,CAAsB;IAExC,YAAY,OAAgC;QAC1C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,qBAAqB,EAAE,CAAC;QAE1E,2DAA2D;QAC3D,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,OAAe,EACf,OAA2B;QAE3B,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;QACjE,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAEzB,+BAA+B;YAC/B,MAAM,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,SAAS,EAAE;gBACxD,KAAK,EAAE,OAAO;gBACd,aAAa,EAAE,OAAO,CAAC,MAAM;aAC9B,CAAC,CAAC;YAEH,wCAAwC;YACxC,IAAI,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClE,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAEvE,MAAM,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,SAAS,EAAE;oBACxD,KAAK,EAAE,UAAU;oBACjB,QAAQ,EAAE,QAAQ;oBAClB,QAAQ,EAAE,YAAY,CAAC,QAAQ;iBAChC,CAAC,CAAC;gBAEH,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;gBAChD,OAAO;oBACL,QAAQ,EAAE,QAAQ;oBAClB,cAAc,EAAE,YAAY;oBAC5B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;iBAC/B,CAAC;YACJ,CAAC;YAED,iCAAiC;YACjC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;YAEzD,MAAM,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,SAAS,EAAE;gBACxD,KAAK,EAAE,QAAQ;gBACf,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7D,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;YAE5D,2CAA2C;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACjD,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;YAEhD,+BAA+B;YAC/B,IAAI,YAAuC,CAAC;YAE5C,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,OAAO,CAAC,EAAE,CAAC;gBACvE,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBAEvE,MAAM,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,SAAS,EAAE;oBACxD,KAAK,EAAE,UAAU;oBACjB,QAAQ;oBACR,UAAU,EAAE,YAAY,CAAC,MAAM;iBAChC,CAAC,CAAC;gBAEH,YAAY,GAAG,MAAM,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;gBAElE,wDAAwD;gBACxD,IAAI,QAAQ,KAAK,QAAQ,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;oBAC5E,OAAO;wBACL,QAAQ,EAAE,UAAU;wBACpB,OAAO;wBACP,YAAY;wBACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;qBAC/B,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,2BAA2B;YAC3B,MAAM,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,SAAS,EAAE;gBACxD,KAAK,EAAE,UAAU;gBACjB,QAAQ;gBACR,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;gBACrC,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,IAAI,CAAC;aAC5E,CAAC,CAAC;YAEH,OAAO;gBACL,QAAQ;gBACR,OAAO;gBACP,YAAY;gBACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1G,IAAI,CAAC,eAAe,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1E,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAmB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,0BAA0B;IAElB,iBAAiB,CAAC,OAAqB;QAC7C,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC;QACnD,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QACjD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,iBAAiB,CACvB,OAAqB,EACrB,OAAe,EACf,OAA2B;QAE3B,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACxC,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,OAAO,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;YAC1D,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;SACzE,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,aAAa,CAAC,MAAmB;QACvC,wEAAwE;QACxE,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC;YACrE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,IAAI,SAAS;YACpD,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAgC;YAC/C,UAAU,EAAE,IAAI,CAAC,UAAmD;SACrE,CAAC,CAAC,CAAC;QAEJ,MAAM,aAAa,GAAyB;YAC1C,KAAK,EAAE,YAAY;YACnB,UAAU,EAAG,MAAM,CAAC,OAAe,EAAE,UAAU;SAChD,CAAC;QAEF,OAAO,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAC5C,CAAC;IAEO,KAAK,CAAC,IAAI,CAChB,IAAY,EACZ,SAA6B,EAC7B,OAAgC;QAEhC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACvB,IAAI,EAAE,IAA0B;YAChC,SAAS;YACT,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/coordinator/direct-response.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Direct Response Handler (M3-6, Issue #147)
+ *
+ * Handles simple queries that don't require agent spawning.
+ * Acts as a first-pass check in the coordinator pipeline —
+ * status queries, help requests, config questions, and team roster
+ * queries are answered directly without consuming agent sessions.
+ */
+import type { SquadConfig } from '../runtime/config.js';
+import type { EventBus } from '../runtime/event-bus.js';
+/**
+ * Context for coordinator message handling.
+ */
+export interface CoordinatorContext {
+    /** Current session ID (coordinator session) */
+    sessionId: string;
+    /** Squad configuration */
+    config: SquadConfig;
+    /** Event bus for observability */
+    eventBus?: EventBus;
+    /** Team roster content (team.md) */
+    teamRoster?: string;
+    /** Active agent names */
+    activeAgents?: string[];
+    /** User-provided metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of a direct response.
+ */
+export interface DirectResponseResult {
+    /** The response text to return to the user */
+    response: string;
+    /** Category of the matched pattern */
+    category: DirectResponseCategory;
+    /** Confidence in the match */
+    confidence: 'high' | 'medium';
+}
+/**
+ * Categories of messages handled directly.
+ */
+export type DirectResponseCategory = 'status' | 'help' | 'config' | 'roster' | 'greeting';
+/**
+ * A configurable pattern for direct response matching.
+ */
+export interface DirectResponsePattern {
+    /** Category this pattern belongs to */
+    category: DirectResponseCategory;
+    /** Regex patterns that trigger this category */
+    patterns: RegExp[];
+    /** Handler that produces the response */
+    handler: (message: string, context: CoordinatorContext) => string;
+}
+/**
+ * Handles simple queries without spawning agents.
+ *
+ * The handler checks incoming messages against a set of configurable
+ * patterns. If a match is found, it produces a direct response without
+ * going through the routing → charter → spawn pipeline.
+ */
+export declare class DirectResponseHandler {
+    private patterns;
+    constructor(customPatterns?: DirectResponsePattern[]);
+    /**
+     * Check whether a message should be handled directly (no agent spawn).
+     */
+    shouldHandleDirectly(message: string, config?: SquadConfig): boolean;
+    /**
+     * Handle a message directly and return a response.
+     * Should only be called after shouldHandleDirectly() returns true.
+     */
+    handleDirect(message: string, context: CoordinatorContext): DirectResponseResult;
+    /**
+     * Add a custom pattern at runtime.
+     */
+    addPattern(pattern: DirectResponsePattern): void;
+    /**
+     * Get all registered patterns.
+     */
+    getPatterns(): ReadonlyArray<DirectResponsePattern>;
+    private matchPattern;
+}
+//# sourceMappingURL=direct-response.d.ts.map

package/dist/coordinator/direct-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-response.d.ts","sourceRoot":"","sources":["../../src/coordinator/direct-response.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,yBAAyB,CAAC;AAIpE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,8BAA8B;IAC9B,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yCAAyC;IACzC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,KAAK,MAAM,CAAC;CACnE;AA8FD;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,cAAc,CAAC,EAAE,qBAAqB,EAAE;IAIpD;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO;IAkBpE;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,oBAAoB;IAmChF;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAIhD;;OAEG;IACH,WAAW,IAAI,aAAa,CAAC,qBAAqB,CAAC;IAMnD,OAAO,CAAC,YAAY;CAUrB"}

package/dist/coordinator/direct-response.js

@@ -0,0 +1,187 @@
+/**
+ * Direct Response Handler (M3-6, Issue #147)
+ *
+ * Handles simple queries that don't require agent spawning.
+ * Acts as a first-pass check in the coordinator pipeline —
+ * status queries, help requests, config questions, and team roster
+ * queries are answered directly without consuming agent sessions.
+ */
+// --- Default Patterns ---
+const DEFAULT_PATTERNS = [
+    {
+        category: 'status',
+        patterns: [
+            /^(?:what(?:'s| is) the )?status\b/i,
+            /^(?:show|list|get)\s+(?:active\s+)?(?:agents?|sessions?|status)\b/i,
+            /^who(?:'s| is) (?:active|running|working)\b/i,
+            /^squad\s+status\b/i,
+        ],
+        handler: (_message, context) => {
+            const agents = context.activeAgents ?? [];
+            if (agents.length === 0) {
+                return 'No agents are currently active. Use a task request to spawn agents.';
+            }
+            return `Active agents (${agents.length}): ${agents.join(', ')}`;
+        },
+    },
+    {
+        category: 'help',
+        patterns: [
+            /^(?:help|how do I|what can you do|what commands|usage)\b/i,
+            /^(?:show|list)\s+(?:help|commands|capabilities)\b/i,
+            /^\?$/,
+        ],
+        handler: () => {
+            return [
+                '**Squad Coordinator** — I route work to specialist agents.',
+                '',
+                'You can ask me to:',
+                '- Route tasks to specific agents (e.g., "ask Fenster to fix the build")',
+                '- Check team status (e.g., "status" or "who is active?")',
+                '- View the team roster (e.g., "show team" or "who is on the team?")',
+                '- View configuration (e.g., "show config" or "what model am I using?")',
+                '',
+                'Or just describe what you need and I\'ll route it to the right agent.',
+            ].join('\n');
+        },
+    },
+    {
+        category: 'config',
+        patterns: [
+            /^(?:show|get|what(?:'s| is))\s+(?:the\s+)?(?:config|configuration|settings|model)\b/i,
+            /^(?:which|what)\s+model\b/i,
+            /^config\b/i,
+        ],
+        handler: (_message, context) => {
+            const cfg = context.config;
+            const model = cfg.models?.defaultModel ?? 'unknown';
+            const tier = cfg.models?.defaultTier ?? 'unknown';
+            const ruleCount = cfg.routing?.rules?.length ?? 0;
+            return [
+                `**Configuration** (v${cfg.version})`,
+                `- Default model: ${model} (${tier} tier)`,
+                `- Routing rules: ${ruleCount}`,
+                `- Tier ceiling respected: ${cfg.models?.respectTierCeiling ?? true}`,
+            ].join('\n');
+        },
+    },
+    {
+        category: 'roster',
+        patterns: [
+            /^(?:show|list|get|who(?:'s| is)(?: on)?)\s+(?:the\s+)?(?:team|roster|agents?|members?)\b/i,
+            /^team\b/i,
+            /^roster\b/i,
+        ],
+        handler: (_message, context) => {
+            if (context.teamRoster) {
+                return context.teamRoster;
+            }
+            const agents = context.activeAgents ?? [];
+            if (agents.length === 0) {
+                return 'No team roster available. Configure agents in your squad.config.ts.';
+            }
+            return `**Team Roster:** ${agents.join(', ')}`;
+        },
+    },
+    {
+        category: 'greeting',
+        patterns: [
+            /^(?:hi|hello|hey|good (?:morning|afternoon|evening)|yo|sup)\b/i,
+            /^(?:hi|hello|hey)!?$/i,
+        ],
+        handler: () => {
+            return 'Hello! I\'m the Squad coordinator. Describe what you need and I\'ll route it to the right agent, or type "help" for options.';
+        },
+    },
+];
+// --- Direct Response Handler ---
+/**
+ * Handles simple queries without spawning agents.
+ *
+ * The handler checks incoming messages against a set of configurable
+ * patterns. If a match is found, it produces a direct response without
+ * going through the routing → charter → spawn pipeline.
+ */
+export class DirectResponseHandler {
+    patterns;
+    constructor(customPatterns) {
+        this.patterns = customPatterns ?? DEFAULT_PATTERNS;
+    }
+    /**
+     * Check whether a message should be handled directly (no agent spawn).
+     */
+    shouldHandleDirectly(message, config) {
+        const trimmed = message.trim();
+        if (trimmed.length === 0)
+            return false;
+        // Check configurable patterns from squad config
+        if (config?.routing?.rules) {
+            for (const rule of config.routing.rules) {
+                if (rule.workType === 'direct' || rule.tier === 'direct') {
+                    // Rules explicitly marked as 'direct' tier mean
+                    // the coordinator should handle them, but we still
+                    // fall through to pattern matching below.
+                }
+            }
+        }
+        return this.matchPattern(trimmed) !== undefined;
+    }
+    /**
+     * Handle a message directly and return a response.
+     * Should only be called after shouldHandleDirectly() returns true.
+     */
+    handleDirect(message, context) {
+        const trimmed = message.trim();
+        const match = this.matchPattern(trimmed);
+        if (!match) {
+            return {
+                response: 'I\'m not sure how to handle that directly. Let me route it to an agent.',
+                category: 'help',
+                confidence: 'medium',
+            };
+        }
+        const response = match.handler(trimmed, context);
+        // Emit event for observability
+        if (context.eventBus) {
+            context.eventBus.emit({
+                type: 'coordinator:routing',
+                sessionId: context.sessionId,
+                payload: {
+                    decision: 'direct',
+                    category: match.category,
+                    messageLength: trimmed.length,
+                },
+                timestamp: new Date(),
+            });
+        }
+        return {
+            response,
+            category: match.category,
+            confidence: 'high',
+        };
+    }
+    /**
+     * Add a custom pattern at runtime.
+     */
+    addPattern(pattern) {
+        this.patterns.push(pattern);
+    }
+    /**
+     * Get all registered patterns.
+     */
+    getPatterns() {
+        return this.patterns;
+    }
+    // --- Private ---
+    matchPattern(message) {
+        for (const pattern of this.patterns) {
+            for (const regex of pattern.patterns) {
+                if (regex.test(message)) {
+                    return pattern;
+                }
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=direct-response.js.map

package/dist/coordinator/direct-response.js.map

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

package/dist/coordinator/fan-out.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Parallel Fan-Out Session Spawning (M1-10, Issue #130)
+ *
+ * Spawns multiple agent sessions concurrently using Promise.allSettled
+ * for maximum throughput. Each spawn compiles charter → resolves model
+ * → creates session → sends initial message. Event aggregation collects
+ * all session events into coordinator's event bus. Error isolation ensures
+ * one session failure doesn't affect others.
+ */
+import type { AgentCharter } from '../agents/index.js';
+import type { EventBus } from '../client/event-bus.js';
+import type { SessionPool } from '../client/session-pool.js';
+export interface AgentSpawnConfig {
+    /** Agent name to spawn */
+    agentName: string;
+    /** Task description for the agent */
+    task: string;
+    /** Priority level */
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    /** Additional context to pass */
+    context?: string;
+    /** Model override (skips resolution) */
+    modelOverride?: string;
+}
+export interface SpawnResult {
+    /** Agent name that was spawned */
+    agentName: string;
+    /** Session ID if spawn succeeded */
+    sessionId?: string;
+    /** Spawn outcome */
+    status: 'success' | 'failed';
+    /** Error message if failed */
+    error?: string;
+    /** Start time */
+    startTime: Date;
+    /** End time */
+    endTime: Date;
+}
+export interface FanOutDependencies {
+    /** Charter compilation function */
+    compileCharter: (agentName: string) => Promise<AgentCharter>;
+    /** Model resolution function */
+    resolveModel: (charter: AgentCharter, override?: string) => Promise<string>;
+    /** Session creation function */
+    createSession: (config: any) => Promise<{
+        sessionId: string;
+        sendMessage: (opts: any) => Promise<void>;
+    }>;
+    /** Session pool for tracking */
+    sessionPool: SessionPool;
+    /** Event bus for aggregation */
+    eventBus: EventBus;
+}
+/**
+ * Spawn multiple agents in parallel using Promise.allSettled.
+ *
+ * Each spawn:
+ * 1. Compile charter.md → AgentCharter
+ * 2. Resolve model (override or charter or auto-select)
+ * 3. Create session via SquadClient
+ * 4. Send initial message with task and context
+ * 5. Aggregate events to coordinator's event bus
+ *
+ * Error isolation: one failure doesn't block others.
+ * Returns SpawnResult[] with outcomes for each agent.
+ *
+ * @param configs - Array of agent spawn configurations
+ * @param deps - Injected dependencies (charter compiler, model resolver, client)
+ * @returns Promise resolving to array of spawn results
+ */
+export declare function spawnParallel(configs: AgentSpawnConfig[], deps: FanOutDependencies): Promise<SpawnResult[]>;
+/**
+ * Subscribe to all events from a spawned session and forward them
+ * to the coordinator's event bus with agent context.
+ *
+ * @param sessionId - Session ID to subscribe to
+ * @param agentName - Agent name for context
+ * @param sessionEventEmitter - Session's event emitter (if available)
+ * @param coordinatorEventBus - Coordinator's event bus
+ */
+export declare function aggregateSessionEvents(sessionId: string, agentName: string, sessionEventEmitter: any, // SquadSession
+coordinatorEventBus: EventBus): void;
+//# sourceMappingURL=fan-out.d.ts.map

package/dist/coordinator/fan-out.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fan-out.d.ts","sourceRoot":"","sources":["../../src/coordinator/fan-out.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAI7D,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,eAAe;IACf,OAAO,EAAE,IAAI,CAAC;CACf;AAID,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,gCAAgC;IAChC,YAAY,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,gCAAgC;IAChC,aAAa,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;IAC1G,gCAAgC;IAChC,WAAW,EAAE,WAAW,CAAC;IACzB,gCAAgC;IAChC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,WAAW,EAAE,CAAC,CAmBxB;AAoGD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,GAAG,EAAE,eAAe;AACzC,mBAAmB,EAAE,QAAQ,GAC5B,IAAI,CAuBN"}