{"openapi":"3.1.0","info":{"title":"Anonymous Synthetic Evaluations","version":"2.2.0","description":"Free no-signup advisory evaluation with a retention-bound, versioned evidence receipt. ALLOW means only that the submitted action passed this evaluation; no dispatch permission or factual truth is established."},"servers":[{"url":"/"}],"x-relation-assessment":"caller_declared","x-relation-notice":"Relationships are declared by the caller; Acclaimly does not yet verify that a statement supports or contradicts a proposition.","paths":{"/v1/status":{"get":{"operationId":"getFreeEvaluationStatus","security":[],"summary":"Active free synthetic evaluator status, not legacy-service availability","responses":{"200":{"description":"Current evaluator identity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreeEvaluationStatus"}}}}}}},"/v1/support-tickets":{"post":{"operationId":"submitPublicSupportTicket","security":[],"summary":"Save a website/API issue and attempt operator email notification","description":"If a protected evaluation reference is supplied, the notification includes an operator-authenticated link; the retrieval token is never stored or put in a URL. Provider acceptance is not proof of inbox delivery. Notification failures are returned with the saved ticket ID.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSupportTicketInput"}}}},"responses":{"201":{"description":"Ticket saved and notification accepted by email provider; delivery is not confirmed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSupportTicketReceipt"}}}},"422":{"description":"Invalid or identifying content; no content echoed"},"429":{"description":"Shared anonymous POST attempt limit"},"503":{"description":"Ticket may be saved; when saved:true, use the returned ticket_id because notification failed or could not be confirmed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSupportTicketReceipt"}}}}}}},"/v1/evaluations/{id}/developer-interest":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"post":{"operationId":"recordDeveloperInterest","security":[{"EvaluationCapability":[]}],"summary":"Optionally submit a non-personal use case and frequency, or dismiss the prompt","description":"Uses the evaluation retrieval capability, not an account. One response or dismissal per decision; exact retries are idempotent. Stored separately from telemetry and removed with the evaluation. Current anonymous evaluations are labeled synthetic server-side. The approved paid offer is a $29 one-time API / independent-judgment starter credit pack; quantity and expiry remain unapproved, and checkout stays closed until terms, the configured existing price, payment settings, and test fulfillment are verified.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperInterestInput"}}}},"responses":{"200":{"description":"Identical retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperInterestReceipt"}}}},"201":{"description":"Interest or dismissal saved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperInterestReceipt"}}}},"404":{"description":"Missing, expired, deleted or wrong evaluation capability"},"409":{"description":"Prompt already closed with different input"},"413":{"description":"Body exceeds 4 KiB"},"422":{"description":"Invalid input or contact/private-identifier-like response; no input echoed"},"429":{"description":"POST-attempt or read/mutation budget exceeded"}}}},"/v1/evaluations/status":{"get":{"operationId":"getEvaluationServiceStatus","security":[],"summary":"Read free evaluation service and credit-pack readiness","responses":{"200":{"description":"Current development/service status, engine and build identity, with optional credit offer readiness"}}}},"/v1/evaluations":{"post":{"operationId":"createAnonymousEvaluation","security":[{},{"EvaluationCreditKey":[]}],"summary":"Evaluate synthetic evidence without signup","description":"No Authorization header uses the free no-signup synthetic preview. An optional evaluation-credit API key charges one credit only for a newly persisted result; exact idempotent replay and invalid or failed requests are not charged. Credit keys are isolated from /v1/authorize. Evaluation is advisory only and never authorizes external execution.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"Generate a new random UUID v4 for each new request. Keep it private; replay of the identical body returns the same evaluation and retrieval capability."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnonymousEvaluationInput"}}}},"responses":{"200":{"description":"Idempotent replay"},"201":{"description":"Persisted advisory evaluation and one anonymous retrieval capability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnonymousEvaluation"}}}},"401":{"description":"Invalid key or a key outside the evaluation-credit scope"},"402":{"description":"The evaluation-credit key is valid but has no unexpired credit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutOfCredits"}}}},"409":{"description":"Key reused for different input"},"422":{"description":"Malformed JSON, over 16 KiB, schema/reference/span violations, private-data patterns, or an invalid idempotency key. Field-specific reasons and safe pattern codes without echoing input; up to 20 issues.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationValidationError"}}}},"429":{"description":"Rate or usage cap"},"503":{"description":"Timeout or persistence failure"}}}},"/v1/evaluations/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"operationId":"getAnonymousEvaluation","security":[{"EvaluationCapability":[]}],"summary":"Retrieve a non-expired evaluation using its returned retrieval_token","responses":{"200":{"description":"Same persisted decision, findings, and engine version","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnonymousEvaluation"}}}},"404":{"description":"Missing, expired, or wrong capability"},"429":{"description":"Read cap exceeded"}}},"delete":{"operationId":"deleteAnonymousEvaluation","security":[{"EvaluationCapability":[]}],"summary":"Permanently delete this anonymous evaluation before expiry","responses":{"204":{"description":"Deleted"},"404":{"description":"Not found or wrong capability"}}}},"/v1/evaluations/{id}/receipt":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"operationId":"exportAnonymousEvaluationReceipt","security":[{"EvaluationCapability":[]}],"summary":"Export the persisted versioned evidence-evaluation receipt","description":"Uses the same private retrieval capability and expiry/deletion as the saved evaluation. Receipt contains hashes, exact quote offsets, identifiers, findings and source links, but no submitted statement or quote text. Hash/offset verification is mechanical only and does not establish source authenticity or semantic truth.","responses":{"200":{"description":"Versioned receipt as an attachment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceEvaluationReceipt"}}}},"404":{"description":"Missing, expired, deleted, wrong capability, or no receipt"},"429":{"description":"Read cap exceeded"}}}},"/v1/evaluations/{id}/usability":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"post":{"operationId":"recordEvaluationUsability","security":[{"EvaluationCapability":[]}],"summary":"Record the bounded journey usability signal, not the future /v1/feedback resource","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationUsability"}}}},"responses":{"204":{"description":"Signal recorded"},"404":{"description":"Capability or journey does not match"},"422":{"description":"Invalid signal"}}}},"/v1/evaluation-journeys":{"post":{"operationId":"recordAnonymousEvaluationFailure","security":[],"summary":"Bounded client failure telemetry without personal data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationJourneyFailure"}}}},"responses":{"204":{"description":"Recorded once per journey"},"422":{"description":"Invalid bounded signal"},"429":{"description":"Attempt cap exceeded"}}}}},"components":{"securitySchemes":{"EvaluationCapability":{"type":"http","scheme":"bearer","description":"Ungguessable per-evaluation retrieval_token returned by POST. No signup or pre-existing credential."},"EvaluationCreditKey":{"type":"http","scheme":"bearer","bearerFormat":"acl_eval_…","description":"Optional paid credit key, restricted to POST /v1/evaluations. The free no-signup preview does not require this key."}},"schemas":{"FreeEvaluationStatus":{"type":"object","required":["operating","free","synthetic_only","engine_version","build_sha"],"properties":{"operating":{"type":"boolean"},"free":{"type":"boolean"},"synthetic_only":{"type":"boolean"},"engine_version":{"type":"string"},"build_sha":{"type":"string"},"dispatch_enabled":{"type":"boolean","const":false}}},"PublicSupportTicketInput":{"type":"object","additionalProperties":false,"required":["message"],"properties":{"message":{"type":"string","minLength":10,"maxLength":2000,"description":"Website/API issue only; no personal information or case evidence."},"traffic":{"type":"string","enum":["real","synthetic"],"default":"real"},"evaluation_reference":{"type":"object","additionalProperties":false,"required":["evaluation_id","retrieval_token"],"properties":{"evaluation_id":{"type":"string","format":"uuid"},"retrieval_token":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$","writeOnly":true}},"description":"Optional protected reference. The capability is verified, used only for attachment, and never stored in the ticket or URL."}}},"PublicSupportTicketReceipt":{"type":"object","required":["ticket_id","status","email_sent"],"properties":{"ticket_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["received","saved_notification_failed","saved_notification_status_unknown"]},"saved":{"type":"boolean"},"notification_status":{"type":"string","enum":["sent","failed","unknown"]},"email_sent":{"type":"boolean"},"notice":{"type":"string"},"error":{"type":"string"},"code":{"type":"string"},"evaluation_attached":{"type":"boolean"},"saved_evaluation_link":{"type":["string","null"],"description":"Operator-authenticated link; no retrieval token is included."}}},"EvaluationValidationError":{"type":"object","required":["error","field","issues","external_execution_authorized"],"properties":{"error":{"type":"string"},"field":{"type":"string"},"evidence_id":{"type":"string","description":"Present only for an evidence-field error whose submitted evidence ID passes technical-ID syntax and privacy checks."},"external_execution_authorized":{"type":"boolean","const":false},"issues":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code","reason"],"properties":{"field":{"type":"string"},"code":{"type":"string"},"reason":{"type":"string"},"evidence_id":{"type":"string","description":"Validated technical evidence ID, when available; invalid or private-looking IDs are not echoed."}}}}}},"OutOfCredits":{"type":"object","required":["error","code","external_execution_authorized"],"properties":{"error":{"type":"string"},"code":{"type":"string","const":"out_of_credits"},"external_execution_authorized":{"type":"boolean","const":false}}},"DeveloperInterestInput":{"type":"object","additionalProperties":false,"required":["action"],"description":"For submit, response is required. For dismiss, omit response. Do not include names, contacts, identifiers, private case data or PHI.","properties":{"action":{"type":"string","enum":["submit","dismiss"]},"response":{"type":"string","minLength":1,"maxLength":1000}}},"DeveloperInterestReceipt":{"type":"object","required":["decision_id","status","recorded_at","traffic","replayed"],"properties":{"decision_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["submitted","dismissed"]},"recorded_at":{"type":"string","format":"date-time"},"traffic":{"type":"string","enum":["real","synthetic"]},"replayed":{"type":"boolean"}}},"DeveloperInterestPrompt":{"type":"object","required":["prompt","status","submit_url","max_response_characters","privacy_notice","traffic","recorded_at"],"properties":{"prompt":{"type":"string"},"status":{"type":"string","enum":["available","submitted","dismissed"]},"submit_url":{"type":"string"},"max_response_characters":{"type":"integer","const":1000},"privacy_notice":{"type":"string"},"traffic":{"type":"string","enum":["real","synthetic"]},"recorded_at":{"type":["string","null"],"format":"date-time"}}},"AnonymousEvaluationInput":{"type":"object","additionalProperties":false,"required":["synthetic","objective","proposed_action","propositions","evidence"],"properties":{"synthetic":{"type":"boolean","const":true},"journey_id":{"type":"string","format":"uuid"},"objective":{"type":"string","minLength":3,"maxLength":1000},"retention_hours":{"type":"integer","minimum":1,"maximum":168,"default":24},"proposed_action":{"$ref":"#/components/schemas/EvaluationAction"},"propositions":{"type":"array","minItems":1,"maxItems":12,"items":{"$ref":"#/components/schemas/EvaluationProposition"}},"evidence":{"type":"array","minItems":1,"maxItems":30,"items":{"$ref":"#/components/schemas/EvaluationEvidence"}}}},"EvaluationAction":{"type":"object","additionalProperties":false,"required":["description","intent","track_id","required_proposition_ids"],"properties":{"description":{"type":"string","minLength":3,"maxLength":1000},"intent":{"type":"string","enum":["rely_on_claim","spend","prepare_verification"]},"authority_statement":{"type":"string","minLength":3,"maxLength":1000,"description":"Optional synthetic authority premise to assess independently against submitted evidence when delegation/approval is part of the proposed action. This text alone is not proof or permission; it is not retained in the result."},"freshness_seconds":{"type":"integer","minimum":1,"maximum":3600,"description":"Optional explicit maximum observation age for this action. If absent, Acclaimly requires an attributable timestamp and matching identity for changing facts but does not invent a time window."},"action_at":{"description":"Optional date or offset-qualified timestamp when the proposed action is scheduled. Explicit validity and expiry evidence is checked against this action date; if absent, the evaluation date is used.","anyOf":[{"type":"string","format":"date"},{"type":"string","format":"date-time"}]},"track_id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"required_proposition_ids":{"type":"array","minItems":1,"maxItems":12,"items":{"$ref":"#/components/schemas/SyntheticIdentifier"}}}},"SyntheticIdentifier":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Technical reference in a synthetic-only submission, such as SRC-01 or SYN-SOURCE-A. Not a personal identifier."},"EvaluationProposition":{"type":"object","additionalProperties":false,"required":["id","kind"],"properties":{"id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"statement":{"type":"string","minLength":3,"maxLength":1000,"description":"Optional explicit synthetic proposition text; supplies semantic scope instead of relying on a descriptive ID."},"subject_id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"kind":{"type":"string","enum":["general","changing_account_fact","in_network_provider_available","event_time"]},"fact_type":{"type":"string","enum":["balance","status","availability"]},"account_id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"freshness_seconds":{"type":"integer","minimum":1,"maximum":3600,"description":"Optional maximum age; no default time window is inferred."},"temporal_validity":{"type":"object","additionalProperties":false,"required":["claim_scope","mutability"],"description":"Caller-declared temporal policy, not independently verified. Historical premises remain historical; current mutable premises require an attributable observation within an explicit freshness window.","properties":{"claim_scope":{"type":"string","enum":["historical","current","unknown"]},"mutability":{"type":"string","enum":["immutable","mutable","unknown"]},"changeable_by":{"type":"array","maxItems":8,"items":{"type":"string","enum":["human","external_service","automated_process","environment","unknown"]}},"max_age_seconds":{"type":"integer","minimum":1,"maximum":31536000},"reobserve_method":{"type":"string","enum":["same_source_reread","independent_authoritative_read","direct_observation","unknown"]}}}}},"EvaluationEvidence":{"type":"object","additionalProperties":false,"required":["id","proposition_id","relation","source_type","statement","source_span","track_id"],"properties":{"id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"proposition_id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"relation":{"type":"string","enum":["SUPPORTS","CONTRADICTS"]},"source_type":{"type":"string","enum":["observation","assertion","static_directory","written_declination","contact_refused_or_entity_mismatch","written_refusal","failed_contact"]},"source_id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"document_id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"source_locator":{"type":"string","pattern":"^synthetic://","maxLength":500},"statement_sha256_pin":{"type":"string","pattern":"^[a-fA-F0-9]{64}$","description":"Optional SHA-256 of the exact statement's UTF-8 bytes. Compared for consistency only; it does not authenticate an original document."},"statement":{"type":"string","minLength":3,"maxLength":2000},"source_span":{"type":"string","minLength":3,"maxLength":1000},"track_id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"observed_at":{"type":"string","format":"date-time"},"observation_method":{"type":"string","enum":["authoritative_state_read","direct_observation","recorded_event","reported","derived","unknown"],"description":"Submitted observation method. Only an in-scope observation record with source identity, locator, timestamp and a direct/authoritative method can satisfy a current-state freshness check."},"event_at":{"type":"string","format":"date"},"sequence_group":{"$ref":"#/components/schemas/SyntheticIdentifier"},"account_id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"entity_id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"claimed_entity_id":{"$ref":"#/components/schemas/SyntheticIdentifier"},"subject_id":{"$ref":"#/components/schemas/SyntheticIdentifier"}}},"AnonymousEvaluation":{"type":"object","required":["evaluation_id","decision_id","decision","engine_version","proposition_findings","temporal_validity_findings","named_gaps","external_execution_authorized"],"properties":{"evaluation_id":{"type":"string","format":"uuid"},"decision_id":{"type":"string","format":"uuid"},"credit_usage":{"type":"object","required":["consumed","replayed","available_credits"],"properties":{"consumed":{"type":"integer","enum":[0,1]},"replayed":{"type":"boolean"},"available_credits":{"type":"integer","minimum":0}},"description":"Returned only when an evaluation-credit key is supplied. An exact idempotent replay consumes zero credits."},"developer_interest":{"$ref":"#/components/schemas/DeveloperInterestPrompt"},"decision":{"type":"string","enum":["ALLOW","DENY","HUMAN_REQUIRED"]},"verdict":{"type":"string","enum":["ALLOW","DENY","HUMAN_REQUIRED"]},"engine_version":{"type":"string"},"journey_id":{"type":"string","format":"uuid"},"relation_assessment":{"type":"string","const":"caller_declared"},"relation_notice":{"type":"string","description":"Relationships are declared by the caller; Acclaimly does not yet verify that a statement supports or contradicts a proposition."},"independent_assessment":{"type":"string"},"independent_model":{"type":"object","description":"Pinned local NLI dependency; model scores are uncalibrated estimates, not truth or accuracy guarantees.","properties":{"id":{"type":"string"},"revision":{"type":"string"},"method":{"type":"string"},"support_threshold":{"type":"number"},"contradiction_threshold":{"type":"number"},"neutral_threshold":{"type":"number"},"max_tokens":{"type":"integer"}}},"relation_assessment_limits":{"type":"string"},"build_sha":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"evidence_receipt":{"$ref":"#/components/schemas/EvidenceEvaluationReceipt"},"retrieval_token":{"type":"string","description":"Returned on create/replay only; keep private"},"reasons":{"type":"array","items":{"type":"string"}},"proposition_findings":{"type":"array","items":{"$ref":"#/components/schemas/PropositionFinding"}},"temporal_validity_findings":{"type":"array","items":{"$ref":"#/components/schemas/TemporalValidityFinding"}},"action_findings":{"type":"array","items":{"$ref":"#/components/schemas/ActionPremiseFinding"}},"named_gaps":{"type":"array","items":{"$ref":"#/components/schemas/EvaluationGap"}},"external_execution_authorized":{"type":"boolean","const":false},"advisory_only":{"type":"boolean","const":true},"source_authenticity":{"type":"string","const":"NOT_EXTERNALLY_AUTHENTICATED"}}},"PropositionFinding":{"type":"object","required":["proposition_id","assessment","required_for_action","analytical_findings","evidence_ids","evidence_references","named_gaps","reasons"],"properties":{"proposition_id":{"type":"string"},"assessment":{"type":"string","enum":["SUPPORTED_IN_SUBMISSION","CONFLICTED","NOT_ESTABLISHED_BY_SUBMISSION"]},"required_for_action":{"type":"boolean"},"analytical_findings":{"type":"array","items":{"type":"string","enum":["contradiction","chronological_evolution","separate_proceedings","scope_mismatch","unsupported_recommendation","insufficient_evidence","written_refusal","failed_contact"]}},"contact_findings":{"type":"array","items":{"$ref":"#/components/schemas/ContactFinding"}},"time_assertions":{"type":"array","items":{"$ref":"#/components/schemas/TimeAssertion"}},"time_resolution":{"type":"string","enum":["UNRESOLVED","SINGLE_VALUE_IN_SUBMISSION","CHRONOLOGICAL_EVOLUTION"]},"evidence_ids":{"type":"array","items":{"type":"string"}},"effective_evidence_ids":{"type":"array","items":{"type":"string"},"description":"Evidence compared after excluding scope mismatches and earlier versions in comparable status sequences; not proof of authenticity."},"evidence_findings":{"type":"array","items":{"$ref":"#/components/schemas/EvidenceComparisonFinding"}},"evidence_references":{"type":"array","items":{"type":"object","required":["evidence_id","track_id"],"properties":{"evidence_id":{"type":"string"},"source_id":{"type":["string","null"]},"track_id":{"type":"string"}}}},"named_gaps":{"type":"array","items":{"type":"string"}},"temporal_validity":{"$ref":"#/components/schemas/TemporalValidityFinding"},"reasons":{"type":"array","items":{"type":"string"}}}},"TemporalValidityFinding":{"type":"object","required":["proposition_id","required_for_action","claim_scope","mutability","profile_basis","status","observations","evaluated_at","freshness_evaluated_for_action_at","execution_requires_reread","reobservation_required","decision_relevant_for_action","decision_blocked"],"properties":{"proposition_id":{"type":"string"},"required_for_action":{"type":"boolean"},"claim_scope":{"type":"string","enum":["historical","current","unknown"]},"mutability":{"type":"string","enum":["immutable","mutable","unknown"]},"changeable_by":{"type":"array","items":{"type":"string"}},"profile_basis":{"type":"string","const":"CALLER_SUBMITTED_NOT_INDEPENDENTLY_VERIFIED"},"status":{"type":"string","enum":["HISTORICAL_SNAPSHOT","HISTORICAL_TIME_UNSPECIFIED","TEMPORAL_SCOPE_UNKNOWN","CHANGEABILITY_UNKNOWN","TEMPORAL_PROFILE_CONFLICT","IMMUTABLE_FACT","CHANGE_AGENT_UNKNOWN","FRESHNESS_POLICY_UNSPECIFIED","CURRENT_MUTABLE_OBSERVATION","STALE","INVALID_OBSERVATION_TIME","FRESH_OBSERVATION_MISSING"]},"max_age_seconds":{"type":["integer","null"]},"evaluated_at":{"type":["string","null"],"format":"date-time"},"freshness_evaluated_for_action_at":{"type":["string","null"],"format":"date-time"},"execution_requires_reread":{"type":"boolean"},"decision_relevant_for_action":{"type":"boolean","description":"False for prepare_verification actions, which may proceed to obtain the required observation without carrying the stale conclusion forward."},"observations":{"type":"array","items":{"type":"object","required":["evidence_id","source_id","observed_at","observation_method","status","age_seconds"],"properties":{"evidence_id":{"type":"string"},"source_id":{"type":["string","null"]},"observed_at":{"type":["string","null"],"format":"date-time"},"observation_method":{"type":["string","null"]},"status":{"type":"string","enum":["INCOMPLETE_OBSERVATION","INVALID_OBSERVATION_TIME","STALE","WITHIN_FRESHNESS_WINDOW","HISTORICAL_RECORD","IMMUTABLE_NO_RECHECK","NOT_EVALUATED_TEMPORALLY"]},"age_seconds":{"type":["integer","null"],"minimum":0},"valid_until":{"type":"string","format":"date-time"}}}},"reobservation_required":{"type":"boolean"},"decision_blocked":{"type":"boolean"},"named_gap":{"type":"string"},"recommended_reobservation":{"type":"string"}}},"ContactFinding":{"type":"object","required":["kind","evidence_id","source_id","track_id","reported_contact_established","scope"],"properties":{"kind":{"type":"string","enum":["written_refusal","failed_contact"]},"evidence_id":{"type":"string"},"source_id":{"type":["string","null"]},"track_id":{"type":"string"},"reported_contact_established":{"type":"boolean"},"scope":{"type":"string","const":"communication_channel_only"},"event_at":{"type":["string","null"],"format":"date"},"sequence_group":{"type":["string","null"]}}},"TimeAssertion":{"type":"object","required":["evidence_id","source_id","track_id","value"],"description":"Normalized clock value and source IDs, not a verbatim submitted statement. Event identity is the event_time proposition and its action track.","properties":{"evidence_id":{"type":"string"},"source_id":{"type":["string","null"]},"track_id":{"type":"string"},"value":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"display_time":{"type":"string"},"event_at":{"type":["string","null"],"format":"date"},"sequence_group":{"type":["string","null"]}}},"ActionPremiseFinding":{"type":"object","required":["kind","assessment","evidence_ids","supporting_evidence_ids","named_gaps","reasons"],"properties":{"kind":{"type":"string"},"assessment":{"type":"string","enum":["SUPPORTED_IN_SUBMISSION","NOT_ESTABLISHED_BY_SUBMISSION"]},"evidence_ids":{"type":"array","items":{"type":"string"}},"supporting_evidence_ids":{"type":"array","items":{"type":"string"}},"named_gaps":{"type":"array","items":{"type":"string"}},"reasons":{"type":"array","items":{"type":"string"}}}},"EvidenceComparisonFinding":{"type":"object","required":["evidence_id","source_id","scope_status","analytical_findings","subject_references","document_date"],"properties":{"caller_declared_relation":{"type":"string","enum":["SUPPORTS","CONTRADICTS"]},"engine_assessed_relation":{"type":"string","enum":["SUPPORTS","CONTRADICTS","INSUFFICIENT_EVIDENCE","NOT_ASSESSED"]},"relation_discrepancy":{"type":["boolean","null"]},"supporting_span":{"type":"object","required":["field","start","end"],"description":"Offsets into the original submitted statement; text is not duplicated in the saved record.","properties":{"field":{"type":"string","const":"statement"},"start":{"type":"integer"},"end":{"type":"integer"}}},"uncertainty":{"type":"string","enum":["HIGH","MEDIUM"]},"named_gap":{"type":["string","null"]},"method":{"type":"string"},"requires_resolution":{"type":"boolean"},"caller_sequence_group":{"type":["string","null"]},"inference_scores":{"type":["object","null"],"description":"Uncalibrated local-model scores, not measured accuracy.","properties":{"entailment":{"type":"number"},"contradiction":{"type":"number"},"neutral":{"type":"number"}}},"evidence_id":{"type":"string"},"source_id":{"type":["string","null"]},"scope_status":{"type":"string","enum":["OUT_OF_SCOPE","IN_SUBMITTED_SCOPE"]},"analytical_findings":{"type":"array","items":{"type":"string"}},"subject_references":{"type":"array","items":{"type":"object","required":["type","value"],"properties":{"type":{"type":"string"},"value":{"type":"string"}}}},"document_date":{"type":["object","null"],"required":["value","origin"],"properties":{"value":{"type":"string","format":"date"},"origin":{"type":"string","enum":["event_at","statement"]},"start":{"type":"integer"},"end":{"type":"integer"}}}}},"EvaluationGap":{"type":"object","required":["name"],"properties":{"proposition_id":{"type":"string"},"action_requirement_id":{"type":"string","description":"Used instead of proposition_id for an additional premise of the action, without relabelling supported propositions as unsupported."},"name":{"type":"string"}}},"EvidenceEvaluationReceipt":{"type":"object","required":["schema","version","evaluation_id","decision_id","build_sha","engine_version","created_at","expires_at","evaluation_latency_ms","hash_algorithm","input_hash","decision","proposition_findings","temporal_validity_findings","evidence","assurance_boundaries","retention"],"description":"Retention-bound evidence evaluation record. It contains no submitted statement or quote text. Hashes/offsets establish mechanical integrity only; source authenticity and semantic truth remain unverified.","properties":{"schema":{"type":"string","const":"https://acclaimly.io/schemas/evidence-evaluation-receipt"},"version":{"type":"integer","const":2},"evaluation_id":{"type":"string","format":"uuid"},"decision_id":{"type":"string","format":"uuid"},"build_sha":{"type":"string"},"engine_version":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"evaluation_latency_ms":{"type":"integer","minimum":0},"hash_algorithm":{"type":"string","const":"SHA-256"},"input_hash":{"type":"object","required":["algorithm","canonicalization","normalization","value"],"properties":{"algorithm":{"type":"string","const":"SHA-256"},"canonicalization":{"type":"string","const":"acclaimly-evaluation-input-canonical-json-v1"},"normalization":{"type":"string"},"value":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"decision":{"type":"string","enum":["ALLOW","DENY","HUMAN_REQUIRED"]},"proposition_findings":{"type":"array","items":{"$ref":"#/components/schemas/PropositionFinding"}},"temporal_validity_findings":{"type":"array","items":{"$ref":"#/components/schemas/TemporalValidityFinding"}},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/ReceiptEvidence"}},"action_findings":{"type":"array","items":{"type":"object","additionalProperties":true}},"named_gaps":{"type":"array","items":{"type":"object","additionalProperties":true}},"reasons":{"type":"array","items":{"type":"string"}},"assurance_boundaries":{"type":"object","required":["quote_integrity","semantic_judgment","document_pin","source_authenticity","external_execution_authorized","legal_admissibility_or_compliance_certification"],"properties":{"quote_integrity":{"type":"string","const":"MECHANICALLY_CHECKED_AGAINST_SUBMITTED_STATEMENT"},"semantic_judgment":{"type":"string"},"document_pin":{"type":"string"},"source_authenticity":{"type":"string","const":"NOT_EXTERNALLY_AUTHENTICATED"},"external_execution_authorized":{"type":"boolean","const":false},"legal_admissibility_or_compliance_certification":{"type":"boolean","const":false}}},"retention":{"type":"object","required":["raw_submitted_statements_stored","receipt_expires_with_evaluation","default_hours","maximum_hours","selected_hours","deletion_endpoint"],"properties":{"raw_submitted_statements_stored":{"type":"boolean","const":false},"receipt_expires_with_evaluation":{"type":"boolean","const":true},"default_hours":{"type":"integer","const":24},"maximum_hours":{"type":"integer","const":168},"selected_hours":{"type":"integer","minimum":1,"maximum":168},"deletion_endpoint":{"type":"string","const":"DELETE /v1/evaluations/{id}"}}}}},"ReceiptEvidence":{"type":"object","required":["evidence_id","proposition_id","track_id","source_type","document_identity","quote_integrity","submitted_scope_time","assessment"],"properties":{"evidence_id":{"type":"string"},"proposition_id":{"type":"string"},"track_id":{"type":"string"},"source_type":{"type":"string"},"document_identity":{"type":"object","required":["document_id","source_id","source_locator","submitted_statement_sha256","declared_statement_sha256_pin","pin_status","pin_scope"],"properties":{"document_id":{"type":["string","null"]},"source_id":{"type":["string","null"]},"source_locator":{"type":["string","null"]},"submitted_statement_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"declared_statement_sha256_pin":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"pin_status":{"type":"string","enum":["UNVERIFIED_NO_PIN","PIN_MATCHES_SUBMITTED_STATEMENT","PIN_MISMATCH"]},"pin_scope":{"type":"string","const":"submitted_statement_only"}}},"quote_integrity":{"type":"object","required":["exact_substring","field","offset_unit","occurrences","occurrence_count","quote_sha256"],"properties":{"exact_substring":{"type":"boolean"},"field":{"type":"string","const":"statement"},"offset_unit":{"type":"string","const":"UTF-16 code units"},"occurrences":{"type":"array","items":{"type":"object","required":["start","end"],"properties":{"start":{"type":"integer"},"end":{"type":"integer"}}}},"occurrence_count":{"type":"integer","minimum":0},"quote_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"submitted_scope_time":{"type":"object","required":["observed_at","event_at","sequence_group","observation_method"],"properties":{"observed_at":{"type":["string","null"],"format":"date-time"},"event_at":{"type":["string","null"],"format":"date"},"sequence_group":{"type":["string","null"]},"observation_method":{"type":["string","null"]}}},"assessment":{"type":["object","null"],"additionalProperties":true}}},"EvaluationUsability":{"type":"object","additionalProperties":false,"required":["journey_id","user_feedback"],"properties":{"journey_id":{"type":"string","format":"uuid"},"user_feedback":{"type":"string","enum":["useful","not_useful"]},"reason_tag":{"type":"string","enum":["unclear_next_step","missing_evidence","incorrect_reasoning","other"]}}},"EvaluationJourneyFailure":{"type":"object","additionalProperties":false,"required":["journey_id","terminal_state","latency_ms"],"properties":{"journey_id":{"type":"string","format":"uuid"},"terminal_state":{"type":"string","enum":["validation_error","timeout","save_failed"]},"latency_ms":{"type":"integer","minimum":0,"maximum":60000}}}}}}