Skip to content

docs: AgentExecutor interface documentation#976

Open
bartek-w wants to merge 1 commit into1.0-devfrom
bartekw-auth
Open

docs: AgentExecutor interface documentation#976
bartek-w wants to merge 1 commit into1.0-devfrom
bartekw-auth

Conversation

@bartek-w
Copy link
Copy Markdown
Collaborator

Fixes #869 🦕

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request replaces TODOs in agent_executor.py with comprehensive documentation regarding the request lifecycle, concurrency, exception handling, and cancellation workflows. It also introduces a new integration test for the 'Auth Required' scenario. Feedback includes addressing a potential AttributeError in the new test when handling non-streaming responses, correcting a redundant method call in the documentation, and improving the phrasing of the framework's response behavior description.

Comment thread tests/integration/test_scenarios.py Outdated
Comment thread src/a2a/server/agent_execution/agent_executor.py Outdated
Comment thread src/a2a/server/agent_execution/agent_executor.py Outdated
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 16, 2026

🧪 Code Coverage (vs 1.0-dev)

⬇️ Download Full Report

No coverage changes.

Generated by coverage-comment.yml

@bartek-w bartek-w changed the title AgentExecutor interface documentation doc: AgentExecutor interface documentation Apr 16, 2026
@bartek-w bartek-w changed the title doc: AgentExecutor interface documentation docs: AgentExecutor interface documentation Apr 16, 2026
@bartek-w bartek-w requested a review from ishymko April 16, 2026 10:57
@bartek-w bartek-w marked this pull request as ready for review April 16, 2026 10:57
@bartek-w bartek-w requested a review from a team as a code owner April 16, 2026 10:57
Comment on lines +79 to +84
Cancellation Workflow & Interactions:
- **Framework Interaction**: The framework issues a cancellation to the asyncio Task
running `execute()` (which will raise `asyncio.CancelledError` inside `execute()`),
and awaits this `cancel()` method.
- **State Transition**: The `cancel()` method MUST publish a `TaskStatusUpdateEvent`
with `TaskState.TASK_STATE_CANCELED` to definitively end the task.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's already mentioned above?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants