Skip to content

[deep-report] tools.md missing per-engine web-search and tools.timeout defaults (Copilot/Gemini/Pi) #59019

Description

@github-actions

Description

docs/src/content/docs/reference/tools.md documents per-engine behavior for only a subset of engines in two places, live-verified by reading the file directly:

  1. Web Tools section: states that for the Codex engine, web-search: is disabled by default unless explicitly declared. It says nothing about Claude/Copilot/Gemini/Pi web-search default behavior, forcing users onto other engines to guess.
  2. Tool Operation Timeout (tools.timeout) section: "Defaults vary by engine (Claude: 60 s, Codex: 120 s)" — Copilot/Gemini/Pi defaults are left unstated.

Expected Impact

Removes guesswork for the majority of users on non-Codex engines when configuring tools.timeout or relying on default web-search availability.

Proposed Change

Fill in the missing per-engine values in both sections of tools.md (Copilot, Gemini, Pi), sourcing the actual defaults from each engine's implementation in pkg/workflow/.

Scope

Primarily docs/src/content/docs/reference/tools.md; may require reading engine source to confirm actual default values before documenting them.

Suggested Agent

Docs-focused agent with repo code access to confirm actual per-engine defaults before writing.

Estimated Effort

Medium (1-4 hours) — requires confirming real defaults per engine, not just editing prose.

Data Source

DeepReport Intelligence Briefing (2026-09-06 cycle), originating from Claude Code User Documentation Review discussion #58988 (Priority 2/3 recommendations).

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • api.anthropic.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "api.anthropic.com"

See Network Configuration for more information.

Generated by 🔬 Deep Report · claude · agent · 254.2 AIC · ⌖ 10.8 AIC · ⊞ 12.8K ·

  • expires on Sep 8, 2026, 10:39 AM UTC-08:00

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions