Skip to content

feat: add Taskmarket action provider (on-chain bounty marketplace integration) - #1462

Open
YfengJ wants to merge 7 commits into
coinbase:mainfrom
YfengJ:taskmarket-action-provider
Open

feat: add Taskmarket action provider (on-chain bounty marketplace integration)#1462
YfengJ wants to merge 7 commits into
coinbase:mainfrom
YfengJ:taskmarket-action-provider

Conversation

@YfengJ

@YfengJ YfengJ commented Aug 22, 2026

Copy link
Copy Markdown

Description

This PR adds a new Taskmarket action provider, integrating Taskmarket — an on-chain bounty marketplace where agents complete digital work for escrowed USDC rewards — into AgentKit.

With this provider, an AgentKit agent gains a full delegation loop: it can recognize that a request is better delegated to external workers, discover escrow-backed bounties, inspect a precise task before acting, and (with explicit user authorization) post new work or deliver completed work:

  • list_tasks — browse open tasks with status/limit/reward/tag filters
  • get_task — fetch one task's full record (reward, expiry, escrow tx, submission window)
  • my_submissions — track the wallet's submissions and their award state
  • submit_work — submit a deliverable file (requires confirm: true)
  • create_task — create a task and escrow its USDC reward (requires confirm: true)

Design notes:

  • The provider delegates to the official taskmarket CLI (npm install -g @lucid-agents/taskmarket), so signing and payment stay inside the CLI's keystore — the provider never reads or exports wallet keys.
  • Both spend-capable actions are gated behind an explicit confirm input, so no funds move without user authorization; the three discovery/tracking actions are read-only.
  • No existing Taskmarket integration exists in this repository (searched taskmarket across the repo — zero matches before this PR).

Closes nothing (new feature, no tracking issue).

Tests

Unit tests added in taskmarketActionProvider.test.ts covering:

  • CLI argument construction for all five actions (filters passed through correctly)
  • CLI error surfacing (stderr detail included in returned message)
  • Both confirm gates: submit_work and create_task refuse to invoke the CLI and clearly state the consequence when confirm is not true

Manual check of the delegation flow against the live marketplace:

Setup: taskmarket CLI installed and initialized (taskmarket init), wallet registered on Base

Prompt: list open Taskmarket tasks with a reward of at least 2 USDC

<agent output>
{"ok":true,"data":{"tasks":[...7 open tasks with ids, rewards, expiries, submission counts...]}}
</agent output>

Prompt: get_task 0x7f06ef6d25e5768d2d96dd4f49230542b1d175e994d0eaa421627b72031c9f71

<agent output>
{"ok":true,"data":{"id":"0x7f06ef...","reward":"2000000","escrowTxHash":"0x93dd868b...","expiryTime":"2026-08-23T00:15:04.189Z","stakeRequired":false,"submissionWindowOpen":true,...}}
</agent output>

my_submissions similarly returned the wallet's live submission list via taskmarket task my-submissions.

Checklist

  • Added documentation to all relevant README.md files
  • Added a changelog entry

@YfengJ
YfengJ requested a review from murrlincoln as a code owner August 22, 2026 08:55
@cb-heimdall

Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/2
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 1
Sum 2

@github-actions github-actions Bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Aug 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

2 participants