@spzxg/cli-ui 0.6.7 → 0.6.9

package/dist/cli-ui.js

@@ -1,4 +1,4 @@
-import { C as a, b as i, d as r, e as t, f as o, h as C, i as l, j as n, k as m, m as d, l as u, n as w, o as B, p as f } from "./cli-ui-embed-CB7ibAtF.js";
+import { C as a, b as i, d as r, e as t, f as o, h as C, i as l, j as n, k as m, m as d, l as u, n as w, o as B, p as f } from "./cli-ui-embed-CtZDwP8y.js";
 export {
   a as CliBoard,
   i as CliBrowserView,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spzxg/cli-ui",
-  "version": "0.6.7",
+  "version": "0.6.9",
   "type": "module",
   "description": "相互联动的 CliMsgList、CliChat、CliBoard，支持任务中枢和完整 Operator 工作区。",
   "main": "src/index.ts",

package/src/chat/CliChat.tsx

@@ -28,6 +28,9 @@ import { QueuedMessages } from "../ui/QueuedMessages";
 import { ReferenceCard } from "../ui/ReferenceCard";
 import type { UploadDocument } from "../core/documentUpload";
 import { GroupChat, type GroupChatAdapter } from "./GroupChat";
+import { RunControls } from "./RunControls";
+import { useExecutionConfig } from "./useExecutionConfig";
+import { CenterError } from "../core/client";
 
 /** onTurnEnd / onConversationEnd：浏览器里从实时流算出的结果通知，不依赖 center 的 callback.url。 */
 export interface CliChatProps extends CliStoreOptions, ResultHandlers {
@@ -229,7 +232,17 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
   const task = (shownTaskId ? job?.tasks?.find((t) => t.id === shownTaskId) : undefined) ?? (shownTaskId || batch ? undefined : job?.tasks?.[0]);
   const info = taskId ? job?.conversation?.conversations?.find((c) => c.task_id === taskId) : undefined;
   const agent = task?.agent ?? conv?.turns[conv.turns.length - 1]?.agent ?? null;
-  const agentText = labelOf(agent);
+  const draftScope = store.draftScope ? `${store.draftScope}:${key ?? `new:${instanceId}`}` : key ?? `new:${instanceId}`;
+  const initialOptions = newConversation ?? store.getNewConversationOptions();
+  const execution = useExecutionConfig({ client: store.client, scope: draftScope,
+    target: key && !isNew ? key : null, running: running || batchPending,
+    enabled: showComposer && (cfg.composer.agentSelector || cfg.composer.executionMode),
+    initial: { ...(initialOptions?.agent ? { agent: initialOptions.agent } : {}), ...initialOptions?.executionConfig },
+  });
+  const agentText = labelOf(execution.config?.agent ?? agent);
+  const executionAgent = execution.config?.agents.find(item => item.id === execution.config?.agent);
+  const executionReadOnly = !!key && !isNew && !store.client.setExecutionConfig;
+  const settingsBusy = !!configurationBusy || execution.blocked;
   const jobStatus = conv?.job?.status ?? job?.status ?? null;
   // 对话式子任务没有「结束」：大任务结束了，再发一条会重新打开它。
   // 支持续派的普通子任务同理：大任务结束不挡输入框。
@@ -306,7 +319,11 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
   // 本组件的新建参数随每次发送带上：放进共享 Provider 时也用自己的，不依赖仓库是谁建的。
   const sendOpts = useRef({ newConversation, createConversation, businessIdFor, select: !controlled });
   useLayoutEffect(() => { sendOpts.current = { newConversation, createConversation, businessIdFor, select: !controlled }; });
+  const prepareExecution = useRef(execution.prepareSend);
+  const reloadExecution = useRef(execution.reload);
+  useLayoutEffect(() => { prepareExecution.current = execution.prepareSend; reloadExecution.current = execution.reload; });
   const send = useCallback(async (text: string) => {
+    const executionOptions = prepareExecution.current();
     // 一次性任务：发给正在看的那个子任务（接着它聊）。
     const id = latest.current.conv?.batch ? latest.current.runKey : latest.current.key;
     // 看板里引用到这个对话的东西：合成一个「看板上下文」块跟着这条消息发出去；发失败就放回去。
@@ -325,9 +342,10 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
     let target: string;
     try {
       if(charCount(full)>MAX_MESSAGE_CHARS)throw new Error("加上看板背景后消息过长，请精简消息内容后重试。");
-      target = await store.send(id ?? null, full, sendOpts.current);
+      target = await store.send(id ?? null, full, { ...sendOpts.current, ...executionOptions });
     } catch (error) {
       if (refKey) { store.restoreRefs(refKey, refs); store.restoreViewing(refKey, viewing); }
+      if (error instanceof CenterError && error.code === "execution_config_conflict" && latest.current.key === refKey) await reloadExecution.current();
       throw error;
     }
     if (target !== id && latest.current.key === refKey) go(target);
@@ -814,21 +832,33 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
           </div>
         )}
         {slots?.beforeComposer}
+        {showComposer && execution.error && <div className="control-error" role="status">{execution.error} {store.client.getExecutionConfig && <button type="button" className="btn btn-ghost btn-sm" disabled={execution.loading || execution.busy} onClick={() => void execution.reload()}>重新读取</button>}</div>}
         {!showComposer && <QueuedMessages scopeKey={key ?? "new"} messages={queued} onCancel={handlers.onCancelQueued} attachmentUrl={handlers.attachmentUrl} />}
         {showComposer && (
           <Composer
             uploadDocument={uploadDocument}
             key={key ?? "new"}
-            draft={store.draftScope ? `${store.draftScope}:${key ?? `new:${instanceId}`}` : key ?? `new:${instanceId}`}
+            draft={draftScope}
             context={(!!shownRefs?.length || !!viewing) && <div className="cli-refs composer-references" aria-label="下一条消息的引用">
               {viewing && <ReferenceCard key={`${key}:viewing:${viewing.id}`} className="reference-viewing" title={`正在看${viewing.label}`} text={viewing.text} disabled={composerDisabled || !!configurationBusy} removeLabel={`不带上 ${viewing.label}`} onRemove={() => { if (key) store.dismissViewing(key); chatRef.current?.querySelector<HTMLTextAreaElement>(".composer textarea")?.focus({ preventScroll: true }); }} />}
               {(shownRefs ?? []).map(ref => <ReferenceCard key={`${key}:${ref.id}`} title={ref.kind === "message" && ref.label === "引用你的消息" ? "你" : ref.kind === "message" && ref.label === "引用智能体消息" ? "智能体" : ref.label} text={ref.text} disabled={composerDisabled || !!configurationBusy} removeLabel={`不带上 ${ref.label}`} onRemove={() => { if (key) store.removeRef(key, ref.id); chatRef.current?.querySelector<HTMLTextAreaElement>(".composer textarea")?.focus({ preventScroll: true }); }} />)}
             </div>}
             placeholder={fillTemplate(key && !isNew ? cfg.composer.placeholder : cfg.composer.placeholderNew, { title: convTitle, agent: agentText })}
-            disabled={composerDisabled || !!configurationBusy}
+            disabled={composerDisabled || settingsBusy}
             disabledHint={cfg.composer.placeholderDisabled ? fillTemplate(cfg.composer.placeholderDisabled, { title: convTitle, agent: agentText }) : disabledHint}
             running={running || batchPending}
-            toolbar={slots?.composerToolbar}
+            toolbar={<>
+              <RunControls task={{ id: draftScope, agent: execution.config?.agent ?? agent ?? initialOptions?.agent ?? undefined,
+                model: execution.config?.model, reasoning: execution.config?.reasoning, permission_mode: execution.config?.permission_mode }}
+                agents={execution.config?.agents} caps={executionAgent?.capabilities} defaults={executionAgent?.defaults}
+                showAgent={cfg.composer.agentSelector} showPermission={cfg.composer.executionMode}
+                unavailableReason={executionReadOnly ? "当前接入仅支持读取执行设置。" : execution.error ?? (execution.loading ? "正在读取执行设置…" : undefined)}
+                disabled={composerDisabled || running || batchPending || !!configurationBusy || execution.loading || executionReadOnly}
+                onSetAgent={agent => execution.save({ agent, model: null, reasoning: null, permission_mode: null })}
+                onSetModel={model => execution.save({ model })} onSetReasoning={reasoning => execution.save({ reasoning })}
+                onSetPermission={permission_mode => execution.save({ permission_mode })} />
+              {slots?.composerToolbar}
+            </>}
             queued={<QueuedMessages scopeKey={key ?? "new"} messages={queued} onCancel={handlers.onCancelQueued} attachmentUrl={handlers.attachmentUrl} />}
             onSend={async text => { if (text.trim() === "/clear" && onClear) { onClear(); return; } const sentFrom = key; await send(text); if (!running && !batchPending && latest.current.key === sentFrom) scrollToBottom("auto"); }}
             onStop={cfg.composer.stop && key && conv && runningTurn(conv) ? stop : undefined}

package/src/chat/Composer.tsx

@@ -109,10 +109,11 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
   const tooLong = total > MAX_MESSAGE_CHARS;
   const reading = pending.some((p) => p.status === "reading");
   // 运行中不允许排队时，等这一轮结束再发。
-  const canSend = !!message.trim() && !pending.length && !reading && !tooLong && !sending && (!running || options.queue);
+  const canSend = !!message.trim() && !pending.length && !reading && !tooLong && !sending && !stopping && (!running || options.queue);
+  const showStop = running && !!onStop && !sending && (stopping || disabled || !options.queue || !message.trim());
 
   const submit = async () => {
-    if (!canSend || disabled || readComposerDraft(draft).sending) return;
+    if (!canSend || disabled || stopLock.current || readComposerDraft(draft).sending) return;
     const submitted = JSON.stringify([val, blocks]);
     setSending(true);
     setError(null);
@@ -138,7 +139,7 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
       stopLock.current = true; setStopping(true); setError(null);
       try { await onStop(); } catch (error) { stopLock.current = false; setStopping(false); setError(error instanceof Error ? error.message : "停止失败，请重试"); }
     }}
-      disabled={stopping} aria-busy={stopping} aria-label={stopping ? "正在停止" : "停止当前轮次"} title={stopping ? "正在停止…" : "停止当前轮次"}>{Icon.stop()}</button>
+      disabled={stopping} aria-busy={stopping} aria-label={stopping ? "正在停止" : "停止当前轮次"} title={stopping ? "正在停止…" : "停止当前轮次"}>{stopping ? <span className="spinner" /> : Icon.stop()}</button>
   );
 
   return (
@@ -224,12 +225,11 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
                 onClick={async () => { if (controlLock.current) return; controlLock.current = true; setControlling(true); try { await taskControl.onToggle(); } catch (error) { setError(error instanceof Error ? error.message : "执行控制失败，请重试"); } finally { controlLock.current = false; setControlling(false); } }}>
                 {taskControl.paused ? Icon.play() : Icon.pause()}<span>{controlling ? "处理中…" : taskControl.paused ? "继续" : "暂停"}</span>
               </button>}
-              {(!running || options.queue) && <button type="button" className={`send cli-send${running ? " queue" : ""}`} disabled={disabled || !canSend} aria-busy={sending}
+              {showStop ? stopButton : (!running || options.queue) && <button type="button" className={`send cli-send${running ? " queue" : ""}`} disabled={disabled || !canSend} aria-busy={sending}
                 onClick={() => void submit()} aria-label={sending ? "正在发送" : running ? "排队发送" : "发送消息"}
-                title={taskControl?.paused ? "排队发送，继续任务后依次执行" : running ? "排队发送，当前轮次结束后执行" : "发送消息（Enter）"}>
-                {Icon.send()}<span>{sending ? "发送中…" : running ? "排队发送" : "发送"}</span>
+                title={sending ? "发送中…" : taskControl?.paused ? "排队发送，继续任务后依次执行" : running ? "排队发送，当前轮次结束后执行" : "发送消息（Enter）"}>
+                {sending ? <span className="spinner" /> : Icon.send()}
               </button>}
-              {stopButton}
             </div>
           </div>
         </div>

package/src/chat/RunControls.tsx

@@ -21,6 +21,9 @@ export type RunControlProps = {
   caps?: RunCapabilities;
   defaults?: { model?: string | null; reasoning?: string | null; permission_mode?: string | null };
   disabled: boolean;
+  showAgent?: boolean;
+  showPermission?: boolean;
+  unavailableReason?: string;
   onSetModel: (value: string | null) => Promise<void>;
   onSetReasoning: (value: string | null) => Promise<void>;
   onSetPermission: (value: string | null) => Promise<void>;
@@ -29,7 +32,7 @@ export type RunControlProps = {
 
 // Both the pre-start view and composer use the same capability-driven controls.
 // Await persistence before allowing Send so the next turn uses the chosen value.
-export function RunControls({ task, agents, onSetAgent, caps, defaults, disabled, onSetModel, onSetReasoning, onSetPermission, onBusyChange }: RunControlProps) {
+export function RunControls({ task, agents, onSetAgent, caps, defaults, disabled, showAgent = true, showPermission = true, unavailableReason, onSetModel, onSetReasoning, onSetPermission, onBusyChange }: RunControlProps) {
   const [open, setOpen] = useState<"model" | "permission" | null>(null);
   const [modelPage, setModelPage] = useState<"agents" | "settings" | "models">("agents");
   const [switching, setSwitching] = useState<{ agent: string; saved: boolean } | null>(null);
@@ -79,6 +82,10 @@ export function RunControls({ task, agents, onSetAgent, caps, defaults, disabled
     finally { release(); onBusyChange?.(false); }
   };
   const locked = disabled || busy || !!switching || !caps;
+  const permissionAvailable = !!caps?.permissionModes.length;
+  useEffect(() => {
+    if ((open === "model" && (!showAgent || !caps)) || (open === "permission" && (!showPermission || !permissionAvailable))) setOpen(null);
+  }, [open, showAgent, showPermission, caps, permissionAvailable]);
   const pickAgent = async (agent: string) => {
     if (locked || !onSetAgent) return;
     setError(""); setCustom("");
@@ -108,11 +115,11 @@ export function RunControls({ task, agents, onSetAgent, caps, defaults, disabled
     return groups;
   }, []);
   return <>
-    {!!caps?.permissionModes.length && <div className="comp-control">
-      <button className={`comp-setting permission${effectivePermission === "bypassPermissions" ? " elevated" : ""}`} disabled={locked} aria-label="权限模式" aria-expanded={open === "permission"} aria-haspopup="dialog" title={disabled ? "本轮结束后可修改权限" : permission?.sub} onClick={(e) => { e.stopPropagation(); setError(""); setOpen(open === "permission" ? null : "permission"); }}>
+    {showPermission && <div className="comp-control">
+      <button className={`comp-setting permission${effectivePermission === "bypassPermissions" ? " elevated" : ""}`} disabled={locked || !permissionAvailable} aria-label="权限模式" aria-expanded={open === "permission"} aria-haspopup="dialog" title={unavailableReason || (!permissionAvailable ? "当前智能体暂未提供执行模式设置" : disabled ? "本轮结束后可修改权限" : permission?.sub)} onClick={(e) => { e.stopPropagation(); setError(""); setOpen(open === "permission" ? null : "permission"); }}>
         {Icon.lock()} <span>{permission?.value ? permission.label : "默认权限"}</span>{Icon.chevDown()}
       </button>
-      {open === "permission" && <Popover onClose={() => setOpen(null)} className="composer-popover composer-permission-popover" ariaLabel="权限模式" placement="top" align="start">
+      {open === "permission" && permissionAvailable && <Popover onClose={() => setOpen(null)} className="composer-popover composer-permission-popover" ariaLabel="权限模式" placement="top" align="start">
         <div className="composer-menu-heading">权限模式</div>
         <p className="composer-menu-note">保存后用于下一轮</p>
         {permissions.map((p) => <button key={p.value ?? "default"} className="pop-item composer-option run-permission-option" disabled={locked} aria-pressed={(task.permission_mode ?? null) === p.value} onClick={() => void change(() => onSetPermission(p.value))}>
@@ -124,11 +131,11 @@ export function RunControls({ task, agents, onSetAgent, caps, defaults, disabled
         {error && <div className="control-error" role="alert">{error}</div>}
       </Popover>}
     </div>}
-    <div className="comp-control comp-model">
-      <button className="comp-setting" disabled={locked} aria-label="智能体设置" aria-expanded={open === "model"} aria-haspopup="dialog" title={disabled ? "本轮结束后可修改智能体设置" : `当前智能体：${currentAgent}`} onClick={(e) => { e.stopPropagation(); setError(""); setCustom(""); setModelPage(hasAgentPicker ? "agents" : "settings"); setOpen(open === "model" ? null : "model"); }}>
+    {showAgent && <div className="comp-control comp-model">
+      <button className="comp-setting" disabled={locked} aria-label="智能体设置" aria-expanded={open === "model"} aria-haspopup="dialog" title={unavailableReason || (!caps ? "当前服务暂未提供智能体设置" : disabled ? "本轮结束后可修改智能体设置" : `当前智能体：${currentAgent}`)} onClick={(e) => { e.stopPropagation(); setError(""); setCustom(""); setModelPage(hasAgentPicker ? "agents" : "settings"); setOpen(open === "model" ? null : "model"); }}>
         <span className="comp-model-name">{currentAgent}</span>{Icon.chevDown()}
       </button>
-      {open === "model" && <Popover onClose={() => setOpen(null)} className="composer-popover composer-agent-popover" ariaLabel={modelPage === "agents" ? "选择智能体" : modelPage === "models" ? "选择模型" : "模型与推理设置"} placement="top" align="end">
+      {open === "model" && caps && <Popover onClose={() => setOpen(null)} className="composer-popover composer-agent-popover" ariaLabel={modelPage === "agents" ? "选择智能体" : modelPage === "models" ? "选择模型" : "模型与推理设置"} placement="top" align="end">
         {modelPage === "agents" ? <div ref={agentListRef} className="run-agent-list">
           <div className="composer-menu-heading">选择智能体</div>
           {availableAgents.map(agent => <button key={agent.id} className="pop-item composer-option run-agent-option" disabled={locked || agent.disabled} aria-pressed={task.agent === agent.id} onClick={() => void pickAgent(agent.id)}>
@@ -184,6 +191,6 @@ export function RunControls({ task, agents, onSetAgent, caps, defaults, disabled
         {(busy || switching) && <div className="composer-menu-note" role="status">{switching ? "正在切换智能体…" : "正在保存…"}</div>}
         {error && <div className="control-error" role="alert">{error}</div>}
       </Popover>}
-    </div>
+    </div>}
   </>;
 }

package/src/chat/draft.ts

@@ -1,8 +1,9 @@
 import { useSyncExternalStore } from "react";
 import type { TextBlock } from "../core/blocks";
 import type { UploadPhase } from "../core/documentUpload";
+import type { ExecutionOptions } from "../core/execution";
 export type PendingFile = { key: string; name: string; status: "reading" | "error"; error?: string; progress?: string; phase?: UploadPhase; bytes?: number; size?: number };
-export interface ComposerDraft { text: string; blocks: Array<TextBlock & { key: string }>; pending: PendingFile[]; sending: boolean; error: string | null; revision: number }
+export interface ComposerDraft { text: string; blocks: Array<TextBlock & { key: string }>; pending: PendingFile[]; sending: boolean; error: string | null; revision: number; executionConfig?: ExecutionOptions; executionUncertain?: boolean }
 const empty = (): ComposerDraft => ({ text: "", blocks: [], pending: [], sending: false, error: null, revision: 0 });
 const server = empty();
 const entries = new Map<string, { state: ComposerDraft; stamp: string }>();
@@ -18,6 +19,10 @@ export function readComposerDraft(id: string): ComposerDraft {
     state.text = localStorage.getItem(textKey(id)) ?? "";
     const data = JSON.parse(localStorage.getItem(dataKey(id)) ?? "null");
     if (data?.version === 1) {
+      if (data.executionUncertain === true) state.executionUncertain = true;
+      if (data.executionConfig && typeof data.executionConfig === "object") state.executionConfig = Object.fromEntries(
+        Object.entries(data.executionConfig).filter(([key, value]) => ["agent", "model", "reasoning", "permission_mode"].includes(key) && (typeof value === "string" || value === null)),
+      );
       state.blocks = Array.isArray(data.blocks) ? data.blocks.filter((b: TextBlock & { key: string }) => typeof b?.text === "string" && typeof b?.key === "string") : [];
       state.pending = Array.isArray(data.pending) ? data.pending.map((p: PendingFile) => ({ ...p, status: "error", error: p.phase
         ? `${p.error || "页面重载中断了上传。"}${p.error?.includes("重新选择文件") ? "" : " 请重新选择文件。"}`
@@ -32,7 +37,7 @@ export function updateComposerDraft(id: string, update: (state: ComposerDraft) =
   const state = { ...update(previous), revision: previous.revision + 1 };
   try {
     if (state.text) localStorage.setItem(textKey(id), state.text); else localStorage.removeItem(textKey(id));
-    if (state.blocks.length || state.pending.length) localStorage.setItem(dataKey(id), JSON.stringify({ version: 1, blocks: state.blocks, pending: state.pending })); else localStorage.removeItem(dataKey(id));
+    if (state.blocks.length || state.pending.length || state.executionConfig || state.executionUncertain) localStorage.setItem(dataKey(id), JSON.stringify({ version: 1, blocks: state.blocks, pending: state.pending, executionConfig: state.executionConfig, executionUncertain: state.executionUncertain })); else localStorage.removeItem(dataKey(id));
   } catch { /* Keep the in-memory draft even if storage is full. */ }
   entries.set(id, { state, stamp: stamp(id) });
   listeners.forEach(listener => listener());

package/src/chat/useExecutionConfig.ts

@@ -0,0 +1,93 @@
+import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
+import { CenterError, type ConversationBackend } from "../core/client";
+import type { ExecutionConfiguration, ExecutionOptions } from "../core/execution";
+import { isConfigurationBusy, useConfigurationBusy } from "./configuration";
+import { readComposerDraft, updateComposerDraft, useComposerDraft } from "./draft";
+
+const errorText = (error: unknown) => error instanceof CenterError && [404, 405, 501].includes(error.status)
+  ? "当前服务尚未支持执行设置，请升级配套服务。"
+  : error instanceof Error ? error.message : "执行设置读取失败，请重试。";
+
+function validate(result: ExecutionConfiguration) {
+  if (!result || typeof result.agent !== "string" || !Number.isSafeInteger(result.revision) || result.revision < 0 || !Array.isArray(result.agents)
+    || result.agents.some(agent => typeof agent?.id !== "string" || typeof agent.label !== "string" || !agent.capabilities
+      || [agent.capabilities.models, agent.capabilities.reasoningOptions, agent.capabilities.permissionModes].some(options => !Array.isArray(options)
+        || options.some(option => typeof option?.value !== "string" || typeof option.label !== "string")))) {
+    throw new Error("服务未返回有效的执行设置，请检查配套服务版本。");
+  }
+}
+
+/** 按对话隔离读取与保存，不轮询；换对话后的迟到响应不覆盖当前选择。 */
+export function useExecutionConfig({ client, scope, target, enabled, initial, running }: {
+  client: ConversationBackend; scope: string; target: string | null; enabled: boolean;
+  initial?: ExecutionOptions; running: boolean;
+}) {
+  const [view, setView] = useState<{ scope: string; config?: ExecutionConfiguration; error?: string; loading: boolean; saveFailed?: boolean }>({ scope, loading: false });
+  const current = useRef(scope);
+  const request = useRef(0);
+  const mounted = useRef(true);
+  useLayoutEffect(() => { current.current = scope; request.current++; }, [scope]);
+  useEffect(() => { mounted.current = true; return () => { mounted.current = false; request.current++; }; }, []);
+  const draft = useComposerDraft(scope);
+  const busy = useConfigurationBusy(scope);
+  const config = view.scope === scope ? view.config : undefined;
+  const reload = useCallback(async () => {
+    const serial = ++request.current;
+    const active = () => mounted.current && current.current === scope && request.current === serial;
+    if (!enabled && !readComposerDraft(scope).executionUncertain) return;
+    if (!client.getExecutionConfig) {
+      setView({ scope, loading: false, error: "当前接入尚未提供执行设置。" });
+      return;
+    }
+    setView(value => ({ ...(value.scope === scope ? value : {}), scope, loading: true }));
+    try {
+      const result = await client.getExecutionConfig(target);
+      validate(result);
+      if (active()) {
+        if (!isConfigurationBusy(scope) && readComposerDraft(scope).executionUncertain) updateComposerDraft(scope, draft => ({ ...draft, executionUncertain: false }));
+        setView({ scope, config: result, loading: false });
+      }
+    } catch (error) {
+      if (active()) setView(value => ({ ...(value.scope === scope ? value : {}), scope, error: errorText(error), loading: false }));
+    }
+  }, [client, scope, target, enabled]);
+  useEffect(() => { void reload(); return () => { request.current++; }; }, [reload]);
+  const wasRunning = useRef(running);
+  useEffect(() => {
+    if (wasRunning.current && !running && !isConfigurationBusy(scope)) void reload();
+    wasRunning.current = running;
+  }, [running, reload, scope]);
+
+  const local = target === null ? { ...initial, ...draft.executionConfig } : undefined;
+  const selected = config ? { ...config, ...local } : undefined;
+  const save = async (changes: ExecutionOptions) => {
+    if (!config || !enabled || running) throw new Error("当前无法修改执行设置，请稍后重试。");
+    if (target === null) {
+      updateComposerDraft(scope, value => ({ ...value, executionConfig: { agent: config.agent, ...initial, ...value.executionConfig, ...changes } }));
+      return;
+    }
+    if (!client.setExecutionConfig) throw new Error("当前接入尚未提供保存执行设置的接口。");
+    // An earlier GET must not overwrite the response to this save.
+    const serial = ++request.current;
+    updateComposerDraft(scope, draft => ({ ...draft, executionUncertain: true }));
+    try {
+      const result = await client.setExecutionConfig(target, changes, config.revision);
+      validate(result);
+      updateComposerDraft(scope, draft => ({ ...draft, executionUncertain: false }));
+      if (mounted.current && current.current === scope && request.current === serial) setView({ scope, config: result, loading: false });
+    } catch (error) {
+      if (mounted.current && current.current === scope && request.current === serial) setView({ scope, config, loading: false, saveFailed: true, error: `${errorText(error)} 请重新读取设置后再发送。` });
+      throw error;
+    }
+  };
+  return {
+    config: selected, busy, loading: view.scope === scope && view.loading,
+    error: view.scope === scope && (enabled || view.saveFailed || draft.executionUncertain) ? view.error ?? (draft.executionUncertain && !busy ? "执行设置尚未确认，请重新读取后再发送。" : undefined) : undefined,
+    blocked: busy || !!draft.executionUncertain || (view.scope === scope && !!view.saveFailed), reload, save,
+    /** Read at submit time, including changes committed before React paints. */
+    prepareSend: () => {
+      if (isConfigurationBusy(scope) || readComposerDraft(scope).executionUncertain || (view.scope === scope && view.saveFailed)) throw new Error("请等待执行设置保存或重新读取设置后再发送。");
+      return target === null ? { executionConfig: readComposerDraft(scope).executionConfig } : { expectedExecutionRevision: config?.revision };
+    },
+  };
+}

package/src/components.tsx

@@ -9,5 +9,5 @@ export interface CliMsgListProps extends CenterMsgListProps { operator?: Compone
 export interface CliChatProps extends CenterChatProps { operator?: ComponentProps<typeof SessionView> }
 export interface CliBoardProps extends CenterBoardProps { operator?: ComponentProps<typeof SessionRail> }
 export function CliMsgList(props: CliMsgListProps) { return props.operator ? <TasksColumn {...props.operator}/> : <CenterMsgList {...props}/>; }
-export function CliChat(props: CliChatProps) { return props.operator ? <SessionView {...props.operator} board={{...props.operator.board,autoContext:props.operator.board?.autoContext??props.passiveContext,onFilesChange:props.operator.board?.onFilesChange??props.onFilesChange,onFilesWatch:props.operator.board?.onFilesWatch??props.onFilesWatch,onBoardContextChange:props.operator.board?.onBoardContextChange??props.onBoardContextChange}}/> : <CenterChat {...props}/>; }
+export function CliChat(props: CliChatProps) { return props.operator ? <SessionView {...props.operator} composer={props.config?.composer ?? props.operator.composer} board={{...props.operator.board,autoContext:props.operator.board?.autoContext??props.passiveContext,onFilesChange:props.operator.board?.onFilesChange??props.onFilesChange,onFilesWatch:props.operator.board?.onFilesWatch??props.onFilesWatch,onBoardContextChange:props.operator.board?.onBoardContextChange??props.onBoardContextChange}}/> : <CenterChat {...props}/>; }
 export function CliBoard(props: CliBoardProps) { return props.operator ? <SessionRail key={props.operator.task.id} {...props.operator} tabs={props.operator.tabs ?? props.tabs} availableTabs={props.operator.availableTabs ?? props.availableTabs} defaultTab={props.operator.defaultTab ?? props.defaultTab} autoContext={props.operator.autoContext ?? props.autoQuoteOpenFile} watchFiles={props.operator.watchFiles ?? props.watchFiles} fileWatchIntervalMs={props.operator.fileWatchIntervalMs ?? props.fileWatchIntervalMs} onFilesChange={props.operator.onFilesChange ?? props.onFilesChange} onFilesWatch={props.operator.onFilesWatch ?? props.onFilesWatch} onBoardContextChange={props.operator.onBoardContextChange ?? props.onBoardContextChange} onEvent={props.operator.onEvent ?? props.onEvent}/> : <CenterBoard {...props}/>; }

package/src/core/client.ts

@@ -8,6 +8,7 @@ import { decodeText } from "./textDecode";
 import { createDocumentUploader, extractDocumentReferences, documentRequest, isTaskUploadPath, type UploadDocument, type DocumentUploadOptions, type DocumentReceipt } from "./documentUpload";
 import { syncFile, type FileSyncTransport } from "../board/fileSync";
 import { createFileSyncTransport } from "../board/fileSyncTransport";
+import type { ExecutionConfiguration, ExecutionOptions } from "./execution";
 
 /**
  * center 服务（cli-task-center）对话任务接口的浏览器端客户端。组件的数据全部从这里来。
@@ -95,6 +96,10 @@ const ERROR_TEXT: Record<string, string> = {
  * 带 ? 的是可选能力：后端不提供，界面就按 Operator 在「没有这个能力」时的样子显示（例如提问的回答改走下一条消息）。
  */
 export interface ConversationBackend {
+  /** 无 key 时读取新对话可用设置；有 key 时读取该对话的已保存设置。 */
+  getExecutionConfig?(key?: string | null): Promise<ExecutionConfiguration>;
+  /** 保存成功才切换界面；服务端用 revision 防止并发覆盖。 */
+  setExecutionConfig?(key: string, changes: ExecutionOptions, expectedRevision: number): Promise<ExecutionConfiguration>;
   /** Upload original HTML/Markdown without embedding document bytes in a message. */
   uploadDocument?: UploadDocument;
   baseUrl: string;
@@ -109,7 +114,7 @@ export interface ConversationBackend {
   history?(jobId: string, remote: string, before: string, limit?: number): Promise<{ messages: Message[]; older: number }>;
   createConversation(firstMessage: string, opts?: NewConversationOptions & { businessId?: string }): Promise<{ id: string; job_id: string; status: string; task_ids?: string[]; turn: CenterTurn }>;
   /** taskId：发给对话任务里的哪个对话，不给 = 第一个。 */
-  sendMessage(jobId: string, text: string, opts?: { businessId?: string; timeoutSeconds?: number; taskId?: string }): Promise<SendResult>;
+  sendMessage(jobId: string, text: string, opts?: { businessId?: string; timeoutSeconds?: number; taskId?: string; expectedExecutionRevision?: number }): Promise<SendResult>;
   /**
    * 一次性任务里的对话式子任务接着聊：续派一条 mode=conversation、continue_from 这个子任务的子任务（接在同一个 Agent 会话里）。
    * 返回新子任务的 id。
@@ -119,7 +124,7 @@ export interface ConversationBackend {
   pauseTask?(taskId: string): Promise<CenterTask>;
   resumeTask?(taskId: string): Promise<CenterTask>;
   /** 在对话任务里新开一个对话（同一节点、同一工作区），text 是它的第一条消息。 */
-  openConversation?(jobId: string, text: string, opts?: { title?: string; agent?: string; browser?: boolean; businessId?: string; timeoutSeconds?: number }): Promise<SendResult>;
+  openConversation?(jobId: string, text: string, opts?: { title?: string; agent?: string; executionConfig?: ExecutionOptions; browser?: boolean; businessId?: string; timeoutSeconds?: number }): Promise<SendResult>;
   cancelTurn(jobId: string, turnId: string): Promise<CenterTurn>;
   closeConversation(jobId: string): Promise<{ id: string; status: string }>;
   /** 只关掉对话任务里的一个对话（别的对话和对话任务照常）。 */
@@ -297,9 +302,18 @@ export function createCenterClient(options: CenterClientOptions = {}): Conversat
 
   const post = <T>(path: string, body: unknown = {}) => request<T>(path, { method: "POST", body: JSON.stringify(body) });
   const id = encodeURIComponent;
+  const executionPath = (key?: string | null) => {
+    if (!key) return "/api/execution-config";
+    const ref = parseConvKey(key);
+    return `/api/jobs/${id(ref.jobId)}/execution-config${ref.taskId && ref.taskId !== NEW_TASK ? `?task_id=${id(ref.taskId)}` : ""}`;
+  };
 
   return {
     baseUrl: base,
+    getExecutionConfig: key => request<ExecutionConfiguration>(executionPath(key)),
+    setExecutionConfig: (key, changes, expectedRevision) => request<ExecutionConfiguration>(executionPath(key), {
+      method: "PATCH", body: JSON.stringify({ ...changes, expected_revision: expectedRevision }),
+    }),
     uploadDocument: createDocumentUploader(doFetch, `${base}/api/file-sync`, headers),
     getJob: (jobId: string) => request<CenterJob>(`/api/jobs/${id(jobId)}`),
     listTurns: (jobId: string, query: { afterSeq?: number; limit?: number; taskId?: string } = {}) => {
@@ -345,6 +359,7 @@ export function createCenterClient(options: CenterClientOptions = {}): Conversat
           ...(extractDocumentReferences(firstMessage).attachments ? { attachments: extractDocumentReferences(firstMessage).attachments } : {}),
           ...(opts.businessId ? { business_id: opts.businessId } : {}),
           ...(opts.agent ? { agent: opts.agent } : {}),
+          ...(opts.executionConfig ? { execution_config: opts.executionConfig } : {}),
           ...(opts.timeoutSeconds ? { timeout_seconds: opts.timeoutSeconds } : {}),
           ...(opts.browser !== undefined ? { browser: opts.browser } : {}),
           ...(opts.browserPlaybook !== undefined ? { browser_playbook: opts.browserPlaybook } : {}),
@@ -353,10 +368,11 @@ export function createCenterClient(options: CenterClientOptions = {}): Conversat
       });
     },
     /** 带 business_id 时 center 按它去重，网络超时可以放心重发同一条。 */
-    sendMessage: (jobId: string, text: string, opts: { businessId?: string; timeoutSeconds?: number; taskId?: string } = {}) =>
+    sendMessage: (jobId: string, text: string, opts: { businessId?: string; timeoutSeconds?: number; taskId?: string; expectedExecutionRevision?: number } = {}) =>
       post<SendResult>(`/api/jobs/${id(jobId)}/messages`, {
         ...extractDocumentReferences(text),
         ...(opts.taskId ? { task_id: opts.taskId } : {}),
+        ...(opts.expectedExecutionRevision !== undefined ? { expected_execution_revision: opts.expectedExecutionRevision } : {}),
         ...(opts.businessId ? { business_id: opts.businessId } : {}),
         ...(opts.timeoutSeconds ? { timeout_seconds: opts.timeoutSeconds } : {}),
       }),
@@ -370,11 +386,12 @@ export function createCenterClient(options: CenterClientOptions = {}): Conversat
     pauseTask: (taskId: string) => post<CenterTask>(`/api/tasks/${id(taskId)}/pause`, {}),
     resumeTask: (taskId: string) => post<CenterTask>(`/api/tasks/${id(taskId)}/resume`, {}),
     /** 同一个 business_id 重发只开一个对话。 */
-    openConversation: (jobId: string, text: string, opts: { title?: string; agent?: string; browser?: boolean; businessId?: string; timeoutSeconds?: number } = {}) =>
+    openConversation: (jobId: string, text: string, opts: { title?: string; agent?: string; executionConfig?: ExecutionOptions; browser?: boolean; businessId?: string; timeoutSeconds?: number } = {}) =>
       post<SendResult>(`/api/jobs/${id(jobId)}/conversations`, {
         ...extractDocumentReferences(text),
         ...(opts.title ? { title: opts.title } : {}),
         ...(opts.agent ? { agent: opts.agent } : {}),
+        ...(opts.executionConfig ? { execution_config: opts.executionConfig } : {}),
         ...(opts.browser !== undefined ? { browser: opts.browser } : {}),
         ...(opts.businessId ? { business_id: opts.businessId } : {}),
         ...(opts.timeoutSeconds ? { timeout_seconds: opts.timeoutSeconds } : {}),

package/src/core/config.ts

@@ -45,6 +45,10 @@ export interface CliChatConfig {
     charCount?: boolean;
     /** 文件上传（按钮、拖拽、粘贴文件）。只收文档：Word、Excel、Markdown、TXT、HTML、CSV。 */
     fileUpload?: boolean;
+    /** 智能体选择入口，默认显示；缺少服务端能力时禁用。 */
+    agentSelector?: boolean;
+    /** 执行模式选择入口，默认显示；缺少服务端能力时禁用。 */
+    executionMode?: boolean;
     /** 「文件」按钮的文字。 */
     fileButtonText?: string;
     /** 执行控制：普通对话停止当前轮次，一次性子任务暂停 / 继续。 */
@@ -87,7 +91,7 @@ export interface ResolvedChatConfig {
   header: { show: boolean; crumb: boolean; export: boolean; title: boolean; agent: boolean; usage: boolean; model: boolean; status: boolean; close: boolean };
   composer: {
     show: boolean; placeholder: string; placeholderNew: string; placeholderRunning: string; placeholderDisabled: string | null;
-    hints: boolean; charCount: boolean; fileUpload: boolean; fileButtonText: string; stop: boolean; queue: boolean;
+    hints: boolean; charCount: boolean; fileUpload: boolean; agentSelector: boolean; executionMode: boolean; fileButtonText: string; stop: boolean; queue: boolean;
   };
   transcript: { nav: boolean; sessionLabel: boolean; timestamps: boolean; initialPrompt: boolean; initialBadge: boolean; tools: boolean; runningIndicator: boolean; status: boolean };
   labels: { user: string; agent: string };
@@ -108,7 +112,7 @@ export const DEFAULT_CHAT_CONFIG: ResolvedChatConfig = {
     placeholderNew: "输入消息，开始新对话…",
     placeholderRunning: "排队一条后续消息…（本轮结束后发送）",
     placeholderDisabled: null,
-    hints: true, charCount: true, fileUpload: true, fileButtonText: "文件", stop: true, queue: true,
+    hints: false, charCount: false, fileUpload: true, agentSelector: true, executionMode: true, fileButtonText: "", stop: true, queue: true,
   },
   transcript: { nav: true, sessionLabel: true, timestamps: true, initialPrompt: false, initialBadge: true, tools: true, runningIndicator: true, status: false },
   labels: { user: "你", agent: "智能体" },

package/src/core/execution.ts

@@ -0,0 +1,24 @@
+import type { RunCapabilities } from "../chat/RunControls";
+
+/** 用户选择的下一轮执行设置；不包含账号或凭据。null 表示使用服务端默认值。 */
+export interface ExecutionOptions {
+  agent?: string;
+  model?: string | null;
+  reasoning?: string | null;
+  permission_mode?: string | null;
+}
+
+export interface ExecutionConfiguration {
+  revision: number;
+  agent: string;
+  model: string | null;
+  reasoning: string | null;
+  permission_mode: string | null;
+  agents: Array<{
+    id: string;
+    label: string;
+    disabled?: boolean;
+    capabilities: RunCapabilities;
+    defaults?: Omit<ExecutionOptions, "agent">;
+  }>;
+}

package/src/core/store.ts

@@ -153,7 +153,7 @@ export interface CliStoreOptions extends CenterClientOptions {
    */
   newConversation?: NewConversationOptions;
   /** 自己建对话（例如经业务后端建，以便把回调密钥留在服务端）：返回 center 的 job_id。 */
-  createConversation?: (firstMessage: string) => Promise<string>;
+  createConversation?: (firstMessage: string, options?: NewConversationOptions) => Promise<string>;
   /**
    * 每条消息的 business_id（center 按它去重，回调里原样带回）。缺省 `cli-<uuid>`。
    * kind = "create" 是第一条（新建对话），"message" 是之后的每条。
@@ -163,10 +163,12 @@ export interface CliStoreOptions extends CenterClientOptions {
 
 /** 发一条消息时可以单独指定的新建参数（组件自己的 props），优先于仓库的。 */
 export interface SendOptions {
+  expectedExecutionRevision?: number;
+  executionConfig?: import("./execution").ExecutionOptions;
   /** 新建对话后是否改仓库的选中（缺省改）。 */
   select?: boolean;
   newConversation?: NewConversationOptions;
-  createConversation?: (firstMessage: string) => Promise<string>;
+  createConversation?: (firstMessage: string, options?: NewConversationOptions) => Promise<string>;
   businessIdFor?: (text: string, kind: "create" | "message") => string;
 }
 
@@ -601,7 +603,8 @@ export function createCliStore(options: CliStoreOptions = {}) {
 
   async function sendWithText(key: string | null, text: string, overrides: SendOptions): Promise<string> {
     // 发消息的组件自己的参数优先（同一个仓库里可以有几个对话组件，各带各的新建参数），没有再用仓库的。
-    const newConversation = overrides.newConversation ?? options.newConversation;
+    const originalOptions = overrides.newConversation ?? options.newConversation;
+    const newConversation = overrides.executionConfig ? { ...originalOptions, agent: overrides.executionConfig.agent ?? originalOptions?.agent, executionConfig: overrides.executionConfig } : originalOptions;
     const createConversation = overrides.createConversation ?? options.createConversation;
     const businessIdFor = overrides.businessIdFor ?? options.businessIdFor;
     const ref = key ? parseConvKey(key) : null;
@@ -610,7 +613,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
       if (ref?.taskId === NEW_TASK) {
         // 在对话任务里新开一个对话：标题取第一行，智能体 / 浏览器模式沿用对话任务的第一个对话（center 决定）。
         if (!client.openConversation) throw new CenterError("当前后端不支持在对话任务里新开对话", "UNSUPPORTED", 0);
-        const result = await retryOnce(() => client.openConversation!(ref.jobId, text, { title: firstLine(text, 60), businessId }));
+        const result = await retryOnce(() => client.openConversation!(ref.jobId, text, { title: firstLine(text, 60), businessId, agent: newConversation?.agent, executionConfig: newConversation?.executionConfig, browser: newConversation?.browser, timeoutSeconds: newConversation?.timeoutSeconds }));
         const target = convKey(result.job_id, result.task_id ?? result.turn.task_id);
         patchConv(target, (conv) => ({ ...conv, turns: addTurnsIfAbsent(conv.turns, [{ ...result.turn, queue_position: result.queue_position }]) }));
         addJobIfMissing(result.job_id);
@@ -623,7 +626,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
         const selectedBeforeCreate = state.selected;
         let newId: string;
         if (createConversation) {
-          newId = await createConversation(text);
+          newId = newConversation?.executionConfig ? await createConversation(text, newConversation) : await createConversation(text);
         } else {
           // 新建只发一次：center 的 POST /api/jobs 没有幂等，建好了却没收到响应时重发会建出第二个对话。
           const created = await client.createConversation(text, { ...newConversation, title: newConversation?.title || firstLine(text), businessId: newConversation?.businessId || businessId });
@@ -653,7 +656,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
         void refreshJob(ref.jobId, true);
         return key;
       }
-      const result = await retryOnce(() => client.sendMessage(ref.jobId, text, { businessId, ...(ref.taskId ? { taskId: ref.taskId } : {}) }));
+      const result = await retryOnce(() => client.sendMessage(ref.jobId, text, { businessId, ...(ref.taskId ? { taskId: ref.taskId } : {}), ...(overrides.expectedExecutionRevision !== undefined ? { expectedExecutionRevision: overrides.expectedExecutionRevision } : {}) }));
       const jobTarget = result.job_id || ref.jobId;
       // 指定了对话的：接续后跟到新对话任务里对应的那个对话；只有 job_id 的照旧只换 job。
       const target = ref.taskId ? convKey(jobTarget, result.task_id ?? result.turn.task_id ?? ref.taskId) : jobTarget;
@@ -959,6 +962,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
 
   return {
     client,
+    getNewConversationOptions: () => options.newConversation,
     draftScope: connectionDraftScope(options),
     getState: () => state,
     /** 在看板里打开文件 / 浏览器 / 改动。返回有没有看板接住。 */

package/src/core/types.ts

@@ -131,6 +131,8 @@ export interface BrowserPacing {
 
 /** 新建对话时可带的参数（POST /api/jobs，mode=conversation）。 */
 export interface NewConversationOptions {
+  /** 首轮执行配置。由服务端校验、持久化，并用于后续派发和重试。 */
+  executionConfig?: import("./execution").ExecutionOptions;
   title?: string;
   /** 业务自己的 ID（tasks[0].business_id）：第一轮的回调里原样带回，用来和业务数据对应。 */
   businessId?: string;

package/src/index.ts

@@ -43,6 +43,7 @@ export {
   type TextBlock, type MessagePart,
 } from "./core/blocks";
 export type * from "./core/types";
+export type { ExecutionOptions, ExecutionConfiguration } from "./core/execution";
 
 
 export { RunControls, type RunControlProps, type RunCapabilities, type RunTask } from "./chat/RunControls";