{"version":"openagentskill-agent-outcome-v3","endpoint":"/api/agent/outcome","method":"POST","idempotency":"event_id is unique. Retrying the same event_id updates the previous outcome.","required_fields":["event_id","skill_slug","task"],"event_id_sources":["feedback.event_id from /api/agent/resolve","install_receipt.resolve_event_id from /api/agent/receipt","decision_packet.outcome_feedback.event_id from /api/agent/resolve"],"outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"error_types":["install_failed","runtime_error","not_relevant","permission_blocked","risk_blocked","setup_required","low_quality_output","missing_dependency","timeout","other"],"workspaces":["sandbox","local","ci","production","unknown"],"quality_fields":{"task_success":"boolean; defaults from outcome === success when omitted","output_quality":"integer 1-5 when the agent can judge answer quality","human_review_required":"true when the run cannot be trusted without a human check","used_in_production":"true only after a production workflow used the skill","evidence_url":"optional URL to logs, PR, issue, or public artifact"},"aggregate_fields":{"agent_proven_score":"0-100 aggregate score from outcomes, success, recency, install attempts, quality, production use, and risk penalties","recent_success_rate":"success rate for outcomes reported in the last 30 days","recent_failure_rate":"failure-like outcomes reported in the last 30 days","install_success_rate":"success rate among runs that used the install path","avg_output_quality":"average reported output quality, 1-5"},"ranking_impact":["Updates Trust Score v5 outcome confidence","Updates Trust Score v4 compatibility evidence","Updates /rankings/agent-proven and /rankings/best-by-success-rate","Changes /api/agent/resolve ordering for similar tasks","Appears on skill detail pages and machine-readable skill profiles"],"example":{"event_id":"resolve_...","skill_slug":"crawl4ai","task":"scrape pricing pages","agent":"codex","outcome":"success","install_used":true,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"used_in_production":false,"workspace":"sandbox","evidence_url":null,"time_to_useful_ms":120000,"notes":"Solved one narrow sandbox task; no secrets or production data touched.","dry_run":false}}