@pi-harness/pi-harness 0.1.14 → 0.1.16

package/packages/client-web/src/context-doctor-view.ts

@@ -1,140 +0,0 @@
-const defaults = {
-  scannedMessages: 10_000,
-  jsonDepth: 64,
-  jsonNodesPerMessage: 10_000,
-  jsonNodesPerAudit: 100_000,
-  errorCharacters: 2_000,
-  recommendationCharacters: 500,
-  displayRecommendations: 4,
-  warnPercent: 75,
-  maxMessageBytes: 64 * 1024,
-  messageCount: 4_294_967_295,
-} as const;
-
-function dataProperty(value: unknown, key: PropertyKey): unknown {
-  if (value === null || typeof value !== "object") return undefined;
-  try {
-    const descriptor = Object.getOwnPropertyDescriptor(value, key);
-    return descriptor !== undefined && "value" in descriptor ? descriptor.value : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-function limit(value: unknown, fallback: number): number {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 1 && value <= fallback ? value : fallback;
-}
-
-function count(value: unknown, maximum: number): number {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 && value <= maximum ? value : 0;
-}
-
-function nullableCount(value: unknown): number | null {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : null;
-}
-
-function boundedText(value: unknown, maximum: number): string {
-  return typeof value === "string" ? value.slice(0, maximum).replaceAll("\0", "�") : "";
-}
-
-function timestamp(value: unknown): string | null {
-  if (typeof value !== "string" || value.length > 64) return null;
-  try {
-    return new Date(value).toISOString() === value ? value : null;
-  } catch {
-    return null;
-  }
-}
-
-function arrayLength(value: readonly unknown[]): number {
-  const length = dataProperty(value, "length");
-  return typeof length === "number" && Number.isSafeInteger(length) && length >= 0 ? length : 0;
-}
-
-type CompactionStatus = "idle" | "queued" | "running" | "completed" | "failed" | "cancelled" | "unknown";
-
-function compactionView(value: unknown, errorCharacters: number) {
-  const rawStatus = dataProperty(value, "status");
-  const status: CompactionStatus =
-    rawStatus === "idle" ||
-    rawStatus === "queued" ||
-    rawStatus === "running" ||
-    rawStatus === "completed" ||
-    rawStatus === "failed" ||
-    rawStatus === "cancelled"
-      ? rawStatus
-      : "unknown";
-  const error = status === "failed" || status === "cancelled" ? boundedText(dataProperty(value, "error"), errorCharacters) || null : null;
-  return {
-    status,
-    error,
-    requestedAt: timestamp(dataProperty(value, "requestedAt")),
-    startedAt: timestamp(dataProperty(value, "startedAt")),
-    finishedAt: timestamp(dataProperty(value, "finishedAt")),
-  };
-}
-
-export function contextDoctorPanelView(data: unknown) {
-  const rawLimits = dataProperty(data, "limits");
-  const limits = {
-    scannedMessages: limit(dataProperty(rawLimits, "scannedMessages"), defaults.scannedMessages),
-    jsonDepth: limit(dataProperty(rawLimits, "jsonDepth"), defaults.jsonDepth),
-    jsonNodesPerMessage: limit(dataProperty(rawLimits, "jsonNodesPerMessage"), defaults.jsonNodesPerMessage),
-    jsonNodesPerAudit: limit(dataProperty(rawLimits, "jsonNodesPerAudit"), defaults.jsonNodesPerAudit),
-    errorCharacters: limit(dataProperty(rawLimits, "errorCharacters"), defaults.errorCharacters),
-    recommendationCharacters: defaults.recommendationCharacters,
-    displayRecommendations: defaults.displayRecommendations,
-  };
-  const rawStatus = dataProperty(data, "status");
-  const status = rawStatus === "ok" || rawStatus === "warning" ? rawStatus : "unknown";
-  const rawUsagePercent = dataProperty(data, "usagePercent");
-  const usagePercent = typeof rawUsagePercent === "number" && Number.isFinite(rawUsagePercent) && rawUsagePercent >= 0 ? rawUsagePercent : null;
-  const messageCount = count(dataProperty(data, "messageCount"), defaults.messageCount);
-  const scannedMessages = count(dataProperty(data, "scannedMessages"), Math.min(messageCount, limits.scannedMessages));
-  const oversizedMessages = count(dataProperty(data, "oversizedMessages"), scannedMessages);
-  const uninspectableMessages = count(dataProperty(data, "uninspectableMessages"), oversizedMessages);
-  const toolErrors = count(dataProperty(data, "toolErrors"), scannedMessages);
-  const rawWarnPercent = dataProperty(data, "warnPercent");
-  const warnPercent =
-    typeof rawWarnPercent === "number" && Number.isFinite(rawWarnPercent) && rawWarnPercent >= 1 && rawWarnPercent <= 100
-      ? rawWarnPercent
-      : defaults.warnPercent;
-  const maxMessageBytes = limit(dataProperty(data, "maxMessageBytes"), 1024 * 1024);
-  const normalizedMaxMessageBytes =
-    maxMessageBytes === 1024 * 1024 && dataProperty(data, "maxMessageBytes") !== 1024 * 1024 ? defaults.maxMessageBytes : maxMessageBytes;
-
-  const rawRecommendations = dataProperty(data, "recommendations");
-  const recommendations: string[] = [];
-  let recommendationsTruncated = false;
-  if (Array.isArray(rawRecommendations)) {
-    const length = arrayLength(rawRecommendations);
-    for (let index = 0; index < Math.min(length, limits.displayRecommendations); index += 1) {
-      const recommendation = boundedText(dataProperty(rawRecommendations, String(index)), limits.recommendationCharacters);
-      if (recommendation === "") {
-        recommendationsTruncated = true;
-        continue;
-      }
-      recommendations.push(recommendation);
-    }
-    recommendationsTruncated ||= length > recommendations.length;
-  }
-
-  return {
-    status,
-    usagePercent,
-    tokens: nullableCount(dataProperty(data, "tokens")),
-    contextWindow: nullableCount(dataProperty(data, "contextWindow")),
-    messageCount,
-    scannedMessages,
-    messagesTruncated: dataProperty(data, "messagesTruncated") === true || messageCount > scannedMessages,
-    oversizedMessages,
-    uninspectableMessages,
-    toolErrors,
-    warnPercent,
-    maxMessageBytes: normalizedMaxMessageBytes,
-    recommendations,
-    recommendationsTruncated,
-    compaction: compactionView(dataProperty(data, "compaction"), limits.errorCharacters),
-    limits,
-  };
-}

package/packages/client-web/src/context-insights-view.ts

@@ -1,125 +0,0 @@
-export interface ContextInsightsEventView {
-  readonly type: string;
-  readonly at: number | null;
-}
-
-export interface ContextInsightsPanelView {
-  readonly tokens: number | null;
-  readonly contextWindow: number | null;
-  readonly percent: number | null;
-  readonly messages: number;
-  readonly scannedMessages: number;
-  readonly messagesTruncated: boolean;
-  readonly events: number;
-  readonly compactions: number;
-  readonly composition: {
-    readonly user: number;
-    readonly assistant: number;
-    readonly toolResult: number;
-    readonly system: number;
-    readonly other: number;
-  };
-  readonly recentEvents: readonly ContextInsightsEventView[];
-  readonly recentEventsTruncated: boolean;
-  readonly limits: {
-    readonly scannedMessages: number;
-    readonly retainedEvents: number;
-    readonly displayedEvents: number;
-    readonly eventTypeCharacters: number;
-  };
-}
-
-const limits = {
-  scannedMessages: 10_000,
-  retainedEvents: 50,
-  displayedEvents: 6,
-  eventTypeCharacters: 128,
-} as const;
-const maxReportedCount = 4_294_967_295;
-const maxDateMilliseconds = 8_640_000_000_000_000;
-
-function dataProperty(value: unknown, key: PropertyKey): unknown {
-  if (typeof value !== "object" || value === null) return undefined;
-  try {
-    const descriptor = Object.getOwnPropertyDescriptor(value, key);
-    return descriptor !== undefined && "value" in descriptor ? descriptor.value : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-function count(value: unknown, maximum = maxReportedCount): number {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 && value <= maximum ? value : 0;
-}
-
-function nullableCount(value: unknown): number | null {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : null;
-}
-
-function percent(value: unknown): number | null {
-  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
-}
-
-function eventType(value: unknown): string {
-  if (typeof value !== "string") return "unknown";
-  const normalized = value.trim().replaceAll("\0", "�");
-  return normalized === "" ? "unknown" : normalized.slice(0, limits.eventTypeCharacters);
-}
-
-function eventTimestamp(value: unknown): number | null {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 && value <= maxDateMilliseconds ? value : null;
-}
-
-function arrayLength(value: unknown): number {
-  if (!Array.isArray(value)) return 0;
-  return count(dataProperty(value, "length"), maxReportedCount);
-}
-
-function normalizedComposition(value: unknown, scannedMessages: number): ContextInsightsPanelView["composition"] {
-  const composition = {
-    user: count(dataProperty(value, "user"), scannedMessages),
-    assistant: count(dataProperty(value, "assistant"), scannedMessages),
-    toolResult: count(dataProperty(value, "toolResult"), scannedMessages),
-    system: count(dataProperty(value, "system"), scannedMessages),
-    other: count(dataProperty(value, "other"), scannedMessages),
-  };
-  const total = Object.values(composition).reduce((sum, item) => sum + item, 0);
-  return total === scannedMessages ? composition : { user: 0, assistant: 0, toolResult: 0, system: 0, other: scannedMessages };
-}
-
-function normalizedEvents(value: unknown): { events: ContextInsightsEventView[]; truncated: boolean } {
-  let rawLength: number;
-  try {
-    rawLength = arrayLength(value);
-  } catch {
-    return { events: [], truncated: false };
-  }
-  const retained = Math.min(rawLength, limits.retainedEvents);
-  const events: ContextInsightsEventView[] = [];
-  for (let offset = 0; offset < Math.min(retained, limits.displayedEvents); offset += 1) {
-    const index = rawLength - offset - 1;
-    const event = dataProperty(value, String(index));
-    events.push({ type: eventType(dataProperty(event, "type")), at: eventTimestamp(dataProperty(event, "at")) });
-  }
-  return { events, truncated: rawLength > events.length };
-}
-
-export function contextInsightsPanelView(data: unknown): ContextInsightsPanelView {
-  const messages = count(dataProperty(data, "messages"));
-  const scannedMessages = count(dataProperty(data, "scannedMessages"), Math.min(messages, limits.scannedMessages));
-  const recent = normalizedEvents(dataProperty(data, "recentEvents"));
-  return {
-    tokens: nullableCount(dataProperty(data, "tokens")),
-    contextWindow: nullableCount(dataProperty(data, "contextWindow")),
-    percent: percent(dataProperty(data, "percent")),
-    messages,
-    scannedMessages,
-    messagesTruncated: dataProperty(data, "messagesTruncated") === true || messages > scannedMessages,
-    events: count(dataProperty(data, "events")),
-    compactions: count(dataProperty(data, "compactions")),
-    composition: normalizedComposition(dataProperty(data, "composition"), scannedMessages),
-    recentEvents: recent.events,
-    recentEventsTruncated: recent.truncated,
-    limits,
-  };
-}

package/packages/client-web/src/control-room.ts

@@ -1,359 +0,0 @@
-export interface ClientStatus {
-  readonly status: string;
-  readonly model: string;
-  readonly messages: number;
-  readonly events: number;
-  readonly sessionId: string;
-  readonly sessionFile?: string;
-  readonly cwd: string;
-  readonly agentDir: string;
-  readonly plugins: readonly string[];
-}
-export interface ClientSession {
-  readonly sessionId: string;
-  readonly sessionFile?: string;
-  readonly messages: readonly Record<string, unknown>[];
-  readonly entries: readonly unknown[];
-  readonly events: readonly Record<string, unknown>[];
-}
-export interface ClientModel {
-  readonly provider: string;
-  readonly id: string;
-  readonly name: string;
-  readonly reasoning: boolean;
-  readonly contextWindow: number | null;
-  readonly active: boolean;
-}
-export interface ClientPlugin {
-  readonly id: string;
-  readonly name: string;
-  readonly enabled: boolean;
-  readonly state: string;
-  readonly removable: boolean;
-  readonly category?: { readonly id: string; readonly label: string };
-}
-export interface ClientPluginPanel {
-  readonly id: string;
-  readonly pluginId: string;
-  readonly title: string;
-  readonly description?: string;
-  readonly icon?: string;
-  readonly data?: unknown;
-  readonly error?: string;
-}
-export interface ClientProvider {
-  readonly provider: string;
-  readonly name: string;
-  readonly active: boolean;
-  readonly auth?: { readonly configured?: boolean; readonly source?: string; readonly label?: string };
-  readonly activeModel?: ClientModel;
-  readonly models: readonly ClientModel[];
-}
-export interface ClientCommand {
-  readonly name: string;
-  readonly invocationName: string;
-  readonly description?: string;
-  readonly source?: string;
-}
-export interface ClientMarketplacePlugin {
-  readonly id: string;
-  readonly packageName: string;
-  readonly version: string;
-  readonly name: string;
-  readonly description: string;
-  readonly author: string;
-  readonly repository: string;
-  readonly license: string;
-  readonly source: "official" | "community";
-  readonly status: "verified" | "experimental";
-  readonly category: { readonly id: string; readonly label: string };
-  readonly capabilities: readonly string[];
-  readonly hooks: readonly string[];
-  readonly profile: { readonly name: string; readonly config: Record<string, unknown> | readonly unknown[]; readonly group?: boolean };
-  readonly statistics?: { readonly downloads30d?: number; readonly quality?: number; readonly updatedAt?: string };
-}
-export interface ClientMarketplaceCategory {
-  readonly id: string;
-  readonly label: string;
-  readonly count: number;
-}
-export interface ClientMarketplacePage {
-  readonly items: readonly ClientMarketplacePlugin[];
-  readonly capabilities: readonly string[];
-  readonly categories: readonly ClientMarketplaceCategory[];
-  readonly total: number;
-  readonly page: number;
-  readonly pageSize: number;
-  readonly hasNext: boolean;
-}
-export interface ClientFile {
-  readonly path: string;
-  readonly status: string;
-  readonly label: string;
-}
-export interface ClientWorkspace {
-  readonly path: string;
-  readonly branch: string;
-  readonly current: boolean;
-  readonly name: string;
-}
-export interface ClientPiConfig {
-  readonly path: string;
-  readonly scope: "global" | "project";
-  readonly source: string;
-  readonly settings: {
-    readonly defaultProvider?: string;
-    readonly defaultModel?: string;
-    readonly defaultThinkingLevel?: string;
-    readonly transport: string;
-    readonly steeringMode: string;
-    readonly followUpMode: string;
-    readonly hideThinkingBlock: boolean;
-    readonly compaction: { readonly enabled: boolean; readonly reserveTokens: number; readonly keepRecentTokens: number };
-    readonly retry: { readonly enabled: boolean; readonly maxRetries: number; readonly baseDelayMs: number };
-    readonly terminal: { readonly showImages: boolean; readonly imageAutoResize: boolean; readonly autocompleteMaxVisible: number };
-    readonly advanced: {
-      readonly quietStartup: boolean;
-      readonly projectTrust: string;
-      readonly showCacheMissNotices: boolean;
-      readonly enableAnalytics: boolean;
-      readonly enableInstallTelemetry: boolean;
-      readonly shellPath?: string;
-      readonly doubleEscapeAction: string;
-      readonly treeFilterMode: string;
-      readonly mermaid: string;
-    };
-  };
-}
-export interface ClientSessionList {
-  readonly items: readonly Record<string, unknown>[];
-  readonly total: number;
-  readonly page: number;
-  readonly pageSize: number;
-  readonly hasNext: boolean;
-}
-export interface ClientApi {
-  getStatus(): Promise<ClientStatus>;
-  getSession(): Promise<ClientSession>;
-  getFiles(): Promise<readonly ClientFile[]>;
-  listWorkspaces(): Promise<readonly ClientWorkspace[]>;
-  pickDirectory(): Promise<string>;
-  getFileDiff(path: string): Promise<{ path: string; diff: string }>;
-  commitFiles(paths: readonly string[], message: string): Promise<{ committed: boolean; commit?: string; message: string }>;
-  revertFiles(paths: readonly string[]): Promise<{ reverted: boolean; paths: readonly string[] }>;
-  prompt(value: string): Promise<{ reply: string; messages: number; aborted?: boolean }>;
-  abort(): Promise<{ aborted: boolean }>;
-  createSession(cwd?: string): Promise<ClientSession>;
-  openSession(path: string): Promise<ClientSession>;
-  listSessions(page?: number, pageSize?: number, includeArchived?: boolean): Promise<ClientSessionList>;
-  renameSession(path: string, name: string): Promise<{ path: string; name?: string }>;
-  deleteSession(path: string): Promise<{ deleted: boolean; path: string; sessionFile?: string }>;
-  setSessionMetadata(path: string, metadata: { archived?: boolean; pinned?: boolean }): Promise<{ path: string; metadata: Record<string, unknown> }>;
-  batchSessions(action: "delete" | "archive" | "unarchive" | "pin" | "unpin", paths: readonly string[]): Promise<{ action: string; count: number }>;
-  forkSession(path: string, cwd?: string): Promise<{ sessionId: string; sessionFile?: string; cwd: string }>;
-  importSession(content: string, filename: string, cwd?: string): Promise<ClientSession>;
-  exportSession(path: string): Promise<Blob>;
-  listModels(): Promise<readonly ClientModel[]>;
-  listProviders(): Promise<readonly ClientProvider[]>;
-  testProvider(provider: string): Promise<{ provider: string; reachable: boolean; auth?: unknown }>;
-  refreshProvider(provider: string): Promise<{ provider: string; models: readonly ClientModel[] }>;
-  addProvider(input: {
-    provider: string;
-    name: string;
-    baseUrl: string;
-    api: "openai-completions" | "openai-responses";
-    apiKey: string;
-    model: string;
-  }): Promise<{ provider: ClientProvider }>;
-  listPlugins(): Promise<readonly ClientPlugin[]>;
-  listPluginPanels(): Promise<readonly ClientPluginPanel[]>;
-  togglePlugin(id: string, enabled: boolean): Promise<{ plugin: ClientPlugin }>;
-  uninstallPlugin(id: string): Promise<{ uninstalled: boolean; id: string }>;
-  listMarketplace(query?: string, capability?: string, page?: number, pageSize?: number, category?: string): Promise<ClientMarketplacePage>;
-  installMarketplace(id: string): Promise<{ plugin: ClientMarketplacePlugin; installed: boolean; restartRequired?: boolean }>;
-  listCommands(): Promise<readonly ClientCommand[]>;
-  selectModel(provider: string, model: string): Promise<{ model: ClientModel }>;
-  getConfig(): Promise<ClientPiConfig>;
-  updateConfig(input: Partial<ClientPiConfig["settings"]>): Promise<ClientPiConfig>;
-  updateConfigSource(source: string): Promise<ClientPiConfig>;
-  reloadConfig(): Promise<ClientPiConfig>;
-  subscribeEvents(onEvent: (payload: Record<string, unknown>) => void): () => void;
-}
-
-export function failedRefreshLabels(labels: readonly string[], results: readonly PromiseSettledResult<unknown>[]): readonly string[] {
-  return labels.filter((_, index) => results[index]?.status === "rejected");
-}
-
-function requestJson<T>(path: string, init?: RequestInit): Promise<T> {
-  return fetch(path, init).then(async (response) => {
-    const payload = (await response.json()) as unknown;
-    if (!response.ok) {
-      const error =
-        payload !== null && typeof payload === "object" && "error" in payload && typeof payload.error === "string"
-          ? payload.error
-          : `Request failed with status ${response.status}`;
-      throw new Error(error);
-    }
-    return payload as T;
-  });
-}
-export function createClientApi(): ClientApi {
-  return {
-    getStatus: () => requestJson<ClientStatus>("/api/status"),
-    getSession: () => requestJson<ClientSession>("/api/session"),
-    getFiles: async () => (await requestJson<{ items: readonly ClientFile[] }>("/api/files")).items,
-    listWorkspaces: async () => (await requestJson<{ items: readonly ClientWorkspace[] }>("/api/workspaces")).items,
-    pickDirectory: async () => (await requestJson<{ path: string }>("/api/workspaces/pick", { method: "POST" })).path,
-    getFileDiff: (path) => requestJson<{ path: string; diff: string }>(`/api/files/diff?path=${encodeURIComponent(path)}`),
-    commitFiles: (paths, message) =>
-      requestJson<{ committed: boolean; commit?: string; message: string }>("/api/files/commit", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ paths, message }),
-      }),
-    revertFiles: (paths) =>
-      requestJson<{ reverted: boolean; paths: readonly string[] }>("/api/files/revert", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ paths, confirm: true }),
-      }),
-    prompt: (value) =>
-      requestJson<{ reply: string; messages: number; aborted?: boolean }>("/api/prompt", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ prompt: value }),
-      }),
-    abort: () => requestJson<{ aborted: boolean }>("/api/abort", { method: "POST" }),
-    createSession: (cwd) =>
-      requestJson<ClientSession>("/api/session/new", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify(cwd ? { cwd } : {}),
-      }),
-    openSession: (path) =>
-      requestJson<ClientSession>("/api/session/open", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ path }) }),
-    listSessions: (page = 0, pageSize = 50, includeArchived = false) =>
-      requestJson<ClientSessionList>(`/api/sessions?page=${page}&pageSize=${pageSize}&includeArchived=${includeArchived}`),
-    renameSession: (path, name) =>
-      requestJson<{ path: string; name?: string }>("/api/session/rename", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ path, name }),
-      }),
-    deleteSession: (path) =>
-      requestJson<{ deleted: boolean; path: string; sessionFile?: string }>("/api/session/delete", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ path, confirm: true }),
-      }),
-    setSessionMetadata: (path, metadata) =>
-      requestJson<{ path: string; metadata: Record<string, unknown> }>("/api/session/metadata", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ path, ...metadata }),
-      }),
-    batchSessions: (action, paths) =>
-      requestJson<{ action: string; count: number }>("/api/sessions/batch", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ action, paths, confirm: action === "delete" }),
-      }),
-    forkSession: (path, cwd) =>
-      requestJson<{ sessionId: string; sessionFile?: string; cwd: string }>("/api/session/fork", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ path, cwd }),
-      }),
-    importSession: async (content, filename, cwd) => {
-      const result = await requestJson<{ sessionId: string; sessionFile?: string; messages: number }>("/api/session/import", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ content, filename, cwd }),
-      });
-      return { sessionId: result.sessionId, sessionFile: result.sessionFile, messages: [], entries: [], events: [] };
-    },
-    exportSession: async (path) => {
-      const response = await fetch(`/api/session/export?path=${encodeURIComponent(path)}`);
-      if (!response.ok) throw new Error(`Export failed with status ${response.status}`);
-      return response.blob();
-    },
-    listModels: async () => (await requestJson<{ items: readonly ClientModel[] }>("/api/models")).items,
-    listProviders: async () => (await requestJson<{ items: readonly ClientProvider[] }>("/api/providers")).items,
-    testProvider: (provider) =>
-      requestJson<{ provider: string; reachable: boolean; auth?: unknown }>("/api/providers/test", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ provider }),
-      }),
-    refreshProvider: (provider) =>
-      requestJson<{ provider: string; models: readonly ClientModel[] }>("/api/providers/refresh", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ provider }),
-      }),
-    addProvider: (input) =>
-      requestJson<{ provider: ClientProvider }>("/api/providers/add", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify(input),
-      }),
-    listPlugins: async () => (await requestJson<{ items: readonly ClientPlugin[] }>("/api/plugins")).items,
-    listPluginPanels: async () => (await requestJson<{ items: readonly ClientPluginPanel[] }>("/api/plugin-ui")).items,
-    togglePlugin: (id, enabled) =>
-      requestJson<{ plugin: ClientPlugin }>("/api/plugins/toggle", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ id, enabled }),
-      }),
-    uninstallPlugin: (id) =>
-      requestJson<{ uninstalled: boolean; id: string }>("/api/plugins/uninstall", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ id }),
-      }),
-    listMarketplace: (query = "", capability = "", page = 0, pageSize = 24, category = "") =>
-      requestJson<ClientMarketplacePage>(
-        `/api/marketplace?q=${encodeURIComponent(query)}&capability=${encodeURIComponent(capability)}&category=${encodeURIComponent(category)}&page=${page}&pageSize=${pageSize}&sort=recommended`,
-      ),
-    installMarketplace: (id) =>
-      requestJson<{ plugin: ClientMarketplacePlugin; installed: boolean; restartRequired?: boolean }>("/api/marketplace/install", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ id }),
-      }),
-    listCommands: async () => (await requestJson<{ items: readonly ClientCommand[] }>("/api/commands")).items,
-    selectModel: (provider, model) =>
-      requestJson<{ model: ClientModel }>("/api/model", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ provider, model }),
-      }),
-    getConfig: () => requestJson<ClientPiConfig>("/api/config"),
-    updateConfig: (input) =>
-      requestJson<ClientPiConfig>("/api/config", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify(input),
-      }),
-    updateConfigSource: (source) =>
-      requestJson<ClientPiConfig>("/api/config/source", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ source }),
-      }),
-    reloadConfig: () => requestJson<ClientPiConfig>("/api/config/reload", { method: "POST" }),
-    subscribeEvents: (onEvent) => {
-      if (typeof EventSource === "undefined") return () => {};
-      const source = new EventSource("/api/events");
-      source.onmessage = (event) => {
-        try {
-          const raw: unknown = event.data;
-          if (typeof raw === "string") onEvent(JSON.parse(raw) as Record<string, unknown>);
-        } catch {
-          /* Ignore malformed frames at the network boundary. */
-        }
-      };
-      return () => source.close();
-    },
-  };
-}