Trait Schemas

interface TraitSchema {
  key: string; // Unique identifier
  label?: string; // Human-readable name
  description?: string; // What this trait represents
  valueType: "string" | "number" | "boolean" | "array" | "enum";
  enumValues?: string[]; // For enum types
  category?: string; // Grouping (communication, context, etc.)

  extraction: {
    enabled: boolean;
    promptSnippet?: string; // Hint for extraction
    confidenceThreshold: number; // Minimum confidence to store
  };

  injection: {
    enabled: boolean;
    template?: string; // How to format in prompt
    priority: number; // Order in injection (higher = earlier)
  };
}

{
  "traits": [
    {
      "key": "name",
      "label": "Name",
      "description": "User's name or preferred name",
      "valueType": "string",
      "category": "identity",
      "extraction": {
        "enabled": true,
        "promptSnippet": "Extract the user's name if they mention it",
        "confidenceThreshold": 0.9
      },
      "injection": {
        "enabled": true,
        "template": "User's name is {{value}}.",
        "priority": 10
      }
    }
  ]
}

const response = await client.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Help me plan my trip" }],
  extra_body: {
    getprofile: {
      traits: [
        {
          key: "travel_preferences",
          valueType: "string",
          extraction: {
            enabled: true,
            promptSnippet: "Extract travel style preferences",
          },
          injection: {
            enabled: true,
            template: "User prefers: {{value}}",
          },
        },
      ],
    },
  },
});