anlyon-agent-loop

The Agent Skill for handling what an Anlyon call returns inside an agent loop: waiting for approvals, connect prompts, refusals, unknown outcomes and idempotent retries.

anlyon-agent-loop teaches your coding agent what to do with each result an action call can return, in your code, in Vercel AI SDK tools and over MCP. The point is the moves an agent must not make: invoking a parked call again, retrying an outcome that may already have happened, or treating a 200 as success when the body says the call was refused.

What it teaches

• A table of every status and grade, with the next move for each: report, wait, ask the user to connect, tell the user why it was refused, or stop and hand an unknown to a person.
• A loop in TypeScript that invokes with an idempotency key tied to your business operation, waits with approvals.waitForDecision, then reads the invocation.
• The AI SDK results from @anlyonhq/ai-sdk: pending_approval, connect_required, refusal codes and limits, and anlyon_check_request after the user decides.
• The MCP flow: list_actions, action_<name>, wait_for_approval until the decision arrives, and request_approval for a step that is not an action.
• Retrying on purpose: retryOf with a new key after a failed, reconciling an unknown before anything else, and the two idempotency conflicts.

When it loads

When code or prompts deal with actions.invoke, waitForDecision, wait_for_approval or check_approval, anlyon_check_request, AI SDK tool results, idempotency keys, or an invocation that is pending_approval, failed, unknown, denied or expired.

What’s inside

Download: anlyon-agent-loop.zip.

Install

npx skills add https://docs.anlyon.com --skill anlyon-agent-loop

Try it

Our worker calls refund-order through Anlyon. Make it wait for the approval, and make sure a restart can never refund twice.

When the Anlyon tool says the user has to connect Slack, show a Connect button in the chat instead of an error.

Write the system prompt section that tells our agent how to treat Anlyon results.