Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Update types to @ag-ui/core 1.0

Aperta
#1,460 0 commenti 0 reazioni 1 assegnatario Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
70/100
Tipo di issue
Refactoring
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
nodejs, typescript

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

has-pr waiting-on: maintainer

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.ts already imports every AG-UI event type from @ag-ui/core and declares the local events with extends. 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) ships SubagentStartedEvent, SubagentFinishedEvent, SubagentErrorEvent, SubagentInfo, SubagentRunId, the Attributable (subagentRunId) mixin, and SUBAGENT_* members on EventType.
  • 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 /schemas subpath 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

  1. Bump the pin in packages/ai/package.json and regenerate pnpm-lock.yaml.
  2. Fix any type errors from event shapes that changed between the canary and 1.0.0. Keep the repo's own event interfaces as extends of the imported ones, with the same optionality as the spec (never stricter).
  3. Add SubagentStartedEvent, SubagentFinishedEvent, SubagentErrorEvent to the AGUIEvent union in packages/ai/src/types.ts as extends of the package types, and add the SUBAGENT_* entries to the EventType re-export in packages/ai/src/client.ts.
  4. Add the three event types and their spec keys (subagentRunId, name, description, parentSubagentRunId, parentToolCallId, parentMessageId, result, outcome, message, code) to packages/ai/src/utilities/spec-event-keys.ts, and subagentRunId to every attributable event, so toWireChunk does not move them into metadata.tanstack.
  5. Changeset for @tanstack/ai (patch or minor, your call; the public StreamChunk union gains three members).
  6. pnpm test:pr green.

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:types and pnpm test:build pass.
  • A unit test pushes a SUBAGENT_STARTED event and an attributed TEXT_MESSAGE_CONTENT through toWireChunk and asserts the fields stay top-level.
  • Confirm pnpm why zod shows no new zod path from packages/ai.

Related: #520 (Zod 3 conflict, resolved by #1038 and can be closed), #1438 (subagents).

Lingua principale
TypeScript
Stelle
3.1k
Fork
331
Merge medio
1g 10h
PR unite (30g)
130

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di TanStack/ai

Tutte le issue di TanStack/ai

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.