import type {
OrchestrationV2Run,
OrchestrationV2RunAttempt,
OrchestrationV2TurnItem,
OrchestrationV2UserMessageInputIntent,
} from "@t3tools/contracts";
type TimelineRun = Pick<OrchestrationV2Run, "id" | "status">;
type TimelineRunAttempt = Pick<OrchestrationV2RunAttempt, "runId" | "rootNodeId" | "status">;
type TimelineTurnItem = Pick<OrchestrationV2TurnItem, "type" | "runId" | "nodeId"> & {
readonly inputIntent?: OrchestrationV2UserMessageInputIntent;
};
export function isOrchestrationV2SupersededInterrupt(input: {
readonly item: TimelineTurnItem;
readonly attempts: ReadonlyArray<TimelineRunAttempt>;
readonly items: ReadonlyArray<TimelineTurnItem>;
}): boolean {
const { item } = input;
if (item.type !== "run_interrupt_result" || item.runId === null || item.nodeId === null) {
return false;
}
const isSuperseded = input.attempts.some(
(attempt) =>
attempt.runId === item.runId &&
attempt.rootNodeId === item.nodeId &&
attempt.status === "superseded",
);
if (!isSuperseded) {
return false;
}
// Show paired stop-then-steer results; hide legacy plain-steer results without matching requests.
const hasMatchingRequest = input.items.some(
(candidate) => candidate.type === "run_interrupt_request" && candidate.runId === item.runId,
);
return !hasMatchingRequest;
}
export function isOrchestrationV2TurnItemVisible(input: {
readonly item: TimelineTurnItem;
readonly runs: ReadonlyArray<TimelineRun>;
readonly attempts: ReadonlyArray<TimelineRunAttempt>;
readonly items: ReadonlyArray<TimelineTurnItem>;
}): boolean {
const { item } = input;
if (
item.runId !== null &&
input.runs.some((run) => run.id === item.runId && run.status === "rolled_back")
) {
return false;
}
// Cancelled queued input never reached the provider and must stay out of the transcript.
if (
item.type === "user_message" &&
item.inputIntent === "queued_turn" &&
item.runId !== null &&
input.runs.some((run) => run.id === item.runId && run.status === "cancelled")
) {
return false;
}
return !isOrchestrationV2SupersededInterrupt({
item,
attempts: input.attempts,
items: input.items,
});
}
export function createOrchestrationV2TurnItemVisibility(input: {
readonly runs: ReadonlyArray<TimelineRun>;
readonly attempts: ReadonlyArray<TimelineRunAttempt>;
readonly items: ReadonlyArray<TimelineTurnItem>;
}): (item: TimelineTurnItem) => boolean {
const statuses = new Map<TimelineRun["id"], TimelineRun["status"]>();
for (const run of input.runs) {
if (run.status === "rolled_back" || run.status === "cancelled")
statuses.set(run.id, run.status);
else statuses.delete(run.id);
}
const supersededRoots = new Map<
TimelineRunAttempt["runId"],
Set<TimelineRunAttempt["rootNodeId"]>
>();
for (const attempt of input.attempts) {
if (attempt.status !== "superseded") continue;
let roots = supersededRoots.get(attempt.runId);
if (roots === undefined) supersededRoots.set(attempt.runId, (roots = new Set()));
roots.add(attempt.rootNodeId);
}
if (statuses.size === 0 && supersededRoots.size === 0) return () => true;
const interruptRuns = new Set<TimelineTurnItem["runId"]>();
if (supersededRoots.size > 0) {
for (const item of input.items) {
if (item.type === "run_interrupt_request") interruptRuns.add(item.runId);
}
}
return (item) => {
const status = item.runId === null ? undefined : statuses.get(item.runId);
if (status === "rolled_back") return false;
if (
status === "cancelled" &&
item.type === "user_message" &&
item.inputIntent === "queued_turn"
)
return false;
return !(
item.type === "run_interrupt_result" &&
item.runId !== null &&
item.nodeId !== null &&
supersededRoots.get(item.runId)?.has(item.nodeId) === true &&
!interruptRuns.has(item.runId)
);
};
}