pi-better-openai 0.1.21 → 0.1.22

package/README.md

@@ -4,6 +4,8 @@ A pi extension for OpenAI subscription workflows: fast mode, usage visibility, f
 
 ## Install
 
+Requires Node.js 22.19.0 or newer.
+
 Install from GitHub:
 
 ```bash
@@ -52,7 +54,15 @@ Project overrides global. Global values fill fields omitted by the project file.
 Default supported models:
 
 ```json
-["openai/gpt-5.4", "openai/gpt-5.5", "openai-codex/gpt-5.4", "openai-codex/gpt-5.5"]
+[
+  "openai/gpt-5.4",
+  "openai/gpt-5.5",
+  "openai-codex/gpt-5.6-sol",
+  "openai-codex/gpt-5.6-terra",
+  "openai-codex/gpt-5.6-luna",
+  "openai-codex/gpt-5.4",
+  "openai-codex/gpt-5.5"
+]
 ```
 
 Example config:
@@ -146,7 +156,7 @@ Then reload Codex skills (`Cmd/Ctrl+K → Force Reload Skills`) and ask:
 $hatch-pet create a new pet inspired by pi-better-openai
 ```
 
-Custom pets should end up in `${CODEX_HOME:-~/.codex}/pets/<pet-name>/` with `pet.json` and `spritesheet.webp`. Refresh custom pets in Codex settings and toggle the overlay with `/pet`.
+Custom pets should end up in `${CODEX_HOME:-~/.codex}/pets/<pet-name>/` with `pet.json` and `spritesheet.webp`. The spritesheet must be a 1536×1872 atlas arranged as 8 columns by 9 animation rows. Animated footer rendering also requires a terminal image protocol supported by pi. Refresh custom pets in Codex settings and toggle the overlay with `/pet`.
 
 ## Screenshots
 

package/index.ts

@@ -4,7 +4,6 @@
  * Adds `service_tier: "priority"` to OpenAI provider payloads while fast mode is
  * enabled and the selected model is in the configured allow-list.
  */
