@bradygaster/squad-sdk 0.7.0 → 0.8.2

package/dist/config/routing.js

@@ -0,0 +1,247 @@
+/**
+ * Routing Configuration Module
+ *
+ * Parses routing.md markdown format into typed RoutingConfig and compiles routing rules
+ * for fast pattern matching. Supports both markdown (legacy) and typed config (new).
+ *
+ * @module config/routing
+ */
+import { normalizeEol } from '../utils/normalize-eol.js';
+/**
+ * Parses routing.md markdown table format into typed RoutingConfig.
+ *
+ * Expected format:
+ * ```markdown
+ * ## Routing Table
+ *
+ * | Work Type | Route To | Examples |
+ * |-----------|----------|----------|
+ * | feature-dev | Lead | New features, enhancements |
+ * | bug-fix | Developer | Bug fixes, patches |
+ * ```
+ *
+ * @param content - Markdown content from routing.md
+ * @returns Parsed routing configuration
+ */
+export function parseRoutingMarkdown(content) {
+    content = normalizeEol(content);
+    const rules = [];
+    const lines = content.split('\n');
+    let inRoutingTable = false;
+    let headerPassed = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Detect routing table section
+        if (trimmed.toLowerCase().includes('## routing table') ||
+            trimmed.toLowerCase().includes('##routing table')) {
+            inRoutingTable = true;
+            headerPassed = false;
+            continue;
+        }
+        // Stop at next section
+        if (inRoutingTable && trimmed.startsWith('##') && !trimmed.toLowerCase().includes('routing table')) {
+            inRoutingTable = false;
+            continue;
+        }
+        // Parse table rows
+        if (inRoutingTable && trimmed.startsWith('|')) {
+            // Skip header row
+            if (trimmed.toLowerCase().includes('work type') || trimmed.toLowerCase().includes('pattern')) {
+                headerPassed = true;
+                continue;
+            }
+            // Skip separator row
+            if (trimmed.includes('---') || trimmed.includes('===')) {
+                continue;
+            }
+            if (!headerPassed) {
+                continue;
+            }
+            // Parse data row: | Work Type | Route To | Examples |
+            const cells = trimmed
+                .split('|')
+                .map(cell => cell.trim())
+                .filter(cell => cell.length > 0);
+            if (cells.length >= 2) {
+                const workType = cells[0];
+                const routeTo = cells[1];
+                const examples = cells.length >= 3 ? cells[2].split(',').map(ex => ex.trim()) : undefined;
+                // Parse agent names (may be comma-separated or single)
+                const agents = routeTo.split(',').map(a => a.trim()).filter(a => a.length > 0);
+                if (workType && agents.length > 0) {
+                    rules.push({
+                        workType,
+                        agents,
+                        examples,
+                        confidence: 'high'
+                    });
+                }
+            }
+        }
+    }
+    return {
+        rules,
+        governance: {
+            eagerByDefault: true,
+            scribeAutoRuns: false,
+            allowRecursiveSpawn: false
+        }
+    };
+}
+/**
+ * Compiles routing rules for fast pattern matching.
+ *
+ * Creates regex patterns from work types and assigns priority scores
+ * based on specificity. More specific patterns get higher priority.
+ *
+ * @param config - Routing configuration to compile
+ * @returns Compiled router with regex patterns
+ */
+export function compileRoutingRules(config) {
+    const workTypeRules = [];
+    for (const rule of config.rules) {
+        const patterns = generatePatterns(rule.workType, rule.examples);
+        const priority = calculatePriority(rule.workType, patterns);
+        workTypeRules.push({
+            workType: rule.workType,
+            agents: rule.agents,
+            patterns,
+            examples: rule.examples,
+            confidence: rule.confidence || 'medium',
+            priority
+        });
+    }
+    // Sort by priority (highest first)
+    workTypeRules.sort((a, b) => b.priority - a.priority);
+    // Compile issue routing rules if present
+    const issueRules = config.issueRouting?.map(compileIssueRule);
+    return {
+        workTypeRules,
+        issueRules,
+        governance: config.governance
+    };
+}
+/**
+ * Matches a message to routing rules.
+ *
+ * @param message - User message to match
+ * @param router - Compiled router
+ * @returns Best routing match
+ */
+export function matchRoute(message, router) {
+    const lowerMessage = message.toLowerCase();
+    // Try to match work type rules
+    for (const rule of router.workTypeRules) {
+        for (const pattern of rule.patterns) {
+            if (pattern.test(lowerMessage)) {
+                return {
+                    agents: rule.agents,
+                    confidence: rule.confidence || 'medium',
+                    rule,
+                    reason: `Matched work type: ${rule.workType}`
+                };
+            }
+        }
+    }
+    // No match - return fallback
+    return {
+        agents: router.fallbackAgent ? [router.fallbackAgent] : ['@coordinator'],
+        confidence: 'low',
+        reason: 'No matching route found, using fallback'
+    };
+}
+/**
+ * Generates regex patterns from work type and examples.
+ */
+function generatePatterns(workType, examples) {
+    const patterns = [];
+    // Create pattern from work type itself
+    const typeWords = workType
+        .toLowerCase()
+        .split(/[-_\s]+/)
+        .filter(w => w.length > 2); // Skip short words like "to", "of"
+    if (typeWords.length > 0) {
+        // Match if all type words are present
+        const typePattern = new RegExp(typeWords.map(w => `(?=.*\\b${escapeRegex(w)})`).join(''), 'i');
+        patterns.push(typePattern);
+    }
+    // Create patterns from examples
+    if (examples && examples.length > 0) {
+        for (const example of examples) {
+            const exampleWords = example
+                .toLowerCase()
+                .split(/[-_\s,]+/)
+                .filter(w => w.length > 2);
+            if (exampleWords.length > 0) {
+                // Match if any significant example words are present
+                const examplePattern = new RegExp(exampleWords.map(w => `\\b${escapeRegex(w)}\\b`).join('|'), 'i');
+                patterns.push(examplePattern);
+            }
+        }
+    }
+    return patterns;
+}
+/**
+ * Calculates priority for a rule based on specificity.
+ * Higher values = more specific = higher priority.
+ */
+function calculatePriority(workType, patterns) {
+    // Base priority on work type length and pattern count
+    const typeLength = workType.length;
+    const patternCount = patterns.length;
+    const wordCount = workType.split(/[-_\s]+/).length;
+    // More words and longer types are more specific
+    return typeLength + (wordCount * 10) + (patternCount * 5);
+}
+/**
+ * Compiles an issue routing rule with regex patterns.
+ */
+function compileIssueRule(rule) {
+    return {
+        labelPattern: new RegExp(escapeRegex(rule.label), 'i'),
+        action: rule.action,
+        target: rule.target,
+        requiredLabels: rule.requiredLabels?.map(label => new RegExp(escapeRegex(label), 'i')),
+        excludedLabels: rule.excludedLabels?.map(label => new RegExp(escapeRegex(label), 'i')),
+        state: rule.state
+    };
+}
+/**
+ * Escapes special regex characters.
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Matches issue labels to routing rules.
+ *
+ * @param labels - Issue labels to match
+ * @param rules - Compiled issue routing rules
+ * @returns Matching rule if found
+ */
+export function matchIssueLabels(labels, rules) {
+    for (const rule of rules) {
+        // Check if primary label matches
+        const primaryMatch = labels.some(label => rule.labelPattern.test(label));
+        if (!primaryMatch) {
+            continue;
+        }
+        // Check required labels
+        if (rule.requiredLabels && rule.requiredLabels.length > 0) {
+            const allRequiredPresent = rule.requiredLabels.every(pattern => labels.some(label => pattern.test(label)));
+            if (!allRequiredPresent) {
+                continue;
+            }
+        }
+        // Check excluded labels
+        if (rule.excludedLabels && rule.excludedLabels.length > 0) {
+            const anyExcludedPresent = rule.excludedLabels.some(pattern => labels.some(label => pattern.test(label)));
+            if (anyExcludedPresent) {
+                continue;
+            }
+        }
+        return rule;
+    }
+    return undefined;
+}
+//# sourceMappingURL=routing.js.map

