You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Discussion #3621 agreed on the target state: a small direct baseline of frequent tools stays visible at step 0, and every other available tool is deferred behind tool_search by default — "Defer other available tools by default, including low-frequency tools such as WriteStdin."
#3765 delivered the provider-independent, turn-scoped tool_search contract and moved catalog surfaces (agent, browser, computer_use, rive) and dynamic client groups behind it. But that first slice deliberately left every ungrouped bound tool eagerly visible. A default session still advertises ~30 tool schemas on every provider request, including low-frequency ones:
Defer available tools by default unless they are in the direct baseline.
Every catalog tool outside DIRECT_TOOL_NAMES joins the deferred search space. Add natural catalog surfaces (e.g. session, memory, history, settings) so the search inventory stays scannable instead of one flat pool.
Which runtime states auto-promote a deferred tool to direct for that turn (open question from Simplify Maka tool discovery: direct baseline + turn-scoped tool_search #3621): e.g. a background PTY exists → WriteStdin; a sandbox-boundary prompt is live → request_sandbox_boundary; goal tools while an autonomous goal is active.
How memory extraction flows behave when memory_remember/memory_extract are deferred, including the Runtime-reserved memory trigger tools built in ai-sdk-backend.ts.
Prompt updates so the model knows to tool_search before relying on deferred flows (task ledger, memory, scheduled tasks, goals).
Acceptance
In a default session, the step-0 provider request contains only DIRECT_TOOL_NAMES, Skill/SkillSearch, tool_search, and any turn-activated tools.
toolAvailability telemetry shows the schema-char reduction versus current main.
Task ledger, scheduled tasks, memory extraction, goals, and history flows all still work after tool_search activation; focused Runtime and Runtime Host suites pass.
Problem
Discussion #3621 agreed on the target state: a small direct baseline of frequent tools stays visible at step 0, and every other available tool is deferred behind
tool_searchby default — "Defer other available tools by default, including low-frequency tools such asWriteStdin."#3765 delivered the provider-independent, turn-scoped
tool_searchcontract and moved catalog surfaces (agent,browser,computer_use,rive) and dynamic client groups behind it. But that first slice deliberately left every ungrouped bound tool eagerly visible. A default session still advertises ~30 tool schemas on every provider request, including low-frequency ones:memory_remember,memory_extracttask_create,task_update,task_list,task_getGoalSet,GoalClear,GoalStatus,GoalPause,GoalResumeScheduledTaskMakaSettingsGet,MakaSettingsUpdateSearchHistory,ReadHistoryExploreAgent,FormatJson,WriteStdin,WebSearch,request_sandbox_boundaryDesired outcome
Defer available tools by default unless they are in the direct baseline.
DIRECT_TOOL_NAMESjoins the deferred search space. Add natural catalog surfaces (e.g.session,memory,history,settings) so the search inventory stays scannable instead of one flat pool.Skill/SkillSearchstay direct, per Simplify Maka tool discovery: direct baseline + turn-scoped tool_search #3621's carve-out pending the separate skill-discovery discussion.DIRECT_TOOL_NAMESremains the never-deferred baseline.requiredToolNameshook when runtime state requires them.boundTools/ tool profiles) remain authoritative; discovery never escapes the bound set.Semantics to settle during implementation
WriteStdin; a sandbox-boundary prompt is live →request_sandbox_boundary; goal tools while an autonomous goal is active.memory_remember/memory_extractare deferred, including the Runtime-reserved memory trigger tools built inai-sdk-backend.ts.tool_searchbefore relying on deferred flows (task ledger, memory, scheduled tasks, goals).Acceptance
DIRECT_TOOL_NAMES,Skill/SkillSearch,tool_search, and any turn-activated tools.toolAvailabilitytelemetry shows the schema-char reduction versus current main.tool_searchactivation; focused Runtime and Runtime Host suites pass.Follows up #3621 and #3765. Tracker: #1382.
AI assistance disclosure
Maka helped audit the current implementation against the #3621 agreement and draft this issue. I reviewed the scope and final text.