@aipanel/provider-opencode 1.2.0-beta.0

package/lib/bridge-script.d.ts

@@ -0,0 +1,14 @@
+import type { OpenCodeLanguage, OpenCodeSettings } from "./types";
+export interface BridgeScriptOptions {
+    /** 主题模式 */
+    theme?: "light" | "dark" | "auto";
+    /** 界面语言 */
+    language?: OpenCodeLanguage;
+    /** 内部设置 */
+    settings?: OpenCodeSettings;
+}
+/**
+ * 生成 PostMessage Bridge 脚本
+ * 只处理 DOM 操作和主题同步，SSE 监听已迁移到 client 层
+ */
+export declare function generateBridgeScript(options?: BridgeScriptOptions): string;

package/lib/constants.cjs

@@ -0,0 +1,55 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var constants_exports = {};
+__export(constants_exports, {
+  DEFAULT_OPENCODE_PROVIDER_OPTIONS: () => DEFAULT_OPENCODE_PROVIDER_OPTIONS,
+  DEFAULT_OPENCODE_SETTINGS: () => DEFAULT_OPENCODE_SETTINGS,
+  OPENCODE_CACHE_DIR: () => OPENCODE_CACHE_DIR,
+  OPENCODE_STORAGE_KEYS: () => OPENCODE_STORAGE_KEYS
+});
+module.exports = __toCommonJS(constants_exports);
+const OPENCODE_STORAGE_KEYS = {
+  /** 设置键 (settings.v3) */
+  SETTINGS: "settings.v3",
+  /** 配色方案键 */
+  COLOR_SCHEME: "opencode-color-scheme",
+  /** 主题 ID 键 */
+  THEME_ID: "opencode-theme-id"
+};
+const DEFAULT_OPENCODE_SETTINGS = {
+  general: {
+    showReasoningSummaries: true,
+    newLayoutDesigns: true,
+    showFileTree: false,
+    editToolPartsExpanded: true,
+    shellToolPartsExpanded: true
+  }
+};
+const OPENCODE_CACHE_DIR = "node_modules/.cache/opencode";
+const DEFAULT_OPENCODE_PROVIDER_OPTIONS = {
+  enableLsp: true,
+  enableBlockOnError: false,
+  enablePrettier: true
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_OPENCODE_PROVIDER_OPTIONS,
+  DEFAULT_OPENCODE_SETTINGS,
+  OPENCODE_CACHE_DIR,
+  OPENCODE_STORAGE_KEYS
+});

package/lib/constants.d.ts

@@ -0,0 +1,32 @@
+/**
+ * OpenCode Provider 专属常量与默认值
+ * 与 OpenCode Web 绑定的常量自包含于此，核心层不感知。
+ */
+import type { OpenCodeProviderOptions } from "./types";
+/** ==================== OpenCode localStorage 键 ==================== */
+/** OpenCode localStorage 配置键 */
+export declare const OPENCODE_STORAGE_KEYS: {
+    /** 设置键 (settings.v3) */
+    readonly SETTINGS: "settings.v3";
+    /** 配色方案键 */
+    readonly COLOR_SCHEME: "opencode-color-scheme";
+    /** 主题 ID 键 */
+    readonly THEME_ID: "opencode-theme-id";
+};
+/** ==================== OpenCode 默认设置 ==================== */
+/** OpenCode 默认设置（与 OpenCode Web localStorage settings.v3 对应） */
+export declare const DEFAULT_OPENCODE_SETTINGS: {
+    general: {
+        showReasoningSummaries: boolean;
+        newLayoutDesigns: boolean;
+        showFileTree: boolean;
+        editToolPartsExpanded: boolean;
+        shellToolPartsExpanded: boolean;
+    };
+};
+/** ==================== 运行环境 ==================== */
+/** OpenCode 缓存目录（相对于项目根目录，存放 opencode.json 等运行状态） */
+export declare const OPENCODE_CACHE_DIR = "node_modules/.cache/opencode";
+/** ==================== Provider 专属配置默认值 ==================== */
+/** OpenCode Provider 专属配置默认值（插件组装 config 时使用） */
+export declare const DEFAULT_OPENCODE_PROVIDER_OPTIONS: OpenCodeProviderOptions;

package/lib/index.cjs

