@oh-my-pi/swarm-extension 13.3.6 → 13.3.8

package/README.md

@@ -80,7 +80,7 @@ swarm:
   workspace: ./workspace # Working directory (relative to YAML file location)
   mode: pipeline # pipeline | parallel | sequential
   target_count: 10 # Iterations (pipeline mode only, default: 1)
-  model: claude-opus-4-6 # Model for all agents (optional)
+  model: claude-opus-4-6 # Default model for agents without an override (optional)
 
   agents:
     first_agent:
@@ -93,6 +93,7 @@ swarm:
         - downstream_agent
       waits_for:
         - upstream_agent
+      model: claude-sonnet-4-5 # Optional per-agent override
 ```
 
 ### Top-Level Fields
@@ -103,7 +104,7 @@ swarm:
 | `workspace`    | yes      | —               | Shared working directory. Relative paths resolve from YAML file location       |
 | `mode`         | no       | `sequential`    | Execution mode (see below)                                                     |
 | `target_count` | no       | `1`             | How many times to repeat the full pipeline. Only meaningful in `pipeline` mode |
-| `model`        | no       | session default | Model ID for all agents. Any omp-configured model works                        |
+| `model`        | no       | session default | Default model for agents that do not set `agents.<name>.model`                |
 
 ### Agent Fields
 
@@ -112,6 +113,7 @@ swarm:
 | `role`          | yes      | Short role identifier — becomes the agent's system prompt               |
 | `task`          | yes      | Complete instructions sent as user prompt. Use YAML `\|` for multi-line |
 | `extra_context` | no       | Additional text appended to system prompt                               |
+| `model`         | no       | Model override for this agent only                                      |
 | `reports_to`    | no       | List of agent names that depend on this agent                           |
 | `waits_for`     | no       | List of agent names this agent depends on                               |
 
@@ -434,14 +436,24 @@ tracking/status.json      -> Cumulative state
 
 ## Models
 
-Any model configured in omp works. Set it in the YAML:
+Any model configured in omp works. Set a swarm default and optionally override per agent:
 
 ```yaml
 swarm:
   model: claude-opus-4-6
+  agents:
+    writer:
+      role: technical-writer
+      task: |
+        Write the draft.
+    reviewer:
+      role: reviewer
+      model: claude-sonnet-4-5
+      task: |
+        Review the draft.
 ```
 
-Or omit `model` to use your session's default. Check `packages/ai/src/models.json` for available model IDs.
+Precedence: `agents.<name>.model` → `swarm.model` → session default. Check `packages/ai/src/models.json` for available model IDs.
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/swarm-extension",
-	"version": "13.3.6",
+	"version": "13.3.8",
 	"description": "Swarm orchestration extension for omp",
 	"homepage": "https://github.com/can1357/oh-my-pi",
 	"author": "Derek Rynd",

package/src/swarm/pipeline.ts

@@ -164,7 +164,7 @@ export class PipelineController {
 							workspace: options.workspace,
 							swarmName: this.#def.name,
 							iteration,
-							modelOverride: this.#def.model,
+							modelOverride: agent.model ?? this.#def.model,
 							signal: options.signal,
 							onProgress: (_name, _progress) => {
 								options.emitProgress(waveIdx);

package/src/swarm/schema.ts

@@ -8,6 +8,7 @@ interface RawSwarmAgentConfig {
 	extra_context?: string;
 	reports_to?: string[];
 	waits_for?: string[];
+	model?: string;
 }
 
 interface RawSwarmConfig {
@@ -32,6 +33,7 @@ export interface SwarmAgent {
 	extraContext?: string;
 	reportsTo: string[];
 	waitsFor: string[];
+	model?: string;
 }
 
 export interface SwarmDefinition {
@@ -95,6 +97,7 @@ export function parseSwarmYaml(content: string): SwarmDefinition {
 			task: config.task.trim(),
 			extraContext: config.extra_context?.trim(),
 			reportsTo: Array.isArray(config.reports_to) ? config.reports_to : [],
+			model: typeof config.model === "string" ? config.model.trim() : undefined,
 			waitsFor: Array.isArray(config.waits_for) ? config.waits_for : [],
 		});
 	}
@@ -104,7 +107,7 @@ export function parseSwarmYaml(content: string): SwarmDefinition {
 		workspace: swarm.workspace,
 		mode: mode as SwarmMode,
 		targetCount: swarm.target_count ?? 1,
-		model: swarm.model,
+		model: typeof swarm.model === "string" ? swarm.model.trim() : undefined,
 		agents,
 		agentOrder,
 	};
@@ -118,6 +121,9 @@ export function validateSwarmDefinition(def: SwarmDefinition): string[] {
 	const errors: string[] = [];
 	const agentNames = new Set(def.agents.keys());
 
+	if (def.model !== undefined && def.model.length === 0) {
+		errors.push("swarm.model must not be empty when provided");
+	}
 	for (const [name, agent] of def.agents) {
 		for (const dep of agent.waitsFor) {
 			if (!agentNames.has(dep)) {
@@ -135,6 +141,9 @@ export function validateSwarmDefinition(def: SwarmDefinition): string[] {
 				errors.push(`Agent '${name}' cannot report to itself`);
 			}
 		}
+		if (agent.model !== undefined && agent.model.length === 0) {
+			errors.push(`Agent '${name}' model must not be empty when provided`);
+		}
 	}
 
 	if (def.targetCount < 1) {