Objects / Grant
Grant
A standing yes that one actor may act for a person or organization, on stated terms, until it ends.
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.
sha256:389a997b714a…Open full size: Grant detail screen generated by OODS Foundry in Reactsha256:ef78556f39e9…Open full size: Grant detail screen generated by OODS Foundry in Vuesha256:b822e7faa191…Open full size: Grant list screen generated by OODS Foundry in Reactsha256:e185c5e84808…Open full size: Grant list screen generated by OODS Foundry in Vuesha256:a8744db64abb…Open full size: Grant form screen generated by OODS Foundry in Reactsha256:fcfd14427462…Open full size: Grant form screen generated by OODS Foundry in Vuesha256:4c604fc8a691…Open full size: Grant timeline screen generated by OODS Foundry in Reactsha256:133894bc04da…Open full size: Grant timeline screen generated by OODS Foundry in Vuesha256:ef97593690d2…Open full size: Grant card screen generated by OODS Foundry in Reactsha256:68bdb0238c64…Open full size: Grant card screen generated by OODS Foundry in Vuesha256:d3f3b4679db8…Open full size: Grant inline screen generated by OODS Foundry in Reactsha256:10c623f47eb5…Open full size: Grant inline screen generated by OODS Foundry in Vuesha256:e79b9f408df9…Open full size: Grant workflow screen generated by OODS Foundry in Reactsha256:21c0f4f38762…Open full size: Grant workflow screen generated by OODS Foundry in VueWhat design_compose reported for every screen here:
OODS-V121Object 'Grant' has maturity 'alpha' — composed output may change.
The calls that made the Grant detail apps, in React and Vue
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
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
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
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
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-V119No 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
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-V121as above, 4 times in all
The calls that made the Grant workflow apps, in React and Vue
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"). |
statusrequired | 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_atrequired | datetime | Timestamp recording when the entity was first created. |
updated_at | datetime | Timestamp for the most recent modification, when available. |
last_eventrequired | string | Lifecycle event associated with the most recent timestamp mutation. |
last_event_at | datetime | Timestamp for the lifecycle event captured in last_event. |
owner_idrequired | string | Identifier of the owning principal scoped by owner_type. |
owner_typerequired | 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_idrequired | uuid | Primary identifier for the grant, the id a history entry's grant_id points at. |
namerequired | 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.
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'