@mmnto/cli 0.18.0 → 0.20.0

package/dist/orchestrators/gemini-orchestrator.test.js

@@ -0,0 +1,120 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { invokeGeminiOrchestrator } from './gemini-orchestrator.js';
+// ─── Mock SDK ───────────────────────────────────────
+const { mockGenerateContent } = vi.hoisted(() => ({
+    mockGenerateContent: vi.fn(),
+}));
+vi.mock('@google/genai', () => ({
+    GoogleGenAI: class {
+        models = { generateContent: mockGenerateContent };
+    },
+}));
+vi.mock('../ui.js', () => ({
+    log: { info: vi.fn(), success: vi.fn(), warn: vi.fn(), error: vi.fn(), dim: vi.fn() },
+}));
+// ─── Tests ──────────────────────────────────────────
+describe('invokeGeminiOrchestrator', () => {
+    const baseOpts = {
+        prompt: 'test prompt',
+        model: 'gemini-2.5-flash',
+        cwd: '.',
+        tag: 'Test',
+        totemDir: '.totem',
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        process.env['GEMINI_API_KEY'] = 'test-key';
+    });
+    afterEach(() => {
+        delete process.env['GEMINI_API_KEY'];
+        delete process.env['GOOGLE_API_KEY'];
+    });
+    it('returns structured result from Gemini API', async () => {
+        mockGenerateContent.mockResolvedValueOnce({
+            text: 'Hello from Gemini',
+            usageMetadata: { promptTokenCount: 100, candidatesTokenCount: 50 },
+            candidates: [{ finishReason: 'STOP' }],
+        });
+        const result = await invokeGeminiOrchestrator(baseOpts);
+        expect(result.content).toBe('Hello from Gemini');
+        expect(result.inputTokens).toBe(100);
+        expect(result.outputTokens).toBe(50);
+        expect(result.finishReason).toBe('STOP');
+        expect(result.durationMs).toBeGreaterThanOrEqual(0);
+    });
+    it('passes model and prompt to the SDK', async () => {
+        mockGenerateContent.mockResolvedValueOnce({
+            text: 'ok',
+            usageMetadata: {},
+            candidates: [],
+        });
+        await invokeGeminiOrchestrator(baseOpts);
+        expect(mockGenerateContent).toHaveBeenCalledWith(expect.objectContaining({
+            model: 'gemini-2.5-flash',
+            contents: 'test prompt',
+        }));
+    });
+    it('falls back to GOOGLE_API_KEY when GEMINI_API_KEY is not set', async () => {
+        delete process.env['GEMINI_API_KEY'];
+        process.env['GOOGLE_API_KEY'] = 'google-key';
+        mockGenerateContent.mockResolvedValueOnce({
+            text: 'ok',
+            usageMetadata: {},
+            candidates: [],
+        });
+        // Should not throw — GOOGLE_API_KEY is accepted
+        await invokeGeminiOrchestrator(baseOpts);
+    });
+    it('throws when no API key is set', async () => {
+        delete process.env['GEMINI_API_KEY'];
+        delete process.env['GOOGLE_API_KEY'];
+        await expect(invokeGeminiOrchestrator(baseOpts)).rejects.toThrow('No Gemini API key found');
+    });
+    it('converts 429 status errors to QuotaError', async () => {
+        const rateLimitErr = Object.assign(new Error('Resource exhausted'), { status: 429 });
+        mockGenerateContent.mockRejectedValueOnce(rateLimitErr);
+        try {
+            await invokeGeminiOrchestrator(baseOpts);
+            expect.fail('Should have thrown');
+        }
+        catch (err) {
+            expect(err.name).toBe('QuotaError');
+        }
+    });
+    it('converts quota keyword errors to QuotaError', async () => {
+        mockGenerateContent.mockRejectedValueOnce(new Error('quota exceeded for model'));
+        try {
+            await invokeGeminiOrchestrator(baseOpts);
+            expect.fail('Should have thrown');
+        }
+        catch (err) {
+            expect(err.name).toBe('QuotaError');
+        }
+    });
+    it('wraps other API errors with [Totem Error] prefix', async () => {
+        mockGenerateContent.mockRejectedValueOnce(new Error('Model not found'));
+        await expect(invokeGeminiOrchestrator(baseOpts)).rejects.toThrow('[Totem Error] Gemini API call failed');
+    });
+    it('handles missing usageMetadata gracefully', async () => {
+        mockGenerateContent.mockResolvedValueOnce({
+            text: 'response',
+            candidates: [],
+        });
+        const result = await invokeGeminiOrchestrator(baseOpts);
+        expect(result.content).toBe('response');
+        expect(result.inputTokens).toBeNull();
+        expect(result.outputTokens).toBeNull();
+        expect(result.finishReason).toBeUndefined();
+    });
+    it('handles undefined text as empty string', async () => {
+        mockGenerateContent.mockResolvedValueOnce({
+            text: undefined,
+            usageMetadata: { promptTokenCount: 10, candidatesTokenCount: 0 },
+            candidates: [{ finishReason: 'SAFETY' }],
+        });
+        const result = await invokeGeminiOrchestrator(baseOpts);
+        expect(result.content).toBe('');
+        expect(result.finishReason).toBe('SAFETY');
+    });
+});
+//# sourceMappingURL=gemini-orchestrator.test.js.map

