97 lines
3.6 KiB
TypeScript
97 lines
3.6 KiB
TypeScript
import fs from "node:fs/promises";
|
|
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";
|
|
import { resolveCodexHomeDir } from "./codex-home.js";
|
|
|
|
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 resolveCodexSkillsHome(config: Record<string, unknown>, companyId?: string) {
|
|
const env =
|
|
typeof config.env === "object" && config.env !== null && !Array.isArray(config.env)
|
|
? (config.env as Record<string, unknown>)
|
|
: {};
|
|
const configuredCodexHome = asString(env.CODEX_HOME);
|
|
const home = configuredCodexHome
|
|
? path.resolve(configuredCodexHome)
|
|
: resolveCodexHomeDir(process.env, companyId);
|
|
return path.join(home, "skills");
|
|
}
|
|
|
|
async function buildCodexSkillSnapshot(
|
|
config: Record<string, unknown>,
|
|
companyId?: string,
|
|
): Promise<AdapterSkillSnapshot> {
|
|
const availableEntries = await readPaperclipRuntimeSkillEntries(config, __moduleDir);
|
|
const desiredSkills = resolvePaperclipDesiredSkillNames(config, availableEntries);
|
|
const skillsHome = resolveCodexSkillsHome(config, companyId);
|
|
const installed = await readInstalledSkillTargets(skillsHome);
|
|
return buildPersistentSkillSnapshot({
|
|
adapterType: "codex_local",
|
|
availableEntries,
|
|
desiredSkills,
|
|
installed,
|
|
skillsHome,
|
|
locationLabel: "$CODEX_HOME/skills",
|
|
missingDetail: "Configured but not currently linked into the Codex skills home.",
|
|
externalConflictDetail: "Skill name is occupied by an external installation.",
|
|
externalDetail: "Installed outside Paperclip management.",
|
|
});
|
|
}
|
|
|
|
export async function listCodexSkills(ctx: AdapterSkillContext): Promise<AdapterSkillSnapshot> {
|
|
return buildCodexSkillSnapshot(ctx.config, ctx.companyId);
|
|
}
|
|
|
|
export async function syncCodexSkills(
|
|
ctx: AdapterSkillContext,
|
|
desiredSkills: string[],
|
|
): Promise<AdapterSkillSnapshot> {
|
|
const availableEntries = await readPaperclipRuntimeSkillEntries(ctx.config, __moduleDir);
|
|
const desiredSet = new Set([
|
|
...desiredSkills,
|
|
...availableEntries.filter((entry) => entry.required).map((entry) => entry.key),
|
|
]);
|
|
const skillsHome = resolveCodexSkillsHome(ctx.config, ctx.companyId);
|
|
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 buildCodexSkillSnapshot(ctx.config, ctx.companyId);
|
|
}
|
|
|
|
export function resolveCodexDesiredSkillNames(
|
|
config: Record<string, unknown>,
|
|
availableEntries: Array<{ key: string; required?: boolean }>,
|
|
) {
|
|
return resolvePaperclipDesiredSkillNames(config, availableEntries);
|
|
}
|