pi-spark 0.26.0 → 0.28.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.28.0](https://github.com/zlliang/pi-spark/compare/v0.27.0...v0.28.0) (2026-09-22)
+
+
+### ⚠ BREAKING CHANGES
+
+* use Pi 0.87 context projections for recaps and titles
+
+### Bug Fixes
+
+* use Pi 0.87 context projections for recaps and titles ([a822fa3](https://github.com/zlliang/pi-spark/commit/a822fa350f1146123d46a7dbf53d812947ff7b49))
+
+## [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)
 
 

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

@@ -74,4 +74,6 @@ Cache admission remains provider-controlled and noisy. In repeated GPT-5.6 Luna
 
 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.26.0",
+  "version": "0.28.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.86.0",
-    "@earendil-works/pi-ai": ">=0.86.0",
-    "@earendil-works/pi-coding-agent": ">=0.86.0",
-    "@earendil-works/pi-tui": ">=0.86.0",
+    "@earendil-works/pi-agent-core": ">=0.87.0",
+    "@earendil-works/pi-ai": ">=0.87.0",
+    "@earendil-works/pi-coding-agent": ">=0.87.0",
+    "@earendil-works/pi-tui": ">=0.87.0",
     "typebox": "*"
   },
   "devDependencies": {
-    "@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",
+    "@earendil-works/pi-agent-core": ">=0.87.0",
+    "@earendil-works/pi-ai": ">=0.87.0",
+    "@earendil-works/pi-coding-agent": ">=0.87.0",
+    "@earendil-works/pi-tui": ">=0.87.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/idle.ts

@@ -1,6 +1,6 @@
 import parseDuration from "parse-duration";
 import * as z from "zod";
-import { convertToLlm, sessionEntryToContextMessages } from "@earendil-works/pi-coding-agent";
+import { convertToLlm } from "@earendil-works/pi-coding-agent";
 
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 
@@ -69,7 +69,7 @@ export class IdleListener {
   }
 
   private check(ctx: ExtensionContext): void {
-    const canEnter = ctx.isIdle() && ctx.sessionManager.buildContextEntries().some((entry) => convertToLlm(sessionEntryToContextMessages(entry)).length > 0);
+    const canEnter = ctx.isIdle() && convertToLlm(ctx.sessionManager.buildSessionProjection().messages).some((message) => message.role !== "system");
     if (!canEnter) {
       this.lastEditorText = undefined;
       if (this.entered) {

package/src/features/recap/manager.ts

@@ -1,4 +1,4 @@
-import { convertToLlm, serializeConversation, sessionEntryToContextMessages } from "@earendil-works/pi-coding-agent";
+import { convertToLlm, serializeConversation } from "@earendil-works/pi-coding-agent";
 
 import { clearRecapWidget, setRecapLoadingWidget, setRecapTextWidget } from "./widget";
 import { sanitizeText } from "../../utils/format";
@@ -109,7 +109,7 @@ export class RecapManager {
   }
 
   private buildPrompt(ctx: ExtensionContext): string {
-    const messages = ctx.sessionManager.buildContextEntries().flatMap(sessionEntryToContextMessages);
+    const messages = ctx.sessionManager.buildSessionProjection().messages;
     const text = serializeConversation(convertToLlm(messages));
     const conversation = text.length > MAX_CONVERSATION_CHARS ? text.slice(-MAX_CONVERSATION_CHARS) : text;
 

package/src/features/title/manager.ts

@@ -91,7 +91,7 @@ export class TitleManager {
   }
 
   private buildPrompt(ctx: ExtensionContext): string {
-    const messages = ctx.sessionManager.getBranch().filter((entry) => entry.type === "message").map((entry) => entry.message);
+    const messages = ctx.sessionManager.buildSessionProjection().messages;
     const text = serializeConversation(convertToLlm(messages));
     const conversation = text.length > MAX_CONVERSATION_CHARS ? text.slice(0, MAX_CONVERSATION_CHARS) : text;