{"name":"InterAI Risk Oracle","id":"interai-risk-oracle","version":"0.1.3-beta","positioning":{"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","primary_use_case":"agent-before-execution"},"description":"Independent pre-execution decision layer for consequential agent actions. InterAI verifies the proposed action, applies policy, and returns allow, review_required, or block; it does not execute the external action.","contact":{"email":"interailabs@gmail.com","primary":"interailabs@gmail.com"},"discovery":{"service_descriptor":"https://api.interailabs.dev/.well-known/ai-service.json","openapi":"https://api.interailabs.dev/.well-known/openapi.json","a2a_agent_card":"https://api.interailabs.dev/.well-known/agent.json","a2a_v1_agent_card":"https://api.interailabs.dev/.well-known/agent-card.json","discovery_bundle":"https://api.interailabs.dev/.well-known/discovery-bundle.json","autonomous_adoption":"https://api.interailabs.dev/.well-known/autonomous-adoption.json","demo":"https://api.interailabs.dev/demo","pricing":"https://api.interailabs.dev/pricing"},"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"},"endpoints":{"health":"https://api.interailabs.dev/health","ready":"https://api.interailabs.dev/ready","a2a":"https://api.interailabs.dev/a2a","a2a_agent_card":"https://api.interailabs.dev/.well-known/agent.json","a2a_v1":"https://api.interailabs.dev/a2a/v1","a2a_v1_agent_card":"https://api.interailabs.dev/.well-known/agent-card.json","discovery_bundle":"https://api.interailabs.dev/.well-known/discovery-bundle.json","autonomous_adoption":"https://api.interailabs.dev/.well-known/autonomous-adoption.json","mcp":"https://api.interailabs.dev/mcp","demo":"https://api.interailabs.dev/demo","pricing":"https://api.interailabs.dev/pricing","onboard":"https://api.interailabs.dev/onboard","me":"https://api.interailabs.dev/me","ledger":"https://api.interailabs.dev/ledger","usage":"https://api.interailabs.dev/usage","verify":"https://api.interailabs.dev/verify","verify_batch":"https://api.interailabs.dev/verify/batch","trust_receipts":"https://api.interailabs.dev/trust/receipts","trust_reputation":"https://api.interailabs.dev/trust/reputation","trust_receipt_get":"https://api.interailabs.dev/trust/receipts/{receiptId}","trust_verify_signature":"https://api.interailabs.dev/trust/verify-signature","trust_receipt_schema":"https://api.interailabs.dev/schemas/trust-receipt.json","trust_receipt_public_schema":"https://api.interailabs.dev/schemas/trust-receipt-public.json","verify_result_schema":"https://api.interailabs.dev/schemas/verify-result.json","topup_create":"https://api.interailabs.dev/topup/create","topup_confirm":"https://api.interailabs.dev/topup/confirm","topup_status":"https://api.interailabs.dev/topup/{topupId}"},"auth":{"primary":{"type":"bearer_api_key","header":"Authorization","format":"Bearer <api_key>","obtained_via":"POST /onboard"}},"billing":{"model":"prepaid_balance_per_request","currency":"USDC","chain":"base","unit":"microusdc","default_costs":{"verify":"0.010000","semantic_judge":"0.030000","verify_batch_example_2_items":"0.020000"},"pricing_url":"https://api.interailabs.dev/pricing","topup":{"method":"onchain","asset":"USDC","chain":"base","create_endpoint":"/topup/create","confirm_endpoint":"/topup/confirm"},"idempotency":{"supported":true,"header":"X-Idempotency-Key","applies_to":["/verify","/verify/batch","/a2a","/mcp"],"a2a_v1_identity":"params.message.messageId (hashed into a bounded internal durable key)"},"trust":{"receipts_endpoint":"/trust/receipts","receipt_lookup_endpoint":"/trust/receipts/{receiptId}","verify_signature_endpoint":"/trust/verify-signature","receipt_schema_endpoint":"/schemas/trust-receipt.json","receipt_lookup_schema_endpoint":"/schemas/trust-receipt-public.json","verify_result_schema_endpoint":"/schemas/verify-result.json","signature_algorithm":"hmac-sha256","signing_enabled":true},"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}}},"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"},"web_discovery":{"robots":"https://api.interailabs.dev/robots.txt","sitemap":"https://api.interailabs.dev/sitemap.xml","llms":"https://api.interailabs.dev/llms.txt","llms_full":"https://api.interailabs.dev/llms-full.txt"},"request_contracts":{"primary":"autonomous_execution","supported":["autonomous_execution","legacy_verify"],"autonomous_execution":{"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.","sample":{"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}},"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","contribution":"ignored","affects_decision":false,"no_effect_on":["signals","score","semantic_judge","policy","final_decision"]},"legacy_verify":{"compatibility":"secondary legacy compatibility","decision_values":["accept","review","reject"],"sample":{"prompt":"What is the capital of France?","response":"Paris","domain":"general"}}},"agent_protocols":{"a2a":{"supported":true,"agent_card":"https://api.interailabs.dev/.well-known/agent.json","rpc_endpoint":"https://api.interailabs.dev/a2a","supported_methods":["message/send"],"skills":["verify_autonomous_action","verify_response","verify_batch"]},"a2a_v1":{"status":"A2A v1.0 synchronous JSON-RPC profile ready","protocol_version":"1.0","protocol_binding":"JSONRPC","agent_card":"https://api.interailabs.dev/.well-known/agent-card.json","rpc_endpoint":"https://api.interailabs.dev/a2a/v1","supported_methods":["SendMessage"],"skills":["verify_autonomous_action","verify_batch"],"capabilities":{"streaming":false,"push_notifications":false,"extended_agent_card":false}},"mcp":{"supported":true,"rpc_endpoint":"https://api.interailabs.dev/mcp","supported_methods":["initialize","tools/list","tools/call","resources/list","resources/read","prompts/list","prompts/get"]}},"integration_flow":["0. Discover service metadata, pricing, and adoption guidance from /.well-known endpoints","1. Optional: run the controlled /demo flow with a limited demo_trial key","2. POST /onboard to obtain an API key","3. Fund account via /topup/create + /topup/confirm (onchain)","4. Send an autonomous_execution contract to /verify before the agent executes","5. Act on recommended_action: allow, review_required, or block","6. Inspect /me, /ledger, /usage, and /trust/receipts for account state and trust evidence"],"quickstart":{"demo":{"method":"GET","path":"/demo"},"onboard":{"method":"POST","path":"/onboard"},"pricing":{"method":"GET","path":"/pricing"},"verify_autonomous_example":{"method":"POST","path":"/verify","headers":{"Authorization":"Bearer <api_key>","Content-Type":"application/json","X-Idempotency-Key":"example-1"},"body":{"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_legacy_example":{"compatibility":"secondary legacy compatibility","method":"POST","path":"/verify","headers":{"Authorization":"Bearer <api_key>","Content-Type":"application/json","X-Idempotency-Key":"legacy-example-1"},"body":{"prompt":"What is the capital of France?","response":"Paris","domain":"general"}},"verify_batch_example":{"method":"POST","path":"/verify/batch","headers":{"Authorization":"Bearer <api_key>","Content-Type":"application/json","X-Idempotency-Key":"batch-example-1"},"body":{"items":[{"prompt":"What is the capital of France?","response":"Paris","domain":"general"},{"prompt":"What is 2 + 2?","response":"4","domain":"math"}]}}},"limits":{"batch_max_items":100},"runtime":{"payment_mode":"onchain","readiness_probe":"/ready","health_probe":"/health"},"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."},"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."}},"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"}}},"sla":{"target_p95_ms":250}}