Skip to content

docs(spec): use canonical TaskState enum name in Input Required prose - #2155

Open
madankumarpichamuthu wants to merge 4 commits into
a2aproject:mainfrom
madankumarpichamuthu:docs/1408-taskstate-prose-consistency
Open

madankumarpichamuthu wants to merge 4 commits into
a2aproject:mainfrom
madankumarpichamuthu:docs/1408-taskstate-prose-consistency

Conversation

@madankumarpichamuthu

@madankumarpichamuthu madankumarpichamuthu commented Aug 19, 2026 •

Copy link
Copy Markdown
Contributor

Description

Follow-up to #1408. When #1408 was filed, the section 6 JSON examples used the old v0.3.0 kebab-case task states. Those examples have since been corrected to the ProtoJSON TASK_STATE_* form, but one prose reference was missed:

Input Required State:

  • Agents can request additional input mid-processing by transitioning a task to the input-required state

The normative TaskState enum (§4.1.3) and every JSON example in §6 use TASK_STATE_INPUT_REQUIRED. This aligns the remaining prose reference with that canonical form so the specification uses one consistent spelling.

Scope kept intentionally narrow to docs/specification.md. Conceptual topic pages (e.g. Life of a Task, Streaming) still use the short input-required phrasing as readable prose; those are left untouched to avoid a broader style change. If maintainers consider #1408 already resolved by the earlier example fixes, this PR can simply close it out.

Checklist

  • Follow the CONTRIBUTING Guide.
  • Conventional Commit title (docs(spec): for specification.md).
  • Linter passes.

Closes #1408

The Input Required State description in section 3 referred to the state as
`input-required` (the v0.3.0 kebab-case form) while the normative TaskState
enum and all section 6 JSON examples use the ProtoJSON SCREAMING_SNAKE_CASE
name. Align the prose with `TASK_STATE_INPUT_REQUIRED` so the specification
uses one consistent form.

Refs a2aproject#1408
@madankumarpichamuthu
madankumarpichamuthu requested a review from a team as a code owner August 19, 2026 21:50

This branch has not been deployed

No deployments
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.

[Bug]: Inconsistent definition of TaskState

1 participant