@alvera-ai/platform-sdk 0.10.0-rc.12 → 0.10.0-rc.13

package/.agent/AGENTS.md

@@ -194,10 +194,10 @@ Cookbook authoring uses per-industry bootstrap setup files
 under `.agent/cookbook/_setup/<industry>.md` to DRY out the
 auth + tenant + datalake + dataset-seeding steps every
 scenario in an industry shares. The convention matches the
-markdown-doctest / doc-vitest ecosystem pattern — setup
-belongs to a scope (the industry), and any cookbook in that
-scope inherits the setup by being there. No per-cookbook
-opt-in field is required.
+markdown-doctest ecosystem pattern — setup belongs to a
+scope (the industry), and any cookbook in that scope
+inherits the setup by being there. No per-cookbook opt-in
+field is required.
 
 - Setup files live under `_setup/`. The leading underscore on
   the directory marks them as fragments (not standalone
@@ -266,8 +266,8 @@ repo's own integration tests use.
   the generated specs already consume.
   `make validate-cookbook` exports
   `COOKBOOK_FIXTURES_DIR=<absolute path to _fixtures>` to the
-  spawned Vitest process; any operator running cookbook code
-  directly from a Bun script must set the same variable.
+  spawned `bun test` process; any operator running cookbook
+  code directly from a Bun script must set the same variable.
 - The fixtures ship with the `@alvera-ai/platform-sdk` npm
   package via the `files: [.agent]` field, so a consumer
   who installed the package finds the templates at

package/.agent/cookbook/_fixtures/README.md

@@ -12,7 +12,7 @@ by reading one path.
 Cookbook code reads fixtures via the
 `COOKBOOK_FIXTURES_DIR` environment variable. The validator
 (`make validate-cookbook`) exports this variable to the spawned
-Vitest process; any operator script that runs cookbook code
+`bun test` process; any operator script that runs cookbook code
 directly must set the same variable to the absolute path of
 this directory.
 
@@ -70,8 +70,30 @@ passes against the new template shape.
 | `_lead_submissions_foundation_generic_table.liquid` | `score-leads-with-llm-categorization` | `priv/liquid_templates/data_activation/interoperability/foundation/airflow/_lead_submissions_foundation_generic_table.liquid` |
 | `_lead_submissions_foundation_mdm.liquid` | `score-leads-with-llm-categorization` | `priv/liquid_templates/data_activation/interoperability/foundation/airflow/_lead_submissions_foundation_mdm.liquid` |
 
-### `healthcare/`, `accounts_receivable/`, `payment_risk/`
+### `healthcare/`
 
-Added as their cookbooks land. Same shape as `foundation/`:
-each directory lists every template + which cookbook consumes
-it + which production template it was vendored from.
+| File | Consumed by cookbook(s) | Source-of-truth |
+|---|---|---|
+| `_cahps_appointments_healthcare_patient.liquid` | `appointment-review-sms-workflow` | `priv/liquid_templates/data_activation/interoperability/healthcare/fhir4/athena/_cahps_appointments_healthcare_patient.liquid` |
+| `_cahps_appointments_healthcare_appointment.liquid` | `appointment-review-sms-workflow` | `priv/liquid_templates/data_activation/interoperability/healthcare/fhir4/athena/_cahps_appointments_healthcare_appointment.liquid` |
+| `_cahps_appointments_healthcare_mdm.liquid` | `appointment-review-sms-workflow` | `priv/liquid_templates/data_activation/interoperability/healthcare/fhir4/athena/_cahps_appointments_healthcare_mdm.liquid` |
+
+The `contact-us-triage-with-llm` cookbook ingests into a generic
+table via the auto-provisioned identity contract, so it loads no
+vendored template.
+
+### `accounts_receivable/`
+
+| File | Consumed by cookbook(s) | Source-of-truth |
+|---|---|---|
+| `_customers_accounts_receivable_customer.liquid` | `welcome-sms-for-customers`, `dunning-sms-for-delinquent` | `priv/liquid_templates/data_activation/interoperability/accounts_receivable/stripe/_customers_accounts_receivable_customer.liquid` |
+| `_customers_accounts_receivable_mdm.liquid` | `welcome-sms-for-customers`, `dunning-sms-for-delinquent` | `priv/liquid_templates/data_activation/interoperability/accounts_receivable/stripe/_customers_accounts_receivable_mdm.liquid` |
+
+### `payment_risk/`
+
+| File | Consumed by cookbook(s) | Source-of-truth |
+|---|---|---|
+| `_payment_accounts_payment_risk_payment_account.liquid` | `kyc-notification-on-account-activation` | `priv/liquid_templates/data_activation/interoperability/payment_risk/atomic_fi/_payment_accounts_payment_risk_payment_account.liquid` |
+| `_payment_accounts_payment_risk_mdm.liquid` | `kyc-notification-on-account-activation` | `priv/liquid_templates/data_activation/interoperability/payment_risk/atomic_fi/_payment_accounts_payment_risk_mdm.liquid` |
+| `_compliance_screenings_payment_risk_compliance_screening.liquid` | `sanctions-screening-with-agent-review` | `priv/liquid_templates/data_activation/interoperability/payment_risk/atomic_fi/_compliance_screenings_payment_risk_compliance_screening.liquid` |
+| `_compliance_screenings_payment_risk_mdm.liquid` | `sanctions-screening-with-agent-review` | `priv/liquid_templates/data_activation/interoperability/payment_risk/atomic_fi/_compliance_screenings_payment_risk_mdm.liquid` |

package/.agent/cookbook/_fixtures/accounts_receivable/_customers_accounts_receivable_customer.liquid

@@ -0,0 +1,32 @@
+{% comment %}Stripe Customers → Accounts Receivable Customer attrs{% endcomment %}
+{% assign p = msg %}
+{
+  "customer_type": "{{ p.customer_type | default: "individual" | json_escape }}",
+  "status": "{{ p.status | default: "prospect" | json_escape }}",
+  "customer_number": "{{ p.customer_number | json_escape }}",
+  {% if p.currency and p.currency != "" %}"currency": "{{ p.currency | json_escape }}",{% endif %}
+  {% if p.delinquent and p.delinquent != "" %}"delinquent": {{ p.delinquent }},{% endif %}
+  {% if p.tax_exempt and p.tax_exempt != "" %}"tax_exempt": "{{ p.tax_exempt | json_escape }}",{% endif %}
+  {% if p.preferred_locales and p.preferred_locales != "" %}{% assign locales = p.preferred_locales | split: "|" %}"preferred_locales": [{% for l in locales %}"{{ l | json_escape }}"{% unless forloop.last %},{% endunless %}{% endfor %}],{% endif %}
+  "regulated_customer": {
+    {% if p.name and p.name != "" %}"name": "{{ p.name | json_escape }}",{% endif %}
+    {% if p.email and p.email != "" %}"email": "{{ p.email | json_escape }}",{% endif %}
+    {% if p.phone and p.phone != "" %}"phone": "{{ p.phone | json_escape }}",{% endif %}
+    {% if p.tax_id and p.tax_id != "" %}"tax_id": "{{ p.tax_id | json_escape }}",{% endif %}
+    {% if p.address_line1 and p.address_line1 != "" %}"address_line1": "{{ p.address_line1 | json_escape }}",{% endif %}
+    {% if p.address_line2 and p.address_line2 != "" %}"address_line2": "{{ p.address_line2 | json_escape }}",{% endif %}
+    {% if p.address_city and p.address_city != "" %}"address_city": "{{ p.address_city | json_escape }}",{% endif %}
+    {% if p.address_state and p.address_state != "" %}"address_state": "{{ p.address_state | json_escape }}",{% endif %}
+    {% if p.address_postal_code and p.address_postal_code != "" %}"address_postal_code": "{{ p.address_postal_code | json_escape }}",{% endif %}
+    {% if p.address_country and p.address_country != "" %}"address_country": "{{ p.address_country | json_escape }}",{% endif %}
+    {% if p.shipping_name and p.shipping_name != "" %}"shipping_name": "{{ p.shipping_name | json_escape }}",{% endif %}
+    {% if p.shipping_phone and p.shipping_phone != "" %}"shipping_phone": "{{ p.shipping_phone | json_escape }}",{% endif %}
+    {% if p.shipping_address_line1 and p.shipping_address_line1 != "" %}"shipping_address_line1": "{{ p.shipping_address_line1 | json_escape }}",{% endif %}
+    {% if p.shipping_address_line2 and p.shipping_address_line2 != "" %}"shipping_address_line2": "{{ p.shipping_address_line2 | json_escape }}",{% endif %}
+    {% if p.shipping_address_city and p.shipping_address_city != "" %}"shipping_address_city": "{{ p.shipping_address_city | json_escape }}",{% endif %}
+    {% if p.shipping_address_state and p.shipping_address_state != "" %}"shipping_address_state": "{{ p.shipping_address_state | json_escape }}",{% endif %}
+    {% if p.shipping_address_postal_code and p.shipping_address_postal_code != "" %}"shipping_address_postal_code": "{{ p.shipping_address_postal_code | json_escape }}",{% endif %}
+    "shipping_address_country": "{{ p.shipping_address_country | default: "" | json_escape }}"
+  },
+  "source_uri": "{{ p.source_uri | default: "" | json_escape }}"
+}

package/.agent/cookbook/_fixtures/accounts_receivable/_customers_accounts_receivable_mdm.liquid

@@ -0,0 +1,20 @@
+{% comment %}Stripe Customers → Accounts Receivable MDM Input{% endcomment %}
+{% assign p = msg %}
+{
+  "identifiers": [
+    {
+      "system": "urn:{{ p.source_uri | json_escape }}:customer-number",
+      "value": "{{ p.customer_number | json_escape }}"
+    }
+  ],
+  {% assign space_parts = p.name | split: " " %}
+  {% if space_parts.size > 1 %}
+  "given_name": "{{ space_parts | first | json_escape }}",
+  "family_name": "{{ space_parts | last | json_escape }}",
+  {% else %}
+  "family_name": "{{ p.name | strip | json_escape }}",
+  {% endif %}
+  {% if p.phone and p.phone != "" %}"phone": "{{ p.phone | json_escape }}",{% endif %}
+  {% if p.email and p.email != "" %}"email": "{{ p.email | json_escape }}",{% endif %}
+  "gender": "unknown"
+}

package/.agent/cookbook/_fixtures/healthcare/_cahps_appointments_healthcare_appointment.liquid

@@ -0,0 +1,47 @@
+{% comment %}CAHPS Appointments → FHIR R4 Appointment attrs{% endcomment %}
+{% comment %}Parent appointment filtering is handled by filter_template{% endcomment %}
+{% assign a = msg %}
+{
+  {% if a.appt_slot_status %}
+  {% assign raw_status = a.appt_slot_status | downcase | strip %}
+  {% if raw_status == "2 - checked in" %}
+  "status": "arrived"
+  {% elsif raw_status == "3 - checked out" or raw_status == "4 - charge entered" %}
+  "status": "fulfilled"
+  {% elsif raw_status == "f - filled" %}
+  "status": "booked"
+  {% elsif raw_status == "o - open slot" %}
+  "status": "pending"
+  {% elsif raw_status == "x - cancelled" %}
+  "status": "cancelled"
+  {% endif %}
+  {% endif %},
+  {% if a.appt_date %}"start": "{{ a.appt_date | parse_date: "{M}/{D}/{YYYY}" }}{% if a.appt_start_time %}T{{ a.appt_start_time | convert_time: "{h12}:{m} {am}" }}{% endif %}{{ a.timezone | tz_offset }}",{% endif %}
+  {% if a.appt_slot_duration and a.appt_slot_duration != "" %}"minutes_duration": {{ a.appt_slot_duration }},{% endif %}
+  {% if a.appt_type and a.appt_type != "" %}"description": "{{ a.appt_type }}",{% endif %}
+  "identifier": [
+    {
+      "system": "urn:{{ a.source_uri }}:appointment-id",
+      "value": "{{ a.appointment_id | default: "" }}"
+    }
+  ],
+  "participants": [
+    {% if a.svc_department and a.svc_department != "" %}
+    {
+      "actor_type": "location",
+      "actor_id": "{{ a.svc_department }}",
+      "required": "required",
+      "status": "accepted"
+    }{% if a.rndrng_provider_id and a.rndrng_provider_id != "" %},{% endif %}
+    {% endif %}
+    {% if a.rndrng_provider_id and a.rndrng_provider_id != "" %}
+    {
+      "actor_type": "practitioner",
+      "actor_id": "{{ a.rndrng_provider_id }}",
+      "required": "required",
+      "status": "accepted"
+    }
+    {% endif %}
+  ],
+  "source_uri": "{{ a.source_uri | default: "" }}"
+}

package/.agent/cookbook/_fixtures/healthcare/_cahps_appointments_healthcare_mdm.liquid

@@ -0,0 +1,24 @@
+{% comment %}CAHPS Appointments → Healthcare MDM Input{% endcomment %}
+{% assign p = msg %}
+{
+  "identifiers": [
+    {
+      "system": "urn:{{ p.source_uri }}:patient-id",
+      "value": "{{ p.patient_id }}"
+    }{% if p.enterprise_id and p.enterprise_id != "" %},
+    {
+      "system": "urn:{{ p.source_uri }}:enterprise-id",
+      "value": "{{ p.enterprise_id }}"
+    }{% endif %}
+  ],
+  {% assign space_parts = p.patient_name | split: " " %}
+  {% if space_parts.size > 1 %}
+  "given_name": "{{ space_parts | first }}",
+  "family_name": "{{ space_parts | last }}",
+  {% else %}
+  "family_name": "{{ p.patient_name | strip }}",
+  {% endif %}
+  {% if p.patientdob and p.patientdob != "" %}"birth_date": "{{ p.patientdob | parse_date: "{M}/{D}/{YYYY}" }}",{% endif %}
+  {% if p.patient_mobile_no and p.patient_mobile_no != "" %}"phone": "{{ p.patient_mobile_no }}",{% endif %}
+  "gender": "unknown"
+}

package/.agent/cookbook/_fixtures/healthcare/_cahps_appointments_healthcare_patient.liquid

@@ -0,0 +1,38 @@
+{% comment %}CAHPS Appointments → FHIR R4 Patient attrs{% endcomment %}
+{% comment %}Parent appointment filtering is handled by filter_template{% endcomment %}
+{% assign p = msg %}
+{
+  "active": true,
+  "gender": "unknown",
+  {% if p.patientdob %}"birth_date": "{{ p.patientdob | parse_date: "{M}/{D}/{YYYY}" }}",{% endif %}
+  "identifier": [
+    {
+      "system": "urn:{{ p.source_uri }}:patient-id",
+      "value": "{{ p.patient_id | default: "" }}"
+    }{% if p.enterprise_id and p.enterprise_id != "" %},
+    {
+      "system": "urn:{{ p.source_uri }}:enterprise-id",
+      "value": "{{ p.enterprise_id }}"
+    }{% endif %}
+  ],
+  {% if p.patient_name %}"name": [
+    {
+      "use": "official",
+      {% assign space_parts = p.patient_name | split: " " %}
+      {% if space_parts.size > 1 %}
+      "given": ["{{ space_parts | first }}"],
+      "family": "{{ space_parts | last }}"
+      {% else %}
+      "family": "{{ p.patient_name | strip }}"
+      {% endif %}
+    }
+  ],{% endif %}
+  {% if p.patient_mobile_no and p.patient_mobile_no != "" %}"telecom": [
+    {
+      "system": "phone",
+      "value": "{{ p.patient_mobile_no }}",
+      "use": "mobile"
+    }
+  ],{% endif %}
+  "source_uri": "{{ p.source_uri | default: "" }}"
+}

package/.agent/cookbook/_fixtures/payment_risk/_compliance_screenings_payment_risk_compliance_screening.liquid

@@ -0,0 +1,59 @@
+{% comment %}Atomic FI ComplianceScreenings → PaymentRisk ComplianceScreening attrs
+
+Source: GET /api/compliance-screenings on Atomic FI (paginated; the
+fetch pipeline extracts the `data` array via the response_extractor_key
+and streams one row per `msg`).
+
+The FK columns `legal_entity_id` and `account_holder_id` are NOT emitted
+here — `ComplianceScreening.upsert_changeset/9` `put_change`s them from
+the resolved MDMOutput after the MDM template's MDMInput drives
+`MDM.resolve/5` (which find-or-creates the LE+AH parent pair).
+
+Field handling on the unregulated side:
+  * narrative + name fields (screened_entity_name, review_notes,
+    pep_list_name) are persisted through TokenizedDataType — pass them
+    as raw strings here; the changeset's `cast_tokenized_data/4` calls
+    tokenize automatically before insert.
+  * analytic numerics (aml_risk_score, aml_velocity_count,
+    aml_high_risk_country) stay plaintext on both unreg + reg.
+  * `sanctions_matches` is explicitly looped — Liquid's default
+    rendering on a list produces a string, not JSON; the explicit
+    {% for %} loop emits one JSON object per element so the CS
+    upsert's `sync_sanctions_matches/6` can cast each child row.
+{% endcomment %}
+{% assign p = msg %}
+{
+  "compliance_screening_number": "{{ p.compliance_screening_number | default: p.id | json_escape }}",
+  "scope": "{{ p.scope | default: "account_holder" | json_escape }}",
+  "screening_type": "{{ p.screening_type | default: "sanctions" | json_escape }}",
+  "screening_status": "{{ p.screening_status | default: "pending" | json_escape }}",
+  "screened_entity_type": "{{ p.screened_entity_type | default: "individual" | json_escape }}",
+  {% if p.screening_score and p.screening_score != "" %}"screening_score": {{ p.screening_score }},{% endif %}
+  {% if p.match_count and p.match_count != "" %}"match_count": {{ p.match_count }},{% endif %}
+  {% if p.screened_at and p.screened_at != "" %}"screened_at": "{{ p.screened_at | json_escape }}",{% endif %}
+  {% if p.sanctions_screening_status and p.sanctions_screening_status != "" %}"sanctions_screening_status": "{{ p.sanctions_screening_status | json_escape }}",{% endif %}
+  {% if p.sanctions_screening_date and p.sanctions_screening_date != "" %}"sanctions_screening_date": "{{ p.sanctions_screening_date | json_escape }}",{% endif %}
+  {% if p.manual_review_required %}"manual_review_required": {{ p.manual_review_required }},{% endif %}
+  {% if p.screened_entity_name and p.screened_entity_name != "" %}"screened_entity_name": "{{ p.screened_entity_name | json_escape }}",{% endif %}
+  {% if p.review_notes and p.review_notes != "" %}"review_notes": "{{ p.review_notes | json_escape }}",{% endif %}
+  {% if p.pep_list_name and p.pep_list_name != "" %}"pep_list_name": "{{ p.pep_list_name | json_escape }}",{% endif %}
+  {% if p.aml_risk_score and p.aml_risk_score != "" %}"aml_risk_score": {{ p.aml_risk_score }},{% endif %}
+  {% if p.aml_velocity_count and p.aml_velocity_count != "" %}"aml_velocity_count": {{ p.aml_velocity_count }},{% endif %}
+  {% if p.aml_high_risk_country and p.aml_high_risk_country != "" %}"aml_high_risk_country": "{{ p.aml_high_risk_country | json_escape }}",{% endif %}
+  {% if p.sanctions_matches %}
+  "sanctions_matches": [
+    {% for m in p.sanctions_matches %}
+    {
+      "matched_name": "{{ m.matched_name | json_escape }}",
+      {% if m.matched_entity_type and m.matched_entity_type != "" %}"matched_entity_type": "{{ m.matched_entity_type | json_escape }}",{% endif %}
+      "match_score": {{ m.match_score }},
+      "source_list": "{{ m.source_list | json_escape }}",
+      {% if m.source_id and m.source_id != "" %}"source_id": "{{ m.source_id | json_escape }}",{% endif %}
+      {% if m.false_positive_qualifier and m.false_positive_qualifier != "" %}"false_positive_qualifier": "{{ m.false_positive_qualifier | json_escape }}",{% endif %}
+      {% if m.list_synced_at and m.list_synced_at != "" %}"list_synced_at": "{{ m.list_synced_at | json_escape }}"{% else %}"list_synced_at": null{% endif %}
+    }{% unless forloop.last %},{% endunless %}
+    {% endfor %}
+  ],
+  {% endif %}
+  "source_uri": "{{ p.source_uri | default: "api.atomic.fi" | json_escape }}"
+}

package/.agent/cookbook/_fixtures/payment_risk/_compliance_screenings_payment_risk_mdm.liquid

@@ -0,0 +1,36 @@
+{% comment %}Atomic FI ComplianceScreenings → PaymentRisk MDM Input
+
+A CS row from Atomic FI references an account_holder UUID
+(`p.account_holder_id`). MDM-resolution side uses that as the external
+`account_holder_number` to find the LegalEntity + AccountHolder pair
+already ingested via the account-holders IOC.
+
+`legal_entity_id` on the resulting MDMOutput is what links the CS row's
+`legal_entity_id` (mandatory per the consistency trigger). The
+`account_number_uri + account_holder_number` pair is the canonical
+external identity used by `AccountHolders.match_account_holder/2`.
+{% endcomment %}
+{% assign p = msg %}
+{
+  "owner_type": "account_holder",
+  "account_holder_type": "individual",
+  "account_holder_number": "{{ p.account_holder_id | json_escape }}",
+  "account_number_uri": "{{ p.source_uri | default: "api.atomic.fi" | json_escape }}",
+  "identifiers": [
+    {
+      "system": "urn:atomic.fi:account-holder-id",
+      "value": "{{ p.account_holder_id | json_escape }}",
+      "id_type": "digital_identifier"
+    }
+  ],
+  {% if p.screened_entity_name and p.screened_entity_name != "" %}
+    {% assign space_parts = p.screened_entity_name | split: " " %}
+    {% if space_parts.size > 1 %}
+  "given_name": "{{ space_parts | first | json_escape }}",
+  "family_name": "{{ space_parts | last | json_escape }}",
+    {% else %}
+  "family_name": "{{ p.screened_entity_name | strip | json_escape }}",
+    {% endif %}
+  {% endif %}
+  "gender": "unknown"
+}

package/.agent/cookbook/_fixtures/payment_risk/_payment_accounts_payment_risk_mdm.liquid

@@ -0,0 +1,30 @@
+{% comment %}Atomic FI PaymentAccount → PaymentRisk MDM Input
+
+A PaymentAccount row from Atomic FI references an account_holder UUID
+(`p.account_holder_id`) — that's the canonical external identity used by
+`AccountHolders.match_account_holder/2` to find-or-create the
+LegalEntity + AccountHolder pair already ingested via the
+account-holders IOC.
+
+`legal_entity_id` on the resulting MDMOutput is what links the PA row's
+`legal_entity_id` (PA belongs_to LE — provides the address slice for
+sanctions-review override-agent context). The MDM scope is always
+`account_holder` for PA rows because the PA inherently serves an
+AccountHolder (per Atomic FI's PA schema invariant
+`validate_required([:account_type, :account_holder_id, :currency,
+:tenant_id])`).
+{% endcomment %}
+{% assign p = msg %}
+{
+  "owner_type": "account_holder",
+  "account_holder_type": "individual",
+  "account_holder_number": "{{ p.account_holder_id | json_escape }}",
+  "account_number_uri": "{{ p.source_uri | default: "api.atomic.fi" | json_escape }}",
+  "identifiers": [
+    {
+      "system": "urn:atomic.fi:account-holder-id",
+      "value": "{{ p.account_holder_id | json_escape }}",
+      "id_type": "digital_identifier"
+    }
+  ]
+}

package/.agent/cookbook/_fixtures/payment_risk/_payment_accounts_payment_risk_payment_account.liquid

@@ -0,0 +1,55 @@
+{% comment %}Atomic FI PaymentAccount → PaymentRisk PaymentAccount attrs
+
+Source: GET /api/payment-accounts on Atomic FI (paginated; the fetch
+pipeline extracts the `data` array via the response_extractor_key and
+streams one row per `msg`).
+
+FK columns (`legal_entity_id`, `account_holder_id`, `counterparty_id`)
+are NOT emitted here — `PaymentAccount.upsert_changeset/7` `put_change`s
+them from the resolved MDMOutput after the MDM template's MDMInput
+drives `MDM.resolve/5`.
+
+Field handling on the unregulated side:
+  * PCI-DSS-sensitive fields (`account_number`, `iban`, `card_pan`,
+    `wallet_address`) and narratives (`purpose_of_payment_detail`,
+    `business_relationship_description`) are persisted through
+    `TokenizedDataType` — pass them as raw strings here; the
+    changeset's `cast_tokenized_data/4` calls tokenize automatically
+    before insert.
+  * `enabled_regimes` is rendered as a JSON array; Liquid's `{{ x }}`
+    on a string array would produce a stringified Elixir list, not
+    JSON — the explicit `{% for %}` loop emits one quoted element per
+    regime so the changeset's array cast accepts it.
+
+`destination_country` is derived here from `swift_bic` (chars 5-6 per
+ISO 9362) or `iban` (chars 1-2 per ISO 13616), with BIC preferred when
+both are present. Downstream agents (sanctions-review override) read
+this field directly without re-parsing.
+{% endcomment %}
+{% assign p = msg %}
+{% if p.swift_bic and p.swift_bic != "" %}
+  {% assign derived_country = p.swift_bic | slice: 4, 2 | upcase %}
+{% elsif p.iban and p.iban != "" %}
+  {% assign derived_country = p.iban | slice: 0, 2 | upcase %}
+{% else %}
+  {% assign derived_country = nil %}
+{% endif %}
+{
+  {% if p.payment_account_external_id and p.payment_account_external_id != "" %}"payment_account_external_id": "{{ p.payment_account_external_id | json_escape }}",{% endif %}
+  {% if p.payment_account_number and p.payment_account_number != "" %}"payment_account_number": "{{ p.payment_account_number | json_escape }}",{% endif %}
+  {% if p.status and p.status != "" %}"status": "{{ p.status | json_escape }}",{% endif %}
+  {% if p.account_type and p.account_type != "" %}"account_type": "{{ p.account_type | json_escape }}",{% endif %}
+  {% if p.currency and p.currency != "" %}"currency": "{{ p.currency | json_escape }}",{% endif %}
+  {% if p.routing_number and p.routing_number != "" %}"routing_number": "{{ p.routing_number | json_escape }}",{% endif %}
+  {% if p.swift_bic and p.swift_bic != "" %}"swift_bic": "{{ p.swift_bic | json_escape }}",{% endif %}
+  {% if p.bank_name and p.bank_name != "" %}"bank_name": "{{ p.bank_name | json_escape }}",{% endif %}
+  {% if p.wallet_chain and p.wallet_chain != "" %}"wallet_chain": "{{ p.wallet_chain | json_escape }}",{% endif %}
+  {% if p.account_number and p.account_number != "" %}"account_number": "{{ p.account_number | json_escape }}",{% endif %}
+  {% if p.iban and p.iban != "" %}"iban": "{{ p.iban | json_escape }}",{% endif %}
+  {% if p.card_pan and p.card_pan != "" %}"card_pan": "{{ p.card_pan | json_escape }}",{% endif %}
+  {% if p.wallet_address and p.wallet_address != "" %}"wallet_address": "{{ p.wallet_address | json_escape }}",{% endif %}
+  {% if p.purpose_of_payment_detail and p.purpose_of_payment_detail != "" %}"purpose_of_payment_detail": "{{ p.purpose_of_payment_detail | json_escape }}",{% endif %}
+  {% if p.business_relationship_description and p.business_relationship_description != "" %}"business_relationship_description": "{{ p.business_relationship_description | json_escape }}",{% endif %}
+  {% if derived_country and derived_country != "" %}"destination_country": "{{ derived_country | json_escape }}",{% endif %}
+  "enabled_regimes": [{% for r in p.enabled_regimes %}"{{ r | json_escape }}"{% unless forloop.last %},{% endunless %}{% endfor %}]
+}