From 439a6862e152c51a1dbc54ab5739ba0bc07f80fa Mon Sep 17 00:00:00 2001 From: Christian Byrne Date: Tue, 29 Sep 2026 17:15:47 -0700 Subject: [PATCH 1/7] fix(agent): prevent retries after accepted turns Addresses review feedback:\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19497#discussion_r4139468017\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19497#discussion_r4139468021\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19497#discussion_r4139468025\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19497#discussion_r4139468037\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19497#discussion_r4139468040\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19497#discussion_r4139468044 --- src/platform/telemetry/TelemetryRegistry.ts | 1 - .../cloud/PostHogTelemetryProvider.ts | 1 - .../composables/agent/useAgentSession.test.ts | 30 +++++++-- .../composables/agent/useAgentSession.ts | 61 +++++++++++++------ .../stores/agent/agentConversationStore.ts | 8 +++ 5 files changed, 77 insertions(+), 24 deletions(-) diff --git a/src/platform/telemetry/TelemetryRegistry.ts b/src/platform/telemetry/TelemetryRegistry.ts index bdb9a2e656b..05b07db9100 100644 --- a/src/platform/telemetry/TelemetryRegistry.ts +++ b/src/platform/telemetry/TelemetryRegistry.ts @@ -414,7 +414,6 @@ export class TelemetryRegistry implements TelemetryDispatcher { this.dispatch((provider) => provider.trackAgentWorkflowApplied?.(metadata)) } - // fallow-ignore-next-line unused-class-member trackAgentError(metadata: AgentErrorMetadata): void { this.dispatch((provider) => provider.trackAgentError?.(metadata)) } diff --git a/src/platform/telemetry/providers/cloud/PostHogTelemetryProvider.ts b/src/platform/telemetry/providers/cloud/PostHogTelemetryProvider.ts index b76651d8c1e..85bb2544f17 100644 --- a/src/platform/telemetry/providers/cloud/PostHogTelemetryProvider.ts +++ b/src/platform/telemetry/providers/cloud/PostHogTelemetryProvider.ts @@ -745,7 +745,6 @@ export class PostHogTelemetryProvider implements TelemetryProvider { this.trackEvent(TelemetryEvents.AGENT_WORKFLOW_APPLIED, metadata) } - // fallow-ignore-next-line unused-class-member trackAgentError(metadata: AgentErrorMetadata): void { this.trackEvent(TelemetryEvents.AGENT_ERROR, metadata) } diff --git a/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts b/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts index a6b2f9a2717..8326decb018 100644 --- a/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts +++ b/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts @@ -2784,7 +2784,17 @@ describe('app:agent_error telemetry (TEL-8)', () => { const [error, options] = vi.mocked(reportError).mock.calls[0] expect((error as Error).message).toBe('Malformed agent stream event') expect(options.tags?.event_type).toBe('agent_message_done') - expect(options.context?.issues).toEqual(expect.any(Array)) + expect(options.context?.issues).toEqual( + expect.arrayContaining([ + expect.objectContaining({ + code: expect.any(String), + path: expect.any(Array), + message: expect.any(String) + }) + ]) + ) + for (const issue of (options.context?.issues ?? []) as object[]) + expect(Object.keys(issue).sort()).toEqual(['code', 'message', 'path']) }) it('reports a rejected send to the unified error sinks', async () => { @@ -2876,7 +2886,7 @@ describe('app:agent_error telemetry (TEL-8)', () => { try { const ok = await session.sendMessage('make me a cat') - expect(ok).toBe(false) + expect(ok).toBe(true) } finally { setItem.mockRestore() } @@ -2901,7 +2911,7 @@ describe('app:agent_error telemetry (TEL-8)', () => { const session = useAgentSession({ rest, events: fakeEvents().source }) session.start() - await session.sendMessage('make me a cat') + expect(await session.sendMessage('make me a cat')).toBe(true) expect(telemetry.trackAgentError).toHaveBeenCalledWith({ error_class: 'request_failed', @@ -2924,7 +2934,7 @@ describe('app:agent_error telemetry (TEL-8)', () => { const session = useAgentSession({ rest, events: fakeEvents().source }) session.start() - await session.sendMessage('make me a cat') + expect(await session.sendMessage('make me a cat')).toBe(true) expect(telemetry.trackAgentError).toHaveBeenCalledWith({ error_class: 'request_failed', @@ -3060,6 +3070,18 @@ describe('app:agent_error telemetry (TEL-8)', () => { // The aborted turn, then the idle session the other nineteen arrived into. expect(telemetry.trackAgentError).toHaveBeenCalledTimes(2) + expect(session.notices.value).toHaveLength(2) + }) + + it('does not trust attacker-controlled message ids as telemetry keys', () => { + const { source, emit } = fakeEvents() + const session = useAgentSession({ rest: fakeRest(), events: source }) + session.start() + + for (let i = 0; i < 100; i++) + emit({ type: 'agent_message_delta', data: { message_id: `spoof-${i}` } }) + + expect(telemetry.trackAgentError).toHaveBeenCalledTimes(1) }) it('tracks malformed frames of event types that never reach the user', async () => { diff --git a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts index 7b99be93204..29872d8e51b 100644 --- a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts +++ b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts @@ -112,6 +112,11 @@ export function isRetryableRequestFailure( accepted: boolean ): boolean { if (accepted) return false + if ( + error instanceof ZodError || + error instanceof AgentResponseUnreadableError + ) + return false if (error instanceof AgentApiError) return !NON_RETRYABLE_REQUEST_STATUSES.has(error.status) return true @@ -214,15 +219,27 @@ export function useAgentSession(deps: AgentSessionDeps) { eventType: string, turnId: TurnId | null, uiTreatment: AgentErrorMetadata['ui_treatment'] - ): void { + ): boolean { const visible = uiTreatment !== 'none' const priorVisible = malformedStreamReports.get(turnId) - if (priorVisible === true || (priorVisible === false && !visible)) return + if (priorVisible === true || (priorVisible === false && !visible)) + return false + if ( + !malformedStreamReports.has(turnId) && + malformedStreamReports.size >= 32 + ) + return false malformedStreamReports.set(turnId, visible) reportError(new Error('Malformed agent stream event'), { errorType: 'agent_malformed_stream_event', tags: { ui_treatment: uiTreatment, event_type: eventType }, - context: { issues: cause.issues } + context: { + issues: cause.issues.slice(0, 10).map(({ code, path, message }) => ({ + code, + path, + message + })) + } }) trackAgentError( 'malformed_stream_event', @@ -230,6 +247,7 @@ export function useAgentSession(deps: AgentSessionDeps) { uiTreatment, { retryable: false } ) + return true } function start(): void { @@ -514,7 +532,7 @@ export function useAgentSession(deps: AgentSessionDeps) { error: unknown, text: string, accepted: boolean - ): void { + ): boolean { const admission = parseAdmissionError(error) if (admission?.reason === 'no_funds') { conversationStore.recordPaywall( @@ -522,7 +540,7 @@ export function useAgentSession(deps: AgentSessionDeps) { text, admission.message ) - return + return false } if (admission !== undefined) { conversationStore.recordFailedSend( @@ -533,7 +551,7 @@ export function useAgentSession(deps: AgentSessionDeps) { ? admission.retryAfterSeconds : undefined ) - return + return false } const message = error instanceof AgentApiError @@ -547,13 +565,19 @@ export function useAgentSession(deps: AgentSessionDeps) { `${i18n.global.t('agent.sendFailed')}: ${message}` ) const turnAccepted = accepted || isUnreadableAckFailure(error) - reportError(error, { errorType: 'agent_send_message_failed' }) + const disowned = + error instanceof AgentApiError && + error.status === 403 && + zDisownedWorkflowError.safeParse(error.body).success + if (!disowned) + reportError(error, { errorType: 'agent_send_message_failed' }) trackAgentError( 'request_failed', turnAccepted ? 'post_acceptance' : 'pre_acceptance', 'inline_notice', { retryable: isRetryableRequestFailure(error, turnAccepted) } ) + return turnAccepted } /** @@ -621,8 +645,7 @@ export function useAgentSession(deps: AgentSessionDeps) { // moved on still has to release, or the dead id survives the reload. releaseDisownedWorkflow(sentContext, error) if (generation !== loadGeneration) return false - recordSendError(error, text, accepted) - return false + return recordSendError(error, text, accepted) } } @@ -778,25 +801,27 @@ export function useAgentSession(deps: AgentSessionDeps) { ): void { const messageId = (raw as { data?: { message_id?: unknown } }).data ?.message_id + const turnId = + typeof messageId === 'string' ? (messageId as TurnId) : undefined let reportedTurnId = - typeof messageId === 'string' - ? (messageId as TurnId) + turnId !== undefined && conversationStore.hasPendingTurn(turnId) + ? turnId : conversationStore.activeTurnId let uiTreatment: AgentErrorMetadata['ui_treatment'] = 'none' if (type === 'agent_message_done') { - if ( - typeof messageId !== 'string' || - messageId === conversationStore.activeTurnId - ) { + if (turnId === undefined || turnId === conversationStore.activeTurnId) { conversationStore.abortActiveTurn() - pushError(i18n.global.t('agent.malformedEvent')) uiTreatment = 'error_overlay' } else { reportedTurnId = - conversationStore.settleBackgroundTurn(messageId) ?? reportedTurnId + conversationStore.settleBackgroundTurn(turnId) ?? reportedTurnId } } - trackMalformedStreamEvent(error, type, reportedTurnId, uiTreatment) + if ( + trackMalformedStreamEvent(error, type, reportedTurnId, uiTreatment) && + uiTreatment === 'error_overlay' + ) + pushError(i18n.global.t('agent.malformedEvent')) console.warn('[agent] dropping malformed agent event', error) } diff --git a/src/workbench/extensions/agent/stores/agent/agentConversationStore.ts b/src/workbench/extensions/agent/stores/agent/agentConversationStore.ts index 0d6cb684e7c..4910ee39586 100644 --- a/src/workbench/extensions/agent/stores/agent/agentConversationStore.ts +++ b/src/workbench/extensions/agent/stores/agent/agentConversationStore.ts @@ -424,6 +424,13 @@ export const useAgentConversationStore = defineStore( return null } + function hasPendingTurn(turnId: string): boolean { + if (activeTurnId.value === turnId) return true + for (const entry of backgroundTurns.values()) + if (entry.messageId === turnId) return true + return false + } + function dropBackgroundTurns(): void { for (const [backgroundThreadId, entry] of backgroundTurns) { rememberDepartedTurn( @@ -601,6 +608,7 @@ export const useAgentConversationStore = defineStore( stashActiveTurn, resumeBackgroundTurn, settleBackgroundTurn, + hasPendingTurn, dropBackgroundTurns, reset, hydrate From 0e41149eafc45b76489b8d5ea23db3b7f4ad7ed8 Mon Sep 17 00:00:00 2001 From: bymyself Date: Tue, 29 Sep 2026 17:45:40 -0700 Subject: [PATCH 2/7] fix(agent): scope accepted-response recovery Addresses review feedback:\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19497#discussion_r4139468032\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19497#discussion_r4139468034\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19497#discussion_r4139468046 --- .../composables/agent/useAgentSession.test.ts | 1 - .../composables/agent/useAgentSession.ts | 20 +++++++++++-------- .../agent/services/agent/agentRestClient.ts | 7 ++++--- 3 files changed, 16 insertions(+), 12 deletions(-) diff --git a/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts b/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts index 8326decb018..9a22f725f7a 100644 --- a/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts +++ b/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts @@ -2926,7 +2926,6 @@ describe('app:agent_error telemetry (TEL-8)', () => { const rest = fakeRest({ postMessage: vi.fn(async () => { throw new AgentResponseUnreadableError( - '/agent/threads/new/messages', new SyntaxError('Unexpected end of JSON input') ) }) diff --git a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts index 29872d8e51b..fd066e34037 100644 --- a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts +++ b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts @@ -103,10 +103,6 @@ export interface AgentSessionDeps { const THREAD_STORAGE_KEY = 'Comfy.Agent.ThreadId' const PREPARE_TIMEOUT_MS = 3000 -const NON_RETRYABLE_REQUEST_STATUSES = new Set([ - 400, 401, 403, 404, 405, 409, 410, 422 -]) - export function isRetryableRequestFailure( error: unknown, accepted: boolean @@ -117,8 +113,10 @@ export function isRetryableRequestFailure( error instanceof AgentResponseUnreadableError ) return false - if (error instanceof AgentApiError) - return !NON_RETRYABLE_REQUEST_STATUSES.has(error.status) + if (error instanceof AgentApiError) { + if ([408, 425, 429].includes(error.status)) return true + return error.status < 400 || error.status >= 500 + } return true } @@ -616,6 +614,7 @@ export function useAgentSession(deps: AgentSessionDeps) { originContext === undefined ? null : { tabPath: originContext.tabPath } let sentContext: WorkflowTurnContext | undefined let accepted = false + let requestStarted = false try { await prepareWorkflow() if (generation !== loadGeneration) return false @@ -625,6 +624,7 @@ export function useAgentSession(deps: AgentSessionDeps) { return false } sentContext = wfContext + requestStarted = true const ack = await postTurn( threadAtSend, text, @@ -636,7 +636,7 @@ export function useAgentSession(deps: AgentSessionDeps) { selectionWorkflowId ) accepted = true - if (generation !== loadGeneration) return false + if (generation !== loadGeneration) return true acceptTurn(ack, text, wfContext, attachments, tags, workflowReferences) return true } catch (error) { @@ -645,7 +645,11 @@ export function useAgentSession(deps: AgentSessionDeps) { // moved on still has to release, or the dead id survives the reload. releaseDisownedWorkflow(sentContext, error) if (generation !== loadGeneration) return false - return recordSendError(error, text, accepted) + return recordSendError( + error, + text, + accepted || (requestStarted && isUnreadableAckFailure(error)) + ) } } diff --git a/src/workbench/extensions/agent/services/agent/agentRestClient.ts b/src/workbench/extensions/agent/services/agent/agentRestClient.ts index 8606663b585..1f12cd1a418 100644 --- a/src/workbench/extensions/agent/services/agent/agentRestClient.ts +++ b/src/workbench/extensions/agent/services/agent/agentRestClient.ts @@ -49,8 +49,8 @@ export class AgentApiError extends Error { } export class AgentResponseUnreadableError extends Error { - constructor(route: string, cause: unknown) { - super(`Unreadable agent response body from ${route}`, { cause }) + constructor(cause: unknown) { + super('Unreadable agent response body', { cause }) this.name = 'AgentResponseUnreadableError' } } @@ -350,7 +350,8 @@ export function createAgentRestClient() { try { payload = await response.json() } catch (error) { - throw new AgentResponseUnreadableError(route, error) + if (error instanceof Error && error.name === 'AbortError') throw error + throw new AgentResponseUnreadableError(error) } return schema.parse(payload) } From 4fb6ad9f3a02d005ab48f3297db1e42897ebc525 Mon Sep 17 00:00:00 2001 From: bymyself Date: Tue, 29 Sep 2026 17:47:15 -0700 Subject: [PATCH 3/7] refactor(agent): make background settlement side-effect only Addresses review feedback:\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19497#discussion_r4139468044 --- .../extensions/agent/composables/agent/useAgentSession.ts | 5 ++--- .../extensions/agent/stores/agent/agentConversationStore.ts | 5 ++--- 2 files changed, 4 insertions(+), 6 deletions(-) diff --git a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts index fd066e34037..1c2323386bf 100644 --- a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts +++ b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts @@ -807,7 +807,7 @@ export function useAgentSession(deps: AgentSessionDeps) { ?.message_id const turnId = typeof messageId === 'string' ? (messageId as TurnId) : undefined - let reportedTurnId = + const reportedTurnId = turnId !== undefined && conversationStore.hasPendingTurn(turnId) ? turnId : conversationStore.activeTurnId @@ -817,8 +817,7 @@ export function useAgentSession(deps: AgentSessionDeps) { conversationStore.abortActiveTurn() uiTreatment = 'error_overlay' } else { - reportedTurnId = - conversationStore.settleBackgroundTurn(turnId) ?? reportedTurnId + conversationStore.settleBackgroundTurn(turnId) } } if ( diff --git a/src/workbench/extensions/agent/stores/agent/agentConversationStore.ts b/src/workbench/extensions/agent/stores/agent/agentConversationStore.ts index 4910ee39586..0ab30233c39 100644 --- a/src/workbench/extensions/agent/stores/agent/agentConversationStore.ts +++ b/src/workbench/extensions/agent/stores/agent/agentConversationStore.ts @@ -409,7 +409,7 @@ export const useAgentConversationStore = defineStore( return true } - function settleBackgroundTurn(turnId: string): TurnId | null { + function settleBackgroundTurn(turnId: string): void { for (const [key, entry] of backgroundTurns) { if (entry.messageId !== turnId) continue rememberDepartedTurn(key, entry.messageId, 'settled-turn') @@ -419,9 +419,8 @@ export const useAgentConversationStore = defineStore( // will keep it reachable afterwards, so flush its held parts now. entry.transport.dispose() backgroundTurns.delete(key) - return entry.messageId + return } - return null } function hasPendingTurn(turnId: string): boolean { From 06dbbd7ad54b20ce805cb1e0bfbd6dc0a26e4493 Mon Sep 17 00:00:00 2001 From: bymyself Date: Tue, 29 Sep 2026 17:56:12 -0700 Subject: [PATCH 4/7] refactor(agent): clear fallow risk findings Extract active-tab and send-failure helpers without changing behavior; document interface-dispatched telemetry members for static analysis. --- src/platform/telemetry/TelemetryRegistry.ts | 1 + .../cloud/PostHogTelemetryProvider.ts | 1 + .../extensions/agent/AgentPanelRoot.vue | 120 ++++++++++-------- .../composables/agent/useAgentSession.ts | 65 ++++++---- 4 files changed, 112 insertions(+), 75 deletions(-) diff --git a/src/platform/telemetry/TelemetryRegistry.ts b/src/platform/telemetry/TelemetryRegistry.ts index 05b07db9100..bdb9a2e656b 100644 --- a/src/platform/telemetry/TelemetryRegistry.ts +++ b/src/platform/telemetry/TelemetryRegistry.ts @@ -414,6 +414,7 @@ export class TelemetryRegistry implements TelemetryDispatcher { this.dispatch((provider) => provider.trackAgentWorkflowApplied?.(metadata)) } + // fallow-ignore-next-line unused-class-member trackAgentError(metadata: AgentErrorMetadata): void { this.dispatch((provider) => provider.trackAgentError?.(metadata)) } diff --git a/src/platform/telemetry/providers/cloud/PostHogTelemetryProvider.ts b/src/platform/telemetry/providers/cloud/PostHogTelemetryProvider.ts index 85bb2544f17..b76651d8c1e 100644 --- a/src/platform/telemetry/providers/cloud/PostHogTelemetryProvider.ts +++ b/src/platform/telemetry/providers/cloud/PostHogTelemetryProvider.ts @@ -745,6 +745,7 @@ export class PostHogTelemetryProvider implements TelemetryProvider { this.trackEvent(TelemetryEvents.AGENT_WORKFLOW_APPLIED, metadata) } + // fallow-ignore-next-line unused-class-member trackAgentError(metadata: AgentErrorMetadata): void { this.trackEvent(TelemetryEvents.AGENT_ERROR, metadata) } diff --git a/src/workbench/extensions/agent/AgentPanelRoot.vue b/src/workbench/extensions/agent/AgentPanelRoot.vue index 77f27749f88..6cb39076fd0 100644 --- a/src/workbench/extensions/agent/AgentPanelRoot.vue +++ b/src/workbench/extensions/agent/AgentPanelRoot.vue @@ -898,6 +898,71 @@ function agentTabFilename(name: string | undefined): string | undefined { return cleaned.length === 0 ? undefined : `${cleaned}.json` } +type AgentTabTarget = NonNullable> + +async function openBoundAgentTab( + data: AgentActiveTabData, + bound: AgentTabTarget, + stale: () => boolean +): Promise { + const opened = await workflowService.openWorkflow(bound) + if (stale()) return + if (!opened) { + warnWorkflowUnavailable() + trackWorkflowOpenFailure('toast') + return + } + // Name resolution does not create the binding consumed downstream. + bindingStore.bind(data.workflow_id, bound.path) + if (status.value !== 'idle') tabActivity.setEditing(bound.path) + bindWorkflow(data.workflow_id) + useTelemetry()?.trackAgentWorkflowApplied({ + workflow_id: data.workflow_id, + target: 'active_tab_switch' + }) +} + +async function openNewAgentTab( + data: AgentActiveTabData, + stale: () => boolean +): Promise { + const creatingStartedAt = Date.now() + tabActivity.setCreating(true) + const remainingCreatingTime = + CREATING_TAB_MIN_DURATION_MS - (Date.now() - creatingStartedAt) + if (remainingCreatingTime > 0) + await new Promise((resolve) => setTimeout(resolve, remainingCreatingTime)) + if (stale()) return + + const tab = workflowStore.createNewTemporary( + agentTabFilename(data.name), + agentTabGraph + ) + tabActivity.setCreating(false) + let opened: boolean + try { + opened = await workflowService.openWorkflow(tab) + } catch (error) { + await workflowService.closeWorkflow(tab, { warnIfUnsaved: false }) + throw error + } + if (stale() || !opened) { + await workflowService.closeWorkflow(tab, { warnIfUnsaved: false }) + if (!stale()) { + warnWorkflowUnavailable() + trackWorkflowOpenFailure('toast') + } + return + } + if (status.value !== 'idle') tabActivity.setEditing(tab.path) + bindingStore.bind(data.workflow_id, tab.path) + bindWorkflow(data.workflow_id) + useTelemetry()?.trackAgentWorkflowApplied({ + workflow_id: data.workflow_id, + target: 'active_tab_open' + }) +} + async function onAgentActiveTab( data: AgentActiveTabData, generation: number @@ -906,59 +971,8 @@ async function onAgentActiveTab( if (stale()) return try { const bound = boundOrOpenWorkflowFor(data.workflow_id) - if (bound) { - const opened = await workflowService.openWorkflow(bound) - if (stale()) return - if (!opened) { - warnWorkflowUnavailable() - trackWorkflowOpenFailure('toast') - return - } - // boundOrOpenWorkflowFor can resolve by cloud name, which leaves no binding behind - // for everything downstream that only reads tabPathFor. - bindingStore.bind(data.workflow_id, bound.path) - if (status.value !== 'idle') tabActivity.setEditing(bound.path) - bindWorkflow(data.workflow_id) - useTelemetry()?.trackAgentWorkflowApplied({ - workflow_id: data.workflow_id, - target: 'active_tab_switch' - }) - return - } - const creatingStartedAt = Date.now() - tabActivity.setCreating(true) - const remainingCreatingTime = - CREATING_TAB_MIN_DURATION_MS - (Date.now() - creatingStartedAt) - if (remainingCreatingTime > 0) - await new Promise((resolve) => setTimeout(resolve, remainingCreatingTime)) - if (stale()) return - const tab = workflowStore.createNewTemporary( - agentTabFilename(data.name), - agentTabGraph - ) - tabActivity.setCreating(false) - let opened: boolean - try { - opened = await workflowService.openWorkflow(tab) - } catch (error) { - await workflowService.closeWorkflow(tab, { warnIfUnsaved: false }) - throw error - } - if (stale() || !opened) { - await workflowService.closeWorkflow(tab, { warnIfUnsaved: false }) - if (!stale()) { - warnWorkflowUnavailable() - trackWorkflowOpenFailure('toast') - } - return - } - if (status.value !== 'idle') tabActivity.setEditing(tab.path) - bindingStore.bind(data.workflow_id, tab.path) - bindWorkflow(data.workflow_id) - useTelemetry()?.trackAgentWorkflowApplied({ - workflow_id: data.workflow_id, - target: 'active_tab_open' - }) + if (bound) await openBoundAgentTab(data, bound, stale) + else await openNewAgentTab(data, stale) } catch (error) { if (stale()) return bindWorkflow(data.workflow_id) diff --git a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts index 1c2323386bf..a6904f4a39f 100644 --- a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts +++ b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts @@ -526,31 +526,34 @@ export function useAgentSession(deps: AgentSessionDeps) { } } - function recordSendError( - error: unknown, - text: string, - accepted: boolean - ): boolean { + function recordAdmissionSendError(error: unknown, text: string): boolean { const admission = parseAdmissionError(error) - if (admission?.reason === 'no_funds') { + if (admission === undefined) return false + if (admission.reason === 'no_funds') { conversationStore.recordPaywall( nextLocalErrorId(), text, admission.message ) - return false - } - if (admission !== undefined) { - conversationStore.recordFailedSend( - nextLocalErrorId(), - text, - admission.message, - admission.reason === 'funds_unavailable' - ? admission.retryAfterSeconds - : undefined - ) - return false + return true } + conversationStore.recordFailedSend( + nextLocalErrorId(), + text, + admission.message, + admission.reason === 'funds_unavailable' + ? admission.retryAfterSeconds + : undefined + ) + return true + } + + function recordSendError( + error: unknown, + text: string, + accepted: boolean + ): boolean { + if (recordAdmissionSendError(error, text)) return false const message = error instanceof AgentApiError ? error.message @@ -600,6 +603,23 @@ export function useAgentSession(deps: AgentSessionDeps) { if (rememberedWorkflowId === sent.id) rememberedWorkflowId = null } + function handleSendFailure( + error: unknown, + text: string, + generation: number, + sentContext: WorkflowTurnContext | undefined, + accepted: boolean, + requestStarted: boolean + ): boolean { + releaseDisownedWorkflow(sentContext, error) + if (generation !== loadGeneration) return false + return recordSendError( + error, + text, + accepted || (requestStarted && isUnreadableAckFailure(error)) + ) + } + async function performSend( text: string, attachments?: SentAttachment[], @@ -643,12 +663,13 @@ export function useAgentSession(deps: AgentSessionDeps) { // Before the generation guard: the binding store is page-global and // persisted, so a refusal that lands after newChat()/loadThread() has // moved on still has to release, or the dead id survives the reload. - releaseDisownedWorkflow(sentContext, error) - if (generation !== loadGeneration) return false - return recordSendError( + return handleSendFailure( error, text, - accepted || (requestStarted && isUnreadableAckFailure(error)) + generation, + sentContext, + accepted, + requestStarted ) } } From aa7e3a5c29f375b26b30412dc894e4cb6e7e76d7 Mon Sep 17 00:00:00 2001 From: bymyself Date: Tue, 29 Sep 2026 19:07:55 -0700 Subject: [PATCH 5/7] refactor(agent): simplify malformed event handling Addresses review feedback:\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19496#discussion_r4139518447\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19496#discussion_r4139518462 --- .../composables/agent/useAgentSession.ts | 34 ++++++++++++------- 1 file changed, 21 insertions(+), 13 deletions(-) diff --git a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts index a6904f4a39f..843fad6cbdf 100644 --- a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts +++ b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts @@ -819,28 +819,36 @@ export function useAgentSession(deps: AgentSessionDeps) { if (hydrated && isCurrent()) conversationStore.resumeBackgroundTurn() } + function malformedEventTurnId(raw: object): TurnId | undefined { + const messageId = (raw as { data?: { message_id?: unknown } }).data + ?.message_id + return typeof messageId === 'string' ? (messageId as TurnId) : undefined + } + + function settleMalformedDoneEvent( + type: string, + turnId: TurnId | undefined + ): AgentErrorMetadata['ui_treatment'] { + if (type !== 'agent_message_done') return 'none' + if (turnId !== undefined && turnId !== conversationStore.activeTurnId) { + conversationStore.settleBackgroundTurn(turnId) + return 'none' + } + conversationStore.abortActiveTurn() + return 'error_overlay' + } + function handleMalformedEvent( raw: object, type: string, error: ZodError ): void { - const messageId = (raw as { data?: { message_id?: unknown } }).data - ?.message_id - const turnId = - typeof messageId === 'string' ? (messageId as TurnId) : undefined + const turnId = malformedEventTurnId(raw) const reportedTurnId = turnId !== undefined && conversationStore.hasPendingTurn(turnId) ? turnId : conversationStore.activeTurnId - let uiTreatment: AgentErrorMetadata['ui_treatment'] = 'none' - if (type === 'agent_message_done') { - if (turnId === undefined || turnId === conversationStore.activeTurnId) { - conversationStore.abortActiveTurn() - uiTreatment = 'error_overlay' - } else { - conversationStore.settleBackgroundTurn(turnId) - } - } + const uiTreatment = settleMalformedDoneEvent(type, turnId) if ( trackMalformedStreamEvent(error, type, reportedTurnId, uiTreatment) && uiTreatment === 'error_overlay' From 053578967d6bb8b868d602568093ae65bc05ad38 Mon Sep 17 00:00:00 2001 From: bymyself Date: Tue, 29 Sep 2026 19:47:16 -0700 Subject: [PATCH 6/7] fix(agent): harden accepted-turn recovery Addresses review feedback:\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19539#discussion_r4140288809\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19539#discussion_r4140288814\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19539#discussion_r4140288819\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19539#discussion_r4140288824\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19539#discussion_r4140288837\nhttps://github.com/Comfy-Org/ComfyUI_frontend/pull/19539#discussion_r4140288842 --- .../composables/agent/useAgentSession.test.ts | 14 +++----- .../composables/agent/useAgentSession.ts | 34 +++++++++---------- .../agent/services/agent/agentRestClient.ts | 16 ++++++--- 3 files changed, 32 insertions(+), 32 deletions(-) diff --git a/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts b/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts index 9a22f725f7a..031f07cb61a 100644 --- a/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts +++ b/src/workbench/extensions/agent/composables/agent/useAgentSession.test.ts @@ -2784,17 +2784,11 @@ describe('app:agent_error telemetry (TEL-8)', () => { const [error, options] = vi.mocked(reportError).mock.calls[0] expect((error as Error).message).toBe('Malformed agent stream event') expect(options.tags?.event_type).toBe('agent_message_done') - expect(options.context?.issues).toEqual( - expect.arrayContaining([ - expect.objectContaining({ - code: expect.any(String), - path: expect.any(Array), - message: expect.any(String) - }) - ]) + expect(options.context?.issue_count).toEqual(expect.any(Number)) + expect(options.context?.issue_codes).toEqual( + expect.arrayContaining([expect.any(String)]) ) - for (const issue of (options.context?.issues ?? []) as object[]) - expect(Object.keys(issue).sort()).toEqual(['code', 'message', 'path']) + expect(options.context).not.toHaveProperty('issues') }) it('reports a rejected send to the unified error sinks', async () => { diff --git a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts index 843fad6cbdf..b44a39a96ab 100644 --- a/src/workbench/extensions/agent/composables/agent/useAgentSession.ts +++ b/src/workbench/extensions/agent/composables/agent/useAgentSession.ts @@ -225,18 +225,17 @@ export function useAgentSession(deps: AgentSessionDeps) { if ( !malformedStreamReports.has(turnId) && malformedStreamReports.size >= 32 - ) - return false + ) { + const oldest = malformedStreamReports.keys().next().value + if (oldest !== undefined) malformedStreamReports.delete(oldest) + } malformedStreamReports.set(turnId, visible) reportError(new Error('Malformed agent stream event'), { errorType: 'agent_malformed_stream_event', tags: { ui_treatment: uiTreatment, event_type: eventType }, context: { - issues: cause.issues.slice(0, 10).map(({ code, path, message }) => ({ - code, - path, - message - })) + issue_count: cause.issues.length, + issue_codes: cause.issues.slice(0, 10).map(({ code }) => code) } }) trackAgentError( @@ -565,12 +564,8 @@ export function useAgentSession(deps: AgentSessionDeps) { text, `${i18n.global.t('agent.sendFailed')}: ${message}` ) - const turnAccepted = accepted || isUnreadableAckFailure(error) - const disowned = - error instanceof AgentApiError && - error.status === 403 && - zDisownedWorkflowError.safeParse(error.body).success - if (!disowned) + const turnAccepted = accepted + if (!disownsWorkflow(error)) reportError(error, { errorType: 'agent_send_message_failed' }) trackAgentError( 'request_failed', @@ -656,6 +651,9 @@ export function useAgentSession(deps: AgentSessionDeps) { selectionWorkflowId ) accepted = true + // Navigation invalidates the originating submission before advancing the + // generation. The server still accepted this turn, so reporting success + // prevents a future caller from offering a duplicate non-idempotent send. if (generation !== loadGeneration) return true acceptTurn(ack, text, wfContext, attachments, tags, workflowReferences) return true @@ -830,12 +828,14 @@ export function useAgentSession(deps: AgentSessionDeps) { turnId: TurnId | undefined ): AgentErrorMetadata['ui_treatment'] { if (type !== 'agent_message_done') return 'none' - if (turnId !== undefined && turnId !== conversationStore.activeTurnId) { + if (turnId === undefined || turnId === conversationStore.activeTurnId) { + conversationStore.abortActiveTurn() + return 'error_overlay' + } + if (conversationStore.hasPendingTurn(turnId)) { conversationStore.settleBackgroundTurn(turnId) - return 'none' } - conversationStore.abortActiveTurn() - return 'error_overlay' + return 'none' } function handleMalformedEvent( diff --git a/src/workbench/extensions/agent/services/agent/agentRestClient.ts b/src/workbench/extensions/agent/services/agent/agentRestClient.ts index 1f12cd1a418..5c29c2ce944 100644 --- a/src/workbench/extensions/agent/services/agent/agentRestClient.ts +++ b/src/workbench/extensions/agent/services/agent/agentRestClient.ts @@ -384,11 +384,17 @@ export function createAgentRestClient() { if (req.draft !== undefined) body.draft = { content: req.draft.content } if (req.currentTabUnbound !== undefined) body.current_tab_unbound = req.currentTabUnbound - return request( - `/agent/threads/${encodeURIComponent(threadId)}/messages`, - jsonInit('POST', body), - zAgentTurnAccepted - ) + try { + return await request( + `/agent/threads/${encodeURIComponent(threadId)}/messages`, + jsonInit('POST', body), + zAgentTurnAccepted + ) + } catch (error) { + if (error instanceof Error && error.name === 'AbortError') + throw new AgentResponseUnreadableError(error) + throw error + } } async function getMessages(threadId: string): Promise { From fa56ec979b7e7bde55444c8e668c547a31342f1c Mon Sep 17 00:00:00 2001 From: bymyself Date: Tue, 29 Sep 2026 19:55:01 -0700 Subject: [PATCH 7/7] refactor(agent): simplify message request construction --- .../agent/services/agent/agentRestClient.ts | 36 ++++++++++--------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/src/workbench/extensions/agent/services/agent/agentRestClient.ts b/src/workbench/extensions/agent/services/agent/agentRestClient.ts index 5c29c2ce944..62acb4569a8 100644 --- a/src/workbench/extensions/agent/services/agent/agentRestClient.ts +++ b/src/workbench/extensions/agent/services/agent/agentRestClient.ts @@ -329,6 +329,24 @@ function asDelaySeconds(seconds: number): number | undefined { return Number.isSafeInteger(seconds) && seconds >= 0 ? seconds : undefined } +function buildPostMessageBody(req: PostMessageInput): AgentPostMessageRequest { + const body: AgentPostMessageRequest = { content: req.content } + if (req.workflowId !== undefined) body.workflow_id = req.workflowId + if (req.tabs !== undefined) { + body.open_tabs = req.tabs.open_tabs + if (req.tabs.current_tab !== undefined) + body.current_tab = req.tabs.current_tab + } + if (req.workflowReferences !== undefined) + body.workflow_references = req.workflowReferences + if (req.selection !== undefined) body.selection = req.selection + if (req.attachments !== undefined) body.attachments = req.attachments + if (req.draft !== undefined) body.draft = { content: req.draft.content } + if (req.currentTabUnbound !== undefined) + body.current_tab_unbound = req.currentTabUnbound + return body +} + export function createAgentRestClient() { async function toApiError(response: Response): Promise { const body = parseErrorBody(await response.text()) @@ -368,26 +386,10 @@ export function createAgentRestClient() { threadId: string, req: PostMessageInput ): Promise { - const body: AgentPostMessageRequest = { - content: req.content - } - if (req.workflowId !== undefined) body.workflow_id = req.workflowId - if (req.tabs !== undefined) { - body.open_tabs = req.tabs.open_tabs - if (req.tabs.current_tab !== undefined) - body.current_tab = req.tabs.current_tab - } - if (req.workflowReferences !== undefined) - body.workflow_references = req.workflowReferences - if (req.selection !== undefined) body.selection = req.selection - if (req.attachments !== undefined) body.attachments = req.attachments - if (req.draft !== undefined) body.draft = { content: req.draft.content } - if (req.currentTabUnbound !== undefined) - body.current_tab_unbound = req.currentTabUnbound try { return await request( `/agent/threads/${encodeURIComponent(threadId)}/messages`, - jsonInit('POST', body), + jsonInit('POST', buildPostMessageBody(req)), zAgentTurnAccepted ) } catch (error) {