Skip to content

Implement structured output across multiple agents and phases#2660

Open
robgruen wants to merge 52 commits into
mainfrom
dev/robgruen/structured_output
Open

Implement structured output across multiple agents and phases#2660
robgruen wants to merge 52 commits into
mainfrom
dev/robgruen/structured_output

Conversation

@robgruen

@robgruen robgruen commented Jul 14, 2026

Copy link
Copy Markdown
Collaborator

This pull request introduces a comprehensive "structured output" system for agent display content, enabling agents to return rich, semantically-typed documents (tables, lists, cards, images, etc.) with automatic markdown/text fallbacks for legacy clients. It adds a new StructuredContent type and related block types to the SDK, a builder function for creating structured results, and supporting helpers. The changes also include test scaffolding and documentation of the rollout plan and status.

The most important changes are:

Structured Output System (Core Types & Helpers):

  • Added StructuredContent and a suite of typed block interfaces (e.g., TableBlock, ListBlock, CardBlock, etc.) to display.ts, allowing agents to describe UI output as a semantic block document with optional machine-readable payloads and automatic markdown/text alternates.
  • Added the createStructuredResult helper to actionHelpers.ts for constructing action results with structured content, including automatic fallback and memory text derivation.
  • Updated imports and exports throughout the SDK to support the new structured output system, including exporting block types and helpers. [1] [2]

Testing Infrastructure:

  • Added a jest.config.cjs to the agent SDK package and new npm scripts in package.json to enable local and ESM-mode Jest testing for agent builders and derivation logic. [1] [2]

Documentation and Planning:

  • Added a detailed status and rollout tracker for structured output in docs/plans/structured-output/STATUS.md, covering phases, agent adoption, test coverage, and open questions.

Copilot AI and others added 27 commits July 11, 2026 18:35
@robgruen

Copy link
Copy Markdown
Collaborator Author

@copilot resolve the merge conflicts in this pull request

@robgruen

Copy link
Copy Markdown
Collaborator Author

@copilot resolve the merge conflicts in this pull request

Copilot AI commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

Resolved in 77385dc.

Copilot AI commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

I checked this branch against main, and there isn’t a merge conflict to resolve right now: the PR head already contains the current main base commit (71bf96b), and a local merge of origin/main reports Already up to date. GitHub currently shows the PR as blocked rather than conflicting.

@robgruen
robgruen enabled auto-merge July 18, 2026 00:04
@robgruen

Copy link
Copy Markdown
Collaborator Author

@copilot resolve the merge conflicts in this pull request

Copilot AI commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

Done in 834dd14 (merge conflict resolution) and 2c26e6d (lockfile sync after merge).

@robgruen

Copy link
Copy Markdown
Collaborator Author

@copilot resolve the merge conflicts in this pull request

Copilot AI commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

Resolved by merging origin/main and fixing the conflicts in commit 296dbc72.

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.

4 participants