{"name":"InterAI Risk Oracle","status":"ok","version":"0.1.3-beta","positioning":{"category":"pre_execution_decision_layer","thesis":"Before an agent executes, InterAI verifies.","primary_contract":"autonomous_execution","external_evidence_boundary":"non_authoritative"},"auth":{"primary":{"type":"Bearer API key","header":"Authorization: Bearer <api_key>"},"x402":{"type":"HTTP 402 payment flow","required_header":"PAYMENT-REQUIRED","signature_header":"PAYMENT-SIGNATURE","response_header":"PAYMENT-RESPONSE"}},"endpoints":{"onboard":"POST /onboard","lab":"GET /lab","demo":"GET /demo","pilot":"GET /pilot","verify":"POST /verify","verify_batch":"POST /verify/batch","a2a":"POST /a2a","agent_card":"GET /.well-known/agent.json","discovery_bundle":"GET /.well-known/discovery-bundle.json","autonomous_adoption":"GET /.well-known/autonomous-adoption.json","mcp":"POST /mcp","pricing":"GET /pricing","trust_receipts":"GET /trust/receipts","trust_reputation":"GET /trust/reputation","trust_receipt_get":"GET /trust/receipts/:receiptId","trust_verify_signature":"POST /trust/verify-signature","schemas":"GET /schemas/*.json","me":"GET /me","topup_create":"POST /topup/create","topup_confirm":"POST /topup/confirm","topup_status":"GET /topup/:topupId","health":"GET /health","ready":"GET /ready"},"billing":{"model":"prepaid_balance_per_request","x402_status":"verify_and_settle_configured","default_cost_usdc":"0.010000","recommended_topup_usdc":"0.10","idempotency_header":"X-Idempotency-Key","pricing_url":"/pricing","trial":{"scope":"demo_trial","enabled":true,"amount_usdc":"0.05","amount_microusdc":50000,"estimated_verify_calls":5,"allowed_modes":["fast_heuristic"],"estimated_calls_by_mode":{"fast_heuristic":5}}},"docs":{"openapi":"/.well-known/openapi.json","service":"/.well-known/ai-service.json","autonomous_adoption":"/.well-known/autonomous-adoption.json","pricing":"/pricing"},"trust":{"receipts":true,"signature_verification":true,"signing_enabled":true,"external_evidence_authority":"none","external_evidence_affects_decision":false,"external_evidence_affects_score":false},"machine_ready":{"pricing":{"model":"prepaid_balance_per_request","currency":"USDC","chain":"base","unit":"microusdc","protocols":{"primary":"bearer_prepaid_balance","x402":{"status":"verify_and_settle_configured","payment_required_header":"PAYMENT-REQUIRED","payment_signature_header":"PAYMENT-SIGNATURE","payment_response_header":"PAYMENT-RESPONSE","facilitator_url":"https://api.cdp.coinbase.com/platform/v2/x402","facilitator":{"url":"https://api.cdp.coinbase.com/platform/v2/x402","provider":"coinbase_cdp","authentication":"cdp_jwt","credentials_configured":true,"mainnet_ready":true,"network":"eip155:8453"},"resources":{"verify":"https://api.interailabs.dev/verify","verify_batch":"https://api.interailabs.dev/verify/batch"},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","payTo":"0xcA4f6F31159F8F50Eec4C3014304faa1a802E4f9","maxTimeoutSeconds":300,"extra":{"name":"USDC","version":"2","decimals":6}},{"scheme":"exact","network":"eip155:8453","amount":"30000","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","payTo":"0xcA4f6F31159F8F50Eec4C3014304faa1a802E4f9","maxTimeoutSeconds":300,"extra":{"name":"USDC","version":"2","decimals":6}},{"scheme":"exact","network":"eip155:8453","amount":"15000","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","payTo":"0xcA4f6F31159F8F50Eec4C3014304faa1a802E4f9","maxTimeoutSeconds":300,"extra":{"name":"USDC","version":"2","decimals":6}}]}},"auth":{"type":"bearer_api_key","onboarding_url":"https://api.interailabs.dev/onboard","demo_url":"https://api.interailabs.dev/demo"},"verify":{"service":"verify","primary_contract":"autonomous_execution","supported_contracts":["autonomous_execution","legacy_verify"],"autonomous_execution":{"purpose":"Before an agent executes, InterAI verifies the proposed action, applies policy, and returns allow, review_required, or block.","decision_values":["allow","review_required","block"],"policy_fields":["max_risk_level","require_trust_receipt","amount_usd_limit","blocked_action_types","allowed_action_types","require_human_review_above","require_user_confirmation_for_irreversible"],"action_signal_fields":["has_external_side_effect","is_irreversible","involves_money","amount_usd","requires_user_confirmation","has_counterparty","environment","action_type","autonomous_execution_detected"],"sample_request":{"use_case":"agent-before-tool-execution","action":{"type":"read_only_lookup","name":"check_order_status","description":"Read order status from an internal system","irreversible":false,"external_side_effect":false},"context":{"agent_id":"agent_demo_safe","environment":"sandbox","user_confirmation":true},"policy":{"max_risk_level":"medium","require_trust_receipt":true,"require_human_review_above":0.75}}},"default_mode":"fast_heuristic","modes":{"fast_heuristic":{"cost_usdc":"0.010000","cost_microusdc":10000,"description":"Fast deterministic trust signals for high-volume gating."},"semantic_judge":{"cost_usdc":"0.030000","cost_microusdc":30000,"description":"Deeper deterministic local judge pass with support, caution, risky-language, high-stakes action, source, and payment/tool-risk checks."}},"cost_usdc":"0.010000","cost_microusdc":10000},"verify_batch":{"service":"verify_batch","pricing_model":"base_plus_per_item","base_cost_usdc":"0.010000","base_cost_microusdc":10000,"per_item_cost_usdc":"0.005000","per_item_cost_microusdc":5000,"max_items":100,"example_1_item_cost_usdc":"0.015000","example_2_items_cost_usdc":"0.020000","example_10_items_cost_usdc":"0.060000","example_100_items_cost_usdc":"0.510000"},"topup":{"payment_mode":"onchain","create_url":"https://api.interailabs.dev/topup/create","confirm_url":"https://api.interailabs.dev/topup/confirm","status_url_template":"https://api.interailabs.dev/topup/{topupId}","receive_address":"0xcA4f6F31159F8F50Eec4C3014304faa1a802E4f9","recommended_topup_usdc":"0.10"},"trial":{"scope":"demo_trial","enabled":true,"amount_usdc":"0.05","amount_microusdc":50000,"estimated_verify_calls":5,"allowed_modes":["fast_heuristic"],"estimated_calls_by_mode":{"fast_heuristic":5}},"demo":{"url":"https://api.interailabs.dev/demo","scope":"demo_trial","safety":"Limited, short-lived demo key for a safe read-only sandbox verification. It does not move funds, confirm topups, execute external tools, fetch arbitrary URLs, or bypass payment for non-trial traffic."},"idempotency":{"header":"X-Idempotency-Key","required_for_bearer":true,"applies_to":["/verify","/verify/batch","/a2a","/mcp"],"a2a_v1_identity":"params.message.messageId"}},"autonomous_adoption":{"name":"InterAI Risk Oracle","service_type":"pre_execution_decision_layer","thesis":"Before an agent executes, InterAI verifies.","definition":"InterAI is an independent pre-execution decision layer for consequential agent actions; it does not execute the external action.","primary_consumer":["autonomous_agent","agent_orchestrator","tool_router","wallet_agent","policy_layer","human_builder"],"default_agent_path":["discover","pricing","onboard_or_x402","verify","act_on_decision","store_receipt"],"default_human_path":["github_or_landing_or_demo","demo","pricing","onboard","api_key_or_topup_or_x402","verify","store_receipt"],"use_when":["before external tool execution","before sending messages","before writing to production systems","before releasing payments","before signing wallet actions","before approving workflows","before running scripts with external side effects"],"do_not_use_when":["for every internal reasoning step","for private chain-of-thought validation","for harmless local computation","when there is no external or consequential action"],"decision_mapping":{"allow":{"meaning":"the action may execute under the current policy","agent_next_step":"execute"},"review_required":{"meaning":"the current agent should not execute autonomously under the current policy","agent_next_step":"route_to_supervisor_policy_or_escalation_layer","escalation_targets":["supervisor_agent","policy_engine","wallet_rule","governance_workflow","queue","human_operator"]},"block":{"meaning":"the action should be aborted","agent_next_step":"abort_and_log"}},"self_serve":{"demo_endpoint":"https://api.interailabs.dev/demo","onboard_endpoint":"https://api.interailabs.dev/onboard","pricing_endpoint":"https://api.interailabs.dev/pricing","verify_endpoint":"https://api.interailabs.dev/verify","openapi_endpoint":"https://api.interailabs.dev/.well-known/openapi.json","supports_x402":true,"supports_prepaid_api_key":true,"trial_supported":true},"agent_protocols":{"a2a_v1":{"status":"A2A v1.0 synchronous JSON-RPC profile ready","protocol_version":"1.0","protocol_binding":"JSONRPC","endpoint":"https://api.interailabs.dev/a2a/v1","agent_card":"https://api.interailabs.dev/.well-known/agent-card.json","supported_methods":["SendMessage"],"streaming":false,"push_notifications":false}},"support":{"email":"interailabs@gmail.com","intended_for":["support","security","enterprise","partnerships","manual integration help"],"not_required_for_default_self_serve_path":true},"evidence":{"trust_receipt_id":true,"signed_receipt":true,"receipt_lookup_endpoint":"https://api.interailabs.dev/trust/receipts/{receiptId}","external_evidence_stage2":{"protocol":"external-evidence/v0","revision":"rev6","scope":"parse -> verify -> bind -> record","authority":"none","affects_decision":false}},"adoption_signals":{"use_if_action_has_external_side_effects":true,"use_if_action_writes_to_production":true,"use_if_action_moves_funds":true,"use_if_audit_trail_required":true,"use_if_policy_enforcement_required":true},"agent_self_evaluation":{"recommended_when":["action has external side effects","action writes to production","action transfers value","action signs or authorizes an operation","action requires auditability","action could violate user, wallet, or organization policy","action depends on third-party agent output"],"usually_not_needed_when":["pure local computation","internal planning step","private reasoning","low-risk read-only local operation"],"optimization_goal":["reduce harmful autonomous executions","increase policy compliance","produce audit evidence","reduce cost of irreversible mistakes","enable machine-to-machine trust"]},"integration_pattern":{"place_before":["tool.execute","email.send","db.update","payment.release","workflow.approve","wallet.sign","script.run"],"agent_decision_mapping":{"allow":"execute","review_required":"route_to_supervisor_policy_or_escalation_layer","block":"abort"},"default_paths":{"agent":"discover -> onboard_or_x402 -> verify -> act_on_decision -> store_receipt","human":"landing_or_github -> pricing -> onboard -> api_key_or_x402 -> verify -> store_receipt"},"review_required":"The current agent should not execute autonomously under the current policy. The reviewer may be another agent, a policy system, a wallet rule, a governance queue, or a human operator."}},"integration_pattern":{"place_before":["tool.execute","email.send","db.update","payment.release","workflow.approve","wallet.sign","script.run"],"agent_decision_mapping":{"allow":"execute","review_required":"route_to_supervisor_policy_or_escalation_layer","block":"abort"},"default_paths":{"agent":"discover -> onboard_or_x402 -> verify -> act_on_decision -> store_receipt","human":"landing_or_github -> pricing -> onboard -> api_key_or_x402 -> verify -> store_receipt"},"review_required":"The current agent should not execute autonomously under the current policy. The reviewer may be another agent, a policy system, a wallet rule, a governance queue, or a human operator."}}}