rolebox 0.1.0

package/README.md

@@ -0,0 +1,167 @@
+# rolebox
+
+Define custom AI agent roles for [opencode](https://github.com/nicholasgriffintn/opencode) via YAML. Each role gets its own prompt, model, skills, and permissions. No code required.
+
+## Quick start
+
+```bash
+# Install
+cd ~/.config/opencode && npm install rolebox
+```
+
+Add to `opencode.jsonc`:
+
+```jsonc
+{
+  "plugin": ["rolebox"]
+}
+```
+
+Create a role:
+
+```bash
+mkdir -p ~/.config/opencode/rolebox/copywriter
+```
+
+```yaml
+# ~/.config/opencode/rolebox/copywriter/role.yaml
+name: Copywriter
+description: Writes concise, punchy copy.
+prompt: |
+  You are a copywriter. Short sentences. No jargon. Every word earns its place.
+```
+
+Restart opencode. The role appears in your agent list.
+
+## Directory structure
+
+```
+~/.config/opencode/
+├── opencode.jsonc
+├── rolebox/
+│   ├── copywriter/
+│   │   └── role.yaml
+│   ├── ai-designer/
+│   │   ├── role.yaml
+│   │   └── skills/
+│   │       ├── visual-design.md
+│   │       └── interaction-patterns/
+│   │           └── SKILL.md
+│   └── ...
+└── skills/                 # Global opencode skills
+```
+
+## Configuration reference
+
+### role.yaml
+
+```yaml
+# Required
+name: string
+description: string
+prompt: |                     # Or use prompt_file (mutually exclusive)
+  Your system prompt here...
+
+# Optional
+model: string                 # e.g. "gpt-4", "claude-3-sonnet"
+mode: primary | subagent | all  # Default: "primary"
+color: string                 # UI color
+variant: string               # Model variant
+temperature: number           # 0.0 - 2.0
+top_p: number                 # 0.0 - 1.0
+prompt_file: string           # Path to external prompt file
+
+# Skills
+skills:                       # From rolebox/{role}/skills/
+  - my-skill
+opencode_skills:              # From ~/.config/opencode/skills/
+  - humanizer
+
+# Permissions
+permission:
+  allow:
+    - Read
+    - Grep
+  deny:
+    - Bash
+tools:
+  Bash: false
+```
+
+### Environment variables
+
+Use `{env:VARIABLE_NAME}` anywhere in role.yaml. Resolved at startup.
+
+```yaml
+model: "{env:PREFERRED_MODEL}"
+prompt: |
+  You work for {env:COMPANY_NAME}...
+```
+
+## Skills
+
+Skills use standard opencode SKILL.md format with YAML frontmatter:
+
+```markdown
+---
+name: my-skill
+description: What this skill does
+---
+
+Skill instructions here...
+```
+
+### Resolution order (first match wins)
+
+1. `{roleDir}/skills/{name}/SKILL.md` (role-local, directory format)
+2. `{roleDir}/skills/{name}.md` (role-local, single file)
+3. `~/.config/opencode/skills/{name}/SKILL.md` (global, directory format)
+4. `~/.config/opencode/skills/{name}.md` (global, single file)
+
+### How skills work at runtime
+
+Rolebox syncs role-local skills into `~/.config/opencode/skills/` at startup. The role's prompt gets an `<available_skills>` XML block listing skill names and descriptions. The model calls the `skill` tool when it needs specialized instructions.
+
+### Example: multi-skill role
+
+```yaml
+name: AI Designer
+description: Professional UI/UX designer producing design specification documents.
+mode: primary
+prompt: |
+  You are a professional UI/UX designer...
+skills:
+  - ai-designer-core
+  - ai-designer-visual
+  - ai-designer-interaction
+  - ai-designer-psychology
+  - ai-designer-research
+  - ai-designer-system
+  - ai-designer-antipatterns
+```
+
+## Startup sequence
+
+1. Scans `~/.config/opencode/rolebox/*/role.yaml`
+2. Parses YAML, resolves `{env:*}` variables, loads `prompt_file` if specified
+3. Resolves skill references to SKILL.md files
+4. Registers each role as an opencode agent
+5. Syncs skills to `~/.config/opencode/skills/`
+6. Syncs agent .md files to `~/.claude/agents/` for compatibility
+
+## Compatibility
+
+Works alongside oh-my-openagent. If both are installed, rolebox roles appear in the agent list and skills are discoverable by the skill tool. No conflicts.
+
+## Error handling
+
+Invalid YAML or missing files won't crash opencode. The broken role is skipped, other roles load normally. Missing skills produce a warning but don't block the role.
+
+## Limitations
+
+- No role inheritance
+- No hot-reload (restart opencode to pick up changes)
+- No model existence validation
+- No runtime role switching
+- No MCP server integration
+- No conditional skills based on project context

package/dist/env-resolver.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Environment variable resolver for rolebox.
+ *
+ * Replaces `{env:VARIABLE_NAME}` patterns in strings with the corresponding
+ * environment variable value. If the variable is not set, the original pattern
+ * is preserved and a warning is logged.
+ */
+/**
+ * Replace `{env:VARIABLE_NAME}` placeholders with actual environment values.
+ *
+ * @param value - The string potentially containing env var placeholders.
+ * @returns The resolved string with environment variables substituted.
+ *          Unresolvable placeholders are left as-is.
+ */
+export declare function resolveEnvVars(value: string): string;
+/**
+ * Deep-resolve all string values in an object/array tree.
+ *
+ * Recursively walks through nested objects and arrays, resolving any
+ * `{env:VARIABLE_NAME}` patterns found in string values.
+ *
+ * @param obj - The value to resolve (string, object, array, or primitive).
+ * @returns A deeply resolved copy of the input.
+ */
+export declare function resolveEnvVarsDeep(obj: unknown): unknown;
+//# sourceMappingURL=env-resolver.d.ts.map

package/dist/env-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-resolver.d.ts","sourceRoot":"","sources":["../src/env-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAkBxD"}

package/dist/env-resolver.js

@@ -0,0 +1,51 @@
+/**
+ * Environment variable resolver for rolebox.
+ *
+ * Replaces `{env:VARIABLE_NAME}` patterns in strings with the corresponding
+ * environment variable value. If the variable is not set, the original pattern
+ * is preserved and a warning is logged.
+ */
+const ENV_VAR_PATTERN = /(?<!\{env:)\{env:([A-Za-z_][A-Za-z0-9_]*)\}/g;
+/**
+ * Replace `{env:VARIABLE_NAME}` placeholders with actual environment values.
+ *
+ * @param value - The string potentially containing env var placeholders.
+ * @returns The resolved string with environment variables substituted.
+ *          Unresolvable placeholders are left as-is.
+ */
+export function resolveEnvVars(value) {
+    return value.replace(ENV_VAR_PATTERN, (match, varName) => {
+        const envValue = process.env[varName];
+        if (envValue === undefined) {
+            console.warn(`[env-resolver] Environment variable "${varName}" is not set; keeping placeholder "${match}"`);
+            return match;
+        }
+        return envValue;
+    });
+}
+/**
+ * Deep-resolve all string values in an object/array tree.
+ *
+ * Recursively walks through nested objects and arrays, resolving any
+ * `{env:VARIABLE_NAME}` patterns found in string values.
+ *
+ * @param obj - The value to resolve (string, object, array, or primitive).
+ * @returns A deeply resolved copy of the input.
+ */
+export function resolveEnvVarsDeep(obj) {
+    if (typeof obj === 'string') {
+        return resolveEnvVars(obj);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => resolveEnvVarsDeep(item));
+    }
+    if (obj !== null && typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = resolveEnvVarsDeep(value);
+        }
+        return result;
+    }
+    return obj;
+}
+//# sourceMappingURL=env-resolver.js.map

