@benvargas/pi-openai-verbosity 1.1.0 → 1.1.2

package/README.md

@@ -121,7 +121,8 @@ By default, the extension mirrors the Codex CLI's own per-model verbosity defaul
     "openai-codex/gpt-5.5": "low",
     "openai-codex/gpt-5.6-luna": "low",
     "openai-codex/gpt-5.6-sol": "low",
-    "openai-codex/gpt-5.6-terra": "low"
+    "openai-codex/gpt-5.6-terra": "low",
+    "openai-codex/gpt-6-astra": "low"
   }
 }
 ```
@@ -130,6 +131,42 @@ You can change any value to override the default for that model. If you have an
 older version of this extension, your file's entries win over these defaults, and entries for model slugs pi no
 longer exposes are simply ignored.
 
+## Why not `samplingParams`?
+
+pi 0.84.0 added `samplingParams`, which lets you pass arbitrary OpenAI-compatible parameters through
+`models.json`, model overrides, and extension providers. Reading those release notes, it is natural to assume
+this extension is now redundant and that you can write:
+
+```json
+{
+  "modelOverrides": {
+    "openai-codex/gpt-5.5": {
+      "samplingParams": { "text": { "verbosity": "medium" } }
+    }
+  }
+}
+```
+
+**On `openai-codex` this silently does nothing.** There is no error and no warning; the setting is simply never
+applied. `samplingParams` is explicitly scoped to OpenAI-*compatible* adapters — pi-ai documents it as "only
+applied by OpenAI-compatible adapters (completions, responses, Azure responses); other APIs ignore it" — and
+the Codex adapter is not one of them. It builds its own request and hardcodes `text: { verbosity: ... }`,
+defaulting to `low`.
+
+So for the `openai-codex` provider, this extension remains the only way to set per-model verbosity.
+
+### If you use `samplingParams` on the plain `openai` provider
+
+There it *is* applied, but the merge is a shallow top-level `Object.assign`. That means:
+
+```json
+{ "samplingParams": { "text": { "verbosity": "medium" } } }
+```
+
+replaces the **entire** `text` object rather than merging into it, discarding any other `text` fields pi had
+already set. This extension deliberately does the opposite: it preserves existing `text` fields and replaces
+only `text.verbosity`.
+
 ## Debugging
 
 Pi does not currently expose a simple CLI flag to print the final provider request body. To verify this extension is
@@ -159,7 +196,9 @@ delete it when you are done debugging.
 
 - This extension only changes outgoing provider request payloads.
 - Existing `text` fields are preserved, and only `text.verbosity` is replaced.
-- Only the `openai-codex` provider is supported.
+- Only the `openai-codex` provider is supported. pi 0.84.0's `samplingParams` does not reach that provider, so
+  this extension remains the only per-model verbosity control for it — see
+  [Why not `samplingParams`?](#why-not-samplingparams).
 - This extension is most useful if you want different verbosity settings for different OpenAI Codex model slugs.
 
 ## Uninstall

package/extensions/index.ts

@@ -21,9 +21,10 @@ const VERBOSITY_CONFIG_BASENAME = "pi-openai-verbosity.json";
 const VERBOSITY_COMMAND_ARGS = ["status"] as const;
 const DEBUG_LOG_ENV = "PI_OPENAI_VERBOSITY_DEBUG_LOG";
 const SUPPORTED_PROVIDERS = ["openai-codex"] as const;
-// Mirrors the Codex CLI upstream defaults for every model in pi's openai-codex
-// catalog. pi itself falls back to `low` for all codex requests, which matches
-// upstream everywhere except gpt-5.4-mini (upstream default: medium).
+// Mirrors the Codex CLI upstream `default_verbosity` for every model in pi's
+// openai-codex catalog as of pi 0.85.1 (gpt-5.3-codex-spark through
+// gpt-6-astra). pi itself falls back to `low` for all codex requests, which
+// matches upstream everywhere except gpt-5.4-mini (upstream default: medium).
 const DEFAULT_MODEL_VERBOSITY = {
 	"openai-codex/gpt-5.3-codex-spark": "low",
 	"openai-codex/gpt-5.4": "low",
@@ -32,6 +33,7 @@ const DEFAULT_MODEL_VERBOSITY = {
 	"openai-codex/gpt-5.6-luna": "low",
 	"openai-codex/gpt-5.6-sol": "low",
 	"openai-codex/gpt-5.6-terra": "low",
+	"openai-codex/gpt-6-astra": "low",
 } as const;
 
 type TextVerbosity = "low" | "medium" | "high";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@benvargas/pi-openai-verbosity",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Per-model OpenAI Codex text verbosity overrides for pi",
   "keywords": [
     "pi",
@@ -12,6 +12,7 @@
     "openai-codex",
     "gpt-5.5",
     "gpt-5.6-sol",
+    "gpt-6-astra",
     "verbosity",
     "text-verbosity",
     "per-model"