package/dist/config/routing.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Squad Configuration Schema
+ * Typed configuration interface for Squad teams
+ */
+export interface SquadConfig {
+    version: string;
+    team: TeamConfig;
+    routing: RoutingConfig;
+    models: ModelConfig;
+    agents: AgentConfig[];
+    hooks?: HooksConfig;
+    ceremonies?: CeremonyConfig[];
+    plugins?: PluginConfig;
+}
+export interface TeamConfig {
+    name: string;
+    description?: string;
+    projectContext?: string;
+    issueSource?: {
+        repo: string;
+        filters?: string[];
+    };
+}
+export interface AgentConfig {
+    name: string;
+    role: string;
+    displayName?: string;
+    charter?: string;
+    model?: string;
+    tools?: string[];
+    status?: 'active' | 'inactive' | 'retired';
+}
+export interface RoutingConfig {
+    rules: RoutingRule[];
+    defaultAgent?: string;
+    fallbackBehavior?: 'ask' | 'default-agent' | 'coordinator';
+}
+export interface RoutingRule {
+    pattern: string;
+    agents: string[];
+    tier?: 'direct' | 'lightweight' | 'standard' | 'full';
+    priority?: number;
+}
+export interface ModelConfig {
+    default: string;
+    defaultTier: 'premium' | 'standard' | 'fast';
+    tiers: Record<string, string[]>;
+    agentOverrides?: Record<string, string>;
+    taskTypeMapping?: Record<string, string>;
+}
+export interface HooksConfig {
+    allowedWritePaths?: string[];
+    blockedCommands?: string[];
+    maxAskUserPerSession?: number;
+    scrubPii?: boolean;
+    reviewerLockout?: boolean;
+}
+export interface CeremonyConfig {
+    name: string;
+    schedule?: string;
+    participants?: string[];
+    agenda?: string;
+    enabled?: boolean;
+}
+export interface PluginConfig {
+    enabled: string[];
+    config?: Record<string, unknown>;
+}
+export declare const DEFAULT_CONFIG: SquadConfig;
+export declare function defineConfig(config: Partial<SquadConfig>): SquadConfig;
+export declare function validateConfig(config: unknown): config is SquadConfig;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,KAAK,GAAG,eAAe,GAAG,aAAa,CAAC;CAC5D;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,WAAW;IAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,eAAO,MAAM,cAAc,EAAE,WAoB5B,CAAC;AAEF,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAoBtE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,WAAW,CAYrE"}

