Repository navigation
docs: Our Tools - which tools are available; restore tool_blocked (AIM-768) - #590
Open
domdalty-ops wants to merge 5 commits into
Open
domdalty-ops wants to merge 5 commits into
domdalty-ops wants to merge 5 commits into
Conversation
…M-768) Stateful, people-data and social-media tools are hidden (ADR 0014), so the page no longer offers social media search, says what is not offered and why, and lists 403 tool_blocked again - the answer for a hidden tool id. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…IM-768) A tool that costs more than the $0.25 default needs max_cost_usd too, and search/inspect now say so in pricing.requires_max_cost; a max_cost_exceeded that names run_limit_usd cannot be fixed by raising max_cost_usd. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Triad audit on dev (F-9, F-16): the browser agent is sent a 30-step limit and charged per step it takes, but its provider ends a run on its own time budget (268-392 s observed), so "at most 240 seconds" was not true; a quick tool answers when it finishes (up to ~65 s) whatever wait_ms says; a failed run is not charged; idempotency keys are per API key. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ble tools (AIM-768) Owner decisions after the triad audit (aimlapi/aimlapi ADR 0015): a sync tool is never cut - past ~110 s the run answers 202 running and is charged when it ends; every run with output carries "untrusted": true; tools whose cheapest call is above the per-run limit are not offered; a browser session's connection details are in that run's answer only. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
main renamed the page (Our Tools -> Toolbox, quickstart/our-tools.md ->
quickstart/toolbox.md, "your AI" -> "your LLM") and added a Quickstart: MCP
section, which collided with this branch's edit to the same opening line.
Resolved by keeping both: main's naming, this branch's wording of the tool
list ("news search, company and domain data"). Everything else from this
branch — the untrusted flag, the 202/wait_ms rules, "Which tools are
available", tool_blocked — came through untouched.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The Our Tools page (hidden, #585–#588) was written before the pilot started hiding tools. Since then only tools that keep no state between calls are offered: tools that create lasting resources, call or message people, look up data about people, or collect data from social networks are hidden from search, and calling one by id answers
403 tool_blocked.Intro and description: no longer offer "social media search" / "social data".
New section Which tools are available: what is not offered and why, and the restricted form of the browser tools (no saved logins or stealth mode, 30 steps / 240 s; 5-minute browser sessions).
Error table:
403 tool_blockedis back. docs: Our Tools - drop the tool_blocked row (AIM-768) #588 dropped it, but it is exactly what a customer gets for a hidden tool id.max_cost_usd: required not only for result-priced tools but also for tools that cost more than the $0.25 default (pricing.requires_max_costsays so); amax_cost_exceededthat namesrun_limit_usdcannot be fixed by raisingmax_cost_usd(aimlapi/aimlapi#6687).After the triad audit (aimlapi/aimlapi ADR 0015): a tool that runs in one call is never cut — past ~110 s the run answers
202running, keeps going and is charged when it ends; every run with output carries"untrusted": true; tools whose cheapest call costs more than a single run may cost are not offered; a browser session's connection details are in that run's answer only; arun_limit_usdrefusal asks for a smaller input.No tool or vendor is named. The text follows the internal decision record (ADR 0014 in aimlapi/aimlapi).
🤖 Generated with Claude Code