@bradygaster/squad-sdk 0.6.2 → 0.8.0

package/dist/runtime/benchmarks.js.map

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

package/dist/runtime/config.d.ts

@@ -0,0 +1,313 @@
+/**
+ * Squad Configuration Loader
+ *
+ * Loads and validates squad.config.ts or squad.config.json configuration files.
+ * Implements the config schema design from spike #72.
+ *
+ * @module runtime/config
+ */
+/**
+ * Model tier classification.
+ */
+export type ModelTier = 'premium' | 'standard' | 'fast';
+/**
+ * Model identifier from Copilot CLI.
+ */
+export type ModelId = string;
+/**
+ * Work type categories for routing.
+ */
+export type WorkType = 'feature-dev' | 'bug-fix' | 'testing' | 'documentation' | 'refactoring' | 'architecture' | 'research' | 'triage' | 'meta' | string;
+/**
+ * Agent role for model selection.
+ */
+export type AgentRole = 'lead' | 'developer' | 'tester' | 'designer' | 'scribe' | 'coordinator';
+/**
+ * Task output type for model selection.
+ */
+export type TaskOutputType = 'code' | 'text' | 'analysis' | 'decision';
+/**
+ * Model selection configuration (Layer 3 + Layer 4).
+ */
+export interface ModelSelectionConfig {
+    /** Default model for new agents (Layer 4) */
+    defaultModel: ModelId;
+    /** Default tier when no specific model is chosen */
+    defaultTier: ModelTier;
+    /** Task output type → model mapping */
+    taskRules?: TaskToModelRule[];
+    /** Role → model mapping with conditions */
+    roleMapping?: RoleToModelMapping[];
+    /** Complexity-based adjustments */
+    complexityAdjustments?: ComplexityAdjustment[];
+    /** Fallback chains per tier */
+    fallbackChains: {
+        premium: ModelId[];
+        standard: ModelId[];
+        fast: ModelId[];
+    };
+    /** Prefer same provider when falling back */
+    preferSameProvider?: boolean;
+    /** Respect tier ceiling during fallback (don't upgrade to premium on standard failure) */
+    respectTierCeiling?: boolean;
+    /** Nuclear fallback configuration */
+    nuclearFallback?: {
+        enabled: boolean;
+        model: ModelId;
+        maxRetriesBeforeNuclear: number;
+    };
+}
+/**
+ * Task-to-model selection rule.
+ */
+export interface TaskToModelRule {
+    /** Task output type */
+    outputType: TaskOutputType;
+    /** Model to use for this output type */
+    model: ModelId;
+    /** Optional conditions */
+    conditions?: {
+        minComplexity?: number;
+        workType?: WorkType[];
+    };
+}
+/**
+ * Role-to-model mapping with override conditions.
+ */
+export interface RoleToModelMapping {
+    /** Agent role */
+    role: AgentRole;
+    /** Default model for this role */
+    model: ModelId;
+    /** Override conditions */
+    overrides?: {
+        workType?: WorkType;
+        model: ModelId;
+    }[];
+}
+/**
+ * Complexity-based model adjustment.
+ */
+export interface ComplexityAdjustment {
+    /** Complexity threshold (0-10 scale) */
+    threshold: number;
+    /** Adjustment action */
+    action: 'bump-tier' | 'downgrade-tier' | 'switch-to-specialist';
+    /** Target model if action is 'switch-to-specialist' */
+    targetModel?: ModelId;
+}
+/**
+ * Routing rule: work type → agent mapping.
+ */
+export interface RoutingRule {
+    /** Work type identifier */
+    workType: WorkType;
+    /** Agent(s) to route this work to */
+    agents: string[];
+    /** Examples to help LLM understand this work type */
+    examples?: string[];
+    /** Confidence level for LLM self-assessment */
+    confidence?: 'high' | 'medium' | 'low';
+}
+/**
+ * Issue label-based routing rule.
+ */
+export interface IssueRoutingRule {
+    /** Label to match */
+    label: string;
+    /** Action to take when label is present */
+    action: 'assign' | 'route' | 'evaluate';
+    /** Target agent or evaluation criteria */
+    target?: string;
+    /** Required labels (all must be present) */
+    requiredLabels?: string[];
+    /** Excluded labels (none can be present) */
+    excludedLabels?: string[];
+    /** Issue state filter */
+    state?: 'open' | 'closed' | 'all';
+}
+/**
+ * @copilot capability evaluation criteria.
+ */
+export interface CopilotCapabilityEvaluation {
+    /** Capabilities to check */
+    requiredCapabilities: string[];
+    /** Fallback agent if @copilot cannot handle */
+    fallbackAgent: string;
+    /** Auto-route without asking if confidence is high */
+    autoRouteOnHighConfidence?: boolean;
+}
+/**
+ * Routing configuration.
+ */
+export interface RoutingConfig {
+    /** Work type → agent routing rules */
+    rules: RoutingRule[];
+    /** Issue label → routing rules */
+    issueRouting?: IssueRoutingRule[];
+    /** @copilot capability evaluation */
+    copilotEvaluation?: CopilotCapabilityEvaluation;
+    /** Routing governance rules */
+    governance?: {
+        eagerByDefault?: boolean;
+        scribeAutoRuns?: boolean;
+        allowRecursiveSpawn?: boolean;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Casting policy configuration.
+ */
+export interface CastingPolicy {
+    /** Allowlist of fictional universes */
+    allowlistUniverses?: string[];
+    /** Capacity limits per universe */
+    universeCapacity?: Record<string, number>;
+    /** Overflow strategy when capacity is reached */
+    overflowStrategy?: 'reject' | 'generic' | 'rotate';
+    /** Universe-specific constraints */
+    universeConstraints?: Record<string, {
+        avoid?: string[];
+        combine?: string[];
+        maxPerRole?: number;
+    }>;
+}
+/**
+ * Agent source configuration (foundation for PRD 15).
+ */
+export interface AgentSourceConfig {
+    /** Source type */
+    type: 'local' | 'git' | 'npm' | 'url';
+    /** Source location */
+    location: string;
+    /** Optional version/ref for git/npm sources */
+    version?: string;
+    /** Cache strategy */
+    cache?: 'always' | 'never' | 'auto';
+}
+/**
+ * Platform-specific overrides.
+ */
+export interface PlatformOverrides {
+    /** VS Code-specific overrides */
+    vscode?: {
+        /** Disable model selection (Phase 1) */
+        disableModelSelection?: boolean;
+        /** Scribe mode (sync on VS Code, background on CLI) */
+        scribeMode?: 'sync' | 'background';
+        /** Other VS Code-specific settings */
+        [key: string]: unknown;
+    };
+    /** CLI-specific overrides */
+    cli?: {
+        [key: string]: unknown;
+    };
+}
+/**
+ * Root Squad configuration object.
+ */
+export interface SquadConfig {
+    /** Config schema version */
+    version: string;
+    /** Model selection configuration */
+    models: ModelSelectionConfig;
+    /** Routing configuration */
+    routing: RoutingConfig;
+    /** Casting policy configuration */
+    casting?: CastingPolicy;
+    /** Agent source configurations */
+    agentSources?: AgentSourceConfig[];
+    /** MCP integration configuration (pass-through to SDK) */
+    mcp?: {
+        servers?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    /** Platform-specific overrides */
+    platforms?: PlatformOverrides;
+    /** Custom extensions */
+    [key: string]: unknown;
+}
+/**
+ * Default Squad configuration with typed defaults.
+ */
+export declare const DEFAULT_CONFIG: SquadConfig;
+/**
+ * Configuration load result.
+ */
+export interface ConfigLoadResult {
+    /** Loaded configuration */
+    config: SquadConfig;
+    /** Configuration file path that was loaded (if any) */
+    source?: string;
+    /** Whether default config was used */
+    isDefault: boolean;
+}
+/**
+ * Configuration validation result.
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings?: string[];
+}
+/**
+ * Configuration validation error.
+ */
+export declare class ConfigValidationError extends Error {
+    readonly errors: string[];
+    constructor(message: string, errors: string[]);
+}
+/**
+ * Discovers Squad configuration file by walking up directory tree.
+ *
+ * Search order per directory:
+ * 1. squad.config.ts
+ * 2. squad.config.js
+ * 3. squad.config.json
+ * 4. .squad/config.json
+ *
+ * @param cwd - Starting directory for upward search
+ * @returns Path to config file if found, undefined otherwise
+ */
+export declare function discoverConfigFile(cwd?: string): string | undefined;
+/**
+ * Loads Squad configuration from squad.config.ts, squad.config.js, squad.config.json, or .squad/config.json.
+ *
+ * Search order:
+ * 1. squad.config.ts (ESM import)
+ * 2. squad.config.js (ESM import)
+ * 3. squad.config.json (JSON parse)
+ * 4. .squad/config.json (JSON parse)
+ * 5. Walk up directory tree to find config file
+ * 6. DEFAULT_CONFIG (fallback)
+ *
+ * @param cwd - Working directory to search for config files
+ * @returns Configuration load result with validation
+ * @throws {ConfigValidationError} If config validation fails
+ */
+export declare function loadConfig(cwd?: string): Promise<ConfigLoadResult>;
+/**
+ * Validates Squad configuration schema and returns detailed result.
+ *
+ * @param config - Configuration object to validate
+ * @returns Validation result with errors and warnings
+ */
+export declare function validateConfigDetailed(config: unknown): ValidationResult;
+/**
+ * Validates Squad configuration schema.
+ *
+ * @param config - Configuration object to validate
+ * @returns Validated configuration with defaults merged
+ * @throws {ConfigValidationError} If validation fails
+ */
+export declare function validateConfig(config: unknown): SquadConfig;
+/**
+ * Synchronously loads Squad configuration.
+ * Only supports squad.config.json (TypeScript config requires async import).
+ *
+ * @param cwd - Working directory to search for config files
+ * @returns Configuration load result with validation
+ * @throws {ConfigValidationError} If config validation fails
+ */
+export declare function loadConfigSync(cwd?: string): ConfigLoadResult;
+//# sourceMappingURL=config.d.ts.map

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

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