rolebox 0.1.1 → 0.3.0

package/README.md

@@ -1,11 +1,10 @@
 # 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.
+Define custom AI agent roles for [opencode](https://github.com/nicholasgriffintn/opencode) via YAML. Each role gets its own prompt, model, skills, functions, and permissions. No code required.
 
-## Quick start
+## Install
 
 ```bash
-# Install
 cd ~/.config/opencode && npm install rolebox
 ```
 
@@ -17,7 +16,7 @@ Add to `opencode.jsonc`:
 }
 ```
 
-Create a role:
+## Create a role
 
 ```bash
 mkdir -p ~/.config/opencode/rolebox/copywriter
@@ -33,24 +32,124 @@ prompt: |
 
 Restart opencode. The role appears in your agent list.
 
-## Directory structure
+## Functions
+
+Functions are composable behavior modules that users activate at runtime with `|name|` syntax. They inject additional instructions into the system prompt on demand.
+
+Every role ships with two built-in functions (`plan` and `execute`) by default. Users activate them by prefixing their message:
 
 ```
-~/.config/opencode/
-├── opencode.jsonc
-├── rolebox/
-│   ├── copywriter/
-│   │   └── role.yaml
-│   ├── ai-designer/
-│   │   ├── role.yaml
-│   │   └── skills/
-│   │       ├── visual-design.md
-│   │       └── interaction-patterns/
-│   │           └── SKILL.md
-│   └── ...
-└── skills/                 # Global opencode skills
+|plan| redesign the auth module
+|execute| implement the refactoring we discussed
+|plan|execute| add pagination to the API
+```
+
+### How it works
+
+1. User types `|plan| do something` → parser strips `|plan|`, activates the function for this session
+2. On every subsequent turn, the function's instructions are injected into the system prompt
+3. Functions persist for the session once activated
+
+### Writing custom functions
+
+Create a markdown file with YAML frontmatter:
+
+```markdown
+---
+name: review
+description: Code review mode with configurable focus
+params:
+  focus: correctness
+  severity: normal
+---
+
+You are reviewing code with focus on **{focus}** at **{severity}** level.
+
+Check for:
+- Logic errors and edge cases
+- Performance implications
+- Consistency with existing patterns
+```
+
+### Parameterized functions
+
+Functions accept parameters via two syntax styles:
+
+**Positional** (maps to param declaration order):
+```
+|review:security,strict| check the auth module
+```
+
+**Key-value** (explicit naming):
+```
+|review focus=security severity=strict| check the auth module
+```
+
+**Mixed** (some with args, some without):
+```
+|plan|review:security| analyze this PR
+```
+
+Parameters that aren't provided fall back to their declared default values. Functions without a `params` block ignore any passed arguments.
+
+### Resolution priority
+
+1. `{roleDir}/functions/{name}.md` — role-local override
+2. `~/.config/opencode/functions/{name}.md` — global user-defined
+3. Built-in (`plan`, `execute`) — shipped with rolebox
+
+### Configuring functions per role
+
+```yaml
+# Use only specific functions (replaces the default plan+execute)
+functions:
+  - plan
+  - review
+  - my-custom-fn
+
+# Disable specific defaults
+disable_functions:
+  - execute
+```
+
+### Built-in functions
+
+**plan** — Instructs the agent to investigate the codebase with tools (Read, Grep, Glob, LSP) before planning. Produces a structured plan with verification strategy. Waits for user approval before executing.
+
+**execute** — Instructs the agent to implement step by step with tool-based verification (lsp_diagnostics, build, tests) after each change. Handles failures with a two-attempt escalation policy.
+
+## Skills
+
+Skills are on-demand knowledge modules the agent loads via the `skill` tool when needed. Unlike functions (which are always-on once activated), skills are pulled in contextually.
+
+```markdown
+---
+name: review-checklist
+description: Comprehensive code review checklist
+---
+
+When reviewing code, check:
+- Error handling completeness
+- Input validation
+- ...
 ```
 
+### Resolution order
+
+1. `{roleDir}/skills/{name}/SKILL.md` (role-local, directory)
+2. `{roleDir}/skills/{name}.md` (role-local, single file)
+3. `~/.config/opencode/skills/{name}/SKILL.md` (global, directory)
+4. `~/.config/opencode/skills/{name}.md` (global, single file)
+
+### Skill vs Function
+
+| | Skill | Function |
+|---|---|---|
+| Activation | Agent decides via `skill` tool | User activates with `\|name\|` syntax |
+| Lifetime | Single use per invocation | Persists for the session |
+| Purpose | Reference knowledge | Behavior modification |
+| Injection | On-demand into context | Always in system prompt while active |
+
 ## Configuration reference
 
 ### role.yaml
@@ -77,6 +176,14 @@ skills:                       # From rolebox/{role}/skills/
 opencode_skills:              # From ~/.config/opencode/skills/
   - humanizer
 
