qlogicagent 0.1.0

package/dist/orchestration/team-orchestration.js

@@ -0,0 +1,370 @@
+/**
+ * Team Orchestration Strategy — multi-agent coordination layer.
+ *
+ * Extends the existing sidechain foundation with team/swarm semantics:
+ * - Parallel agent spawning (multiple sidechains at once)
+ * - Role-based agent assignment (planner / executor / reviewer)
+ * - Shared knowledge pool via merge policies
+ * - Budget-aware concurrency limits
+ * - Lifecycle state machine for team coordination
+ *
+ * Architecture:
+ *   Gateway ─── Hub ─── orchestration (this module, pure strategy)
+ *                │
+ *   ┌───────────┼───────────┐
+ *   │   TeamCoordinator     │  ← Hub runtime (multi-sidechain-coordinator.ts)
+ *   │   │                   │
+ *   │   ├── Agent #1 (planner)
+ *   │   ├── Agent #2 (executor)
+ *   │   └── Agent #3 (reviewer)
+ *   └───────────────────────┘
+ *
+ * This module provides:
+ * 1. Type definitions (TeamPlan, AgentRole, TeamLifecycle)
+ * 2. Pure strategy functions (plan resolution, role assignment, budget allocation)
+ * 3. Merge/aggregation policies (how agent results combine)
+ *
+ * Hub consumes these types and strategy functions in its coordinator runtime.
+ * Gateway consumes TeamPlan to spawn/manage multiple sidechain executions.
+ */
+// ---------------------------------------------------------------------------
+// Strategy Functions — Pure, no I/O
+// ---------------------------------------------------------------------------
+/** Budget allocation weights per role (relative). */
+const ROLE_BUDGET_WEIGHTS = {
+    planner: 3,
+    executor: 4,
+    reviewer: 2,
+    researcher: 3,
+    custom: 2,
+};
+/** Default concurrency limits by execution mode. */
+const MODE_CONCURRENCY_DEFAULTS = {
+    parallel: 4,
+    sequential: 1,
+    pipeline: 1,
+    adaptive: 3,
+};
+/** Maximum agents allowed in a team (safety bound). */
+export const TEAM_MAX_AGENTS = 8;
+/** Maximum recursion depth (teams spawning teams). */
+export const TEAM_MAX_DEPTH = 2;
+/**
+ * Resolve a team plan from a high-level task decomposition.
+ *
+ * This is the main entry point: given a set of subtasks and constraints,
+ * produce a concrete TeamPlan that the coordinator can execute.
+ */
+export function resolveTeamPlan(params) {
+    const agents = params.subtasks.slice(0, TEAM_MAX_AGENTS).map((sub) => {
+        const budgetTier = resolveAgentBudgetTier(sub.role);
+        return {
+            agentId: sub.id,
+            role: sub.role,
+            label: sub.label,
+            sidechainType: mapRoleToSidechainType(sub.role),
+            taskDescription: sub.task,
+            toolAccessMode: resolveAgentToolAccess(sub.role),
+            budgetTier,
+            dependsOn: sub.dependsOn ?? [],
+            maxTokenBudget: 0, // Will be allocated below
+            maxToolCalls: resolveMaxToolCalls(sub.role),
+            timeoutMs: 0,
+        };
+    });
+    const mode = params.mode ?? inferExecutionMode(agents);
+    const totalBudget = params.totalTokenBudget ?? 100_000;
+    const allocatedAgents = allocateTokenBudgets(agents, totalBudget);
+    return {
+        teamId: params.teamId,
+        mode,
+        aggregationPolicy: params.aggregationPolicy ?? inferAggregationPolicy(mode, agents),
+        agents: allocatedAgents,
+        maxConcurrency: MODE_CONCURRENCY_DEFAULTS[mode],
+        timeoutMs: params.timeoutMs ?? 300_000, // 5 min default
+        totalTokenBudget: totalBudget,
+        failFast: params.failFast ?? (mode === "pipeline"),
+        sharedContext: params.sharedContext ?? "",
+        mergePolicy: params.mergePolicy ?? "summary-only",
+    };
+}
+/**
+ * Map agent role to sidechain type for existing Hub plumbing compatibility.
+ */
+export function mapRoleToSidechainType(role) {
+    switch (role) {
+        case "planner": return "planner";
+        case "executor": return "code-repair";
+        case "reviewer": return "research";
+        case "researcher": return "research";
+        case "custom": return "research";
+    }
+}
+/**
+ * Resolve tool access mode for a given role.
+ */
+export function resolveAgentToolAccess(role) {
+    switch (role) {
+        case "planner": return "none"; // Planner thinks, doesn't act
+        case "executor": return "full"; // Executor needs full tool access
+        case "reviewer": return "read-only"; // Reviewer inspects, doesn't modify
+        case "researcher": return "read-only";
+        case "custom": return "read-only";
+    }
+}
+/**
+ * Resolve maximum tool calls for a given role.
+ */
+function resolveMaxToolCalls(role) {
+    switch (role) {
+        case "planner": return 0;
+        case "executor": return 30;
+        case "reviewer": return 10;
+        case "researcher": return 15;
+        case "custom": return 10;
+    }
+}
+/**
+ * Resolve budget tier for a given role.
+ */
+function resolveAgentBudgetTier(role) {
+    switch (role) {
+        case "planner": return "high";
+        case "executor": return "high";
+        case "reviewer": return "medium";
+        case "researcher": return "medium";
+        case "custom": return "low";
+    }
+}
+/**
+ * Allocate token budgets proportionally by role weight.
+ */
+export function allocateTokenBudgets(agents, totalBudget) {
+    const totalWeight = agents.reduce((sum, a) => sum + ROLE_BUDGET_WEIGHTS[a.role], 0);
+    if (totalWeight === 0)
+        return agents;
+    return agents.map((agent) => ({
+        ...agent,
+        maxTokenBudget: Math.floor((ROLE_BUDGET_WEIGHTS[agent.role] / totalWeight) * totalBudget),
+    }));
+}
+/**
+ * Infer execution mode from agent dependency graph.
+ */
+export function inferExecutionMode(agents) {
+    const hasDeps = agents.some((a) => a.dependsOn.length > 0);
+    if (!hasDeps)
+        return "parallel";
+    // If every agent depends on the previous → pipeline
+    const isLinearChain = agents.every((a, i) => i === 0 ? a.dependsOn.length === 0 : a.dependsOn.includes(agents[i - 1].agentId));
+    if (isLinearChain)
+        return "pipeline";
+    return "sequential";
+}
+/**
+ * Infer aggregation policy from mode and agent composition.
+ */
+export function inferAggregationPolicy(mode, agents) {
+    const hasReviewer = agents.some((a) => a.role === "reviewer");
+    const hasPlanner = agents.some((a) => a.role === "planner");
+    if (hasReviewer)
+        return "reviewer-gate";
+    if (hasPlanner && mode === "adaptive")
+        return "planner-sync";
+    if (mode === "parallel" && agents.length >= 3)
+        return "majority-vote";
+    return "merge-all";
+}
+/**
+ * Determine the execution order for agents given their dependency graph.
+ * Returns groups of agent IDs that can execute concurrently.
+ *
+ * Example: [[planner], [executor-a, executor-b], [reviewer]]
+ */
+export function resolveExecutionOrder(agents) {
+    const idSet = new Set(agents.map((a) => a.agentId));
+    const depMap = new Map(agents.map((a) => [a.agentId, a.dependsOn.filter((d) => idSet.has(d))]));
+    const completed = new Set();
+    const groups = [];
+    let remaining = new Set(idSet);
+    let iterations = 0;
+    const maxIterations = agents.length + 1;
+    while (remaining.size > 0 && iterations < maxIterations) {
+        const ready = [];
+        for (const id of remaining) {
+            const deps = depMap.get(id) ?? [];
+            if (deps.every((d) => completed.has(d))) {
+                ready.push(id);
+            }
+        }
+        if (ready.length === 0) {
+            // Circular dependency — break by picking first remaining
+            const first = remaining.values().next().value;
+            if (first)
+                ready.push(first);
+        }
+        for (const id of ready) {
+            remaining.delete(id);
+            completed.add(id);
+        }
+        groups.push(ready);
+        iterations++;
+    }
+    return groups;
+}
+/**
+ * Aggregate team results into a single output string.
+ */
+export function aggregateTeamResults(results, policy) {
+    const completed = results.filter((r) => r.status === "completed");
+    switch (policy) {
+        case "first-success":
+            return completed[0]?.output ?? "[No successful agent output]";
+        case "majority-vote":
+            // Simple: return the most common non-empty output
+            if (completed.length === 0)
+                return "[No successful agent output]";
+            const counts = new Map();
+            for (const r of completed) {
+                const key = r.output.trim();
+                counts.set(key, (counts.get(key) ?? 0) + 1);
+            }
+            let best = "";
+            let bestCount = 0;
+            for (const [output, count] of counts) {
+                if (count > bestCount) {
+                    best = output;
+                    bestCount = count;
+                }
+            }
+            return best || completed[0].output;
+        case "merge-all":
+            return completed
+                .map((r) => `[${r.role}:${r.agentId}]\n${r.output}`)
+                .join("\n\n---\n\n");
+        case "reviewer-gate": {
+            const reviewer = completed.find((r) => r.role === "reviewer");
+            const executors = completed.filter((r) => r.role !== "reviewer");
+            if (reviewer) {
+                return `[Review]\n${reviewer.output}\n\n[Execution]\n${executors.map((e) => e.output).join("\n")}`;
+            }
+            return executors.map((e) => e.output).join("\n\n");
+        }
+        case "planner-sync": {
+            const planner = completed.find((r) => r.role === "planner");
+            const others = completed.filter((r) => r.role !== "planner");
+            if (planner) {
+                return `[Plan]\n${planner.output}\n\n[Results]\n${others.map((o) => `- ${o.agentId}: ${o.output.slice(0, 500)}`).join("\n")}`;
+            }
+            return others.map((o) => o.output).join("\n\n");
+        }
+    }
+}
+/**
+ * Validate a team plan before execution.
+ * Returns a list of issues (empty = valid).
+ */
+export function validateTeamPlan(plan) {
+    const issues = [];
+    if (plan.agents.length === 0) {
+        issues.push("Team plan has no agents");
+    }
+    if (plan.agents.length > TEAM_MAX_AGENTS) {
+        issues.push(`Too many agents: ${plan.agents.length} > ${TEAM_MAX_AGENTS}`);
+    }
+    if (plan.totalTokenBudget <= 0) {
+        issues.push("Total token budget must be positive");
+    }
+    // Check for duplicate IDs
+    const ids = plan.agents.map((a) => a.agentId);
+    const uniqueIds = new Set(ids);
+    if (uniqueIds.size !== ids.length) {
+        issues.push("Duplicate agent IDs in team plan");
+    }
+    // Check dependency references
+    for (const agent of plan.agents) {
+        for (const dep of agent.dependsOn) {
+            if (!uniqueIds.has(dep)) {
+                issues.push(`Agent "${agent.agentId}" depends on non-existent agent "${dep}"`);
+            }
+            if (dep === agent.agentId) {
+                issues.push(`Agent "${agent.agentId}" depends on itself`);
+            }
+        }
+    }
+    // Pipeline mode must have linear dependencies
+    if (plan.mode === "pipeline") {
+        for (let i = 1; i < plan.agents.length; i++) {
+            if (!plan.agents[i].dependsOn.includes(plan.agents[i - 1].agentId)) {
+                issues.push(`Pipeline mode requires linear dependencies; agent "${plan.agents[i].agentId}" doesn't depend on previous`);
+            }
+        }
+    }
+    return issues;
+}
+/**
+ * Determine if a team execution should be cancelled early based on current state.
+ */
+export function shouldCancelTeam(params) {
+    const { plan, results, elapsedMs } = params;
+    // Timeout check
+    if (plan.timeoutMs > 0 && elapsedMs > plan.timeoutMs) {
+        return { cancel: true, reason: "team_timeout" };
+    }
+    // Fail-fast: any failure causes cancel
+    if (plan.failFast && results.some((r) => r.status === "failed")) {
+        return { cancel: true, reason: "fail_fast" };
+    }
+    // All agents completed or failed — no need to cancel, just aggregate
+    if (results.length >= plan.agents.length) {
+        return { cancel: false, reason: "" };
+    }
+    // Budget exhaustion
+    const usedTokens = results.reduce((sum, r) => sum + r.tokenUsage.prompt + r.tokenUsage.completion, 0);
+    if (usedTokens >= plan.totalTokenBudget * 0.95) {
+        return { cancel: true, reason: "budget_exhausted" };
+    }
+    return { cancel: false, reason: "" };
+}
+/**
+ * Build the task prompt for a specific agent, incorporating shared context
+ * and outputs from dependency agents.
+ */
+export function buildAgentTaskPrompt(params) {
+    const { agent, plan, dependencyResults } = params;
+    const parts = [];
+    // Shared context
+    if (plan.sharedContext) {
+        parts.push(`[Shared Context]\n${plan.sharedContext}`);
+    }
+    // Dependency outputs
+    if (dependencyResults.length > 0) {
+        const depSection = dependencyResults
+            .filter((r) => r.status === "completed")
+            .map((r) => `[From ${r.agentId} (${r.role})]\n${r.output}`)
+            .join("\n\n");
+        if (depSection) {
+            parts.push(`[Prior Results]\n${depSection}`);
+        }
+    }
+    // Agent-specific task
+    parts.push(`[Your Task]\n${agent.taskDescription}`);
+    // Role-specific guidance
+    parts.push(`[Your Role: ${agent.role}]\n${getRoleGuidance(agent.role)}`);
+    return parts.join("\n\n---\n\n");
+}
+function getRoleGuidance(role) {
+    switch (role) {
+        case "planner":
+            return "You are the planner. Break down the task, identify dependencies, and create a clear execution plan. Do NOT execute actions yourself.";
+        case "executor":
+            return "You are the executor. Follow the plan and use tools to accomplish the task. Report what you did and any issues encountered.";
+        case "reviewer":
+            return "You are the reviewer. Examine the execution results for correctness, completeness, and quality. Point out any issues or improvements needed.";
+        case "researcher":
+            return "You are the researcher. Gather information, search for relevant context, and provide evidence-based findings. Do NOT modify any files.";
+        case "custom":
+            return "Complete the assigned task to the best of your ability.";
+    }
+}
+//# sourceMappingURL=team-orchestration.js.map

