@pi-harness/pi-harness 0.1.2 → 0.1.3

package/packages/client-web/dist/runtime-events.d.ts

@@ -0,0 +1,4 @@
+type RuntimeEvent = Record<string, unknown>;
+export declare function compactThinkingEvents(events: readonly RuntimeEvent[]): readonly RuntimeEvent[];
+export {};
+//# sourceMappingURL=runtime-events.d.ts.map

package/packages/client-web/dist/runtime-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-events.d.ts","sourceRoot":"","sources":["../src/runtime-events.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAS5C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,YAAY,EAAE,CAmB9F"}

package/packages/client-web/dist/runtime-events.js

@@ -0,0 +1,29 @@
+function thinkingDelta(event) {
+    if (event?.type !== "message_update" || typeof event.assistantMessageEvent !== "object" || event.assistantMessageEvent === null)
+        return undefined;
+    const assistantMessageEvent = event.assistantMessageEvent;
+    if (assistantMessageEvent.type !== "thinking_delta")
+        return undefined;
+    return { assistantMessageEvent, delta: typeof assistantMessageEvent.delta === "string" ? assistantMessageEvent.delta : "" };
+}
+export function compactThinkingEvents(events) {
+    const compacted = [];
+    for (const event of events) {
+        const currentThinking = thinkingDelta(event);
+        const previous = compacted.at(-1);
+        const previousThinking = thinkingDelta(previous);
+        if (currentThinking && previous && previousThinking) {
+            compacted[compacted.length - 1] = {
+                ...previous,
+                assistantMessageEvent: {
+                    ...previousThinking.assistantMessageEvent,
+                    delta: previousThinking.delta + currentThinking.delta,
+                },
+            };
+            continue;
+        }
+        compacted.push(event);
+    }
+    return compacted;
+}
+//# sourceMappingURL=runtime-events.js.map

package/packages/client-web/dist/runtime-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-events.js","sourceRoot":"","sources":["../src/runtime-events.ts"],"names":[],"mappings":"AAEA,SAAS,aAAa,CAAC,KAA+B;IACpD,IAAI,KAAK,EAAE,IAAI,KAAK,gBAAgB,IAAI,OAAO,KAAK,CAAC,qBAAqB,KAAK,QAAQ,IAAI,KAAK,CAAC,qBAAqB,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClJ,MAAM,qBAAqB,GAAG,KAAK,CAAC,qBAAqC,CAAC;IAC1E,IAAI,qBAAqB,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACtE,OAAO,EAAE,qBAAqB,EAAE,KAAK,EAAE,OAAO,qBAAqB,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC9H,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAA+B;IACnE,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,gBAAgB,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,eAAe,IAAI,QAAQ,IAAI,gBAAgB,EAAE,CAAC;YACpD,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG;gBAChC,GAAG,QAAQ;gBACX,qBAAqB,EAAE;oBACrB,GAAG,gBAAgB,CAAC,qBAAqB;oBACzC,KAAK,EAAE,gBAAgB,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK;iBACtD;aACF,CAAC;YACF,SAAS;QACX,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/packages/client-web/package.json

@@ -1,7 +1,20 @@
 {
   "name": "@pi-harness/client-web",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Browser-side Cordis client plugins for the Pi Harness web surface",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pi-harness/pi-harness.git",
+    "directory": "packages/client-web"
+  },
+  "homepage": "https://github.com/pi-harness/pi-harness#readme",
+  "bugs": {
+    "url": "https://github.com/pi-harness/pi-harness/issues"
+  },
+  "files": [
+    "dist"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,19 +24,18 @@
       "import": "./dist/index.js"
     }
   },
-  "files": [
-    "dist"
-  ],
-  "engines": {
-    "node": ">=22.19.0"
-  },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json"
   },
   "dependencies": {
     "@deepseek-ai/cordis": "4.0.1",
+    "dompurify": "3.4.14",
+    "marked": "18.0.5",
     "react": "^19.1.1",
     "react-dom": "^19.1.1"
+  },
+  "engines": {
+    "node": ">=22.19.0"
   }
 }

package/packages/client-web/src/annotation-ui.ts

