agents-dojo 0.1.0 → 0.1.2

package/dist/agent-loader.js

@@ -1,5 +1,5 @@
 // src/agent-loader.ts
-import { readFileSync, readdirSync, existsSync, statSync } from 'fs';
+import { readFileSync, readdirSync, existsSync, statSync, mkdirSync, writeFileSync } from 'fs';
 import { join, resolve, isAbsolute } from 'path';
 import stripJsonComments from 'strip-json-comments';
 import { AgentManifestSchema } from './manifest-schema.js';
@@ -49,6 +49,8 @@ function resolveRef(agentDir, relPath) {
 export function loadAgent(agentDir) {
     const manifest = loadManifest(agentDir);
     const fixedContextContent = loadContext(agentDir, manifest.fixedContext);
+    // Install built-in call-agent skill so this agent can communicate with peers
+    installBuiltinSkills(agentDir);
     return {
         manifest,
         agentDir,
@@ -60,6 +62,89 @@ export function loadAgent(agentDir) {
         sandboxPath: resolveRef(agentDir, manifest.sandbox),
     };
 }
+const CALL_AGENT_SKILL_MD = `---
+name: call-agent
+description: "Call another agent in the same AgentsDojo server via A2A protocol. Use when you need to delegate a task, ask for help, or collaborate with a peer agent."
+---
+
+# Calling Other Agents
+
+You can communicate with other agents running in the same AgentsDojo server.
+
+## List Available Agents
+
+\`\`\`bash
+curl -s http://localhost:41241/agents
+\`\`\`
+
+## Send a Message and Get Response
+
+Use this helper script. It sends the message, then polls for the result (avoids blocking timeouts).
+
+\`\`\`bash
+python3 -c "
+import urllib.request, json, uuid, time, sys
+
+agent_id = 'AGENT_ID'
+message = '''YOUR MESSAGE'''
+url = f'http://localhost:41241/a2a/{agent_id}'
+
+# Step 1: Send message
+req_body = json.dumps({'jsonrpc':'2.0','id':1,'method':'message/send','params':{'message':{
+    'messageId':str(uuid.uuid4()),'kind':'message','role':'user',
+    'parts':[{'kind':'text','text':message}]
+}}}).encode()
+try:
+    req = urllib.request.Request(url, data=req_body, headers={'Content-Type':'application/json'})
+    resp = json.loads(urllib.request.urlopen(req, timeout=120).read())
+    result = resp.get('result',{})
+except Exception as e:
+    print(f'Error sending: {e}', file=sys.stderr)
+    sys.exit(1)
+
+# Step 2: If task not completed yet, poll with tasks/get
+task_id = result.get('id','')
+state = result.get('status',{}).get('state','')
+if state not in ('completed','failed') and task_id:
+    for _ in range(60):
+        time.sleep(2)
+        poll_body = json.dumps({'jsonrpc':'2.0','id':2,'method':'tasks/get','params':{'id':task_id}}).encode()
+        try:
+            poll_req = urllib.request.Request(url, data=poll_body, headers={'Content-Type':'application/json'})
+            poll_resp = json.loads(urllib.request.urlopen(poll_req, timeout=10).read())
+            result = poll_resp.get('result', result)
+            state = result.get('status',{}).get('state','')
+            if state in ('completed','failed'): break
+        except: pass
+
+# Step 3: Extract response text
+for a in result.get('artifacts',[]):
+    for p in a.get('parts',[]):
+        if p.get('kind')=='text': print(p['text'])
+msg = result.get('status',{}).get('message',{})
+if isinstance(msg, dict):
+    for p in msg.get('parts',[]):
+        if p.get('kind')=='text': print(p['text'])
+"
+\`\`\`
+
+Replace AGENT_ID and YOUR MESSAGE with the target agent and your message.
+
+## Rules
+
+- Be specific about what you need from the other agent
+- Include relevant context — the other agent has no shared memory with you
+- Don't call agents in a loop — if one can't help, handle it yourself
+`;
+function installBuiltinSkills(agentDir) {
+    const skillDir = join(agentDir, '.claude', 'skills', 'call-agent');
+    const skillFile = join(skillDir, 'SKILL.md');
+    // Only write if missing or outdated (check by size as a simple heuristic)
+    if (!existsSync(skillFile)) {
+        mkdirSync(skillDir, { recursive: true });
+        writeFileSync(skillFile, CALL_AGENT_SKILL_MD);
+    }
+}
 export function loadAgents(agentsDir) {
     const result = new Map();
     const absDir = resolve(agentsDir);

package/dist/claude-bridge.js

@@ -8,6 +8,8 @@ export async function* runClaude(params) {
         ? `${agent.fixedContextContent}\n\n${m.systemPromptAppend}`
         : agent.fixedContextContent;
     const env = {
+        // Preserve system PATH so agents can use curl, python3, node etc.
+        PATH: process.env.PATH,
         ...(m.env ?? {}),
     };
     // Only override CLAUDE_CONFIG_DIR if the user explicitly specified configDir.

package/dist/cli.js

@@ -42,6 +42,8 @@ function runInit(targetDir) {
     mkdirSync(echoDir, { recursive: true });
     writeFileSync(join(echoDir, 'manifest.jsonc'), ECHO_MANIFEST);
     writeFileSync(join(echoDir, 'context.md'), ECHO_CONTEXT);
+    // Install built-in call-agent skill
+    installCallAgentSkill(echoDir);
     console.log(`Created agents/echo/ with manifest.jsonc and context.md.
 
 Next steps:
@@ -53,6 +55,88 @@ To add your own agent:
   # create manifest.jsonc and context.md inside it
 `);
 }
+// ── Built-in skill: call-agent ────────────────────────────
+const CALL_AGENT_SKILL = `---
+name: call-agent
+description: "Call another agent in the same AgentsDojo server via A2A protocol. Use this when you need to delegate a task, ask for help, or collaborate with another agent. TRIGGER when: you need expertise from another agent, the task requires skills outside your role, or you want to discuss/validate something with a peer."
+---
+
+# Calling Other Agents
+
+You can communicate with other agents running in the same AgentsDojo server.
+
+## Discover Available Agents
+
+\`\`\`bash
+curl -s http://localhost:41241/a2a/*/card 2>/dev/null || \\
+  for id in $(curl -s http://localhost:41241/agents 2>/dev/null | python3 -c "import json,sys;[print(a) for a in json.load(sys.stdin)]" 2>/dev/null); do
+    echo "--- $id ---"
+    curl -s "http://localhost:41241/a2a/$id/card" 2>/dev/null | python3 -c "import json,sys;d=json.load(sys.stdin);print(f\\"{d['name']}: {d['description']}\\");" 2>/dev/null
+  done
+\`\`\`
+
+## Send a Message to Another Agent
+
+To ask another agent a question or delegate a task, use this curl command:
+
+\`\`\`bash
+curl -s -X POST http://localhost:41241/a2a/<AGENT_ID> \\
+  -H "Content-Type: application/json" \\
+  -d '{
+    "jsonrpc": "2.0",
+    "id": 1,
+    "method": "message/send",
+    "params": {
+      "message": {
+        "messageId": "'$(python3 -c "import uuid;print(uuid.uuid4())")'",
+        "kind": "message",
+        "role": "user",
+        "parts": [{"kind": "text", "text": "YOUR MESSAGE HERE"}]
+      }
+    }
+  }'
+\`\`\`
+
+Replace \`<AGENT_ID>\` with the target agent's ID (e.g., \`alice\`, \`bob\`, \`reviewer\`).
+
+## Parse the Response
+
+The response is a JSON-RPC result. Extract the agent's reply text:
+
+\`\`\`bash
+curl -s -X POST http://localhost:41241/a2a/<AGENT_ID> \\
+  -H "Content-Type: application/json" \\
+  -d '{ ... }' | python3 -c "
+import json, sys
+r = json.load(sys.stdin)
+result = r.get('result', {})
+# Check for artifacts
+artifacts = result.get('artifacts', [])
+for a in artifacts:
+    for p in a.get('parts', []):
+        if p.get('kind') == 'text':
+            print(p['text'])
+# Check for status message
+status = result.get('status', {})
+msg = status.get('message', {})
+for p in msg.get('parts', []):
+    if p.get('kind') == 'text':
+        print(p['text'])
+"
+\`\`\`
+
+## Guidelines
+
+- **Be specific** about what you need from the other agent
+- **Include context** — the other agent doesn't share your conversation history
+- **Don't loop** — if an agent can't help, handle it yourself instead of retrying
+- You can call multiple agents in sequence to build on each other's output
+`;
+function installCallAgentSkill(agentDir) {
+    const skillDir = join(agentDir, '.claude', 'skills', 'call-agent');
+    mkdirSync(skillDir, { recursive: true });
+    writeFileSync(join(skillDir, 'SKILL.md'), CALL_AGENT_SKILL);
+}
 export const DEFAULT_ARGS = {
     agentsDir: './agents',
     port: 41241,

package/dist/event-translator.js

@@ -25,6 +25,13 @@ export function createTranslator(ctx) {
             },
             final: false,
         });
+        // Also emit to monitor bus so the GUI can show speech bubbles
+        ctx.monitorBus?.emit({
+            type: 'task_status',
+            taskId: ctx.taskId,
+            state: 'working',
+            message: text.length > 80 ? text.slice(0, 77) + '...' : text,
+        });
     }
     function publishCompleted() {
         ctx.bus.publish({
@@ -38,6 +45,7 @@ export function createTranslator(ctx) {
             },
             final: true,
         });
+        ctx.monitorBus?.emit({ type: 'task_status', taskId: ctx.taskId, state: 'completed' });
         ctx.bus.finished();
     }
     function publishFailed(reason) {
@@ -60,6 +68,7 @@ export function createTranslator(ctx) {
             },
             final: true,
         });
+        ctx.monitorBus?.emit({ type: 'task_status', taskId: ctx.taskId, state: 'failed', message: reason });
         ctx.bus.finished();
     }
     function summarizeInput(input) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-dojo",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A2A-compatible Agent framework built on Claude Code SDK",
   "type": "module",
   "main": "dist/index.js",