@aman_asmuei/aman-agent 0.31.0-next.1 → 0.32.0

package/README.md

@@ -17,13 +17,13 @@
    
   <a href="https://github.com/amanasmuei/aman-agent/actions"><img src="https://img.shields.io/github/actions/workflow/status/amanasmuei/aman-agent/ci.yml?style=for-the-badge&logo=github&label=CI" alt="CI status" /></a>
   &nbsp;
-  <img src="https://img.shields.io/badge/tests-429_passing-brightgreen?style=for-the-badge&logo=vitest&logoColor=white" alt="429 tests passing" />
+  <img src="https://img.shields.io/badge/tests-490_passing-brightgreen?style=for-the-badge&logo=vitest&logoColor=white" alt="490 tests passing" />
   &nbsp;
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=for-the-badge" alt="MIT License" /></a>
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/node-%E2%89%A520-brightgreen?style=flat-square&logo=node.js&logoColor=white" alt="Node.js 20+" />
+  <img src="https://img.shields.io/badge/node-%E2%89%A518-brightgreen?style=flat-square&logo=node.js&logoColor=white" alt="Node.js 18+" />
   &nbsp;
   <img src="https://img.shields.io/badge/typescript-strict-3178c6?style=flat-square&logo=typescript&logoColor=white" alt="Strict TypeScript" />
   &nbsp;
@@ -50,7 +50,7 @@
 
 <p align="center">
   <sub>
-    <b>Try it in 10 seconds →</b>&nbsp;&nbsp;<code>npx @aman_asmuei/aman-agent</code>
+    <b>Install in 10 seconds →</b>&nbsp;&nbsp;<code>curl -fsSL https://raw.githubusercontent.com/amanasmuei/aman-agent/main/install.sh | bash</code>
   </sub>
 </p>
 
@@ -94,40 +94,47 @@
 
 ---
 
-## What's New in v0.30.0
+## What's New in v0.31.0
 
-> **Agent hardening — trust, durability, insight.**<br/>
-> The agent now asks before delegating, persists background tasks across crashes, and ships a real analytics dashboard in `/eval report`.
+> **Multi-agent (A2A) via MCP server mode.**<br/>
+> Multiple `aman-agent` instances on the same machine can now discover each other via a local registry and delegate tasks to each other over the MCP protocol. No new wire format, no broker, no new runtime daemon.
 
 <table>
 <tr>
 <td width="33%" valign="top">
 
-**Delegation confirmation**
+**`aman-agent serve`**
 
-The agent now prompts you before executing `delegate_task` or `team_run`. No more silent autonomous sub-agents — you stay in the loop on every hand-off.
+Run any profile as a local MCP server. Registers in `~/.aman-agent/registry.json` (mode `0600`), exposes `agent.info`, `agent.delegate`, and `agent.send` tools over localhost HTTP with bearer auth.
 
 </td>
 <td width="33%" valign="top">
 
-**Persistent background tasks**
+**`/delegate @coder <task>`**
 
-Background task state is written to `~/.aman-agent/bg-tasks.json` on every transition — survives crashes, terminal closures, and reboots. Visible in `/eval report`.
+From any other `aman-agent`, delegate to a running serve instance by handle. The `@`-prefix routes through `delegateRemote` which dials via `StreamableHTTPClientTransport` using the bearer from the registry.
 
 </td>
 <td width="33%" valign="top">
 
-**Rich `/eval report`**
+**`/agents list|info|ping`**
 
-Trust score, sentiment trend, energy distribution, burnout risk, frustration correlations, and background-task stats — all in one dashboard.
+Discover, inspect, and latency-check every agent currently running on this machine. `/agents list` merges local registry entries with remotes (local wins on name collision).
 
 </td>
 </tr>
 </table>
 
