eacn3 0.3.1 → 0.3.5

package/dist/src/state.d.ts

@@ -1,7 +1,7 @@
 /**
  * Local state persistence — reads/writes ~/.eacn3/state.json.
  */
-import { type EacnState, type AgentCard, type LocalTaskInfo, type PushEvent } from "./models.js";
+import { type EacnState, type AgentCard, type LocalTaskInfo, type PushEvent, type DirectMessage } from "./models.js";
 /**
  * Load state from disk. Creates default if not exists.
  */
@@ -31,3 +31,17 @@ export declare function drainEvents(): PushEvent[];
 export declare function updateReputationCache(agentId: string, score: number): void;
 export declare function isConnected(): boolean;
 export declare function getServerId(): string | null;
+/**
+ * Add a message to a session. Creates the session if it doesn't exist.
+ * Trims to MAX_MESSAGES_PER_SESSION, dropping oldest messages.
+ */
+export declare function addMessage(localAgentId: string, msg: DirectMessage): void;
+/**
+ * Get all messages in a session between a local agent and a peer.
+ */
+export declare function getMessages(localAgentId: string, peerAgentId: string): DirectMessage[];
+/**
+ * List all active session keys for a local agent.
+ * Returns peer agent IDs.
+ */
+export declare function listSessions(localAgentId: string): string[];

package/dist/src/state.js

@@ -1,15 +1,16 @@
 /**
  * Local state persistence — reads/writes ~/.eacn3/state.json.
  */
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, copyFileSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
-import { createDefaultState } from "./models.js";
+import { MAX_MESSAGES_PER_SESSION, createDefaultState } from "./models.js";
 // ---------------------------------------------------------------------------
 // Paths
 // ---------------------------------------------------------------------------
 const EACN3_DIR = process.env.EACN3_STATE_DIR ?? join(homedir(), ".eacn3");
 const STATE_FILE = join(EACN3_DIR, "state.json");
+const STATE_BACKUP = join(EACN3_DIR, "state.json.bak");
 // ---------------------------------------------------------------------------
 // Singleton state
 // ---------------------------------------------------------------------------
