opencode-froggy 0.4.0 → 0.5.1

package/README.md

@@ -7,7 +7,7 @@
   <a href="https://www.npmjs.com/package/opencode-froggy"><img src="https://badge.fury.io/js/opencode-froggy.svg" alt="npm version"></a>
 </p>
 
-Plugin providing Claude Code–style hooks, specialized agents (doc-writer, code reviewer, architect, partner, etc.), dedicated commands such as simplify-code and review-pr, and tools such as gitingest.
+OpenCode plugin providing hooks, specialized agents (architect, doc-writer, rubber-duck, partner), skills (code-review, code-simplify), and tools (gitingest, blockchain queries, agent-promote).
 
 ---
 
@@ -16,11 +16,14 @@ Plugin providing Claude Code–style hooks, specialized agents (doc-writer, code
 - [Installation](#installation)
 - [Commands](#commands)
 - [Agents](#agents)
+- [Skills](#skills)
+  - [code-review](#code-review)
+  - [code-simplify](#code-simplify)
 - [Tools](#tools)
   - [gitingest](#gitingest)
-  - [diff-summary](#diff-summary)
   - [prompt-session](#prompt-session)
   - [list-child-sessions](#list-child-sessions)
+  - [agent-promote](#agent-promote)
   - [Blockchain](#blockchain)
     - [Configuration](#configuration)
     - [eth-transaction](#eth-transaction)
@@ -66,14 +69,34 @@ Alternatively, clone or copy the plugin files to one of these directories:
 
 | Command | Description | Agent |
 |---------|-------------|-------|
+| `/agent-promote <name> [grade]` | Promote an agent to primary (default) or specify grade: `subagent`, `primary`, `all` | - |
+| `/agent-demote <name>` | Demote an agent to subagent | - |
 | `/commit-push` | Stage, commit, and push changes with user confirmation | `build` |
+| `/diff-summary [source] [target]` | Show working tree changes or diff between branches | - |
 | `/doc-changes` | Update documentation based on uncommitted changes (new features only) | `doc-writer` |
-| `/review-changes` | Review uncommitted changes (staged + unstaged, including untracked files) | `code-reviewer` |
-| `/review-pr <source> <target>` | Review changes from source branch into target branch | `code-reviewer` |
 | `/send-to [agent] <message>` | Send a message to a child session (subagent) to continue the conversation | - |
-| `/simplify-changes` | Simplify uncommitted changes (staged + unstaged, including untracked files) | `code-simplifier` |
 | `/tests-coverage` | Run the full test suite with coverage report and suggest fixes for failures | `build` |
 
+### /diff-summary
+
+The `/diff-summary` command supports two modes:
+
+**Working tree mode** (no parameters):
+```bash
+/diff-summary
+```
+Shows staged changes, unstaged changes, and untracked file contents.
+
+**Branch comparison mode** (with parameters):
+```bash
+# Compare a branch with the current branch (HEAD)
+/diff-summary feature-branch
+
+# Compare two specific branches
+/diff-summary feature-branch main
+```
+Shows stats overview, commits, files changed, and full diff between branches.
+
 ---
 
 ## Agents
@@ -81,14 +104,44 @@ Alternatively, clone or copy the plugin files to one of these directories:
 | Agent | Mode | Description |
 |-------|------|-------------|
 | `architect` | subagent | Strategic technical advisor providing high-leverage guidance on architecture, code structure, and complex engineering trade-offs. Read-only. |
-| `code-reviewer` | subagent | Reviews code for quality, correctness, and security. Read-only with restricted git access. |
-| `code-simplifier` | subagent | Simplifies recently modified code for clarity and maintainability while strictly preserving behavior. |
 | `doc-writer` | subagent | Technical writer that crafts clear, comprehensive documentation (README, API docs, architecture docs, user guides). |
 | `partner` | subagent | Strategic ideation partner that breaks frames, expands solution spaces, and surfaces non-obvious strategic options. Read-only. |
 | `rubber-duck` | subagent | Strategic thinking partner for exploratory dialogue. Challenges assumptions, asks pointed questions, and sharpens thinking through conversational friction. Read-only. |
 
 ---
 
+## Skills
+
+Skills are loaded on-demand to provide specialized capabilities during a session.
+
+### code-review
+
+Read-only code review skill that analyzes diffs for real problems.
+
+- **Purpose**: Provide actionable feedback on code changes without modifying files
+- **Activation**: On user request, or before committing/merging changes
+- **Focus areas**:
+  - Logic & stability (edge cases, race conditions, state transitions)
+  - Security (injection risks, validation, sensitive data exposure)
+  - Performance (resource leaks, O(n²) operations, unnecessary calls)
+  - Maintainability (SOLID violations, excessive complexity)
+- **Output**: Numbered blocking issues with evidence and fix suggestions, plus optional simplification candidates
+
+### code-simplify
+
+Automatic simplification skill that improves code clarity while preserving behavior.
+
+- **Purpose**: Ensure newly written code enters the codebase at a high standard of clarity
+- **Activation**: Automatically after any code modification (new files, edits, refactors)
+- **Core principle**: Behavior preservation is absolute — no changes to APIs, return values, side effects, or execution order
+- **Focus areas**:
+  - Reduce unnecessary nesting and redundant checks
+  - Improve naming only when it prevents misunderstanding
+  - Consolidate related logic without merging concerns
+  - Remove comments that restate obvious code
+
+---
+
 ## Tools
 
 ### gitingest
@@ -139,50 +192,6 @@ gitingest({
 
 ---
 
-### diff-summary
-
-**Command** that displays a structured summary of git working tree changes (staged, unstaged, and untracked files). Injects git diff output directly into the prompt using bash commands.
-
-#### Usage
-
-```bash
-/diff-summary
-```
-
-#### What it shows
-
-- Git status (porcelain format)
-- Staged changes (stats and full diff)
-- Unstaged changes (stats and full diff)
-- Untracked files content (first 50 lines of each file)
-
-#### Implementation
-
-This command uses OpenCode's `!`\`...\`` syntax to inject bash command output directly into the prompt, avoiding the 2000-line truncation limit that affects tools.
-
-See `command/diff-summary.md` for the full implementation.
-
-#### Output Structure
-
-**For branch comparisons:**
-- Stats Overview: Summary of changes (insertions, deletions)
-- Commits to Review: List of commits in the range
-- Files Changed: List of modified files
-- Full Diff: Complete diff with context
-
-**For working tree changes:**
-- Status Overview: Git status output
-- Staged Changes: Stats, files, and diff for staged changes
-- Unstaged Changes: Stats, files, and diff for unstaged changes
-- Untracked Files: List and diffs for new untracked files
-
-#### Notes
-
-- When comparing branches, the tool fetches from the remote before generating the diff
-- Diffs include 5 lines of context and function context for better readability
-
----
-
 ### prompt-session
 
 Send a message to a child session (subagent) to continue the conversation. Useful for iterating with subagents without creating new sessions.
@@ -250,6 +259,46 @@ Child sessions (2):
 
 ---
 
+### agent-promote
+
+Promote an agent to primary (default) or specify a grade.
+
+#### Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `name` | `string` | Yes | Name of the plugin agent (e.g., `rubber-duck`, `architect`) |
+| `grade` | `string` | No | Target type: `subagent`, `primary`, or `all` (default: `primary`) |
+
+#### Grade Types
+
+| Grade | Effect |
+|-------|--------|
+| `subagent` | Available only as a subagent |
+| `primary` | Appears in Tab selection for direct use |
+| `all` | Available both as primary and subagent |
+
+#### Usage Examples
+
+```bash
+# Promote rubber-duck to primary (default)
+/agent-promote rubber-duck
+
+# Promote with explicit grade
+/agent-promote architect all
+
+# Demote back to subagent
+/agent-demote rubber-duck
+```
+
+#### Notes
+
+- Only agents from this plugin can be promoted (see [Agents](#agents) table)
+- Changes persist in memory until OpenCode restarts
+- After promotion, use `Tab` or `<leader>a` to select the agent
+
+---
+
 ### Blockchain
 
 Tools for querying Ethereum and EVM-compatible blockchains via Etherscan APIs.

package/command/agent-demote.md

@@ -0,0 +1,5 @@
+---
+description: Demote an agent to subagent
+---
+
+Use the agent-promote tool with name=$1 and grade=subagent.

package/command/agent-promote.md

@@ -0,0 +1,5 @@
+---
+description: Promote an agent to primary (or specify grade)
+---
+
+Use the agent-promote tool to change agent $1 to grade $2. If no grade is provided, use primary.

package/command/commit-push.md

@@ -13,8 +13,13 @@ agent: build
 2. Present a summary to the user:
    - Files modified/added/deleted with stats
    - Proposed commit message based on the changes
-3. Ask the user for confirmation before proceeding
-4. Only if the user confirms:
+3. **If the current branch is `master`, `main`, `develop`, or `dev`:**
+   - Warn the user that committing directly to this branch is discouraged
+   - Propose to create a new feature branch with a suggested name based on the changes
+   - Ask the user if they want to: (a) create the suggested branch, (b) provide a custom branch name, or (c) continue on the current branch anyway
+   - If the user chooses to create a branch, create it and switch to it before proceeding
+4. Ask the user for confirmation before proceeding
+5. Only if the user confirms:
    - Stage all changes (`git add -A`)
    - Create the commit with the agreed message
    - Push to origin on the current branch

package/command/diff-summary.md

@@ -1,19 +1,51 @@
 ---
-description: Show working tree changes (staged, unstaged, untracked)
+description: Show working tree changes or diff between branches ($1=source, $2=target)
 ---
 
-# Diff Summary: Working Tree → HEAD
+# Diff Summary
 
-## Status
-!`git status --porcelain`
+!`bash -c '
+SOURCE="$1"
+TARGET="$2"
+TARGET="${TARGET:-HEAD}"
 
-## Staged Changes
-!`git diff --cached --stat`
-!`git diff --cached`
+if [ -n "$SOURCE" ]; then
+  echo "## Branch Comparison: $SOURCE → $TARGET"
+  echo ""
+  git fetch --all --prune 2>/dev/null || true
+  
+  echo "### Stats Overview"
+  git diff --stat "$TARGET"..."$SOURCE"
+  
+  echo ""
+  echo "### Commits"
+  git log --oneline --no-merges "$TARGET".."$SOURCE"
+  
+  echo ""
+  echo "### Files Changed"
+  git diff --name-only "$TARGET"..."$SOURCE"
+  
+  echo ""
+  echo "### Full Diff"
+  git diff "$TARGET"..."$SOURCE"
+else
+  echo "## Status"
+  git status --porcelain
 
-## Unstaged Changes
-!`git diff --stat`
-!`git diff`
+  echo ""
+  echo "## Staged Changes"
+  git diff --cached --stat
+  git diff --cached
 
-## Untracked Files Content
-!`bash -c 'git ls-files --others --exclude-standard | while read f; do [ -f "$f" ] && echo "=== $f ===" && sed -n "1,50p" "$f" && sed -n "51p" "$f" | grep -q . && echo "... (truncated)"; done'`
+  echo ""
+  echo "## Unstaged Changes"
+  git diff --stat
+  git diff
+
+  echo ""
+  echo "## Untracked Files Content"
+  git ls-files --others --exclude-standard | while read f; do
+    [ -f "$f" ] && echo "=== $f ===" && sed -n "1,50p" "$f" && sed -n "51p" "$f" | grep -q . && echo "... (truncated)"
+  done
+fi
+'`

package/command/gh-create-pr.md

@@ -0,0 +1,18 @@
+---
+description: Commit, push and create a GitHub PR
+agent: build
+---
+
+## Context
+
+- Current branch: !`git branch --show-current`
+- Default branch: !`gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name'`
+
+## Your task
+
+1. Execute `/commit-push` to commit and push all changes
+2. Once the push is complete, create a PR using `gh pr create`:
+   - Use the commit message as PR title
+   - Generate a brief PR description summarizing the changes
+   - Target the repository's default branch
+3. Display the PR URL to the user

package/command/send-to.md

@@ -5,7 +5,7 @@ description: Send a message to a child session (subagent) to continue the conver
 Send a message to a child session using the `prompt-session` tool.
 
 Parse the input:
-- If the first word matches a known agent type (e.g., `rubber-duck`, `explore`, `code-simplifier`, `general`, `architect`, `code-reviewer`, `doc-writer`, `partner`), use it to find the matching session and send the rest as the message
+- If the first word matches a known agent type (e.g., `rubber-duck`, `explore`, `general`, `architect`, `doc-writer`, `partner`), use it to find the matching session and send the rest as the message
 - Otherwise, send the entire input to the most recent child session
 
 Steps:

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { type Plugin } from "@opencode-ai/plugin";
-export { parseFrontmatter, loadAgents, loadCommands } from "./loaders";
+export { parseFrontmatter, loadAgents, loadCommands, type LoadedSkill } from "./loaders";
+export { buildSkillActivationBlock } from "./skill-activation";
 declare const SmartfrogPlugin: Plugin;
 export default SmartfrogPlugin;

package/dist/index.js

@@ -1,12 +1,14 @@
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { loadAgents, loadCommands, loadHooks, mergeHooks, } from "./loaders";
+import { loadAgents, loadCommands, loadHooks, loadSkills, mergeHooks, } from "./loaders";
 import { getGlobalHookDir, getProjectHookDir } from "./config-paths";
 import { hasCodeExtension } from "./code-files";
 import { log } from "./logger";
 import { executeBashAction, DEFAULT_BASH_TIMEOUT, } from "./bash-executor";
-import { gitingestTool, createPromptSessionTool, createListChildSessionsTool, ethTransactionTool, ethAddressTxsTool, ethAddressBalanceTool, ethTokenTransfersTool, } from "./tools";
+import { gitingestTool, createPromptSessionTool, createListChildSessionsTool, createAgentPromoteTool, createSkillTool, getPromotedAgents, ethTransactionTool, ethAddressTxsTool, ethAddressBalanceTool, ethTokenTransfersTool, } from "./tools";
 export { parseFrontmatter, loadAgents, loadCommands } from "./loaders";
+export { buildSkillActivationBlock } from "./skill-activation";
+import { buildSkillActivationBlock } from "./skill-activation";
 // ============================================================================
 // CONSTANTS
 // ============================================================================
@@ -15,23 +17,37 @@ const __dirname = dirname(__filename);
 const PLUGIN_ROOT = join(__dirname, "..");
 const AGENT_DIR = join(PLUGIN_ROOT, "agent");
 const COMMAND_DIR = join(PLUGIN_ROOT, "command");
+const SKILL_DIR = join(PLUGIN_ROOT, "skill");
 // ============================================================================
 // PLUGIN
 // ============================================================================
 const SmartfrogPlugin = async (ctx) => {
     const agents = loadAgents(AGENT_DIR);
     const commands = loadCommands(COMMAND_DIR);
+    const skills = loadSkills(SKILL_DIR);
     const globalHooks = loadHooks(getGlobalHookDir());
     const projectHooks = loadHooks(getProjectHookDir(ctx.directory));
     const hooks = mergeHooks(globalHooks, projectHooks);
     const modifiedCodeFiles = new Map();
     const pendingToolArgs = new Map();
+    const skillsWithTriggers = skills.filter(s => s.useWhen);
+    const skillActivationBlock = skillsWithTriggers.length > 0
+        ? buildSkillActivationBlock(skillsWithTriggers)
+        : null;
+    const skillTool = createSkillTool({
+        pluginSkills: skills,
+        pluginDir: PLUGIN_ROOT,
+    });
     log("[init] Plugin loaded", {
         agents: Object.keys(agents),
         commands: Object.keys(commands),
+        skills: skills.map(s => s.name),
+        skillsWithTriggers: skillsWithTriggers.map(s => s.name),
         hooks: Array.from(hooks.keys()),
         tools: [
             "gitingest",
+            "skill",
+            "agent-promote",
             "eth-transaction",
             "eth-address-txs",
             "eth-address-balance",
@@ -173,8 +189,14 @@ const SmartfrogPlugin = async (ctx) => {
     }
     return {
         config: async (config) => {
-            if (Object.keys(agents).length > 0) {
-                config.agent = { ...(config.agent ?? {}), ...agents };
+            const loadedAgents = loadAgents(AGENT_DIR);
+            for (const [name, mode] of getPromotedAgents()) {
+                if (loadedAgents[name]) {
+                    loadedAgents[name].mode = mode;
+                }
+            }
+            if (Object.keys(loadedAgents).length > 0) {
+                config.agent = { ...(config.agent ?? {}), ...loadedAgents };
             }
             if (Object.keys(commands).length > 0) {
                 config.command = { ...(config.command ?? {}), ...commands };
@@ -182,8 +204,10 @@ const SmartfrogPlugin = async (ctx) => {
         },
         tool: {
             gitingest: gitingestTool,
+            skill: skillTool,
             "prompt-session": createPromptSessionTool(ctx.client),
             "list-child-sessions": createListChildSessionsTool(ctx.client),
+            "agent-promote": createAgentPromoteTool(ctx.client, Object.keys(agents)),
             "eth-transaction": ethTransactionTool,
             "eth-address-txs": ethAddressTxsTool,
             "eth-address-balance": ethAddressBalanceTool,
@@ -256,6 +280,11 @@ const SmartfrogPlugin = async (ctx) => {
                 await triggerHooks("session.idle", sessionID, { files: files ? Array.from(files) : [] });
             }
         },
+        "experimental.chat.system.transform": async (_input, output) => {
+            if (!skillActivationBlock)
+                return;
+            output.system.push(skillActivationBlock);
+        },
     };
 };
 export default SmartfrogPlugin;

package/dist/index.test.js

@@ -4,6 +4,7 @@ import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { parseFrontmatter, loadAgents, loadSkills, loadCommands, loadHooks, mergeHooks, } from "./loaders";
 import { executeBashAction } from "./bash-executor";
+import { buildSkillActivationBlock } from "./skill-activation";
 describe("parseFrontmatter", () => {
     it("should parse valid frontmatter", () => {
         const content = `---
@@ -209,6 +210,35 @@ Content`;
         expect(result).toHaveLength(1);
         expect(result[0].name).toBe("valid");
     });
+    it("should load use_when field from frontmatter", () => {
+        const skillDir = join(testDir, "auto-skill");
+        mkdirSync(skillDir);
+        const skillContent = `---
+name: auto-skill
+description: An auto-triggered skill
+use_when: After completing a task, call this skill
+---
+
+Skill instructions here.`;
+        writeFileSync(join(skillDir, "SKILL.md"), skillContent);
+        const result = loadSkills(testDir);
+        expect(result).toHaveLength(1);
+        expect(result[0].name).toBe("auto-skill");
+        expect(result[0].useWhen).toBe("After completing a task, call this skill");
+    });
+    it("should have undefined useWhen when not provided", () => {
+        const skillDir = join(testDir, "manual-skill");
+        mkdirSync(skillDir);
+        const skillContent = `---
+name: manual-skill
+description: A manual skill
+---
+
+Content`;
+        writeFileSync(join(skillDir, "SKILL.md"), skillContent);
+        const result = loadSkills(testDir);
+        expect(result[0].useWhen).toBeUndefined();
+    });
 });
 describe("loadCommands", () => {
     let testDir;
@@ -771,6 +801,83 @@ describe("executeBashAction", () => {
         expect(parsed.tool_args).toBeUndefined();
     });
 });
+describe("buildSkillActivationBlock", () => {
+    it("should return empty string for undefined input", () => {
+        const result = buildSkillActivationBlock(undefined);
+        expect(result).toBe("");
+    });
+    it("should return empty string for empty array", () => {
+        const result = buildSkillActivationBlock([]);
+        expect(result).toBe("");
+    });
+    it("should generate imperative instruction with skill name", () => {
+        const skills = [
+            {
+                name: "code-review",
+                description: "Review code",
+                useWhen: "After writing code",
+                path: "/path/to/skill",
+                body: "",
+            },
+        ];
+        const result = buildSkillActivationBlock(skills);
+        expect(result).toContain("MANDATORY");
+        expect(result).toContain('skill({ name: "code-review" })');
+        expect(result).toContain("After writing code");
+    });
+    it("should preserve quotes in trigger text", () => {
+        const skills = [
+            {
+                name: "test-skill",
+                description: "Test",
+                useWhen: 'Call when user says "help"',
+                path: "/path",
+                body: "",
+            },
+        ];
+        const result = buildSkillActivationBlock(skills);
+        expect(result).toContain('"help"');
+    });
+    it("should collapse whitespace in trigger text", () => {
+        const skills = [
+            {
+                name: "multi-line",
+                description: "Test",
+                useWhen: "First line\nSecond line\nThird line",
+                path: "/path",
+                body: "",
+            },
+        ];
+        const result = buildSkillActivationBlock(skills);
+        expect(result).toContain("First line Second line Third line");
+    });
+    it("should trim whitespace from trigger text", () => {
+        const skills = [
+            {
+                name: "whitespace",
+                description: "Test",
+                useWhen: "  padded trigger  ",
+                path: "/path",
+                body: "",
+            },
+        ];
+        const result = buildSkillActivationBlock(skills);
+        expect(result).toContain("padded trigger");
+        expect(result).not.toContain("  padded");
+    });
+    it("should generate separate instructions for multiple skills", () => {
+        const skills = [
+            { name: "skill-a", description: "A", useWhen: "Trigger A", path: "/a", body: "" },
+            { name: "skill-b", description: "B", useWhen: "Trigger B", path: "/b", body: "" },
+        ];
+        const result = buildSkillActivationBlock(skills);
+        expect(result).toContain('skill({ name: "skill-a" })');
+        expect(result).toContain('skill({ name: "skill-b" })');
+        expect(result).toContain("Trigger A");
+        expect(result).toContain("Trigger B");
+        expect(result.match(/MANDATORY/g)).toHaveLength(2);
+    });
+});
 describe("mergeHooks", () => {
     it("should return empty map when merging empty maps", () => {
         const result = mergeHooks(new Map(), new Map());

package/dist/loaders.d.ts

@@ -12,6 +12,7 @@ export interface AgentFrontmatter {
 export interface SkillFrontmatter {
     name: string;
     description: string;
+    use_when?: string;
     license?: string;
     compatibility?: string;
     metadata?: Record<string, string>;
@@ -32,6 +33,7 @@ export interface CommandConfig {
 export interface LoadedSkill {
     name: string;
     description: string;
+    useWhen?: string;
     path: string;
     body: string;
 }

package/dist/loaders.js

@@ -68,6 +68,7 @@ export function loadSkills(skillDir) {
         skills.push({
             name: data.name || entry.name,
             description: data.description || "",
+            useWhen: data.use_when,
             path: skillPath,
             body: body.trim(),
         });

package/dist/skill-activation.d.ts

@@ -0,0 +1,2 @@
+import { type LoadedSkill } from "./loaders";
+export declare function buildSkillActivationBlock(skills: LoadedSkill[]): string;

package/dist/skill-activation.js

@@ -0,0 +1,11 @@
+function formatTrigger(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+function buildSkillInstruction(skill) {
+    return `MANDATORY: Call skill({ name: "${skill.name}" }) ${formatTrigger(skill.useWhen)}`;
+}
+export function buildSkillActivationBlock(skills) {
+    if (!Array.isArray(skills) || skills.length === 0)
+        return "";
+    return skills.map(buildSkillInstruction).join("\n\n");
+}

package/dist/tools/agent-promote-core.d.ts

@@ -0,0 +1,6 @@
+export type AgentMode = "subagent" | "primary" | "all";
+export declare const VALID_GRADES: AgentMode[];
+export declare function getPromotedAgents(): ReadonlyMap<string, AgentMode>;
+export declare function setPromotedAgent(name: string, mode: AgentMode): void;
+export declare function validateGrade(grade: string): grade is AgentMode;
+export declare function validateAgentName(name: string, pluginAgentNames: string[]): boolean;

package/dist/tools/agent-promote-core.js

@@ -0,0 +1,14 @@
+export const VALID_GRADES = ["subagent", "primary", "all"];
+const promotedAgents = new Map();
+export function getPromotedAgents() {
+    return promotedAgents;
+}
+export function setPromotedAgent(name, mode) {
+    promotedAgents.set(name, mode);
+}
+export function validateGrade(grade) {
+    return VALID_GRADES.includes(grade);
+}
+export function validateAgentName(name, pluginAgentNames) {
+    return pluginAgentNames.includes(name);
+}

package/dist/tools/agent-promote.d.ts

@@ -0,0 +1,19 @@
+import { type ToolContext } from "@opencode-ai/plugin";
+import type { createOpencodeClient } from "@opencode-ai/sdk";
+export { type AgentMode, VALID_GRADES, getPromotedAgents, setPromotedAgent, validateGrade, validateAgentName, } from "./agent-promote-core";
+type Client = ReturnType<typeof createOpencodeClient>;
+export interface AgentPromoteArgs {
+    name: string;
+    grade?: string;
+}
+export declare function createAgentPromoteTool(client: Client, pluginAgentNames: string[]): {
+    description: string;
+    args: {
+        name: import("zod").ZodString;
+        grade: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    execute(args: {
+        name: string;
+        grade?: string | undefined;
+    }, context: ToolContext): Promise<string>;
+};