opencode-optimal-model-temps 1.0.0

package/README.md

@@ -0,0 +1,22 @@
+# opencode-optimal-model-temps
+
+Minimal OpenCode plugin that hooks `chat.params` and nudges specific models to their preferred sampling temperature. Right now it only pinches Google Gemini 3 Pro to **0.35**, following the recommendation in [Optimal Temperature for Gemini 3 Pro](https://lynchmark.com/blog/gemini-optimal-temperature).
+
+## Usage
+
+Add the plugin to your `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "plugin": [
+    "opencode-optimal-model-temps"
+  ]
+}
+```
+
+You can override the defaults with env vars:
+
+- `OPENCODE_GEMINI3_TEMPERATURE`: override target (defaults to `0.35`).
+- `OPENCODE_GEMINI3_BASELINE`: baseline value (defaults to `1`). The plugin only overrides when the CLI is still using this baseline, so your explicit agent temperatures still win.
+
+Feel free to extend `src/index.ts` with more entries in `TEMPERATURE_RULES` as the “perfect” settings for other models surface.

package/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "opencode-optimal-model-temps",
+  "version": "1.0.0",
+  "type": "module",
+  "license": "MIT"
+}

package/src/index.ts

@@ -0,0 +1,45 @@
+const TEMPERATURE_EPSILON = 1e-3
+
+type TemperatureRule = {
+  provider: string
+  match: RegExp
+  target: number
+  baseline?: number
+}
+
+const TEMPERATURE_RULES: TemperatureRule[] = [
+  {
+    provider: "google",
+    match: /gemini-3-pro/,
+    target: Number(process.env.OPENCODE_GEMINI3_TEMPERATURE ?? "0.35"),
+    baseline: Number(process.env.OPENCODE_GEMINI3_BASELINE ?? "1"),
+  },
+]
+
+function findRule(model: any): TemperatureRule | undefined {
+  const provider = (model?.providerID ?? "").toLowerCase()
+  const modelId = (model?.modelID ?? model?.api?.id ?? "").toLowerCase()
+
+  return TEMPERATURE_RULES.find((rule) => {
+    if (provider !== rule.provider.toLowerCase()) return false
+    return rule.match.test(modelId)
+  })
+}
+
+function isDefaultTemperature(current: number | undefined, baseline?: number) {
+  if (baseline === undefined || !Number.isFinite(baseline)) {
+    return current === undefined
+  }
+  if (current === undefined) return true
+  return Math.abs(current - baseline) < TEMPERATURE_EPSILON
+}
+
+export const OptimalModelTemperaturesPlugin = async () => ({
+  "chat.params": async ({ model }: { model: any }, output: { temperature?: number }) => {
+    const rule = findRule(model)
+    if (!rule || !Number.isFinite(rule.target)) return
+    if (!isDefaultTemperature(output.temperature, rule.baseline)) return
+
+    output.temperature = rule.target
+  },
+})