@@ -0,0 +1,55 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var lib_exports = {};
+__export(lib_exports, {
+  DEFAULT_OPENCODE_PROVIDER_OPTIONS: () => import_constants.DEFAULT_OPENCODE_PROVIDER_OPTIONS,
+  OpenCodeAPI: () => import_api.OpenCodeAPI,
+  checkOpenCodeInstalled: () => import_system.checkOpenCodeInstalled,
+  createProvider: () => createProvider,
+  generateBridgeScript: () => import_bridge_script.generateBridgeScript,
+  getOpenCodeVersion: () => import_system.getOpenCodeVersion,
+  killOrphanOpenCodeProcesses: () => import_system.killOrphanOpenCodeProcesses,
+  prepareOpenCodeRuntime: () => import_opencode_web.prepareOpenCodeRuntime,
+  startOpenCodeWeb: () => import_opencode_web.startOpenCodeWeb
+});
+module.exports = __toCommonJS(lib_exports);
+var import_provider = require("./provider.cjs");
+var import_api = require("./api.cjs");
+var import_opencode_web = require("./opencode-web.cjs");
+var import_bridge_script = require("./bridge-script.cjs");
+var import_system = require("./system.cjs");
+var import_constants = require("./constants.cjs");
+function createProvider(ctx) {
+  return new import_provider.DefaultWebProvider(
+    { hostname: ctx.hostname, chromeDevtoolsPort: ctx.chromeDevtoolsPort },
+    { getWebPort: ctx.getWebPort, getProxyPort: ctx.getProxyPort },
+    ctx.options
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_OPENCODE_PROVIDER_OPTIONS,
+  OpenCodeAPI,
+  checkOpenCodeInstalled,
+  createProvider,
+  generateBridgeScript,
+  getOpenCodeVersion,
+  killOrphanOpenCodeProcesses,
+  prepareOpenCodeRuntime,
+  startOpenCodeWeb
+});

package/lib/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * OpenCode Web Provider
+ * 实现 WebProvider 契约：进程管理、REST 会话 API、桥接脚本、CLI 环境检查。
+ * 所有 OpenCode 专属类型与常量自包含于此包。
+ */
+import type { ProviderInitContext, WebProvider } from "@aipanel/core";
+/** 约定工厂：核心层动态加载本包后调用，初始化动作完全由 Provider 定义 */
+export declare function createProvider(ctx: ProviderInitContext): WebProvider;
+export { OpenCodeAPI } from "./api";
+export type { DefaultWebProviderConfig, DefaultWebProviderDeps } from "./provider";
+export { prepareOpenCodeRuntime, startOpenCodeWeb } from "./opencode-web";
+export { generateBridgeScript, type BridgeScriptOptions } from "./bridge-script";
+export { checkOpenCodeInstalled, getOpenCodeVersion, killOrphanOpenCodeProcesses } from "./system";
+export { DEFAULT_OPENCODE_PROVIDER_OPTIONS } from "./constants";
+export type { OpenCodeProviderOptions, OpenCodeLanguage, OpenCodeSettings, SessionInfo, WebOptions, } from "./types";

package/lib/opencode-web.cjs