package/dist/orchestrators/gemini-orchestrator.test.js.map

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

package/dist/orchestrators/orchestrator.d.ts

@@ -0,0 +1,56 @@
+import type { Orchestrator as OrchestratorConfig } from '@mmnto/totem';
+export interface OrchestratorResult {
+    content: string;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    durationMs: number;
+    finishReason?: string;
+}
+export interface OrchestratorInvokeOptions {
+    prompt: string;
+    model: string;
+    cwd: string;
+    tag: string;
+    totemDir: string;
+}
+/** A provider-bound function that invokes an LLM and returns the result. */
+export type InvokeOrchestrator = (options: OrchestratorInvokeOptions) => Promise<OrchestratorResult>;
+/**
+ * Detect the active package manager from the `npm_config_user_agent` env var
+ * (set by npm, pnpm, yarn, and bun when running scripts). Falls back to `npm`.
+ */
+export declare function detectPackageManager(): string;
+/**
+ * Detect whether an error is a rate-limit / quota-exhaustion response.
+ * Used by both Gemini and Anthropic orchestrators to normalize QuotaError.
+ */
+export declare function isQuotaError(err: unknown): boolean;
+/**
+ * Parse a `provider:model` string into its components.
+ * If the prefix before the first colon is a known provider, splits it out.
+ * Otherwise, returns the full string as the model with the default provider.
+ */
+export declare function parseModelString(value: string, defaultProvider: string): {
+    provider: string;
+    model: string;
+};
+export interface ResolvedOrchestrator {
+    parsed: {
+        provider: string;
+        model: string;
+    };
+    invoke: InvokeOrchestrator;
+    qualifiedModel: string;
+}
+/**
+ * Parse and validate a model string, resolve cross-provider routing,
+ * and return the appropriate invoker. Centralizes the validation logic
+ * to guarantee symmetric validation across primary and fallback paths.
+ */
+export declare function resolveOrchestrator(rawModel: string, baseProvider: string, baseInvoke: InvokeOrchestrator): ResolvedOrchestrator;
+/**
+ * Create an orchestrator invoker bound to the given provider config.
+ * Mirrors the `createEmbedder()` pattern from `packages/core/src/embedders/`.
+ */
+export declare function createOrchestrator(config: OrchestratorConfig): InvokeOrchestrator;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrators/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrators/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAMvE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4EAA4E;AAC5E,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAIjC;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAUlD;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,GACtB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CASrC;AAOD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,EAAE,kBAAkB,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,kBAAkB,GAC7B,oBAAoB,CA8BtB;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAejF"}

package/dist/orchestrators/orchestrator.js

