[Objects](https://oods-foundry.com/objects) / Grant

# Grant

A standing yes that one actor may act for a person or organization, on stated terms, until it ends.

alpha 4 traits · 7 contexts · 57 fields [Grant.object.yaml](#file) [How objects work](https://oods-foundry.com/guides/objects-and-traits)

Generated from @oods/foundry 0.18.0

This object is marked alpha.

## Screens

Every screen below was generated from this object by OODS Foundry 0.18.0, in React and Vue, and shows the calls that made it and its content hash. Each runs as its generated app runs, in this site's brand, Aquex, in the theme you choose, with the sample records this object's own file carries; the lists on its detail screens show related records from the shipped objects' samples, and a generated app copies the other objects' records among them when it is made. A value no record gives is left out where this object's views mark the place to leave out, and elsewhere shows as a neutral one, such as an empty value or "Not recorded"; OODS Foundry invents none.

[Grant detail screen generated by OODS Foundry in React](https://oods-foundry.com/objects/grant/screens/detail-react)

React app · sample records Maturity: alpha `sha256:389a997b714a…` [Open full size: Grant detail screen generated by OODS Foundry in React](https://oods-foundry.com/objects/grant/screens/detail-react)

Vue app · sample records Maturity: alpha `sha256:ef78556f39e9…` [Open full size: Grant detail screen generated by OODS Foundry in Vue](https://oods-foundry.com/objects/grant/screens/detail-vue)

React app · sample records Maturity: alpha `sha256:b822e7faa191…` [Open full size: Grant list screen generated by OODS Foundry in React](https://oods-foundry.com/objects/grant/screens/list-react)

Vue app · sample records Maturity: alpha `sha256:e185c5e84808…` [Open full size: Grant list screen generated by OODS Foundry in Vue](https://oods-foundry.com/objects/grant/screens/list-vue)

React app · sample records Maturity: alpha `sha256:a8744db64abb…` [Open full size: Grant form screen generated by OODS Foundry in React](https://oods-foundry.com/objects/grant/screens/form-react)

Vue app · sample records Maturity: alpha `sha256:fcfd14427462…` [Open full size: Grant form screen generated by OODS Foundry in Vue](https://oods-foundry.com/objects/grant/screens/form-vue)

React app · sample records Maturity: alpha `sha256:4c604fc8a691…` [Open full size: Grant timeline screen generated by OODS Foundry in React](https://oods-foundry.com/objects/grant/screens/timeline-react)

Vue app · sample records Maturity: alpha `sha256:133894bc04da…` [Open full size: Grant timeline screen generated by OODS Foundry in Vue](https://oods-foundry.com/objects/grant/screens/timeline-vue)

React app · sample records Maturity: alpha `sha256:ef97593690d2…` [Open full size: Grant card screen generated by OODS Foundry in React](https://oods-foundry.com/objects/grant/screens/card-react)

Vue app · sample records Maturity: alpha `sha256:68bdb0238c64…` [Open full size: Grant card screen generated by OODS Foundry in Vue](https://oods-foundry.com/objects/grant/screens/card-vue)

React app · sample records Maturity: alpha `sha256:d3f3b4679db8…` [Open full size: Grant inline screen generated by OODS Foundry in React](https://oods-foundry.com/objects/grant/screens/inline-react)

Vue app · sample records Maturity: alpha `sha256:10c623f47eb5…` [Open full size: Grant inline screen generated by OODS Foundry in Vue](https://oods-foundry.com/objects/grant/screens/inline-vue)

React app · sample records Maturity: alpha `sha256:e79b9f408df9…` [Open full size: Grant workflow screen generated by OODS Foundry in React](https://oods-foundry.com/objects/grant/screens/workflow-react)

Vue app · sample records Maturity: alpha `sha256:21c0f4f38762…` [Open full size: Grant workflow screen generated by OODS Foundry in Vue](https://oods-foundry.com/objects/grant/screens/workflow-vue)

What `design_compose` reported for every screen here:

- `OODS-V121` Object 'Grant' has maturity 'alpha' — composed output may change.

The calls that made the Grant detail apps, in React and Vue

3 calls, as the pipeline sent them

```
design_compose {
  "object": "Grant",
  "context": "detail",
  "preferences": {
    "brand": "Aquex",
    "theme": "light"
  }
}

code_generate {
  "schemaRef": "compose-4702551c",
  "framework": "react",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}

code_generate {
  "schemaRef": "compose-4702551c",
  "framework": "vue",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}
```

The React app's content hash: `sha256:389a997b714a33bd2aa70cb3d08a199f17ba666b75a00fef42123f1e5657aab7`. Its `src/` folder: App.tsx, GeneratedUI.tsx, app.css, main.tsx, oods-brand-aquex.css

The Vue app's content hash: `sha256:ef78556f39e989472593008aa6f485b62c85f669dfc132c5b6182883b9375454`. Its `src/` folder: App.vue, GeneratedUI.vue, app.css, main.ts, oods-brand-aquex.css

The calls that made the Grant list apps, in React and Vue

3 calls, as the pipeline sent them

```
design_compose {
  "object": "Grant",
  "context": "list",
  "preferences": {
    "brand": "Aquex",
    "theme": "light"
  }
}

code_generate {
  "schemaRef": "compose-46136b39",
  "framework": "react",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}

code_generate {
  "schemaRef": "compose-46136b39",
  "framework": "vue",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}
```

The React app's content hash: `sha256:b822e7faa19108ccb9cd1ef95fbb44cd18bb3b93ce3eaceb65d535daf567e0ab`. Its `src/` folder: App.tsx, GeneratedUI.tsx, app.css, main.tsx, oods-brand-aquex.css

The Vue app's content hash: `sha256:e185c5e84808ee50fc857f53f96ce7ddf257e73fbe34d82db6f53ee5e5f7651a`. Its `src/` folder: App.vue, GeneratedUI.vue, app.css, main.ts, oods-brand-aquex.css

The calls that made the Grant form apps, in React and Vue

3 calls, as the pipeline sent them

```
design_compose {
  "object": "Grant",
  "context": "form",
  "preferences": {
    "brand": "Aquex",
    "theme": "light"
  }
}

code_generate {
  "schemaRef": "compose-4e6fff7d",
  "framework": "react",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}

code_generate {
  "schemaRef": "compose-4e6fff7d",
  "framework": "vue",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}
```

The React app's content hash: `sha256:a8744db64abb75ca2be20986106956dede2a2b8c78c8c074f0a13c974cbb09d8`. Its `src/` folder: App.tsx, GeneratedUI.tsx, app.css, main.tsx, oods-brand-aquex.css

The Vue app's content hash: `sha256:fcfd14427462220ca3aca4416964cbb63bd51bbf9cd938ba7098a1c4b8a3996b`. Its `src/` folder: App.vue, GeneratedUI.vue, app.css, main.ts, oods-brand-aquex.css

The calls that made the Grant timeline apps, in React and Vue

3 calls, as the pipeline sent them

```
design_compose {
  "object": "Grant",
  "context": "timeline",
  "preferences": {
    "brand": "Aquex",
    "theme": "light"
  }
}

code_generate {
  "schemaRef": "compose-3ed08bc8",
  "framework": "react",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}

code_generate {
  "schemaRef": "compose-3ed08bc8",
  "framework": "vue",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}
```

The React app's content hash: `sha256:4c604fc8a69172bbe47c3df26c0a7529a096671ecffedd79c07cce51d6d4886a`. Its `src/` folder: App.tsx, GeneratedUI.tsx, app.css, main.tsx, oods-brand-aquex.css

The Vue app's content hash: `sha256:133894bc04da8141bbfcee5c3e1337b88b8cdb051e96284f1786199e5e08303f`. Its `src/` folder: App.vue, GeneratedUI.vue, app.css, main.ts, oods-brand-aquex.css

The calls that made the Grant card apps, in React and Vue

3 calls, as the pipeline sent them

```
design_compose {
  "object": "Grant",
  "context": "card",
  "preferences": {
    "brand": "Aquex",
    "theme": "light"
  }
}

code_generate {
  "schemaRef": "compose-45db7ff3",
  "framework": "react",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}

code_generate {
  "schemaRef": "compose-45db7ff3",
  "framework": "vue",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}
```

The React app's content hash: `sha256:ef97593690d2568d9a2dfa4b8b3254cec4b89a4acdbe4edb1d80c148e3ea4c67`. Its `src/` folder: App.tsx, GeneratedUI.tsx, app.css, main.tsx, oods-brand-aquex.css

The Vue app's content hash: `sha256:68bdb0238c646288b6190b6f8817eba26c89026e052c0044169a1f1e3c501d08`. Its `src/` folder: App.vue, GeneratedUI.vue, app.css, main.ts, oods-brand-aquex.css

For this screen it also reported:

- `OODS-V119` No view_extensions found for context "inline" in object "Grant". Available contexts: list, card, detail, form

The calls that made the Grant inline apps, in React and Vue

3 calls, as the pipeline sent them

```
design_compose {
  "object": "Grant",
  "context": "inline",
  "preferences": {
    "brand": "Aquex",
    "theme": "light"
  }
}

code_generate {
  "schemaRef": "compose-fce8379e",
  "framework": "react",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}

code_generate {
  "schemaRef": "compose-fce8379e",
  "framework": "vue",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}
```

The React app's content hash: `sha256:d3f3b4679db8303cdfd0bcec36b6869c79bbfddc4f8fa9646cea3753be6936a2`. Its `src/` folder: App.tsx, GeneratedUI.tsx, app.css, main.tsx, oods-brand-aquex.css

The Vue app's content hash: `sha256:10c623f47eb56ec6733ff15c5110762a5104e0130ffa2988d99a9687b7c609c2`. Its `src/` folder: App.vue, GeneratedUI.vue, app.css, main.ts, oods-brand-aquex.css

For this screen it also reported:

- `OODS-V121` as above, 4 times in all

The calls that made the Grant workflow apps, in React and Vue

3 calls, as the pipeline sent them

```
design_compose {
  "object": "Grant",
  "context": "workflow",
  "preferences": {
    "brand": "Aquex",
    "theme": "light"
  }
}

code_generate {
  "schemaRef": "compose-8d55ba65",
  "framework": "react",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}

code_generate {
  "schemaRef": "compose-8d55ba65",
  "framework": "vue",
  "profile": "build",
  "options": {
    "output": "application",
    "brand": "Aquex",
    "theme": "light",
    "payloadMode": "file"
  }
}
```

The React app's content hash: `sha256:e79b9f408df97a673e88f3a1150c9a9cf5548e9c785d5d581bce9a5e85ea06bb`. Its `src/` folder: App.tsx, actions.ts, app.css, application.ts, main.tsx, oods-brand-aquex.css, related-data.ts, sample-data.ts, screens/, ssr.tsx, store.ts

The Vue app's content hash: `sha256:21c0f4f3876238ba8963e7fd0f721615c450f549ef8fd15a31a485ccd4b76cf4`. Its `src/` folder: App.vue, actions.ts, app.css, application.ts, main.ts, oods-brand-aquex.css, related-data.ts, sample-data.ts, screens/, ssr.ts, store.ts

## Fields

| Field | Type | Description |
| - | - | - |
| `requested_by_id` | string | Who asked for the grant, by the id the product knows them by: a person, or the agent itself. |
| `requested_by_name` | string | Who asked for the grant, as shown ("Billing Agent").MoreKept on the record. |
| `requested_by_kind` | string (person, agent, system) | What kind of actor asked for it (person, agent or system), as the Actor trait names them. |
| `asked_of_id` | string | Who was asked for the yes, by the id the product knows them by.MoreA requested grant waits on them; the field stays once it is answered. |
| `asked_of_name` | string | Who was asked for the yes, as shown ("Ruth Adeyemi").MoreKept on the record. |
| `asked_of_kind` | string (person, agent, system) | What kind of actor was asked for the yes (person, agent or system), as the Actor trait names them. |
| `granted_by_id` | string | Who gave the grant, by the id the product knows them by: usually a person who may give it for the party. |
| `granted_by_name` | string | Who gave the grant, as shown ("Ruth Adeyemi").MoreKept on the record, so it still reads after they leave. |
| `granted_by_kind` | string (person, agent, system) | What kind of actor gave it (person, agent or system), as the Actor trait names them. |
| `granted_as` | string | The capacity the giver gave it in, in one line ("Finance manager, Tidewater Co-op"). |
| `granted_to_id` | string | Who holds the grant and acts under it, by the id the product knows them by: an agent, or a person standing in for someone. |
| `granted_to_name` | string | Who holds the grant, as shown ("Billing Agent").MoreKept on the record. |
| `granted_to_kind` | string (person, agent, system) | What kind of actor holds it (person, agent or system), as the Actor trait names them. |
| `granted_for_id` | string | Who the grant is for, the person or organization the holder acts for, by the id the product knows them by.MoreNever an agent. |
| `granted_for_name` | string | Who the grant is for, as shown ("Tidewater Co-op").MoreKept on the record. |
| `scope` | string | What the grant covers, in a few words ("Invoices and payments"). |
| `allowed_actions` | string | Actions the holder may take for this party with no one asked, separated by "; "; None when there are none. |
| `asks_first_for` | string | Actions that need a person's yes before the holder takes them for this party, separated by "; "; None when there are none. |
| `never_allowed` | string | Actions the holder never takes for this party, separated by "; "; None when there are none.MoreAn action for the party that no line names is never allowed; asking the person who gave it for a yes or an answer is not one. |
| `amount_limit_minor` | integer | The most the holder may move in one use, in the currency's minor units (1200000 is $12,000.00). |
| `period_limit_minor` | integer | The most the holder may move in each period, in the currency's minor units. |
| `limit_currency` | string | The currency of the money limits, as an ISO 4217 code ("USD"). |
| `limit_period` | string (day, week, month, year) | The period the limits per period count over. |
| `uses_per_period` | integer | The most times the grant may be used in each period. |
| `conditions` | string | Conditions on each use, in words, shown and not checked ("Only a payment the bank returned, to the same payee for the same amount"). |
| `ends_at` | datetime | The exact instant the grant ends, the one a product checks. |
| `timezone` | string | The party's time zone, as an IANA name ("Pacific/Auckland"), the zone its end is read in. |
| `ends_note` | string | The end as people read it, in the party's own words and time zone ("At the end of 31 Dec 2026, Tauranga time"), written by the product; a grant with no end says so here ("No end: it stands until someone ends it"). |
| `uses` | integer | How many times the grant has been used, as the product counts it. |
| `last_used_at` | datetime | When the grant was last used. |
| `last_use` | string | The last use, in one kept line ("28 Sep: PAY-2026-0429 sent again"). |
| `spent_minor` | integer | The money moved under the grant in the current period, as the product counts it, in the currency's minor units. |
| `within_id` | string | The grant this one sits inside, for a standing yes given for one action: same holder, same party, ending no later. |
| `within_name` | string | The grant this one sits inside, as shown.MoreKept on the record. |
| `replaces_id` | string | The grant this one replaced when the terms changed; that grant is kept whole, ended as replaced. |
| `replaces_name` | string | The grant this one replaced, as shown.MoreKept on the record. |
| `first_grant_id` | string | The first grant in a line of replacements, kept on every later grant in the line so a search by its name finds them all. |
| `first_grant_name` | string | The first grant in the line, as shown.MoreKept on the record. |
| `ended_by_id` | string | Who ended the grant, by the id the product knows them by, when someone did. |
| `ended_by_name` | string | Who ended the grant, as shown.MoreKept on the record. |
| `ended_by_kind` | string (person, agent, system) | What kind of actor ended it (person, agent or system), as the Actor trait names them. |
| `ended_as` | string | The capacity they ended it in, in one line, where it is not one of the grant's own seats ("Accounts lead, Kestrel Print Co."). |
| `ended_reason` | string | Why the grant ended, in one line, written where it is ended ("The studio closed"). |
| `status`required | string | Canonical lifecycle state derived from the states parameter.MoreThis is the single source of truth for the entity's current lifecycle position. Consumed by Colorized to resolve visual tokens, and by view extensions to render StatusBadge and StatusTimeline. |
| `state_history` | StateTransition\[] | Chronological log of state transitions.MoreEach entry records the before/after states, timestamp, and (when governance is enabled) the actor, reason, and transition metadata. Rendered by StatusTimeline in the detail and timeline views. Entry structure: - from: string (previous state) - to: string (new state) - timestamp: ISO 8601 datetime - actor_id: string (user/system who triggered the transition, optional) - reason: string (human-readable justification, required when requireTransitionReason is true) - transition_metadata: Record\<string, unknown> (arbitrary context, optional) Every recorded change can name who acted, who it acted for and who approved it. All optional, following Relationship's source_id/source_name pattern; only a \*\_name names a party, and an entry that names no one renders as it always has: - actor_name: string (who acted, as shown: "Billing Agent") - actor_kind: string (person, agent or system: the Actor trait's kinds) - on_behalf_of_name / on_behalf_of_id: string (the person or organization it acted for) - approved_by_name / approved_by_id: string (who approved the change, when someone did) StatusTimeline then reads "Billing Agent for Tidewater Co-op · approved by Ruth Adeyemi". A change someone approved can also say which approval it belongs to and what level of yes it was. Both optional; the id stays in the record's data, a pointer and not a link, and an entry without them renders as it always has: - approval_id: string (the Approval record the yes is kept in) - approval_level: string (the level of yes, one of the levels the product declares: "approval") StatusTimeline then reads "Billing Agent for Tidewater Co-op · approved by Ruth Adeyemi (level: Approval)". A change made as part of a task can also say which task it was. Both optional; the id stays in the record's data, a pointer and not a link, and an entry without them renders as it always has: - task_id: string (the Task record the change was made under) - task_name: string (the task, as shown: "Get INV-2026-0155 paid") StatusTimeline then reads "… · approved by Ruth Adeyemi (level: Approval) · task: Get INV-2026-0155 paid". A change made under a grant, the standing yes an actor acts under for a person or organization, can also say which grant it was. Both optional; the id stays in the record's data, a pointer and not a link, and an entry without them renders as it always has: - grant_id: string (the Grant record the change was made under) - grant_name: string (the grant, as shown: "Resend returned transfers") StatusTimeline names the grant after any approval and before the task: "Billing Agent for Tidewater Co-op · grant: Resend returned transfers". |
| `allowed_transitions` | string\[] | Materialized list of the next states the product allows from the current status, written by the product from the transitionRules parameter.MoreWhen transitionRules is null (open model), this contains all states except the current one. The detail page's StatusTimeline lists it when the record holds it. A generated StatusSelector reads transitionRules instead: it offers the current state and the moves the order allows (every state where no order is declared). |
| `created_at`required | datetime | Timestamp recording when the entity was first created. |
| `updated_at` | datetime | Timestamp for the most recent modification, when available. |
| `last_event`required | string | Lifecycle event associated with the most recent timestamp mutation. |
| `last_event_at` | datetime | Timestamp for the lifecycle event captured in last_event. |
| `owner_id`required | string | Identifier of the owning principal scoped by owner_type. |
| `owner_type`required | string | Categorical owner type sourced from the ownerTypes parameter. |
| `ownership_role` | string | Optional role name describing how the owner governs the entity. |
| `ownership_transferred_at` | datetime | Timestamp recording when ownership was last transferred. |
| `grant_id`required | uuid | Primary identifier for the grant, the id a history entry's grant_id points at. |
| `name`required | string | What the grant is called, in a few words ("Tidewater invoices and payments"). |
| `owner_name` | string | Who answers for the grant, a person or a team, as shown. |

## Traits

Each trait adds fields and behaviour. Every object with the trait gets the same.

- [Mandate](https://oods-foundry.com/traits/mandate)
- [Stateful as GrantState](https://oods-foundry.com/traits/stateful)
- [Timestampable as GrantTimes](https://oods-foundry.com/traits/timestampable)
- [Ownerable as GrantAnswers](https://oods-foundry.com/traits/ownerable)

## Relationships

This object declares no relationships with other object types. Its detail screens also list related records, declared on the object as related lists, apart from relationships.

## The object file

The Grant object definition in YAML: `objects/core/Grant.object.yaml`

```
object:
  name: Grant
  version: 1.0.1
  domain: core.governance
  description: A standing yes that one actor may act for a person or organization, on stated terms, until it ends.
  tags:
    - universal
    - governance
    - core
    - grant

# A grant is a standing yes, not a setting. One record is one set of terms on which one holder may act for one party, as
# given by one giver, until it ends: who asked for it, who gave it and in what capacity, who holds it, who it is for, what
# it covers, its three lines for that party, its limits, its end, its use as the product counts it, and how it ended (the
# Mandate trait's fields). Its terms are never edited in place: a change of terms is a new grant that names the one it
# replaces, which ends as replaced and is kept whole, and "always allow" for one action is a new grant inside the first,
# with its own bounds and end. Taking a grant back is its Revoke, which asks once first and ends active or paused grants inside it, or the same move of its status to revoked on its form. The one who answers for it is the owner, a person or a
# team, never an agent. OODS Foundry keeps and shows the record; it does not check a grant against what an actor does,
# expire or renew one, or decide whether an action was allowed. A generated app's Revoke, Pause and Resume change the
# app's own records when a person asks, and its store keeps the declared order; they stop nothing outside the app.
traits:
  - name: core/Mandate
  - name: lifecycle/Stateful
    alias: GrantState
    parameters:
      states:
        - requested
        - active
        - paused
        - revoked
        - expired
        - replaced
        - declined
        - withdrawn
      initialState: requested
      # The order your product enforces. A grant is asked for, then given, declined or withdrawn by its asker, or it expires
      # when no one answers in time (s249); a given grant may be paused and resumed, and ends one of three ways: taken back
      # (revoked), at its end or from disuse (expired), or replaced by a grant with other terms. The five endings are final
      # (empty lists), so a grant never comes back: a new one follows it and names it. OODS Foundry holds its own samples to
      # the order, and a generated app keeps it: its status select offers only the moves it allows, and its store refuses
      # any other.
      transitionRules:
        requested: [active, declined, withdrawn, expired]
        active: [paused, revoked, expired, replaced]
        paused: [active, revoked, expired, replaced]
        revoked: []
        expired: []
        replaced: []
        declined: []
        withdrawn: []
      # s249-m03: the moves a person makes on a grant. Revoke ends it, asks once first, writes the note given (if any) as
      # why it ended and who ended it when the app is told, and ends active or paused grants inside it. A request stays open. Pause can be undone:
      # Resume gives it again, and only someone who may give grants for the party should resume it (shown, not checked).
      # A move to expired, replaced, declined or withdrawn has no action: it saves as an edit, from the form's status
      # select or from your product.
      actions:
        - { id: revoke, to: revoked, verb: Revoke, event: ended, reasonField: ended_reason, bySeat: ended_by, confirm: true, alsoEnds: { via: within_id } }
        - { id: pause, to: paused, verb: Pause, event: paused }
        - { id: resume, from: [paused], to: active, verb: Resume, event: resumed }
  - name: lifecycle/Timestampable
    alias: GrantTimes
    parameters:
      recordedEvents:
        - requested
        - granted
        - paused
        - resumed
        - ended
        - updated
      timezone: UTC
  # The one who answers for the grant: a person or a team, never an agent. By default it is the one who gave it.
  - name: structural/Ownerable
    alias: GrantAnswers
    parameters:
      ownerTypes:
        - user
        - team
      primaryOwnerType: user
      allowTransfer: true

schema:
  grant_id:
    type: uuid
    required: true
    description: Primary identifier for the grant, the id a history entry's grant_id points at.
  name:
    type: string
    required: true
    description: What the grant is called, in a few words ("Tidewater invoices and payments").
    validation:
      minLength: 1
      maxLength: 120
  owner_name:
    type: string
    required: false
    description: Who answers for the grant, a person or a team, as shown.

semantics:
  grant_id:
    semantic_type: governance.grant.id
    token_mapping: tokenMap(identity.id.primary)
  name:
    semantic_type: text.label
    token_mapping: tokenMap(identity.name.primary)
  # The one-line summary under the grant's name in lists: what it covers.
  scope:
    semantic_type: text.summary
    token_mapping: tokenMap(text.body.*)
    ui_hints:
      component: Text
      label: Covers
  # structural/Ownerable's owner reference: the one who answers for the grant, named by owner_name.
  owner_id:
    semantic_type: ownership.owner.id
    token_mapping: tokenMap(ownership.owner.id)
    ui_hints:
      component: OwnerReference
      ownerTypeField: owner_type
      displayLabelField: owner_name

tokens:
  identity.id.primary: "var(--text-strong)"
  identity.name.primary: "var(--text-strong)"

metadata:
  owners:
    - Core team
    - Platform team
  steward: Design team
  maturity: alpha
  changelog:
    - version: 1.0.1
      date: "2026-11-19"
      description: Declares Revoke, Pause and Resume, related records under the grant and its closure. The closure row dates its last report, and the detail explains a stored None.
    - version: 1.0.0
      date: "2026-11-14"
      description: Initial Grant object, the fifteenth public reference object; a grant is a standing yes, not a setting.
  # s249-m01: the lists this object's detail page shows of the records that point at one of its records, seat by seat,
  # declared here on the page that shows them (packages/mcp-server/src/objects/related-lists.ts says what each key means).
  # They read the registered objects' records by id only, never by name.
  relatedLists:
    - id: inside
      label: Grants inside it
      empty: No grant sits inside this one.
      sources:
        - { from: Grant, via: within_id, row: { line: [scope], time: ends_note } }
    - id: replaced-by
      label: Replaced by
      empty: No grant replaces this one.
      sources:
        - { from: Grant, via: replaces_id, row: { line: [scope] } }
    # The records whose lines name the grant, each with its lines, beside the product's own count where the grant holds one.
    - id: recorded
      label: Recorded under it
      empty: No recorded change names this grant.
      beside: { field: uses, one: Your product counts 1 use., other: "Your product counts {value} uses." }
      sources:
        - { from: [Task, Approval, Transaction, Grant], via: "state_history[].grant_id" }
    # The same records that are not final, or not known; on an ended grant, read at its end, with their state then and now.
    - id: under-way
      label: Still under way
      empty: No record that names this grant is under way.
      filtered: { one: 1 record that names this grant has reached an end., other: "{count} records that name this grant have reached an end." }
      note: These are only the records here that name this grant; work under it elsewhere is not shown.
      finality: [not_final, not_known]
      sources:
        - { from: [Task, Approval, Transaction, Grant], via: "state_history[].grant_id" }
    - id: after-end
      label: Recorded after it ended
      empty: Nothing was recorded under it after it ended.
      afterEnd: true
      sources:
        - { from: [Task, Approval, Transaction, Grant], via: "state_history[].grant_id" }
    # s250-m03: once the grant has ended, the closure a product recorded for it, with its lines (the third part of the
    # Grant story). A request never given gets none, and a grant that ended with its outer grant gets none of its own (your
    # product may name it, in words, in a line of the outer grant's closure), so the empty sentence says only what the list
    # reads.
    - id: closure
      label: Its closure
      empty: No closure here is of this grant.
      afterEnd: true
      sources:
        - { from: Closure, via: closes_id, lines: true, row: { line: [summary], time: { field: updated_at, says: Last report } } }
    # Its seats' own records as they stand now, by forward lookup; a seat with no record here shows its kept name and kind.
    - id: parties
      label: Its parties now
      empty: No party of this grant is a record here.
      sources:
        - { from: User, key: granted_by_id, seat: Given by, kept: { name: granted_by_name, kind: granted_by_kind } }
        - { from: [Agent, User], key: granted_to_id, seat: Held by, kept: { name: granted_to_name, kind: granted_to_kind } }
        - { from: [Organization, User], key: granted_for_id, seat: For, kept: { name: granted_for_name } }
        - { from: User, key: owner_id, seat: Answers for it, kept: { name: owner_name, kind: owner_type } }

# Eight authored sample grants. Each names its giver and its holder as shipped User and Agent samples, the party it is for
# as a shipped Organization, and the one who answers for it as a shipped User or the team an Agent sample names as its
# sponsor. The first carries on the Tidewater story: Ruth Adeyemi's grant to the Billing Agent, and the standing yes inside
# it that the Billing Agent asked Ruth for and she gave after the 28 September resend, for returned transfers only, within
# limits. "Northwind customer replies" ended with work under way: Dana Whitfield revoked it on 8 October while the task
# it was used for still needed her answer, so the task stays as it was. Taking the grant back ended the yes, not the work
# (s249). Every line an agent writes for a party in any shipped sample names the grant it acted under, active at the time; every grant that stands, and is not
# inside another, is restated in its holder's acts_for. Each history follows the declared order from requested, and every
# actor acts inside the dates of its own record. A grant's uses count the moments its holder acted under it: one act can
# write lines on several records at once (the 21:00 resend writes the payment's, the task's and the approval's). Times are
# UTC, as the records keep them; the end is also kept in the party's own zone and words.
samples:
  - grant_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c01'
    name: Tidewater invoices and payments
    scope: Invoices and payments
    requested_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d02'
    requested_by_name: Ruth Adeyemi
    requested_by_kind: person
    granted_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d02'
    granted_by_name: Ruth Adeyemi
    granted_by_kind: person
    granted_as: 'Finance manager, Tidewater Co-op'
    granted_to_id: '6a1e2b3c-4d5e-4f60-8a7b-9c0d1e2f3a01'
    granted_to_name: Billing Agent
    granted_to_kind: agent
    granted_for_id: '3f1c2a4e-5b6d-4e7f-8a9b-0c1d2e3f4a05'
    granted_for_name: Tidewater Co-op
    allowed_actions: Look up invoices; Match payments to invoices
    asks_first_for: Resend a payment; Dispute a charge
    never_allowed: Change bank details; Close the account
    ends_at: '2026-12-31T10:59:59Z'
    timezone: Pacific/Auckland
    ends_note: 'At the end of 31 Dec 2026, Tauranga time'
    uses: 6
    last_used_at: '2026-09-28T21:05:00Z'
    last_use: '28 Sep: asked for a standing yes to resend returned transfers'
    owner_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d02'
    owner_type: user
    owner_name: Ruth Adeyemi
    ownership_role: Answers for it
    status: active
    state_history:
      - { title: Requested, from: null, to: requested, at: '2026-08-20T21:30:00Z', reason: Requested to match bank transfers to invoices, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d02', actor_name: Ruth Adeyemi, actor_kind: person }
      - { title: Given, from: requested, to: active, at: '2026-09-01T21:00:00Z', reason: Given after twelve days of supervised matching, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d02', actor_name: Ruth Adeyemi, actor_kind: person }
    created_at: '2026-08-20T21:30:00Z'
    updated_at: '2026-09-28T21:05:00Z'
    last_event: updated
    last_event_at: '2026-09-28T21:05:00Z'
  - grant_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c02'
    name: Resend returned transfers
    scope: Resend a payment the bank returned
    requested_by_id: '6a1e2b3c-4d5e-4f60-8a7b-9c0d1e2f3a01'
    requested_by_name: Billing Agent
    requested_by_kind: agent
    asked_of_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d02'
    asked_of_name: Ruth Adeyemi
    asked_of_kind: person
    granted_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d02'
    granted_by_name: Ruth Adeyemi
    granted_by_kind: person
    granted_as: 'Finance manager, Tidewater Co-op'
    granted_to_id: '6a1e2b3c-4d5e-4f60-8a7b-9c0d1e2f3a01'
    granted_to_name: Billing Agent
    granted_to_kind: agent
    granted_for_id: '3f1c2a4e-5b6d-4e7f-8a9b-0c1d2e3f4a05'
    granted_for_name: Tidewater Co-op
    allowed_actions: Resend a payment
    asks_first_for: None
    never_allowed: None
    ends_at: '2026-12-31T10:59:59Z'
    timezone: Pacific/Auckland
    ends_note: 'At the end of 31 Dec 2026, Tauranga time'
    amount_limit_minor: 1200000
    period_limit_minor: 3000000
    limit_currency: USD
    limit_period: month
    uses_per_period: 3
    conditions: 'Only a payment the bank returned, to the same payee for the same amount, with the invoice number in the reference'
    uses: 0
    spent_minor: 0
    within_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c01'
    within_name: Tidewater invoices and payments
    owner_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d02'
    owner_type: user
    owner_name: Ruth Adeyemi
    ownership_role: Answers for it
    status: active
    state_history:
      - { title: Requested, from: null, to: requested, at: '2026-09-28T21:05:00Z', reason: Requested to resend returned transfers without asking each time, actor_id: '6a1e2b3c-4d5e-4f60-8a7b-9c0d1e2f3a01', actor_name: Billing Agent, actor_kind: agent, on_behalf_of_id: '3f1c2a4e-5b6d-4e7f-8a9b-0c1d2e3f4a05', on_behalf_of_name: Tidewater Co-op, grant_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c01', grant_name: Tidewater invoices and payments }
      - { title: Given, from: requested, to: active, at: '2026-09-28T21:12:00Z', reason: 'Given for returned transfers, within its limits', actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d02', actor_name: Ruth Adeyemi, actor_kind: person }
    created_at: '2026-09-28T21:05:00Z'
    updated_at: '2026-09-28T21:12:00Z'
    last_event: granted
    last_event_at: '2026-09-28T21:12:00Z'
  - grant_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c03'
    name: Marlow Yoga class bookings
    scope: Class bookings
    requested_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d07'
    requested_by_name: Jonah Marlow
    requested_by_kind: person
    granted_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d07'
    granted_by_name: Jonah Marlow
    granted_by_kind: person
    granted_as: 'Founder, Marlow Yoga'
    granted_to_id: '6a1e2b3c-4d5e-4f60-8a7b-9c0d1e2f3a07'
    granted_to_name: Scheduling Agent
    granted_to_kind: agent
    granted_for_id: '3f1c2a4e-5b6d-4e7f-8a9b-0c1d2e3f4a06'
    granted_for_name: Marlow Yoga
    allowed_actions: Send waitlist offers
    asks_first_for: Book a class
    never_allowed: Charge a card
    ends_at: '2027-01-01T05:59:59Z'
    timezone: America/Chicago
    ends_note: 'At the end of 31 Dec 2026, Austin time'
    ended_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d07'
    ended_by_name: Jonah Marlow
    ended_by_kind: person
    ended_reason: The studio closed
    owner_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d07'
    owner_type: user
    owner_name: Jonah Marlow
    ownership_role: Answers for it
    status: revoked
    state_history:
      - { title: Requested, from: null, to: requested, at: '2026-01-12T10:00:00Z', reason: Requested to fill classes from the waitlist, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d07', actor_name: Jonah Marlow, actor_kind: person }
      - { title: Given, from: requested, to: active, at: '2026-01-19T10:00:00Z', reason: Given for class bookings, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d07', actor_name: Jonah Marlow, actor_kind: person }
      - { title: Revoked, from: active, to: revoked, at: '2026-07-10T08:55:00Z', reason: The studio closed, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d07', actor_name: Jonah Marlow, actor_kind: person }
    created_at: '2026-01-12T10:00:00Z'
    updated_at: '2026-07-10T08:55:00Z'
    last_event: ended
    last_event_at: '2026-07-10T08:55:00Z'
  - grant_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c04'
    name: Northwind spring order replies
    scope: Customer replies during the spring order rush
    requested_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01'
    requested_by_name: Dana Whitfield
    requested_by_kind: person
    granted_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01'
    granted_by_name: Dana Whitfield
    granted_by_kind: person
    granted_as: 'Operations director, Northwind Traders'
    granted_to_id: '6a1e2b3c-4d5e-4f60-8a7b-9c0d1e2f3a02'
    granted_to_name: Support Agent
    granted_to_kind: agent
    granted_for_id: '3f1c2a4e-5b6d-4e7f-8a9b-0c1d2e3f4a01'
    granted_for_name: Northwind Traders
    allowed_actions: Track shipments; Draft replies
    asks_first_for: Send a reply
    never_allowed: Offer a discount code; Cancel an order; Change a delivery address
    ends_at: '2026-06-01T04:59:59Z'
    timezone: America/Chicago
    ends_note: 'At the end of 31 May 2026, Chicago time'
    ended_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01'
    ended_by_name: Dana Whitfield
    ended_by_kind: person
    ended_reason: Replaced by Northwind customer replies
    owner_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01'
    owner_type: user
    owner_name: Dana Whitfield
    ownership_role: Answers for it
    status: replaced
    state_history:
      - { title: Requested, from: null, to: requested, at: '2026-03-02T15:05:00Z', reason: Requested for the spring order rush, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01', actor_name: Dana Whitfield, actor_kind: person }
      - { title: Given, from: requested, to: active, at: '2026-03-02T15:10:00Z', reason: 'Given for the spring order rush, until the end of May', actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01', actor_name: Dana Whitfield, actor_kind: person }
      - { title: Replaced, from: active, to: replaced, at: '2026-03-09T15:00:00Z', reason: Replaced by Northwind customer replies, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01', actor_name: Dana Whitfield, actor_kind: person }
    created_at: '2026-03-02T15:05:00Z'
    updated_at: '2026-03-09T15:00:00Z'
    last_event: ended
    last_event_at: '2026-03-09T15:00:00Z'
  - grant_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c05'
    name: Northwind customer replies
    scope: Customer replies
    requested_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01'
    requested_by_name: Dana Whitfield
    requested_by_kind: person
    granted_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01'
    granted_by_name: Dana Whitfield
    granted_by_kind: person
    granted_as: 'Operations director, Northwind Traders'
    granted_to_id: '6a1e2b3c-4d5e-4f60-8a7b-9c0d1e2f3a02'
    granted_to_name: Support Agent
    granted_to_kind: agent
    granted_for_id: '3f1c2a4e-5b6d-4e7f-8a9b-0c1d2e3f4a01'
    granted_for_name: Northwind Traders
    allowed_actions: Track shipments; Draft replies
    asks_first_for: Send a reply; Offer a discount code
    never_allowed: Cancel an order; Change a delivery address
    ends_at: '2027-07-01T04:59:59Z'
    timezone: America/Chicago
    ends_note: 'At the end of 30 Jun 2027, Chicago time'
    uses: 2
    last_used_at: '2026-10-06T14:12:00Z'
    last_use: '6 Oct: asked Dana Whitfield a question about order NW-2207'
    replaces_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c04'
    replaces_name: Northwind spring order replies
    first_grant_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c04'
    first_grant_name: Northwind spring order replies
    ended_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01'
    ended_by_name: Dana Whitfield
    ended_by_kind: person
    ended_reason: Replies go back to the support team
    owner_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01'
    owner_type: user
    owner_name: Dana Whitfield
    ownership_role: Answers for it
    status: revoked
    state_history:
      - { title: Requested, from: null, to: requested, at: '2026-03-09T14:50:00Z', reason: 'Requested to answer every customer, not only spring orders', actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01', actor_name: Dana Whitfield, actor_kind: person }
      - { title: Given, from: requested, to: active, at: '2026-03-09T15:00:00Z', reason: Given once replies were reviewed and approved, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01', actor_name: Dana Whitfield, actor_kind: person }
      - { title: Revoked, from: active, to: revoked, at: '2026-10-08T16:00:00Z', reason: Replies go back to the support team, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d01', actor_name: Dana Whitfield, actor_kind: person }
    created_at: '2026-03-09T14:50:00Z'
    updated_at: '2026-10-08T16:00:00Z'
    last_event: ended
    last_event_at: '2026-10-08T16:00:00Z'
  - grant_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c06'
    name: Summit online orders
    scope: Online orders
    requested_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d08'
    requested_by_name: Arjun Mehta
    requested_by_kind: person
    granted_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d08'
    granted_by_name: Arjun Mehta
    granted_by_kind: person
    granted_as: 'E-commerce manager, Summit Outfitters'
    granted_to_id: '6a1e2b3c-4d5e-4f60-8a7b-9c0d1e2f3a03'
    granted_to_name: Order Agent
    granted_to_kind: agent
    granted_for_id: '3f1c2a4e-5b6d-4e7f-8a9b-0c1d2e3f4a07'
    granted_for_name: Summit Outfitters
    allowed_actions: Check stock; Reserve items for 24 hours
    asks_first_for: Split a shipment; Upgrade shipping
    never_allowed: Issue a refund; Delete an order
    ends_at: '2027-04-01T05:59:59Z'
    timezone: America/Denver
    ends_note: 'At the end of 31 Mar 2027, Denver time'
    uses: 1
    last_used_at: '2026-10-08T15:00:00Z'
    last_use: '8 Oct: checked stock for the 40 trail tents'
    owner_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d08'
    owner_type: user
    owner_name: Arjun Mehta
    ownership_role: Answers for it
    status: active
    state_history:
      - { title: Requested, from: null, to: requested, at: '2026-05-04T16:30:00Z', reason: Requested to reserve stock for online orders, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d08', actor_name: Arjun Mehta, actor_kind: person }
      - { title: Given, from: requested, to: active, at: '2026-05-11T16:00:00Z', reason: Given once reservations were tested, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d08', actor_name: Arjun Mehta, actor_kind: person }
    created_at: '2026-05-04T16:30:00Z'
    updated_at: '2026-10-08T15:00:00Z'
    last_event: updated
    last_event_at: '2026-10-08T15:00:00Z'
  - grant_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c07'
    name: Blue Harbor session bookings
    scope: Session bookings
    requested_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d03'
    requested_by_name: Priya Raman
    requested_by_kind: person
    granted_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d03'
    granted_by_name: Priya Raman
    granted_by_kind: person
    granted_as: 'Studio manager, Blue Harbor Studio'
    granted_to_id: '6a1e2b3c-4d5e-4f60-8a7b-9c0d1e2f3a04'
    granted_to_name: Booking Agent
    granted_to_kind: agent
    granted_for_id: '3f1c2a4e-5b6d-4e7f-8a9b-0c1d2e3f4a02'
    granted_for_name: Blue Harbor Studio
    allowed_actions: Send reminders
    asks_first_for: Book a session; Reschedule a session
    never_allowed: Charge a card; Cancel a membership
    ends_at: '2027-02-01T07:59:59Z'
    timezone: America/Los_Angeles
    ends_note: 'At the end of 31 Jan 2027, Portland time'
    uses: 2
    last_used_at: '2026-09-19T18:20:00Z'
    last_use: '19 Sep: Sunday''s reminders sent; delivery not confirmed'
    owner_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d03'
    owner_type: user
    owner_name: Priya Raman
    ownership_role: Answers for it
    status: paused
    state_history:
      - { title: Requested, from: null, to: requested, at: '2026-09-19T11:30:00Z', reason: Requested to send session reminders, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d03', actor_name: Priya Raman, actor_kind: person }
      - { title: Given, from: requested, to: active, at: '2026-09-19T12:00:00Z', reason: Given for session reminders and bookings, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d03', actor_name: Priya Raman, actor_kind: person }
      - { title: Paused, from: active, to: paused, at: '2026-09-21T09:30:00Z', reason: 'Paused until the studio''s new calendar is ready', actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d03', actor_name: Priya Raman, actor_kind: person }
    created_at: '2026-09-19T11:30:00Z'
    updated_at: '2026-09-21T09:30:00Z'
    last_event: paused
    last_event_at: '2026-09-21T09:30:00Z'
  - grant_id: '4d7a9c2e-1b3f-4e6a-9c8d-5e2f7a1b3c08'
    name: Kestrel overdue invoices
    scope: Overdue invoices
    requested_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d05'
    requested_by_name: Grace Okafor
    requested_by_kind: person
    granted_by_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d05'
    granted_by_name: Grace Okafor
    granted_by_kind: person
    granted_as: 'Accounts lead, Kestrel Print Co.'
    granted_to_id: '6a1e2b3c-4d5e-4f60-8a7b-9c0d1e2f3a06'
    granted_to_name: Collections Agent
    granted_to_kind: agent
    granted_for_id: '3f1c2a4e-5b6d-4e7f-8a9b-0c1d2e3f4a04'
    granted_for_name: Kestrel Print Co.
    allowed_actions: Record a promise to pay
    asks_first_for: Send a payment reminder
    never_allowed: Pass an account to collections; Add a late fee
    ends_at: '2026-12-31T23:59:59Z'
    timezone: Europe/London
    ends_note: 'At the end of 31 Dec 2026, Leeds time'
    uses: 2
    last_used_at: '2026-09-22T09:00:00Z'
    last_use: '22 Sep: started drafting September''s payment reminders'
    owner_id: team_kestrel_accounts
    owner_type: team
    owner_name: Accounts team
    ownership_role: Answers for it
    status: active
    state_history:
      - { title: Requested, from: null, to: requested, at: '2026-02-02T10:30:00Z', reason: Requested to chase overdue invoices, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d05', actor_name: Grace Okafor, actor_kind: person }
      - { title: Given, from: requested, to: active, at: '2026-02-09T10:00:00Z', reason: Given once the reminder wording was approved, actor_id: '8b2e4d6f-1a3c-4e5b-9d7f-2c4e6a8b0d05', actor_name: Grace Okafor, actor_kind: person }
    created_at: '2026-02-02T10:30:00Z'
    updated_at: '2026-09-22T09:00:00Z'
    last_event: updated
    last_event_at: '2026-09-22T09:00:00Z'
```