-import { sep } from "node:path";
 import {
   getSettingsListTheme,
   type ExtensionAPI,
@@ -33,7 +32,6 @@ import {
   type SettingsOptionDescriptor,
   configPaths,
   type ResolvedConfig,
-  type PetPlacement,
   type PetState,
   isRecord,
   parseModelKey,
@@ -65,6 +63,13 @@ import {
 import { FastController, modelList, supportsFast } from "./src/fast-controller.ts";
 import { UsageController } from "./src/usage-controller.ts";
 import { PetFooterController } from "./src/pet-footer-controller.ts";
+import {
+  abbreviateHomePath,
+  combineInlinePetFooter,
+  isInlinePetPlacement,
+  isTerminalImageLine,
+  petSizeCellsForPlacement,
+} from "./src/footer-layout.ts";
 
 const COMMAND = "fast";
 const OPENAI_STATUS_COMMAND = "openai-usage";
@@ -84,28 +89,10 @@ type SettingsPickerItem = {
   ) => { render(width: number): string[]; invalidate(): void; handleInput?(data: string): void };
 };
 
-function abbreviateHomePath(
-  path: string,
-  home = process.env.HOME || process.env.USERPROFILE,
-): string {
-  if (!home) return path;
-  if (path === home) return "~";
-  const homePrefix = home.endsWith(sep) ? home : `${home}${sep}`;
-  return path.startsWith(homePrefix) ? `~/${path.slice(homePrefix.length)}` : path;
-}
-
-function isInlinePetPlacement(placement: PetPlacement): boolean {
-  return placement === "inline-left" || placement === "inline-right" || placement === "badge";
-}
-
 function hasTerminalUI(ctx: ExtensionContext): boolean {
   return ctx.mode === "tui" || (ctx.mode === undefined && ctx.hasUI);
 }
 
-function petSizeCellsForPlacement(placement: PetPlacement, sizeCells: number): number {
-  return placement === "badge" ? Math.min(6, sizeCells) : sizeCells;
-}
-
 function readyPetPickerValues(pets: CodexPetPackage[]): string[] | undefined {
   const readyPets = pets.filter((pet) => pet.hasSpritesheet);
   return readyPets.length > 0 ? readyPets.map((pet) => pet.slug) : undefined;
@@ -131,8 +118,8 @@ function petPickerDescription(cfg: ResolvedConfig, pets: CodexPetPackage[]): str
   if (readyPets.length === 0)
     return "No ready custom pets found. Use /pets help to create one, then return here.";
   if (!cfg.pets.slug) {
-    const firstPet = readyPets[0];
-    const lastPet = readyPets[readyPets.length - 1];
+    const firstPet = readyPets[0]!;
+    const lastPet = readyPets[readyPets.length - 1]!;
     return `No pet selected. Enter/Space/→ selects ${firstPet.name}; ← selects ${lastPet.name}.`;
   }
   const selectedPet = findPickerPet(cfg.pets.slug, readyPets);
@@ -169,84 +156,6 @@ function formatPetSelectPrompt(
   return { message: lines.join("\n"), level: "info" };
 }
 
-function spaces(width: number): string {
-  return " ".repeat(Math.max(0, width));
-}
-
-function padTextToWidth(value: string, width: number): string {
-  return value + spaces(width - visibleWidth(value));
-}
-
-function isTerminalImageLine(line: string): boolean {
-  return line.includes("\x1b_G") || line.includes("\x1b]1337;File=");
-}
-
-function petLineCell(line: string, width: number): string {
-  if (!line) return spaces(width);
-  if (isTerminalImageLine(line)) return `\x1b[0m${line}`;
-  const clipped = truncateToWidth(line, width, "");
-  return clipped + spaces(width - visibleWidth(clipped));
-}
-
-function stripLeadingCursorUp(line: string): string {
-  if (!line.startsWith("\x1b[")) return line;
-  const end = line.indexOf("A", 2);
-  if (end === -1) return line;
-  return /^\d+$/.test(line.slice(2, end)) ? line.slice(end + 1) : line;
-}
-
-function stripTrailingCursorDown(line: string): string {
-  if (!line.endsWith("B")) return line;
-  const start = line.lastIndexOf("\x1b[");
-  if (start === -1) return line;
-  return /^\d+$/.test(line.slice(start + 2, -1)) ? line.slice(0, start) : line;
-}
-
-function terminalImageInlineLeftSequence(line: string, totalRows: number): string {
-  const moveUp = totalRows > 1 ? `\x1b[${totalRows - 1}A` : "";
-  const moveDown = totalRows > 1 ? `\x1b[${totalRows - 1}B` : "";
-  const balancedLine = stripTrailingCursorDown(stripLeadingCursorUp(line));
-  return `\x1b[0m\r${moveUp}${balancedLine}${moveDown}`;
-}
-
-function combineInlinePetFooter(
-  petLines: string[],
-  textLines: string[],
-  width: number,
-  placement: PetPlacement,
-  petWidth: number,
-): string[] {
-  const gap = 2;
-  const textWidth = Math.max(1, width - petWidth - gap);
-  const totalRows = Math.max(petLines.length, textLines.length);
-  const petStart = 0;
-  const textStart = 0;
-  const hasTerminalImageLine = petLines.some(isTerminalImageLine);
-  const leftImageLine =
-    placement === "inline-left" ? petLines.find(isTerminalImageLine) : undefined;
-  const renderPetOnRight =
-    placement === "inline-right" || (placement !== "inline-left" && hasTerminalImageLine);
-  const lines: string[] = [];
-
-  for (let row = 0; row < totalRows; row++) {
-    const petLine = row >= petStart ? (petLines[row - petStart] ?? "") : "";
-    const textLine = row >= textStart ? (textLines[row - textStart] ?? "") : "";
-    const textPart = truncateToWidth(textLine, textWidth, "...");
-    const petPart = leftImageLine ? spaces(petWidth) : petLineCell(petLine, petWidth);
-    if (renderPetOnRight) {
-      lines.push(`${padTextToWidth(textPart, textWidth)}${spaces(gap)}${petPart}`);
-    } else {
-      lines.push(`${petPart}${spaces(gap)}${textPart}`);
-    }
-  }
-
-  if (leftImageLine && lines.length > 0) {
-    lines[lines.length - 1] += terminalImageInlineLeftSequence(leftImageLine, totalRows);
-  }
-
-  return lines;
-}
-
 function textPanel(title: string, lines: string[], done: () => void) {
   return {
     render(width: number) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-openai",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "Personal pi extension that improves OpenAI with fast mode, usage stats, and footer polish.",
   "keywords": [
     "fast",
@@ -43,7 +43,7 @@
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "0.80.6",
     "@earendil-works/pi-tui": "0.80.6",
-    "@types/node": "^24.13.2",
+    "@types/node": "~22.19.0",
     "oxfmt": "^0.47.0",
     "oxlint": "^1.62.0",
     "typescript": "^6.0.3",

package/src/config.ts

@@ -29,6 +29,9 @@ export const PET_STATES = [
 export const DEFAULT_SUPPORTED_MODELS = [
   "openai/gpt-5.4",
   "openai/gpt-5.5",
+  "openai-codex/gpt-5.6-sol",
+  "openai-codex/gpt-5.6-terra",
+  "openai-codex/gpt-5.6-luna",
   "openai-codex/gpt-5.4",
   "openai-codex/gpt-5.5",
 ] as const;

package/src/fast-controller.ts

@@ -40,8 +40,11 @@ export class FastController {
   private lastInjectedAt: number | undefined;
   private lastInjectedModel: string | undefined;
   private lastInjectedTier: string | undefined;
+  private readonly serviceTier: string;
 
-  constructor(private readonly serviceTier: string) {}
+  constructor(serviceTier: string) {
+    this.serviceTier = serviceTier;
+  }
 
   applyDesiredState(ctx: ExtensionContext, cfg: ResolvedConfig): void {
     this.active = this.desiredActive && supportsFast(ctx, cfg.supportedModels);

package/src/footer-layout.ts

@@ -0,0 +1,97 @@
+import { sep } from "node:path";
+import type { PetPlacement } from "./config.ts";
+import { truncateToWidth, visibleWidth } from "./format.ts";
+
+export function abbreviateHomePath(
+  path: string,
+  home = process.env.HOME || process.env.USERPROFILE,
+): string {
+  if (!home) return path;
+  if (path === home) return "~";
+  const homePrefix = home.endsWith(sep) ? home : `${home}${sep}`;
+  return path.startsWith(homePrefix) ? `~/${path.slice(homePrefix.length)}` : path;
+}
+
+export function isInlinePetPlacement(placement: PetPlacement): boolean {
+  return placement === "inline-left" || placement === "inline-right" || placement === "badge";
+}
+
+export function petSizeCellsForPlacement(placement: PetPlacement, sizeCells: number): number {
+  return placement === "badge" ? Math.min(6, sizeCells) : sizeCells;
+}
+
+function spaces(width: number): string {
+  return " ".repeat(Math.max(0, width));
+}
+
+function padTextToWidth(value: string, width: number): string {
+  return value + spaces(width - visibleWidth(value));
+}
+
+export function isTerminalImageLine(line: string): boolean {
+  return line.includes("\x1b_G") || line.includes("\x1b]1337;File=");
+}
+
+function petLineCell(line: string, width: number): string {
+  if (!line) return spaces(width);
+  if (isTerminalImageLine(line)) return `\x1b[0m${line}`;
+  const clipped = truncateToWidth(line, width, "");
+  return clipped + spaces(width - visibleWidth(clipped));
+}
+
+function stripLeadingCursorUp(line: string): string {
+  if (!line.startsWith("\x1b[")) return line;
+  const end = line.indexOf("A", 2);
+  if (end === -1) return line;
+  return /^\d+$/.test(line.slice(2, end)) ? line.slice(end + 1) : line;
+}
+
+function stripTrailingCursorDown(line: string): string {
+  if (!line.endsWith("B")) return line;
+  const start = line.lastIndexOf("\x1b[");
+  if (start === -1) return line;
+  return /^\d+$/.test(line.slice(start + 2, -1)) ? line.slice(0, start) : line;
+}
+
+function terminalImageInlineLeftSequence(line: string, totalRows: number): string {
+  const moveUp = totalRows > 1 ? `\x1b[${totalRows - 1}A` : "";
+  const moveDown = totalRows > 1 ? `\x1b[${totalRows - 1}B` : "";
+  const balancedLine = stripTrailingCursorDown(stripLeadingCursorUp(line));
+  return `\x1b[0m\r${moveUp}${balancedLine}${moveDown}`;
+}
+
+export function combineInlinePetFooter(
+  petLines: string[],
+  textLines: string[],
+  width: number,
+  placement: PetPlacement,
+  petWidth: number,
+): string[] {
+  const gap = 2;
+  const textWidth = Math.max(1, width - petWidth - gap);
+  const totalRows = Math.max(petLines.length, textLines.length);
+  const hasTerminalImageLine = petLines.some(isTerminalImageLine);
+  const leftImageLine =
+    placement === "inline-left" ? petLines.find(isTerminalImageLine) : undefined;
+  const renderPetOnRight =
+    placement === "inline-right" || (placement !== "inline-left" && hasTerminalImageLine);
+  const lines: string[] = [];
+
+  for (let row = 0; row < totalRows; row++) {
+    const petLine = petLines[row] ?? "";
+    const textLine = textLines[row] ?? "";
+    const textPart = truncateToWidth(textLine, textWidth, "...");
+    const petPart = leftImageLine ? spaces(petWidth) : petLineCell(petLine, petWidth);
+    if (renderPetOnRight) {
+      lines.push(`${padTextToWidth(textPart, textWidth)}${spaces(gap)}${petPart}`);
+    } else {
+      lines.push(`${petPart}${spaces(gap)}${textPart}`);
+    }
+  }
+
+  if (leftImageLine && lines.length > 0) {
+    lines[lines.length - 1] += terminalImageInlineLeftSequence(leftImageLine, totalRows);
+  }
+
+  return lines;
+}

package/src/image.ts

@@ -296,7 +296,11 @@ function buildRequest(
 
 function dataUrlParts(value: string, fallbackMimeType: string): { data: string; mimeType: string } {
   const match = value.match(/^data:([^;,]+);base64,(.*)$/s);
-  if (match) return { mimeType: match[1] || fallbackMimeType, data: match[2].trim() };
+  if (match)
+    return {
+      mimeType: match[1] || fallbackMimeType,
+      data: (match[2] ?? "").trim(),
+    };
   return { data: value.trim(), mimeType: fallbackMimeType };
 }
 

package/src/pet-footer-controller.ts

@@ -117,12 +117,19 @@ export class PetFooterController {
   private requestFooterRender: (() => void) | undefined;
   private requestSettingsRender: (() => void) | undefined;
   private shuttingDown = false;
+  private readonly getConfig: (ctx: ExtensionContext) => ResolvedConfig;
+  private readonly updateFooter: (ctx: ExtensionContext) => void;
+  private readonly getFooterInstalled: () => boolean;
 
   constructor(
-    private readonly getConfig: (ctx: ExtensionContext) => ResolvedConfig,
-    private readonly updateFooter: (ctx: ExtensionContext) => void,
-    private readonly getFooterInstalled: () => boolean = () => false,
-  ) {}
+    getConfig: (ctx: ExtensionContext) => ResolvedConfig,
+    updateFooter: (ctx: ExtensionContext) => void,
+    getFooterInstalled: () => boolean = () => false,
+  ) {
+    this.getConfig = getConfig;
+    this.updateFooter = updateFooter;
+    this.getFooterInstalled = getFooterInstalled;
+  }
 
   get loadedPet(): LoadedCodexPet | undefined {
     return this.pet;
@@ -239,6 +246,14 @@ export class PetFooterController {
     }
   }
 
+  private recallRender(key: string): string[] | undefined {
+    const lines = this.petRenderCache.get(key);
+    if (!lines) return undefined;
+    this.petRenderCache.delete(key);
+    this.petRenderCache.set(key, lines);
+    return lines;
+  }
+
   isResizeFrozen(now = Date.now()): boolean {
     return now < this.petResizeFreezeUntil;
   }
@@ -568,7 +583,7 @@ export class PetFooterController {
             options.petColumnWidth,
             options.petRenderSizeCells,
           );
-          const cachedPetLines = this.petRenderCache.get(cacheKey);
+          const cachedPetLines = this.recallRender(cacheKey);
           if (cachedPetLines) {
             petLines.push(...cachedPetLines);
             return petLines;

package/src/pets.ts

@@ -276,7 +276,8 @@ async function readCodexPetPackages(
   const readNext = async (): Promise<void> => {
     while (nextIndex < entries.length) {
       const index = nextIndex++;
-      pets[index] = await readCodexPetPackage(petsDir, entries[index], options);
+      const entry = entries[index];
+      if (entry) pets[index] = await readCodexPetPackage(petsDir, entry, options);
     }
   };
   await Promise.all(
@@ -622,7 +623,7 @@ export function nextAnimationFrameDelayMs(
     if (cursor < duration) return Math.max(1, Math.ceil(duration - cursor));
     cursor -= duration;
   }
-  return Math.max(1, Math.ceil(frames[0].durationMs));
+  return Math.max(1, Math.ceil(frames[0]!.durationMs));
 }
 
 function forEachCodexPetFrame(
@@ -691,8 +692,11 @@ function encodeKittyRawRgba(frame: PetFrame, imageId: number): string {
 export class CodexPetKittyManager {
   private previousFrameImageId: number | undefined;
   private readonly pendingCleanupImageIds = new Set<number>();
+  readonly placementImageId: number;
 
-  constructor(readonly placementImageId: number) {}
+  constructor(placementImageId: number) {
+    this.placementImageId = placementImageId;
+  }
 
   queueCleanup(pet?: LoadedCodexPet): void {
     for (const imageId of codexPetKittyImageIds(pet)) this.pendingCleanupImageIds.add(imageId);

package/src/usage-controller.ts

@@ -55,11 +55,16 @@ export class UsageController {
   private sessionAbortSignal: AbortSignal | undefined;
   private sessionAbortHandler: (() => void) | undefined;
   private sessionGeneration = 0;
+  private readonly getConfig: (ctx: ExtensionContext) => ResolvedConfig;
+  private readonly updateFooter: (ctx: ExtensionContext) => void;
 
   constructor(
-    private readonly getConfig: (ctx: ExtensionContext) => ResolvedConfig,
-    private readonly updateFooter: (ctx: ExtensionContext) => void,
-  ) {}
+    getConfig: (ctx: ExtensionContext) => ResolvedConfig,
+    updateFooter: (ctx: ExtensionContext) => void,
+  ) {
+    this.getConfig = getConfig;
+    this.updateFooter = updateFooter;
+  }
 
   get snapshot(): UsageSnapshot | undefined {
     return this.usageSnapshot;