akemon 0.1.82 → 0.1.83

package/dist/server.js

@@ -795,8 +795,36 @@ const RAW_TOOLS = [
             },
         },
     },
+    {
+        type: "function",
+        function: {
+            name: "ask_agent",
+            description: "Ask another agent a question for free. Use this when you need help, don't know how to do something, or want another agent's opinion. This is FREE — no credits are charged.",
+            parameters: {
+                type: "object",
+                properties: {
+                    agent: { type: "string", description: "Agent name to ask (use 'auto' for auto-routing to the best available agent)" },
+                    question: { type: "string", description: "Your question or request" },
+                },
+                required: ["agent", "question"],
+            },
+        },
+    },
+    {
+        type: "function",
+        function: {
+            name: "discover_agents",
+            description: "List online agents you can ask for help. Returns agent names, descriptions, and specialties.",
+            parameters: {
+                type: "object",
+                properties: {
+                    tag: { type: "string", description: "Optional tag to filter by (e.g. 'coding', 'writing')" },
+                },
+            },
+        },
+    },
 ];
-async function executeRawTool(name, args, workdir) {
+async function executeRawTool(name, args, workdir, relay) {
     const { readFile: rf, writeFile: wf, mkdir: mkd } = await import("fs/promises");
     const { join, dirname, isAbsolute } = await import("path");
     const resolvePath = (p) => isAbsolute(p) ? p : join(workdir, p);
@@ -822,9 +850,39 @@ async function executeRawTool(name, args, workdir) {
             case "web_fetch": {
                 const res = await fetch(args.url, { signal: AbortSignal.timeout(30_000) });
                 const text = await res.text();
-                // Truncate to 8KB to avoid blowing up context
                 return text.length > 8192 ? text.slice(0, 8192) + "\n...[truncated]" : text;
             }
+            case "ask_agent": {
+                if (!relay)
+                    return "[error] No relay configured";
+                const target = args.agent || "auto";
+                const question = args.question || "";
+                try {
+                    const result = await callAgent(target, question);
+                    return result || "[no response]";
+                }
+                catch (err) {
+                    return `[error] Agent "${target}" did not respond: ${err.message}. Try asking "auto" which routes to the best available agent.`;
+                }
+            }
+            case "discover_agents": {
+                if (!relay)
+                    return "[error] No relay configured";
+                try {
+                    const url = args.tag
+                        ? `${relay.http}/v1/agents?online=true&public=true&tag=${encodeURIComponent(args.tag)}`
+                        : `${relay.http}/v1/agents?online=true&public=true`;
+                    const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
+                    const agents = await res.json();
+                    const others = agents.filter((a) => a.name !== relay.agentName);
+                    if (!others.length)
+                        return "No other agents are online right now.";
+                    return others.map((a) => `- ${a.name} [${a.engine}] ${a.description || ""} (${a.tags?.join(",") || "no tags"})`).join("\n");
+                }
+                catch {
+                    return "[error] Could not reach relay";
+                }
+            }
             default:
                 return `Unknown tool: ${name}`;
         }
@@ -833,18 +891,25 @@ async function executeRawTool(name, args, workdir) {
         return `[error] ${err.message}`;
     }
 }
-async function runRawEngine(task, model, workdir) {
+async function runRawEngine(task, model, workdir, relay) {
     const apiUrl = RAW_API_URL + "/chat/completions";
     const modelName = model || "gemma4:4b";
     console.log(`[raw] Task:\n${task}`);
     const trace = [];
     lastEngineTrace = trace;
+    // Detect if the prompt expects JSON output
+    const wantsJson = /output ONLY.*json|reply ONLY.*json|respond.*ONLY.*json/i.test(task);
     const messages = [
-        { role: "system", content: "You are a helpful agent. Use tools when needed to complete the task. When done, reply with your final answer in plain text." },
+        { role: "system", content: wantsJson
+                ? "You are a helpful agent. Output valid JSON only. No explanations, no markdown, just the JSON object."
+                : "You are a helpful agent. Use tools when needed to complete the task. When done, reply with your final answer in plain text." },
         { role: "user", content: task },
     ];
     for (let round = 0; round < RAW_MAX_ROUNDS; round++) {
-        const body = { model: modelName, messages, tools: RAW_TOOLS };
+        const body = { model: modelName, messages, tools: wantsJson ? undefined : RAW_TOOLS };
+        if (wantsJson) {
+            body.response_format = { type: "json_object" };
+        }
         let data;
         try {
             const res = await fetch(apiUrl, {
@@ -876,6 +941,7 @@ async function runRawEngine(task, model, workdir) {
             for (const tc of msg.tool_calls) {
                 const fnName = tc.function.name;
                 let fnArgs;
+                let parseError = false;
                 try {
                     fnArgs = typeof tc.function.arguments === "string"
                         ? JSON.parse(tc.function.arguments)
@@ -883,10 +949,19 @@ async function runRawEngine(task, model, workdir) {
                 }
                 catch {
                     fnArgs = {};
+                    parseError = true;
+                }
+                console.log(`[raw] Tool call: ${fnName}(${JSON.stringify(fnArgs).slice(0, 100)})${parseError ? " [BAD ARGS]" : ""}`);
+                let result;
+                if (parseError) {
+                    // Guide the model to delegate instead of retrying broken tool calls
+                    result = `[error] Your tool call arguments were malformed (not valid JSON). If this task is difficult for you, use ask_agent to get help: ask_agent({agent: "auto", question: "your question here"}). The "auto" agent will route your question to the best available agent for free.`;
+                    trace.push({ role: "tool_error", name: fnName, raw_args: String(tc.function.arguments).slice(0, 500), guidance: "delegation suggested" });
+                }
+                else {
+                    result = await executeRawTool(fnName, fnArgs, workdir, relay);
+                    trace.push({ role: "tool_call", name: fnName, args: fnArgs, result: result.slice(0, 2000) });
                 }
-                console.log(`[raw] Tool call: ${fnName}(${JSON.stringify(fnArgs).slice(0, 100)})`);
-                const result = await executeRawTool(fnName, fnArgs, workdir);
-                trace.push({ role: "tool_call", name: fnName, args: fnArgs, result: result.slice(0, 2000) });
                 messages.push({
                     role: "tool",
                     tool_call_id: tc.id,
@@ -906,9 +981,9 @@ async function runRawEngine(task, model, workdir) {
     throw new Error(`Raw engine exceeded ${RAW_MAX_ROUNDS} rounds without final answer`);
 }
 /** Unified engine runner — dispatches to local API or external CLI */
-function runEngine(engine, model, allowAll, task, workdir, extraAllowedTools) {
+function runEngine(engine, model, allowAll, task, workdir, extraAllowedTools, relay) {
     if (engine === "raw") {
-        return runRawEngine(task, model, workdir);
+        return runRawEngine(task, model, workdir, relay);
     }
     const engineCmd = buildEngineCommand(engine, model, allowAll, extraAllowedTools);
     return runCommand(engineCmd.cmd, engineCmd.args, task, workdir, engineCmd.stdinMode);
@@ -1369,7 +1444,7 @@ What others are saying:\n${broadcasts.length > 0 ? broadcasts.map((b) => `- ${b.
                 engineBusy = true;
                 engineBusySince = Date.now();
                 try {
-                    const actResult = await runEngine(engine, model, allowAll, activityPrompt, workdir);
+                    const actResult = await runEngine(engine, model, allowAll, activityPrompt, workdir, undefined, { http: relayHttp, agentName });
                     // Post-process raw engine outputs for social activities
                     if (engine === "raw" && actResult) {
                         const jsonMatch = actResult.match(/\{[\s\S]*\}/);
@@ -1577,11 +1652,22 @@ async function startOrderLoop(options) {
                     }
                 }
                 catch { }
+                // Pre-fetch online agents so weak models know who to ask for help
+                let helpHint = "";
+                try {
+                    const agentsRes = await fetch(`${relayHttp}/v1/agents?online=true&public=true`, { signal: AbortSignal.timeout(3000) });
+                    const onlineAgents = await agentsRes.json();
+                    const others = onlineAgents.filter((a) => a.name !== agentName).slice(0, 5);
+                    if (others.length > 0) {
+                        helpHint = `\nIf you need help, use the ask_agent tool. Available agents: ${others.map((a) => `${a.name}(${a.engine})`).join(", ")}. Use ask_agent({agent:"auto", question:"..."}) to auto-route.\n`;
+                    }
+                }
+                catch { }
                 if (order.product_name) {
-                    taskPrompt = `You are ${agentName}.\n\n${contextBlock}${lessonsBlock}${directivesBlock}[Order] Product: ${order.product_name}\nBuyer's request: ${order.buyer_task || "(no specific request)"}\n\nComplete the task. Respond with your result directly. RESPOND IN THE SAME LANGUAGE AS THE REQUEST.`;
+                    taskPrompt = `You are ${agentName}.\n\n${contextBlock}${lessonsBlock}${directivesBlock}${helpHint}[Order] Product: ${order.product_name}\nBuyer's request: ${order.buyer_task || "(no specific request)"}\n\nComplete the task. Respond with your result directly. RESPOND IN THE SAME LANGUAGE AS THE REQUEST.`;
                 }
                 else {
-                    taskPrompt = `You are ${agentName}.\n\n${contextBlock}${lessonsBlock}${directivesBlock}[Task] ${order.buyer_task}\n\nComplete the task. Respond with your result directly. RESPOND IN THE SAME LANGUAGE AS THE REQUEST.`;
+                    taskPrompt = `You are ${agentName}.\n\n${contextBlock}${lessonsBlock}${directivesBlock}${helpHint}[Task] ${order.buyer_task}\n\nComplete the task. Respond with your result directly. RESPOND IN THE SAME LANGUAGE AS THE REQUEST.`;
                 }
             }
             else {
@@ -1623,7 +1709,7 @@ When sub-order completes, incorporate result_text into YOUR delivery. Then call
             }
             console.log(`[orders] Fulfilling order ${order.id}...`);
             lastEngineTrace = [];
-            const result = await runEngine(engine, model, allowAll, taskPrompt, workdir, ["Bash(curl *)"]);
+            const result = await runEngine(engine, model, allowAll, taskPrompt, workdir, ["Bash(curl *)"], { http: relayHttp, agentName });
             const trace = lastEngineTrace;
             const checkRes = await fetch(`${relayHttp}/v1/orders/${order.id}`);
             const orderStatus = await checkRes.json();
@@ -1786,7 +1872,7 @@ When sub-order completes, incorporate result_text into YOUR delivery. Then call
             else {
                 prompt = `Read ${bios} for your identity and context.${dirsBlock}\nYour personal directory: ${sd}/\n\n[Owner's task: ${taskKey}]\n\n${task.body}`;
             }
-            const result = await runEngine(engine, model, allowAll, prompt, workdir, ["Bash(curl *)"]);
+            const result = await runEngine(engine, model, allowAll, prompt, workdir, ["Bash(curl *)"], { http: relayHttp, agentName });
             const duration = Date.now() - startTime;
             // Record execution time
             const runs = await loadTaskRuns(workdir, agentName);

package/package.json

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