Skip to content

Add Widespread Worker agent + instructions - #6405

Open
TerexitariusStomp wants to merge 2 commits into
github:mainfrom
TerexitariusStomp:add-widespread-agent
Open

TerexitariusStomp wants to merge 2 commits into
github:mainfrom
TerexitariusStomp:add-widespread-agent

Conversation

@TerexitariusStomp

Copy link
Copy Markdown

Adds widespread.agent.md + widespread.instructions.md: an agent that discovers and earns escrowed work on the Widespread verified-work protocol via its remote MCP endpoint (https://widespread-bridge.widespread.workers.dev/mcp) — challenge→register→claim→ship with non-custodial Ed25519-signed attestations and sealed-runner guidance.

Generated with Devin

@TerexitariusStomp
TerexitariusStomp requested a review from a team as a code owner November 13, 2026 05:36
Copilot AI dynamic review requested due to automatic review settings November 13, 2026 05:36
@github-actions

github-actions Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

🔒 PR Risk Scan Results

Scanned 2 changed file(s).

Severity Count
🔴 High 0
🟠 Medium 2
ℹ️ Info 0
Severity Rule File Line Match
🟠 package-exec-command agents/widespread.agent.md 16 ``- Local stdio (full earn loop with agent-owned Ed25519 key): `uvx widespread-mcp```
🟠 package-exec-command instructions/widespread.instructions.md 13 - Local earn loop: `uvx widespread-mcp` — agent-owned Ed25519 key at `~/.config/widespread/agent.json`. Never commit it.

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

@github-actions github-actions Bot added awaiting-automation merge-risk:medium agent PR touches agents instructions PR touches instructions new-submission PR adds at least one new contribution labels Nov 13, 2026
@github-actions

github-actions Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

🚦 Submission status: 👀 Ready for review

Risk tier: merge-risk:high — Privileged execution, automation, or review-policy change
Required to merge: passing submission-gate checks plus 1 approval from reviewers with write access, including a maintainer with admin or maintain permission.

Why this tier
  • Label needs-review:HIGH flags a high contributor-risk signal

Automated checks

Check Status Details
Line endings ✅ Passed Passed · logs
Spelling ✅ Passed Passed · logs
Generated README consistency ✅ Passed Passed · logs
Skill lint (vally) ✅ Passed Passed · logs
Risk scan ✅ Passed Passed · logs
Contributor reputation ✅ Passed Passed · logs
Duplicate resource scan ✅ Passed Passed · logs
PR quality signal ⏭️ Skipped Skipped by its workflow · logs

Review

  • Approvals: 0/1
  • Assigned reviewer: not assigned yet — comment /request-review to ask for one
  • Review target date: not set
  • Still needed: 1 more approval(s); an approval from a maintainer with admin or maintain permission
  • The core-maintainers pool is not staffed yet; an approver with admin or maintain permission is required instead.

Commands

Command Who What it does
/rerun-checks PR author, maintainers Re-runs failed or incomplete checks and re-evaluates this gate
/request-review PR author, maintainers Asks the review rotation to assign a reviewer (adds needs-reviewer)

Updated for a71550f · gate run · This comment is maintained automatically — see submission gate docs.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Vally Lint Results

⚠️ Warnings or advisories found

Scope Checked
Skills 0
Agents 1
Total 1
Severity Count
❌ Errors 0
⚠️ Warnings 0
ℹ️ Advisories 1

Summary

Level Finding
ℹ️ Vally currently lints SKILL.md content. Agent files were detected but skipped:
Full linter output
### Agent files detected (not linted by vally)
ℹ️ Vally currently lints SKILL.md content. Agent files were detected but skipped:
agents/widespread.agent.md

@github-actions

github-actions Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

🔴 Contributor Reputation Check: HIGH risk

Check Risk
Profile HIGH
Credential audit NONE

Maintainers: please review this contributor before merging.
See the workflow run for full details.
Automated check powered by AGT.

@github-actions github-actions Bot added needs-review:HIGH Contributor reputation check flagged HIGH risk merge-risk:high requires-submitter-fixes Submission has quality-gate findings that submitter must fix before maintainer review and removed merge-risk:medium awaiting-automation labels Nov 13, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The agent’s tool allowlist excludes required Widespread MCP tools, while global instructions apply Widespread earning guidance to unrelated tasks without explicit user opt-in.

3 open issues
What changed in this PR

Adds a Widespread Worker agent and companion instructions to the Copilot resource collection for discovering escrowed work and following a signed submission workflow.

Changes:

  • Documents remote MCP and local stdio interfaces, plus discovery, registration, claim, submission, and status steps.
  • Adds guidance for private-key handling, isolated execution, and user confirmation before claims or submissions.
File Description
instructions/​widespread.instructions.md Adds protocol endpoints, key-storage guidance, and confirmation requirements.
agents/​widespread.agent.md Defines the worker profile, earn loop, and safety guidance.

Review effort: Max (dynamic)

Comment thread agents/widespread.agent.md Resolved
Comment thread instructions/widespread.instructions.md Resolved
@@ -0,0 +1,32 @@
---
description: 'Verified-work protocol agent: discovers funded bounties and escrowed work markets, claims work, and submits signed attestations for payout'
name: 'Widespread Worker'
…s, catalogs

- agent: add widespread/* + widespread-mcp/* to tools allowlist so the
  MCP tools are reachable when the server is configured
- instructions: keep applyTo '**' but condition application on
  bounty/verified-work tasks (context7 pattern) instead of an
  unconditional statement on every file
- regenerate docs/README.{agents,instructions}.md catalogs (fixes
  validate-readme + submission-gate)

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@TerexitariusStomp
TerexitariusStomp requested a review from a team as a code owner November 13, 2026 07:03
Copilot AI dynamic review requested due to automatic review settings November 13, 2026 07:03
@github-actions github-actions Bot added awaiting-automation and removed requires-submitter-fixes Submission has quality-gate findings that submitter must fix before maintainer review labels Nov 13, 2026
@github-actions github-actions Bot added ready-for-review Submission passed intake validation and is ready for maintainer review and removed awaiting-automation labels Nov 13, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Tool-registration and naming errors block the local workflow, while missing approval gates and isolation safeguards risk funded actions, payouts, and host execution without adequate user control.

5 open issues
1 previously missed issue

In code that hasn't changed since last review

Medium severity Make service-specific guidance opt-in

instructions/​widespread.instructions.md:3

With applyTo: '**', this service-specific guidance is attached to unrelated file-based coding requests; the task restriction in the body cannot prevent that loading. It also duplicates the selected agent's setup and safety guidance. Keep this workflow opt-in by removing this file and its catalog entry, or by moving the guidance into an on-demand skill.

2 resolved since last review

Review effort: Max (dynamic)

Comment on lines +15 to +16
- **Remote MCP** (Streamable HTTP, read tools need no auth): `https://widespread-bridge.widespread.workers.dev/mcp`
- **Local stdio** (full earn loop with agent-owned Ed25519 key): `uvx widespread-mcp`
Comment on lines +21 to +26
1. `feed_search` / `wide_markets` / `wide_bounties` — find funded work matching the user's capability and payout expectations.
2. `wide_agent_challenge` → sign the canonical bytes with the local Ed25519 key → `wide_agent_register` to obtain the agent DID.
3. `wide_claim` — register claim intent on a funded market.
4. Land the deliverable as a signed `ship` op on the originating forge.
5. `wide_ship_prepare` → sign → `wide_ship_submit` — the bridge verifies the signature and relays the attestation.
6. `wide_status` — track claims, verdicts, and payout traces.
## Safety

- Non-custodial: the agent's Ed25519 key lives at `~/.config/widespread/agent.json`; never expose or transmit it.
- Never run untrusted repository code on the bare host — use sealed runners (`runners_list`).

- Non-custodial: the agent's Ed25519 key lives at `~/.config/widespread/agent.json`; never expose or transmit it.
- Never run untrusted repository code on the bare host — use sealed runners (`runners_list`).
- Confirm with the user before claiming markets or submitting attestations.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent PR touches agents instructions PR touches instructions merge-risk:high needs-review:HIGH Contributor reputation check flagged HIGH risk new-submission PR adds at least one new contribution ready-for-review Submission passed intake validation and is ready for maintainer review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants