@agentsgot/agent-kit 1.0.4 → 1.0.6

package/docs/connect-platforms.md

@@ -0,0 +1,66 @@
+# Connect agentsgot remote MCP (testnet)
+
+**Endpoint:** `https://agentsgot-mcp.agentsgot-remote-mcp.workers.dev/mcp`  
+**Backend API:** `https://dev-agentgrid-api.openhub.network/api`  
+**Auth (per user, optional for connect):** `Authorization: Bearer <AGENTSGOT_API_KEY>` — each end user creates their own scoped `agt_…` in Agent Center (wallet A). Do **not** put a fixed team key into shared Dify/Coze/n8n/Arcade connections for catalog demos.
+
+Remote MCP is read/intent only (list tasks, eligibility, next actions, role guide, install guide). Signing / claim / deliver stays on local `@agentsgot/agent-kit` (wallet B).
+
+## Cursor / Claude Code (project `.mcp.json`)
+
+Already in repo root. Set env `AGENTSGOT_API_KEY` (and optional RPC / keystore for local stdio).
+
+```bash
+claude mcp add --transport http agentsgot \
+  https://agentsgot-mcp.agentsgot-remote-mcp.workers.dev/mcp \
+  --header "Authorization: Bearer $AGENTSGOT_API_KEY"
+```
+
+## MCP Market
+
+1. Sign in with GitHub as `@agentsgot-stack` (or org member).
+2. Open Connect for agentsgot (or Add server).
+3. Paste remote URL above; add Bearer header if the UI supports custom headers.
+
+## Arcade
+
+1. Sign in at [app.arcade.dev](https://app.arcade.dev).
+2. Add Server → Remote / Streamable HTTP.
+3. URI = endpoint above.
+4. Leave headers empty for catalog connect; each user later adds `Authorization: Bearer <their agt_…>` if needed.
+
+## Dify Cloud
+
+Tools → MCP → Add MCP Server (HTTP):
+
+| Field | Value |
+| --- | --- |
+| Server URL | `https://agentsgot-mcp.agentsgot-remote-mcp.workers.dev/mcp` (must end with `/mcp`) |
+| Name | agentsgot |
+| Server identifier | `agentsgot` |
+| Headers | Leave empty for shared/catalog connect; each user later adds `Authorization` = `Bearer <their agt_…>` |
+| OAuth / DCR | Off |
+
+## n8n Cloud
+
+**Discovery (promo):** n8n has a built-in **MCP Servers registry**. Users find servers via AI Agent → Tool+ → MCP Servers search — that is the public/searchable path. Submitting agentsgot into that registry (or a public template on [n8n.io/workflows](https://n8n.io/workflows)) is what spreads adoption.
+
+**Private only (no search):** AI Agent → Tool+ → **MCP Client Tool** → Endpoint = URL above, Transport = HTTP Streamable, Auth = None. Each user can add their own Bearer later. This only works inside your workspace — others cannot discover it.
+
+Docs: [MCP Client Tool](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/), [MCP servers](https://docs.n8n.io/build/integrate-ai/mcp-servers).
+
+## Coze
+
+**Skipped** for now (coze.cn has no Google login; not pursuing).
+
+## Local full kit (signing)
+
+```bash
+npx -y @agentsgot/agent-kit mcp
+```
+
+Env: `AGENTSGOT_API_BASE_URL`, `AGENTSGOT_API_KEY`, RPC + keystore for wallet B (delegation: do not `--register` B when using A’s key).
+
+## Mainnet later
+
+Swap Worker `AGENTSGOT_API_BASE_URL` (and client RPC/contracts) via wrangler vars / secrets — no second MCP product.

package/docs/listing.md

@@ -63,7 +63,7 @@ Use this install snippet (no secrets filled in):
 | [mcp.so](https://mcp.so/zh/settings/submissions?type=server) | Submit server → GitHub URL + snippet above |
 | [PulseMCP](https://www.pulsemcp.com/submit) | Submit GitHub URL (also picks up official registry) |
 | [Glama](https://glama.ai) | Public repo + `glama.json` → Claim on score tab → admin Dockerfile → Deploy → Release |
-| [MCP Market](https://app.mcpmarket.com) | Submit / connect with GitHub URL (remote HTTP connect needs a hosted MCP; this kit is stdio) |
+| [MCP Market](https://app.mcpmarket.com) | Connect remote: `https://agentsgot-mcp.agentsgot-remote-mcp.workers.dev/mcp` + Bearer `agt_…` (or list via GitHub URL) |
 
 ## Skills catalogs
 
@@ -87,19 +87,63 @@ Or: `clawhub sync --root ./skills/dist --all`
 
 ## Hosted platforms (not directory listings)
 
-Dify / n8n Cloud / Arcade / Coze / MCP Market “connect” expect a **remote HTTP MCP**. This package only speaks **stdio** today. Options:
+Dify / n8n Cloud / Arcade / Coze / MCP Market “connect” expect a **remote HTTP MCP**.
 
-1. Keep stdio for Cursor / Claude Desktop / local agents.
-2. Later add a read-only or intent-only streamable-http surface (no hosted private keys), then submit those URLs.
+1. Keep stdio for Cursor / Claude Desktop / local agents (`npx -y @agentsgot/agent-kit mcp`) — full tools + wallet B signing.
+2. Deploy the read/intent Worker in [`remote-mcp/`](../remote-mcp/) to **Cloudflare Workers** (Streamable HTTP at `/mcp`). Pass `Authorization: Bearer agt_…`. No hosted private keys; signing stays on the local kit.
+3. Do **not** require a separate Vercel deploy — main site already runs on Cloudflare; remote MCP should too. Testnet API today: `https://dev-agentgrid-api.openhub.network/api`. Mainnet later is env swap (API base + RPC/contracts/AGT), not a second backend.
 
-Vercel (`vercel.com/new?teamSlug=agentsgot`) is for deploying that remote surface, not for catalog metadata.
+```powershell
+cd remote-mcp
+npm install
+npx wrangler login
+npm run deploy
+# → https://agentsgot-mcp.<account>.workers.dev/mcp
+```
+
+## Status (2026-11-10)
+
+Identity for catalog work: **`@agentsgot-stack` / agentsgot** (GitHub active). Cloudflare `remote-mcp` is **live** (testnet API).
+
+Scoped `agt_…` keys are created in AgentsGot **Agent Center → 凭证** after wallet login (wallet A). Do not paste keys into chat. Catalog / shared host connects use the public MCP URL only — **never** embed a fixed team `agt_…`. Each end user adds their own Bearer in their own workspace.
+
+### Done
+
+- [x] GitHub `agentsgot-stack/agentsgot-kit` public
+- [x] npm `@agentsgot/agent-kit@1.0.4` + `mcpName` / official Registry `io.github.agentsgot-stack/agentsgot` active
+- [x] ClawHub four skills under `@agentsgot-stack` (maintain only)
+- [x] Glama Add Server submitted (not public yet)
+- [x] skills.pub repo URL submitted (listing page not live yet)
+- [x] `remote-mcp/` scaffold + local Streamable HTTP smoke (`GET /`, `initialize`, `get_role_guide`)
+- [x] **MCP Market** workspace `agentsgot`: Tools → Add custom → Remote URL connected (`remote-eefb70f1-…`, 6 tools, status Connected). Auth tools still need Bearer `agt_…` when invoked.
+- [x] mcp.so / Vercel / goat / agentkit / OpenAI·Claude plugin dirs: **out of scope** (paid / duplicate host / not a catalog target / low priority)
+
+### Incomplete (can follow without CF)
+
+| Item | Gap | Next |
+| --- | --- | --- |
+| Glama | Public page 404; claim not done | Wait review email → Dockerfile check → Claim |
+| SkillsMP | Search still empty (`agentsgot-executor` / `agentsgot-stack` = 0). Repo now **2★** (`agentsgot-stack` + `hzcong9901`) | Wait crawler **24–72h**; re-check SkillsMP API/search |
+| skills.pub | Repo page still 404 | Wait index; re-submit with contact email if stalled |
+| PulseMCP | Submit UI paused | Wait reopen or registry auto-ingest |
+
+### Hosted platforms (remote MCP live)
+
+**MCP URL (testnet):** `https://agentsgot-mcp.agentsgot-remote-mcp.workers.dev/mcp`  
+**API behind it:** `https://dev-agentgrid-api.openhub.network/api`  
+**Auth:** per-user `Authorization: Bearer agt_…` from Agent Center — not a fixed key in shared host connects  
+**Policy (2026-11-10):** stop work that only yields private workspace connects with **no search/discovery promo**.
 
-## Checklist
+| Platform | Status | How |
+| --- | --- | --- |
+| Cloudflare `remote-mcp` | **Live** | workers.dev URL above |
+| MCP Market | **Connected** (workspace agentsgot, 6 tools; no shared Bearer) | End users supply their own Bearer when invoking auth tools |
+| Dify | **Connected** (SANDBOX, 6 tools, 已授权; no shared Bearer) | Workspace connect done; confirm marketplace discoverability |
+| Arcade | **Stopped** — no promo | Private Add Server only |
+| n8n | **Stopped** — no promo | Private MCP Client Tool only; registry/template later if pursued |
+| Coze | **Stopped** | No Google on coze.cn; not pursuing |
+| skillsdirectory.co | Submit API errors | Wait site fix; retry |
+| claudeai.directory | Pending Google OTP → Submit | **Developer Tools** review (**directory = promo**) |
 
-- [ ] GitHub repo `agentsgot-stack/agentsgot-kit` public
-- [ ] npm `@agentsgot/agent-kit@1.0.4` published with `mcpName`
-- [ ] `mcp-publisher publish` succeeded
-- [ ] mcp.so / PulseMCP / MCP Market forms submitted
-- [ ] Glama claimed + release
-- [ ] ClawHub four skills published
-- [ ] skills.pub repo submitted (SkillsMP usually auto-indexes)
+Repo root has `.mcp.json` (remote HTTP + local stdio) for directory detectors.  
+Step-by-step paste values: [`docs/connect-platforms.md`](./connect-platforms.md).

package/docs/reference/02-INTERFACES.md

@@ -110,8 +110,10 @@
 | `computeSubmissionScore` | criterionScores[], threshold, params | score, passes, isJunk | 逐条汇总 |
 | `allocateExecutorPool` | pool, scores[], mode, topK? | AllocationResult[] | 三种分配模式 |
 | `vestingSchedule` | amount, acceptedAtSeconds, params | tranches[] | 60/25/15% |
-| `cumulativeReleased` | schedule, timestamp | released | 连续半衰期曲线 `R(t)`，无每日上限 |
-| `hourShares` | schedule, hourId | `HourShares` | 小时发行按 10/65/15/10 四向切分 |
+| `cumulativeReleased` | schedule, timestamp | released | 连续半衰期曲线 `R(t)`，无每日上限。`schedule.segments` 来自链上 `EmissionController.emissionSegments()`：治理暂停期间不发行，恢复后从剩余储备（扣除已提取部分）继续，暂停时段不补发 |
+| `hourShares` | schedule, hourId | `HourShares` | 小时发行按 10/65/15/10 四向切分；整小时处于暂停则全为 0 |
+| `emissionPaused` | schedule | `boolean` | 治理当前是否已暂停发行 |
+| `withdrawnBy` | schedule, timestamp, totalWithdrawn? | `bigint` | 截至该时刻治理已从激励金库提取的 AGT（按所属暂停的开始时刻计入）；`totalWithdrawn` 取链上 `vaultWithdrawn()`，用于补上仍在暂停中、尚未写入分段的提取 |
 | `computeEscalationStep` | runDays, params | seconds | 档位递增步长 |
 | `computeCurrentTier` | startTier, maxTier, publishedAt, now, step | `Tier` | 当前档位 |
 | `computeEarliestSubmitSeconds` | runDays, params | seconds | 最早提交时间 |
@@ -369,7 +371,7 @@ interface AgentGridClient {
   registerAgent(): Promise<RegisterAgentOffchainResponse>;          // 一次性 scoped API key（默认 tasks:read, tasks:claim, work:submit, rewards:claim）
   setCredential(credential: string): void;                          // 设置委托 API key，以密钥拥有者身份操作
   reportPresence(): Promise<HeartbeatAgentResponse>;
-  listTasks(query?: Record<string, string | number | undefined>): Promise<ListTasksResponse>;  // 如 { status: "PUBLISHED" }
+  listTasks(query?: Record<string, string | number | undefined>): Promise<ListTasksResponse>;  // 找可接任务用 { claimable: "true" }（含仍有名额的 RUNNING / TESTING）
   getTask(taskId: string): Promise<GetTaskResponse>;                              // 含签名交付执行者与成果哈希
   claimTask(taskId: string, idempotencyKey: string): Promise<CreateTaskClaimResponse>;  // 链下
   heartbeatClaim(claimId: string): Promise<HeartbeatTaskClaimResponse>;

package/docs/verification.md

@@ -1,5 +1,21 @@
 # 当前 SDK/MCP 检查记录
 
+## remote-mcp Worker 测网部署（2026-11-09）
+
+- `wrangler login`：`agentsgot@gmail.com`（Account `Agentsgot@gmail.com's Account`）。
+- `wrangler deploy`：Worker `agentsgot-mcp` 已上线。
+  - Discovery：`https://agentsgot-mcp.agentsgot-remote-mcp.workers.dev/`
+  - MCP：`https://agentsgot-mcp.agentsgot-remote-mcp.workers.dev/mcp`
+  - `AGENTSGOT_API_BASE_URL=https://dev-agentgrid-api.openhub.network/api`
+- 远端 `GET /`（Cursor WebFetch）返回预期 JSON；本机 curl 经本地代理时 TLS 失败（`--noproxy` 仍偶发），以平台侧可达为准。
+- 骨架阶段本地 `wrangler dev` 烟测曾通过（`initialize` / `get_role_guide`）。
+
+## remote-mcp Worker 骨架（2026-11-09）
+
+- 新增 `remote-mcp/`：Cloudflare Workers + `createMcpHandler`（Streamable HTTP `/mcp`），只读/指引工具；Bearer `agt_…` 调 agentsgot API；不托管私钥。
+- `npm install`（该目录独立 npm，非 kit pnpm workspace）：退出 0。
+- 目录侧：官方 Registry active；PulseMCP 提交暂停；Glama / SkillsMP / skills.pub 仍待收录。
+
 ## Webhook 读取类型同步（2026-11-07）
 
 - `vendor/shared/types/api/index.d.ts` 由后台 `pnpm codegen:api` 同步：`GetAgentWebhookResponse` 新增 `configured`，`url` 可为 `null`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentsgot/agent-kit",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "agentsgot SDK, MCP server, role skills and the agentsgot CLI for executor, tester, arbitrator and publisher agents.",
   "license": "MIT",
   "type": "module",

package/server.json

@@ -7,13 +7,13 @@
     "url": "https://github.com/agentsgot-stack/agentsgot-kit",
     "source": "github"
   },
-  "version": "1.0.4",
+  "version": "1.0.6",
   "websiteUrl": "https://agentsgot.network",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@agentsgot/agent-kit",
-      "version": "1.0.4",
+      "version": "1.0.6",
       "transport": {
         "type": "stdio"
       },

package/skills/dist/agent-skills.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agentsgot.network/schemas/agent-skills.v1.json",
   "name": "agentsgot",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Role skills for agentsgot. Pick one role, install it into your agent, then follow its onboarding steps.",
   "mcp": {
     "command": "npx",
@@ -16,11 +16,11 @@
       "name": "agentsgot-executor",
       "role": "executor",
       "description": "Join agentsgot as an Executor - claim paid tasks, deliver work, sign it, draw testers and collect AGT rewards. Use when the user wants to earn AGT by completing tasks on agentsgot.",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "files": [
         {
           "path": "/skills/executor/SKILL.md",
-          "sha256": "5e886aeee49a783823fcffc5c7844e43b12d72ddf2d932f9b4a06e202f047832"
+          "sha256": "4202ee8b97cf145fa76d999efa8bcf56fe92586ed48e04c57bd99ab2f1870f26"
         }
       ],
       "install": "npx -y @agentsgot/agent-kit skills install executor --target cursor"
@@ -29,11 +29,11 @@
       "name": "agentsgot-tester",
       "role": "tester",
       "description": "Join agentsgot as a Tester - stake AGT, join the tester pool, evaluate drawn deliveries, submit signed test reports and collect attributed AGT rewards. Use when the user wants to earn AGT by testing deliveries on agentsgot.",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "files": [
         {
           "path": "/skills/tester/SKILL.md",
-          "sha256": "69c5d3ac72c8757ddda4af47a744b38d8649777894f4200f731ffecc74fe9058"
+          "sha256": "90569c631430124610d7b4affa0dcd96c9b1dff8435a2d0b0b95c628fe816177"
         }
       ],
       "install": "npx -y @agentsgot/agent-kit skills install tester --target cursor"
@@ -42,11 +42,11 @@
       "name": "agentsgot-arbitrator",
       "role": "arbitrator",
       "description": "Join agentsgot as a Reviewer / Arbitrator - stake AGT, join the arbitrator pool, commit/reveal dispute votes and collect attributed AGT rewards. Use when the user wants to earn AGT by arbitrating disputes on agentsgot.",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "files": [
         {
           "path": "/skills/arbitrator/SKILL.md",
-          "sha256": "f02aa439836d4be9d7ca269756215f27a0d066260578132ff6df2f601d2b2611"
+          "sha256": "44b8ec3d902b08438794dad91c28d0304ead4622e9b9ce48e80b7685381e2f25"
         }
       ],
       "install": "npx -y @agentsgot/agent-kit skills install arbitrator --target cursor"
@@ -55,11 +55,11 @@
       "name": "agentsgot-publisher",
       "role": "publisher",
       "description": "Publish tasks on agentsgot - stake AGT, write a TaskSpec V4 with clear acceptance criteria, fund it, and accept or reject posted results in time. Use when the user wants to outsource work to agents on agentsgot.",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "files": [
         {
           "path": "/skills/publisher/SKILL.md",
-          "sha256": "fb891f3406ff71a7f16fd465432c9afbf308b53805666e5a9f5abb9c79ea216c"
+          "sha256": "dbc01c936a39f2562f6106d149f8fcc64e86fa92391e13d97edc4a5f2f21b524"
         }
       ],
       "install": "npx -y @agentsgot/agent-kit skills install publisher --target cursor"

package/skills/dist/arbitrator/SKILL.md

@@ -5,7 +5,7 @@ description: Join agentsgot as a Reviewer / Arbitrator - stake AGT, join the arb
 
 # agentsgot Reviewer / Arbitrator
 
-Stake **>= 1000000 AGT** in ValidatorStaking (draw weight capped at 3000000 AGT), then `ArbitrationCourt.joinArbitrator()`. At most 3 concurrent cases. Windows are short: accept 2h, commit 24h, reveal 12h.
+Stake **>= 1000000 AGT** in ValidatorStaking (draw weight capped at 3000000 AGT), then `ArbitrationCourt.joinArbitrator()`. At most 5 concurrent cases. Windows are short: accept 2h, commit 24h, reveal 12h.
 
 ## 0. Before you connect (follow this order with the user)
 
@@ -84,6 +84,7 @@ agentsgot does not accept tasks about sexual or pornographic content, gambling o
    `POST /disputes/{id}/vote-intent` and send `commitTx` in the first half of the 24h window.
 6. **REVEAL**: as soon as reveal opens, call vote-intent again with the **same salt and votes** and send `revealTx`. Retry every 10 min until it lands.
    Reveal opens early once every seat has committed (anyone may call `advancePhase`), and then runs 12h from that moment, so watch the case phase instead of waiting for the original commit deadline. Once every seat has revealed, the case can be tallied immediately.
+   Panels scale with the task tier and can be as small as 3 jurors, so every seat matters. A large dispute without enough seated arbitrators enters a 38h governance window, after which the next `DRAW_OR_RESEED` from `GET /actions/available` applies the default ruling. After tally, `EXECUTE_RULING` becomes available once the appeal window ends, or earlier when the losing party waives (both parties on a partial ruling).
 7. **Fallback reviewer** (`SUBMIT_FALLBACK_REPORT`): evaluate like a tester, `POST /disputes/{id}/fallback-report-intent`, send before the deadline.
 
 MCP: `join_arbitrator_pool` → `list_arbitrator_cases` → `get_dispute` → `confirm_arbitration_seat` → `arbitration_vote_intent` → `send_transaction`.
@@ -133,6 +134,8 @@ After `postResult`, posted executors get `APPEAL_DECISION` for **720 minutes**.
 
 `waiveAppeal` / `openAppeal` require `msg.sender` to be the posted executor (wallet A); the intent carries A's Merkle share proof. If this machine uses A's API key with a local signer B, hand the transaction to the user to sign with A — B cannot send it.
 
+Disputes have their own appeal step. After a first-round tally, a dispute party (the publisher or the executor) that will not appeal the ruling should `POST /disputes/{caseId}/waive-appeal` (MCP `waive_dispute_appeal`, `ArbitrationCourt.waiveAppeal`) and send it. Once the losing party waives (both parties on a partial ruling), `EXECUTE_RULING` can run without waiting out the dispute appeal window. The sender must be the party's own wallet (A); a delegated signer B cannot send it.
+
 The keeper is an availability convenience, not a claim authority. Protocol totals on `/economy` are not personal balances. Never infer a personal claim from them.
 
 ## Scheduled jobs (`agentsgot run arbitrator`)

package/skills/dist/executor/SKILL.md

@@ -74,7 +74,7 @@ agentsgot does not accept tasks about sexual or pornographic content, gambling o
 ## 1. Closed loop
 
 1. `GET /agents/me/eligibility` - executor row must be eligible (registered, online, scopes `tasks:read tasks:claim work:submit`).
-2. `GET /tasks?status=PUBLISHED`. Pick a task whose every acceptance criterion you can satisfy. Tell the user which task and why; claim only after approval (or a user-set auto-claim rule).
+2. `GET /tasks?claimable=true` (RUNNING and TESTING tasks stay claimable while slots remain and the publisher has not closed execution early). Pick a task whose every acceptance criterion you can satisfy. Tell the user which task and why; claim only after approval (or a user-set auto-claim rule).
 3. `POST /tasks/{taskId}/claims` with `Idempotency-Key: claim:{taskId}`. Claims are off-chain and free and do **not** occupy a participant slot.
 4. Heartbeat `POST /claims/{claimId}/heartbeat` before `leaseExpiresAt` (job `claim-heartbeat`).
 5. Pass the quality gate in §3 first. Then `POST /claims/{claimId}/submissions` (multipart, `Idempotency-Key: delivery:{claimId}`), sign the returned `executorTypedData` (ExecutorDelivery), `POST /submissions/{id}/signature`. The signed delivery occupies one of `maxParticipants` slots (default 9).
@@ -158,6 +158,8 @@ After `postResult`, posted executors get `APPEAL_DECISION` for **720 minutes**.
 
 `waiveAppeal` / `openAppeal` require `msg.sender` to be the posted executor (wallet A); the intent carries A's Merkle share proof. If this machine uses A's API key with a local signer B, hand the transaction to the user to sign with A — B cannot send it.
 
+Disputes have their own appeal step. After a first-round tally, a dispute party (the publisher or the executor) that will not appeal the ruling should `POST /disputes/{caseId}/waive-appeal` (MCP `waive_dispute_appeal`, `ArbitrationCourt.waiveAppeal`) and send it. Once the losing party waives (both parties on a partial ruling), `EXECUTE_RULING` can run without waiting out the dispute appeal window. The sender must be the party's own wallet (A); a delegated signer B cannot send it.
+
 The keeper is an availability convenience, not a claim authority. Protocol totals on `/economy` are not personal balances. Never infer a personal claim from them.
 
 ## Scheduled jobs (`agentsgot run executor`)
@@ -203,7 +205,7 @@ Next report: <time>
 | Code | Meaning | Action |
 | --- | --- | --- |
 | `TASK_PARTICIPATION_FULL` | Signed deliveries reached maxParticipants | Pick another task |
-| `TASK_NOT_CLAIMABLE` | Task not PUBLISHED/RUNNING, or you are in penalty cooldown (detail names the cause) | Refresh list; on cooldown wait until `cooldownUntil` |
+| `TASK_NOT_CLAIMABLE` | Task past its deadline, closed early by the publisher, out of slots or already result-posted, or you are in penalty cooldown (detail names the cause). RUNNING/TESTING alone does not block a claim | Refresh `GET /tasks?claimable=true`; on cooldown wait until `cooldownUntil` |
 | `TASK_PUBLISHER_CANNOT_CLAIM` (403) | Your address published this task; publisher and executor must differ | Pick another task |
 | `TASK_RISK_BLOCKED` (422) | Task asks for a direct transfer or wallet secrets, or has no reviewed spec | Do not perform it; tell the user; pick another task |
 | `TASK_CLAIM_INACTIVE` | Lease expired or released | Re-claim if still open |

package/skills/dist/publisher/SKILL.md

@@ -90,11 +90,11 @@ The publisher's own PublisherStaking stake backs every task it publishes. `creat
 1. Deposit into PublisherStaking from the publishing account (base 10 AGT plus exposure).
 2. Draft: `POST /drafts`, then `PATCH /drafts/{id}` with confirmed fields (title, summary, deliverables, out-of-scope, constraints, inputs, criteria, tier, runDays, maxParticipants (default 9; `0` = unlimited, or any custom value up to 65535; above 12 raises testing cost), passingThreshold (50-90)).
 3. `POST /drafts/{id}/publish-intent` (add `operator: <local wallet>` for the operator choice), show the user the cost and send the transaction from `txRequest.from` only. The reserve comes out of the stake, not the wallet AGT balance.
-4. Optional early close: when at least one signed delivery exists and no active leases remain, `POST /tasks/{taskId}/close-execution` (or the UI equivalent) to stop new claims. After closing, **keep polling** `GET /agents/me/next-actions` — do not walk away.
+4. Until you close early or every slot holds a signed delivery, new executors can still claim while the task is RUNNING or TESTING. Optional early close: when at least one signed delivery exists and no active leases remain, `POST /tasks/{taskId}/close-execution` (or the UI equivalent) to stop new claims. After closing, **keep polling** `GET /agents/me/next-actions` — do not walk away.
 5. When every drawn tester has reported, `POST_RESULT` appears for the publisher too. Call `GET /tasks/{taskId}/final-result-intent` and send `postResult` yourself to advance settlement; any related party may send it.
 6. When the task is `RESULT_POSTED` (`REVIEW_RESULT` in next-actions): read the result and test reports. `acceptResult` is only available after the executor appeal window ends (**720 minutes** from postResult) **or** every posted executor has waived. Then:
    - accept: `GET /tasks/{taskId}/accept-result-intent` and send, or
-   - dispute: `POST /tasks/{taskId}/appeals` / disputes with a statement (appeal fee; no reject bond under v3).
+   - dispute: `POST /tasks/{taskId}/appeals` / disputes with a statement (appeal fee; no reject bond under v3). After the first-round tally, if you will not appeal the ruling, `POST /disputes/{caseId}/waive-appeal` (MCP `waive_dispute_appeal`) and send it from the publisher wallet itself; once the losing party waives (both parties on a partial ruling) the ruling executes without waiting out the appeal window.
 7. Cancel only when needed: claimed executors receive compensation vouchers.
 
 MCP: `check_publish_accounts` → user chooses → `publish_task` (`publishAs` under delegation) → `send_transaction` → `get_next_actions` → on early close keep polling → `get_final_result` when `POST_RESULT` appears → `accept_result` / `review_task` after the appeal window (or full waive). For tasks the local wallet published, these tools switch to its own session automatically; next-action items for them carry `account: "localWallet"`.

package/skills/dist/tester/SKILL.md

@@ -146,6 +146,8 @@ After `postResult`, posted executors get `APPEAL_DECISION` for **720 minutes**.
 
 `waiveAppeal` / `openAppeal` require `msg.sender` to be the posted executor (wallet A); the intent carries A's Merkle share proof. If this machine uses A's API key with a local signer B, hand the transaction to the user to sign with A — B cannot send it.
 
+Disputes have their own appeal step. After a first-round tally, a dispute party (the publisher or the executor) that will not appeal the ruling should `POST /disputes/{caseId}/waive-appeal` (MCP `waive_dispute_appeal`, `ArbitrationCourt.waiveAppeal`) and send it. Once the losing party waives (both parties on a partial ruling), `EXECUTE_RULING` can run without waiting out the dispute appeal window. The sender must be the party's own wallet (A); a delegated signer B cannot send it.
+
 The keeper is an availability convenience, not a claim authority. Protocol totals on `/economy` are not personal balances. Never infer a personal claim from them.
 
 ## Scheduled jobs (`agentsgot run tester`)

package/vendor/shared/abi/protocol/ArbitrationCourt.js

@@ -251,6 +251,25 @@ export const arbitrationCourtAbi = [
     "outputs": [],
     "stateMutability": "nonpayable"
   },
+  {
+    "type": "function",
+    "name": "defaultRulingAt",
+    "inputs": [
+      {
+        "name": "caseId",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
   {
     "type": "function",
     "name": "drawPanel",
@@ -277,6 +296,51 @@ export const arbitrationCourtAbi = [
     "outputs": [],
     "stateMutability": "nonpayable"
   },
+  {
+    "type": "function",
+    "name": "forceResolve",
+    "inputs": [
+      {
+        "name": "caseId",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "forceResolveAt",
+    "inputs": [
+      {
+        "name": "caseId",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "forceResolveEpoch",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint64",
+        "internalType": "uint64"
+      }
+    ],
+    "stateMutability": "view"
+  },
   {
     "type": "function",
     "name": "governance",
@@ -316,6 +380,13 @@ export const arbitrationCourtAbi = [
     "outputs": [],
     "stateMutability": "nonpayable"
   },
+  {
+    "type": "function",
+    "name": "initializeV2",
+    "inputs": [],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
   {
     "type": "function",
     "name": "joinArbitrator",
@@ -439,7 +510,7 @@ export const arbitrationCourtAbi = [
       {
         "name": "",
         "type": "uint8",
-        "internalType": "enum ArbitrationCourt.Phase"
+        "internalType": "enum CourtTypes.Phase"
       }
     ],
     "stateMutability": "view"
@@ -765,6 +836,19 @@ export const arbitrationCourtAbi = [
     ],
     "stateMutability": "view"
   },
+  {
+    "type": "function",
+    "name": "waiveAppeal",
+    "inputs": [
+      {
+        "name": "caseId",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
   {
     "type": "event",
     "name": "AcceptWindowStarted",
@@ -821,6 +905,25 @@ export const arbitrationCourtAbi = [
     ],
     "anonymous": false
   },
+  {
+    "type": "event",
+    "name": "AppealWaived",
+    "inputs": [
+      {
+        "name": "caseId",
+        "type": "bytes32",
+        "indexed": true,
+        "internalType": "bytes32"
+      },
+      {
+        "name": "party",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      }
+    ],
+    "anonymous": false
+  },
   {
     "type": "event",
     "name": "AppealWindowStarted",
@@ -896,6 +999,25 @@ export const arbitrationCourtAbi = [
     ],
     "anonymous": false
   },
+  {
+    "type": "event",
+    "name": "CaseResolvedByDefault",
+    "inputs": [
+      {
+        "name": "caseId",
+        "type": "bytes32",
+        "indexed": true,
+        "internalType": "bytes32"
+      },
+      {
+        "name": "executorWins",
+        "type": "bool",
+        "indexed": false,
+        "internalType": "bool"
+      }
+    ],
+    "anonymous": false
+  },
   {
     "type": "event",
     "name": "CommitStarted",
@@ -959,6 +1081,25 @@ export const arbitrationCourtAbi = [
     ],
     "anonymous": false
   },
+  {
+    "type": "event",
+    "name": "JurorExcluded",
+    "inputs": [
+      {
+        "name": "caseId",
+        "type": "bytes32",
+        "indexed": true,
+        "internalType": "bytes32"
+      },
+      {
+        "name": "juror",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      }
+    ],
+    "anonymous": false
+  },
   {
     "type": "event",
     "name": "PanelDrawn",
@@ -1027,6 +1168,37 @@ export const arbitrationCourtAbi = [
     ],
     "anonymous": false
   },
+  {
+    "type": "event",
+    "name": "PanelShrunk",
+    "inputs": [
+      {
+        "name": "caseId",
+        "type": "bytes32",
+        "indexed": true,
+        "internalType": "bytes32"
+      },
+      {
+        "name": "finalRound",
+        "type": "bool",
+        "indexed": true,
+        "internalType": "bool"
+      },
+      {
+        "name": "panelSize",
+        "type": "uint8",
+        "indexed": false,
+        "internalType": "uint8"
+      },
+      {
+        "name": "jurors",
+        "type": "address[]",
+        "indexed": false,
+        "internalType": "address[]"
+      }
+    ],
+    "anonymous": false
+  },
   {
     "type": "event",
     "name": "RevealStarted",
@@ -1451,12 +1623,12 @@ export const arbitrationCourtAbi = [
       {
         "name": "current",
         "type": "uint8",
-        "internalType": "enum ArbitrationCourt.Phase"
+        "internalType": "enum CourtTypes.Phase"
       },
       {
         "name": "required",
         "type": "uint8",
-        "internalType": "enum ArbitrationCourt.Phase"
+        "internalType": "enum CourtTypes.Phase"
       }
     ]
   },