Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Example: one complete agent workflow (local mock, tests, then Base Sepolia)

Aperta
  • Qualcosa non va?
#40 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
typescript
Ambito
developer-experience, testing

Direzione di ricerca

Start with the offline example section in docs/DEVELOPERS.md (#test-without-a-chain) and the startMockServer helper exported from @deepfirstsearch/agent-pay/testing, then check how the newcomer CI job runs those examples. Build examples/agent-workflow/ around a free tool call, a paid x402 call and one hostile 402, with a vitest file asserting all three outcomes. Done means npm test passes offline and the newcomer CI job runs the example.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Suggested by @Priyadharshan2003 in #29. Today the docs show each piece on its own:

  • npx @deepfirstsearch/agent-pay demo;
  • a short offline example per framework in docs/DEVELOPERS.md, which CI runs verbatim;
  • the MCP server.

What's missing is one example that goes through a whole agent workflow, start to finish.

What: examples/agent-workflow/, a small agent (AI SDK or LangChain) that:

  1. reads a task;
  2. calls a free tool and a paid x402 API;
  3. hits one hostile 402 along the way, and shows the refusal code it gets back and what the agent does with it (report, ask_owner, retry_later).

It should cover three ways to run it:

  • Local development: against startMockServer from @deepfirstsearch/agent-pay/testing, no keys, no chain.
  • Tests: a vitest file that asserts the paid call succeeds, the hostile one is refused with its code, and the budget is enforced.
  • Base Sepolia: the same agent pointed at a real testnet merchant, with the steps to fund a payer (overlaps with #36).

Done when: a newcomer can clone, npm i, npm test and see all three outcomes, and the README walks through what the agent saw at each step. It also needs to be added to the newcomer CI job.

Lingua principale
TypeScript
Stelle
0
Fork
0
Merge medio
3h 51m
PR unite (30g)
3

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di DeepFirstHQ/deepfirstsearch

Tutte le issue di DeepFirstHQ/deepfirstsearch

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.