feat(opencode): add task model override by kobicovaldev · Pull Request #29447 · anomalyco/opencode · GitHub

Issue for this PR

Type of change

Bug fix
New feature
Refactor / code improvement
Documentation

What does this PR do?

This adds an optional model parameter to the Task tool so a primary agent can choose a subagent model at runtime using provider/model format.

The model selection order is explicit Task model, then the configured subagent model, then the parent assistant message model. Explicit overrides are gated behind a new model_override permission, which defaults to deny. The implementation validates malformed model strings early, asks model_override before the normal task permission, and uses exact-model approval scope.

This is a refreshed forward-port of #26535 onto current dev. Credit to @funkybooboo for the original implementation and design. I opened this separately because #26535 is conflicted and far behind the base branch.

How did you verify your code works?

git diff --check passed.
bun build packages/opencode/src/tool/task.ts --packages external passed.
bun build packages/opencode/test/tool/task.test.ts --packages external passed.

Full local test commands were blocked in my checkout because required local tooling/dependencies were missing:

bun test test/tool/task.test.ts test/tool/parameters.test.ts --timeout 30000 was blocked by missing @opentui/solid/preload.
bun typecheck was blocked by missing tsgo.

Screenshots / recordings

Not applicable. This is not a UI change.

Checklist

I have tested my changes locally
I have not included unrelated changes in this PR

The following comment was made by an LLM, it may be inaccurate:

Potential Duplicate Found

#26535 - feat(opencode): add model parameter to task tool for subagent model override

URL: feat(opencode): add model parameter to task tool for subagent model override #26535
Relationship: This is the original PR that the current PR (feat(opencode): add task model override #29447) is explicitly porting forward. As noted in the PR description, feat(opencode): add model parameter to task tool for subagent model override #26535 is currently conflicted against dev and far behind the base branch. The current PR (feat(opencode): add task model override #29447) refreshes and ports this work onto current dev with some design improvements (different permission ordering and exact-model approval strategy).

This is intentional, not a conflict—#29447 is the forward port to replace #26535.

…erride-port

Thanks for updating your PR! It now meets our contributing guidelines. 👍

…erride-port

@kobicovaldev you are awesome!

…erride-port

…erride-port # Conflicts: # packages/core/src/v1/config/permission.ts # packages/opencode/src/tool/task.ts # packages/opencode/test/tool/task.test.ts

…erride-port # Conflicts: # packages/opencode/test/tool/task.test.ts

…erride-port

…override-port

Refreshed this PR against latest dev (commit 4ddfa7c). Current PR checks are passing, and the diff is still scoped to the Task tool model override implementation. Ready for maintainer review when you have a chance.

Friendly bump for maintainer review when someone has bandwidth. This PR has been refreshed onto latest dev, is mergeable, and the current PR checks are passing. Happy to adjust anything that would make it easier to land.

Hey @kobicovaldev , what is the merge plan for this PR, when can we expect this change to be in dev ?

Thanks for the interest @Sufyan31. I’m the PR author, but I don’t have merge permissions on this repo, so this is waiting on maintainer review/merge.

The PR is currently mergeable, checks are passing, and maintainerCanModify is enabled. @thdxr / @adamdotdevin, would one of you be able to review or let me know if anything else is needed to land this?

…29447)

Thanks for carrying this forward.

A strong +1 from a multi-model independent sampling / review convergence use case: the important part for us is being able to have one orchestrator delegate the same role/prompt to different models in the same run, then compare agreement/disagreement and converge on the result.

That is useful for review-consensus and second-opinion loops, and it breaks down if we have to duplicate agent definitions per model. We want agents to stay role-centric, with the caller choosing the model per invocation when needed.

So this feels directly aligned with #17595 and #29984, and it would also help unblock downstream review flows like #30289. Not asking for a separate fallback mechanism here — just first-class runtime model selection for Task/subagent calls.

