- metadata.business_transaction_id always equals business_transaction_id
- authorization.authority_id always equals authority.authority_id
- intent.authorization_id always equals authorization.authorization_id
API reference
parmana.builders
Python SDK reference: Constructs a fully-formed, internally-consistent BusinessTransaction from the fields a caller actually decides, deriving every field the server checks for cross-consistency.
Constructs a fully-formed, internally-consistent BusinessTransaction
from the fields a caller actually decides, deriving every field the
server’s own BusinessTransactionValidator checks for cross-consistency
(packages/runtime/src/validators/BusinessTransactionValidator.ts) so a
caller can never build a request that fails one of those checks by
mistake:
Builds a BusinessTransaction with every cross-referenced id
derived and kept consistent automatically.
business_transaction_id defaults to a fresh uuid4() if omitted —
a caller providing one explicitly is responsible for it being
unique per attempt, since it doubles as the server’s own
idempotency key (see the error catalog,
“businessTransactionId is an idempotency key”).
authority_type defaults to SERVICE — the correct value for an
autonomous agent. There is no “AGENT” value; it does not exist
server-side.
principal_id must match one of the caller API key’s own
allowed_principal_ids server-side, or the request is rejected
before policy ever runs — see GET /callers/me.