import path from "path" import { type ParseError as JsoncParseError, applyEdits, modify, parse as parseJsonc, printParseErrorCode, } from "jsonc-parser" import { ConfigPaths } from "@/config/paths" import { Global } from "@/global" import { Filesystem } from "@/util/filesystem" import { Flock } from "@/util/flock" import { parsePluginSpecifier, readPluginPackage, resolvePluginTarget } from "./shared" type Mode = "noop" | "add" | "replace" type Kind = "server" | "tui" export type Target = { kind: Kind opts?: Record } export type InstallDeps = { resolve: (spec: string) => Promise } export type PatchDeps = { readText: (file: string) => Promise write: (file: string, text: string) => Promise exists: (file: string) => Promise files: (dir: string, name: "opencode" | "tui") => string[] } export type PatchInput = { spec: string targets: Target[] force?: boolean global?: boolean vcs?: string worktree: string directory: string config?: string } type Ok = { ok: true } & T type Err = { ok: false code: C } & T export type InstallResult = Ok<{ target: string }> | Err<"install_failed", { error: unknown }> export type ManifestResult = | Ok<{ targets: Target[] }> | Err<"manifest_read_failed", { file: string; error: unknown }> | Err<"manifest_no_targets", { file: string }> export type PatchItem = { kind: Kind mode: Mode file: string } type PatchErr = | Err<"invalid_json", { kind: Kind; file: string; line: number; col: number; parse: string }> | Err<"patch_failed", { kind: Kind; error: unknown }> type PatchOne = Ok<{ item: PatchItem }> | PatchErr export type PatchResult = Ok<{ dir: string; items: PatchItem[] }> | (PatchErr & { dir: string }) const defaultInstallDeps: InstallDeps = { resolve: (spec) => resolvePluginTarget(spec), } const defaultPatchDeps: PatchDeps = { readText: (file) => Filesystem.readText(file), write: async (file, text) => { await Filesystem.write(file, text) }, exists: (file) => Filesystem.exists(file), files: (dir, name) => ConfigPaths.fileInDirectory(dir, name), } function pluginSpec(item: unknown) { if (typeof item === "string") return item if (!Array.isArray(item)) return if (typeof item[0] !== "string") return return item[0] } function parseTarget(item: unknown): Target | undefined { if (item === "server" || item === "tui") return { kind: item } if (!Array.isArray(item)) return if (item[0] !== "server" && item[0] !== "tui") return if (item.length < 2) return { kind: item[0] } const opt = item[1] if (!opt || typeof opt !== "object" || Array.isArray(opt)) return { kind: item[0] } return { kind: item[0], opts: opt, } } function parseTargets(raw: unknown) { if (!Array.isArray(raw)) return [] const map = new Map() for (const item of raw) { const hit = parseTarget(item) if (!hit) continue map.set(hit.kind, hit) } return [...map.values()] } function patchPluginList(list: unknown[], spec: string, next: unknown, force = false): { mode: Mode; list: unknown[] } { const pkg = parsePluginSpecifier(spec).pkg const rows = list.map((item, i) => ({ item, i, spec: pluginSpec(item), })) const dup = rows.filter((item) => { if (!item.spec) return false if (item.spec === spec) return true if (item.spec.startsWith("file://")) return false return parsePluginSpecifier(item.spec).pkg === pkg }) if (!dup.length) { return { mode: "add", list: [...list, next], } } if (!force) { return { mode: "noop", list, } } const keep = dup[0] if (!keep) { return { mode: "noop", list, } } if (dup.length === 1 && keep.spec === spec) { return { mode: "noop", list, } } const idx = new Set(dup.map((item) => item.i)) return { mode: "replace", list: rows.flatMap((row) => { if (!idx.has(row.i)) return [row.item] if (row.i !== keep.i) return [] if (typeof row.item === "string") return [next] if (Array.isArray(row.item) && typeof row.item[0] === "string") { return [[spec, ...row.item.slice(1)]] } return [row.item] }), } } export async function installPlugin(spec: string, dep: InstallDeps = defaultInstallDeps): Promise { const target = await dep.resolve(spec).then( (item) => ({ ok: true as const, item, }), (error: unknown) => ({ ok: false as const, error, }), ) if (!target.ok) { return { ok: false, code: "install_failed", error: target.error, } } return { ok: true, target: target.item, } } export async function readPluginManifest(target: string): Promise { const pkg = await readPluginPackage(target).then( (item) => ({ ok: true as const, item, }), (error: unknown) => ({ ok: false as const, error, }), ) if (!pkg.ok) { return { ok: false, code: "manifest_read_failed", file: target, error: pkg.error, } } const targets = parseTargets(pkg.item.json["oc-plugin"]) if (!targets.length) { return { ok: false, code: "manifest_no_targets", file: pkg.item.pkg, } } return { ok: true, targets, } } function patchDir(input: PatchInput) { if (input.global) return input.config ?? Global.Path.config const git = input.vcs === "git" && input.worktree !== "/" const root = git ? input.worktree : input.directory return path.join(root, ".opencode") } function patchName(kind: Kind): "opencode" | "tui" { if (kind === "server") return "opencode" return "tui" } async function patchOne(dir: string, target: Target, spec: string, force: boolean, dep: PatchDeps): Promise { const name = patchName(target.kind) await using _ = await Flock.acquire(`plug-config:${Filesystem.resolve(path.join(dir, name))}`) const files = dep.files(dir, name) let cfg = files[0] for (const file of files) { if (!(await dep.exists(file))) continue cfg = file break } const src = await dep.readText(cfg).catch((err: NodeJS.ErrnoException) => { if (err.code === "ENOENT") return "{}" return err }) if (src instanceof Error) { return { ok: false, code: "patch_failed", kind: target.kind, error: src, } } const text = src.trim() ? src : "{}" const errs: JsoncParseError[] = [] const data = parseJsonc(text, errs, { allowTrailingComma: true }) if (errs.length) { const err = errs[0] const lines = text.substring(0, err.offset).split("\n") return { ok: false, code: "invalid_json", kind: target.kind, file: cfg, line: lines.length, col: lines[lines.length - 1].length + 1, parse: printParseErrorCode(err.error), } } const list: unknown[] = data && typeof data === "object" && !Array.isArray(data) && Array.isArray(data.plugin) ? data.plugin : [] const item = target.opts ? [spec, target.opts] : spec const out = patchPluginList(list, spec, item, force) if (out.mode === "noop") { return { ok: true, item: { kind: target.kind, mode: out.mode, file: cfg, }, } } const edits = modify(text, ["plugin"], out.list, { formattingOptions: { tabSize: 2, insertSpaces: true, }, }) const write = await dep.write(cfg, applyEdits(text, edits)).catch((error: unknown) => error) if (write instanceof Error) { return { ok: false, code: "patch_failed", kind: target.kind, error: write, } } return { ok: true, item: { kind: target.kind, mode: out.mode, file: cfg, }, } } export async function patchPluginConfig(input: PatchInput, dep: PatchDeps = defaultPatchDeps): Promise { const dir = patchDir(input) const items: PatchItem[] = [] for (const target of input.targets) { const hit = await patchOne(dir, target, input.spec, Boolean(input.force), dep) if (!hit.ok) { return { ...hit, dir, } } items.push(hit.item) } return { ok: true, dir, items, } }