Add an optional `model` parameter to the task tool (provider/model format) that overrides the subagent's model, gated behind a new `model_override` permission that defaults to deny. Selection precedence is the `model` parameter, then the subagent's configured model, then the parent assistant message model. Ported from anomalyco#29447 (adapted for the Effect layer). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Add an experimental subagent-interrupt capability (behind OPENCODE_EXPERIMENTAL_SUBAGENT_INTERRUPT): an Interrupt service with pending/terminal state, task_steer/task_cancel/task_abort tools (gated by a new `interrupt` permission), a POST /session/:id/interrupt endpoint, and a turn-boundary consume in the prompt loop that injects an escaped steer/cancel frame plus a visible transcript marker. Cancel records a terminal reason and force-breaks after a grace window; abort writes a marker, records the terminal, and cancels the BackgroundJob immediately. The TUI gains an esc-with-reason flow, footer button, and distinct interrupt markers. Ported from anomalyco#32425 (adapted for the Effect layer; merged with the prior task.ts/registry.ts/prompt.ts changes from anomalyco#29447/anomalyco#32122/anomalyco#12520/anomalyco#32192/anomalyco#19961). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Add an optional `model` parameter to the task tool (provider/model format) that overrides the subagent's model, gated behind a new `model_override` permission that defaults to deny. Selection precedence is the `model` parameter, then the subagent's configured model, then the parent assistant message model. Ported from anomalyco#29447 (adapted for the Effect layer). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Add an experimental subagent-interrupt capability (behind OPENCODE_EXPERIMENTAL_SUBAGENT_INTERRUPT): an Interrupt service with pending/terminal state, task_steer/task_cancel/task_abort tools (gated by a new `interrupt` permission), a POST /session/:id/interrupt endpoint, and a turn-boundary consume in the prompt loop that injects an escaped steer/cancel frame plus a visible transcript marker. Cancel records a terminal reason and force-breaks after a grace window; abort writes a marker, records the terminal, and cancels the BackgroundJob immediately. The TUI gains an esc-with-reason flow, footer button, and distinct interrupt markers. Ported from anomalyco#32425 (adapted for the Effect layer; merged with the prior task.ts/registry.ts/prompt.ts changes from anomalyco#29447/anomalyco#32122/anomalyco#12520/anomalyco#32192/anomalyco#19961). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Add an optional `model` parameter to the task tool (provider/model format) that overrides the subagent's model, gated behind a new `model_override` permission that defaults to deny. Selection precedence is the `model` parameter, then the subagent's configured model, then the parent assistant message model. Ported from anomalyco#29447 (adapted for the Effect layer). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Add an experimental subagent-interrupt capability (behind OPENCODE_EXPERIMENTAL_SUBAGENT_INTERRUPT): an Interrupt service with pending/terminal state, task_steer/task_cancel/task_abort tools (gated by a new `interrupt` permission), a POST /session/:id/interrupt endpoint, and a turn-boundary consume in the prompt loop that injects an escaped steer/cancel frame plus a visible transcript marker. Cancel records a terminal reason and force-breaks after a grace window; abort writes a marker, records the terminal, and cancels the BackgroundJob immediately. The TUI gains an esc-with-reason flow, footer button, and distinct interrupt markers. Ported from anomalyco#32425 (adapted for the Effect layer; merged with the prior task.ts/registry.ts/prompt.ts changes from anomalyco#29447/anomalyco#32122/anomalyco#12520/anomalyco#32192/anomalyco#19961). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Adds per-dispatch controls to the Task tool: - model override (provider/model), permission-gated via model_override (default deny), supersedes anomalyco#29447 - resumed tasks keep their last-used model and variant instead of reverting to the agent default - human-readable slug task_ids with deterministic child session ids and agent-chosen session slug, supersedes anomalyco#32122 - per-dispatch variant override - structured dispatch metadata persisted on the child session - explicit resume consent: resuming an idle/completed task session requires resume: true - timeout (ms) per attempt and fallback_model retried once on timeout or typed failure, never on parent abort; runner-only cancelRun avoids self-cancelling the enclosing background job

