import { ApprovalRequestId, isToolLifecycleItemType, type OrchestrationLatestTurn, type OrchestrationThreadActivity, type OrchestrationProposedPlanId, type ProviderKind, type ToolLifecycleItemType, type UserInputQuestion, type ThreadId, type TurnId, } from "@t3tools/contracts"; import type { ChatMessage, ProposedPlan, SessionPhase, Thread, ThreadSession, TurnDiffSummary, } from "./types"; export type ProviderPickerKind = ProviderKind | "cursor"; export const PROVIDER_OPTIONS: Array<{ value: ProviderPickerKind; label: string; available: boolean; }> = [ { value: "codex", label: "Codex", available: true }, { value: "claudeAgent", label: "Claude", available: true }, { value: "cursor", label: "Cursor", available: false }, ]; export interface WorkLogEntry { id: string; createdAt: string; label: string; detail?: string; command?: string; changedFiles?: ReadonlyArray; tone: "thinking" | "tool" | "info" | "error"; toolTitle?: string; itemType?: ToolLifecycleItemType; requestKind?: PendingApproval["requestKind"]; } export interface PendingApproval { requestId: ApprovalRequestId; requestKind: "command" | "file-read" | "file-change"; createdAt: string; detail?: string; } export interface PendingUserInput { requestId: ApprovalRequestId; createdAt: string; questions: ReadonlyArray; } export interface ActivePlanState { createdAt: string; turnId: TurnId | null; explanation?: string | null; steps: Array<{ step: string; status: "pending" | "inProgress" | "completed"; }>; } export interface LatestProposedPlanState { id: OrchestrationProposedPlanId; createdAt: string; updatedAt: string; turnId: TurnId | null; planMarkdown: string; implementedAt: string | null; implementationThreadId: ThreadId | null; } export type TimelineEntry = | { id: string; kind: "message"; createdAt: string; message: ChatMessage; } | { id: string; kind: "proposed-plan"; createdAt: string; proposedPlan: ProposedPlan; } | { id: string; kind: "work"; createdAt: string; entry: WorkLogEntry; }; export function formatDuration(durationMs: number): string { if (!Number.isFinite(durationMs) || durationMs < 0) return "0ms"; if (durationMs < 1_000) return `${Math.max(1, Math.round(durationMs))}ms`; if (durationMs < 10_000) return `${(durationMs / 1_000).toFixed(1)}s`; if (durationMs < 60_000) return `${Math.round(durationMs / 1_000)}s`; const minutes = Math.floor(durationMs / 60_000); const seconds = Math.round((durationMs % 60_000) / 1_000); if (seconds === 0) return `${minutes}m`; if (seconds === 60) return `${minutes + 1}m`; return `${minutes}m ${seconds}s`; } export function formatElapsed(startIso: string, endIso: string | undefined): string | null { if (!endIso) return null; const startedAt = Date.parse(startIso); const endedAt = Date.parse(endIso); if (Number.isNaN(startedAt) || Number.isNaN(endedAt) || endedAt < startedAt) { return null; } return formatDuration(endedAt - startedAt); } type LatestTurnTiming = Pick; type SessionActivityState = Pick; export function isLatestTurnSettled( latestTurn: LatestTurnTiming | null, session: SessionActivityState | null, ): boolean { if (!latestTurn?.startedAt) return false; if (!latestTurn.completedAt) return false; if (!session) return true; if (session.orchestrationStatus === "running") return false; return true; } export function deriveActiveWorkStartedAt( latestTurn: LatestTurnTiming | null, session: SessionActivityState | null, sendStartedAt: string | null, ): string | null { if (!isLatestTurnSettled(latestTurn, session)) { return latestTurn?.startedAt ?? sendStartedAt; } return sendStartedAt; } function requestKindFromRequestType(requestType: unknown): PendingApproval["requestKind"] | null { switch (requestType) { case "command_execution_approval": case "exec_command_approval": return "command"; case "file_read_approval": return "file-read"; case "file_change_approval": case "apply_patch_approval": return "file-change"; default: return null; } } export function derivePendingApprovals( activities: ReadonlyArray, ): PendingApproval[] { const openByRequestId = new Map(); const ordered = [...activities].toSorted(compareActivitiesByOrder); for (const activity of ordered) { const payload = activity.payload && typeof activity.payload === "object" ? (activity.payload as Record) : null; const requestId = payload && typeof payload.requestId === "string" ? ApprovalRequestId.makeUnsafe(payload.requestId) : null; const requestKind = payload && (payload.requestKind === "command" || payload.requestKind === "file-read" || payload.requestKind === "file-change") ? payload.requestKind : payload ? requestKindFromRequestType(payload.requestType) : null; const detail = payload && typeof payload.detail === "string" ? payload.detail : undefined; if (activity.kind === "approval.requested" && requestId && requestKind) { openByRequestId.set(requestId, { requestId, requestKind, createdAt: activity.createdAt, ...(detail ? { detail } : {}), }); continue; } if (activity.kind === "approval.resolved" && requestId) { openByRequestId.delete(requestId); continue; } if ( activity.kind === "provider.approval.respond.failed" && requestId && detail?.includes("Unknown pending permission request") ) { openByRequestId.delete(requestId); continue; } } return [...openByRequestId.values()].toSorted((left, right) => left.createdAt.localeCompare(right.createdAt), ); } function parseUserInputQuestions( payload: Record | null, ): ReadonlyArray | null { const questions = payload?.questions; if (!Array.isArray(questions)) { return null; } const parsed = questions .map((entry) => { if (!entry || typeof entry !== "object") return null; const question = entry as Record; if ( typeof question.id !== "string" || typeof question.header !== "string" || typeof question.question !== "string" || !Array.isArray(question.options) ) { return null; } const options = question.options .map((option) => { if (!option || typeof option !== "object") return null; const optionRecord = option as Record; if ( typeof optionRecord.label !== "string" || typeof optionRecord.description !== "string" ) { return null; } return { label: optionRecord.label, description: optionRecord.description, }; }) .filter((option): option is UserInputQuestion["options"][number] => option !== null); if (options.length === 0) { return null; } return { id: question.id, header: question.header, question: question.question, options, }; }) .filter((question): question is UserInputQuestion => question !== null); return parsed.length > 0 ? parsed : null; } export function derivePendingUserInputs( activities: ReadonlyArray, ): PendingUserInput[] { const openByRequestId = new Map(); const ordered = [...activities].toSorted(compareActivitiesByOrder); for (const activity of ordered) { const payload = activity.payload && typeof activity.payload === "object" ? (activity.payload as Record) : null; const requestId = payload && typeof payload.requestId === "string" ? ApprovalRequestId.makeUnsafe(payload.requestId) : null; if (activity.kind === "user-input.requested" && requestId) { const questions = parseUserInputQuestions(payload); if (!questions) { continue; } openByRequestId.set(requestId, { requestId, createdAt: activity.createdAt, questions, }); continue; } if (activity.kind === "user-input.resolved" && requestId) { openByRequestId.delete(requestId); } } return [...openByRequestId.values()].toSorted((left, right) => left.createdAt.localeCompare(right.createdAt), ); } export function deriveActivePlanState( activities: ReadonlyArray, latestTurnId: TurnId | undefined, ): ActivePlanState | null { const ordered = [...activities].toSorted(compareActivitiesByOrder); const candidates = ordered.filter((activity) => { if (activity.kind !== "turn.plan.updated") { return false; } if (!latestTurnId) { return true; } return activity.turnId === latestTurnId; }); const latest = candidates.at(-1); if (!latest) { return null; } const payload = latest.payload && typeof latest.payload === "object" ? (latest.payload as Record) : null; const rawPlan = payload?.plan; if (!Array.isArray(rawPlan)) { return null; } const steps = rawPlan .map((entry) => { if (!entry || typeof entry !== "object") return null; const record = entry as Record; if (typeof record.step !== "string") { return null; } const status = record.status === "completed" || record.status === "inProgress" ? record.status : "pending"; return { step: record.step, status, }; }) .filter( ( step, ): step is { step: string; status: "pending" | "inProgress" | "completed"; } => step !== null, ); if (steps.length === 0) { return null; } return { createdAt: latest.createdAt, turnId: latest.turnId, ...(payload && "explanation" in payload ? { explanation: payload.explanation as string | null } : {}), steps, }; } export function findLatestProposedPlan( proposedPlans: ReadonlyArray, latestTurnId: TurnId | string | null | undefined, ): LatestProposedPlanState | null { if (latestTurnId) { const matchingTurnPlan = [...proposedPlans] .filter((proposedPlan) => proposedPlan.turnId === latestTurnId) .toSorted( (left, right) => left.updatedAt.localeCompare(right.updatedAt) || left.id.localeCompare(right.id), ) .at(-1); if (matchingTurnPlan) { return toLatestProposedPlanState(matchingTurnPlan); } } const latestPlan = [...proposedPlans] .toSorted( (left, right) => left.updatedAt.localeCompare(right.updatedAt) || left.id.localeCompare(right.id), ) .at(-1); if (!latestPlan) { return null; } return toLatestProposedPlanState(latestPlan); } export function findSidebarProposedPlan(input: { threads: ReadonlyArray>; latestTurn: Pick | null; latestTurnSettled: boolean; threadId: ThreadId | string | null | undefined; }): LatestProposedPlanState | null { const activeThreadPlans = input.threads.find((thread) => thread.id === input.threadId)?.proposedPlans ?? []; if (!input.latestTurnSettled) { const sourceProposedPlan = input.latestTurn?.sourceProposedPlan; if (sourceProposedPlan) { const sourcePlan = input.threads .find((thread) => thread.id === sourceProposedPlan.threadId) ?.proposedPlans.find((plan) => plan.id === sourceProposedPlan.planId); if (sourcePlan) { return toLatestProposedPlanState(sourcePlan); } } } return findLatestProposedPlan(activeThreadPlans, input.latestTurn?.turnId ?? null); } export function hasActionableProposedPlan( proposedPlan: LatestProposedPlanState | Pick | null, ): boolean { return proposedPlan !== null && proposedPlan.implementedAt === null; } export function deriveWorkLogEntries( activities: ReadonlyArray, latestTurnId: TurnId | undefined, ): WorkLogEntry[] { const ordered = [...activities].toSorted(compareActivitiesByOrder); return ordered .filter((activity) => (latestTurnId ? activity.turnId === latestTurnId : true)) .filter((activity) => activity.kind !== "tool.started") .filter((activity) => activity.kind !== "task.started" && activity.kind !== "task.completed") .filter((activity) => activity.summary !== "Checkpoint captured") .filter((activity) => !isPlanBoundaryToolActivity(activity)) .map((activity) => { const payload = activity.payload && typeof activity.payload === "object" ? (activity.payload as Record) : null; const command = extractToolCommand(payload); const changedFiles = extractChangedFiles(payload); const title = extractToolTitle(payload); const entry: WorkLogEntry = { id: activity.id, createdAt: activity.createdAt, label: activity.summary, tone: activity.tone === "approval" ? "info" : activity.tone, }; const itemType = extractWorkLogItemType(payload); const requestKind = extractWorkLogRequestKind(payload); if (payload && typeof payload.detail === "string" && payload.detail.length > 0) { const detail = stripTrailingExitCode(payload.detail).output; if (detail) { entry.detail = detail; } } if (command) { entry.command = command; } if (changedFiles.length > 0) { entry.changedFiles = changedFiles; } if (title) { entry.toolTitle = title; } if (itemType) { entry.itemType = itemType; } if (requestKind) { entry.requestKind = requestKind; } return entry; }); } function isPlanBoundaryToolActivity(activity: OrchestrationThreadActivity): boolean { if (activity.kind !== "tool.updated" && activity.kind !== "tool.completed") { return false; } const payload = activity.payload && typeof activity.payload === "object" ? (activity.payload as Record) : null; return typeof payload?.detail === "string" && payload.detail.startsWith("ExitPlanMode:"); } function toLatestProposedPlanState(proposedPlan: ProposedPlan): LatestProposedPlanState { return { id: proposedPlan.id, createdAt: proposedPlan.createdAt, updatedAt: proposedPlan.updatedAt, turnId: proposedPlan.turnId, planMarkdown: proposedPlan.planMarkdown, implementedAt: proposedPlan.implementedAt, implementationThreadId: proposedPlan.implementationThreadId, }; } function asRecord(value: unknown): Record | null { return value && typeof value === "object" ? (value as Record) : null; } function asTrimmedString(value: unknown): string | null { if (typeof value !== "string") { return null; } const trimmed = value.trim(); return trimmed.length > 0 ? trimmed : null; } function normalizeCommandValue(value: unknown): string | null { const direct = asTrimmedString(value); if (direct) { return direct; } if (!Array.isArray(value)) { return null; } const parts = value .map((entry) => asTrimmedString(entry)) .filter((entry): entry is string => entry !== null); return parts.length > 0 ? parts.join(" ") : null; } function extractToolCommand(payload: Record | null): string | null { const data = asRecord(payload?.data); const item = asRecord(data?.item); const itemResult = asRecord(item?.result); const itemInput = asRecord(item?.input); const candidates = [ normalizeCommandValue(item?.command), normalizeCommandValue(itemInput?.command), normalizeCommandValue(itemResult?.command), normalizeCommandValue(data?.command), ]; return candidates.find((candidate) => candidate !== null) ?? null; } function extractToolTitle(payload: Record | null): string | null { return asTrimmedString(payload?.title); } function stripTrailingExitCode(value: string): { output: string | null; exitCode?: number | undefined; } { const trimmed = value.trim(); const match = /^(?[\s\S]*?)(?:\s*\d+)>)\s*$/i.exec( trimmed, ); if (!match?.groups) { return { output: trimmed.length > 0 ? trimmed : null, }; } const exitCode = Number.parseInt(match.groups.code ?? "", 10); const normalizedOutput = match.groups.output?.trim() ?? ""; return { output: normalizedOutput.length > 0 ? normalizedOutput : null, ...(Number.isInteger(exitCode) ? { exitCode } : {}), }; } function extractWorkLogItemType( payload: Record | null, ): WorkLogEntry["itemType"] | undefined { if (typeof payload?.itemType === "string" && isToolLifecycleItemType(payload.itemType)) { return payload.itemType; } return undefined; } function extractWorkLogRequestKind( payload: Record | null, ): WorkLogEntry["requestKind"] | undefined { if ( payload?.requestKind === "command" || payload?.requestKind === "file-read" || payload?.requestKind === "file-change" ) { return payload.requestKind; } return requestKindFromRequestType(payload?.requestType) ?? undefined; } function pushChangedFile(target: string[], seen: Set, value: unknown) { const normalized = asTrimmedString(value); if (!normalized || seen.has(normalized)) { return; } seen.add(normalized); target.push(normalized); } function collectChangedFiles(value: unknown, target: string[], seen: Set, depth: number) { if (depth > 4 || target.length >= 12) { return; } if (Array.isArray(value)) { for (const entry of value) { collectChangedFiles(entry, target, seen, depth + 1); if (target.length >= 12) { return; } } return; } const record = asRecord(value); if (!record) { return; } pushChangedFile(target, seen, record.path); pushChangedFile(target, seen, record.filePath); pushChangedFile(target, seen, record.relativePath); pushChangedFile(target, seen, record.filename); pushChangedFile(target, seen, record.newPath); pushChangedFile(target, seen, record.oldPath); for (const nestedKey of [ "item", "result", "input", "data", "changes", "files", "edits", "patch", "patches", "operations", ]) { if (!(nestedKey in record)) { continue; } collectChangedFiles(record[nestedKey], target, seen, depth + 1); if (target.length >= 12) { return; } } } function extractChangedFiles(payload: Record | null): string[] { const changedFiles: string[] = []; const seen = new Set(); collectChangedFiles(asRecord(payload?.data), changedFiles, seen, 0); return changedFiles; } function compareActivitiesByOrder( left: OrchestrationThreadActivity, right: OrchestrationThreadActivity, ): number { if (left.sequence !== undefined && right.sequence !== undefined) { if (left.sequence !== right.sequence) { return left.sequence - right.sequence; } } else if (left.sequence !== undefined) { return 1; } else if (right.sequence !== undefined) { return -1; } return left.createdAt.localeCompare(right.createdAt) || left.id.localeCompare(right.id); } export function hasToolActivityForTurn( activities: ReadonlyArray, turnId: TurnId | null | undefined, ): boolean { if (!turnId) return false; return activities.some((activity) => activity.turnId === turnId && activity.tone === "tool"); } export function deriveTimelineEntries( messages: ChatMessage[], proposedPlans: ProposedPlan[], workEntries: WorkLogEntry[], ): TimelineEntry[] { const messageRows: TimelineEntry[] = messages.map((message) => ({ id: message.id, kind: "message", createdAt: message.createdAt, message, })); const proposedPlanRows: TimelineEntry[] = proposedPlans.map((proposedPlan) => ({ id: proposedPlan.id, kind: "proposed-plan", createdAt: proposedPlan.createdAt, proposedPlan, })); const workRows: TimelineEntry[] = workEntries.map((entry) => ({ id: entry.id, kind: "work", createdAt: entry.createdAt, entry, })); return [...messageRows, ...proposedPlanRows, ...workRows].toSorted((a, b) => a.createdAt.localeCompare(b.createdAt), ); } export function inferCheckpointTurnCountByTurnId( summaries: TurnDiffSummary[], ): Record { const sorted = [...summaries].toSorted((a, b) => a.completedAt.localeCompare(b.completedAt)); const result: Record = {}; for (let index = 0; index < sorted.length; index += 1) { const summary = sorted[index]; if (!summary) continue; result[summary.turnId] = index + 1; } return result; } export function derivePhase(session: ThreadSession | null): SessionPhase { if (!session || session.status === "closed") return "disconnected"; if (session.status === "connecting") return "connecting"; if (session.status === "running") return "running"; return "ready"; }