2026-05-07 22:12:33 +01:00
{
"$schema" : "https://json-schema.org/draft/2020-12/schema" ,
"$id" : "https://github.com/GameCult/Epiphany/blob/main/schemas/ghostlight.agent-state.schema.json" ,
"title" : "Epiphany Ghostlight Agent State Schema" ,
2026-05-29 01:23:43 +01:00
"description" : "Source-lineage Ghostlight contract for dense character agent, perception, relationship, event, scene, and dialogue-context state." ,
2026-05-07 22:12:33 +01:00
"type" : "object" ,
"required" : [
"schema_version" ,
"world" ,
"agents" ,
"relationships" ,
"events" ,
"scenes"
] ,
"additionalProperties" : false ,
"properties" : {
"schema_version" : {
"const" : "ghostlight.agent_state.v0"
} ,
"world" : {
"$ref" : "#/$defs/world_state"
} ,
"agents" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/agent"
}
} ,
"relationships" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/relationship"
}
} ,
"events" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/event"
}
} ,
"scenes" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/scene"
}
}
} ,
"$defs" : {
"world_state" : {
"type" : "object" ,
"required" : [
"world_id" ,
"setting" ,
"time" ,
"canon_context"
] ,
"additionalProperties" : false ,
"properties" : {
"world_id" : {
"type" : "string"
} ,
"setting" : {
"type" : "string"
} ,
"time" : {
"type" : "object" ,
"required" : [
"label"
] ,
"additionalProperties" : true ,
"properties" : {
"label" : {
"type" : "string"
}
}
} ,
"canon_context" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"ambient_pressures" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/pressure"
}
}
}
} ,
"agent" : {
"type" : "object" ,
"required" : [
"agent_id" ,
"identity" ,
"canonical_state" ,
"goals" ,
"memories" ,
"perceived_state_overlays"
] ,
"additionalProperties" : false ,
"properties" : {
"agent_id" : {
"type" : "string"
} ,
"identity" : {
"$ref" : "#/$defs/identity"
} ,
"canonical_state" : {
"$ref" : "#/$defs/canonical_state"
} ,
"goals" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/goal"
}
} ,
"memories" : {
"$ref" : "#/$defs/memory_bundle"
} ,
"perceived_state_overlays" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/perceived_state_overlay"
}
}
}
} ,
"identity" : {
"type" : "object" ,
"required" : [
"name" ,
"roles" ,
"origin" ,
"public_description"
] ,
"additionalProperties" : false ,
"properties" : {
"name" : {
"type" : "string"
} ,
"roles" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"origin" : {
"type" : "string"
} ,
"public_description" : {
"type" : "string"
} ,
"private_notes" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
}
}
} ,
"canonical_state" : {
"type" : "object" ,
"required" : [
"underlying_organization" ,
"stable_dispositions" ,
"behavioral_dimensions" ,
"presentation_strategy" ,
"voice_style" ,
"situational_state" ,
"values"
] ,
"additionalProperties" : false ,
"properties" : {
"underlying_organization" : {
"$ref" : "#/$defs/variable_map"
} ,
"stable_dispositions" : {
"$ref" : "#/$defs/variable_map"
} ,
"behavioral_dimensions" : {
"$ref" : "#/$defs/variable_map"
} ,
"presentation_strategy" : {
"$ref" : "#/$defs/variable_map"
} ,
"situational_state" : {
"$ref" : "#/$defs/variable_map"
} ,
"values" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/value_commitment"
}
} ,
"voice_style" : {
"$ref" : "#/$defs/variable_map"
}
}
} ,
"variable_map" : {
"type" : "object" ,
"additionalProperties" : {
"$ref" : "#/$defs/state_variable"
}
} ,
"state_variable" : {
"type" : "object" ,
"required" : [
"mean" ,
"plasticity" ,
"current_activation"
] ,
"additionalProperties" : false ,
"properties" : {
"mean" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
} ,
"plasticity" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
} ,
"current_activation" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
} ,
"evidence" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
}
}
} ,
"value_commitment" : {
"type" : "object" ,
"required" : [
"value_id" ,
"label" ,
"priority" ,
"unforgivable_if_betrayed"
] ,
"additionalProperties" : false ,
"properties" : {
"value_id" : {
"type" : "string"
} ,
"label" : {
"type" : "string"
} ,
"priority" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
} ,
"unforgivable_if_betrayed" : {
"type" : "boolean"
}
}
} ,
"goal" : {
"type" : "object" ,
"required" : [
"goal_id" ,
"description" ,
"scope" ,
"priority" ,
"emotional_stake" ,
"status"
] ,
"additionalProperties" : false ,
"properties" : {
"goal_id" : {
"type" : "string"
} ,
"description" : {
"type" : "string"
} ,
"scope" : {
"enum" : [
"immediate" ,
"scene" ,
"case" ,
"arc" ,
"life"
]
} ,
"priority" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
} ,
"emotional_stake" : {
"type" : "string"
} ,
"blockers" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"status" : {
"enum" : [
"active" ,
"blocked" ,
"dormant" ,
"resolved" ,
"abandoned"
]
}
}
} ,
"memory_bundle" : {
"type" : "object" ,
"required" : [
"episodic" ,
"semantic" ,
"relationship_summaries"
] ,
"additionalProperties" : false ,
"properties" : {
"episodic" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/memory"
}
} ,
"semantic" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/memory"
}
} ,
"relationship_summaries" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/memory"
}
}
}
} ,
"memory" : {
"type" : "object" ,
"required" : [
"memory_id" ,
"summary" ,
"salience" ,
"confidence"
] ,
"additionalProperties" : false ,
"properties" : {
"memory_id" : {
"type" : "string"
} ,
"summary" : {
"type" : "string"
} ,
"salience" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
} ,
"confidence" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
} ,
"linked_event_ids" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"linked_relationship_id" : {
"type" : "string"
}
}
} ,
"perceived_state_overlay" : {
"type" : "object" ,
"required" : [
"observer_agent_id" ,
"target_agent_id" ,
"perceived_dimensions" ,
"beliefs" ,
"distortions"
] ,
"additionalProperties" : false ,
"properties" : {
"observer_agent_id" : {
"type" : "string"
} ,
"target_agent_id" : {
"type" : "string"
} ,
"perceived_dimensions" : {
"$ref" : "#/$defs/inferred_variable_map"
} ,
"beliefs" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/belief"
}
} ,
"distortions" : {
"type" : "array" ,
"items" : {
"enum" : [
"hostile_attribution" ,
"false_reassurance" ,
"overread_warmth" ,
"underread_threat" ,
"false_mask_detection" ,
"missed_mask_detection" ,
"status_injury" ,
"threat_amplification" ,
"institutional_suspicion_transfer" ,
"care_underread" ,
"mask_overfocus"
]
}
}
}
} ,
"belief" : {
"type" : "object" ,
"required" : [
"belief_id" ,
"claim" ,
"confidence"
] ,
"additionalProperties" : false ,
"properties" : {
"belief_id" : {
"type" : "string"
} ,
"claim" : {
"type" : "string"
} ,
"confidence" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
} ,
"subject_id" : {
"type" : "string"
} ,
"claim_type" : {
"enum" : [
"fact" ,
"identity_inference" ,
"motive_inference" ,
"prediction" ,
"norm" ,
"value_read" ,
"relationship_read"
]
} ,
"evidence_event_ids" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"visibility" : {
"enum" : [
"private" ,
"shared" ,
"public" ,
"rumor"
]
} ,
"emotional_charge" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
}
}
} ,
"relationship" : {
"type" : "object" ,
"required" : [
"relationship_id" ,
"source_id" ,
"target_id" ,
"stance" ,
"summary"
] ,
"additionalProperties" : false ,
"properties" : {
"relationship_id" : {
"type" : "string"
} ,
"source_id" : {
"type" : "string"
} ,
"target_id" : {
"type" : "string"
} ,
"stance" : {
"$ref" : "#/$defs/variable_map"
} ,
"summary" : {
"type" : "string"
} ,
"unresolved_incident_ids" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
}
}
} ,
"event" : {
"type" : "object" ,
"required" : [
"event_id" ,
"kind" ,
"summary" ,
"participants" ,
"pressure_tags"
] ,
"additionalProperties" : false ,
"properties" : {
"event_id" : {
"type" : "string"
} ,
"kind" : {
"enum" : [
"dialogue" ,
"action" ,
"memory" ,
"relationship_shift" ,
"scene_outcome" ,
"author_note"
]
} ,
"summary" : {
"type" : "string"
} ,
"participants" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"pressure_tags" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"observed_exchange" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/event_exchange_turn"
}
} ,
"private_interpretations" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/event_private_interpretation"
}
} ,
"event_effects" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/event_effect"
}
}
}
} ,
"scene" : {
"type" : "object" ,
"required" : [
"scene_id" ,
"location" ,
"participants" ,
"public_stakes" ,
"hidden_stakes" ,
"dialogue_context_packs"
] ,
"additionalProperties" : false ,
"properties" : {
"scene_id" : {
"type" : "string"
} ,
"location" : {
"type" : "string"
} ,
"participants" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"public_stakes" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"hidden_stakes" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"dialogue_context_packs" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/dialogue_context_pack"
}
}
}
} ,
"dialogue_context_pack" : {
"type" : "object" ,
"required" : [
"speaker_agent_id" ,
"listener_ids" ,
"speaker_local_truth" ,
"speaker_beliefs" ,
"active_memories" ,
"active_goals" ,
"presentation_constraints"
] ,
"additionalProperties" : false ,
"properties" : {
"speaker_agent_id" : {
"type" : "string"
} ,
"listener_ids" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"speaker_local_truth" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"speaker_beliefs" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"active_memories" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"active_goals" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"presentation_constraints" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
}
}
} ,
"pressure" : {
"type" : "object" ,
"required" : [
"pressure_id" ,
"label" ,
"intensity"
] ,
"additionalProperties" : false ,
"properties" : {
"pressure_id" : {
"type" : "string"
} ,
"label" : {
"type" : "string"
} ,
"intensity" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
}
}
} ,
"inferred_variable_map" : {
"type" : "object" ,
"additionalProperties" : {
"$ref" : "#/$defs/inferred_state_variable"
}
} ,
"inferred_state_variable" : {
"type" : "object" ,
"required" : [
"observed_activation" ,
"attributed_disposition" ,
"confidence"
] ,
"additionalProperties" : false ,
"properties" : {
"observed_activation" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
} ,
"attributed_disposition" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
} ,
"confidence" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
} ,
"evidence" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
}
}
} ,
"event_exchange_turn" : {
"type" : "object" ,
"required" : [
"speaker_id" ,
"utterance_summary" ,
"dialogue_function"
] ,
"additionalProperties" : false ,
"properties" : {
"speaker_id" : {
"type" : "string"
} ,
"utterance_summary" : {
"type" : "string"
} ,
"dialogue_function" : {
"type" : "string"
} ,
"observable_cues" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
}
}
} ,
"event_private_interpretation" : {
"type" : "object" ,
"required" : [
"agent_id" ,
"interpretation" ,
"confidence"
] ,
"additionalProperties" : false ,
"properties" : {
"agent_id" : {
"type" : "string"
} ,
"interpretation" : {
"type" : "string"
} ,
"attributed_motive" : {
"type" : "string"
} ,
"appraisal_tags" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"confidence" : {
"type" : "number" ,
"minimum" : 0 ,
"maximum" : 1
}
}
} ,
"event_effect" : {
"type" : "object" ,
"required" : [
"agent_id" ,
"summary"
] ,
"additionalProperties" : false ,
"properties" : {
"agent_id" : {
"type" : "string"
} ,
"summary" : {
"type" : "string"
} ,
"state_deltas" : {
"type" : "array" ,
"items" : {
"$ref" : "#/$defs/state_delta"
}
} ,
"new_belief_ids" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"memory_update_ids" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
}
}
} ,
"state_delta" : {
"type" : "object" ,
"required" : [
"path" ,
"delta"
] ,
"additionalProperties" : false ,
"properties" : {
"path" : {
"type" : "string"
} ,
"delta" : {
"type" : "number" ,
"minimum" : -1 ,
"maximum" : 1
}
}
}
}
}