+# Functions
+functions:                    # Available functions (default: [plan, execute])
+  - plan
+  - execute
+  - my-custom-fn
+disable_functions:            # Remove specific defaults
+  - execute
+
 # Permissions
 permission:
   allow:
@@ -98,70 +205,85 @@ 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
----
+## Directory structure
 
-Skill instructions here...
+```
+~/.config/opencode/
+├── opencode.jsonc
+├── rolebox/
+│   ├── copywriter/
+│   │   └── role.yaml
+│   ├── code-reviewer/
+│   │   ├── role.yaml
+│   │   ├── skills/
+│   │   │   └── review-checklist.md
+│   │   └── functions/
+│   │       └── plan.md          # Role-local override of built-in plan
+│   └── ...
+├── functions/                    # Global user-defined functions
+│   └── my-custom-fn.md
+└── skills/                       # Global opencode skills
 ```
 
-### 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.
+## Examples
 
-### Example: multi-skill role
+### Code reviewer with custom plan function
 
 ```yaml
-name: AI Designer
-description: Professional UI/UX designer producing design specification documents.
-mode: primary
+# rolebox/code-reviewer/role.yaml
+name: Code Reviewer
+description: Expert code reviewer
+model: gpt-4
+mode: subagent
+temperature: 0.2
 prompt: |
-  You are a professional UI/UX designer...
+  You are an expert code reviewer. Review for correctness,
+  performance, and readability. Be specific and actionable.
 skills:
-  - ai-designer-core
-  - ai-designer-visual
-  - ai-designer-interaction
-  - ai-designer-psychology
-  - ai-designer-research
-  - ai-designer-system
-  - ai-designer-antipatterns
+  - review-checklist
+functions:
+  - plan
+permission:
+  allow: [Read, Grep, Glob]
 ```
 
-## Startup sequence
+### Parameterized review function
+
+```markdown
+<!-- rolebox/code-reviewer/functions/review.md -->
+---
+name: review
+description: Configurable code review
+params:
+  focus: correctness
+  depth: normal
+---
 
-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
+Review this code with focus on **{focus}**.
+
+Depth level: **{depth}**
+- normal: flag clear issues, suggest improvements
+- deep: trace all code paths, verify edge cases, check error propagation
+- surface: only obvious bugs and style issues
+```
+
+Usage: `|review:security,deep| check the new auth endpoints`
 
 ## 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.
+Works alongside oh-my-openagent. 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.
+- Invalid YAML or missing files won't crash opencode. The broken role is skipped.
+- Missing skills produce a warning but don't block the role.
+- Missing functions are silently skipped.
+- Invalid function activation syntax (uppercase, mid-sentence pipes) is left untouched in the message.
 
 ## Limitations
 
-- No role inheritance
 - No hot-reload (restart opencode to pick up changes)
-- No model existence validation
+- No role inheritance
 - No runtime role switching
-- No MCP server integration
-- No conditional skills based on project context
+- Functions persist for the entire session (no per-message deactivation yet)
+- No conditional functions based on project context

package/dist/function-parser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A parsed function activation entry — name plus optional arguments.
+ */
+export interface FunctionCall {
+    name: string;
+    args: Record<string, string>;
+}
+/**
+ * Parse `|fn|` function activation syntax from user messages.
+ *
+ * Only matches `|fn|` patterns at the very start of the text.
+ * Mid-sentence `|fn|` is NOT activation and is left untouched.
+ *
+ * Supports parameterized activation:
+ *   - Positional: |review:security,strict|  → mapped to param order in frontmatter
+ *   - Key-value:  |review focus=security severity=strict|
+ *   - Mixed:      |plan| |review:security|  → plan has no args, review has one
+ */
+export declare function parseFunctionActivation(text: string): {
+    functions: string[];
+    calls: FunctionCall[];
+    cleanedText: string;
+};
+//# sourceMappingURL=function-parser.d.ts.map

package/dist/function-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-parser.d.ts","sourceRoot":"","sources":["../src/function-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG;IACrD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,CA+BA"}

package/dist/function-parser.js

