apache / apache/maka

[A06] Tool Runtime refactoring discussion and implementation plan

Open
#4,909 4 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
5.4k
Forks
502
Avg merge
1d 2h
Merged PRs (30d)
715

Description

## Purpose

This issue is the discussion and coordination entry point for A06 from [monthly cleanup issue #4726](https://github.com/apache/maka/issues/4726).

A06 covers:

- `packages/runtime/src/tool-runtime.ts`
- `packages/runtime/src/computer-use-tools.ts`

The current checkout contains 7,063 lines across these two files. The goal is to reduce structural duplication and clarify ownership through several small, reviewable refactoring slices.

This work does not add product capabilities. Each implementation slice must preserve public APIs, provider behavior, event formats, and existing runtime semantics.

The overall analysis and proposed target architecture are recorded in the second comment. Implementation work is tracked through linked child issues.

## Child issues

- [#4908 — Extract the existing tool-call snapshot and centralize argument projections](https://github.com/apache/maka/issues/4908)

Additional child issues will be added after each boundary is reviewed.

Contributor guide

Open the contributing guide

Research direction

Read the second comment for the proposed target architecture, then inspect packages/runtime/src/tool-runtime.ts and packages/runtime/src/computer-use-tools.ts. Start with child issue #4908 to understand the first implementation slice; done means each reviewed slice preserves public APIs, provider behavior, event formats, and existing runtime semantics.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
backend
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.