@@ -0,0 +1,302 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var opencode_web_exports = {};
+__export(opencode_web_exports, {
+  prepareOpenCodeRuntime: () => prepareOpenCodeRuntime,
+  startOpenCodeWeb: () => startOpenCodeWeb
+});
+module.exports = __toCommonJS(opencode_web_exports);
+var import_execa = require("execa");
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_url = require("url");
+var import_constants = require("./constants.cjs");
+var import_node = require("@aipanel/core/node");
+const require2 = (0, import_node.createPackageRequire)();
+const packageDir = (0, import_node.resolvePackageDir)("@aipanel/opencode-plugins");
+const log = (0, import_node.createLogger)("OpenCodeWeb");
+function prepareOpenCodeRuntime(cwd, vitePort, enableLsp, enablePrettier) {
+  const cacheDir = import_path.default.join(cwd, import_constants.OPENCODE_CACHE_DIR);
+  log.debug("Setting up OpenCode runtime", { cacheDir, enableLsp });
+  if (!import_fs.default.existsSync(cacheDir)) {
+    import_fs.default.mkdirSync(cacheDir, { recursive: true });
+  }
+  const sourcePluginsDir = resolveSourcePluginsDir();
+  const plugins = resolvePluginEntries(sourcePluginsDir);
+  const formatterConfig = buildFormatterConfig(enablePrettier);
+  const opencodeConfigPath = import_path.default.join(cacheDir, "opencode.json");
+  const config = {
+    plugin: plugins,
+    formatter: formatterConfig,
+    mcp: {
+      "chrome-devtools": {
+        type: "remote",
+        url: `http://localhost:${vitePort}${import_node.MCP_API_PATH}`
+      }
+    }
+  };
+  import_fs.default.writeFileSync(opencodeConfigPath, JSON.stringify(config, null, 2));
+  log.debug("OpenCode runtime ready", {
+    cacheDir,
+    opencodeConfigPath,
+    pluginCount: plugins.length
+  });
+  return cacheDir;
+}
+function startOpenCodeWeb(options) {
+  const {
+    port,
+    hostname,
+    cwd,
+    configDir,
+    corsOrigins,
+    contextApiUrl,
+    logsApiUrl,
+    logFilesJson,
+    enableBlockOnError,
+    verbose,
+    enableLsp,
+    vueDevtoolsApiUrl
+  } = options;
+  const stateDir = createStateDirectory(cwd);
+  log.debug("Building process environment", {
+    stateDir,
+    configDir,
+    contextApiUrl,
+    logsApiUrl,
+    logFilesJson,
+    enableBlockOnError,
+    verbose,
+    enableLsp
+  });
+  const env = buildProcessEnv(
+    stateDir,
+    configDir,
+    contextApiUrl,
+    logsApiUrl,
+    logFilesJson,
+    enableBlockOnError,
+    verbose,
+    enableLsp,
+    vueDevtoolsApiUrl,
+    cwd
+  );
+  const args = ["serve", "--port", String(port), "--hostname", hostname];
+  if (corsOrigins && corsOrigins.length > 0) {
+    corsOrigins.forEach((origin) => {
+      args.push("--cors", origin);
+    });
+    log.debug("CORS origins added", { origins: corsOrigins });
+  }
+  log.debug("Spawning OpenCode process", {
+    command: "opencode",
+    args: args.join(" "),
+    cwd
+  });
+  const proc = (0, import_execa.execa)("opencode", args, {
+    cwd,
+    env,
+    reject: false,
+    cleanup: true,
+    shell: true
+  });
+  proc.stdout?.on("data", (data) => {
+    const output = data.toString().trim();
+    if (output) {
+      log.debug("[OpenCode stdout]", { output });
+      (0, import_node.getProcessLogBuffer)().addProviderStdout(output);
+    }
+  });
+  proc.stderr?.on("data", (data) => {
+    const output = data.toString().trim();
+    if (output) {
+      if (output.includes("MaxListenersExceededWarning")) return;
+      log.warn("[OpenCode stderr]", { output });
+      (0, import_node.getProcessLogBuffer)().addProviderStderr(output);
+    }
+  });
+  return proc;
+}
+function createStateDirectory(cwd) {
+  const stateDir = import_path.default.join(cwd, import_constants.OPENCODE_CACHE_DIR);
+  if (!import_fs.default.existsSync(stateDir)) {
+    import_fs.default.mkdirSync(stateDir, { recursive: true });
+    log.debug("Created state directory", { stateDir });
+  }
+  return stateDir;
+}
+function buildFormatterConfig(enablePrettier) {
+  if (enablePrettier === false) {
+    log.debug("enablePrettier is false, formatter disabled");
+    return false;
+  }
+  const bridgePath = resolveFormatBridgePath();
+  if (!bridgePath) {
+    log.debug("format-bridge not found, using built-in formatters");
+    return true;
+  }
+  log.debug("Format bridge configured");
+  if (!isFormatServiceRunning()) {
+    log.debug("VS Code format service not running, using built-in formatters only");
+    return true;
+  }
+  log.debug("VS Code format service detected, enabling bridge");
+  log.info("\u5DF2\u8FDE\u63A5 VS Code \u683C\u5F0F\u5316\u670D\u52A1");
+  const extensions = [
+    ".ts",
+    ".tsx",
+    ".mts",
+    ".cts",
+    ".js",
+    ".jsx",
+    ".mjs",
+    ".cjs",
+    ".vue",
+    ".svelte",
+    ".astro",
+    ".css",
+    ".scss",
+    ".sass",
+    ".less",
+    ".pcss",
+    ".html",
+    ".htm",
+    ".xml",
+    ".svg",
+    ".json",
+    ".jsonc",
+    ".yaml",
+    ".yml",
+    ".toml",
+    ".md",
+    ".mdx",
+    ".graphql",
+    ".gql"
+  ];
+  return {
+    format_bridge: {
+      command: ["node", bridgePath, "$FILE"],
+      extensions
+    }
+  };
+}
+let _formatServiceRunning;
+function isFormatServiceRunning() {
+  if (_formatServiceRunning !== void 0) return _formatServiceRunning;
+  try {
+    require2("child_process").execSync(
+      `node -e "const h=require('http');h.get('http://127.0.0.1:${import_node.VSCODE_EXTENSION_PORT}/health',r=>{r.resume();process.exit(r.statusCode===200?0:1)}).on('error',()=>process.exit(1))"`,
+      { timeout: 500, stdio: "ignore" }
+    );
+    _formatServiceRunning = true;
+  } catch {
+    _formatServiceRunning = false;
+  }
+  return _formatServiceRunning;
+}
+function resolveFormatBridgePath() {
+  const viteEntry = require2.resolve("vite-plugin-aipanel");
+  const bridgePath = import_path.default.resolve(import_path.default.dirname(viteEntry), "utils", "format-bridge.cjs");
+  if (import_fs.default.existsSync(bridgePath)) return bridgePath;
+  return void 0;
+}
+function resolveSourcePluginsDir() {
+  const candidatePaths = [import_path.default.join(packageDir, "es", "plugins")];
+  for (const candidatePath of candidatePaths) {
+    if (import_fs.default.existsSync(candidatePath)) {
+      return candidatePath;
+    }
+  }
+  return candidatePaths[0];
+}
+const MIGRATED_TO_MCP_PLUGINS = /* @__PURE__ */ new Set(["vue-devtools.js", "vite-logs.js", "service-logs.js"]);
+function resolvePluginEntries(sourceDir) {
+  const files = import_fs.default.readdirSync(sourceDir).filter((f) => f.endsWith(".js") && !MIGRATED_TO_MCP_PLUGINS.has(f));
+  const entries = files.map((file) => {
+    const absolutePath = import_path.default.join(sourceDir, file);
+    return (0, import_url.pathToFileURL)(absolutePath).href;
+  });
+  log.debug("Resolved plugin entries", { count: entries.length, entries });
+  return entries;
+}
+function buildProcessEnv(stateDir, configDir, contextApiUrl, logsApiUrl, logFilesJson, enableBlockOnError, verbose, enableLsp, vueDevtoolsApiUrl, workspace) {
+  const env = {
+    ...Object.fromEntries(
+      Object.entries(process.env).filter(([, v]) => v !== void 0)
+    ),
+    XDG_STATE_HOME: stateDir,
+    // 指向缓存目录，OpenCode 通过 opencode.json 中 plugins 字段加载插件
+    OPENCODE_CONFIG_DIR: stateDir
+  };
+  if (configDir) {
+    env.OPENCODE_CONFIG_DIR = configDir;
+    log.debug("Set OPENCODE_CONFIG_DIR", { configDir });
+  }
+  if (contextApiUrl) {
+    env.OPENCODE_CONTEXT_API_URL = contextApiUrl;
+    log.debug("Set OPENCODE_CONTEXT_API_URL", { contextApiUrl });
+  }
+  if (logsApiUrl) {
+    env.OPENCODE_VITE_LOGS_API_URL = logsApiUrl;
+    log.debug("Set OPENCODE_VITE_LOGS_API_URL", { logsApiUrl });
+  }
+  if (logFilesJson) {
+    env.OPENCODE_LOG_FILES_JSON = logFilesJson;
+    log.debug("Set OPENCODE_LOG_FILES_JSON", { logFilesJson });
+  }
+  if (enableBlockOnError) {
+    env.OPENCODE_BLOCK_ON_ERROR = "1";
+    log.debug("Set OPENCODE_BLOCK_ON_ERROR=1");
+  }
+  if (verbose) {
+    env.OPENCODE_VERBOSE = "1";
+    log.debug("Set OPENCODE_VERBOSE=1");
+  }
+  if (enableLsp) {
+    env.OPENCODE_ENABLE_LINT = "1";
+    log.debug("Set OPENCODE_ENABLE_LINT=1");
+  }
+  if (vueDevtoolsApiUrl) {
+    env.OPENCODE_VUE_DEVTOOLS_API_URL = vueDevtoolsApiUrl;
+    log.debug("Set OPENCODE_VUE_DEVTOOLS_API_URL", { vueDevtoolsApiUrl });
+  }
+  if (workspace) {
+    env.OPENCODE_WORKSPACE = workspace;
+    log.debug("Set OPENCODE_WORKSPACE", { workspace });
+  }
+  if (isFormatServiceRunning()) {
+    env[import_node.ENV_VSCODE_PORT] = String(import_node.VSCODE_EXTENSION_PORT);
+    log.debug("Set OPENCODE_VSCODE_PORT");
+  }
+  return env;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  prepareOpenCodeRuntime,
+  startOpenCodeWeb
+});

package/lib/opencode-web.d.ts

@@ -0,0 +1,4 @@
+import type { ResultPromise } from "execa";
+import type { WebOptions } from "./types";
+export declare function prepareOpenCodeRuntime(cwd: string, vitePort: number, enableLsp?: boolean, enablePrettier?: boolean): string;
+export declare function startOpenCodeWeb(options: WebOptions): ResultPromise;