@promptbook/cli 0.114.0-24 → 0.114.0-26

package/README.md

@@ -549,7 +549,7 @@ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treate
 
 #### Features
 
--   **Multi-runner execution:** `openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`
+-   **Multi-runner execution:** `openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`, `qwen-code`
 -   **Context injection:** `--agent agents/coding/developer.book --context AGENTS.md` or inline extra instructions
 -   **Reasoning control:** `--thinking-level low|medium|high|xhigh` for supported runners
 -   **Unattended or interactive runs:** default auto mode, or `--no-auto` to wait for user confirmation before each prompt
@@ -626,7 +626,7 @@ ptbk coder verify
 | Flag                       | Purpose                                                                                                                                                                                |
 | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `--harness <name>`         | Selects the coding harness.                                                                                                                                                            |
-| `--model <model>`          | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`.                                                                                     |
+| `--model <model>`          | Chooses the runner model; required for `openai-codex`, `gemini` and `qwen-code`, optional for `github-copilot`.                                                                        |
 | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`.                                                                                                                     |
 | `--test <command>`         | Runs a verification command after each prompt attempt and feeds failing output back for retries.                                                                                       |
 | `--test-before <mode>`     | Runs tests before coding: `no` (default), `yes-and-fail` (stop with results), or `yes-and-fix` (create one repair prompt first); defaults to `npm test` when enabled without `--test`. |

package/apps/agents-server/src/utils/agentProjects/agentProjectRuntimePm2.ts

@@ -1,6 +1,8 @@
 import { execFile } from 'child_process';
 import { createHash } from 'crypto';
 import { promisify } from 'util';
+import { UnexpectedError } from '../../../../../src/errors/UnexpectedError';
+import { spaceTrim } from '../../../../../src/utils/organization/spaceTrim';
 import { AGENT_PROJECT_RUNTIME_HOST } from './agentProjectRuntimeConstants';
 import type { AgentProjectRuntimeMode } from './AgentProjectRuntimeInfo';
 import { resolveAgentProjectRuntimeEnvironmentFlag } from './resolveAgentProjectRuntimeEnvironmentFlag';
@@ -44,8 +46,18 @@ const AGENT_PROJECT_PM2_PROCESS_LABEL_LENGTH = 36;
 
 /**
  * Max output retained from pm2 commands.
+ *
+ * Note: `pm2 jlist` embeds a full environment snapshot into every listed process, so the list grows by tens of
+ *       kilobytes with each started project. A budget of one megabyte was exhausted by roughly a dozen projects,
+ *       after which `execFile` killed every `pm2 jlist` call with `ERR_CHILD_PROCESS_STDIO_MAXBUFFER` and pm2
+ *       appeared to know no process at all.
+ */
+const PM2_COMMAND_MAX_BUFFER_BYTES = 64 * 1024 * 1024;
+
+/**
+ * pm2 error reported when no process of the requested name is registered.
  */
-const PM2_COMMAND_MAX_BUFFER_BYTES = 1024 * 1024;
+const PM2_MISSING_PROCESS_ERROR_PATTERN = /Process or Namespace .* not found/u;
 
 /**
  * Status snapshot for one pm2 process.
@@ -189,25 +201,46 @@ export async function startAgentProjectRuntimePm2Process(
 }
 
 /**
- * Stops one pm2 project process when it exists.
+ * Deletes every pm2 process registered under one name.
+ *
+ * Note: The delete is never skipped because pm2 could not be asked for its current process list. `pm2 start`
+ *       appends another process instead of replacing the existing one when a process of the same name is already
+ *       registered, so a delete which silently does nothing turns every later start of the same project into one
+ *       more duplicate. Only pm2 itself reporting an unknown name counts as "already gone", every other failure
+ *       is reported to the caller, which then must not start the project again.
  *
  * @param processName - pm2 process name.
  */
 export async function stopAgentProjectRuntimePm2Process(processName: string | null | undefined): Promise<void> {
-    if (!processName) {
+    if (!processName || !isAgentProjectRuntimePm2Enabled()) {
         return;
     }
 
-    const status = await resolveAgentProjectRuntimePm2Status(processName);
+    try {
+        await execFileAsync(PM2_COMMAND, ['delete', processName], {
+            maxBuffer: PM2_COMMAND_MAX_BUFFER_BYTES,
+            windowsHide: true,
+        });
+    } catch (error) {
+        if (isPm2MissingProcessError(error)) {
+            return;
+        }
 
-    if (!status.isKnown) {
-        return;
+        throw new UnexpectedError(
+            spaceTrim(
+                (block) => `
+                    Failed to delete the pm2 process \`${processName}\` of an agent project.
+
+                    Starting the project again would register one more pm2 process of the same name instead of
+                    replacing the existing one, so the project was left alone.
+
+                    **Cause:**
+                    ${block(error instanceof Error ? error.message : String(error))}
+                `,
+            ),
+        );
     }
 
-    await execFileAsync(PM2_COMMAND, ['delete', processName], {
-        maxBuffer: PM2_COMMAND_MAX_BUFFER_BYTES,
-        windowsHide: true,
-    });
     await savePm2ProcessList();
 }
 
@@ -366,6 +399,19 @@ async function savePm2ProcessList(): Promise<void> {
     });
 }
 
