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

MCP: add a structured Cloudflare Workers summary to inspect_span

Abierto
  • ¿Algo no está bien?
#1,874 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
42/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
typescript
Área
ai, observability

Línea de trabajo

Start with the UI Cloudflare adapter in packages/ui/src/lib/cloud-platforms/cloudflare.ts to see how it detects Workers and maps fields, then read apps/ai/src/mcp/tools/inspect-span.ts for the raw attribute output. The change moves detection and mapping into shared pure logic and adds an optional Workers section to the MCP result. Done means tests cover missing fields, zero timing values, and a renamed custom span that keeps its stored name and IDs, and the guidance text covers the clock, sampling, and propagation limits.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Problem

Maple's web UI already interprets Cloudflare Workers attributes, but MCP inspect_span exposes those fields as raw span/resource attribute maps. An agent must repeatedly work out which fields identify the script, version, execution region, CPU time, wall time, TTFB, and Ray ID.

A compact structured Cloudflare summary would make incident analysis more consistent and reduce the amount of attribute interpretation each agent must do.

Existing support and code

Maple already documents native Workers OTLP destinations. Checked against main at 7edfccb17c3f524f9d793e0a11893fcf0535737e:

  • The UI Cloudflare adapter detects Workers and displays script/version, handler, execution model, CPU/wall time, TTFB, colo/region, location, outcome, and Ray ID.
  • inspect_span provides raw attributes and a special decoded view for AI spans.

Proposed change

Add an optional Cloudflare Workers section to the structured and text output of inspect_span. Align its detection and field mapping with the existing UI adapter, preferably through shared pure logic that has no UI dependency.

Include fields when present: script name/version, handler, execution model, colo/region, CPU time in ms, wall time in ms, TTFB in ms, outcome, and Ray ID. Preserve the full raw attribute maps. Missing fields should stay missing; zero is a valid timing value.

Add concise Workers-specific interpretation notes to MCP guidance:

  • Zero-duration spans can result from the Workers clock advancing on I/O; they do not prove that no CPU work occurred.
  • A trace ID in a log or response does not guarantee that spans were stored. Logs can retain IDs when tracing is disabled or a request is not sampled.
  • The current spanContext().traceFlags value does not reflect head sampling and must not be used to construct downstream traceparent headers.
  • Automatic trace-context propagation has limits; missing downstream spans do not prove that no downstream call occurred.

Relation to the latest Cloudflare update

The October 26, 2026 update adds spanContext(), setStatus(), and updateName(). It makes native custom spans easier to identify and interpret. The summary should retain the stored operation name and trace/span IDs so an agent can correlate an application-supplied ID with its renamed operation and Cloudflare context.

The requested Cloudflare summary builds on existing exported attributes. Those attributes predate this update. Generic single-span status exposure is tracked separately in #1873. This Cloudflare summary can be implemented independently.

References: Cloudflare custom-span API and limits, Maple's documented Workers caveats.

Acceptance criteria

  • A native Workers span has a consistent Cloudflare summary in MCP and the web UI.
  • Non-Cloudflare spans retain their current response; empty projected cloudflare.* keys do not cause false detection.
  • Tests cover missing fields, zero timing values, and Cloudflare context supplied through span/resource attributes.
  • A fixture with a renamed custom span retains its stored name and IDs through the MCP result.
  • MCP guidance explains the clock, sampling, and propagation limits without claiming that sampling or a root cause can be determined from those fields alone.

Evidence: source and documentation inspection. A live Cloudflare-to-Maple export has not been tested for this report.

Lenguaje dominante
TypeScript
Estrellas
1.8k
Forks
120
Merge medio
8 h 11 min
PR fusionados (30 d)
667

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

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 MapleTechLabs/maple

Todos los issues de MapleTechLabs/maple

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.