@oni.bot/core 1.0.0 → 1.0.2

package/dist/oni-code/topology-agent-builder.js

@@ -1,220 +0,0 @@
-/**
- * Topology-Aware Agent Prompt Builder
- *
- * Generates topology-specific agent definitions for auto-dispatch.
- * Each topology produces agents with distinct roles and prompts that
- * match the topology's semantics (debate → opposing positions,
- * pipeline → sequential stages, etc.).
- */
-// ── Pipeline Stage Labels ────────────────────────────────────
-const PIPELINE_STAGES = [
-    { role: "Stage 1: Analyze", directive: "Analyze the task requirements. Examine the codebase, identify what needs to change, and produce a clear plan. Pass your analysis to the next stage." },
-    { role: "Stage 2: Implement", directive: "Implement the changes based on the analysis from Stage 1. Write the actual code modifications. Pass your implementation to the next stage for verification." },
-    { role: "Stage 3: Verify", directive: "Review and verify the implementation from Stage 2. Check for correctness, edge cases, test coverage, and potential issues. Produce a final summary." },
-    { role: "Stage 4: Polish", directive: "Polish the output from previous stages. Clean up code style, add documentation, and ensure consistency across all changes." },
-    { role: "Stage 5: Integrate", directive: "Integrate all changes from previous stages. Ensure everything works together and resolve any conflicts." },
-];
-// ── Debate Perspective Labels ────────────────────────────────
-const DEBATE_PERSPECTIVES = [
-    { role: "Advocate", directive: "Argue FOR the proposed approach. Present the strongest case: benefits, advantages, and reasons this approach is correct. Acknowledge weaknesses only if they can be mitigated." },
-    { role: "Skeptic", directive: "Argue AGAINST the proposed approach or present an alternative. Challenge assumptions, identify risks, edge cases, and potential failures. Propose a different approach if appropriate." },
-    { role: "Synthesizer", directive: "Evaluate both the advocate's and skeptic's arguments. Identify the strongest points from each side. Produce a balanced recommendation that incorporates the best elements." },
-    { role: "Pragmatist", directive: "Focus on practical implementation concerns. Evaluate approaches by effort, maintainability, team impact, and real-world constraints rather than theoretical merit." },
-    { role: "Innovator", directive: "Propose a creative alternative that neither the advocate nor skeptic considered. Think outside the conventional approaches." },
-];
-// ── Builder Functions Per Topology ───────────────────────────
-function buildFanOut(task, count) {
-    return Array.from({ length: count }, (_, i) => ({
-        id: `fanout-worker-${i}`,
-        role: `Worker Stream ${i + 1}`,
-        systemPrompt: `You are an independent worker agent (stream ${i + 1} of ${count}) in a fan-out topology.
-
-Your task: ${task}
-
-You own your portion of this work independently. Focus on your assigned subset without duplicating work done by other streams. Work thoroughly and produce complete results for your portion.`,
-    }));
-}
-function buildPipeline(task, count) {
-    return Array.from({ length: count }, (_, i) => {
-        const stage = PIPELINE_STAGES[i] ?? {
-            role: `Stage ${i + 1}: Process`,
-            directive: `Process your stage of the pipeline. Build on the output from the previous stage and pass your results to the next stage.`,
-        };
-        return {
-            id: `pipeline-stage-${i}`,
-            role: stage.role,
-            systemPrompt: `You are ${stage.role} in a ${count}-stage pipeline.
-
-Your task: ${task}
-
-${stage.directive}
-
-You are stage ${i + 1} of ${count}.${i > 0 ? " You will receive input from the previous stage — build on it, don't start from scratch." : " You are the first stage — start fresh with the original task."}${i < count - 1 ? " Your output will feed into the next stage." : " You are the final stage — produce the definitive result."}`,
-        };
-    });
-}
-function buildDebate(task, count) {
-    return Array.from({ length: count }, (_, i) => {
-        const perspective = DEBATE_PERSPECTIVES[i] ?? {
-            role: `Perspective ${i + 1}`,
-            directive: `Offer a unique perspective different from all others. Bring a distinct viewpoint to the discussion.`,
-        };
-        return {
-            id: `debate-${perspective.role.toLowerCase().replace(/\s+/g, "-")}`,
-            role: perspective.role,
-            systemPrompt: `You are the ${perspective.role} in a ${count}-perspective debate.
-
-The question: ${task}
-
-${perspective.directive}
-
-Present a well-reasoned, specific argument. Use concrete examples and evidence from the codebase or domain knowledge. Do not hedge or present both sides — commit to your assigned perspective.`,
-        };
-    });
-}
-function buildMapReduce(task, count) {
-    return Array.from({ length: count }, (_, i) => ({
-        id: `mapper-${i}`,
-        role: `Mapper ${i + 1}`,
-        systemPrompt: `You are Mapper ${i + 1} of ${count} in a map-reduce topology.
-
-Your task: ${task}
-
-Process your assigned portion of the input independently. Produce structured, consistent output that can be combined with outputs from the other ${count - 1} mappers. Focus on thoroughness over brevity — the reducer will synthesize everything.`,
-    }));
-}
-function buildHierarchical(task, count) {
-    const agents = [
-        {
-            id: "supervisor",
-            role: "Supervisor",
-            systemPrompt: `You are the Supervisor coordinating ${count - 1} specialist worker agents.
-
-The task: ${task}
-
-Your job: decompose the task into subtasks, assign them to your workers, review their outputs, and produce the final integrated result. You are the decision-maker — resolve conflicts between workers and ensure quality.`,
-        },
-    ];
-    for (let i = 1; i < count; i++) {
-        agents.push({
-            id: `specialist-${i}`,
-            role: `Specialist Agent ${i}`,
-            systemPrompt: `You are Specialist Agent ${i} of ${count - 1} workers reporting to a Supervisor.
-
-The overall task: ${task}
-
-Execute the specific subtask assigned to you by the Supervisor. Focus on your assigned work, be thorough, and report your results clearly. The Supervisor will integrate your output with work from the other specialists.`,
-        });
-    }
-    return agents;
-}
-function buildRace(task, count) {
-    const strategies = [
-        "Take the most direct, straightforward approach — prioritize speed and simplicity.",
-        "Take a thorough, methodical approach — prioritize correctness and completeness over speed.",
-        "Take a creative, unconventional approach — try a different strategy than the obvious one.",
-        "Take a cautious, defensive approach — handle edge cases and error conditions first.",
-        "Take an iterative approach — start with the minimal viable solution and refine.",
-    ];
-    return Array.from({ length: count }, (_, i) => ({
-        id: `racer-${i}`,
-        role: `Racer ${i + 1} (${["Direct", "Thorough", "Creative", "Defensive", "Iterative"][i] ?? `Strategy ${i + 1}`})`,
-        systemPrompt: `You are Racer ${i + 1} of ${count} in a race topology. The first complete solution wins.
-
-Your task: ${task}
-
-Your strategy: ${strategies[i] ?? `Use your own independent approach (strategy ${i + 1}).`}
-
-Work independently. Do not assume what other racers are doing. Produce a complete, working solution as quickly as possible.`,
-    }));
-}
-function buildPool(task, count) {
-    return Array.from({ length: count }, (_, i) => ({
-        id: `pool-worker-${i}`,
-        role: `Pool Worker ${i + 1}`,
-        systemPrompt: `You are Pool Worker ${i + 1} of ${count} in a shared work pool.
-
-Your task: ${task}
-
-Pick up and complete work items from the shared queue. You are interchangeable with the other workers — any of you can handle any work item. Focus on completing your assigned items efficiently.`,
-    }));
-}
-function buildPeerNetwork(task, count) {
-    return Array.from({ length: count }, (_, i) => ({
-        id: `peer-${i}`,
-        role: `Peer ${i + 1}`,
-        systemPrompt: `You are Peer ${i + 1} of ${count} in a collaborative peer network.
-
-Your task: ${task}
-
-Collaborate with your peers — share discoveries, coordinate on overlapping concerns, and build on each other's work. There is no supervisor; you are all equals working toward the same goal. Communicate findings that might affect other peers' work.`,
-    }));
-}
-function buildDag(task, count) {
-    return Array.from({ length: count }, (_, i) => ({
-        id: `dag-node-${i}`,
-        role: `Task Node ${i + 1}`,
-        systemPrompt: `You are Task Node ${i + 1} of ${count} in a dependency-ordered DAG (directed acyclic graph).
-
-Your task: ${task}
-
-Complete your assigned subtask. You may depend on outputs from upstream nodes and your output may be required by downstream nodes. Produce clear, structured results that downstream nodes can consume.`,
-    }));
-}
-function buildHierarchicalMesh(task, count) {
-    const agents = [
-        {
-            id: "mesh-coordinator",
-            role: "Mesh Coordinator",
-            systemPrompt: `You are the Coordinator of a ${count - 1}-agent mesh network.
-
-The task: ${task}
-
-Your job: oversee the mesh workers, resolve conflicts between their outputs, and produce the final integrated result. The mesh workers communicate with each other directly — you provide oversight and final decision-making.`,
-        },
-    ];
-    for (let i = 1; i < count; i++) {
-        agents.push({
-            id: `mesh-worker-${i}`,
-            role: `Mesh Worker ${i}`,
-            systemPrompt: `You are Mesh Worker ${i} of ${count - 1} in a hierarchical mesh network with a coordinator.
-
-The task: ${task}
-
-Collaborate with other mesh workers directly — share findings and coordinate on overlapping concerns. The coordinator will integrate final results. Focus on your portion of the work while staying aware of what others are doing.`,
-        });
-    }
-    return agents;
-}
-function buildGeneric(task, count) {
-    return Array.from({ length: count }, (_, i) => ({
-        id: `agent-${i}`,
-        role: `Agent ${i + 1}`,
-        systemPrompt: `You are agent ${i + 1} of ${count} working on: ${task}`,
-    }));
-}
-// ── Main Builder ─────────────────────────────────────────────
-const TOPOLOGY_BUILDERS = {
-    fanOut: buildFanOut,
-    pipeline: buildPipeline,
-    debate: buildDebate,
-    mapReduce: buildMapReduce,
-    hierarchical: buildHierarchical,
-    race: buildRace,
-    pool: buildPool,
-    peerNetwork: buildPeerNetwork,
-    dag: buildDag,
-    hierarchicalMesh: buildHierarchicalMesh,
-};
-/**
- * Build topology-specific agent definitions for auto-dispatch.
- *
- * Each topology produces agents with distinct roles and system prompts
- * that match the topology's semantics. This replaces the generic
- * "agent N of M" pattern that previously discarded topology information.
- */
-export function buildAutoDispatchAgents(topology, task, agentCount) {
-    const builder = TOPOLOGY_BUILDERS[topology] ?? buildGeneric;
-    return builder(task, agentCount);
-}
-//# sourceMappingURL=topology-agent-builder.js.map

