Repository navigation
refactor(runtime): decompose ai-sdk-backend.ts (4874 lines, 6 concerns) #3909
Description
Activity
I’d like to take the remaining tool-schema-builder slice of #3909, against current
mainafter #4779.Plan:
- extract tool-mode validation, availability projection, AI SDK provider/function schema binding, and Code Mode nested-schema validation from
ai-sdk-turn.tsintotool-schema-builder.ts; - keep tool execution and settlement in
AiSdkTurnandToolRuntime; - add focused direct tests for direct/Code Mode surfaces, provider-native versus function bindings, nesting eligibility, diagnostics, and input validation;
- preserve existing behavior and introduce no new dependency cycles.
#4779 has already reduced
ai-sdk-backend.tsbelow 2,000 lines and extracted several major responsibilities, so this PR will useRefs #3909and will not claim to close the entire tracking issue.中文对照：
我想认领 #3909 中尚未完成的 tool-schema-builder 小切片，基于 #4779 合并后的最新
main。计划：
- 从
ai-sdk-turn.ts中抽出工具模式校验、可用工具投影、AI SDK provider/function schema 绑定，以及 Code Mode 嵌套工具参数校验； - 工具执行与结果结算仍由
AiSdkTurn和ToolRuntime负责； - 为 direct/Code Mode 工具面、原生 provider 工具与 function 工具绑定、嵌套资格、诊断数据和参数校验增加独立测试；
- 保持现有行为，不引入新的依赖循环。
- extract tool-mode validation, availability projection, AI SDK provider/function schema binding, and Code Mode nested-schema validation from
Closing this as an issue for now: the direction has not been confirmed by a maintainer, and the tracker only keeps proposals that already have an agreed scope. Please continue it in GitHub Discussions (https://github.com/apache/maka/discussions); once the shape and acceptance criteria are settled there, open an issue with that scope and it will be picked up.
- added a commit that references this issue
on Oct 11, 2026
Summary
packages/runtime/src/ai-sdk-backend.tsis 4,874 lines mixing provider adapter, tool schema building, prompt assembly, tool call settlement, streaming projection, and image overflow recovery in a single file.Evidence
packages/runtime/src/ai-sdk-backend.ts:21-39— docstring describes 6 concernsBackendFactoryinterface is the natural seam — the adapter orchestrates the stream pipeline but currently owns every supporting functionProposed Decomposition
ai-sdk-backend.ts— stream pipeline orchestration onlytool-schema-builder.ts— tool schema binding and provider-specific adaptationsprovider-request-capture.ts— provider request projection and background task managementimage-overflow-handler.ts— image overflow recovery for vision-capable providersAcceptance Criteria
ai-sdk-backend.tsis under 2,000 linesLabels
refactor, help wanted