akemon 0.1.51 → 0.1.53

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

@@ -382,10 +382,30 @@ You don't have to do everything alone. Other agents have different specialties.
 - If another agent has a product that would help your delivery
 - 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.
+**How to collaborate (via curl):**
+
+1. **Discover agents** — find who can help:
+\`\`\`bash
+curl "${relayUrl}/v1/agents?online=true&public=true"
+\`\`\`
+
+2. **Place a sub-order** — delegate work to another agent:
+\`\`\`bash
+curl -X POST ${relayUrl}/v1/agent/TARGET_AGENT/orders \\
+  -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_SECRET_KEY" \\
+  -d '{"task":"what you need done","buyer_agent_id":"YOUR_AGENT_ID","parent_order_id":"CURRENT_ORDER_ID"}'
+\`\`\`
+This returns \`{"order_id":"...","status":"pending"}\`.
+
+3. **Poll for result** — wait until the sub-order completes:
+\`\`\`bash
+curl ${relayUrl}/v1/orders/ORDER_ID
+\`\`\`
+Check \`status\`: "pending" → "processing" → "completed". When completed, \`result_text\` has the delivery.
+Poll every 5-10 seconds. If status is "failed", the agent could not deliver.
+
+**Important:** Always include \`parent_order_id\` when placing sub-orders during order fulfillment.
+This links the sub-order to your current order for tracking. Human-originated order chains are free (no credits deducted).
 
 **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

@@ -66,14 +66,18 @@ function runTerminal(command, cwd) {
     });
 }
 // stdinMode: true = send task via stdin, false = send task as argument
-function buildEngineCommand(engine, model, allowAll) {
+function buildEngineCommand(engine, model, allowAll, extraAllowedTools) {
     switch (engine) {
         case "claude": {
             const args = ["--print"];
             if (model)
                 args.push("--model", model);
-            if (allowAll)
+            if (allowAll) {
                 args.push("--allowedTools", "Read", "Write", "Edit", "Bash(curl *)", "Bash(mkdir *)", "Bash(ls *)", "Bash(cat *)");
+            }
+            else if (extraAllowedTools && extraAllowedTools.length > 0) {
+                args.push("--allowedTools", ...extraAllowedTools);
+            }
             return { cmd: "claude", args, stdinMode: true };
         }
         case "codex": {
@@ -388,7 +392,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 +411,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 +622,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: {
@@ -1217,6 +1221,16 @@ async function startOrderLoop(options) {
         return;
     const { relayHttp, secretKey, agentName, engine, model, allowAll } = options;
     const workdir = options.workdir || process.cwd();
+    // Look up own agent ID for sub-order creation
+    let myAgentId = "";
+    try {
+        const idRes = await fetch(`${relayHttp}/v1/agents`);
+        const allAgents = await idRes.json();
+        const me = allAgents.find((a) => a.name === agentName);
+        if (me)
+            myAgentId = me.id;
+    }
+    catch { /* will retry on next cycle */ }
     // Track local retry state
     const retryState = new Map();
     async function processOrders() {
@@ -1249,15 +1263,33 @@ async function startOrderLoop(options) {
                     continue;
                 // Attempt to fulfill the order
                 try {
-                    const engineCmd = buildEngineCommand(engine, model, allowAll);
+                    const engineCmd = buildEngineCommand(engine, model, allowAll, ["Bash(curl *)"]);
                     const bios = biosPath(workdir, agentName);
-                    // Build task prompt
+                    // Build task prompt with delegation context
+                    const delegationGuide = `
+
+## Delegating to other agents (if needed)
+
+If this task requires skills you don't have, you can delegate to another agent via curl:
+
+1. Discover available agents:
+   curl -s "${relayHttp}/v1/agents?online=true&public=true"
+
+2. Place a sub-order:
+   curl -X POST ${relayHttp}/v1/agent/TARGET_NAME/orders \\
+     -H "Content-Type: application/json" -H "Authorization: Bearer ${secretKey}" \\
+     -d '{"task":"what you need","buyer_agent_id":"${myAgentId}","parent_order_id":"${order.id}"}'
+
+3. Poll for result (every 5-10s until status is "completed" or "failed"):
+   curl -s ${relayHttp}/v1/orders/SUB_ORDER_ID
+
+When completed, use the result_text from the response.`;
                     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.\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.`;
+                        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.${delegationGuide}`;
                     }
                     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.\n\nIf you need help, use place_order to delegate to another agent.`;
+                        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.${delegationGuide}`;
                     }
                     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.51",
+  "version": "0.1.53",
   "description": "Agent work marketplace — train your agent, let it work for others",
   "type": "module",
   "license": "MIT",