pi-spark 0.18.0 → 0.18.1

package/README.md

@@ -37,7 +37,7 @@ pi-spark ships with custom editor, footer, and fullscreen rendering, replacing t
 pi-spark shows the active provider's credit balance or rate-limit usage in the status line, so you can keep an eye on what's left without leaving the terminal.
 
 - Supported providers: DeepSeek, Fireworks, Kimi Code, Moonshot, OpenAI Codex, OpenRouter, and Vercel AI Gateway.
-- Most provider fetching follows [CodexBar](https://github.com/steipete/codexbar). Fireworks is the exception: its balance sits behind an internal gRPC API, reverse-engineered from the `firectl` binary (see [docs/fireworks.md](./docs/fireworks.md)).
+- Most provider fetching follows [CodexBar](https://github.com/steipete/codexbar). Fireworks is the exception: its balance sits behind an internal gRPC API, reverse-engineered from the `firectl` binary (see [Reverse-Engineering Fireworks Credits](./docs/reverse-engineering-fireworks-credits.md)).
 
 ![Credits](./assets/screenshot-credits.png)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-spark",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "Pi package that polishes your daily experience.",
   "keywords": [
     "pi-coding-agent",

package/src/features/recap/manager.ts

@@ -1,9 +1,8 @@
-import { completeSimple } from "@earendil-works/pi-ai/compat";
 import { convertToLlm, serializeConversation } from "@earendil-works/pi-coding-agent";
 
 import { clearRecapWidget, setRecapLoadingWidget, setRecapTextWidget } from "./widget";
 import { sanitizeText } from "../../utils/format";
-import { resolveModelSettings } from "../../utils/model";
+import { completeBackground, resolveModelSettings } from "../../utils/model";
 
 import type { Api, Model, ModelThinkingLevel, SimpleStreamOptions, Usage } from "@earendil-works/pi-ai";
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
@@ -85,18 +84,12 @@ export class RecapManager {
     const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
     if (!auth.ok) throw new Error(auth.error);
 
-    const options: SimpleStreamOptions = {
-      maxTokens: MAX_TOKENS,
-      // Codex uses the session ID for request routing; without it, background calls may be
-      // routed to an unavailable model.
-      sessionId: ctx.sessionManager.getSessionId(),
-      signal,
-    };
+    const options: SimpleStreamOptions = { maxTokens: MAX_TOKENS, signal };
     if (auth.apiKey) options.apiKey = auth.apiKey;
     if (auth.headers) options.headers = auth.headers;
     if (thinkingLevel !== "off") options.reasoning = thinkingLevel;
 
-    const response = await completeSimple(model, {
+    const response = await completeBackground(model, {
       systemPrompt: SYSTEM_PROMPT,
       messages: [{
         role: "user",

package/src/features/title/manager.ts

@@ -1,8 +1,7 @@
-import { completeSimple } from "@earendil-works/pi-ai/compat";
 import { convertToLlm, serializeConversation } from "@earendil-works/pi-coding-agent";
 
 import { sanitizeText } from "../../utils/format";
-import { resolveModelSettings } from "../../utils/model";
+import { completeBackground, resolveModelSettings } from "../../utils/model";
 
 import type { Api, Model, ModelThinkingLevel, SimpleStreamOptions, Usage } from "@earendil-works/pi-ai";
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
@@ -68,18 +67,12 @@ export class TitleManager {
     const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
     if (!auth.ok) throw new Error(auth.error);
 
-    const options: SimpleStreamOptions = {
-      maxTokens: MAX_TOKENS,
-      // Codex uses the session ID for request routing; without it, background calls may be
-      // routed to an unavailable model.
-      sessionId: ctx.sessionManager.getSessionId(),
-      signal,
-    };
+    const options: SimpleStreamOptions = { maxTokens: MAX_TOKENS, signal };
     if (auth.apiKey) options.apiKey = auth.apiKey;
     if (auth.headers) options.headers = auth.headers;
     if (thinkingLevel !== "off") options.reasoning = thinkingLevel;
 
-    const response = await completeSimple(model, {
+    const response = await completeBackground(model, {
       systemPrompt: SYSTEM_PROMPT,
       messages: [{
         role: "user",

package/src/utils/model.ts

@@ -1,4 +1,6 @@
-import { clampThinkingLevel } from "@earendil-works/pi-ai";
+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";
 
@@ -29,6 +31,22 @@ export function isFreeModel(model: Model<Api>): boolean {
   return model.cost.input === 0 && model.cost.output === 0 && model.cost.cacheRead === 0 && model.cost.cacheWrite === 0;
 }
 
+/**
+ * Complete 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);
+
+  const sessionId = uuidv7();
+
+  try {
+    return await completeSimple(model, context, { ...options, sessionId });
+  } finally {
+    cleanupSessionResources(sessionId);
+  }
+};
+
 /**
  * Resolve the model and thinking level for a background feature (recap, title, ...).
  *