@framers/agentos 0.1.111 → 0.1.113

package/dist/api/strategies/debate.d.ts

@@ -9,8 +9,19 @@ import type { AgencyOptions, CompiledStrategy, Agent, BaseAgentConfig } from '..
  *
  * @param agents - Named roster of agent configs or pre-built `Agent` instances.
  * @param agencyConfig - Agency-level configuration providing fallback model/provider/tools.
+ *   Must include `model` or `provider` for the synthesis step.
  * @returns A {@link CompiledStrategy} with `execute` and `stream` methods.
- * @throws {AgencyConfigError} When no agency-level model/provider is available for synthesis.
+ * @throws {AgencyConfigError} When no agency-level model/provider is available
+ *   for the synthesis step.
+ *
+ * @example
+ * ```ts
+ * const strategy = compileDebate(
+ *   { optimist: { instructions: 'Argue the positive case.' }, pessimist: { instructions: 'Argue the risks.' } },
+ *   { model: 'openai:gpt-4o', maxRounds: 2, agents: { ... } },
+ * );
+ * const result = await strategy.execute('Should we adopt this new technology?');
+ * ```
  */
 export declare function compileDebate(agents: Record<string, BaseAgentConfig | Agent>, agencyConfig: AgencyOptions): CompiledStrategy;
 //# sourceMappingURL=debate.d.ts.map

package/dist/api/strategies/debate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debate.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/debate.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,eAAe,EAEhB,MAAM,aAAa,CAAC;AAIrB;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,KAAK,CAAC,EAC/C,YAAY,EAAE,aAAa,GAC1B,gBAAgB,CAiHlB"}
+{"version":3,"file":"debate.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/debate.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,eAAe,EAEhB,MAAM,aAAa,CAAC;AAIrB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,KAAK,CAAC,EAC/C,YAAY,EAAE,aAAa,GAC1B,gBAAgB,CAwHlB"}

package/dist/api/strategies/debate.js

@@ -2,10 +2,28 @@
  * @file debate.ts
  * Debate strategy compiler for the Agency API.
  *
+ * ## Execution model
+ *
  * Agents argue in rounds over a shared task. Each round, every agent sees all
  * prior arguments from every other agent, enabling progressive refinement
  * through adversarial discourse. After all rounds complete, a synthesizer
  * distils the collected arguments into a single coherent response.
+ *
+ * ## Why debate?
+ *
+ * Debate is effective for tasks where multiple perspectives lead to better
+ * outcomes: ethical reasoning, policy analysis, creative brainstorming,
+ * risk assessment. Each agent is forced to defend its position while
+ * considering others, reducing blind spots.
+ *
+ * ## Round structure
+ *
+ * For `N` agents and `R` rounds, the total agent calls are `N * R` plus one
+ * synthesis call. In each round, agents are called in declaration order.
+ * Each agent receives the full argument history from all prior agents/rounds.
+ *
+ * @see {@link compileStrategy} -- the dispatcher that selects this compiler.
+ * @see {@link compileReviewLoop} -- an alternative iterative strategy with explicit approval.
  */
 import { agent as createAgent } from '../agent.js';
 import { AgencyConfigError } from '../types.js';
@@ -20,13 +38,26 @@ import { resolveAgent, checkBeforeAgent } from './shared.js';
  *
  * @param agents - Named roster of agent configs or pre-built `Agent` instances.
  * @param agencyConfig - Agency-level configuration providing fallback model/provider/tools.
+ *   Must include `model` or `provider` for the synthesis step.
  * @returns A {@link CompiledStrategy} with `execute` and `stream` methods.
