clawdex-mobile 5.0.0 → 5.0.2

package/apps/mobile/src/api/chatMapping.ts

@@ -1,1048 +0,0 @@
-import type {
-  Chat,
-  ChatMessage,
-  ChatMessageSubAgentMeta,
-  ChatPlanSnapshot,
-  ChatStatus,
-  ChatSummary,
-  TurnPlanStep,
-} from './types';
-
-export type RawThreadStatus =
-  | { type?: string }
-  | string
-  | null
-  | undefined;
-
-export interface RawTurn {
-  id?: string;
-  status?: string;
-  error?: {
-    message?: string;
-  } | null;
-  items?: RawThreadItem[];
-}
-
-export type RawThreadItem =
-  | {
-      type?: 'userMessage';
-      id?: string;
-      content?: Array<{ type?: string; text?: string; path?: string; url?: string }>;
-    }
-  | {
-      type?: 'agentMessage';
-      id?: string;
-      text?: string;
-    }
-  | {
-      type?: string;
-      id?: string;
-      text?: string;
-    };
-
-export interface RawThread {
-  id?: string;
-  name?: string;
-  title?: string;
-  preview?: string;
-  modelProvider?: string;
-  agentNickname?: string;
-  agentRole?: string;
-  createdAt?: number;
-  updatedAt?: number;
-  status?: RawThreadStatus;
-  cwd?: string;
-  source?: unknown;
-  turns?: RawTurn[];
-}
-
-interface ThreadSourceMetadata {
-  kind?: string;
-  parentThreadId?: string;
-  subAgentDepth?: number;
-}
-
-export function toRecord(value: unknown): Record<string, unknown> | null {
-  return typeof value === 'object' && value !== null
-    ? (value as Record<string, unknown>)
-    : null;
-}
-
-export function readString(value: unknown): string | null {
-  return typeof value === 'string' ? value : null;
-}
-
-function readStringArray(value: unknown): string[] {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-
-  return value
-    .map((entry) => readString(entry)?.trim() ?? '')
-    .filter((entry): entry is string => entry.length > 0);
-}
-
-function readNumber(value: unknown): number | null {
-  return typeof value === 'number' && Number.isFinite(value) ? value : null;
-}
-
-export function toPreview(value: string): string {
-  const collapsed = value.replace(/\s+/g, ' ').trim();
-  if (collapsed.length <= 180) {
-    return collapsed;
-  }
-
-  return `${collapsed.slice(0, 177)}...`;
-}
-
-function unixSecondsToIso(value: number | undefined): string {
-  if (typeof value !== 'number' || !Number.isFinite(value)) {
-    return new Date().toISOString();
-  }
-
-  return new Date(value * 1000).toISOString();
-}
-
-function normalizeLifecycleStatus(value: string | null | undefined): string | null {
-  if (!value) {
-    return null;
-  }
-
-  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9]/g, '');
-  return normalized.length > 0 ? normalized : null;
-}
-
-function mapRawStatus(status: unknown, turns: RawTurn[] | undefined): ChatStatus {
-  const statusRecord = toRecord(status);
-  const statusType = normalizeLifecycleStatus(
-    readString(statusRecord?.type) ?? readString(status)
-  );
-  const hasTurns = Array.isArray(turns) && turns.length > 0;
-  const lastTurn = hasTurns ? turns[turns.length - 1] : null;
-  const lastTurnStatus = normalizeLifecycleStatus(readString(lastTurn?.status));
-  const isIdleLikeStatus = statusType === 'idle' || statusType === 'notloaded';
-
-  if (
-    lastTurnStatus === 'inprogress' ||
-    lastTurnStatus === 'running' ||
-    lastTurnStatus === 'active' ||
-    lastTurnStatus === 'queued' ||
-    lastTurnStatus === 'pending'
-  ) {
-    // Some thread/read payloads can return stale turn state while the thread
-    // itself is already idle/notLoaded. Prefer the thread lifecycle in that case.
-    if (isIdleLikeStatus) {
-      return hasTurns ? 'complete' : 'idle';
-    }
-    return 'running';
-  }
-
-  if (
-    lastTurnStatus === 'failed' ||
-    lastTurnStatus === 'interrupted' ||
-    lastTurnStatus === 'error' ||
-    lastTurnStatus === 'aborted'
-  ) {
-    return 'error';
-  }
-
-  if (
-    lastTurnStatus === 'completed' ||
-    lastTurnStatus === 'complete' ||
-    lastTurnStatus === 'success' ||
-    lastTurnStatus === 'succeeded'
-  ) {
-    return 'complete';
-  }
-
-  if (
-    statusType === 'systemerror' ||
-    statusType === 'error' ||
-    statusType === 'failed'
-  ) {
-    return 'error';
-  }
-
-  if (
-    statusType === 'running' ||
-    statusType === 'inprogress' ||
-    statusType === 'queued' ||
-    statusType === 'pending'
-  ) {
-    return 'running';
-  }
-
-  if (statusType === 'active') {
-    // Some backends keep a thread "active" while loaded in memory even when no
-    // turn is running. If there is no in-progress turn, avoid false "working" UI.
-    return hasTurns ? 'complete' : 'idle';
-  }
-
-  if (isIdleLikeStatus) {
-    return hasTurns ? 'complete' : 'idle';
-  }
-
-  return 'idle';
-}
-
-function extractLastError(turns: RawTurn[]): string | null {
-  for (let i = turns.length - 1; i >= 0; i -= 1) {
-    const turn = turns[i];
-    const turnStatus = readString(turn.status);
-    if (turnStatus !== 'failed' && turnStatus !== 'interrupted') {
-      continue;
-    }
-
-    const message = readString(turn.error?.message);
-    if (message) {
-      return message;
-    }
-
-    return `turn ${turnStatus}`;
-  }
-
-  return null;
-}
-
-export function toRawThread(value: unknown): RawThread {
-  const record = toRecord(value) ?? {};
-  const threadName =
-    readString(record.name) ??
-    readString(record.title) ??
-    readString(record.threadName) ??
-    readString(record.thread_name) ??
-    undefined;
-  return {
-    id: readString(record.id) ?? undefined,
-    name: threadName,
-    title: threadName,
-    preview: readString(record.preview) ?? undefined,
-    modelProvider: readString(record.modelProvider) ?? undefined,
-    agentNickname:
-      readString(record.agentNickname) ??
-      readString(record.agent_nickname) ??
-      undefined,
-    agentRole:
-      readString(record.agentRole) ??
-      readString(record.agent_role) ??
-      undefined,
-    createdAt: readNumber(record.createdAt) ?? undefined,
-    updatedAt: readNumber(record.updatedAt) ?? undefined,
-    status: (record.status as RawThreadStatus) ?? undefined,
-    cwd: readString(record.cwd) ?? undefined,
-    source: record.source,
-    turns: Array.isArray(record.turns)
-      ? (record.turns.map((turn) => toRawTurn(turn)).filter(Boolean) as RawTurn[])
-      : undefined,
-  };
-}
-
-function toRawTurn(value: unknown): RawTurn | null {
-  const record = toRecord(value);
-  if (!record) {
-    return null;
-  }
-
-  const items = Array.isArray(record.items)
-    ? (record.items
-        .map((item) => toRecord(item))
-        .filter((item): item is RawThreadItem => item !== null) as RawThreadItem[])
-    : undefined;
-
-  return {
-    id: readString(record.id) ?? undefined,
-    status: readString(record.status) ?? undefined,
-    error: toRecord(record.error) as { message?: string } | null,
-    items,
-  };
-}
-
-export function mapChatSummary(raw: RawThread): ChatSummary | null {
-  if (!raw.id) {
-    return null;
-  }
-
-  const createdAt = unixSecondsToIso(raw.createdAt);
-  const updatedAt = unixSecondsToIso(raw.updatedAt);
-  const turns = Array.isArray(raw.turns) ? raw.turns : [];
-  const sourceMetadata = readThreadSourceMetadata(raw.source);
-
-  const lastError = extractLastError(turns);
-  const displayTitle = raw.name ?? raw.preview;
-
-  return {
-    id: raw.id,
-    title: toPreview(displayTitle || `Chat ${raw.id.slice(0, 8)}`),
-    status: mapRawStatus(raw.status, turns),
-    createdAt,
-    updatedAt,
-    statusUpdatedAt: updatedAt,
-    lastMessagePreview: toPreview(raw.preview || ''),
-    cwd: readString(raw.cwd) ?? undefined,
-    modelProvider: readString(raw.modelProvider) ?? undefined,
-    agentNickname: readString(raw.agentNickname) ?? undefined,
-    agentRole: readString(raw.agentRole) ?? undefined,
-    sourceKind: sourceMetadata.kind,
-    parentThreadId: sourceMetadata.parentThreadId,
-    subAgentDepth: sourceMetadata.subAgentDepth,
-    lastError: lastError ?? undefined,
-  };
-}
-
-function readThreadSourceMetadata(source: unknown): ThreadSourceMetadata {
-  if (typeof source === 'string') {
-    return {
-      kind: source,
-    };
-  }
-
-  const sourceRecord = toRecord(source);
-  if (!sourceRecord) {
-    return {};
-  }
-
-  // Legacy shape used by older adapters.
-  const legacyKind = readString(sourceRecord.kind);
-  if (legacyKind) {
-    return {
-      kind: legacyKind,
-      parentThreadId:
-        readString(sourceRecord.parentThreadId) ??
-        readString(sourceRecord.parent_thread_id) ??
-        undefined,
-      subAgentDepth:
-        readNumber(sourceRecord.depth) ??
-        readNumber(sourceRecord.agentDepth) ??
-        readNumber(sourceRecord.agent_depth) ??
-        undefined,
-    };
-  }
-
-  // Current app-server shape: { subAgent: ... } tagged union.
-  const subAgentValue =
-    sourceRecord.subAgent ??
-    sourceRecord.subagent;
-
-  if (subAgentValue !== undefined) {
-    const subAgent = subAgentValue;
-    if (typeof subAgent === 'string') {
-      const kind =
-        subAgent === 'review'
-          ? 'subAgentReview'
-          : subAgent === 'compact'
-            ? 'subAgentCompact'
-            : subAgent === 'memory_consolidation'
-              ? 'subAgentOther'
-              : 'subAgent';
-      return {
-        kind,
-      };
-    }
-
-    const subAgentRecord = toRecord(subAgent);
-    if (!subAgentRecord) {
-      return {
-        kind: 'subAgent',
-      };
-    }
-
-    const threadSpawn = toRecord(subAgentRecord.thread_spawn);
-    if (threadSpawn) {
-      return {
-        kind: 'subAgentThreadSpawn',
-        parentThreadId:
-          readString(threadSpawn.parentThreadId) ??
-          readString(threadSpawn.parent_thread_id) ??
-          undefined,
-        subAgentDepth:
-          readNumber(threadSpawn.depth) ??
-          readNumber(threadSpawn.agentDepth) ??
-          readNumber(threadSpawn.agent_depth) ??
-          undefined,
-      };
-    }
-
-    if (readString(subAgentRecord.other)) {
-      return {
-        kind: 'subAgentOther',
-      };
-    }
-
-    return {
-      kind: 'subAgent',
-      parentThreadId:
-        readString(subAgentRecord.parentThreadId) ??
-        readString(subAgentRecord.parent_thread_id) ??
-        undefined,
-      subAgentDepth:
-        readNumber(subAgentRecord.depth) ??
-        readNumber(subAgentRecord.agentDepth) ??
-        readNumber(subAgentRecord.agent_depth) ??
-        undefined,
-    };
-  }
-
-  const typeKind = readString(sourceRecord.type);
-  if (typeKind && typeKind.startsWith('subAgent')) {
-    return {
-      kind: typeKind,
-      parentThreadId:
-        readString(sourceRecord.parentThreadId) ??
-        readString(sourceRecord.parent_thread_id) ??
-        undefined,
-      subAgentDepth:
-        readNumber(sourceRecord.depth) ??
-        readNumber(sourceRecord.agentDepth) ??
-        readNumber(sourceRecord.agent_depth) ??
-        undefined,
-    };
-  }
-
-  return {};
-}
-
-export function mapChat(raw: RawThread): Chat {
-  const summary = mapChatSummary(raw);
-  if (!summary) {
-    throw new Error('chat id missing in app-server response');
-  }
-
-  const messages = mapMessages(raw, summary.createdAt);
-  const plans = extractChatPlans(raw);
-
-  const lastPreview =
-    messages.length > 0
-      ? toPreview(messages[messages.length - 1].content)
-      : summary.lastMessagePreview;
-
-  return {
-    ...summary,
-    lastMessagePreview: lastPreview,
-    messages,
-    latestPlan: plans.latestPlan,
-    latestTurnPlan: plans.latestTurnPlan,
-    latestTurnStatus: plans.latestTurnStatus,
-  };
-}
-
-function extractChatPlans(raw: RawThread): {
-  latestPlan: ChatPlanSnapshot | null;
-  latestTurnPlan: ChatPlanSnapshot | null;
-  latestTurnStatus: string | null;
-} {
-  const threadId = raw.id?.trim();
-  const turns = Array.isArray(raw.turns) ? raw.turns : [];
-  const latestTurn = turns.length > 0 ? turns[turns.length - 1] : null;
-  const latestTurnStatus = readString(latestTurn?.status);
-
-  if (!threadId || turns.length === 0) {
-    return {
-      latestPlan: null,
-      latestTurnPlan: null,
-      latestTurnStatus,
-    };
-  }
-
-  let latestPlan: ChatPlanSnapshot | null = null;
-  let latestTurnPlan: ChatPlanSnapshot | null = null;
-
-  for (const turn of turns) {
-    const turnId = readString(turn.id);
-    const items = Array.isArray(turn.items) ? turn.items : [];
-    let latestPlanInTurn: ChatPlanSnapshot | null = null;
-
-    for (const item of items) {
-      const itemRecord = toRecord(item);
-      if (!itemRecord) {
-        continue;
-      }
-
-      const itemType = normalizeType(readString(itemRecord.type) ?? '');
-      if (itemType !== 'plan') {
-        continue;
-      }
-
-      const plan = toPlanSnapshot(itemRecord, threadId, turnId);
-      if (!plan) {
-        continue;
-      }
-
-      latestPlan = plan;
-      latestPlanInTurn = plan;
-    }
-
-    if (turn === latestTurn) {
-      latestTurnPlan = latestPlanInTurn;
-    }
-  }
-
-  return {
-    latestPlan,
-    latestTurnPlan,
-    latestTurnStatus,
-  };
-}
-
-function mapMessages(raw: RawThread, fallbackCreatedAt: string): ChatMessage[] {
-  const turns = Array.isArray(raw.turns) ? raw.turns : [];
-  if (turns.length === 0) {
-    return [];
-  }
-
-  const baseTs = new Date(fallbackCreatedAt).getTime();
-  const messages: ChatMessage[] = [];
-
-  for (const turn of turns) {
-    const items = Array.isArray(turn.items) ? turn.items : [];
-    for (const item of items) {
-      const itemRecord = toRecord(item);
-      if (!itemRecord) {
-        continue;
-      }
-
-      const itemType = readString(itemRecord.type);
-
-      if (itemType === 'userMessage') {
-        const contentItems = Array.isArray(itemRecord.content) ? itemRecord.content : [];
-        const text = contentItems
-          .map((entry: unknown) => {
-            const entryRecord = toRecord(entry);
-            if (!entryRecord) {
-              return '';
-            }
-
-            const entryType = readString(entryRecord.type);
-            if (entryType === 'text') {
-              return readString(entryRecord.text) ?? '';
-            }
-
-            if (entryType === 'image') {
-              return `[image: ${readString(entryRecord.url) ?? 'unknown'}]`;
-            }
-
-            if (entryType === 'localImage') {
-              return `[local image: ${readString(entryRecord.path) ?? 'unknown'}]`;
-            }
-
-            if (entryType === 'mention') {
-              const mentionPath = readString(entryRecord.path) ?? 'unknown';
-              return `[file: ${mentionPath}]`;
-            }
-
-            return '';
-          })
-          .filter(Boolean)
-          .join('\n');
-
-        if (!text.trim()) {
-          continue;
-        }
-
-        messages.push({
-          id: readString(itemRecord.id) ?? generateLocalId(),
-          role: 'user',
-          content: text,
-          createdAt: new Date(baseTs + messages.length * 1000).toISOString(),
-        });
-        continue;
-      }
-
-      if (itemType === 'agentMessage') {
-        const text = readString(itemRecord.text) ?? '';
-        if (!text.trim()) {
-          continue;
-        }
-
-        messages.push({
-          id: readString(itemRecord.id) ?? generateLocalId(),
-          role: 'assistant',
-          content: text,
-          createdAt: new Date(baseTs + messages.length * 1000).toISOString(),
-        });
-        continue;
-      }
-
-      const toolLikeMessage = toToolLikeMessage(itemRecord);
-      if (toolLikeMessage) {
-        const systemKind = itemType === 'collabToolCall' ? 'subAgent' : 'tool';
-        messages.push({
-          id: readString(itemRecord.id) ?? generateLocalId(),
-          role: 'system',
-          content: toolLikeMessage,
-          systemKind,
-          subAgentMeta: systemKind === 'subAgent' ? toSubAgentMeta(itemRecord) : undefined,
-          createdAt: new Date(baseTs + messages.length * 1000).toISOString(),
-        });
-      }
-    }
-  }
-
-  return messages;
-}
-
-function generateLocalId(): string {
-  return `msg-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
-}
-
-function toPlanSnapshot(
-  item: Record<string, unknown>,
-  threadId: string,
-  fallbackTurnId?: string | null
-): ChatPlanSnapshot | null {
-  const turnId =
-    readString(item.turnId) ??
-    readString(item.turn_id) ??
-    fallbackTurnId ??
-    readString(item.id);
-  if (!turnId) {
-    return null;
-  }
-
-  const rawSteps = Array.isArray(item.plan)
-    ? item.plan
-    : Array.isArray(item.steps)
-      ? item.steps
-      : [];
-  const steps: TurnPlanStep[] = rawSteps
-    .map((entry) => {
-      const entryRecord = toRecord(entry);
-      if (!entryRecord) {
-        return null;
-      }
-
-      const step = readString(entryRecord.step);
-      const status = normalizePlanStepStatus(readString(entryRecord.status));
-      if (!step || !status) {
-        return null;
-      }
-
-      return {
-        step,
-        status,
-      } satisfies TurnPlanStep;
-    })
-    .filter((entry): entry is TurnPlanStep => entry !== null);
-  const explanation = readString(item.explanation);
-
-  if (steps.length === 0 && !explanation?.trim()) {
-    return parsePlanTextSnapshot(readString(item.text), threadId, turnId);
-  }
-
-  return {
-    threadId,
-    turnId,
-    explanation,
-    steps,
-  };
-}
-
-function parsePlanTextSnapshot(
-  text: string | null | undefined,
-  threadId: string,
-  turnId: string
-): ChatPlanSnapshot | null {
-  const trimmed = text?.trim();
-  if (!trimmed) {
-    return null;
-  }
-
-  const lines = trimmed
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter((line) => line.length > 0);
-  if (lines.length === 0) {
-    return null;
-  }
-
-  const hasSummaryHeader = lines.some((line) => /^summary$/i.test(line));
-  const steps: TurnPlanStep[] = [];
-  for (const line of lines) {
-    const match = line.match(/^\d+[.)]\s+(.+)$/);
-    if (!match?.[1]) {
-      continue;
-    }
-
-    steps.push({
-      step: match[1].trim(),
-      status: 'pending',
-    });
-  }
-
-  if (!hasSummaryHeader && steps.length === 0) {
-    return null;
-  }
-
-  let startIndex = 0;
-  if (lines.length > 1 && /plan$/i.test(lines[0])) {
-    startIndex = 1;
-  }
-  if (lines[startIndex] && /^summary$/i.test(lines[startIndex])) {
-    startIndex += 1;
-  }
-
-  const explanationLines: string[] = [];
-  for (let index = startIndex; index < lines.length; index += 1) {
-    const line = lines[index];
-    if (/^\d+[.)]\s+/.test(line)) {
-      break;
-    }
-    if (/^(summary|implementation plan|proposed plan)$/i.test(line)) {
-      continue;
-    }
-    explanationLines.push(line);
-  }
-
-  const explanation =
-    explanationLines.length > 0 ? explanationLines.join(' ').trim() : null;
-
-  if (steps.length === 0 && !explanation) {
-    return null;
-  }
-
-  return {
-    threadId,
-    turnId,
-    explanation,
-    steps,
-  };
-}
-
-function normalizePlanStepStatus(value: string | null | undefined): TurnPlanStep['status'] | null {
-  if (!value) {
-    return null;
-  }
-
-  const normalized = value.trim().toLowerCase().replace(/[^a-z]/g, '');
-  if (normalized === 'pending') {
-    return 'pending';
-  }
-  if (normalized === 'inprogress') {
-    return 'inProgress';
-  }
-  if (normalized === 'completed' || normalized === 'complete') {
-    return 'completed';
-  }
-  return null;
-}
-
-function toToolLikeMessage(item: Record<string, unknown>): string | null {
-  const rawType = readString(item.type);
-  if (!rawType) {
-    return null;
-  }
-
-  const type = normalizeType(rawType);
-
-  if (type === 'plan') {
-    const text = normalizeMultiline(readString(item.text), 1800);
-    return text || null;
-  }
-
-  if (type === 'commandexecution') {
-    const command = normalizeInline(readString(item.command), 240) ?? 'command';
-    const status = normalizeType(readString(item.status) ?? '');
-    const output =
-      normalizeMultiline(readString(item.aggregatedOutput), 2400) ??
-      normalizeMultiline(readString(item.aggregated_output), 2400);
-    const exitCode = readNumber(item.exitCode) ?? readNumber(item.exit_code);
-    const title =
-      status === 'failed' || status === 'error'
-        ? `• Command failed \`${command}\``
-        : `• Ran \`${command}\``;
-    const outputPreview = output ? toNestedOutput(output, 8, 1600) : null;
-    const detail = outputPreview ?? (exitCode !== null ? `exit code ${String(exitCode)}` : null);
-    return withNestedDetail(title, detail);
-  }
-
-  if (type === 'mcptoolcall') {
-    const server = normalizeInline(readString(item.server), 120);
-    const tool = normalizeInline(readString(item.tool), 120);
-    const label = [server, tool].filter(Boolean).join(' / ') || 'MCP tool call';
-    const status = normalizeType(readString(item.status) ?? '');
-    const errorRecord = toRecord(item.error);
-    const errorDetail =
-      normalizeInline(readString(errorRecord?.message), 240) ??
-      normalizeInline(readString(item.error), 240);
-    const resultDetail = toStructuredPreview(item.result, 240);
-    const detail =
-      status === 'failed' || status === 'error'
-        ? errorDetail ?? resultDetail
-        : resultDetail;
-    const title =
-      status === 'failed' || status === 'error'
-        ? `• Tool failed \`${label}\``
-        : `• Called tool \`${label}\``;
-    return withNestedDetail(title, detail);
-  }
-
-  if (type === 'collabtoolcall') {
-    const tool = normalizeType(readString(item.tool) ?? '');
-    const status = normalizeType(readString(item.status) ?? '');
-    const prompt = normalizeInline(readString(item.prompt), 220);
-    const receiverThreadIds = readReceiverThreadIds(item);
-    const primaryReceiverThreadId = normalizeInline(receiverThreadIds[0], 120);
-    const newThreadId = normalizeInline(
-      readString(item.newThreadId) ??
-        readString(item.new_thread_id) ??
-        primaryReceiverThreadId,
-      120
-    );
-    const senderThreadId = normalizeInline(
-      readString(item.senderThreadId) ?? readString(item.sender_thread_id),
-      120
-    );
-    const agentStatus = normalizeInline(
-      readString(item.agentStatus) ?? readString(item.agent_status),
-      120
-    );
-
-    const title = (() => {
-      if (tool === 'spawnagent') {
-        if (status === 'failed' || status === 'error') {
-          return '• Sub-agent spawn failed';
-        }
-        if (status === 'completed' || status === 'complete' || status === 'succeeded') {
-          return '• Spawned sub-agent';
-        }
-        return '• Spawning sub-agent';
-      }
-
-      if (tool === 'sendinput') {
-        return status === 'failed' || status === 'error'
-          ? '• Sub-agent update failed'
-          : '• Sent follow-up to sub-agent';
-      }
-
-      if (tool === 'wait') {
-        return status === 'failed' || status === 'error'
-          ? '• Waiting on sub-agent failed'
-          : '• Waiting on sub-agent';
-      }
-
-      if (tool === 'closeagent') {
-        return status === 'failed' || status === 'error'
-          ? '• Closing sub-agent failed'
-          : '• Closed sub-agent thread';
-      }
-
-      return status === 'failed' || status === 'error'
-        ? '• Sub-agent action failed'
-        : '• Updated sub-agent thread';
-    })();
-
-    const detailParts = [
-      prompt ? `Prompt: ${prompt}` : null,
-      newThreadId ? `Thread: ${newThreadId}` : null,
-      primaryReceiverThreadId ? `Target: ${primaryReceiverThreadId}` : null,
-      senderThreadId ? `From: ${senderThreadId}` : null,
-      agentStatus ? `Status: ${agentStatus}` : null,
-    ].filter(Boolean);
-
-    return withNestedDetail(title, detailParts.join('\n') || null);
-  }
-
-  if (type === 'websearch') {
-    const query = normalizeInline(readString(item.query), 180);
-    const actionRecord = toRecord(item.action);
-    const actionType = normalizeType(readString(actionRecord?.type) ?? '');
-    let detail: string | null = query;
-
-    if (actionType === 'openpage') {
-      detail = normalizeInline(readString(actionRecord?.url), 240) ?? detail;
-    } else if (actionType === 'findinpage') {
-      const url = normalizeInline(readString(actionRecord?.url), 180);
-      const pattern = normalizeInline(readString(actionRecord?.pattern), 120);
-      detail = [url, pattern ? `pattern: ${pattern}` : null].filter(Boolean).join(' | ') || detail;
-    }
-
-    const title = query ? `• Searched web for "${query}"` : '• Searched web';
-    return withNestedDetail(title, detail && detail !== query ? detail : null);
-  }
-
-  if (type === 'filechange') {
-    const status = normalizeType(readString(item.status) ?? '');
-    const changeCount = Array.isArray(item.changes) ? item.changes.length : 0;
-    const detail =
-      changeCount > 0
-        ? `${String(changeCount)} file${changeCount === 1 ? '' : 's'} changed`
-        : null;
-    const title =
-      status === 'failed' || status === 'error'
-        ? '• File changes failed'
-        : '• Applied file changes';
-    return withNestedDetail(title, detail);
-  }
-
-  if (type === 'imageview') {
-    const path = normalizeInline(readString(item.path), 220);
-    if (!path) {
-      return null;
-    }
-    return `• Viewed image\n  └ ${path}`;
-  }
-
-  if (type === 'enteredreviewmode') {
-    return '• Entered review mode';
-  }
-
-  if (type === 'exitedreviewmode') {
-    return '• Exited review mode';
-  }
-
-  if (type === 'contextcompaction') {
-    return '• Compacted conversation context';
-  }
-
-  return null;
-}
-
-function toSubAgentMeta(item: Record<string, unknown>): ChatMessageSubAgentMeta | undefined {
-  const tool = readString(item.tool) ?? undefined;
-  const prompt = normalizeInline(readString(item.prompt), 4000) ?? undefined;
-  const senderThreadId =
-    normalizeInline(
-      readString(item.senderThreadId) ?? readString(item.sender_thread_id),
-      200
-    ) ?? undefined;
-  const agentStatus =
-    normalizeInline(
-      readString(item.agentStatus) ?? readString(item.agent_status),
-      200
-    ) ?? undefined;
-  const receiverThreadIds = readReceiverThreadIds(item);
-
-  if (!tool && !prompt && !senderThreadId && receiverThreadIds.length === 0 && !agentStatus) {
-    return undefined;
-  }
-
-  return {
-    tool,
-    prompt,
-    senderThreadId,
-    receiverThreadIds,
-    agentStatus,
-  };
-}
-
-function readReceiverThreadIds(item: Record<string, unknown>): string[] {
-  const pluralIds = [
-    ...readStringArray(item.receiverThreadIds),
-    ...readStringArray(item.receiver_thread_ids),
-  ];
-  if (pluralIds.length > 0) {
-    return Array.from(new Set(pluralIds));
-  }
-
-  const singularIds = [
-    readString(item.newThreadId),
-    readString(item.new_thread_id),
-    readString(item.receiverThreadId),
-    readString(item.receiver_thread_id),
-  ]
-    .map((value) => value?.trim() ?? '')
-    .filter((value): value is string => value.length > 0);
-
-  return singularIds;
-}
-
-function normalizeType(value: string): string {
-  return value.replace(/[^a-zA-Z0-9]/g, '').toLowerCase();
-}
-
-function normalizeInline(value: string | null, maxChars: number): string | null {
-  if (!value) {
-    return null;
-  }
-
-  const cleaned = value.replace(/\s+/g, ' ').trim();
-  if (!cleaned) {
-    return null;
-  }
-
-  if (cleaned.length <= maxChars) {
-    return cleaned;
-  }
-
-  return `${cleaned.slice(0, Math.max(1, maxChars - 1))}…`;
-}
-
-function normalizeMultiline(value: string | null, maxChars: number): string | null {
-  if (!value) {
-    return null;
-  }
-
-  const cleaned = value
-    .replace(/\u001b\[[0-9;]*[A-Za-z]/g, '')
-    .replace(/\r\n/g, '\n')
-    .trim();
-  if (!cleaned) {
-    return null;
-  }
-
-  if (cleaned.length <= maxChars) {
-    return cleaned;
-  }
-
-  return `${cleaned.slice(0, Math.max(1, maxChars - 1))}…`;
-}
-
-function toNestedOutput(
-  value: string,
-  maxLines: number,
-  maxChars: number
-): string | null {
-  const normalized = normalizeMultiline(value, maxChars);
-  if (!normalized) {
-    return null;
-  }
-
-  const lines = normalized
-    .split('\n')
-    .map((line) => line.trimEnd())
-    .filter((line) => line.trim().length > 0);
-  if (lines.length === 0) {
-    return null;
-  }
-
-  const limited = lines.slice(0, maxLines);
-  return limited.join('\n');
-}
-
-function withNestedDetail(title: string, detail: string | null): string {
-  if (!detail) {
-    return title;
-  }
-
-  const lines = detail
-    .split('\n')
-    .map((line) => line.trimEnd())
-    .filter((line) => line.trim().length > 0);
-  if (lines.length === 0) {
-    return title;
-  }
-
-  const first = `  └ ${lines[0]}`;
-  if (lines.length === 1) {
-    return `${title}\n${first}`;
-  }
-
-  const rest = lines.slice(1).map((line) => `    ${line}`);
-  return [title, first, ...rest].join('\n');
-}
-
-function toStructuredPreview(value: unknown, maxChars: number): string | null {
-  if (value == null) {
-    return null;
-  }
-
-  if (typeof value === 'string') {
-    return normalizeInline(value, maxChars);
-  }
-
-  try {
-    const serialized = JSON.stringify(value);
-    return normalizeInline(serialized, maxChars);
-  } catch {
-    return null;
-  }
-}