Add an optional `model` parameter to the task tool (provider/model format) that overrides the subagent's model, gated behind a new `model_override` permission that defaults to deny. Selection precedence is the `model` parameter, then the subagent's configured model, then the parent assistant message model. Ported from anomalyco#29447 (adapted for the Effect layer). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Add an experimental subagent-interrupt capability (behind OPENCODE_EXPERIMENTAL_SUBAGENT_INTERRUPT): an Interrupt service with pending/terminal state, task_steer/task_cancel/task_abort tools (gated by a new `interrupt` permission), a POST /session/:id/interrupt endpoint, and a turn-boundary consume in the prompt loop that injects an escaped steer/cancel frame plus a visible transcript marker. Cancel records a terminal reason and force-breaks after a grace window; abort writes a marker, records the terminal, and cancels the BackgroundJob immediately. The TUI gains an esc-with-reason flow, footer button, and distinct interrupt markers. Ported from anomalyco#32425 (adapted for the Effect layer; merged with the prior task.ts/registry.ts/prompt.ts changes from anomalyco#29447/anomalyco#32122/anomalyco#12520/anomalyco#32192/anomalyco#19961). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Add an optional `model` parameter to the task tool (provider/model format) that overrides the subagent's model, gated behind a new `model_override` permission that defaults to deny. Selection precedence is the `model` parameter, then the subagent's configured model, then the parent assistant message model. Ported from anomalyco#29447 (adapted for the Effect layer). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Add an experimental subagent-interrupt capability (behind OPENCODE_EXPERIMENTAL_SUBAGENT_INTERRUPT): an Interrupt service with pending/terminal state, task_steer/task_cancel/task_abort tools (gated by a new `interrupt` permission), a POST /session/:id/interrupt endpoint, and a turn-boundary consume in the prompt loop that injects an escaped steer/cancel frame plus a visible transcript marker. Cancel records a terminal reason and force-breaks after a grace window; abort writes a marker, records the terminal, and cancels the BackgroundJob immediately. The TUI gains an esc-with-reason flow, footer button, and distinct interrupt markers. Ported from anomalyco#32425 (adapted for the Effect layer; merged with the prior task.ts/registry.ts/prompt.ts changes from anomalyco#29447/anomalyco#32122/anomalyco#12520/anomalyco#32192/anomalyco#19961). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Closing this PR as superseded by #34947, which carries the permission-gated Task model override forward and is now the active implementation. Please follow #34947 for review and landing progress.

Add an optional `model` parameter to the task tool (provider/model format) that overrides the subagent's model, gated behind a new `model_override` permission that defaults to deny. Selection precedence is the `model` parameter, then the subagent's configured model, then the parent assistant message model. Ported from anomalyco#29447 (adapted for the Effect layer). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Add an experimental subagent-interrupt capability (behind OPENCODE_EXPERIMENTAL_SUBAGENT_INTERRUPT): an Interrupt service with pending/terminal state, task_steer/task_cancel/task_abort tools (gated by a new `interrupt` permission), a POST /session/:id/interrupt endpoint, and a turn-boundary consume in the prompt loop that injects an escaped steer/cancel frame plus a visible transcript marker. Cancel records a terminal reason and force-breaks after a grace window; abort writes a marker, records the terminal, and cancels the BackgroundJob immediately. The TUI gains an esc-with-reason flow, footer button, and distinct interrupt markers. Ported from anomalyco#32425 (adapted for the Effect layer; merged with the prior task.ts/registry.ts/prompt.ts changes from anomalyco#29447/anomalyco#32122/anomalyco#12520/anomalyco#32192/anomalyco#19961). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(opencode): add task model override

473ed05

github-actions Bot added contributor needs:compliance This means the issue will auto-close after 2 hours. labels May 26, 2026

kobicovaldev mentioned this pull request May 26, 2026

feat(opencode): add model parameter to task tool for subagent model override #26535

Closed

6 tasks

Merge remote-tracking branch 'origin/dev' into analysis-task-model-ov…

784c602

…erride-port

github-actions Bot removed the needs:compliance This means the issue will auto-close after 2 hours. label May 26, 2026

Merge remote-tracking branch 'origin/dev' into analysis-task-model-ov…

0b8ecd0

…erride-port

github-actions Bot mentioned this pull request May 28, 2026

📊 AI CLI 工具社区动态日报 2026-05-28 ivanweng2077/big_model_radar#101

Open

kobicovaldev added 6 commits May 29, 2026 16:18

Merge remote-tracking branch 'origin/dev' into analysis-task-model-ov…

