Files
opencode-power-pack/.opencode/lib/agent-config.js
T

128 lines
4.4 KiB
JavaScript

import { readdirSync, readFileSync, statSync } from "fs";
import path from "path";
const AGENT_NAMES = ["code-explorer", "code-architect", "code-reviewer"];
const READ_ONLY_PERMISSION = {
"*": "deny",
read: {
"*": "allow",
"*.env": "deny",
"*.env.*": "deny",
"*.env.example": "allow",
},
glob: "allow",
grep: "allow",
list: "allow",
edit: "deny",
task: "deny",
webfetch: "deny",
websearch: "deny",
external_directory: "deny",
};
const REVIEW_BASH_PERMISSION = {
"*": "deny",
"git status*": "allow",
"git diff*": "allow",
"git show*": "allow",
"git log*": "allow",
"git blame*": "allow",
"git rev-parse*": "allow",
"git merge-base*": "allow",
"git ls-files*": "allow",
"git *--output*": "deny",
"git *--ext-diff*": "deny",
"git *>*": "deny",
};
// OpenCode 2 renamed these V1 permission keys and folded `list` into `read`.
const V2_ACTIONS = { bash: "shell", task: "subagent", list: null };
function readSkill(skillsDir, id) {
const file = path.join(skillsDir, id, "SKILL.md");
const match = readFileSync(file, "utf8").match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
if (!match) throw new Error(`Invalid frontmatter in ${id}/SKILL.md`);
const field = (key) => match[1]
.split(/\r?\n/)
.find((line) => line.startsWith(`${key}:`))
?.slice(key.length + 1)
.trim();
const description = field("description");
if (!description) throw new Error(`Missing description in ${id}/SKILL.md`);
// Native OpenCode 2 discovery strips frontmatter, so the body is the content.
return { id, name: field("name") || id, description, path: file, content: match[2] };
}
/** Parses every bundled SKILL.md into the OpenCode 2 Skill.Info shape. */
export function loadSkills(skillsDir) {
return readdirSync(skillsDir)
.filter((entry) => statSync(path.join(skillsDir, entry, "SKILL.md"), { throwIfNoEntry: false })?.isFile())
.sort()
.map((id) => readSkill(skillsDir, id));
}
function specialists(skills) {
return AGENT_NAMES.map((name) => {
const skill = skills.find(({ id }) => id === name);
if (!skill) throw new Error(`Missing specialist skill ${name}`);
return skill;
});
}
// Returns a fresh copy on every call: OpenCode edits agent permissions in place.
function permissionFor(name) {
return structuredClone({
...READ_ONLY_PERMISSION,
bash: name === "code-reviewer" ? REVIEW_BASH_PERMISSION : "deny",
});
}
/** Converts a V1 permission map into the ordered V2 ruleset, preserving key order. */
function toRuleset(permission) {
return Object.entries(permission).flatMap(([key, value]) => {
const action = key in V2_ACTIONS ? V2_ACTIONS[key] : key;
if (!action) return [];
const patterns = typeof value === "string" ? { "*": value } : value;
return Object.entries(patterns).map(([resource, effect]) => ({ action, resource, effect }));
});
}
/** Matches the host's whole-value * and ? permission wildcards. */
function matches(pattern, value) {
const expression = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&")
.replace(/\*/g, ".*").replace(/\?/g, ".");
return new RegExp(`^${expression}$`, process.platform === "win32" ? "is" : "s").test(value);
}
/** Evaluates our ordered policy without granting access denied by the host. */
export function permissionEffect(rules, action, resource) {
// The reviewer's Git prefixes authorize one inspection command, not shell
// composition, redirection, or command substitution following that prefix.
if (action === "shell" && /[;&|<>`$\r\n]/.test(resource)) return "deny";
const normalized = ["read", "edit", "external_directory"].includes(action)
? resource.replaceAll("\\", "/") : resource;
return rules.findLast((rule) => matches(rule.action, action) && matches(rule.resource, normalized))?.effect ?? "deny";
}
/** OpenCode 1 agent definitions, merged through the plugin config hook. */
export function legacyAgents(skills) {
return Object.fromEntries(specialists(skills).map((skill) => [skill.id, {
description: skill.description,
prompt: skill.content.trim(),
mode: "subagent",
permission: permissionFor(skill.id),
}]));
}
/** OpenCode 2 Agent.Info patches, applied through an agent transform. */
export function agents(skills) {
return Object.fromEntries(specialists(skills).map((skill) => [skill.id, {
name: skill.name,
description: skill.description,
system: skill.content.trim(),
mode: "subagent",
hidden: false,
permissions: toRuleset(permissionFor(skill.id)),
}]));
}