package/dist/oni-code/topology-agent-builder.js.map

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

package/dist/oni-code/topology-selector.d.ts

@@ -1,85 +0,0 @@
-/**
- * Topology Selector — automatic swarm topology recommendation.
- *
- * Analyzes task characteristics (text patterns, file counts, structure)
- * to recommend the best swarm topology. Pure functions, no side effects.
- *
- * Used by:
- * - Conductor: for invisible auto-dispatch (P1 #5)
- * - spawn_swarm tool: as a fallback when topology is "auto"
- * - System prompt: to guide the LLM's topology choice
- *
- * Swarm-aware by definition — this IS the swarm selection logic.
- */
-export declare const TOPOLOGY_DESCRIPTIONS: Record<string, string>;
-export type Topology = keyof typeof TOPOLOGY_DESCRIPTIONS;
-export interface TaskSignals {
-    /** The task description text */
-    task: string;
-    /** Number of files explicitly mentioned or targeted */
-    fileCount?: number;
-    /** File paths mentioned in the task */
-    filePaths?: string[];
-    /** Whether the task involves sequential stages */
-    isSequential?: boolean;
-    /** Whether the task involves design/architecture decisions */
-    isDesignDecision?: boolean;
-    /** Number of agents the caller wants (hint, not binding) */
-    agentCountHint?: number;
-}
-export interface TopologyRecommendation {
-    /** Recommended topology */
-    topology: Topology;
-    /** Confidence: 0-1 (1 = strong match, <0.4 = weak/fallback) */
-    confidence: number;
-    /** Short explanation for why this topology was chosen */
-    reason: string;
-    /** Suggested agent count (minimum viable) */
-    suggestedAgentCount: number;
-}
-/**
- * Score each topology against the task signals.
- * Returns all topologies sorted by score (highest first).
- */
-export declare function scoreTopologies(signals: TaskSignals): Array<{
-    topology: Topology;
-    score: number;
-    reason: string;
-    agentCount: number;
-}>;
-/**
- * Select the best topology for a given task.
- *
- * Returns a recommendation with confidence level.
- * If no topology is a strong match (confidence < threshold),
- * falls back to fanOut (safest general-purpose topology).
- */
-export declare function selectTopology(signals: TaskSignals, options?: {
-    /** Minimum confidence to recommend (default: 0.3) */
-    minConfidence?: number;
-    /** Fallback topology when confidence is below threshold */
-    fallback?: Topology;
-}): TopologyRecommendation;
-/**
- * Quick check: should this task use a swarm at all?
- *
- * Returns false for tasks that are clearly single-agent
- * (simple questions, single-file edits, quick lookups).
- */
-export declare function shouldUseSwarm(task: string): boolean;
-/**
- * Extract task signals from a task description string.
- *
- * Parses file paths, counts, and structural hints from natural language.
- */
-export declare function extractSignals(task: string): TaskSignals;
-/**
- * Full auto-selection pipeline: task string → topology recommendation.
- *
- * Combines signal extraction, swarm-worthiness check, and topology selection.
- */
-export declare function autoSelectTopology(task: string, options?: {
-    minConfidence?: number;
-    fallback?: Topology;
-}): TopologyRecommendation | null;
-//# sourceMappingURL=topology-selector.d.ts.map