@@ -0,0 +1,96 @@
+import { invokeShellOrchestrator } from './shell-orchestrator.js';
+// ─── Package manager detection (#236) ───────────────
+/**
+ * Detect the active package manager from the `npm_config_user_agent` env var
+ * (set by npm, pnpm, yarn, and bun when running scripts). Falls back to `npm`.
+ */
+export function detectPackageManager() {
+    const ua = process.env['npm_config_user_agent'] ?? '';
+    if (ua.startsWith('pnpm'))
+        return 'pnpm';
+    if (ua.startsWith('yarn'))
+        return 'yarn';
+    if (ua.startsWith('bun'))
+        return 'bun';
+    return 'npm';
+}
+// ─── Quota detection (shared) ────────────────────────
+/**
+ * Detect whether an error is a rate-limit / quota-exhaustion response.
+ * Used by both Gemini and Anthropic orchestrators to normalize QuotaError.
+ */
+export function isQuotaError(err) {
+    if (!(err instanceof Error))
+        return false;
+    if ('status' in err && err.status === 429)
+        return true;
+    const msg = err.message.toLowerCase();
+    return (msg.includes('429') ||
+        msg.includes('quota') ||
+        msg.includes('rate limit') ||
+        msg.includes('too many requests'));
+}
+// ─── Model string parsing (#243) ─────────────────────
+const KNOWN_PROVIDERS = ['gemini', 'anthropic', 'shell'];
+/**
+ * Parse a `provider:model` string into its components.
+ * If the prefix before the first colon is a known provider, splits it out.
+ * Otherwise, returns the full string as the model with the default provider.
+ */
+export function parseModelString(value, defaultProvider) {
+    const colonIdx = value.indexOf(':');
+    if (colonIdx > 0) {
+        const prefix = value.slice(0, colonIdx);
+        if (KNOWN_PROVIDERS.includes(prefix)) {
+            return { provider: prefix, model: value.slice(colonIdx + 1) };
+        }
+    }
+    return { provider: defaultProvider, model: value };
+}
+// ─── Centralized model resolution (#248) ────────────
+/** Characters allowed in model names — restricts shell metacharacters. */
+const MODEL_NAME_RE = /^[\w./:_-]+$/;
+/**
+ * Parse and validate a model string, resolve cross-provider routing,
+ * and return the appropriate invoker. Centralizes the validation logic
+ * to guarantee symmetric validation across primary and fallback paths.
+ */
+export function resolveOrchestrator(rawModel, baseProvider, baseInvoke) {
+    if (rawModel.startsWith('-') || !MODEL_NAME_RE.test(rawModel)) {
+        throw new Error(`[Totem Error] Invalid model name '${rawModel}'. Model names may only contain word characters, dots, slashes, colons, underscores, and hyphens.`);
+    }
+    const parsed = parseModelString(rawModel, baseProvider);
+    if (parsed.provider === 'shell' && baseProvider !== 'shell') {
+        throw new Error(`[Totem Error] Cannot route to 'shell' provider from a '${baseProvider}' config.\n` +
+            `The shell provider requires a 'command' template in the orchestrator config.`);
+    }
+    if (!parsed.model || parsed.model.startsWith('-')) {
+        throw new Error(`[Totem Error] Invalid model name in '${rawModel}'. The model portion must not be empty or start with a hyphen.`);
+    }
+    const invoke = parsed.provider === baseProvider
+        ? baseInvoke
+        : createOrchestrator({ provider: parsed.provider });
+    return { parsed, invoke, qualifiedModel: rawModel };
+}
+// ─── Factory ─────────────────────────────────────────
+/**
+ * Create an orchestrator invoker bound to the given provider config.
+ * Mirrors the `createEmbedder()` pattern from `packages/core/src/embedders/`.
+ */
+export function createOrchestrator(config) {
+    switch (config.provider) {
+        case 'shell':
+            return (opts) => invokeShellOrchestrator({ ...opts, command: config.command });
+        case 'gemini':
+            return async (opts) => {
+                const { invokeGeminiOrchestrator } = await import('./gemini-orchestrator.js');
+                return invokeGeminiOrchestrator(opts);
+            };
+        case 'anthropic':
+            return async (opts) => {
+                const { invokeAnthropicOrchestrator } = await import('./anthropic-orchestrator.js');
+                return invokeAnthropicOrchestrator(opts);
+            };
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrators/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/orchestrators/orchestrator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAyBlE,uDAAuD;AAEvD;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC;IACtD,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wDAAwD;AAExD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,QAAQ,IAAI,GAAG,IAAK,GAA+B,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACpF,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,CACL,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;QACrB,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC1B,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAClC,CAAC;AACJ,CAAC;AAED,wDAAwD;AAExD,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,eAAuB;IAEvB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACxC,IAAK,eAAqC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;QAChE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACrD,CAAC;AAED,uDAAuD;AAEvD,0EAA0E;AAC1E,MAAM,aAAa,GAAG,cAAc,CAAC;AAQrC;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,YAAoB,EACpB,UAA8B;IAE9B,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,qCAAqC,QAAQ,mGAAmG,CACjJ,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAExD,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,0DAA0D,YAAY,aAAa;YACjF,8EAA8E,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,wCAAwC,QAAQ,gEAAgE,CACjH,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GACV,MAAM,CAAC,QAAQ,KAAK,YAAY;QAC9B,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAE1C,CAAC,CAAC;IAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AACtD,CAAC;AAED,wDAAwD;AAExD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACjF,KAAK,QAAQ;YACX,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;gBACpB,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;gBAC9E,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC,CAAC;QACJ,KAAK,WAAW;YACd,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;gBACpB,MAAM,EAAE,2BAA2B,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;gBACpF,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC;YAC3C,CAAC,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/orchestrators/orchestrator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.test.d.ts","sourceRoot":"","sources":["../../src/orchestrators/orchestrator.test.ts"],"names":[],"mappings":""}

package/dist/orchestrators/orchestrator.test.js

@@ -0,0 +1,222 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { createOrchestrator, detectPackageManager, isQuotaError, parseModelString, resolveOrchestrator, } from './orchestrator.js';
+// ─── Mock provider modules ──────────────────────────
+vi.mock('./gemini-orchestrator.js', () => ({
+    invokeGeminiOrchestrator: vi.fn().mockResolvedValue({
+        content: 'gemini result',
+        inputTokens: 100,
+        outputTokens: 50,
+        durationMs: 1000,
+    }),
+}));
+vi.mock('./anthropic-orchestrator.js', () => ({
+    invokeAnthropicOrchestrator: vi.fn().mockResolvedValue({
+        content: 'anthropic result',
+        inputTokens: 200,
+        outputTokens: 75,
+        durationMs: 2000,
+    }),
+}));
+// ─── Tests ──────────────────────────────────────────
+describe('createOrchestrator', () => {
+    it('returns a function for shell provider', () => {
+        const config = {
+            provider: 'shell',
+            command: 'echo {file}',
+        };
+        const invoke = createOrchestrator(config);
+        expect(typeof invoke).toBe('function');
+    });
+    it('returns a function for gemini provider', () => {
+        const config = {
+            provider: 'gemini',
+            defaultModel: 'gemini-2.5-flash',
+        };
+        const invoke = createOrchestrator(config);
+        expect(typeof invoke).toBe('function');
+    });
+    it('returns a function for anthropic provider', () => {
+        const config = {
+            provider: 'anthropic',
+            defaultModel: 'claude-sonnet-4-5-20250514',
+        };
+        const invoke = createOrchestrator(config);
+        expect(typeof invoke).toBe('function');
+    });
+    it('gemini invoker dispatches to gemini-orchestrator module', async () => {
+        const config = { provider: 'gemini' };
+        const invoke = createOrchestrator(config);
+        const result = await invoke({
+            prompt: 'test',
+            model: 'gemini-2.5-flash',
+            cwd: '.',
+            tag: 'Test',
+            totemDir: '.totem',
+        });
+        expect(result.content).toBe('gemini result');
+        expect(result.inputTokens).toBe(100);
+    });
+    it('anthropic invoker dispatches to anthropic-orchestrator module', async () => {
+        const config = { provider: 'anthropic' };
+        const invoke = createOrchestrator(config);
+        const result = await invoke({
+            prompt: 'test',
+            model: 'claude-sonnet-4-5-20250514',
+            cwd: '.',
+            tag: 'Test',
+            totemDir: '.totem',
+        });
+        expect(result.content).toBe('anthropic result');
+        expect(result.inputTokens).toBe(200);
+    });
+});
+// ─── detectPackageManager ───────────────────────────
+describe('detectPackageManager', () => {
+    const originalUa = process.env['npm_config_user_agent'];
+    afterEach(() => {
+        if (originalUa !== undefined) {
+            process.env['npm_config_user_agent'] = originalUa;
+        }
+        else {
+            delete process.env['npm_config_user_agent'];
+        }
+    });
+    it('detects pnpm', () => {
+        process.env['npm_config_user_agent'] = 'pnpm/9.15.0 npm/? node/v22.0.0';
+        expect(detectPackageManager()).toBe('pnpm');
+    });
+    it('detects yarn', () => {
+        process.env['npm_config_user_agent'] = 'yarn/4.0.0 npm/? node/v22.0.0';
+        expect(detectPackageManager()).toBe('yarn');
+    });
+    it('detects bun', () => {
+        process.env['npm_config_user_agent'] = 'bun/1.0.0';
+        expect(detectPackageManager()).toBe('bun');
+    });
+    it('defaults to npm when env var is missing', () => {
+        delete process.env['npm_config_user_agent'];
+        expect(detectPackageManager()).toBe('npm');
+    });
+    it('defaults to npm for unknown user agent', () => {
+        process.env['npm_config_user_agent'] = 'npm/10.0.0 node/v22.0.0';
+        expect(detectPackageManager()).toBe('npm');
+    });
+});
+// ─── isQuotaError ───────────────────────────────────
+describe('isQuotaError', () => {
+    it('detects 429 status errors', () => {
+        const err = Object.assign(new Error('rate limit'), { status: 429 });
+        expect(isQuotaError(err)).toBe(true);
+    });
+    it('detects quota keyword in message', () => {
+        expect(isQuotaError(new Error('quota exceeded'))).toBe(true);
+    });
+    it('detects rate limit keyword in message', () => {
+        expect(isQuotaError(new Error('rate limit reached'))).toBe(true);
+    });
+    it('detects too many requests keyword', () => {
+        expect(isQuotaError(new Error('Too Many Requests'))).toBe(true);
+    });
+    it('returns false for non-quota errors', () => {
+        expect(isQuotaError(new Error('Model not found'))).toBe(false);
+    });
+    it('returns false for non-Error values', () => {
+        expect(isQuotaError('some string')).toBe(false);
+        expect(isQuotaError(null)).toBe(false);
+    });
+});
+// ─── resolveOrchestrator (#248) ─────────────────────
+describe('resolveOrchestrator', () => {
+    const mockInvoke = vi.fn().mockResolvedValue({
+        content: 'mock result',
+        inputTokens: 100,
+        outputTokens: 50,
+        durationMs: 500,
+    });
+    it('reuses baseInvoke for same-provider resolution', () => {
+        const result = resolveOrchestrator('gemini-3-flash-preview', 'gemini', mockInvoke);
+        expect(result.invoke).toBe(mockInvoke);
+        expect(result.parsed).toEqual({ provider: 'gemini', model: 'gemini-3-flash-preview' });
+        expect(result.qualifiedModel).toBe('gemini-3-flash-preview');
+    });
+    it('creates new invoker for cross-provider resolution', () => {
+        const result = resolveOrchestrator('anthropic:claude-sonnet-4-20250514', 'gemini', mockInvoke);
+        expect(result.invoke).not.toBe(mockInvoke);
+        expect(result.parsed).toEqual({ provider: 'anthropic', model: 'claude-sonnet-4-20250514' });
+        expect(result.qualifiedModel).toBe('anthropic:claude-sonnet-4-20250514');
+    });
+    it('throws on empty model string (provider:)', () => {
+        expect(() => resolveOrchestrator('anthropic:', 'gemini', mockInvoke)).toThrow('must not be empty or start with a hyphen');
+    });
+    it('throws on model starting with hyphen', () => {
+        expect(() => resolveOrchestrator('anthropic:-bad', 'gemini', mockInvoke)).toThrow('must not be empty or start with a hyphen');
+    });
+    it('throws when cross-routing to shell from API provider', () => {
+        expect(() => resolveOrchestrator('shell:my-model', 'gemini', mockInvoke)).toThrow("Cannot route to 'shell' provider");
+    });
+    it('allows shell-to-shell routing', () => {
+        const result = resolveOrchestrator('shell:my-model', 'shell', mockInvoke);
+        expect(result.invoke).toBe(mockInvoke);
+        expect(result.parsed).toEqual({ provider: 'shell', model: 'my-model' });
+    });
+    it('preserves provider:model as qualifiedModel for cross-route', () => {
+        const result = resolveOrchestrator('gemini:gemini-3.1-pro-preview', 'anthropic', mockInvoke);
+        expect(result.qualifiedModel).toBe('gemini:gemini-3.1-pro-preview');
+    });
+    it('rejects model names with shell metacharacters', () => {
+        expect(() => resolveOrchestrator('$(touch /tmp/pwned)', 'shell', mockInvoke)).toThrow('Invalid model name');
+        expect(() => resolveOrchestrator('model;rm -rf /', 'shell', mockInvoke)).toThrow('Invalid model name');
+    });
+});
+// ─── parseModelString (#243) ────────────────────────
+describe('parseModelString', () => {
+    it('parses anthropic:model into provider and model', () => {
+        expect(parseModelString('anthropic:claude-sonnet-4-20250514', 'gemini')).toEqual({
+            provider: 'anthropic',
+            model: 'claude-sonnet-4-20250514',
+        });
+    });
+    it('parses gemini:model into provider and model', () => {
+        expect(parseModelString('gemini:gemini-3.1-pro-preview', 'anthropic')).toEqual({
+            provider: 'gemini',
+            model: 'gemini-3.1-pro-preview',
+        });
+    });
+    it('parses shell:model into provider and model', () => {
+        expect(parseModelString('shell:my-model', 'gemini')).toEqual({
+            provider: 'shell',
+            model: 'my-model',
+        });
+    });
+    it('returns default provider for plain model string', () => {
+        expect(parseModelString('gemini-3-flash-preview', 'gemini')).toEqual({
+            provider: 'gemini',
+            model: 'gemini-3-flash-preview',
+        });
+    });
+    it('returns default provider for unknown prefix (not a known provider)', () => {
+        expect(parseModelString('unknown:my-model:v1', 'gemini')).toEqual({
+            provider: 'gemini',
+            model: 'unknown:my-model:v1',
+        });
+    });
+    it('returns default provider for org/namespace:model patterns', () => {
+        expect(parseModelString('myorg/namespace:model-v1', 'anthropic')).toEqual({
+            provider: 'anthropic',
+            model: 'myorg/namespace:model-v1',
+        });
+    });
+    it('parses empty model after colon (caller should validate)', () => {
+        expect(parseModelString('anthropic:', 'gemini')).toEqual({
+            provider: 'anthropic',
+            model: '',
+        });
+    });
+    it('does not split on leading colon', () => {
+        expect(parseModelString(':some-model', 'gemini')).toEqual({
+            provider: 'gemini',
+            model: ':some-model',
+        });
+    });
+});
+//# sourceMappingURL=orchestrator.test.js.map

package/dist/orchestrators/orchestrator.test.js.map

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

package/dist/orchestrators/shell-orchestrator.d.ts

@@ -0,0 +1,16 @@
+import type { OrchestratorInvokeOptions, OrchestratorResult } from './orchestrator.js';
+/**
+ * Try to parse Gemini CLI JSON output. Returns extracted data or null if
+ * the output is not valid Gemini JSON (e.g. raw text from a non-Gemini orchestrator).
+ */
+export declare function tryParseGeminiJson(raw: string): {
+    content: string;
+    inputTokens: number;
+    outputTokens: number;
+    latencyMs: number | null;
+} | null;
+export interface ShellOrchestratorOptions extends OrchestratorInvokeOptions {
+    command: string;
+}
+export declare function invokeShellOrchestrator(opts: ShellOrchestratorOptions): Promise<OrchestratorResult>;
+//# sourceMappingURL=shell-orchestrator.d.ts.map

package/dist/orchestrators/shell-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrators/shell-orchestrator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAwBvF;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GACV;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAwBjG;AAID,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,kBAAkB,CAAC,CAoG7B"}