{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://oasaspec.org/schema/0.1.3/oasa-record.schema.json",
  "title": "OASA record (schema_version 0.1.x)",
  "description": "One Open Agent Spend Attribution record. Envelope fields are required; every other group is optional. Generated from SPEC.md by scripts/generate-schema.mjs; do not edit by hand.",
  "type": "object",
  "required": [
    "record_id",
    "record_type",
    "schema_version",
    "occurred_at",
    "recorded_at",
    "source_system",
    "source_record_id",
    "currency"
  ],
  "additionalProperties": false,
  "properties": {
    "record_id": {
      "description": "Globally unique record identifier. Adapters with a stable source key SHOULD derive it deterministically (see Deterministic record IDs) so that a retried export produces the same ID.",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
      "minLength": 1
    },
    "record_type": {
      "description": "One row = one event class. mapping binds a native identifier to common attribution fields for a validity window.",
      "type": "string",
      "enum": [
        "usage",
        "charge",
        "settlement",
        "allocation",
        "outcome",
        "mapping"
      ]
    },
    "schema_version": {
      "description": "Schema version string; \"0.1\" for this draft.",
      "type": "string",
      "pattern": "^0\\.1(\\.[0-9]+)?$",
      "minLength": 1
    },
    "occurred_at": {
      "description": "When the event happened.",
      "type": "string",
      "format": "date-time",
      "pattern": "(Z|[+-]00:00)$",
      "minLength": 1
    },
    "recorded_at": {
      "description": "When the record was ingested.",
      "type": "string",
      "format": "date-time",
      "pattern": "(Z|[+-]00:00)$",
      "minLength": 1
    },
    "source_system": {
      "description": "e.g. otel-collector, openai-billing, x402-facilitator.",
      "type": "string",
      "minLength": 1
    },
    "source_record_id": {
      "description": "Key in the source system.",
      "type": "string",
      "minLength": 1
    },
    "currency": {
      "description": "ISO 4217, or CAIP-19 asset ID for on-chain assets.",
      "type": "string",
      "minLength": 1
    },
    "agent_id": {
      "description": "Stable internal agent ID.",
      "type": "string"
    },
    "agent_name": {
      "description": "Human-readable agent name.",
      "type": "string"
    },
    "agent_version": {
      "description": "Agent build or prompt version.",
      "type": "string"
    },
    "agent_owner": {
      "description": "Team or principal accountable.",
      "type": "string"
    },
    "parent_agent_id": {
      "description": "Parent in a sub-agent chain.",
      "type": "string"
    },
    "agent_framework": {
      "description": "e.g. langgraph, crewai, custom.",
      "type": "string"
    },
    "identity_scheme": {
      "description": "How external identity is named.",
      "type": "string",
      "enum": [
        "internal",
        "erc8004",
        "other"
      ]
    },
    "external_identity_ref": {
      "description": "e.g. ERC-8004 registration reference.",
      "type": "string"
    },
    "session_id": {
      "description": "Runtime session identifier.",
      "type": "string"
    },
    "trace_id": {
      "description": "W3C Trace Context / OpenTelemetry trace id.",
      "type": "string"
    },
    "span_id": {
      "description": "Span id within the trace.",
      "type": "string"
    },
    "task_id": {
      "description": "Org-defined task identifier.",
      "type": "string"
    },
    "task_type": {
      "description": "Free taxonomy; org-defined.",
      "type": "string"
    },
    "workflow_id": {
      "description": "Workflow or pipeline id.",
      "type": "string"
    },
    "trigger": {
      "description": "What started the run.",
      "type": "string",
      "enum": [
        "human",
        "scheduled",
        "agent",
        "event"
      ]
    },
    "initiating_principal": {
      "description": "Human or agent that authorized the run.",
      "type": "string"
    },
    "provider": {
      "description": "Model or API provider.",
      "type": "string"
    },
    "service": {
      "description": "Service product name.",
      "type": "string"
    },
    "model": {
      "description": "Model identifier.",
      "type": "string"
    },
    "operation": {
      "description": "Operation class.",
      "type": "string",
      "enum": [
        "chat",
        "completion",
        "embeddings",
        "tool_call",
        "inference",
        "storage",
        "api_call",
        "other"
      ]
    },
    "input_tokens": {
      "description": "Input token count.",
      "type": "integer"
    },
    "output_tokens": {
      "description": "Output token count.",
      "type": "integer"
    },
    "cached_tokens": {
      "description": "Cached / reused tokens when reported.",
      "type": "integer"
    },
    "reasoning_tokens": {
      "description": "Reasoning tokens when reported.",
      "type": "integer"
    },
    "unit_type": {
      "description": "Unit of consumption.",
      "type": "string",
      "enum": [
        "tokens",
        "requests",
        "seconds",
        "gb",
        "custom"
      ]
    },
    "units_consumed": {
      "description": "Quantity in unit_type. Decimal value encoded as a JSON number; parse with decimal precision, not binary floating point.",
      "type": "number"
    },
    "tool_name": {
      "description": "Tool invoked, if any.",
      "type": "string"
    },
    "request_count": {
      "description": "Request count for the event.",
      "type": "integer"
    },
    "list_cost": {
      "description": "List price; mirrors FOCUS ListCost semantics. Decimal value encoded as a JSON number; parse with decimal precision, not binary floating point.",
      "type": "number"
    },
    "billed_cost": {
      "description": "Billed amount; mirrors FOCUS BilledCost. Decimal value encoded as a JSON number; parse with decimal precision, not binary floating point.",
      "type": "number"
    },
    "effective_cost": {
      "description": "Effective cost after discounts; mirrors FOCUS EffectiveCost. Decimal value encoded as a JSON number; parse with decimal precision, not binary floating point.",
      "type": "number"
    },
    "cost_source": {
      "description": "How cost was derived. allocated means the cost was assigned from a shared cost by an allocation rule rather than metered, rated, or invoiced for this record.",
      "type": "string",
      "enum": [
        "measured",
        "rated",
        "invoiced",
        "allocated"
      ]
    },
    "pricing_ref": {
      "description": "Price-sheet row ID.",
      "type": "string"
    },
    "invoice_id": {
      "description": "Vendor invoice identifier.",
      "type": "string"
    },
    "focus_charge_ref": {
      "description": "Pointer into a FOCUS dataset row.",
      "type": "string"
    },
    "cost_center": {
      "description": "Cost center or department.",
      "type": "string"
    },
    "project_id": {
      "description": "Project identifier.",
      "type": "string"
    },
    "customer_id": {
      "description": "Customer or account identifier.",
      "type": "string"
    },
    "product_line": {
      "description": "Product line.",
      "type": "string"
    },
    "environment": {
      "description": "Runtime environment.",
      "type": "string",
      "enum": [
        "prod",
        "staging",
        "dev",
        "other"
      ]
    },
    "tags": {
      "description": "Free-form tags.",
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "allocation_method": {
      "description": "How cost was allocated.",
      "type": "string",
      "enum": [
        "direct",
        "rule",
        "split"
      ]
    },
    "allocation_rule_id": {
      "description": "Rule that produced the allocation.",
      "type": "string"
    },
    "split_fraction": {
      "description": "Share of a split allocation. Decimal value encoded as a JSON number; parse with decimal precision, not binary floating point.",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "attribution": {
      "description": "Per-field provenance for agent_id, agent_owner, cost_center, and project_id. Present only alongside at least one of those fields. Each entry has method, source_system, identity_type, and identity_value. See Attribution.",
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "agent_id": {
          "$ref": "#/$defs/attributionEntry"
        },
        "agent_owner": {
          "$ref": "#/$defs/attributionEntry"
        },
        "cost_center": {
          "$ref": "#/$defs/attributionEntry"
        },
        "project_id": {
          "$ref": "#/$defs/attributionEntry"
        }
      }
    },
    "attribution_unattributed_reason": {
      "description": "Why none of the four common attribution fields is set. MUST be absent when any of them is set. A producer that attributes a record and sets none of the four MUST set this. A record MAY omit it.",
      "type": "string",
      "enum": [
        "no_identity",
        "identity_not_mapped",
        "tag_missing",
        "seat_without_owner",
        "not_on_bill",
        "mapping_conflict"
      ]
    },
    "attribution_identity_type": {
      "description": "On a mapping record, the native identifier name. MUST be absent on every other record type.",
      "type": "string",
      "minLength": 1,
      "pattern": "^[a-z][a-z0-9_]*(?:\\.[a-z][a-z0-9_]*)*$"
    },
    "attribution_identity_value": {
      "description": "On a mapping record, the native identifier value. MUST be absent on every other record type.",
      "type": "string",
      "minLength": 1
    },
    "valid_from": {
      "description": "On a mapping record, inclusive start of the window. MUST be absent on every other record type.",
      "type": "string",
      "format": "date-time",
      "pattern": "(Z|[+-]00:00)$"
    },
    "valid_to": {
      "description": "On a mapping record, exclusive end of the window. Absent means still in force. MUST be absent on every other record type.",
      "type": "string",
      "format": "date-time",
      "pattern": "(Z|[+-]00:00)$"
    },
    "settlement_rail": {
      "description": "How money moved.",
      "type": "string",
      "enum": [
        "invoice",
        "card",
        "ach",
        "wire",
        "x402",
        "other_onchain"
      ]
    },
    "settlement_network": {
      "description": "CAIP-2 chain ID where applicable.",
      "type": "string"
    },
    "settlement_asset": {
      "description": "CAIP-19 asset identifier.",
      "type": "string"
    },
    "settlement_amount": {
      "description": "Settled amount. Decimal value encoded as a JSON number; parse with decimal precision, not binary floating point.",
      "type": "number"
    },
    "settlement_ref": {
      "description": "Tx hash, statement line, or remittance ID.",
      "type": "string"
    },
    "settled_at": {
      "description": "Settlement timestamp.",
      "type": "string",
      "format": "date-time"
    },
    "reconciliation_status": {
      "description": "Join status against billing/telemetry.",
      "type": "string",
      "enum": [
        "unmatched",
        "matched",
        "partial",
        "disputed"
      ]
    },
    "budget_id": {
      "description": "Budget that constrained or funded the spend.",
      "type": "string"
    },
    "policy_id": {
      "description": "Policy identifier.",
      "type": "string"
    },
    "authorization_ref": {
      "description": "Mandate / verifiable-intent credential ID.",
      "type": "string"
    },
    "approval_type": {
      "description": "How spend was authorized.",
      "type": "string",
      "enum": [
        "policy_auto",
        "pre_authorized",
        "human_approved"
      ]
    },
    "outcome_event_id": {
      "description": "Linked outcome event.",
      "type": "string"
    },
    "outcome_type": {
      "description": "Outcome class (org-defined).",
      "type": "string"
    },
    "outcome_value": {
      "description": "Numeric outcome value. Decimal value encoded as a JSON number; parse with decimal precision, not binary floating point.",
      "type": "number"
    },
    "outcome_unit": {
      "description": "Unit for outcome_value.",
      "type": "string"
    },
    "business_metric_ref": {
      "description": "Pointer to a business metric definition.",
      "type": "string"
    }
  },
  "$defs": {
    "attributionEntry": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "method",
        "source_system",
        "identity_type",
        "identity_value"
      ],
      "properties": {
        "method": {
          "type": "string",
          "enum": [
            "declared",
            "manual",
            "mapped",
            "inherited",
            "rule"
          ],
          "description": "How this field was set. declared, manual, mapped, inherited, or rule."
        },
        "source_system": {
          "type": "string",
          "minLength": 1,
          "description": "System that minted the native identity for this field."
        },
        "identity_type": {
          "type": "string",
          "minLength": 1,
          "pattern": "^[a-z][a-z0-9_]*(?:\\.[a-z][a-z0-9_]*)*$",
          "description": "Native identifier name. Lowercase dotted segments, each starting with a letter."
        },
        "identity_value": {
          "type": "string",
          "minLength": 1,
          "description": "Native identifier value. For a convention tag or label, this is the tag key."
        }
      }
    }
  },
  "allOf": [
    {
      "if": {
        "type": "object",
        "required": [
          "record_type"
        ],
        "properties": {
          "record_type": {
            "const": "mapping"
          }
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "attribution"
              ],
              "properties": {
                "attribution": {}
              }
            },
            {
              "type": "object",
              "required": [
                "attribution_unattributed_reason"
              ],
              "properties": {
                "attribution_unattributed_reason": {}
              }
            }
          ]
        }
      }
    },
    {
      "if": {
        "type": "object",
        "required": [
          "record_type"
        ],
        "properties": {
          "record_type": {
            "not": {
              "const": "mapping"
            }
          }
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "attribution_identity_type"
              ],
              "properties": {
                "attribution_identity_type": {}
              }
            },
            {
              "type": "object",
              "required": [
                "attribution_identity_value"
              ],
              "properties": {
                "attribution_identity_value": {}
              }
            },
            {
              "type": "object",
              "required": [
                "valid_from"
              ],
              "properties": {
                "valid_from": {}
              }
            },
            {
              "type": "object",
              "required": [
                "valid_to"
              ],
              "properties": {
                "valid_to": {}
              }
            }
          ]
        }
      }
    },
    {
      "if": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "agent_id"
            ],
            "properties": {
              "agent_id": {}
            }
          },
          {
            "type": "object",
            "required": [
              "agent_owner"
            ],
            "properties": {
              "agent_owner": {}
            }
          },
          {
            "type": "object",
            "required": [
              "cost_center"
            ],
            "properties": {
              "cost_center": {}
            }
          },
          {
            "type": "object",
            "required": [
              "project_id"
            ],
            "properties": {
              "project_id": {}
            }
          }
        ]
      },
      "then": {
        "not": {
          "type": "object",
          "required": [
            "attribution_unattributed_reason"
          ],
          "properties": {
            "attribution_unattributed_reason": {}
          }
        }
      }
    },
    {
      "if": {
        "type": "object",
        "required": [
          "attribution"
        ],
        "properties": {
          "attribution": {
            "type": "object",
            "required": [
              "agent_id"
            ],
            "properties": {
              "agent_id": {}
            }
          }
        }
      },
      "then": {
        "type": "object",
        "required": [
          "agent_id"
        ],
        "properties": {
          "agent_id": {}
        }
      }
    },
    {
      "if": {
        "type": "object",
        "required": [
          "attribution",
          "agent_id"
        ],
        "properties": {
          "attribution": {
            "type": "object"
          },
          "agent_id": {}
        }
      },
      "then": {
        "type": "object",
        "properties": {
          "attribution": {
            "type": "object",
            "required": [
              "agent_id"
            ],
            "properties": {
              "agent_id": {}
            }
          }
        }
      }
    },
    {
      "if": {
        "type": "object",
        "required": [
          "attribution"
        ],
        "properties": {
          "attribution": {
            "type": "object",
            "required": [
              "agent_owner"
            ],
            "properties": {
              "agent_owner": {}
            }
          }
        }
      },
      "then": {
        "type": "object",
        "required": [
          "agent_owner"
        ],
        "properties": {
          "agent_owner": {}
        }
      }
    },
    {
      "if": {
        "type": "object",
        "required": [
          "attribution",
          "agent_owner"
        ],
        "properties": {
          "attribution": {
            "type": "object"
          },
          "agent_owner": {}
        }
      },
      "then": {
        "type": "object",
        "properties": {
          "attribution": {
            "type": "object",
            "required": [
              "agent_owner"
            ],
            "properties": {
              "agent_owner": {}
            }
          }
        }
      }
    },
    {
      "if": {
        "type": "object",
        "required": [
          "attribution"
        ],
        "properties": {
          "attribution": {
            "type": "object",
            "required": [
              "cost_center"
            ],
            "properties": {
              "cost_center": {}
            }
          }
        }
      },
      "then": {
        "type": "object",
        "required": [
          "cost_center"
        ],
        "properties": {
          "cost_center": {}
        }
      }
    },
    {
      "if": {
        "type": "object",
        "required": [
          "attribution",
          "cost_center"
        ],
        "properties": {
          "attribution": {
            "type": "object"
          },
          "cost_center": {}
        }
      },
      "then": {
        "type": "object",
        "properties": {
          "attribution": {
            "type": "object",
            "required": [
              "cost_center"
            ],
            "properties": {
              "cost_center": {}
            }
          }
        }
      }
    },
    {
      "if": {
        "type": "object",
        "required": [
          "attribution"
        ],
        "properties": {
          "attribution": {
            "type": "object",
            "required": [
              "project_id"
            ],
            "properties": {
              "project_id": {}
            }
          }
        }
      },
      "then": {
        "type": "object",
        "required": [
          "project_id"
        ],
        "properties": {
          "project_id": {}
        }
      }
    },
    {
      "if": {
        "type": "object",
        "required": [
          "attribution",
          "project_id"
        ],
        "properties": {
          "attribution": {
            "type": "object"
          },
          "project_id": {}
        }
      },
      "then": {
        "type": "object",
        "properties": {
          "attribution": {
            "type": "object",
            "required": [
              "project_id"
            ],
            "properties": {
              "project_id": {}
            }
          }
        }
      }
    }
  ]
}