jackwener/maka-agent

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

Fermée

#1 405 ouverte le 23 juil. 2026

Voir sur GitHubGuide contributeur
 (2 commentaires) (0 réaction) (1 personne assignée)TypeScript (0 fork)github user discovery
enhancementgood first issue

Métriques du dépôt

Stars
 (1 étoile)
Métriques de merge PR
 (Métriques PR en attente)

Description

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.

Guide contributeur

Direction de recherche
Identifiez les sections de code mentionnées dans computer use tools.ts (environ L230, L469, L496, L590), extrayez les dans les nouveaux fichiers computer use codec.ts et computer use types.ts, en vous assurant que les exportations publiques sont réexportées depuis index.ts ou équivalent. Suivez le modèle de openai computer codec.ts. Exécutez la vérification de type et les tests.
Stack technique
typescript
Domaine
backend
Type d'issue
Refactorisation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
3
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Une demi journée
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Récente
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
TypeScript
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
70