github / github/copilot-sdk

[Feature Request] Allow subagents to override reasoning effort in CustomAgentConfig (parity with Claude Agent SDK)

Ouverte
#1,131 4 commentaires 13 réactions 0 personnes assignées Voir sur GitHub
enhancement
Langage dominant
Java
Étoiles
10.5k
Forks
1.5k
Merge moyen
1 j 11 h
PR mergées (30 j)
128

Description

## Summary

Allow custom subagents defined via `CustomAgentConfig` to specify their own reasoning effort independent of the orchestrator session's reasoning. The Claude Agent SDK supports this via an `effort` field on `AgentDefinition`. copilot-sdk's `CustomAgentConfig` does not, so reasoning is fixed at session level and applies uniformly to every subagent invocation.

## Motivation

- Orchestrators often benefit from `high` or `max` reasoning for planning and delegation
- Many subagent tasks are mechanical execution (validation, extraction, format conversion) and do not benefit from deep reasoning, but today pay its latency and cost
- Conversely, security focused or analysis focused subagents may want stronger reasoning than the orchestrator
- Without per subagent control, the tallest reasoning setting propagates to every dispatch

## Current state

- `CustomAgentConfig` (copilot-sdk `types.d.ts`, lines 802 to 833) has no `reasoningEffort` or `effort` field
- Session level `reasoningEffort` in `providerOptions` applies to all subagent dispatches in that session

## Proposed

1. Add optional `reasoningEffort` (or `effort`) field to `CustomAgentConfig`
2. Accept existing values: `low | medium | high | xhigh | max`, plus numeric for models that support it
3. Fall back to session reasoning when omitted
4. Mirror the field in the YAML frontmatter loader (coordinated with github/copilot-cli#2904)

## Precedent

Claude Agent SDK's `AgentDefinition.effort`:
https://code.claude.com/docs/en/agent-sdk/subagents

Identical value vocabulary already in use by this SDK.

## Related

- github/copilot-cli#2904 — Custom Agent YAML Frontmatter Should Support Reasoning Effort (CLI surface for the same feature)
- #1019 — Per agent tool visibility for custom sub agents (same architectural axis)

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Start with CustomAgentConfig in types.d.ts around lines 802–833, then trace how session-level reasoningEffort in providerOptions reaches custom subagent dispatches. Read the YAML frontmatter loader and related github/copilot-cli#2904 context. Done means the config and YAML surfaces accept the documented effort values and omitted values retain the session setting.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
typescript, yaml
Domaine
developer-experience, tooling
Type d'issue
Fonctionnalité
Difficulté
4/5
Temps estimé
3-5 jours
Activité
Calme
Clarté
Plutôt claire
Accessibilité débutants
64/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.