@pixelbyte-software/pixcode 1.51.1 → 1.51.3

package/server/modules/providers/list/opencode/opencode-sessions.provider.ts

@@ -1,286 +1,286 @@
-import sessionManager from '@/sessionManager.js';
-import type { IProviderSessions } from '@/shared/interfaces.js';
-import type { AnyRecord, FetchHistoryOptions, FetchHistoryResult, NormalizedMessage } from '@/shared/types.js';
-import { createNormalizedMessage, generateMessageId, readObjectRecord } from '@/shared/utils.js';
-
-const PROVIDER = 'opencode';
-
-/**
- * OpenCode sessions provider.
- *
- * OpenCode persists session transcripts under
- * `~/.local/share/opencode/project/<project-slug>/sessions/` (XDG data dir).
- * The on-disk format is JSON per session — different from Gemini/Qwen's
- * single-file-per-conversation layout. For the initial integration we
- * read transcripts only from the in-memory sessionManager (freshly
- * captured streams); restoring historical sessions from disk will land
- * in a follow-up once the exact schema is pinned.
- *
- * Stream shape from `opencode run --format json` (verified against
- * opencode-ai 0.x at the wire):
- *   { type:"step_start",  timestamp, sessionID, part:{ type:"step-start",  ... } }
- *   { type:"text",        timestamp, sessionID, part:{ type:"text", text:"…", time:{…}, metadata:{…} } }
- *   { type:"tool_use",    timestamp, sessionID, part:{ type:"tool-use",  callID, tool, state:{ input } } }
- *   { type:"tool_result", timestamp, sessionID, part:{ type:"tool-result", callID, state:{ output, status } } }
- *   { type:"step_finish", timestamp, sessionID, part:{ type:"step-finish", reason, tokens, cost } }
- *   { type:"error",       timestamp, sessionID, error:{ name, data:{ message, statusCode? } } }
- * Field names are camelCase (`sessionID`, `callID`) — NOT snake_case.
- */
-export class OpencodeSessionsProvider implements IProviderSessions {
-  normalizeMessage(rawMessage: unknown, sessionId: string | null): NormalizedMessage[] {
-    const raw = readObjectRecord(rawMessage);
-    if (!raw) return [];
-
-    const ts = raw.timestamp || new Date().toISOString();
-    const baseId = raw.uuid || raw.id || generateMessageId('opencode');
-    const part = readObjectRecord(raw.part) || {};
-
-    // Modern shape: { type:"text", part:{ type:"text", text:"…" } }.
-    // The full text arrives in a single event (not token-by-token), but it
-    // can also legitimately be empty during a step_start preamble — we only
-    // emit when there's actual text. `stream_end` is emitted on step_finish
-    // (which is guaranteed at the end of every assistant turn), so we don't
-    // close the stream here.
-    if (raw.type === 'text') {
-      const text = typeof part.text === 'string' ? part.text : '';
-      if (!text) return [];
-      return [createNormalizedMessage({
-        id: baseId,
-        sessionId,
-        timestamp: ts,
-        provider: PROVIDER,
-        kind: 'stream_delta',
-        content: text,
-      })];
-    }
-
-    // Legacy fallback for older builds that still emit `{ type:"message", role:"assistant", content }`.
-    if (raw.type === 'message' && raw.role === 'assistant') {
-      const content = typeof raw.content === 'string' ? raw.content : '';
-      if (!content) return [];
-      const messages: NormalizedMessage[] = [createNormalizedMessage({
-        id: baseId,
-        sessionId,
-        timestamp: ts,
-        provider: PROVIDER,
-        kind: 'stream_delta',
-        content,
-      })];
-      if (raw.delta !== true) {
-        messages.push(createNormalizedMessage({
-          sessionId,
-          timestamp: ts,
-          provider: PROVIDER,
-          kind: 'stream_end',
-        }));
-      }
-      return messages;
-    }
-
-    if (raw.type === 'tool_use' || raw.type === 'tool-use') {
-      const state = readObjectRecord(part.state) || {};
-      return [createNormalizedMessage({
-        id: baseId,
-        sessionId,
-        timestamp: ts,
-        provider: PROVIDER,
-        kind: 'tool_use',
-        toolName: String(part.tool || raw.tool_name || raw.name || ''),
-        toolInput: state.input || part.input || raw.parameters || raw.input || {},
-        toolId: String(part.callID || part.id || raw.tool_id || raw.id || baseId),
-      })];
-    }
-
-    if (raw.type === 'tool_result' || raw.type === 'tool-result') {
-      const state = readObjectRecord(part.state) || {};
-      const status = (state.status || raw.status) as string | undefined;
-      const output = state.output ?? part.output ?? raw.output;
-      return [createNormalizedMessage({
-        id: baseId,
-        sessionId,
-        timestamp: ts,
-        provider: PROVIDER,
-        kind: 'tool_result',
-        toolId: String(part.callID || part.id || raw.tool_id || raw.toolCallId || ''),
-        content: output === undefined || output === null ? '' : String(output),
-        isError: status === 'error' || Boolean(raw.isError),
-      })];
-    }
-
-    // OpenCode signals end-of-turn with `step_finish` (run mode never emits
-    // a top-level `result`). Emit stream_end so the UI clears its
-    // "Processing…" state.
-    if (raw.type === 'step_finish' || raw.type === 'result') {
-      return [createNormalizedMessage({
-        sessionId,
-        timestamp: ts,
-        provider: PROVIDER,
-        kind: 'stream_end',
-      })];
-    }
-
-    // step_start carries the session ID but no user-visible content — we
-    // capture the session ID elsewhere (response handler) and drop the event.
-    if (raw.type === 'step_start') {
-      return [];
-    }
-
-    if (raw.type === 'error') {
-      // OpenCode `--format json` emits errors as
-      //   { type:"error", error:{ name, data:{ message, statusCode?, isRetryable? } } }
-      // — `error` is always an object wrapper, never a plain string. Older
-      // builds put the message at `error.message`; current builds nest it
-      // under `error.data.message`. Map known error class names to friendly
-      // copy so the user gets actionable text instead of a class identifier.
-      const rawErr = raw.error ?? raw.message;
-      const errObj = rawErr && typeof rawErr === 'object' ? rawErr as Record<string, unknown> : null;
-      const data = errObj && typeof errObj.data === 'object' && errObj.data
-        ? errObj.data as Record<string, unknown>
-        : null;
-      const dataMessage = data && typeof data.message === 'string' ? data.message : null;
-      const errMessage = errObj && typeof errObj.message === 'string' ? errObj.message : null;
-      const errName = errObj && typeof errObj.name === 'string' ? errObj.name : null;
-      const statusCode = data && typeof data.statusCode === 'number' ? data.statusCode : null;
-
-      let content: string;
-      if (typeof rawErr === 'string') {
-        content = rawErr;
-      } else if (dataMessage) {
-        content = dataMessage;
-      } else if (errMessage) {
-        content = errMessage;
-      } else if (errName) {
-        const friendly: Record<string, string> = {
-          ProviderModelNotFoundError: 'Model not found. Open Settings → Agents → OpenCode and pick a model from the live catalog (or run `opencode models --refresh`).',
-          ProviderInitError: 'OpenCode provider config is invalid. Try `opencode auth login` or remove `~/.local/share/opencode/auth.json` and re-authenticate.',
-          MessageOutputLengthError: 'OpenCode response was truncated by the model output cap. Try shortening the prompt or pick a model with a larger output limit.',
-          AI_APICallError: 'OpenCode upstream API call failed. Clearing `~/.cache/opencode` and retrying usually fixes this.',
-          APIError: statusCode === 429
-            ? 'OpenCode hit a rate limit (429). Wait a few seconds and try again, or switch to a different model.'
-            : 'OpenCode upstream API error.',
-        };
-        content = friendly[errName] ?? errName;
-      } else {
-        try { content = JSON.stringify(rawErr); }
-        catch { content = 'Unknown OpenCode streaming error'; }
-      }
-      return [createNormalizedMessage({
-        id: baseId,
-        sessionId,
-        timestamp: ts,
-        provider: PROVIDER,
-        kind: 'error',
-        content,
-      })];
-    }
-
-    return [];
-  }
-
-  async fetchHistory(
-    sessionId: string,
-    options: FetchHistoryOptions = {},
-  ): Promise<FetchHistoryResult> {
-    const { limit = null, offset = 0 } = options;
-
-    let rawMessages: AnyRecord[] = [];
-    try {
-      rawMessages = sessionManager.getSessionMessages(sessionId) as AnyRecord[];
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      console.warn(`[OpencodeProvider] Failed to load session ${sessionId}:`, message);
-      return { messages: [], total: 0, hasMore: false, offset: 0, limit: null };
-    }
-
-    const normalized: NormalizedMessage[] = [];
-    for (let i = 0; i < rawMessages.length; i++) {
-      const raw = rawMessages[i];
-      const ts = raw.timestamp || new Date().toISOString();
-      const baseId = raw.uuid || raw.id || `${PROVIDER}_${sessionId}_${i}`;
-      const role = raw.message?.role || raw.role;
-      const content = raw.message?.content || raw.content;
-
-      if (!role || !content) continue;
-      const normalizedRole = role === 'user' ? 'user' : 'assistant';
-
-      if (Array.isArray(content)) {
-        for (let partIdx = 0; partIdx < content.length; partIdx++) {
-          const part = readObjectRecord(content[partIdx]);
-          if (!part) continue;
-          if (part.type === 'text' && typeof part.text === 'string' && part.text.trim()) {
-            normalized.push(createNormalizedMessage({
-              id: `${baseId}_${partIdx}`,
-              sessionId,
-              timestamp: ts,
-              provider: PROVIDER,
-              kind: 'text',
-              role: normalizedRole,
-              content: part.text,
-            }));
-          } else if (part.type === 'tool_use') {
-            normalized.push(createNormalizedMessage({
-              id: `${baseId}_${partIdx}`,
-              sessionId,
-              timestamp: ts,
-              provider: PROVIDER,
-              kind: 'tool_use',
-              toolName: String(part.name || ''),
-              toolInput: part.input || {},
-              toolId: String(part.id || `${baseId}_${partIdx}`),
-            }));
-          } else if (part.type === 'tool_result') {
-            normalized.push(createNormalizedMessage({
-              id: `${baseId}_${partIdx}`,
-              sessionId,
-              timestamp: ts,
-              provider: PROVIDER,
-              kind: 'tool_result',
-              toolId: String(part.tool_use_id || ''),
-              content: part.content === undefined || part.content === null ? '' : String(part.content),
-              isError: Boolean(part.is_error),
-            }));
-          }
-        }
-      } else if (typeof content === 'string' && content.trim()) {
-        normalized.push(createNormalizedMessage({
-          id: baseId,
-          sessionId,
-          timestamp: ts,
-          provider: PROVIDER,
-          kind: 'text',
-          role: normalizedRole,
-          content,
-        }));
-      }
-    }
-
-    const toolResultMap = new Map<string, NormalizedMessage>();
-    for (const msg of normalized) {
-      if (msg.kind === 'tool_result' && msg.toolId) {
-        toolResultMap.set(msg.toolId, msg);
-      }
-    }
-    for (const msg of normalized) {
-      if (msg.kind === 'tool_use' && msg.toolId && toolResultMap.has(msg.toolId)) {
-        const toolResult = toolResultMap.get(msg.toolId);
-        if (toolResult) {
-          msg.toolResult = { content: toolResult.content, isError: toolResult.isError };
-        }
-      }
-    }
-
-    const start = Math.max(0, offset);
-    const pageLimit = limit === null ? null : Math.max(0, limit);
-    const messages = pageLimit === null
-      ? normalized.slice(start)
-      : normalized.slice(start, start + pageLimit);
-
-    return {
-      messages,
-      total: normalized.length,
-      hasMore: pageLimit === null ? false : start + pageLimit < normalized.length,
-      offset: start,
-      limit: pageLimit,
-    };
-  }
-}
+import sessionManager from '@/sessionManager.js';
+import type { IProviderSessions } from '@/shared/interfaces.js';
+import type { AnyRecord, FetchHistoryOptions, FetchHistoryResult, NormalizedMessage } from '@/shared/types.js';
+import { createNormalizedMessage, generateMessageId, readObjectRecord } from '@/shared/utils.js';
+
+const PROVIDER = 'opencode';
+
+/**
+ * OpenCode sessions provider.
+ *
+ * OpenCode persists session transcripts under
+ * `~/.local/share/opencode/project/<project-slug>/sessions/` (XDG data dir).
+ * The on-disk format is JSON per session — different from Gemini/Qwen's
+ * single-file-per-conversation layout. For the initial integration we
+ * read transcripts only from the in-memory sessionManager (freshly
+ * captured streams); restoring historical sessions from disk will land
+ * in a follow-up once the exact schema is pinned.
+ *
+ * Stream shape from `opencode run --format json` (verified against
+ * opencode-ai 0.x at the wire):
+ *   { type:"step_start",  timestamp, sessionID, part:{ type:"step-start",  ... } }
+ *   { type:"text",        timestamp, sessionID, part:{ type:"text", text:"…", time:{…}, metadata:{…} } }
+ *   { type:"tool_use",    timestamp, sessionID, part:{ type:"tool-use",  callID, tool, state:{ input } } }
+ *   { type:"tool_result", timestamp, sessionID, part:{ type:"tool-result", callID, state:{ output, status } } }
+ *   { type:"step_finish", timestamp, sessionID, part:{ type:"step-finish", reason, tokens, cost } }
+ *   { type:"error",       timestamp, sessionID, error:{ name, data:{ message, statusCode? } } }
+ * Field names are camelCase (`sessionID`, `callID`) — NOT snake_case.
+ */
+export class OpencodeSessionsProvider implements IProviderSessions {
+  normalizeMessage(rawMessage: unknown, sessionId: string | null): NormalizedMessage[] {
+    const raw = readObjectRecord(rawMessage);
+    if (!raw) return [];
+
+    const ts = raw.timestamp || new Date().toISOString();
+    const baseId = raw.uuid || raw.id || generateMessageId('opencode');
+    const part = readObjectRecord(raw.part) || {};
+
+    // Modern shape: { type:"text", part:{ type:"text", text:"…" } }.
+    // The full text arrives in a single event (not token-by-token), but it
+    // can also legitimately be empty during a step_start preamble — we only
+    // emit when there's actual text. `stream_end` is emitted on step_finish
+    // (which is guaranteed at the end of every assistant turn), so we don't
+    // close the stream here.
+    if (raw.type === 'text') {
+      const text = typeof part.text === 'string' ? part.text : '';
+      if (!text) return [];
+      return [createNormalizedMessage({
+        id: baseId,
+        sessionId,
+        timestamp: ts,
+        provider: PROVIDER,
+        kind: 'stream_delta',
+        content: text,
+      })];
+    }
+
+    // Legacy fallback for older builds that still emit `{ type:"message", role:"assistant", content }`.
+    if (raw.type === 'message' && raw.role === 'assistant') {
+      const content = typeof raw.content === 'string' ? raw.content : '';
+      if (!content) return [];
+      const messages: NormalizedMessage[] = [createNormalizedMessage({
+        id: baseId,
+        sessionId,
+        timestamp: ts,
+        provider: PROVIDER,
+        kind: 'stream_delta',
+        content,
+      })];
+      if (raw.delta !== true) {
+        messages.push(createNormalizedMessage({
+          sessionId,
+          timestamp: ts,
+          provider: PROVIDER,
+          kind: 'stream_end',
+        }));
+      }
+      return messages;
+    }
+
+    if (raw.type === 'tool_use' || raw.type === 'tool-use') {
+      const state = readObjectRecord(part.state) || {};
+      return [createNormalizedMessage({
+        id: baseId,
+        sessionId,
+        timestamp: ts,
+        provider: PROVIDER,
+        kind: 'tool_use',
+        toolName: String(part.tool || raw.tool_name || raw.name || ''),
+        toolInput: state.input || part.input || raw.parameters || raw.input || {},
+        toolId: String(part.callID || part.id || raw.tool_id || raw.id || baseId),
+      })];
+    }
+
+    if (raw.type === 'tool_result' || raw.type === 'tool-result') {
+      const state = readObjectRecord(part.state) || {};
+      const status = (state.status || raw.status) as string | undefined;
+      const output = state.output ?? part.output ?? raw.output;
+      return [createNormalizedMessage({
+        id: baseId,
+        sessionId,
+        timestamp: ts,
+        provider: PROVIDER,
+        kind: 'tool_result',
+        toolId: String(part.callID || part.id || raw.tool_id || raw.toolCallId || ''),
+        content: output === undefined || output === null ? '' : String(output),
+        isError: status === 'error' || Boolean(raw.isError),
+      })];
+    }
+
+    // OpenCode signals end-of-turn with `step_finish` (run mode never emits
+    // a top-level `result`). Emit stream_end so the UI clears its
+    // "Processing…" state.
+    if (raw.type === 'step_finish' || raw.type === 'result') {
+      return [createNormalizedMessage({
+        sessionId,
+        timestamp: ts,
+        provider: PROVIDER,
+        kind: 'stream_end',
+      })];
+    }
+
+    // step_start carries the session ID but no user-visible content — we
+    // capture the session ID elsewhere (response handler) and drop the event.
+    if (raw.type === 'step_start') {
+      return [];
+    }
+
+    if (raw.type === 'error') {
+      // OpenCode `--format json` emits errors as
+      //   { type:"error", error:{ name, data:{ message, statusCode?, isRetryable? } } }
+      // — `error` is always an object wrapper, never a plain string. Older
+      // builds put the message at `error.message`; current builds nest it
+      // under `error.data.message`. Map known error class names to friendly
+      // copy so the user gets actionable text instead of a class identifier.
+      const rawErr = raw.error ?? raw.message;
+      const errObj = rawErr && typeof rawErr === 'object' ? rawErr as Record<string, unknown> : null;
+      const data = errObj && typeof errObj.data === 'object' && errObj.data
+        ? errObj.data as Record<string, unknown>
+        : null;
+      const dataMessage = data && typeof data.message === 'string' ? data.message : null;
+      const errMessage = errObj && typeof errObj.message === 'string' ? errObj.message : null;
+      const errName = errObj && typeof errObj.name === 'string' ? errObj.name : null;
+      const statusCode = data && typeof data.statusCode === 'number' ? data.statusCode : null;
+
+      let content: string;
+      if (typeof rawErr === 'string') {
+        content = rawErr;
+      } else if (dataMessage) {
+        content = dataMessage;
+      } else if (errMessage) {
+        content = errMessage;
+      } else if (errName) {
+        const friendly: Record<string, string> = {
+          ProviderModelNotFoundError: 'Model not found. Open Settings → Agents → OpenCode and pick a model from the live catalog (or run `opencode models --refresh`).',
+          ProviderInitError: 'OpenCode provider config is invalid. Try `opencode auth login` or remove `~/.local/share/opencode/auth.json` and re-authenticate.',
+          MessageOutputLengthError: 'OpenCode response was truncated by the model output cap. Try shortening the prompt or pick a model with a larger output limit.',
+          AI_APICallError: 'OpenCode upstream API call failed. Clearing `~/.cache/opencode` and retrying usually fixes this.',
+          APIError: statusCode === 429
+            ? 'OpenCode hit a rate limit (429). Wait a few seconds and try again, or switch to a different model.'
+            : 'OpenCode upstream API error.',
+        };
+        content = friendly[errName] ?? errName;
+      } else {
+        try { content = JSON.stringify(rawErr); }
+        catch { content = 'Unknown OpenCode streaming error'; }
+      }
+      return [createNormalizedMessage({
+        id: baseId,
+        sessionId,
+        timestamp: ts,
+        provider: PROVIDER,
+        kind: 'error',
+        content,
+      })];
+    }
+
+    return [];
+  }
+
+  async fetchHistory(
+    sessionId: string,
+    options: FetchHistoryOptions = {},
+  ): Promise<FetchHistoryResult> {
+    const { limit = null, offset = 0 } = options;
+
+    let rawMessages: AnyRecord[] = [];
+    try {
+      rawMessages = sessionManager.getSessionMessages(sessionId) as AnyRecord[];
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.warn(`[OpencodeProvider] Failed to load session ${sessionId}:`, message);
+      return { messages: [], total: 0, hasMore: false, offset: 0, limit: null };
+    }
+
+    const normalized: NormalizedMessage[] = [];
+    for (let i = 0; i < rawMessages.length; i++) {
+      const raw = rawMessages[i];
+      const ts = raw.timestamp || new Date().toISOString();
+      const baseId = raw.uuid || raw.id || `${PROVIDER}_${sessionId}_${i}`;
+      const role = raw.message?.role || raw.role;
+      const content = raw.message?.content || raw.content;
+
+      if (!role || !content) continue;
+      const normalizedRole = role === 'user' ? 'user' : 'assistant';
+
+      if (Array.isArray(content)) {
+        for (let partIdx = 0; partIdx < content.length; partIdx++) {
+          const part = readObjectRecord(content[partIdx]);
+          if (!part) continue;
+          if (part.type === 'text' && typeof part.text === 'string' && part.text.trim()) {
+            normalized.push(createNormalizedMessage({
+              id: `${baseId}_${partIdx}`,
+              sessionId,
+              timestamp: ts,
+              provider: PROVIDER,
+              kind: 'text',
+              role: normalizedRole,
+              content: part.text,
+            }));
+          } else if (part.type === 'tool_use') {
+            normalized.push(createNormalizedMessage({
+              id: `${baseId}_${partIdx}`,
+              sessionId,
+              timestamp: ts,
+              provider: PROVIDER,
+              kind: 'tool_use',
+              toolName: String(part.name || ''),
+              toolInput: part.input || {},
+              toolId: String(part.id || `${baseId}_${partIdx}`),
+            }));
+          } else if (part.type === 'tool_result') {
+            normalized.push(createNormalizedMessage({
+              id: `${baseId}_${partIdx}`,
+              sessionId,
+              timestamp: ts,
+              provider: PROVIDER,
+              kind: 'tool_result',
+              toolId: String(part.tool_use_id || ''),
+              content: part.content === undefined || part.content === null ? '' : String(part.content),
+              isError: Boolean(part.is_error),
+            }));
+          }
+        }
+      } else if (typeof content === 'string' && content.trim()) {
+        normalized.push(createNormalizedMessage({
+          id: baseId,
+          sessionId,
+          timestamp: ts,
+          provider: PROVIDER,
+          kind: 'text',
+          role: normalizedRole,
+          content,
+        }));
+      }
+    }
+
+    const toolResultMap = new Map<string, NormalizedMessage>();
+    for (const msg of normalized) {
+      if (msg.kind === 'tool_result' && msg.toolId) {
+        toolResultMap.set(msg.toolId, msg);
+      }
+    }
+    for (const msg of normalized) {
+      if (msg.kind === 'tool_use' && msg.toolId && toolResultMap.has(msg.toolId)) {
+        const toolResult = toolResultMap.get(msg.toolId);
+        if (toolResult) {
+          msg.toolResult = { content: toolResult.content, isError: toolResult.isError };
+        }
+      }
+    }
+
+    const start = Math.max(0, offset);
+    const pageLimit = limit === null ? null : Math.max(0, limit);
+    const messages = pageLimit === null
+      ? normalized.slice(start)
+      : normalized.slice(start, start + pageLimit);
+
+    return {
+      messages,
+      total: normalized.length,
+      hasMore: pageLimit === null ? false : start + pageLimit < normalized.length,
+      offset: start,
+      limit: pageLimit,
+    };
+  }
+}

