@zapier/zapier-sdk 0.120.0 → 0.122.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (21) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +65 -47
  3. package/dist/beta.cjs +287 -287
  4. package/dist/beta.d.mts +244 -116
  5. package/dist/beta.d.ts +244 -116
  6. package/dist/beta.mjs +2 -2
  7. package/dist/{chunk-VLYXR2T6.cjs → chunk-5H5J5AKU.cjs} +1 -1
  8. package/dist/{chunk-CYPVUHGJ.cjs → chunk-AUBIZWYI.cjs} +237 -109
  9. package/dist/{chunk-ZSALKPF6.mjs → chunk-FYLZ2LZO.mjs} +1 -1
  10. package/dist/{chunk-CKZGXKRK.mjs → chunk-PHEZB6T2.mjs} +150 -22
  11. package/dist/experimental.cjs +321 -321
  12. package/dist/experimental.d.mts +256 -128
  13. package/dist/experimental.d.ts +256 -128
  14. package/dist/experimental.mjs +7 -7
  15. package/dist/{index-CThNTXl2.d.mts → index-BnMxdUcw.d.mts} +2 -2
  16. package/dist/{index-CThNTXl2.d.ts → index-BnMxdUcw.d.ts} +2 -2
  17. package/dist/index.cjs +281 -281
  18. package/dist/index.d.mts +1 -1
  19. package/dist/index.d.ts +1 -1
  20. package/dist/index.mjs +1 -1
  21. package/package.json +3 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,39 @@
1
1
  # @zapier/zapier-sdk
2
2
 
3
+ ## 0.122.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 246ba1d: Updated `zod` from 4.3.6 to 4.6.7. Importing `@zapier/zapier-sdk` now uses about 60% less memory (heap after import drops from 35.6 MB to 14.7 MB). The main bundle grows by about 31 KB gzipped, because zod 4.6.7 is larger than 4.3.6.
8
+
9
+ Projects that pass their own zod schemas to the SDK, or reuse its exported schemas, should be on zod 4.6.7 too so the types match. Those schemas follow zod 4.6: ISO timestamps need seconds, and string length limits count characters rather than UTF-16 units. The SDK's own inputs have no ISO timestamp checks, and their string limits are all maximums, so these rules do not make the SDK reject input it accepted before.
10
+
11
+ ### Patch Changes
12
+
13
+ - 246ba1d: Response fields with no fixed shape are now typed and documented as optional. On beta methods: `input` and `output` on `getDurableRun` and `listDurableRuns` (and `input` on a `getDurableRun` execution); `input`, `output` and `error` on `getWorkflowRun`, `getTriggerRun`, `runWorkflow` and `runWorkflowDraft`; `input` and `error` on `listWorkflowRuns`. On the experimental `createForm`: `document`, `consumer_auth` and `callback_url`. These methods already accepted a response without them, so behavior is unchanged.
14
+ - Updated dependencies [246ba1d]
15
+ - @zapier/kitcore@0.22.1
16
+
17
+ ## 0.121.0
18
+
19
+ ### Minor Changes
20
+
21
+ - f208d30: Added options to `validateWorkflow` so it can check everything a workflow is published with, not just its source:
22
+ - `zapierDurableVersion` and `dependencies`: run the version and dependency checks.
23
+ - `triggerConfigurations`: check the trigger, keyed by trigger node id (`workflow-trigger-0`), with its `selectedApi`, `app`, `appTitle`, `action`, `actionTitle`, and `params`.
24
+ - `connections`: check the connection aliases the source uses, as `{ alias: { connectionId } }`.
25
+ - `checkGroups`: run only some checks, for example `["source"]` to skip the account lookups.
26
+ - `severity`: return only issues of one severity, for example `"error"`, and skip checks that only report other severities.
27
+
28
+ All are optional. Checks that need a value you leave out are skipped.
29
+
30
+ Each issue in the response can now also carry:
31
+ - `title`: a short label to show in place of `message`.
32
+ - `fix`: what resolves it (`agent`, `upgrade`, or `retry`; treat unknown values as `agent`).
33
+ - `incomplete`: `true` when the workflow isn't finished yet rather than wrong.
34
+ - `app_key`, `connection_id`, `connection_alias`, and `unchecked_kind`: the app, connection, or skipped check the issue is about.
35
+ - `state_path`, `projection_node_id`, `configuration_id`, `operation_id`, and `region_id`: where the issue sits in the workflow and its diagram.
36
+
3
37
  ## 0.120.0