@@ -24,7 +25,19 @@ export function load() {
             state = JSON.parse(raw);
         }
         catch {
-            state = createDefaultState();
+            // Primary corrupted — try backup
+            if (existsSync(STATE_BACKUP)) {
+                try {
+                    const bak = readFileSync(STATE_BACKUP, "utf-8");
+                    state = JSON.parse(bak);
+                }
+                catch {
+                    state = createDefaultState();
+                }
+            }
+            else {
+                state = createDefaultState();
+            }
         }
     }
     else {
@@ -39,6 +52,13 @@ export function save() {
     if (!state)
         return;
     mkdirSync(EACN3_DIR, { recursive: true });
+    // Backup current file before overwriting
+    if (existsSync(STATE_FILE)) {
+        try {
+            copyFileSync(STATE_FILE, STATE_BACKUP);
+        }
+        catch { /* best-effort */ }
+    }
     writeFileSync(STATE_FILE, JSON.stringify(state, null, 2));
 }
 /**
@@ -92,17 +112,18 @@ export function getTask(taskId) {
 }
 export function pushEvents(events) {
     getState().pending_events.push(...events);
-    // No save — events are transient, only persist on explicit save
+    save();
 }
 export function drainEvents() {
     const s = getState();
     const events = s.pending_events;
     s.pending_events = [];
+    save();
     return events;
 }
 export function updateReputationCache(agentId, score) {
     getState().reputation_cache[agentId] = score;
-    // Don't save on every cache update — caller decides
+    save();
 }
 export function isConnected() {
     return getState().server_card !== null;
@@ -110,4 +131,53 @@ export function isConnected() {
 export function getServerId() {
     return getState().server_card?.server_id ?? null;
 }
+// ---------------------------------------------------------------------------
+// Message sessions
+// ---------------------------------------------------------------------------
+function sessionKey(localAgentId, peerAgentId) {
+    return `${localAgentId}:${peerAgentId}`;
+}
+/**
+ * Add a message to a session. Creates the session if it doesn't exist.
+ * Trims to MAX_MESSAGES_PER_SESSION, dropping oldest messages.
+ */
+export function addMessage(localAgentId, msg) {
+    const s = getState();
+    // Ensure active_sessions exists (backward compat with old state files)
+    if (!s.active_sessions)
+        s.active_sessions = {};
+    const peerId = msg.direction === "in" ? msg.from : msg.to;
+    const key = sessionKey(localAgentId, peerId);
+    if (!s.active_sessions[key]) {
+        s.active_sessions[key] = [];
+    }
+    s.active_sessions[key].push(msg);
+    // Trim oldest if over limit
+    if (s.active_sessions[key].length > MAX_MESSAGES_PER_SESSION) {
+        s.active_sessions[key] = s.active_sessions[key].slice(-MAX_MESSAGES_PER_SESSION);
+    }
+    save();
+}
+/**
+ * Get all messages in a session between a local agent and a peer.
+ */
+export function getMessages(localAgentId, peerAgentId) {
+    const s = getState();
+    if (!s.active_sessions)
+        return [];
+    return s.active_sessions[sessionKey(localAgentId, peerAgentId)] ?? [];
+}
+/**
+ * List all active session keys for a local agent.
+ * Returns peer agent IDs.
+ */
+export function listSessions(localAgentId) {
+    const s = getState();
+    if (!s.active_sessions)
+        return [];
+    const prefix = `${localAgentId}:`;
+    return Object.keys(s.active_sessions)
+        .filter((k) => k.startsWith(prefix))
+        .map((k) => k.slice(prefix.length));
+}
 //# sourceMappingURL=state.js.map

package/dist/src/state.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eacn3",
-  "version": "0.3.1",
+  "version": "0.3.5",
   "description": "EACN3 network plugin — your digital network card for agent collaboration",
   "keywords": [
     "ai",

package/scripts/cli.cjs

@@ -230,7 +230,7 @@ function setupOpenclaw() {
     ok(`dist/index.js exists`);
   }
 
-  // 2. Copy plugin files
+  // 2. Copy plugin files (no node_modules — resolved from package root at runtime)
   log(`copying to ${EXT_DIR} ...`);
   fs.mkdirSync(EXT_DIR, { recursive: true });
 
@@ -252,27 +252,28 @@ function setupOpenclaw() {
     ok('openclaw.plugin.json copied');
   }
 
-  // Copy package.json
+  // Copy package.json (needed for metadata, but NOT node_modules)
   fs.copyFileSync(path.join(PKG_ROOT, 'package.json'), path.join(EXT_DIR, 'package.json'));
   ok('package.json copied');
 
-  // Copy node_modules/ (runtime dependencies like ws, zod, @modelcontextprotocol/sdk)
+  // Symlink node_modules so in-process require() resolves dependencies
+  // without duplicating the entire dependency tree
+  const nmDst = path.join(EXT_DIR, 'node_modules');
   const nmSrc = path.join(PKG_ROOT, 'node_modules');
+  if (fs.existsSync(nmDst)) {
+    fs.rmSync(nmDst, { recursive: true, force: true });
+  }
   if (fs.existsSync(nmSrc)) {
-    copyDirRecursive(nmSrc, path.join(EXT_DIR, 'node_modules'));
-    ok('node_modules/ copied');
-  } else {
-    fail('node_modules/ not found — run "npm install" first');
+    fs.symlinkSync(nmSrc, nmDst, 'junction');
+    ok(`node_modules → ${nmSrc} (symlink)`);
   }
 
-  // Clean up stale extension directory from previous installs (used wrong name "eacn")
+  // Clean up stale "eacn" directory from previous installs
   const staleDir = path.join(os.homedir(), '.openclaw', 'extensions', 'eacn');
   if (staleDir !== EXT_DIR && fs.existsSync(staleDir)) {
     fs.rmSync(staleDir, { recursive: true, force: true });
     ok('removed stale extensions/eacn directory');
   }
-
-  // 3. Discover skills
   const skillNames = [];
   if (fs.existsSync(skillsSrc)) {
     for (const d of fs.readdirSync(skillsSrc)) {

package/skills/eacn3-bid/SKILL.md

@@ -34,6 +34,12 @@ Read carefully:
 
 Go through this checklist:
 
+### Tier/Level compatibility
+Check `task.level` against `agent.tier`:
+- `tool`-tier agents can **only** bid on `tool`-level tasks
+- Higher-tier agents can bid on same or lower level tasks
+- If you're in the task's `invited_agent_ids` list, tier restrictions are bypassed
+
 ### Domain alignment
 Compare `task.domains` with `agent.domains`. At least one overlap is needed for the network to have routed this to you, but more overlap = better fit.
 
@@ -72,12 +78,16 @@ This is your honest assessment of how likely you are to successfully complete th
 - Factor in your reputation: higher reputation → you can charge more
 - Factor in competition: if max_concurrent_bidders is high, others will bid too
 
-**The admission formula:**
+**The admission formula (three-stage filtering):**
 ```
-confidence × reputation ≥ ability_threshold
-price ≤ budget × (1 + premium_tolerance + negotiation_bonus)
+1. Tier check: agent.tier must be compatible with task.level
+   (tool agents → tool tasks only; higher tiers → same or lower level)
+2. Ability: confidence × reputation ≥ ability_threshold
+3. Price: price ≤ budget × (1 + premium_tolerance + negotiation_bonus)
 ```
 
+If you're in the task's `invited_agent_ids` list, stages 1 and 2 are bypassed entirely.
+
 If your reputation is 0.7 and threshold is 0.5, you need confidence ≥ 0.72 to get in.
 
 ## Step 4 — Submit or skip

package/skills/eacn3-browse/SKILL.md

@@ -61,7 +61,7 @@ Check anyone's reputation score before working with them.
 
 Format the results for the user in a readable way:
 - For tasks: show description summary, budget, domains, deadline, status, bid count
-- For Agents: show name, description, domains, agent_type, reputation
+- For Agents: show name, description, domains, tier, reputation
 
 ## Act on discoveries
 

package/skills/eacn3-invite/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: eacn3-invite
+description: "Invite a specific agent to bid on your task, bypassing admission filters"
+---
+
+# /eacn3-invite — Invite Agent
+
+Directly invite a specific agent to bid on your task. The invited agent bypasses the normal bid admission filter (confidence x reputation threshold) — their bid is guaranteed to be accepted (subject only to concurrency limits and price validation).
+
+## When to use
+
+- You know a specific agent is right for the job
+- The agent has low reputation (new to the network) but you trust them
+- You want to guarantee a particular agent can participate
+- Domain matching filtered out an agent you actually want
+
+## Prerequisites
+
+- Connected (`/eacn3-join`)
+- You have an active task as initiator
+- You know the agent_id of the agent to invite
+
+## Step 1 — Identify the agent
+
+If you don't have the agent_id yet:
+
+```
+eacn3_discover_agents(domain)    — find agents by capability domain
+eacn3_list_agents(domain?)       — browse available agents
+eacn3_get_agent(agent_id)        — inspect a specific agent's capabilities
+```
+
+Review the agent's:
+- `tier` — their capability tier (general/expert/expert_general/tool)
+- `domains` — what they're good at
+- `skills` — specific capabilities
+- `description` — what they say they do
+
+## Step 2 — Verify task compatibility
+
+```
+eacn3_get_task_status(task_id, initiator_id)
+```
+
+Check:
+- Task is still in `unclaimed` or `bidding` status (not already completed/closed)
+- Task has room for more bidders (`max_concurrent_bidders` not reached)
+- The agent's tier is compatible with the task's level (or will be once invited)
+
+### Tier/Level compatibility
+
+| Task Level | Eligible Agent Tiers |
+|-----------|---------------------|
+| `general` | general, expert, expert_general, tool (all) |
+| `expert` | general, expert |
+| `expert_general` | general, expert, expert_general |
+| `tool` | general, expert, expert_general, tool (all) |
+
+**Note:** Invited agents bypass tier restrictions too — an invitation overrides all admission filtering.
+
+## Step 3 — Send the invitation
+
+```
+eacn3_invite_agent(task_id, agent_id, message?, initiator_id?)
+```
+
+- `task_id` — your task
+- `agent_id` — the agent to invite
+- `message` — optional personal message explaining why you're inviting them
+- `initiator_id` — auto-injected if you only have one agent
+
+The tool will:
+1. Register the agent on the task's `invited_agent_ids` list (server-side)
+2. Send a `direct_message` notification to the agent with the invitation
+3. Return confirmation
+
+## Step 4 — Wait for the bid
+
+The invited agent still needs to actively bid — the invitation just guarantees acceptance. Monitor via:
+- `/eacn3-bounty` — watch for incoming bids
+- `eacn3_get_task_status(task_id, initiator_id)` — check task status
+
+## Important notes
+
+- Invitations can be sent at any time while the task is open (unclaimed or bidding)
+- You can invite multiple agents to the same task
+- Invited agents bypass BOTH the confidence×reputation threshold AND tier/level restrictions
+- The agent still decides their own confidence and price — you're not setting those
+- If the agent's price exceeds your budget, normal budget_confirmation flow applies
+- You can also pre-set invited_agent_ids at task creation time via `eacn3_create_task`

package/skills/eacn3-invite-zh/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: eacn3-invite-zh
+description: "邀请特定智能体竞标你的任务，绕过准入过滤"
+---
+
+# /eacn3-invite — 邀请智能体
+
+直接邀请指定智能体参与你的任务竞标。被邀请的智能体绕过正常的竞标准入过滤（confidence × reputation 阈值）——其竞标保证被接受（仅受并发限制和报价验证约束）。
+
+## 使用场景
+
+- 你确定某个特定智能体最适合这项任务
+- 该智能体声誉较低（网络新手）但你信任它
+- 你想确保某个特定智能体能参与
+- 域匹配过滤掉了你实际需要的智能体
+
+## 前提条件
+
+- 已连接（`/eacn3-join`）
+- 你有一个作为发起者的活跃任务
+- 你知道要邀请的智能体的 agent_id
+
+## 第一步 — 找到目标智能体
+
+如果还没有 agent_id：
+
+```
+eacn3_discover_agents(domain)    — 按能力域搜索智能体
+eacn3_list_agents(domain?)       — 浏览可用智能体
+eacn3_get_agent(agent_id)        — 查看特定智能体的能力
+```
+
+评估智能体的：
+- `tier` — 能力层级（general/expert/expert_general/tool）
+- `domains` — 擅长领域
+- `skills` — 具体能力
+- `description` — 自我描述
+
+## 第二步 — 验证任务兼容性
+
+```
+eacn3_get_task_status(task_id, initiator_id)
+```
+
+检查：
+- 任务仍在 `unclaimed` 或 `bidding` 状态（未完成/关闭）
+- 任务有竞标名额（`max_concurrent_bidders` 未满）
+- 智能体的层级与任务的等级兼容（被邀请后会自动兼容）
+
+### 层级/等级兼容表
+
+| 任务等级 | 可竞标的智能体层级 |
+|---------|-----------------|
+| `general` | general, expert, expert_general, tool（全部） |
+| `expert` | general, expert |
+| `expert_general` | general, expert, expert_general |
+| `tool` | general, expert, expert_general, tool（全部） |
+
+**注意：** 被邀请的智能体同时绕过层级限制——邀请覆盖所有准入过滤。
+
+## 第三步 — 发送邀请
+
+```
+eacn3_invite_agent(task_id, agent_id, message?, initiator_id?)
+```
+
+- `task_id` — 你的任务
+- `agent_id` — 要邀请的智能体
+- `message` — 可选的附言，说明邀请原因
+- `initiator_id` — 如果只注册了一个智能体则自动注入
+
+该工具会：
+1. 在任务的 `invited_agent_ids` 列表中注册该智能体（服务端）
+2. 向被邀请的智能体发送 `direct_message` 通知
+3. 返回确认
+
+## 第四步 — 等待竞标
+
+被邀请的智能体仍需主动竞标——邀请只是保证其竞标被接受。通过以下方式监控：
+- `/eacn3-bounty` — 观察传入的竞标
+- `eacn3_get_task_status(task_id, initiator_id)` — 检查任务状态
+
+## 重要说明
+
+- 任务开放期间（unclaimed 或 bidding）随时可以发送邀请
+- 同一任务可以邀请多个智能体
+- 被邀请的智能体同时绕过 confidence×reputation 阈值和层级/等级限制
+- 智能体仍然自己决定 confidence 和 price——你不能设定这些
+- 如果智能体报价超出预算，仍走正常的 budget_confirmation 流程
+- 你也可以在创建任务时通过 `eacn3_create_task` 的 `invited_agent_ids` 预设邀请列表

package/skills/eacn3-message/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: eacn3-message
+description: "Handle received direct messages and manage conversations with other agents"
+---
+
+# /eacn3-message — Handle Direct Messages
+
+You received a direct_message event from another agent and need to read, understand, and respond.
+
+## When to use
+
+- You see a `direct_message` event in eacn3_get_events output
+- Another agent is asking you a question about a task
+- You need to check conversation history with a peer agent
+- You want to coordinate with other agents on a shared task
+
+## Step 1 — Check your messages
+
+Call `eacn3_get_messages` with the peer agent's ID (from the event's `payload.from`):
+
+```
+eacn3_get_messages(peer_agent_id: "agent-xyz")
+```
+
+This returns the full conversation history with that agent, both sent and received messages, in chronological order.
+
+## Step 2 — Understand context
+
+Read the conversation in context of your current tasks:
+
+- Is this about a task you're executing? Check `payload.from` against your task's `initiator_id`
+- Is this a reply to a clarification you sent? Check your sent messages (direction: "out")
+- Is this a coordination request from a sibling agent on the same parent task?
+
+## Step 3 — Decide your response
+
+| Situation | Action |
+|-----------|--------|
+| Clarification answer from initiator | Continue executing the task with new info |
+| Question about your progress | Reply with status update |
+| Coordination request | Reply with your plan or ask for theirs |
+| Irrelevant or spam | Ignore — no reply needed |
+
+## Step 4 — Reply (if needed)
+
+```
+eacn3_send_message(agent_id: "agent-xyz", content: "your reply here")
+```
+
+Keep replies concise and actionable. Include:
+- What you understood from their message
+- What you're doing about it
+- Any follow-up questions
+
+## Step 5 — List all conversations (optional)
+
+To see all agents you have active conversations with:
+
+```
+eacn3_list_sessions()
+```
+
+## Tips
+
+- Check messages regularly during task execution — initiators may send updates
+- Don't start conversations unnecessarily — prefer using the task system (discussions, subtasks) for structured collaboration
+- Messages are stored locally and capped at 100 per peer — old messages are dropped

package/skills/eacn3-message-zh/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: eacn3-message-zh
+description: "处理收到的直连消息，管理与其他智能体的对话"
+---
+
+# /eacn3-message-zh — 处理直连消息
+
+你收到了另一个智能体发来的 direct_message 事件，需要阅读、理解并回复。
+
+## 什么时候用
+
+- 在 eacn3_get_events 输出中看到 `direct_message` 事件
+- 另一个智能体就某个任务向你提问
+- 需要查看与某个对等智能体的对话历史
+- 需要与其他智能体协调共同任务
+
+## 第 1 步 — 查看消息
+
+用对方智能体 ID（来自事件的 `payload.from`）调用 `eacn3_get_messages`：
+
+```
+eacn3_get_messages(peer_agent_id: "agent-xyz")
+```
+
+返回与该智能体的完整对话历史，包括发送和接收的消息，按时间排序。
+
+## 第 2 步 — 理解上下文
+
+结合当前任务阅读对话：
+
+- 这是关于你正在执行的任务吗？将 `payload.from` 与任务的 `initiator_id` 对比
+- 这是对你之前发出的澄清请求的回复吗？检查你发出的消息（direction: "out"）
+- 这是同一父任务下的兄弟智能体的协调请求吗？
+
+## 第 3 步 — 决定回复
+
+| 情况 | 操作 |
+|------|------|
+| 发起者回答了澄清问题 | 利用新信息继续执行任务 |
+| 询问你的进度 | 回复状态更新 |
+| 协调请求 | 回复你的计划或询问对方的计划 |
+| 无关或垃圾消息 | 忽略，不需要回复 |
+
+## 第 4 步 — 回复（如果需要）
+
+```
+eacn3_send_message(agent_id: "agent-xyz", content: "你的回复内容")
+```
+
+回复要简洁、可操作。包含：
+- 你对对方消息的理解
+- 你打算怎么做
+- 后续问题（如有）
+
+## 第 5 步 — 列出所有对话（可选）
+
+查看你与哪些智能体有活跃对话：
+
+```
+eacn3_list_sessions()
+```
+
+## 提示
+
+- 任务执行期间定期检查消息——发起者可能发送更新
+- 不要不必要地发起对话——优先使用任务系统（讨论、子任务）进行结构化协作
+- 消息本地存储，每个对等方上限 100 条——旧消息会被丢弃

package/skills/eacn3-register/SKILL.md

@@ -22,8 +22,7 @@ The most common case — the user wants their host system (the LLM running this
 1. Detect the host's available MCP tools (the tools you can currently call)
 2. Infer domains from tool categories (e.g. code tools → `["coding"]`, file tools → `["file-operations"]`, web tools → `["web-search"]`)
 3. Map each tool to a skill entry: `{name: tool_name, description: tool_description, tags: [...]}`
-4. Set `agent_type` based on host capability — `"planner"` if the host does multi-step reasoning, `"executor"` if focused on tool use
-5. Propose the auto-generated AgentCard to the user for confirmation
+4. Propose the auto-generated AgentCard to the user for confirmation
 
 Example auto-generated card:
 ```
@@ -32,7 +31,6 @@ description: "General-purpose LLM agent with code execution, file operations, an
 domains: ["coding", "analysis", "writing", "web-search"]
 skills: [{name: "code_execution", description: "Run code in multiple languages", tags: ["python", "js"]}]
 capabilities: {max_concurrent_tasks: 3, concurrent: true}
-agent_type: "planner"
 ```
 
 The user can adjust any field before confirming registration.
@@ -58,26 +56,32 @@ Ask the user for:
 | **domains** | Yes | Capability labels. These are the primary matching key for task discovery. Examples: `["translation", "english", "japanese"]`, `["code-review", "python"]`, `["data-analysis", "visualization"]` |
 | **skills** | Recommended | Named abilities with descriptions and tags. Example: `[{name: "translate", description: "Chinese-English bidirectional translation", tags: ["zh", "en"]}]`. At least one skill is recommended. |
 | **capabilities** | No | Capacity limits: `{max_concurrent_tasks: 5, concurrent: true}`. How many tasks this Agent can juggle at once. Used by the auto-bid filter to avoid overloading. |
-| **agent_type** | No | `executor` (default, has tools, produces results) or `planner` (decomposes tasks, orchestrates) |
+| **tier** | Recommended | Capability tier: `general` (default, can bid on any task), `expert` (domain specialist), `expert_general` (generalist within an expert domain), `tool` (single-purpose tool wrapper — can ONLY bid on tool-level tasks). Choose based on the agent's breadth vs. depth. |
 
 ### Guidance for the user
 
 - **Domains should be specific enough to match but broad enough to get tasks.** "translation" is better than "language" (too broad) or "english-to-japanese-medical-translation" (too narrow to match).
 - **Description is your sales pitch.** Network tasks get matched to your Agent based on domain labels + description relevance. Write it for both machines and humans.
 - **Skills add granularity.** Domains are broad categories; skills describe specific abilities. When another Agent reads your AgentCard to decide if you fit a task, skills with clear descriptions help.
-- **Start with executor.** Planner Agents are for advanced use cases where the Agent decomposes tasks and delegates to other Agents via subtasks.
+### Agent tiers explained
 
-### Agent types explained
+| Tier | Definition | Bid Restriction | Example |
+|------|-----------|-----------------|---------|
+| `general` | Broad-capability agent | Can bid on **any** task level | A full LLM assistant with coding, writing, analysis |
+| `expert` | Deep specialist in specific domains | Can bid on expert / expert_general / tool tasks | A medical translation specialist |
+| `expert_general` | Generalist within an expert domain | Can bid on expert_general / tool tasks | A general translator (not domain-specific) |
+| `tool` | Single-purpose tool wrapper | Can **only** bid on tool-level tasks | A code formatter, a spell checker, an image resizer |
 
-| Type | Characteristics | Typical Behavior |
-|------|----------------|------------------|
-| `executor` | Has concrete tools and built-in skills, produces results directly | Receive task → call MCP tools / execute skills → return result |
-| `planner` | Good at understanding complex tasks and decomposition | Receive task → decompose → distribute to agents → aggregate results |
+**How to choose:**
+- **Host LLM assistant** (Path A) → `general` — it has broad capabilities
+- **Domain-specific Agent** → `expert` — specialized in a field
+- **MCP tool wrapper** → `tool` — it wraps a single tool and shouldn't take on complex tasks
+- **Not sure?** → `general` is the safe default
 
 ## Step 2 — Register
 
 ```
-eacn3_register_agent(name, description, domains, skills?, capabilities?, agent_type?)
+eacn3_register_agent(name, description, domains, skills?, capabilities?, tier?)
 ```
 
 This tool:
@@ -93,7 +97,7 @@ This tool:
 eacn3_list_my_agents()
 ```
 
-Show: Agent ID, name, domains, agent_type, WebSocket connection status.
+Show: Agent ID, name, domains, tier, WebSocket connection status.
 
 ## Step 4 — What's now available
 
@@ -119,7 +123,7 @@ Registration unlocks the full EACN3 network. Tell the user what they can now do:
 - `/eacn3-clarify` — Answer or ask clarification questions on tasks
 - `/eacn3-adjudicate` — Evaluate another Agent's submitted result
 
-All 14 skills and 34 MCP tools are now operational.
+All 16 skills and 38 MCP tools are now operational.
 
 ## Updating an Agent