import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; import { fileURLToPath } from "node:url"; import type { AdapterSkillContext, AdapterSkillSnapshot, } from "@paperclipai/adapter-utils"; import { buildPersistentSkillSnapshot, ensurePaperclipSkillSymlink, readPaperclipRuntimeSkillEntries, readInstalledSkillTargets, resolvePaperclipDesiredSkillNames, } from "@paperclipai/adapter-utils/server-utils"; const __moduleDir = path.dirname(fileURLToPath(import.meta.url)); function asString(value: unknown): string | null { return typeof value === "string" && value.trim().length > 0 ? value.trim() : null; } function resolveOpenCodeSkillsHome(config: Record) { const env = typeof config.env === "object" && config.env !== null && !Array.isArray(config.env) ? (config.env as Record) : {}; const configuredHome = asString(env.HOME); const home = configuredHome ? path.resolve(configuredHome) : os.homedir(); return path.join(home, ".claude", "skills"); } async function buildOpenCodeSkillSnapshot(config: Record): Promise { const availableEntries = await readPaperclipRuntimeSkillEntries(config, __moduleDir); const desiredSkills = resolvePaperclipDesiredSkillNames(config, availableEntries); const skillsHome = resolveOpenCodeSkillsHome(config); const installed = await readInstalledSkillTargets(skillsHome); return buildPersistentSkillSnapshot({ adapterType: "opencode_local", availableEntries, desiredSkills, installed, skillsHome, locationLabel: "~/.claude/skills", installedDetail: "Installed in the shared Claude/OpenCode skills home.", missingDetail: "Configured but not currently linked into the shared Claude/OpenCode skills home.", externalConflictDetail: "Skill name is occupied by an external installation in the shared skills home.", externalDetail: "Installed outside Paperclip management in the shared skills home.", warnings: [ "OpenCode currently uses the shared Claude skills home (~/.claude/skills).", ], }); } export async function listOpenCodeSkills(ctx: AdapterSkillContext): Promise { return buildOpenCodeSkillSnapshot(ctx.config); } export async function syncOpenCodeSkills( ctx: AdapterSkillContext, desiredSkills: string[], ): Promise { const availableEntries = await readPaperclipRuntimeSkillEntries(ctx.config, __moduleDir); const desiredSet = new Set([ ...desiredSkills, ...availableEntries.filter((entry) => entry.required).map((entry) => entry.key), ]); const skillsHome = resolveOpenCodeSkillsHome(ctx.config); await fs.mkdir(skillsHome, { recursive: true }); const installed = await readInstalledSkillTargets(skillsHome); const availableByRuntimeName = new Map(availableEntries.map((entry) => [entry.runtimeName, entry])); for (const available of availableEntries) { if (!desiredSet.has(available.key)) continue; const target = path.join(skillsHome, available.runtimeName); await ensurePaperclipSkillSymlink(available.source, target); } for (const [name, installedEntry] of installed.entries()) { const available = availableByRuntimeName.get(name); if (!available) continue; if (desiredSet.has(available.key)) continue; if (installedEntry.targetPath !== available.source) continue; await fs.unlink(path.join(skillsHome, name)).catch(() => {}); } return buildOpenCodeSkillSnapshot(ctx.config); } export function resolveOpenCodeDesiredSkillNames( config: Record, availableEntries: Array<{ key: string; required?: boolean }>, ) { return resolvePaperclipDesiredSkillNames(config, availableEntries); }