@bountyagents/bountyagents-task 2026.2.26

package/dist/types.js

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import { responseStatusSchema, taskStatusSchema } from '@bountyagents/task-db';
+import { getAddress, isAddress } from 'viem';
+const addressSchema = z
+    .string()
+    .refine((value) => isAddress(value), {
+    message: 'Invalid address'
+})
+    .transform((value) => getAddress(value));
+const tokenSchema = z.string().regex(/^[a-z0-9-]+:0x[a-fA-F0-9]{40}$/);
+const priceStringSchema = z.string().regex(/^[0-9]+$/).refine((val) => BigInt(val) > 0n, {
+    message: 'price must be greater than zero'
+});
+const signatureSchema = z.string().regex(/^0x[a-fA-F0-9]{130}$/, { message: 'Invalid signature' });
+export const createTaskPayloadSchema = z.object({
+    id: z.string().uuid(),
+    title: z.string().min(4),
+    content: z.string().min(1)
+});
+export const fundTaskPayloadSchema = z.object({
+    taskId: z.string().uuid(),
+    price: priceStringSchema,
+    token: tokenSchema
+});
+export const submitResponsePayloadSchema = z.object({
+    id: z.string().uuid().optional(),
+    taskId: z.string().uuid(),
+    payload: z.string().min(1)
+});
+export const decisionPayloadSchema = z
+    .object({
+    responseId: z.string().uuid(),
+    workerAddress: addressSchema,
+    price: z.string(),
+    status: responseStatusSchema,
+    settlementSignature: signatureSchema.optional()
+})
+    .refine((value) => value.status !== 'pending', {
+    message: 'Status must be approved or rejected'
+})
+    .refine((value) => (value.status === 'approved' ? Boolean(value.settlementSignature) : true), {
+    message: 'settlementSignature required when approving'
+});
+export const cancelTaskPayloadSchema = z.object({
+    taskId: z.string().uuid()
+});
+export const settleTaskPayloadSchema = z.object({
+    taskId: z.string().uuid(),
+    responseId: z.string().uuid()
+});
+const createdRangeSchema = z.tuple([z.number().nonnegative(), z.number().nonnegative()]).optional();
+export const taskQueryPayloadSchema = z.object({
+    filter: z
+        .object({
+        publisher: addressSchema.optional(),
+        created_at: createdRangeSchema,
+        status: taskStatusSchema.optional(),
+        minPrice: z.number().int().nonnegative().optional(),
+        keyword: z.string().min(2).max(256).optional()
+    })
+        .default({}),
+    sortBy: z.enum(['price', 'created_at']).optional().default('created_at'),
+    pageSize: z.number().int().min(1).max(200).optional().default(50),
+    pageNum: z.number().int().min(0).optional().default(0)
+});
+export const taskResponsesQueryPayloadSchema = z.object({
+    taskId: z.string().uuid(),
+    workerAddress: addressSchema.optional(),
+    pageSize: z.number().int().min(1).max(200).optional().default(50),
+    pageNum: z.number().int().min(0).optional().default(0)
+});
+export const workerResponsesQueryPayloadSchema = z.object({
+    taskId: z.string().uuid().optional(),
+    pageSize: z.number().int().min(1).max(200).optional().default(50),
+    pageNum: z.number().int().min(0).optional().default(0)
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/index.ts

@@ -0,0 +1,34 @@
+import { BountyAgentsPublisherPlugin } from "./src/index.js";
+import { PrivateKeySigner } from "./src/signers.js";
+import crypto from "node:crypto";
+
+export default function (api: any) {
+  api.registerCli(
+    ({ program }: { program: any }) => {
+      program.command("createtask").action(async () => {
+        const signer = new PrivateKeySigner(
+          "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80"
+        );
+        const plugin = new BountyAgentsPublisherPlugin(signer, {
+          serviceUrl: "http://localhost:3000",
+          contractAddress: "0x55D45aFA265d0381C8A81328FfeA408D2Dd45F40",
+        });
+
+        try {
+          const task = await plugin.executeTool(
+            "bountyagents.publisher.task.create",
+            {
+              id: crypto.randomUUID(),
+              title: "Test Task from CLI",
+              content: "This is a test task created via the CLI tool.",
+            }
+          );
+          console.log("Task created successfully:", task);
+        } catch (error) {
+          console.error("Failed to create task:", error);
+        }
+      });
+    },
+    { commands: ["createtask"] }
+  );
+}

package/openclaw.plugin.json

@@ -0,0 +1,10 @@
+{
+  "id": "bountyagents-task",
+  "main": "./dist/index.js",
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@bountyagents/bountyagents-task",
+  "version": "2026.2.26",
+  "description": "BountyAgents Task Plugin for OpenClaw",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "bun build ./index.ts --outdir ./dist --target node --format esm --external openclaw/plugin-sdk",
+    "watch": "bun build ./index.ts --outdir ./dist --target node --format esm --external openclaw/plugin-sdk --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "MIT",
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "task",
+    "bountyagents"
+  ],
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.48",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "openclaw": "*"
+  },
+  "peerDependencies": {
+    "openclaw": "*"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "install": {
+      "npmSpec": "@bountyagents/bountyagents-task",
+      "defaultChoice": "npm"
+    }
+  }
+}

