@steerable/agent-shell-web 0.6.50 → 0.6.52

package/src/components/chat/UserMessage.tsx

@@ -1,6 +1,6 @@
 import { useLayoutEffect, useRef, useState } from 'react';
 import { motion } from 'framer-motion';
-import { LuChevronDown, LuChevronUp, LuCheck, LuCopy } from 'react-icons/lu';
+import { LuChevronDown, LuChevronUp, LuCheck, LuCopy, LuCornerDownRight } from 'react-icons/lu';
 import type { ChatMessage } from '@steerable/agent-protocol';
 import type { LocalChat, LocalChatAgent } from '@/lib/local-api';
 import { useSlashSources } from '@/lib/slash-sources';
@@ -12,38 +12,32 @@ import { useCopy } from './useCopy';
  * UserMessage — port of `deeppath`'s user-bubble component, trimmed to the
  * agent-only surface.
  *
- * Differences vs the original:
- *   - **No RefCards.** Local-backend messages don't carry the `messageMetadata.refs`
- *     array used by the cloud product to attach goal/task/event/document refs;
- *     when we eventually want this for agent (e.g. uploaded files), it'll go
- *     here.
- *   - **No edit button.** The cloud product's `editChatMessage` rewrites the
- *     SSE turn in place — we don't have that machinery yet. Tracking under
- *     phase 2c.
- *   - **No inline `ref://` / `tool://` / `agent://` parsing.** Pinned-ref
- *     shortcuts stay cloud-only. `@智能体名` is a Markdown chip painted from
- *     the agent list + message text (refresh restores from content).
- *
- * What we KEEP from the old version (and why it matters for parity):
- *   - Left-aligned bubble (not right-aligned). The product chat layout stacks
- *     both user + assistant bubbles flush-left in a vertical column — this is
- *     the most visible "feel" difference vs a typical chat UI.
- *   - Bubble background uses the secondary muted token so it sits a notch
- *     above the canvas without competing with assistant bubbles.
- *   - 4.5em fold + gradient mask + 「展开全部 / 收起」 toggle so a wall-of-text
- *     user prompt doesn't steal the whole viewport before the assistant
- *     replies.
- *   - Friendly timestamp at bottom-right.
- *   - `framer-motion` fade/slide-in on mount.
+ * Grouping (方案 A):
+ *   When multiple user messages occur consecutively without an assistant reply
+ *   in between, MessageList renders them as a single connected card:
+ *   - The first message has `isGroupStart = true`
+ *   - Mid-turn / follow-up steered additions have `isAppended = true`
+ *   - The outer container groups them with a subtle dashed divider and a
+ *     「↳ 追加」 badge.
  */
 
 interface UserMessageProps {
   message: ChatMessage;
   agents?: LocalChatAgent[];
   chats?: LocalChat[];
+  /** Whether this message is part of a consecutive user message group. */
+  isGrouped?: boolean;
+  /** Whether this message is an appended follow-up inside the group (not the first one). */
+  isAppended?: boolean;
 }
 