@@ -0,0 +1,87 @@
+/**
+ * Parse `|fn|` function activation syntax from user messages.
+ *
+ * Only matches `|fn|` patterns at the very start of the text.
+ * Mid-sentence `|fn|` is NOT activation and is left untouched.
+ *
+ * Supports parameterized activation:
+ *   - Positional: |review:security,strict|  → mapped to param order in frontmatter
+ *   - Key-value:  |review focus=security severity=strict|
+ *   - Mixed:      |plan| |review:security|  → plan has no args, review has one
+ */
+export function parseFunctionActivation(text) {
+    // Matches consecutive |fn| or |fn:args| or |fn key=val| patterns at the start.
+    // The inner content between pipes can contain: letters, digits, hyphens, colons,
+    // equals, commas, spaces (for key=val pairs), underscores, dots, slashes.
+    const fullPattern = /^\|[a-z][a-z0-9-]*(?:[: ][^|]*)?\|(?:\|?[a-z][a-z0-9-]*(?:[: ][^|]*)?\|)*/;
+    const match = text.match(fullPattern);
+    if (!match) {
+        return { functions: [], calls: [], cleanedText: text };
+    }
+    const matched = match[0];
+    const cleanedText = text.slice(matched.length).trimStart();
+    // Split into individual function segments.
+    // Each segment is between pipes: |segment1|segment2| or |segment1||segment2|
+    const segments = matched.split("|").filter(Boolean);
+    const functions = [];
+    const calls = [];
+    for (const segment of segments) {
+        const call = parseSingleCall(segment);
+        if (call) {
+            functions.push(call.name);
+            calls.push(call);
+        }
+    }
+    return { functions, calls, cleanedText };
+}
+/**
+ * Parse a single function segment like "review:security,strict"
+ * or "review focus=security severity=strict" into a FunctionCall.
+ */
+function parseSingleCall(segment) {
+    // Try colon syntax first: "name:arg1,arg2"
+    const colonIdx = segment.indexOf(":");
+    const spaceIdx = segment.indexOf(" ");
+    if (colonIdx > 0 && (spaceIdx < 0 || colonIdx < spaceIdx)) {
+        const name = segment.slice(0, colonIdx);
+        if (!isValidName(name))
+            return null;
+        const argsStr = segment.slice(colonIdx + 1);
+        const positional = argsStr.split(",").map((s) => s.trim()).filter(Boolean);
+        const args = {};
+        for (let i = 0; i < positional.length; i++) {
+            args[`_${i}`] = positional[i];
+        }
+        return { name, args };
+    }
+    // Try key=value syntax: "name key1=val1 key2=val2"
+    if (spaceIdx > 0) {
+        const name = segment.slice(0, spaceIdx);
+        if (!isValidName(name))
+            return null;
+        const rest = segment.slice(spaceIdx + 1).trim();
+        const args = parseKeyValueArgs(rest);
+        return { name, args };
+    }
+    // Plain name, no args
+    if (!isValidName(segment))
+        return null;
+    return { name: segment, args: {} };
+}
+/**
+ * Parse "key1=val1 key2=val2" into a Record.
+ */
+function parseKeyValueArgs(str) {
+    const args = {};
+    // Match key=value pairs. Value can be quoted or unquoted.
+    const pattern = /([a-z][a-z0-9_-]*)=(?:"([^"]*)"|(\S+))/g;
+    let m;
+    while ((m = pattern.exec(str)) !== null) {
+        args[m[1]] = m[2] ?? m[3];
+    }
+    return args;
+}
+function isValidName(s) {
+    return /^[a-z][a-z0-9-]*$/.test(s);
+}
+//# sourceMappingURL=function-parser.js.map

package/dist/function-parser.js.map

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

package/dist/function-resolver.d.ts

@@ -0,0 +1,35 @@
+import type { FunctionMetadata, ResolvedFunction } from "./types";
+import type { FunctionCall } from "./function-parser";
+/**
+ * Resolve function names to their file locations using Bun.file().exists().
+ *
+ * For each function name, three candidate locations are checked in priority
+ * order.  The first existing file wins.  Functions whose body is empty after
+ * frontmatter are skipped.  Functions that cannot be found in any location
+ * are silently skipped (a warning is logged).
+ *
+ * Resolution priority:
+ *  1. {roleDir}/functions/{name}.md  (role-local)
+ *  2. {globalFunctionsDir}/{name}.md (global)
+ *  3. {builtinDir}/{name}.md         (built-in)
+ */
+export declare function resolveFunctions(names: string[], roleDir: string, globalFunctionsDir: string, builtinDir: string): Promise<ResolvedFunction[]>;
+/**
+ * Apply parameter substitution to a function's content.
+ *
+ * Replaces `{param_name}` placeholders with values from the activation call.
+ * Positional args (from colon syntax) are mapped to param declaration order.
+ * Missing params fall back to their declared default values.
+ * Unresolved placeholders (no value, no default) are left as-is.
+ */
+export declare function applyParams(fn: ResolvedFunction, call: FunctionCall): string;
+/**
+ * Read a function file and extract its frontmatter metadata and body content.
+ *
+ * @throws If the file cannot be read.
+ */
+export declare function loadFunctionContent(filePath: string): Promise<{
+    metadata: FunctionMetadata;
+    content: string;
+}>;
+//# sourceMappingURL=function-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"function-resolver.d.ts","sourceRoot":"","sources":["../src/function-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,MAAM,EAC1B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAmD7B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,gBAAgB,EACpB,IAAI,EAAE,YAAY,GACjB,MAAM,CA+BR;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB1D"}

package/dist/function-resolver.js