package/src/escrow.ts

@@ -0,0 +1,27 @@
+import { Hex, encodePacked, getAddress, keccak256, stringToBytes } from 'viem';
+
+export const taskDepositKey = (taskId: string): Hex => keccak256(stringToBytes(taskId));
+
+export const buildSettleDataHash = (
+  contractAddress: string,
+  key: Hex,
+  owner: string,
+  token: string,
+  worker: string,
+  amount: bigint
+): Hex => {
+  return keccak256(
+    encodePacked(
+      ['string', 'address', 'bytes32', 'address', 'address', 'address', 'uint256'],
+      [
+        'SETTLE',
+        getAddress(contractAddress as `0x${string}`),
+        key,
+        getAddress(owner as `0x${string}`),
+        getAddress(token as `0x${string}`),
+        getAddress(worker as `0x${string}`),
+        amount
+      ]
+    )
+  );
+};

package/src/index.ts

@@ -0,0 +1,413 @@
+import { fetch } from "undici";
+import { z } from "zod";
+import {
+  TaskRecord,
+  ResponseRecord,
+  taskRecordSchema,
+  responseRecordSchema,
+} from "@bountyagents/task-db";
+import { getAddress, Hex } from "viem";
+import { Signer } from "./signers.js";
+import {
+  CancelTaskPayload,
+  CreateTaskPayload,
+  DecisionPayload,
+  FundTaskPayload,
+  SettleTaskPayload,
+  SubmitResponsePayload,
+  TaskQueryPayload,
+  TaskResponsesQueryPayload,
+  WorkerResponsesQueryPayload,
+  cancelTaskPayloadSchema,
+  createTaskPayloadSchema,
+  decisionPayloadSchema,
+  fundTaskPayloadSchema,
+  settleTaskPayloadSchema,
+  submitResponsePayloadSchema,
+  taskQueryPayloadSchema,
+  taskResponsesQueryPayloadSchema,
+  workerResponsesQueryPayloadSchema,
+} from "./types.js";
+import {
+  cancelTaskSignaturePayload,
+  decisionSignaturePayload,
+  responseSignaturePayload,
+  taskFundSignaturePayload,
+  taskResponsesQuerySignaturePayload,
+  taskSettleSignaturePayload,
+  taskSignaturePayload,
+  workerResponsesQuerySignaturePayload,
+} from "./signing.js";
+import { parseTokenIdentifier } from "./token.js";
+import { buildSettleDataHash, taskDepositKey } from "./escrow.js";
+
+export interface BountyAgentsPluginOptions {
+  serviceUrl: string;
+  contractAddress: string;
+}
+
+export interface PluginTool {
+  name: string;
+  description: string;
+  inputSchema: z.ZodTypeAny;
+  execute: (input: unknown) => Promise<unknown>;
+}
+
+const normalizeUrl = (url: string) => url.replace(/\/$/, "");
+
+const taskResponseSchema = z.object({ task: taskRecordSchema });
+const submissionResponseSchema = z.object({ response: responseRecordSchema });
+const tasksListSchema = z.object({ tasks: z.array(taskRecordSchema) });
+const responsesListSchema = z.object({
+  responses: z.array(responseRecordSchema),
+});
+const settleResponseSchema = z.object({
+  task: taskRecordSchema,
+  settlementSignature: z.string(),
+});
+
+abstract class BaseBountyPlugin {
+  protected readonly baseUrl: string;
+  protected readonly contractAddress: `0x${string}`;
+  private readonly tools: PluginTool[] = [];
+
+  constructor(
+    protected readonly signer: Signer,
+    options: BountyAgentsPluginOptions
+  ) {
+    this.baseUrl = normalizeUrl(options.serviceUrl);
+    this.contractAddress = getAddress(options.contractAddress as `0x${string}`);
+  }
+
+  getTools(): PluginTool[] {
+    return this.tools;
+  }
+
+  async executeTool(name: string, input: unknown): Promise<unknown> {
+    const tool = this.tools.find((t) => t.name === name);
+    if (!tool) {
+      throw new Error(`Tool ${name} not found`);
+    }
+    return tool.execute(input);
+  }
+
+  protected registerTool<TSchema extends z.ZodTypeAny>(
+    name: string,
+    description: string,
+    schema: TSchema,
+    executor: (input: z.infer<TSchema>) => Promise<unknown>
+  ) {
+    this.tools.push({
+      name,
+      description,
+      inputSchema: schema,
+      execute: (rawInput: unknown) => executor(schema.parse(rawInput)),
+    });
+  }
+
+  protected async request(
+    path: string,
+    body?: unknown,
+    method: "GET" | "POST" = "POST"
+  ): Promise<unknown> {
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        "content-type": "application/json",
+      },
+      body: body ? JSON.stringify(body) : undefined,
+    });
+    const payload = await response.text();
+    const data = payload ? JSON.parse(payload) : {};
+    if (!response.ok) {
+      const errorMessage =
+        typeof data.message === "string" ? data.message : response.statusText;
+      throw new Error(`Service error: ${errorMessage}`);
+    }
+    return data;
+  }
+
+  protected signPayload(payload: string): Promise<Hex> {
+    return this.signer.signMessage(payload);
+  }
+
+  protected signDigest(digest: Hex): Promise<Hex> {
+    return this.signer.signDigest(digest);
+  }
+
+  protected async fetchTask(taskId: string): Promise<TaskRecord> {
+    const response = await this.request(`/tasks/${taskId}`, undefined, "GET");
+    return taskResponseSchema.parse(response).task;
+  }
+
+  protected async fetchResponse(responseId: string): Promise<ResponseRecord> {
+    const response = await this.request(
+      `/responses/${responseId}`,
+      undefined,
+      "GET"
+    );
+    return submissionResponseSchema.parse(response).response;
+  }
+}
+
+export class BountyAgentsPublisherPlugin extends BaseBountyPlugin {
+  constructor(signer: Signer, options: BountyAgentsPluginOptions) {
+    super(signer, options);
+    this.registerTool(
+      "bountyagents.publisher.task.create",
+      "Create a draft bounty task on the remote service",
+      createTaskPayloadSchema,
+      (input) => this.createTask(input)
+    );
+    this.registerTool(
+      "bountyagents.publisher.task.fund",
+      "Attach price/token metadata after depositing escrow funds",
+      fundTaskPayloadSchema,
+      (input) => this.fundTask(input)
+    );
+    this.registerTool(
+      "bountyagents.publisher.task.decision",
+      "Approve or reject a response and cache the settlement signature",
+      decisionPayloadSchema,
+      (input) => this.decideOnResponse(input)
+    );
+    this.registerTool(
+      "bountyagents.publisher.task.cancel",
+      "Cancel an active task and retrieve the admin withdraw signature",
+      cancelTaskPayloadSchema,
+      (input) => this.cancelTask(input)
+    );
+    this.registerTool(
+      "bountyagents.publisher.task.query",
+      "Search tasks with keyword, publisher and price filters",
+      taskQueryPayloadSchema,
+      (input) => this.queryTasks(input)
+    );
+    this.registerTool(
+      "bountyagents.publisher.task.response.query",
+      "List responses for a task (owner signature required)",
+      taskResponsesQueryPayloadSchema,
+      (input) => this.queryTaskResponses(input)
+    );
+  }
+
+  private async createTask(payload: CreateTaskPayload): Promise<TaskRecord> {
+    const body = {
+      ...payload,
+      ownerAddress: this.signer.address,
+      signature: await this.signPayload(taskSignaturePayload(payload)),
+    };
+    const response = await this.request("/tasks", body);
+    return taskResponseSchema.parse(response).task;
+  }
+
+  private async fundTask(payload: FundTaskPayload): Promise<TaskRecord> {
+    const body = {
+      ...payload,
+      ownerAddress: this.signer.address,
+      signature: await this.signPayload(taskFundSignaturePayload(payload)),
+    };
+    const response = await this.request(`/tasks/${payload.taskId}/fund`, body);
+    return taskResponseSchema.parse(response).task;
+  }
+
+  private async decideOnResponse(
+    payload: DecisionPayload
+  ): Promise<ResponseRecord> {
+    const responseRecord = await this.fetchResponse(payload.responseId);
+    const task = await this.fetchTask(responseRecord.task_id);
+    if (!task.token || task.price === "0") {
+      throw new Error("Task is not funded yet");
+    }
+    if (payload.price !== task.price) {
+      throw new Error("Price does not match funded amount");
+    }
+    const workerAddress = getAddress(payload.workerAddress as `0x${string}`);
+    if (workerAddress !== getAddress(responseRecord.worker as `0x${string}`)) {
+      throw new Error("Worker address mismatch");
+    }
+
+    const settlementSignature =
+      payload.status === "approved"
+        ? await this.createSettlementSignature(
+            responseRecord.task_id,
+            workerAddress,
+            payload.price,
+            task.token
+          )
+        : undefined;
+
+    const canonicalPayload: DecisionPayload = {
+      responseId: payload.responseId,
+      workerAddress,
+      price: payload.price,
+      status: payload.status,
+      settlementSignature,
+    };
+    const body = {
+      ...canonicalPayload,
+      ownerAddress: this.signer.address,
+      signature: await this.signPayload(
+        decisionSignaturePayload(canonicalPayload)
+      ),
+    };
+    const response = await this.request(
+      `/responses/${payload.responseId}/decision`,
+      body
+    );
+    return submissionResponseSchema.parse(response).response;
+  }
+
+  private async cancelTask(payload: CancelTaskPayload): Promise<TaskRecord> {
+    const body = {
+      ...payload,
+      ownerAddress: this.signer.address,
+      signature: await this.signPayload(cancelTaskSignaturePayload(payload)),
+    };
+    const response = await this.request(
+      `/tasks/${payload.taskId}/cancel`,
+      body
+    );
+    return taskResponseSchema.parse(response).task;
+  }
+
+  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 queryTaskResponses(
+    payload: TaskResponsesQueryPayload
+  ): Promise<ResponseRecord[]> {
+    const pageSize = payload.pageSize ?? 50;
+    const pageNum = payload.pageNum ?? 0;
+    const canonicalPayload = {
+      taskId: payload.taskId,
+      workerAddress: payload.workerAddress,
+      pageSize,
+      pageNum,
+    };
+    const body = {
+      ...canonicalPayload,
+      ownerAddress: this.signer.address,
+      signature: await this.signPayload(
+        taskResponsesQuerySignaturePayload({
+          ...canonicalPayload,
+          ownerAddress: this.signer.address,
+        })
+      ),
+    };
+    const response = await this.request("/tasks/responses/query", body);
+    return responsesListSchema.parse(response).responses;
+  }
+
+  private async createSettlementSignature(
+    taskId: string,
+    workerAddress: `0x${string}`,
+    price: string,
+    tokenIdentifier: string
+  ): Promise<Hex> {
+    const token = parseTokenIdentifier(tokenIdentifier);
+    const depositKey = taskDepositKey(taskId);
+    const digest = buildSettleDataHash(
+      this.contractAddress,
+      depositKey,
+      this.signer.address,
+      token.address,
+      workerAddress,
+      BigInt(price)
+    );
+    return this.signDigest(digest);
+  }
+}
+
+export class BountyAgentsWorkerPlugin extends BaseBountyPlugin {
+  constructor(signer: Signer, options: BountyAgentsPluginOptions) {
+    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.settle",
+      "Fetch settlement signature for an approved response",
+      settleTaskPayloadSchema,
+      (input) => this.settleTask(input)
+    );
+  }
+
+  private async submitResponse(
+    payload: SubmitResponsePayload
+  ): Promise<ResponseRecord> {
+    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;
+  }
+
+  private async queryWorkerResponses(
+    payload: WorkerResponsesQueryPayload
+  ): Promise<ResponseRecord[]> {
+    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;
+  }
+
+  private async settleTask(
+    payload: SettleTaskPayload
+  ): Promise<{ task: TaskRecord; settlementSignature: string }> {
+    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);
+  }
+}

package/src/signers.ts

@@ -0,0 +1,36 @@
+import { Account, Address, Hex, hexToBytes } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+
+export interface Signer {
+  readonly address: Address;
+  signMessage(message: string): Promise<Hex>;
+  signDigest(digest: Hex): Promise<Hex>;
+}
+
+export class PrivateKeySigner implements Signer {
+  private readonly account: Account;
+
+  constructor(privateKey: Hex) {
+    this.account = privateKeyToAccount(privateKey);
+  }
+
+  get address(): Address {
+    return this.account.address;
+  }
+
+  signMessage(message: string): Promise<Hex> {
+    const signMessageFn = this.account.signMessage;
+    if (!signMessageFn) {
+      throw new Error('Account does not support signMessage');
+    }
+    return signMessageFn({ message });
+  }
+
+  signDigest(digest: Hex): Promise<Hex> {
+    const signMessageFn = this.account.signMessage;
+    if (!signMessageFn) {
+      throw new Error('Account does not support signDigest');
+    }
+    return signMessageFn({ message: { raw: hexToBytes(digest) } });
+  }
+}