-export function UserMessage({ message, agents = [], chats = [] }: UserMessageProps) {
+export function UserMessage({
+  message,
+  agents = [],
+  chats = [],
+  isGrouped = false,
+  isAppended = false,
+}: UserMessageProps) {
   const content = message.content || '';
   // 发出去的消息里 `/技能` `/mcp__srv__tool` 要和输入框里同样渲染成工具卡片。
   // 目录来自共享缓存，整屏消息只拉一次。
@@ -60,6 +54,103 @@ export function UserMessage({ message, agents = [], chats = [] }: UserMessagePro
     setIsOverflowing(el.scrollHeight > el.clientHeight + 1);
   }, [content, isExpanded]);
 
+  // When rendered as an item inside a group, the parent handles the outer card.
+  if (isGrouped) {
+    return (
+      <div
+        className={`group/message relative px-3 py-2 text-xs text-agent-foreground ${
+          isAppended ? 'border-t border-dashed border-agent-border/60 bg-agent-muted/30' : ''
+        }`}
+        data-message-role="user"
+        data-message-id={message.id}
+      >
+        {isAppended && (
+          <div className="mb-1 flex items-center gap-1 text-[11px] font-medium text-agent-muted-foreground select-none">
+            <LuCornerDownRight className="h-3 w-3 text-agent-primary/80" />
+            <span className="rounded bg-agent-primary/10 px-1 py-0.5 text-[10px] text-agent-primary font-medium">
+              追加
+            </span>
+          </div>
+        )}
+        <div className="relative">
+          <div
+            ref={contentRef}
+            className={`markdown-content pl-1 ${
+              !isExpanded ? 'overflow-hidden' : ''
+            }`}
+            style={!isExpanded ? { maxHeight: '4.5em' } : undefined}
+          >
+            {content ? (
+              <Markdown
+                inlineParagraph
+                agents={agents}
+                chats={chats}
+                skills={skills}
+                mcpTools={mcpTools}
+              >
+                {content}
+              </Markdown>
+            ) : (
+              <div className="h-4" />
+            )}
+          </div>
+          {!isExpanded && isOverflowing && (
+            <div className="pointer-events-none absolute bottom-0 left-0 right-0 h-5 bg-gradient-to-t from-agent-muted to-transparent" />
+          )}
+        </div>
+
+        {isOverflowing && (
+          <button
+            type="button"
+            onClick={(event) => {
+              event.stopPropagation();
+              setIsExpanded((prev) => !prev);
+            }}
+            className="mt-1 inline-flex items-center gap-0.5 text-xs text-agent-muted-foreground transition-colors hover:text-agent-foreground"
+          >
+            {isExpanded ? (
+              <>
+                收起
+                <LuChevronUp className="h-3 w-3" />
+              </>
+            ) : (
+              <>
+                展开全部
+                <LuChevronDown className="h-3 w-3" />
+              </>
+            )}
+          </button>
+        )}
+
+        <div className="mt-1 flex items-center justify-between">
+          <button
+            type="button"
+            onClick={() => void copy()}
+            className="inline-flex items-center gap-0.5 rounded text-xs text-agent-muted-foreground opacity-0 transition-all duration-200 hover:text-agent-foreground focus:opacity-100 group-hover/message:opacity-100"
+            title={copied ? '已复制' : '复制消息'}
+            aria-label={copied ? '已复制' : '复制消息'}
+          >
+            {copied ? (
+              <>
+                <LuCheck className="h-3 w-3 text-emerald-600 dark:text-emerald-400" />
+                <span className="text-emerald-600 dark:text-emerald-400">
+                  已复制
+                </span>
+              </>
+            ) : (
+              <LuCopy className="h-3 w-3" />
+            )}
+          </button>
+          <div className="text-[11px] text-agent-muted-foreground">
+            {message.createdAt
+              ? getFriendlyDate(new Date(message.createdAt))
+              : getFriendlyDate(new Date())}
+          </div>
+        </div>
+      </div>
+    );
+  }
+
   return (
     <motion.div
       className="group/message"

package/src/components/chat/composer-status-stack.tsx

@@ -0,0 +1,79 @@
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useLayoutEffect,
+  useMemo,
+  useRef,
+  useState,
+  type ReactNode,
+} from 'react';
+
+export type ComposerStatusPanelId = 'orchestration' | 'todos';
+
+type ComposerStatusContextValue = {
+  activeId: ComposerStatusPanelId | null;
+  claim: (id: ComposerStatusPanelId, force: boolean) => void;
+  release: (id: ComposerStatusPanelId) => void;
+};
+
+const ComposerStatusContext = createContext<ComposerStatusContextValue | null>(null);
+
+/**
+ * Right-aligned column for the composer status pills (orchestration + todos).
+ * At most one panel is expanded; a user click steals the open slot, while an
+ * automatic open only claims it when nothing else is showing.
+ */
+export function ComposerStatusStack({ children }: { children: ReactNode }) {
+  const [activeId, setActiveId] = useState<ComposerStatusPanelId | null>(null);
+  const claim = useCallback((id: ComposerStatusPanelId, force: boolean) => {
+    setActiveId((current) => {
+      if (force || current == null || current === id) return id;
+      return current;
+    });
+  }, []);
+  const release = useCallback((id: ComposerStatusPanelId) => {
+    setActiveId((current) => (current === id ? null : current));
+  }, []);
+  const value = useMemo(
+    () => ({ activeId, claim, release }),
+    [activeId, claim, release],
+  );
+
+  return (
+    <ComposerStatusContext.Provider value={value}>
+      <div
+        className="flex min-w-0 flex-col items-end gap-1.5"
+        data-testid="composer-status-stack"
+      >
+        {children}
+      </div>
+    </ComposerStatusContext.Provider>
+  );
+}
+
+/**
+ * Fold a panel's own open preference into the stack.
+ * Outside a stack, `expanded` follows `desired` directly.
+ */
+export function useExclusiveExpand(
+  id: ComposerStatusPanelId,
+  desired: boolean,
+): { expanded: boolean; requestOpen: () => void } {
+  const ctx = useContext(ComposerStatusContext);
+  const wasDesired = useRef(false);
+
+  useLayoutEffect(() => {
+    if (!ctx) return;
+    if (desired && !wasDesired.current) ctx.claim(id, false);
+    if (!desired && wasDesired.current) ctx.release(id);
+    wasDesired.current = desired;
+  }, [ctx, desired, id]);
+
+  const requestOpen = useCallback(() => {
+    ctx?.claim(id, true);
+  }, [ctx, id]);
+
+  const expanded = ctx ? desired && ctx.activeId === id : desired;
+  return { expanded, requestOpen };
+}

package/src/components/chat/orchestration-flow-model.ts

@@ -0,0 +1,401 @@
+/**
+ * 多智能体协同编排模型（Orchestration Flow Model）
+ *
+ * 将 CoreLoop 编排六件套（agent_spawn / agent_wait / agent_send / agent_interrupt / agent_close / agent_list）
+ * 以及 SSE agent.child 生命周期事件聚合成面向用户的 DAG 流程图与 Todo 式状态模型。
+ */
+
+import type { ChildInfo } from './orchestration-children-model';
+import { parseToolEnvelope } from './executed-actions-model';
+
+export const ORCHESTRATION_TOOL_NAMES = [
+  'agent_spawn',
+  'agent_wait',
+  'agent_send',
+  'agent_interrupt',
+  'agent_close',
+  'agent_list',
+] as const;
+
+export type OrchestrationToolName = (typeof ORCHESTRATION_TOOL_NAMES)[number];
+
+export function isOrchestrationTool(toolName: string): toolName is OrchestrationToolName {
+  return (ORCHESTRATION_TOOL_NAMES as readonly string[]).includes(toolName);
+}
+
+export type OrchestrationNodeStatus =
+  | 'pending'
+  | 'running'
+  | 'completed'
+  | 'failed'
+  | 'interrupted'
+  | 'closed'
+  | 'cancelled';
+
+export interface OrchestrationSteer {
+  message: string;
+  delivery?: string;
+}
+
+export interface OrchestrationChildNode {
+  childId: string;
+  task: string;
+  toolFilter?: string[];
+  status: OrchestrationNodeStatus;
+  answer?: string;
+  steers: OrchestrationSteer[];
+  interrupted?: boolean;
+  closed?: boolean;
+  recordId?: string;
+  error?: string;
+  spawnActionIndex?: number;
+  waitActionIndex?: number;
+}
+
+export interface OrchestrationFlowData {
+  nodes: OrchestrationChildNode[];
+  totalCount: number;
+  completedCount: number;
+  runningCount: number;
+  failedCount: number;
+  interruptedCount: number;
+  closedCount: number;
+  isAllCompleted: boolean;
+  hasActive: boolean;
+  summaryCopy: string;
+}
+
+interface ActionLike {
+  tool: string;
+  arguments?: unknown;
+  result?: unknown;
+}
+
+function toNodeStatus(raw: string | undefined): OrchestrationNodeStatus {
+  switch (raw) {
+    case 'pending':
+    case 'running':
+    case 'completed':
+    case 'failed':
+    case 'interrupted':
+    case 'closed':
+    case 'cancelled':
+      return raw;
+    case 'error':
+      return 'failed';
+    default:
+      return 'running';
+  }
+}
+
+function buildOrchestrationFlow(nodes: OrchestrationChildNode[]): OrchestrationFlowData | null {
+  if (nodes.length === 0) return null;
+
+  const totalCount = nodes.length;
+  const completedCount = nodes.filter((n) => n.status === 'completed').length;
+  const runningCount = nodes.filter((n) => n.status === 'running' || n.status === 'pending').length;
+  const failedCount = nodes.filter((n) => n.status === 'failed').length;
+  const interruptedCount = nodes.filter((n) => n.status === 'interrupted').length;
+  const closedCount = nodes.filter((n) => n.status === 'closed' || n.status === 'cancelled').length;
+  const isAllCompleted = totalCount > 0 && completedCount === totalCount;
+  const hasActive = runningCount > 0;
+
+  let summaryCopy = '';
+  if (isAllCompleted) {
+    summaryCopy = `${completedCount}/${totalCount} 全部完成`;
+  } else if (hasActive) {
+    summaryCopy = `协同执行中 (${completedCount}/${totalCount} 完成)...`;
+  } else {
+    summaryCopy = `${completedCount} 完成 · ${totalCount - completedCount} 结束 (${totalCount} 个子任务)`;
+  }
+
+  return {
+    nodes,
+    totalCount,
+    completedCount,
+    runningCount,
+    failedCount,
+    interruptedCount,
+    closedCount,
+    isAllCompleted,
+    hasActive,
+    summaryCopy,
+  };
+}
+
+/**
+ * 父回合已经结束时，还标着 running/pending 的分支不会再收到子代理终态
+ * （停止发生在流关闭之后）。把它们收成 cancelled，避免胶囊一直停在「协同执行中」。
+ */
+export function settleStoppedOrchestration(flow: OrchestrationFlowData): OrchestrationFlowData {
+  if (!flow.nodes.some((node) => node.status === 'running' || node.status === 'pending')) {
+    return flow;
+  }
+  return (
+    buildOrchestrationFlow(
+      flow.nodes.map((node) =>
+        node.status === 'running' || node.status === 'pending'
+          ? { ...node, status: 'cancelled' }
+          : node,
+      ),
+    ) ?? flow
+  );
+}
+
+function safeParseJson(value: unknown): Record<string, unknown> | null {
+  if (!value) return null;
+  if (typeof value === 'object' && !Array.isArray(value)) {
+    return value as Record<string, unknown>;
+  }
+  if (typeof value === 'string') {
+    const trimmed = value.trim();
+    if ((trimmed.startsWith('{') && trimmed.endsWith('}')) || (trimmed.startsWith('[') && trimmed.endsWith(']'))) {
+      try {
+        const parsed = JSON.parse(trimmed);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+          return parsed as Record<string, unknown>;
+        }
+      } catch {
+        return null;
+      }
+    }
+  }
+  return null;
+}
+
+export function extractOrchestrationFlow(
+  actions?: readonly ActionLike[] | null,
+  children?: readonly ChildInfo[] | null,
+): OrchestrationFlowData | null {
+  const nodeMap = new Map<string, OrchestrationChildNode>();
+
+  // 1. 先用 SSE 累积的 ChildInfo 占位（实时性最高，包含 live 状态与 recordId）
+  if (children && children.length > 0) {
+    for (const c of children) {
+      if (!c.childId) continue;
+      nodeMap.set(c.childId, {
+        childId: c.childId,
+        task: c.task || '',
+        status: toNodeStatus(c.status),
+        recordId: c.recordId,
+        steers: [],
+      });
+    }
+  }
+
+  // 2. 扫描 actions 里的编排六件套
+  const actionList = actions ?? [];
+  let hasOrchAction = false;
+
+  actionList.forEach((action, actionIdx) => {
+    if (!isOrchestrationTool(action.tool)) return;
+    hasOrchAction = true;
+
+    const rawArgs = safeParseJson(action.arguments) ?? {};
+    const envelope = parseToolEnvelope(action.result);
+    const innerMsg = safeParseJson(envelope.message);
+    const innerData = safeParseJson(envelope.fields?.data);
+
+    if (action.tool === 'agent_spawn') {
+      const task = typeof rawArgs.task === 'string' ? rawArgs.task.trim() : '';
+      const rawFilter = Array.isArray(rawArgs.toolFilter) ? rawArgs.toolFilter.map(String) : undefined;
+
+      // childId 优先从结果里提取
+      const childId =
+        (typeof envelope.fields.childId === 'string' ? envelope.fields.childId : null) ??
+        (typeof innerData?.childId === 'string' ? innerData.childId : null) ??
+        (typeof innerMsg?.childId === 'string' ? innerMsg.childId : null) ??
+        `spawn-${actionIdx}`;
+
+      let node = nodeMap.get(childId);
+      if (!node) {
+        node = {
+          childId,
+          task,
+          toolFilter: rawFilter,
+          status: 'running',
+          steers: [],
+          spawnActionIndex: actionIdx,
+        };
+        nodeMap.set(childId, node);
+      } else {
+        if (!node.task && task) node.task = task;
+        if (!node.toolFilter && rawFilter) node.toolFilter = rawFilter;
+        if (node.spawnActionIndex === undefined) node.spawnActionIndex = actionIdx;
+      }
+
+      if (envelope.success === false || envelope.error) {
+        node.status = 'failed';
+        node.error = envelope.error || '派发失败';
+      }
+    } else if (action.tool === 'agent_wait') {
+      const childId = typeof rawArgs.childId === 'string' ? rawArgs.childId.trim() : '';
+      if (childId) {
+        let node = nodeMap.get(childId);
+        if (!node) {
+          node = {
+            childId,
+            task: '',
+            status: 'running',
+            steers: [],
+            waitActionIndex: actionIdx,
+          };
+          nodeMap.set(childId, node);
+        } else {
+          node.waitActionIndex = actionIdx;
+        }
+
+        const waitStatus =
+          (typeof innerData?.status === 'string' ? innerData.status : null) ??
+          (typeof innerMsg?.status === 'string' ? innerMsg.status : null);
+        const answer =
+          (typeof innerMsg?.answer === 'string' ? innerMsg.answer : null) ??
+          (typeof innerData?.answer === 'string' ? innerData.answer : null);
+
+        if (answer) {
+          node.answer = answer;
+        }
+
+        if (waitStatus === 'completed') {
+          node.status = 'completed';
+        } else if (waitStatus === 'failed' || waitStatus === 'error' || envelope.success === false) {
+          node.status = 'failed';
+          node.error = envelope.error || '执行失败';
+        } else if (waitStatus === 'cancelled') {
+          node.status = 'cancelled';
+        } else if (waitStatus === 'interrupted') {
+          node.interrupted = true;
+          node.status = 'interrupted';
+        } else if (waitStatus === 'closed') {
+          node.closed = true;
+          if (node.status !== 'completed') node.status = 'closed';
+        } else if (waitStatus === 'running') {
+          node.status = 'running';
+        }
+      }
+    } else if (action.tool === 'agent_send') {
+      const childId = typeof rawArgs.childId === 'string' ? rawArgs.childId.trim() : '';
+      const message = typeof rawArgs.message === 'string' ? rawArgs.message.trim() : '';
+      if (childId && message) {
+        const node = nodeMap.get(childId);
+        if (node) {
+          const delivery =
+            (typeof innerData?.delivery === 'string' ? innerData.delivery : null) ??
+            (typeof innerMsg?.delivery === 'string' ? innerMsg.delivery : null);
+          node.steers.push({ message, delivery: delivery ?? undefined });
+        }
+      }
+    } else if (action.tool === 'agent_interrupt') {
+      const childId = typeof rawArgs.childId === 'string' ? rawArgs.childId.trim() : '';
+      if (childId) {
+        const node = nodeMap.get(childId);
+        if (node) {
+          node.interrupted = true;
+          node.status = 'interrupted';
+        }
+      }
+    } else if (action.tool === 'agent_close') {
+      const childId = typeof rawArgs.childId === 'string' ? rawArgs.childId.trim() : '';
+      if (childId) {
+        const node = nodeMap.get(childId);
+        if (node) {
+          node.closed = true;
+          if (node.status !== 'completed') {
+            node.status = 'closed';
+          }
+        }
+      }
+    } else if (action.tool === 'agent_list') {
+      const childrenArr = Array.isArray(innerMsg?.children) ? innerMsg.children : null;
+      if (childrenArr) {
+        for (const rawChild of childrenArr) {
+          if (rawChild && typeof rawChild === 'object') {
+            const cid = typeof rawChild.childId === 'string' ? rawChild.childId : '';
+            if (!cid) continue;
+            const listedStatus =
+              typeof rawChild.status === 'string' ? toNodeStatus(rawChild.status) : undefined;
+            const listedAnswer =
+              (typeof rawChild.answer === 'string' && rawChild.answer) ||
+              (typeof rawChild.answerPreview === 'string' && rawChild.answerPreview) ||
+              '';
+            let node = nodeMap.get(cid);
+            if (!node) {
+              node = {
+                childId: cid,
+                task: typeof rawChild.task === 'string' ? rawChild.task : '',
+                status: listedStatus ?? 'running',
+                answer: listedAnswer || undefined,
+                steers: [],
+              };
+              nodeMap.set(cid, node);
+            } else {
+              if (!node.task && rawChild.task) node.task = String(rawChild.task);
+              if (!node.answer && listedAnswer) node.answer = listedAnswer;
+              if (listedStatus) node.status = listedStatus;
+            }
+          }
+        }
+      }
+    }
+  });
+
+  if (!hasOrchAction && (!children || children.length === 0)) {
+    return null;
+  }
+
+  return buildOrchestrationFlow(Array.from(nodeMap.values()));
+}
+
+function actionsFromTimeline(blocks?: ReadonlyArray<{ type: string; actions?: unknown[] }>): ActionLike[] {
+  if (!blocks) return [];
+  const actions: ActionLike[] = [];
+  for (const block of blocks) {
+    if (block.type === 'tools' && Array.isArray(block.actions)) {
+      actions.push(...(block.actions as ActionLike[]));
+    }
+  }
+  return actions;
+}
+
+/**
+ * 提取当前打开对话中最新一轮的编排流程。
+ * 正在流式/执行中的回合优先；历史回合倒序寻找最新的一次编排。
+ */
+export function resolveLatestSessionOrchestrationFlow(input: {
+  messages: Array<{ id: string }>;
+  executedActionsByMessageId?: Record<string, ActionLike[]>;
+  currentTurnActions?: ActionLike[];
+  currentTurnChildren?: ChildInfo[];
+  orchestrationChildrenByMessageId?: Record<string, ChildInfo[]>;
+  timelineByMessageId?: Record<string, Array<{ type: string; actions?: unknown[] }>>;
+  currentTurnTimeline?: Array<{ type: string; actions?: unknown[] }>;
+  /** 父回合仍在流式输出。结束后残留的 running 分支收成已停止。 */
+  turnActive?: boolean;
+}): OrchestrationFlowData | null {
+  const finish = (flow: OrchestrationFlowData | null, active: boolean) => {
+    if (!flow || flow.totalCount === 0) return null;
+    return active ? flow : settleStoppedOrchestration(flow);
+  };
+
+  // 1. 优先实时回合
+  const liveActions =
+    input.currentTurnActions ?? actionsFromTimeline(input.currentTurnTimeline);
+  const liveFlow = finish(
+    extractOrchestrationFlow(liveActions, input.currentTurnChildren),
+    input.turnActive !== false,
+  );
+  if (liveFlow) return liveFlow;
+
+  // 2. 倒序历史回合。落库的回合已经结束，残留 running 同样收成已停止。
+  for (let i = input.messages.length - 1; i >= 0; i -= 1) {
+    const id = input.messages[i].id;
+    const actions =
+      input.executedActionsByMessageId?.[id] ??
+      actionsFromTimeline(input.timelineByMessageId?.[id]);
+    const children = input.orchestrationChildrenByMessageId?.[id];
+    const flow = finish(extractOrchestrationFlow(actions, children), false);
+    if (flow) return flow;
+  }
+
+  return null;
+}

