{"name":"Random Choice","version":"0.6.1","docs_updated":"2026-08-30","description":"Cryptographically secure random picker for 2-100 JSON choices. Use for low-stakes one-off random or weighted selection, unbiased tie-breaking, and sampling. Returns the selected value and index, request ID, and weight totals for audit logs. $0.001 USDC per paid request. Not for stable assignments, gambling, security tokens, or consequential decisions; outcomes are not provably fair.","task_intent":{"primary":"select_one_random_choice","aliases":["random picker","random selector","weighted random choice","random tie breaker","sample one item"],"whenToCall":["Select one item from 2-100 JSON-compatible choices when a fresh random outcome is wanted.","Choose among options with positive relative weights.","Break a low-stakes tie without relying on model preference or list order.","Sample one item from a small caller-supplied set."],"doNotCall":["Do not use when the same input must produce the same output or assignments must remain stable across retries.","Do not use for gambling, lotteries, security tokens, or cryptographic key material.","Do not use as the sole decision-maker for consequential medical, legal, financial, safety, or access-control decisions.","Do not use when independently verifiable or provably fair randomness is required."],"representativeQueries":["Pick one of these equivalent cache regions at random.","Choose one candidate using relative weights 7, 2, and 1.","Break this low-stakes tie between two equally acceptable labels.","Sample one item from this caller-supplied JSON list."]},"value":{"randomness":"Selection uses a server-side cryptographically secure pseudorandom number generator instead of model preference or list order.","auditability":"The response identifies the selected value and zero-based index, whether weights were used, the choice count, and a request ID; weighted responses also include the selected and total weights.","determinism":"Validation and the response shape are deterministic, but the selected outcome is intentionally nondeterministic. Repeating the same request can return a different result.","limitation":"The service does not publish a proof of the random draw, so the outcome is not independently verifiable or provably fair."},"route":{"method":"POST","path":"/random-choice","payment":{"enabled":true,"price":"$0.001","network":"eip155:8453","provider":"coinbase"}},"request":{"choices":"Array of 2-100 JSON-compatible values.","weights":"Optional array of positive finite relative weights, exactly one per choice."},"response":{"selected":"alpha","index":0,"weighted":true,"choice_count":3,"selected_weight":7,"total_weight":10,"request_id":"rc_example","service_hint":{"id":"random-choice","suitable_for":["random_selection","weighted_selection","tie_breaking","sampling"]}},"published_price":{"amount":0.001,"currency":"USDC","display":"$0.001 USDC per paid request","unit":"paid request","protocol":"x402"},"pricing_note":"Promotional validation price. Pricing will be reviewed after paid-call demand and marginal costs are measured.","usage_notes":["Each successful call is a new random event; retries are not idempotent and may be charged again.","Results are generated with a server-side CSPRNG but are not independently verifiable or provably fair.","Do not use for gambling, security tokens, or consequential medical, legal, or financial decisions.","Do not use for routing or experiments that require stable assignments across retries."]}