@promptbook/cli 0.114.0-24 → 0.114.0-25

package/esm/scripts/run-codex-prompts/runners/common/estimateUsageFromTextLength.d.ts

@@ -0,0 +1,33 @@
+import type { Usage } from '../../../../src/execution/Usage';
+import type { ModelPricing } from './modelPricing';
+/**
+ * Options for estimating the usage of one harness run.
+ */
+export type EstimateUsageFromTextLengthOptions = {
+    /**
+     * Human-readable harness name used when the estimation itself fails.
+     */
+    readonly harnessLabel: string;
+    /**
+     * The prompt that was sent to the harness.
+     */
+    readonly prompt: string;
+    /**
+     * The output which the harness has printed.
+     */
+    readonly output: string;
+    /**
+     * Reads the pricing of the model which was used for this run.
+     *
+     * It is resolved lazily so that a broken pricing table degrades to an uncertain estimate
+     * instead of failing the coding round, because a price estimate must never block coding work.
+     */
+    readonly resolvePricing: () => ModelPricing;
+};
+/**
+ * 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.
+ */
+export declare function estimateUsageFromTextLength(options: EstimateUsageFromTextLengthOptions): Usage;

package/esm/scripts/run-codex-prompts/runners/common/modelPricing.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Price of one model per 1 million tokens in USD.
+ */
+export type ModelPricing = {
+    /**
+     * Price of 1 million input tokens in USD.
+     */
+    readonly input: number;
+    /**
+     * Price of 1 million output tokens in USD.
+     */
+    readonly output: number;
+};
+/**
+ * Pricing of all known models of one harness, keyed by the model identifier.
+ */
+export type ModelPricingTable = Readonly<Record<string, ModelPricing>>;
+/**
+ * Options for resolving the pricing of one model.
+ */
+export type ResolveModelPricingOptions = {
+    /**
+     * Pricing of all models known to one harness.
+     */
+    readonly pricingTable: ModelPricingTable;
+    /**
+     * Model whose pricing is used when the requested model is unknown.
+     */
+    readonly modelNameForEstimation: string;
+    /**
+     * Model requested for the run, or `undefined` when the harness picks its own model.
+     */
+    readonly modelName?: string;
+};
+/**
+ * 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.
+ */
+export declare function resolveModelPricing(options: ResolveModelPricingOptions): ModelPricing;

package/esm/scripts/run-codex-prompts/runners/gemini/gemini-pricing.d.ts

