/*
 * E5 - Agent Provenance
 *
 * Operator of Record and the accountability chain for entities whose
 * constituents include autonomous agents. Accountability shape absorbed
 * from RegistrarChain-ZodSchema (AccountabilityRequirementSchema,
 * ReportingExceptionReasonSchema). Lean but real per the MVP cut.
 *
 * provenance:
 *   source: universal-constitution v2-minimal-core-study.md (Extensions register)
 *   licence: Apache-2.0
 */
concerto version "^3.0.0"
namespace id.entity.ext.e5@0.1.0

import id.entity.core@2.2.0.{Extension, SubjectKind, EthAddress} from https://models.entity.id/core@2.2.0.cto
/** Absorbed from ZodSchema ReportingExceptionReasonSchema (GLEIF-aligned). */
enum ReportingExceptionReason {
  o NON_CONSOLIDATING
  o NATURAL_PERSONS
  o NO_KNOWN_PERSON
  o NO_LEI
  o NON_PUBLIC
}

/**
 * The accountability chain requirement: resolution through constituents
 * to a natural person, within a maximum number of hops.
 * Absorbed from ZodSchema AccountabilityRequirementSchema.
 */
concept AccountabilityRequirement {
  o Boolean mustResolveToNaturalPerson
  o Integer maxHopsToNaturalPerson range=[0,] optional
  o ReportingExceptionReason[] exceptionsAllowed optional
}

/** The natural or legal person answerable for an autonomous agent. */
concept OperatorOfRecord {
  o String name
  o SubjectKind kind
  o EthAddress address optional
  o String contact optional
}

/**
 * E5 Agent Provenance - attached to a Constitution via clause 6.2.
 */
concept AgentProvenanceExtension extends Extension {
  o OperatorOfRecord operatorOfRecord
  o AccountabilityRequirement accountability
  o String modelProvider optional
  o String modelIdentifier optional
}