@@ -0,0 +1,29 @@
+export interface ClientAnnotation {
+  id: number;
+  quote: string;
+  note: string;
+}
+
+const annotationHeader = "[Pi Harness annotations]";
+const annotationFooter = "[/Pi Harness annotations]";
+const questionMarker = "\n\n提问：";
+
+export function formatAnnotationPrompt(annotations: readonly ClientAnnotation[], question: string): string {
+  const lines = annotations.flatMap((annotation) => [
+    `${annotation.id}. ${annotation.quote}`,
+    ...(annotation.note === "" ? [] : [`   批注：${annotation.note}`]),
+  ]);
+  const instruction = annotations.map((annotation) => `Annotation ${annotation.id}：`).join("、");
+  return `${annotationHeader}\n${lines.join("\n")}\n${annotationFooter}\n\n请逐条回应 ${instruction}${questionMarker}${question.trim()}`;
+}
+
+export function parseAnnotationPrompt(text: string): { question: string; count: number } {
+  const marker = text.lastIndexOf(questionMarker);
+  if (marker < 0) return { question: text, count: 0 };
+  const header = text.lastIndexOf(annotationHeader, marker);
+  const footer = text.indexOf(annotationFooter, header);
+  if (header < 0 || footer < header) return { question: text, count: 0 };
+  const block = text.slice(header + annotationHeader.length, footer);
+  const count = block.split("\n").filter((line) => /^\d+\.\s+/u.test(line)).length;
+  return { question: text.slice(marker + questionMarker.length), count };
+}

package/packages/client-web/src/browser-session-view.ts

@@ -0,0 +1,13 @@
+export interface BrowserSessionTab {
+  readonly targetId: string;
+  readonly title: string;
+  readonly url: string;
+}
+
+export function browserSessionTabs(entries: readonly BrowserSessionTab[], limit: number): readonly BrowserSessionTab[] {
+  const normalizedLimit = Math.max(0, Math.min(20, Math.trunc(limit)));
+  return entries
+    .filter((entry) => entry.targetId.trim() !== "" && entry.url.trim() !== "")
+    .slice(0, normalizedLimit)
+    .map((entry) => ({ targetId: entry.targetId, title: entry.title || "未命名页面", url: entry.url }));
+}

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

@@ -1,11 +1,359 @@
-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; }
-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 capabilities: readonly string[]; readonly hooks: readonly string[]; readonly profile: { readonly name: string; readonly config: Record<string, unknown> }; }
-export interface ClientFile { readonly path: string; readonly status: string; readonly label: string; }
-export interface ClientApi { getStatus(): Promise<ClientStatus>; getSession(): Promise<ClientSession>; getFiles(): Promise<readonly ClientFile[]>; 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 }>; abort(): Promise<{ aborted: boolean }>; createSession(): Promise<ClientSession>; openSession(path: string): Promise<ClientSession>; listSessions(): Promise<readonly Record<string, unknown>[]>; 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[] }>; listPlugins(): Promise<readonly ClientPlugin[]>; listMarketplace(query?: string, capability?: string): Promise<{ items: readonly ClientMarketplacePlugin[]; capabilities: readonly string[] }>; listCommands(): Promise<readonly ClientCommand[]>; selectModel(provider: string, model: string): Promise<{ model: ClientModel }>; subscribeEvents(onEvent: (payload: Record<string, unknown>) => void): () => void; }
-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, 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 }>("/api/prompt", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ prompt: value }) }), abort: () => requestJson<{ aborted: boolean }>("/api/abort", { method: "POST" }), createSession: () => requestJson<ClientSession>("/api/session/new", { method: "POST" }), openSession: (path) => requestJson<ClientSession>("/api/session/open", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ path }) }), listSessions: async () => (await requestJson<{ items: readonly Record<string, unknown>[] }>("/api/sessions")).items, 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 }) }), listPlugins: async () => (await requestJson<{ items: readonly ClientPlugin[] }>("/api/plugins")).items, listMarketplace: (query = "", capability = "") => requestJson<{ items: readonly ClientMarketplacePlugin[]; capabilities: readonly string[] }>(`/api/marketplace?q=${encodeURIComponent(query)}&capability=${encodeURIComponent(capability)}`), 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 }) }), 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(); } }; }
+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 }>;
+  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 }>("/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();
+    },
+  };
+}