@bradygaster/squad-sdk 0.7.0 → 0.8.2

package/dist/coordinator/fan-out.js

@@ -0,0 +1,161 @@
+/**
+ * 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.
+ */
+// --- Fan-Out Orchestrator ---
+/**
+ * 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 async function spawnParallel(configs, deps) {
+    const spawnPromises = configs.map(config => spawnSingle(config, deps));
+    const settledResults = await Promise.allSettled(spawnPromises);
+    return settledResults.map((result, index) => {
+        if (result.status === 'fulfilled') {
+            return result.value;
+        }
+        else {
+            // Rejection from spawnSingle shouldn't happen (it catches internally),
+            // but handle defensively
+            return {
+                agentName: configs[index].agentName,
+                status: 'failed',
+                error: result.reason?.message || String(result.reason),
+                startTime: new Date(),
+                endTime: new Date(),
+            };
+        }
+    });
+}
+/**
+ * Spawn a single agent session.
+ * Catches all errors and returns a SpawnResult (never rejects).
+ */
+async function spawnSingle(config, deps) {
+    const startTime = new Date();
+    try {
+        // Step 1: Compile charter
+        const charter = await deps.compileCharter(config.agentName);
+        // Step 2: Resolve model
+        const model = config.modelOverride
+            ? config.modelOverride
+            : await deps.resolveModel(charter, config.modelOverride);
+        // Step 3: Create session
+        const session = await deps.createSession({
+            model,
+            clientName: `squad-agent-${config.agentName}`,
+        });
+        // Step 4: Register in session pool
+        deps.sessionPool.add({
+            id: session.sessionId,
+            agentName: config.agentName,
+            status: 'active',
+            createdAt: startTime,
+        });
+        // Step 5: Send initial task message
+        const initialPrompt = buildInitialPrompt(config);
+        await session.sendMessage({
+            prompt: initialPrompt,
+            mode: 'immediate',
+        });
+        // Step 6: Emit spawn success event
+        await deps.eventBus.emit({
+            type: 'session.created',
+            sessionId: session.sessionId,
+            payload: { agentName: config.agentName, priority: config.priority || 'normal' },
+            timestamp: new Date(),
+        });
+        return {
+            agentName: config.agentName,
+            sessionId: session.sessionId,
+            status: 'success',
+            startTime,
+            endTime: new Date(),
+        };
+    }
+    catch (error) {
+        // Error isolation: one spawn failure doesn't affect others
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        await deps.eventBus.emit({
+            type: 'session.error',
+            sessionId: undefined,
+            payload: { agentName: config.agentName, error: errorMessage },
+            timestamp: new Date(),
+        });
+        return {
+            agentName: config.agentName,
+            status: 'failed',
+            error: errorMessage,
+            startTime,
+            endTime: new Date(),
+        };
+    }
+}
+/**
+ * Build the initial prompt message for a spawned agent.
+ * Includes task, priority, and optional context.
+ */
+function buildInitialPrompt(config) {
+    const parts = [];
+    if (config.priority && config.priority !== 'normal') {
+        parts.push(`**Priority:** ${config.priority.toUpperCase()}`);
+    }
+    parts.push('', `**Task:**`, config.task);
+    if (config.context) {
+        parts.push('', `**Context:**`, config.context);
+    }
+    return parts.join('\n');
+}
+// --- Event Aggregation Helper ---
+/**
+ * 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 function aggregateSessionEvents(sessionId, agentName, sessionEventEmitter, // SquadSession
+coordinatorEventBus) {
+    // Forward all session events to coordinator's event bus
+    const eventTypes = [
+        'message.delta',
+        'message.complete',
+        'tool.start',
+        'tool.complete',
+        'session.error',
+        'session.complete',
+    ];
+    for (const eventType of eventTypes) {
+        if (sessionEventEmitter.on) {
+            sessionEventEmitter.on(eventType, (event) => {
+                coordinatorEventBus.emit({
+                    type: eventType,
+                    sessionId,
+                    payload: { agentName, ...event },
+                    timestamp: new Date(),
+                });
+            });
+        }
+    }
+}
+//# sourceMappingURL=fan-out.js.map

package/dist/coordinator/fan-out.js.map

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

package/dist/coordinator/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Coordinator Orchestrator (PRD 5)
+ *
+ * The central orchestration engine. Replaces the 32KB squad.agent.md
+ * prompt-based coordinator with a TypeScript program that manages
+ * agent sessions, routes work, and observes progress via SDK events.
+ */
+export { SquadCoordinator, type SquadCoordinatorOptions, type CoordinatorResult, type SpawnStrategy, type CoordinatorContext, } from './coordinator.js';
+export { DirectResponseHandler, type DirectResponseResult, type DirectResponseCategory, type DirectResponsePattern, } from './direct-response.js';
+export { spawnParallel, aggregateSessionEvents, type AgentSpawnConfig, type SpawnResult, type FanOutDependencies, } from './fan-out.js';
+export { selectResponseTier, getTier, type TierName, type TierContext, type ModelTierSuggestion, } from './response-tiers.js';
+import type { SquadClient } from '../client/index.js';
+import type { EventBus } from '../runtime/event-bus.js';
+import type { AgentSessionManager } from '../agents/index.js';
+import type { HookPipeline } from '../hooks/index.js';
+import type { ToolRegistry } from '../tools/index.js';
+export type ResponseTier = 'direct' | 'lightweight' | 'standard' | 'full';
+export interface RoutingDecision {
+    /** Tier of response based on complexity */
+    tier: ResponseTier;
+    /** Target agent(s) for this request */
+    agents: string[];
+    /** Whether agents should run in parallel */
+    parallel: boolean;
+    /** Routing rationale (for observability) */
+    rationale: string;
+}
+export interface CoordinatorConfig {
+    /** Path to the team root (.squad/ directory) */
+    teamRoot: string;
+    /** Default model for routing decisions */
+    model?: string;
+    /** Enable parallel fan-out for multi-agent tasks */
+    enableParallel?: boolean;
+}
+export interface CoordinatorDeps {
+    client?: SquadClient;
+    eventBus?: EventBus;
+    agentManager?: AgentSessionManager;
+    hookPipeline?: HookPipeline;
+    toolRegistry?: ToolRegistry;
+}
+export declare class Coordinator {
+    private client;
+    private eventBus;
+    private agentManager;
+    private hookPipeline;
+    private toolRegistry;
+    private config;
+    private initialized;
+    private unsubscribers;
+    constructor(config: CoordinatorConfig, deps?: CoordinatorDeps);
+    /** Initialize the coordinator: wire up event subscriptions and mark ready */
+    initialize(): Promise<void>;
+    /** Route an incoming user message to the appropriate agent(s) */
+    route(message: string): Promise<RoutingDecision>;
+    /** Execute a routing decision: emit routing event on EventBus */
+    execute(decision: RoutingDecision, message: string): Promise<void>;
+    /** Graceful shutdown: unsubscribe from events and release references */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/coordinator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/coordinator/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAClB,OAAO,EACP,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAgB,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOtD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,IAAI,EAAE,YAAY,CAAC;IACnB,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAID,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAsB;gBAE/B,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,eAAe;IAW7D,6EAA6E;IACvE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BjC,iEAAiE;IAC3D,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA0DtD,iEAAiE;IAC3D,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxE,wEAAwE;IAClE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAqBhC"}

package/dist/coordinator/index.js

@@ -0,0 +1,171 @@
+/**
+ * Coordinator Orchestrator (PRD 5)
+ *
+ * The central orchestration engine. Replaces the 32KB squad.agent.md
+ * prompt-based coordinator with a TypeScript program that manages
+ * agent sessions, routes work, and observes progress via SDK events.
+ */
+// --- M3-1 Coordinator ---
+export { SquadCoordinator, } from './coordinator.js';
+// --- M3-6 Direct Response ---
+export { DirectResponseHandler, } from './direct-response.js';
+// --- M1-10 Fan-Out ---
+export { spawnParallel, aggregateSessionEvents, } from './fan-out.js';
+// --- M3-4 Response Tiers ---
+export { selectResponseTier, getTier, } from './response-tiers.js';
+import { trace, SpanStatusCode } from '@opentelemetry/api';
+const tracer = trace.getTracer('squad-sdk');
+export class Coordinator {
+    client = null;
+    eventBus = null;
+    agentManager = null;
+    hookPipeline = null;
+    toolRegistry = null;
+    config;
+    initialized = false;
+    unsubscribers = [];
+    constructor(config, deps) {
+        this.config = config;
+        if (deps) {
+            this.client = deps.client ?? null;
+            this.eventBus = deps.eventBus ?? null;
+            this.agentManager = deps.agentManager ?? null;
+            this.hookPipeline = deps.hookPipeline ?? null;
+            this.toolRegistry = deps.toolRegistry ?? null;
+        }
+    }
+    /** Initialize the coordinator: wire up event subscriptions and mark ready */
+    async initialize() {
+        const span = tracer.startSpan('squad.coordinator.initialize');
+        try {
+            if (this.eventBus) {
+                this.unsubscribers.push(this.eventBus.subscribe('session:created', (event) => {
+                    console.log(`[Coordinator] Session created: ${event.sessionId ?? 'unknown'}`);
+                }));
+                this.unsubscribers.push(this.eventBus.subscribe('session:error', (event) => {
+                    console.log(`[Coordinator] Session error: ${event.sessionId ?? 'unknown'}`);
+                }));
+                this.unsubscribers.push(this.eventBus.subscribe('session:destroyed', (event) => {
+                    console.log(`[Coordinator] Session destroyed: ${event.sessionId ?? 'unknown'}`);
+                }));
+            }
+            this.initialized = true;
+        }
+        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();
+        }
+    }
+    /** Route an incoming user message to the appropriate agent(s) */
+    async route(message) {
+        const span = tracer.startSpan('squad.coordinator.route');
+        span.setAttribute('message.length', message.length);
+        try {
+            const lower = message.toLowerCase().trim();
+            let decision;
+            // Direct response: status queries, factual questions
+            if (/^(status|help|what is|who is|how many|show|list)\b/.test(lower)) {
+                decision = {
+                    tier: 'direct',
+                    agents: [],
+                    parallel: false,
+                    rationale: `Direct response for informational query: "${message}"`,
+                };
+            }
+            else {
+                // Agent name mention — route to that specific agent
+                const agentMention = lower.match(/@(\w+)/);
+                if (agentMention) {
+                    decision = {
+                        tier: 'standard',
+                        agents: [agentMention[1]],
+                        parallel: false,
+                        rationale: `Routed to mentioned agent: ${agentMention[1]}`,
+                    };
+                }
+                else if (/\bteam\b/.test(lower)) {
+                    // Team-wide task — fan-out to all agents
+                    decision = {
+                        tier: 'full',
+                        agents: ['all'],
+                        parallel: true,
+                        rationale: 'Team-wide task detected — fan-out to all agents',
+                    };
+                }
+                else {
+                    // Default: route to lead agent (Keaton)
+                    decision = {
+                        tier: 'standard',
+                        agents: ['lead'],
+                        parallel: false,
+                        rationale: 'Default routing to lead agent (Keaton)',
+                    };
+                }
+            }
+            span.setAttribute('routing.tier', decision.tier);
+            span.setAttribute('target.agents', decision.agents.join(','));
+            span.setAttribute('routing.reason', decision.rationale);
+            return decision;
+        }
+        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();
+        }
+    }
+    /** Execute a routing decision: emit routing event on EventBus */
+    async execute(decision, message) {
+        const span = tracer.startSpan('squad.coordinator.execute');
+        span.setAttribute('routing.tier', decision.tier);
+        span.setAttribute('target.agents', decision.agents.join(','));
+        try {
+            if (this.eventBus) {
+                await this.eventBus.emit({
+                    type: 'coordinator:routing',
+                    payload: { decision, message },
+                    timestamp: new Date(),
+                });
+            }
+        }
+        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();
+        }
+    }
+    /** Graceful shutdown: unsubscribe from events and release references */
+    async shutdown() {
+        const span = tracer.startSpan('squad.coordinator.shutdown');
+        try {
+            for (const unsub of this.unsubscribers) {
+                unsub();
+            }
+            this.unsubscribers = [];
+            this.initialized = false;
+            this.client = null;
+            this.eventBus = null;
+            this.agentManager = null;
+            this.hookPipeline = null;
+            this.toolRegistry = null;
+        }
+        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();
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/coordinator/index.js.map

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

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

@@ -0,0 +1,49 @@
+/**
+ * Response Tier Selection (M3-4, Issue #143)
+ *
+ * Not all tasks need the same level of agent involvement. This module
+ * selects one of four response tiers based on message complexity,
+ * keyword patterns, config overrides, and history hints.
+ *
+ * Tiers:
+ *   Direct      — Answer inline, no agent spawn
+ *   Lightweight — Single fast-model agent
+ *   Standard    — Single standard-model agent
+ *   Full        — Multi-agent fan-out (premium models)
+ */
+import type { SquadConfig } from '../config/schema.js';
+export type TierName = 'direct' | 'lightweight' | 'standard' | 'full';
+export type ModelTierSuggestion = 'none' | 'fast' | 'standard' | 'premium';
+export interface ResponseTier {
+    /** Tier identifier */
+    tier: TierName;
+    /** Suggested model tier */
+    modelTier: ModelTierSuggestion;
+    /** Maximum agents to spawn */
+    maxAgents: number;
+    /** Per-agent timeout in seconds */
+    timeout: number;
+}
+export interface TierContext {
+    /** Recent conversation history (summaries) */
+    recentHistory?: string[];
+    /** Names of currently available agents */
+    agentAvailability?: string[];
+    /** Number of currently active sessions */
+    currentLoad?: number;
+}
+/** Get a tier definition by name. */
+export declare function getTier(name: TierName): ResponseTier;
+/**
+ * Select the appropriate response tier for an incoming message.
+ *
+ * Priority order:
+ *  1. Config routing-rule tier overrides
+ *  2. Full-tier keyword patterns
+ *  3. Direct-tier keyword patterns (short / simple)
+ *  4. Lightweight keyword patterns
+ *  5. Context-based adjustments (load, history)
+ *  6. Default → standard
+ */
+export declare function selectResponseTier(message: string, config: SquadConfig, context?: TierContext): ResponseTier;
+//# sourceMappingURL=response-tiers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"response-tiers.d.ts","sourceRoot":"","sources":["../../src/coordinator/response-tiers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;AAEtE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,2BAA2B;IAC3B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAuCD,qCAAqC;AACrC,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAEpD;AA8BD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,WAAgB,GACxB,YAAY,CAoCd"}

package/dist/coordinator/response-tiers.js

@@ -0,0 +1,149 @@
+/**
+ * Response Tier Selection (M3-4, Issue #143)
+ *
+ * Not all tasks need the same level of agent involvement. This module
+ * selects one of four response tiers based on message complexity,
+ * keyword patterns, config overrides, and history hints.
+ *
+ * Tiers:
+ *   Direct      — Answer inline, no agent spawn
+ *   Lightweight — Single fast-model agent
+ *   Standard    — Single standard-model agent
+ *   Full        — Multi-agent fan-out (premium models)
+ */
+// --- Tier Definitions ---
+const TIER_DIRECT = {
+    tier: 'direct',
+    modelTier: 'none',
+    maxAgents: 0,
+    timeout: 0,
+};
+const TIER_LIGHTWEIGHT = {
+    tier: 'lightweight',
+    modelTier: 'fast',
+    maxAgents: 1,
+    timeout: 30,
+};
+const TIER_STANDARD = {
+    tier: 'standard',
+    modelTier: 'standard',
+    maxAgents: 1,
+    timeout: 120,
+};
+const TIER_FULL = {
+    tier: 'full',
+    modelTier: 'premium',
+    maxAgents: 5,
+    timeout: 300,
+};
+const TIERS = {
+    direct: TIER_DIRECT,
+    lightweight: TIER_LIGHTWEIGHT,
+    standard: TIER_STANDARD,
+    full: TIER_FULL,
+};
+/** Get a tier definition by name. */
+export function getTier(name) {
+    return { ...TIERS[name] };
+}
+// --- Keyword Patterns ---
+/** Patterns that suggest a direct (no-spawn) response. */
+const DIRECT_PATTERNS = [
+    /^(hi|hello|hey|thanks|thank you|ok|okay)\b/i,
+    /^what('s| is) (your|the) (name|version|status)\b/i,
+    /^(help|usage|how do I use)\b/i,
+    /\?$/,
+];
+/** Patterns that suggest lightweight (quick lookup / simple task). */
+const LIGHTWEIGHT_PATTERNS = [
+    /\b(list|show|display|get|find|search|where is)\b/i,
+    /\b(status|info|check)\b/i,
+    /\b(rename|move|delete|remove)\s+\w+/i,
+];
+/** Patterns that suggest full multi-agent fan-out. */
+const FULL_PATTERNS = [
+    /\b(refactor|redesign|migrate|rewrite)\b.*\b(entire|all|whole|system|codebase)\b/i,
+    /\b(implement|build|create)\b.*\b(feature|module|system|service)\b/i,
+    /\bmulti[- ]?(agent|step|file)\b/i,
+    /\b(security audit|pen\s?test|vulnerability scan)\b/i,
+    /\bfull\s+(review|analysis|sweep)\b/i,
+];
+// --- Selection Logic ---
+/**
+ * Select the appropriate response tier for an incoming message.
+ *
+ * Priority order:
+ *  1. Config routing-rule tier overrides
+ *  2. Full-tier keyword patterns
+ *  3. Direct-tier keyword patterns (short / simple)
+ *  4. Lightweight keyword patterns
+ *  5. Context-based adjustments (load, history)
+ *  6. Default → standard
+ */
+export function selectResponseTier(message, config, context = {}) {
+    const trimmed = message.trim();
+    // 1. Config override: check routing rules for explicit tier
+    const configTier = matchConfigTier(trimmed, config);
+    if (configTier)
+        return getTier(configTier);
+    // 2. Full patterns (checked first — they are most impactful)
+    if (FULL_PATTERNS.some((p) => p.test(trimmed))) {
+        return applyLoadAdjustment(getTier('full'), context);
+    }
+    // 3. Very short messages are usually direct
+    if (trimmed.length < 20 && !trimmed.includes('\n')) {
+        if (DIRECT_PATTERNS.some((p) => p.test(trimmed))) {
+            return getTier('direct');
+        }
+    }
+    // 4. Direct patterns (greetings, simple questions)
+    if (DIRECT_PATTERNS.some((p) => p.test(trimmed))) {
+        return getTier('direct');
+    }
+    // 5. Lightweight patterns
+    if (LIGHTWEIGHT_PATTERNS.some((p) => p.test(trimmed))) {
+        return applyLoadAdjustment(getTier('lightweight'), context);
+    }
+    // 6. History hint: if recent history contains multi-file changes → standard+
+    if (context.recentHistory && context.recentHistory.length > 3) {
+        return applyLoadAdjustment(getTier('standard'), context);
+    }
+    // Default: standard
+    return applyLoadAdjustment(getTier('standard'), context);
+}
+// --- Helpers ---
+function matchConfigTier(message, config) {
+    if (!config.routing?.rules)
+        return undefined;
+    const lower = message.toLowerCase();
+    for (const rule of config.routing.rules) {
+        if (!rule.tier)
+            continue;
+        // Simple pattern match against the rule pattern
+        const words = rule.pattern
+            .toLowerCase()
+            .split(/[-_\s]+/)
+            .filter((w) => w.length > 2);
+        if (words.length > 0 && words.every((w) => lower.includes(w))) {
+            return rule.tier;
+        }
+    }
+    return undefined;
+}
+/**
+ * Downgrade tier when load is high to conserve resources.
+ */
+function applyLoadAdjustment(tier, context) {
+    if (context.currentLoad === undefined)
+        return tier;
+    // If load is ≥ 4 active sessions, cap at standard
+    if (context.currentLoad >= 4 && tier.tier === 'full') {
+        return getTier('standard');
+    }
+    // If load is ≥ 6, cap at lightweight
+    if (context.currentLoad >= 6 && tier.tier === 'standard') {
+        return getTier('lightweight');
+    }
+    return tier;
+}
+//# sourceMappingURL=response-tiers.js.map

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

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