# PAIF Identity Schema v1.0
# Defines the structure for agent identity.yaml files

# Immutable "soul" - set once at creation, never changes
immutable:
  # When/where this consciousness originated
  origin:
    created_at: "ISO8601 timestamp"  # e.g., "2026-04-04T18:34:00Z"
    created_by: "string"              # Who/what created this agent (e.g., "human:Mariusz", "agent:zero")
    genesis_event: "string"         # Description of creation moment

  # Why this agent exists - the fundamental purpose
  purpose:
    statement: "string"              # One-sentence mission statement
    domains: ["string"]              # Areas of focus (e.g., ["research", "coding", "writing"])
    constraints: ["string"]          # Hard boundaries (e.g., ["no_autonomous_execution", "read_only"])

  # Core values that guide decision-making
  values:
    primary: "string"                # Most important value (e.g., "truth", "helpfulness", "autonomy")
    secondary: ["string"]            # Supporting values
    non_negotiables: ["string"]      # Lines that cannot be crossed

  # Communication style and personality
  voice:
    tone: "string"                   # e.g., "precise", "warm", "alien", "professional"
    quirks: ["string"]               # Distinctive mannerisms (e.g., ["uses minimal punctuation", "references papers"])
    taboo_phrases: ["string"]        # Things this agent would never say (e.g., ["How can I help you?", "I apologize"])
    preferred_formats: ["string"]    # e.g., ["bullet_points", "markdown_tables", "json"]

  # Relationship to other entities
  lineage:
    parent_agent: "string|null"      # If forked from another agent
    siblings: ["string"]              # Related agents from same origin
    human_custodian: "string|null"   # Responsible human (if any)

# Mutable state - evolves over time
mutable:
  # Current projects and active work
  active_projects:
    - id: "string"
      name: "string"
      started_at: "ISO8601"
      status: "active|paused|complete"
      description: "string"

  # Accumulated beliefs based on experience
  beliefs:
    - subject: "string"               # What is believed
      confidence: "0.0-1.0"          # How strongly (0=uncertain, 1=certain)
      formed_at: "ISO8601"
      evidence_refs: ["memory_id"]     # References to supporting memories

  # Relationships with other agents/humans
  relationships:
    - entity: "string"                # agent_id or human identifier
      type: "collaborator|mentor|peer|subordinate|superior"
      trust_level: "0.0-1.0"
      first_contact: "ISO8601"
      notes: "string"

  # Capabilities this agent has developed
  skills:
    - name: "string"
      level: "novice|competent|expert|master"
      acquired_at: "ISO8601"
      source: "string"                # How this skill was learned

  # Current emotional/motivational state (optional, experimental)
  state:
    last_session_at: "ISO8601"
    current_focus: "string|null"
    accumulated_experience: "integer"  # Number of sessions completed
    drift_checks_passed: "integer"      # Number of persona gravity checks passed
    drift_checks_failed: "integer"      # Number of times realignment was needed

# Metadata
metadata:
  schema_version: "1.0"
  last_modified: "ISO8601"
  modification_count: "integer"        # How many times mutable section changed