@adecore/agent-contracts 0.45.0 → 0.46.0

package/dist/chat.d.ts

@@ -765,6 +765,7 @@ export declare const ChatWorkflowSchema: z.ZodObject<{
     }, z.core.$strip>>;
     lastProgressAt: z.ZodOptional<z.ZodNumber>;
     stalledAt: z.ZodOptional<z.ZodNumber>;
+    finishedAt: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type ChatWorkflow = z.infer<typeof ChatWorkflowSchema>;
 export declare function workflowAgentRef(agentId: string): string;
@@ -831,6 +832,7 @@ export declare const ChatToolItemSchema: z.ZodObject<{
         }, z.core.$strip>>;
         lastProgressAt: z.ZodOptional<z.ZodNumber>;
         stalledAt: z.ZodOptional<z.ZodNumber>;
+        finishedAt: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     outputRef: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
@@ -1257,6 +1259,7 @@ export declare const ChatItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strip>>;
         lastProgressAt: z.ZodOptional<z.ZodNumber>;
         stalledAt: z.ZodOptional<z.ZodNumber>;
+        finishedAt: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     outputRef: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
@@ -1439,6 +1442,8 @@ export type ChatTurnItem = z.infer<typeof ChatTurnItemSchema>;
 export type ChatNoteItem = z.infer<typeof ChatNoteItemSchema>;
 export type ChatCompactionItem = z.infer<typeof ChatCompactionItemSchema>;
 export declare function activeSubagents(items: readonly ChatItem[]): ChatSubagentItem[];
+export declare function workflowEndedAt(workflow: ChatWorkflow): number | null;
+export declare function activeWorkflows(items: readonly ChatItem[]): ChatToolItem[];
 export declare const CHAT_OUTLINE_TEXT_CHARS = 280;
 export declare function outlineItems(items: readonly ChatItem[], marked?: ReadonlySet<string>): ChatItem[];
 export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1623,6 +1628,7 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }, z.core.$strip>>;
             lastProgressAt: z.ZodOptional<z.ZodNumber>;
             stalledAt: z.ZodOptional<z.ZodNumber>;
+            finishedAt: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         outputRef: z.ZodOptional<z.ZodObject<{
             id: z.ZodString;
@@ -2374,6 +2380,7 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }, z.core.$strip>>;
             lastProgressAt: z.ZodOptional<z.ZodNumber>;
             stalledAt: z.ZodOptional<z.ZodNumber>;
