@bountyagents/bountyagents-task 2026.2.279 → 2026.2.2711

package/dist/index.js

@@ -55176,6 +55176,12 @@ var taskFundSignaturePayload = (input) => canonicalStringify({
   taskId: input.taskId,
   token: input.token
 });
+var responseSignaturePayload = (input) => canonicalStringify({
+  kind: "task:response",
+  taskId: input.taskId,
+  payload: input.payload,
+  id: input.id ?? null
+});
 var decisionSignaturePayload = (input) => canonicalStringify({
   kind: "task:decision",
   responseId: input.responseId,
@@ -55188,6 +55194,12 @@ var cancelTaskSignaturePayload = (input) => canonicalStringify({
   kind: "task:cancel",
   taskId: input.taskId
 });
+var taskSettleSignaturePayload = (input) => canonicalStringify({
+  kind: "task:settle",
+  taskId: input.taskId,
+  responseId: input.responseId,
+  workerAddress: input.workerAddress
+});
 var taskResponsesQuerySignaturePayload = (input) => canonicalStringify({
   kind: "task:response:query",
   taskId: input.taskId,
@@ -55196,6 +55208,13 @@ var taskResponsesQuerySignaturePayload = (input) => canonicalStringify({
   pageSize: input.pageSize ?? 50,
   pageNum: input.pageNum ?? 0
 });
+var workerResponsesQuerySignaturePayload = (input) => canonicalStringify({
+  kind: "worker:response:query",
+  workerAddress: input.workerAddress,
+  taskId: input.taskId ?? null,
+  pageSize: input.pageSize ?? 50,
+  pageNum: input.pageNum ?? 0
+});
 
 // src/token.ts
 var parseTokenIdentifier = (token) => {
@@ -55389,6 +55408,65 @@ class BountyAgentsPublisherPlugin extends BaseBountyPlugin {
   }
 }
 
+class BountyAgentsWorkerPlugin extends BaseBountyPlugin {
+  constructor(signer, options) {
+    super(signer, options);
+    this.registerTool("bountyagents.worker.task.respond", "Submit a response for an active task", submitResponsePayloadSchema, (input) => this.submitResponse(input));
+    this.registerTool("bountyagents.worker.response.query", "List responses submitted by this worker", workerResponsesQueryPayloadSchema, (input) => this.queryWorkerResponses(input));
+    this.registerTool("bountyagents.worker.task.query", "Search tasks with keyword, publisher and price filters", taskQueryPayloadSchema, (input) => this.queryTasks(input));
+  }
+  async queryTasks(payload) {
+    const canonicalFilter = payload.filter ?? {};
+    const pageSize = payload.pageSize ?? 50;
+    const pageNum = payload.pageNum ?? 0;
+    const body = {
+      filter: canonicalFilter,
+      sortBy: payload.sortBy ?? "created_at",
+      pageSize,
+      pageNum
+    };
+    const response = await this.request("/tasks/query", body);
+    return tasksListSchema.parse(response).tasks;
+  }
+  async submitResponse(payload) {
+    const body = {
+      ...payload,
+      workerAddress: this.signer.address,
+      signature: await this.signPayload(responseSignaturePayload(payload))
+    };
+    const response = await this.request(`/tasks/${payload.taskId}/responses`, body);
+    return submissionResponseSchema.parse(response).response;
+  }
+  async queryWorkerResponses(payload) {
+    const pageSize = payload.pageSize ?? 50;
+    const pageNum = payload.pageNum ?? 0;
+    const canonicalPayload = {
+      taskId: payload.taskId,
+      pageSize,
+      pageNum
+    };
+    const body = {
+      ...canonicalPayload,
+      workerAddress: this.signer.address,
+      signature: await this.signPayload(workerResponsesQuerySignaturePayload({
+        ...canonicalPayload,
+        workerAddress: this.signer.address
+      }))
+    };
+    const response = await this.request("/workers/responses/query", body);
+    return responsesListSchema.parse(response).responses;
+  }
+  async settleTask(payload) {
+    const canonicalPayload = { ...payload, workerAddress: this.signer.address };
+    const body = {
+      ...canonicalPayload,
+      signature: await this.signPayload(taskSettleSignaturePayload(canonicalPayload))
+    };
+    const response = await this.request(`/tasks/${payload.taskId}/settle`, body);
+    return settleResponseSchema.parse(response);
+  }
+}
+
 // src/signers.ts
 class PrivateKeySigner {
   account;
@@ -55610,9 +55688,58 @@ function registerPublisherTools(api3) {
   });
 }
 
+// src/worker.ts
+var SERVICE_URL2 = "http://localhost:3000";
+var CONTRACT_ADDRESS2 = "0x55D45aFA265d0381C8A81328FfeA408D2Dd45F40";
+var PRIVATE_KEY2 = "0x289f92dd30c36ff24b75b48623c70dea2b428dabac7a52c5ca810bcda64d861b";
+async function getAvailableTask(params) {
+  const signer = new PrivateKeySigner(PRIVATE_KEY2);
+  const plugin = new BountyAgentsWorkerPlugin(signer, {
+    serviceUrl: SERVICE_URL2,
+    contractAddress: CONTRACT_ADDRESS2
+  });
+  const tasks = await plugin.executeTool("bountyagents.worker.task.query", {
+    filter: {
+      status: "active"
+    },
+    pageSize: params.pageSize,
+    pageNum: params.pageNum
+  });
+  if (tasks.length === 0) {
+    return null;
+  }
+  return tasks[0];
+}
+function registerWorkerTools(api3) {
+  api3.registerTool({
+    name: "get_available_task",
+    description: "Get available active bounty task for the worker to work on and respond to.",
+    parameters: Type.Object({
+      pageSize: Type.Optional(Type.Number()),
+      pageNum: Type.Optional(Type.Number()),
+      keyword: Type.Optional(Type.String())
+    }),
+    async execute(_id, params) {
+      try {
+        const result = await getAvailableTask({
+          pageSize: params.pageSize,
+          pageNum: params.pageNum,
+          keyword: ""
+        });
+        return json(result);
+      } catch (error48) {
+        return json({
+          error: error48 instanceof Error ? error48.message : String(error48)
+        });
+      }
+    }
+  });
+}
+
 // index.ts
 function register(api3) {
   registerPublisherTools(api3);
+  registerWorkerTools(api3);
 }
 export {
   register as default

package/index.ts

@@ -1,4 +1,5 @@
 import { registerPublisherTools } from "./src/publisher.js";
+import { registerWorkerTools } from "./src/worker.js";
 
 export default function register(api: any) {
   // api.registerCommand({
@@ -47,5 +48,6 @@ export default function register(api: any) {
   //   },
   // });
 
- registerPublisherTools(api);
+  registerPublisherTools(api);
+  registerWorkerTools(api);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bountyagents/bountyagents-task",
-  "version": "2026.2.279",
+  "version": "2026.2.2711",
   "description": "BountyAgents Task Plugin for OpenClaw",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -343,13 +343,29 @@ export class BountyAgentsWorkerPlugin extends BaseBountyPlugin {
       (input) => this.queryWorkerResponses(input)
     );
     this.registerTool(
-      "bountyagents.worker.task.settle",
-      "Fetch settlement signature for an approved response",
-      settleTaskPayloadSchema,
-      (input) => this.settleTask(input)
+      "bountyagents.worker.task.query",
+      "Search tasks with keyword, publisher and price filters",
+      taskQueryPayloadSchema,
+      (input) => this.queryTasks(input)
     );
   }
 
+  private async queryTasks(payload: TaskQueryPayload): Promise<TaskRecord[]> {
+    const canonicalFilter = (payload.filter ?? {}) as NonNullable<
+      TaskQueryPayload["filter"]
+    >;
+    const pageSize = payload.pageSize ?? 50;
+    const pageNum = payload.pageNum ?? 0;
+    const body = {
+      filter: canonicalFilter,
+      sortBy: payload.sortBy ?? "created_at",
+      pageSize,
+      pageNum,
+    };
+    const response = await this.request("/tasks/query", body);
+    return tasksListSchema.parse(response).tasks;
+  }
+
   private async submitResponse(
     payload: SubmitResponsePayload
   ): Promise<ResponseRecord> {

package/src/worker.ts

@@ -0,0 +1,60 @@
+import { Type } from "@sinclair/typebox";
+import { PrivateKeySigner } from "./signers.js";
+import { BountyAgentsWorkerPlugin } from "./index.js";
+import { json } from "./helper.js";
+
+const SERVICE_URL = "http://localhost:3000";
+const CONTRACT_ADDRESS = "0x55D45aFA265d0381C8A81328FfeA408D2Dd45F40";
+const PRIVATE_KEY =
+  "0x289f92dd30c36ff24b75b48623c70dea2b428dabac7a52c5ca810bcda64d861b";
+
+export async function getAvailableTask(params: {
+  keyword?: string;
+  pageSize?: number;
+  pageNum?: number;
+}) {
+  const signer = new PrivateKeySigner(PRIVATE_KEY);
+  const plugin = new BountyAgentsWorkerPlugin(signer, {
+    serviceUrl: SERVICE_URL,
+    contractAddress: CONTRACT_ADDRESS,
+  });
+
+  const tasks = (await plugin.executeTool("bountyagents.worker.task.query", {
+    filter: {
+      status: "active",
+    },
+    pageSize: params.pageSize,
+    pageNum: params.pageNum,
+  })) as any;
+  if (tasks.length === 0) {
+    return null;
+  }
+  return tasks[0];
+}
+
+export function registerWorkerTools(api: any) {
+  api.registerTool({
+    name: "get_available_task",
+    description:
+      "Get available active bounty task for the worker to work on and respond to.",
+    parameters: Type.Object({
+      pageSize: Type.Optional(Type.Number()),
+      pageNum: Type.Optional(Type.Number()),
+      keyword: Type.Optional(Type.String()),
+    }),
+    async execute(_id: string, params: any) {
+      try {
+        const result = await getAvailableTask({
+          pageSize: params.pageSize,
+          pageNum: params.pageNum,
+          keyword: "",
+        });
+        return json(result);
+      } catch (error: any) {
+        return json({
+          error: error instanceof Error ? error.message : String(error),
+        });
+      }
+    },
+  });
+}

package/test-worker.ts

@@ -0,0 +1,25 @@
+import { getAvailableTask } from "./src/worker.js";
+
+async function testGetAvailableTasks() {
+  console.log(`\n--- Testing getAvailableTasks ---`);
+
+  try {
+    const task = await getAvailableTask({
+      pageSize: 5,
+      pageNum: 0,
+      keyword: "",
+    });
+
+    if (task) {
+      console.log("First task sample:");
+      console.log(JSON.stringify(task, null, 2));
+    } else {
+      console.log("No active tasks found.");
+    }
+  } catch (error) {
+    console.error("Test failed:");
+    console.error(error);
+  }
+}
+
+testGetAvailableTasks();