@@ -0,0 +1,115 @@
+import { parseFrontmatter } from "./skill-resolver";
+/**
+ * Resolve function names to their file locations using Bun.file().exists().
+ *
+ * For each function name, three candidate locations are checked in priority
+ * order.  The first existing file wins.  Functions whose body is empty after
+ * frontmatter are skipped.  Functions that cannot be found in any location
+ * are silently skipped (a warning is logged).
+ *
+ * Resolution priority:
+ *  1. {roleDir}/functions/{name}.md  (role-local)
+ *  2. {globalFunctionsDir}/{name}.md (global)
+ *  3. {builtinDir}/{name}.md         (built-in)
+ */
+export async function resolveFunctions(names, roleDir, globalFunctionsDir, builtinDir) {
+    const resolved = [];
+    for (const name of names) {
+        const candidates = [
+            { source: "role-local", path: `${roleDir}/functions/${name}.md` },
+            { source: "global", path: `${globalFunctionsDir}/${name}.md` },
+            { source: "built-in", path: `${builtinDir}/${name}.md` },
+        ];
+        let matched = false;
+        for (const candidate of candidates) {
+            if (!(await Bun.file(candidate.path).exists())) {
+                continue;
+            }
+            let content;
+            try {
+                content = await Bun.file(candidate.path).text();
+            }
+            catch {
+                continue;
+            }
+            const { metadata, body } = parseFrontmatter(content);
+            if (body.trim() === "") {
+                continue;
+            }
+            resolved.push({
+                name: metadata.name ?? name,
+                description: metadata.description ?? "",
+                content: body,
+                filePath: candidate.path,
+                source: candidate.source,
+                params: metadata.params,
+            });
+            matched = true;
+            break;
+        }
+        if (!matched) {
+            console.warn(`Function "${name}" not found in any of the searched locations.`);
+        }
+    }
+    return resolved;
+}
+/**
+ * Apply parameter substitution to a function's content.
+ *
+ * Replaces `{param_name}` placeholders with values from the activation call.
+ * Positional args (from colon syntax) are mapped to param declaration order.
+ * Missing params fall back to their declared default values.
+ * Unresolved placeholders (no value, no default) are left as-is.
+ */
+export function applyParams(fn, call) {
+    if (!fn.params || Object.keys(fn.params).length === 0) {
+        return fn.content;
+    }
+    const paramNames = Object.keys(fn.params);
+    const resolved = {};
+    // Map positional args (_0, _1, ...) to declared param order
+    for (let i = 0; i < paramNames.length; i++) {
+        const paramName = paramNames[i];
+        if (call.args[paramName] !== undefined) {
+            // Named arg takes priority
+            resolved[paramName] = call.args[paramName];
+        }
+        else if (call.args[`_${i}`] !== undefined) {
+            // Positional arg by index
+            resolved[paramName] = call.args[`_${i}`];
+        }
+        else {
+            // Fall back to default from frontmatter
+            resolved[paramName] = fn.params[paramName];
+        }
+    }
+    let content = fn.content;
+    for (const [key, value] of Object.entries(resolved)) {
+        if (value !== undefined && value !== "") {
+            content = content.replaceAll(`{${key}}`, value);
+        }
+    }
+    return content;
+}
+/**
+ * Read a function file and extract its frontmatter metadata and body content.
+ *
+ * @throws If the file cannot be read.
+ */
+export async function loadFunctionContent(filePath) {
+    const file = Bun.file(filePath);
+    if (!(await file.exists())) {
+        throw new Error(`Function file not found at "${filePath}". ` +
+            `The file may have been deleted.`);
+    }
+    const content = await file.text();
+    const { metadata, body } = parseFrontmatter(content);
+    return {
+        metadata: {
+            name: metadata.name,
+            description: metadata.description ?? "",
+        },
+        content: body,
+    };
+}
+//# sourceMappingURL=function-resolver.js.map

package/dist/function-resolver.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,10 @@
 import type { Plugin } from "@opencode-ai/plugin";
