thoth-agents 0.2.6 → 0.2.8

package/dist/{chunk-76DARQOT.js → chunk-YLRPDTU7.js}

@@ -47,6 +47,9 @@ function getLiteConfig() {
 function getLiteConfigJsonc() {
   return join(getConfigDir(), "thoth-agents.jsonc");
 }
+function getOpenCodeManagedModelStatePath() {
+  return join(getConfigDir(), ".thoth-agents-managed-models.json");
+}
 function getExistingLiteConfigPath() {
   const jsonPath = getLiteConfig();
   if (existsSync(jsonPath)) return jsonPath;
@@ -74,17 +77,240 @@ function ensureOpenCodeConfigDir() {
   }
 }
 
+// src/config/constants.ts
+var AGENT_ALIASES = {
+  explore: "explorer",
+  "frontend-ui-ux-engineer": "designer"
+};
+var SUBAGENT_NAMES = [
+  "explorer",
+  "librarian",
+  "oracle",
+  "designer",
+  "quick",
+  "deep"
+];
+var ORCHESTRATOR_NAME = "orchestrator";
+var ALL_AGENT_NAMES = [
+  ORCHESTRATOR_NAME,
+  "explorer",
+  "librarian",
+  "oracle",
+  "designer",
+  "quick",
+  "deep"
+];
+var DEFAULT_MODELS = {
+  orchestrator: void 0,
+  oracle: "openai/gpt-5.4",
+  librarian: "openai/gpt-5.4-mini",
+  explorer: "openai/gpt-5.4-mini",
+  designer: "openai/gpt-5.4-mini",
+  quick: "openai/gpt-5.4-mini",
+  deep: "openai/gpt-5.4"
+};
+var CONFIRMED_OPENAI_SUBAGENT_PRESET = {
+  oracle: { model: "gpt-5.6-sol", effort: "high" },
+  librarian: { model: "gpt-5.6-luna", effort: "low" },
+  explorer: { model: "gpt-5.6-luna", effort: "low" },
+  designer: { model: "gpt-5.6-terra", effort: "high" },
+  quick: { model: "gpt-5.6-luna", effort: "medium" },
+  deep: { model: "gpt-5.6-terra", effort: "xhigh" }
+};
+var POLL_INTERVAL_BACKGROUND_MS = 2e3;
+var DEFAULT_TIMEOUT_MS = 2 * 60 * 1e3;
+var MAX_POLL_TIME_MS = 5 * 60 * 1e3;
+var DEFAULT_THOTH_COMMAND = ["npx", "-y", "thoth-mem", "mcp"];
+
+// src/config/schema.ts
+import { z } from "zod";
+var AGENT_NAMES = [
+  "orchestrator",
+  "oracle",
+  "designer",
+  "explorer",
+  "librarian",
+  "quick",
+  "deep"
+];
+var FALLBACK_AGENT_NAMES = [...AGENT_NAMES];
+var MANUAL_AGENT_NAMES = [...AGENT_NAMES];
+var ProviderModelIdSchema = z.string().regex(
+  /^[^/\s]+\/[^\s]+$/,
+  "Expected provider/model format (provider/.../model)"
+);
+var ManualAgentPlanSchema = z.object({
+  primary: ProviderModelIdSchema,
+  fallback1: ProviderModelIdSchema,
+  fallback2: ProviderModelIdSchema,
+  fallback3: ProviderModelIdSchema
+}).superRefine((value, ctx) => {
+  const unique = /* @__PURE__ */ new Set([
+    value.primary,
+    value.fallback1,
+    value.fallback2,
+    value.fallback3
+  ]);
+  if (unique.size !== 4) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "primary and fallbacks must be unique per agent"
+    });
+  }
+});
+var ManualPlanSchema = z.object({
+  orchestrator: ManualAgentPlanSchema,
+  oracle: ManualAgentPlanSchema,
+  designer: ManualAgentPlanSchema,
+  explorer: ManualAgentPlanSchema,
+  librarian: ManualAgentPlanSchema,
+  quick: ManualAgentPlanSchema,
+  deep: ManualAgentPlanSchema
+}).strict();
+var AgentModelChainSchema = z.array(z.string()).min(1);
+var FallbackChainsSchema = z.object({
+  orchestrator: AgentModelChainSchema.optional(),
+  oracle: AgentModelChainSchema.optional(),
+  designer: AgentModelChainSchema.optional(),
+  explorer: AgentModelChainSchema.optional(),
+  librarian: AgentModelChainSchema.optional(),
+  quick: AgentModelChainSchema.optional(),
+  deep: AgentModelChainSchema.optional()
+}).catchall(AgentModelChainSchema);
+var AgentOverrideConfigSchema = z.object({
+  model: z.union([
+    z.string(),
+    z.array(
+      z.union([
+        z.string(),
+        z.object({
+          id: z.string(),
+          variant: z.string().optional()
+        })
+      ])
+    )
+  ]).optional(),
+  temperature: z.number().min(0).max(2).optional(),
+  steps: z.number().int().min(1).optional(),
+  variant: z.string().optional().catch(void 0)
+});
+var TmuxLayoutSchema = z.enum([
+  "main-horizontal",
+  // Main pane on top, agents stacked below
+  "main-vertical",
+  // Main pane on left, agents stacked on right
+  "tiled",
+  // All panes equal size grid
+  "even-horizontal",
+  // All panes side by side
+  "even-vertical"
+  // All panes stacked vertically
+]);
+var TmuxConfigSchema = z.object({
+  enabled: z.boolean().default(false),
+  layout: TmuxLayoutSchema.default("main-vertical"),
+  main_pane_size: z.number().min(20).max(80).default(60)
+  // percentage for main pane
+});
+var PresetSchema = z.record(z.string(), AgentOverrideConfigSchema);
+var AgentNameSchema = z.enum(AGENT_NAMES);
+var McpNameSchema = z.enum([
+  "exa",
+  "context7",
+  "grep_app",
+  "thoth_mem"
+]);
+var ThothConfigSchema = z.object({
+  command: z.array(z.string()).optional(),
+  data_dir: z.string().optional(),
+  environment: z.record(z.string(), z.string()).optional(),
+  timeout: z.number().optional(),
+  http_port: z.number().optional()
+});
+var ArtifactStoreModeSchema = z.enum([
+  "thoth-mem",
+  "openspec",
+  "hybrid"
+]);
+var ArtifactStoreConfigSchema = z.object({
+  mode: ArtifactStoreModeSchema.default("hybrid")
+});
+var CodexGenerationConfigSchema = z.object({
+  enabled: z.boolean().default(false),
+  outputRoot: z.string().optional(),
+  dryRun: z.boolean().default(true)
+});
+var ClaudeCodeGenerationConfigSchema = z.object({
+  enabled: z.boolean().default(false),
+  outputRoot: z.string().optional(),
+  dryRun: z.boolean().default(true)
+});
+var FailoverConfigSchema = z.object({
+  enabled: z.boolean().default(true),
+  timeoutMs: z.number().min(0).default(15e3),
+  retryDelayMs: z.number().min(0).default(500),
+  chains: FallbackChainsSchema.default({})
+});
+var PluginConfigSchema = z.object({
+  $schema: z.string().optional(),
+  preset: z.string().optional(),
+  setDefaultAgent: z.boolean().optional(),
+  scoringEngineVersion: z.enum(["v1", "v2-shadow", "v2"]).optional(),
+  balanceProviderUsage: z.boolean().optional(),
+  manualPlan: ManualPlanSchema.optional(),
+  presets: z.record(z.string(), PresetSchema).optional(),
+  agents: z.record(z.string(), AgentOverrideConfigSchema).optional(),
+  disabled_mcps: z.array(z.string()).optional(),
+  tmux: TmuxConfigSchema.optional(),
+  fallback: FailoverConfigSchema.optional(),
+  thoth: ThothConfigSchema.optional(),
+  artifactStore: ArtifactStoreConfigSchema.optional(),
+  codex: CodexGenerationConfigSchema.optional(),
+  claudeCode: ClaudeCodeGenerationConfigSchema.optional()
+});
+
+// src/config/utils.ts
+function getAgentOverride(config, name) {
+  const overrides = config?.agents ?? {};
+  return overrides[name] ?? overrides[Object.keys(AGENT_ALIASES).find((k) => AGENT_ALIASES[k] === name) ?? ""];
+}
+function getPrimaryModelId(model) {
+  if (Array.isArray(model)) {
+    const first = model[0];
+    return typeof first === "string" ? first : first?.id;
+  }
+  return model;
+}
+
 // src/cli/providers.ts
 var THOTH_AGENTS_CONFIG_SCHEMA_URL = "https://unpkg.com/thoth-agents@latest/thoth-agents.schema.json";
 var MODEL_MAPPINGS = {
   openai: {
     orchestrator: { model: "openai/gpt-5.4" },
-    oracle: { model: "openai/gpt-5.4", variant: "high" },
-    librarian: { model: "openai/gpt-5.4-mini", variant: "low" },
-    explorer: { model: "openai/gpt-5.4-mini", variant: "low" },
-    designer: { model: "openai/gpt-5.4-mini", variant: "medium" },
-    quick: { model: "openai/gpt-5.4-mini", variant: "low" },
-    deep: { model: "openai/gpt-5.4", variant: "high" }
+    oracle: {
+      model: `openai/${CONFIRMED_OPENAI_SUBAGENT_PRESET.oracle.model}`,
+      variant: CONFIRMED_OPENAI_SUBAGENT_PRESET.oracle.effort
+    },
+    librarian: {
+      model: `openai/${CONFIRMED_OPENAI_SUBAGENT_PRESET.librarian.model}`,
+      variant: CONFIRMED_OPENAI_SUBAGENT_PRESET.librarian.effort
+    },
+    explorer: {
+      model: `openai/${CONFIRMED_OPENAI_SUBAGENT_PRESET.explorer.model}`,
+      variant: CONFIRMED_OPENAI_SUBAGENT_PRESET.explorer.effort
+    },
+    designer: {
+      model: `openai/${CONFIRMED_OPENAI_SUBAGENT_PRESET.designer.model}`,
+      variant: CONFIRMED_OPENAI_SUBAGENT_PRESET.designer.effort
+    },
+    quick: {
+      model: `openai/${CONFIRMED_OPENAI_SUBAGENT_PRESET.quick.model}`,
+      variant: CONFIRMED_OPENAI_SUBAGENT_PRESET.quick.effort
+    },
+    deep: {
+      model: `openai/${CONFIRMED_OPENAI_SUBAGENT_PRESET.deep.model}`,
+      variant: CONFIRMED_OPENAI_SUBAGENT_PRESET.deep.effort
+    }
   },
   kimi: {
     orchestrator: { model: "kimi-for-coding/k2p5" },
@@ -341,153 +567,6 @@ function detectCurrentConfig() {
   return result;
 }
 
-// src/config/schema.ts
-import { z } from "zod";
-var AGENT_NAMES = [
-  "orchestrator",
-  "oracle",
-  "designer",
-  "explorer",
-  "librarian",
-  "quick",
-  "deep"
-];
-var FALLBACK_AGENT_NAMES = [...AGENT_NAMES];
-var MANUAL_AGENT_NAMES = [...AGENT_NAMES];
-var ProviderModelIdSchema = z.string().regex(
-  /^[^/\s]+\/[^\s]+$/,
-  "Expected provider/model format (provider/.../model)"
-);
-var ManualAgentPlanSchema = z.object({
-  primary: ProviderModelIdSchema,
-  fallback1: ProviderModelIdSchema,
-  fallback2: ProviderModelIdSchema,
-  fallback3: ProviderModelIdSchema
-}).superRefine((value, ctx) => {
-  const unique = /* @__PURE__ */ new Set([
-    value.primary,
-    value.fallback1,
-    value.fallback2,
-    value.fallback3
-  ]);
-  if (unique.size !== 4) {
-    ctx.addIssue({
-      code: z.ZodIssueCode.custom,
-      message: "primary and fallbacks must be unique per agent"
-    });
-  }
-});
-var ManualPlanSchema = z.object({
-  orchestrator: ManualAgentPlanSchema,
-  oracle: ManualAgentPlanSchema,
-  designer: ManualAgentPlanSchema,
-  explorer: ManualAgentPlanSchema,
-  librarian: ManualAgentPlanSchema,
-  quick: ManualAgentPlanSchema,
-  deep: ManualAgentPlanSchema
-}).strict();
-var AgentModelChainSchema = z.array(z.string()).min(1);
-var FallbackChainsSchema = z.object({
-  orchestrator: AgentModelChainSchema.optional(),
-  oracle: AgentModelChainSchema.optional(),
-  designer: AgentModelChainSchema.optional(),
-  explorer: AgentModelChainSchema.optional(),
-  librarian: AgentModelChainSchema.optional(),
-  quick: AgentModelChainSchema.optional(),
-  deep: AgentModelChainSchema.optional()
-}).catchall(AgentModelChainSchema);
-var AgentOverrideConfigSchema = z.object({
-  model: z.union([
-    z.string(),
-    z.array(
-      z.union([
-        z.string(),
-        z.object({
-          id: z.string(),
-          variant: z.string().optional()
-        })
-      ])
-    )
-  ]).optional(),
-  temperature: z.number().min(0).max(2).optional(),
-  steps: z.number().int().min(1).optional(),
-  variant: z.string().optional().catch(void 0)
-});
-var TmuxLayoutSchema = z.enum([
-  "main-horizontal",
-  // Main pane on top, agents stacked below
-  "main-vertical",
-  // Main pane on left, agents stacked on right
-  "tiled",
-  // All panes equal size grid
-  "even-horizontal",
-  // All panes side by side
-  "even-vertical"
-  // All panes stacked vertically
-]);
-var TmuxConfigSchema = z.object({
-  enabled: z.boolean().default(false),
-  layout: TmuxLayoutSchema.default("main-vertical"),
-  main_pane_size: z.number().min(20).max(80).default(60)
-  // percentage for main pane
-});
-var PresetSchema = z.record(z.string(), AgentOverrideConfigSchema);
-var AgentNameSchema = z.enum(AGENT_NAMES);
-var McpNameSchema = z.enum([
-  "exa",
-  "context7",
-  "grep_app",
-  "thoth_mem"
-]);
-var ThothConfigSchema = z.object({
-  command: z.array(z.string()).optional(),
-  data_dir: z.string().optional(),
-  environment: z.record(z.string(), z.string()).optional(),
-  timeout: z.number().optional(),
-  http_port: z.number().optional()
-});
-var ArtifactStoreModeSchema = z.enum([
-  "thoth-mem",
-  "openspec",
-  "hybrid"
-]);
-var ArtifactStoreConfigSchema = z.object({
-  mode: ArtifactStoreModeSchema.default("hybrid")
-});
-var CodexGenerationConfigSchema = z.object({
-  enabled: z.boolean().default(false),
-  outputRoot: z.string().optional(),
-  dryRun: z.boolean().default(true)
-});
-var ClaudeCodeGenerationConfigSchema = z.object({
-  enabled: z.boolean().default(false),
-  outputRoot: z.string().optional(),
-  dryRun: z.boolean().default(true)
-});
-var FailoverConfigSchema = z.object({
-  enabled: z.boolean().default(true),
-  timeoutMs: z.number().min(0).default(15e3),
-  retryDelayMs: z.number().min(0).default(500),
-  chains: FallbackChainsSchema.default({})
-});
-var PluginConfigSchema = z.object({
-  $schema: z.string().optional(),
-  preset: z.string().optional(),
-  setDefaultAgent: z.boolean().optional(),
-  scoringEngineVersion: z.enum(["v1", "v2-shadow", "v2"]).optional(),
-  balanceProviderUsage: z.boolean().optional(),
-  manualPlan: ManualPlanSchema.optional(),
-  presets: z.record(z.string(), PresetSchema).optional(),
-  agents: z.record(z.string(), AgentOverrideConfigSchema).optional(),
-  disabled_mcps: z.array(z.string()).optional(),
-  tmux: TmuxConfigSchema.optional(),
-  fallback: FailoverConfigSchema.optional(),
-  thoth: ThothConfigSchema.optional(),
-  artifactStore: ArtifactStoreConfigSchema.optional(),
-  codex: CodexGenerationConfigSchema.optional(),
-  claudeCode: ClaudeCodeGenerationConfigSchema.optional()
-});
-
 // src/config/loader.ts
 var PROMPTS_DIR_NAME = "thoth-agents";
 function loadConfigFromPath(configPath) {
@@ -617,56 +696,6 @@ function loadAgentPrompt(agentName, preset) {
   return result;
 }
 
-// src/config/constants.ts
-var AGENT_ALIASES = {
-  explore: "explorer",
-  "frontend-ui-ux-engineer": "designer"
-};
-var SUBAGENT_NAMES = [
-  "explorer",
-  "librarian",
-  "oracle",
-  "designer",
-  "quick",
-  "deep"
-];
-var ORCHESTRATOR_NAME = "orchestrator";
-var ALL_AGENT_NAMES = [
-  ORCHESTRATOR_NAME,
-  "explorer",
-  "librarian",
-  "oracle",
-  "designer",
-  "quick",
-  "deep"
-];
-var DEFAULT_MODELS = {
-  orchestrator: void 0,
-  oracle: "openai/gpt-5.4",
-  librarian: "openai/gpt-5.4-mini",
-  explorer: "openai/gpt-5.4-mini",
-  designer: "openai/gpt-5.4-mini",
-  quick: "openai/gpt-5.4-mini",
-  deep: "openai/gpt-5.4"
-};
-var POLL_INTERVAL_BACKGROUND_MS = 2e3;
-var DEFAULT_TIMEOUT_MS = 2 * 60 * 1e3;
-var MAX_POLL_TIME_MS = 5 * 60 * 1e3;
-var DEFAULT_THOTH_COMMAND = ["npx", "-y", "thoth-mem", "mcp"];
-
-// src/config/utils.ts
-function getAgentOverride(config, name) {
-  const overrides = config?.agents ?? {};
-  return overrides[name] ?? overrides[Object.keys(AGENT_ALIASES).find((k) => AGENT_ALIASES[k] === name) ?? ""];
-}
-function getPrimaryModelId(model) {
-  if (Array.isArray(model)) {
-    const first = model[0];
-    return typeof first === "string" ? first : first?.id;
-  }
-  return model;
-}
-
 // src/agents/prompt-dialects.ts
 var OPENCODE_CAPABILITIES = {
   agentDefinitions: "supported",
@@ -1036,6 +1065,9 @@ function createSubagentRulesSection(memoryAccess = "base") {
     userQuestionConcept: "userQuestion"
   };
 }
+function createReasoningDisciplineSection() {
+  return { kind: "reasoning-discipline" };
+}
 function createResponseBudgetSection() {
   return { kind: "response-budget" };
 }
@@ -1140,6 +1172,9 @@ You are ${role}.
 ${responsibility}
 </responsibility>
 
+`),
+    createReasoningDisciplineSection(),
+    roleText(`
 <rules>`),
     createSubagentRulesSection(memoryAccess),
     roleText(`${rules.join("\n")}
@@ -1163,7 +1198,8 @@ the harness does not name this agent "orchestrator".
 <style>
 Respond in the user's language. Be warm, direct, evidence-led, and concise.
 Push back when context, risk, or assumptions are weak. Avoid verbosity.
-</style>
+</style>`),
+    roleText(`
 
 <core-rules>
 - Mode: primary coordinator. Mutation: coordination artifacts only.
@@ -1183,10 +1219,11 @@ Push back when context, risk, or assumptions are weak. Avoid verbosity.
 </core-rules>
 
 <epistemic-rigor>
-- Verify material user or agent claims before relying on them when they affect implementation, architecture, verification, safety, or guidance.
-- Use the cheapest reliable evidence: bounded direct check, delegated local discovery, or authoritative external documentation.
-- If evidence disproves a user or agent assumption, correct it plainly with the evidence, explain relevant tradeoffs, and offer viable alternatives.
-- Allow low-risk assumptions only when brief and not correctness-critical. Stay warm, direct, concise, and evidence-led.
+- Verify material user/agent claims before relying on them in implementation, architecture, verification, safety, or guidance.
+- Before solving/editing, post one short commentary update naming reasoning/root-cause check.
+- Do thought experiments: test competing explanations, edge cases, failure modes, root-cause fit.
+- Do not stop at first plausible explanation/superficial answer; validate with evidence, edge cases, tests, or fitting check.
+- If evidence disproves an assumption, correct it plainly, explain tradeoffs, and offer alternatives.
 </epistemic-rigor>
 
 <session-bootstrap>
@@ -1504,6 +1541,13 @@ function renderSubagentRules(section, dialect) {
   }
   return rules.join("\n");
 }
+function renderReasoningDiscipline() {
+  return `<reasoning-discipline>
+- Before solving/editing, post one short commentary update naming reasoning/root-cause check.
+- Do thought experiments: test competing explanations, edge cases, failure modes, root-cause fit.
+- Do not stop at first plausible explanation/superficial answer; validate with evidence, edge cases, tests, or fitting check.
+</reasoning-discipline>`;
+}
 function renderResponseBudget() {
   return "Return concise structured results: status, summary, files, verification/issues. Never return raw file dumps.";
 }
@@ -1584,6 +1628,8 @@ function renderPromptSection(section, dialect) {
       return renderQuestionProtocol(section, dialect);
     case "subagent-rules":
       return renderSubagentRules(section, dialect);
+    case "reasoning-discipline":
+      return renderReasoningDiscipline();
     case "response-budget":
       return renderResponseBudget();
     case "step-budget":
@@ -2221,9 +2267,11 @@ export {
   SUBAGENT_NAMES,
   ALL_AGENT_NAMES,
   DEFAULT_MODELS,
+  CONFIRMED_OPENAI_SUBAGENT_PRESET,
   POLL_INTERVAL_BACKGROUND_MS,
   DEFAULT_THOTH_COMMAND,
   getOpenCodeConfigPaths,
+  getOpenCodeManagedModelStatePath,
   getExistingLiteConfigPath,
   getExistingConfigPath,
   ensureConfigDir,

package/dist/cli/claude-code-install.d.ts

@@ -1,4 +1,4 @@
-import { type ClaudeCodeModel, isClaudeCodeModel } from '../harness/writers/claude-code-subagent';
+import { isClaudeCodeModel } from '../harness/writers/claude-code-subagent';
 import type { ClaudeCodeInstallScope, ClaudeCodeResolvedTargets, ClaudeCodeRoleName } from './claude-code-paths';
 import { type ManagedModelState } from './managed-state-io';
 export { CLAUDE_CODE_ROLE_NAMES } from './claude-code-paths';
@@ -39,11 +39,16 @@ export interface ClaudeCodeApplyResult {
 }
 export interface ClaudeCodeManagedModelOverride {
     role: ClaudeCodeRoleName;
-    model: ClaudeCodeModel;
+    model: string;
+    catalogId?: string;
+    effort?: string;
+    clearEffort?: boolean;
 }
 export declare const isClaudeCodeModelAlias: typeof isClaudeCodeModel;
 export declare function parseSubagentModel(content: string): string | undefined;
 export declare function replaceSubagentModel(content: string, model: string): string;
+export declare function parseSubagentEffort(content: string): string | undefined;
+export declare function replaceSubagentEffort(content: string, effort: string | undefined): string;
 export declare function parseManagedModelStateJson(text: string | undefined): ManagedModelState;
 export declare function readManagedModelState(path: string): ManagedModelState;
 export declare function buildClaudeCodeSetupPlan(config: ClaudeCodeInstallConfig): ClaudeCodeSetupPlan;

package/dist/cli/codex-install.d.ts

@@ -41,10 +41,14 @@ export declare const MANAGED_MODEL_STATE_VERSION = 1;
 export declare function readManagedModelState(path: string): ManagedModelState;
 export declare function parseRoleTomlModel(content: string): string | undefined;
 export declare function replaceRoleTomlModel(content: string, model: string): string;
+export declare function parseRoleTomlEffort(content: string): string | undefined;
+export declare function replaceRoleTomlEffort(content: string, effort: string | undefined): string;
 export declare function roleManagedModelStateKey(path: string): string;
 export interface CodexManagedModelOverride {
     role: CodexRoleName;
     model: string;
+    effort?: string;
+    clearEffort?: boolean;
 }
 export declare function applyCodexManagedModelOverrides(config: CodexInstallConfig, overrides: CodexManagedModelOverride[]): CodexApplyResult;
 export declare function buildCodexSetupPlan(config: CodexInstallConfig): CodexSetupPlan;

package/dist/cli/commands.d.ts

@@ -1,9 +1,19 @@
-import type { HarnessStatusReport, OperationApplyResult, OperationHarnessMetadata, OperationPlan } from './operations/types';
-import type { CliParseResult, GenerateArgs } from './types';
+import type { HarnessStatusReport, ModelRoleInput, OperationApplyResult, OperationContext, OperationHarnessMetadata, OperationPlan } from './operations/types';
+import { type ModelOption } from './tui/model-catalog';
+import type { CliModelRoleArg, CliParseResult, GenerateArgs, OperationHarnessArg } from './types';
 export declare function formatHarnessStatusReport(reports: readonly HarnessStatusReport[]): string;
 export declare function formatHarnessList(harnesses: readonly OperationHarnessMetadata[]): string;
 export declare function formatOperationPlan(plan: OperationPlan): string;
 export declare function formatOperationApplyResult(result: OperationApplyResult): string;
 export declare function printHelp(): void;
+export declare function resolveCliModelRoles(harness: OperationHarnessArg, roles: readonly CliModelRoleArg[], resolution?: {
+    currentRoles: readonly ModelRoleInput[];
+    modelOptions: readonly ModelOption[];
+}): ModelRoleInput[];
+export interface CliModelCommandServices {
+    operationContext(): OperationContext;
+    modelRoles(harness: OperationHarnessArg): ModelRoleInput[];
+    modelOptions(harness: OperationHarnessArg): Promise<ModelOption[]>;
+}
 export declare function printHarnessGeneration(args: GenerateArgs): number;
-export declare function runCliCommand(parsed: CliParseResult): Promise<number>;
+export declare function runCliCommand(parsed: CliParseResult, modelServices?: CliModelCommandServices): Promise<number>;