perf(tools): move mergeToolParameters into a registry-free leaf module

[waleedlatif1]

Stacked on #6151. Review that first; base retargets to staging once it merges.

Why

providers/utils.ts imports exactly one symbol from @/tools/params — mergeToolParameters. That function does no tool lookup at all; it merges two plain param objects.

But params.ts imports getTool from @/tools/utils, which statically imports the 4,300-entry @/tools/registry barrel. So that one-symbol import was dragging the entire tool registry — and every tool's HTTP closures, SDK clients and transitive deps — into every module graph that reached it.

Measurement

Module-graph walk from each entry (imports + re-exports, import type excluded):

entry	before	after
providers/utils.ts	4,926 (registry reachable)	22 (registry unreachable ✅)
tools/params.ts	4,926	4,927 (unchanged — still owns getTool)
tools/merge-params.ts	—	2 (registry unreachable ✅)

What moved

mergeToolParameters, deepMergeInputMapping and isNonEmpty → @/tools/merge-params, copied verbatim. The new module is documented as forbidden from importing @/tools/utils, @/tools/registry or @/tools/params.

params.ts now imports isNonEmpty from there; its isRecordLike and isEmptyTagValue imports became unused and are dropped. Both consumers (providers/utils.ts, executor/handlers/pi/sim-tools.ts) import the new module directly rather than through a re-export, per the no-re-exports rule.

This is preparation, not the payoff

The canvas route still reaches the registry through three other edges — block-outputs, serializer, and sanitization/validation. All four are redundant paths, so the route's module count does not move until all of them are cut. That happens in the metadata-manifest PRs stacked on top of this one.

Test plan

• vitest run tools/ providers/ executor/handlers/pi/ — 3,262 passed
• tsc --noEmit exit 0
• check:client-boundary, check:utils, check:boundaries pass
• biome clean

One pre-existing failure, executor/handlers/pi/cloud-review-tools.test.ts, is environmental — it shells out to a rg binary that isn't installed on this machine. Verified it fails identically on the base commit with these changes stashed.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Aug 1, 2026 6:03pm

[cursor]

PR Summary

Low Risk
Refactor-only import graph change with no intended behavior change; merge logic is copied verbatim and existing tests still cover mergeToolParameters.

Overview
Moves mergeToolParameters, deepMergeInputMapping, and isNonEmpty out of @/tools/params into a new @/tools/merge-params module (logic copied verbatim). params.ts only pulls in isNonEmpty from there and drops the unused isRecordLike / isEmptyTagValue imports.

providers/utils.ts and executor/handlers/pi/sim-tools.ts now import mergeToolParameters from merge-params instead of params, so callers that only need param merging no longer transitively load params.ts → getTool → the full @/tools/registry barrel. The new file is documented as forbidden from importing utils, registry, or params. params.test.ts imports mergeToolParameters from merge-params for the existing merge tests.

^{Reviewed by Cursor Bugbot for commit 3ac64f2. Configure here.}

[greptile-apps]

Greptile Summary

The PR extracts plain parameter-merging helpers into a registry-free leaf module so provider and PI execution paths no longer load the tool registry through tools/params.

• Moves mergeToolParameters, deepMergeInputMapping, and isNonEmpty without behavioral changes.
• Redirects direct consumers and tests to @/tools/merge-params.
• Keeps tools/params functionality intact by importing isNonEmpty from the new module.

Confidence Score: 5/5

The PR appears safe to merge, with the moved implementation, consumers, exports, and dependency boundary remaining consistent.

The extracted functions are behaviorally unchanged, all repository consumers use valid module paths, and the new leaf module has no runtime path back to the tool registry.

Important Files Changed

Filename	Overview
apps/sim/tools/merge-params.ts	Introduces the registry-free leaf containing the unchanged parameter-merging implementation; its runtime dependencies do not reach the tool registry.
apps/sim/tools/params.ts	Removes the relocated exports and imports isNonEmpty from the new module while retaining all remaining callers and behavior.
apps/sim/providers/utils.ts	Redirects parameter merging to the leaf module, removing this consumer's dependency edge through registry-owning tools/params.
apps/sim/executor/handlers/pi/sim-tools.ts	Redirects the PI tool-spec builder to the new declaration source without changing execution behavior.
apps/sim/tools/params.test.ts	Updates merge-helper tests to exercise the new module path while preserving existing coverage.

_{Reviews (1): Last reviewed commit: "perf(tools): move mergeToolParameters in..." | Re-trigger Greptile}