+/**
+ * Returns whether one failed pm2 command failed only because pm2 knows no process of the requested name.
+ */
+function isPm2MissingProcessError(error: unknown): boolean {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+
+    const { stderr } = error as { readonly stderr?: unknown };
+
+    return typeof stderr === 'string' && PM2_MISSING_PROCESS_ERROR_PATTERN.test(stderr);
+}
+
 /**
  * Creates the fallback status for missing or unavailable pm2 processes.
  */

package/apps/agents-server/src/utils/userChat/createImmediateUserChatAnswerModelRequirements.ts

@@ -19,6 +19,7 @@ const IMMEDIATE_USER_CHAT_ANSWER_INSTRUCTION_COMMITMENTS = new Set<string>([
     'STYLE',
     'STYLES',
     'WRITING RULES',
+    'WRITING RULE',
     'FORMAT',
     'FORMATS',
     'SCENARIO',

package/esm/index.es.js

@@ -48,7 +48,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.114.0-24';
+const PROMPTBOOK_ENGINE_VERSION = '0.114.0-26';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1721,6 +1721,7 @@ const CLI_AGENT_HARNESS_NAMES = [
     'claude-code',
     'opencode',
     'gemini',
+    'qwen-code',
 ];
 /**
  * All supported thinking-level values for CLI coding-agent runners.
@@ -1731,8 +1732,8 @@ const CLI_AGENT_THINKING_LEVEL_VALUES = ['low', 'medium', 'high', 'xhigh', 'max'
 /**
  * Environment variable used as the default runner identifier when `--harness` is omitted or not set in `CliAgent`.
  *
- * Set this to one of the harness names (`openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`)
- * so that `CliAgent` and `ptbk agent exec` can run without an explicit `harness` option.
+ * Set this to one of the harness names (`openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`,
+ * `qwen-code`) so that `CliAgent` and `ptbk agent exec` can run without an explicit `harness` option.
  *
  * @public exported from `@promptbook/node`
  */
@@ -1817,23 +1818,31 @@ const PROMPT_RUNNER_DESCRIPTION = spaceTrim$1(`
     - claude-code: Claude Code integration
     - opencode: Opencode integration
     - gemini: Google Gemini CLI integration (requires --model)
+    - qwen-code: Qwen Code CLI integration (requires --model)
 `);
 /**
  * Commander description for the `--harness` option.
  *
  * @private internal utility of `promptbookCli`
  */
-const PROMPT_RUNNER_HARNESS_OPTION_DESCRIPTION = 'Select runner: openai-codex, github-copilot, cline, claude-code, opencode, gemini (required for non-dry-run)';
+const PROMPT_RUNNER_HARNESS_OPTION_DESCRIPTION = `Select runner: ${PROMPT_RUNNER_HARNESS_NAMES.join(', ')} (required for non-dry-run)`;
+/**
+ * Runner harness names listed as alternatives of the `--harness` option in error messages.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+const PROMPT_RUNNER_HARNESS_OPTION_HINT = `--harness <${PROMPT_RUNNER_HARNESS_NAMES.join('|')}>`;
 /**
  * Commander description for the `--model` option.
  *
  * @private internal utility of `promptbookCli`
  */
 const PROMPT_RUNNER_MODEL_OPTION_DESCRIPTION = spaceTrim$1(`
-    Model to use (required for openai-codex and gemini)
+    Model to use (required for openai-codex, gemini and qwen-code)
 
     OpenAI examples: gpt-5.2-codex, default
     Gemini examples: gemini-3-flash-preview, default
+    Qwen examples: qwen3.8-max, default
 `);
 /**
  * Commander description for the `--git-changes` option.
@@ -1921,7 +1930,7 @@ function resolvePromptRunnerHarnessName(harness, options) {
         if (!options.isAgentRequired) {
             return undefined;
         }
-        throw new Error(colors.red('You must choose a harness using --harness <openai-codex|github-copilot|cline|claude-code|opencode|gemini>'));
+        throw new Error(colors.red(`You must choose a harness using ${PROMPT_RUNNER_HARNESS_OPTION_HINT}`));
     }
     if (isPromptRunnerHarnessName(harness)) {
         return harness;
@@ -20054,29 +20063,36 @@ class UseUserLocationCommitmentDefinition extends BaseCommitmentDefinition {
 /**
  * `WRITING RULES` commitment definition.
  *
- * It adds constraints that apply strictly to writing style and presentation
- * rather than task-solving behavior.
+ * The `WRITING RULES`/`WRITING RULE` commitment adds constraints that apply strictly to writing style
+ * and presentation rather than task-solving behavior.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * WRITING RULES Keep every response under 120 words
+ * WRITING RULE Always end the message with an emoji
+ * ```
  *
  * @private [🪔] Maybe export the commitments through some package
  */
 class WritingRulesCommitmentDefinition extends BaseCommitmentDefinition {
-    constructor() {
-        super('WRITING RULES');
+    constructor(type = 'WRITING RULES') {
+        super(type);
     }
     /**
-     * Short one-line description of `WRITING RULES`.
+     * Short one-line description of `WRITING RULES`/`WRITING RULE`.
      */
     get description() {
         return 'Add writing-only constraints such as tone, length, formatting, or emoji usage.';
     }
     /**
-     * Icon for `WRITING RULES`.
+     * Icon for `WRITING RULES`/`WRITING RULE`.
      */
     get icon() {
         return '📝';
     }
     /**
-     * Markdown documentation for `WRITING RULES`.
+     * Markdown documentation for `WRITING RULES`/`WRITING RULE` commitment.
      */
     get documentation() {
         return spaceTrim$1(`
@@ -20086,6 +20102,7 @@ class WritingRulesCommitmentDefinition extends BaseCommitmentDefinition {
 
             ## Key aspects
 
+            - All writing rules are treated equally regardless of singular/plural form.
             - Use it for writing-only constraints such as tone, formatting, length, emoji usage, punctuation, or reading level.
             - Do **not** use it for problem-solving behavior, policy, tool usage, or decision-making logic. Use \`RULE\` for that.
             - Newer writing-rules blocks override conflicting earlier writing-rules blocks.
@@ -20284,7 +20301,8 @@ const COMMITMENT_REGISTRY = [
     new LanguageCommitmentDefinition('LANGUAGE'),
     new LanguageCommitmentDefinition('LANGUAGES'),
     new WritingSampleCommitmentDefinition(),
-    new WritingRulesCommitmentDefinition(),
+    new WritingRulesCommitmentDefinition('WRITING RULES'),
+    new WritingRulesCommitmentDefinition('WRITING RULE'),
     new SampleCommitmentDefinition('SAMPLE'),
     new SampleCommitmentDefinition('EXAMPLE'),
     new FormatCommitmentDefinition('FORMAT'),
@@ -24133,6 +24151,12 @@ const HARNESS_DEFINITIONS = {
         commandName: 'gemini',
         npmPackageName: '@google/gemini-cli',
     },
+    'qwen-code': {
+        harnessName: 'qwen-code',
+        label: 'Qwen Code',
+        commandName: 'qwen',
+        npmPackageName: '@qwen-code/qwen-code',
+    },
 };
 /**
  * Looks up the definition of one supported CLI coding harness.
@@ -26258,6 +26282,71 @@ function uncertainNumber(value, isUncertain) {
     return { value };
 }
 
+/**
+ * An estimation of how many characters are in one token.
+ */
+const CHARS_PER_TOKEN = 4;
+/**
+ * Estimates the usage of one harness run from the length of its prompt and its output.
+ *
+ * Harnesses which do not report their own token counts are billed per token anyway, so the
+ * character counts are the only signal available for a price estimate.
+ */
+function estimateUsageFromTextLength(options) {
+    const { harnessLabel, prompt, output, resolvePricing } = options;
+    try {
+        const pricing = resolvePricing();
+        const inputTokens = Math.ceil(prompt.length / CHARS_PER_TOKEN);
+        const outputTokens = Math.ceil(output.length / CHARS_PER_TOKEN);
+        const price = uncertainNumber((inputTokens / 1000000) * pricing.input + (outputTokens / 1000000) * pricing.output);
+        return {
+            ...UNCERTAIN_USAGE,
+            price,
+            input: {
+                ...UNCERTAIN_USAGE.input,
+                tokensCount: uncertainNumber(inputTokens),
+            },
+            output: {
+                ...UNCERTAIN_USAGE.output,
+                tokensCount: uncertainNumber(outputTokens),
+            },
+        };
+    }
+    catch (error) {
+        console.error(colors.bgRed(`Error parsing ${harnessLabel} usage output:`), error);
+        return UNCERTAIN_USAGE;
+    }
+}
+
+/**
+ * Resolves the pricing of one model of one harness.
+ *
+ * It first tries exact match, then prefix match, then falls back to the pricing of a stable
+ * default model, because every harness names new models faster than the pricing tables grow.
+ */
+function resolveModelPricing(options) {
+    var _a;
+    const { pricingTable, modelNameForEstimation, modelName } = options;
+    const fallbackPricing = pricingTable[modelNameForEstimation];
+    if (fallbackPricing === undefined) {
+        throw new UnexpectedError(spaceTrim(`
+                Missing pricing of the model \`${modelNameForEstimation}\` used for price estimation.
+
+                **The model used for estimation must always be listed in its own pricing table.**
+            `));
+    }
+    if (!modelName) {
+        return fallbackPricing;
+    }
+    const exactMatch = pricingTable[modelName];
+    if (exactMatch) {
+        return exactMatch;
+    }
+    const prefixMatch = (_a = Object.entries(pricingTable).find(([knownModelName]) => modelName.startsWith(knownModelName))) === null || _a === void 0 ? void 0 : _a[1];
+    return prefixMatch !== null && prefixMatch !== void 0 ? prefixMatch : fallbackPricing;
+}
+// Note: [💞] Ignore a discrepancy between file name and entity name
+
 /**
  * The pricing for Gemini models per 1 million tokens in USD.
  *
@@ -26277,27 +26366,14 @@ const GEMINI_PRICING = {
 const GEMINI_MODEL_FOR_ESTIMATION = 'gemini-1.5-flash';
 /**
  * Resolves Gemini pricing for the requested model.
- *
- * It first tries exact match, then prefix match, then falls back to a stable
- * default pricing model.
  */
 function resolveGeminiPricing(modelName) {
-    var _a;
-    const fallbackPricing = GEMINI_PRICING[GEMINI_MODEL_FOR_ESTIMATION];
-    if (!modelName) {
-        return fallbackPricing;
-    }
-    const exactMatch = GEMINI_PRICING[modelName];
-    if (exactMatch) {
-        return exactMatch;
-    }
-    const prefixMatch = (_a = Object.entries(GEMINI_PRICING).find(([knownModel]) => modelName.startsWith(knownModel))) === null || _a === void 0 ? void 0 : _a[1];
-    return prefixMatch !== null && prefixMatch !== void 0 ? prefixMatch : fallbackPricing;
+    return resolveModelPricing({
+        pricingTable: GEMINI_PRICING,
+        modelNameForEstimation: GEMINI_MODEL_FOR_ESTIMATION,
+        modelName,
+    });
 }
-/**
- * A an estimation of how many characters are in one token.
- */
-const CHARS_PER_TOKEN = 4;
 
 /**
  * Parses Gemini CLI output and extracts usage information.
@@ -26307,28 +26383,12 @@ const CHARS_PER_TOKEN = 4;
  * @param modelName The Gemini model used for this run.
  */
 function parseGeminiUsageFromOutput(output, prompt, modelName) {
-    try {
-        const pricing = resolveGeminiPricing(modelName);
-        const inputTokens = Math.ceil(prompt.length / CHARS_PER_TOKEN);
-        const outputTokens = Math.ceil(output.length / CHARS_PER_TOKEN);
-        const price = uncertainNumber((inputTokens / 1000000) * pricing.input + (outputTokens / 1000000) * pricing.output);
-        return {
-            ...UNCERTAIN_USAGE,
-            price,
-            input: {
-                ...UNCERTAIN_USAGE.input,
-                tokensCount: uncertainNumber(inputTokens),
-            },
-            output: {
-                ...UNCERTAIN_USAGE.output,
-                tokensCount: uncertainNumber(outputTokens),
-            },
-        };
-    }
-    catch (error) {
-        console.error(colors.bgRed('Error parsing Gemini usage output:'), error);
-        return UNCERTAIN_USAGE;
-    }
+    return estimateUsageFromTextLength({
+        harnessLabel: 'Gemini',
+        prompt,
+        output,
+        resolvePricing: () => resolveGeminiPricing(modelName),
+    });
 }
 
 /**
@@ -27716,6 +27776,114 @@ class OpencodeRunner {
     }
 }
 
+/**
+ * Delimiter used for passing large prompts to the Qwen Code CLI.
+ */
+const QWEN_CODE_PROMPT_DELIMITER = 'QWEN_CODE_PROMPT';
+/**
+ * Builds the shell script that runs Qwen Code with the prompt and coding context.
+ *
+ * Note: `-y` runs the harness unattended, because `ptbk coder` approves the whole prompt
+ *       up front and there is nobody at the keyboard to confirm the single tool calls.
+ */
+function buildQwenCodeScript(options) {
+    return spaceTrim((block) => `
+            qwen -y -m ${options.model} -p "$(cat <<'${QWEN_CODE_PROMPT_DELIMITER}'
+
+            ${block(options.prompt)}
+
+            ${QWEN_CODE_PROMPT_DELIMITER}
+            )"
+        `);
+}
+
+/**
+ * The pricing for Qwen Code models per 1 million tokens in USD.
+ *
+ * Note: This is an estimation.
+ *
+ * @see https://www.alibabacloud.com/help/en/model-studio/models
+ */
+const QWEN_CODE_PRICING = {
+    'qwen3-coder-plus': {
+        input: 1,
+        output: 5,
+    },
+    'qwen3-coder-flash': {
+        input: 0.3,
+        output: 1.5,
+    },
+    'qwen3-max': {
+        input: 1.2,
+        output: 6,
+    },
+};
+/**
+ * The model to use for price estimation.
+ */
+const QWEN_CODE_MODEL_FOR_ESTIMATION = 'qwen3-coder-plus';
+/**
+ * Resolves Qwen Code pricing for the requested model.
+ */
+function resolveQwenCodePricing(modelName) {
+    return resolveModelPricing({
+        pricingTable: QWEN_CODE_PRICING,
+        modelNameForEstimation: QWEN_CODE_MODEL_FOR_ESTIMATION,
+        modelName,
+    });
+}
+
+/**
+ * Parses Qwen Code CLI output and extracts usage information.
+ *
+ * @param output The output from the Qwen Code CLI.
+ * @param prompt The prompt that was sent to the Qwen Code CLI.
+ * @param modelName The Qwen Code model used for this run.
+ */
+function parseQwenCodeUsageFromOutput(output, prompt, modelName) {
+    return estimateUsageFromTextLength({
+        harnessLabel: 'Qwen Code',
+        prompt,
+        output,
+        resolvePricing: () => resolveQwenCodePricing(modelName),
+    });
+}
+
+/**
+ * Default Qwen Code model used by the coding runner.
+ */
+const DEFAULT_QWEN_CODE_MODEL = 'qwen3.8-max';
+/**
+ * Runs prompts via the Qwen Code CLI.
+ */
+class QwenCodeRunner {
+    /**
+     * Creates a new Qwen Code runner.
+     */
+    constructor(options) {
+        this.options = options;
+        this.name = 'qwen-code';
+    }
+    /**
+     * Runs the prompt using Qwen Code and parses usage output.
+     */
+    async runPrompt(options) {
+        const scriptContent = buildQwenCodeScript({
+            prompt: options.prompt,
+            model: this.options.model,
+        });
+        const output = await $runGoScriptWithOutput({
+            scriptPath: options.scriptPath,
+            scriptContent,
+            logPath: options.logPath,
+            shouldPrintLiveOutput: options.shouldPrintLiveOutput,
+            preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
+        });
+        const usage = parseQwenCodeUsageFromOutput(output, options.prompt, this.options.model);
+        return { usage };
+    }
+}
+
 /**
  * Constant for default codex model.
  */
@@ -27724,6 +27892,11 @@ const DEFAULT_CODEX_MODEL = 'gpt-5.2-codex';
  * Constant for cline model.
  */
 const CLINE_MODEL = 'gemini:gemini-3-flash-preview';
+/**
+ * Harnesses which refuse to run without an explicit `--model`, because they expose many models
+ * of very different capability and price and never pick a sensible one on their own.
+ */
+const MODEL_REQUIRING_HARNESS_NAMES = ['openai-codex', 'gemini', 'qwen-code'];
 /**
  * Resolves the configured prompt runner together with status-line metadata.
  *
@@ -27761,6 +27934,9 @@ function resolvePromptRunner(options) {
     if (agentName === 'gemini') {
         return createGeminiRunnerResolution(options);
     }
+    if (agentName === 'qwen-code') {
+        return createQwenCodeRunnerResolution(options);
+    }
     throw new Error(`Unknown harness: ${agentName}`);
 }
 /**
@@ -27802,6 +27978,23 @@ function createGeminiRunnerResolution(options) {
         model: actualRunnerModel,
     }), actualRunnerModel);
 }
+/**
+ * Builds the Qwen Code CLI runner resolution, including required-model validation.
+ */
+function createQwenCodeRunnerResolution(options) {
+    const actualRunnerModel = resolveRequiredModel({
+        agentName: 'qwen-code',
+        providedModel: options.model,
+        defaultModel: DEFAULT_QWEN_CODE_MODEL,
+        exampleUsages: [
+            `--harness qwen-code --model ${DEFAULT_QWEN_CODE_MODEL}`,
+            '--harness qwen-code --model default',
+        ],
+    });
+    return createRunnerResolution(options, new QwenCodeRunner({
+        model: actualRunnerModel,
+    }), actualRunnerModel);
+}
 /**
  * Combines the instantiated runner with prompt status metadata.
  */
@@ -27817,9 +28010,7 @@ function createRunnerResolution(options, runner, actualRunnerModel) {
  */
 function getRunnerMetadata(options, actualRunnerModel) {
     const runnerName = options.agentName ? getHarnessDefinition(options.agentName).label : 'unknown';
-    if (options.agentName === 'openai-codex' ||
-        options.agentName === 'github-copilot' ||
-        options.agentName === 'gemini') {
+    if (options.agentName === 'github-copilot' || isModelRequiringHarnessName(options.agentName)) {
         return { runnerName, modelName: actualRunnerModel };
     }
     if (options.agentName === 'cline') {
@@ -27830,6 +28021,12 @@ function getRunnerMetadata(options, actualRunnerModel) {
     }
     return { runnerName };
 }
+/**
+ * Checks whether one harness refuses to run without an explicit `--model`.
+ */
+function isModelRequiringHarnessName(agentName) {
+    return MODEL_REQUIRING_HARNESS_NAMES.includes(agentName);
+}
 /**
  * Resolves a runner model, allowing `default` but otherwise requiring an explicit value.
  */
@@ -39981,7 +40178,7 @@ function updateAgentRunUiForPulling(uiHandle, queueSnapshot, statusMessage) {
  */
 function validateAgentRunOptions(options) {
     if (!options.agentName) {
-        throw new NotAllowed('You must choose a harness using --harness <openai-codex|github-copilot|cline|claude-code|opencode|gemini>.');
+        throw new NotAllowed(`You must choose a harness using ${PROMPT_RUNNER_HARNESS_OPTION_HINT}.`);
     }
     if (options.autoPull && options.noCommit) {
         throw new NotAllowed(spaceTrim$1(`
@@ -74653,7 +74850,7 @@ function parseRunOptions(args) {
         exitWithUsageError(error instanceof Error ? error.message : String(error));
     }
     if (!agentName && !dryRun) {
-        exitWithUsageError('You must choose a harness using --harness <openai-codex|github-copilot|cline|claude-code|opencode|gemini>');
+        exitWithUsageError(`You must choose a harness using ${PROMPT_RUNNER_HARNESS_OPTION_HINT}`);
     }
     return {
         dryRun,