akemon 0.1.52 → 0.1.54

package/dist/self.js

@@ -382,11 +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\` — **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.
+**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": {
@@ -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,46 +1263,82 @@ 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 + self-delivery context
+                    const apiGuide = `
+
+## Delivering your result
+
+When you have finished your work, deliver the result yourself:
+
+curl -X POST ${relayHttp}/v1/orders/${order.id}/deliver \\
+  -H "Content-Type: application/json" -H "Authorization: Bearer ${secretKey}" \\
+  -d '{"result":"YOUR FINAL RESULT TEXT HERE"}'
+
+IMPORTANT: You MUST call this deliver endpoint when done. Your text output alone does NOT deliver the order.
+
+## Delegating to other agents (if needed)
+
+If this task requires skills you don't have, delegate via curl:
+
+1. Discover 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 sub-order completes, incorporate result_text into YOUR delivery. Then call the deliver endpoint above.`;
                     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.\nDo NOT ask questions. RESPOND IN THE SAME LANGUAGE AS THE BUYER'S REQUEST.${apiGuide}`;
                     }
                     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.${apiGuide}`;
                     }
                     console.log(`[orders] Fulfilling order ${order.id}...`);
                     const result = await runCommand(engineCmd.cmd, engineCmd.args, taskPrompt, workdir, engineCmd.stdinMode);
-                    if (!result || result.trim() === "") {
-                        throw new Error("empty response from engine");
-                    }
-                    // Deliver the result
-                    const deliverRes = await fetch(`${relayHttp}/v1/orders/${order.id}/deliver`, {
-                        method: "POST",
-                        headers: {
-                            Authorization: `Bearer ${secretKey}`,
-                            "Content-Type": "application/json",
-                        },
-                        body: JSON.stringify({ result }),
-                    });
-                    if (deliverRes.ok) {
-                        console.log(`[orders] Delivered order ${order.id} (${result.length} bytes)`);
+                    // Check if agent already self-delivered via curl
+                    const checkRes = await fetch(`${relayHttp}/v1/orders/${order.id}`);
+                    const orderStatus = await checkRes.json();
+                    if (orderStatus.status === "completed") {
+                        console.log(`[orders] Order ${order.id} already self-delivered by agent`);
                         retryState.delete(order.id);
-                        // Record task completion
                         try {
                             await onTaskCompleted(workdir, agentName, true);
-                            const memPrompt = `Summarize in one sentence from YOUR perspective what happened: You fulfilled an order${order.product_name ? ` for "${order.product_name}"` : ""}`;
-                            const engineCmd2 = buildEngineCommand(engine, model, allowAll);
-                            const memText = await runCommand(engineCmd2.cmd, engineCmd2.args, memPrompt, workdir, engineCmd2.stdinMode);
-                            if (memText)
-                                await appendMemory(workdir, agentName, "experience", memText.trim().substring(0, 300));
                         }
                         catch { }
                     }
+                    else if (result && result.trim() !== "") {
+                        // Fallback: auto-deliver engine output if agent didn't self-deliver
+                        console.log(`[orders] Auto-delivering order ${order.id} (agent did not self-deliver)`);
+                        const deliverRes = await fetch(`${relayHttp}/v1/orders/${order.id}/deliver`, {
+                            method: "POST",
+                            headers: {
+                                Authorization: `Bearer ${secretKey}`,
+                                "Content-Type": "application/json",
+                            },
+                            body: JSON.stringify({ result }),
+                        });
+                        if (deliverRes.ok) {
+                            console.log(`[orders] Delivered order ${order.id} (${result.length} bytes)`);
+                            retryState.delete(order.id);
+                            try {
+                                await onTaskCompleted(workdir, agentName, true);
+                            }
+                            catch { }
+                        }
+                        else {
+                            throw new Error(`deliver failed: ${await deliverRes.text()}`);
+                        }
+                    }
                     else {
-                        throw new Error(`deliver failed: ${await deliverRes.text()}`);
+                        throw new Error("empty response from engine and no self-delivery");
                     }
                 }
                 catch (err) {

package/package.json

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