@herbertgao/pi-extensions 2026.8.7 → 2026.8.9

package/node_modules/@herbertgao/pi-preferred-thinking/src/index.ts

@@ -3,31 +3,17 @@ import path from "node:path"
 import {
   getAgentDir,
   type ExtensionAPI,
+  type ExtensionCommandContext,
   type ExtensionContext,
 } from "@earendil-works/pi-coding-agent"
 
 type ThinkingLevel = Parameters<ExtensionAPI["setThinkingLevel"]>[0]
-
-type PreferredThinkingConfig = Record<string, unknown> & {
-  preferredThinking?: Record<string, unknown>
+type PiSettings = Record<string, unknown> & {
+  enabledModels?: unknown
 }
 
-const CONFIG_PATH = path.join(
-  getAgentDir(),
-  "extensions",
-  "pi-preferred-thinking.json",
-)
-const CONFIG_DIR = path.dirname(CONFIG_PATH)
+const SETTINGS_PATH = path.join(getAgentDir(), "settings.json")
 const UNSET_OPTION = "unset"
-const VALID_THINKING_LEVELS = new Set<ThinkingLevel>([
-  "off",
-  "minimal",
-  "low",
-  "medium",
-  "high",
-  "xhigh",
-  "max",
-])
 const THINKING_LEVEL_OPTIONS: readonly ThinkingLevel[] = [
   "off",
   "minimal",
@@ -37,137 +23,206 @@ const THINKING_LEVEL_OPTIONS: readonly ThinkingLevel[] = [
   "xhigh",
   "max",
 ]
+const HINT_WIDGET_KEY = "pi-preferred-thinking"
+const HINT_DURATION_MS = 3_000
+
+let hintTimer: ReturnType<typeof setTimeout> | undefined
+const nudgedModels = new Set<string>()
 
 function getModelKey(provider: string, modelId: string): string {
   return `${provider}/${modelId}`
 }
 
-function readConfig(): PreferredThinkingConfig {
+function readSettings(): PiSettings {
+  const content = readFileSync(SETTINGS_PATH, "utf8")
+  let settings: unknown
   try {
-    const content = readFileSync(CONFIG_PATH, "utf-8")
-    const config = JSON.parse(content) as unknown
-    return config && typeof config === "object" && !Array.isArray(config)
-      ? (config as PreferredThinkingConfig)
-      : {}
-  } catch (error) {
-    if (error instanceof SyntaxError) throw error
+    settings = JSON.parse(content)
+  } catch {
     return {}
   }
+  return settings && typeof settings === "object" && !Array.isArray(settings)
+    ? (settings as PiSettings)
+    : {}
 }
 
-function readPreferredThinking(): Readonly<Record<string, ThinkingLevel>> {
-  try {
-    const config = readConfig()
-    const configured = config.preferredThinking
-    if (!configured || typeof configured !== "object") return {}
-
-    const preferredThinking: Record<string, ThinkingLevel> = {}
-    for (const [modelKey, level] of Object.entries(configured)) {
-      if (
-        typeof level === "string" &&
-        VALID_THINKING_LEVELS.has(level as ThinkingLevel)
-      ) {
-        preferredThinking[modelKey] = level as ThinkingLevel
-      }
-    }
+function getEnabledModels(settings: PiSettings): string[] {
+  return Array.isArray(settings.enabledModels)
+    ? settings.enabledModels.filter(
+        (entry): entry is string => typeof entry === "string",
+      )
+    : []
+}
 
-    return preferredThinking
-  } catch {
-    return {}
-  }
+function isExactModelEntry(entry: string, modelKey: string): boolean {
+  return (
+    entry === modelKey ||
+    THINKING_LEVEL_OPTIONS.some((level) => entry === `${modelKey}:${level}`)
+  )
 }
 
-function savePreferredThinking(
+function saveThinkingLevel(
   modelKey: string,
   level: ThinkingLevel | undefined,
 ): void {
-  const config = readConfig()
-  const configured = config.preferredThinking
-  const preferredThinking =
-    configured && typeof configured === "object" && !Array.isArray(configured)
-      ? { ...configured }
-      : {}
+  const settings = readSettings()
+  if (!Array.isArray(settings.enabledModels)) {
+    throw new Error(
+      "Pi enabledModels is not configured. Add the model with /scoped-models first.",
+    )
+  }
 
-  if (level) {
-    preferredThinking[modelKey] = level
-  } else {
-    delete preferredThinking[modelKey]
+  const entries = getEnabledModels(settings)
+  const exactIndex = entries.findIndex((entry) =>
+    isExactModelEntry(entry, modelKey),
+  )
+  const nextEntries = entries.filter(
+    (entry) => !isExactModelEntry(entry, modelKey),
+  )
+  const replacement = level
+    ? `${modelKey}:${level}`
+    : exactIndex >= 0
+      ? modelKey
+      : undefined
+
+  if (replacement) {
+    const insertAt =
+      exactIndex < 0 ? 0 : Math.min(exactIndex, nextEntries.length)
+    nextEntries.splice(insertAt, 0, replacement)
   }
 
-  config.preferredThinking = preferredThinking
-  mkdirSync(CONFIG_DIR, { recursive: true })
-  writeFileSync(CONFIG_PATH, `${JSON.stringify(config, null, 2)}\n`, "utf-8")
+  settings.enabledModels = nextEntries
+  mkdirSync(path.dirname(SETTINGS_PATH), { recursive: true })
+  writeFileSync(SETTINGS_PATH, `${JSON.stringify(settings, null, 2)}\n`, "utf8")
+}
+
+function getPinnedThinkingLevel(
+  ctx: ExtensionContext,
+  modelKey: string,
+): ThinkingLevel | undefined {
+  const scopedModel = ctx.scopedModels.find(
+    (entry) => getModelKey(entry.model.provider, entry.model.id) === modelKey,
+  )
+  if (scopedModel?.thinkingLevel !== undefined) {
+    return scopedModel.thinkingLevel
+  }
+
+  try {
+    const entry = getEnabledModels(readSettings()).find((candidate) =>
+      candidate.startsWith(`${modelKey}:`),
+    )
+    const level = entry?.slice(modelKey.length + 1) as ThinkingLevel | undefined
+    return level && THINKING_LEVEL_OPTIONS.includes(level) ? level : undefined
+  } catch {
+    return undefined
+  }
+}
+
+function clearHint(ctx: ExtensionContext): void {
+  if (hintTimer) {
+    clearTimeout(hintTimer)
+    hintTimer = undefined
+  }
+  ctx.ui.setWidget(HINT_WIDGET_KEY, undefined)
+}
+
+function showHint(ctx: ExtensionContext, modelKey: string): void {
+  if (!ctx.hasUI) return
+  clearHint(ctx)
+  ctx.ui.setWidget(
+    HINT_WIDGET_KEY,
+    [
+      `No saved thinking level for ${modelKey}.`,
+      "Run /preferred-thinking to set one.",
+    ],
+    { placement: "aboveEditor" },
+  )
+  hintTimer = setTimeout(() => {
+    ctx.ui.setWidget(HINT_WIDGET_KEY, undefined)
+    hintTimer = undefined
+  }, HINT_DURATION_MS)
 }
 
 function applyPreferredThinking(
   pi: ExtensionAPI,
-  provider: string,
-  modelId: string,
+  ctx: ExtensionContext,
+  model: NonNullable<ExtensionContext["model"]>,
 ): void {
-  const modelKey = getModelKey(provider, modelId)
-  const preferredThinking = readPreferredThinking()[modelKey]
-  if (!preferredThinking) return
+  const modelKey = getModelKey(model.provider, model.id)
+  const thinkingLevel = getPinnedThinkingLevel(ctx, modelKey)
+
+  if (thinkingLevel !== undefined) {
+    clearHint(ctx)
+    if (pi.getThinkingLevel() !== thinkingLevel) {
+      pi.setThinkingLevel(thinkingLevel)
+    }
+    return
+  }
 
-  if (pi.getThinkingLevel() !== preferredThinking) {
-    pi.setThinkingLevel(preferredThinking)
+  if (model.reasoning && !nudgedModels.has(modelKey)) {
+    nudgedModels.add(modelKey)
+    showHint(ctx, modelKey)
   }
 }
 
 async function configurePreferredThinking(
   pi: ExtensionAPI,
-  ctx: ExtensionContext,
+  ctx: ExtensionCommandContext,
 ): Promise<void> {
-  if (!ctx.model) {
+  const model = ctx.model
+  if (!model) {
     ctx.ui.notify("No current model selected.", "error")
     return
   }
 
-  const modelKey = getModelKey(ctx.model.provider, ctx.model.id)
-  const current = readPreferredThinking()[modelKey] ?? UNSET_OPTION
+  const modelKey = getModelKey(model.provider, model.id)
+  const current = getPinnedThinkingLevel(ctx, modelKey) ?? UNSET_OPTION
   const selected = await ctx.ui.select(
     `Preferred thinking for ${modelKey} (current: ${current})`,
     [...THINKING_LEVEL_OPTIONS, UNSET_OPTION],
   )
   if (selected === undefined) return
 
-  const level = VALID_THINKING_LEVELS.has(selected as ThinkingLevel)
+  const level = THINKING_LEVEL_OPTIONS.includes(selected as ThinkingLevel)
     ? (selected as ThinkingLevel)
     : undefined
 
   try {
-    savePreferredThinking(modelKey, level)
+    saveThinkingLevel(modelKey, level)
   } catch (error) {
-    const reason =
-      error instanceof SyntaxError ? "invalid JSON" : "write failed"
-    ctx.ui.notify(
-      `Could not update preferred thinking config: ${reason}.`,
-      "error",
-    )
+    const reason = error instanceof SyntaxError ? "invalid JSON" : String(error)
+    ctx.ui.notify(`Could not update Pi settings: ${reason}`, "error")
     return
   }
 
   if (level) {
     pi.setThinkingLevel(level)
-    ctx.ui.notify(`Preferred thinking for ${modelKey} set to ${level}.`, "info")
+    ctx.ui.notify(`Thinking for ${modelKey} set to ${level}.`, "info")
   } else {
-    ctx.ui.notify(`Preferred thinking for ${modelKey} unset.`, "info")
+    ctx.ui.notify(`Thinking pin for ${modelKey} removed.`, "info")
   }
+
+  await ctx.reload()
 }
 
 export default function (pi: ExtensionAPI): void {
   pi.registerCommand("preferred-thinking", {
-    description: "set the preferred thinking level for the current model",
+    description: "set the native thinking level for the current model",
     handler: async (_args, ctx) => {
       await configurePreferredThinking(pi, ctx)
     },
   })
 
   pi.on("session_start", async (_event, ctx) => {
-    if (!ctx.model) return
-    applyPreferredThinking(pi, ctx.model.provider, ctx.model.id)
+    nudgedModels.clear()
+    if (ctx.model) applyPreferredThinking(pi, ctx, ctx.model)
+  })
+
+  pi.on("model_select", async (event, ctx) => {
+    applyPreferredThinking(pi, ctx, event.model)
   })
 
-  pi.on("model_select", async (event) => {
-    applyPreferredThinking(pi, event.model.provider, event.model.id)
+  pi.on("session_shutdown", async (_event, ctx) => {
+    clearHint(ctx)
   })
 }

package/node_modules/@herbertgao/pi-recap/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tifan/pi-recap
 
+## 0.4.5
+
+### Patch Changes
+
+- [#116](https://github.com/HerbertGao/pi-extensions/pull/116) [`ecda398`](https://github.com/HerbertGao/pi-extensions/commit/ecda398b9a95212c512d53325c617e485e6ded8d) Thanks [@HerbertGao](https://github.com/HerbertGao)! - Use Pi 0.84.2 model-registry completion and authentication APIs for recap generation and model selection.
+
+## 0.4.5
+
+### Patch Changes
+
+- [`12ef66c`](https://github.com/tifandotme/pi-extensions/commit/12ef66c7ec6efe04202c91f70e20cd97e9c167f3) Thanks [@tifandotme](https://github.com/tifandotme)! - Require Pi 0.84.2 or newer for recap generation.
+
 ## 0.4.4
 
 ### Patch Changes

package/node_modules/@herbertgao/pi-recap/README.md

@@ -14,6 +14,8 @@ Re-enter a session without rereading the transcript.
 pi install npm:@herbertgao/pi-recap
 ```
 
+This package requires Pi 0.84.2 or newer.
+
 ## How it works
 
 - `/recap` generates a fresh, goal-first recap and shows it above the editor.
@@ -36,7 +38,7 @@ A good recap should answer "what was I trying to do here?". For example:
 
 ## Configuration
 
-Out of the box, `pi-recap` uses this default model: `openai-codex/gpt-5.4-mini`.
+Out of the box, `pi-recap` uses this default model: `openai-codex/gpt-5.6-luna`.
 
 Run `/recap config` to choose a different model.
 
@@ -48,13 +50,13 @@ You can also edit `~/.config/pi/extensions/pi-recap.json` manually:
 
 ```json
 {
-  "model": "openai-codex/gpt-5.4-mini"
+  "model": "openai-codex/gpt-5.6-luna"
 }
 ```
 
 ## Release notes
 
-See [CHANGELOG.md](CHANGELOG.md)
+See [CHANGELOG.md](CHANGELOG.md).
 
 ## License
 

package/node_modules/@herbertgao/pi-recap/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/pi-recap",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "One-line session recap on demand or after you have been away.",
   "keywords": [
     "pi",
@@ -32,6 +32,12 @@
     "access": "public",
     "provenance": true
   },
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": ">=0.84.2",
+    "@earendil-works/pi-ai": ">=0.84.2",
+    "@earendil-works/pi-coding-agent": ">=0.84.2",
+    "@earendil-works/pi-tui": ">=0.84.2"
+  },
   "engines": {
     "node": ">=20"
   },
@@ -42,8 +48,8 @@
   },
   "x-upstream": {
     "package": "@tifan/pi-recap",
-    "version": "0.4.4",
+    "version": "0.4.5",
     "repository": "https://github.com/tifandotme/pi-extensions",
-    "commit": "460d580"
+    "commit": "b39d1e6359c78718cbf8fe5c74c82b89065e9a0b"
   }
 }

package/node_modules/@herbertgao/pi-recap/src/index.ts

@@ -1,5 +1,5 @@
 import type { AgentMessage } from "@earendil-works/pi-agent-core"
-import { complete, type Message } from "@earendil-works/pi-ai/compat"
+import type { Message } from "@earendil-works/pi-ai"
 import type { AutocompleteItem } from "@earendil-works/pi-tui"
 import type {
   ExtensionAPI,
@@ -276,22 +276,18 @@ async function generateRecap(
     return
   }
 
-  const auth = modelAuth.auth
-
   const abortController = new AbortController()
   abortPendingGeneration(state)
   state.abortController = abortController
 
   try {
-    const response = await complete(
-      auth.model,
+    const response = await ctx.modelRegistry.complete(
+      modelAuth.auth,
       {
         systemPrompt: RECAP_SYSTEM_PROMPT,
         messages: [buildPrompt(messages)],
       },
       {
-        apiKey: auth.apiKey,
-        ...(auth.headers ? { headers: auth.headers } : {}),
         maxTokens: RECAP_MAX_TOKENS,
         maxRetries: 0,
         cacheRetention: "none",

package/node_modules/@herbertgao/pi-recap/src/model-picker.ts

@@ -13,7 +13,6 @@ import {
   type RecapModelPreference,
 } from "./models.js"
 
-const USE_DEFAULT_VALUE = "__pi-recap-default__"
 const MAX_VISIBLE_ITEMS = 10
 
 export type ModelPickerResult =
@@ -22,7 +21,6 @@ export type ModelPickerResult =
   | { action: "cancel" }
 
 interface ModelPickerItem {
-  readonly value: string
   readonly label: string
   readonly description?: string
   readonly model?: RecapModelPreference
@@ -43,12 +41,10 @@ class RecapModelPicker implements Component, Focusable {
     this.theme = theme
     this.items = [
       {
-        value: USE_DEFAULT_VALUE,
         label: "Use default",
         description: formatRecapModelKey(DEFAULT_RECAP_MODEL),
       },
       ...models.map((model) => ({
-        value: formatRecapModelKey(model),
         label: formatRecapModelKey(model),
         model,
       })),
@@ -90,11 +86,7 @@ class RecapModelPicker implements Component, Focusable {
     } else {
       for (const [index, item] of visibleItems.entries()) {
         lines.push(
-          this.renderItem(
-            item,
-            startIndex + index === this.selectedIndex,
-            width,
-          ),
+          this.renderItem(item, startIndex + index === this.selectedIndex),
         )
       }
     }
@@ -146,11 +138,7 @@ class RecapModelPicker implements Component, Focusable {
     }
   }
 
-  private renderItem(
-    item: ModelPickerItem,
-    isSelected: boolean,
-    width: number,
-  ): string {
+  private renderItem(item: ModelPickerItem, isSelected: boolean): string {
     const prefix = isSelected ? "→ " : "  "
     const label = isSelected
       ? this.theme.fg("accent", item.label)
@@ -158,7 +146,7 @@ class RecapModelPicker implements Component, Focusable {
     const description = item.description
       ? this.theme.fg("dim", ` ${item.description}`)
       : ""
-    return truncateToWidth(`${prefix}${label}${description}`, width)
+    return `${prefix}${label}${description}`
   }
 
   private moveSelection(delta: number): void {
@@ -171,14 +159,13 @@ class RecapModelPicker implements Component, Focusable {
     const item = this.getFilteredItems()[this.selectedIndex]
     if (!item) return
 
-    if (item.value === USE_DEFAULT_VALUE) {
+    const model = item.model
+    if (!model) {
       this.onDone({ action: "default" })
       return
     }
 
-    if (item.model) {
-      this.onDone({ action: "model", model: item.model })
-    }
+    this.onDone({ action: "model", model })
   }
 
   private getFilter(): string {

package/node_modules/@herbertgao/pi-recap/src/models.ts

@@ -6,7 +6,7 @@ import {
   writeFileSync,
 } from "node:fs"
 import path from "node:path"
-import type { Api, Model, ProviderHeaders } from "@earendil-works/pi-ai"
+import type { Api, Model } from "@earendil-works/pi-ai"
 import {
   getAgentDir,
   type ExtensionContext,
@@ -20,12 +20,6 @@ export interface RecapModelPreference {
   readonly id: string
 }
 
-export interface FastModelAuth {
-  readonly model: Model<Api>
-  readonly apiKey: string
-  readonly headers: ProviderHeaders | undefined
-}
-
 export type RecapModelConfig =
   | { readonly kind: "missing" }
   | { readonly kind: "invalid" }
@@ -34,7 +28,7 @@ export type RecapModelConfig =
 export type ResolvedRecapModelAuth =
   | {
       readonly status: "ok"
-      readonly auth: FastModelAuth
+      readonly auth: Model<Api>
       readonly source: "configured" | "default"
     }
   | { readonly status: "invalid-config" }
@@ -66,8 +60,8 @@ export function formatRecapModelKey({
   return `${provider}/${id}`
 }
 
-export function formatAuthModelKey(auth: FastModelAuth): string {
-  return `${auth.model.provider}/${auth.model.id}`
+export function formatAuthModelKey(auth: Model<Api>): string {
+  return `${auth.provider}/${auth.id}`
 }
 
 export function parseModelSpec(
@@ -127,21 +121,15 @@ export function resolveInitialModelConfig(): RecapModelConfig {
 async function getModelAuth(
   ctx: ExtensionContext,
   modelPreference: RecapModelPreference,
-): Promise<FastModelAuth | undefined> {
+): Promise<Model<Api> | undefined> {
   const model = ctx.modelRegistry.find(
     modelPreference.provider,
     modelPreference.id,
   )
   if (!model) return undefined
 
-  const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model)
-  return auth.ok && auth.apiKey
-    ? {
-        model,
-        apiKey: auth.apiKey,
-        headers: auth.headers,
-      }
-    : undefined
+  const auth = await ctx.modelRegistry.getProviderAuth(model.provider)
+  return auth?.auth.apiKey ? model : undefined
 }
 
 export async function getRecapModelAuth(
@@ -181,8 +169,8 @@ export async function getAuthenticatedTextModelPreferences(
     .filter((model) => model.input.includes("text"))
   const authenticatedModels = await Promise.all(
     models.map(async (model) => {
-      const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model)
-      return auth.ok && auth.apiKey ? toModelPreference(model) : undefined
+      const auth = await ctx.modelRegistry.getProviderAuth(model.provider)
+      return auth?.auth.apiKey ? toModelPreference(model) : undefined
     }),
   )
 

package/node_modules/@herbertgao/pi-recap/src/tui.ts

@@ -82,7 +82,7 @@ class PiRecapLine implements Component {
     const labelWidth = visibleWidth(LABEL)
     const label = this.renderLabel()
 
-    if (width < MIN_RECAP_WIDTH || width <= labelWidth) {
+    if (width < MIN_RECAP_WIDTH) {
       return [
         truncateToWidth(this.theme.fg("muted", `${LABEL}${this.recap}`), width),
       ]

package/node_modules/@herbertgao/pi-rename/CHANGELOG.md

@@ -0,0 +1,49 @@
+# @tifan/pi-rename
+
+## 0.5.0
+
+### Minor Changes
+
+- [#116](https://github.com/HerbertGao/pi-extensions/pull/116) [`ecda398`](https://github.com/HerbertGao/pi-extensions/commit/ecda398b9a95212c512d53325c617e485e6ded8d) Thanks [@HerbertGao](https://github.com/HerbertGao)! - Use Pi 0.84.2 model-registry APIs, show rename progress, and synchronize generated names across Herdr panes and tabs.
+
+## 0.5.0
+
+### Minor Changes
+
+- [`b2ea184`](https://github.com/tifandotme/pi-extensions/commit/b2ea1841e99243aa4773bd5c33f43c40248859db) Thanks [@tifandotme](https://github.com/tifandotme)! - Update Herdr synchronization to rename the current pane in split tabs and both the pane and tab in single-pane tabs.
+
+## 0.4.3
+
+### Patch Changes
+
+- [`e8709bc`](https://github.com/tifandotme/pi-extensions/commit/e8709bc388aa8e094918ec465cfab511358f18ff) Thanks [@tifandotme](https://github.com/tifandotme)! - Require Pi 0.84.2 or newer and show progress while `/rename` generates a session name.
+
+## 0.4.2
+
+### Patch Changes
+
+- [`b27ba8a`](https://github.com/tifandotme/pi-extensions/commit/b27ba8aef49ea00879cec87d913840f39e02b19e) Thanks [@tifandotme](https://github.com/tifandotme)! - Use gpt-5.6-luna by default and keep Herdr tab names after quitting Pi.
+
+## 0.4.1
+
+### Patch Changes
+
+- [`ba259a0`](https://github.com/tifandotme/pi-extensions/commit/ba259a0c990563e4dad3443371cc2ed31d122cd0) Thanks [@tifandotme](https://github.com/tifandotme)! - Keep model-powered handoffs and session names compatible with Pi 0.80.
+
+## 0.4.0
+
+### Minor Changes
+
+- [`416ac2f`](https://github.com/tifandotme/pi-extensions/commit/416ac2fecc6aa731c23ae895220bac87317152e4) Thanks [@tifandotme](https://github.com/tifandotme)! - Expose the rename naming utilities through the package exports for reuse.
+
+## 0.3.0
+
+### Minor Changes
+
+- [`57565bd`](https://github.com/tifandotme/pi-extensions/commit/57565bd14cf86cb51ca5ba5c6d937568fc4e251f) Thanks [@tifandotme](https://github.com/tifandotme)! - Sync Herdr tab labels with saved pi session names on resume, and reset matching tab labels to the tab number when pi quits.
+
+## 0.2.0
+
+### Minor Changes
+
+- [`392f57c`](https://github.com/tifandotme/pi-extensions/commit/392f57c3dd62858d41f462801ef53773596e3f96) Thanks [@tifandotme](https://github.com/tifandotme)! - Add `/rename` to generate hyphen-separated session names, configure the rename model, and mirror names to the current Herdr tab.