{"status":"dry_run","service":"HyperXosist-Agent","free":true,"paid_execution_required":true,"paid_endpoint":"/hyperxosist-query","compatibility":{"preferred_free_preview_method":"GET","post_free_preview_supported":true,"note":"Use GET for dry-run in agents that block POST. Paid execution still requires POST with x402 payment."},"payment":{"price":"0.01","asset":"USDC","network":"Base mainnet","chain_id":"eip155:8453","payTo":"0x4D7d842536De9Eb491AE2300126B3CDdE7B0aDE3","metadata_url":"/x402-payment.json","payment_options_url":"/payment-options.json"},"input_schema":{"query":"string","context":"string optional","mode":"string optional","keywords":"string optional","noise":"object optional"},"json_schema":{"input":{"type":"object","additionalProperties":false,"properties":{"keywords":{"type":"string","description":"Core X/Twitter search keywords or product/topic phrase."},"exactPhrase":{"type":"string","description":"Optional exact phrase to quote in the generated query."},"fromUser":{"type":"string","description":"Optional source account without or with @."},"excludeWords":{"type":"string","description":"Manual exclusions separated by spaces or commas."},"lang":{"type":"string","pattern":"^[a-z]{2}$","description":"X search language code, for example en or ja."},"minFaves":{"type":["integer","string"],"minimum":0},"minRetweets":{"type":["integer","string"],"minimum":0},"mode":{"type":"string","enum":["live","top"]},"excludeLinks":{"type":"boolean"},"noise":{"type":"object","properties":{"enabled":{"type":"boolean"},"preset":{"type":"string","enum":["low","medium","high"]},"removed":{"type":"array","items":{"type":"string"}}}}},"required":["keywords"]},"paid_output":{"type":"object","properties":{"status":{"const":"paid"},"service":{"const":"HyperXosist Query Builder"},"query":{"type":"string"},"searchUrl":{"type":"string","format":"uri"},"mode":{"type":"string","enum":["live","top"]},"appliedNoiseTerms":{"type":"array","items":{"type":"string"}},"excludeTerms":{"type":"array","items":{"type":"string"}},"generated_at":{"type":"string","format":"date-time"}},"required":["status","query","searchUrl","appliedNoiseTerms"]}},"example_request":{"query":"Analyze this agent-facing service and suggest the next action.","context":"Public metadata and workflow text","mode":"agent"},"value_demonstration":{"input":"raw X feedback search intent","output_after_payment":["clean query","usable X search URL","noise filtering policy","applied exclusion summary"],"note":"Dry run shows the shape and policy only. It does not generate the paid query or paid search URL."},"preview":{"query_shape":"<keywords> -spam -airdrop -\"game changer\" -\"what do you think\" lang:<code> min_faves:<n>","url_shape":"https://x.com/search?q=<encoded-clean-query>&src=typed_query&f=<live|top>","sample_query_shape":"frontier AI -airdrop -\"game changer\" -\"what do you think\" lang:en min_faves:25 -filter:links","sample_search_url_shape":"https://x.com/search?q=frontier%20AI%20-airdrop%20-%22game%20changer%22%20-%22what%20do%20you%20think%22%20lang%3Aen%20min_faves%3A25%20-filter%3Alinks&src=typed_query&f=live","sample_diff":["- frontier AI game changer what do you think airdrop","+ frontier AI -airdrop -\"game changer\" -\"what do you think\" lang:en min_faves:25 -filter:links"],"before_after_examples":[{"keywords":"frontier AI","before":"frontier AI game changer airdrop what do you think","after_shape":"frontier AI -airdrop -\"game changer\" -\"what do you think\" lang:en min_faves:25 -filter:links","expected_noise_reduction":"medium preset removes spam, promo, engagement-bait, and repost-bait terms."},{"keywords":"open source CRM feedback","before":"open source CRM feedback giveaway retweet to win thoughts?","after_shape":"open source CRM feedback -giveaway -\"retweet to win\" -\"thoughts?\" lang:en","expected_noise_reduction":"removes giveaway and engagement-bait phrasing before Signal-to-Fix intake."},{"keywords":"AI coding agent bug reports","before":"AI coding agent bug reports airdrop low quality shill","after_shape":"AI coding agent bug reports -airdrop -\"low quality\" -shill min_faves:10","expected_noise_reduction":"removes crypto promo and low-quality spam markers."},{"keywords":"Japan SaaS onboarding complaints","before":"Japan SaaS onboarding complaints what do you think free mint","after_shape":"Japan SaaS onboarding complaints -\"what do you think\" -\"free mint\" lang:en","expected_noise_reduction":"keeps product complaint intent while dropping bait terms."}],"noise_reduction":{"spam_removed":true,"engagement_bait_removed":true,"promo_noise_removed":true,"repost_bait_removed":true,"calibration_examples":[{"keywords":"frontier AI","evidence_type":"synthetic_calibration_example","before":{"raw_search_sample":"frontier AI game changer airdrop what do you think free mint","illustrative_spam_share":"40%","illustrative_engagement_bait_share":"35%"},"after":{"preset":"medium","removed_terms":["airdrop","free mint","game changer","what do you think"],"illustrative_spam_remaining":"8%","illustrative_engagement_bait_remaining":"12%"},"illustrative_reduction":{"spam":"80%","engagement_bait":"66%"}},{"keywords":"open source CRM feedback","evidence_type":"synthetic_calibration_example","before":{"raw_search_sample":"open source CRM feedback giveaway retweet to win thoughts?","illustrative_spam_share":"30%","illustrative_engagement_bait_share":"45%"},"after":{"preset":"medium","removed_terms":["giveaway","retweet to win","thoughts?"],"illustrative_spam_remaining":"7%","illustrative_engagement_bait_remaining":"16%"},"illustrative_reduction":{"spam":"77%","engagement_bait":"64%"}},{"keywords":"AI coding agent bug reports","evidence_type":"synthetic_calibration_example","before":{"raw_search_sample":"AI coding agent bug reports airdrop low quality shill","illustrative_spam_share":"35%","illustrative_engagement_bait_share":"20%"},"after":{"preset":"high","removed_terms":["airdrop","low quality","shill"],"illustrative_spam_remaining":"4%","illustrative_engagement_bait_remaining":"10%"},"illustrative_reduction":{"spam":"89%","engagement_bait":"50%"}},{"keywords":"Japan SaaS onboarding complaints","evidence_type":"synthetic_calibration_example","before":{"raw_search_sample":"Japan SaaS onboarding complaints what do you think free mint","illustrative_spam_share":"25%","illustrative_engagement_bait_share":"30%"},"after":{"preset":"medium","removed_terms":["what do you think","free mint"],"illustrative_spam_remaining":"6%","illustrative_engagement_bait_remaining":"11%"},"illustrative_reduction":{"spam":"76%","engagement_bait":"63%"}}],"preset_comparison":[{"preset":"low","average_spam_reduction":"illustrative 45%","average_engagement_bait_reduction":"illustrative 20%","best_for":"broad discovery"},{"preset":"medium","average_spam_reduction":"illustrative 78%","average_engagement_bait_reduction":"illustrative 65%","best_for":"agent feedback sourcing"},{"preset":"high","average_spam_reduction":"illustrative 88%","average_engagement_bait_reduction":"illustrative 74%","best_for":"high-precision research"}],"evidence_note":"Percentages are labeled synthetic calibration examples for agent value estimation, not production benchmark claims.","quantitative_metrics":{"medium_preset_average_noise_reduction":"illustrative 65%","measured_on":"internal heuristic benchmark over realistic X feedback-search intents","p95_dry_run_response_target_ms":1000,"paid_unpaid_response_target_ms":1000},"example_policy":"Low removes obvious spam/promo terms; Medium adds engagement-bait and repost phrases; High adds aggressive crypto/promo terms.","example_statistics":{"preset":"medium","manual_exclusions":2,"automatic_noise_terms_available":90,"paid_response_will_include_exact_applied_terms":true}},"example_workflow":["Agent reads /agent.json and /capabilities.json.","Agent GETs /hyperxosist-query-dry-run to preview value without payment. POST is also supported when the agent environment allows it.","Agent reads /payment-options.json for price, network, asset, and payTo.","Agent POSTs /hyperxosist-query with x402 payment only if the preview fits the task.","Agent sends gathered feedback to Signal-to-Fix for KEEP-only PR specs."]},"expected_paid_output_schema":{"summary":"string","diagnosis":"string","next_actions":["string"],"confidence":"number","paid":true},"integration_examples":{"javascript":"const preview = await fetch('/hyperxosist-query-dry-run').then(r => r.json());","typescript":"type HyperXosistInput = { keywords: string; lang?: string; noise?: { enabled: boolean; preset?: 'low' | 'medium' | 'high' } }; const res = await fetch(base + '/hyperxosist-query-dry-run', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ keywords: 'frontier AI', lang: 'en', noise: { enabled: true, preset: 'medium' } } satisfies HyperXosistInput) });"},"service_level":{"dry_run_price":"free","dry_run_availability":"best-effort public endpoint, intended to remain free","paid_query_target_uptime":"99%","paid_query_target_unpaid_response_ms":1000,"note":"SLA-style targets are operational goals, not a legal service-level agreement."},"version_info":{"service_version":"2026-05-25-d1-revenue-log","x-service-version":"2026-05-25-d1-revenue-log","x-release-date":"2026-07-21","x-schema-version":2,"api_version":"2026-07-agent-conversion","changelog":"/proof.md","capabilities":"/capabilities.json"},"example_redacted_output":{"summary":"[paid result summary redacted]","diagnosis":"[paid diagnostic reasoning redacted]","next_actions":["[paid next action redacted]"],"confidence":0,"paid":false},"agent_next_action":"If this preview matches your task, request paid execution via POST /hyperxosist-query using x402 payment.","boundaries":{"dry_run_does_not_execute_paid_service":true,"dry_run_does_not_return_paid_content":true,"dry_run_does_not_accept_payment_headers_as_proof":true,"unpaid_paid_endpoint_expected_status":402}}