[Bug]: t3_thread_read drops the typed failure (usage_limit class and resetAt) on error items

Offen Anfängerfreundlich
  • Stimmt etwas nicht?
#35,270 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Anfängerfreundlichkeit
75/100
Issue-Typ
Bug
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
typescript
Bereich
backend-api-design

Rechercherichtung

Beginne mit den MCP-Verträgen in packages/contracts/src/orchestratorMcp.ts sowie mit timelineItem() und dem Thread-Detail-Builder in apps/server/src/mcp/OrchestratorMcpService.ts. Verfolge, wie das Fehler-Element und die Felder des Thread-Shells in die Antwort übernommen werden, und prüfe anschließend die vorhandenen MCP-Vertrags- und Service-Tests. Die Aufgabe ist abgeschlossen, wenn t3_thread_read bei Fehler-Elementen und Thread-Details die typisierte Fehlerklasse und den Zeitpunkt des Zurücksetzens ausgibt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

Before submitting
  • I searched existing issues and did not find a duplicate. (#31057 is about limited children resuming on the wrong account; it is not this.)
  • I included enough detail to reproduce or investigate the problem.
Area

apps/server: the orchestrator MCP read (t3_thread_read)

Steps to reproduce
  1. Start a thread on a provider that is out of usage. Seen with Codex, which fails the turn with usageLimitExceeded.
  2. The turn fails. T3's own store holds the typed failure on the error item: in orchestration_v2_projection_turn_items, failure = { class: "usage_limit", code: "usageLimitExceeded", resetAt: "<ISO>" }. The thread shell's lastErrorClass and usageLimitResetAt are set from it (threadErrorSummary).
  3. Read the thread through MCP: t3_thread_read with view: "activity", and the default view.
Expected behavior

An MCP client can tell a usage-limit failure, and its reset time, from any other failure using typed fields, without reading the human-readable message. One of these:

  • OrchestratorMcpThreadTimelineItem for type: "error" carries failure: { class, code, resetAt }, or at least failureClass and resetAt;
  • the thread object returned by t3_thread_read carries lastErrorClass and usageLimitResetAt, as the shell projection already does.
Actual behavior

The error item comes back with type, status, title, text and ids only. failure reaches the client only as text, because turnItemText returns item.failure.message for case "error" (apps/server/src/mcp/OrchestratorMcpService.ts, timelineItem(), at ac781dcb). The thread object has no lastErrorClass or usageLimitResetAt.

Claude limits are visible, because they also produce a system_notice whose item id ends usage-limit:…:<window>:<reset epoch seconds>. Codex limits produce only the error item, so through MCP a Codex usage limit looks like any other failed turn.

Impact

An MCP client that orchestrates agents cannot treat a usage limit as a wait without parsing English error text. It sees a plain failure, and may fail or relaunch work that T3's own UsageLimitRecoveryWorker would resume at resetAt. The fix is small: add the typed fields to the MCP timeline item and thread contracts in packages/contracts/src/orchestratorMcp.ts, then fill them in timelineItem() and the thread detail builder.

Version or commit

main at 59118847; OrchestratorMcpService.ts last changed in ac781dcb.

Environment

T3 server on Linux, threads started over MCP.

Logs or stack traces

The error item's text on the Codex thread: "You've hit your usage limit. Visit https://chatgpt.com/settings/usage to purchase more credits or try again at Nov 17th, 2026 7:32 PM."

— Model: claude-opus-5-5 · Harness: Claude Code (T3 Code)

Vorherrschende Sprache
TypeScript
Sterne
24.8k
Forks
6.4k
Ø Merge
4 Std. 16 Min.
Gemergte PRs (30 T.)
352

Entwicklungsumgebung

In Codespaces öffnen

Startet den Dev-Container des Projekts im Browser, mit Ihrem eigenen GitHub-Konto.

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus pingdotgg/t3code

Alle Issues in pingdotgg/t3code

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.