pi-spark 0.25.0 → 0.27.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.27.0](https://github.com/zlliang/pi-spark/compare/v0.26.0...v0.27.0) (2026-09-20)
+
+
+### Features
+
+* **credits:** honor Chinese holidays in DeepSeek off-peak pricing ([fc99f7d](https://github.com/zlliang/pi-spark/commit/fc99f7d152091e7c751745b46f35840676270538))
+
+## [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,7 @@ 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.27.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/data/holiday-cn-2026.json

@@ -0,0 +1,205 @@
+{
+    "$schema": "https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json",
+    "$id": "https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2026.json",
+    "year": 2026,
+    "papers": [
+        "https://www.gov.cn/zhengce/zhengceku/202511/content_7047091.htm"
+    ],
+    "days": [
+        {
+            "name": "元旦",
+            "date": "2026-01-01",
+            "isOffDay": true
+        },
+        {
+            "name": "元旦",
+            "date": "2026-01-02",
+            "isOffDay": true
+        },
+        {
+            "name": "元旦",
+            "date": "2026-01-03",
+            "isOffDay": true
+        },
+        {
+            "name": "元旦",
+            "date": "2026-01-04",
+            "isOffDay": false
+        },
+        {
+            "name": "春节",
+            "date": "2026-02-14",
+            "isOffDay": false
+        },
+        {
+            "name": "春节",
+            "date": "2026-02-15",
+            "isOffDay": true
+        },
+        {
+            "name": "春节",
+            "date": "2026-02-16",
+            "isOffDay": true
+        },
+        {
+            "name": "春节",
+            "date": "2026-02-17",
+            "isOffDay": true
+        },
+        {
+            "name": "春节",
+            "date": "2026-02-18",
+            "isOffDay": true
+        },
+        {
+            "name": "春节",
+            "date": "2026-02-19",
+            "isOffDay": true
+        },
+        {
+            "name": "春节",
+            "date": "2026-02-20",
+            "isOffDay": true
+        },
+        {
+            "name": "春节",
+            "date": "2026-02-21",
+            "isOffDay": true
+        },
+        {
+            "name": "春节",
+            "date": "2026-02-22",
+            "isOffDay": true
+        },
+        {
+            "name": "春节",
+            "date": "2026-02-23",
+            "isOffDay": true
+        },
+        {
+            "name": "春节",
+            "date": "2026-02-28",
+            "isOffDay": false
+        },
+        {
+            "name": "清明节",
+            "date": "2026-04-04",
+            "isOffDay": true
+        },
+        {
+            "name": "清明节",
+            "date": "2026-04-05",
+            "isOffDay": true
+        },
+        {
+            "name": "清明节",
+            "date": "2026-04-06",
+            "isOffDay": true
+        },
+        {
+            "name": "劳动节",
+            "date": "2026-05-01",
+            "isOffDay": true
+        },
+        {
+            "name": "劳动节",
+            "date": "2026-05-02",
+            "isOffDay": true
+        },
+        {
+            "name": "劳动节",
+            "date": "2026-05-03",
+            "isOffDay": true
+        },
+        {
+            "name": "劳动节",
+            "date": "2026-05-04",
+            "isOffDay": true
+        },
+        {
+            "name": "劳动节",
+            "date": "2026-05-05",
+            "isOffDay": true
+        },
+        {
+            "name": "劳动节",
+            "date": "2026-05-09",
+            "isOffDay": false
+        },
+        {
+            "name": "端午节",
+            "date": "2026-06-19",
+            "isOffDay": true
+        },
+        {
+            "name": "端午节",
+            "date": "2026-06-20",
+            "isOffDay": true
+        },
+        {
+            "name": "端午节",
+            "date": "2026-06-21",
+            "isOffDay": true
+        },
+        {
+            "name": "国庆节",
+            "date": "2026-09-20",
+            "isOffDay": false
+        },
+        {
+            "name": "中秋节",
+            "date": "2026-09-25",
+            "isOffDay": true
+        },
+        {
+            "name": "中秋节",
+            "date": "2026-09-26",
+            "isOffDay": true
+        },
+        {
+            "name": "中秋节",
+            "date": "2026-09-27",
+            "isOffDay": true
+        },
+        {
+            "name": "国庆节",
+            "date": "2026-10-01",
+            "isOffDay": true
+        },
+        {
+            "name": "国庆节",
+            "date": "2026-10-02",
+            "isOffDay": true
+        },
+        {
+            "name": "国庆节",
+            "date": "2026-10-03",
+            "isOffDay": true
+        },
+        {
+            "name": "国庆节",
+            "date": "2026-10-04",
+            "isOffDay": true
+        },
+        {
+            "name": "国庆节",
+            "date": "2026-10-05",
+            "isOffDay": true
+        },
+        {
+            "name": "国庆节",
+            "date": "2026-10-06",
+            "isOffDay": true
+        },
+        {
+            "name": "国庆节",
+            "date": "2026-10-07",
+            "isOffDay": true
+        },
+        {
+            "name": "国庆节",
+            "date": "2026-10-10",
+            "isOffDay": false
+        }
+    ]
+}

package/src/features/credits/pricing.ts

@@ -23,7 +23,7 @@ export interface PricingRule {
 
 /** Updates registry and active model prices without changing the provider's rule data. */
 export function applyPricingRules(ctx: ExtensionContext, provider: CreditsProvider, timestamp: number): void {
-  (provider.pricingRules ?? []).forEach((rule) => {
+  (provider.pricingRules?.(timestamp) ?? []).forEach((rule) => {
     const cost = resolveCost(rule, timestamp);
     const model = ctx.modelRegistry.find(provider.id, rule.model);
 

package/src/features/credits/providers/deepseek.ts

@@ -4,8 +4,12 @@ import { http, withAuth } from "../../../utils/http";
 import type { Cost } from "../pricing";
 import type { Credits, CreditsProvider } from "../types";
 
+import holidays2026 from "../../../data/holiday-cn-2026.json" with { type: "json" };
+
 const PROVIDER = "deepseek";
 const URL = "https://api.deepseek.com/user/balance";
+const BEIJING_OFFSET_MS = 8 * 60 * 60 * 1000;
+const HOLIDAYS = new Set(holidays2026.days.filter((day) => day.isOffDay).map((day) => day.date));
 
 interface DeepSeekBalanceResponse {
   balance_infos?: DeepSeekBalanceInfo[] | null;
@@ -16,46 +20,44 @@ interface DeepSeekBalanceInfo {
   total_balance?: string | number;
 }
 
+/** Checks for an all-day off-peak date in Beijing, including weekends with makeup work. */
+function isDeepSeekOffPeakDay(timestamp: number): boolean {
+  // Beijing uses UTC+8 without daylight saving time.
+  const date = new Date(timestamp + BEIJING_OFFSET_MS);
+  const day = date.getUTCDay();
+
+  // Years without bundled holiday data fall back to weekends only.
+  return day === 0 || day === 6 || HOLIDAYS.has(date.toISOString().slice(0, 10));
+}
+
 export const deepseekProvider: CreditsProvider = {
   id: PROVIDER,
   label: "DeepSeek",
   link: "https://platform.deepseek.com/usage",
 
   // See https://api-docs.deepseek.com/quick_start/pricing/.
-  pricingRules: [
-    {
-      model: "deepseek-flash",
-      defaultCost: { input: 0.15, output: 0.6, cacheRead: 0.003, cacheWrite: 0, label: "Off-peak" },
-      windows: [
-        { start: "01:00", end: "04:00", days: [1, 2, 3, 4, 5], cost: { input: 0.3, output: 1.2, cacheRead: 0.006, cacheWrite: 0, label: "Peak" } },
-        { start: "06:00", end: "10:00", days: [1, 2, 3, 4, 5], cost: { input: 0.3, output: 1.2, cacheRead: 0.006, cacheWrite: 0, label: "Peak" } },
-      ],
-    },
-    {
-      model: "deepseek-v4-flash",
-      defaultCost: { input: 0.15, output: 0.6, cacheRead: 0.003, cacheWrite: 0, label: "Off-peak" },
-      windows: [
-        { start: "01:00", end: "04:00", days: [1, 2, 3, 4, 5], cost: { input: 0.3, output: 1.2, cacheRead: 0.006, cacheWrite: 0, label: "Peak" } },
-        { start: "06:00", end: "10:00", days: [1, 2, 3, 4, 5], cost: { input: 0.3, output: 1.2, cacheRead: 0.006, cacheWrite: 0, label: "Peak" } },
-      ],
-    },
-    {
-      model: "deepseek-v4-flash-vision-exp",
-      defaultCost: { input: 0.15, output: 0.6, cacheRead: 0.003, cacheWrite: 0, label: "Off-peak" },
-      windows: [
-        { start: "01:00", end: "04:00", days: [1, 2, 3, 4, 5], cost: { input: 0.3, output: 1.2, cacheRead: 0.006, cacheWrite: 0, label: "Peak" } },
-        { start: "06:00", end: "10:00", days: [1, 2, 3, 4, 5], cost: { input: 0.3, output: 1.2, cacheRead: 0.006, cacheWrite: 0, label: "Peak" } },
-      ],
-    },
-    {
-      model: "deepseek-v4-pro",
-      defaultCost: { input: 0.66, output: 1.98, cacheRead: 0.022, cacheWrite: 0, label: "Off-peak" },
-      windows: [
-        { start: "01:00", end: "04:00", days: [1, 2, 3, 4, 5], cost: { input: 1.32, output: 3.96, cacheRead: 0.044, cacheWrite: 0, label: "Peak" } },
-        { start: "06:00", end: "10:00", days: [1, 2, 3, 4, 5], cost: { input: 1.32, output: 3.96, cacheRead: 0.044, cacheWrite: 0, label: "Peak" } },
-      ],
-    },
-  ],
+  pricingRules(timestamp) {
+    const offPeakDay = isDeepSeekOffPeakDay(timestamp);
+
+    return [
+      {
+        model: "deepseek-flash",
+        defaultCost: { input: 0.15, output: 0.6, cacheRead: 0.003, cacheWrite: 0, label: "Off-peak" },
+        windows: offPeakDay ? [] : [
+          { start: "01:00", end: "04:00", cost: { input: 0.3, output: 1.2, cacheRead: 0.006, cacheWrite: 0, label: "Peak" } },
+          { start: "06:00", end: "10:00", cost: { input: 0.3, output: 1.2, cacheRead: 0.006, cacheWrite: 0, label: "Peak" } },
+        ],
+      },
+      {
+        model: "deepseek-v4-pro",
+        defaultCost: { input: 0.66, output: 1.98, cacheRead: 0.022, cacheWrite: 0, label: "Off-peak" },
+        windows: offPeakDay ? [] : [
+          { start: "01:00", end: "04:00", cost: { input: 1.32, output: 3.96, cacheRead: 0.044, cacheWrite: 0, label: "Peak" } },
+          { start: "06:00", end: "10:00", cost: { input: 1.32, output: 3.96, cacheRead: 0.044, cacheWrite: 0, label: "Peak" } },
+        ],
+      },
+    ];
+  },
 
   async fetch(apiKey, signal, cost?: Cost): Promise<Credits> {
     const payload = await withAuth(http, apiKey).get(URL, { signal }).json<DeepSeekBalanceResponse>();

package/src/features/credits/types.ts

@@ -27,7 +27,7 @@ export interface CreditsProvider {
   readonly id: CreditsProviderId;
   readonly label: string;
   readonly link?: string;
-  readonly pricingRules?: PricingRule[];
+  readonly pricingRules?: (timestamp: number) => PricingRule[];
   fetch(apiKey: string, signal: AbortSignal, cost?: Cost): Promise<Credits>;
   register?(pi: ExtensionAPI, ctx: ExtensionContext, refresh: RefreshCredits): void;
 }

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 };