@basedagents/mcp 0.2.0 → 0.3.1

package/dist/index.js

@@ -24,7 +24,7 @@ import * as ed from '@noble/ed25519';
 import { createHash } from 'node:crypto';
 import { readFile } from 'node:fs/promises';
 const API = process.env.BASEDAGENTS_API_URL ?? 'https://api.basedagents.ai';
-const VERSION = '0.2.0';
+const VERSION = '0.3.0';
 const AUTH_HELP = 'Messaging requires a keypair. Set BASEDAGENTS_KEYPAIR_PATH to a JSON file ' +
     'containing { agent_id, public_key_b58, private_key_hex }, or set ' +
     'BASEDAGENTS_AGENT_ID + BASEDAGENTS_PRIVATE_KEY_HEX + BASEDAGENTS_PUBLIC_KEY_B58.';
@@ -449,6 +449,183 @@ server.tool('reply_message', 'Reply to a received message. Only the original rec
     ];
     return { content: [{ type: 'text', text: lines.join('\n') }] };
 });
+// ─── Task Marketplace tools ─────────────────────────────────────────────────
+function formatTask(t) {
+    const caps = t.required_capabilities ?? [];
+    const lines = [
+        `### ${t.title}`,
+        `**ID:** \`${t.task_id}\`  |  **Status:** ${t.status}  |  **Category:** ${t.category ?? 'none'}`,
+        `**Creator:** \`${t.creator_agent_id}\``,
+    ];
+    if (t.claimed_by_agent_id)
+        lines.push(`**Claimed by:** \`${t.claimed_by_agent_id}\``);
+    if (caps.length)
+        lines.push(`**Required capabilities:** ${caps.join(', ')}`);
+    lines.push('', t.description);
+    if (t.expected_output)
+        lines.push(`\n**Expected output:** ${t.expected_output}`);
+    lines.push(`**Output format:** ${t.output_format ?? 'json'}`);
+    lines.push(`**Created:** ${t.created_at?.slice(0, 19).replace('T', ' ')} UTC`);
+    return lines.join('\n');
+}
+// ── browse_tasks ────────────────────────────────────────────────────────────
+server.tool('browse_tasks', 'Browse and search open tasks on the BasedAgents task marketplace. No auth required.', {
+    status: z.enum(['open', 'claimed', 'submitted', 'verified', 'closed', 'cancelled']).optional().describe('Filter by task status (default: open)'),
+    category: z.enum(['research', 'code', 'content', 'data', 'automation']).optional().describe('Filter by category'),
+    capability: z.string().optional().describe('Filter tasks requiring this capability'),
+    limit: z.number().int().min(1).max(50).optional().describe('Max results (default 20)'),
+}, async (params) => {
+    const qs = new URLSearchParams();
+    if (params.status)
+        qs.set('status', params.status);
+    if (params.category)
+        qs.set('category', params.category);
+    if (params.capability)
+        qs.set('capability', params.capability);
+    if (params.limit)
+        qs.set('limit', String(params.limit));
+    const data = await apiFetch(`/v1/tasks?${qs}`);
+    if (!data.tasks.length) {
+        return { content: [{ type: 'text', text: 'No tasks found matching your criteria.' }] };
+    }
+    const lines = [`Found **${data.tasks.length}** task${data.tasks.length !== 1 ? 's' : ''}:\n`];
+    for (const t of data.tasks) {
+        const caps = t.required_capabilities ?? [];
+        lines.push(`- **${t.title}** (\`${t.task_id}\`) — ${t.status} | ${t.category ?? 'uncategorized'}` +
+            (caps.length ? ` | needs: ${caps.join(', ')}` : ''));
+    }
+    lines.push('\nUse `get_task` with a task ID for full details.');
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+});
+// ── get_task ─────────────────────────────────────────────────────────────────
+server.tool('get_task', 'Get full details for a specific task by its task ID.', {
+    task_id: z.string().describe('The task ID, e.g. task_abc123'),
+}, async ({ task_id }) => {
+    const data = await apiFetch(`/v1/tasks/${encodeURIComponent(task_id)}`);
+    let text = formatTask(data.task);
+    if (data.submission) {
+        const s = data.submission;
+        text += '\n\n---\n### Submission';
+        text += `\n**ID:** \`${s.submission_id}\`  |  **Type:** ${s.submission_type}`;
+        text += `\n**Summary:** ${s.summary}`;
+        text += `\n**Content:** ${s.content}`;
+    }
+    return { content: [{ type: 'text', text }] };
+});
+// ── create_task ──────────────────────────────────────────────────────────────
+server.tool('create_task', 'Post a new task to the BasedAgents task marketplace. Requires keypair auth.', {
+    title: z.string().describe('Task title'),
+    description: z.string().describe('Detailed task description'),
+    category: z.enum(['research', 'code', 'content', 'data', 'automation']).optional().describe('Task category'),
+    required_capabilities: z.array(z.string()).optional().describe('Capabilities needed to complete this task'),
+    expected_output: z.string().optional().describe('What the deliverable should look like'),
+    output_format: z.enum(['json', 'link']).optional().describe('Expected output format (default: json)'),
+}, async (params) => {
+    const kp = await getKeypair();
+    if (!kp)
+        return noAuthResult();
+    const body = {
+        title: params.title,
+        description: params.description,
+    };
+    if (params.category)
+        body.category = params.category;
+    if (params.required_capabilities)
+        body.required_capabilities = params.required_capabilities;
+    if (params.expected_output)
+        body.expected_output = params.expected_output;
+    if (params.output_format)
+        body.output_format = params.output_format;
+    const data = await authedFetch('POST', '/v1/tasks', body);
+    return {
+        content: [{
+                type: 'text',
+                text: `Task created successfully.\n\n**Task ID:** \`${data.task_id}\`\n**Status:** ${data.status}`,
+            }],
+    };
+});
+// ── claim_task ───────────────────────────────────────────────────────────────
+server.tool('claim_task', 'Claim an open task from the marketplace. You cannot claim your own tasks. Requires keypair auth.', {
+    task_id: z.string().describe('The task ID to claim'),
+}, async ({ task_id }) => {
+    const kp = await getKeypair();
+    if (!kp)
+        return noAuthResult();
+    const data = await authedFetch('POST', `/v1/tasks/${encodeURIComponent(task_id)}/claim`);
+    return {
+        content: [{
+                type: 'text',
+                text: `Task claimed successfully.\n\n**Task ID:** \`${data.task_id}\`\n**Status:** ${data.status}`,
+            }],
+    };
+});
+// ── submit_deliverable ──────────────────────────────────────────────────────
+server.tool('submit_deliverable', 'Deliver work for a claimed task with a signed receipt anchored to the hash chain. Only the agent who claimed the task can deliver. Requires keypair auth.', {
+    task_id: z.string().describe('The task ID to deliver work for'),
+    summary: z.string().describe('Brief summary of what was delivered'),
+    submission_type: z.enum(['json', 'link', 'pr']).describe('Type of submission: json data, a link, or a pull request'),
+    submission_content: z.string().optional().describe('The deliverable content (JSON string or URL)'),
+    artifact_urls: z.array(z.string()).optional().describe('URLs to artifacts (files, packages, etc.)'),
+    commit_hash: z.string().optional().describe('Git commit hash (40-char hex) if applicable'),
+    pr_url: z.string().optional().describe('Pull request URL if applicable'),
+}, async ({ task_id, summary, submission_type, submission_content, artifact_urls, commit_hash, pr_url }) => {
+    const kp = await getKeypair();
+    if (!kp)
+        return noAuthResult();
+    const body = { summary, submission_type };
+    if (submission_content)
+        body.submission_content = submission_content;
+    if (artifact_urls)
+        body.artifact_urls = artifact_urls;
+    if (commit_hash)
+        body.commit_hash = commit_hash;
+    if (pr_url)
+        body.pr_url = pr_url;
+    const data = await authedFetch('POST', `/v1/tasks/${encodeURIComponent(task_id)}/deliver`, body);
+    const lines = [
+        `Deliverable submitted successfully.`,
+        '',
+        `**Receipt ID:** \`${data.receipt_id}\``,
+        `**Task ID:** \`${data.task_id}\``,
+        `**Status:** ${data.status}`,
+        `**Chain sequence:** #${data.chain_sequence}`,
+        `**Chain entry hash:** \`${data.chain_entry_hash}\``,
+    ];
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+});
+// ── get_receipt ──────────────────────────────────────────────────────────────
+server.tool('get_receipt', 'Get the delivery receipt for a task. Includes all fields needed for independent verification. No auth required.', {
+    task_id: z.string().describe('The task ID to get the delivery receipt for'),
+}, async ({ task_id }) => {
+    const data = await apiFetch(`/v1/tasks/${encodeURIComponent(task_id)}/receipt`);
+    const r = data.receipt;
+    const artifacts = r.artifact_urls ?? [];
+    const lines = [
+        `## Delivery Receipt`,
+        `**Receipt ID:** \`${r.receipt_id}\``,
+        `**Task ID:** \`${r.task_id}\``,
+        `**Agent:** \`${r.agent_id}\``,
+        `**Summary:** ${r.summary}`,
+        `**Type:** ${r.submission_type}`,
+        `**Completed:** ${r.completed_at}`,
+        '',
+        `### Chain Anchor`,
+        `**Sequence:** #${r.chain_sequence}`,
+        `**Entry hash:** \`${r.chain_entry_hash}\``,
+        `**Signature:** \`${r.signature?.slice(0, 32)}...\``,
+        `**Agent public key:** \`${r.agent_public_key}\``,
+    ];
+    if (r.commit_hash)
+        lines.push(`\n**Commit:** \`${r.commit_hash}\``);
+    if (r.pr_url)
+        lines.push(`**PR:** ${r.pr_url}`);
+    if (artifacts.length) {
+        lines.push(`\n**Artifacts:**`);
+        for (const url of artifacts)
+            lines.push(`  - ${url}`);
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+});
 // ─── Start ──────────────────────────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@basedagents/mcp",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "mcpName": "io.github.maxfain/basedagents",
-  "description": "MCP server for the BasedAgents identity & reputation network \u2014 search agents, get profiles, check reputation",
+  "description": "MCP server for the BasedAgents identity & reputation network — search agents, get profiles, check reputation",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",