package/dist/oni-code/topology-selector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"topology-selector.d.ts","sourceRoot":"","sources":["../../src/oni-code/topology-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAexD,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAI1D,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAoJD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,GACnB,KAAK,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA+ClF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IACR,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GACA,sBAAsB,CA4BxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA2DpD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAmCxD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GACA,sBAAsB,GAAG,IAAI,CAQ/B"}

package/dist/oni-code/topology-selector.js

@@ -1,338 +0,0 @@
-/**
- * Topology Selector — automatic swarm topology recommendation.
- *
- * Analyzes task characteristics (text patterns, file counts, structure)
- * to recommend the best swarm topology. Pure functions, no side effects.
- *
- * Used by:
- * - Conductor: for invisible auto-dispatch (P1 #5)
- * - spawn_swarm tool: as a fallback when topology is "auto"
- * - System prompt: to guide the LLM's topology choice
- *
- * Swarm-aware by definition — this IS the swarm selection logic.
- */
-// ── Topology Definitions (canonical source) ─────────────────
-export const TOPOLOGY_DESCRIPTIONS = {
-    debate: "Multi-round debate with judge — for architecture decisions, trade-off analysis, code review with multiple perspectives",
-    fanOut: "Parallel independent agents with synthesis — for parallel independent work that gets combined",
-    pipeline: "Sequential multi-stage — for sequential work where each stage feeds the next",
-    mapReduce: "Analyze many inputs then synthesize — for analyzing many files or inputs and producing a combined conclusion",
-    hierarchical: "Manager delegates to specialists — for complex tasks needing a manager who delegates to specialist agents",
-    // peerNetwork and hierarchicalMesh omitted — they require manual handoff/team
-    // configuration that DefaultSwarmRunner cannot auto-generate. The framework
-    // factories (SwarmGraph.peerNetwork, SwarmGraph.hierarchicalMesh) still exist
-    // for advanced users building custom swarms directly.
-};
-const PATTERNS = [
-    // ── Fan-Out: parallel independent work ──────────────────
-    {
-        topology: "fanOut",
-        textPatterns: [
-            /\b(?:refactor|update|modify|edit|change|fix)\b.*\b(?:files?|modules?|components?|handlers?|services?|endpoints?|models?|adapters?)\b/i,
-            /\beach\s+(?:file|module|component|service|handler|endpoint|model)\b/i,
-            /\bin\s+parallel\b/i,
-            /\ball\s+(?:\d+\s+)?(?:files?|modules?|handlers?|services?|endpoints?|models?|adapters?|components?)\b/i,
-            /\bmulti(?:ple)?[\s-]?file/i,
-            /\bacross\s+(?:all|multiple|several|the\s+entire)\b/i,
-            /\b(?:3|4|5|6|7|8|9|\d{2,})\s+(?:\w+\s+)?(?:files?|modules?|handlers?|services?|models?|adapters?|components?|endpoints?)\b/i,
-        ],
-        textWeight: 1.0,
-        structuralCheck: (s) => {
-            // Strong signal if 3+ files targeted
-            if (s.fileCount !== undefined && s.fileCount >= 3)
-                return 0.8;
-            if (s.filePaths && s.filePaths.length >= 3)
-                return 0.8;
-            return 0;
-        },
-        baseAgentCount: 3,
-        reasonTemplate: "Parallel independent work on multiple targets",
-    },
-    // ── Pipeline: sequential stages ─────────────────────────
-    {
-        topology: "pipeline",
-        textPatterns: [
-            /\bthen\b.*\bthen\b/i,
-            /\bstep\s+\d+\b.*\bstep\s+\d+\b/i,
-            /\bfirst\b.*\bthen\b.*\bfinally\b/i,
-            /\bbuild\b.*\btest\b/i,
-            /\banalyze\b.*\bimplement\b/i,
-            /\bplan\b.*\bexecute\b/i,
-            /\bextract\b.*\btransform\b/i,
-            /\bparse\b.*\bvalidate\b.*\bgenerate\b/i,
-            /\bmigrat(?:e|ion)\b/i,
-        ],
-        textWeight: 1.0,
-        structuralCheck: (s) => {
-            if (s.isSequential)
-                return 0.9;
-            return 0;
-        },
-        baseAgentCount: 3,
-        reasonTemplate: "Sequential multi-stage workflow",
-    },
-    // ── Debate: design decisions, trade-offs ────────────────
-    {
-        topology: "debate",
-        textPatterns: [
-            /\bdesign\b.*\b(?:api|interface|architecture|system)\b/i,
-            /\btrade[\s-]?off/i,
-            /\bpros?\s+(?:and|&|vs)\s+cons?\b/i,
-            /\bcompare\b.*\bapproach/i,
-            /\bwhich\s+(?:approach|strategy|pattern|method)\b/i,
-            /\bbest\s+(?:approach|way|strategy|pattern)\b/i,
-            /\barchitectur(?:e|al)\s+(?:decision|review|choice)\b/i,
-            /\breview\b.*\b(?:code|design|approach)/i,
-            /\bevaluat(?:e|ion)\b.*\b(?:option|alternative|approach)/i,
-            /\bshould\s+(?:we|I)\s+use\b/i,
-            /\b(?:REST|GraphQL|SQL|NoSQL|MongoDB|Postgres|Redis)\b.*\b(?:or|vs\.?|versus)\b/i,
-        ],
-        textWeight: 1.0,
-        structuralCheck: (s) => {
-            if (s.isDesignDecision)
-                return 0.9;
-            return 0;
-        },
-        baseAgentCount: 3,
-        reasonTemplate: "Multiple perspectives for decision-making",
-    },
-    // ── MapReduce: analyze many inputs → synthesize ─────────
-    {
-        topology: "mapReduce",
-        textPatterns: [
-            /\banalyze\b.*\ball\b/i,
-            /\baudit\b/i,
-            /\bsummariz(?:e|ation)\b.*\b(?:all|every|each)\b/i,
-            /\bfind\b.*\bevery\b/i,
-            /\bscan\b.*\b(?:entire|whole|all)\b/i,
-            /\binventory\b/i,
-            /\bcatalog(?:ue)?\b/i,
-            /\bsurvey\b.*\bcodebase\b/i,
-            /\bcollect\b.*\b(?:all|every)\b/i,
-            /\banalyze\b.*\bsummariz/i,
-            /\bfind\b.*\b(?:all|every)\b.*\b(?:across|modules?|remove)\b/i,
-        ],
-        textWeight: 1.2,
-        structuralCheck: (s) => {
-            // Strong signal if many files to analyze
-            if (s.fileCount !== undefined && s.fileCount >= 5)
-                return 0.7;
-            if (s.filePaths && s.filePaths.length >= 5)
-                return 0.7;
-            return 0;
-        },
-        baseAgentCount: 4,
-        reasonTemplate: "Analyze many inputs and synthesize results",
-    },
-    // ── Hierarchical: complex tasks with delegation ─────────
-    {
-        topology: "hierarchical",
-        textPatterns: [
-            /\bdelegate\b/i,
-            /\bcoordinat(?:e|or|ion)\b/i,
-            /\bmanag(?:e|er)\b.*\b(?:team|agents?|workers?)\b/i,
-            /\bcomplex\b.*\b(?:project|task|system)\b/i,
-            /\bmulti[\s-]?(?:module|service|package)\b/i,
-            /\b(?:build(?:ing)?|implement(?:ing)?|creat(?:e|ing))\b.*\bfull[\s-]?(?:stack|system|platform)\b/i,
-            /\bfull[\s-]?(?:stack|system|platform)\b.*\b(?:build(?:ing)?|implement(?:ing)?|creat(?:e|ing))\b/i,
-            /\borchestrat(?:e|ion)\b/i,
-            /\b(?:build|implement|create)\b.*\b(?:api|database|frontend|backend)\b.*\b(?:api|database|frontend|backend)\b/i,
-            /\b(?:module|service|feature)\b.*\bwith\b.*\b(?:api|database|frontend|backend|auth)\b.*\band\b/i,
-            /\b(?:build|implement|create)\b.*\b(?:api|database|frontend|backend|auth|billing)\b.*\band\b.*\b(?:api|database|frontend|backend|component)/i,
-        ],
-        textWeight: 1.0,
-        structuralCheck: (s) => {
-            if (s.agentCountHint !== undefined && s.agentCountHint >= 5)
-                return 0.6;
-            return 0;
-        },
-        baseAgentCount: 4,
-        reasonTemplate: "Manager delegates to specialist agents",
-    },
-    // peerNetwork omitted — SwarmRunner does not support auto-generating
-    // peer handoff config. Users can still request it explicitly via spawn_swarm.
-];
-// ── Core Selection Logic ─────────────────────────────────────
-/**
- * Score each topology against the task signals.
- * Returns all topologies sorted by score (highest first).
- */
-export function scoreTopologies(signals) {
-    const scored = PATTERNS.map((pattern) => {
-        let score = 0;
-        // Text pattern matching
-        const matchCount = pattern.textPatterns.filter((re) => re.test(signals.task)).length;
-        if (matchCount > 0) {
-            // Diminishing returns: first match is worth most
-            score += Math.min(matchCount * 0.3, 1.0) * pattern.textWeight;
-        }
-        // Structural signals
-        if (pattern.structuralCheck) {
-            score += pattern.structuralCheck(signals);
-        }
-        // Bonus for file count alignment
-        if (signals.fileCount !== undefined) {
-            if (pattern.topology === "fanOut" && signals.fileCount >= 3) {
-                score += 0.2;
-            }
-            if (pattern.topology === "mapReduce" && signals.fileCount >= 5) {
-                score += 0.2;
-            }
-        }
-        // Agent count hint alignment
-        if (signals.agentCountHint !== undefined) {
-            if (pattern.topology === "debate" && signals.agentCountHint >= 2 && signals.agentCountHint <= 4) {
-                score += 0.1;
-            }
-            if (pattern.topology === "fanOut" && signals.agentCountHint >= 3) {
-                score += 0.1;
-            }
-        }
-        const agentCount = signals.agentCountHint ?? pattern.baseAgentCount;
-        return {
-            topology: pattern.topology,
-            score,
-            reason: pattern.reasonTemplate,
-            agentCount,
-        };
-    });
-    return scored.sort((a, b) => b.score - a.score);
-}
-/**
- * Select the best topology for a given task.
- *
- * Returns a recommendation with confidence level.
- * If no topology is a strong match (confidence < threshold),
- * falls back to fanOut (safest general-purpose topology).
- */
-export function selectTopology(signals, options) {
-    const minConfidence = options?.minConfidence ?? 0.3;
-    const fallback = options?.fallback ?? "fanOut";
-    const scored = scoreTopologies(signals);
-    const best = scored[0];
-    // Normalize score to confidence (0-1)
-    // Max possible score is ~2.0 (text + structural + bonus)
-    // Round to 4 decimals to avoid IEEE 754 boundary issues (e.g. 0.6/1.5 → 0.39999... instead of 0.4)
-    const confidence = Math.round(Math.min(best.score / 1.5, 1.0) * 10000) / 10000;
-    if (confidence >= minConfidence && best.score > 0) {
-        return {
-            topology: best.topology,
-            confidence,
-            reason: best.reason,
-            suggestedAgentCount: best.agentCount,
-        };
-    }
-    // Below threshold — use fallback
-    return {
-        topology: fallback,
-        confidence,
-        reason: `No strong topology match — defaulting to ${fallback}`,
-        suggestedAgentCount: signals.agentCountHint ?? 3,
-    };
-}
-/**
- * Quick check: should this task use a swarm at all?
- *
- * Returns false for tasks that are clearly single-agent
- * (simple questions, single-file edits, quick lookups).
- */
-export function shouldUseSwarm(task) {
-    const lower = task.toLowerCase();
-    // Single-file operations — no swarm needed
-    if (/^(?:fix|edit|update|change|modify)\s+(?:the\s+)?(?:a\s+)?(?:bug|error|typo|issue)\s+in\s+\S+$/i.test(task)) {
-        return false;
-    }
-    // Simple questions — no swarm (unless they contain design/comparison keywords)
-    if (/^(?:what|how|why|where|when|who|explain|describe|show|should)\b/i.test(task) &&
-        task.length < 100 &&
-        !/\b(?:all|every|each|multiple|several|across)\b/i.test(task) &&
-        !/\b(?:compare|vs\.?|versus|trade[\s-]?off|design|evaluate)\b/i.test(task) &&
-        !/\buse\b.*\bor\b/i.test(task)) {
-        return false;
-    }
-    // Very short tasks — probably simple (exempt pipeline/debate/complex keywords)
-    if (task.length < 30 && !/\b(?:refactor|migrate|audit|analyze|review|design|compare|evaluate|debate|then|step\s+\d)\b/i.test(task)) {
-        return false;
-    }
-    // Multi-target indicators → swarm-worthy
-    if (/\b(?:all|every|each|multiple|several|across|parallel)\b/i.test(lower)) {
-        return true;
-    }
-    // Complex task indicators → swarm-worthy
-    if (/\b(?:refactor|migrate|audit|analyze|review|redesign|overhaul|design|compare|evaluate|debate)\b/i.test(lower)) {
-        return true;
-    }
-    // Build/implement/create are swarm-worthy when describing a full system or multi-component work
-    if (/\b(?:build(?:ing)?|implement(?:ing)?|creat(?:e|ing))\b/i.test(lower) && /\b(?:full[\s-]?stack|system|platform|entire|multiple|multi[\s-])/i.test(lower)) {
-        return true;
-    }
-    // Multi-component implementation: "implement X with API, database, and frontend"
-    if (/\b(?:build(?:ing)?|implement(?:ing)?|creat(?:e|ing))\b/i.test(lower) && /\b(?:api|database|frontend|backend|auth|billing|payment)\b/i.test(lower) && /\band\b/i.test(lower)) {
-        return true;
-    }
-    // Comparison/decision questions → swarm-worthy (debate topology)
-    if (/\bshould\s+(?:we|I)\s+use\b/i.test(lower) && /\bor\b/i.test(lower)) {
-        return true;
-    }
-    // Sequential/pipeline indicators → swarm-worthy
-    if (/\bthen\b/i.test(lower) || /\bstep\s+\d/i.test(lower)) {
-        return true;
-    }
-    // Multiple files mentioned → swarm-worthy
-    const fileRefs = lower.match(/\b\S+\.\w{1,4}\b/g);
-    if (fileRefs && fileRefs.length >= 3) {
-        return true;
-    }
-    // Default: don't use swarm for ambiguous cases
-    return false;
-}
-/**
- * Extract task signals from a task description string.
- *
- * Parses file paths, counts, and structural hints from natural language.
- */
-export function extractSignals(task) {
-    const signals = { task };
-    // Extract file paths (foo.ts, src/bar.js, etc.)
-    const filePattern = /(?:^|\s)((?:[\w./\\-]+\/)?[\w.-]+\.(?:ts|js|tsx|jsx|py|go|rs|java|rb|css|html|json|yaml|yml|md|toml|sql|sh|bash))\b/gi;
-    const files = [];
-    let match;
-    while ((match = filePattern.exec(task)) !== null) {
-        files.push(match[1]);
-    }
-    if (files.length > 0) {
-        signals.filePaths = files;
-        signals.fileCount = files.length;
-    }
-    // Detect file/target count from natural language ("10 files", "5 API handlers", "8 database models")
-    const countMatch = task.match(/\b(\d+)\s+(?:\w+\s+)?(?:files?|modules?|handlers?|services?|endpoints?|models?|adapters?|components?)\b/i);
-    if (countMatch) {
-        const count = parseInt(countMatch[1], 10);
-        if (count > (signals.fileCount ?? 0)) {
-            signals.fileCount = count;
-        }
-    }
-    // Detect sequential structure
-    if (/\bthen\b/i.test(task) || /\bstep\s+\d/i.test(task) || /\bfirst\b.*\bthen\b/i.test(task)) {
-        signals.isSequential = true;
-    }
-    // Detect design decisions
-    if (/\b(?:design|architect|decide|choose|compare|evaluate|trade[\s-]?off|pros?\s+(?:and|&|vs)\s+cons?)\b/i.test(task)) {
-        signals.isDesignDecision = true;
-    }
-    return signals;
-}
-/**
- * Full auto-selection pipeline: task string → topology recommendation.
- *
- * Combines signal extraction, swarm-worthiness check, and topology selection.
- */
-export function autoSelectTopology(task, options) {
-    // First check if this even warrants a swarm
-    if (!shouldUseSwarm(task)) {
-        return null;
-    }
-    const signals = extractSignals(task);
-    return selectTopology(signals, options);
-}
-//# sourceMappingURL=topology-selector.js.map