refactor(runtime): extract computer-use wire codec and contract types from computer-use-tools.ts

(2 commenti) (0 reazioni) (1 assegnatario)TypeScript (0 fork)github user discovery

enhancementgood first issue

Metriche repository

Star: (1 stella)
Metriche merge PR: (Metriche PR in attesa)

Descrizione

Part of #1084 (second-pass sink-file and boundary governance). Scope re-verified against current main (computer-use-tools.ts, 1836 lines).

Scope

Extract the wire-protocol codec into computer-use-codec.ts, mirroring the existing openai-computer-codec.ts pattern: the computerParams zod discriminated union (~L230+), snapshotComputerParams (~L469), adaptToCuAction (~L496), and summarize (~L590) if its call surface allows.
Move the contract types into computer-use-types.ts so adapters stop importing the implementation file: CuRunResult, CuDispatchBackend, CuDispatchOutcome, CuDispatchEvidence, CuScreenshot, CuObservation, CuSemanticAction, CuRunContext, and the overlay hooks.
buildComputerUseTools stays in computer-use-tools.ts.

Invariants

Same as #1084: behavior-neutral; keep @maka/runtime public exports stable via re-exports; no reverse imports from new leaf files; flat PR off main.

Verification

Typecheck/build + existing computer-use tests.

Guida contributor

Direzione di ricerca: Identifica le sezioni di codice menzionate in computer use tools.ts (circa L230, L469, L496, L590), estraile nei nuovi file computer use codec.ts e computer use types.ts, assicurandoti che le esportazioni pubbliche siano re esportate da index.ts o equivalente. Segui il modello di openai computer codec.ts. Esegui il typecheck e i test.
Tech stack: typescript
Dominio: backend
Tipo issue: Refactoring
Difficoltà: 3
Tempo stimato: Mezza giornata
Stato attività: Nuova
Chiarezza: Chiara
Prerequisiti: TypeScript
Adatta ai principianti: 70