Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Turn protocol v1 parts into the old stream format, for widgets before 0.6

Cerrado
  • ¿Algo no está bien?
#240 2 comentarios 0 reacciones 1 asignado Ver en GitHub

Los mantenedores suelen responder en 1 día

@Saifjafri212213 ya está trabajando en esto.

Desde el 20/10/2026.

  • #259 de @Saifjafri212213 — fusionado

Evaluación

Este issue todavía no se ha evaluado.

Descripción

core enhancement good first issue hacktoberfest

The 0.6 server streams typed parts (WirePart, in packages/core/src/protocol/v1.ts), but widgets on 0.5 and older read chunks like {"content":"Hi"} and {"done":true}. Those widgets will stay on sites and CDNs for months, so the server needs to translate. This issue is that translation, as one pure function.

What to do
Create packages/core/src/protocol/legacy.ts:

export interface LegacyChunk {
  content?: string;
  done?: boolean;
  error?: string;
  retryAfter?: number;          // seconds
  leadCaptured?: boolean;
  leadData?: Record<string, unknown>;
  suggestedActions?: string[];
}

/** The chunk an old widget expects for this part, or null for parts it has no use for. */
export function toLegacyChunk(part: WirePart): LegacyChunk | null;
v1 part Legacy chunk
text-delta { content: delta }
lead-captured { leadCaptured: true, leadData: lead }
suggestions { suggestedActions: items }
error with rate_limited { error: 'rate_limit', retryAfter }, with retryAfter = retryAfterMs rounded up to seconds, left out when there's none
error with timeout { error: 'timeout' }
error with internal_error { error: 'internal_error' }
error with invalid_request { error: 'Invalid request' } (what 0.5 servers send)
error with any other code { error: 'provider_error' }
finish with reason error or aborted null (the error part already went out, or nobody is listening)
finish with any other reason { done: true }
everything else (start, text-start, text-end, source, tool-call, tool-result, handoff, agent-message) null

Those error strings are the ones the 0.5 widget understands (packages/widget/src/widget.ts, resolveErrorType, line 643).

Where to look

  • packages/core/src/protocol/v1.ts (the part types)
  • packages/server/src/handler.ts, which writes the old chunks today (lines 51, 61, 71, 181, 209, 223, 250)

Acceptance criteria

  • New packages/core/src/protocol/legacy.ts, exported from packages/core/src/protocol/index.ts and from @chatcops/core
  • One test per row of the table, plus retryAfterMs: 1500 becoming retryAfter: 2
  • A test that runs a whole v1 stream through it and gets the exact chunks a 0.5 server sends for the same reply
  • Changeset for @chatcops/core (minor)
  • pnpm test:coverage and pnpm lint pass

Want to work on this? Comment below and I'll assign it to you. Please take one issue at a time, branch off dev, and open your PR against dev with Closes #<this issue number>. Setup notes (pnpm, build before test) are in CONTRIBUTING.md.

Lenguaje dominante
TypeScript
Estrellas
13
Forks
7
Merge medio
3 h 41 min
PR fusionados (30 d)
155

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de codercops/chatcops

Todos los issues de codercops/chatcops

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.