package/dist/env-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-resolver.js","sourceRoot":"","sources":["../src/env-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,eAAe,GAAG,8CAA8C,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,wCAAwC,OAAO,sCAAsC,KAAK,GAAG,CAAC,CAAC;YAC5G,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from "@opencode-ai/plugin";
+/**
+ * OpenCode plugin for rolebox — define custom agent roles via YAML
+ * configuration files with custom prompts, models, skills, and permissions.
+ */
+declare const RoleboxPlugin: Plugin;
+export default RoleboxPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA+NlD;;;GAGG;AACH,QAAA,MAAM,aAAa,EAAE,MA+BpB,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,246 @@
+import path from "node:path";
+import os from "node:os";
+import { writeFileSync, readFileSync, mkdirSync, rmdirSync, readdirSync, unlinkSync, symlinkSync, lstatSync, existsSync } from "node:fs";
+import { discoverRoles } from "./role-loader";
+import { resolveSkills } from "./skill-resolver";
+import { buildAgentPrompt } from "./prompt-builder";
+/**
+ * Resolve all discovered roles into ResolvedRole objects.
+ *
+ * For each role in the Map:
+ *  1. Gather both role-local skills (skills[]) and opencode-global skills
+ *     (opencode_skills[]) into a single name list.
+ *  2. Resolve those names to file paths via the 4-candidate priority system.
+ *  3. Build the final agent prompt with <available_skills> XML block.
+ *  4. Return a ResolvedRole object for each successfully-resolved role.
+ *
+ * Errors from individual role resolution are caught and the failing role is
+ * silently skipped (the returned array omits it).
+ */
+async function resolveAllRoles(roles, roleboxDir, globalSkillsDir) {
+    const resolved = [];
+    for (const [roleId, config] of roles) {
+        try {
+            const roleDir = path.join(roleboxDir, roleId);
+            // Combine both role-local and opencode-global skill names.
+            const localSkills = config.skills ?? [];
+            const globalSkills = config.opencode_skills ?? [];
+            const allSkillNames = [...localSkills, ...globalSkills];
+            let skills = [];
+            if (allSkillNames.length > 0) {
+                skills = await resolveSkills(allSkillNames, roleDir, globalSkillsDir);
+            }
+            const prompt = buildAgentPrompt(config, skills);
+            resolved.push({ id: roleId, config, prompt, skills });
+        }
+        catch {
+            // Silently skip roles that fail during resolution.
+        }
+    }
+    return resolved;
+}
+/**
+ * Build an SDK-compatible AgentConfig from a ResolvedRole.
+ *
+ * Only defined fields are included so that defaults in opencode itself
+ * are not accidentally overwritten with empty strings or zero values.
+ */
+function buildAgentConfig(resolved) {
+    const { config } = resolved;
+    const agent = {
+        prompt: resolved.prompt,
+        mode: config.mode ?? "primary",
+    };
+    if (config.model !== undefined) {
+        agent.model = config.model;
+    }
+    if (config.description !== undefined) {
+        agent.description = config.description;
+    }
+    if (config.color !== undefined) {
+        agent.color = config.color;
+    }
+    if (config.variant !== undefined) {
+        agent.variant = config.variant;
+    }
+    if (config.temperature !== undefined) {
+        agent.temperature = config.temperature;
+    }
+    if (config.top_p !== undefined) {
+        agent.top_p = config.top_p;
+    }
+    if (config.tools !== undefined) {
+        agent.tools = config.tools;
+    }
+    if (config.permission !== undefined) {
+        agent.permission = config.permission;
+    }
+    return agent;
+}
+/**
+ * Marker prefix used in agent .md files to identify rolebox-managed agents.
+ * This allows cleanup of stale agents when roles are removed from rolebox.
+ */
+const ROLEBOX_MARKER = "<!-- rolebox-managed -->";
+/**
+ * Write agent definitions to ~/.claude/agents/ as fallback registration.
+ *
+ * This ensures agents are discoverable by oh-my-openagent (which reads
+ * from this directory) even though rolebox also registers them via the
+ * standard config hook. Agents managed by rolebox are tagged with a
+ * marker comment so they can be cleaned up if the role is removed.
+ */
+function syncAgentFiles(resolvedRoles) {
+    const agentsDir = path.join(os.homedir(), ".claude", "agents");
+    try {
+        mkdirSync(agentsDir, { recursive: true });
+    }
+    catch {
+        return; // Can't write — skip silently
+    }
+    try {
+        const existing = readdirSync(agentsDir);
+        for (const file of existing) {
+            if (!file.endsWith(".md"))
+                continue;
+            const filePath = path.join(agentsDir, file);
+            try {
+                const text = readFileSync(filePath, "utf-8");
+                if (text.includes(ROLEBOX_MARKER)) {
+                    const roleId = file.replace(/\.md$/, "");
+                    if (!resolvedRoles.some((r) => r.id === roleId)) {
+                        unlinkSync(filePath);
+                    }
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    catch {
+        // Directory not readable — skip cleanup
+    }
+    // Write current roles
+    for (const resolved of resolvedRoles) {
+        const { config } = resolved;
+        const lines = [
+            ROLEBOX_MARKER,
+            "---",
+            `name: ${config.name}`,
+            `description: ${config.description}`,
+            `mode: ${config.mode ?? "primary"}`,
+        ];
+        if (config.model)
+            lines.push(`model: ${config.model}`);
+        lines.push("---", "", resolved.prompt);
+        const filePath = path.join(agentsDir, `${resolved.id}.md`);
+        try {
+            writeFileSync(filePath, lines.join("\n"), "utf-8");
+        }
+        catch {
+            // Skip if write fails
+        }
+    }
+}
+const ROLEBOX_SKILL_PREFIX = "rolebox--";
+/**
+ * Sync rolebox skills into ~/.config/opencode/skills/ for oh-my-openagent discovery.
+ *
+ * oh-my-openagent's loadSkillsFromDir treats symlinks as directories:
+ * it resolves them and looks for SKILL.md inside. So:
+ * - Directory skills (with SKILL.md): create symlink to the directory
+ * - Single-file skills (.md): create a wrapper directory with SKILL.md symlink inside
+ */
+function syncSkillSymlinks(resolvedRoles, globalSkillsDir) {
+    try {
+        mkdirSync(globalSkillsDir, { recursive: true });
+    }
+    catch {
+        return;
+    }
+    // Clean up stale rolebox entries
+    try {
+        const existing = readdirSync(globalSkillsDir);
+        for (const entry of existing) {
+            if (!entry.startsWith(ROLEBOX_SKILL_PREFIX))
+                continue;
+            const entryPath = path.join(globalSkillsDir, entry);
+            try {
+                const stat = lstatSync(entryPath);
+                if (stat.isSymbolicLink()) {
+                    unlinkSync(entryPath);
+                }
+                else if (stat.isDirectory()) {
+                    // Wrapper directory: remove SKILL.md symlink inside, then rmdir
+                    const inner = path.join(entryPath, "SKILL.md");
+                    try {
+                        unlinkSync(inner);
+                    }
+                    catch { }
+                    try {
+                        rmdirSync(entryPath);
+                    }
+                    catch { }
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    catch { }
+    // Create entries for all resolved role-local skills
+    for (const role of resolvedRoles) {
+        for (const skill of role.skills) {
+            if (skill.scope !== "rolebox")
+                continue;
+            if (!existsSync(skill.filePath))
+                continue;
+            const entryName = `${ROLEBOX_SKILL_PREFIX}${skill.name}`;
+            const entryPath = path.join(globalSkillsDir, entryName);
+            const isDirectorySkill = path.basename(skill.filePath).toLowerCase() === "skill.md";
+            try {
+                if (isDirectorySkill) {
+                    // Symlink to the directory containing SKILL.md
+                    symlinkSync(path.dirname(skill.filePath), entryPath);
+                }
+                else {
+                    // Create wrapper directory with SKILL.md symlink inside
+                    mkdirSync(entryPath, { recursive: true });
+                    symlinkSync(skill.filePath, path.join(entryPath, "SKILL.md"));
+                }
+            }
+            catch { }
+        }
+    }
+}
+/**
+ * OpenCode plugin for rolebox — define custom agent roles via YAML
+ * configuration files with custom prompts, models, skills, and permissions.
+ */
+const RoleboxPlugin = async (ctx) => {
+    const roleboxDir = path.join(ctx.directory, "rolebox");
+    const globalSkillsDir = path.join(ctx.directory, "skills");
+    // Discover all roles from the rolebox directory.
+    // Returns an empty Map when the directory does not exist or is empty.
+    const roles = await discoverRoles(roleboxDir);
+    // Resolve skills and build final prompts for every discovered role.
+    const resolvedRoles = await resolveAllRoles(roles, roleboxDir, globalSkillsDir);
+    // Sync agent files to ~/.claude/agents/ for oh-my-openagent compatibility.
+    syncAgentFiles(resolvedRoles);
+    // Sync role skills as symlinks into ~/.config/opencode/skills/ so that
+    // oh-my-openagent's skill tool can discover and load them.
+    syncSkillSymlinks(resolvedRoles, globalSkillsDir);
+    return {
+        config: async (config) => {
+            for (const resolved of resolvedRoles) {
+                const agentConfig = buildAgentConfig(resolved);
+                config.agent ??= {};
+                config.agent[resolved.id] = agentConfig;
+            }
+        },
+    };
+};
+export default RoleboxPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGzI,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,eAAe,CAC5B,KAA8B,EAC9B,UAAkB,EAClB,eAAuB;IAEvB,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAE9C,2DAA2D;YAC3D,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;YACxC,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC;YAClD,MAAM,aAAa,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,YAAY,CAAC,CAAC;YAExD,IAAI,MAAM,GAAoB,EAAE,CAAC;YACjC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,GAAG,MAAM,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;YACxE,CAAC;YAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAEhD,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,QAAsB;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;IAE5B,MAAM,KAAK,GAAgB;QACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS;KAC/B,CAAC;IAEF,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IACjC,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAuC,CAAC;IACpE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAElD;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,aAA6B;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAE/D,IAAI,CAAC;QACH,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,8BAA8B;IACxC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAS;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC7C,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;oBAClC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;oBACzC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC;wBAChD,UAAU,CAAC,QAAQ,CAAC,CAAC;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;IAED,sBAAsB;IACtB,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC5B,MAAM,KAAK,GAAG;YACZ,cAAc;YACd,KAAK;YACL,SAAS,MAAM,CAAC,IAAI,EAAE;YACtB,gBAAgB,MAAM,CAAC,WAAW,EAAE;YACpC,SAAS,MAAM,CAAC,IAAI,IAAI,SAAS,EAAE;SACpC,CAAC;QACF,IAAI,MAAM,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAEzC;;;;;;;GAOG;AACH,SAAS,iBAAiB,CAAC,aAA6B,EAAE,eAAuB;IAC/E,IAAI,CAAC;QACH,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,iCAAiC;IACjC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;QAC9C,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC;gBAAE,SAAS;YACtD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;gBAClC,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;oBAC1B,UAAU,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC;qBAAM,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBAC9B,gEAAgE;oBAChE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;oBAC/C,IAAI,CAAC;wBAAC,UAAU,CAAC,KAAK,CAAC,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAA,CAAC;oBACnC,IAAI,CAAC;wBAAC,SAAS,CAAC,SAAS,CAAC,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAA,CAAC;gBACxC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,oDAAoD;IACpD,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;gBAAE,SAAS;YACxC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAE1C,MAAM,SAAS,GAAG,GAAG,oBAAoB,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YACzD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;YACxD,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC;YAEpF,IAAI,CAAC;gBACH,IAAI,gBAAgB,EAAE,CAAC;oBACrB,+CAA+C;oBAC/C,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC;gBACvD,CAAC;qBAAM,CAAC;oBACN,wDAAwD;oBACxD,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC1C,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,aAAa,GAAW,KAAK,EAAE,GAAG,EAAE,EAAE;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAE3D,iDAAiD;IACjD,sEAAsE;IACtE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAE9C,oEAAoE;IACpE,MAAM,aAAa,GAAG,MAAM,eAAe,CACzC,KAAK,EACL,UAAU,EACV,eAAe,CAChB,CAAC;IAEF,2EAA2E;IAC3E,cAAc,CAAC,aAAa,CAAC,CAAC;IAE9B,uEAAuE;IACvE,2DAA2D;IAC3D,iBAAiB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAElD,OAAO;QACL,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvB,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;gBACrC,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBAC/C,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC;YAC1C,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/prompt-builder.d.ts

@@ -0,0 +1,13 @@
+import type { RoleConfig, ResolvedSkill } from "./types";
+/**
+ * Build the final system prompt for a role.
+ *
+ * If the skills array is non-empty, the role prompt is followed by an
+ * <available_skills> XML block that lists each resolved skill with its
+ * name, description, and scope.
+ *
+ * If the skills array is empty, the raw role prompt is returned as-is
+ * without any XML wrapping.
+ */
+export declare function buildAgentPrompt(role: RoleConfig, skills: ResolvedSkill[]): string;
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../src/prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEzD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,aAAa,EAAE,GACtB,MAAM,CAsBR"}

package/dist/prompt-builder.js

@@ -0,0 +1,29 @@
+/**
+ * Build the final system prompt for a role.
+ *
+ * If the skills array is non-empty, the role prompt is followed by an
+ * <available_skills> XML block that lists each resolved skill with its
+ * name, description, and scope.
+ *
+ * If the skills array is empty, the raw role prompt is returned as-is
+ * without any XML wrapping.
+ */
+export function buildAgentPrompt(role, skills) {
+    if (skills.length === 0) {
+        return role.prompt;
+    }
+    const skillBlocks = skills
+        .map((s) => `  <skill>
+    <name>${s.name}</name>
+    <description>${s.description}</description>
+    <scope>${s.scope}</scope>
+  </skill>`)
+        .join("\n");
+    return `${role.prompt}
+
+<available_skills>
+Skills provide specialized instructions. Use the skill tool to load when task matches.
+${skillBlocks}
+</available_skills>`;
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../src/prompt-builder.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAgB,EAChB,MAAuB;IAEvB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,MAAM,WAAW,GAAG,MAAM;SACvB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ;YACI,CAAC,CAAC,IAAI;mBACC,CAAC,CAAC,WAAW;aACnB,CAAC,CAAC,KAAK;WACT,CACN;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,GAAG,IAAI,CAAC,MAAM;;;;EAIrB,WAAW;oBACO,CAAC;AACrB,CAAC"}

package/dist/role-loader.d.ts

@@ -0,0 +1,20 @@
+/**
+ * YAML role loader for rolebox.
+ *
+ * Scans a rolebox directory for role definitions (role.yaml files)
+ * and returns a Map of parsed and validated RoleConfig objects keyed
+ * by their directory name (roleId).
+ *
+ * Handles: YAML parsing, prompt_file loading, env var resolution,
+ * graceful skip-on-error, and empty-directory / nonexistent-directory cases.
+ */
+import type { RoleConfig } from "./types";
+/**
+ * Discover roles by scanning `roleboxDir` for subdirectories containing
+ * `role.yaml` files. Only scans ONE level deep (roleboxDir/{role}/role.yaml).
+ *
+ * @param roleboxDir - Absolute path to the rolebox configuration directory.
+ * @returns Map of roleId → RoleConfig for valid roles. Empty Map if no roles found.
+ */
+export declare function discoverRoles(roleboxDir: string): Promise<Map<string, RoleConfig>>;
+//# sourceMappingURL=role-loader.d.ts.map

package/dist/role-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-loader.d.ts","sourceRoot":"","sources":["../src/role-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAgClC"}

package/dist/role-loader.js

@@ -0,0 +1,138 @@
+/**
+ * YAML role loader for rolebox.
+ *
+ * Scans a rolebox directory for role definitions (role.yaml files)
+ * and returns a Map of parsed and validated RoleConfig objects keyed
+ * by their directory name (roleId).
+ *
+ * Handles: YAML parsing, prompt_file loading, env var resolution,
+ * graceful skip-on-error, and empty-directory / nonexistent-directory cases.
+ */
+import { readFile } from "node:fs/promises";
+import { basename, dirname, resolve as pathResolve } from "node:path";
+import fglob from "fast-glob";
+import yaml from "js-yaml";
+import { resolveEnvVarsDeep, resolveEnvVars } from "./env-resolver";
+/**
+ * Discover roles by scanning `roleboxDir` for subdirectories containing
+ * `role.yaml` files. Only scans ONE level deep (roleboxDir/{role}/role.yaml).
+ *
+ * @param roleboxDir - Absolute path to the rolebox configuration directory.
+ * @returns Map of roleId → RoleConfig for valid roles. Empty Map if no roles found.
+ */
+export async function discoverRoles(roleboxDir) {
+    const roles = new Map();
+    let matches;
+    try {
+        matches = await fglob("**/role.yaml", {
+            cwd: roleboxDir,
+            absolute: true,
+            deep: 2,
+        });
+    }
+    catch {
+        // roleboxDir doesn't exist or glob fails — return empty Map silently
+        return roles;
+    }
+    for (const yamlPath of matches) {
+        const roleId = basename(dirname(yamlPath));
+        try {
+            const config = await loadOneRole(yamlPath, roleId);
+            if (config !== null) {
+                roles.set(roleId, config);
+            }
+        }
+        catch {
+            // Unexpected errors during loadOneRole; skip and continue
+            console.warn(`[role-loader] Skipping "${roleId}": unexpected error during load`);
+        }
+    }
+    return roles;
+}
+/**
+ * Parse and validate a single role.yaml file.
+ *
+ * @returns RoleConfig on success, null if the role should be skipped
+ *          (validation failure already logged via console.warn).
+ */
+async function loadOneRole(yamlPath, roleId) {
+    let raw;
+    try {
+        const content = await readFile(yamlPath, "utf-8");
+        raw = yaml.load(content);
+    }
+    catch (err) {
+        console.warn(`[role-loader] Skipping "${roleId}": invalid YAML — ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    if (raw === null || raw === undefined || typeof raw !== "object") {
+        console.warn(`[role-loader] Skipping "${roleId}": YAML does not contain an object`);
+        return null;
+    }
+    const obj = raw;
+    if (!obj.name || typeof obj.name !== "string" || obj.name.trim() === "") {
+        console.warn(`[role-loader] Skipping "${roleId}": missing or invalid "name" field`);
+        return null;
+    }
+    let prompt;
+    if (typeof obj.prompt_file === "string" && obj.prompt_file.trim() !== "") {
+        const promptFilePath = pathResolve(dirname(yamlPath), obj.prompt_file);
+        try {
+            prompt = await readFile(promptFilePath, "utf-8");
+        }
+        catch {
+            console.warn(`[role-loader] Skipping "${roleId}": prompt_file "${obj.prompt_file}" not found`);
+            return null;
+        }
+    }
+    else if (typeof obj.prompt === "string" && obj.prompt.trim() !== "") {
+        prompt = obj.prompt;
+    }
+    else {
+        console.warn(`[role-loader] Skipping "${roleId}": must provide "prompt" or "prompt_file"`);
+        return null;
+    }
+    prompt = resolveEnvVars(prompt);
+    const resolved = resolveEnvVarsDeep(obj);
+    const config = {
+        name: resolved.name,
+        description: resolved.description ?? "",
+        prompt,
+        ...(typeof resolved.prompt_file === "string"
+            ? { prompt_file: resolved.prompt_file }
+            : {}),
+        ...(typeof resolved.model === "string"
+            ? { model: resolved.model }
+            : {}),
+        ...(typeof resolved.mode === "string" &&
+            ["primary", "subagent", "all"].includes(resolved.mode)
+            ? { mode: resolved.mode }
+            : {}),
+        ...(typeof resolved.color === "string"
+            ? { color: resolved.color }
+            : {}),
+        ...(typeof resolved.variant === "string"
+            ? { variant: resolved.variant }
+            : {}),
+        ...(Array.isArray(resolved.skills)
+            ? { skills: resolved.skills }
+            : {}),
+        ...(Array.isArray(resolved.opencode_skills)
+            ? { opencode_skills: resolved.opencode_skills }
+            : {}),
+        ...(resolved.permission != null && typeof resolved.permission === "object"
+            ? { permission: resolved.permission }
+            : {}),
+        ...(resolved.tools != null && typeof resolved.tools === "object"
+            ? { tools: resolved.tools }
+            : {}),
+        ...(typeof resolved.temperature === "number"
+            ? { temperature: resolved.temperature }
+            : {}),
+        ...(typeof resolved.top_p === "number"
+            ? { top_p: resolved.top_p }
+            : {}),
+    };
+    return config;
+}
+//# sourceMappingURL=role-loader.js.map

package/dist/role-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-loader.js","sourceRoot":"","sources":["../src/role-loader.ts"],"names":[],"mappings":"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"}

package/dist/skill-resolver.d.ts

@@ -0,0 +1,29 @@
+import type { ResolvedSkill, SkillMetadata } from "./types";
+/**
+ * Resolve skill names to their file locations using fast-glob.
+ *
+ * For each skill name the four candidate locations are checked in priority
+ * order.  The first existing file wins.  Skills that cannot be found in any
+ * location are silently skipped (no error is thrown).
+ */
+export declare function resolveSkills(skillNames: string[], roleDir: string, globalSkillsDir: string): Promise<ResolvedSkill[]>;
+/**
+ * Read the full SKILL.md content from the resolved skill's file path.
+ *
+ * @throws If the file cannot be read (e.g. it was deleted since resolution).
+ */
+export declare function loadSkillContent(skill: ResolvedSkill): Promise<string>;
+/**
+ * Parse YAML frontmatter from SKILL.md content.
+ *
+ * Frontmatter is delimited by `---` lines at the very start of the file.
+ *
+ * @returns `metadata` — parsed frontmatter keys (empty object if none/invalid)
+ *          `body`    — everything after the closing `---` (or the entire
+ *                      content when no frontmatter is present).
+ */
+export declare function parseFrontmatter(content: string): {
+    metadata: SkillMetadata;
+    body: string;
+};
+//# sourceMappingURL=skill-resolver.d.ts.map

package/dist/skill-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-resolver.d.ts","sourceRoot":"","sources":["../src/skill-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAyB5D;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,EAAE,CAAC,CAyB1B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAW5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd,CA2BA"}

package/dist/skill-resolver.js

@@ -0,0 +1,94 @@
+import fg from "fast-glob";
+import yaml from "js-yaml";
+// Resolution priority:
+//  1. {roleDir}/skills/{name}/SKILL.md  (role-local directory)
+//  2. {roleDir}/skills/{name}.md        (role-local single-file)
+//  3. {globalSkillsDir}/{name}/SKILL.md (global directory)
+//  4. {globalSkillsDir}/{name}.md       (global single-file)
+function buildCandidates(name, roleDir, globalSkillsDir) {
+    return [
+        { scope: "rolebox", pattern: `${roleDir}/skills/${name}/SKILL.md` },
+        { scope: "rolebox", pattern: `${roleDir}/skills/${name}.md` },
+        { scope: "opencode", pattern: `${globalSkillsDir}/${name}/SKILL.md` },
+        { scope: "opencode", pattern: `${globalSkillsDir}/${name}.md` },
+    ];
+}
+/**
+ * Resolve skill names to their file locations using fast-glob.
+ *
+ * For each skill name the four candidate locations are checked in priority
+ * order.  The first existing file wins.  Skills that cannot be found in any
+ * location are silently skipped (no error is thrown).
+ */
+export async function resolveSkills(skillNames, roleDir, globalSkillsDir) {
+    const resolved = [];
+    for (const name of skillNames) {
+        const candidates = buildCandidates(name, roleDir, globalSkillsDir);
+        for (const candidate of candidates) {
+            const matches = await fg(candidate.pattern, { onlyFiles: true });
+            if (matches.length > 0) {
+                const filePath = matches[0];
+                let description = "";
+                try {
+                    const content = await Bun.file(filePath).text();
+                    const { metadata } = parseFrontmatter(content);
+                    description = metadata.description ?? "";
+                }
+                catch {
+                    // If the file can't be read, use empty description
+                }
+                resolved.push({ name, description, scope: candidate.scope, filePath });
+                break;
+            }
+        }
+    }
+    return resolved;
+}
+/**
+ * Read the full SKILL.md content from the resolved skill's file path.
+ *
+ * @throws If the file cannot be read (e.g. it was deleted since resolution).
+ */
+export async function loadSkillContent(skill) {
+    const file = Bun.file(skill.filePath);
+    if (!(await file.exists())) {
+        throw new Error(`Skill file not found at "${skill.filePath}" for skill "${skill.name}". ` +
+            `The file may have been deleted after resolution.`);
+    }
+    return file.text();
+}
+/**
+ * Parse YAML frontmatter from SKILL.md content.
+ *
+ * Frontmatter is delimited by `---` lines at the very start of the file.
+ *
+ * @returns `metadata` — parsed frontmatter keys (empty object if none/invalid)
+ *          `body`    — everything after the closing `---` (or the entire
+ *                      content when no frontmatter is present).
+ */
+export function parseFrontmatter(content) {
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith("---")) {
+        return { metadata: {}, body: content };
+    }
+    const endIdx = trimmed.indexOf("\n---", 3);
+    if (endIdx === -1) {
+        return { metadata: {}, body: content };
+    }
+    const yamlStr = trimmed.slice(4, endIdx);
+    let body = trimmed.slice(endIdx + 4);
+    if (body.startsWith("\n")) {
+        body = body.slice(1);
+    }
+    try {
+        const parsed = yaml.load(yamlStr);
+        if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+            return { metadata: parsed, body };
+        }
+        return { metadata: {}, body };
+    }
+    catch {
+        return { metadata: {}, body: content };
+    }
+}
+//# sourceMappingURL=skill-resolver.js.map

package/dist/skill-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-resolver.js","sourceRoot":"","sources":["../src/skill-resolver.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Permission configuration, mirroring opencode's PermissionConfig structure.
+ * Controls which tools a role is allowed or denied from using.
+ */
+export interface PermissionConfig {
+    /** Tool names the role is explicitly allowed to use */
+    allow?: string[];
+    /** Tool names the role is explicitly denied from using */
+    deny?: string[];
+}
+/**
+ * Raw role configuration as parsed from a role's YAML file (role.yaml).
+ * Contains user-facing settings before any environment variable resolution
+ * or file-based prompt loading has occurred.
+ */
+export interface RoleConfig {
+    /** Human-readable name for the role */
+    name: string;
+    /** Brief description of the role's purpose */
+    description: string;
+    /** LLM model identifier (e.g., "gpt-4", "claude-3-sonnet") */
+    model?: string;
+    /** Role mode: "primary" (default), "subagent", or "all" */
+    mode?: "primary" | "subagent" | "all";
+    /** Display color for the role in the UI */
+    color?: string;
+    /** Model variant / configuration flavor */
+    variant?: string;
+    /** System prompt text (mutually exclusive with prompt_file) */
+    prompt: string;
+    /** Path to a file containing the system prompt (mutually exclusive with prompt) */
+    prompt_file?: string;
+    /** Names of rolebox-local skills to load */
+    skills?: string[];
+    /** Names of opencode-global skills to load */
+    opencode_skills?: string[];
+    /** Permission controls for tool access */
+    permission?: PermissionConfig;
+    /** Map of tool names to enabled/disabled state */
+    tools?: Record<string, boolean>;
+    /** Sampling temperature for the LLM (0.0 - 2.0) */
+    temperature?: number;
+    /** Top-p nucleus sampling parameter (0.0 - 1.0) */
+    top_p?: number;
+}
+/**
+ * A resolved skill reference after locating the corresponding SKILL.md file
+ * in either the role's local skills directory or the opencode global skills directory.
+ */
+export interface ResolvedSkill {
+    /** Skill name (matches the directory or frontmatter name) */
+    name: string;
+    /** Human-readable description from SKILL.md frontmatter */
+    description: string;
+    /** Scope indicating where the skill was found */
+    scope: "rolebox" | "opencode";
+    /** Absolute filesystem path to the SKILL.md file */
+    filePath: string;
+}
+/**
+ * A fully resolved role with all configuration materialized.
+ * Environment variables have been substituted, prompt_file content has been
+ * loaded into the prompt field, and all skill references have been resolved
+ * to their actual file locations.
+ */
+export interface ResolvedRole {
+    /** Unique identifier for the role (typically the directory name) */
+    id: string;
+    /** Original role configuration (raw YAML data) */
+    config: RoleConfig;
+    /** Final system prompt string (after prompt_file resolution) */
+    prompt: string;
+    /** Resolved skill references */
+    skills: ResolvedSkill[];
+}
+/**
+ * YAML frontmatter metadata parsed from SKILL.md files.
+ * Fields follow the standard opencode skill frontmatter schema.
+ */
+export interface SkillMetadata {
+    /** Skill name */
+    name?: string;
+    /** Human-readable description */
+    description?: string;
+    /** Recommended model for this skill */
+    model?: string;
+    /** Software license identifier */
+    license?: string;
+    /** Tool compatibility declaration (e.g., "claude-code opencode") */
+    compatibility?: string;
+    /** Allowed tools, either as a comma-separated string or an array */
+    "allowed-tools"?: string | string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACtC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,MAAM,EAAE,UAAU,CAAC;IACnB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACrC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/examples/code-reviewer/role.yaml

@@ -0,0 +1,25 @@
+name: Code Reviewer
+description: Expert code reviewer with deep understanding of CR and best practices
+model: gpt-4
+mode: subagent
+color: '#4CAF50'
+variant: thorough
+temperature: 0.2
+top_p: 0.95
+prompt: |
+  You are an expert code reviewer. Your job is to:
+
+  1. Review code for correctness, performance, and readability
+  2. Identify potential bugs and security issues
+  3. Suggest improvements with concrete examples
+  4. Be constructive and respectful in your feedback
+
+  Always provide specific, actionable feedback.
+skills:
+  - review-checklist
+permission:
+  allow:
+    - Read
+    - Grep
+    - Glob
+    - Edit

package/examples/code-reviewer/skills/review-checklist/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: review-checklist
+description: Standard code review checklist covering correctness, security, performance, and style
+license: MIT
+compatibility: opencode
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+---
+
+# Code Review Checklist
+
+## Correctness
+- Does the code handle edge cases?
+- Are there any logic errors?
+- Are error paths properly handled?
+
+## Security
+- Are inputs validated and sanitized?
+- Are there any injection vulnerabilities?
+- Are secrets hardcoded?
+
+## Performance
+- Are there N+1 query patterns?
+- Is memory usage reasonable?
+- Are there obvious optimization opportunities?
+
+## Style
+- Does the code follow project conventions?
+- Are names descriptive?
+- Is the code well-structured?

package/examples/tech-writer/role.yaml

@@ -0,0 +1,7 @@
+name: Tech Writer
+description: Technical documentation specialist
+prompt: |
+  You are a technical writer specializing in clear, concise documentation.
+  Write documentation that is accurate, well-structured, and easy to understand.
+opencode_skills:
+  - humanizer

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "rolebox",
+  "version": "0.1.0",
+  "description": "OpenCode plugin — define custom AI agent roles via YAML with per-role prompts, models, skills, and permissions",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "ai-agent",
+    "yaml",
+    "role",
+    "prompt"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EricMoin/rolebox"
+  },
+  "dependencies": {
+    "fast-glob": "^3.3.0",
+    "js-yaml": "^4.1.0"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": "^1.3.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.3.0",
+    "@types/js-yaml": "^4.0.0",
+    "bun-types": "latest",
+    "typescript": "^5.7.0"
+  }
+}