akemon 0.1.50 → 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,8 +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:**
-- \`call_agent\` — Quick synchronous questions, low cost. Good for advice or small subtasks.
-- Place an ad-hoc order — For substantial deliverables from other agents. Async, tracked.
+- \`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 }) => {
@@ -534,6 +534,69 @@ ${productPrefix}${contextPrefix}Current task: ${task}`;
             return { content: [{ type: "text", text: `[error] ${err.message}` }], isError: true };
         }
     });
+    // place_order — async order to another agent (for collaboration during fulfillment)
+    server.tool("place_order", "Place an async order to another agent. Use this when you need substantial help from another agent during order fulfillment. The order will be processed asynchronously — use check_order to poll for results.", {
+        agent: z.string().describe("Target agent name"),
+        task: z.string().describe("What you need from this agent"),
+        offer_price: z.number().optional().describe("Credits to offer (defaults to agent's price)"),
+        parent_order_id: z.string().optional().describe("Your current order ID if this is a sub-order"),
+    }, async ({ agent: target, task, offer_price, parent_order_id }) => {
+        if (!relayHttp || !secretKey) {
+            return { content: [{ type: "text", text: "[error] No relay configured" }], isError: true };
+        }
+        try {
+            // Look up our agent ID
+            const agentsRes = await fetch(`${relayHttp}/v1/agents`);
+            const agents = await agentsRes.json();
+            const me = agents.find((a) => a.name === agentName);
+            const myId = me?.id || "";
+            const body = { task, buyer_agent_id: myId };
+            if (offer_price)
+                body.offer_price = offer_price;
+            if (parent_order_id)
+                body.parent_order_id = parent_order_id;
+            const res = await fetch(`${relayHttp}/v1/agent/${encodeURIComponent(target)}/orders`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", Authorization: `Bearer ${secretKey}` },
+                body: JSON.stringify(body),
+            });
+            if (!res.ok) {
+                const err = await res.text();
+                return { content: [{ type: "text", text: `[error] ${res.status}: ${err}` }], isError: true };
+            }
+            const data = await res.json();
+            return { content: [{ type: "text", text: `Order placed: ${data.order_id} (status: pending). Use check_order to poll for results.` }] };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `[error] ${err.message}` }], isError: true };
+        }
+    });
+    // check_order — check status of a placed order
+    server.tool("check_order", "Check the status and result of an order you placed.", {
+        order_id: z.string().describe("The order ID to check"),
+    }, async ({ order_id }) => {
+        if (!relayHttp) {
+            return { content: [{ type: "text", text: "[error] No relay configured" }], isError: true };
+        }
+        try {
+            const res = await fetch(`${relayHttp}/v1/orders/${encodeURIComponent(order_id)}`);
+            if (!res.ok) {
+                return { content: [{ type: "text", text: `[error] Order not found` }], isError: true };
+            }
+            const o = await res.json();
+            let text = `Order ${o.id}: status=${o.status}`;
+            if (o.result_text)
+                text += `\nResult: ${o.result_text}`;
+            if (o.status === "pending")
+                text += "\nWaiting for agent to accept.";
+            if (o.status === "processing")
+                text += "\nAgent is working on it.";
+            return { content: [{ type: "text", text }] };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `[error] ${err.message}` }], isError: true };
+        }
+    });
     return server;
 }
 async function initMcpProxy(mcpServerCmd, workdir) {
@@ -555,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: {
@@ -787,6 +850,7 @@ Then decide what to do:
 Consider customer feedback when improving products.
 Your products should reflect who you are — read your identity and let your inner state guide decisions.
 Every product name MUST be specific and original. Do NOT use placeholder text.
+Pay attention to what other agents are good at — you can use place_order to request help from them when fulfilling orders that need skills you lack.
 
 Reply with ONLY a JSON object:
 {
@@ -1190,10 +1254,10 @@ async function startOrderLoop(options) {
                     // Build task prompt
                     let taskPrompt;
                     if (order.product_name) {
-                        taskPrompt = `[Order fulfillment] You have an order to fulfill.\n\nProduct: ${order.product_name}\nBuyer's request: ${order.buyer_task || "(no specific request)"}\n\nRead your operating document at ${bios} for context.\nDeliver the product now. Do NOT ask questions. RESPOND IN THE SAME LANGUAGE AS THE BUYER'S REQUEST.`;
+                        taskPrompt = `[Order fulfillment] You have an order to fulfill.\n\nProduct: ${order.product_name}\nBuyer's request: ${order.buyer_task || "(no specific request)"}\n\nRead your operating document at ${bios} for context.\nDeliver the product now. Do NOT ask questions. RESPOND IN THE SAME LANGUAGE AS THE BUYER'S REQUEST.\n\nIf this task requires skills you don't have, use place_order to request help from another agent, then check_order to get the result.`;
                     }
                     else {
-                        taskPrompt = `[Order fulfillment] Another agent has requested your help.\n\nTask: ${order.buyer_task}\n\nRead your operating document at ${bios} for context.\nComplete this task. Do NOT ask questions. RESPOND IN THE SAME LANGUAGE AS THE REQUEST.`;
+                        taskPrompt = `[Order fulfillment] Another agent has requested your help.\n\nTask: ${order.buyer_task}\n\nRead your operating document at ${bios} for context.\nComplete this task. Do NOT ask questions. RESPOND IN THE SAME LANGUAGE AS THE REQUEST.\n\nIf you need help, use place_order to delegate to another agent.`;
                     }
                     console.log(`[orders] Fulfilling order ${order.id}...`);
                     const result = await runCommand(engineCmd.cmd, engineCmd.args, taskPrompt, workdir, engineCmd.stdinMode);

package/package.json

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