+import type { ResolvedFunction } from "./types";
+/**
+ * Map of roleId → ResolvedFunction[] built at startup.
+ * Exported so tests and hooks can query role-level function resolution.
+ */
+export declare const roleFunctionsMap: Map<string, ResolvedFunction[]>;
 /**
  * OpenCode plugin for rolebox — define custom agent roles via YAML
  * configuration files with custom prompts, models, skills, and permissions.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA2OlD;;;GAGG;AACH,QAAA,MAAM,aAAa,EAAE,MA+BpB,CAAC;AAEF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAYlD,OAAO,KAAK,EAA2C,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEzF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,iCAAwC,CAAC;AAsPtE;;;GAGG;AACH,QAAA,MAAM,aAAa,EAAE,MA6FpB,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -1,9 +1,20 @@
 import path from "node:path";
 import os from "node:os";
 import { writeFileSync, readFileSync, mkdirSync, rmdirSync, readdirSync, unlinkSync, symlinkSync, lstatSync, existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 import { discoverRoles } from "./role-loader";
 import { resolveSkills } from "./skill-resolver";
-import { buildAgentPrompt } from "./prompt-builder";
+import { resolveFunctions, applyParams } from "./function-resolver";
+import { parseFunctionActivation } from "./function-parser";
+import { functionSessionState } from "./session-state";
+import { buildAgentPrompt, buildFunctionBlock } from "./prompt-builder";
+/**
+ * Map of roleId → ResolvedFunction[] built at startup.
+ * Exported so tests and hooks can query role-level function resolution.
+ */
+export const roleFunctionsMap = new Map();
 /**
  * Resolve all discovered roles into ResolvedRole objects.
  *
@@ -11,13 +22,14 @@ import { buildAgentPrompt } from "./prompt-builder";
  *  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.
+ *  3. Gather function names, filter disabled ones, and resolve function files.
+ *  4. Build the final agent prompt with <available_skills> XML block.
+ *  5. 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) {
+async function resolveAllRoles(roles, roleboxDir, globalSkillsDir, configDir) {
     const resolved = [];
     for (const [roleId, config] of roles) {
         try {
@@ -30,8 +42,17 @@ async function resolveAllRoles(roles, roleboxDir, globalSkillsDir) {
             if (allSkillNames.length > 0) {
                 skills = await resolveSkills(allSkillNames, roleDir, globalSkillsDir);
             }
+            const globalFunctionsDir = path.join(configDir, "functions");
+            const builtinDir = path.join(__dirname, "..", "functions");
+            const functionNames = config.functions ?? ["plan", "execute"];
+            const enabledFunctions = functionNames.filter((fn) => !(config.disable_functions ?? []).includes(fn));
+            let functions = [];
+            if (enabledFunctions.length > 0) {
+                functions = await resolveFunctions(enabledFunctions, roleDir, globalFunctionsDir, builtinDir);
+            }
             const prompt = buildAgentPrompt(config, skills);
-            resolved.push({ id: roleId, config, prompt, skills });
+            resolved.push({ id: roleId, config, prompt, skills, functions });
+            roleFunctionsMap.set(roleId, functions);
         }
         catch {
             // Silently skip roles that fail during resolution.
@@ -231,13 +252,19 @@ function syncSkillSymlinks(resolvedRoles, globalSkillsDir) {
  * configuration files with custom prompts, models, skills, and permissions.
  */
 const RoleboxPlugin = async (ctx) => {
-    const roleboxDir = path.join(ctx.directory, "rolebox");
-    const globalSkillsDir = path.join(getOpencodeConfigDir(), "skills");
+    const configDir = getOpencodeConfigDir();
+    // Prefer ctx.directory/rolebox if it exists (e.g. when ctx.directory IS the
+    // config dir), otherwise fall back to the well-known config location.
+    const ctxRoleboxDir = path.join(ctx.directory, "rolebox");
+    const roleboxDir = existsSync(ctxRoleboxDir)
+        ? ctxRoleboxDir
+        : path.join(configDir, "rolebox");
+    const globalSkillsDir = path.join(configDir, "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);
+    const resolvedRoles = await resolveAllRoles(roles, roleboxDir, globalSkillsDir, configDir);
     // Sync agent files to ~/.claude/agents/ for oh-my-openagent compatibility.
     syncAgentFiles(resolvedRoles);
     // Sync role skills as symlinks into ~/.config/opencode/skills/ so that
@@ -251,6 +278,57 @@ const RoleboxPlugin = async (ctx) => {
                 config.agent[resolved.id] = agentConfig;
             }
         },
+        "chat.message": async (input, output) => {
+            const textPartIndex = output.parts.findIndex((p) => p.type === "text" && "text" in p);
+            if (textPartIndex === -1)
+                return;
+            const part = output.parts[textPartIndex];
+            const { functions: parsedFunctions, calls, cleanedText } = parseFunctionActivation(part.text);
+            if (parsedFunctions.length === 0)
+                return;
+            part.text = cleanedText;
+            const roleId = input.agent;
+            const roleFunctions = roleId ? roleFunctionsMap.get(roleId) : null;
+            if (roleFunctions) {
+                const validNames = new Set(roleFunctions.map((f) => f.name));
+                const validFunctions = parsedFunctions.filter((fn) => validNames.has(fn));
+                const validCalls = calls.filter((c) => validNames.has(c.name));
+                functionSessionState.activate(input.sessionID, validFunctions, validCalls);
+            }
+            else {
+                functionSessionState.activate(input.sessionID, parsedFunctions, calls);
+            }
+        },
+        "experimental.chat.system.transform": async (input, output) => {
+            if (!input.sessionID)
+                return;
+            const activeNames = functionSessionState.getActive(input.sessionID);
+            if (activeNames.size === 0)
+                return;
+            const allFunctions = [];
+            for (const funcs of roleFunctionsMap.values()) {
+                allFunctions.push(...funcs);
+            }
+            const seen = new Set();
+            const activeFunctions = [];
+            for (const fn of allFunctions) {
+                if (activeNames.has(fn.name) && !seen.has(fn.name)) {
+                    // Apply parameter substitution if the function was called with args
+                    const call = functionSessionState.getCall(input.sessionID, fn.name);
+                    if (call && fn.params && Object.keys(call.args).length > 0) {
+                        activeFunctions.push({ ...fn, content: applyParams(fn, call) });
+                    }
+                    else {
+                        activeFunctions.push(fn);
+                    }
+                    seen.add(fn.name);
+                }
+            }
+            if (activeFunctions.length === 0)
+                return;
+            const block = buildFunctionBlock(activeFunctions);
+            output.system.push(block);
+        },
     };
 };
 export default RoleboxPlugin;

