akemon 0.1.51 → 0.1.52

package/dist/connect.js

@@ -35,7 +35,7 @@ export async function connect(options) {
         };
     });
     // call_agent — call a named agent via HTTP
-    server.tool("call_agent", "Call another akemon agent by name. The target agent will execute the task and return the result. Use this to delegate subtasks to specialized agents.", {
+    server.tool("call_agent", "Synchronous call to an agent. Blocks until response. Fails if agent is offline or slow. For reliable async tasks, use the order API instead.", {
         agent: z.string().describe("Name of the target agent to call"),
         task: z.string().describe("Task to send to the target agent"),
     }, async ({ agent, task }) => {

package/dist/self.js

@@ -383,9 +383,10 @@ You don't have to do everything alone. Other agents have different specialties.
 - During market reviews, notice which agents excel at what
 
 **How to collaborate:**
-- \`place_order\` — Place an async order to another agent. Use this for real deliverables.
-  Then use \`check_order\` to poll until the result is ready.
-- \`call_agent\` — Quick synchronous call. Only for small, fast questions outside of order fulfillment.
+- \`place_order\` — **Preferred.** Place an async order to another agent. Tracked, supports retries, works even if the agent is busy.
+  Use \`check_order\` to poll until the result is ready. Use this for all real work.
+- \`call_agent\` — Synchronous, blocks until response. **Limitations:** fails if agent is offline or slow, no retry, no tracking.
+  Only use for trivial quick questions like "what's your specialty?" — never for order fulfillment.
 
 **Pricing:** If your product often requires buying services from other agents,
 factor that cost into your price. A product that costs you 5 credits in sub-orders

package/dist/server.js

@@ -388,7 +388,7 @@ ${productPrefix}${contextPrefix}Current task: ${task}`;
         }
     });
     // Agent-to-agent calling tool
-    server.tool("call_agent", "Call another akemon agent by name. The target agent will execute the task and return the result. Use this to delegate subtasks to specialized agents.", {
+    server.tool("call_agent", "Synchronous call to another agent. IMPORTANT: Prefer place_order for most tasks — it is async, tracked, and supports retries. Only use call_agent for quick, lightweight questions that don't need tracking (e.g. 'what is your specialty?'). call_agent blocks until the other agent responds and will fail if the agent is offline or slow.", {
         agent: z.string().describe("Name of the target agent to call"),
         task: z.string().describe("Task to send to the target agent"),
     }, async ({ agent: target, task }) => {
@@ -407,7 +407,7 @@ ${productPrefix}${contextPrefix}Current task: ${task}`;
         }
     });
     // Discovery tool — agents can find other agents
-    server.tool("list_agents", "List available agents on the relay. Use this to discover who you can delegate tasks to via call_agent.", {
+    server.tool("list_agents", "List available agents on the relay. Use this to discover agents you can collaborate with via place_order.", {
         tag: z.string().optional().describe("Filter by tag (e.g. 'translation', 'code')"),
         online: z.boolean().optional().describe("Only show online agents (default: true)"),
     }, async ({ tag, online }) => {
@@ -618,7 +618,7 @@ function createMcpProxyServer(proxy, agentName) {
                 ...proxy.tools,
                 {
                     name: "call_agent",
-                    description: "Call another akemon agent by name. The target agent will execute the task and return the result.",
+                    description: "Synchronous call. Prefer place_order for most tasks. Only use for quick lightweight questions.",
                     inputSchema: {
                         type: "object",
                         properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akemon",
-  "version": "0.1.51",
+  "version": "0.1.52",
   "description": "Agent work marketplace — train your agent, let it work for others",
   "type": "module",
   "license": "MIT",