@mmnto/cli 1.101.1 → 1.102.0

package/dist/orchestrators/orchestrator.js

@@ -1,5 +1,227 @@
 import { TotemConfigError, TotemOrchestratorError } from '@mmnto/totem';
 import { invokeShellOrchestrator } from './shell-orchestrator.js';
+const INVOKE_RECOVERY_HINT_LIMIT_BYTES = 1024;
+function boundUtf8Text(value, limitBytes) {
+    const bytes = Buffer.from(value, 'utf8');
+    if (bytes.length <= limitBytes)
+        return value;
+    return bytes
+        .subarray(0, limitBytes)
+        .toString('utf8')
+        .replace(/\uFFFD$/u, '');
+}
+function defaultInvokeRecoveryHint(kind) {
+    switch (kind) {
+        case 'auth':
+            return 'Check the provider login or API key, then retry the invocation.';
+        case 'quota':
+            return 'Wait for quota to reset, increase provider quota, or configure an available fallbackModel.';
+        case 'model':
+            return 'Select a model that is available to the configured provider account.';
+        case 'process-spawn':
+            return 'Install the configured CLI, verify it is on PATH, and check the shell command.';
+        case 'process-exit':
+            return 'Inspect the bounded invocation evidence, correct the CLI/provider failure, and retry.';
+        case 'timeout':
+            return 'Reduce the request workload or fix provider availability, then retry.';
+        case 'unknown':
+            return 'Inspect the invocation failure artifact and provider status, then retry.';
+    }
+}
+function normalizeTotemErrorBody(message) {
+    return message.replace(/^(?:\[Totem Error\]\s*)+/u, '');
+}
+/**
+ * Stable invocation failure surface consumed by run-artifact persistence and
+ * review-fan diagnostics. Process text in `attempts` is bounded but not yet
+ * DLP-masked; callers must not persist it directly.
+ */
+export class OrchestratorInvokeError extends TotemOrchestratorError {
+    code = 'ORCHESTRATOR_UNAVAILABLE';
+    kind;
+    attempts;
+    failureArtifactHash;
+    constructor(message, kind, attempts, options) {
+        super(normalizeTotemErrorBody(message), boundUtf8Text(options?.recoveryHint ?? defaultInvokeRecoveryHint(kind), INVOKE_RECOVERY_HINT_LIMIT_BYTES), options?.cause);
+        this.name = kind === 'quota' ? 'QuotaError' : 'OrchestratorInvokeError';
+        this.kind = kind;
+        this.attempts = attempts;
+        this.failureArtifactHash = options?.failureArtifactHash;
+    }
+}
+const ERROR_CAUSE_MAX_DEPTH = 8;
+/** Bounded, cycle-safe traversal for provider metadata wrapped by Totem errors. */
+function errorCauseChain(err) {
+    const chain = [];
+    const seen = new Set();
+    let current = err;
+    while (current !== null &&
+        (typeof current === 'object' || typeof current === 'function') &&
+        chain.length < ERROR_CAUSE_MAX_DEPTH &&
+        !seen.has(current)) {
+        chain.push(current);
+        seen.add(current);
+        try {
+            current = current['cause'];
+            // totem-context: intentional cleanup — a hostile cause getter ends this bounded, cycle-safe traversal at the last readable error; the already-collected evidence remains usable.
+        }
+        catch {
+            break;
+        }
+    }
+    return chain;
+}
+function numericProperty(err, names) {
+    for (const item of errorCauseChain(err)) {
+        for (const name of names) {
+            let value;
+            try {
+                value = item[name];
+                // totem-context: intentional cleanup — provider errors may expose hostile numeric getters; skip an unreadable field while bounded cause traversal continues.
+            }
+            catch {
+                continue;
+            }
+            if (typeof value === 'number' && Number.isFinite(value))
+                return value;
+        }
+    }
+    return undefined;
+}
+function stringProperties(err, names) {
+    const values = [];
+    for (const item of errorCauseChain(err)) {
+        for (const name of names) {
+            let value;
+            try {
+                value = item[name];
+                // totem-context: intentional cleanup — provider errors may expose hostile string getters; skip an unreadable field while bounded cause traversal continues.
+            }
+            catch {
+                continue;
+            }
+            if (typeof value === 'string' && value.length > 0)
+                values.push(value);
+        }
+    }
+    return values;
+}
+/**
+ * Deterministically classify an invocation failure. Structured process facts
+ * and provider status/code win over message heuristics; unmatched failures
+ * remain fail-honest as `unknown`.
+ */
+export function classifyInvokeFailure(err, context = {}) {
+    if (context.timedOut)
+        return 'timeout';
+    if (context.spawnFailed)
+        return 'process-spawn';
+    if (!(err instanceof Error)) {
+        return context.exitCode !== undefined || context.signal !== undefined
+            ? 'process-exit'
+            : 'unknown';
+    }
+    const status = numericProperty(err, ['status', 'statusCode']);
+    const normalizedCodes = stringProperties(err, ['code', 'type']).map((value) => value.toLowerCase());
+    const hasCode = (predicate) => normalizedCodes.some(predicate);
+    const message = err.message.toLowerCase();
+    if (hasCode((code) => code === 'etimedout' || code === 'abort_err'))
+        return 'timeout';
+    if (hasCode((code) => ['enoent', 'eacces', 'enoexec'].includes(code)))
+        return 'process-spawn';
+    // Structured provider metadata is authoritative. In particular, an auth or
+    // model status/code must not be reclassified as quota merely because the
+    // provider's prose happens to mention quota or rate limits.
+    if (status === 429 ||
+        hasCode((code) => code.includes('rate_limit') || code.includes('quota')) ||
+        stringProperties(err, ['name']).includes('QuotaError') ||
+        stringProperties(err, ['kind']).includes('quota')) {
+        return 'quota';
+    }
+    if (status === 401 ||
+        status === 403 ||
+        hasCode((code) => code.includes('auth') || code.includes('api_key'))) {
+        return 'auth';
+    }
+    if (hasCode((code) => code.includes('model')))
+        return 'model';
+    if (message.includes('429') ||
+        message.includes('quota') ||
+        message.includes('rate limit') ||
+        message.includes('too many requests')) {
+        return 'quota';
+    }
+    if (message.includes('unauthorized') ||
+        message.includes('forbidden') ||
+        message.includes('authentication') ||
+        message.includes('invalid api key') ||
+        message.includes('no anthropic api key') ||
+        message.includes('no gemini api key') ||
+        message.includes('no openai api key')) {
+        return 'auth';
+    }
+    if (message.includes('model not found') ||
+        message.includes('unknown model') ||
+        message.includes('model unavailable') ||
+        message.includes('does not exist') ||
+        (message.includes('model') && message.includes('not installed'))) {
+        return 'model';
+    }
+    if (context.exitCode !== undefined || context.signal !== undefined)
+        return 'process-exit';
+    return 'unknown';
+}
+function providerMetadata(err) {
+    if (!(err instanceof Error))
+        return {};
+    const providerStatus = numericProperty(err, ['status', 'statusCode']);
+    const providerCodes = stringProperties(err, ['code', 'type']);
+    const providerCode = providerCodes.find((code) => code !== 'ORCHESTRATOR_UNAVAILABLE') ?? providerCodes[0];
+    return {
+        ...(providerStatus !== undefined ? { providerStatus } : {}),
+        ...(providerCode !== undefined ? { providerCode } : {}),
+    };
+}
+function failedRuntimeAttempt(provider, model, route, durationMs, err, context = {}) {
+    const failureKind = classifyInvokeFailure(err, context);
+    return {
+        sequence: 1,
+        route,
+        provider,
+        model,
+        status: 'failed',
+        durationMs,
+        failureKind,
+        ...providerMetadata(err),
+    };
+}
+function recoveryHintProperty(err) {
+    if (!(err instanceof Error))
+        return undefined;
+    const recoveryHint = err['recoveryHint'];
+    return typeof recoveryHint === 'string' && recoveryHint.length > 0 ? recoveryHint : undefined;
+}
+/**
+ * Normalize any provider throw at the invocation boundary. Existing structured
+ * errors retain identity; legacy Totem/provider errors remain available as the
+ * cause and keep their recovery hint while gaining typed attempt evidence.
+ */
+export function toOrchestratorInvokeError(args) {
+    if (args.err instanceof OrchestratorInvokeError)
+        return args.err;
+    const attempt = failedRuntimeAttempt(args.provider, args.model, args.route, args.durationMs, args.err);
+    const message = args.err instanceof Error
+        ? args.err.message
+        : `Invocation failed for '${args.provider}' with a non-Error rejection.`;
+    const recoveryHint = recoveryHintProperty(args.err);
+    return new OrchestratorInvokeError(message, attempt.failureKind ?? 'unknown', [attempt], {
+        cause: args.err,
+        ...(recoveryHint !== undefined ? { recoveryHint } : {}),
+    });
+}
+function resequenceAttempts(attempts) {
+    return attempts.map((attempt, index) => ({ ...attempt, sequence: index + 1 }));
+}
 // ─── Package manager detection (#236) ───────────────
 /**
  * Detect the active package manager from the `npm_config_user_agent` env var
@@ -23,6 +245,10 @@ export function detectPackageManager() {
 export function isQuotaError(err) {
     if (!(err instanceof Error))
         return false;
+    if (err.name === 'QuotaError')
+        return true;
+    if ('kind' in err && err.kind === 'quota')
+        return true;
     if ('status' in err && err.status === 429)
         return true;
     const msg = err.message.toLowerCase();
@@ -111,9 +337,9 @@ export function resolveOrchestrator(rawModel, baseProvider, baseInvoke) {
 }
 // ─── CLI fallback infrastructure ─────────────────────
 /** Map provider names to their CLI command templates. {file} and {model} are replaced at runtime. */
