pi-spark 0.14.7 → 0.16.0

package/src/{features/recap → utils}/model.ts

@@ -1,14 +1,14 @@
 import { clampThinkingLevel } from "@earendil-works/pi-ai";
 
-import { formatModel } from "../../utils/format";
+import { formatModel } from "./format";
 
 import type { Api, Model, ModelThinkingLevel } from "@earendil-works/pi-ai";
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import type { OptionalModelConfig } from "../../config/model";
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { OptionalModelConfig } from "../config/model";
 
 const DEFAULT_THINKING_LEVEL: ModelThinkingLevel = "off";
 
-type RecapModelSettings = {
+export type ModelSettings = {
   model: Model<Api>;
   thinkingLevel: ModelThinkingLevel;
   warning: string | undefined;
@@ -24,15 +24,30 @@ type ThinkingLevelSelection = {
   warning: string | undefined;
 };
 
-export async function resolveRecapModelSettings(pi: ExtensionAPI, ctx: ExtensionContext, config: OptionalModelConfig): Promise<RecapModelSettings | undefined> {
+/** Check if a model has zero costs for all categories. */
+export function isFreeModel(model: Model<Api>): boolean {
+  return model.cost.input === 0 && model.cost.output === 0 && model.cost.cacheRead === 0 && model.cost.cacheWrite === 0;
+}
+
+/**
+ * Resolve the model and thinking level for a background feature (recap, title, ...).
+ *
+ * `feature` names the config section so warnings can point at the offending fields. When the
+ * feature's model config is incomplete or unavailable, this falls back to the session's main
+ * model and reports why via `warning`. Pass `notifyOnMissingModel: false` for silent features.
+ *
+ * The thinking level defaults to "off" (clamped to the model) when not set in config, so these
+ * background features stay cheap regardless of the working model's thinking level.
+ */
+export async function resolveModelSettings(ctx: ExtensionContext, config: OptionalModelConfig, feature: string, options: { notifyOnMissingModel?: boolean } = {}): Promise<ModelSettings | undefined> {
   const fallbackModel = ctx.model;
   if (!fallbackModel) {
-    ctx.ui.notify("No model selected for recap", "warning");
+    if (options.notifyOnMissingModel ?? true) ctx.ui.notify(`No model selected for ${feature}`, "warning");
     return;
   }
 
-  const { model, warning: modelWarning } = await resolveModelSelection(ctx, config, fallbackModel);
-  const { thinkingLevel, warning: thinkingLevelWarning } = resolveThinkingLevel(model, config.thinkingLevel ?? pi.getThinkingLevel());
+  const { model, warning: modelWarning } = await resolveModelSelection(ctx, config, feature, fallbackModel);
+  const { thinkingLevel, warning: thinkingLevelWarning } = resolveThinkingLevel(model, config.thinkingLevel ?? DEFAULT_THINKING_LEVEL);
 
   return {
     model,
@@ -41,7 +56,7 @@ export async function resolveRecapModelSettings(pi: ExtensionAPI, ctx: Extension
   };
 }
 
-async function resolveModelSelection(ctx: ExtensionContext, config: OptionalModelConfig, fallbackModel: Model<Api>): Promise<ModelSelection> {
+async function resolveModelSelection(ctx: ExtensionContext, config: OptionalModelConfig, feature: string, fallbackModel: Model<Api>): Promise<ModelSelection> {
   if (!config.provider && !config.model) {
     return {
       model: fallbackModel,
@@ -52,7 +67,7 @@ async function resolveModelSelection(ctx: ExtensionContext, config: OptionalMode
   if (!config.provider || !config.model) {
     return {
       model: fallbackModel,
-      warning: "Both recap.provider and recap.model are required; using the current model.",
+      warning: `Both ${feature}.provider and ${feature}.model are required; using the current model.`,
     };
   }
 

package/src/utils/usage.ts

@@ -1,7 +1,7 @@
 import type { Usage } from "@earendil-works/pi-ai";
 import type { SessionEntry } from "@earendil-works/pi-coding-agent";
 
-/** Structural type guard for the pi `Usage` shape. */
+/** Structural type guard for the Pi `Usage` shape. */
 export function isUsage(value: unknown): value is Usage {
   if (typeof value !== "object" || value === null) return false;
 

package/src/features/pi/actions/models.ts

@@ -1,165 +0,0 @@
-import { keyHint, truncateHead } from "@earendil-works/pi-coding-agent";
-import { Container, Spacer, Text } from "@earendil-works/pi-tui";
-import { filter, parse } from "liqe";
-import { Type } from "typebox";
-
-import { defineAction } from "../registry";
-import { formatListNotice, toMetadata, toModelRow } from "../model";
-
-import type { TruncationResult } from "@earendil-works/pi-coding-agent";
-import type { ModelMetadata, ModelRow } from "../model";
-
-const LIST_MAX_LINES = 200;
-const COLLAPSED_MAX_LINES = 10;
-
-interface ModelsDetails {
-  action: "models";
-  models: ModelMetadata[];
-  total: number;
-  truncation?: TruncationResult;
-}
-
-export const modelsAction = defineAction({
-  name: "models",
-  summary: `lists and searches the model catalog (one JSON object per line, truncated to ${LIST_MAX_LINES} models)`,
-  fields: {
-    query: Type.Optional(Type.String({
-      description:
-        "For \"models\": Filter models with a Liqe (Lucene-like) query. Bare terms match any " +
-        "field, and unquoted terms are case-insensitive substrings. The syntax supports " +
-        "AND/OR/NOT, grouping, wildcards, and numeric comparisons; quote values containing " +
-        "special characters (e.g., id:\"deepseek/deepseek-v4\"). Filterable fields are id, name, " +
-        "provider, api, reasoning (boolean), input (modalities), cost.input and cost.output " +
-        "(USD per 1M tokens), contextWindow, maxTokens, thinkingLevels, and available " +
-        "(boolean, true when auth is configured). Examples: \"claude available:true\", " +
-        "\"provider:openrouter cost.input:<1\".",
-    })),
-    offset: Type.Optional(Type.Number({ description: "For \"models\": Start from this model number (1-indexed)." })),
-    limit: Type.Optional(Type.Number({ description: "For \"models\": Return at most this many models." })),
-  },
-  promptGuidelines: [
-    "Use the pi tool's \"models\" action when you need metadata of pi models; include available:true in the query unless unavailable models are needed.",
-  ],
-  renderParams(args, theme) {
-    const params: string[] = [];
-
-    const query = args.query?.trim();
-    if (query) params.push(theme.fg("muted", query));
-
-    if (args.offset !== undefined || args.limit !== undefined) {
-      const start = args.offset ?? 1;
-      const end = args.limit !== undefined ? start + args.limit - 1 : "end";
-      params.push(theme.fg("warning", `${start}-${end}`));
-    }
-
-    return params;
-  },
-  renderResult(result, { expanded }, theme, context) {
-    const details = result.details as ModelsDetails | undefined;
-
-    const container = new Container();
-    container.addChild(new Spacer(1));
-
-    if (!details) {
-      container.addChild(new Text(theme.fg("muted", "No models found."), 0, 0));
-      return container;
-    }
-
-    const addRows = (rows: ModelRow[]) => {
-      const widths = {
-        label: Math.max(...rows.map((row) => row.label.length)),
-        cost: Math.max(...rows.map((row) => row.cost.length)),
-        context: Math.max(...rows.map((row) => row.context.length)),
-      };
-
-      for (const row of rows) {
-        const cells = [
-          row.label.padEnd(widths.label),
-          row.cost.padStart(widths.cost),
-          row.context.padStart(widths.context),
-        ].join("  ");
-        const noAuthHint = row.available ? "" : theme.fg("dim", "  (no auth)");
-        container.addChild(new Text(theme.fg("muted", cells) + noAuthHint, 0, 0));
-      }
-    };
-
-    const filtered = Boolean(context.args.query?.trim());
-    const models = details.models ?? [];
-    const total = details.total ?? models.length;
-
-    if (models.length > 0) {
-      const maxRows = expanded ? models.length : Math.min(models.length, COLLAPSED_MAX_LINES);
-      addRows(models.slice(0, maxRows).map((model) => toModelRow(model)));
-
-      const hiddenRows = models.length - maxRows;
-      if (hiddenRows > 0) container.addChild(new Text(theme.fg("dim", `... (${hiddenRows} more, `) + keyHint("app.tools.expand", "to expand") + theme.fg("dim", ")"), 0, 0));
-      container.addChild(new Spacer(1));
-    }
-
-    if (details.truncation?.truncated) {
-      const startIndex = context.args.offset ? Math.max(0, context.args.offset - 1) : 0;
-      const endDisplay = startIndex + models.length;
-      const notice = formatListNotice(true, startIndex, endDisplay, total);
-      if (notice) {
-        container.addChild(new Text(theme.fg("warning", notice), 0, 0));
-        container.addChild(new Spacer(1));
-      }
-    }
-
-    const summary = `${models.length !== total ? `${models.length} of ` : ""}${total} ${filtered ? "matched " : ""}model${total === 1 ? "" : "s"} listed.`;
-    container.addChild(new Text(theme.fg("muted", total > 0 ? summary : `No models ${filtered ? "matched" : "found"}.`), 0, 0));
-
-    return container;
-  },
-  async execute(args, { ctx }) {
-    const queryText = args.query?.trim();
-    const filtered = Boolean(queryText);
-
-    let listQuery = null;
-    if (queryText) {
-      try {
-        listQuery = parse(queryText);
-      } catch (error) {
-        throw new Error(`Invalid Liqe query ${JSON.stringify(queryText)}: ${error instanceof Error ? error.message : String(error)}`);
-      }
-    }
-
-    const models = ctx.modelRegistry.getAll().map((model) => toMetadata(model, ctx.modelRegistry.hasConfiguredAuth(model)));
-    const matched = listQuery ? filter(listQuery, models) : models;
-    const total = matched.length;
-
-    if (total === 0) {
-      return {
-        content: [{ type: "text", text: `No models ${filtered ? "matched" : "found"}.` }],
-        details: { action: "models", models: [], total } satisfies ModelsDetails,
-      };
-    }
-
-    // Convert from 1-indexed offset to 0-indexed array access.
-    const startIndex = args.offset ? Math.max(0, args.offset - 1) : 0;
-    if (startIndex >= total) {
-      throw new Error(`Offset ${args.offset} is beyond the end of the list (${total} models total)`);
-    }
-
-    const endIndex = args.limit !== undefined ? Math.min(startIndex + args.limit, total) : total;
-    const selected = matched.slice(startIndex, endIndex);
-
-    // JSONL: one compact object per line, so truncation cuts at record boundaries.
-    const truncation = truncateHead(selected.map((model) => JSON.stringify(model)).join("\n"), {
-      maxLines: LIST_MAX_LINES,
-      maxBytes: Infinity,
-    });
-
-    const delivered = truncation.truncated ? selected.slice(0, truncation.outputLines) : selected;
-    const endDisplay = startIndex + delivered.length;
-
-    let text = truncation.content;
-    const notice = formatListNotice(truncation.truncated, startIndex, endDisplay, total);
-    if (notice) text += `\n\n${notice}`;
-
-    return {
-      content: [{ type: "text", text }],
-      details: { action: "models", models: delivered, total, truncation } satisfies ModelsDetails,
-    };
-  },
-});

package/src/features/pi/actions/name.ts

@@ -1,58 +0,0 @@
-import { Text } from "@earendil-works/pi-tui";
-import { Type } from "typebox";
-
-import { sanitizeText } from "../../../utils/format";
-import { defineAction } from "../registry";
-
-interface NameDetails {
-  action: "name";
-  changed: boolean;
-  previous: string | null;
-}
-
-export const nameAction = defineAction({
-  name: "name",
-  summary: "sets or updates the current session's name",
-  fields: {
-    name: Type.String({
-      minLength: 1,
-      maxLength: 120,
-      description:
-        "For \"name\": Use a short, recognizable phrase in sentence case, ideally <= 72 characters " +
-        "(e.g., \"Refactor auth module\", \"Debug flaky CI pipeline\"). Do not use " +
-        "surrounding quotes, trailing punctuation, or generic prefixes like \"Chat about\".",
-    }),
-  },
-  required: ["name"],
-  promptGuidelines: [
-    "Use the pi tool's \"name\" action to give the current session a concise, recognizable name, especially after a long, vague, or pasted opening prompt, or after a substantial shift in the conversation's focus.",
-  ],
-  renderParams(args, theme) {
-    return [theme.fg("muted", sanitizeText(args.name ?? ""))];
-  },
-  renderResult() {
-    // "name" has no success UI; errors are rendered by the registry's fallback.
-    return new Text("", 0, 0);
-  },
-  async execute(args, { pi }) {
-    const name = sanitizeText(args.name);
-    if (!name) throw new Error("Session name was empty after normalization; provide a short, non-empty phrase");
-
-    const previous = pi.getSessionName() ?? null;
-    if (previous === name) {
-      const details: NameDetails = { action: "name", changed: false, previous };
-      return {
-        content: [{ type: "text", text: `Session is already named "${name}". Nothing changed.` }],
-        details,
-      };
-    }
-
-    pi.setSessionName(name);
-
-    const details: NameDetails = { action: "name", changed: true, previous };
-    return {
-      content: [{ type: "text", text: previous ? `Renamed session from "${previous}" to "${name}".` : `Named session "${name}".` }],
-      details,
-    };
-  },
-});

package/src/features/pi/actions/whoami.ts

@@ -1,61 +0,0 @@
-import { Container, Spacer, Text } from "@earendil-works/pi-tui";
-
-import { defineAction } from "../registry";
-import { toMetadata, toModelRow } from "../model";
-
-import type { ModelThinkingLevel } from "@earendil-works/pi-ai";
-import type { ModelMetadata } from "../model";
-
-interface WhoamiDetails {
-  action: "whoami";
-  sessionName: string | null;
-  model: ModelMetadata | null;
-  thinkingLevel: ModelThinkingLevel;
-}
-
-export const whoamiAction = defineAction({
-  name: "whoami",
-  summary: "shows the current pi state, including session name, active model, and thinking level",
-  fields: {},
-  promptGuidelines: [
-    "Use the pi tool's \"whoami\" action when you need the current session's name or the active model and thinking level.",
-  ],
-  renderResult(result, _options, theme) {
-    const details = result.details as WhoamiDetails | undefined;
-
-    const container = new Container();
-    container.addChild(new Spacer(1));
-
-    if (!details) {
-      container.addChild(new Text(theme.fg("muted", "No pi state available."), 0, 0));
-      return container;
-    }
-
-    const formatLine = (label: string, value: string) => `${label.padEnd(7)}  ${value}`;
-
-    if (details.sessionName) {
-      container.addChild(new Text(theme.fg("muted", formatLine("session", details.sessionName)), 0, 0));
-    }
-
-    if (details.model) {
-      const row = toModelRow(details.model, details.thinkingLevel);
-      const cells = [row.label, row.cost, row.context].join("  ");
-      container.addChild(new Text(theme.fg("muted", formatLine("model", cells)), 0, 0));
-    }
-
-    return container;
-  },
-  async execute(_args, { pi, ctx }) {
-    const state: WhoamiDetails = {
-      action: "whoami",
-      sessionName: pi.getSessionName() ?? null,
-      model: ctx.model ? toMetadata(ctx.model, true) : null,
-      thinkingLevel: pi.getThinkingLevel(),
-    };
-
-    return {
-      content: [{ type: "text", text: JSON.stringify(state) }],
-      details: state,
-    };
-  },
-});

package/src/features/pi/config.ts

@@ -1,3 +0,0 @@
-import * as z from "zod";
-
-export const piConfigSchema = z.object({});

package/src/features/pi/index.ts

@@ -1,23 +0,0 @@
-import { nameAction } from "./actions/name";
-import { modelsAction } from "./actions/models";
-import { whoamiAction } from "./actions/whoami";
-import { registerPiTool } from "./registry";
-import { loadConfig } from "../../config";
-
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-
-/** Self-management actions exposed by the pi tool, ordered alphabetically by action name. */
-const ACTIONS = [
-  modelsAction,
-  nameAction,
-  whoamiAction,
-];
-
-export function registerPi(pi: ExtensionAPI): void {
-  pi.on("session_start", (_event, ctx) => {
-    const config = loadConfig(ctx).pi;
-    if (!config) return;
-
-    registerPiTool(pi, ACTIONS);
-  });
-}

package/src/features/pi/model.ts

@@ -1,56 +0,0 @@
-import { clampThinkingLevel, getSupportedThinkingLevels } from "@earendil-works/pi-ai";
-
-import { formatModel, formatTokens } from "../../utils/format";
-
-import type { Api, Model, ModelThinkingLevel } from "@earendil-works/pi-ai";
-
-/** Pi's built-in default thinking level, clamped per model. Not exported by pi's public API. */
-const DEFAULT_THINKING_LEVEL: ModelThinkingLevel = "medium";
-
-export type ModelMetadata = Omit<Model<Api>, "headers" | "compat"> & {
-  thinkingLevels: ModelThinkingLevel[];
-  defaultThinkingLevel: ModelThinkingLevel;
-  available: boolean;
-};
-
-export type ModelRow = {
-  label: string;
-  cost: string;
-  context: string;
-  available: boolean;
-};
-
-export function toMetadata(model: Model<Api>, available: boolean): ModelMetadata {
-  const { headers: _headers, compat: _compat, ...metadata } = model;
-
-  return {
-    ...metadata,
-    thinkingLevels: getSupportedThinkingLevels(model),
-    defaultThinkingLevel: clampThinkingLevel(model, DEFAULT_THINKING_LEVEL),
-    available,
-  };
-}
-
-export function toModelRow(model: ModelMetadata, thinkingLevel?: ModelThinkingLevel): ModelRow {
-  return {
-    label: formatModel(model.provider, model.id, thinkingLevel),
-    cost: `$${formatPrice(model.cost.input)}/$${formatPrice(model.cost.output)}`,
-    context: formatTokens(model.contextWindow),
-    available: model.available,
-  };
-}
-
-/** Round to at most 2 decimals and trim float noise: 0.7999... -> 0.8, 0.0983 -> 0.1, 15 -> 15. */
-function formatPrice(value: number): string {
-  return String(parseFloat(value.toFixed(2)));
-}
-
-/** Notice line describing truncation or remaining pages, shared by the text result and the TUI. */
-export function formatListNotice(truncated: boolean, startIndex: number, endDisplay: number, total: number): string | undefined {
-  const nextOffset = endDisplay + 1;
-
-  if (truncated) return `[Truncated: showing models ${startIndex + 1}-${endDisplay} of ${total}. Use offset=${nextOffset} to continue.]`;
-  if (endDisplay < total) return `[${total - endDisplay} more models in list. Use offset=${nextOffset} to continue.]`;
-
-  return undefined;
-}

package/src/features/pi/registry.ts

@@ -1,28 +0,0 @@
-import { defineActionFor, registerComposedTool } from "../../utils/tool";
-
-import type { Action } from "../../utils/tool";
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-
-interface PiActionContext {
-  pi: ExtensionAPI;
-  ctx: ExtensionContext;
-}
-
-export const defineAction = defineActionFor<PiActionContext>();
-
-export function registerPiTool(pi: ExtensionAPI, actions: Action<PiActionContext, any, any>[]): void {
-  registerComposedTool<PiActionContext>(pi, {
-    name: "pi",
-    label: "pi",
-    descriptionIntro:
-      "Inspect and adjust the current pi session and model state. This tool groups " +
-      "self-management actions over the running pi instance:",
-    descriptionOutro: "Use this tool to read or change pi's own state instead of guessing.",
-    promptSnippet: "Inspect and adjust the current pi session and model state",
-    generalGuidelines: [
-      "The pi tool operates only on pi's own session and model state; it does not read or modify the user's project, files, or task.",
-    ],
-    actions,
-    createContext: (ctx) => ({ pi, ctx }),
-  });
-}

package/src/features/web/actions/fetch.ts

@@ -1,47 +0,0 @@
-import { Type } from "typebox";
-
-import { defineAction } from "../registry";
-import { renderWebResult } from "../render";
-
-interface FetchDetails {
-  action: "fetch";
-}
-
-export const fetchAction = defineAction({
-  name: "fetch",
-  summary: "reads the full content of known URLs as clean markdown",
-  showTiming: true,
-  fields: {
-    urls: Type.Optional(Type.Array(Type.String(), {
-      description: "For \"fetch\": List the URLs to read. Batch multiple URLs in one call.",
-    })),
-    maxCharacters: Type.Optional(Type.Number({
-      description: "For \"fetch\": Extract at most this many characters per page (default 3000).",
-    })),
-  },
-  promptGuidelines: [
-    "Use the web tool's \"fetch\" action to read full content from known URLs, batching multiple URLs in one call, especially when search highlights are insufficient.",
-  ],
-  renderParams(args, theme) {
-    const params: string[] = [];
-
-    if (args.urls && args.urls.length > 0) params.push(theme.fg("muted", args.urls.join(", ")));
-    if (args.maxCharacters !== undefined) params.push(theme.fg("warning", `<= ${args.maxCharacters} chars`));
-
-    return params;
-  },
-  renderResult(result, { expanded }, theme) {
-    return renderWebResult(result, expanded, theme);
-  },
-  async execute(args, { exa }, signal) {
-    if (!(args.urls && args.urls.length > 0)) {
-      throw new Error("The \"fetch\" action requires a non-empty \"urls\" array");
-    }
-
-    const requestArgs: Record<string, unknown> = { urls: args.urls };
-    if (args.maxCharacters !== undefined) requestArgs.maxCharacters = args.maxCharacters;
-
-    const content = await exa.call("web_fetch_exa", requestArgs, signal);
-    return { content, details: { action: "fetch" } satisfies FetchDetails };
-  },
-});

package/src/features/web/actions/search.ts

@@ -1,50 +0,0 @@
-import { Type } from "typebox";
-
-import { defineAction } from "../registry";
-import { renderWebResult } from "../render";
-
-interface SearchDetails {
-  action: "search";
-}
-
-export const searchAction = defineAction({
-  name: "search",
-  summary: "finds current information across the web and returns ready-to-use content",
-  showTiming: true,
-  fields: {
-    query: Type.Optional(Type.String({
-      description:
-        "For \"search\": Provide the search query. Use a semantically rich description of the " +
-        "ideal page, not just keywords. Optionally include category:<type> (company, people) " +
-        "to focus results.",
-    })),
-    numResults: Type.Optional(Type.Number({
-      description: "For \"search\": Return at most this many search results (default 10).",
-    })),
-  },
-  promptGuidelines: [
-    "Use the web tool's \"search\" action for current information, news, facts, people, or companies; describe the ideal page rather than keywords (e.g., \"blog post comparing React and Vue performance\").",
-  ],
-  renderParams(args, theme) {
-    const params: string[] = [];
-
-    const query = args.query?.trim();
-    if (query) params.push(theme.fg("muted", query));
-    if (args.numResults !== undefined) params.push(theme.fg("warning", `${args.numResults} results`));
-
-    return params;
-  },
-  renderResult(result, { expanded }, theme) {
-    return renderWebResult(result, expanded, theme);
-  },
-  async execute(args, { exa }, signal) {
-    const query = args.query?.trim();
-    if (!query) throw new Error("The \"search\" action requires a non-empty \"query\"");
-
-    const requestArgs: Record<string, unknown> = { query };
-    if (args.numResults !== undefined) requestArgs.numResults = args.numResults;
-
-    const content = await exa.call("web_search_exa", requestArgs, signal);
-    return { content, details: { action: "search" } satisfies SearchDetails };
-  },
-});

package/src/features/web/client.ts

@@ -1,77 +0,0 @@
-import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import type { TextContent } from "@earendil-works/pi-ai";
-
-/** Exa's hosted MCP endpoint (Streamable HTTP). No API key required for the free tier. */
-const EXA_MCP_URL = "https://mcp.exa.ai/mcp";
-
-/** Collapse an MCP tool call result's content into plain text content for the model. */
-function sanitizeContent(content: unknown): TextContent[] {
-  const blocks = (Array.isArray(content) ? content : []) as { type: string; text?: string}[];
-  const result: TextContent[] = blocks.map((block) =>
-    block.type === "text" && typeof block.text === "string"
-      ? { type: "text", text: block.text }
-      : { type: "text", text: JSON.stringify(block) },
-  );
-
-  return result;
-}
-
-/**
- * Thin, session-scoped wrapper over Exa's remote MCP server using the official MCP client.
- *
- * The MCP connection (one `initialize` handshake) is established lazily on the first call and
- * reused for the rest of the session; `close()` tears it down on `session_shutdown`.
- */
-export class ExaClient {
-  private client: Client | undefined;
-  private connecting: Promise<Client> | undefined;
-
-  async call(toolName: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<TextContent[]> {
-    const client = await this.getClient();
-    const result = await client.callTool({ name: toolName, arguments: args }, undefined, signal ? { signal } : undefined);
-    const content = sanitizeContent(result.content);
-
-    if (result.isError && content.length > 0) {
-      const text = content.map((block) => block.text).join("\n");
-      throw new Error(`Exa request failed: ${text}`);
-    }
-
-    if (result.isError) throw new Error(`Exa request failed: no content returned`);
-    if (content.length === 0) throw new Error(`No content returned`);
-
-    return content;
-  }
-
-  async close(): Promise<void> {
-    const current = this.client;
-    this.client = undefined;
-    this.connecting = undefined;
-    await current?.close().catch(() => {});
-  }
-
-  private getClient(): Promise<Client> {
-    if (this.client) return Promise.resolve(this.client);
-
-    if (!this.connecting) {
-      this.connecting = (async () => {
-        // The MCP SDK is heavy to import (~40 ms cold); load it lazily so startup never pays for
-        // it unless a web action actually runs.
-        const [{ Client }, { StreamableHTTPClientTransport }] = await Promise.all([
-          import("@modelcontextprotocol/sdk/client/index.js"),
-          import("@modelcontextprotocol/sdk/client/streamableHttp.js"),
-        ]);
-
-        const next = new Client({ name: "pi-spark", version: "0" });
-        const transport = new StreamableHTTPClientTransport(new URL(EXA_MCP_URL));
-        await next.connect(transport as Parameters<Client["connect"]>[0]);
-        this.client = next;
-        return next;
-      })().catch((error) => {
-        this.connecting = undefined;
-        throw error;
-      });
-    }
-
-    return this.connecting;
-  }
-}

package/src/features/web/config.ts

@@ -1,3 +0,0 @@
-import * as z from "zod";
-
-export const webConfigSchema = z.object({});