Skip to content

Commit bf6215a

Browse files
committed
feat(opencode): add model parameter to task tool for subagent model override
Adds an optional model parameter to the task tool that overrides which model a subagent uses. Format: provider/model (e.g. anthropic/claude-sonnet-4). Model priority: params.model > agent config > parent session model. The model_override permission is denied by default, requiring users to opt in via config (e.g. model_override: { anthropic/*: allow }). This prevents prompt injection from escalating to expensive models. Closes anomalyco#17595
1 parent 3afa622 commit bf6215a

5 files changed

Lines changed: 75 additions & 3 deletions

File tree

‎packages/opencode/src/agent/agent.ts‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,7 @@ export const layer = Layer.effect(
9999
const defaults = Permission.fromConfig({
100100
"*": "allow",
101101
doom_loop: "ask",
102+
model_override: "deny",
102103
external_directory: {
103104
"*": "ask",
104105
...Object.fromEntries(whitelistedDirs.map((dir) => [dir, "allow"])),

‎packages/opencode/src/config/permission.ts‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,7 @@ const InputObject = Schema.StructWithRest(
3838
codesearch: Schema.optional(Action),
3939
repo_clone: Schema.optional(Rule),
4040
repo_overview: Schema.optional(Rule),
41+
model_override: Schema.optional(Rule),
4142
lsp: Schema.optional(Rule),
4243
doom_loop: Schema.optional(Action),
4344
skill: Schema.optional(Rule),

‎packages/opencode/src/tool/task.ts‎

Lines changed: 34 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ import { MessageV2 } from "../session/message-v2"
66
import { Agent } from "../agent/agent"
77
import type { SessionPrompt } from "../session/prompt"
88
import { Config } from "@/config/config"
9+
import { ModelID, ProviderID } from "../provider/schema"
910
import { Effect, Exit, Schema } from "effect"
1011
import { EffectBridge } from "@/effect/bridge"
1112

@@ -21,6 +22,10 @@ export const Parameters = Schema.Struct({
2122
description: Schema.String.annotate({ description: "A short (3-5 words) description of the task" }),
2223
prompt: Schema.String.annotate({ description: "The task for the agent to perform" }),
2324
subagent_type: Schema.String.annotate({ description: "The type of specialized agent to use for this task" }),
25+
model: Schema.optional(Schema.String).annotate({
26+
description:
27+
"Override the model for this subagent. Format: provider/model (e.g. anthropic/claude-sonnet-4, openai/gpt-4o). Takes precedence over the agent's configured model.",
28+
}),
2429
task_id: Schema.optional(Schema.String).annotate({
2530
description:
2631
"This should only be set if you mean to resume a previous task (you can pass a prior task_id and the task will continue the same subagent session as before instead of creating a fresh one)",
@@ -104,9 +109,35 @@ export const TaskTool = Tool.define(
104109
const msg = yield* Effect.sync(() => MessageV2.get({ sessionID: ctx.sessionID, messageID: ctx.messageID }))
105110
if (msg.info.role !== "assistant") return yield* Effect.fail(new Error("Not an assistant message"))
106111

107-
const model = next.model ?? {
108-
modelID: msg.info.modelID,
109-
providerID: msg.info.providerID,
112+
let model: { modelID: ModelID; providerID: ProviderID }
113+
if (params.model) {
114+
const slash = params.model.indexOf("/")
115+
if (slash <= 0 || slash === params.model.length - 1) {
116+
return yield* Effect.fail(
117+
new Error(
118+
`Invalid model format: "${params.model}". Expected provider/model (e.g. anthropic/claude-sonnet-4)`,
119+
),
120+
)
121+
}
122+
yield* ctx.ask({
123+
permission: "model_override",
124+
patterns: [params.model],
125+
always: [params.model.slice(0, slash + 1) + "*"],
126+
metadata: {
127+
description: params.description,
128+
subagent_type: params.subagent_type,
129+
model: params.model,
130+
},
131+
})
132+
model = {
133+
providerID: ProviderID.make(params.model.slice(0, slash)),
134+
modelID: ModelID.make(params.model.slice(slash + 1)),
135+
}
136+
} else {
137+
model = next.model ?? {
138+
modelID: msg.info.modelID,
139+
providerID: msg.info.providerID,
140+
}
110141
}
111142

112143
yield* ctx.metadata({

‎packages/opencode/src/tool/task.txt‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,11 @@ When NOT to use the Task tool:
1111
- If you are searching for code within a specific file or set of 2-3 files, use the Read tool instead of the Task tool, to find the match more quickly
1212
- Other tasks that are not related to the agent descriptions above
1313

14+
Model selection:
15+
- Each agent has a default model (usually inherited from the parent session).
16+
- You can override the model by passing the `model` parameter in `provider/model` format (e.g. `anthropic/claude-sonnet-4`, `openai/gpt-4o`, `google/gemini-2.5-pro`).
17+
- Model overrides require the `model_override` permission. By default this permission is denied and the user will be asked to approve. The user can allow specific models or providers in their config (e.g. `"model_override": { "anthropic/*": "allow" }`).
18+
- Use the `model` parameter to run a subagent on a different model than the parent session. This is useful for leveraging different model strengths (e.g., sending research tasks to a faster/cheaper model, or routing code generation to a more capable model).
1419

1520
Usage notes:
1621
1. Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses

‎packages/opencode/test/tool/task.test.ts‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -432,4 +432,38 @@ describe("tool.task", () => {
432432
},
433433
},
434434
)
435+
436+
it.instance("execute uses model parameter to override subagent model", () =>
437+
Effect.gen(function* () {
438+
const { chat, assistant } = yield* seed()
439+
const tool = yield* TaskTool
440+
const def = yield* tool.init()
441+
let seen: SessionPrompt.PromptInput | undefined
442+
const promptOps = stubOps({ onPrompt: (input) => (seen = input) })
443+
444+
const result = yield* def.execute(
445+
{
446+
description: "inspect bug",
447+
prompt: "look into the cache key path",
448+
subagent_type: "general",
449+
model: "anthropic/claude-sonnet-4",
450+
},
451+
{
452+
sessionID: chat.id,
453+
messageID: assistant.id,
454+
agent: "build",
455+
abort: new AbortController().signal,
456+
extra: { promptOps },
457+
messages: [],
458+
metadata: () => Effect.void,
459+
ask: () => Effect.void,
460+
},
461+
)
462+
463+
expect(result.metadata.model.providerID as string).toBe("anthropic")
464+
expect(result.metadata.model.modelID as string).toBe("claude-sonnet-4")
465+
expect((seen?.model?.providerID ?? "") as string).toBe("anthropic")
466+
expect((seen?.model?.modelID ?? "") as string).toBe("claude-sonnet-4")
467+
}),
468+
)
435469
})

0 commit comments

Comments
 (0)