Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.
TypeScript agentic-aiai-agentsai-codinganthropicautomationclaudeclaude-codecodexcoding-agentsdevops-automationdevtoolsgithub-actionsgrokllmloop-engineeringmcpprompt-engineering
feat(loop-init): add orcarouter model provider (#569)
dulcestentaciones2920-debug07e55b3eb3c7
diff --git a/tools/loop-init/README.md b/tools/loop-init/README.mdindex b0f3e4d..53b9398 100644--- a/tools/loop-init/README.md+++ b/tools/loop-init/README.md@@ -40,20 +40,22 @@ Every `loop-init` run prints a Foundry CTA; when Loop Ready is **≥ 80**, the C### Interface provider (implementer preset)-The `implementer` preset defaults to the built-in interface primitive. Pass `--model-provider minimax` to emit a `model/minimax` provider primitive instead. The generated stack always carries both regional endpoints and both model options, so you can switch region/model without regenerating:+The `implementer` preset defaults to the built-in interface primitive. Pass `--model-provider minimax` to emit a `model/minimax` provider primitive instead, or `--model-provider orcarouter` to emit a `model/orcarouter` provider primitive. The generated stack always carries the provider endpoints and model options, so you can switch provider/model without regenerating:```bashnpx @cobusgreyling/loop-init . -p ci-sweeper -t grok --with-foundry --model-provider minimaxnpx @cobusgreyling/loop-init . -p ci-sweeper -t grok --with-foundry --model-provider minimax --region cn_zh --model MiniMax-M2.7+npx @cobusgreyling/loop-init . -p ci-sweeper -t claude --with-foundry --model-provider orcarouter+npx @cobusgreyling/loop-init . -p ci-sweeper -t claude --with-foundry --model-provider orcarouter --model orcarouter/auto```| Flag | Values | Default ||------|--------|---------|-| `--model-provider` | `anthropic`, `minimax` | `anthropic` |+| `--model-provider` | `anthropic`, `minimax`, `orcarouter` | `anthropic` || `--region` | `global_en`, `cn_zh` | `global_en` |-| `--model` | `MiniMax-M3`, `MiniMax-M2.7` | `MiniMax-M3` |+| `--model` | `MiniMax-M3`, `MiniMax-M2.7`, `orcarouter/fusion`, `orcarouter/fusion-flash`, `orcarouter/auto`, `orcarouter/free` | `MiniMax-M3` / `orcarouter/fusion` |-MiniMax model options and both endpoints (`global_en` → `https://api.minimax.io`, `cn_zh` → `https://api.minimaxi.com`) are written into `.foundry/stack.yaml`.+MiniMax model options and both endpoints (`global_en` → `https://api.minimax.io`, `cn_zh` → `https://api.minimaxi.com`) are written into `.foundry/stack.yaml`. The OrcaRouter provider writes the gateway's OpenAI- and Anthropic-compatible endpoints (`https://api.orcarouter.ai`) plus its routing model options (`orcarouter/fusion`, `orcarouter/fusion-flash`, `orcarouter/auto`, `orcarouter/free`).## Patternsdiff --git a/tools/loop-init/dist/cli.js b/tools/loop-init/dist/cli.jsindex daaa513..ef210ee 100644--- a/tools/loop-init/dist/cli.js+++ b/tools/loop-init/dist/cli.js@@ -106,6 +106,60 @@ const MINIMAX_REGIONS = [];const MINIMAX_MODEL_IDS = MINIMAX_MODELS.map((m) => m.id);const MINIMAX_REGION_IDS = MINIMAX_REGIONS.map((r) => r.region);+const ORCAROUTER_DEFAULT_MODEL = 'orcarouter/fusion';+const ORCAROUTER_BASE_URL = 'https://api.orcarouter.ai';+const ORCAROUTER_MODELS = [+ {+ id: 'orcarouter/fusion',+ contextWindow: 1_000_000,+ thinking: ['adaptive', 'disabled'],+ notes: 'Adaptive-routing flagship; multi-model aggregate with automatic failover',+ },+ {+ id: 'orcarouter/fusion-flash',+ contextWindow: 200_000,+ thinking: ['adaptive', 'disabled'],+ notes: 'Fast adaptive-routing tier for high-volume, latency-sensitive loops',+ },+ {+ id: 'orcarouter/auto',+ contextWindow: 1_000_000,+ thinking: ['adaptive', 'disabled'],+ notes: 'Cost-optimized routing tier',+ },+ {+ id: 'orcarouter/free',+ contextWindow: 200_000,+ thinking: ['disabled'],+ notes: 'Zero-cost tier for report-only loops',+ },+];+const ORCAROUTER_MODEL_IDS = ORCAROUTER_MODELS.map((m) => m.id);+/**+ * Render the `model/orcarouter` interface primitive for the implementer stack.+ * OrcaRouter exposes an OpenAI-compatible gateway that routes a single model+ * id across many upstream models. Both protocol shapes live on the same+ * gateway base URL — the OpenAI and Anthropic-compatible paths are identical+ * and the client picks the wire format via its request headers.+ */+function orcarouterInterfaceYaml(model) {+ const models = ORCAROUTER_MODELS.map((m) => [+ ` - id: ${m.id}`,+ ` context_window: ${m.contextWindow}`,+ ` thinking: [${m.thinking.join(', ')}]`,+ ` notes: "${m.notes}"`,+ ].join('\n')).join('\n');+ return ` - primitive: model/orcarouter+ config:+ model: ${model}+ models:+${models}+ endpoints:+ global:+ openai_base_url: ${ORCAROUTER_BASE_URL}/v1+ anthropic_base_url: ${ORCAROUTER_BASE_URL}/v1+ docs_root: https://www.orcarouter.ai`;+}/** Render the `model/minimax` interface primitive for the implementer stack. */function minimaxInterfaceYaml(model, region) {const models = MINIMAX_MODELS.map((m) => [@@ -176,7 +230,9 @@ function foundryStackYaml(stackName, pattern, preset, provider = 'anthropic', reif (preset === 'implementer') {const interfaceLayer = provider === 'minimax'? minimaxInterfaceYaml(model, region)- : ` - primitive: model/anthropic+ : provider === 'orcarouter'+ ? orcarouterInterfaceYaml(model)+ : ` - primitive: model/anthropicconfig:model: claude-sonnet-4-6`;return `name: ${stackName}@@ -660,9 +716,9 @@ Options:--with-foundry Also scaffold .foundry/ stack (harness-foundry runtime)--with-memory Also scaffold memory-engineering tiers and budget--with-fleet Also scaffold fleet-engineering registry and inbox- --model-provider Implementer interface provider (default: anthropic; minimax)+ --model-provider Implementer interface provider (default: anthropic; minimax, orcarouter)--region MiniMax region when --model-provider minimax (global_en, cn_zh)- --model MiniMax model when --model-provider minimax (MiniMax-M3, MiniMax-M2.7)+ --model Provider model when --model-provider minimax/orcarouter (default: MiniMax-M3 / orcarouter/fusion)--dry-run Print actions without copying-h, --help This help@@ -677,13 +733,14 @@ Examples:npx @cobusgreyling/loop-init . -p pr-babysitter -t claude --with-foundrynpx @cobusgreyling/loop-init . -p ci-sweeper -t grok --with-foundry --model-provider minimaxnpx @cobusgreyling/loop-init . -p ci-sweeper -t grok --with-foundry --model-provider minimax --region cn_zh --model MiniMax-M2.7+ npx @cobusgreyling/loop-init . -p ci-sweeper -t claude --with-foundry --model-provider orcarouter --model orcarouter/autonpx @cobusgreyling/loop-init . -p daily-triage -t opencodenpx @cobusgreyling/loop-init . --with-memorynpx @cobusgreyling/loop-init . --with-fleet`);process.exit(0);}- const { pattern, tool, target, dryRun, withFoundry, withMemory, withFleet, modelProvider, region, model } = args;+ let { pattern, tool, target, dryRun, withFoundry, withMemory, withFleet, modelProvider, region, model } = args;const validPatterns = Object.keys(PATTERN_STARTERS);const validTools = Object.keys(TOOL_SUFFIX);if (!validPatterns.includes(pattern)) {@@ -694,7 +751,7 @@ Examples:console.error(`Unknown tool: ${tool}. Valid: ${validTools.join(', ')}`);process.exit(1);}- const validProviders = ['anthropic', 'minimax'];+ const validProviders = ['anthropic', 'minimax', 'orcarouter'];if (!validProviders.includes(modelProvider)) {console.error(`Unknown model provider: ${modelProvider}. Valid: ${validProviders.join(', ')}`);process.exit(1);@@ -709,6 +766,19 @@ Examples:process.exit(1);}}+ if (modelProvider === 'orcarouter') {+ // `model` defaults to the MiniMax default; if the user did not pass+ // `--model` explicitly, fall back to the OrcaRouter default instead.+ if (!ORCAROUTER_MODEL_IDS.includes(model)) {+ if (model === MINIMAX_DEFAULT_MODEL) {+ model = ORCAROUTER_DEFAULT_MODEL;+ }+ else {+ console.error(`Unknown model: ${model}. Valid: ${ORCAROUTER_MODEL_IDS.join(', ')}`);+ process.exit(1);+ }+ }+ }const targetDir = path.resolve(target);const baseStarter = PATTERN_STARTERS[pattern];const suffix = TOOL_AGNOSTIC.has(pattern) ? '' : TOOL_SUFFIX[tool];diff --git a/tools/loop-init/src/cli.ts b/tools/loop-init/src/cli.tsindex 6c5c1e7..e56164d 100644--- a/tools/loop-init/src/cli.ts+++ b/tools/loop-init/src/cli.ts@@ -104,10 +104,11 @@ const FOUNDRY_SHOWCASE =/*** Model providers selectable for the implementer preset's `interface` layer.- * The implementer stack defaults to the existing primitive; `minimax` emits a- * `model/minimax` provider primitive with regional endpoints and model options.+ * The implementer stack defaults to the existing primitive; `minimax` and+ * `orcarouter` emit their own provider primitive with endpoints and model+ * options instead.*/-type ModelProvider = 'anthropic' | 'minimax';+type ModelProvider = 'anthropic' | 'minimax' | 'orcarouter';type MiniMaxRegion = 'global_en' | 'cn_zh';@@ -169,6 +170,67 @@ const MINIMAX_REGIONS: MiniMaxRegionEndpoint[] = [const MINIMAX_MODEL_IDS = MINIMAX_MODELS.map((m) => m.id);const MINIMAX_REGION_IDS = MINIMAX_REGIONS.map((r) => r.region);+const ORCAROUTER_DEFAULT_MODEL = 'orcarouter/fusion';+const ORCAROUTER_BASE_URL = 'https://api.orcarouter.ai';++const ORCAROUTER_MODELS = [+ {+ id: 'orcarouter/fusion',+ contextWindow: 1_000_000,+ thinking: ['adaptive', 'disabled'],+ notes: 'Adaptive-routing flagship; multi-model aggregate with automatic failover',+ },+ {+ id: 'orcarouter/fusion-flash',+ contextWindow: 200_000,+ thinking: ['adaptive', 'disabled'],+ notes: 'Fast adaptive-routing tier for high-volume, latency-sensitive loops',+ },+ {+ id: 'orcarouter/auto',+ contextWindow: 1_000_000,+ thinking: ['adaptive', 'disabled'],+ notes: 'Cost-optimized routing tier',+ },+ {+ id: 'orcarouter/free',+ contextWindow: 200_000,+ thinking: ['disabled'],+ notes: 'Zero-cost tier for report-only loops',+ },+];++const ORCAROUTER_MODEL_IDS = ORCAROUTER_MODELS.map((m) => m.id);++/**+ * Render the `model/orcarouter` interface primitive for the implementer stack.+ * OrcaRouter exposes an OpenAI-compatible gateway that routes a single model+ * id across many upstream models. Both protocol shapes live on the same+ * gateway base URL — the OpenAI and Anthropic-compatible paths are identical+ * and the client picks the wire format via its request headers.+ */+function orcarouterInterfaceYaml(model: string): string {+ const models = ORCAROUTER_MODELS.map((m) =>+ [+ ` - id: ${m.id}`,+ ` context_window: ${m.contextWindow}`,+ ` thinking: [${m.thinking.join(', ')}]`,+ ` notes: "${m.notes}"`,+ ].join('\n'),+ ).join('\n');++ return ` - primitive: model/orcarouter+ config:+ model: ${model}+ models:+${models}+ endpoints:+ global:+ openai_base_url: ${ORCAROUTER_BASE_URL}/v1+ anthropic_base_url: ${ORCAROUTER_BASE_URL}/v1+ docs_root: https://www.orcarouter.ai`;+}+/** Render the `model/minimax` interface primitive for the implementer stack. */function minimaxInterfaceYaml(model: string, region: MiniMaxRegion): string {const models = MINIMAX_MODELS.map((m) =>@@ -247,7 +309,9 @@ function foundryStackYaml(const interfaceLayer =provider === 'minimax'? minimaxInterfaceYaml(model, region)- : ` - primitive: model/anthropic+ : provider === 'orcarouter'+ ? orcarouterInterfaceYaml(model)+ : ` - primitive: model/anthropicconfig:model: claude-sonnet-4-6`;return `name: ${stackName}@@ -832,9 +896,9 @@ Options:--with-foundry Also scaffold .foundry/ stack (harness-foundry runtime)--with-memory Also scaffold memory-engineering tiers and budget--with-fleet Also scaffold fleet-engineering registry and inbox- --model-provider Implementer interface provider (default: anthropic; minimax)+ --model-provider Implementer interface provider (default: anthropic; minimax, orcarouter)--region MiniMax region when --model-provider minimax (global_en, cn_zh)- --model MiniMax model when --model-provider minimax (MiniMax-M3, MiniMax-M2.7)+ --model Provider model when --model-provider minimax/orcarouter (default: MiniMax-M3 / orcarouter/fusion)--dry-run Print actions without copying-h, --help This help@@ -849,6 +913,7 @@ Examples:npx @cobusgreyling/loop-init . -p pr-babysitter -t claude --with-foundrynpx @cobusgreyling/loop-init . -p ci-sweeper -t grok --with-foundry --model-provider minimaxnpx @cobusgreyling/loop-init . -p ci-sweeper -t grok --with-foundry --model-provider minimax --region cn_zh --model MiniMax-M2.7+ npx @cobusgreyling/loop-init . -p ci-sweeper -t claude --with-foundry --model-provider orcarouter --model orcarouter/autonpx @cobusgreyling/loop-init . -p daily-triage -t opencodenpx @cobusgreyling/loop-init . --with-memorynpx @cobusgreyling/loop-init . --with-fleet@@ -856,7 +921,7 @@ Examples:process.exit(0);}- const { pattern, tool, target, dryRun, withFoundry, withMemory, withFleet, modelProvider, region, model } = args;+ let { pattern, tool, target, dryRun, withFoundry, withMemory, withFleet, modelProvider, region, model } = args;const validPatterns = Object.keys(PATTERN_STARTERS) as Pattern[];const validTools = Object.keys(TOOL_SUFFIX) as Tool[];@@ -868,7 +933,7 @@ Examples:console.error(`Unknown tool: ${tool}. Valid: ${validTools.join(', ')}`);process.exit(1);}- const validProviders: ModelProvider[] = ['anthropic', 'minimax'];+ const validProviders: ModelProvider[] = ['anthropic', 'minimax', 'orcarouter'];if (!validProviders.includes(modelProvider)) {console.error(`Unknown model provider: ${modelProvider}. Valid: ${validProviders.join(', ')}`);process.exit(1);@@ -883,6 +948,18 @@ Examples:process.exit(1);}}+ if (modelProvider === 'orcarouter') {+ // `model` defaults to the MiniMax default; if the user did not pass+ // `--model` explicitly, fall back to the OrcaRouter default instead.+ if (!ORCAROUTER_MODEL_IDS.includes(model)) {+ if (model === MINIMAX_DEFAULT_MODEL) {+ model = ORCAROUTER_DEFAULT_MODEL;+ } else {+ console.error(`Unknown model: ${model}. Valid: ${ORCAROUTER_MODEL_IDS.join(', ')}`);+ process.exit(1);+ }+ }+ }const targetDir = path.resolve(target);const baseStarter = PATTERN_STARTERS[pattern];diff --git a/tools/loop-init/test/cli.test.mjs b/tools/loop-init/test/cli.test.mjsindex b76eaac..012c3c4 100644--- a/tools/loop-init/test/cli.test.mjs+++ b/tools/loop-init/test/cli.test.mjs@@ -379,6 +379,93 @@ test('loop-init --with-foundry anthropic provider is unchanged (default)', async}});+test('loop-init --with-foundry --model-provider orcarouter emits OrcaRouter provider primitive', async () => {+ const dir = await mkdtemp(path.join(tmpdir(), 'loop-init-foundry-orcarouter-'));+ try {+ const { stdout } = await exec('node', [+ CLI,+ dir,+ '--pattern',+ 'ci-sweeper',+ '--tool',+ 'grok',+ '--with-foundry',+ '--model-provider',+ 'orcarouter',+ ]);+ const stack = await readFile(path.join(dir, '.foundry', 'stack.yaml'), 'utf8');+ assert.match(stack, /primitive: model\/orcarouter/);+ // default routing model+ assert.match(stack, /model: orcarouter\/fusion/);+ // model options table+ assert.match(stack, /- id: orcarouter\/fusion/);+ assert.match(stack, /- id: orcarouter\/fusion-flash/);+ assert.match(stack, /- id: orcarouter\/auto/);+ assert.match(stack, /- id: orcarouter\/free/);+ // single global endpoint; both protocol shapes share the gateway base URL+ assert.match(stack, /https:\/\/api\.orcarouter\.ai\/v1/);+ assert.match(stack, /anthropic_base_url: https:\/\/api\.orcarouter\.ai\/v1/);+ assert.doesNotMatch(stack, /model\/anthropic/);+ assert.doesNotMatch(stack, /model\/minimax/);+ assert.match(stdout, /preset: implementer/);+ } finally {+ await rm(dir, { recursive: true, force: true });+ }+});++test('loop-init --with-foundry orcarouter --model selects a different routing model', async () => {+ const dir = await mkdtemp(path.join(tmpdir(), 'loop-init-foundry-orcarouter-model-'));+ try {+ await exec('node', [+ CLI,+ dir,+ '--pattern',+ 'ci-sweeper',+ '--tool',+ 'grok',+ '--with-foundry',+ '--model-provider',+ 'orcarouter',+ '--model',+ 'orcarouter/auto',+ ]);+ const stack = await readFile(path.join(dir, '.foundry', 'stack.yaml'), 'utf8');+ assert.match(stack, /model: orcarouter\/auto/);+ // all routing model options remain available in config+ assert.match(stack, /- id: orcarouter\/fusion/);+ assert.match(stack, /- id: orcarouter\/free/);+ } finally {+ await rm(dir, { recursive: true, force: true });+ }+});++test('loop-init rejects unknown orcarouter model', async () => {+ await assert.rejects(+ () =>+ exec('node', [+ CLI,+ '.',+ '--pattern',+ 'ci-sweeper',+ '--tool',+ 'grok',+ '--with-foundry',+ '--model-provider',+ 'orcarouter',+ '--model',+ 'not-a-model',+ '--dry-run',+ ]),+ (err) => err.stderr?.includes('Unknown model') || err.message?.includes('Unknown model'),+ );+});++test('loop-init --help documents --model-provider orcarouter', async () => {+ const { stdout } = await exec('node', [CLI, '--help']);+ assert.match(stdout, /--model-provider/);+ assert.match(stdout, /orcarouter/);+});+test('loop-init rejects unknown model provider', async () => {await assert.rejects(() =>