fix(search): make ToolsetConfigError actionable and fix misleading docs

[CameronCarlin]

Summary

• Rewrite the ToolsetConfigError "Search is disabled" message at all 4 raise sites to show the exact constructor arg needed (search={} or search={"method": "auto"})
• Fix 3 README snippets that called StackOneToolSet() with no args before invoking pydantic_ai(mode="search_and_execute"), get_search_tool(), or search_tools() — these would all raise ToolsetConfigError at runtime
• Fix openai(), pydantic_ai(), and get_search_tool() docstring examples that showed the same misleading pattern

No behavior change — default remains search=None (disabled).

Test plan

• just lint passes
• just ty passes
• Run examples/search_tools.py against a sandbox account to confirm the working path is unaffected
• Manually trigger the error to verify the new message renders cleanly

🤖 Generated with Claude Code

---

Summary by cubic

Makes the "Search is disabled" error actionable and points to the correct README section. Fixes examples so search-enabled usage works out of the box. No behavior change; search remains opt-in.

• Bug Fixes
  • Updated all four ToolsetConfigError sites to suggest search={} or search={"method": "auto"} and reference README "Search Tool".
  • Corrected README and docstring examples: construct StackOneToolSet(search={"method": "auto"}) before using pydantic_ai(mode="search_and_execute"), get_search_tool(), or search_tools(); fixed Basic Usage snippet (added StackOneToolSet import, removed unused fetch_tools, and passed account_ids to the search call).

^{Written for commit 1b7a8c6. Summary will update on new commits. Review in cubic}

[cubic-dev-ai]

No issues found across 2 files

<sub>Auto-approved: The changes are limited to improving error messages in toolset.py and fixing misleading documentation in README.md and docstrings, with no behavioral changes to business logic, APIs, or infrastructure.

Re-trigger cubic</sub>

[Copilot]

Pull request overview

Improves the developer experience around StackOne tool search by making the “search is disabled” failure mode more actionable and updating documentation examples to avoid runtime ToolsetConfigErrors when using search-enabled modes.

Changes:

• Updates ToolsetConfigError messages at all search-gated call sites to explicitly show the constructor argument needed to enable search (search={} / search={"method": "auto"}).
• Fixes StackOneToolSet usage examples in toolset.py docstrings for get_search_tool(), openai(mode="search_and_execute"), and pydantic_ai(mode="search_and_execute").
• Updates README snippets to reflect that search must be enabled on the constructor for search-related APIs.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
stackone_ai/toolset.py	Makes search-disabled errors more actionable; corrects docstring examples for search-enabled modes.
README.md	Updates search-related snippets to enable search on the constructor and clarifies usage.

Comments suppressed due to low confidence (3)

stackone_ai/toolset.py:670

• Same as above: README section header is 'Search Tool' (singular), so the exception text should reference that exact heading.

        if self._search_config is None:
            raise ToolsetConfigError(
                "Search is disabled. Pass search={} (or search={'method': 'auto'}) to "
                "StackOneToolSet(...) to enable. See README 'Search Tools' for options."
            )

stackone_ai/toolset.py:937

• Same heading mismatch: the README section is titled 'Search Tool', not 'Search Tools'.

        if self._search_config is None:
            raise ToolsetConfigError(
                "Search is disabled. Pass search={} (or search={'method': 'auto'}) to "
                "StackOneToolSet(...) to enable. See README 'Search Tools' for options."
            )

stackone_ai/toolset.py:1091

• Same heading mismatch here: the README section is titled 'Search Tool' (singular).

        if self._search_config is None:
            raise ToolsetConfigError(
                "Search is disabled. Pass search={} (or search={'method': 'auto'}) to "
                "StackOneToolSet(...) to enable. See README 'Search Tools' for options."
            )

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[cubic-dev-ai]

0 issues found across 2 files (changes from recent commits).

<sub>Auto-approved: These changes only improve error messages to be more actionable and fix misleading documentation examples—no runtime behavior is altered and the risk of breakage is negligible.

Re-trigger cubic</sub>