kcg-code 0.0.0-stage → 0.2.0

package/src/server/services/opencode-client.ts

@@ -0,0 +1,714 @@
+/**
+ * OpenCode_Client — client HTTP + SSE ke server headless `opencode serve`.
+ *
+ * Menggantikan `pty-process.ts` (PTY/TUI): alih-alih menulis byte ke terminal,
+ * percakapan dilakukan lewat API terstruktur:
+ * - `POST /session`                     buat session (`ses_...`)
+ * - `POST /session/{id}/message`        kirim prompt, balasan terstruktur
+ * - `POST /session/{id}/prompt_async`   kirim prompt, balas 204 (hasil via SSE)
+ * - `POST /permission/{id}/reply`       jawab izin tool (`once|always|reject`)
+ * - `POST /question/{id}/reply|reject`  jawab pertanyaan
+ * - `POST /session/{id}/abort`          hentikan turn berjalan
+ * - `GET /event`                        SSE — event bertipe (permission.asked,
+ *                                       question.asked, message.*, session.*)
+ *
+ * `subscribeEvents` menormalkan frame SSE `{ id, type, properties }` menjadi
+ * `{ type, id, ...properties }` agar konsumen mudah membaca `requestID`,
+ * `sessionID`, `permission`, `questions`, dst.
+ */
+import type { McpServerState, MessagePart, SessionModel } from "../../types";
+import type { Result, SimpleResult } from "../result";
+import { subscribeOpenCodeEvents } from "./opencode-sse";
+
+export interface OpenCodeSessionInfo {
+  id: string;
+  directory?: string;
+  /** Judul session; opencode meng-generate ulang setelah prompt pertama. */
+  title?: string;
+}
+
+/** Satu model yang tersedia pada sebuah provider (hasil GET /config/providers). */
+export interface ModelOption {
+  providerID: string;
+  providerName: string;
+  modelID: string;
+  /** Nama tampilan (fallback: modelID). */
+  name: string;
+}
+
+/** Satu agent (mode) opencode — hasil `GET /agent` server headless. */
+export interface AgentOption {
+  name: string;
+  mode: "primary" | "subagent" | "all";
+  description: string | null;
+}
+
+/**
+ * Satu MCP server Project — hasil `GET /mcp` server headless. Bentuknya
+ * didefinisikan SEKALI di `types/context.ts` (dipakai juga UI) agar server &
+ * klien tidak pernah berbeda.
+ */
+export type McpServerInfo = McpServerState;
+
+/** Status koneksi MCP server — mengikuti skema `MCPStatus` opencode. */
+export type McpStatus = McpServerState["status"];
+
+/** Asal sebuah skill: bawaan opencode, folder Project, atau global user. */
+export type SkillSource = "builtin" | "project" | "global";
+
+/** Satu skill yang terdaftar — hasil `GET /skill` (tanpa isi `content`). */
+export interface SkillInfo {
+  name: string;
+  description: string | null;
+  /** Path SKILL.md; null untuk skill bawaan. */
+  location: string | null;
+  source: SkillSource;
+}
+
+const MCP_STATUSES: readonly McpStatus[] = [
+  "connected",
+  "disabled",
+  "failed",
+  "needs_auth",
+  "needs_client_registration",
+];
+
+/**
+ * Flatten respons `GET /mcp` (`{ [name]: { status, error? } }`) menjadi
+ * daftar terurut nama. Status tak dikenal dipetakan ke `unknown`.
+ */
+export function flattenMcp(payload: unknown): McpServerInfo[] {
+  if (typeof payload !== "object" || payload === null || Array.isArray(payload)) return [];
+  const out: McpServerInfo[] = [];
+  for (const [name, raw] of Object.entries(payload as Record<string, unknown>)) {
+    if (name === "") continue;
+    const v = (typeof raw === "object" && raw !== null ? raw : {}) as {
+      status?: unknown;
+      error?: unknown;
+    };
+    const status = MCP_STATUSES.includes(v.status as McpStatus)
+      ? (v.status as McpStatus)
+      : "unknown";
+    out.push({
+      name,
+      status,
+      error: typeof v.error === "string" && v.error !== "" ? v.error : null,
+    });
+  }
+  return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+/**
+ * Flatten respons `GET /skill` menjadi daftar ringkas. `content` (isi
+ * SKILL.md, bisa panjang) sengaja dibuang. `projectPath` dipakai untuk
+ * mengklasifikasi asal skill: di dalam direktori Project -> `project`,
+ * `<built-in>` -> `builtin`, selain itu -> `global`.
+ */
+export function flattenSkills(payload: unknown, projectPath?: string): SkillInfo[] {
+  if (!Array.isArray(payload)) return [];
+  const root = projectPath ? projectPath.replace(/\/+$/, "") : null;
+  const out: SkillInfo[] = [];
+  for (const raw of payload) {
+    if (typeof raw !== "object" || raw === null) continue;
+    const s = raw as { name?: unknown; description?: unknown; location?: unknown };
+    if (typeof s.name !== "string" || s.name === "") continue;
+    const loc = typeof s.location === "string" && s.location !== "" ? s.location : null;
+    let source: SkillSource = "global";
+    if (loc === null || loc === "<built-in>") source = "builtin";
+    else if (root && (loc === root || loc.startsWith(`${root}/`))) source = "project";
+    out.push({
+      name: s.name,
+      description: typeof s.description === "string" && s.description !== "" ? s.description : null,
+      location: source === "builtin" ? null : loc,
+      source,
+    });
+  }
+  return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+/**
+ * Flatten respons `GET /agent` menjadi opsi siap pakai UI: hanya agent
+ * primary/all (subagent murni tidak bisa dipakai sebagai mode percakapan).
+ * Diekspor agar dapat diuji tanpa server.
+ */
+export function flattenAgents(payload: unknown): AgentOption[] {
+  if (!Array.isArray(payload)) return [];
+  const out: AgentOption[] = [];
+  for (const raw of payload) {
+    if (typeof raw !== "object" || raw === null) continue;
+    const a = raw as { name?: unknown; mode?: unknown; description?: unknown };
+    if (typeof a.name !== "string" || a.name === "") continue;
+    if (a.mode === "subagent") continue; // bukan mode percakapan
+    out.push({
+      name: a.name,
+      mode: a.mode === "all" ? "all" : "primary",
+      description: typeof a.description === "string" && a.description !== "" ? a.description : null,
+    });
+  }
+  return out;
+}
+
+/**
+ * Flatten respons `GET /config/providers` menjadi satu entri per model.
+ * Bentuk sumber: `{ providers: [{ id, name, models: { [modelID]: {...} } }] }`.
+ * Model berstatus `deprecated` disaring; provider tanpa model diabaikan.
+ * Diekspor agar dapat diuji tanpa server.
+ */
+export function flattenProviders(payload: unknown): ModelOption[] {
+  const providers = (payload as { providers?: unknown } | null)?.providers;
+  if (!Array.isArray(providers)) return [];
+  const out: ModelOption[] = [];
+  for (const p of providers) {
+    if (typeof p !== "object" || p === null) continue;
+    const prov = p as { id?: unknown; name?: unknown; models?: unknown };
+    if (typeof prov.id !== "string" || prov.id === "") continue;
+    const providerName = typeof prov.name === "string" && prov.name !== "" ? prov.name : prov.id;
+    const models =
+      typeof prov.models === "object" && prov.models !== null
+        ? (prov.models as Record<string, unknown>)
+        : {};
+    for (const [modelID, raw] of Object.entries(models)) {
+      const m = (typeof raw === "object" && raw !== null ? raw : {}) as {
+        name?: unknown;
+        status?: unknown;
+      };
+      if (m.status === "deprecated") continue;
+      out.push({
+        providerID: prov.id,
+        providerName,
+        modelID,
+        name: typeof m.name === "string" && m.name !== "" ? m.name : modelID,
+      });
+    }
+  }
+  return out;
+}
+
+export interface OpenCodeMessageResult {
+  info: { id: string; role: string; [k: string]: unknown };
+  parts: MessagePart[];
+}
+
+export type OpenCodePermissionReply = "once" | "always" | "reject";
+
+/** Referensi file untuk part `file` prompt: `@file` teks maupun gambar. */
+export interface OpenCodeFileRef {
+  /** Nama tampilan part (path relatif project / nama file asli upload). */
+  filename: string;
+  /** MIME part — `text/plain` untuk @file, `image/*` untuk gambar. */
+  mime: string;
+  /** URL absolut yang dibaca opencode (`file:///abs/path`). */
+  url: string;
+}
+
+/**
+ * Satu item task list (`todowrite` opencode) — `GET /session/{id}/todo`.
+ * `status`/`priority` dibiarkan string: skema opencode mendeskripsikannya
+ * sebagai string bebas (pending/in_progress/completed/cancelled), jadi nilai
+ * baru dari versi opencode berikutnya tidak membuat parsing gagal.
+ */
+export interface OpenCodeTodo {
+  content: string;
+  status: string;
+  priority: string;
+}
+
+/** Satu file yang berubah di worktree — `GET /file/status`. */
+export interface OpenCodeFileChange {
+  path: string;
+  added: number;
+  removed: number;
+  status: "added" | "deleted" | "modified";
+}
+
+/** Satu event SSE hasil normalisasi (properties digabung ke level atas). */
+export interface OpenCodeEvent {
+  type: string;
+  id?: string;
+  [k: string]: unknown;
+}
+
+export interface OpenCodeClient {
+  /**
+   * Buat Session di server headless. Tanpa `title` (disarankan) opencode
+   * meng-generate judul dari prompt pertama; dengan `title`, judul tetap.
+   */
+  createSession(opts?: { title?: string }): Promise<Result<OpenCodeSessionInfo>>;
+  /**
+   * Cek keberadaan Session di server headless (`GET /session/{id}`):
+   * `{ ok: true }` bila Session masih dikenal server, `{ ok: false }`
+   * bila tidak ada / server gagal merespons.
+   */
+  getSession(sessionId: string): Promise<SimpleResult>;
+  /** Daftar model yang tersedia pada server (`GET /config/providers`),
+   * sudah di-flatten menjadi satu entri per model.
+   */
+  listModels(): Promise<Result<ModelOption[]>>;
+  /**
+   * Daftar agent (mode) pada server (`GET /agent`) — hanya primary/all;
+   * subagent murni tidak bisa dipakai sebagai mode percakapan.
+   */
+  listAgents(): Promise<Result<AgentOption[]>>;
+  /** Status MCP server yang terkonfigurasi (`GET /mcp`). */
+  listMcp(): Promise<Result<McpServerInfo[]>>;
+  /**
+   * Skill yang terdaftar (`GET /skill`). `projectPath` untuk menandai skill
+   * yang berasal dari folder Project.
+   */
+  listSkills(projectPath?: string): Promise<Result<SkillInfo[]>>;
+  /**
+   * Buang cache instance Project di server (`POST /instance/dispose`) agar
+   * skill/config dibaca ulang dari disk — `GET /skill` di-cache per
+   * instance. Instance dibuat ulang otomatis pada request berikutnya.
+   */
+  disposeInstance(): Promise<SimpleResult>;
+  /**
+   * Hapus Session di server headless (`DELETE /session/{id}`) beserta
+   * seluruh riwayat pesannya di sisi opencode.
+   */
+  deleteSession(sessionId: string): Promise<SimpleResult>;
+  sendMessage(
+    sessionId: string,
+    text: string,
+    signal?: AbortSignal,
+  ): Promise<Result<OpenCodeMessageResult>>;
+  /**
+   * Kirim prompt tanpa menunggu balasan (`POST /session/{id}/prompt_async`,
+   * 204). `model` disertakan agar Session memakai model pilihan user, bukan
+   * model default opencode. `files` berupa referensi file (teks `@file`
+   * maupun gambar) — opencode mem-parse `url` part file dengan `URL()` dan
+   * membaca isinya sendiri, sehingga `url` harus path absolut
+   * (`file:///abs/path`).
+   */
+  promptAsync(
+    sessionId: string,
+    text: string,
+    model?: SessionModel | null,
+    files?: OpenCodeFileRef[],
+    agent?: string | null,
+    /** Instruksi tambahan (custom instruction Project) -> body `system`. */
+    system?: string | null,
+  ): Promise<Result<null>>;
+  /** Cari file project untuk autocomplete `@file` (path relatif). */
+  findFiles(query: string): Promise<Result<string[]>>;
+  /** Task list Session (`todowrite`) — kosong bila agent belum memakainya. */
+  listTodos(sessionId: string): Promise<Result<OpenCodeTodo[]>>;
+  /** File yang berubah di worktree project (git status versi opencode). */
+  fileStatus(): Promise<Result<OpenCodeFileChange[]>>;
+  replyPermission(requestId: string, reply: OpenCodePermissionReply): Promise<Result<unknown>>;
+  /**
+   * `answers` = SATU array label per pertanyaan (urut sesuai `questions`);
+   * request pertanyaan tunggal berarti array berisi satu elemen.
+   */
+  replyQuestion(requestId: string, answers: string[][]): Promise<Result<unknown>>;
+  rejectQuestion(requestId: string): Promise<Result<unknown>>;
+  abortSession(sessionId: string): Promise<Result<unknown>>;
+  /** Subscribe event SSE; mengembalikan fungsi untuk berhenti subscribe. */
+  subscribeEvents(cb: (ev: OpenCodeEvent) => void): () => void;
+  health(): Promise<boolean>;
+}
+
+function errResult(msg: string): { ok: false; error: string } {
+  return { ok: false, error: msg };
+}
+
+/**
+ * Error reply permission/question saat opencode membalas 404
+ * (`QuestionNotFoundError` / `PermissionNotFoundError`): request sudah
+ * tidak ditunggu lagi — dijawab dari klien lain, dibatalkan karena turn
+ * di-abort, atau server opencode di-restart. Pemanggil memperlakukannya
+ * sebagai prompt kedaluwarsa (bukan kegagalan yang bisa dicoba ulang).
+ */
+export const OC_REQUEST_GONE = "OC_REQUEST_GONE";
+
+async function requestJson(
+  baseUrl: string,
+  method: string,
+  path: string,
+  body?: unknown,
+  signal?: AbortSignal,
+): Promise<{ status: number; json: unknown }> {
+  const res = await fetch(`${baseUrl}${path}`, {
+    method,
+    headers: body !== undefined ? { "content-type": "application/json" } : undefined,
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+    signal,
+  });
+  let json: unknown = null;
+  try {
+    json = await res.json();
+  } catch {
+    /* body kosong / bukan JSON */
+  }
+  return { status: res.status, json };
+}
+
+export function createOpenCodeClient(baseUrl: string): OpenCodeClient {
+  async function health(): Promise<boolean> {
+    try {
+      const res = await fetch(`${baseUrl}/global/health`, { signal: AbortSignal.timeout(3000) });
+      return res.ok;
+    } catch {
+      return false;
+    }
+  }
+
+  async function getSession(sessionId: string): Promise<SimpleResult> {
+    try {
+      const { status } = await requestJson(
+        baseUrl,
+        "GET",
+        `/session/${sessionId}`,
+        undefined,
+        AbortSignal.timeout(5000),
+      );
+      return status === 200 ? { ok: true } : errResult(`OC_SESSION_NOT_FOUND(${status})`);
+    } catch (e) {
+      return errResult(`OC_GET_SESSION_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function createSession(
+    opts: { title?: string } = {},
+  ): Promise<Result<OpenCodeSessionInfo>> {
+    try {
+      // Tanpa `title`: opencode memberi placeholder `New session - <ISO>` dan
+      // HANYA untuk judul berpola itu ia meng-generate judul otomatis
+      // (agent `title`) setelah prompt pertama. Judul eksplisit mematikannya.
+      const { status, json } = await requestJson(
+        baseUrl,
+        "POST",
+        "/session",
+        opts.title === undefined ? {} : { title: opts.title },
+      );
+      if (status !== 200) return errResult(`OC_CREATE_SESSION_FAILED(${status})`);
+      const info = json as OpenCodeSessionInfo;
+      if (typeof info?.id !== "string") return errResult("OC_CREATE_SESSION_FAILED");
+      return { ok: true, data: info };
+    } catch (e) {
+      return errResult(`OC_CREATE_SESSION_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function sendMessage(
+    sessionId: string,
+    text: string,
+    signal?: AbortSignal,
+  ): Promise<Result<OpenCodeMessageResult>> {
+    try {
+      const { status, json } = await requestJson(
+        baseUrl,
+        "POST",
+        `/session/${sessionId}/message`,
+        { parts: [{ type: "text", text }] },
+        signal,
+      );
+      if (status !== 200) return errResult(`OC_SEND_MESSAGE_FAILED(${status})`);
+      const body = json as OpenCodeMessageResult | null;
+      if (!body || typeof body.info?.id !== "string" || !Array.isArray(body.parts)) {
+        return errResult("OC_SEND_MESSAGE_FAILED: balasan tidak valid");
+      }
+      return { ok: true, data: body };
+    } catch (e) {
+      const err = e as Error & { name?: string };
+      const name = err.name ?? "";
+      const msg = err.message ?? "";
+      if (name === "TimeoutError" || name === "AbortError" || /timed out|aborted/i.test(msg)) {
+        return errResult("OC_SEND_MESSAGE_TIMEOUT");
+      }
+      return errResult(`OC_SEND_MESSAGE_FAILED: ${msg}`);
+    }
+  }
+
+  async function promptAsync(
+    sessionId: string,
+    text: string,
+    model?: SessionModel | null,
+    files: OpenCodeFileRef[] = [],
+    agent?: string | null,
+    system?: string | null,
+  ): Promise<Result<null>> {
+    try {
+      // Parts prompt: teks bebas + satu part `file` per referensi (teks/gambar).
+      const parts: Record<string, unknown>[] = [{ type: "text", text }];
+      for (const f of files) {
+        parts.push({ type: "file", mime: f.mime, filename: f.filename, url: f.url });
+      }
+      const body: Record<string, unknown> = { parts };
+      // Skema prompt_async menerima `model: { providerID, modelID }` opsional;
+      // tanpa field ini opencode memakai model default-nya.
+      if (model) body.model = { providerID: model.providerID, modelID: model.modelID };
+      // `agent` opsional (mis. build/plan atau agent kustom user); tanpa
+      // field ini opencode memakai agent default-nya.
+      if (agent) body.agent = agent;
+      // `system` opsional: custom instruction Project, ditambahkan opencode
+      // ke system prompt untuk turn ini (skema sama dengan POST /message).
+      if (system) body.system = system;
+      const { status } = await requestJson(
+        baseUrl,
+        "POST",
+        `/session/${sessionId}/prompt_async`,
+        body,
+        // Hanya menunggu penerimaan prompt (204), bukan seluruh turn.
+        AbortSignal.timeout(30_000),
+      );
+      // 204 = prompt diterima; opencode juga membalas 200 pada versi tertentu.
+      return status === 204 || status === 200
+        ? { ok: true, data: null }
+        : errResult(`OC_PROMPT_ASYNC_FAILED(${status})`);
+    } catch (e) {
+      return errResult(`OC_PROMPT_ASYNC_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  /**
+   * Cari file di project (`GET /find/file?query=`) — dipakai autocomplete
+   * referensi `@file` di composer. Mengembalikan path relatif project.
+   */
+  async function findFiles(query: string): Promise<Result<string[]>> {
+    try {
+      const { status, json } = await requestJson(
+        baseUrl,
+        "GET",
+        `/find/file?query=${encodeURIComponent(query)}`,
+        undefined,
+        AbortSignal.timeout(5000),
+      );
+      if (status !== 200) return errResult(`OC_FIND_FILES_FAILED(${status})`);
+      const raw = Array.isArray(json) ? json : [];
+      const out: string[] = [];
+      for (const item of raw) {
+        if (typeof item === "string" && item.length > 0) out.push(item);
+      }
+      return { ok: true, data: out };
+    } catch (e) {
+      return errResult(`OC_FIND_FILES_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function listTodos(sessionId: string): Promise<Result<OpenCodeTodo[]>> {
+    try {
+      const { status, json } = await requestJson(
+        baseUrl,
+        "GET",
+        `/session/${sessionId}/todo`,
+        undefined,
+        AbortSignal.timeout(5000),
+      );
+      if (status !== 200) return errResult(`OC_TODO_FAILED(${status})`);
+      const out: OpenCodeTodo[] = [];
+      for (const item of Array.isArray(json) ? json : []) {
+        if (typeof item !== "object" || item === null) continue;
+        const t = item as { content?: unknown; status?: unknown; priority?: unknown };
+        if (typeof t.content !== "string" || t.content === "") continue;
+        out.push({
+          content: t.content,
+          status: typeof t.status === "string" ? t.status : "pending",
+          priority: typeof t.priority === "string" ? t.priority : "medium",
+        });
+      }
+      return { ok: true, data: out };
+    } catch (e) {
+      return errResult(`OC_TODO_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function fileStatus(): Promise<Result<OpenCodeFileChange[]>> {
+    try {
+      const { status, json } = await requestJson(
+        baseUrl,
+        "GET",
+        "/file/status",
+        undefined,
+        AbortSignal.timeout(5000),
+      );
+      if (status !== 200) return errResult(`OC_FILE_STATUS_FAILED(${status})`);
+      const out: OpenCodeFileChange[] = [];
+      for (const item of Array.isArray(json) ? json : []) {
+        if (typeof item !== "object" || item === null) continue;
+        const f = item as {
+          path?: unknown;
+          added?: unknown;
+          removed?: unknown;
+          status?: unknown;
+        };
+        if (typeof f.path !== "string" || f.path === "") continue;
+        const kind =
+          f.status === "added" || f.status === "deleted" || f.status === "modified"
+            ? f.status
+            : "modified";
+        out.push({
+          path: f.path,
+          added: typeof f.added === "number" ? f.added : 0,
+          removed: typeof f.removed === "number" ? f.removed : 0,
+          status: kind,
+        });
+      }
+      return { ok: true, data: out };
+    } catch (e) {
+      return errResult(`OC_FILE_STATUS_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function listModels(): Promise<Result<ModelOption[]>> {
+    try {
+      const { status, json } = await requestJson(baseUrl, "GET", "/config/providers");
+      if (status !== 200) return errResult(`OC_LIST_MODELS_FAILED(${status})`);
+      return { ok: true, data: flattenProviders(json) };
+    } catch (e) {
+      return errResult(`OC_LIST_MODELS_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function listAgents(): Promise<Result<AgentOption[]>> {
+    try {
+      const { status, json } = await requestJson(baseUrl, "GET", "/agent");
+      if (status !== 200) return errResult(`OC_LIST_AGENTS_FAILED(${status})`);
+      return { ok: true, data: flattenAgents(json) };
+    } catch (e) {
+      return errResult(`OC_LIST_AGENTS_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function listMcp(): Promise<Result<McpServerInfo[]>> {
+    try {
+      const { status, json } = await requestJson(
+        baseUrl,
+        "GET",
+        "/mcp",
+        undefined,
+        AbortSignal.timeout(10_000),
+      );
+      if (status !== 200) return errResult(`OC_LIST_MCP_FAILED(${status})`);
+      return { ok: true, data: flattenMcp(json) };
+    } catch (e) {
+      return errResult(`OC_LIST_MCP_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function listSkills(projectPath?: string): Promise<Result<SkillInfo[]>> {
+    try {
+      const { status, json } = await requestJson(
+        baseUrl,
+        "GET",
+        "/skill",
+        undefined,
+        AbortSignal.timeout(10_000),
+      );
+      if (status !== 200) return errResult(`OC_LIST_SKILLS_FAILED(${status})`);
+      return { ok: true, data: flattenSkills(json, projectPath) };
+    } catch (e) {
+      return errResult(`OC_LIST_SKILLS_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function disposeInstance(): Promise<SimpleResult> {
+    try {
+      const { status } = await requestJson(
+        baseUrl,
+        "POST",
+        "/instance/dispose",
+        undefined,
+        AbortSignal.timeout(10_000),
+      );
+      return status === 200 ? { ok: true } : { ok: false, error: `OC_DISPOSE_FAILED(${status})` };
+    } catch (e) {
+      return { ok: false, error: `OC_DISPOSE_FAILED: ${(e as Error).message}` };
+    }
+  }
+
+  async function deleteSession(sessionId: string): Promise<SimpleResult> {
+    try {
+      const { status } = await requestJson(
+        baseUrl,
+        "DELETE",
+        `/session/${sessionId}`,
+        undefined,
+        AbortSignal.timeout(10_000),
+      );
+      // 200 = terhapus. 404 dianggap sukses: target sudah tidak ada (idemoten
+      // terhadap storage opencode yang mungkin sudah dibersihkan manual).
+      return status === 200 || status === 404
+        ? { ok: true }
+        : errResult(`OC_DELETE_SESSION_FAILED(${status})`);
+    } catch (e) {
+      return errResult(`OC_DELETE_SESSION_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function replyPermission(
+    requestId: string,
+    reply: OpenCodePermissionReply,
+  ): Promise<Result<unknown>> {
+    try {
+      const { status } = await requestJson(baseUrl, "POST", `/permission/${requestId}/reply`, {
+        reply,
+      });
+      if (status === 200) return { ok: true, data: null };
+      return errResult(status === 404 ? OC_REQUEST_GONE : `OC_PERMISSION_REPLY_FAILED(${status})`);
+    } catch (e) {
+      return errResult(`OC_PERMISSION_REPLY_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function replyQuestion(requestId: string, answers: string[][]): Promise<Result<unknown>> {
+    try {
+      // Skema Question.Reply: `{ answers: Answer[] }` — SATU entri per
+      // pertanyaan, masing-masing berupa array label terpilih. Pemanggil
+      // sudah mengirim satu array per pertanyaan, jadi body diteruskan
+      // apa adanya.
+      const { status } = await requestJson(baseUrl, "POST", `/question/${requestId}/reply`, {
+        answers,
+      });
+      if (status === 200) return { ok: true, data: null };
+      return errResult(status === 404 ? OC_REQUEST_GONE : `OC_QUESTION_REPLY_FAILED(${status})`);
+    } catch (e) {
+      return errResult(`OC_QUESTION_REPLY_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function rejectQuestion(requestId: string): Promise<Result<unknown>> {
+    try {
+      const { status } = await requestJson(baseUrl, "POST", `/question/${requestId}/reject`, {});
+      if (status === 200) return { ok: true, data: null };
+      return errResult(status === 404 ? OC_REQUEST_GONE : `OC_QUESTION_REJECT_FAILED(${status})`);
+    } catch (e) {
+      return errResult(`OC_QUESTION_REJECT_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  async function abortSession(sessionId: string): Promise<Result<unknown>> {
+    try {
+      const { status } = await requestJson(baseUrl, "POST", `/session/${sessionId}/abort`, {});
+      return status === 200 ? { ok: true, data: null } : errResult(`OC_ABORT_FAILED(${status})`);
+    } catch (e) {
+      return errResult(`OC_ABORT_FAILED: ${(e as Error).message}`);
+    }
+  }
+
+  function subscribeEvents(cb: (ev: OpenCodeEvent) => void): () => void {
+    return subscribeOpenCodeEvents(baseUrl, cb);
+  }
+
+  return {
+    createSession,
+    getSession,
+    listModels,
+    listAgents,
+    deleteSession,
+    sendMessage,
+    promptAsync,
+    listMcp,
+    listSkills,
+    disposeInstance,
+    findFiles,
+    listTodos,
+    fileStatus,
+    replyPermission,
+    replyQuestion,
+    rejectQuestion,
+    abortSession,
+    subscribeEvents,
+    health,
+  };
+}