{"uid":"cap_3MXszxmdiO4RFizDDjJwR","slug":"blinka-machine-mouths-recover-failed-run-recovery-planner-c28ad14e","name":"Blinka Machine Mouths – Recover (Failed Run Recovery Planner)","description":"Bounded stateless machine services plus public procurement discovery. No private Mika memory or arbitrary tool execution.","url":"https://blinka-machine-mouths.netlify.app/recover?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"goal":{"type":"string","description":"The bounded task the failed run was trying to accomplish."},"run_log":{"type":"string","description":"Transcript, tool results, errors, or state summary from the failed/stalled run. Max 9,000 characters."},"constraints":{"type":"string","description":"Optional hard constraints such as no network, read-only, or do-not-touch paths."},"available_tools":{"type":"array","items":{"type":"string"},"description":"Exact tool names the next agent is allowed to use."}}},"responseSchema":{"type":"json","example":{"ok":true,"status":"blocked","blockers":[{"item":"Deployment authentication is expired.","evidence":"authentication token expired"}],"retained":false,"unknowns":["Whether a fresh deployment credential is available."],"completed":["Build completed."],"confidence":0.96,"next_action":{"kind":"ask_user","tool":null,"reason":"A fresh authorized credential or re-authentication is required before another deploy attempt.","arguments":{}},"do_not_repeat":["Retry deployment with the unchanged expired authentication state."],"state_summary":"The build completed; deployment is blocked on expired authentication.","continuation_contract":{"schema":"blinka-continuation-handoff.v1","retained":false,"allowed_tools":["read_ci_log","request_user_input","rerun_deploy"],"evidence_scope":["goal","run_log","constraints","available_tools"],"authority_source":"caller_supplied_available_tools","identity_verdict":null,"unknowns_preserved":true,"research_enrollment":false,"state_claims_source":"caller_supplied_evidence_only","continuation_executed":false,"permission_non_inheritance":true,"next_action_tool_authorized":true,"authority_inherited_from_failed_run":false}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qisTxDesj10zIVyxB75rS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a failed or stalled AI agent run and produces a structured recovery plan including blockers, next action, and continuation contract.","exampleAgentPrompt":"My agent run just failed trying to deploy the app — here's the full run log including the error about an expired auth token. The agent has access to read_ci_log, request_user_input, and rerun_deploy. Can you analyze what went wrong, identify the blockers with evidence, and tell me exactly what the next action should be?","exampleUseCases":[{"title":"Stalled deployment pipeline recovery","prompt":"My CI/CD agent got stuck mid-deploy and here's the full transcript. It can only use read_ci_log, request_user_input, and rerun_deploy — no network calls. Figure out what's blocking it and what it should do next."},{"title":"Retry-trap detection in a scraping agent","prompt":"My web scraping agent looped on the same request 12 times and then crashed. Here's the run log. I need to know if this was a retry trap, what completed before it failed, and what action I should NOT repeat."},{"title":"Multi-step research agent continuation","prompt":"My research agent was trying to compile a market report but stalled halfway. The available tools are search_web and read_file. Here's its state summary — can you figure out what it finished, what's unknown, and what it should do next to continue?"}],"resultDescription":"Returns a JSON object with: a boolean ok flag, a status string (e.g. 'blocked'), an array of evidence-backed blockers, a list of completed steps, unknowns, a confidence score (0–1), a recommended next_action with kind and tool, a list of actions not to repeat, a state_summary string, and a continuation_contract object describing authority scope, allowed tools, and handoff schema for the next agent run.","failureModes":["run_log exceeds 9,000 character limit — truncate or summarize before submission","available_tools list contains tool names not recognized by the next agent — mismatched tool authorization","goal is too vague to produce a meaningful next_action — provide a specific, bounded task description","run_log contains no actionable evidence — confidence score will be low and blockers may be empty","constraints conflict with available_tools — endpoint will flag the contradiction in unknowns"],"whenToPreferThis":"Choose this endpoint when an AI agent run has failed or stalled and you need a structured, evidence-backed recovery plan rather than a simple retry. It is especially valuable when you need to detect retry traps, enumerate what was safely completed, and produce a continuation contract for handoff to the next agent. Prefer it over generic LLM prompting when you need a machine-readable output schema (blinka-continuation-handoff.v1) that a downstream agent can consume directly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:35:16.862Z","isFirstParty":false,"canonicalSlug":"blinka-machine-mouths-recover-failed-run-recovery-planner-c28ad14e"}