package/dist/config/schema.js

@@ -0,0 +1,63 @@
+/**
+ * Squad Configuration Schema
+ * Typed configuration interface for Squad teams
+ */
+export const DEFAULT_CONFIG = {
+    version: '0.6.0',
+    team: {
+        name: 'Default Squad',
+        description: 'A Squad team',
+    },
+    routing: {
+        rules: [],
+        fallbackBehavior: 'coordinator',
+    },
+    models: {
+        default: 'claude-sonnet-4',
+        defaultTier: 'standard',
+        tiers: {
+            premium: ['claude-opus-4', 'claude-opus-4.5'],
+            standard: ['claude-sonnet-4', 'claude-sonnet-4.5', 'gpt-5.1-codex'],
+            fast: ['claude-haiku-4.5', 'gpt-5.1-codex-mini'],
+        },
+    },
+    agents: [],
+};
+export function defineConfig(config) {
+    return {
+        ...DEFAULT_CONFIG,
+        ...config,
+        team: {
+            ...DEFAULT_CONFIG.team,
+            ...config.team,
+        },
+        routing: {
+            ...DEFAULT_CONFIG.routing,
+            ...config.routing,
+            rules: config.routing?.rules ?? DEFAULT_CONFIG.routing.rules,
+        },
+        models: {
+            ...DEFAULT_CONFIG.models,
+            ...config.models,
+            tiers: config.models?.tiers ?? DEFAULT_CONFIG.models.tiers,
+        },
+        agents: config.agents ?? DEFAULT_CONFIG.agents,
+    };
+}
+export function validateConfig(config) {
+    if (typeof config !== 'object' || config === null)
+        return false;
+    const c = config;
+    if (typeof c.version !== 'string')
+        return false;
+    if (!c.team || typeof c.team.name !== 'string')
+        return false;
+    if (!c.routing || !Array.isArray(c.routing.rules))
+        return false;
+    if (!c.models || typeof c.models.default !== 'string')
+        return false;
+    if (!Array.isArray(c.agents))
+        return false;
+    return true;
+}
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2EH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE;QACJ,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,cAAc;KAC5B;IACD,OAAO,EAAE;QACP,KAAK,EAAE,EAAE;QACT,gBAAgB,EAAE,aAAa;KAChC;IACD,MAAM,EAAE;QACN,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,UAAU;QACvB,KAAK,EAAE;YACL,OAAO,EAAE,CAAC,eAAe,EAAE,iBAAiB,CAAC;YAC7C,QAAQ,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,CAAC;YACnE,IAAI,EAAE,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;SACjD;KACF;IACD,MAAM,EAAE,EAAE;CACX,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAA4B;IACvD,OAAO;QACL,GAAG,cAAc;QACjB,GAAG,MAAM;QACT,IAAI,EAAE;YACJ,GAAG,cAAc,CAAC,IAAI;YACtB,GAAG,MAAM,CAAC,IAAI;SACf;QACD,OAAO,EAAE;YACP,GAAG,cAAc,CAAC,OAAO;YACzB,GAAG,MAAM,CAAC,OAAO;YACjB,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI,cAAc,CAAC,OAAO,CAAC,KAAK;SAC7D;QACD,MAAM,EAAE;YACN,GAAG,cAAc,CAAC,MAAM;YACxB,GAAG,MAAM,CAAC,MAAM;YAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK;SAC3D;QACD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAEhE,MAAM,CAAC,GAAG,MAA8B,CAAC;IAEzC,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC7D,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAE3C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/coordinator/coordinator.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 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 type { EventBus } from '../runtime/event-bus.js';
+import type { SquadConfig } from '../runtime/config.js';
+import { DirectResponseHandler, type CoordinatorContext, type DirectResponseResult } from './direct-response.js';
+import { type CompiledRouter, type RoutingMatch } from '../config/routing.js';
+import { type SpawnResult, type FanOutDependencies } from './fan-out.js';
+export type { CoordinatorContext } from './direct-response.js';
+export type SpawnStrategy = 'direct' | 'single' | 'multi' | 'fallback';
+export interface CoordinatorResult {
+    /** How the message was handled */
+    strategy: SpawnStrategy;
+    /** Direct response (if strategy is 'direct') */
+    directResponse?: DirectResponseResult;
+    /** Routing match info */
+    routing?: RoutingMatch;
+    /** Spawn results (if agents were spawned) */
+    spawnResults?: SpawnResult[];
+    /** Time taken to handle the message in ms */
+    durationMs: number;
+}
+export interface SquadCoordinatorOptions {
+    /** Squad configuration */
+    config: SquadConfig;
+    /** Event bus for observability */
+    eventBus?: EventBus;
+    /** Fan-out dependencies (charter compiler, model resolver, session creator) */
+    fanOutDeps?: FanOutDependencies;
+    /** Custom direct-response handler */
+    directHandler?: DirectResponseHandler;
+    /** Custom compiled router (skips compilation from config) */
+    compiledRouter?: CompiledRouter;
+}
+/**
+ * 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 declare class SquadCoordinator {
+    private config;
+    private eventBus?;
+    private directHandler;
+    private compiledRouter;
+    private fanOutDeps?;
+    constructor(options: SquadCoordinatorOptions);
+    /**
+     * Main dispatch — handle an incoming user message.
+     */
+    handleMessage(message: string, context: CoordinatorContext): Promise<CoordinatorResult>;
+    /**
+     * Get the compiled router (for inspection / testing).
+     */
+    getRouter(): CompiledRouter;
+    /**
+     * Get the direct response handler (for inspection / testing).
+     */
+    getDirectHandler(): DirectResponseHandler;
+    /**
+     * Update configuration at runtime.
+     */
+    updateConfig(config: SquadConfig): void;
+    private determineStrategy;
+    private buildSpawnConfigs;
+    private compileRouter;
+    private emit;
+}
+//# sourceMappingURL=coordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/coordinator/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAwC,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAM/G,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/D,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAIvE,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,gDAAgD;IAChD,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,yBAAyB;IACzB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,qCAAqC;IACrC,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAID;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,UAAU,CAAC,CAAqB;gBAE5B,OAAO,EAAE,uBAAuB;IAc5C;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IA+F7B;;OAEG;IACH,SAAS,IAAI,cAAc;IAI3B;;OAEG;IACH,gBAAgB,IAAI,qBAAqB;IAIzC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAOvC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,aAAa;YAiBP,IAAI;CAanB"}