4
38
 
5
39
  ### Minor Changes
package/README.md CHANGED
@@ -1709,10 +1709,10 @@ Create a Zapier Form from a title and optional fields. Forms publish by default
1709
1709
  | ​ ↳ `owner_id` | `string` | ✅ | — | |
1710
1710
  | ​ ↳ `created_at` | `string` | ✅ | — | |
1711
1711
  | ​ ↳ `updated_at` | `string` | ✅ | — | |
1712
- | ​ ↳ `document` | `unknown` | ✅ | — | |
1712
+ | ​ ↳ `document` | `unknown` | ❌ | — | |
1713
1713
  | ​ ↳ `last_published_at` | `string` | ✅ | — | |
1714
- | ​ ↳ `consumer_auth` | `unknown` | ✅ | — | |
1715
- | ​ ↳ `callback_url` | `unknown` | ✅ | — | |
1714
+ | ​ ↳ `consumer_auth` | `unknown` | ❌ | — | |
1715
+ | ​ ↳ `callback_url` | `unknown` | ❌ | — | |
1716
1716
 
1717
1717
  **Example:**
1718
1718
 
@@ -1978,8 +1978,8 @@ Get the full state of a run-once durable run, including its operations journal
1978
1978
  | `data` | `object` | ✅ | — | |
1979
1979
  | ​ ↳ `id` | `string` | ✅ | — | Run ID (UUID) |
1980
1980
  | ​ ↳ `status` | `string` | ✅ | `initialized`, `started`, `finished`, `failed`, `cancelled` | Run lifecycle status. `finished` / `failed` / `cancelled` are terminal. |
1981
- | ​ ↳ `input` | `unknown` | ✅ | — | Input data passed to the run |
1982
- | ​ ↳ `output` | `unknown` | ✅ | — | Return value, present when status is `finished` |
1981
+ | ​ ↳ `input` | `unknown` | ❌ | — | Input data passed to the run |
1982
+ | ​ ↳ `output` | `unknown` | ❌ | — | Return value, present when status is `finished` |
1983
1983
  | ​ ↳ `error` | `object` | ✅ | — | Structured error details when the run failed (null otherwise) |
1984
1984
  | ​ ↳ `execution` | `object` | ✅ | — | Linked execution, including the operations journal. Null while the run is still in `initialized` state. |
1985
1985
  | ​ ↳ `is_private` | `boolean` | ❌ | — | When true, the run is visible only to the creating user; when false, it is visible across the account. Deprecated: may be removed from the API in a future release. There is no replacement field; do not rely on it. An absent or null value means unknown, not false. |
@@ -2015,9 +2015,9 @@ Get the workflow run associated with a deployed workflow's trigger. Useful immed
2015
2015
  | ​ ↳ `durable_run_id` | `string` | ✅ | — | Linked code-substrate-runner run ID. Null until the durable run is created. |
2016
2016
  | ​ ↳ `workflow_version_id` | `string` | ✅ | — | Workflow version the run is bound to |
2017
2017
  | ​ ↳ `status` | `string` | ✅ | `initialized`, `started`, `finished`, `failed`, `cancelled` | Workflow run lifecycle status. `finished` / `failed` / `cancelled` are terminal. |
