pi-spark 0.14.7 → 0.16.0

package/README.md

@@ -2,7 +2,7 @@
 
 # pi-spark
 
-[Pi](https://pi.dev/) package that polishes your daily experience and keeps you at the frontier of agentic workflows.
+[Pi](https://pi.dev/) package that polishes your daily experience.
 
 ![Overview](./assets/screenshot-overview.png)
 
@@ -57,26 +57,18 @@ pi-spark generates a short recap of the current session after it goes idle, or o
 
 - A recap is generated automatically once the session stays idle past `recap.idle` in `spark.json`.
 - Run `/recap` to generate one manually at any time.
-- The recap can use its own model, configured separately from your working model.
+- The recap generation can use its own model, configured separately from your working model.
 
 ![Recap](./assets/screenshot-recap.png)
 
-### Agent tools: `pi` and `web`
+### Title
 
-pi-spark adds two agent tools:
+pi-spark names the session automatically after the first exchange, so it's easy to find later in the session selector.
 
-The `pi` tool lets the pi coding agent inspect and manipulate itself (~740 tokens).
-
-- `models` lists and searches the model catalog.
-- `name` sets or updates the current session's name.
-- `whoami` shows the current pi state, including session name, active model, and thinking level.
-
-The `web` tool gives the agent live web access, backed by the free [Exa MCP](https://exa.ai/mcp) (~350 tokens). No separate MCP setup or API key is needed.
-
-- `search` finds current information across the web and returns ready-to-use content.
-- `fetch` reads the full content of known URLs as clean markdown, and can batch several URLs in one call.
-
-![Agent tools](./assets/screenshot-tools.png)
+- After the first message is sent and the agent replies, pi-spark generates a short title from the conversation and sets it as the session name.
+- Generation is silent: nothing is shown in the UI, and the usage is recorded in a session entry like the recap.
+- Sessions that already have a name are left untouched.
+- The title generation can use its own model, configured separately from your working model.
 
 ## Configuration
 
@@ -107,6 +99,11 @@ For example:
     "provider": "openai-codex",
     "model": "gpt-5.4-mini",
     "thinkingLevel": "off"
+  },
+  "title": {
+    "provider": "openai-codex",
+    "model": "gpt-5.4-mini",
+    "thinkingLevel": "off"
   }
 }
 ```
@@ -121,10 +118,9 @@ All fields are optional. Each top-level feature runs with the defaults below unl
 | `editor` | `EditorConfig` | Shows a working indicator and the current model on the editor's top border. |
 | `footer` | `{}` | Shows session info, extension statuses, cost, and context usage on one line. |
 | `fullscreen` | `{}` | Clears the screen and scrollback on start and exit, and pins the editor and footer to the bottom. |
-| `pi` | `{}` | Exposes the `pi` agent tool (`models`, `name`, `whoami` actions). |
 | `presets` | `{ [name]: Preset }` | Defines named model presets, keyed by name. |
 | `recap` | `RecapConfig` | Generates a session recap when idle or on demand. |
-| `web` | `{}` | Exposes the `web` agent tool (`search`, `fetch` actions) via Exa's hosted MCP server. |
+| `title` | `TitleConfig` | Names the session automatically after the first exchange. |
 
 #### `EditorConfig`
 
@@ -149,14 +145,24 @@ Each preset must set all three fields.
 
 #### `RecapConfig`
 
-All fields are optional, including `thinkingLevel`. If the recap model configuration is incomplete, pi-spark falls back to the session's main model.
+All fields are optional. If the recap model configuration is incomplete, pi-spark falls back to the session's main model. `thinkingLevel` defaults to `off` (clamped to the model), so recap stays cheap regardless of your working thinking level.
 
 | Field | Value | Description |
 | --- | --- | --- |
 | `idle` | number (ms) or duration string | How long the session must stay idle before a recap is generated. Accepts a millisecond number or a [vercel/ms](https://github.com/vercel/ms) string (e.g., `"5m"`); minimum 5000 ms, defaults to 5 minutes. |
 | `provider` | string | Provider ID for the recap model. |
 | `model` | string | Model ID for the recap model. |
-| `thinkingLevel` | `ModelThinkingLevel` | Thinking level for the recap model. |
+| `thinkingLevel` | `ModelThinkingLevel` | Thinking level for the recap model. Defaults to `off`. |
+
+#### `TitleConfig`
+
+All fields are optional. If the title model configuration is incomplete, pi-spark falls back to the session's main model. `thinkingLevel` defaults to `off` (clamped to the model), so title generation stays cheap regardless of your working thinking level.
+
+| Field | Value | Description |
+| --- | --- | --- |
+| `provider` | string | Provider ID for the title model. |
+| `model` | string | Model ID for the title model. |
+| `thinkingLevel` | `ModelThinkingLevel` | Thinking level for the title model. Defaults to `off`. |
 
 #### `ModelThinkingLevel`
 

package/index.ts

@@ -3,10 +3,9 @@ import { registerCredits } from "./src/features/credits";
 import { registerEditor } from "./src/features/editor";
 import { registerFooter } from "./src/features/footer";
 import { registerFullscreen } from "./src/features/fullscreen";
-import { registerPi } from "./src/features/pi";
 import { registerPresets } from "./src/features/presets";
 import { registerRecap } from "./src/features/recap";
-import { registerWeb } from "./src/features/web";
+import { registerTitle } from "./src/features/title";
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
@@ -24,8 +23,7 @@ export default function (pi: ExtensionAPI) {
   registerEditor(pi, events);
   registerFooter(pi);
   registerFullscreen(pi);
-  registerPi(pi);
   registerPresets(pi);
   registerRecap(pi);
-  registerWeb(pi);
+  registerTitle(pi);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-spark",
-  "version": "0.14.7",
-  "description": "Pi package that polishes your daily experience and keeps you at the frontier of agentic workflows.",
+  "version": "0.16.0",
+  "description": "Pi package that polishes your daily experience.",
   "keywords": [
     "pi-coding-agent",
     "pi-package"
@@ -31,8 +31,7 @@
   "dependencies": {
     "@grpc/grpc-js": "^1.14.4",
     "@grpc/proto-loader": "^0.8.1",
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "liqe": "^3.8.7",
+    "defu": "^6.1.7",
     "ms": "4.0.0-nightly.202508271359",
     "zod": "^4.4.3"
   },

package/src/config/index.ts

@@ -1,15 +1,13 @@
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
-import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import { CONFIG_DIR_NAME, getAgentDir } from "@earendil-works/pi-coding-agent";
+import { defu } from "defu";
 
 import { featureSchemas } from "./schema";
 
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { SparkConfig } from "./schema";
 
-type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue };
-type JsonObject = { [key: string]: JsonValue };
-
 const cache = new Map<string, SparkConfig>();
 
 /** Load and validate spark.json once per session lifecycle; later calls return the cached result. */
@@ -18,8 +16,10 @@ export function loadConfig(ctx: ExtensionContext, fileName: string = "spark.json
   const cached = cache.get(key);
   if (cached) return cached;
 
-  const rawValue = loadMergedJson(getConfigPaths(ctx.cwd, fileName)) ?? {};
-  const raw = isPlainObject(rawValue) ? rawValue : {};
+  // Deep-merge the global file under the project file, so project settings win at scalar
+  // leaves while deep objects (e.g., `recap.model`) combine across both.
+  const [globalPath, projectPath] = getConfigPaths(ctx.cwd, fileName);
+  const raw = defu(readRawConfig(projectPath) ?? {}, readRawConfig(globalPath) ?? {});
 
   // Validate each feature independently so a single invalid field disables only that feature
   // (falling back to its enabled defaults) instead of taking down the whole config.
@@ -46,12 +46,11 @@ export function loadConfig(ctx: ExtensionContext, fileName: string = "spark.json
     }
 
     config[field] = {};
-    const detail = result.error.issues.map((issue) => `${[field, ...issue.path].join(".")}: ${issue.message}`).join("; ");
-    errors.push(detail);
+    errors.push(result.error.issues.map((issue) => `${[field, ...issue.path].join(".")}: ${issue.message}`).join("; "));
   }
 
   if (errors.length > 0) {
-    ctx.ui.notify(`Invalid spark config, using defaults for: ${errors.join("; ")}`, "error");
+    ctx.ui.notify(`Invalid pi-spark config: ${errors.join("; ")}`, "error");
   }
 
   cache.set(key, config as SparkConfig);
@@ -59,46 +58,13 @@ export function loadConfig(ctx: ExtensionContext, fileName: string = "spark.json
 }
 
 function getConfigPaths(cwd: string, fileName: string): [globalPath: string, projectPath: string] {
-  return [join(getAgentDir(), fileName), join(cwd, ".pi", fileName)];
-}
-
-function loadMergedJson(paths: string[]): JsonObject | undefined {
-  let merged: JsonObject | undefined;
-  paths.forEach((path) => {
-    const value = readJsonFile(path);
-    if (value === undefined) return;
-
-    merged = mergeConfig(merged, value);
-  });
-
-  return merged;
+  return [join(getAgentDir(), fileName), join(cwd, CONFIG_DIR_NAME, fileName)];
 }
 
-function readJsonFile(path: string): JsonObject | undefined {
+function readRawConfig(path: string): Record<string, unknown> | undefined {
   try {
-    return JSON.parse(readFileSync(path, "utf8")) as JsonObject;
+    return JSON.parse(readFileSync(path, "utf8")) as Record<string, unknown>;
   } catch {
     return undefined;
   }
 }
-
-function mergeConfig(base: JsonObject | undefined, override: JsonObject): JsonObject {
-  if (base === undefined) return override;
-  if (!isPlainObject(base) || !isPlainObject(override)) return override;
-
-  const result: Record<string, JsonValue> = { ...base };
-  Object.entries(override).forEach(([key, overrideValue]) => {
-    const baseValue = base[key];
-    if (isPlainObject(baseValue) && isPlainObject(overrideValue)) {
-      result[key] = { ...baseValue, ...overrideValue };
-    } else {
-      result[key] = overrideValue;
-    }
-  });
-
-  return result;
-}
-
-function isPlainObject(value: unknown): value is Record<string, JsonValue> {
-  return !!value && typeof value === "object" && !Array.isArray(value);
-}

package/src/config/schema.ts

@@ -4,10 +4,9 @@ import { creditsConfigSchema } from "../features/credits/config";
 import { editorConfigSchema } from "../features/editor/config";
 import { footerConfigSchema } from "../features/footer/config";
 import { fullscreenConfigSchema } from "../features/fullscreen/config";
-import { piConfigSchema } from "../features/pi/config";
 import { presetsConfigSchema } from "../features/presets/config";
 import { recapConfigSchema } from "../features/recap/config";
-import { webConfigSchema } from "../features/web/config";
+import { titleConfigSchema } from "../features/title/config";
 
 /**
  * Raw option shape for each feature. The enable/disable/default policy lives in `loadConfig`:
@@ -19,10 +18,9 @@ export const featureSchemas = {
   editor: editorConfigSchema,
   footer: footerConfigSchema,
   fullscreen: fullscreenConfigSchema,
-  pi: piConfigSchema,
   presets: presetsConfigSchema,
   recap: recapConfigSchema,
-  web: webConfigSchema,
+  title: titleConfigSchema,
 } as const;
 
 /** Resolved config for every feature; `false` means the feature is disabled. */

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

@@ -10,7 +10,7 @@ interface MoonshotBalanceResponse {
 
 /**
  * For Moonshot, the international and China-mainland accounts live on separate hosts and bill in
- * different currencies (USD vs CNY), which the endpoint does not report, so each pi provider ID
+ * different currencies (USD vs CNY), which the endpoint does not report, so each Pi provider ID
  * fixes both host and currency.
  */
 function createMoonshotProvider(id: string, host: string, currency: string): CreditsProvider {

package/src/features/credits/status.ts

@@ -14,7 +14,7 @@ export function renderCredits(theme: Theme, label: string, credits: Credits): st
 }
 
 export function renderError(theme: Theme, label: string, message: string): string {
-  return theme.fg("error", `${label} credits unavailable: ${message}`);
+  return theme.fg("error", `${label} ${message}`);
 }
 
 function renderWindows(theme: Theme, credits: Extract<Credits, { type: "windows" }>): string {

package/src/features/credits/types.ts

@@ -1,4 +1,4 @@
-import type { Provider } from "@earendil-works/pi-ai";
+import type { ProviderId } from "@earendil-works/pi-ai";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 
 /**
@@ -16,9 +16,9 @@ export interface CreditsLane {
   percent: number | undefined;
 }
 
-/** A credits source for a pi provider, shown in the status line while that provider is active. */
+/** A credits source for a Pi provider, shown in the status line while that provider is active. */
 export interface CreditsProvider {
-  readonly id: Provider;
+  readonly id: ProviderId;
   readonly label: string;
   fetch(ctx: ExtensionContext, apiKey: string, signal: AbortSignal): Promise<Credits>;
 }

package/src/features/footer/index.ts

@@ -4,9 +4,12 @@ import { pathToFileURL } from "node:url";
 
 import { SplitLine } from "../../components/split-line";
 import { loadConfig } from "../../config";
-import { formatContextUsage, formatCost, formatCwd, linkText, sanitizeText } from "../../utils/format";
+import { formatContextUsage, formatCost, formatCwd, sanitizeText } from "../../utils/format";
+import { isFreeModel } from "../../utils/model";
 import { getEntryUsage } from "../../utils/usage";
 
+import { hyperlink } from "@earendil-works/pi-tui";
+
 import type { ExtensionContext, ExtensionAPI, ReadonlyFooterDataProvider, Theme } from "@earendil-works/pi-coding-agent";
 import type { Component } from "@earendil-works/pi-tui";
 
@@ -35,7 +38,7 @@ class FooterComponent implements Component {
   private getLeft(): string {
     const cwd = this.ctx.sessionManager.getCwd();
     const url = pathToFileURL(resolve(cwd));
-    const cwdText = linkText(formatCwd(cwd, homedir()), url.href);
+    const cwdText = hyperlink(formatCwd(cwd, homedir()), url.href);
     const branch = this.footerData.getGitBranch();
     const sessionName = this.ctx.sessionManager.getSessionName();
 
@@ -63,6 +66,10 @@ class FooterComponent implements Component {
 
   private getStyledCostText(): string {
     const totalCost = this.ctx.sessionManager.getBranch().reduce((acc, entry) => acc + (getEntryUsage(entry)?.cost.total ?? 0), 0);
+
+    // Hide cost when it's zero and the current model is free.
+    if (totalCost === 0 && this.ctx.model && isFreeModel(this.ctx.model)) return "";
+
     const costText = formatCost(totalCost);
 
     if (totalCost > 20) return this.theme.fg("warning", costText);

package/src/features/fullscreen/filler.ts

@@ -22,7 +22,7 @@ export class BottomFiller implements Component {
     this.measuring = true;
 
     // Re-assert `clearOnShrink` every render pass; the TUI reads it after `render()` returns,
-    // so this wins deterministically over pi's reset to the settings value on startup/reload.
+    // so this wins deterministically over Pi's reset to the settings value on startup/reload.
     this.tui.setClearOnShrink(true);
 
     const rows = this.tui.terminal.rows;

package/src/features/presets/manager.ts

@@ -95,7 +95,7 @@ export class PresetManager {
     if (!preset) return;
 
     return this.keys.find((key) => {
-      const p = this.presets[key]!;
+      const p = this.presets[key];
 
       return p.provider === preset.provider && p.model === preset.model && p.thinkingLevel === preset.thinkingLevel;
     });

package/src/features/presets/selector.ts

@@ -20,7 +20,7 @@ export async function showPresetSelector(ctx: ExtensionContext, presetManager: P
       }));
 
     const container = new Container();
-    container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
+    container.addChild(new DynamicBorder((s: string) => theme.fg("border", s)));
 
     const box = new Box(1, 1);
     box.addChild(new Text(theme.bold(theme.fg("accent", "Select preset")), 0, 0));
@@ -46,7 +46,7 @@ export async function showPresetSelector(ctx: ExtensionContext, presetManager: P
     box.addChild(new Text(keyHints.join("  "), 0, 0));
 
     container.addChild(box);
-    container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
+    container.addChild(new DynamicBorder((s: string) => theme.fg("border", s)));
 
     return {
       render: (width: number) => container.render(width),

package/src/features/recap/manager.ts

@@ -1,9 +1,9 @@
-import { completeSimple } from "@earendil-works/pi-ai";
+import { completeSimple } from "@earendil-works/pi-ai/compat";
 import { convertToLlm, serializeConversation } from "@earendil-works/pi-coding-agent";
 
-import { resolveRecapModelSettings } from "./model";
 import { clearRecapWidget, setRecapLoadingWidget, setRecapTextWidget } from "./widget";
 import { sanitizeText } from "../../utils/format";
+import { 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";
@@ -16,7 +16,7 @@ const SYSTEM_PROMPT = [
   "Summarize the user's goal, what was done, current state, and any clearly supported next step.",
   "Respond in the conversation's primary language. Address the user in the second person.",
   "Output 1-2 plain-text sentences under 40 words. No heading, markdown, bullets, or quotes.",
-].join("\n");
+].join(" ");
 
 const MAX_TOKENS = 80;
 const MAX_CONVERSATION_CHARS = 8_000;
@@ -40,10 +40,10 @@ export class RecapManager {
     this.inflight = controller;
 
     try {
-      const recapModelSettings = await resolveRecapModelSettings(this.pi, ctx, this.config);
-      if (controller.signal.aborted || this.inflight !== controller || !recapModelSettings) return;
+      const modelSettings = await resolveModelSettings(ctx, this.config, "recap");
+      if (controller.signal.aborted || this.inflight !== controller || !modelSettings) return;
 
-      const { model, thinkingLevel, warning } = recapModelSettings;
+      const { model, thinkingLevel, warning } = modelSettings;
 
       setRecapLoadingWidget(ctx, warning);
       this.active = false;

package/src/features/title/config.ts

@@ -0,0 +1,7 @@
+import * as z from "zod";
+
+import { optionalModelSchema } from "../../config/model";
+
+export const titleConfigSchema = optionalModelSchema;
+
+export type TitleConfig = z.infer<typeof titleConfigSchema>;

package/src/features/title/index.ts

@@ -0,0 +1,26 @@
+import { TitleManager } from "./manager";
+import { loadConfig } from "../../config";
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+export function registerTitle(pi: ExtensionAPI): void {
+  let titleManager: TitleManager | undefined = undefined;
+
+  pi.on("session_start", (_event, ctx) => {
+    const config = loadConfig(ctx).title;
+    if (!ctx.hasUI || !config) return;
+
+    titleManager = new TitleManager(pi, config);
+  });
+
+  // Generate the title after the first exchange, once the session has context to summarize.
+  // The manager runs at most once and skips sessions that already have a name.
+  pi.on("agent_end", (_event, ctx) => {
+    titleManager?.run(ctx);
+  });
+
+  pi.on("session_shutdown", () => {
+    titleManager?.dispose();
+    titleManager = undefined;
+  });
+}

package/src/features/title/manager.ts

@@ -0,0 +1,117 @@
+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 type { Api, Model, ModelThinkingLevel, SimpleStreamOptions, Usage } from "@earendil-works/pi-ai";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { TitleConfig } from "./config";
+
+const SYSTEM_PROMPT = [
+  "You write a concise title for a terminal coding agent session.",
+  "Base the title only on the transcript; do not invent topics, files, or intent.",
+  "Capture the user's main goal or the session's central task.",
+  "Respond in the conversation's primary language.",
+  "Output a single title of 3-8 words. No trailing punctuation, quotes, markdown, or prefix like 'Title:'.",
+].join(" ");
+
+const MAX_TOKENS = 32;
+const MAX_TITLE_CHARS = 80;
+const MAX_CONVERSATION_CHARS = 8_000;
+
+export class TitleManager {
+  private pi: ExtensionAPI;
+  private config: TitleConfig;
+  private inflight: AbortController | undefined;
+
+  constructor(pi: ExtensionAPI, config: TitleConfig) {
+    this.pi = pi;
+    this.config = config;
+  }
+
+  /** Generate and set the session title once, silently, from the current context. */
+  async run(ctx: ExtensionContext): Promise<void> {
+    if (this.pi.getSessionName()) return;
+
+    this.cancelInflight();
+    const controller = new AbortController();
+    this.inflight = controller;
+
+    try {
+      const modelSettings = await resolveModelSettings(ctx, this.config, "title", { notifyOnMissingModel: false });
+      if (controller.signal.aborted || this.inflight !== controller || !modelSettings) return;
+
+      const { model, thinkingLevel } = modelSettings;
+      const result = await this.generate(ctx, model, thinkingLevel, controller.signal);
+      if (controller.signal.aborted || this.inflight !== controller || !result.content) return;
+
+      this.pi.setSessionName(result.content);
+      this.pi.appendEntry("title", {
+        provider: model.provider,
+        model: model.id,
+        usage: result.usage,
+        content: result.content,
+      });
+    } catch {
+      // Title generation is best-effort and silent; ignore failures.
+    } finally {
+      if (this.inflight === controller) this.inflight = undefined;
+    }
+  }
+
+  dispose(): void {
+    this.cancelInflight();
+  }
+
+  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 (thinkingLevel !== "off") options.reasoning = thinkingLevel;
+
+    const response = await completeSimple(model, {
+      systemPrompt: SYSTEM_PROMPT,
+      messages: [{
+        role: "user",
+        content: [{ type: "text", text: this.buildPrompt(ctx) }],
+        timestamp: Date.now(),
+      }],
+    }, options);
+
+    const content = response.content
+      .filter((block) => block.type === "text")
+      .map((block) => block.text)
+      .join("\n")
+      .trim();
+
+    return { content: this.normalizeTitle(content), usage: response.usage };
+  }
+
+  private buildPrompt(ctx: ExtensionContext): string {
+    const messages = ctx.sessionManager.getBranch().filter((entry) => entry.type === "message").map((entry) => entry.message);
+    const text = serializeConversation(convertToLlm(messages));
+    const conversation = text.length > MAX_CONVERSATION_CHARS ? text.slice(0, MAX_CONVERSATION_CHARS) : text;
+
+    return [
+      "Write a short title for this session, based on the transcript below.",
+      "",
+      "<conversation>",
+      conversation,
+      "</conversation>",
+    ].join("\n");
+  }
+
+  private normalizeTitle(content: string): string {
+    const title = sanitizeText(content).replace(/^["'`]+|["'`]+$/g, "").replace(/[.。!！?？]+$/g, "").trim();
+    return title.length > MAX_TITLE_CHARS ? title.slice(0, MAX_TITLE_CHARS).trim() : title;
+  }
+
+  private cancelInflight(): void {
+    this.inflight?.abort();
+    this.inflight = undefined;
+  }
+}

