Skip to content
This repository was archived by the owner on May 15, 2026. It is now read-only.

feat(gemini): add minimal and medium reasoning effort levels #9973

Merged
cte merged 4 commits into from
Dec 10, 2025
Merged

feat(gemini): add minimal and medium reasoning effort levels #9973

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
f04433d
feat(gemini): add minimal and medium reasoning effort levels
hannesrudolph Dec 10, 2025
5772e89
refactor: derive GeminiThinkingLevel type from const array
roomote Dec 10, 2025
9838370
Add changeset
cte Dec 10, 2025
173814d
refactor(gemini): add isGeminiThinkingLevel type guard function
roomote Dec 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
196 changes: 196 additions & 0 deletions src/api/transform/__tests__/reasoning.spec.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ import {
OpenAiReasoningParams,
RooReasoningParams,
GeminiReasoningParams,
GeminiThinkingLevel,
} from "../reasoning"

describe("reasoning.ts", () => {
Expand Down Expand Up @@ -642,6 +643,201 @@ describe("reasoning.ts", () => {
const result = getGeminiReasoning(options) as GeminiReasoningParams | undefined
expect(result).toEqual({ thinkingLevel: "high", includeThoughts: true })
})

it("should return thinkingLevel for minimal effort", () => {
const geminiModel: ModelInfo = {
...baseModel,
supportsReasoningEffort: ["minimal", "low", "medium", "high"] as ModelInfo["supportsReasoningEffort"],
reasoningEffort: "high",
}

const settings: ProviderSettings = {
apiProvider: "gemini",
reasoningEffort: "minimal",
}

const options: GetModelReasoningOptions = {
model: geminiModel,
reasoningBudget: undefined,
reasoningEffort: "minimal",
settings,
}

const result = getGeminiReasoning(options) as GeminiReasoningParams | undefined
expect(result).toEqual({ thinkingLevel: "minimal", includeThoughts: true })
})

it("should return thinkingLevel for medium effort", () => {
const geminiModel: ModelInfo = {
...baseModel,
supportsReasoningEffort: ["minimal", "low", "medium", "high"] as ModelInfo["supportsReasoningEffort"],
reasoningEffort: "low",
}

const settings: ProviderSettings = {
apiProvider: "gemini",
reasoningEffort: "medium",
}

const options: GetModelReasoningOptions = {
model: geminiModel,
reasoningBudget: undefined,
reasoningEffort: "medium",
settings,
}

const result = getGeminiReasoning(options) as GeminiReasoningParams | undefined
expect(result).toEqual({ thinkingLevel: "medium", includeThoughts: true })
})

it("should handle all four Gemini thinking levels", () => {
const levels: GeminiThinkingLevel[] = ["minimal", "low", "medium", "high"]

levels.forEach((level) => {
const geminiModel: ModelInfo = {
...baseModel,
supportsReasoningEffort: [
"minimal",
"low",
"medium",
"high",
] as ModelInfo["supportsReasoningEffort"],
reasoningEffort: "low",
}

const settings: ProviderSettings = {
apiProvider: "gemini",
reasoningEffort: level,
}

const options: GetModelReasoningOptions = {
model: geminiModel,
reasoningBudget: undefined,
reasoningEffort: level,
settings,
}

const result = getGeminiReasoning(options) as GeminiReasoningParams | undefined
expect(result).toEqual({ thinkingLevel: level, includeThoughts: true })
})
})

it("should return undefined for disable effort", () => {
const geminiModel: ModelInfo = {
...baseModel,
supportsReasoningEffort: ["minimal", "low", "medium", "high"] as ModelInfo["supportsReasoningEffort"],
reasoningEffort: "low",
}

const settings: ProviderSettings = {
apiProvider: "gemini",
reasoningEffort: "disable",
}

const options: GetModelReasoningOptions = {
model: geminiModel,
reasoningBudget: undefined,
reasoningEffort: "disable",
settings,
}

const result = getGeminiReasoning(options)
expect(result).toBeUndefined()
})

it("should return undefined for none effort (invalid for Gemini)", () => {
const geminiModel: ModelInfo = {
...baseModel,
supportsReasoningEffort: ["minimal", "low", "medium", "high"] as ModelInfo["supportsReasoningEffort"],
reasoningEffort: "low",
}

const settings: ProviderSettings = {
apiProvider: "gemini",
reasoningEffort: "none",
}

const options: GetModelReasoningOptions = {
model: geminiModel,
reasoningBudget: undefined,
reasoningEffort: "none",
settings,
}

const result = getGeminiReasoning(options)
expect(result).toBeUndefined()
})

it("should use thinkingBudget for budget-based models", () => {
const geminiModel: ModelInfo = {
...baseModel,
supportsReasoningBudget: true,
requiredReasoningBudget: true,
}

const settings: ProviderSettings = {
apiProvider: "gemini",
enableReasoningEffort: true,
}

const options: GetModelReasoningOptions = {
model: geminiModel,
reasoningBudget: 4096,
reasoningEffort: "high",
settings,
}

const result = getGeminiReasoning(options) as GeminiReasoningParams | undefined
expect(result).toEqual({ thinkingBudget: 4096, includeThoughts: true })
})

it("should prioritize budget over effort when model has requiredReasoningBudget", () => {
const geminiModel: ModelInfo = {
...baseModel,
supportsReasoningBudget: true,
requiredReasoningBudget: true,
supportsReasoningEffort: ["minimal", "low", "medium", "high"] as ModelInfo["supportsReasoningEffort"],
}

const settings: ProviderSettings = {
apiProvider: "gemini",
enableReasoningEffort: true,
reasoningEffort: "high",
}

const options: GetModelReasoningOptions = {
model: geminiModel,
reasoningBudget: 8192,
reasoningEffort: "high",
settings,
}

const result = getGeminiReasoning(options) as GeminiReasoningParams | undefined
// Budget should take precedence
expect(result).toEqual({ thinkingBudget: 8192, includeThoughts: true })
})

it("should fall back to model default effort when settings.reasoningEffort is undefined", () => {
const geminiModel: ModelInfo = {
...baseModel,
supportsReasoningEffort: ["minimal", "low", "medium", "high"] as ModelInfo["supportsReasoningEffort"],
reasoningEffort: "medium",
}

const settings: ProviderSettings = {
apiProvider: "gemini",
}

const options: GetModelReasoningOptions = {
model: geminiModel,
reasoningBudget: undefined,
reasoningEffort: undefined,
settings,
}

const result = getGeminiReasoning(options) as GeminiReasoningParams | undefined
expect(result).toEqual({ thinkingLevel: "medium", includeThoughts: true })
})
})

