@steerable/agent-shell-web 0.6.67 → 0.6.69

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-shell-web",
-  "version": "0.6.67",
+  "version": "0.6.69",
   "type": "module",
   "description": "Steerable framework — product-neutral renderer SPA source for @steerable/agent-shell (React + Vite). Consumed by product web entry points via the `@/` alias (anchored at this package's src/) and the createProductViteConfig factory. Published as a source package (src/), plus the compiled vite.base config factory (vite.base.js + .d.ts) for Node-side config loading.",
   "license": "Apache-2.0",
@@ -45,8 +45,8 @@
     "react-router-dom": "^6.30.0",
     "rehype-raw": "^7.0.0",
     "remark-gfm": "^4.0.1",
-    "@steerable/agent-protocol": "0.6.67",
-    "@steerable/agent-ui": "0.6.67"
+    "@steerable/agent-protocol": "0.6.69",
+    "@steerable/agent-ui": "0.6.69"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.3.0",
@@ -59,7 +59,7 @@
     "typescript": "^5.8.3",
     "vite": "^5.4.21",
     "vitest": "^3.2.4",
-    "@steerable/pack-sdk": "0.6.67"
+    "@steerable/pack-sdk": "0.6.69"
   },
   "scripts": {
     "gen": "echo agent-shell-web",

package/src/components/AgentSidebar.tsx

@@ -114,6 +114,7 @@ import {
   nextProjectOrder,
   type ProjectDropPlace,
 } from "@/lib/project-order";
+import { chatActivityTime, latestActivityTime } from "@/lib/sidebar-order";
 import type { RightPanelState } from "@/layouts/AgentLayout";
 import { BrandLockup } from "@/components/BrandLockup";
 import { ConfirmDialog } from "@/components/ConfirmDialog";
@@ -389,6 +390,10 @@ export function AgentSidebar({
   const [streamingChatIds, setStreamingChatIds] = useState<Set<string>>(
     () => new Set(),
   );
+  // 回合已经开始、列表里的 updatedAt 还没刷新时，用这个时间把会话抬到前面。
+  const [liveActivityAt, setLiveActivityAt] = useState<ReadonlyMap<string, number>>(
+    () => new Map(),
+  );
   const pendingAskUserChatIds = usePendingAskUserChatIds();
   const pendingApprovalChatIds = usePendingApprovalChatIds();
 
@@ -409,6 +414,14 @@ export function AgentSidebar({
         }
         return next;
       });
+      if (isStreaming) {
+        setLiveActivityAt((prev) => {
+          if (prev.has(chatId)) return prev;
+          const next = new Map(prev);
+          next.set(chatId, Date.now());
+          return next;
+        });
+      }
     };
     window.addEventListener("chat:streaming-change", handleStreamingChange);
     return () => {
@@ -419,6 +432,25 @@ export function AgentSidebar({
     };
   }, []);
 
+  // 列表里的 updatedAt 追上本地时间后丢掉抬升，避免旧回合一直占在最前。
+  useEffect(() => {
+    setLiveActivityAt((prev) => {
+      if (prev.size === 0) return prev;
+      let changed = false;
+      const next = new Map(prev);
+      for (const [id, stamp] of prev) {
+        if (streamingChatIds.has(id)) continue;
+        const chat = chats.find((item) => item.id === id);
+        const updated = chat?.updatedAt ? Date.parse(chat.updatedAt) : Number.NaN;
+        if (!chat || (Number.isFinite(updated) && updated >= stamp)) {
+          next.delete(id);
+          changed = true;
+        }
+      }
+      return changed ? next : prev;
+    });
+  }, [chats, streamingChatIds]);
+
   // 当前打开的会话由 AgentChatView 自己报开始/结束。切走后的会话回合还在
   // 后端跑，卸载时不会再报结束，这里用 live-stream 对账，结束后摘掉指示。
   const seenActiveBackgroundRef = useRef<Set<string>>(new Set());
@@ -752,35 +784,31 @@ export function AgentSidebar({
   const normalizedChats = useMemo(() => {
     return chats
       .map((chat) => {
-        const updated = chat.updatedAt ? new Date(chat.updatedAt) : null;
-        const created = new Date(chat.createdAt);
-        const sortDate =
-          updated && !Number.isNaN(updated.getTime())
-            ? updated
-            : !Number.isNaN(created.getTime())
-              ? created
-              : new Date();
         const { displayTitle, isAutomation } = parseChatTitle(chat.title);
         return {
           id: chat.id,
           title: displayTitle || t("New conversation"),
           isAutomation,
           isPinned: chat.isPinned,
-          sortDate,
+          sortDate: new Date(
+            chatActivityTime(
+              chat.updatedAt,
+              chat.createdAt,
+              liveActivityAt.get(chat.id),
+            ),
+          ),
           agentId: chat.agentId ?? null,
           projectId: chat.projectId ?? null,
           isStreaming: chat.isStreaming,
           needsUserInput: chat.needsUserInput,
         };
       })
-      .sort((a, b) => {
-        if (a.isPinned !== b.isPinned) return a.isPinned ? -1 : 1;
-        return b.sortDate.getTime() - a.sortDate.getTime();
-      });
-  }, [chats]);
+      .sort((a, b) => b.sortDate.getTime() - a.sortDate.getTime());
+  }, [chats, liveActivityAt]);
 
   // 顶层按项目分组：无项目对话（含项目已被删但列表还没刷新的孤儿会话）
-  // 保持原有的日期分组；每个项目一个分组，组内按 pin + 时间排序。
+  // 保持日期分组。会话按最后活动时间新到旧。项目按组内最近一次会话排序，
+  // 没有会话的项目留在后面，并保持它们原来的相对顺序。
   const knownProjectIds = useMemo(
     () =>
       showProjectsChrome
@@ -797,16 +825,23 @@ export function AgentSidebar({
     [normalizedChats, knownProjectIds],
   );
 
-  const projectGroups = useMemo(
-    () =>
-      showProjectsChrome
-        ? projects.map((project) => ({
-            project,
-            items: normalizedChats.filter((c) => c.projectId === project.id),
-          }))
-        : [],
-    [projects, normalizedChats, showProjectsChrome],
-  );
+  const projectGroups = useMemo(() => {
+    if (!showProjectsChrome) return [];
+    return projects
+      .map((project, index) => ({
+        project,
+        index,
+        items: normalizedChats.filter((c) => c.projectId === project.id),
+      }))
+      .sort((a, b) => {
+        const byActivity =
+          latestActivityTime(b.items.map((item) => item.sortDate.getTime())) -
+          latestActivityTime(a.items.map((item) => item.sortDate.getTime()));
+        if (byActivity !== 0) return byActivity;
+        return a.index - b.index;
+      })
+      .map(({ project, items }) => ({ project, items }));
+  }, [projects, normalizedChats, showProjectsChrome]);
 
   const pinnedChats = useMemo(
     () => normalizedChats.filter((c) => c.isPinned),

package/src/components/chat/ExecPolicyPicker.tsx

@@ -6,7 +6,8 @@ import { t } from '@/i18n';
 /**
  * ExecPolicyPicker — 输入框上的命令沙箱切换（类 Codex 底部权限档）。
  *
- * 切档立刻记住，下一轮才生效：当前回合的 `execSandbox` 已经随流发出。
+ * 切档立刻记住。排队的下一轮按当时的档开流；插进当前回合的消息会改
+ * 这一回合后面的命令沙箱。已经在跑的那条命令保持它开始时的档。
  * 工作区 = Seatbelt/bwrap 只允许写项目家目录、源文件夹（含各自子目录）或本对话工作区；完整权限
  * = 不下发命令沙箱，本机路径（如 Downloads）不再被 Operation not permitted 拦住。
  */

package/src/hooks/useChatsAndAgents.ts

@@ -58,6 +58,12 @@ export interface UseChatsAndAgentsResult {
    * 找不到 id 时静默忽略。
    */
   patchChatTitle: (chatId: string, title: string) => void;
+  /**
+   * 就地把某个 chat 的最后更新时间改掉（不打后端、不重新拉已在列表里的会话）。
+   * 用于 `chat-activity`：消息落库后侧边栏按这个时间重排。
+   * 当前已加载的页里没有这条会话时，退回刷新第一页。
+   */
+  patchChatUpdatedAt: (chatId: string, updatedAt: string) => void;
   /** True while a `loadMoreChats` call is in flight. */
   isLoadingMoreChats: boolean;
   /** True iff the last list-chats response reported more pages available. */
@@ -149,6 +155,43 @@ export function useChatsAndAgents(): UseChatsAndAgentsResult {
     [list],
   );
 
+  // 消息落库后的活动时间。叠在已加载列表上，避免整表刷新把分页打回第一页。
+  const [activityAt, setActivityAt] = useState<ReadonlyMap<string, string>>(() => new Map());
+  const chats = useMemo(() => {
+    if (activityAt.size === 0) return list.chats;
+    return list.chats.map((chat) => {
+      const next = activityAt.get(chat.id);
+      if (!next || chat.updatedAt >= next) return chat;
+      return { ...chat, updatedAt: next };
+    });
+  }, [activityAt, list.chats]);
+  useEffect(() => {
+    setActivityAt((prev) => {
+      if (prev.size === 0) return prev;
+      let changed = false;
+      const next = new Map(prev);
+      for (const [id, stamp] of prev) {
+        const chat = list.chats.find((item) => item.id === id);
+        if (chat && chat.updatedAt >= stamp) {
+          next.delete(id);
+          changed = true;
+        }
+      }
+      return changed ? next : prev;
+    });
+  }, [list.chats]);
+  const patchChatUpdatedAt = useCallback((chatId: string, updatedAt: string) => {
+    const known = list.chats.some((chat) => chat.id === chatId);
+    setActivityAt((prev) => {
+      const current = prev.get(chatId);
+      if (current && current >= updatedAt) return prev;
+      const next = new Map(prev);
+      next.set(chatId, updatedAt);
+      return next;
+    });
+    if (!known) void list.refreshChats();
+  }, [list.chats, list.refreshChats]);
+
   const deleteChat = useCallback(
     async (chatId: string) => {
       try {
@@ -164,7 +207,7 @@ export function useChatsAndAgents(): UseChatsAndAgentsResult {
   );
 
   return {
-    chats: list.chats,
+    chats,
     agents: list.agents,
     isLoading: list.isLoading,
     error: mergedError,
@@ -175,6 +218,7 @@ export function useChatsAndAgents(): UseChatsAndAgentsResult {
     createChat,
     deleteChat,
     patchChatTitle: list.patchChatTitle,
+    patchChatUpdatedAt,
     isLoadingMoreChats: list.isLoadingMoreChats,
     hasMoreChats: list.hasMoreChats,
     loadMoreChats: list.loadMoreChats,

package/src/layouts/AgentLayout.tsx

@@ -164,6 +164,10 @@ function AgentLayoutContent() {
   useEffect(() => {
     patchChatTitleRef.current = data.patchChatTitle;
   }, [data.patchChatTitle]);
+  const patchChatUpdatedAtRef = useRef(data.patchChatUpdatedAt);
+  useEffect(() => {
+    patchChatUpdatedAtRef.current = data.patchChatUpdatedAt;
+  }, [data.patchChatUpdatedAt]);
   const refreshChatsRef = useRef(data.refreshChats);
   useEffect(() => {
     refreshChatsRef.current = data.refreshChats;
@@ -187,6 +191,16 @@ function AgentLayoutContent() {
     });
     return unsubscribe;
   }, []);
+  // 消息落库后的活动时间。只改这条会话在内存里的 updatedAt，侧边栏按它重排。
+  useEffect(() => {
+    const bridge = getHostBridge();
+    if (!bridge?.onChatActivity) return;
+    const unsubscribe = bridge.onChatActivity((payload) => {
+      if (!payload?.chatId || !payload.updatedAt) return;
+      patchChatUpdatedAtRef.current(payload.chatId, payload.updatedAt);
+    });
+    return unsubscribe;
+  }, []);
   useEffect(() => {
     const bridge = getHostBridge();
     if (!bridge?.onStoreChanged) return;

package/src/lib/browser-dev-host-mock.ts

@@ -651,6 +651,7 @@ export function installBrowserDevHostMock() {
     onMenuOpenTerminal: () => undefined,
     offMenuOpenTerminal: () => undefined,
     onChatTitleUpdated: () => () => undefined,
+    onChatActivity: () => () => undefined,
     onSuggestedReplies: (callback) => {
       suggestedReplyListeners.add(callback);
       return () => {

package/src/lib/chat-transport.ts

@@ -254,10 +254,14 @@ export function createHostChatTransport(chatId: string): HostChatTransport {
     },
     // 轮中转向：仅在 CoreLoop 路径（STEERABLE_USE_CORELOOP=1）且回合仍
     // 运行时生效；否则主进程软失败，useChatStream 保留草稿。
-    steer: async (content: string) => {
+    steer: async (content: string, options?: { execPolicy?: 'workspace' | 'full' }) => {
       const bridge = getHostBridge();
       if (!bridge?.localBackend.steerChat) return false;
-      return await bridge.localBackend.steerChat(chatId, content);
+      return await bridge.localBackend.steerChat(
+        chatId,
+        content,
+        options?.execPolicy ? { execPolicy: options.execPolicy } : undefined,
+      );
     },
     stream: async (input: ChatStreamSendInput, onEvent) => {
       const bridge = getHostBridge();

package/src/lib/host-bridge.ts

@@ -159,8 +159,15 @@ export interface HostBridge {
       onEvent: (payload: LocalBackendStreamEvent) => void,
     ) => Promise<string | null>;
     cancelStream: (streamId: string) => void;
-    /** 轮中转向：注入一条用户消息到运行中的 CoreLoop 回合；false = 无可转向回合。 */
-    steerChat?: (chatId: string, content: string) => Promise<boolean>;
+    /**
+     * 轮中转向：注入一条用户消息到运行中的 CoreLoop 回合；false = 无可转向回合。
+     * `execPolicy` 改这一回合后面的命令沙箱（工作区 / 完整权限）。
+     */
+    steerChat?: (
+      chatId: string,
+      content: string,
+      options?: { execPolicy?: 'workspace' | 'full' },
+    ) => Promise<boolean>;
   };
   /** 会话附件：把源文件路径 / base64 字节拷贝进会话空间（`attachments:save`）。 */
   attachments?: {
@@ -239,6 +246,13 @@ export interface HostBridge {
   onChatCreated?: (
     callback: (payload: { chatId: string; agentId?: string | null }) => void,
   ) => () => void;
+  /**
+   * 会话有了新的活动时间（写入消息或改会话）。载荷是 `{chatId, updatedAt}`。
+   * 侧边栏据此改内存里的时间并重排，不整表刷新。
+   */
+  onChatActivity?: (
+    callback: (payload: { chatId: string; updatedAt: string }) => void,
+  ) => () => void;
   /**
    * 另一个进程提交了宿主库。侧栏据此重新拉会话列表。
    * 载荷为空；渲染端不依赖里面的字段。

package/src/lib/http-bridge.ts

@@ -257,8 +257,12 @@ export function createHttpBridge(): HostBridge {
         http<T>(input.method, input.path, input.body),
       startStream,
       cancelStream,
-      steerChat: async (chatId, content) => {
-        const result = await http<{ ok?: boolean }>('POST', '/host/steer', { chatId, content });
+      steerChat: async (chatId, content, options) => {
+        const result = await http<{ ok?: boolean }>('POST', '/host/steer', {
+          chatId,
+          content,
+          ...(options?.execPolicy ? { execPolicy: options.execPolicy } : {}),
+        });
         return result.ok === true;
       },
     },
@@ -286,6 +290,9 @@ export function createHttpBridge(): HostBridge {
     onChatCreated: (callback) =>
       subscribeChannel<{ chatId: string; agentId?: string | null }>('chat-created', callback),
 
+    onChatActivity: (callback) =>
+      subscribeChannel<{ chatId: string; updatedAt: string }>('chat-activity', callback),
+
     onStoreChanged: (callback) => subscribeChannel('store:changed', () => callback()),
 
     onTaskUpdated: (callback) =>

package/src/lib/sidebar-order.ts

@@ -0,0 +1,35 @@
+/**
+ * 侧栏会话与项目的显示顺序。
+ * 会话按最后活动时间新到旧；项目按组内最近一次会话的活动时间，没有会话的项目留在后面。
+ */
+
+/**
+ * 会话的排序时间。有效的 `updatedAt` 优先，否则用 `createdAt`。
+ * `liveAt` 是进行中回合在列表刷新前的本地时间，只在比已保存时间更新时抬高。
+ */
+export function chatActivityTime(
+  updatedAt: string | null | undefined,
+  createdAt: string | null | undefined,
+  liveAt?: number,
+  now = Date.now(),
+): number {
+  const updated = updatedAt ? Date.parse(updatedAt) : Number.NaN;
+  const created = createdAt ? Date.parse(createdAt) : Number.NaN;
+  const persisted = Number.isFinite(updated)
+    ? updated
+    : Number.isFinite(created)
+      ? created
+      : now;
+  return liveAt !== undefined && Number.isFinite(liveAt) && liveAt > persisted
+    ? liveAt
+    : persisted;
+}
+
+/** 一组会话里最近的活动时间。没有会话时为 0，这样空项目排在有对话的项目后面。 */
+export function latestActivityTime(times: readonly number[]): number {
+  let latest = 0;
+  for (const time of times) {
+    if (time > latest) latest = time;
+  }
+  return latest;
+}

package/src/pages/AgentPage.tsx

@@ -101,6 +101,31 @@ function readStoredMode(): ChatMode {
   return clampWebChatMode(localStorage.getItem(CHAT_MODE_STORAGE_KEY));
 }
 
+interface ComposerTurnSettings {
+  execPolicy: ExecPolicy;
+  mode: ChatMode;
+  modelOverride: string | null;
+  effortOverride: string | null;
+}
+
+/**
+ * 排队和插队失败后的新回合不经过输入框的正常提交，这里在真正开流时
+ * 补上当前输入框的命令沙箱、模式、模型和编排开关。
+ */
+function applyComposerTurnSettings<T extends { metadata?: Record<string, unknown> }>(
+  input: T,
+  settings: ComposerTurnSettings,
+): T {
+  const metadata: Record<string, unknown> = { ...(input.metadata ?? {}) };
+  metadata.execPolicy = settings.execPolicy;
+  if (settings.mode === "plan") metadata.mode = "plan";
+  else delete metadata.mode;
+  if (settings.modelOverride) metadata.model = settings.modelOverride;
+  if (settings.effortOverride) metadata.reasoningEffort = settings.effortOverride;
+  metadata.orchestration = isOrchestrationSettingEnabled();
+  return { ...input, metadata };
+}
+
 function extractPersistedActions(
   messages: ChatMessageWithMetadata[] | undefined,
 ): Record<string, ExecutedAction[]> {
@@ -388,10 +413,29 @@ function AgentChatView({
   const chatProject = chat?.projectId
     ? (projects.find((p) => p.id === chat.projectId) ?? null)
     : null;
-  const transport = useMemo(
-    () => createHostChatTransport(chatId),
-    [chatId],
-  );
+  // 插队 / 排队在开流或注入时读这里，而不是排队那一刻的闭包。
+  const composerSettingsRef = useRef<ComposerTurnSettings>({
+    execPolicy: readStoredExecPolicy(),
+    mode: readStoredMode(),
+    modelOverride: null,
+    effortOverride: null,
+  });
+  const transport = useMemo(() => {
+    const inner = createHostChatTransport(chatId);
+    return {
+      cancelActive: () => inner.cancelActive(),
+      stream: (
+        input: { content: string; metadata?: Record<string, unknown> },
+        onEvent: (event: SSEEvent) => void,
+      ) => inner.stream(applyComposerTurnSettings(input, composerSettingsRef.current), onEvent),
+      steer: (content: string) => {
+        if (!inner.steer) return Promise.resolve(false);
+        return inner.steer(content, {
+          execPolicy: composerSettingsRef.current.execPolicy,
+        });
+      },
+    };
+  }, [chatId]);
 
   // 4.6a 后台任务：header 角标与消息列尾部的终态卡共用这一份订阅，两处
   // 因此不会各拉一次任务表、也不会显示互相错位的状态。
@@ -874,6 +918,12 @@ function AgentChatView({
   // ModelPicker 自取（GET /api/v2/llm/models → sidecar models.list）。
   const [modelOverride, setModelOverride] = useState<string | null>(null);
   const [effortOverride, setEffortOverride] = useState<string | null>(null);
+  composerSettingsRef.current = {
+    execPolicy,
+    mode,
+    modelOverride,
+    effortOverride,
+  };
 
   const handleSubmit = useCallback(
     (input: { content: string; metadata?: Record<string, unknown> }) => {