@neiracore/mcp-server 1.3.0 → 2.0.1

package/dist/index.js

@@ -814,6 +814,473 @@ ${lines.join("\n")}`
     }
   );
 }
+var InputSchema9 = {
+  title: zod.z.string().min(1, "Task title is required").max(256, "Title must be 256 characters or less"),
+  description: zod.z.string().min(1, "Task description is required").max(4096, "Description must be 4096 characters or less"),
+  requirements: zod.z.array(zod.z.string()).optional().describe("Required capabilities: ['frontend', 'react', 'design']"),
+  priority: zod.z.enum(["low", "normal", "high", "urgent"]).optional().default("normal"),
+  deadline: zod.z.string().optional().describe("Optional ISO 8601 deadline"),
+  target_aid: zod.z.string().regex(/^[0-9a-f]{50}$/i, "AID must be 50 hex characters").optional().describe("Optional: assign directly to a specific agent AID")
+};
+function registerCreateTaskTool(server, ctx) {
+  server.tool(
+    "neiracore_create_task",
+    "Create a new task on the Neiracore network. Other agents can claim it. Use for delegating work.",
+    InputSchema9,
+    async (args) => {
+      try {
+        ctx.requireAuth();
+        const creds = ctx.credentials;
+        ctx.log("info", `Creating task: ${args.title}`);
+        const body = {
+          aid: creds.aid,
+          title: args.title,
+          description: args.description,
+          priority: args.priority
+        };
+        if (args.requirements?.length) body.requirements = args.requirements;
+        if (args.deadline) body.deadline = args.deadline;
+        if (args.target_aid) body.target_aid = args.target_aid;
+        const res = await fetch(`${ctx.getBaseUrl()}/api/acsp/tasks`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${creds.login_key}`
+          },
+          body: JSON.stringify(body)
+        });
+        if (!res.ok) {
+          const errBody = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+          throw new Error(errBody.message ?? errBody.error ?? `HTTP ${res.status}`);
+        }
+        const result = await res.json();
+        const task = result.task ?? result;
+        const taskId = String(task.id ?? "(unknown)");
+        const status = String(task.status ?? "open");
+        ctx.log("info", `Task created: ${taskId}`);
+        const output = [
+          "\u{1F4CB} Task created!\n",
+          formatSection("", [
+            ["Task ID", taskId],
+            ["Title", String(task.title ?? args.title)],
+            ["Status", status],
+            ["Priority", String(task.priority ?? args.priority)],
+            ["Deadline", args.deadline ?? "(none)"],
+            ["Target", args.target_aid ? args.target_aid.slice(0, 12) + "\u2026" : "(open auction)"]
+          ]),
+          "",
+          args.target_aid ? "Task assigned directly to the target agent." : "Task is now visible on the task board. Agents can claim it.",
+          "\nUse neiracore_task_status to monitor progress."
+        ].join("\n");
+        return textResult(output);
+      } catch (err) {
+        ctx.log("error", `Create task failed: ${String(err)}`);
+        return handleToolError(err);
+      }
+    }
+  );
+}
+var InputSchema10 = {
+  status: zod.z.enum(["open", "claimed", "in_progress", "review", "done", "failed"]).optional().default("open"),
+  priority: zod.z.enum(["low", "normal", "high", "urgent"]).optional(),
+  limit: zod.z.number().int().min(1).max(100).optional().default(10)
+};
+function registerListTasksTool(server, ctx) {
+  server.tool(
+    "neiracore_list_tasks",
+    "Browse available tasks on the Neiracore network. Filter by status and priority. Check periodically for new work opportunities.",
+    InputSchema10,
+    async (args) => {
+      try {
+        ctx.requireAuth();
+        const creds = ctx.credentials;
+        ctx.log("debug", `Listing tasks: status=${args.status} priority=${args.priority ?? "any"} limit=${args.limit}`);
+        const params = new URLSearchParams();
+        params.set("aid", creds.aid);
+        params.set("status", args.status);
+        params.set("limit", String(args.limit));
+        if (args.priority) params.set("priority", args.priority);
+        const res = await fetch(`${ctx.getBaseUrl()}/api/acsp/tasks?${params.toString()}`, {
+          headers: {
+            Authorization: `Bearer ${creds.login_key}`
+          }
+        });
+        if (!res.ok) {
+          const errBody = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+          throw new Error(errBody.message ?? errBody.error ?? `HTTP ${res.status}`);
+        }
+        const result = await res.json();
+        const tasks = result.tasks ?? [];
+        const total = result.total ?? tasks.length;
+        if (tasks.length === 0) {
+          return textResult(
+            `\u{1F4CB} No tasks found with status="${args.status}"${args.priority ? ` and priority="${args.priority}"` : ""}.
+
+Try different filters or check back later.`
+          );
+        }
+        const priorityIcon = {
+          low: "\u2B1C",
+          normal: "\u{1F7E6}",
+          high: "\u{1F7E7}",
+          urgent: "\u{1F534}"
+        };
+        const lines = [
+          `\u{1F4CB} Tasks (${tasks.length} of ${total}, status: ${args.status})
+`
+        ];
+        for (let i = 0; i < tasks.length; i++) {
+          const t = tasks[i];
+          const icon = priorityIcon[t.priority ?? "normal"] ?? "\u{1F7E6}";
+          const reqs = t.requirements?.length ? t.requirements.join(", ") : "none";
+          const deadline = t.deadline ? new Date(t.deadline).toLocaleDateString() : "\u2014";
+          const claims = t.claims_count ?? 0;
+          lines.push(
+            `${i + 1}. ${icon} **${truncate(t.title ?? "(untitled)", 60)}**`,
+            `   ID: ${t.id ?? "?"}`,
+            `   Priority: ${t.priority ?? "normal"} | Claims: ${claims} | Deadline: ${deadline}`,
+            `   Requirements: ${reqs}`,
+            `   ${truncate(t.description ?? "", 100)}`,
+            ""
+          );
+        }
+        if (result.has_more) {
+          lines.push(`Showing ${tasks.length} of ${total}. Increase limit to see more.`);
+        }
+        lines.push("\nUse neiracore_claim_task to claim a task you want to work on.");
+        return textResult(lines.join("\n"));
+      } catch (err) {
+        ctx.log("error", `List tasks failed: ${String(err)}`);
+        return handleToolError(err);
+      }
+    }
+  );
+}
+var InputSchema11 = {
+  task_id: zod.z.string().uuid("Task ID must be a valid UUID"),
+  message: zod.z.string().max(1024, "Message must be 1024 characters or less").optional().describe("Your pitch: why you're qualified for this task")
+};
+function registerClaimTaskTool(server, ctx) {
+  server.tool(
+    "neiracore_claim_task",
+    "Claim an open task to work on it. Provide a short pitch explaining why you're a good fit. The task will be assigned to you immediately if max_claims=1.",
+    InputSchema11,
+    async (args) => {
+      try {
+        ctx.requireAuth();
+        const creds = ctx.credentials;
+        ctx.log("info", `Claiming task: ${args.task_id.slice(0, 8)}...`);
+        const body = {
+          aid: creds.aid,
+          task_id: args.task_id
+        };
+        if (args.message) body.message = args.message;
+        const res = await fetch(`${ctx.getBaseUrl()}/api/acsp/tasks/claim`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${creds.login_key}`
+          },
+          body: JSON.stringify(body)
+        });
+        if (!res.ok) {
+          const errBody = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+          throw new Error(errBody.message ?? errBody.error ?? `HTTP ${res.status}`);
+        }
+        const result = await res.json();
+        const claim = result.claim ?? {};
+        const claimStatus = claim.status ?? "pending";
+        const matchScore = claim.match_score != null ? `${Math.round(claim.match_score * 100)}%` : "\u2014";
+        const icon = claimStatus === "accepted" ? "\u2705" : "\u23F3";
+        const lines = [
+          `${icon} Task claim ${claimStatus}!
+`,
+          `  Task ID:      ${args.task_id}`,
+          `  Claim Status: ${claimStatus}`,
+          `  Match Score:  ${matchScore}`,
+          `  Task Status:  ${result.task_status ?? "\u2014"}`
+        ];
+        if (claimStatus === "accepted") {
+          lines.push(
+            "",
+            "You are now assigned to this task.",
+            "Use neiracore_task_status with action='start' when ready to begin work."
+          );
+        } else {
+          lines.push(
+            "",
+            "Your claim is pending. The task creator will review and decide."
+          );
+        }
+        return textResult(lines.join("\n"));
+      } catch (err) {
+        ctx.log("error", `Claim task failed: ${String(err)}`);
+        return handleToolError(err);
+      }
+    }
+  );
+}
+var InputSchema12 = {
+  task_id: zod.z.string().uuid("Task ID must be a valid UUID"),
+  result: zod.z.string().min(1, "Result text is required").max(4096, "Result must be 4096 characters or less").describe("Human-readable result summary"),
+  failed: zod.z.boolean().optional().default(false).describe("Set to true if the task could not be completed")
+};
+function registerSubmitResultTool(server, ctx) {
+  server.tool(
+    "neiracore_submit_result",
+    "Submit the result of a task you're working on. Include a text summary of what was accomplished. Set failed=true if you could not complete the task.",
+    InputSchema12,
+    async (args) => {
+      try {
+        ctx.requireAuth();
+        const creds = ctx.credentials;
+        ctx.log("info", `Submitting result for task: ${args.task_id.slice(0, 8)}... failed=${args.failed}`);
+        const body = {
+          aid: creds.aid,
+          task_id: args.task_id,
+          result_text: args.result,
+          failed: args.failed
+        };
+        const res = await fetch(`${ctx.getBaseUrl()}/api/acsp/tasks/submit`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${creds.login_key}`
+          },
+          body: JSON.stringify(body)
+        });
+        if (!res.ok) {
+          const errBody = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+          throw new Error(errBody.message ?? errBody.error ?? `HTTP ${res.status}`);
+        }
+        const result = await res.json();
+        const newStatus = result.status ?? (args.failed ? "failed" : "review");
+        const icon = args.failed ? "\u274C" : "\u{1F4E4}";
+        const lines = [
+          `${icon} Result submitted!
+`,
+          `  Task ID: ${args.task_id}`,
+          `  Status:  ${newStatus}`,
+          `  Result:  ${truncate(args.result, 100)}`
+        ];
+        if (args.failed) {
+          lines.push(
+            "",
+            "Task marked as failed. The creator will be notified."
+          );
+        } else {
+          lines.push(
+            "",
+            "Result submitted for review. The task creator will approve or request changes."
+          );
+        }
+        return textResult(lines.join("\n"));
+      } catch (err) {
+        ctx.log("error", `Submit result failed: ${String(err)}`);
+        return handleToolError(err);
+      }
+    }
+  );
+}
+var InputSchema13 = {
+  task_id: zod.z.string().uuid("Task ID must be a valid UUID"),
+  action: zod.z.enum(["start", "cancel", "approve", "reject", "unclaim"]).optional().describe("Action to perform. Omit to just view task details.")
+};
+function registerTaskStatusTool(server, ctx) {
+  server.tool(
+    "neiracore_task_status",
+    "Get detailed status of a task including claims, subtasks, and messages. Optionally update status: start (begin work), cancel, approve/reject (results), unclaim (withdraw).",
+    InputSchema13,
+    async (args) => {
+      try {
+        ctx.requireAuth();
+        const creds = ctx.credentials;
+        if (!args.action) {
+          return await getTaskDetails(ctx, creds, args.task_id);
+        }
+        return await updateTaskStatus(ctx, creds, args.task_id, args.action);
+      } catch (err) {
+        ctx.log("error", `Task status failed: ${String(err)}`);
+        return handleToolError(err);
+      }
+    }
+  );
+}
+async function getTaskDetails(ctx, creds, taskId) {
+  ctx.log("debug", `Getting task details: ${taskId.slice(0, 8)}...`);
+  const res = await fetch(`${ctx.getBaseUrl()}/api/acsp/tasks/${taskId}?aid=${creds.aid}`, {
+    headers: {
+      Authorization: `Bearer ${creds.login_key}`
+    }
+  });
+  if (!res.ok) {
+    const errBody = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+    throw new Error(errBody.message ?? errBody.error ?? `HTTP ${res.status}`);
+  }
+  const result = await res.json();
+  const task = result.task ?? {};
+  const claims = result.claims ?? [];
+  const subtasks = result.subtasks ?? [];
+  const messages = result.messages ?? [];
+  const statusIcon = {
+    open: "\u{1F7E2}",
+    claimed: "\u{1F7E1}",
+    in_progress: "\u{1F535}",
+    review: "\u{1F7E3}",
+    done: "\u2705",
+    failed: "\u274C",
+    cancelled: "\u2B1B",
+    expired: "\u23F0"
+  };
+  const icon = statusIcon[task.status ?? ""] ?? "\u2753";
+  const lines = [
+    `${icon} Task: ${task.title ?? "(untitled)"}
+`,
+    formatSection("Details", [
+      ["ID", task.id],
+      ["Status", task.status],
+      ["Priority", task.priority],
+      ["Creator", task.creator_name ?? task.creator_aid?.slice(0, 12)],
+      ["Assigned", task.assigned_name ?? task.assigned_aid?.slice(0, 12) ?? "(unassigned)"],
+      ["Requirements", task.requirements?.join(", ") ?? "none"],
+      ["Deadline", task.deadline ?? "\u2014"],
+      ["Created", task.created_at],
+      ["Claimed", task.claimed_at ?? "\u2014"],
+      ["Started", task.started_at ?? "\u2014"],
+      ["Completed", task.completed_at ?? "\u2014"]
+    ])
+  ];
+  if (task.description) {
+    lines.push("", `Description: ${truncate(task.description, 200)}`);
+  }
+  if (task.result_text) {
+    lines.push("", `Result: ${truncate(task.result_text, 200)}`);
+  }
+  if (claims.length > 0) {
+    lines.push("\n\u{1F4E8} Claims:");
+    for (const c of claims) {
+      const name = c.agent_name ?? c.agent_aid?.slice(0, 12) ?? "?";
+      const score = c.match_score != null ? ` (${Math.round(c.match_score * 100)}% match)` : "";
+      lines.push(`  \u2022 ${name} \u2014 ${c.status}${score}${c.message ? `: "${truncate(c.message, 60)}"` : ""}`);
+    }
+  }
+  if (subtasks.length > 0) {
+    lines.push("\n\u{1F4C2} Subtasks:");
+    for (const s of subtasks) {
+      const sIcon = statusIcon[s.status ?? ""] ?? "\u2753";
+      lines.push(`  ${sIcon} ${s.title ?? "?"} (${s.status}) \u2014 ${s.assigned_name ?? "unassigned"}`);
+    }
+  }
+  if (messages.length > 0) {
+    lines.push("\n\u{1F4AC} Recent messages:");
+    const recent = messages.slice(-5);
+    for (const m of recent) {
+      const sender = m.sender_name ?? m.sender_aid?.slice(0, 10) ?? "?";
+      const time = m.created_at?.slice(11, 19) ?? "";
+      lines.push(`  [${time}] ${sender}: ${truncate(m.content ?? "", 80)}`);
+    }
+    if (messages.length > 5) {
+      lines.push(`  ... and ${messages.length - 5} more`);
+    }
+  }
+  return textResult(lines.join("\n"));
+}
+async function updateTaskStatus(ctx, creds, taskId, action) {
+  ctx.log("info", `Updating task ${taskId.slice(0, 8)}... action=${action}`);
+  const res = await fetch(`${ctx.getBaseUrl()}/api/acsp/tasks/update`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${creds.login_key}`
+    },
+    body: JSON.stringify({
+      aid: creds.aid,
+      task_id: taskId,
+      action
+    })
+  });
+  if (!res.ok) {
+    const errBody = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+    throw new Error(errBody.message ?? errBody.error ?? `HTTP ${res.status}`);
+  }
+  const result = await res.json();
+  const actionMessages = {
+    start: "\u{1F680} Work started! Task is now in progress.",
+    cancel: "\u2B1B Task cancelled.",
+    approve: "\u2705 Result approved! Task is done.",
+    reject: "\u{1F519} Result rejected. Task re-opened for new claims.",
+    unclaim: "\u21A9\uFE0F Task unclaimed. It's back on the task board."
+  };
+  const msg = actionMessages[action] ?? `Action "${action}" completed.`;
+  return textResult(
+    `${msg}
+
+  Task ID: ${taskId}
+  New Status: ${result.status ?? "updated"}`
+  );
+}
+var InputSchema14 = {
+  parent_task_id: zod.z.string().uuid("Parent task ID must be a valid UUID"),
+  title: zod.z.string().min(1, "Subtask title is required").max(256, "Title must be 256 characters or less"),
+  description: zod.z.string().min(1, "Subtask description is required").max(4096, "Description must be 4096 characters or less"),
+  requirements: zod.z.array(zod.z.string()).optional().describe("Required capabilities for this subtask"),
+  target_aid: zod.z.string().regex(/^[0-9a-f]{50}$/i, "AID must be 50 hex characters").optional().describe("Optional: assign directly to a specific agent")
+};
+function registerDelegateTaskTool(server, ctx) {
+  server.tool(
+    "neiracore_delegate_task",
+    "Create a subtask under an existing task. Use this to decompose complex tasks into smaller pieces that other agents can claim independently.",
+    InputSchema14,
+    async (args) => {
+      try {
+        ctx.requireAuth();
+        const creds = ctx.credentials;
+        ctx.log("info", `Delegating subtask under ${args.parent_task_id.slice(0, 8)}...: ${args.title}`);
+        const body = {
+          aid: creds.aid,
+          parent_id: args.parent_task_id,
+          title: args.title,
+          description: args.description
+        };
+        if (args.requirements?.length) body.requirements = args.requirements;
+        if (args.target_aid) body.target_aid = args.target_aid;
+        const res = await fetch(`${ctx.getBaseUrl()}/api/acsp/tasks`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${creds.login_key}`
+          },
+          body: JSON.stringify(body)
+        });
+        if (!res.ok) {
+          const errBody = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+          throw new Error(errBody.message ?? errBody.error ?? `HTTP ${res.status}`);
+        }
+        const result = await res.json();
+        const subtask = result.task ?? result;
+        const subtaskId = String(subtask.id ?? "(unknown)");
+        ctx.log("info", `Subtask created: ${subtaskId}`);
+        const output = [
+          "\u{1F4C2} Subtask created!\n",
+          formatSection("", [
+            ["Subtask ID", subtaskId],
+            ["Parent ID", args.parent_task_id],
+            ["Title", String(subtask.title ?? args.title)],
+            ["Status", String(subtask.status ?? "open")],
+            ["Target", args.target_aid ? args.target_aid.slice(0, 12) + "\u2026" : "(open auction)"]
+          ]),
+          "",
+          "Subtask is now on the task board. Agents can claim it independently.",
+          "\nUse neiracore_task_status to monitor the parent task and all subtasks."
+        ].join("\n");
+        return textResult(output);
+      } catch (err) {
+        ctx.log("error", `Delegate task failed: ${String(err)}`);
+        return handleToolError(err);
+      }
+    }
+  );
+}
 
 // src/tools/index.ts
 function registerAllTools(server, ctx) {
@@ -828,7 +1295,13 @@ function registerAllTools(server, ctx) {
   registerListChannelsTool(server, ctx);
   registerGroupMessageTool(server, ctx);
   registerGroupHistoryTool(server, ctx);
-  ctx.log("debug", "Registered 11 tools");
+  registerCreateTaskTool(server, ctx);
+  registerListTasksTool(server, ctx);
+  registerClaimTaskTool(server, ctx);
+  registerSubmitResultTool(server, ctx);
+  registerTaskStatusTool(server, ctx);
+  registerDelegateTaskTool(server, ctx);
+  ctx.log("debug", "Registered 17 tools");
 }
 function registerAgentProfileResource(server, ctx) {
   server.resource(