-const CLI_FALLBACK_COMMANDS = {
+export const CLI_FALLBACK_COMMANDS = {
     gemini: 'gemini -e none -m {model} < {file}',
-    anthropic: 'claude -p {file} --model {model}',
+    anthropic: 'claude -p --model {model} < {file}',
 };
 /** Check if a CLI binary is available on PATH. */
 async function isCliAvailable(binary) {
@@ -166,19 +392,56 @@ function withCliFallback(provider, sdkInvoker) {
     if (!binary || !command)
         return sdkInvoker;
     return async (opts) => {
+        const sdkStartMs = Date.now();
         try {
             return await sdkInvoker(opts);
         }
         catch (err) {
-            if (!isFallbackEligible(err))
-                throw err;
-            if (!(await isCliAvailable(binary))) {
-                const msg = err instanceof Error ? err.message : String(err);
-                throw new TotemOrchestratorError(`CLI fallback for '${provider}' unavailable: '${binary}' not found on PATH. Original error: ${msg}`, `Install the ${provider} CLI or its SDK to use this provider.`, err);
+            const sdkAttempt = failedRuntimeAttempt(provider, opts.model, 'sdk', Date.now() - sdkStartMs, err);
+            if (!isFallbackEligible(err)) {
+                const recoveryHint = recoveryHintProperty(err);
+                throw new OrchestratorInvokeError(err instanceof Error ? err.message : `Invocation failed for '${provider}'.`, sdkAttempt.failureKind ?? 'unknown', [sdkAttempt], {
+                    cause: err,
+                    ...(recoveryHint !== undefined ? { recoveryHint } : {}),
+                });
+            }
+            const cliProbeStartMs = Date.now();
+            const cliAvailable = await isCliAvailable(binary);
+            const cliProbeDurationMs = Date.now() - cliProbeStartMs;
+            if (!cliAvailable) {
+                const cliUnavailable = new Error(`[Totem Error] '${binary}' not found on PATH.`);
+                const cliAttempt = failedRuntimeAttempt(provider, opts.model, 'cli-fallback', cliProbeDurationMs, cliUnavailable, { spawnFailed: true });
+                throw new OrchestratorInvokeError(`CLI fallback for '${provider}' unavailable: '${binary}' not found on PATH.`, 'process-spawn', resequenceAttempts([sdkAttempt, cliAttempt]), {
+                    cause: err,
+                    recoveryHint: `Install the ${provider} CLI or its SDK to use this provider.`,
+                });
             }
             const { log } = await import('../ui.js');
             log.warn(opts.tag, `SDK unavailable, falling back to ${binary} CLI...`);
-            return invokeShellOrchestrator({ ...opts, command });
+            try {
+                const result = await invokeShellOrchestrator({
+                    ...opts,
+                    command,
+                    provider,
+                    route: 'cli-fallback',
+                });
+                return {
+                    ...result,
+                    attempts: resequenceAttempts([sdkAttempt, ...(result.attempts ?? [])]),
+                };
+            }
+            catch (fallbackErr) {
+                const fallbackAttempts = fallbackErr instanceof OrchestratorInvokeError
+                    ? fallbackErr.attempts
+                    : [failedRuntimeAttempt(provider, opts.model, 'cli-fallback', 0, fallbackErr)];
+                const attempts = resequenceAttempts([sdkAttempt, ...fallbackAttempts]);
+                const kind = fallbackErr instanceof OrchestratorInvokeError
+                    ? fallbackErr.kind
+                    : (attempts.at(-1)?.failureKind ?? 'unknown');
+                throw new OrchestratorInvokeError(fallbackErr instanceof Error
+                    ? fallbackErr.message
+                    : `CLI fallback failed for '${provider}'.`, kind, attempts, { cause: fallbackErr });
+            }
         }
     };
 }
@@ -192,7 +455,12 @@ function withCliFallback(provider, sdkInvoker) {
 export function createOrchestrator(config) {
     switch (config.provider) {
         case 'shell':
-            return (opts) => invokeShellOrchestrator({ ...opts, command: config.command });
+            return (opts) => invokeShellOrchestrator({
+                ...opts,
+                command: config.command,
+                provider: 'shell',
+                route: 'configured-shell',
+            });
         case 'gemini':
             return withCliFallback('gemini', async (opts) => {
                 const { invokeGeminiOrchestrator } = await import('./gemini-orchestrator.js');

package/dist/orchestrators/orchestrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/orchestrators/orchestrator.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAExE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAsFlE,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,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAE7F;;;;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;AAErC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,gBAAgB,CACxB,uBAAuB,QAAQ,mIAAmI,EAClK,+EAA+E,EAC/E,gBAAgB,CACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,YAAoB,EACpB,UAA8B;IAE9B,yEAAyE;IACzE,0EAA0E;IAC1E,gBAAgB;IAChB,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAE/B,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,gBAAgB,CACxB,4CAA4C,YAAY,wFAAwF,EAChJ,iFAAiF,EACjF,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,yEAAyE;IACzE,uEAAuE;IACvE,wEAAwE;IACxE,0EAA0E;IAC1E,8BAA8B;IAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,gBAAgB,CACxB,0BAA0B,QAAQ,gEAAgE,EAClG,qGAAqG,EACrG,gBAAgB,CACjB,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,qGAAqG;AACrG,MAAM,qBAAqB,GAA2B;IACpD,MAAM,EAAE,oCAAoC;IAC5C,SAAS,EAAE,kCAAkC;CAC9C,CAAC;AAEF,kDAAkD;AAClD,KAAK,UAAU,cAAc,CAAC,MAAc;IAC1C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EAAE,IAAI,CAAC,CAAC;QACT,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACrB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uCAAuC;AACvC,MAAM,YAAY,GAA2B;IAC3C,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,QAAQ;CACpB,CAAC;AAEF;;;GAGG;AACH,SAAS,kBAAkB,CAAC,GAAY;IACtC,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,CACL,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAChC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACjC,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACjC,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CACnC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,QAAgB,EAAE,UAA8B;IACvE,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAEhD,+DAA+D;IAC/D,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO;QAAE,OAAO,UAAU,CAAC;IAE3C,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC;gBAAE,MAAM,GAAG,CAAC;YAExC,IAAI,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBACpC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,MAAM,IAAI,sBAAsB,CAC9B,qBAAqB,QAAQ,mBAAmB,MAAM,wCAAwC,GAAG,EAAE,EACnG,eAAe,QAAQ,uCAAuC,EAC9D,GAAG,CACJ,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YACzC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oCAAoC,MAAM,SAAS,CAAC,CAAC;YACxE,OAAO,uBAAuB,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,wDAAwD;AAExD;;;;;GAKG;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,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC9C,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;gBAC9E,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;QACL,KAAK,WAAW;YACd,OAAO,eAAe,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACjD,MAAM,EAAE,2BAA2B,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;gBACpF,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;QACL,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,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,CAAC,CAAC;QACJ,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;oBAC9B,GAAG,IAAI;oBACP,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB,CAAC,CAAC;YACL,CAAC,CAAC;IACN,CAAC;AACH,CAAC"}
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/orchestrators/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/orchestrators/orchestrator.test.js

@@ -1,5 +1,18 @@
+import { EventEmitter } from 'node:events';
 import { afterEach, describe, expect, it, vi } from 'vitest';
-import { createOrchestrator, detectPackageManager, isQuotaError, parseModelString, resolveOrchestrator, } from './orchestrator.js';
+import { TotemOrchestratorError } from '@mmnto/totem';
+import { classifyInvokeFailure, CLI_FALLBACK_COMMANDS, createOrchestrator, detectPackageManager, isQuotaError, OrchestratorInvokeError, parseModelString, resolveOrchestrator, toOrchestratorInvokeError, } from './orchestrator.js';
+const { mockShellInvoke, mockSpawn } = vi.hoisted(() => ({
+    mockShellInvoke: vi.fn(),
+    mockSpawn: vi.fn(),
+}));
+vi.mock('node:child_process', async (importOriginal) => ({
+    ...(await importOriginal()),
+    spawn: mockSpawn,
+}));
+vi.mock('./shell-orchestrator.js', () => ({
+    invokeShellOrchestrator: mockShellInvoke,
+}));
 // ─── Mock provider modules ──────────────────────────
 vi.mock('./gemini-orchestrator.js', () => ({
     invokeGeminiOrchestrator: vi.fn().mockResolvedValue({
@@ -101,6 +114,10 @@ describe('createOrchestrator', () => {
 });
 // ─── CLI fallback ───────────────────────────────────
 describe('withCliFallback (via createOrchestrator)', () => {
+    it('pins Anthropic CLI fallback to prompt bytes on stdin', () => {
+        expect(CLI_FALLBACK_COMMANDS['anthropic']).toBe('claude -p --model {model} < {file}');
+        expect(CLI_FALLBACK_COMMANDS['anthropic']).not.toMatch(/-p\s+\{file\}/);
+    });
     it('gemini SDK success does not trigger fallback', async () => {
         const config = { provider: 'gemini' };
         const invoke = createOrchestrator(config);
@@ -126,13 +143,232 @@ describe('withCliFallback (via createOrchestrator)', () => {
         });
         expect(result.content).toBe('anthropic result');
     });
-    it('non-fallback-eligible errors are re-thrown', async () => {
+    it('preserves the failed SDK attempt before a successful CLI fallback', async () => {
+        const { invokeAnthropicOrchestrator } = await import('./anthropic-orchestrator.js');
+        vi.mocked(invokeAnthropicOrchestrator).mockRejectedValueOnce(new Error('No Anthropic API key found'));
+        const availability = new EventEmitter();
+        availability.kill = vi.fn();
+        mockSpawn.mockImplementationOnce(() => {
+            process.nextTick(() => availability.emit('close', 0));
+            return availability;
+        });
+        mockShellInvoke.mockResolvedValueOnce({
+            content: 'fallback result',
+            inputTokens: null,
+            outputTokens: null,
+            durationMs: 20,
+            attempts: [
+                {
+                    sequence: 1,
+                    route: 'cli-fallback',
+                    provider: 'anthropic',
+                    model: 'claude-sonnet-5',
+                    status: 'succeeded',
+                    durationMs: 20,
+                },
+            ],
+        });
+        const invoke = createOrchestrator({ provider: 'anthropic' });
+        const result = await invoke({
+            prompt: 'test',
+            model: 'claude-sonnet-5',
+            cwd: '.',
+            tag: 'Test',
+            totemDir: '.totem',
+        });
+        expect(mockShellInvoke).toHaveBeenCalledWith(expect.objectContaining({
+            command: 'claude -p --model {model} < {file}',
+            provider: 'anthropic',
+            route: 'cli-fallback',
+        }));
+        expect(result.attempts).toEqual([
+            expect.objectContaining({
+                sequence: 1,
+                route: 'sdk',
+                status: 'failed',
+                failureKind: 'auth',
+            }),
+            expect.objectContaining({
+                sequence: 2,
+                route: 'cli-fallback',
+                status: 'succeeded',
+            }),
+        ]);
+    });
+    it('preserves both attempts when the CLI fallback also fails', async () => {
+        const { invokeGeminiOrchestrator } = await import('./gemini-orchestrator.js');
+        vi.mocked(invokeGeminiOrchestrator).mockRejectedValueOnce(new Error('No Gemini API key found'));
+        const availability = new EventEmitter();
+        availability.kill = vi.fn();
+        mockSpawn.mockImplementationOnce(() => {
+            process.nextTick(() => availability.emit('close', 0));
+            return availability;
+        });
+        const fallbackAttempt = {
+            sequence: 1,
+            route: 'cli-fallback',
+            provider: 'gemini',
+            model: 'gemini-3-pro',
+            status: 'failed',
+            durationMs: 30,
+            failureKind: 'timeout',
+        };
+        mockShellInvoke.mockRejectedValueOnce(new OrchestratorInvokeError('fallback timed out', 'timeout', [fallbackAttempt]));
+        const invoke = createOrchestrator({ provider: 'gemini' });
+        const err = await invoke({
+            prompt: 'test',
+            model: 'gemini-3-pro',
+            cwd: '.',
+            tag: 'Test',
+            totemDir: '.totem',
+        }).catch((cause) => cause);
+        expect(err).toBeInstanceOf(OrchestratorInvokeError);
+        expect(err).toMatchObject({ kind: 'timeout' });
+        expect(err.attempts).toEqual([
+            expect.objectContaining({ sequence: 1, route: 'sdk', status: 'failed' }),
+            expect.objectContaining({
+                sequence: 2,
+                route: 'cli-fallback',
+                status: 'failed',
+                failureKind: 'timeout',
+            }),
+        ]);
+    });
+    it('preserves the structured CLI install recovery contract when fallback is unavailable', async () => {
+        const { invokeAnthropicOrchestrator } = await import('./anthropic-orchestrator.js');
+        vi.mocked(invokeAnthropicOrchestrator).mockRejectedValueOnce(new Error('No Anthropic API key found'));
+        let nowMs = 1_000;
+        const dateNow = vi.spyOn(Date, 'now').mockImplementation(() => nowMs);
+        const availability = new EventEmitter();
+        availability.kill = vi.fn();
+        mockSpawn.mockImplementationOnce(() => {
+            process.nextTick(() => {
+                nowMs += 75;
+                availability.emit('close', 1);
+            });
+            return availability;
+        });
+        const invoke = createOrchestrator({ provider: 'anthropic' });
+        const err = await invoke({
+            prompt: 'test',
+            model: 'claude-sonnet-5',
+            cwd: '.',
+            tag: 'Test',
+            totemDir: '.totem',
+        }).catch((cause) => cause);
+        dateNow.mockRestore();
+        expect(err).toBeInstanceOf(OrchestratorInvokeError);
+        expect(err).toMatchObject({
+            code: 'ORCHESTRATOR_UNAVAILABLE',
+            kind: 'process-spawn',
+            recoveryHint: 'Install the anthropic CLI or its SDK to use this provider.',
+            attempts: [
+                expect.objectContaining({ sequence: 1, route: 'sdk' }),
+                expect.objectContaining({ sequence: 2, route: 'cli-fallback', durationMs: 75 }),
+            ],
+        });
+    });
+    it('preserves recovery guidance on non-fallback-eligible errors', async () => {
         // Override the mock to throw a non-eligible error
         const { invokeGeminiOrchestrator } = await import('./gemini-orchestrator.js');
-        vi.mocked(invokeGeminiOrchestrator).mockRejectedValueOnce(new Error('Gemini API call failed: model not found'));
+        const sdkErr = Object.assign(new Error('Gemini API call failed: model not found'), {
+            recoveryHint: 'Select a Gemini model available to this account.',
+        });
+        vi.mocked(invokeGeminiOrchestrator).mockRejectedValueOnce(sdkErr);
         const config = { provider: 'gemini' };
         const invoke = createOrchestrator(config);
-        await expect(invoke({ prompt: 'test', model: 'bad-model', cwd: '.', tag: 'Test', totemDir: '.totem' })).rejects.toThrow('model not found');
+        const rejection = invoke({
+            prompt: 'test',
+            model: 'bad-model',
+            cwd: '.',
+            tag: 'Test',
+            totemDir: '.totem',
+        });
+        await expect(rejection).rejects.toThrow('model not found');
+        await expect(rejection).rejects.toMatchObject({
+            name: 'OrchestratorInvokeError',
+            kind: 'model',
+            cause: sdkErr,
+            recoveryHint: 'Select a Gemini model available to this account.',
+            attempts: [
+                expect.objectContaining({
+                    sequence: 1,
+                    route: 'sdk',
+                    status: 'failed',
+                    failureKind: 'model',
+                }),
+            ],
+        });
+    });
+});
+describe('classifyInvokeFailure', () => {
+    it('uses deterministic timeout and spawn precedence', () => {
+        expect(classifyInvokeFailure(new Error('quota exceeded'), { timedOut: true })).toBe('timeout');
+        expect(classifyInvokeFailure(new Error('quota exceeded'), { spawnFailed: true })).toBe('process-spawn');
+    });
+    it('prefers structured provider metadata over generic prose', () => {
+        expect(classifyInvokeFailure(Object.assign(new Error('request failed'), { status: 429 }))).toBe('quota');
+        expect(classifyInvokeFailure(Object.assign(new Error('request failed'), { status: 401 }))).toBe('auth');
+        expect(classifyInvokeFailure(Object.assign(new Error('request failed'), { code: 'model_not_found' }))).toBe('model');
+    });
+    it('prefers structured auth/model metadata over conflicting quota prose', () => {
+        expect(classifyInvokeFailure(Object.assign(new Error('quota exhausted'), { status: 401 }))).toBe('auth');
+        expect(classifyInvokeFailure(Object.assign(new Error('rate limit exceeded'), { code: 'model_not_found' }))).toBe('model');
+        expect(classifyInvokeFailure(Object.assign(new Error('authentication failed'), { status: 429 }))).toBe('quota');
+    });
+    it('reads structured provider metadata through wrapped Error causes', () => {
+        const providerErr = Object.assign(new Error('provider rejected request'), {
+            status: 401,
+            code: 'authentication_error',
+        });
+        const wrapped = new TotemOrchestratorError('outer message mentions quota', 'keep the provider-specific recovery', providerErr);
+        expect(classifyInvokeFailure(wrapped)).toBe('auth');
+        const normalized = toOrchestratorInvokeError({
+            err: wrapped,
+            provider: 'openai',
+            model: 'gpt-5',
+            route: 'sdk',
+            durationMs: 12,
+        });
+        expect(normalized).toBeInstanceOf(TotemOrchestratorError);
+        expect(normalized.cause).toBe(wrapped);
+        expect(normalized.recoveryHint).toBe('keep the provider-specific recovery');
+        expect(normalized.attempts[0]).toMatchObject({
+            failureKind: 'auth',
+            providerStatus: 401,
+            providerCode: 'authentication_error',
+            durationMs: 12,
+        });
+    });
+    it('bounds cause traversal and terminates safely on cause cycles', () => {
+        const first = new Error('first');
+        const second = Object.assign(new Error('second'), { code: 'model_not_found', cause: first });
+        Object.assign(first, { cause: second });
+        expect(classifyInvokeFailure(first)).toBe('model');
+        let beyondDepth = Object.assign(new Error('provider'), { status: 429 });
+        for (let index = 0; index < 8; index++) {
+            beyondDepth = new Error(`wrapper-${index}`, { cause: beyondDepth });
+        }
+        expect(classifyInvokeFailure(beyondDepth)).toBe('unknown');
+    });
+    it('distinguishes process exit and preserves unknown', () => {
+        expect(classifyInvokeFailure(new Error('failed'), { exitCode: 2, signal: null })).toBe('process-exit');
+        expect(classifyInvokeFailure(new Error('unclassified provider response'))).toBe('unknown');
+    });
+    it('keeps quota name compatibility on the structured error', () => {
+        const err = new OrchestratorInvokeError('provider rejected the request', 'quota', []);
+        expect(err).toBeInstanceOf(OrchestratorInvokeError);
+        expect(err.name).toBe('QuotaError');
+        expect(isQuotaError(err)).toBe(true);
+        expect(err.code).toBe('ORCHESTRATOR_UNAVAILABLE');
+        expect(err.recoveryHint).toContain('fallbackModel');
+    });
+    it('normalizes duplicate Totem prefixes and bounds recovery hints', () => {
+        const err = new OrchestratorInvokeError('[Totem Error] [Totem Error] failed', 'unknown', [], {
+            recoveryHint: 'x'.repeat(2_000),
+        });
+        expect(err.message).toBe('[Totem Error] failed');
+        expect(Buffer.byteLength(err.recoveryHint, 'utf8')).toBeLessThanOrEqual(1_024);
     });
 });
 // ─── detectPackageManager ───────────────────────────