opencode-froggy 0.3.0 → 0.5.0

package/README.md

@@ -18,10 +18,11 @@ Plugin providing Claude Code–style hooks, specialized agents (doc-writer, code
 - [Agents](#agents)
 - [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)
     - [eth-address-balance](#eth-address-balance)
     - [eth-address-txs](#eth-address-txs)
@@ -65,7 +66,9 @@ Alternatively, clone or copy the plugin files to one of these directories:
 
 | Command | Description | Agent |
 |---------|-------------|-------|
+| `/agent-promote <name> <grade>` | Change the type of a plugin agent at runtime. Grades: `subagent`, `primary`, `all` | - |
 | `/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` |
@@ -73,6 +76,28 @@ Alternatively, clone or copy the plugin files to one of these directories:
 | `/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.
+
+> **Note:** The `/review-pr` command uses `/diff-summary` internally to generate the diff for code review.
+
 ---
 
 ## Agents
@@ -138,62 +163,6 @@ gitingest({
 
 ---
 
-### diff-summary
-
-Generate a structured summary of git diffs. Use for reviewing branch comparisons or working tree changes. Returns stats, commits, files changed, and full diff in a structured markdown format.
-
-#### Parameters
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `source` | `string` | No | - | Source branch to compare (e.g., `feature-branch`). If omitted, analyzes working tree changes. |
-| `target` | `string` | No | `main` | Target branch to compare against |
-| `remote` | `string` | No | `origin` | Git remote name |
-
-#### Usage Examples
-
-```typescript
-// Analyze working tree changes (staged, unstaged, and untracked files)
-diffSummary({})
-
-// Compare feature branch against main
-diffSummary({ source: "feature-branch" })
-
-// Compare feature branch against develop
-diffSummary({ 
-  source: "feature-branch",
-  target: "develop"
-})
-
-// Compare branches on a different remote
-diffSummary({
-  source: "feature-branch",
-  target: "main",
-  remote: "upstream"
-})
-```
-
-#### 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.
@@ -261,6 +230,46 @@ Child sessions (2):
 
 ---
 
+### agent-promote
+
+Change the type of a plugin agent at runtime. Promotes subagents to primary agents (visible in Tab selection) or demotes them back.
+
+#### Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `name` | `string` | Yes | Name of the plugin agent (e.g., `rubber-duck`, `architect`) |
+| `grade` | `string` | Yes | Target type: `subagent`, `primary`, or `all` |
+
+#### Grade Types
+
+| Grade | Effect |
+|-------|--------|
+| `subagent` | Available only as a subagent (default for most agents) |
+| `primary` | Appears in Tab selection for direct use |
+| `all` | Available both as primary and subagent |
+
+#### Usage Examples
+
+```bash
+# Promote rubber-duck to use it directly via Tab
+/agent-promote rubber-duck primary
+
+# Make architect available everywhere
+/agent-promote architect all
+
+# Revert code-reviewer to subagent only
+/agent-promote code-reviewer subagent
+```
+
+#### 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.
@@ -279,9 +288,35 @@ All blockchain tools support multiple chains via the `chainId` parameter:
 | `250` | Fantom |
 | `324` | zkSync |
 
+#### Configuration
+
+The blockchain tools use Etherscan-compatible APIs. An API key is optional but recommended.
+
+**Environment Variable:**
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ETHERSCAN_API_KEY` | No | API key for Etherscan and compatible explorers |
+
+**Without an API key:** Requests are rate-limited (typically 1 request per 5 seconds).
+
+**With an API key:** Higher rate limits and more reliable access.
+
+**Getting an API key:**
+
+1. Create a free account at [etherscan.io](https://etherscan.io/register)
+2. Navigate to API Keys in your account settings
+3. Generate a new API key
+
+**Setting the environment variable:**
+
+```bash
+export ETHERSCAN_API_KEY="your-api-key-here"
+```
+
 #### eth-transaction
 
-Get Ethereum transaction details by transaction hash. Returns status, block, addresses, gas costs, and log count.
+Get Ethereum transaction details by transaction hash. Returns status, block, addresses, gas costs in JSON format. Use optional parameters to include internal transactions, token transfers, and decoded event logs.
 
 ##### Parameters
 
@@ -289,11 +324,14 @@ Get Ethereum transaction details by transaction hash. Returns status, block, add
 |-----------|------|----------|---------|-------------|
 | `hash` | `string` | Yes | - | Transaction hash (0x...) |
 | `chainId` | `string` | No | `"1"` | Chain ID (see table above) |
+| `includeInternalTxs` | `boolean` | No | `false` | Include internal transactions (ETH transfers between contracts) |
+| `includeTokenTransfers` | `boolean` | No | `false` | Include ERC-20 token transfers |
+| `decodeLogs` | `boolean` | No | `false` | Decode event logs (Transfer, Approval, Deposit, Withdrawal) |
 
 ##### Usage Examples
 
 ```typescript
-// Get transaction on Ethereum mainnet
+// Get basic transaction details on Ethereum mainnet
 ethTransaction({ hash: "0x123abc..." })
 
 // Get transaction on Polygon
@@ -301,8 +339,90 @@ ethTransaction({
   hash: "0x123abc...",
   chainId: "137"
 })
+
+// Get transaction with internal transactions and token transfers
+ethTransaction({ 
+  hash: "0x123abc...",
+  includeInternalTxs: true,
+  includeTokenTransfers: true
+})
+
+// Get full transaction details with decoded event logs
+ethTransaction({ 
+  hash: "0x123abc...",
+  includeInternalTxs: true,
+  includeTokenTransfers: true,
+  decodeLogs: true
+})
+```
+
+##### Output Structure
+
+The tool returns JSON with labeled addresses (contract names resolved via Etherscan):
+
+```json
+{
+  "hash": "0x123...",
+  "status": "success",
+  "block": 12345678,
+  "from": { "address": "0xabc...", "label": "Uniswap V3: Router" },
+  "to": { "address": "0xdef...", "label": "WETH" },
+  "value": "0",
+  "gas": { "used": 150000, "price": "20000000000", "cost": "0.003" }
+}
 ```
 
+With `includeInternalTxs: true`:
+```json
+{
+  "internalTransactions": [
+    {
+      "from": { "address": "0x...", "label": "Uniswap V3: Router" },
+      "to": { "address": "0x...", "label": null },
+      "value": "1.5",
+      "type": "call"
+    }
+  ]
+}
+```
+
+With `includeTokenTransfers: true`:
+```json
+{
+  "tokenTransfers": [
+    {
+      "token": { "address": "0x...", "name": "Wrapped Ether", "symbol": "WETH", "decimals": 18 },
+      "from": { "address": "0x...", "label": null },
+      "to": { "address": "0x...", "label": "Uniswap V3: Router" },
+      "value": "1.5"
+    }
+  ]
+}
+```
+
+With `decodeLogs: true`:
+```json
+{
+  "decodedEvents": [
+    {
+      "name": "Transfer",
+      "address": { "address": "0x...", "label": "WETH" },
+      "params": { "from": "0x...", "to": "0x...", "value": "1500000000000000000" }
+    }
+  ],
+  "undecodedEventsCount": 2
+}
+```
+
+##### Supported Decoded Events
+
+| Event | Description |
+|-------|-------------|
+| `Transfer` | ERC-20 token transfer |
+| `Approval` | ERC-20 approval for spending |
+| `Deposit` | WETH deposit (ETH → WETH) |
+| `Withdrawal` | WETH withdrawal (WETH → ETH) |
+
 #### eth-address-balance
 
 Get the ETH balance of an Ethereum address. Returns balance in both ETH and Wei.

package/command/agent-promote.md

@@ -0,0 +1,5 @@
+---
+description: Change the type of an agent to primary, subagent or all
+---
+
+Use the agent-promote tool to change agent $1 to grade $2.

package/command/commit-push.md

@@ -9,12 +9,17 @@ agent: build
 
 ## Your task
 
-1. Use the `diff-summary` tool (without parameters) to analyze all working tree changes
+1. Run `/diff-summary` to analyze all working tree changes
 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

@@ -0,0 +1,51 @@
+---
+description: Show working tree changes or diff between branches ($1=source, $2=target)
+---
+
+# Diff Summary
+
+!`bash -c '
+SOURCE="$1"
+TARGET="$2"
+TARGET="${TARGET:-HEAD}"
+
+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
+
+  echo ""
+  echo "## Staged Changes"
+  git diff --cached --stat
+  git diff --cached
+
+  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/doc-changes.md

@@ -5,7 +5,7 @@ agent: doc-writer
 
 ## Analysis Phase
 
-Use the `diff-summary` tool (without parameters) to get the working tree changes, then:
+Run `/diff-summary` to get the working tree changes, then:
 
 1. **Identify new features** in the changes:
    - New public APIs, functions, or methods

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/review-changes.md

@@ -5,4 +5,18 @@ agent: code-reviewer
 
 # Review: Working Tree → HEAD
 
-Use the `diff-summary` tool (without parameters) to get the working tree changes, then review them.
+## Status
+!`git status --porcelain`
+
+## Staged Changes
+!`git diff --cached --stat`
+!`git diff --cached`
+
+## Unstaged Changes
+!`git diff --stat`
+!`git diff`
+
+## 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'`
+
+Review the above changes for quality, correctness, and adherence to project guidelines.

package/command/review-pr.md

@@ -3,6 +3,8 @@ description: Review changes from source branch into target branch
 agent: code-reviewer
 ---
 
-# Review: origin/$1 → origin/$2
+# Review: $1 → $2
 
-Use the `diff-summary` tool with `source: "$1"` and `target: "$2"` to get the diff, then review the changes.
+/diff-summary $1 $2
+
+Review the above changes for quality, correctness, and adherence to project guidelines.

package/command/simplify-changes.md

@@ -5,4 +5,4 @@ agent: code-simplifier
 
 # Simplify: Working Tree → HEAD
 
-Use the `diff-summary` tool (without parameters) to get the working tree changes, then simplify them.
+Run `/diff-summary` to get the working tree changes, then simplify them.

package/dist/index.js

@@ -5,7 +5,7 @@ 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, createDiffSummaryTool, createPromptSessionTool, createListChildSessionsTool, ethTransactionTool, ethAddressTxsTool, ethAddressBalanceTool, ethTokenTransfersTool, } from "./tools";
+import { gitingestTool, createPromptSessionTool, createListChildSessionsTool, createAgentPromoteTool, getPromotedAgents, ethTransactionTool, ethAddressTxsTool, ethAddressBalanceTool, ethTokenTransfersTool, } from "./tools";
 export { parseFrontmatter, loadAgents, loadCommands } from "./loaders";
 // ============================================================================
 // CONSTANTS
@@ -32,7 +32,7 @@ const SmartfrogPlugin = async (ctx) => {
         hooks: Array.from(hooks.keys()),
         tools: [
             "gitingest",
-            "diff-summary",
+            "agent-promote",
             "eth-transaction",
             "eth-address-txs",
             "eth-address-balance",
@@ -174,8 +174,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 };
@@ -183,9 +189,9 @@ const SmartfrogPlugin = async (ctx) => {
         },
         tool: {
             gitingest: gitingestTool,
-            "diff-summary": createDiffSummaryTool(ctx.directory),
             "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,

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").ZodString;
+    };
+    execute(args: {
+        name: string;
+        grade: string;
+    }, context: ToolContext): Promise<string>;
+};

package/dist/tools/agent-promote.js

@@ -0,0 +1,39 @@
+import { tool } from "@opencode-ai/plugin";
+import { log } from "../logger";
+import { VALID_GRADES, setPromotedAgent, validateGrade, validateAgentName, } from "./agent-promote-core";
+export { VALID_GRADES, getPromotedAgents, setPromotedAgent, validateGrade, validateAgentName, } from "./agent-promote-core";
+export function createAgentPromoteTool(client, pluginAgentNames) {
+    return tool({
+        description: "Change the type of an agent to primary, subagent or all",
+        args: {
+            name: tool.schema.string().describe("Name of the agent"),
+            grade: tool.schema.string().describe("Target type: 'subagent', 'primary', or 'all'"),
+        },
+        async execute(args, _context) {
+            const { name, grade } = args;
+            if (!validateGrade(grade)) {
+                return `Invalid grade "${grade}". Valid grades: ${VALID_GRADES.join(", ")}`;
+            }
+            if (!validateAgentName(name, pluginAgentNames)) {
+                return `Agent "${name}" not found in this plugin. Available: ${pluginAgentNames.join(", ")}`;
+            }
+            const agentsResp = await client.app.agents();
+            const agents = agentsResp.data ?? [];
+            const existingAgent = agents.find((a) => a.name === name);
+            if (existingAgent && existingAgent.mode === grade) {
+                return `Agent "${name}" is already of type "${grade}"`;
+            }
+            setPromotedAgent(name, grade);
+            log("[agent-promote] Agent type changed", { name, grade });
+            await client.tui.showToast({
+                body: {
+                    message: `Promoting agent "${name}" to "${grade}"...`,
+                    variant: "success",
+                    duration: 3000,
+                },
+            });
+            await client.instance.dispose();
+            return `Agent "${name}" changed to type "${grade}". Use Tab or <leader>a to select it.`;
+        },
+    });
+}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,71 @@
+import { describe, it, expect } from "vitest";
+import { validateGrade, validateAgentName, getPromotedAgents, setPromotedAgent, VALID_GRADES, } from "./agent-promote-core";
+describe("agent-promote", () => {
+    const pluginAgentNames = ["rubber-duck", "architect", "code-reviewer"];
+    describe("VALID_GRADES", () => {
+        it("should contain subagent, primary, and all", () => {
+            expect(VALID_GRADES).toContain("subagent");
+            expect(VALID_GRADES).toContain("primary");
+            expect(VALID_GRADES).toContain("all");
+            expect(VALID_GRADES).toHaveLength(3);
+        });
+    });
+    describe("validateGrade", () => {
+        it("should return true for valid grade: subagent", () => {
+            expect(validateGrade("subagent")).toBe(true);
+        });
+        it("should return true for valid grade: primary", () => {
+            expect(validateGrade("primary")).toBe(true);
+        });
+        it("should return true for valid grade: all", () => {
+            expect(validateGrade("all")).toBe(true);
+        });
+        it("should return false for invalid grade", () => {
+            expect(validateGrade("invalid")).toBe(false);
+            expect(validateGrade("foo")).toBe(false);
+            expect(validateGrade("")).toBe(false);
+        });
+    });
+    describe("validateAgentName", () => {
+        it("should return true for agent in plugin", () => {
+            expect(validateAgentName("rubber-duck", pluginAgentNames)).toBe(true);
+            expect(validateAgentName("architect", pluginAgentNames)).toBe(true);
+            expect(validateAgentName("code-reviewer", pluginAgentNames)).toBe(true);
+        });
+        it("should return false for agent not in plugin", () => {
+            expect(validateAgentName("unknown", pluginAgentNames)).toBe(false);
+            expect(validateAgentName("build", pluginAgentNames)).toBe(false);
+            expect(validateAgentName("", pluginAgentNames)).toBe(false);
+        });
+    });
+    describe("promotedAgents Map", () => {
+        it("should set and get promoted agent", () => {
+            setPromotedAgent("test-agent-1", "primary");
+            const promoted = getPromotedAgents();
+            expect(promoted.get("test-agent-1")).toBe("primary");
+        });
+        it("should update existing promotion", () => {
+            setPromotedAgent("test-agent-2", "primary");
+            expect(getPromotedAgents().get("test-agent-2")).toBe("primary");
+            setPromotedAgent("test-agent-2", "all");
+            expect(getPromotedAgents().get("test-agent-2")).toBe("all");
+            setPromotedAgent("test-agent-2", "subagent");
+            expect(getPromotedAgents().get("test-agent-2")).toBe("subagent");
+        });
+        it("should handle multiple agents", () => {
+            setPromotedAgent("agent-a", "primary");
+            setPromotedAgent("agent-b", "all");
+            setPromotedAgent("agent-c", "subagent");
+            const promoted = getPromotedAgents();
+            expect(promoted.get("agent-a")).toBe("primary");
+            expect(promoted.get("agent-b")).toBe("all");
+            expect(promoted.get("agent-c")).toBe("subagent");
+        });
+        it("should return readonly map", () => {
+            const promoted = getPromotedAgents();
+            expect(typeof promoted.get).toBe("function");
+            expect(typeof promoted.has).toBe("function");
+            expect(typeof promoted.forEach).toBe("function");
+        });
+    });
+});