@tea-agent/loop-agent 0.25.6 → 0.26.0

package/bin/loop-agent.js

@@ -1,21 +1,21 @@
-#!/usr/bin/env node
-import { existsSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-
-const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
-const cliEntry = join(packageRoot, "dist", "cli.js");
-
-if (!existsSync(cliEntry)) {
-  console.error(
-    `loop-agent: cannot find built CLI at ${cliEntry}. Run \`npm run build\` before using the package bin.`,
-  );
-  process.exit(1);
-}
-
-try {
-  await import(pathToFileURL(cliEntry).href);
-} catch (error) {
-  console.error(error instanceof Error ? error.message : String(error));
-  process.exit(1);
-}
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const cliEntry = join(packageRoot, "dist", "cli.js");
+
+if (!existsSync(cliEntry)) {
+  console.error(
+    `loop-agent: cannot find built CLI at ${cliEntry}. Run \`npm run build\` before using the package bin.`,
+  );
+  process.exit(1);
+}
+
+try {
+  await import(pathToFileURL(cliEntry).href);
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+}

package/dist/commands/cursor-prompt.js

@@ -141,7 +141,7 @@ async function runCursorPromptBatch(task, cwd, model, timeoutMs) {
 }
 async function runCursorPromptStreaming(task, cwd, model, timeoutMs) {
     const startedAt = Date.now();
-    process.stderr.write(`[cursor-prompt] streaming (model=${model}, cwd=${cwd})
+    process.stderr.write(`[cursor-prompt] streaming (model=${model}, cwd=${cwd})
 `);
     const runDir = (await computeRunDir(cwd, task)) ?? undefined;
     const result = await executeCursorPromptStream({
@@ -164,15 +164,15 @@ async function runCursorPromptStreaming(task, cwd, model, timeoutMs) {
     });
     const elapsed = ((Date.now() - startedAt) / 1000).toFixed(1);
     if (result.ok) {
-        process.stderr.write(`
-[cursor-prompt] done in ${elapsed}s, status=${result.status}
+        process.stderr.write(`
+[cursor-prompt] done in ${elapsed}s, status=${result.status}
 `);
     }
     else {
         const stderr = result.stderr || "(no output)";
-        process.stderr.write(`
-[cursor-prompt] FAILED in ${elapsed}s (${result.failureCategory}):
-${stderr}
+        process.stderr.write(`
+[cursor-prompt] FAILED in ${elapsed}s (${result.failureCategory}):
+${stderr}
 `);
         process.exit(1);
     }

package/dist/commands/loop-benchmark.js

@@ -37,17 +37,17 @@ export function parseLoopBenchmarkArgs(args) {
     return { json, markdown, outputPath };
 }
 export function printLoopBenchmarkUsage() {
-    console.log(`usage: loop-benchmark [options]
-
-Deterministic loop-agent loop benchmark baseline (no live Pi/Cursor calls).
-
-Options:
-  --json              Emit JSON (default when no format flag is set)
-  --markdown          Emit Markdown report
-  --output <path>     Write Markdown report to a repo-relative or absolute path
-  -h, --help          Show this help
-
-Control groups: single-repair, 3-pass-convergence, 3-pass-convergence+quota.
+    console.log(`usage: loop-benchmark [options]
+
+Deterministic loop-agent loop benchmark baseline (no live Pi/Cursor calls).
+
+Options:
+  --json              Emit JSON (default when no format flag is set)
+  --markdown          Emit Markdown report
+  --output <path>     Write Markdown report to a repo-relative or absolute path
+  -h, --help          Show this help
+
+Control groups: single-repair, 3-pass-convergence, 3-pass-convergence+quota.
 Recommendation never changes convergence.enabled default.`);
 }
 export async function runLoopBenchmark(repoRoot, rawArgs) {

package/dist/commands/pi-reuse-benchmark.js

@@ -106,22 +106,22 @@ export function parsePiReuseBenchmarkArgs(args) {
     };
 }
 export function printPiReuseBenchmarkUsage() {
-    console.log(`usage: pi-reuse-benchmark [options]
-
-Deterministic Pi runtime reuse benchmark/decision summary (no live Pi calls).
-
-Options:
-  --report <path>         Benchmark report markdown (approval status)
-  --approval <path>       Explicit approval JSON artifact
-  --off-executor <path>   Baseline executor.jsonl (reuse off)
-  --on-executor <path>    Treatment executor.jsonl (reuse on)
-  --off-task <task-id>    Resolve baseline from .harness/tasks/<id>/logs/executor.jsonl
-  --on-task <task-id>     Resolve treatment from .harness/tasks/<id>/logs/executor.jsonl
-  --json                  Emit JSON (default when no format flag is set)
-  --markdown              Emit Markdown summary
-  -h, --help              Show this help
-
-Recommendations: defer | maintain-opt-in | eligible-for-human-review
+    console.log(`usage: pi-reuse-benchmark [options]
+
+Deterministic Pi runtime reuse benchmark/decision summary (no live Pi calls).
+
+Options:
+  --report <path>         Benchmark report markdown (approval status)
+  --approval <path>       Explicit approval JSON artifact
+  --off-executor <path>   Baseline executor.jsonl (reuse off)
+  --on-executor <path>    Treatment executor.jsonl (reuse on)
+  --off-task <task-id>    Resolve baseline from .harness/tasks/<id>/logs/executor.jsonl
+  --on-task <task-id>     Resolve treatment from .harness/tasks/<id>/logs/executor.jsonl
+  --json                  Emit JSON (default when no format flag is set)
+  --markdown              Emit Markdown summary
+  -h, --help              Show this help
+
+Recommendations: defer | maintain-opt-in | eligible-for-human-review
 Never changes CODE_AGENT_PI_REUSE_RUNTIME default (off).`);
 }
 function resolveRepoRelative(repoRoot, filePath) {

package/dist/executors/dag-pi-executor.js

@@ -169,14 +169,25 @@ export function buildDagPiUserMessage(task, persona, step) {
         "Do not wrap the output in code fences and do not add conversational preamble.",
     ].join(" ");
 }
-function resolveDagPiModelConfig(model) {
-    const provider = DAG_PI_MODEL_PROVIDERS[model] ?? DEFAULT_DAG_PI_PROVIDER;
+export function resolveDagPiModelConfig(modelReference, options) {
+    const separatorIndex = modelReference.indexOf("/");
+    const qualified = separatorIndex >= 0;
+    const provider = qualified
+        ? modelReference.slice(0, separatorIndex)
+        : (DAG_PI_MODEL_PROVIDERS[modelReference] ?? DEFAULT_DAG_PI_PROVIDER);
+    const model = qualified
+        ? modelReference.slice(separatorIndex + 1)
+        : modelReference;
+    if (!provider || !model) {
+        throw new Error(`invalid DAG Pi model reference "${modelReference}": expected non-empty provider/model`);
+    }
+    const explicitThinking = options?.thinking?.trim();
+    const thinking = explicitThinking ??
+        (provider === "wizard-local" && model === "gpt-5.5" ? "low" : undefined);
     return {
         provider,
         model,
-        ...(provider === "wizard-local" && model === "gpt-5.5"
-            ? { thinking: "low" }
-            : {}),
+        ...(thinking ? { thinking } : {}),
     };
 }
 const SUMMARY_STDOUT_MAX = 4_000;
@@ -291,7 +302,7 @@ export async function executeDagPiNode(input, meta, piStepFn = executePiStep) {
         : undefined;
     const result = await piStepFn({
         attachedFiles: [],
-        modelConfig: resolveDagPiModelConfig(input.model),
+        modelConfig: resolveDagPiModelConfig(input.model, input.thinking ? { thinking: input.thinking } : undefined),
         prompt: input.prompt,
         repoRoot: input.cwd,
         step,
@@ -304,8 +315,8 @@ export async function executeDagPiNode(input, meta, piStepFn = executePiStep) {
         abortGraceMs: input.abortGraceMs,
         onActivity: bridgeActivity
             ? (activity) => {
-                if (activity.kind === "lease"
-                    || activity.kind === "synthetic-heartbeat") {
+                if (activity.kind === "lease" ||
+                    activity.kind === "synthetic-heartbeat") {
                     return;
                 }
                 bridgeActivity(activity.kind, activity.at);
@@ -372,7 +383,9 @@ export async function executeDagPiNode(input, meta, piStepFn = executePiStep) {
             }
         }
     }
-    if (writeGuardOk && beforeStatus !== undefined && changeManifestChangedFiles !== undefined) {
+    if (writeGuardOk &&
+        beforeStatus !== undefined &&
+        changeManifestChangedFiles !== undefined) {
         await persistWriterChangeManifest({
             runDir: meta.runDir,
             nodeId: input.task.id,
@@ -445,12 +458,8 @@ function parseWriterImplementationOutcome(text) {
         const normalized = normalizeProtocolLine(line, WRITER_OUTCOME_PROTOCOL_LINE, nextLine);
         if (normalized === undefined)
             continue;
-        const value = normalized
-            .slice(WRITER_OUTCOME_PROTOCOL_LINE.length)
-            .trim();
-        const outcome = isWriterImplementationOutcome(value)
-            ? value
-            : undefined;
+        const value = normalized.slice(WRITER_OUTCOME_PROTOCOL_LINE.length).trim();
+        const outcome = isWriterImplementationOutcome(value) ? value : undefined;
         candidates.push({
             lineIndex,
             value,
@@ -474,9 +483,7 @@ function parseWriterImplementationOutcome(text) {
     };
 }
 function isWriterImplementationOutcome(value) {
-    return (value === "changed" ||
-        value === "already-satisfied" ||
-        value === "blocked");
+    return (value === "changed" || value === "already-satisfied" || value === "blocked");
 }
 function writerOutcomeDiagnostics(text, parsed, changedFiles) {
     const firstNonEmpty = text
@@ -543,8 +550,7 @@ function canonicalizeProtocolFirstLine(assistantText, firstProtocolLine) {
     if (protocolNextLineIndex === protocolIndex + 1) {
         after.shift();
     }
-    while (before.at(-1)?.trim() === "" &&
-        after.at(0)?.trim() === "") {
+    while (before.at(-1)?.trim() === "" && after.at(0)?.trim() === "") {
         after.shift();
     }
     const bodyLines = [...before, ...after];

package/dist/executors/model-routing.js

@@ -1,4 +1,5 @@
-import { DEFAULT_DAG_EXECUTOR_MODELS, } from '../workflows/dag/types.js';
+import { DEFAULT_DAG_EXECUTOR_MODELS, } from "../workflows/dag/types.js";
+import { normalizeExecutorTierValue, } from "../governance/manifest-types.js";
 export const DEFAULT_DAG_MODELS = {
     HIGH: "gpt-5.5",
     MED: "gpt-5.5",
@@ -8,6 +9,16 @@ export const DEFAULT_DAG_MODELS = {
  * DAG executor model tier keys that may carry a per-complexity override.
  */
 const EXECUTOR_MODEL_TIERS = ["LOW", "MED", "HIGH"];
+/** Resolve one tier to a model and optional explicit thinking override. */
+export function resolveExecutorTierSelection(execConfig, tier) {
+    const tierSelection = normalizeExecutorTierValue(execConfig?.[tier]);
+    if (tierSelection)
+        return tierSelection;
+    const defaultModel = execConfig?.defaultModel;
+    if (defaultModel && defaultModel !== "default")
+        return { model: defaultModel };
+    return { model: DEFAULT_DAG_EXECUTOR_MODELS.pi[tier] };
+}
 /**
  * Resolve the DAG executor model matrix for Pi from harness `executors.pi`.
  *
@@ -19,22 +30,23 @@ const EXECUTOR_MODEL_TIERS = ["LOW", "MED", "HIGH"];
  * The "default" literal (injected by the schema `.default("default")`) and
  * absent/undefined both mean "no override, fall through".
  */
-export function resolveExecutorModelMatrix(executor, execConfig) {
-    const tierValue = (tier) => {
-        const tierOverride = execConfig?.[tier];
-        if (tierOverride && tierOverride !== "default")
-            return tierOverride;
-        const defaultModel = execConfig?.defaultModel;
-        if (defaultModel && defaultModel !== "default")
-            return defaultModel;
-        return DEFAULT_DAG_EXECUTOR_MODELS[executor][tier];
-    };
+export function resolveExecutorModelMatrix(_executor, execConfig) {
     return {
-        LOW: tierValue("LOW"),
-        MED: tierValue("MED"),
-        HIGH: tierValue("HIGH"),
+        LOW: resolveExecutorTierSelection(execConfig, "LOW").model,
+        MED: resolveExecutorTierSelection(execConfig, "MED").model,
+        HIGH: resolveExecutorTierSelection(execConfig, "HIGH").model,
     };
 }
+/** Resolve only explicitly configured per-tier thinking values. */
+export function resolveExecutorThinkingMatrix(execConfig) {
+    const result = {};
+    for (const tier of EXECUTOR_MODEL_TIERS) {
+        const selection = normalizeExecutorTierValue(execConfig?.[tier]);
+        if (selection?.thinking)
+            result[tier] = selection.thinking;
+    }
+    return result;
+}
 /**
  * Resolve the Pi DAG executor model matrix from a harness manifest.
  */
@@ -55,7 +67,9 @@ export function resolveModelSelection(manifest, taskConfig, step, options) {
         };
     }
     const profileName = resolveProfileName(manifest, taskConfig.complexity, step, retryAttempt);
-    const profile = profileName ? manifest.modelProfiles?.[profileName] : undefined;
+    const profile = profileName
+        ? manifest.modelProfiles?.[profileName]
+        : undefined;
     if (!profile) {
         return {
             modelConfig: manifest.models?.[step],
@@ -74,7 +88,9 @@ export function resolveModelSelection(manifest, taskConfig, step, options) {
     };
 }
 function resolveProfileName(manifest, complexity, step, retryAttempt) {
-    if (step === 'implement' && retryAttempt > 0 && manifest.modelRouting?.implementRetry) {
+    if (step === "implement" &&
+        retryAttempt > 0 &&
+        manifest.modelRouting?.implementRetry) {
         return manifest.modelRouting.implementRetry;
     }
     const route = manifest.modelRouting?.[step];
@@ -85,11 +101,11 @@ function resolveProfileName(manifest, complexity, step, retryAttempt) {
 }
 export function formatModelSelectionLabel(modelConfig, profileName) {
     if (!modelConfig) {
-        return profileName ? `${profileName}` : 'default';
+        return profileName ? `${profileName}` : "default";
     }
     const base = modelConfig.provider && modelConfig.model
         ? `${modelConfig.provider}/${modelConfig.model}`
-        : modelConfig.model ?? 'default';
+        : (modelConfig.model ?? "default");
     return profileName ? `${profileName}:${base}` : base;
 }
 export function formatFallbackLabel(profile) {

package/dist/governance/manifest-types.js

@@ -18,6 +18,34 @@ export const worktreeManifestConfigSchema = z.object({
 });
 export const taskExecutorSchema = z.enum(["pi"]);
 export const CURSOR_TASK_EXECUTOR_REMOVED_ERROR = 'task executor "cursor" is no longer supported; governed runtime is Pi-only';
+/** Per-tier model override: bare model id string, or `{ model, thinking? }`. */
+export const executorTierModelSchema = z.union([
+    z.string(),
+    z.object({
+        model: z.string().min(1),
+        thinking: z.string().optional(),
+    }),
+]);
+/** Normalize an executors.pi LOW|MED|HIGH value. */
+export function normalizeExecutorTierValue(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value === "string") {
+        if (value === "default" || value.length === 0)
+            return undefined;
+        return { model: value };
+    }
+    if (typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const model = value.model;
+    if (typeof model !== "string" || model.length === 0 || model === "default") {
+        return undefined;
+    }
+    const thinking = value.thinking;
+    return typeof thinking === "string" && thinking.length > 0
+        ? { model, thinking }
+        : { model };
+}
 export const executorManifestSchema = z.object({
     description: z.string().optional(),
     enabled: z.boolean().optional(),
@@ -27,9 +55,9 @@ export const executorManifestSchema = z.object({
      * these take priority over defaultModel for the matching DAG executor tier.
      * "default" literal and absent/undefined both mean "no override, fall through".
      */
-    LOW: z.string().optional(),
-    MED: z.string().optional(),
-    HIGH: z.string().optional(),
+    LOW: executorTierModelSchema.optional(),
+    MED: executorTierModelSchema.optional(),
+    HIGH: executorTierModelSchema.optional(),
     requiresApiKey: z.string().optional(),
 });
 export const workflowPolicyProfileNameSchema = z.enum([
@@ -98,7 +126,7 @@ export const workflowPolicySchema = z
 })
     .optional()
     .default({});
-export const CURSOR_HARNESS_EXECUTOR_REMOVED_ERROR = 'harness executors.cursor is no longer supported; remove it and use executors.pi only (Cursor is available only via cursor-prompt sidecar)';
+export const CURSOR_HARNESS_EXECUTOR_REMOVED_ERROR = "harness executors.cursor is no longer supported; remove it and use executors.pi only (Cursor is available only via cursor-prompt sidecar)";
 export const harnessManifestSchema = z
     .object({
     version: z.number(),
@@ -160,7 +188,7 @@ export const harnessManifestSchema = z
     if ("cursorExecutorUsage" in entrypoints) {
         ctx.addIssue({
             code: z.ZodIssueCode.custom,
-            message: 'entrypoints.cursorExecutorUsage is no longer supported; remove it (Cursor is cursor-prompt sidecar only)',
+            message: "entrypoints.cursorExecutorUsage is no longer supported; remove it (Cursor is cursor-prompt sidecar only)",
             path: ["entrypoints", "cursorExecutorUsage"],
         });
     }

package/dist/sidecars/cursor-prompt/executor.js

@@ -29,7 +29,7 @@ export function resolveArtifactWriteDir(options) {
 }
 export function buildArtifactPathPrompt(writeDir) {
     if (!writeDir)
-        return `After changes, write artifacts/修改记录.md and artifacts/验证结果.md with verification evidence.
+        return `After changes, write artifacts/修改记录.md and artifacts/验证结果.md with verification evidence.
 ${ARTIFACT_INSTRUCTIONS}`;
     return [
         `After changes, write the following files:`,

package/dist/task/task-demand-routing.js

@@ -156,7 +156,7 @@ function isDocumentationOnlyClause(clause) {
     if (DOCUMENTATION_ONLY_MARKERS.test(clause)) {
         return !PRODUCT_AND_DOCUMENT_DELIVERY.test(clause);
     }
-    return TEST_ONLY_MARKERS.test(clause) && !PRODUCT_AND_TEST_DELIVERY.test(clause);
+    return (TEST_ONLY_MARKERS.test(clause) && !PRODUCT_AND_TEST_DELIVERY.test(clause));
 }
 function masksExistingBackendDependency(clause) {
     return clause
@@ -335,6 +335,8 @@ export function classifyTaskDemand(input) {
     }
     const backendDelivery = titleSignals.backendDelivery || requirementSignals.backendDelivery;
     const frontendProjectDefaultImplementation = hasStrongFrontendProjectEvidence &&
+        frontendPath &&
+        !hasBackendTaskType &&
         !backendDelivery &&
         !frontendNegated &&
         !allowedPathsOnlyCoverNonProductArtifacts;

package/dist/worker/console/chat/model-resolver.js

@@ -20,6 +20,18 @@ import { readFile } from "node:fs/promises";
 import path from "node:path";
 /** Tier keys in harness executors.pi that may override the default. */
 const EXECUTOR_TIERS = ["LOW", "MED", "HIGH"];
+function modelIdFromTierValue(value) {
+    if (typeof value === "string") {
+        return value && value !== "default" ? value : undefined;
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const model = value.model;
+    return typeof model === "string" && model && model !== "default"
+        ? model
+        : undefined;
+}
 /**
  * Read executors.pi.<tier> from the repo harness.json. Returns undefined when
  * harness.json is absent or the tier is unset / "default" sentinel.
@@ -33,9 +45,9 @@ export async function readHarnessPiModelTier(repoRoot, tier = "MED") {
         const pi = manifest.executors?.pi;
         if (!pi)
             return undefined;
-        const tierValue = pi[tier];
-        if (tierValue && tierValue !== "default")
-            return tierValue;
+        const tierModel = modelIdFromTierValue(pi[tier]);
+        if (tierModel)
+            return tierModel;
         const defaultModel = pi.defaultModel;
         if (defaultModel && defaultModel !== "default")
             return defaultModel;

package/dist/worker/observe/static/constants.js

@@ -67,8 +67,8 @@ export const STATUS_LABELS = {
 	done: "完成",
 	failed: "失败",
 	error: "错误",
-	partial_failed: "部分失败",
-	partialfailed: "部分失败",
+	partial_failed: "部分成功",
+	partialfailed: "部分成功",
 	blocked: "阻塞",
 	stale: "心跳失联",
 	reused: "复用",
@@ -104,6 +104,7 @@ export const DAG_EFFECTIVE_STATUS_LABELS = {
 	interrupted: "执行已中断",
 	"remote-unknown": "远端状态未知",
 	finished: "已完成",
+	partial_failed: "部分成功",
 	failed: "执行失败",
 	superseded: "任务已另行完成",
 	abandoned: "已放弃",

package/dist/worker/observe/static/copy.js

@@ -1,67 +1,67 @@
-/** Copy-only recommended commands (Observe UI R5). */
-import { el } from "./dom.js";
-
-export async function copyText(text) {
-	const value = String(text ?? "");
-	if (!value) return false;
-	try {
-		if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
-			await navigator.clipboard.writeText(value);
-			return true;
-		}
-	} catch {
-		// fall through
-	}
-	try {
-		const ta = document.createElement("textarea");
-		ta.value = value;
-		ta.setAttribute("readonly", "");
-		ta.style.position = "fixed";
-		ta.style.left = "-9999px";
-		document.body.appendChild(ta);
-		ta.select();
-		const ok = document.execCommand("copy");
-		document.body.removeChild(ta);
-		return ok;
-	} catch {
-		return false;
-	}
-}
-
-/** Advisory recommended command: copy-only, never executes. */
-export function renderRecommendedCommand(action) {
-	const block = el("div", "recommended-command");
-	if (!action) {
-		block.appendChild(el("span", "muted", "缺失"));
-		return block;
-	}
-	const head = el("div", "recommended-command-head");
-	if (action.kind) {
-		head.appendChild(el("span", "recommended-command-kind", action.kind));
-	}
-	head.appendChild(
-		el("span", "recommended-command-label", action.label ?? "—"),
-	);
-	block.appendChild(head);
-	if (action.command) {
-		const body = el("div", "recommended-command-body");
-		const code = el("code", "recommended-command-text", action.command);
-		body.appendChild(code);
-		const btn = el("button", "copy-command", "复制");
-		btn.type = "button";
-		btn.addEventListener("click", (e) => {
-			e.preventDefault();
-			e.stopPropagation();
-			void copyText(action.command).then((ok) => {
-				btn.textContent = ok ? "已复制" : "复制失败";
-				setTimeout(() => {
-					btn.textContent = "复制";
-				}, 1500);
-			});
-		});
-		body.appendChild(btn);
-		block.appendChild(body);
-	}
-	return block;
-}
-
+/** Copy-only recommended commands (Observe UI R5). */
+import { el } from "./dom.js";
+
+export async function copyText(text) {
+	const value = String(text ?? "");
+	if (!value) return false;
+	try {
+		if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
+			await navigator.clipboard.writeText(value);
+			return true;
+		}
+	} catch {
+		// fall through
+	}
+	try {
+		const ta = document.createElement("textarea");
+		ta.value = value;
+		ta.setAttribute("readonly", "");
+		ta.style.position = "fixed";
+		ta.style.left = "-9999px";
+		document.body.appendChild(ta);
+		ta.select();
+		const ok = document.execCommand("copy");
+		document.body.removeChild(ta);
+		return ok;
+	} catch {
+		return false;
+	}
+}
+
+/** Advisory recommended command: copy-only, never executes. */
+export function renderRecommendedCommand(action) {
+	const block = el("div", "recommended-command");
+	if (!action) {
+		block.appendChild(el("span", "muted", "缺失"));
+		return block;
+	}
+	const head = el("div", "recommended-command-head");
+	if (action.kind) {
+		head.appendChild(el("span", "recommended-command-kind", action.kind));
+	}
+	head.appendChild(
+		el("span", "recommended-command-label", action.label ?? "—"),
+	);
+	block.appendChild(head);
+	if (action.command) {
+		const body = el("div", "recommended-command-body");
+		const code = el("code", "recommended-command-text", action.command);
+		body.appendChild(code);
+		const btn = el("button", "copy-command", "复制");
+		btn.type = "button";
+		btn.addEventListener("click", (e) => {
+			e.preventDefault();
+			e.stopPropagation();
+			void copyText(action.command).then((ok) => {
+				btn.textContent = ok ? "已复制" : "复制失败";
+				setTimeout(() => {
+					btn.textContent = "复制";
+				}, 1500);
+			});
+		});
+		body.appendChild(btn);
+		block.appendChild(body);
+	}
+	return block;
+}
+