@promptbook/cli 0.114.0-24 → 0.114.0-26

package/src/version.ts

@@ -16,11 +16,11 @@ export const BOOK_LANGUAGE_VERSION: string_semantic_version = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-export const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version = '0.114.0-24';
+export const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version = '0.114.0-26';
 
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.114.0-23`).
+ * It follows semantic versioning (e.g., `0.114.0-25`).
  *
  * @generated
  */

package/src/versions.txt

@@ -1200,3 +1200,5 @@
 0.114.0-22
 0.114.0-23
 0.114.0-24
+0.114.0-25
+0.114.0-26

package/umd/index.umd.js

@@ -58,7 +58,7 @@
      * @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
@@ -1731,6 +1731,7 @@
         'claude-code',
         'opencode',
         'gemini',
+        'qwen-code',
     ];
     /**
      * All supported thinking-level values for CLI coding-agent runners.
@@ -1741,8 +1742,8 @@
     /**
      * 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`
      */
@@ -1827,23 +1828,31 @@
     - 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.spaceTrim(`
-    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.
@@ -1931,7 +1940,7 @@
             if (!options.isAgentRequired) {
                 return undefined;
             }
-            throw new Error(colors__default["default"].red('You must choose a harness using --harness <openai-codex|github-copilot|cline|claude-code|opencode|gemini>'));
+            throw new Error(colors__default["default"].red(`You must choose a harness using ${PROMPT_RUNNER_HARNESS_OPTION_HINT}`));
         }
         if (isPromptRunnerHarnessName(harness)) {
             return harness;
@@ -20064,29 +20073,36 @@
     /**
      * `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.spaceTrim(`
@@ -20096,6 +20112,7 @@
 
             ## 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.
@@ -20294,7 +20311,8 @@
         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'),
@@ -24143,6 +24161,12 @@
             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.
@@ -26268,6 +26292,71 @@
         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__default["default"].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.
      *
@@ -26287,27 +26376,14 @@
     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.
@@ -26317,28 +26393,12 @@
      * @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__default["default"].bgRed('Error parsing Gemini usage output:'), error);
-            return UNCERTAIN_USAGE;
-        }
+        return estimateUsageFromTextLength({
+            harnessLabel: 'Gemini',
+            prompt,
+            output,
+            resolvePricing: () => resolveGeminiPricing(modelName),
+        });
     }
 
     /**
@@ -27726,6 +27786,114 @@
         }
     }
 
+    /**
+     * 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.
      */
@@ -27734,6 +27902,11 @@
      * 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.
      *
@@ -27771,6 +27944,9 @@
         if (agentName === 'gemini') {
             return createGeminiRunnerResolution(options);
         }
+        if (agentName === 'qwen-code') {
+            return createQwenCodeRunnerResolution(options);
+        }
         throw new Error(`Unknown harness: ${agentName}`);
     }
     /**
@@ -27812,6 +27988,23 @@
             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.
      */
@@ -27827,9 +28020,7 @@
      */
     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') {
@@ -27840,6 +28031,12 @@
         }
         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.
      */
@@ -39991,7 +40188,7 @@
      */
     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.spaceTrim(`
@@ -74663,7 +74860,7 @@
             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,