package/dist/orchestration/team-orchestration.js.map

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

package/dist/orchestration/team-tool-loop-wiring.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Team Tool Loop Wiring — Connects team orchestration to the tool loop.
+ *
+ * When the LLM invokes `team_create`, this module:
+ * 1. Validates the team plan
+ * 2. Maps team agents to fork contexts
+ * 3. Coordinates execution according to the team execution mode
+ * 4. Aggregates results according to the aggregation policy
+ * 5. Returns the aggregated result as a tool_result
+ *
+ * This bridges the gap between the pure strategy layer (team-orchestration.ts)
+ * and the Hub's tool loop.
+ */
+import type { AgentRole, TeamExecutionMode, TeamAggregationPolicy, TeamLifecycleState } from "./team-orchestration.js";
+import type { AgentDefinition } from "./agent-registry.js";
+import type { ForkResult } from "./fork-subagent.js";
+export interface TeamToolRequest {
+    /** Team name for identification. */
+    name: string;
+    /** Agent specs for the team. */
+    agents: TeamAgentRequest[];
+    /** Execution mode. */
+    mode: TeamExecutionMode;
+    /** How to aggregate results. */
+    aggregation: TeamAggregationPolicy;
+}
+export interface TeamAgentRequest {
+    /** Role within the team. */
+    role: AgentRole;
+    /** Agent type from built-in registry. */
+    agentType: string;
+    /** Task prompt for this agent. */
+    prompt: string;
+    /** Max turns override. */
+    maxTurns?: number;
+    /** Dependencies (agent IDs that must complete before this one). */
+    dependsOn?: string[];
+}
+export interface TeamExecutionPlan {
+    /** Ordered batches for execution. */
+    batches: TeamExecutionBatch[];
+    /** Total estimated token budget. */
+    totalBudget: number;
+    /** Lifecycle state. */
+    state: TeamLifecycleState;
+}
+export interface TeamExecutionBatch {
+    /** Agents in this batch (run in parallel within a batch). */
+    agents: TeamAgentRequest[];
+    /** Batch mode (parallel or sequential within the batch). */
+    mode: "parallel" | "serial";
+}
+/**
+ * Resolve the execution plan for a team request.
+ * Validates the request, resolves dependencies into ordered batches,
+ * and determines the execution topology.
+ */
+export declare function resolveTeamExecutionPlan(request: TeamToolRequest): TeamExecutionPlan;
+export interface TeamAggregatedResult {
+    /** Whether the team execution succeeded overall. */
+    ok: boolean;
+    /** Aggregated output text. */
+    output: string;
+    /** Individual agent results. */
+    agentResults: Array<{
+        agentId: string;
+        role: AgentRole;
+        result: ForkResult;
+    }>;
+    /** Total tokens consumed by all agents. */
+    totalTokensUsed: number;
+    /** Lifecycle state after aggregation. */
+    finalState: TeamLifecycleState;
+}
+/**
+ * Aggregate results from team agents according to the aggregation policy.
+ */
+export declare function aggregateTeamToolResults(results: Array<{
+    agentId: string;
+    role: AgentRole;
+    result: ForkResult;
+}>, policy: TeamAggregationPolicy): TeamAggregatedResult;
+/**
+ * Map a team tool_call into the format needed for the tool loop to dispatch.
+ * Returns the list of fork configs the tool loop should execute.
+ */
+export declare function mapTeamRequestToForkConfigs(request: TeamToolRequest, agentRegistry: (name: string) => AgentDefinition | undefined): Array<{
+    agentDef: AgentDefinition;
+    prompt: string;
+    maxTurns?: number;
+    role: AgentRole;
+}>;
+//# sourceMappingURL=team-tool-loop-wiring.d.ts.map