9b92886

…erride-port

Merge branch 'dev' into analysis-task-model-override-port

8e9e952

Merge remote-tracking branch 'origin/dev' into analysis-task-model-ov…

0cdf9c6

…erride-port # Conflicts: # packages/core/src/v1/config/permission.ts # packages/opencode/src/tool/task.ts # packages/opencode/test/tool/task.test.ts

Merge remote-tracking branch 'origin/dev' into analysis-task-model-ov…

0ab95f4

…erride-port # Conflicts: # packages/opencode/test/tool/task.test.ts

Merge remote-tracking branch 'origin/dev' into analysis-task-model-ov…

f465a73

…erride-port

Merge remote-tracking branch 'origin/dev' into analysis-task-model-ov…

bc0557e

…erride-port

github-actions Bot mentioned this pull request Jun 10, 2026

feat(opencode): add optional model param to Task tool and show provider in message headers #31694

Closed

3 tasks

Merge remote-tracking branch 'upstream/dev' into analysis-task-model-…

7114c25

…override-port

iceteaSA added a commit to iceteaSA/opencode that referenced this pull request Jun 17, 2026

chore(sdk,test): regenerate for task model-override param (anomalyco#…

08cb499

…29447)

iceteaSA mentioned this pull request Jul 2, 2026

feat(opencode): add dispatch controls to the task tool #34947

Open

3 tasks

pratikranaa mentioned this pull request Jul 7, 2026

feat(opencode): add runtime model override for task tool subagents #35800

Open

6 tasks

kobicovaldev closed this Jul 28, 2026

leoncheng57 mentioned this pull request Aug 26, 2026

feat(task): allow selecting a model per task invocation (1.18.23 lineage) leoncheng57/opencode#4

Merged

6 tasks

feat(opencode): add task model override by kobicovaldev · Pull Request #29447 · anomalyco/opencode · GitHub

Uh oh!

feat(opencode): add task model override - #29447

feat(opencode): add task model override#29447
kobicovaldev wants to merge 10 commits into
anomalyco:devfrom
kobicovaldev:analysis-task-model-override-port

kobicovaldev commented May 26, 2026 •
edited
Loading

Uh oh!

Uh oh!

github-actions Bot commented May 26, 2026

Uh oh!

github-actions Bot commented May 26, 2026

Uh oh!

funkybooboo commented May 28, 2026

Uh oh!

kobicovaldev commented Jun 12, 2026

Uh oh!

kobicovaldev commented Jun 12, 2026

Uh oh!

Sufyan31 commented Jun 13, 2026

Uh oh!

kobicovaldev commented Jun 15, 2026

Uh oh!

tossp commented Jun 18, 2026

Uh oh!

kobicovaldev commented Jul 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

feat(opencode): add task model override by kobicovaldev · Pull Request #29447 · anomalyco/opencode · GitHub

Uh oh!

feat(opencode): add task model override - #29447

feat(opencode): add task model override#29447kobicovaldev wants to merge 10 commits intoanomalyco:devanomalyco/opencode:devfrom kobicovaldev:analysis-task-model-override-portkobicovaldev/opencode:analysis-task-model-override-portCopy head branch name to clipboard

Conversation

kobicovaldev commented May 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Issue for this PR

Type of change

What does this PR do?

How did you verify your code works?

Screenshots / recordings

Checklist

Uh oh!

github-actions Bot commented May 26, 2026

Potential Duplicate Found

Uh oh!

github-actions Bot commented May 26, 2026

Uh oh!

funkybooboo commented May 28, 2026

Uh oh!

kobicovaldev commented Jun 12, 2026

Uh oh!

kobicovaldev commented Jun 12, 2026

Uh oh!

Sufyan31 commented Jun 13, 2026

Uh oh!

kobicovaldev commented Jun 15, 2026

Uh oh!

tossp commented Jun 18, 2026

Uh oh!

kobicovaldev commented Jul 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

feat(opencode): add task model override#29447
kobicovaldev wants to merge 10 commits into
anomalyco:devfrom
kobicovaldev:analysis-task-model-override-port

kobicovaldev commented May 26, 2026 •
edited
Loading