Update types to @ag-ui/core 1.0
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 70/100
- Issue type
- Refactor
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- nodejs, typescript
- Domain
- backend-api-design, tooling
Research direction
Start by updating the dependency in packages/ai/package.json and running pnpm install. Then, examine packages/ai/src/types.ts to see how AG-UI event types are imported and extended. Add the three new subagent event types to the AGUIEvent union and update EventType in src/client.ts. Update spec-event-keys.ts to include the new keys. Run pnpm test:types and pnpm test:build to verify changes, and add a unit test for toWireChunk as described. Finally, create a changeset for @tanstack/ai.
Written by the indexing model from the issue text.
Description
Task
Bump @ag-ui/core in packages/ai from 0.1.1-canary.beta.0 to 1.0.0 and source the AG-UI event types from the package instead of hand-written copies.
Why
packages/ai/src/types.tsalready imports every AG-UI event type from@ag-ui/coreand declares the local events withextends. The three subagent events in PR #1438 are the exception because the pinned canary predates them.@ag-ui/core@1.0.0(published 2026-09-17) shipsSubagentStartedEvent,SubagentFinishedEvent,SubagentErrorEvent,SubagentInfo,SubagentRunId, theAttributable(subagentRunId) mixin, andSUBAGENT_*members onEventType.- The Zod reason for avoiding the package is gone: 1.0.0 has no
dependencies, zod is an optional peer at^3.25.18 || ^4.0.0, and the main entry does not import zod. Only the/schemassubpath does, and we do not use it. This is the layout PR #1038 adopted via the canary. - Renovate will not offer this bump because the pin is a prerelease.
Scope
- Bump the pin in
packages/ai/package.jsonand regeneratepnpm-lock.yaml. - Fix any type errors from event shapes that changed between the canary and 1.0.0. Keep the repo's own event interfaces as
extendsof the imported ones, with the same optionality as the spec (never stricter). - Add
SubagentStartedEvent,SubagentFinishedEvent,SubagentErrorEventto theAGUIEventunion inpackages/ai/src/types.tsasextendsof the package types, and add theSUBAGENT_*entries to theEventTypere-export inpackages/ai/src/client.ts. - Add the three event types and their spec keys (
subagentRunId,name,description,parentSubagentRunId,parentToolCallId,parentMessageId,result,outcome,message,code) topackages/ai/src/utilities/spec-event-keys.ts, andsubagentRunIdto every attributable event, sotoWireChunkdoes not move them intometadata.tanstack. - Changeset for
@tanstack/ai(patch or minor, your call; the publicStreamChunkunion gains three members). pnpm test:prgreen.
Out of scope: the subagent runtime (spawn, router, processor, client handles). That stays in #1438, which should rebase onto this once merged and delete its duplicate interfaces in spawn.ts and types.ts.
Verification
pnpm test:typesandpnpm test:buildpass.- A unit test pushes a
SUBAGENT_STARTEDevent and an attributedTEXT_MESSAGE_CONTENTthroughtoWireChunkand asserts the fields stay top-level. - Confirm
pnpm why zodshows no new zod path frompackages/ai.
Related: #520 (Zod 3 conflict, resolved by #1038 and can be closed), #1438 (subagents).
- Dominant language
- TypeScript
- Stars
- 3.1k
- Forks
- 331
- Avg merge
- 1d 10h
- Merged PRs (30d)
- 130
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from TanStack/ai
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
has-pr waiting-on: maintainer
-
waiting-on: maintainer
-
waiting-on: maintainer
-
waiting-on: maintainer
Similar issues
-
bug(cli): hapi doctor inline-media prints a fabricated B:\ helper-script path in packaged installs Open
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
-
Crush Open
Difficulty 1/5 Under an hour Newbie friendliness 85/100
catppuccin/catppuccin#3125 ·
-
Add a SECURITY.md Open
Difficulty 1/5 Under an hour Newbie friendliness 90/100
ElementsProject/cln-application#167 · 1 comment · 1 reaction ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Quantco/pnpm-licenses#17 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100