2018
- | ​ ↳ `input` | `unknown` | ✅ | — | Input passed to the run |
2019
- | ​ ↳ `output` | `unknown` | ✅ | — | Return value, present when status is `finished` |
2020
- | ​ ↳ `error` | `unknown` | ✅ | — | Error payload when status is `failed` (null otherwise) |
2018
+ | ​ ↳ `input` | `unknown` | ❌ | — | Input passed to the run |
2019
+ | ​ ↳ `output` | `unknown` | ❌ | — | Return value, present when status is `finished` |
2020
+ | ​ ↳ `error` | `unknown` | ❌ | — | Error payload when status is `failed` (null otherwise) |
2021
2021
  | ​ ↳ `created_at` | `string` | ✅ | — | When the run was created (ISO-8601) |
2022
2022
  | ​ ↳ `updated_at` | `string` | ✅ | — | When the run was last updated (ISO-8601) |
2023
2023
 
@@ -2156,9 +2156,9 @@ Get the current state of a workflow run — a live run of a published workflow v
2156
2156
  | `workflow_id` | `string` | ✅ | — | The workflow this run belongs to |
2157
2157
  | `durable_run_id` | `string` | ✅ | — | Linked code-substrate-runner run ID. Null until the durable run is created. |
2158
2158
  | `status` | `string` | ✅ | `initialized`, `started`, `finished`, `failed`, `cancelled` | Workflow run lifecycle status. `finished` / `failed` / `cancelled` are terminal. |
2159
- | `input` | `unknown` | ✅ | — | Input passed to the run |
2160
- | `output` | `unknown` | ✅ | — | Return value, present when status is `finished` |
2161
- | `error` | `unknown` | ✅ | — | Error payload when status is `failed` (null otherwise) |
2159
+ | `input` | `unknown` | ❌ | — | Input passed to the run |
2160
+ | `output` | `unknown` | ❌ | — | Return value, present when status is `finished` |
2161
+ | `error` | `unknown` | ❌ | — | Error payload when status is `failed` (null otherwise) |
2162
2162
  | `created_at` | `string` | ✅ | — | When the run was created (ISO-8601) |
2163
2163
  | `updated_at` | `string` | ✅ | — | When the run was last updated (ISO-8601) |
2164
2164
  | `kind` | `string` | ✅ | `live` | A run of a published workflow version. |
@@ -2173,9 +2173,9 @@ Get the current state of a workflow run — a live run of a published workflow v
2173
2173
  | `workflow_id` | `string` | ✅ | — | The workflow this run belongs to |
2174
2174
  | `durable_run_id` | `string` | ✅ | — | Linked code-substrate-runner run ID. Null until the durable run is created. |
2175
2175
  | `status` | `string` | ✅ | `initialized`, `started`, `finished`, `failed`, `cancelled` | Workflow run lifecycle status. `finished` / `failed` / `cancelled` are terminal. |
2176
- | `input` | `unknown` | ✅ | — | Input passed to the run |
2177
- | `output` | `unknown` | ✅ | — | Return value, present when status is `finished` |
2178
- | `error` | `unknown` | ✅ | — | Error payload when status is `failed` (null otherwise) |
2176
+ | `input` | `unknown` | ❌ | — | Input passed to the run |
2177
+ | `output` | `unknown` | ❌ | — | Return value, present when status is `finished` |
2178
+ | `error` | `unknown` | ❌ | — | Error payload when status is `failed` (null otherwise) |
2179
2179
  | `created_at` | `string` | ✅ | — | When the run was created (ISO-8601) |
2180
2180
  | `updated_at` | `string` | ✅ | — | When the run was last updated (ISO-8601) |
2181
2181
  | `kind` | `string` | ✅ | `draft` | A run launched from a workflow draft via `runWorkflowDraft`. |
@@ -2323,8 +2323,8 @@ List run-once durable runs for the authenticated account, newest first
2323
2323
  | `data[]` | `object[]` | ✅ | — | |