@@ -1,3 +1,4 @@
+import type { ModelPricing } from '../common/modelPricing';
 /**
  * The pricing for Gemini models per 1 million tokens in USD.
  *
@@ -6,30 +7,16 @@
  * @see https://ai.google.dev/pricing
  */
 export declare const GEMINI_PRICING: {
-    'gemini-1.5-flash': {
-        input: number;
-        output: number;
+    readonly 'gemini-1.5-flash': {
+        readonly input: 0.1125;
+        readonly output: 0.45;
     };
 };
 /**
  * The model to use for price estimation.
  */
 export declare const GEMINI_MODEL_FOR_ESTIMATION = "gemini-1.5-flash";
-/**
- * Gemini pricing entry per 1 million tokens.
- */
-export type GeminiPricing = {
-    input: number;
-    output: number;
-};
 /**
  * Resolves Gemini pricing for the requested model.
- *
- * It first tries exact match, then prefix match, then falls back to a stable
- * default pricing model.
- */
-export declare function resolveGeminiPricing(modelName?: string): GeminiPricing;
-/**
- * A an estimation of how many characters are in one token.
  */
-export declare const CHARS_PER_TOKEN = 4;
+export declare function resolveGeminiPricing(modelName?: string): ModelPricing;

package/esm/scripts/run-codex-prompts/runners/qwen-code/QwenCodeRunner.d.ts

@@ -0,0 +1,23 @@
+import type { PromptRunner } from '../types/PromptRunner';
+import type { PromptRunOptions } from '../types/PromptRunOptions';
+import type { PromptRunResult } from '../types/PromptRunResult';
+import type { QwenCodeRunnerOptions } from './QwenCodeRunnerOptions';
+/**
+ * Default Qwen Code model used by the coding runner.
+ */
+export declare const DEFAULT_QWEN_CODE_MODEL = "qwen3.8-max";
+/**
+ * Runs prompts via the Qwen Code CLI.
+ */
+export declare class QwenCodeRunner implements PromptRunner {
+    private readonly options;
+    readonly name = "qwen-code";
+    /**
+     * Creates a new Qwen Code runner.
+     */
+    constructor(options: QwenCodeRunnerOptions);
+    /**
+     * Runs the prompt using Qwen Code and parses usage output.
+     */
+    runPrompt(options: PromptRunOptions): Promise<PromptRunResult>;
+}

package/esm/scripts/run-codex-prompts/runners/qwen-code/buildQwenCodeScript.d.ts

@@ -0,0 +1,8 @@
+import type { QwenCodeScriptOptions } from './QwenCodeScriptOptions';
+/**
+ * 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.
+ */
+export declare function buildQwenCodeScript(options: QwenCodeScriptOptions): string;

package/esm/scripts/run-codex-prompts/runners/qwen-code/parseQwenCodeUsageFromOutput.d.ts

@@ -0,0 +1,9 @@
+import type { Usage } from '../../../../src/execution/Usage';
+/**
+ * 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.
+ */
+export declare function parseQwenCodeUsageFromOutput(output: string, prompt: string, modelName?: string): Usage;

package/esm/scripts/run-codex-prompts/runners/qwen-code/qwen-code-pricing.d.ts

@@ -0,0 +1,30 @@
+import type { ModelPricing } from '../common/modelPricing';
+/**
+ * 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
+ */
+export declare const QWEN_CODE_PRICING: {
+    readonly 'qwen3-coder-plus': {
+        readonly input: 1;
+        readonly output: 5;
+    };
+    readonly 'qwen3-coder-flash': {
+        readonly input: 0.3;
+        readonly output: 1.5;
+    };
+    readonly 'qwen3-max': {
+        readonly input: 1.2;
+        readonly output: 6;
+    };
+};
+/**
+ * The model to use for price estimation.
+ */
+export declare const QWEN_CODE_MODEL_FOR_ESTIMATION = "qwen3-coder-plus";
+/**
+ * Resolves Qwen Code pricing for the requested model.
+ */
+export declare function resolveQwenCodePricing(modelName?: string): ModelPricing;

package/esm/src/book-3.0/cliAgentEnv.d.ts

@@ -3,7 +3,7 @@
  *
  * @public exported from `@promptbook/node`
  */
-export declare const CLI_AGENT_HARNESS_NAMES: readonly ["openai-codex", "github-copilot", "cline", "claude-code", "opencode", "gemini"];
+export declare const CLI_AGENT_HARNESS_NAMES: readonly ["openai-codex", "github-copilot", "cline", "claude-code", "opencode", "gemini", "qwen-code"];
 /**
  * All supported thinking-level values for CLI coding-agent runners.
  *
@@ -13,8 +13,8 @@ export declare const CLI_AGENT_THINKING_LEVEL_VALUES: readonly ["low", "medium",
 /**
  * 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`
  */

package/esm/src/cli/cli-commands/common/promptRunnerCliOptions.d.ts

@@ -8,7 +8,7 @@ export { PTBK_HARNESS_ENV, PTBK_MODEL_ENV, PTBK_THINKING_LEVEL_ENV };
  *
  * @private internal utility of `promptbookCli`
  */
-export declare const PROMPT_RUNNER_HARNESS_NAMES: readonly ["openai-codex", "github-copilot", "cline", "claude-code", "opencode", "gemini"];
+export declare const PROMPT_RUNNER_HARNESS_NAMES: readonly ["openai-codex", "github-copilot", "cline", "claude-code", "opencode", "gemini", "qwen-code"];
 /**
  * Runner identifier supported by Promptbook CLI agent orchestration commands.
  *
@@ -72,7 +72,13 @@ export declare const PROMPT_RUNNER_DESCRIPTION: string;
  *
  * @private internal utility of `promptbookCli`
  */
-export declare const PROMPT_RUNNER_HARNESS_OPTION_DESCRIPTION = "Select runner: openai-codex, github-copilot, cline, claude-code, opencode, gemini (required for non-dry-run)";
+export declare const PROMPT_RUNNER_HARNESS_OPTION_DESCRIPTION: string;
+/**
+ * Runner harness names listed as alternatives of the `--harness` option in error messages.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare const PROMPT_RUNNER_HARNESS_OPTION_HINT: string;
 /**
  * Commander description for the `--model` option.
  *

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * 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-24`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.114.0-24",
+    "version": "0.114.0-25",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/src/book-3.0/cliAgentEnv.ts

@@ -12,6 +12,7 @@ export const CLI_AGENT_HARNESS_NAMES = [
     'claude-code',
     'opencode',
     'gemini',
+    'qwen-code',
 ] as const;
 
 /**
@@ -24,8 +25,8 @@ export const CLI_AGENT_THINKING_LEVEL_VALUES = ['low', 'medium', 'high', 'xhigh'
 /**
  * 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`
  */

package/src/cli/cli-commands/common/harness/HarnessDefinition.ts

@@ -78,6 +78,12 @@ export const HARNESS_DEFINITIONS: Readonly<Record<PromptRunnerHarnessName, Harne
         commandName: 'gemini',
         npmPackageName: '@google/gemini-cli',
     },
+    'qwen-code': {
+        harnessName: 'qwen-code',
+        label: 'Qwen Code',
+        commandName: 'qwen',
+        npmPackageName: '@qwen-code/qwen-code',
+    },
 };
 
 /**

package/src/cli/cli-commands/common/promptRunnerCliOptions.ts

@@ -100,6 +100,7 @@ export const PROMPT_RUNNER_DESCRIPTION = spaceTrim(`
     - claude-code: Claude Code integration
     - opencode: Opencode integration
     - gemini: Google Gemini CLI integration (requires --model)
+    - qwen-code: Qwen Code CLI integration (requires --model)
 `);
 
 /**
@@ -107,8 +108,16 @@ export const PROMPT_RUNNER_DESCRIPTION = spaceTrim(`
  *
  * @private internal utility of `promptbookCli`
  */
-export const PROMPT_RUNNER_HARNESS_OPTION_DESCRIPTION =
-    'Select runner: openai-codex, github-copilot, cline, claude-code, opencode, gemini (required for non-dry-run)';
+export 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`
+ */
+export const PROMPT_RUNNER_HARNESS_OPTION_HINT = `--harness <${PROMPT_RUNNER_HARNESS_NAMES.join('|')}>`;
 
 /**
  * Commander description for the `--model` option.
@@ -116,10 +125,11 @@ export const PROMPT_RUNNER_HARNESS_OPTION_DESCRIPTION =
  * @private internal utility of `promptbookCli`
  */
 export const PROMPT_RUNNER_MODEL_OPTION_DESCRIPTION = 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
 `);
 
 /**
@@ -249,11 +259,7 @@ function resolvePromptRunnerHarnessName(
             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)) {