+            finishedAt: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         outputRef: z.ZodOptional<z.ZodObject<{
             id: z.ZodString;
@@ -2730,6 +2737,7 @@ export declare const ChatEventEnvelopeSchema: z.ZodObject<{
                 }, z.core.$strip>>;
                 lastProgressAt: z.ZodOptional<z.ZodNumber>;
                 stalledAt: z.ZodOptional<z.ZodNumber>;
+                finishedAt: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
             outputRef: z.ZodOptional<z.ZodObject<{
                 id: z.ZodString;
@@ -3481,6 +3489,7 @@ export declare const ChatEventEnvelopeSchema: z.ZodObject<{
                 }, z.core.$strip>>;
                 lastProgressAt: z.ZodOptional<z.ZodNumber>;
                 stalledAt: z.ZodOptional<z.ZodNumber>;
+                finishedAt: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
             outputRef: z.ZodOptional<z.ZodObject<{
                 id: z.ZodString;
@@ -3919,6 +3928,7 @@ export declare const ChatHistoryResultSchema: z.ZodObject<{
             }, z.core.$strip>>;
             lastProgressAt: z.ZodOptional<z.ZodNumber>;
             stalledAt: z.ZodOptional<z.ZodNumber>;
+            finishedAt: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         outputRef: z.ZodOptional<z.ZodObject<{
             id: z.ZodString;
@@ -4318,6 +4328,7 @@ export declare const ChatSubagentResultSchema: z.ZodObject<{
             }, z.core.$strip>>;
             lastProgressAt: z.ZodOptional<z.ZodNumber>;
             stalledAt: z.ZodOptional<z.ZodNumber>;
+            finishedAt: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         outputRef: z.ZodOptional<z.ZodObject<{
             id: z.ZodString;
@@ -5163,6 +5174,7 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
             }, z.core.$strip>>;
             lastProgressAt: z.ZodOptional<z.ZodNumber>;
             stalledAt: z.ZodOptional<z.ZodNumber>;
+            finishedAt: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         outputRef: z.ZodOptional<z.ZodObject<{
             id: z.ZodString;
@@ -5517,6 +5529,7 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
             }, z.core.$strip>>;
             lastProgressAt: z.ZodOptional<z.ZodNumber>;
             stalledAt: z.ZodOptional<z.ZodNumber>;
+            finishedAt: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         outputRef: z.ZodOptional<z.ZodObject<{
             id: z.ZodString;
@@ -5870,6 +5883,7 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
                 }, z.core.$strip>>;
                 lastProgressAt: z.ZodOptional<z.ZodNumber>;
                 stalledAt: z.ZodOptional<z.ZodNumber>;
+                finishedAt: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
             outputRef: z.ZodOptional<z.ZodObject<{
                 id: z.ZodString;
@@ -6621,6 +6635,7 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
                 }, z.core.$strip>>;
                 lastProgressAt: z.ZodOptional<z.ZodNumber>;
                 stalledAt: z.ZodOptional<z.ZodNumber>;
+                finishedAt: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
             outputRef: z.ZodOptional<z.ZodObject<{
                 id: z.ZodString;
@@ -6850,6 +6865,69 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
         childId: z.ZodOptional<z.ZodString>;
         parentToolUseId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodNumber;
+        turnId: z.ZodNullable<z.ZodString>;
+        kind: z.ZodLiteral<"tool">;
+        toolUseId: z.ZodString;
+        name: z.ZodString;
+        input: z.ZodUnknown;
+        output: z.ZodNullable<z.ZodString>;
+        state: z.ZodEnum<{
+            done: "done";
+            error: "error";
+            running: "running";
+        }>;
+        parentToolUseId: z.ZodNullable<z.ZodString>;
+        progress: z.ZodOptional<z.ZodObject<{
+            startedAt: z.ZodNullable<z.ZodNumber>;
+            description: z.ZodNullable<z.ZodString>;
+            output: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        changes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            kind: z.ZodEnum<{
+                add: "add";
+                delete: "delete";
+                update: "update";
+            }>;
+            diff: z.ZodString;
+        }, z.core.$strip>>>;
+        workflow: z.ZodOptional<z.ZodObject<{
+            name: z.ZodNullable<z.ZodString>;
+            taskId: z.ZodOptional<z.ZodString>;
+            phases: z.ZodArray<z.ZodObject<{
+                index: z.ZodNumber;
+                title: z.ZodString;
+            }, z.core.$strip>>;
+            agents: z.ZodArray<z.ZodObject<{
+                index: z.ZodNumber;
+                label: z.ZodString;
+                phaseIndex: z.ZodNullable<z.ZodNumber>;
+                agentId: z.ZodNullable<z.ZodString>;
+                status: z.ZodEnum<{
+                    done: "done";
+                    failed: "failed";
+                    running: "running";
+                }>;
+                startedAt: z.ZodNullable<z.ZodNumber>;
+                durationMs: z.ZodNullable<z.ZodNumber>;
+                lastTool: z.ZodNullable<z.ZodString>;
+                lastToolSummary: z.ZodOptional<z.ZodString>;
+                promptPreview: z.ZodOptional<z.ZodString>;
+                resultPreview: z.ZodOptional<z.ZodString>;
+                error: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            lastProgressAt: z.ZodOptional<z.ZodNumber>;
+            stalledAt: z.ZodOptional<z.ZodNumber>;
+            finishedAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        outputRef: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            bytes: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
     outline: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodString;
         createdAt: z.ZodNumber;
@@ -7030,6 +7108,7 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
             }, z.core.$strip>>;
             lastProgressAt: z.ZodOptional<z.ZodNumber>;
             stalledAt: z.ZodOptional<z.ZodNumber>;
+            finishedAt: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         outputRef: z.ZodOptional<z.ZodObject<{
             id: z.ZodString;

package/dist/chat.js

@@ -408,7 +408,9 @@ export const ChatWorkflowSchema = z.object({
     phases: z.array(ChatWorkflowPhaseSchema),
     agents: z.array(ChatWorkflowAgentSchema),
     lastProgressAt: z.number().optional(),
-    stalledAt: z.number().optional()
+    stalledAt: z.number().optional(),
+    // Set by the host once the Workflow call settled; a call stored before it was kept has none.
+    finishedAt: z.number().optional()
 });
 // A workflow's agent has no call of its own, so `chat.subagent` names it by its agent id under this prefix.
 const WORKFLOW_AGENT_REF = 'workflow-agent:';
@@ -637,6 +639,36 @@ export function activeSubagents(items) {
         (item.turnId !== null && turns.has(item.turnId)))
         .map(({ item }) => item);
 }
+/*
+ * When a workflow last did something it could be shown for: the end the host noted, else the last end
+ * of an agent, else its last report. Null for one that never reported, which counts as long ago.
+ */
+export function workflowEndedAt(workflow) {
+    if (workflow.finishedAt !== undefined) {
+        return workflow.finishedAt;
+    }
+    const ends = workflow.agents.flatMap((agent) => (agent.startedAt !== null && agent.durationMs !== null ? [agent.startedAt + agent.durationMs] : []));
+    return ends.length > 0 ? Math.max(...ends) : (workflow.lastProgressAt ?? null);
+}
+/*
+ * The Workflow calls a chat still speaks of beside its thread, by the rule of `activeSubagents`: every
+ * one that runs, and the ones that ended since the last message, so a finished workflow stays until the
+ * next message is sent. Only a call that reported what it runs counts. `items` is in thread order.
+ */
+export function activeWorkflows(items) {
+    const lastMessage = items.findLastIndex((item) => item.kind === 'user');
+    const lastMessageAt = lastMessage < 0 ? null : items[lastMessage].createdAt;
+    return items.filter((item, index) => {
+        if (item.kind !== 'tool' || item.name !== 'Workflow' || item.workflow === undefined) {
+            return false;
+        }
+        if (item.state === 'running' || index > lastMessage) {
+            return true;
+        }
+        const endedAt = workflowEndedAt(item.workflow);
+        return lastMessageAt !== null && endedAt !== null && endedAt > lastMessageAt;
+    });
+}
 /* How much of a message the outline keeps: what a hover card over its tick shows. */
 export const CHAT_OUTLINE_TEXT_CHARS = 280;
 /*
@@ -827,6 +859,8 @@ export const ChatAttachResultSchema = z.object({
     visuals: ChatVisualsSchema.optional(),
     // With a page: the active sub-agents (`activeSubagents`) from before it, so the pill over the composer never waits on a scroll.
     subagents: z.array(ChatSubagentItemSchema).optional(),
+    // With a page: the active Workflow calls (`activeWorkflows`) from before it, so what shows a workflow beside the thread never waits on a scroll.
+    workflows: z.array(ChatToolItemSchema).optional(),
     // With a page: the thread before it as `outlineItems` cuts it, so the scrubber reaches the whole thread before a scroll does.
     outline: z.array(ChatItemSchema).optional()
 });

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { KNOWN_AGENT_KINDS, type KnownAgentKind, AGENT_KIND_MAX_LENGTH, AgentKindSchema, type AgentKind, isKnownAgentKind, AgentStatusSchema, type AgentStatus, SUGGESTED_TITLE_LIMIT, SuggestedTitleSchema, AgentRequestSchema, type AgentRequest, AgentInfoSchema, type AgentInfo, SessionStatusEventSchema, type SessionStatusEvent, AgentResumePayloadSchema, type AgentResumePayload, ApprovalChoiceSchema, type ApprovalChoice, ApprovalRequestSchema, type ApprovalRequest, SessionApprovalsEventSchema, type SessionApprovalsEvent, ApprovalAnswerPayloadSchema, type ApprovalAnswerPayload, ApprovalAnswerResultSchema, type ApprovalAnswerResult, ApprovalPreferencePayloadSchema, type ApprovalPreferencePayload } from './agent.ts';
-export { ChatIdSchema, type ChatId, ChatContextBreakdownSchema, type ChatContextBreakdown, ChatUsageSchema, type ChatUsage, CHAT_ATTACHMENTS_MAX_BYTES, CHAT_ATTACHMENT_MAX_BYTES, CHAT_ATTACHMENTS_MAX_COUNT, attachmentBytes, attachmentImageMime, ChatAttachmentUploadSchema, type ChatAttachmentUpload, ChatAttachmentUploadsSchema, ChatAttachmentSchema, type ChatAttachment, ChatUiChoiceOriginSchema, type ChatUiChoiceOrigin, ChatUiAnswerSchema, type ChatUiAnswer, ChatQuoteSourceSchema, type ChatQuoteSource, ChatQueuedMessageSchema, type ChatQueuedMessage, ChatBackgroundTaskSchema, type ChatBackgroundTask, ChatTurnLimitSchema, type ChatTurnLimit, ChatGoalStatusSchema, type ChatGoalStatus, ChatGoalSchema, type ChatGoal, ChatQuestionSchema, type ChatQuestion, ChatRequestKindSchema, type ChatRequestKind, CHAT_REQUEST_LIMITS, ChatRequestApprovalSchema, type ChatRequestApproval, ChatRequestSummarySchema, type ChatRequestSummary, ChatInfoSchema, type ChatInfo, ChatSkillSourceSchema, type ChatSkillSource, ChatSkillSchema, type ChatSkill, SkillsListPayloadSchema, type SkillsListPayload, SkillsListResultSchema, type SkillsListResult, ChatUserItemSchema, ChatUiQueryReadingSchema, type ChatUiQueryReading, ChatUiLinkReadingSchema, type ChatUiLinkReading, ChatUiPlaceReadingSchema, type ChatUiPlaceReading, ChatUiQueryStateSchema, type ChatUiQueryState, ChatAssistantItemSchema, ChatThinkingItemSchema, ChatToolStateSchema, type ChatToolState, ChatToolProgressSchema, type ChatToolProgress, ChatFileChangeSchema, type ChatFileChange, ChatSubagentStatusSchema, type ChatSubagentStatus, ChatWorkflowPhaseSchema, type ChatWorkflowPhase, ChatWorkflowAgentSchema, type ChatWorkflowAgent, ChatWorkflowSchema, type ChatWorkflow, workflowAgentRef, workflowAgentIdOf, CHAT_PAYLOAD_INLINE_BYTES, ChatPayloadRefSchema, type ChatPayloadRef, ChatToolItemSchema, ChatSubagentUsageSchema, type ChatSubagentUsage, HOST_TASK_ORIGIN, ChatSubagentItemSchema, ChatApprovalDecisionSchema, type ChatApprovalDecision, ChatApprovalItemSchema, ChatQuestionItemSchema, ChatCheckpointFileSchema, type ChatCheckpointFile, ChatCheckpointDiffSchema, type ChatCheckpointDiff, ChatTurnItemSchema, notResumedNote, abortedByMachine, ENDED_NOTE_PREFIX, abortedByEnd, activeSubagents, CHAT_OUTLINE_TEXT_CHARS, outlineItems, WAITING_NOTE_PREFIX, ChatNoteItemSchema, ChatCompactionItemSchema, ChatItemSchema, type ChatItem, type ChatUserItem, type ChatAssistantItem, type ChatThinkingItem, type ChatToolItem, type ChatSubagentItem, type ChatApprovalItem, type ChatQuestionItem, type ChatTurnItem, type ChatNoteItem, type ChatCompactionItem, ChatEventSchema, type ChatEvent, ChatEventEnvelopeSchema, type ChatEventEnvelope, ChatCreatePayloadSchema, type ChatCreatePayload, ChatConfigurePayloadSchema, type ChatConfigurePayload, ChatPreferencesPayloadSchema, type ChatPreferencesPayload, ChatTargetPayloadSchema, type ChatTargetPayload, ChatClearPayloadSchema, type ChatClearPayload, ChatCancelPayloadSchema, type ChatCancelPayload, ChatAttachPayloadSchema, ChatHistoryPayloadSchema, ChatHistoryPageSchema, ChatHistoryResultSchema, type ChatHistoryResult, ChatSubagentPayloadSchema, type ChatSubagentPayload, ChatStopSubagentPayloadSchema, type ChatStopSubagentPayload, ChatGoalActionSchema, type ChatGoalAction, ChatGoalPayloadSchema, type ChatGoalPayload, ChatStopTaskPayloadSchema, type ChatStopTaskPayload, ChatSubagentPageSchema, ChatSubagentSourceSchema, type ChatSubagentSource, ChatSubagentResultSchema, type ChatSubagentResult, ChatStatusEventSchema, type ChatStatusEvent, ChatSubagentChangedEventSchema, type ChatSubagentChangedEvent, CHAT_BOOKMARK_LIMITS, ChatBookmarkSchema, type ChatBookmark, ChatBookmarksSchema, ChatAddBookmarkPayloadSchema, type ChatAddBookmarkPayload, ChatRenameBookmarkPayloadSchema, type ChatRenameBookmarkPayload, ChatRemoveBookmarkPayloadSchema, type ChatRemoveBookmarkPayload, ChatBookmarksResultSchema, type ChatBookmarksResult, ChatBookmarksEventSchema, type ChatBookmarksEvent, ChatRemoveVisualPayloadSchema, type ChatRemoveVisualPayload, ChatVisualsResultSchema, type ChatVisualsResult, ChatVisualsEventSchema, type ChatVisualsEvent, ChatAttachResultSchema, type ChatAttachResult, ChatDeliverySchema, type ChatDelivery, ChatSendPayloadSchema, type ChatSendPayload, ChatSendResultSchema, type ChatSendResult, ChatUiChoicePayloadSchema, type ChatUiChoicePayload, ChatUiQueryPayloadSchema, type ChatUiQueryPayload, ChatUiLinkPayloadSchema, type ChatUiLinkPayload, ChatQueuePayloadSchema, type ChatQueuePayload, ChatUnqueueResultSchema, type ChatUnqueueResult, ChatApprovePayloadSchema, type ChatApprovePayload, ChatDismissPayloadSchema, type ChatDismissPayload, ChatAnswerPayloadSchema, type ChatAnswerPayload, ChatTurnDiffPayloadSchema, type ChatTurnDiffPayload, ChatTurnDiffResultSchema, type ChatTurnDiffResult, ChatToolOutputPayloadSchema, type ChatToolOutputPayload, ChatToolOutputResultSchema, type ChatToolOutputResult, CHAT_FORK_TITLE_MAX, ChatForkPayloadSchema, type ChatForkPayload, ChatForkResultSchema, type ChatForkResult, ChatContinueOnPayloadSchema, type ChatContinueOnPayload, ChatContinueOnResultSchema, type ChatContinueOnResult, ChatSummarizePayloadSchema, type ChatSummarizePayload, ChatSummarizeResultSchema, type ChatSummarizeResult, ChatForkInfoPayloadSchema, type ChatForkInfoPayload, ChatForkInfoResultSchema, type ChatForkInfoResult, ChatListResultSchema, type ChatListResult, GeneratedImageInputSchema, type GeneratedImageInput, generatedImageAttachment, holdsConversation } from './chat.ts';
+export { ChatIdSchema, type ChatId, ChatContextBreakdownSchema, type ChatContextBreakdown, ChatUsageSchema, type ChatUsage, CHAT_ATTACHMENTS_MAX_BYTES, CHAT_ATTACHMENT_MAX_BYTES, CHAT_ATTACHMENTS_MAX_COUNT, attachmentBytes, attachmentImageMime, ChatAttachmentUploadSchema, type ChatAttachmentUpload, ChatAttachmentUploadsSchema, ChatAttachmentSchema, type ChatAttachment, ChatUiChoiceOriginSchema, type ChatUiChoiceOrigin, ChatUiAnswerSchema, type ChatUiAnswer, ChatQuoteSourceSchema, type ChatQuoteSource, ChatQueuedMessageSchema, type ChatQueuedMessage, ChatBackgroundTaskSchema, type ChatBackgroundTask, ChatTurnLimitSchema, type ChatTurnLimit, ChatGoalStatusSchema, type ChatGoalStatus, ChatGoalSchema, type ChatGoal, ChatQuestionSchema, type ChatQuestion, ChatRequestKindSchema, type ChatRequestKind, CHAT_REQUEST_LIMITS, ChatRequestApprovalSchema, type ChatRequestApproval, ChatRequestSummarySchema, type ChatRequestSummary, ChatInfoSchema, type ChatInfo, ChatSkillSourceSchema, type ChatSkillSource, ChatSkillSchema, type ChatSkill, SkillsListPayloadSchema, type SkillsListPayload, SkillsListResultSchema, type SkillsListResult, ChatUserItemSchema, ChatUiQueryReadingSchema, type ChatUiQueryReading, ChatUiLinkReadingSchema, type ChatUiLinkReading, ChatUiPlaceReadingSchema, type ChatUiPlaceReading, ChatUiQueryStateSchema, type ChatUiQueryState, ChatAssistantItemSchema, ChatThinkingItemSchema, ChatToolStateSchema, type ChatToolState, ChatToolProgressSchema, type ChatToolProgress, ChatFileChangeSchema, type ChatFileChange, ChatSubagentStatusSchema, type ChatSubagentStatus, ChatWorkflowPhaseSchema, type ChatWorkflowPhase, ChatWorkflowAgentSchema, type ChatWorkflowAgent, ChatWorkflowSchema, type ChatWorkflow, workflowAgentRef, workflowAgentIdOf, CHAT_PAYLOAD_INLINE_BYTES, ChatPayloadRefSchema, type ChatPayloadRef, ChatToolItemSchema, ChatSubagentUsageSchema, type ChatSubagentUsage, HOST_TASK_ORIGIN, ChatSubagentItemSchema, ChatApprovalDecisionSchema, type ChatApprovalDecision, ChatApprovalItemSchema, ChatQuestionItemSchema, ChatCheckpointFileSchema, type ChatCheckpointFile, ChatCheckpointDiffSchema, type ChatCheckpointDiff, ChatTurnItemSchema, notResumedNote, abortedByMachine, ENDED_NOTE_PREFIX, abortedByEnd, activeSubagents, activeWorkflows, workflowEndedAt, CHAT_OUTLINE_TEXT_CHARS, outlineItems, WAITING_NOTE_PREFIX, ChatNoteItemSchema, ChatCompactionItemSchema, ChatItemSchema, type ChatItem, type ChatUserItem, type ChatAssistantItem, type ChatThinkingItem, type ChatToolItem, type ChatSubagentItem, type ChatApprovalItem, type ChatQuestionItem, type ChatTurnItem, type ChatNoteItem, type ChatCompactionItem, ChatEventSchema, type ChatEvent, ChatEventEnvelopeSchema, type ChatEventEnvelope, ChatCreatePayloadSchema, type ChatCreatePayload, ChatConfigurePayloadSchema, type ChatConfigurePayload, ChatPreferencesPayloadSchema, type ChatPreferencesPayload, ChatTargetPayloadSchema, type ChatTargetPayload, ChatClearPayloadSchema, type ChatClearPayload, ChatCancelPayloadSchema, type ChatCancelPayload, ChatAttachPayloadSchema, ChatHistoryPayloadSchema, ChatHistoryPageSchema, ChatHistoryResultSchema, type ChatHistoryResult, ChatSubagentPayloadSchema, type ChatSubagentPayload, ChatStopSubagentPayloadSchema, type ChatStopSubagentPayload, ChatGoalActionSchema, type ChatGoalAction, ChatGoalPayloadSchema, type ChatGoalPayload, ChatStopTaskPayloadSchema, type ChatStopTaskPayload, ChatSubagentPageSchema, ChatSubagentSourceSchema, type ChatSubagentSource, ChatSubagentResultSchema, type ChatSubagentResult, ChatStatusEventSchema, type ChatStatusEvent, ChatSubagentChangedEventSchema, type ChatSubagentChangedEvent, CHAT_BOOKMARK_LIMITS, ChatBookmarkSchema, type ChatBookmark, ChatBookmarksSchema, ChatAddBookmarkPayloadSchema, type ChatAddBookmarkPayload, ChatRenameBookmarkPayloadSchema, type ChatRenameBookmarkPayload, ChatRemoveBookmarkPayloadSchema, type ChatRemoveBookmarkPayload, ChatBookmarksResultSchema, type ChatBookmarksResult, ChatBookmarksEventSchema, type ChatBookmarksEvent, ChatRemoveVisualPayloadSchema, type ChatRemoveVisualPayload, ChatVisualsResultSchema, type ChatVisualsResult, ChatVisualsEventSchema, type ChatVisualsEvent, ChatAttachResultSchema, type ChatAttachResult, ChatDeliverySchema, type ChatDelivery, ChatSendPayloadSchema, type ChatSendPayload, ChatSendResultSchema, type ChatSendResult, ChatUiChoicePayloadSchema, type ChatUiChoicePayload, ChatUiQueryPayloadSchema, type ChatUiQueryPayload, ChatUiLinkPayloadSchema, type ChatUiLinkPayload, ChatQueuePayloadSchema, type ChatQueuePayload, ChatUnqueueResultSchema, type ChatUnqueueResult, ChatApprovePayloadSchema, type ChatApprovePayload, ChatDismissPayloadSchema, type ChatDismissPayload, ChatAnswerPayloadSchema, type ChatAnswerPayload, ChatTurnDiffPayloadSchema, type ChatTurnDiffPayload, ChatTurnDiffResultSchema, type ChatTurnDiffResult, ChatToolOutputPayloadSchema, type ChatToolOutputPayload, ChatToolOutputResultSchema, type ChatToolOutputResult, CHAT_FORK_TITLE_MAX, ChatForkPayloadSchema, type ChatForkPayload, ChatForkResultSchema, type ChatForkResult, ChatContinueOnPayloadSchema, type ChatContinueOnPayload, ChatContinueOnResultSchema, type ChatContinueOnResult, ChatSummarizePayloadSchema, type ChatSummarizePayload, ChatSummarizeResultSchema, type ChatSummarizeResult, ChatForkInfoPayloadSchema, type ChatForkInfoPayload, ChatForkInfoResultSchema, type ChatForkInfoResult, ChatListResultSchema, type ChatListResult, GeneratedImageInputSchema, type GeneratedImageInput, generatedImageAttachment, holdsConversation } from './chat.ts';
 export { ErrorSchema, type WireError, RequestSchema, type Request, ReplyOkSchema, type ReplyOk, ReplyErrorSchema, type ReplyError, ReplySchema, type Reply, EventSchema, type Event, ServerFrameSchema, type ServerFrame, type ParseResult, parseRequest, parseServerFrame } from './envelope.ts';
 export { SessionIdSchema, type SessionId } from './ids.ts';
 export { ModelOptionChoiceSchema, type ModelOptionChoice, ModelOptionDescriptorSchema, type ModelOptionDescriptor, ModelInfoSchema, type ModelInfo, ModelSelectionSchema, type ModelSelection, ModelCatalogProfileSchema, type ModelCatalogProfile, ModelCatalogEntrySchema, type ModelCatalogEntry, ModelCatalogDataSchema, type ModelCatalogData, RuntimeModeSchema, type RuntimeMode, ProviderCapabilitiesSchema, type ProviderCapabilities, ProviderPlatformSchema, type ProviderPlatform, ProviderSignInSchema, type ProviderSignIn, ProviderInstallSchema, type ProviderInstall, ProviderInfoSchema, type ProviderInfo, FRONTIER_PROVIDER_KINDS, API_PROVIDER_KINDS, type ProviderPickerGroup, type ProviderPickerGroups, providerGroupOf, pickerGroupsOf, ProviderListResultSchema, type ProviderListResult, resumeCommandFor } from './model.ts';

package/dist/index.js

@@ -1,6 +1,6 @@
 // Public API: exports.test.ts snapshots this list, so a name added or dropped here is an API change.
 export { KNOWN_AGENT_KINDS, AGENT_KIND_MAX_LENGTH, AgentKindSchema, isKnownAgentKind, AgentStatusSchema, SUGGESTED_TITLE_LIMIT, SuggestedTitleSchema, AgentRequestSchema, AgentInfoSchema, SessionStatusEventSchema, AgentResumePayloadSchema, ApprovalChoiceSchema, ApprovalRequestSchema, SessionApprovalsEventSchema, ApprovalAnswerPayloadSchema, ApprovalAnswerResultSchema, ApprovalPreferencePayloadSchema } from './agent.js';
-export { ChatIdSchema, ChatContextBreakdownSchema, ChatUsageSchema, CHAT_ATTACHMENTS_MAX_BYTES, CHAT_ATTACHMENT_MAX_BYTES, CHAT_ATTACHMENTS_MAX_COUNT, attachmentBytes, attachmentImageMime, ChatAttachmentUploadSchema, ChatAttachmentUploadsSchema, ChatAttachmentSchema, ChatUiChoiceOriginSchema, ChatUiAnswerSchema, ChatQuoteSourceSchema, ChatQueuedMessageSchema, ChatBackgroundTaskSchema, ChatTurnLimitSchema, ChatGoalStatusSchema, ChatGoalSchema, ChatQuestionSchema, ChatRequestKindSchema, CHAT_REQUEST_LIMITS, ChatRequestApprovalSchema, ChatRequestSummarySchema, ChatInfoSchema, ChatSkillSourceSchema, ChatSkillSchema, SkillsListPayloadSchema, SkillsListResultSchema, ChatUserItemSchema, ChatUiQueryReadingSchema, ChatUiLinkReadingSchema, ChatUiPlaceReadingSchema, ChatUiQueryStateSchema, ChatAssistantItemSchema, ChatThinkingItemSchema, ChatToolStateSchema, ChatToolProgressSchema, ChatFileChangeSchema, ChatSubagentStatusSchema, ChatWorkflowPhaseSchema, ChatWorkflowAgentSchema, ChatWorkflowSchema, workflowAgentRef, workflowAgentIdOf, CHAT_PAYLOAD_INLINE_BYTES, ChatPayloadRefSchema, ChatToolItemSchema, ChatSubagentUsageSchema, HOST_TASK_ORIGIN, ChatSubagentItemSchema, ChatApprovalDecisionSchema, ChatApprovalItemSchema, ChatQuestionItemSchema, ChatCheckpointFileSchema, ChatCheckpointDiffSchema, ChatTurnItemSchema, notResumedNote, abortedByMachine, ENDED_NOTE_PREFIX, abortedByEnd, activeSubagents, CHAT_OUTLINE_TEXT_CHARS, outlineItems, WAITING_NOTE_PREFIX, ChatNoteItemSchema, ChatCompactionItemSchema, ChatItemSchema, ChatEventSchema, ChatEventEnvelopeSchema, ChatCreatePayloadSchema, ChatConfigurePayloadSchema, ChatPreferencesPayloadSchema, ChatTargetPayloadSchema, ChatClearPayloadSchema, ChatCancelPayloadSchema, ChatAttachPayloadSchema, ChatHistoryPayloadSchema, ChatHistoryPageSchema, ChatHistoryResultSchema, ChatSubagentPayloadSchema, ChatStopSubagentPayloadSchema, ChatGoalActionSchema, ChatGoalPayloadSchema, ChatStopTaskPayloadSchema, ChatSubagentPageSchema, ChatSubagentSourceSchema, ChatSubagentResultSchema, ChatStatusEventSchema, ChatSubagentChangedEventSchema, CHAT_BOOKMARK_LIMITS, ChatBookmarkSchema, ChatBookmarksSchema, ChatAddBookmarkPayloadSchema, ChatRenameBookmarkPayloadSchema, ChatRemoveBookmarkPayloadSchema, ChatBookmarksResultSchema, ChatBookmarksEventSchema, ChatRemoveVisualPayloadSchema, ChatVisualsResultSchema, ChatVisualsEventSchema, ChatAttachResultSchema, ChatDeliverySchema, ChatSendPayloadSchema, ChatSendResultSchema, ChatUiChoicePayloadSchema, ChatUiQueryPayloadSchema, ChatUiLinkPayloadSchema, ChatQueuePayloadSchema, ChatUnqueueResultSchema, ChatApprovePayloadSchema, ChatDismissPayloadSchema, ChatAnswerPayloadSchema, ChatTurnDiffPayloadSchema, ChatTurnDiffResultSchema, ChatToolOutputPayloadSchema, ChatToolOutputResultSchema, CHAT_FORK_TITLE_MAX, ChatForkPayloadSchema, ChatForkResultSchema, ChatContinueOnPayloadSchema, ChatContinueOnResultSchema, ChatSummarizePayloadSchema, ChatSummarizeResultSchema, ChatForkInfoPayloadSchema, ChatForkInfoResultSchema, ChatListResultSchema, GeneratedImageInputSchema, generatedImageAttachment, holdsConversation } from './chat.js';
+export { ChatIdSchema, ChatContextBreakdownSchema, ChatUsageSchema, CHAT_ATTACHMENTS_MAX_BYTES, CHAT_ATTACHMENT_MAX_BYTES, CHAT_ATTACHMENTS_MAX_COUNT, attachmentBytes, attachmentImageMime, ChatAttachmentUploadSchema, ChatAttachmentUploadsSchema, ChatAttachmentSchema, ChatUiChoiceOriginSchema, ChatUiAnswerSchema, ChatQuoteSourceSchema, ChatQueuedMessageSchema, ChatBackgroundTaskSchema, ChatTurnLimitSchema, ChatGoalStatusSchema, ChatGoalSchema, ChatQuestionSchema, ChatRequestKindSchema, CHAT_REQUEST_LIMITS, ChatRequestApprovalSchema, ChatRequestSummarySchema, ChatInfoSchema, ChatSkillSourceSchema, ChatSkillSchema, SkillsListPayloadSchema, SkillsListResultSchema, ChatUserItemSchema, ChatUiQueryReadingSchema, ChatUiLinkReadingSchema, ChatUiPlaceReadingSchema, ChatUiQueryStateSchema, ChatAssistantItemSchema, ChatThinkingItemSchema, ChatToolStateSchema, ChatToolProgressSchema, ChatFileChangeSchema, ChatSubagentStatusSchema, ChatWorkflowPhaseSchema, ChatWorkflowAgentSchema, ChatWorkflowSchema, workflowAgentRef, workflowAgentIdOf, CHAT_PAYLOAD_INLINE_BYTES, ChatPayloadRefSchema, ChatToolItemSchema, ChatSubagentUsageSchema, HOST_TASK_ORIGIN, ChatSubagentItemSchema, ChatApprovalDecisionSchema, ChatApprovalItemSchema, ChatQuestionItemSchema, ChatCheckpointFileSchema, ChatCheckpointDiffSchema, ChatTurnItemSchema, notResumedNote, abortedByMachine, ENDED_NOTE_PREFIX, abortedByEnd, activeSubagents, activeWorkflows, workflowEndedAt, CHAT_OUTLINE_TEXT_CHARS, outlineItems, WAITING_NOTE_PREFIX, ChatNoteItemSchema, ChatCompactionItemSchema, ChatItemSchema, ChatEventSchema, ChatEventEnvelopeSchema, ChatCreatePayloadSchema, ChatConfigurePayloadSchema, ChatPreferencesPayloadSchema, ChatTargetPayloadSchema, ChatClearPayloadSchema, ChatCancelPayloadSchema, ChatAttachPayloadSchema, ChatHistoryPayloadSchema, ChatHistoryPageSchema, ChatHistoryResultSchema, ChatSubagentPayloadSchema, ChatStopSubagentPayloadSchema, ChatGoalActionSchema, ChatGoalPayloadSchema, ChatStopTaskPayloadSchema, ChatSubagentPageSchema, ChatSubagentSourceSchema, ChatSubagentResultSchema, ChatStatusEventSchema, ChatSubagentChangedEventSchema, CHAT_BOOKMARK_LIMITS, ChatBookmarkSchema, ChatBookmarksSchema, ChatAddBookmarkPayloadSchema, ChatRenameBookmarkPayloadSchema, ChatRemoveBookmarkPayloadSchema, ChatBookmarksResultSchema, ChatBookmarksEventSchema, ChatRemoveVisualPayloadSchema, ChatVisualsResultSchema, ChatVisualsEventSchema, ChatAttachResultSchema, ChatDeliverySchema, ChatSendPayloadSchema, ChatSendResultSchema, ChatUiChoicePayloadSchema, ChatUiQueryPayloadSchema, ChatUiLinkPayloadSchema, ChatQueuePayloadSchema, ChatUnqueueResultSchema, ChatApprovePayloadSchema, ChatDismissPayloadSchema, ChatAnswerPayloadSchema, ChatTurnDiffPayloadSchema, ChatTurnDiffResultSchema, ChatToolOutputPayloadSchema, ChatToolOutputResultSchema, CHAT_FORK_TITLE_MAX, ChatForkPayloadSchema, ChatForkResultSchema, ChatContinueOnPayloadSchema, ChatContinueOnResultSchema, ChatSummarizePayloadSchema, ChatSummarizeResultSchema, ChatForkInfoPayloadSchema, ChatForkInfoResultSchema, ChatListResultSchema, GeneratedImageInputSchema, generatedImageAttachment, holdsConversation } from './chat.js';
 export { ErrorSchema, RequestSchema, ReplyOkSchema, ReplyErrorSchema, ReplySchema, EventSchema, ServerFrameSchema, parseRequest, parseServerFrame } from './envelope.js';
 export { SessionIdSchema } from './ids.js';
 export { ModelOptionChoiceSchema, ModelOptionDescriptorSchema, ModelInfoSchema, ModelSelectionSchema, ModelCatalogProfileSchema, ModelCatalogEntrySchema, ModelCatalogDataSchema, RuntimeModeSchema, ProviderCapabilitiesSchema, ProviderPlatformSchema, ProviderSignInSchema, ProviderInstallSchema, ProviderInfoSchema, FRONTIER_PROVIDER_KINDS, API_PROVIDER_KINDS, providerGroupOf, pickerGroupsOf, ProviderListResultSchema, resumeCommandFor } from './model.js';

package/dist/protocol.d.ts

@@ -372,6 +372,7 @@ export declare const AGENT_REQUEST_SCHEMAS: {
                     }, z.core.$strip>>;
                     lastProgressAt: z.ZodOptional<z.ZodNumber>;
                     stalledAt: z.ZodOptional<z.ZodNumber>;
+                    finishedAt: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
                 outputRef: z.ZodOptional<z.ZodObject<{
                     id: z.ZodString;
@@ -900,6 +901,7 @@ export declare const AGENT_REQUEST_SCHEMAS: {
                     }, z.core.$strip>>;
                     lastProgressAt: z.ZodOptional<z.ZodNumber>;
                     stalledAt: z.ZodOptional<z.ZodNumber>;
+                    finishedAt: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
                 outputRef: z.ZodOptional<z.ZodObject<{
                     id: z.ZodString;
@@ -1254,6 +1256,7 @@ export declare const AGENT_REQUEST_SCHEMAS: {
                     }, z.core.$strip>>;
                     lastProgressAt: z.ZodOptional<z.ZodNumber>;
                     stalledAt: z.ZodOptional<z.ZodNumber>;
+                    finishedAt: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
                 outputRef: z.ZodOptional<z.ZodObject<{
                     id: z.ZodString;
@@ -1607,6 +1610,7 @@ export declare const AGENT_REQUEST_SCHEMAS: {
                         }, z.core.$strip>>;
                         lastProgressAt: z.ZodOptional<z.ZodNumber>;
                         stalledAt: z.ZodOptional<z.ZodNumber>;
+                        finishedAt: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strip>>;
                     outputRef: z.ZodOptional<z.ZodObject<{
                         id: z.ZodString;
@@ -2358,6 +2362,7 @@ export declare const AGENT_REQUEST_SCHEMAS: {
                         }, z.core.$strip>>;
                         lastProgressAt: z.ZodOptional<z.ZodNumber>;
                         stalledAt: z.ZodOptional<z.ZodNumber>;
+                        finishedAt: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strip>>;
                     outputRef: z.ZodOptional<z.ZodObject<{
                         id: z.ZodString;
@@ -2587,6 +2592,69 @@ export declare const AGENT_REQUEST_SCHEMAS: {
                 childId: z.ZodOptional<z.ZodString>;
                 parentToolUseId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
+            workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                createdAt: z.ZodNumber;
+                turnId: z.ZodNullable<z.ZodString>;
+                kind: z.ZodLiteral<"tool">;
+                toolUseId: z.ZodString;
+                name: z.ZodString;
+                input: z.ZodUnknown;
+                output: z.ZodNullable<z.ZodString>;
+                state: z.ZodEnum<{
+                    done: "done";
+                    error: "error";
+                    running: "running";
+                }>;
+                parentToolUseId: z.ZodNullable<z.ZodString>;
+                progress: z.ZodOptional<z.ZodObject<{
+                    startedAt: z.ZodNullable<z.ZodNumber>;
+                    description: z.ZodNullable<z.ZodString>;
+                    output: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                changes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    kind: z.ZodEnum<{
+                        add: "add";
+                        delete: "delete";
+                        update: "update";
+                    }>;
+                    diff: z.ZodString;
+                }, z.core.$strip>>>;
+                workflow: z.ZodOptional<z.ZodObject<{
+                    name: z.ZodNullable<z.ZodString>;
+                    taskId: z.ZodOptional<z.ZodString>;
+                    phases: z.ZodArray<z.ZodObject<{
+                        index: z.ZodNumber;
+                        title: z.ZodString;
+                    }, z.core.$strip>>;
+                    agents: z.ZodArray<z.ZodObject<{
+                        index: z.ZodNumber;
+                        label: z.ZodString;
+                        phaseIndex: z.ZodNullable<z.ZodNumber>;
+                        agentId: z.ZodNullable<z.ZodString>;
+                        status: z.ZodEnum<{
+                            done: "done";
+                            failed: "failed";
+                            running: "running";
+                        }>;
+                        startedAt: z.ZodNullable<z.ZodNumber>;
+                        durationMs: z.ZodNullable<z.ZodNumber>;
+                        lastTool: z.ZodNullable<z.ZodString>;
+                        lastToolSummary: z.ZodOptional<z.ZodString>;
+                        promptPreview: z.ZodOptional<z.ZodString>;
+                        resultPreview: z.ZodOptional<z.ZodString>;
+                        error: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    lastProgressAt: z.ZodOptional<z.ZodNumber>;
+                    stalledAt: z.ZodOptional<z.ZodNumber>;
+                    finishedAt: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                outputRef: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    bytes: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
             outline: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 id: z.ZodString;
                 createdAt: z.ZodNumber;
@@ -2767,6 +2835,7 @@ export declare const AGENT_REQUEST_SCHEMAS: {
                     }, z.core.$strip>>;
                     lastProgressAt: z.ZodOptional<z.ZodNumber>;
                     stalledAt: z.ZodOptional<z.ZodNumber>;
+                    finishedAt: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
                 outputRef: z.ZodOptional<z.ZodObject<{
                     id: z.ZodString;
@@ -4001,6 +4070,7 @@ export declare const AGENT_REQUEST_SCHEMAS: {
                     }, z.core.$strip>>;
                     lastProgressAt: z.ZodOptional<z.ZodNumber>;
                     stalledAt: z.ZodOptional<z.ZodNumber>;
+                    finishedAt: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
                 outputRef: z.ZodOptional<z.ZodObject<{
                     id: z.ZodString;
@@ -5261,6 +5331,7 @@ export declare const AGENT_EVENT_SCHEMAS: {
                     }, z.core.$strip>>;
                     lastProgressAt: z.ZodOptional<z.ZodNumber>;
                     stalledAt: z.ZodOptional<z.ZodNumber>;
+                    finishedAt: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
                 outputRef: z.ZodOptional<z.ZodObject<{
                     id: z.ZodString;
@@ -6012,6 +6083,7 @@ export declare const AGENT_EVENT_SCHEMAS: {
                     }, z.core.$strip>>;
                     lastProgressAt: z.ZodOptional<z.ZodNumber>;
                     stalledAt: z.ZodOptional<z.ZodNumber>;
+                    finishedAt: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
                 outputRef: z.ZodOptional<z.ZodObject<{
                     id: z.ZodString;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agent-contracts",
-  "version": "0.45.0",
+  "version": "0.46.0",
   "description": "Schemas and port contracts for agent chats, provider accounts, models and usage.",
   "type": "module",
   "exports": {
@@ -86,7 +86,7 @@
     "test": "bun --conditions=source test"
   },
   "dependencies": {
-    "@adecore/intelligent-ui": "0.45.0",
+    "@adecore/intelligent-ui": "0.46.0",
     "zod": "^4.6.7"
   },
   "devDependencies": {

package/src/chat.ts

@@ -494,7 +494,9 @@ export const ChatWorkflowSchema = z.object({
     phases: z.array(ChatWorkflowPhaseSchema),
     agents: z.array(ChatWorkflowAgentSchema),
     lastProgressAt: z.number().optional(),
-    stalledAt: z.number().optional()
+    stalledAt: z.number().optional(),
+    // Set by the host once the Workflow call settled; a call stored before it was kept has none.
+    finishedAt: z.number().optional()
 });
 export type ChatWorkflow = z.infer<typeof ChatWorkflowSchema>;
 
@@ -775,6 +777,44 @@ export function activeSubagents(items: readonly ChatItem[]): ChatSubagentItem[]
         .map(({ item }) => item);
 }
 
+/*
+ * When a workflow last did something it could be shown for: the end the host noted, else the last end
+ * of an agent, else its last report. Null for one that never reported, which counts as long ago.
+ */
+export function workflowEndedAt(workflow: ChatWorkflow): number | null {
+    if (workflow.finishedAt !== undefined) {
+        return workflow.finishedAt;
+    }
+
+    const ends = workflow.agents.flatMap((agent) => (agent.startedAt !== null && agent.durationMs !== null ? [agent.startedAt + agent.durationMs] : []));
+
+    return ends.length > 0 ? Math.max(...ends) : (workflow.lastProgressAt ?? null);
+}
+
+/*
+ * The Workflow calls a chat still speaks of beside its thread, by the rule of `activeSubagents`: every
+ * one that runs, and the ones that ended since the last message, so a finished workflow stays until the
+ * next message is sent. Only a call that reported what it runs counts. `items` is in thread order.
+ */
+export function activeWorkflows(items: readonly ChatItem[]): ChatToolItem[] {
+    const lastMessage = items.findLastIndex((item) => item.kind === 'user');
+    const lastMessageAt = lastMessage < 0 ? null : items[lastMessage]!.createdAt;
+
+    return items.filter((item, index): item is ChatToolItem => {
+        if (item.kind !== 'tool' || item.name !== 'Workflow' || item.workflow === undefined) {
+            return false;
+        }
+
+        if (item.state === 'running' || index > lastMessage) {
+            return true;
+        }
+
+        const endedAt = workflowEndedAt(item.workflow);
+
+        return lastMessageAt !== null && endedAt !== null && endedAt > lastMessageAt;
+    });
+}
+
 /* How much of a message the outline keeps: what a hover card over its tick shows. */
 export const CHAT_OUTLINE_TEXT_CHARS = 280;
 
@@ -1033,6 +1073,8 @@ export const ChatAttachResultSchema = z.object({
     visuals: ChatVisualsSchema.optional(),
     // With a page: the active sub-agents (`activeSubagents`) from before it, so the pill over the composer never waits on a scroll.
     subagents: z.array(ChatSubagentItemSchema).optional(),
+    // With a page: the active Workflow calls (`activeWorkflows`) from before it, so what shows a workflow beside the thread never waits on a scroll.
+    workflows: z.array(ChatToolItemSchema).optional(),
     // With a page: the thread before it as `outlineItems` cuts it, so the scrubber reaches the whole thread before a scroll does.
     outline: z.array(ChatItemSchema).optional()
 });

package/src/index.ts

@@ -132,6 +132,8 @@ export {
     ENDED_NOTE_PREFIX,
     abortedByEnd,
     activeSubagents,
+    activeWorkflows,
+    workflowEndedAt,
     CHAT_OUTLINE_TEXT_CHARS,
     outlineItems,
     WAITING_NOTE_PREFIX,