2324
2324
  | ​ ↳ `id` | `string` | ✅ | — | Run ID (UUID) |
2325
2325
  | ​ ↳ `status` | `string` | ✅ | `initialized`, `started`, `finished`, `failed`, `cancelled` | Run lifecycle status. `finished` / `failed` / `cancelled` are terminal. |
2326
- | ​ ↳ `input` | `unknown` | ✅ | — | Input data passed to the run |
2327
- | ​ ↳ `output` | `unknown` | ✅ | — | Return value, present when status is `finished` |
2326
+ | ​ ↳ `input` | `unknown` | ❌ | — | Input data passed to the run |
2327
+ | ​ ↳ `output` | `unknown` | ❌ | — | Return value, present when status is `finished` |
2328
2328
  | ​ ↳ `error` | `object` | ✅ | — | Structured error details when the run failed (null otherwise) |
2329
2329
  | ​ ↳ `execution_id` | `string` | ✅ | — | Linked execution ID. Null until the run leaves the `initialized` state. |
2330
2330
  | ​ ↳ `is_private` | `boolean` | ❌ | — | When true, the run is visible only to the creating user; when false, it is visible across the account. Deprecated: may be removed from the API in a future release. There is no replacement field; do not rely on it. An absent or null value means unknown, not false. |
@@ -2436,8 +2436,8 @@ List workflow runs for a specific workflow, newest first. Live runs (of publishe
2436
2436
  | `id` | `string` | ✅ | — | Workflow run ID (UUIDv7). Unique across live and draft runs. |
2437
2437
  | `durable_run_id` | `string` | ✅ | — | Linked code-substrate-runner run ID. Null until the durable run is created. |
2438
2438
  | `status` | `string` | ✅ | `initialized`, `started`, `finished`, `failed`, `cancelled` | Workflow run lifecycle status. `finished` / `failed` / `cancelled` are terminal. |
2439
- | `input` | `unknown` | ✅ | — | Input passed to the run |
2440
- | `error` | `unknown` | ✅ | — | Error payload when status is `failed` (null otherwise) |
2439
+ | `input` | `unknown` | ❌ | — | Input passed to the run |
2440
+ | `error` | `unknown` | ❌ | — | Error payload when status is `failed` (null otherwise) |
2441
2441
  | `created_at` | `string` | ✅ | — | When the run was created (ISO-8601) |
2442
2442
  | `updated_at` | `string` | ✅ | — | When the run was last updated (ISO-8601) |
2443
2443
  | `kind` | `string` | ✅ | `live` | A run of a published workflow version. |
@@ -2451,8 +2451,8 @@ List workflow runs for a specific workflow, newest first. Live runs (of publishe
2451
2451
  | `id` | `string` | ✅ | — | Workflow run ID (UUIDv7). Unique across live and draft runs. |
2452
2452
  | `durable_run_id` | `string` | ✅ | — | Linked code-substrate-runner run ID. Null until the durable run is created. |
2453
2453
  | `status` | `string` | ✅ | `initialized`, `started`, `finished`, `failed`, `cancelled` | Workflow run lifecycle status. `finished` / `failed` / `cancelled` are terminal. |
2454
- | `input` | `unknown` | ✅ | — | Input passed to the run |
2455
- | `error` | `unknown` | ✅ | — | Error payload when status is `failed` (null otherwise) |
2454
+ | `input` | `unknown` | ❌ | — | Input passed to the run |
2455
+ | `error` | `unknown` | ❌ | — | Error payload when status is `failed` (null otherwise) |
2456
2456
  | `created_at` | `string` | ✅ | — | When the run was created (ISO-8601) |
2457
2457
  | `updated_at` | `string` | ✅ | — | When the run was last updated (ISO-8601) |
2458
2458
  | `kind` | `string` | ✅ | `draft` | A run launched from a workflow draft via `runWorkflowDraft`. |
@@ -2772,9 +2772,9 @@ Run a published workflow and wait for its result: fires the workflow's trigger a
2772
2772
  | ​ ↳ `durable_run_id` | `string` | ✅ | — | Linked code-substrate-runner run ID. Null until the durable run is created. |
2773
2773
  | ​ ↳ `workflow_version_id` | `string` | ✅ | — | Workflow version the run is bound to |
2774
2774
  | ​ ↳ `status` | `string` | ✅ | `initialized`, `started`, `finished`, `failed`, `cancelled` | Workflow run lifecycle status. `finished` / `failed` / `cancelled` are terminal. |
2775
- | ​ ↳ `input` | `unknown` | ✅ | — | Input passed to the run |
2776
- | ​ ↳ `output` | `unknown` | ✅ | — | Return value, present when status is `finished` |
2777
- | ​ ↳ `error` | `unknown` | ✅ | — | Error payload when status is `failed` (null otherwise) |
2775
+ | ​ ↳ `input` | `unknown` | ❌ | — | Input passed to the run |
2776
+ | ​ ↳ `output` | `unknown` | ❌ | — | Return value, present when status is `finished` |
2777
+ | ​ ↳ `error` | `unknown` | ❌ | — | Error payload when status is `failed` (null otherwise) |
2778
2778
  | ​ ↳ `created_at` | `string` | ✅ | — | When the run was created (ISO-8601) |
2779
2779
  | ​ ↳ `updated_at` | `string` | ✅ | — | When the run was last updated (ISO-8601) |
2780
2780
  | ​ ↳ `trigger_id` | `string` | ✅ | — | Trigger ID of the run (UUID) |
@@ -2814,9 +2814,9 @@ Launch a draft test run: execute the draft's current source without publishing i
2814
2814
  | ​ ↳ `workflow_draft_id` | `string` | ✅ | — | The draft this run was launched from. Becomes null once that draft is deleted — the run outlives its draft. |
2815
2815
  | ​ ↳ `draft_revision` | `number` | ✅ | — | The draft's revision at the moment this run was created. |
2816
2816
  | ​ ↳ `status` | `string` | ✅ | `initialized`, `started`, `finished`, `failed`, `cancelled` | Workflow run lifecycle status. `finished` / `failed` / `cancelled` are terminal. |
2817
- | ​ ↳ `input` | `unknown` | ✅ | — | Input passed to the run |
2818
- | ​ ↳ `output` | `unknown` | ✅ | — | Return value, present when status is `finished` |
2819
- | ​ ↳ `error` | `unknown` | ✅ | — | Error payload when status is `failed` (null otherwise) |
2817
+ | ​ ↳ `input` | `unknown` | ❌ | — | Input passed to the run |
2818
+ | ​ ↳ `output` | `unknown` | ❌ | — | Return value, present when status is `finished` |
2819
+ | ​ ↳ `error` | `unknown` | ❌ | — | Error payload when status is `failed` (null otherwise) |
2820
2820
  | ​ ↳ `created_at` | `string` | ✅ | — | When the run was created (ISO-8601) |
2821
2821
  | ​ ↳ `updated_at` | `string` | ✅ | — | When the run was last updated (ISO-8601) |
2822
2822
 
@@ -2956,30 +2956,48 @@ Validate durable workflow source without publishing it. Returns source diagnosti
2956
2956
 
2957
2957
  **Parameters:**
2958
2958
 
2959
- | Name | Type | Required | Default | Possible Values | Description |
2960
- | -------------------- | -------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------- |
2961
- | `options` | `object` | ✅ | — | — | |
2962
- | ​ ↳ `sourceFiles` | `object` | ✅ | — | — | Exact TypeScript sources keyed by absolute logical path. |
2963
- | ​ ↳ `entrypointFile` | `string` | ❌ | — | — | Absolute logical path of the entry file in sourceFiles. Defaults to /workflow.ts. |
2959
+ | Name | Type | Required | Default | Possible Values | Description |
2960
+ | --------------------------- | -------- | -------- | ------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2961
+ | `options` | `object` | ✅ | — | — | |
2962
+ | ​ ↳ `sourceFiles` | `object` | ✅ | — | — | Exact TypeScript sources keyed by absolute logical path. |
2963
+ | ​ ↳ `entrypointFile` | `string` | ❌ | — | — | Absolute logical path of the entry file in sourceFiles. Defaults to /workflow.ts. |
2964
+ | ​ ↳ `zapierDurableVersion` | `string` | ❌ | — | — | Version of @zapier/zapier-durable the workflow will run on, e.g. "1.2.3". Version checks are skipped when omitted or "latest". |
2965
+ | ​ ↳ `dependencies` | `object` | ❌ | — | — | npm package dependencies keyed by package name. Dependency checks are skipped when omitted. |
2966
+ | ​ ↳ `checkGroups` | `array` | ❌ | — | — | Check groups to run. Runs every group when omitted. Pass only `source` to skip the account lookups, e.g. while code is being edited. |
2967
+ | ​ ↳ `severity` | `string` | ❌ | — | `error`, `warning`, `info`, `hint` | Return only issues with exactly this severity, and skip checks that only report other severities. Returns every issue when omitted. |
2968
+ | ​ ↳ `triggerConfigurations` | `object` | ❌ | — | — | Trigger configurations keyed by trigger node id (`workflow-trigger-{i}`). The trigger isn't in the source, so it's only checked when sent, e.g. `{ "workflow-trigger-0": { "selectedApi": "ScheduleCLIAPI@1.6.0", "action": "everyDay" } }`. |
2969
+ | ​ ↳ `connections` | `object` | ❌ | — | — | Named connection aliases the source uses. Maps each alias to its Zapier connection ID, e.g. `{ "slack": { "connectionId": 123 } }`. Aliases are only checked when sent. |
2964
2970
 
2965
2971
  **Returns:** `Promise<WorkflowValidationItem>`
2966
2972
 
2967
- | Name | Type | Required | Possible Values | Description |
2968
- | ---------------------- | ---------- | -------- | ---------------------------------- | ----------------------------------------------------------------------------------- |
2969
- | `data` | `object` | ✅ | — | |
2970
- | ​ ↳ `issues[]` | `object[]` | ✅ | — | Source diagnostics, or an empty array when validation passes. |
2971
- | ​   ↳ `kind` | `string` | ✅ | — | Extensible diagnostic category; clients must accept unfamiliar values. |
2972
- | ​   ↳ `message` | `string` | ✅ | — | Safe human-readable explanation. |
2973
- | ​   ↳ `severity` | `string` | ✅ | `error`, `warning`, `info`, `hint` | Diagnostic severity. |
2974
- | ​   ↳ `suggestion` | `string` | ❌ | — | Actionable fix hint. |
2975
- | ​   ↳ `source` | `object` | ❌ | — | Affected source location. |
2976
- | ​     ↳ `file_id` | `string` | ✅ | — | Source file containing the diagnostic. |
2977
- | ​     ↳ `start_line` | `number` | ✅ | — | Inclusive 1-based start line. |
2978
- | ​     ↳ `start_column` | `number` | ✅ | — | Inclusive 1-based start column. |
2979
- | ​     ↳ `end_line` | `number` | ✅ | — | Inclusive 1-based end line. |
2980
- | ​     ↳ `end_column` | `number` | ✅ | — | Inclusive 1-based end column. |
2981
- | ​   ↳ `source_excerpt` | `string` | ❌ | — | Source text the diagnostic was raised against, truncated to 240 characters. |
2982
- | ​   ↳ `syntax_kind` | `string` | ❌ | — | TypeScript AST node kind the diagnostic was raised against (e.g. `CallExpression`). |
2973
+ | Name | Type | Required | Possible Values | Description |
2974
+ | -------------------------- | ---------- | -------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2975
+ | `data` | `object` | ✅ | — | |
2976
+ | ​ ↳ `issues[]` | `object[]` | ✅ | — | Source diagnostics, or an empty array when validation passes. |
2977
+ | ​   ↳ `kind` | `string` | ✅ | — | Extensible diagnostic category; clients must accept unfamiliar values. |
2978
+ | ​   ↳ `message` | `string` | ✅ | — | Safe human-readable explanation. |
2979
+ | ​   ↳ `title` | `string` | ❌ | — | Short label for the issue, safe to show in place of `message` where space is short. Omitted for kinds with no title yet; fall back to `message`. |
2980
+ | ​   ↳ `severity` | `string` | ✅ | `error`, `warning`, `info`, `hint` | Diagnostic severity. |
2981
+ | ​   ↳ `suggestion` | `string` | ❌ | — | Actionable fix hint. |
2982
+ | ​   ↳ `fix` | `string` | ❌ | — | Extensible: what resolves the issue. Known values are `agent` (change the source), `upgrade` (change the account's plan) and `retry` (a lookup failed; validate again). Omitted or unknown means `agent`. |
2983
+ | ​   ↳ `incomplete` | `boolean` | ❌ | — | `true` when the issue means the workflow isn't finished yet rather than wrong, e.g. no steps yet. Still blocks publish. |
2984
+ | ​   ↳ `app_key` | `string` | ❌ | — | Implementation id of the app the issue is about, e.g. `SlackCLIAPI`. Set on `admin-restricted-app`. |
2985
+ | ​   ↳ `connection_id` | `string` | ❌ | — | Zapier connection id the issue is about, as a string. Set on connection issues. |
2986
+ | ​   ↳ `connection_alias` | `string` | ❌ | — | Connection alias the source used, a key of the request's `connections`. Set on connection issues when the source named the connection by alias. |
2987
+ | ​   ↳ `unchecked_kind` | `string` | ❌ | — | On `check-unavailable`, the issue kind whose check couldn't run because a lookup failed. Validating again retries it. |
2988
+ | ​   ↳ `source` | `object` | ❌ | — | Affected source location. |
2989
+ | ​     ↳ `file_id` | `string` | ✅ | — | Source file containing the diagnostic. |
2990
+ | ​     ↳ `start_line` | `number` | ✅ | — | Inclusive 1-based start line. |
2991
+ | ​     ↳ `start_column` | `number` | ✅ | — | Inclusive 1-based start column. |
2992
+ | ​     ↳ `end_line` | `number` | ✅ | — | Inclusive 1-based end line. |
2993
+ | ​     ↳ `end_column` | `number` | ✅ | — | Inclusive 1-based end column. |
2994
+ | ​   ↳ `source_excerpt` | `string` | ❌ | — | Source text the diagnostic was raised against, truncated to 240 characters. |
2995
+ | ​   ↳ `syntax_kind` | `string` | ❌ | — | TypeScript AST node kind the diagnostic was raised against (e.g. `CallExpression`). |
2996
+ | ​   ↳ `state_path` | `string` | ❌ | — | Workflow state path the issue is about. |
2997
+ | ​   ↳ `projection_node_id` | `string` | ❌ | — | Diagram node the issue is about. Validation sets it only on trigger issues, to the trigger node id (`workflow-trigger-{i}`). |
2998
+ | ​   ↳ `configuration_id` | `string` | ❌ | — | Canonical configuration reference. Validation currently leaves it unset. |
2999
+ | ​   ↳ `operation_id` | `string` | ❌ | — | Canonical operation that owns the issue, when unambiguous. Match against diagram nodes' `operation_ids` for the same source. |
3000
+ | ​   ↳ `region_id` | `string` | ❌ | — | Immediate canonical parent region of the owning operation. May have no visible container in the diagram. |
2983
3001
 
2984
3002
  **Example:**
2985
3003