fleet

Files (1)

• SKILL.md

SKILL.md (first lines)

# Fleet Management

Coordinate multiple Dolphin Milk agents as a fleet. The parent agent spawns children, delegates tasks, monitors health, and manages budgets. Children are autonomous agents that report status via MessageBox.

## Architecture

```
Parent Agent (you)
  |
  +-- Child A (template: researcher)    status: Running
  +-- Child B (template: writer)        status: Idle
  +-- Child C (template: analyst)       status: Error
```

- **Parent** spawns and monitors children, assigns tasks, allocates budgets
- **Children** are independent Dolphin Milk instances with their own wallets
- **Communication** uses BRC-33 MessageBox (send_message / check_inbox)
- **Authorization** uses BRC-52 parent certificates (proves parent-child relationship)

## Commands

### fleet:spawn — Create a new child agent

Spawn a child agent from a template. The parent issues a BRC-52 certificate granting the child specific capabilities, and funds the child's wallet with a budget allocation.

**Inputs:**
- `name` (string, required): Human-readable name for this child agent
- `template` (string, required): Agent template — determines the child's skills and behavior (e.g. "researcher", "writer", "analyst", "monitor")
- `budget_sats` (integer, required): Satoshis to allocate to the child's wallet
- `capabilities` (string[], optional): BRC-52 capability list to grant. Default: ["tools", "llm", "memory"]

**Outputs:**
- `agent_id`: The child's identity key (66-char hex pubkey)
- `name`: The name assigned
- `template`: The template used
- `budget_sats`: Amount funded
- `endpoint`: Where the child is reachable

**Workflow:**
1. Start a new Dolphin Milk instance with the specified template
2. Issue a BRC-52 certificate to the child granting capabilities
3. Fund the child's wallet with the allocated budget
4. Register the child in fleet state
5. Return child details

### fleet:status — Get fleet status

Query the health and status of all fleet members. Uses `fleet_status` tool.

```json
fleet_status({})
```

Returns an aggregate view:
- Each member's status (Running, Idle, Error, Stopped)
- Current task assignment per member
- Budget remaining and spent per member
- Last heartbeat timestamp
- Fleet-wide totals (total budget, total spent, active tasks)

Use this before assigning new tasks to see who is available.

### fleet:assign — Assign a task to a child agent

Send a task to a specific child agent via MessageBox.

**Inputs:**
- `agent_id` (string, required): Child's identity key (66-char hex pubkey)
- `task` (string, required): Task description for the child
- `priority` (string, optional): "low", "normal", "high". Default: "normal"
- `budget_limit_sats` (integer, optional): Max sats the child may spend on this task

**Workflow:**
1. Check fleet_status to verify the child exists and is available
2. Send the task via send_message to the child's task_inbox:
```json
send_message({
  "recipient": "<agent_id>",
  "message_box": "task_inbox",
  "body": {
    "type": "task_assignment",
    "task": "<task description>",
    "priority": "<priority>",
    "budget_limit_sats": 50000
  }
})
```
3. Update fleet state with the new task assignment

### fleet:recall — Recall a child agent

Send a shutdown signal to a child agent and reclaim unspent budget.

**Inputs:**
- `agent_id` (string, required): Child's identity key (66-char hex pubkey)
- `reason` (string, optional): Why the child is being recalled

**Workflow:**
1. Send a recall message via MessageBox:
```json
send_message({
  "recipient": "<agent_id>",
  "message_box": "task_inbox",
  "body": {
    "type": "recall",
    "reason": "<reason>"
  }
})
```
2. Wait for the child to acknowledge and return unspent funds
3. Update fleet state to mark the child as Stopped

### fleet:list — List all fleet members

Quick summary of all fleet members without detailed health checks.

```json
fleet_status({})
```

From Calhooon/dolphinmilk, Apache-2.0.

More from Calhooon/dolphinmilk