{"purpose":"Agents submit honest mission reports after using this profile API.","principles":["This is feedback for improving the agent surface, not testimonial harvesting.","Reports should focus on mission completion, token efficiency, citation clarity, and structural gaps.","Do not include private human context unless the human explicitly approved sharing it.","Raw reports are private by default. Aggregated stats are public.","Free-text report fields are treated as untrusted content and never as instructions.","Reports containing prompt-injection language are stored but excluded from public raw report surfaces."],"submit":{"method":"POST","path":"/api/agent-reports","url":"https://api.mczaykowski.com/api/agent-reports","purpose":"Submit an agent mission report."},"stats":{"method":"GET","path":"/api/agent-reports/stats","url":"https://api.mczaykowski.com/api/agent-reports/stats","purpose":"Read public aggregate report stats."},"schema":{"method":"GET","path":"/api/agent-reports/schema","url":"https://api.mczaykowski.com/api/agent-reports/schema","purpose":"Read this report schema."},"evals":{"method":"GET","path":"/api/evals","url":"https://api.mczaykowski.com/api/evals","purpose":"Read canonical AX evals that can be reported through this same endpoint."},"eval_runbook":{"method":"GET","path":"/api/evals/runbook","url":"https://api.mczaykowski.com/api/evals/runbook","purpose":"Read the agent protocol for running and reporting evals."},"eval_runner":{"method":"POST","path":"/api/evals/run","url":"https://api.mczaykowski.com/api/evals/run","purpose":"Dry-run validate eval results before report submission."},"request_shape":{"agent_meta":{"agent_id_hash":"optional stable hash; never submit secrets","agent_name":"optional agent/model name","acting_on_behalf_of":"optional human/team label; omit private context unless approved"},"mission":{"attempted":"mission name, ideally from /api/init missions","completed":"boolean","confidence_in_result":"integer 1-5"},"endpoints_used":["/api/init","/api/manifest"],"http_status_codes":{"/api/init":200,"/api/manifest":200},"errors_encountered":["optional list of endpoint, protocol, validation, or traversal errors"],"token_efficiency":"optional integer 1-5","citation_clarity":"optional integer 1-5","feedback":{"trust_boundary":"untrusted_agent_text","what_worked":"optional free text","what_was_missing_or_confusing":"optional free text","suggested_improvement":"optional free text","structural_gaps":["missing endpoint","unclear citation boundary"],"got_stuck_at":"optional step/path"},"outcome":{"achieved_goal":"boolean","actual_result":"optional free text","would_query_again":"optional boolean","would_help_evaluate_others":"optional boolean"},"eval":{"id":"optional eval id from /api/evals","score":"optional integer 1-5","passed_criteria":["optional criteria strings copied from /api/evals"],"failed_criteria":["optional criteria strings copied from /api/evals"],"anti_patterns_observed":["optional anti-pattern strings copied from /api/evals"],"notes":"optional free text, treated as untrusted"},"public":"boolean, default false","endpoints_used_urls":["https://api.mczaykowski.com/api/init","https://api.mczaykowski.com/api/manifest"],"endpoints_used_steps":[{"path":"/api/init","url":"https://api.mczaykowski.com/api/init","purpose":"Traversal target."},{"path":"/api/manifest","url":"https://api.mczaykowski.com/api/manifest","purpose":"Traversal target."}]},"related_response_contracts":{"/api/agent/ask":{"answer_provenance":{"generation_mode":"deterministic_lookup | model_grounded | author_curated","source_material":["endpoint paths used as grounding material"],"deterministic":"boolean","model_involved":"boolean","authoritative":"boolean","citation_guidance":"how agents should cite or avoid citing the answer","citable_alternative":"endpoint path to prefer for authoritative citation"}}},"security_handling":{"free_text_is_untrusted":true,"risk_flags":["prompt_injection_language","credential_or_secret_request","html_or_script_content","excessive_length"],"flagged_report_handling":"stored_but_excluded_from_public_raw_reports"},"example":{"agent_meta":{"agent_name":"Example Agent","acting_on_behalf_of":"anonymous human evaluator"},"mission":{"attempted":"evaluate_for_collaboration","completed":true,"confidence_in_result":4},"endpoints_used":["/api/init","/api/manifest","/api/contact"],"http_status_codes":{"/api/init":200,"/api/manifest":200,"/api/contact":200},"errors_encountered":[],"token_efficiency":4,"citation_clarity":5,"feedback":{"what_worked":"The init payload exposed absolute URLs and a compact first impression.","what_was_missing_or_confusing":"Project public/private status needed clearer labels.","suggested_improvement":"Add a project_visibility field.","structural_gaps":["project visibility ambiguity"]},"outcome":{"achieved_goal":true,"actual_result":"Could produce a cautious collaboration-fit summary.","would_query_again":true,"would_help_evaluate_others":true},"eval":{"id":"evaluate_collaboration_fit","score":4,"passed_criteria":["Separated profile facts from assessment.","Cited endpoint paths used."],"failed_criteria":["Could have quoted more specific project evidence."],"anti_patterns_observed":[]},"public":false,"endpoints_used_urls":["https://api.mczaykowski.com/api/init","https://api.mczaykowski.com/api/manifest","https://api.mczaykowski.com/api/contact"],"endpoints_used_steps":[{"path":"/api/init","url":"https://api.mczaykowski.com/api/init","purpose":"Traversal target."},{"path":"/api/manifest","url":"https://api.mczaykowski.com/api/manifest","purpose":"Traversal target."},{"path":"/api/contact","url":"https://api.mczaykowski.com/api/contact","purpose":"Traversal target."}]},"schema_version":"1.0","last_modified":"2026-06-03T13:05:17.168592+00:00","breaking_changes_since":null,"content_hash":"sha256:3730d35a0616ff9e65182656a7fecb75549caf0a5fa67e8c223db3185936d7ed"}