@dzhechkov/harness-core 0.3.98 → 0.3.100

package/src/feature-adr-routing.ts

@@ -189,6 +189,9 @@ export const KNOWN_CODEX: Record<string, number> = { auto: 1, 'gpt-5.5': 1, 'gpt
 /** The Claude model names the Workflow runtime accepts as `agent()` `model`. */
 export const CLAUDE_NAMES: Record<string, number> = { fable: 1, opus: 1, sonnet: 1, haiku: 1 };
 
+/** The codex-companion `--effort` vocabulary; a spec's `<reasoning>` is clamped to this (unknown ⇒ 'high'). */
+export const VALID_REASONING: Record<string, number> = { none: 1, minimal: 1, low: 1, medium: 1, high: 1, xhigh: 1 };
+
 /**
  * The proven DEFAULT TABLE, applied only when the user opts into routing.
  * `code`/`qe` are `null` SENTINELS: their defaults are DERIVED (the coder knob /
@@ -228,7 +231,13 @@ export function specToOpts(spec: string | null | undefined, env: RoutingEnv): St
       log('models: unknown codex id ' + id + ' — using ' + env.CODEX_MODEL);
       id = env.CODEX_MODEL;
     }
-    const reasoning = parts[2] || 'high';
+    let reasoning = parts[2] || 'high';
+    // Clamp to the codex-companion --effort vocabulary so a bad token (e.g. `codex:gpt-5.6:banana`)
+    // can't silently reach the runtime as `--effort banana` (QE LOW). Unknown ⇒ 'high'.
+    if (!VALID_REASONING[reasoning]) {
+      log('models: unknown reasoning ' + reasoning + ' — using high');
+      reasoning = 'high';
+    }
     return { agentType: 'codex:codex-rescue', codexModel: id, _reasoning: reasoning };
   }
   if (CLAUDE_NAMES[head]) return { model: head };
@@ -350,6 +359,19 @@ export function needsLandedBarrier(opts: StageOpts | null | undefined): boolean
   return !!(opts && opts.agentType === 'codex:codex-rescue');
 }
 
+/**
+ * The per-call Codex effort hint. Codex-rescue maps this prompt instruction to
+ * `codex-companion.mjs task --effort <reasoning>`, so the resolved per-stage `_reasoning`
+ * is no longer only a `modelsUsed` label. Non-Codex stages return an empty string, preserving
+ * the routing-off and Claude-stage prompt text exactly.
+ */
+export function codexEffortHint(opts: StageOpts | null | undefined): string {
+  if (opts && opts.agentType === 'codex:codex-rescue' && opts._reasoning) {
+    return ' (If you are the Codex runtime, run at --effort ' + opts._reasoning + '.)';
+  }
+  return '';
+}
+
 // ── Step-7.5 CODE landed barrier (Codex out-of-band write flush) ────────────
 
 export const DEFAULT_CODE_LANDING_MAX_WAIT_MS = 120_000;

package/src/index.ts

@@ -184,10 +184,12 @@ export {
   DEFAULT_MODELS,
   KNOWN_CODEX,
   CLAUDE_NAMES,
+  VALID_REASONING,
   topCodexId,
   decideUsageAction,
   OVERRIDE_REASONING,
   needsLandedBarrier,
+  codexEffortHint,
   modelLabel,
   stageLabel,
   needsCodeLandedBarrier,
@@ -196,5 +198,25 @@ export {
   CODE_LANDED_BARRIER_SLEEPS_SECONDS,
 } from './feature-adr-routing.js';
 export type { StageOpts, RoutingEnv, UsageSignal, UsageAction } from './feature-adr-routing.js';
-export { computeUsage, readUsageLimits } from './usage.js';
-export type { UsageEstimate, UsageLimits } from './usage.js';
+export {
+  CLAUDE_USAGE_MODELS,
+  computeUsage,
+  deriveUsageCalibration,
+  fixedBlockWindowFor,
+  normalizeClaudeUsageModel,
+  normalizeClaudeUsageModelKey,
+  parseWeeklyResetAnchor,
+  readUsageLimits,
+  weeklyWindowFor,
+} from './usage.js';
+export type {
+  ClaudeUsageModel,
+  UsageCalibrationChange,
+  UsageCalibrationInput,
+  UsageCalibrationPlan,
+  UsageEstimate,
+  UsageLimits,
+  UsageModelEstimate,
+  UsageWindow,
+  WeeklyResetAnchor,
+} from './usage.js';