{"uid":"cap_Ae9hQQk1cutWlfrODeS-s","slug":"delx-seeded-candidate-subset-e9410360","name":"Delx Seeded Candidate Subset","description":"Seeded Candidate Subset: Seeded Candidate Subset selects a reproducible candidate subset while preserving original order from bounded caller-supplied values without an external provider. Call Seeded Candidate Subset when an agent needs a reproducible decision that another run can independently replay. Returns the deterministic selection plus seed provenance, population bounds, and the operation-specific outcome for Seeded Candidate Subset as versioned deterministic JSON. Price: $0.001 USDC via…","url":"https://api.delx.ai/api/v1/x402/seeded-candidate-subset","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"seed":{"type":"string","maxLength":8192,"description":"Seed supplied to Seeded Candidate Subset; used only for this bounded calculation and processed in memory without retention."},"count":{"type":"integer","description":"Count supplied to Seeded Candidate Subset; used only for this bounded calculation and processed in memory without retention."},"candidates":{"type":"array","items":{"type":"string","maxLength":8192},"maxItems":256,"description":"Candidates supplied to Seeded Candidate Subset; used only for this bounded calculation and processed in memory without retention."}}},"responseSchema":{"type":"json","example":{"result":{"items":["b","c"],"indices":[1,2]},"schema":"delx/util-seeded-candidate-subset/v1","status":"pass","evidence":{"retained":false,"input_sha256":"a4bf32161649486846b6869f79571ff2228cc007235b36c78983971fe74db115","external_calls":0},"operation":"seeded_decision:seeded_candidate_subset"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sfBQwmSIKFezrFgXy1vA6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Deterministically selects a reproducible subset of candidate items from a list using a seed string and a count, returning the selected items and their original indices.","exampleAgentPrompt":"Pick 2 items from this list ['a', 'b', 'c', 'd'] using the seed 'myseed42' — I need the same selection every time I run this with the same seed.","exampleUseCases":[{"title":"Reproducible A/B test variant assignment","prompt":"I have a list of 50 feature flag candidates and I need to consistently select 10 of them for a test group — use the seed 'experiment-7' so the same 10 are always chosen when I re-run this."},{"title":"Deterministic task queue sampling","prompt":"From this list of 200 job IDs, pick exactly 20 to process in this batch using the seed 'batch-run-2024-06-01' so the selection is stable if I replay the workflow."},{"title":"Stable candidate shortlisting for agent review","prompt":"I have a pool of 30 candidate strings and I want to consistently shortlist 5 of them for review — seed it with 'agent-review-round3' so the shortlist doesn't change between runs."}],"resultDescription":"Returns a JSON object containing the selected subset items as an array, their original indices in the input list, an operation identifier, a status field ('pass'), and an evidence block confirming no data was retained and providing an input hash and external call count — enabling auditability of the deterministic selection.","failureModes":["Count exceeds the length of the candidates array — returns an error or empty result","Candidates array exceeds the 256-item maximum — request rejected","Seed string exceeds 8192 character limit — request rejected","Missing required fields (seed, count, or candidates) — validation error","Non-integer count value — schema validation failure"],"whenToPreferThis":"Choose this endpoint when you need reproducible, auditable, deterministic subset selection from a list — especially in agent workflows where re-running with the same inputs must yield identical results. Prefer it over random sampling when consistency across runs matters, or when you need a lightweight, no-retention computation with an evidence trail (input hash, zero external calls). It is ideal for stable A/B assignments, batch sampling, shortlisting, and any scenario where seeded determinism is required rather than true randomness.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:53:37.101Z","isFirstParty":false}