describe("Integration scenarios", () => {
Expand Down
15 changes: 10 additions & 5 deletions src/api/transform/reasoning.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,10 @@ export type AnthropicReasoningParams = BetaThinkingConfigParam

export type OpenAiReasoningParams = { reasoning_effort: OpenAI.Chat.ChatCompletionCreateParams["reasoning_effort"] }

export type GeminiThinkingLevel = "minimal" | "low" | "medium" | "high"

export type GeminiReasoningParams = GenerateContentConfig["thinkingConfig"] & {
thinkingLevel?: "low" | "high"
thinkingLevel?: GeminiThinkingLevel
}

export type GetModelReasoningOptions = {
Expand Down Expand Up @@ -116,6 +118,9 @@ export const getOpenAiReasoning = ({
}
}

// Valid Gemini thinking levels for effort-based reasoning
const GEMINI_THINKING_LEVELS: readonly GeminiThinkingLevel[] = ["minimal", "low", "medium", "high"] as const

@cte cte Dec 10, 2025

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The more traditional way to do this is to define the array of values as const and then derive the type from the array.

@cte cte Dec 10, 2025

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@roomote Please fix this.

@ghost ghost Dec 10, 2025 •
edited by ghost
Loading

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixaroo Clock   See task on Roo Cloud

Fixed the reported issue. Now defines GEMINI_THINKING_LEVELS array as const first, then derives GeminiThinkingLevel type from it. All local checks passed.

View commit | Revert commit


export const getGeminiReasoning = ({
model,
reasoningBudget,
Expand All @@ -136,15 +141,15 @@ export const getGeminiReasoning = ({
| "disable"
| undefined

// Respect “off” / unset semantics from the effort selector itself.
// Respect "off" / unset semantics from the effort selector itself.
if (!selectedEffort || selectedEffort === "disable") {
return undefined
}

// Effort-based models on Google GenAI currently support only explicit low/high levels.
if (selectedEffort !== "low" && selectedEffort !== "high") {
// Effort-based models on Google GenAI support minimal/low/medium/high levels.
if (!GEMINI_THINKING_LEVELS.includes(selectedEffort as GeminiThinkingLevel)) {
return undefined
}
Comment on lines +153 to 156

@cte cte Dec 10, 2025

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@roomote Let's make this a proper type guard function called isGeminiThinkingLevel.

@ghost ghost Dec 10, 2025 •
edited by ghost
Loading

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixaroo Clock   See task on Roo Cloud

Added isGeminiThinkingLevel type guard function. All local checks passed.

View commit | Revert commit


return { thinkingLevel: selectedEffort, includeThoughts: true }
return { thinkingLevel: selectedEffort as GeminiThinkingLevel, includeThoughts: true }
}
Loading