@steerable/agent-shell-web 0.6.20 → 0.6.22

package/src/lib/local-api.ts

@@ -332,6 +332,37 @@ export async function cancelChatTurn(chatId: string) {
   });
 }
 
+/**
+ * 用系统默认应用打开本地绝对路径（回合产物列表的点击行为）。
+ * 成功时后端返回 `{ success: true }`；打开失败返回 `{ success: false, error }`。
+ */
+export async function openLocalPath(targetPath: string) {
+  return bridge().localBackend.request<{ success: boolean; error?: string }>({
+    method: 'POST',
+    path: '/api/v2/local/open-path',
+    body: { path: targetPath },
+  });
+}
+
+/** 后端确认存在的路径：`candidate` 是正文里的原字面量，`path` 是落地绝对路径。 */
+export interface ResolvedLocalPath {
+  candidate: string;
+  path: string;
+  isDirectory: boolean;
+}
+
+/**
+ * 批量确认正文里提到的路径是否真实存在（用于决定行内代码要不要变成可点击）。
+ * 相对路径由后端按对话绑定的项目根解析，无项目时按 home；不存在的候选不回。
+ */
+export async function resolveLocalPaths(candidates: string[], chatId?: string | null) {
+  return bridge().localBackend.request<{ resolved: ResolvedLocalPath[] }>({
+    method: 'POST',
+    path: '/api/v2/local/resolve-paths',
+    body: { candidates, ...(chatId ? { chatId } : {}) },
+  });
+}
+
 /* ---------------- Projects（项目模式） ---------------- */
 
 export interface LocalProject {

package/src/main.tsx

@@ -1,5 +1,5 @@
 import { StrictMode, lazy, Suspense, type ReactNode } from 'react';
-import { createRoot } from 'react-dom/client';
+import { createRoot, type Root } from 'react-dom/client';
 import { createHashRouter, RouterProvider } from 'react-router-dom';
 import { AppShell } from './AppShell';
 import { AgentLayout } from './layouts/AgentLayout';
@@ -7,6 +7,7 @@ import { AgentPage } from './pages/AgentPage';
 import { SettingsPage } from './pages/SettingsPage';
 import { getPackRoutes } from './packs/registry';
 import { getBrandLogoUrl, BRAND_NAME } from './brand';
+import { getAppShellGate } from './auth/gate';
 import './styles/index.css';
 
 // 浏览器 dev mock 的安装在 bootstrap() 开头（动态 import + DEV 门）。
@@ -40,19 +41,7 @@ const ChatPanelPreviewPage = import.meta.env.DEV
  * （products/<id>/web/main.tsx）先静态调用包的 register*Renderer()，
  * 再调本函数——路由注册发生在路由表创建之前。
  */
-export async function bootstrap(): Promise<void> {
-  if (import.meta.env.DEV) {
-    // 动态 import：prod 构建里 Rollup 把 DEV 分支连同 mock（含其 fixtures）
-    // 整体树摇掉，浏览器 dev mock 数据不进产物。
-    const { installBrowserDevElectronMock } = await import('./lib/browser-dev-electron-mock');
-    installBrowserDevElectronMock();
-  }
-
-  // 标题与 favicon 在 bootstrap 时设置——此刻产品入口已完成包注册
-  // （品牌 logo 由包经 setBrandLogoUrl 注入，见 brand.ts）。
-  document.title = BRAND_NAME;
-  document.querySelector<HTMLLinkElement>('link[rel="icon"]')?.setAttribute('href', getBrandLogoUrl());
-
+function renderApplication(root: Root): void {
   const router = createHashRouter([
     {
       path: '/',
@@ -90,14 +79,47 @@ export async function bootstrap(): Promise<void> {
     },
   ]);
 
+  root.render(
+    <StrictMode>
+      <RouterProvider router={router} />
+    </StrictMode>,
+  );
+}
+
+export async function bootstrap(): Promise<void> {
+  if (import.meta.env.DEV) {
+    // 动态 import：prod 构建里 Rollup 把 DEV 分支连同 mock（含其 fixtures）
+    // 整体树摇掉，浏览器 dev mock 数据不进产物。
+    const { installBrowserDevElectronMock } = await import('./lib/browser-dev-electron-mock');
+    installBrowserDevElectronMock();
+  }
+
+  // 标题与 favicon 在 bootstrap 时设置——此刻产品入口已完成包注册
+  // （品牌 logo 由包经 setBrandLogoUrl 注入，见 brand.ts）。
+  document.title = BRAND_NAME;
+  document.querySelector<HTMLLinkElement>('link[rel="icon"]')?.setAttribute('href', getBrandLogoUrl());
+
   const rootEl = document.getElementById('root');
   if (!rootEl) {
     throw new Error('Missing #root element in index.html');
   }
+  const root = createRoot(rootEl);
+  const gate = getAppShellGate();
+  if (gate?.enabled()) {
+    let authenticated = false;
+    const onAuthenticated = () => {
+      if (authenticated) return;
+      authenticated = true;
+      renderApplication(root);
+    };
+    const Gate = gate.Component;
+    root.render(
+      <StrictMode>
+        <Gate onAuthenticated={onAuthenticated} />
+      </StrictMode>,
+    );
+    return;
+  }
 
-  createRoot(rootEl).render(
-    <StrictMode>
-      <RouterProvider router={router} />
-    </StrictMode>,
-  );
+  renderApplication(root);
 }

package/src/pages/AgentPage.tsx

@@ -26,7 +26,12 @@ import type { ExecutedAction } from "@/components/chat/ExecutedActionsCard";
 import type { ChildInfo } from "@/components/chat/OrchestrationChildrenCard";
 import { foldOrchestrationChildEvents } from "@/components/chat/orchestration-children-model";
 import { parseTurnBlocks, type TurnBlock } from "@/components/chat/turn-timeline";
+import { parseTurnFiles, type TurnFile } from "@/components/chat/turn-files";
 import { readPersistedDurationMs } from "@/components/chat/elapsed";
+import {
+  extractLatestSuggestedReplies,
+  type SuggestedRepliesState,
+} from "@/components/chat/suggested-replies-model";
 import { useChatTasks } from "@/components/chat/useChatTasks";
 import { LuListChecks, LuArrowRight } from "react-icons/lu";
 import { LocalLlmSettingsModal } from "@/components/LocalLlmSettingsModal";
@@ -136,6 +141,26 @@ function extractPersistedDurations(
   return seeded;
 }
 
+function extractPersistedTurnFiles(
+  messages: ChatMessageWithMetadata[] | undefined,
+): Record<string, TurnFile[]> {
+  const seeded: Record<string, TurnFile[]> = {};
+  if (!messages || messages.length === 0) return seeded;
+  for (const message of messages) {
+    if (message.role !== "assistant" || !message.messageMetadata) continue;
+    try {
+      const metadata = JSON.parse(message.messageMetadata) as {
+        turnFiles?: unknown;
+      };
+      const files = parseTurnFiles(metadata.turnFiles);
+      if (files) seeded[message.id] = files;
+    } catch {
+      // Ignore malformed legacy metadata.
+    }
+  }
+  return seeded;
+}
+
 /**
  * Routing layer for `/agent/:chatId`.
  *
@@ -205,6 +230,11 @@ function AgentChatLoader({
   const [initialDurations, setInitialDurations] = useState<
     Record<string, number>
   >({});
+  const [initialTurnFiles, setInitialTurnFiles] = useState<
+    Record<string, TurnFile[]>
+  >({});
+  const [initialSuggestedReplies, setInitialSuggestedReplies] =
+    useState<SuggestedRepliesState | null>(null);
   // W7-1: 后端在 messages 响应里下发 interrupted（上一轮崩溃/强杀中断）。
   const [initialInterrupted, setInitialInterrupted] = useState(false);
   // 运行中回合的实时快照：切走再切回时用它在历史消息之上叠出「正在运行」
@@ -234,10 +264,17 @@ function AgentChatLoader({
           getChatLiveStream(chatId),
         ]);
         if (cancelled) return;
-        setInitialMessages(chronological(response.messages));
+        const ordered = chronological(response.messages);
+        setInitialMessages(ordered);
         setInitialExecutedActions(extractPersistedActions(response.messages));
         setInitialTimelines(extractPersistedTimelines(response.messages));
         setInitialDurations(extractPersistedDurations(response.messages));
+        setInitialTurnFiles(extractPersistedTurnFiles(response.messages));
+        setInitialSuggestedReplies(
+          extractLatestSuggestedReplies(
+            ordered as ChatMessageWithMetadata[],
+          ),
+        );
         setInitialInterrupted(response.interrupted === true);
         setInitialLiveStream(live ?? { active: false });
       } catch (err) {
@@ -247,6 +284,8 @@ function AgentChatLoader({
         setInitialExecutedActions({});
         setInitialTimelines({});
         setInitialDurations({});
+        setInitialTurnFiles({});
+        setInitialSuggestedReplies(null);
         setInitialInterrupted(false);
         setInitialLiveStream({ active: false });
       }
@@ -271,6 +310,8 @@ function AgentChatLoader({
       initialExecutedActions={initialExecutedActions}
       initialTimelines={initialTimelines}
       initialDurations={initialDurations}
+      initialTurnFiles={initialTurnFiles}
+      initialSuggestedReplies={initialSuggestedReplies}
       initialInterrupted={initialInterrupted}
       initialLiveStream={initialLiveStream}
       hydrationError={hydrationError}
@@ -285,6 +326,8 @@ interface AgentChatViewProps {
   initialExecutedActions: Record<string, ExecutedAction[]>;
   initialTimelines: Record<string, TurnBlock[]>;
   initialDurations: Record<string, number>;
+  initialTurnFiles: Record<string, TurnFile[]>;
+  initialSuggestedReplies: SuggestedRepliesState | null;
   /** W7-1: 打开会话时上一轮处于中断态（崩溃/强杀，无完成记录）。 */
   initialInterrupted: boolean;
   /** 打开会话时的运行中回合快照（切回恢复运行状态用）。 */
@@ -299,6 +342,8 @@ function AgentChatView({
   initialExecutedActions,
   initialTimelines,
   initialDurations,
+  initialTurnFiles,
+  initialSuggestedReplies,
   initialInterrupted,
   initialLiveStream,
   hydrationError,
@@ -389,6 +434,16 @@ function AgentChatView({
   const [durationByMessageId, setDurationByMessageId] = useState<
     Record<string, number>
   >(initialDurations);
+  // 回合产物文件列表：与 executedActions 同款 reconcile 模式——live 回合
+  // 先挂 pendingTurnFilesRef，`message_id` 事件到达时归档到落库 id 上；
+  // 历史回合由 initialTurnFiles 从 messageMetadata.turnFiles 水合。
+  const [turnFilesByMessageId, setTurnFilesByMessageId] = useState<
+    Record<string, TurnFile[]>
+  >(initialTurnFiles);
+  // 当轮产物：turn_files 事件到达（流尾声）到 message_id 归档之间，以及
+  // 归档后占位 id 消息仍在屏上的这段时间，都靠它渲染尾部消息的文件列表。
+  const [currentTurnFiles, setCurrentTurnFiles] = useState<TurnFile[]>([]);
+  const pendingTurnFilesRef = useRef<TurnFile[]>([]);
   const turnStartedAtRef = useRef<number | null>(null);
   const [currentTurnStartedAtMs, setCurrentTurnStartedAtMs] = useState<
     number | undefined
@@ -425,6 +480,11 @@ function AgentChatView({
   const [planReady, setPlanReady] = useState(false);
   const planTurnRef = useRef(false);
   const wasStreamingRef = useRef(false);
+  const [suggestedReplies, setSuggestedReplies] =
+    useState<SuggestedRepliesState | null>(initialSuggestedReplies);
+  const [tailAssistantDbId, setTailAssistantDbId] = useState<string | null>(
+    initialSuggestedReplies?.messageId ?? null,
+  );
 
   const handleModeChange = useCallback((next: ChatMode) => {
     setMode(next);
@@ -459,6 +519,16 @@ function AgentChatView({
       }
       return;
     }
+    if (ev.event === "turn_files") {
+      // 回合收尾时后端发一次（在 message_id 之前）；先挂 pending，
+      // message_id 到达时随其他队列一起归档。
+      const files = parseTurnFiles(ev.payload?.files);
+      if (files) {
+        pendingTurnFilesRef.current = files;
+        setCurrentTurnFiles(files);
+      }
+      return;
+    }
     if (ev.event === "round_end") {
       // chat-transport surfaces `completion executing` as round_end. Bumping
       // the counter here is safe even if the round emits no tools — the
@@ -537,6 +607,15 @@ function AgentChatView({
         }));
       }
       pendingChildrenRef.current = [];
+      const queuedTurnFiles = pendingTurnFilesRef.current;
+      if (queuedTurnFiles.length > 0) {
+        setTurnFilesByMessageId((prev) => ({
+          ...prev,
+          [messageId]: queuedTurnFiles,
+        }));
+      }
+      pendingTurnFilesRef.current = [];
+      setTailAssistantDbId(messageId);
     }
     // AI 标题更新走的是后台 IPC 广播（chat-title-updated）而不是 SSE——
     // 见 AgentLayout 里的订阅。SSE 通道在 [DONE] 之后就不再监听了，title-gen
@@ -684,6 +763,8 @@ function AgentChatView({
       setCurrentTurnTimeline([]);
       pendingChildrenRef.current = [];
       setCurrentTurnChildren([]);
+      pendingTurnFilesRef.current = [];
+      setCurrentTurnFiles([]);
       setCurrentRound(1);
       const started = Date.now();
       turnStartedAtRef.current = started;
@@ -694,6 +775,8 @@ function AgentChatView({
       setPlanReady(false);
       // 手动发起新一轮即取代中断态——用户已经继续往前走了。
       setInterrupted(false);
+      setSuggestedReplies(null);
+      setTailAssistantDbId(null);
       // 模型选择器的每轮覆盖随 metadata 下发：model 覆盖设置里的全局
       // 模型；reasoningEffort 由 sidecar 按目录严格校验（不支持即报错，
       // 不静默丢弃）。都为 null 时保持设置/预制默认。
@@ -711,6 +794,26 @@ function AgentChatView({
     [sendUserMessage, modelOverride, effortOverride, execPolicy],
   );
 
+  const handleSelectSuggestion = useCallback(
+    (text: string) => {
+      void handleSubmit({ content: text });
+    },
+    [handleSubmit],
+  );
+
+  useEffect(() => {
+    const bridge = getElectronBridge();
+    if (!bridge?.onSuggestedReplies) return;
+    return bridge.onSuggestedReplies((payload) => {
+      if (payload.chatId !== chatId) return;
+      if (!Array.isArray(payload.suggestions) || payload.suggestions.length === 0) return;
+      setSuggestedReplies({
+        messageId: payload.messageId,
+        suggestions: payload.suggestions,
+      });
+    });
+  }, [chatId]);
+
   // 包槽位 fallback 发送通道（如文档包的单页修改在 sidecar 未就绪时把
   // 后端拼好的指令退回主聊天）：AgentLayout 持有发送器 ref，这里挂载时
   // 注册、卸载时注销，包面板经 sendChatMessage 调到当前注册的 handleSubmit。
@@ -732,6 +835,8 @@ function AgentChatView({
     setCurrentTurnTimeline([]);
     pendingChildrenRef.current = [];
     setCurrentTurnChildren([]);
+    pendingTurnFilesRef.current = [];
+    setCurrentTurnFiles([]);
     setCurrentRound(1);
     const started = Date.now();
     turnStartedAtRef.current = started;
@@ -863,6 +968,22 @@ function AgentChatView({
       )
     : currentTurnChildren;
 
+  let lastAssistantId: string | undefined;
+  for (let i = effectiveMessages.length - 1; i >= 0; i -= 1) {
+    if (effectiveMessages[i].role === "assistant") {
+      lastAssistantId = effectiveMessages[i].id;
+      break;
+    }
+  }
+  const visibleSuggestedReplies =
+    !effectiveIsStreaming &&
+    !interrupted &&
+    suggestedReplies &&
+    (suggestedReplies.messageId === lastAssistantId ||
+      suggestedReplies.messageId === tailAssistantDbId)
+      ? suggestedReplies.suggestions
+      : undefined;
+
   return (
     <div className="flex h-full w-full flex-col">
       {hydrationError && (
@@ -887,7 +1008,6 @@ function AgentChatView({
         header={
           <ChatHeader
             chat={chat}
-            agent={agent}
             onBranchSwitched={isElectron() ? onBranchTick : undefined}
             onInspectTask={ctx.inspectTask}
             tasks={tasks}
@@ -915,6 +1035,8 @@ function AgentChatView({
         currentTurnTimeline={effectiveCurrentTurnTimeline}
         currentTurnStartedAtMs={currentTurnStartedAtMs}
         durationByMessageId={durationByMessageId}
+        turnFilesByMessageId={turnFilesByMessageId}
+        currentTurnFiles={currentTurnFiles}
         currentTurnChildren={effectiveCurrentTurnChildren}
         orchestrationChildrenByMessageId={orchestrationChildrenByMessageId}
         currentRound={currentRound}
@@ -925,6 +1047,8 @@ function AgentChatView({
         onInspectTask={handleInspectTask}
         onDismissFinishedTask={dismissFinished}
         onShare={isElectron() ? handleShare : undefined}
+        suggestedReplies={visibleSuggestedReplies}
+        onSelectSuggestion={handleSelectSuggestion}
         onOpenSettings={
           isElectron() ? () => setLlmSettingsOpen(true) : undefined
         }

package/src/pages/ChatPanelPreviewPage.tsx

@@ -148,6 +148,7 @@ export function ChatPanelPreviewPage() {
     currentTurnStartedAtMs?: number;
     durationByMessageId?: Record<string, number>;
     currentRound: number;
+    suggestedReplies?: string[];
   }
   const config = useMemo<SceneConfig>(() => {
     switch (scene) {
@@ -203,6 +204,7 @@ export function ChatPanelPreviewPage() {
           timelineByMsgId: { m2: MOCK_TIMELINE },
           durationByMessageId: { m2: 83_000 },
           currentRound: 1,
+          suggestedReplies: ['修一下失败的断言颜色', '把测试再跑一遍', '解释这次失败的原因'],
         };
     }
   }, [scene]);
@@ -240,7 +242,7 @@ export function ChatPanelPreviewPage() {
           onCancel={() => {}}
           className="flex-1"
           header={
-            <ChatHeader chat={MOCK_CHAT} agent={MOCK_AGENT} />
+            <ChatHeader chat={MOCK_CHAT} />
           }
           inputPlaceholder="预览模式 — 输入不会真的发送…"
           agents={[MOCK_AGENT]}
@@ -252,6 +254,8 @@ export function ChatPanelPreviewPage() {
           currentTurnStartedAtMs={config.currentTurnStartedAtMs}
           durationByMessageId={config.durationByMessageId}
           currentRound={config.currentRound}
+          suggestedReplies={config.suggestedReplies}
+          onSelectSuggestion={(text) => console.log('[preview] suggestion:', text)}
           onOpenSettings={() =>
             console.log('[preview] open llm settings (noop in harness)')
           }

package/src/components/chat/AskUserModalHost.tsx

@@ -1,61 +0,0 @@
-import { useEffect, useState } from 'react';
-import { getElectronBridge, type AskUserPromptRequest } from '@/lib/electron-bridge';
-import { AskUserQuestionMenu } from './AskUserQuestionMenu';
-
-/**
- * AskUserModalHost — W8 结构化提问的桌面 UI 半侧。
- *
- * 挂载一次（AgentLayout），订阅主进程/BS 服务器广播的 `ask-user:request`，
- * 以模态渲染自研的 `<AskUserQuestionMenu />`（分步菜单选择框：模型建议
- * 作为选项、底部追加「其他 / 自定义」输入）。答案经 `ask-user:answer`
- * （Electron IPC / BS HTTP）回到主进程，再应答 sidecar 的反向调用。
- *
- * 队列为 FIFO：ask_user 标记了 concurrency_safe=False，sidecar 串行等待
- * 每个应答。「交给我决定」应答空映射——模型收到「用户未作答」后自行
- * 推进（对齐 HostAskUserHandler 的 fail-open 语义）。
- */
-
-export function AskUserModalHost() {
-  const [queue, setQueue] = useState<AskUserPromptRequest[]>([]);
-
-  useEffect(() => {
-    const bridge = getElectronBridge();
-    if (!bridge?.askUser) return;
-    return bridge.askUser.onRequest((request) => {
-      setQueue((prev) => [...prev, request]);
-    });
-  }, []);
-
-  const current = queue[0] ?? null;
-  if (!current) return null;
-
-  const answer = (answers: Record<string, string | string[]>) => {
-    const bridge = getElectronBridge();
-    setQueue((prev) => prev.slice(1));
-    void bridge?.askUser?.answer({ requestId: current.requestId, answers });
-  };
-
-  return (
-    <div
-      className="fixed inset-0 z-50 flex items-center justify-center bg-black/40 p-4"
-      role="dialog"
-      aria-modal="true"
-      aria-label="Agent 提问"
-    >
-      <div className="max-h-[85vh] w-full max-w-lg overflow-auto rounded-agent-lg">
-        <AskUserQuestionMenu
-          key={current.requestId}
-          intro={current.intro}
-          questions={current.questions}
-          onSubmit={(answers) => answer(answers)}
-          onAutoContinue={() => answer({})}
-          bottomHint={
-            queue.length > 1 ? `还有 ${queue.length - 1} 组问题待回答` : undefined
-          }
-        />
-      </div>
-    </div>
-  );
-}
-
-export default AskUserModalHost;