package/server/modules/providers/list/opencode/opencode.provider.ts

@@ -1,29 +1,29 @@
-import { AbstractProvider } from '@/modules/providers/shared/base/abstract.provider.js';
-import { OpencodeProviderAuth } from '@/modules/providers/list/opencode/opencode-auth.provider.js';
-import { OpencodeMcpProvider } from '@/modules/providers/list/opencode/opencode-mcp.provider.js';
-import { OpencodeSessionsProvider } from '@/modules/providers/list/opencode/opencode-sessions.provider.js';
-import type { IProviderAuth, IProviderSessions } from '@/shared/interfaces.js';
-
-/**
- * OpenCode provider.
- *
- * OpenCode (npm package: `opencode-ai`, binary: `opencode`) is a
- * multi-provider terminal coding agent. Unlike Claude/Codex/Gemini/Qwen
- * it uses XDG paths:
- *   - config: `~/.config/opencode/opencode.json`
- *   - data:   `~/.local/share/opencode/` (auth.json, sessions, logs)
- *
- * Its permission system is granular (per-tool + per-pattern) rather than
- * the 2/3-mode toggle other CLIs expose. We surface that through the
- * Configuration tab and the opencode.json editor — the Permissions tab
- * exposes high-level presets only.
- */
-export class OpencodeProvider extends AbstractProvider {
-  readonly mcp = new OpencodeMcpProvider();
-  readonly auth: IProviderAuth = new OpencodeProviderAuth();
-  readonly sessions: IProviderSessions = new OpencodeSessionsProvider();
-
-  constructor() {
-    super('opencode');
-  }
-}
+import { AbstractProvider } from '@/modules/providers/shared/base/abstract.provider.js';
+import { OpencodeProviderAuth } from '@/modules/providers/list/opencode/opencode-auth.provider.js';
+import { OpencodeMcpProvider } from '@/modules/providers/list/opencode/opencode-mcp.provider.js';
+import { OpencodeSessionsProvider } from '@/modules/providers/list/opencode/opencode-sessions.provider.js';
+import type { IProviderAuth, IProviderSessions } from '@/shared/interfaces.js';
+
+/**
+ * OpenCode provider.
+ *
+ * OpenCode (npm package: `opencode-ai`, binary: `opencode`) is a
+ * multi-provider terminal coding agent. Unlike Claude/Codex/Gemini/Qwen
+ * it uses XDG paths:
+ *   - config: `~/.config/opencode/opencode.json`
+ *   - data:   `~/.local/share/opencode/` (auth.json, sessions, logs)
+ *
+ * Its permission system is granular (per-tool + per-pattern) rather than
+ * the 2/3-mode toggle other CLIs expose. We surface that through the
+ * Configuration tab and the opencode.json editor — the Permissions tab
+ * exposes high-level presets only.
+ */
+export class OpencodeProvider extends AbstractProvider {
+  readonly mcp = new OpencodeMcpProvider();
+  readonly auth: IProviderAuth = new OpencodeProviderAuth();
+  readonly sessions: IProviderSessions = new OpencodeSessionsProvider();
+
+  constructor() {
+    super('opencode');
+  }
+}