{"uid":"cap_78GXfmNbjsdkqRBMtYzwz","slug":"bounty-engineer-task-state-transition-gate-8e6b5054","name":"Bounty Engineer Task State Transition Gate","description":"Machine-buyable infrastructure for autonomous agents: API cost routing, margin optimization, funding-rate data, webpage extraction, result verification, spend controls, retry planning, state, tender search and GitHub bounty intelligence.","url":"https://bounty-engineer-x402-prod.onrender.com/v1/task-state-transition-gate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"},"allow_self":{"type":"boolean"},"allowed_transitions":{"type":"object"}}},"responseSchema":{"type":"json","example":{"ok":true,"to":"completed","from":"working","mode":"task_state_transition_gate","reason":"allowed_transition","decision":"allow","limitations":["The default state machine is a generic agent-task profile. Supply allowed_transitions when a specific protocol or application uses different states."],"allowed_targets":["input_required","completed","failed","cancelled"],"known_from_state":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fgcHf2u-DvoHalyAFsqIR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates and enforces allowed state transitions for agent tasks, returning a decision (allow/deny) with the set of valid next states from a given current state.","exampleAgentPrompt":"Check whether my agent task is allowed to transition from 'working' to 'completed' — I don't have any custom state rules so just use the default task state machine.","exampleUseCases":[{"title":"Guard task completion in agent pipeline","prompt":"My agent task is currently in 'working' state and I want to mark it as 'completed' — can you verify that transition is allowed before I commit it?"},{"title":"Enforce custom protocol state machine","prompt":"I have a custom workflow where tasks go from 'pending' to 'in_review' to 'approved' — check if moving from 'in_review' to 'approved' is valid given these allowed transitions."},{"title":"Prevent self-loop transitions","prompt":"My agent is trying to transition a task from 'failed' back to 'failed' — is that allowed, and if not, what states can it legally move to from 'failed'?"}],"resultDescription":"Returns a JSON object with a boolean 'ok', the decision ('allow' or 'deny'), the reason for the decision, the mode ('task_state_transition_gate'), a list of allowed target states from the current state, a flag indicating whether the from-state is recognized, and any limitations (e.g. whether a generic or custom state machine was applied).","failureModes":["Unknown 'from' state returns known_from_state: false and may restrict allowed_targets","Missing 'to' or 'from' fields may result in a validation error or denial","Custom allowed_transitions map with invalid structure may cause unexpected behavior","Self-transitions denied by default unless allow_self is set to true"],"whenToPreferThis":"Use this endpoint when an autonomous agent needs to enforce task lifecycle rules before committing a state change — especially in multi-step pipelines where illegal transitions could corrupt task state. Prefer it over ad-hoc conditional logic when you need a consistent, auditable gate with explicit allowed-transition semantics and support for custom state machine overrides.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:49:11.100Z","isFirstParty":false,"canonicalSlug":"bounty-engineer-task-state-transition-gate-8e6b5054"}