package/src/utils/format.ts

@@ -1,9 +1,9 @@
 import { isAbsolute, relative, resolve, sep } from "node:path";
 
-import type { ImageContent, Provider, TextContent } from "@earendil-works/pi-ai";
+import type { ProviderId } from "@earendil-works/pi-ai";
 import type { ContextUsage } from "@earendil-works/pi-coding-agent";
 
-export function formatModel(provider?: Provider, model?: string, thinkingLevel?: string): string {
+export function formatModel(provider?: ProviderId, model?: string, thinkingLevel?: string): string {
   return provider && model ? `${provider}/${model}${thinkingLevel ? `:${thinkingLevel}` : ""}` : "no-model";
 }
 
@@ -28,11 +28,6 @@ export function formatCost(cost: number): string {
   return `$${cost.toFixed(2)}`;
 }
 
-/** Format a duration in ms as `1.2s`, like the built-in bash tool. */
-export function formatDuration(ms: number): string {
-  return `${(ms / 1000).toFixed(1)}s`;
-}
-
 export function formatCwd(cwd: string, home: string): string {
   const resolvedCwd = resolve(cwd);
   const resolvedHome = resolve(home);
@@ -54,11 +49,6 @@ function shortenPath(path: string): string {
   }).join(sep);
 }
 
-/** Wrap text in an OSC 8 hyperlink while preserving the visible text. */
-export function linkText(text: string, url: string): string {
-  return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`;
-}
-
 /** Replace newlines, tabs, carriage returns with space, then collapse multiple spaces */
 export function sanitizeText(text: string): string {
   return text
@@ -67,14 +57,6 @@ export function sanitizeText(text: string): string {
     .trim();
 }
 
-/** Join the text blocks of tool result content into a single newline-separated string. */
-export function joinTextContent(content: (TextContent | ImageContent)[]): string {
-  return content
-    .filter((block) => block.type === "text")
-    .map((block) => block.text)
-    .join("\n");
-}
-
 /** Coerce a possibly-stringified numeric value to a finite number, or `undefined`. */
 export function toNumber(value?: string | number | null): number | undefined {
   if (value === undefined || value === null) return undefined;