源码快照 @ 2026-09-01 (source-only, 剔除非源码素材)

packages/agent/gui/shared/agentConversation/contracts/agentMessageRowVM.ts

@@ -0,0 +1,131 @@
+import type { AgentActivityMessageSemantics } from "@tutti-os/agent-activity-core";
+import type { ToolCallStatusKind } from "../../workspaceAgentToolCallDisplay";
+import type { WorkspaceAgentActivityTimelineItem } from "../../workspaceAgentTimelineTypes";
+import type { AgentTranscriptPresentationKind } from "./agentTranscriptPresentation";
+import type { AgentCollaborationVM } from "./agentCollaborationVM";
+import type { AgentToolGroupRowVM } from "./agentToolGroupRowVM";
+
+export type AgentMessageContentKind =
+  | "text"
+  | "image-grid"
+  | "plan"
+  | "collaboration"
+  | "tutti-checkpoint-wake"
+  | "tutti-plan-issue-link"
+  | "selected-text";
+
+export interface AgentMessageContentVM {
+  kind: "message-content";
+  id: string;
+  turnId: string;
+  body: string;
+  presentationKind: AgentTranscriptPresentationKind;
+  copyText?: string | null;
+  statusKind?: ToolCallStatusKind | null;
+  contentKind?: AgentMessageContentKind;
+  isTurnFinalText?: true;
+  /** Typed payload for `contentKind: "collaboration"` rows. */
+  collaboration?: AgentCollaborationVM | null;
+  /**
+   * Typed payload for `contentKind: "tutti-checkpoint-wake"` rows: a daemon
+   * checkpoint-wake prompt injected into the source agent. `body` carries the
+   * full prompt (minus the sentinel line) for the expand-to-full affordance.
+   */
+  checkpointWake?: AgentTuttiModeCheckpointWakeVM | null;
+  /**
+   * Typed payload for `contentKind: "tutti-plan-issue-link"` rows: the durable
+   * plan→Issue reverse link the daemon writes when the user accepts a Tutti
+   * Mode plan (messageId "plan-issue:<issueID>").
+   */
+  planIssueLink?: AgentTuttiPlanIssueLinkVM | null;
+  /** Typed payload for `contentKind: "selected-text"` rows. */
+  selectedText?: AgentSelectedTextVM | null;
+  images?: AgentMessageImageVM[];
+  occurredAtUnixMs: number | null;
+  visibleError?: {
+    code: string | null;
+    phase: string | null;
+    provider: string | null;
+    origin?: string | null;
+    detail: string | null;
+    detailAvailable?: boolean;
+    retryable: boolean | null;
+  } | null;
+  systemNotice?: {
+    noticeKind: string | null;
+    semanticKind?: "context-handoff-required" | null;
+    severity: string | null;
+    source?: string | null;
+    command?: AgentActivityMessageSemantics["noticeCommand"] | null;
+    commandStatus?: AgentActivityMessageSemantics["noticeCommandStatus"] | null;
+    title: string | null;
+    detail: string | null;
+    retryable: boolean | null;
+  } | null;
+  sourceTimelineItems?: WorkspaceAgentActivityTimelineItem[];
+}
+
+export interface AgentSelectedTextVM {
+  count: number;
+  texts: readonly string[];
+}
+
+export interface AgentTuttiModeCheckpointWakeVM {
+  /** Wire kind, e.g. "task_settled" | "task_failed" | "all_tasks_terminal". */
+  kind: string;
+  issueId: string;
+  checkpointId: string;
+  graphRevision: number | null;
+}
+
+export interface AgentTuttiPlanIssueLinkVM {
+  issueId: string;
+  /** Issue title with markdown escapes removed; falls back to the issue id. */
+  title: string;
+  /** The original single-mention markdown, rendered as the issue chip. */
+  mentionMarkdown: string;
+}
+
+export interface AgentMessageImageVM {
+  id: string;
+  workspaceId?: string | null;
+  agentSessionId: string;
+  attachmentId?: string | null;
+  mimeType: string;
+  name?: string | null;
+  data?: string | null;
+  url?: string | null;
+  path?: string | null;
+}
+
+export interface AgentThinkingContentVM {
+  kind: "thinking-content";
+  id: string;
+  turnId: string;
+  body: string;
+  statusKind?: ToolCallStatusKind | null;
+  occurredAtUnixMs: number | null;
+  sourceTimelineItems?: WorkspaceAgentActivityTimelineItem[];
+}
+
+export interface AgentMessageRowVM {
+  kind: "message";
+  id: string;
+  turnId: string;
+  speaker: "user" | "assistant";
+  /**
+   * Exact first text block from the submitted structured content. Editing must
+   * not recover this value from displayPrompt, copy text, or rendered Markdown.
+   */
+  rawFirstTextBlock?: string | null;
+  messages: AgentMessageContentVM[];
+  thinking: AgentThinkingContentVM[];
+  /**
+   * Tool-group rows that happened right before this message and are rendered
+   * inside this message's block (under the participant header, above the
+   * content) instead of as standalone transcript rows. Populated only for the
+   * participant-header presentation (e.g. the Agent board session detail).
+   */
+  leadingToolRows?: AgentToolGroupRowVM[];
+  occurredAtUnixMs: number | null;
+}