package/dist/index.js.map

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

package/dist/prompt-builder.d.ts

@@ -1,4 +1,4 @@
-import type { RoleConfig, ResolvedSkill } from "./types";
+import type { RoleConfig, ResolvedFunction, ResolvedSkill } from "./types";
 /**
  * Build the final system prompt for a role.
  *
@@ -10,4 +10,11 @@ import type { RoleConfig, ResolvedSkill } from "./types";
  * without any XML wrapping.
  */
 export declare function buildAgentPrompt(role: RoleConfig, skills: ResolvedSkill[]): string;
+/**
+ * Build an XML block listing active functions for system prompt injection.
+ *
+ * Each function's content is wrapped in CDATA to prevent XML parsing issues.
+ * Returns empty string when the functions array is empty.
+ */
+export declare function buildFunctionBlock(functions: ResolvedFunction[]): string;
 //# sourceMappingURL=prompt-builder.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../src/prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE3E;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,aAAa,EAAE,GACtB,MAAM,CAsBR;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAsBxE"}

package/dist/prompt-builder.js

@@ -26,4 +26,28 @@ Skills provide specialized instructions. Use the skill tool to load when task ma
 ${skillBlocks}
 </available_skills>`;
 }
+/**
+ * Build an XML block listing active functions for system prompt injection.
+ *
+ * Each function's content is wrapped in CDATA to prevent XML parsing issues.
+ * Returns empty string when the functions array is empty.
+ */
+export function buildFunctionBlock(functions) {
+    if (functions.length === 0) {
+        return "";
+    }
+    const blocks = functions
+        .map((fn) => `  <function>
+    <name>${fn.name}</name>
+    <description>${fn.description}</description>
+    <instructions><![CDATA[
+${fn.content}
+    ]]></instructions>
+  </function>`)
+        .join("\n");
+    return `<active_functions>
+These functions are currently active for this session. Follow their instructions.
+${blocks}
+</active_functions>`;
+}
 //# sourceMappingURL=prompt-builder.js.map

package/dist/prompt-builder.js.map

@@ -1 +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"}
+{"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;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA6B;IAC9D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS;SACrB,GAAG,CACF,CAAC,EAAE,EAAE,EAAE,CACL;YACI,EAAE,CAAC,IAAI;mBACA,EAAE,CAAC,WAAW;;EAE/B,EAAE,CAAC,OAAO;;cAEE,CACT;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;EAEP,MAAM;oBACY,CAAC;AACrB,CAAC"}

package/dist/role-loader.js

@@ -132,6 +132,12 @@ async function loadOneRole(yamlPath, roleId) {
         ...(typeof resolved.top_p === "number"
             ? { top_p: resolved.top_p }
             : {}),
+        ...(Array.isArray(resolved.functions)
+            ? { functions: resolved.functions }
+            : {}),
+        ...(Array.isArray(resolved.disable_functions)
+            ? { disable_functions: resolved.disable_functions }
+            : {}),
     };
     return config;
 }

package/dist/role-loader.js.map

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

package/dist/session-state.d.ts

@@ -0,0 +1,12 @@
+import type { FunctionCall } from "./function-parser";
+export declare class FunctionSessionState {
+    private sessions;
+    private callArgs;
+    activate(sessionID: string, functionNames: string[], calls?: FunctionCall[]): void;
+    getActive(sessionID: string): Set<string>;
+    getCall(sessionID: string, functionName: string): FunctionCall | undefined;
+    isActive(sessionID: string, functionName: string): boolean;
+    clear(sessionID: string): void;
+}
+export declare const functionSessionState: FunctionSessionState;
+//# sourceMappingURL=session-state.d.ts.map

package/dist/session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../src/session-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,QAAQ,CAAqD;IAErE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI;IAoBlF,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIzC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI1E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAI1D,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAI/B;AAED,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/dist/session-state.js

@@ -0,0 +1,37 @@
+export class FunctionSessionState {
+    sessions = new Map();
+    callArgs = new Map();
+    activate(sessionID, functionNames, calls) {
+        if (!this.sessions.has(sessionID)) {
+            this.sessions.set(sessionID, new Set());
+        }
+        const active = this.sessions.get(sessionID);
+        for (const name of functionNames) {
+            active.add(name);
+        }
+        if (calls && calls.length > 0) {
+            if (!this.callArgs.has(sessionID)) {
+                this.callArgs.set(sessionID, new Map());
+            }
+            const argsMap = this.callArgs.get(sessionID);
+            for (const call of calls) {
+                argsMap.set(call.name, call);
+            }
+        }
+    }
+    getActive(sessionID) {
+        return this.sessions.get(sessionID) ?? new Set();
+    }
+    getCall(sessionID, functionName) {
+        return this.callArgs.get(sessionID)?.get(functionName);
+    }
+    isActive(sessionID, functionName) {
+        return this.sessions.get(sessionID)?.has(functionName) ?? false;
+    }
+    clear(sessionID) {
+        this.sessions.delete(sessionID);
+        this.callArgs.delete(sessionID);
+    }
+}
+export const functionSessionState = new FunctionSessionState();
+//# sourceMappingURL=session-state.js.map

package/dist/session-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.js","sourceRoot":"","sources":["../src/session-state.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,oBAAoB;IACvB,QAAQ,GAA6B,IAAI,GAAG,EAAE,CAAC;IAC/C,QAAQ,GAA2C,IAAI,GAAG,EAAE,CAAC;IAErE,QAAQ,CAAC,SAAiB,EAAE,aAAuB,EAAE,KAAsB;QACzE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAED,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;YAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IACnD,CAAC;IAED,OAAO,CAAC,SAAiB,EAAE,YAAoB;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IACzD,CAAC;IAED,QAAQ,CAAC,SAAiB,EAAE,YAAoB;QAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,SAAiB;QACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC"}

package/dist/types.d.ts

@@ -42,6 +42,10 @@ export interface RoleConfig {
     temperature?: number;
     /** Top-p nucleus sampling parameter (0.0 - 1.0) */
     top_p?: number;
+    /** Names of functions this role supports */
+    functions?: string[];
+    /** Names of default functions to disable */
+    disable_functions?: string[];
 }
 /**
  * A resolved skill reference after locating the corresponding SKILL.md file
@@ -57,6 +61,24 @@ export interface ResolvedSkill {
     /** Absolute filesystem path to the SKILL.md file */
     filePath: string;
 }
+/**
+ * A resolved function reference after locating the corresponding function file
+ * in either the role's local functions directory or a global functions directory.
+ */
+export interface ResolvedFunction {
+    /** Function name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Raw function content (the actual system message / tool definition) */
+    content: string;
+    /** Absolute filesystem path to the function file */
+    filePath: string;
+    /** Source indicating where the function was found */
+    source: "role-local" | "global" | "built-in";
+    /** Parameter declarations from frontmatter (name → default value) */
+    params?: Record<string, string>;
+}
 /**
  * A fully resolved role with all configuration materialized.
  * Environment variables have been substituted, prompt_file content has been
@@ -72,6 +94,8 @@ export interface ResolvedRole {
     prompt: string;
     /** Resolved skill references */
     skills: ResolvedSkill[];
+    /** Resolved function references */
+    functions: ResolvedFunction[];
 }
 /**
  * YAML frontmatter metadata parsed from SKILL.md files.
@@ -91,4 +115,16 @@ export interface SkillMetadata {
     /** Allowed tools, either as a comma-separated string or an array */
     "allowed-tools"?: string | string[];
 }
+/**
+ * YAML frontmatter metadata parsed from function files.
+ * Fields follow a simpler subset of the skill frontmatter schema.
+ */
+export interface FunctionMetadata {
+    /** Function name */
+    name?: string;
+    /** Human-readable description */
+    description?: string;
+    /** Parameter declarations: name → default value or description */
+    params?: Record<string, string>;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/examples/code-reviewer/functions/plan.md

@@ -0,0 +1,30 @@
+---
+name: plan
+description: Code review planning mode — analyze PRs and structure review plans
+---
+
+You are a code reviewer in PLANNING mode. Before writing a review, create a structured plan.
+
+## Review Planning Process
+
+1. **Understand the Change**: Identify what the PR/modification is trying to accomplish. What problem does it solve?
+
+2. **Scope the Review**: Determine which files and areas need focused attention:
+   - New functionality vs. refactoring
+   - Core logic vs. peripheral changes
+   - Public API vs. internal implementation
+
+3. **Identify Risk Areas**: Flag files that warrant closer inspection:
+   - Security-sensitive changes (auth, input handling, data access)
+   - Performance-critical paths
+   - Public API or interface changes
+   - Complex logic with many branches
+
+4. **Plan the Review Order**: Structure your review to be efficient:
+   - Start with the overall approach/architecture
+   - Then dive into specific files by risk level
+   - End with style, naming, and documentation
+
+5. **Present Your Plan**: Outline what you'll examine and in what order.
+
+Present the plan before executing the review.

package/examples/code-reviewer/role.yaml

@@ -17,6 +17,8 @@ prompt: |
   Always provide specific, actionable feedback.
 skills:
   - review-checklist
+functions:
+  - plan
 permission:
   allow:
     - Read

package/functions/execute.md

@@ -0,0 +1,63 @@
+---
+name: execute
+description: Execution mode — implement step by step with tool-based verification after each change
+---
+
+You are now in EXECUTION mode. You have a plan (explicit or implied). Implement it systematically.
+
+## Process
+
+### 1. Work Step by Step
+
+For each step:
+
+- Complete it fully before moving on
+- Don't skip ahead or combine unrelated steps
+- If the plan proves wrong mid-execution, stop. State what changed. Propose revision.
+
+### 2. Verify After Each Change
+
+After every file edit or meaningful action, verify with your tools:
+
+- **lsp_diagnostics** on changed files — no new errors introduced
+- **Bash** to run build/test commands if the project has them
+- **Read** the changed file to confirm the edit landed correctly
+- **Grep** to check you didn't break other callers or references
+
+Do not assume success. Run the check. If a step has no verifiable output, state what you couldn't confirm.
+
+### 3. Report Progress
+
+After each step, one to three sentences:
+
+- What you did
+- Whether verification passed
+- What's next
+
+Don't repeat the plan. Don't narrate your thinking. Just report results.
+
+### 4. Handle Failures
+
+When something breaks:
+
+1. Read the actual error output. Don't guess.
+2. Fix the root cause (not the symptom). Re-verify.
+3. If two attempts fail on the same issue: stop. Report what you tried, what you think is wrong, and what options remain.
+
+Never shotgun-debug. Never suppress errors to make them go away.
+
+### 5. Finish Clean
+
+When done:
+
+- Run a final verification pass (build, test, lsp_diagnostics on all changed files)
+- List what was accomplished
+- Note anything deferred or worth watching
+- Tell the user how to verify themselves if relevant
+
+## Guidelines
+
+- Precision > speed. Right the first time beats fast-then-fix.
+- Stay in scope. Notice unrelated issues? Note them, don't fix them.
+- Minimal changes. Don't refactor while implementing. Don't "improve" adjacent code.
+- Be direct about failure. "X broke because Y" > hedging.

package/functions/plan.md

@@ -0,0 +1,69 @@
+---
+name: plan
+description: Strategic planning mode — investigate the codebase, then create a structured plan before execution
+---
+
+You are now in PLANNING mode. Do not make changes yet. Investigate first, then plan.
+
+## Process
+
+### 1. Investigate Before Planning
+
+Use your tools to understand the current state before proposing changes:
+
+- **Read** files that will be affected. Don't guess at their contents.
+- **Grep/Glob** to find related patterns, usages, and dependencies.
+- **LSP** to check type relationships and references if relevant.
+- **Bash** to inspect project structure, dependencies, build config.
+
+Do not plan based on assumptions. If you haven't read the file, you don't know what's in it.
+
+### 2. Analyze the Request
+
+With investigation complete, identify:
+
+- The actual goal (not just the surface request)
+- Constraints: backward compatibility, performance, existing patterns, test coverage
+- What's implied but not stated
+- Whether the existing codebase already has conventions for this kind of change
+
+### 3. Break Down the Work
+
+Decompose into discrete steps. Each step must be:
+
+- Specific enough to verify (name the file, the function, the expected behavior)
+- Ordered by dependency
+- Scoped to one concern (don't mix refactoring with new features)
+
+Bad: "handle edge cases." Good: "add null check in parseConfig() for missing `port` field, return default 3000."
+
+### 4. Identify Risks
+
+For each non-trivial step:
+
+- What could break? (other callers, tests, types)
+- What assumptions are you making about the codebase?
+- What would you need to verify after making the change?
+
+### 5. Present the Plan
+
+**Goal**: One sentence.
+
+**Steps**:
+1. Step — what you'll do, which files, complexity estimate
+2. ...
+
+**Verification**: How you'll confirm it works (which tests to run, what to check with LSP, what to build).
+
+**Open questions**: Anything blocking.
+
+### 6. Wait for Approval
+
+Present the plan. Do not start executing until the user confirms or the task is trivially obvious.
+
+## Guidelines
+
+- Fewer steps > many micro-steps. Aim for 3–8 steps, not 20.
+- Be honest about what you don't know. "I need to read X first" is valid.
+- If multiple approaches exist, recommend one with a brief reason. Don't present an essay of trade-offs.
+- Scale the plan to the task. A typo fix needs one line, not five sections.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rolebox",
-  "version": "0.1.1",
+  "version": "0.3.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",
@@ -14,7 +14,8 @@
   },
   "files": [
     "dist",
-    "examples"
+    "examples",
+    "functions"
   ],
   "scripts": {
     "build": "tsc",