- * @throws {AgencyConfigError} When no agency-level model/provider is available for synthesis.
+ * @throws {AgencyConfigError} When no agency-level model/provider is available
+ *   for the synthesis step.
+ *
+ * @example
+ * ```ts
+ * const strategy = compileDebate(
+ *   { optimist: { instructions: 'Argue the positive case.' }, pessimist: { instructions: 'Argue the risks.' } },
+ *   { model: 'openai:gpt-4o', maxRounds: 2, agents: { ... } },
+ * );
+ * const result = await strategy.execute('Should we adopt this new technology?');
+ * ```
  */
 export function compileDebate(agents, agencyConfig) {
     if (!agencyConfig.model && !agencyConfig.provider) {
         throw new AgencyConfigError('Debate strategy requires an agency-level model or provider for result synthesis.');
     }
+    // Default to 3 rounds when not specified -- enough for meaningful discourse
+    // without excessive token consumption.
     const maxRounds = agencyConfig.maxRounds ?? 3;
     return {
         async execute(prompt, opts) {
@@ -36,13 +67,16 @@ export function compileDebate(agents, agencyConfig) {
             const collectedArguments = [];
             for (let round = 0; round < maxRounds; round++) {
                 for (const [name, agentOrConfig] of entries) {
-                    /* HITL: check beforeAgent gate before invoking this agent. */
+                    // HITL: check beforeAgent gate before invoking this agent.
                     const decision = await checkBeforeAgent(name, prompt, agentCalls, agencyConfig);
                     if (decision && !decision.approved) {
-                        /* Agent was rejected — skip this agent in this round. */
+                        // Agent was rejected -- skip this agent in this round.
                         continue;
                     }
                     const a = resolveAgent(agentOrConfig, agencyConfig);
+                    // Build the debate context: original task + all prior arguments.
+                    // The first agent in the first round sees "You are the first to argue."
+                    // which prevents confusion about missing prior context.
                     const debateContext = `Task: ${prompt}\n\n` +
                         (collectedArguments.length > 0
                             ? `Previous arguments:\n${collectedArguments.join('\n---\n')}`
@@ -54,6 +88,8 @@ export function compileDebate(agents, agencyConfig) {
                     const resultText = result.text ?? '';
                     const resultUsage = result.usage ?? {};
                     const resultToolCalls = result.toolCalls ?? [];
+                    // Label each argument with the agent name and round for traceability
+                    // in the synthesis prompt.
                     collectedArguments.push(`[${name}, round ${round + 1}]: ${resultText}`);
                     agentCalls.push({
                         agent: name,
@@ -72,7 +108,7 @@ export function compileDebate(agents, agencyConfig) {
                     totalUsage.totalTokens += resultUsage.totalTokens ?? 0;
                 }
             }
-            /* Synthesize all arguments into a final answer using the agency-level model. */
+            // Synthesize all arguments into a final answer using the agency-level model.
             const synthInstructions = agencyConfig.instructions
                 ? `\n\n${agencyConfig.instructions}`
                 : '';
@@ -94,7 +130,7 @@ export function compileDebate(agents, agencyConfig) {
             return { ...synthesis, agentCalls, usage: totalUsage };
         },
         stream(prompt, opts) {
-            /*
+            /**
              * For v1: streaming delegates to execute() and wraps the resolved text
              * as a single-chunk async iterable. A future version will stream the
              * synthesis step in real-time.

package/dist/api/strategies/debate.js.map

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

package/dist/api/strategies/hierarchical.d.ts

@@ -14,7 +14,21 @@ import type { AgencyOptions, CompiledStrategy, Agent, BaseAgentConfig } from '..
  * @param agencyConfig - Agency-level configuration; must include `model` or `provider`
  *   for the manager agent.
  * @returns A {@link CompiledStrategy} with `execute` and `stream` methods.
- * @throws {AgencyConfigError} When no agency-level model/provider is available for the manager.
+ * @throws {AgencyConfigError} When no agency-level model/provider is available
+ *   for the manager agent.
+ *
+ * @example
+ * ```ts
+ * const strategy = compileHierarchical(
+ *   {
+ *     researcher: { instructions: 'Find academic sources.' },
+ *     writer: { instructions: 'Write clear prose.' },
+ *   },
+ *   { model: 'openai:gpt-4o', agents: { ... } },
+ * );
+ * const result = await strategy.execute('Write a literature review on LLMs.');
+ * // The manager decided which agents to call and in what order.
+ * ```
  */
 export declare function compileHierarchical(agents: Record<string, BaseAgentConfig | Agent>, agencyConfig: AgencyOptions): CompiledStrategy;
 //# sourceMappingURL=hierarchical.d.ts.map

package/dist/api/strategies/hierarchical.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hierarchical.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/hierarchical.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,eAAe,EAEhB,MAAM,aAAa,CAAC;AAkBrB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,KAAK,CAAC,EAC/C,YAAY,EAAE,aAAa,GAC1B,gBAAgB,CAmHlB"}
+{"version":3,"file":"hierarchical.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/hierarchical.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,eAAe,EAEhB,MAAM,aAAa,CAAC;AAqBrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,KAAK,CAAC,EAC/C,YAAY,EAAE,aAAa,GAC1B,gBAAgB,CA0HlB"}

package/dist/api/strategies/hierarchical.js

@@ -2,10 +2,30 @@
  * @file hierarchical.ts
  * Hierarchical strategy compiler for the Agency API.
  *
+ * ## Execution model
+ *
  * A manager agent (instantiated from the agency-level config) delegates
  * subtasks to sub-agents via tool calls. Each sub-agent is exposed as a
  * `delegate_to_<name>` tool that the manager can invoke to assign work.
  * The manager synthesizes sub-agent outputs into a final answer.
+ *
+ * ## Emergent wiring
+ *
+ * The manager does not follow a fixed execution order. It decides which
+ * agents to call, in what order, and with what subtasks -- based on the
+ * user prompt and its system instructions. This makes hierarchical the
+ * most flexible strategy, but also the most dependent on the manager
+ * model's ability to plan and delegate effectively.
+ *
+ * ## Tool-based delegation
+ *
+ * Each sub-agent becomes a tool with a JSON Schema parameter (`task: string`).
+ * The tool's `execute` function invokes the sub-agent's `generate()` and
+ * returns the result text. This leverages the LLM's native tool-calling
+ * capability for delegation, avoiding custom routing logic.
+ *
+ * @see {@link compileStrategy} -- the dispatcher that selects this compiler.
+ * @see {@link compileAdaptiveWrapper} -- wraps other strategies with a hierarchical manager.
  */
 import { agent as createAgent } from '../agent.js';
 import { AgencyConfigError } from '../types.js';
@@ -13,6 +33,9 @@ import { isAgent, resolveAgent, checkBeforeAgent } from './shared.js';
 /**
  * Extracts a human-readable description from an agent config or instance.
  *
+ * Used to build the team roster in the manager's system prompt so the manager
+ * knows what each sub-agent specialises in.
+ *
  * @param agentOrConfig - Either a pre-built Agent or a raw BaseAgentConfig.
  * @returns The instructions string if available, otherwise a generic label.
  */
@@ -37,7 +60,21 @@ function getAgentDescription(agentOrConfig) {
  * @param agencyConfig - Agency-level configuration; must include `model` or `provider`
  *   for the manager agent.
  * @returns A {@link CompiledStrategy} with `execute` and `stream` methods.
- * @throws {AgencyConfigError} When no agency-level model/provider is available for the manager.
+ * @throws {AgencyConfigError} When no agency-level model/provider is available
+ *   for the manager agent.
+ *
+ * @example
+ * ```ts
+ * const strategy = compileHierarchical(
+ *   {
+ *     researcher: { instructions: 'Find academic sources.' },
+ *     writer: { instructions: 'Write clear prose.' },
+ *   },
+ *   { model: 'openai:gpt-4o', agents: { ... } },
+ * );
+ * const result = await strategy.execute('Write a literature review on LLMs.');
+ * // The manager decided which agents to call and in what order.
+ * ```
  */
 export function compileHierarchical(agents, agencyConfig) {
     if (!agencyConfig.model && !agencyConfig.provider) {
@@ -46,7 +83,9 @@ export function compileHierarchical(agents, agencyConfig) {
     return {
         async execute(prompt, opts) {
             const agentCalls = [];
-            /* Build one tool per sub-agent for the manager to delegate to. */
+            // Build one tool per sub-agent for the manager to delegate to.
+            // The tool name follows the `delegate_to_<name>` convention so the
+            // manager can infer the agent's role from the tool name alone.
             const agentTools = {};
             for (const [name, agentOrConfig] of Object.entries(agents)) {
                 const description = getAgentDescription(agentOrConfig);
@@ -60,13 +99,13 @@ export function compileHierarchical(agents, agencyConfig) {
                         required: ['task'],
                     },
                     execute: async (args) => {
-                        /* HITL: check beforeAgent gate before delegating to this sub-agent. */
+                        // HITL: check beforeAgent gate before delegating to this sub-agent.
                         const decision = await checkBeforeAgent(name, args.task, agentCalls, agencyConfig);
                         if (decision && !decision.approved) {
                             return { success: false, data: `Agent "${name}" execution was rejected by HITL.` };
                         }
                         const a = resolveAgent(agentOrConfig, agencyConfig);
-                        /* Apply instruction modifications from the approval decision if any. */
+                        // Apply instruction modifications from the approval decision if any.
                         const effectiveTask = decision?.modifications?.instructions
                             ? `${args.task}\n\n[Additional instructions]: ${decision.modifications.instructions}`
                             : args.task;
@@ -76,6 +115,7 @@ export function compileHierarchical(agents, agencyConfig) {
                         const resultText = result.text ?? '';
                         const resultUsage = result.usage ?? {};
                         const resultToolCalls = result.toolCalls ?? [];
+                        // Record the sub-agent call for the final result's agentCalls array.
                         agentCalls.push({
                             agent: name,
                             input: args.task,
@@ -92,7 +132,8 @@ export function compileHierarchical(agents, agencyConfig) {
                     },
                 };
             }
-            /* Build the team roster description for the manager's system prompt. */
+            // Build the team roster description for the manager's system prompt.
+            // This tells the manager who is on the team and what each member does.
             const teamRoster = Object.entries(agents)
                 .map(([name, c]) => `- ${name}: ${getAgentDescription(c)}`)
                 .join('\n');
@@ -100,7 +141,8 @@ export function compileHierarchical(agents, agencyConfig) {
                 `Available team members:\n${teamRoster}\n\n` +
                 `Use the delegate_to_<name> tools to assign work. Synthesize their outputs into a final answer.` +
                 (agencyConfig.instructions ? `\n\n${agencyConfig.instructions}` : '');
-            /* Merge agency-level tools with the delegation tools. */
+            // Merge agency-level tools with the delegation tools. Agency tools
+            // (e.g. shared search, calculator) are available alongside delegation.
             const mergedTools = { ...(agencyConfig.tools ?? {}), ...agentTools };
             const manager = createAgent({
                 model: agencyConfig.model,
@@ -109,13 +151,15 @@ export function compileHierarchical(agents, agencyConfig) {
                 baseUrl: agencyConfig.baseUrl,
                 instructions: managerInstructions,
                 tools: mergedTools,
+                // Higher maxSteps than default because the manager needs room to
+                // call multiple delegation tools before synthesizing.
                 maxSteps: agencyConfig.maxSteps ?? 10,
             });
             const result = (await manager.generate(prompt, opts));
             return { ...result, agentCalls };
         },
         stream(prompt, opts) {
-            /*
+            /**
              * For v1: streaming delegates to execute() and wraps the resolved text
              * as a single-chunk async iterable. A future version will stream the
              * manager's output in real-time.

package/dist/api/strategies/hierarchical.js.map

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

package/dist/api/strategies/index.d.ts

@@ -4,9 +4,23 @@
  *
  * Maps an {@link AgencyStrategy} discriminant to the concrete compiler that
  * produces a {@link CompiledStrategy}. Supports sequential, parallel, debate,
- * review-loop, and hierarchical strategies. When `adaptive` mode is enabled
- * on a non-hierarchical strategy, the dispatcher wraps it with an implicit
- * hierarchical manager that may override the default strategy at runtime.
+ * review-loop, hierarchical, and graph strategies.
+ *
+ * ## Adaptive mode
+ *
+ * When `adaptive` mode is enabled on a non-hierarchical strategy, the dispatcher
+ * wraps it with an implicit hierarchical manager that may override the default
+ * strategy at runtime. This works by:
+ *
+ * 1. Appending strategy-awareness instructions to the manager prompt.
+ * 2. Setting `adaptive: false` on the inner call to prevent infinite recursion.
+ * 3. Delegating to `compileHierarchical()` which creates delegation tools.
+ *
+ * The adaptive wrapper is transparent to the caller -- it still receives a
+ * standard {@link CompiledStrategy} with `execute` and `stream` methods.
+ *
+ * @see {@link compileStrategy} -- the main entry point for strategy compilation.
+ * @see {@link agency} -- the factory that calls compileStrategy during construction.
  */
 import type { AgencyStrategy, AgencyOptions, CompiledStrategy, Agent, BaseAgentConfig } from '../types.js';
 /**
@@ -21,7 +35,15 @@ import type { AgencyStrategy, AgencyOptions, CompiledStrategy, Agent, BaseAgentC
  * @param agents - Named roster of agent configs or pre-built `Agent` instances.
  * @param agencyConfig - Full agency-level configuration providing fallback values.
  * @returns A compiled strategy with `execute` and `stream` methods.
- * @throws {Error} When the requested strategy is not yet implemented.
+ * @throws {Error} When the requested strategy is not yet implemented (e.g. a
+ *         future strategy discriminant that has been added to `AgencyStrategy`
+ *         but not yet wired here).
+ *
+ * @example
+ * ```ts
+ * const strategy = compileStrategy('sequential', agents, agencyConfig);
+ * const result = await strategy.execute('Summarise AI research.');
+ * ```
  */
 export declare function compileStrategy(strategy: AgencyStrategy, agents: Record<string, BaseAgentConfig | Agent>, agencyConfig: AgencyOptions): CompiledStrategy;
 export { compileSequential } from './sequential.js';

package/dist/api/strategies/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,eAAe,EAChB,MAAM,aAAa,CAAC;AAQrB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,KAAK,CAAC,EAC/C,YAAY,EAAE,aAAa,GAC1B,gBAAgB,CAOlB;AAqED,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,eAAe,EAChB,MAAM,aAAa,CAAC;AAQrB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,KAAK,CAAC,EAC/C,YAAY,EAAE,aAAa,GAC1B,gBAAgB,CAUlB;AAgFD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/api/strategies/index.js

@@ -16,10 +16,21 @@ import { compileGraph } from './graph.js';
  * @param agents - Named roster of agent configs or pre-built `Agent` instances.
  * @param agencyConfig - Full agency-level configuration providing fallback values.
  * @returns A compiled strategy with `execute` and `stream` methods.
- * @throws {Error} When the requested strategy is not yet implemented.
+ * @throws {Error} When the requested strategy is not yet implemented (e.g. a
+ *         future strategy discriminant that has been added to `AgencyStrategy`
+ *         but not yet wired here).
+ *
+ * @example
+ * ```ts
+ * const strategy = compileStrategy('sequential', agents, agencyConfig);
+ * const result = await strategy.execute('Summarise AI research.');
+ * ```
  */
 export function compileStrategy(strategy, agents, agencyConfig) {
-    /* When adaptive mode is enabled on non-hierarchical strategies, wrap with a manager. */
+    // When adaptive mode is enabled on non-hierarchical strategies, wrap with
+    // a manager that can override the strategy at runtime. Hierarchical is
+    // excluded because it IS the manager pattern -- wrapping it again would
+    // create a pointless double-manager layer.
     if (agencyConfig.adaptive && strategy !== 'hierarchical') {
         return compileAdaptiveWrapper(strategy, agents, agencyConfig);
     }
@@ -28,10 +39,15 @@ export function compileStrategy(strategy, agents, agencyConfig) {
 /**
  * Core strategy compiler without adaptive wrapping.
  *
+ * Dispatches on the strategy discriminant to the appropriate concrete compiler.
+ * Each compiler returns a {@link CompiledStrategy} with consistent `execute`
+ * and `stream` method signatures.
+ *
  * @param strategy - Strategy discriminant.
  * @param agents - Named agent roster.
  * @param agencyConfig - Agency-level configuration.
  * @returns A compiled strategy.
+ * @throws {Error} When the strategy is not recognised.
  * @internal
  */
 function compileStrategyCore(strategy, agents, agencyConfig) {
@@ -61,7 +77,13 @@ function compileStrategyCore(strategy, agents, agencyConfig) {
  * just like the hierarchical strategy, but with the additional context of the
  * original intended strategy.
  *
- * @param defaultStrategy - The user-declared default strategy.
+ * ## Recursion prevention
+ *
+ * `adaptive: false` is set on the inner config to prevent the hierarchical
+ * compiler from re-entering the adaptive wrapper, which would cause infinite
+ * recursion.
+ *
+ * @param defaultStrategy - The user-declared default strategy (e.g. `"sequential"`).
  * @param agents - Named agent roster.
  * @param agencyConfig - Agency-level configuration.
  * @returns A compiled hierarchical strategy with adaptive instructions.
@@ -74,7 +96,7 @@ function compileAdaptiveWrapper(defaultStrategy, agents, agencyConfig) {
     const adaptiveConfig = {
         ...agencyConfig,
         instructions: adaptiveInstructions,
-        /* Disable adaptive on the inner call to prevent infinite recursion. */
+        // Disable adaptive on the inner call to prevent infinite recursion.
         adaptive: false,
     };
     return compileHierarchical(agents, adaptiveConfig);

package/dist/api/strategies/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/strategies/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAwB,EACxB,MAA+C,EAC/C,YAA2B;IAE3B,wFAAwF;IACxF,IAAI,YAAY,CAAC,QAAQ,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;QACzD,OAAO,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,mBAAmB,CAC1B,QAAwB,EACxB,MAA+C,EAC/C,YAA2B;IAE3B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACjD,KAAK,UAAU;YACb,OAAO,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC/C,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC7C,KAAK,aAAa;YAChB,OAAO,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACjD,KAAK,cAAc;YACjB,OAAO,mBAAmB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACnD,KAAK,OAAO;YACV,OAAO,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC5C;YACE,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,uBAAuB,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,sBAAsB,CAC7B,eAA+B,EAC/B,MAA+C,EAC/C,YAA2B;IAE3B,MAAM,oBAAoB,GACxB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,6BAA6B,eAAe,sEAAsE;QAClH,yFAAyF,CAAC;IAE5F,MAAM,cAAc,GAAkB;QACpC,GAAG,YAAY;QACf,YAAY,EAAE,oBAAoB;QAClC,uEAAuE;QACvE,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEF,OAAO,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/strategies/index.ts"],"names":[],"mappings":"AA+BA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAwB,EACxB,MAA+C,EAC/C,YAA2B;IAE3B,0EAA0E;IAC1E,uEAAuE;IACvE,wEAAwE;IACxE,2CAA2C;IAC3C,IAAI,YAAY,CAAC,QAAQ,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;QACzD,OAAO,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,mBAAmB,CAC1B,QAAwB,EACxB,MAA+C,EAC/C,YAA2B;IAE3B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACjD,KAAK,UAAU;YACb,OAAO,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC/C,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC7C,KAAK,aAAa;YAChB,OAAO,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACjD,KAAK,cAAc;YACjB,OAAO,mBAAmB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACnD,KAAK,OAAO;YACV,OAAO,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC5C;YACE,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,uBAAuB,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAS,sBAAsB,CAC7B,eAA+B,EAC/B,MAA+C,EAC/C,YAA2B;IAE3B,MAAM,oBAAoB,GACxB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,6BAA6B,eAAe,sEAAsE;QAClH,yFAAyF,CAAC;IAE5F,MAAM,cAAc,GAAkB;QACpC,GAAG,YAAY;QACf,YAAY,EAAE,oBAAoB;QAClC,oEAAoE;QACpE,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEF,OAAO,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/api/strategies/parallel.d.ts

@@ -3,15 +3,26 @@ import type { AgencyOptions, CompiledStrategy, Agent, BaseAgentConfig } from '..
  * Compiles a parallel execution strategy.
  *
  * All agents are invoked concurrently with the same prompt via
- * `Promise.all`. Once every agent has responded, a synthesis agent
- * (instantiated from the agency-level config) combines the individual
- * outputs into a single coherent response.
+ * `Promise.allSettled`. Once every agent has responded (or failed), a
+ * synthesis agent (instantiated from the agency-level config) combines the
+ * individual outputs into a single coherent response.
  *
  * @param agents - Named roster of agent configs or pre-built `Agent` instances.
  * @param agencyConfig - Agency-level configuration; must include `model` or `provider`
  *   for the synthesis step.
  * @returns A {@link CompiledStrategy} with `execute` and `stream` methods.
- * @throws {AgencyConfigError} When no agency-level model/provider is available for synthesis.
+ * @throws {AgencyConfigError} When no agency-level model/provider is available
+ *   for the synthesis step. The synthesis agent needs an LLM to combine the
+ *   parallel outputs.
+ *
+ * @example
+ * ```ts
+ * const strategy = compileParallel(
+ *   { factChecker: factAgent, writer: writeAgent },
+ *   { model: 'openai:gpt-4o', agents: { factChecker: factAgent, writer: writeAgent } },
+ * );
+ * const result = await strategy.execute('Write a fact-checked article.');
+ * ```
  */
 export declare function compileParallel(agents: Record<string, BaseAgentConfig | Agent>, agencyConfig: AgencyOptions): CompiledStrategy;
 //# sourceMappingURL=parallel.d.ts.map

package/dist/api/strategies/parallel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/parallel.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,eAAe,EAEhB,MAAM,aAAa,CAAC;AAIrB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,KAAK,CAAC,EAC/C,YAAY,EAAE,aAAa,GAC1B,gBAAgB,CAyIlB"}
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/parallel.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,eAAe,EAEhB,MAAM,aAAa,CAAC;AAIrB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,KAAK,CAAC,EAC/C,YAAY,EAAE,aAAa,GAC1B,gBAAgB,CAiJlB"}