truto-jsonata
Installation
SKILL.md
truto-jsonata — Custom Functions for Truto JSONata Expressions
Use this skill whenever you (or an agent acting on a Truto customer's behalf) write JSONata inside Truto config. Everywhere JSONata appears in Truto config is editable via the public Truto HTTP API — there is no need to fork the platform. The customer-facing surfaces are:
- Unified API mapping overrides (the heaviest user) —
POST/PATCH /environment-unified-model-resource-methodconfig.response_mapping,config.query_mapping,config.request_body_mapping,config.request_header_mapping,config.response_header_mapping,config.path_mapping,config.error_mapping,config.resource.expression/config.method.expression,config.is_partial_expression,config.before[].run_if/config.after[].run_if,config.side_load.*.response_mapping - Custom unified models —
POST /unified-model+POST /unified-model-resource-method(sameconfig.*JSONata fields as above, defining the base row that environment overrides merge on top of) - Per-integrated-account overrides —
PATCH /integrated-account/:idunified_model_override.<model>.<resource>.<method>.<mapping_field>(per-account variant of the unified mapping fields) - Environment integration overrides —
PATCH /environment-integration/:idoverride.error_expression,override.authorization.config.expression,override.pagination.config.*_expression,override.rate_limit.is_rate_limited/.retry_after_header_expression/.rate_limit_header_expression,override.webhook.handle_verification/.payload_transform - Sync Job V4 templates —
transform.config.expression,add_context.config.expression,update_state.config.value_expression, node-levelrun_if, job-levelargs_validation, andrequest.query/request.bodywhen given as strings - Workflows — workflow-level
run_if, step-levelrun_if, and stepconfigwhen given as a string - Daemon Jobs —
args_validation - Integration Scheduled Actions —
run_if
Truto evaluates these expressions with the @truto/truto-jsonata runtime, which extends standard JSONata with a curated set of custom $ functions for data conversion, encoding, hashing, lodash-style array/object work, format conversions (Markdown ↔ HTML ↔ Notion ↔ Slack ↔ Google Docs ↔ ADF ↔ PDF), data formats (XML, CSV, Parquet, SQL), and AI helpers.