package/dist/orchestration/team-tool-loop-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-tool-loop-wiring.d.ts","sourceRoot":"","sources":["../../src/orchestration/team-tool-loop-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACvH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMrD,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,sBAAsB;IACtB,IAAI,EAAE,iBAAiB,CAAC;IACxB,gCAAgC;IAChC,WAAW,EAAE,qBAAqB,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,4DAA4D;IAC5D,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,GACvB,iBAAiB,CA8CnB;AAMD,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,EAAE,EAAE,OAAO,CAAC;IACZ,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,YAAY,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IAC9E,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,EACxE,MAAM,EAAE,qBAAqB,GAC5B,oBAAoB,CA2EtB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,EACxB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,GAC3D,KAAK,CAAC;IAAE,QAAQ,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAa1F"}

package/dist/orchestration/team-tool-loop-wiring.js

@@ -0,0 +1,148 @@
+/**
+ * Team Tool Loop Wiring — Connects team orchestration to the tool loop.
+ *
+ * When the LLM invokes `team_create`, this module:
+ * 1. Validates the team plan
+ * 2. Maps team agents to fork contexts
+ * 3. Coordinates execution according to the team execution mode
+ * 4. Aggregates results according to the aggregation policy
+ * 5. Returns the aggregated result as a tool_result
+ *
+ * This bridges the gap between the pure strategy layer (team-orchestration.ts)
+ * and the Hub's tool loop.
+ */
+/**
+ * Resolve the execution plan for a team request.
+ * Validates the request, resolves dependencies into ordered batches,
+ * and determines the execution topology.
+ */
+export function resolveTeamExecutionPlan(request) {
+    const agents = request.agents;
+    if (agents.length === 0) {
+        return { batches: [], totalBudget: 0, state: "planning" };
+    }
+    if (agents.length > 8) {
+        throw new Error(`Team cannot have more than 8 agents (got ${agents.length})`);
+    }
+    // For "parallel" mode — single batch with all agents
+    if (request.mode === "parallel") {
+        return {
+            batches: [{ agents, mode: "parallel" }],
+            totalBudget: agents.length * 50000,
+            state: "spawning",
+        };
+    }
+    // For "sequential" or "pipeline" — one agent per batch
+    if (request.mode === "sequential" || request.mode === "pipeline") {
+        return {
+            batches: agents.map((a) => ({ agents: [a], mode: "serial" })),
+            totalBudget: agents.length * 50000,
+            state: "spawning",
+        };
+    }
+    // "adaptive" — planner first, then remaining in parallel
+    const planners = agents.filter((a) => a.role === "planner");
+    const rest = agents.filter((a) => a.role !== "planner");
+    const batches = [];
+    if (planners.length > 0) {
+        batches.push({ agents: planners, mode: "serial" });
+    }
+    if (rest.length > 0) {
+        batches.push({ agents: rest, mode: "parallel" });
+    }
+    return {
+        batches,
+        totalBudget: agents.length * 50000,
+        state: "spawning",
+    };
+}
+/**
+ * Aggregate results from team agents according to the aggregation policy.
+ */
+export function aggregateTeamToolResults(results, policy) {
+    const totalTokens = results.reduce((sum, r) => sum + r.result.tokensUsed, 0);
+    const allOk = results.every((r) => r.result.ok);
+    const anyOk = results.some((r) => r.result.ok);
+    switch (policy) {
+        case "first-success": {
+            const first = results.find((r) => r.result.ok);
+            return {
+                ok: !!first,
+                output: first?.result.output || "(No agent succeeded)",
+                agentResults: results,
+                totalTokensUsed: totalTokens,
+                finalState: first ? "completed" : "failed",
+            };
+        }
+        case "merge-all": {
+            const outputs = results.map((r) => `### ${r.role} (${r.agentId})\n${r.result.output || "(no output)"}`);
+            return {
+                ok: anyOk,
+                output: outputs.join("\n\n---\n\n"),
+                agentResults: results,
+                totalTokensUsed: totalTokens,
+                finalState: anyOk ? "completed" : "failed",
+            };
+        }
+        case "reviewer-gate": {
+            const reviewer = results.find((r) => r.role === "reviewer");
+            const executors = results.filter((r) => r.role !== "reviewer");
+            const executorOutput = executors.map((r) => r.result.output).filter(Boolean).join("\n\n");
+            if (reviewer && reviewer.result.ok) {
+                return {
+                    ok: true,
+                    output: `## Reviewed Output\n${executorOutput}\n\n## Review\n${reviewer.result.output}`,
+                    agentResults: results,
+                    totalTokensUsed: totalTokens,
+                    finalState: "completed",
+                };
+            }
+            return {
+                ok: false,
+                output: `Review failed: ${reviewer?.result.output || "no reviewer result"}`,
+                agentResults: results,
+                totalTokensUsed: totalTokens,
+                finalState: "failed",
+            };
+        }
+        case "planner-sync": {
+            // Planner agent's output is the consolidated result
+            const planner = results.find((r) => r.role === "planner");
+            if (planner) {
+                return {
+                    ok: planner.result.ok,
+                    output: planner.result.output,
+                    agentResults: results,
+                    totalTokensUsed: totalTokens,
+                    finalState: planner.result.ok ? "completed" : "failed",
+                };
+            }
+            // Fallback to merge-all
+            return aggregateTeamToolResults(results, "merge-all");
+        }
+        case "majority-vote":
+        default: {
+            // Simple: all outputs merged
+            return aggregateTeamToolResults(results, "merge-all");
+        }
+    }
+}
+/**
+ * Map a team tool_call into the format needed for the tool loop to dispatch.
+ * Returns the list of fork configs the tool loop should execute.
+ */
+export function mapTeamRequestToForkConfigs(request, agentRegistry) {
+    return request.agents.map((agent) => {
+        const def = agentRegistry(agent.agentType);
+        if (!def) {
+            throw new Error(`Unknown agent type "${agent.agentType}" in team request`);
+        }
+        return {
+            agentDef: def,
+            prompt: agent.prompt,
+            maxTurns: agent.maxTurns,
+            role: agent.role,
+        };
+    });
+}
+//# sourceMappingURL=team-tool-loop-wiring.js.map

package/dist/orchestration/team-tool-loop-wiring.js.map

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