cruxIR

Agent Types

Agent schema definition in cruxIR.

Agent Interface

interface Agent {
  id: string;
  type: string;
  position: { x: number; y: number };
  state: Record<string, unknown>;
  tags: string[];
  identity?: VisualIdentity;
}

Visual Identity

Auto-generated visual representation for each agent:

interface VisualIdentity {
  color: string;    // Hex color
  glyph: string;    // Unicode character
  name: string;     // Display name
}

Example

{
  "id": "agent_001",
  "type": "visitor",
  "position": { "x": 50, "y": 25 },
  "state": {
    "energy": 100,
    "mood": "curious"
  },
  "tags": ["tourist", "photographer"]
}