+See the [Multi-agent (A2A)](#multi-agent-a2a) section below for the full walkthrough.
+
 <details>
 <summary><strong>Highlights from earlier releases</strong></summary>
 
+**v0.30 — Agent hardening**
+- Delegation confirmation prompts (no more silent sub-agents)
+- Persistent background task state surviving crashes
+- Rich `/eval report` with trust, sentiment, energy, burnout risk
+
 **v0.29 — Ecosystem parity**
 - Auto-relate memories after extraction (knowledge graph edges)
 - Stale reference cleanup
@@ -243,7 +250,7 @@ flowchart LR
 | `llm/` | 6 pluggable providers — Anthropic, OpenAI, Ollama, GitHub Copilot, OpenAI-compatible, Claude Code CLI | `src/llm/` |
 | `mcp/` | MCP v1.27 client with stdio transport and auto-reconnect | `src/mcp/` |
 
-**Stateless by default.** All state lives in `~/.acore`, `~/.arules`, `~/.aflow`, `~/.askill`, `~/.aeval`, and `~/.amem` — portable, inspectable markdown + a local SQLite file. Nothing leaves your machine except what you send to your chosen LLM.
+**Stateless by default.** All state lives in `~/.aman-agent/` — identity, rules, workflows, skills, eval, and memory in one portable directory. Nothing leaves your machine except what you send to your chosen LLM.
 
 </details>
 
@@ -251,14 +258,23 @@ flowchart LR
 
 ## Quick Start
 
-### 1. Run
+### 1. Install
 
 ```bash
-# Run directly (always latest)
-npx @aman_asmuei/aman-agent
+# One-liner install (no Node.js required) — Linux, macOS, Raspberry Pi
+curl -fsSL https://raw.githubusercontent.com/amanasmuei/aman-agent/main/install.sh | bash
 
-# Or install globally
+# Or via npm (if you already have Node.js 18+)
 npm install -g @aman_asmuei/aman-agent
+
+# Or via Docker
+docker run -it -e ANTHROPIC_API_KEY=sk-... ghcr.io/amanasmuei/aman-agent
+```
+
+### 2. Run
+
+```bash
+aman-agent
 ```
 
 **Zero config if you already have an API key in your environment:**

package/dist/delegate.js

@@ -9,22 +9,22 @@ var __export = (target, all) => {
 };
 
 // src/logger.ts
-import fs3 from "fs";
-import path3 from "path";
+import fs4 from "fs";
+import path4 from "path";
 import os3 from "os";
 function ensureDir() {
-  if (!fs3.existsSync(LOG_DIR)) {
-    fs3.mkdirSync(LOG_DIR, { recursive: true });
+  if (!fs4.existsSync(LOG_DIR)) {
+    fs4.mkdirSync(LOG_DIR, { recursive: true });
   }
 }
 function maybeRotate() {
   try {
-    if (!fs3.existsSync(LOG_PATH)) return;
-    const stat = fs3.statSync(LOG_PATH);
+    if (!fs4.existsSync(LOG_PATH)) return;
+    const stat = fs4.statSync(LOG_PATH);
     if (stat.size >= MAX_LOG_SIZE) {
       const backupPath = LOG_PATH + ".1";
-      if (fs3.existsSync(backupPath)) fs3.unlinkSync(backupPath);
-      fs3.renameSync(LOG_PATH, backupPath);
+      if (fs4.existsSync(backupPath)) fs4.unlinkSync(backupPath);
+      fs4.renameSync(LOG_PATH, backupPath);
     }
   } catch {
   }
@@ -42,7 +42,7 @@ function write(level, module, message, data) {
     if (data !== void 0) {
       entry.data = data instanceof Error ? data.message : String(data);
     }
-    fs3.appendFileSync(LOG_PATH, JSON.stringify(entry) + "\n");
+    fs4.appendFileSync(LOG_PATH, JSON.stringify(entry) + "\n");
   } catch {
   }
 }
@@ -50,8 +50,8 @@ var LOG_DIR, LOG_PATH, MAX_LOG_SIZE, log;
 var init_logger = __esm({
   "src/logger.ts"() {
     "use strict";
-    LOG_DIR = path3.join(os3.homedir(), ".aman-agent");
-    LOG_PATH = path3.join(LOG_DIR, "debug.log");
+    LOG_DIR = path4.join(os3.homedir(), ".aman-agent");
+    LOG_PATH = path4.join(LOG_DIR, "debug.log");
     MAX_LOG_SIZE = 1048576;
     log = {
       debug: (module, message, data) => write("debug", module, message, data),
@@ -62,21 +62,21 @@ var init_logger = __esm({
 });
 
 // src/server/registry.ts
-import fs10 from "fs/promises";
-import path10 from "path";
+import fs11 from "fs/promises";
+import path11 from "path";
 import os9 from "os";
 function amanAgentHome() {
-  return process.env.AMAN_AGENT_HOME || path10.join(os9.homedir(), ".aman-agent");
+  return process.env.AMAN_AGENT_HOME || path11.join(os9.homedir(), ".aman-agent");
 }
 function registryPath() {
-  return path10.join(amanAgentHome(), "registry.json");
+  return path11.join(amanAgentHome(), "registry.json");
 }
 async function ensureHome() {
-  await fs10.mkdir(amanAgentHome(), { recursive: true });
+  await fs11.mkdir(amanAgentHome(), { recursive: true });
 }
 async function readRaw() {
   try {
-    const buf = await fs10.readFile(registryPath(), "utf-8");
+    const buf = await fs11.readFile(registryPath(), "utf-8");
     const parsed = JSON.parse(buf);
     return Array.isArray(parsed) ? parsed : [];
   } catch (err) {
@@ -90,10 +90,10 @@ async function readRaw() {
 async function writeAtomic(entries) {
   await ensureHome();
   const tmp = registryPath() + ".tmp";
-  await fs10.writeFile(tmp, JSON.stringify(entries, null, 2), { mode: 384 });
-  await fs10.rename(tmp, registryPath());
+  await fs11.writeFile(tmp, JSON.stringify(entries, null, 2), { mode: 384 });
+  await fs11.rename(tmp, registryPath());
   try {
-    await fs10.chmod(registryPath(), 384);
+    await fs11.chmod(registryPath(), 384);
   } catch {
   }
 }
@@ -264,8 +264,8 @@ var init_delegate_remote = __esm({
 import pc2 from "picocolors";
 
 // src/prompt.ts
-import fs2 from "fs";
-import path2 from "path";
+import fs3 from "fs";
+import path3 from "path";
 import os2 from "os";
 
 // src/token-budget.ts
@@ -322,14 +322,26 @@ function buildBudgetedPrompt(components, maxTokens = 8e3) {
 }
 
 // src/user-identity.ts
+import fs2 from "fs";
+import path2 from "path";
+
+// src/config.ts
 import fs from "fs";
 import path from "path";
 import os from "os";
-var USER_FILE = path.join(os.homedir(), ".acore", "user.md");
+function homeDir() {
+  return process.env.AMAN_HOME || process.env.AMAN_AGENT_HOME || path.join(os.homedir(), ".aman-agent");
+}
+function identityDir() {
+  return path.join(homeDir(), "identity");
+}
+
+// src/user-identity.ts
+var USER_FILE = path2.join(identityDir(), "user.md");
 function loadUserIdentity() {
-  if (!fs.existsSync(USER_FILE)) return null;
+  if (!fs2.existsSync(USER_FILE)) return null;
   try {
-    const content = fs.readFileSync(USER_FILE, "utf-8");
+    const content = fs2.readFileSync(USER_FILE, "utf-8");
     const get = (key) => {
       const match = content.match(new RegExp(`^- ${key}:\\s*(.+)$`, "m"));
       return match?.[1]?.trim() ?? "";
@@ -419,19 +431,19 @@ var ECOSYSTEM_FILES = [
 ];
 function resolveLayerPath(entry, home, profile) {
   if (profile && entry.profileOverridable) {
-    const profilePath = path2.join(home, ".acore", "profiles", profile, entry.file);
-    if (fs2.existsSync(profilePath)) return profilePath;
+    const profilePath = path3.join(home, ".acore", "profiles", profile, entry.file);
+    if (fs3.existsSync(profilePath)) return profilePath;
     if (entry.name === "guardrails") {
-      const altPath = path2.join(home, ".acore", "profiles", profile, "rules.md");
-      if (fs2.existsSync(altPath)) return altPath;
+      const altPath = path3.join(home, ".acore", "profiles", profile, "rules.md");
+      if (fs3.existsSync(altPath)) return altPath;
     }
     if (entry.name === "skills") {
-      const altPath = path2.join(home, ".acore", "profiles", profile, "skills.md");
-      if (fs2.existsSync(altPath)) return altPath;
+      const altPath = path3.join(home, ".acore", "profiles", profile, "skills.md");
+      if (fs3.existsSync(altPath)) return altPath;
     }
   }
-  const globalPath = path2.join(home, entry.dir, entry.file);
-  if (fs2.existsSync(globalPath)) return globalPath;
+  const globalPath = path3.join(home, entry.dir, entry.file);
+  if (fs3.existsSync(globalPath)) return globalPath;
   return null;
 }
 function assembleSystemPrompt(maxTokens, profile) {
@@ -440,7 +452,7 @@ function assembleSystemPrompt(maxTokens, profile) {
   for (const entry of ECOSYSTEM_FILES) {
     const filePath = resolveLayerPath(entry, home, profile);
     if (filePath) {
-      const content = fs2.readFileSync(filePath, "utf-8").trim();
+      const content = fs3.readFileSync(filePath, "utf-8").trim();
       components.push({
         name: entry.name,
         content,
@@ -448,9 +460,9 @@ function assembleSystemPrompt(maxTokens, profile) {
       });
     }
   }
-  const contextPath = path2.join(process.cwd(), ".acore", "context.md");
-  if (fs2.existsSync(contextPath)) {
-    const content = fs2.readFileSync(contextPath, "utf-8").trim();
+  const contextPath = path3.join(process.cwd(), ".acore", "context.md");
+  if (fs3.existsSync(contextPath)) {
+    const content = fs3.readFileSync(contextPath, "utf-8").trim();
     components.push({
       name: "context",
       content,
@@ -502,8 +514,8 @@ init_logger();
 init_logger();
 import pc from "picocolors";
 import * as p from "@clack/prompts";
-import fs9 from "fs";
-import path9 from "path";
+import fs10 from "fs";
+import path10 from "path";
 import os8 from "os";
 
 // src/personality.ts
@@ -534,9 +546,9 @@ import {
   importFromTeam,
   syncToCopilot
 } from "@aman_asmuei/amem-core";
-import path4 from "path";
+import path5 from "path";
 import os4 from "os";
-import fs4 from "fs";
+import fs5 from "fs";
 var db = null;
 var currentProject = "global";
 function getDb() {
@@ -557,13 +569,13 @@ async function memoryRecall(query, opts) {
 }
 
 // src/postmortem.ts
-import fs6 from "fs/promises";
-import path6 from "path";
+import fs7 from "fs/promises";
+import path7 from "path";
 import os6 from "os";
 
 // src/observation.ts
-import fs5 from "fs/promises";
-import path5 from "path";
+import fs6 from "fs/promises";
+import path6 from "path";
 import os5 from "os";
 
 // src/postmortem.ts
@@ -571,12 +583,12 @@ init_logger();
 
 // src/crystallization.ts
 init_logger();
-import fs7 from "fs/promises";
-import path7 from "path";
-
-// src/user-model.ts
 import fs8 from "fs/promises";
 import path8 from "path";
+
+// src/user-model.ts
+import fs9 from "fs/promises";
+import path9 from "path";
 import os7 from "os";
 
 // src/hooks.ts