package/src/components/chat/prompt-chat-scope.ts

@@ -0,0 +1,33 @@
+/** Chat id from `#/agent/:chatId` (hash router) or `/agent/:chatId`. */
+export function chatIdFromLocation(location: { pathname: string; hash: string }): string | null {
+  const hashed = location.hash.startsWith('#') ? location.hash.slice(1) : '';
+  const raw = hashed || location.pathname;
+  const match = raw.match(/\/agent\/([^/?#]+)/);
+  if (!match?.[1]) return null;
+  try {
+    return decodeURIComponent(match[1]);
+  } catch {
+    return match[1];
+  }
+}
+
+/** Stamp an unscoped prompt with the chat open when it arrived. */
+export function bindPromptToActiveChat<T extends { chatId?: string }>(request: T): T {
+  if (request.chatId) return request;
+  const chatId = chatIdFromLocation(window.location);
+  if (!chatId) return request;
+  return { ...request, chatId };
+}
+
+/**
+ * A prompt with a chat id belongs only to that chat.
+ * A prompt without one stays visible only when the composer itself has no chat,
+ * so an older request is still answerable.
+ */
+export function promptVisibleInChat(
+  request: { chatId?: string },
+  chatId: string | null | undefined,
+): boolean {
+  if (!request.chatId) return !chatId;
+  return request.chatId === chatId;
+}