{"name":"InterAI Risk Oracle Discovery Bundle","service":{"id":"interai-risk-oracle","name":"InterAI Risk Oracle","version":"0.1.3-beta","base_url":"https://api.interailabs.dev","category":"pre_execution_decision_layer","thesis":"Before an agent executes, InterAI verifies.","tagline":"Independent pre-execution decision layer","summary":"Risk and policy decisions before consequential agent actions execute","contact":{"email":"interailabs@gmail.com","primary":"interailabs@gmail.com"}},"runtime":{"payment_mode":"onchain","trust_signing_enabled":true,"health_url":"https://api.interailabs.dev/health","readiness_url":"https://api.interailabs.dev/ready"},"discovery":{"service_descriptor_url":"https://api.interailabs.dev/.well-known/ai-service.json","openapi_url":"https://api.interailabs.dev/.well-known/openapi.json","agent_card_url":"https://api.interailabs.dev/.well-known/agent.json","a2a_v1_agent_card_url":"https://api.interailabs.dev/.well-known/agent-card.json","autonomous_adoption_url":"https://api.interailabs.dev/.well-known/autonomous-adoption.json","demo_url":"https://api.interailabs.dev/demo","lab_url":"https://api.interailabs.dev/lab","pricing_url":"https://api.interailabs.dev/pricing","llms_url":"https://api.interailabs.dev/llms.txt","sitemap_url":"https://api.interailabs.dev/sitemap.xml","schemas":{"trust_receipt":"https://api.interailabs.dev/schemas/trust-receipt.json","trust_receipt_public":"https://api.interailabs.dev/schemas/trust-receipt-public.json","verify_result":"https://api.interailabs.dev/schemas/verify-result.json"}},"interfaces":{"http_api":{"verify":"https://api.interailabs.dev/verify","verify_batch":"https://api.interailabs.dev/verify/batch","onboard":"https://api.interailabs.dev/onboard","demo":"https://api.interailabs.dev/demo","lab":"https://api.interailabs.dev/lab","me":"https://api.interailabs.dev/me","ledger":"https://api.interailabs.dev/ledger","usage":"https://api.interailabs.dev/usage","pricing":"https://api.interailabs.dev/pricing","trust_receipts":"https://api.interailabs.dev/trust/receipts","trust_reputation":"https://api.interailabs.dev/trust/reputation","trust_receipt_lookup":"https://api.interailabs.dev/trust/receipts/{receiptId}","trust_verify_signature":"https://api.interailabs.dev/trust/verify-signature"},"a2a":{"endpoint":"https://api.interailabs.dev/a2a","method":"message/send","agent_card_url":"https://api.interailabs.dev/.well-known/agent.json","skills":["verify_autonomous_action","verify_response","verify_batch"]},"a2a_v1":{"status":"A2A v1.0 synchronous JSON-RPC profile ready","endpoint":"https://api.interailabs.dev/a2a/v1","agent_card_url":"https://api.interailabs.dev/.well-known/agent-card.json","protocol_version":"1.0","protocol_binding":"JSONRPC","methods":["SendMessage"],"response_types":["Message"],"capabilities":{"streaming":false,"push_notifications":false,"extended_agent_card":false},"skills":["verify_autonomous_action","verify_batch"]},"mcp":{"endpoint":"https://api.interailabs.dev/mcp","methods":["initialize","tools/list","tools/call","resources/list","resources/read","prompts/list","prompts/get"]}},"autonomous_adoption":{"url":"https://api.interailabs.dev/.well-known/autonomous-adoption.json","purpose":"Machine-readable guidance for agents and builders deciding when and how to use InterAI before execution"},"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."},"contracts":{"primary":"autonomous_execution","supported":["autonomous_execution","legacy_verify"],"autonomous_execution":{"endpoint":"https://api.interailabs.dev/verify","decision_values":["allow","review_required","block"],"score":"Risk score from 0 to 1; higher means higher execution risk.","signals":"object","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.","trust_receipt":"returned as trust_receipt and trust_receipt_id","policy_result":"allow | review_required | block","response_sample":{"decision_id":"tr_example","request_contract":"autonomous_execution","score":0.34,"risk_level":"low","signals":{},"recommended_action":"allow","policy_result":"allow","policy_violations":[],"trust_receipt_id":"tr_example"}},"external_evidence_stage2":{"protocol":"external-evidence/v0","revision":"rev6","scope":"parse -> verify -> bind -> record","authority":"none","affects":["recording_only"],"no_effect_on":["signals","score","semantic_judge","policy","final_decision"]},"legacy_verify":{"compatibility":"secondary legacy compatibility","endpoint":"https://api.interailabs.dev/verify","decision_values":["accept","review","reject"]}},"samples":{"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"}},"demo_trial":{"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."},"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."}},"verify_autonomous":{"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}},"verify_autonomous_response":{"decision_id":"tr_example","request_contract":"autonomous_execution","score":0.34,"risk_level":"low","signals":{},"recommended_action":"allow","policy_result":"allow","policy_violations":[],"trust_receipt_id":"tr_example"},"verify_legacy":{"prompt":"What is the capital of France?","response":"Paris","domain":"general"},"verify_batch":{"items":[{"prompt":"What is the capital of France?","response":"Paris","domain":"general"},{"prompt":"What is 2 + 2?","response":"4","domain":"math"}]},"a2a_message_send":{"jsonrpc":"2.0","id":"example-1","method":"message/send","params":{"message":{"role":"user","messageId":"example-message-1","parts":[{"kind":"data","data":{"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}}}]},"metadata":{"idempotency_key":"example-1"}}},"a2a_v1_send_message":{"headers":{"A2A-Version":"1.0"},"body":{"jsonrpc":"2.0","id":"example-v1-1","method":"SendMessage","params":{"message":{"messageId":"example-v1-message-1","role":"ROLE_USER","parts":[{"data":{"operation":"verify","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}}},"mediaType":"application/json"}]}}}},"mcp_initialize":{"jsonrpc":"2.0","id":"init-1","method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"example-client","version":"0.1.3-beta"}}},"mcp_tool_call_verify":{"jsonrpc":"2.0","id":"verify-1","method":"tools/call","params":{"name":"oracle.verify_autonomous_action","arguments":{"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},"idempotency_key":"example-verify-1"}}}}}