pi-spark 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.26.0](https://github.com/zlliang/pi-spark/compare/v0.25.0...v0.26.0) (2026-09-20)
+
+
+### ⚠ BREAKING CHANGES
+
+* Require Pi 0.86.0 or later.
+
+### Features
+
+* adopt Pi 0.86 model and usage APIs ([5d5868d](https://github.com/zlliang/pi-spark/commit/5d5868defdad303a0b8a9761b013886a198c268d))
+
 ## [0.25.0](https://github.com/zlliang/pi-spark/compare/v0.24.0...v0.25.0) (2026-09-14)
 
 

package/docs/background-model-calls-and-openai-codex-sessions.md

@@ -73,3 +73,5 @@ The independent-session design preserves the main thread's WebSocket reuse, `pre
 Cache admission remains provider-controlled and noisy. In repeated GPT-5.6 Luna title A/B probes, isolated background calls caused no continuation errors and showed no negative main-thread cache trend. Main second-turn latency remained around the normal control range instead of paying the reconnect penalty seen when the shared main socket was closed.
 
 Use the [`measuring-model-cache`](../.agents/skills/measuring-model-cache/SKILL.md) skill to repeat the comparison after changes to Pi, providers, session handling, title, recap, or other background model features.
+
+**Update Sep 19, 2026:** Background calls now use Pi 0.86's `ctx.modelRegistry.streamSimple(...).result()` to support extension-registered providers and resolve authentication automatically. Independent Codex UUIDv7 sessions and cleanup in `finally` remain unchanged.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-spark",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Pi package that polishes your daily experience",
   "keywords": [
     "pi-coding-agent",
@@ -44,17 +44,17 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@earendil-works/pi-agent-core": ">=0.85.0",
-    "@earendil-works/pi-ai": ">=0.85.0",
-    "@earendil-works/pi-coding-agent": ">=0.85.0",
-    "@earendil-works/pi-tui": ">=0.85.0",
+    "@earendil-works/pi-agent-core": ">=0.86.0",
+    "@earendil-works/pi-ai": ">=0.86.0",
+    "@earendil-works/pi-coding-agent": ">=0.86.0",
+    "@earendil-works/pi-tui": ">=0.86.0",
     "typebox": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-agent-core": ">=0.85.0",
-    "@earendil-works/pi-ai": ">=0.85.0",
-    "@earendil-works/pi-coding-agent": ">=0.85.0",
-    "@earendil-works/pi-tui": ">=0.85.0",
+    "@earendil-works/pi-agent-core": ">=0.86.0",
+    "@earendil-works/pi-ai": ">=0.86.0",
+    "@earendil-works/pi-coding-agent": ">=0.86.0",
+    "@earendil-works/pi-tui": ">=0.86.0",
     "@types/node": "*",
     "typebox": "*",
     "typescript": "^7.0.2"

package/src/features/recap/manager.ts

@@ -4,7 +4,7 @@ import { clearRecapWidget, setRecapLoadingWidget, setRecapTextWidget } from "./w
 import { sanitizeText } from "../../utils/format";
 import { completeBackground, resolveModelSettings } from "../../utils/model";
 
-import type { Api, Model, ModelThinkingLevel, SimpleStreamOptions, Usage } from "@earendil-works/pi-ai";
+import type { Api, Model, ModelThinkingLevel, Usage } from "@earendil-works/pi-ai";
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { RecapConfig } from "./config";
 
@@ -82,23 +82,18 @@ export class RecapManager {
   }
 
   private async generate(ctx: ExtensionContext, model: Model<Api>, thinkingLevel: ModelThinkingLevel, signal: AbortSignal): Promise<{ content: string; usage: Usage }> {
-    const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
-    if (!auth.ok) throw new Error(auth.error);
-
-    const options: SimpleStreamOptions = { maxTokens: MAX_TOKENS, signal };
-    if (auth.apiKey) options.apiKey = auth.apiKey;
-    if (auth.headers) options.headers = auth.headers;
-    if (auth.env) options.env = auth.env;
-    if (thinkingLevel !== "off") options.reasoning = thinkingLevel;
-
-    const response = await completeBackground(model, {
+    const response = await completeBackground(ctx, model, {
       systemPrompt: SYSTEM_PROMPT,
       messages: [{
         role: "user",
         content: [{ type: "text", text: this.buildPrompt(ctx) }],
         timestamp: Date.now(),
       }],
-    }, options);
+    }, {
+      maxTokens: MAX_TOKENS,
+      signal,
+      reasoning: thinkingLevel === "off" ? undefined : thinkingLevel,
+    });
 
     if (response.stopReason === "error") {
       throw new Error(response.errorMessage ?? "Recap generation failed");

package/src/features/title/manager.ts

@@ -3,7 +3,7 @@ import { convertToLlm, serializeConversation } from "@earendil-works/pi-coding-a
 import { sanitizeText } from "../../utils/format";
 import { completeBackground, resolveModelSettings } from "../../utils/model";
 
-import type { Api, Model, ModelThinkingLevel, SimpleStreamOptions, Usage } from "@earendil-works/pi-ai";
+import type { Api, Model, ModelThinkingLevel, Usage } from "@earendil-works/pi-ai";
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { TitleConfig } from "./config";
 
@@ -64,23 +64,18 @@ export class TitleManager {
   }
 
   private async generate(ctx: ExtensionContext, model: Model<Api>, thinkingLevel: ModelThinkingLevel, signal: AbortSignal): Promise<{ content: string; usage: Usage }> {
-    const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
-    if (!auth.ok) throw new Error(auth.error);
-
-    const options: SimpleStreamOptions = { maxTokens: MAX_TOKENS, signal };
-    if (auth.apiKey) options.apiKey = auth.apiKey;
-    if (auth.headers) options.headers = auth.headers;
-    if (auth.env) options.env = auth.env;
-    if (thinkingLevel !== "off") options.reasoning = thinkingLevel;
-
-    const response = await completeBackground(model, {
+    const response = await completeBackground(ctx, model, {
       systemPrompt: SYSTEM_PROMPT,
       messages: [{
         role: "user",
         content: [{ type: "text", text: this.buildPrompt(ctx) }],
         timestamp: Date.now(),
       }],
-    }, options);
+    }, {
+      maxTokens: MAX_TOKENS,
+      signal,
+      reasoning: thinkingLevel === "off" ? undefined : thinkingLevel,
+    });
 
     if (response.stopReason === "error") {
       throw new Error(response.errorMessage ?? "Title generation failed");

package/src/utils/model.ts

@@ -1,10 +1,9 @@
 import { uuidv7 } from "@earendil-works/pi-agent-core";
 import { clampThinkingLevel, cleanupSessionResources } from "@earendil-works/pi-ai";
-import { completeSimple } from "@earendil-works/pi-ai/compat";
 
 import { formatModel } from "./format";
 
-import type { Api, Model, ModelThinkingLevel } from "@earendil-works/pi-ai";
+import type { Api, AssistantMessage, Context, Model, ModelsSimpleStreamOptions, ModelThinkingLevel } from "@earendil-works/pi-ai";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { OptionalModelConfig } from "../config/model";
 
@@ -30,17 +29,17 @@ type ThinkingLevelSelection = {
  * Completes a one-shot background request, using an isolated session for OpenAI Codex models.
  * See [the investigation](../../docs/background-model-calls-and-openai-codex-sessions.md).
  */
-export const completeBackground: typeof completeSimple = async (model, context, options) => {
-  if (model.api !== "openai-codex-responses") return completeSimple(model, context, options);
+export async function completeBackground(ctx: ExtensionContext, model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): Promise<AssistantMessage> {
+  if (model.api !== "openai-codex-responses") return ctx.modelRegistry.streamSimple(model, context, options).result();
 
   const sessionId = uuidv7();
 
   try {
-    return await completeSimple(model, context, { ...options, sessionId });
+    return await ctx.modelRegistry.streamSimple(model, context, { ...options, sessionId }).result();
   } finally {
     cleanupSessionResources(sessionId);
   }
-};
+}
 
 /**
  * Resolves the model and thinking level for a background feature (recap, title, ...).

package/src/utils/usage.ts

@@ -33,7 +33,7 @@ export function isUsage(value: unknown): value is Usage {
  * - `message` carries them on `message`.
  * - `custom` on `data`.
  * - `custom_message` on `details`.
- * - `compaction` and `branch_summary` directly on the entry.
+ * - `usage`, `compaction`, and `branch_summary` directly on the entry.
  *
  * Other entry types carry no usage. Returns `undefined` when the resolved field has no `usage`.
  */
@@ -42,8 +42,7 @@ export function getEntryUsage(entry: SessionEntry): Usage | undefined {
   if (entry.type === "message") source = entry.message;
   else if (entry.type === "custom") source = entry.data;
   else if (entry.type === "custom_message") source = entry.details;
-  else if (entry.type === "compaction" || entry.type === "branch_summary") source = entry;
-  else return;
+  else source = entry;
 
   if (typeof source !== "object" || source === null) return;
   const data = source as { usage?: unknown };