callman-core 1.28.0 → 1.28.1

package/ai-packs/scenario-nodes.md

@@ -0,0 +1,451 @@
+<!-- GENERATED FILE — do not edit by hand. Source: callman_core (npm run ai:packs). -->
+
+# Scenario node reference
+
+A scenario is a directed graph: nodes do the work, edges decide what runs next. This reference is for clients that write scenarios through the API or an MCP tool; every rule below is what the server enforces on save or what the run engine does.
+
+## Scenario shape
+
+Compact form (what the MCP scenario tools take):
+
+```json
+{
+  "name": "Order flow",
+  "description": "optional",
+  "priority": "high",
+  "nodes": [
+    {
+      "id": "login",
+      "type": "request",
+      "label": "Login",
+      "config": {
+        "method": "POST",
+        "url": "{{env.baseUrl}}/login"
+      }
+    },
+    {
+      "id": "done",
+      "type": "end",
+      "label": "Done"
+    }
+  ],
+  "edges": [
+    {
+      "source": "login",
+      "target": "done"
+    }
+  ],
+  "environments": [
+    {
+      "name": "Default",
+      "variables": [
+        {
+          "key": "baseUrl",
+          "value": "https://api.example.com"
+        }
+      ]
+    }
+  ]
+}
+```
+
+- Node `{ id?, type, label?, config?, position? }`. `id` defaults to n1, n2, …; `position` is laid out when omitted.
+- `config` is deep-merged over the type's defaults (the Default column): objects merge key by key, arrays and scalars replace the default whole. Send only what you change — but an array you send (headers, checks, steps, rules, assignments) must be complete.
+- Edge `{ id?, source, target, type? }`, `type` = `default` (or omitted) | `yes` | `no` | `error`. Edges have no label.
+- `priority`: critical | high | medium | low. `environments[].variables`: `{ key, value, enabled? }[]`.
+- Stored form (the REST API, and the body of `foreach` / `subscenario` / `scenario-ref`): node `{ id, type, position: { x, y }, data: { label, config } }` with the COMPLETE config — nothing is merged — and edge `{ id, source, target, type? }` with a required `id`.
+
+Req column: **yes** = rejected on save without a real value; **run** = saved, but the run fails without it. Default "(engine)" = applied at run time when the field is absent.
+
+## Connections
+
+db, redis, kafka, notification and ai nodes run on a workspace connection: `config.connectionId` is the id of a connection of type `database`, `redis`, `kafka`, `notification` (Slack) or `ai` (managed). Use a real connection id from the workspace — never invent one. Only the ai node rejects an empty id on save; the others save with `""` and fail when run.
+
+## Labels
+
+- `label` names a node's output: later nodes read `{{Label.path}}`. It is optional on save, but an unlabelled node's output cannot be referenced.
+- Labels must be unique across the whole scenario, including foreach / subscenario bodies: a repeated label is overwritten by whichever node ran last.
+- Reserved labels — the engine drops the output of a node labelled `workflow`, `__meta`, `loop`, `loops`, `item`, `each`, `eaches`, `ws`, so references to it resolve to empty without any error.
+- Avoid labels that are built-in roots — `response`, `lastResponse`, `data`, `env`, `global`, `globals`, `db`, `redis`, `kafkaEvent`, `kafkaevent` — the node and the root shadow each other.
+- Prefer identifier labels (`Login`, `CreateOrder`, `check_db`). Script nodes get a label as a global variable only when it is an identifier and not a sandbox name (`pm`, `env`, `console`, `request`, `response`, `test`, `expect`, `workflow`, `db`, `kafka`, `redis`, …).
+
+## Templates and outputs
+
+- `{{env.KEY}}` / `{{global.KEY}}` read one scope; a bare `{{KEY}}` reads both (in scenario runs a global wins when both define KEY). `{{data.column}}` is the current dataset row.
+- `{{Label.path}}` (or `{Label.path}`) reads an earlier node's output; arrays by index (`items[0].id`), no wildcards. `{{response.*}}` is the most recent request's response. Generators: `{{$randomUUID}}`, `{{$timestamp}}`, `{{random.email}}`, `{{counter}}`.
+- Substitution is plain text — quote SQL strings yourself (`WHERE id = '{{userId}}'`). A missing value resolves to an empty string.
+- A request's output: `<Label>.status` is the HTTP status (number). Read body fields through `<Label>.body.<path>`: top-level body keys are also spread onto the output, but `status`, `statusText`, `data`, `body`, `rawBody`, `text`, `headers`, `cookies`, `durationMs` are HTTP metadata and win over same-named body keys. `<Label>.data.<path>` reads a body's top-level `data`.
+- Operand paths (rules, `foreach.itemsPath`, set-vars `source`) are BARE dotted paths without braces: `CreateOrder.body.total`, `CheckOrder.rows[0].status`.
+
+## Rules and operands
+
+Shared by condition, assertion, poll, websocket expect steps and `end.loopExitRule`.
+
+- Rule `{ id, type: "rule", left, operator, right? }` — `id` and `type: "rule"` are required; `right` is required unless the operator is unary.
+- Group `{ id, type: "group", operator: "AND" | "OR", children: [Rule | Group, …] }` with at least one child.
+- Operand `{ mode: "runtime" | "literal", valueType: "string" | "number" | "boolean" | "null" | "array", value, extract? }`. runtime: `value` is a bare path. literal: a JSON number for number, true/false for boolean, null for null, a JSON array for array.
+- Binary operators: equals, not_equals, strict_equals, strict_not_equals, greater_than, less_than, greater_or_equal, less_or_equal, between, contains, not_contains, starts_with, ends_with, regex, in, not_in, contains_row, set_equals_unordered. `between` takes [min, max]; `in` / `not_in` an array; `regex` a JS regex source; `contains_row` checks that an array of rows has one matching every key of an object (a JSON-object string literal or a runtime path); `set_equals_unordered` compares two arrays as multisets.
+- Unary operators (no `right`): exists, not_exists, is_empty, not_empty, is_null, not_null.
+- `extract` `{ type: "jsonpath" | "regex", expression, flags?, group?, select?: "first" | "all" }` is applied to the resolved value first; a failed extraction behaves as not-exists.
+
+Example: `{ "id": "r1", "type": "rule", "left": { "mode": "runtime", "valueType": "number", "value": "CreateOrder.status" }, "operator": "equals", "right": { "mode": "literal", "valueType": "number", "value": 201 } }`
+
+## Contract rules
+
+Each rule's `rules` object may use ONLY these keys (omit the rest):
+- common: required(bool), type(string|number|boolean|object|array|null), equals(string|number|bool), notEmpty(bool)
+- number: min,max,greaterThan,lessThan(number); integer,positive,negative,nonZero(bool)
+- string: minLength,maxLength(int); pattern,contains,notContains,startsWith,endsWith(string); caseSensitive(bool); enumValues(array); format(enum)
+- array: minItems,maxItems(int); sorted({order:asc|desc,field?}); unique({mode:whole|byField,fields?})
+- object: requiredKeys,forbiddenKeys(string[]); minProperties,maxProperties(int); strictSchema(bool)
+- format values: email, url, uuid, uuidV1, uuidV4, uuidV7, jwt, base64, base64url, base64Pdf, base64Png, base64Jpeg, base64Gif, base64Webp, base64Image, base64Zip, base64Office, datetime, date, time, ipv4, ipv6, hostname, json, numeric, integer, alpha, alphanumeric, hex, hexColor, slug, semver, objectId, creditCard, phone
+
+## Execution policy
+
+Every node except condition takes `executionPolicy: { onFailure: "stop" | "continue", retry: { enabled, maxAttempts (0..100), delayMs (0..3600000), backoffMultiplier? (1..10), maxDelayMs? (0..3600000) } }` — onFailure and retry.enabled / maxAttempts / delayMs are required when you send the stored form.
+- `maxAttempts` counts every attempt (an enabled retry makes at least 2). Delay before retry n = min(maxDelayMs, delayMs × backoffMultiplier^(n−1)). No policy = stop, no retry.
+- stop: a failure ends the run; continue: the run goes on along the normal edges.
+- `error` edges from the failing node win over both: the run follows them instead of the normal edges (after the retries).
+
+## Node types
+
+### request
+One HTTP call.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `method` | string | `"GET"` |  | HTTP verb. |
+| `url` | string (≤10000) | `""` | run | Absolute URL; `{{…}}` allowed. Its own `?query` is used only when `query` has no enabled rows. |
+| `headers` | {key, value, enabled?}[] | `[]` |  | Disabled rows are not sent. A Content-Type row beats the automatic one (formdata always uses the driver's multipart type). |
+| `query` | {key, value, enabled?}[] | `[]` |  |  |
+| `body.mode` | none \| raw \| formdata \| urlencoded | `"none"` |  |  |
+| `body.raw` | string | `""` |  | mode raw. JSON text that still parses after templating is sent as JSON. |
+| `body.rawLanguage` | json \| xml \| text \| html | — |  | With no Content-Type header, sets application/json, application/xml, text/plain or text/html (json when absent). |
+| `body.formEntries` | {key, value, enabled?, type?, fixtureId?, fileName?}[] | `[]` |  | formdata / urlencoded rows. A `type:"file"` row needs `fixtureId` (an uploaded workspace fixture file) — server runs fail it otherwise. |
+| `auth.type` | none \| bearer \| basic \| apikey \| oauth2 | `"none"` |  |  |
+| `auth.bearerToken` | string | `""` |  | bearer → `Authorization: Bearer <token>`. |
+| `auth.basicUsername / auth.basicPassword` | string | `""` |  | basic → base64 `user:password`. |
+| `auth.apiKeyKey / auth.apiKeyValue` | string | `""` |  | apikey → sends `key: value`; skipped when the key is blank. |
+| `auth.apiKeyLocation` | header \| query | `"header"` |  |  |
+| `auth.oauth2` | {grantType, tokenUrl, clientId, clientSecret, scope, username, password, refreshToken, clientAuth, audience} | — |  | oauth2: when present ALL ten keys are required (send "" for unused ones); grantType client_credentials \| password \| refresh_token; clientAuth basic \| body. The token is fetched (and cached) before the call and sent as a Bearer header. Without it, type oauth2 sends no Authorization. |
+| `preRequestScript / postResponseScript / testsScript` | string | `""` |  | `pm.*` scripts: before the call / after the response / assertions (`pm.test`). |
+| `contractAssertions` | {id, path, enabled, rules, engine?, namespaces?}[] (≤200) | `[]` |  | id, path, enabled and rules are required; `rules` needs ≥1 key (see Contract rules). `path` is a dot-path over the parsed body (`data.items[0].id`, `items[].id` = every element); with engine "xpath" it is an XPath over the raw XML and every prefix must be in `namespaces` {prefix: uri}. |
+| `expectedStatus` | string (≤200) | — |  | Negative testing: `"201"`, `"4xx"`, `"200-299"`, `"200,204"`, templates allowed. When set the node passes iff the status matches (instead of 2xx/3xx); contract assertions and test scripts can still fail it. |
+| `responseSchema` | JSON Schema object | — |  | Validated against the response body; a mismatch fails the node. |
+| `clientCertificate` | {enabled, format, pfxBase64?, certPem?, keyPem?, passphrase?, caPem?, rejectUnauthorized?} | — |  | mTLS. enabled and format ("pfx" \| "pem") are required; pfx uses pfxBase64, pem uses certPem + keyPem. Server runs present the certificate whenever this object is set — omit it to send none. |
+| `soap` | {enabled, version, action?, wsSecurity?} | — |  | version "1.1" \| "1.2". Keep the full envelope in body.raw (rawLanguage "xml"); Content-Type/SOAPAction come from the version (a Content-Type header wins). wsSecurity {enabled, username, password, passwordType: text \| digest} injects a UsernameToken at send time. |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: `<Label>.status` (number), `<Label>.body.<path>`, `<Label>.headers`, `<Label>.text`, `<Label>.durationMs`. The most recent request is also `response.*`.
+
+```json
+{"id":"login","type":"request","label":"Login","config":{"method":"POST","url":"{{env.baseUrl}}/login","body":{"mode":"raw","raw":"{\"user\":\"{{env.user}}\",\"password\":\"{{env.password}}\"}","rawLanguage":"json"},"expectedStatus":"200"}}
+```
+
+### db
+One query on a workspace connection of type `database`.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `connectionId` | string | `""` | run | `""` = not chosen yet: saved, but the run fails. |
+| `query` | string (1..100000) | `"SELECT *\nFROM users\nWHERE id = {{env.userId}}"` | yes | Mongo: a JSON command-object string (`{"collection":"orders","operation":"findOne","filter":{…}}`); SQL: plain SQL. Per-engine details: the DB query reference. The default is a placeholder — always send your own. |
+| `params` | string[] (≤200) | — |  | Positional binds, template-resolved: `$1` (Postgres), `?` (MySQL), `@p1…` (SQL Server). |
+| `typedParams` | {value, type?}[] (≤200) | — |  | Wins over params. type auto \| text \| int \| numeric \| boolean \| date \| timestamp \| json \| null: null binds SQL NULL, boolean a real boolean, the rest stay strings (cast in SQL). |
+| `useSession` | boolean | — |  | Postgres only: join the run's shared session (scenario-level `dbSettings.transactionMode`: none \| rollback \| commit). |
+| `expectError` | {sqlState?, messagePattern?} | — |  | Negative test: the node passes only if the query FAILS with that SQLSTATE and/or a message matching the regex. |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: `<Label>.rows`, `<Label>.rowCount`; the rows are also `db.result`.
+
+```json
+{"id":"check","type":"db","label":"CheckOrder","config":{"connectionId":"<database connection id>","query":"SELECT status FROM orders WHERE id = $1","params":["{{CreateOrder.body.id}}"]}}
+```
+
+### redis
+Redis commands on a workspace connection of type `redis`.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `connectionId` | string | `""` | run |  |
+| `commands` | string[] (≤1000, each non-empty) | `[]` | run | One command per entry, template-resolved. Supported: GET, SET, DEL, EXISTS, TTL, HGET, HSET, HGETALL, HDEL, LPUSH, RPUSH, LRANGE, LLEN, SADD, SMEMBERS, SISMEMBER, INCR, DECR, INCRBY, EXPIRE, PERSIST, TYPE, ZADD, ZRANGE, ZSCORE, SCAN. `SCAN pattern [count]` returns {keys, count, truncated}. An empty list fails the run. |
+| `executionPolicy` | ExecutionPolicy | continue, retry ×2 every 1000 ms |  | See Execution policy. |
+
+Output: The reply (one command) or an array of replies, as `<Label>` and `redis.result`.
+
+```json
+{"id":"cache","type":"redis","label":"Cache","config":{"connectionId":"<redis connection id>","commands":["GET order:{{CreateOrder.body.id}}"]}}
+```
+
+### kafka
+Consume (wait for a matching message) or publish, on a connection of type `kafka`.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `connectionId` | string | `""` | run |  |
+| `topic` | string (1..500) | `""` | yes |  |
+| `mode` | consume \| publish | `"consume"` |  |  |
+| `matchMode` | regex \| rules | `"regex"` |  | consume. |
+| `rules` | string[] | `[]` |  | consume. regex: rules[0] is a regex tested against the whole message. rules: every entry is ONE comparison `left op right` (op ==, !=, ===, !==, >, <, >=, <=, contains) and all must hold, e.g. `kafkaEvent.orderId == '{{CreateOrder.body.id}}'`. Empty = the first message captured. |
+| `publishValueFormat` | json \| raw | `"json"` |  | publish. json fails the node when messageValue is not valid JSON after templating. |
+| `messageKey` | string | `""` |  | publish. |
+| `messageValue` | string (≤1000000) | `""` |  | publish payload, template-resolved. |
+| `messageHeaders` | {key, value, enabled?}[] | `[]` |  | publish. |
+| `executionPolicy` | ExecutionPolicy | continue, retry ×3 every 2000 ms |  | See Execution policy. |
+
+Output: consume: the matched message — a JSON message's keys at the top level plus `meta` {value, text, key, partition, offset, timestamp, headers}; also `kafkaEvent.*`.
+
+```json
+{"id":"event","type":"kafka","label":"OrderCreated","config":{"connectionId":"<kafka connection id>","topic":"orders","mode":"consume","matchMode":"rules","rules":["kafkaEvent.orderId == '{{CreateOrder.body.id}}'"]}}
+```
+
+### condition
+The only branching node and the only node without `executionPolicy`. Needs exactly two outgoing edges: one `yes`, one `no`.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `mode` | builder \| expert | `"builder"` |  |  |
+| `rootGroup` | Group | one rule: `response.status` equals `200` |  | Evaluated in builder mode (see Rules and operands). Stored in both modes. |
+| `expertExpression` | string \| null | `"{{response.status}} == 200"` |  | Used ONLY with `mode: "expert"` (ignored otherwise). Syntax below. |
+
+Output: Takes the `yes` or `no` edge.
+
+Expert syntax: operands are `{{path}}` tokens (a bare path is a parse error), 'single'- or "double"-quoted strings, numbers, true / false / null and [arrays]; operators ==, !=, ===, !==, >, <, >=, <=, contains, not contains, starts with, ends with, regex, in, not in, between, exists, not exists, is empty, not empty, is null, not null, contains row, set equals; combine with && / AND, || / OR and parentheses. Example: `{{Login.status}} == 200 && {{Login.body.token}} != ''`.
+
+```json
+{"id":"ok","type":"condition","label":"LoggedIn","config":{"mode":"builder","rootGroup":{"id":"g1","type":"group","operator":"AND","children":[{"id":"r1","type":"rule","left":{"mode":"runtime","valueType":"number","value":"Login.status"},"operator":"equals","right":{"mode":"literal","valueType":"number","value":200}}]}}}
+```
+
+### assertion
+Pass/fail checkpoint; does not branch (on failure the execution policy decides).
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `matchMode` | all \| any | `"all"` |  |  |
+| `checks` | {id, name, enabled, rule}[] (≤1000) | one blank check | run | id, name (may be ""), enabled and rule are required; `rule` is a full Rule. With no enabled check the node passes without testing anything — send at least one. |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: `<Label>.passed`, `.passedCount`, `.failedCount`, `.checks[i]` {name, passed, message}.
+
+```json
+{"id":"verify","type":"assertion","label":"VerifyOrder","config":{"checks":[{"id":"c1","name":"total is 40","enabled":true,"rule":{"id":"c1r","type":"rule","left":{"mode":"runtime","valueType":"number","value":"CreateOrder.body.total"},"operator":"equals","right":{"mode":"literal","valueType":"number","value":40}}}]}}
+```
+
+### script
+JavaScript in the `pm.*` sandbox.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `script` | string (≤1000000) | `"return {\n  ok: true,\n};"` | run | Its `return` value is the node's output. Can `pm.environment.set`, `pm.test`, `await pm.db.query(…)` / `pm.redis.command(…)`. Empty or invalid code fails the run. |
+| `timeoutMs` | integer 1..60000 | `3000` |  | Also capped by the host's per-node timeout. |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: The returned value (`<Label>.<key>` for an object).
+
+```json
+{"id":"calc","type":"script","label":"Totals","config":{"script":"const body = CreateOrder.body;\nreturn { total: body.total * 2 };"}}
+```
+
+### set-vars
+Write environment/global variables without a script. Rows apply top to bottom (a row sees earlier rows' writes).
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `assignments` | Assignment[] (≤200) | one blank row |  |  |
+| `assignments[].id / .key / .value` | string | — | yes | key and value are template-resolved; value may be "". |
+| `assignments[].scope` | environment \| global | — | yes |  |
+| `assignments[].enabled` | boolean | — | yes |  |
+| `assignments[].extractorType` | template \| jsonpath \| regex | — |  | jsonpath / regex: resolve `source` (a bare runtime path such as `CreateOrder.body`), then apply `expression` (JSONPath like `$.items[0].id`, or a JS regex source); `value` is ignored. Regex rows take `flags` (subset of gimsuy) and `group`; `select` first \| all (all writes a JSON array). A failed extraction skips that write. |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: `<Label>.environment` / `<Label>.globals` (what was written), `<Label>.extraction` for extractor rows.
+
+```json
+{"id":"save","type":"set-vars","label":"SaveOrderId","config":{"assignments":[{"id":"a1","scope":"environment","key":"orderId","value":"{{CreateOrder.body.id}}","enabled":true}]}}
+```
+
+### poll
+Repeat ONE embedded action until a condition passes or the budget runs out. Retry is forced off (the loop is the retry); a failing tick is retried, not fatal.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `actionType` | request \| db \| redis \| script | `"request"` |  |  |
+| `request / db / redis / script` | that node type's config | request: the request defaults | run | The one matching actionType. Same fields as the standalone node. |
+| `successCondition` | {mode, rootGroup, expertExpression?} | `response.status` equals `200` |  | Evaluated after every successful tick. A tick publishes like the real node: request → `response.*`, db → `db.result` (rows), redis → `redis.result`; a script tick exposes only its variable writes (`env.*`, `global.*`). |
+| `intervalMs` | integer 0..3600000 | `2000` |  |  |
+| `maxAttempts` | integer 1..1000 | `30` |  |  |
+| `timeoutMs` | integer 1..86400000 | — |  | Wall-clock cap. |
+| `backoffMultiplier` | number 1..10 | — |  | Exponential backoff on the interval. |
+| `maxDelayMs` | integer 0..3600000 | — |  | Backoff cap. |
+| `onTimeout` | fail \| continue | `"fail"` |  | continue marks the node degraded and goes on. |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: `<Label>.attempts`, `.elapsedMs`, `.timedOut`, `.conditionResult`, `.lastTickError`; the last tick's result as listed above.
+
+```json
+{"id":"wait-ready","type":"poll","label":"WaitReady","config":{"actionType":"request","request":{"url":"{{env.baseUrl}}/orders/{{CreateOrder.body.id}}"},"successCondition":{"mode":"expert","expertExpression":"{{response.body.status}} == 'READY'"},"intervalMs":2000,"maxAttempts":15}}
+```
+
+### foreach
+Run an embedded body graph once per item of an array.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `nodes / edges` | stored node[] / stored edge[] | `[]` |  | The body graph in the STORED form with complete configs (see Scenario shape) — no defaults are merged inside. Same graph rules; labels unique across the whole scenario. |
+| `sourceMode` | path \| inline | `"path"` |  |  |
+| `itemsPath` | string (≤2000) | — | run | path mode: a bare runtime path to an array, e.g. `Users.body.items`. |
+| `itemsInline` | string | — | run | inline mode: JSON array text; templates resolve first. |
+| `itemAlias` | string (≤100) | — |  | Extra root mirroring `{{item}}` (e.g. `user` → `{{user.id}}`). Not a reserved label. |
+| `maxIterations` | integer 1..1000 | 100 (engine) |  |  |
+| `delayMs` | integer 0..3600000 | — |  | Pause between items. |
+| `onItemFailure` | stop \| continue | `"stop"` |  | continue: failed items degrade the run, the loop goes on. |
+| `collectResults` | boolean | `true` |  |  |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: `<Label>.results[i].<ChildLabel>…`, `.itemCount`, `.processedCount`, `.truncated`, `.failedItems`. Inside the body: `{{item}}`, `{{each.index}}` (0-based), `{{each.iteration}}` (1-based), `{{each.total}}`, `{{each.remaining}}`, `{{eaches.<ForeachLabel>.iteration}}` for an outer loop.
+
+```json
+{"id":"each-user","type":"foreach","label":"EachUser","config":{"sourceMode":"path","itemsPath":"Users.body.items","itemAlias":"user","nodes":[{"id":"get-user","type":"request","position":{"x":0,"y":0},"data":{"label":"GetUser","config":{"method":"GET","url":"{{env.baseUrl}}/users/{{user.id}}","headers":[],"query":[],"body":{"mode":"none","raw":"","formEntries":[]}}}}],"edges":[]}}
+```
+
+### websocket
+One WebSocket conversation: connect, run the steps in order, close. Retry re-runs the whole conversation.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `url` | string (≤2000) | `""` | run | ws:// or wss://, template-resolved. |
+| `headers` | {key, value, enabled?}[] (≤100) | `[]` |  |  |
+| `subprotocols` | string[] (≤20) | `[]` |  |  |
+| `connectTimeoutMs` | integer 100..120000 | 10000 (engine) |  |  |
+| `steps` | Step[] (≤200) | `[]` |  | {id, kind:"send", payload} sends one text frame; {id, kind:"expect", rules (1..50 Rules), timeoutMs? (100..300000, default 10000), matchMode? all \| any} waits for a matching frame — rule paths use `ws.text`, `ws.json.<path>`, `ws.direction`, `ws.index`; {id, kind:"wait", durationMs (0..300000)}. A timed-out expect fails the node. |
+| `closeCode` | integer 1000..4999 | 1000 (engine) |  |  |
+| `rejectUnauthorized` | boolean | — |  | false accepts self-signed certificates. |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: `<Label>.connected`, `.messages[i].text`, `.messageCount`, `.failedSteps`, `.closeCode`.
+
+```json
+{"id":"ws","type":"websocket","label":"Subscribe","config":{"url":"wss://stream.example.com/orders","steps":[{"id":"s1","kind":"send","payload":"{\"subscribe\":\"orders\"}"},{"id":"s2","kind":"expect","rules":[{"id":"s2r","type":"rule","left":{"mode":"runtime","valueType":"string","value":"ws.json.event"},"operator":"equals","right":{"mode":"literal","valueType":"string","value":"subscribed"}}]}]}}
+```
+
+### ai
+One LLM call on a managed workspace connection of type `ai`.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `connectionId` | string (1..200) | `""` | yes | The default `""` is rejected on save. |
+| `prompt` | string (≤200000) | `""` | run | Template-resolved; empty fails the run. |
+| `responseExample` | string (≤20000) | `""` | run | A JSON OBJECT as text; its top-level keys are required in the reply (extra keys allowed). |
+| `maxTokens` | integer 1..32000 | 2000 (engine) |  |  |
+| `timeoutMs` | integer 1000..300000 | 60000 (engine) |  |  |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: The parsed JSON reply: `<Label>.<exampleKey>`.
+
+```json
+{"id":"classify","type":"ai","label":"Classify","config":{"connectionId":"<ai connection id>","prompt":"Classify the sentiment of: {{GetReview.body.text}}","responseExample":"{\"sentiment\":\"positive\",\"score\":0.9}"}}
+```
+
+### wait
+Fixed delay.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `durationMs` | integer 1..2147483647 | `5000` |  |  |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: `<Label>.configuredDurationMs`, `.actualDurationMs`, `.status`.
+
+```json
+{"id":"pause","type":"wait","label":"Pause","config":{"durationMs":1000}}
+```
+
+### notification
+Slack message through a workspace connection of type `notification`.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `provider` | "slack" | `"slack"` |  |  |
+| `connectionId` | string | `""` | run |  |
+| `severity` | info \| success \| warning \| error | `"info"` |  |  |
+| `messageTemplate` | string (≤100000) | a run-status line |  | Template-resolved (node outputs, `{{workflow.name}}`, `{{workflow.__meta.status}}` …). |
+| `channelOverride` | string (≤500) | `""` |  |  |
+| `continueOnFailure` | boolean | `true` |  | Overrides executionPolicy.onFailure (true = continue). |
+| `advanced.useRichBlocks` | boolean | `true` |  |  |
+| `executionPolicy` | ExecutionPolicy | continue, no retry |  | See Execution policy. |
+
+Output: The delivery result.
+
+```json
+{"id":"notify","type":"notification","label":"Notify","config":{"connectionId":"<notification connection id>","severity":"warning","messageTemplate":"Order {{CreateOrder.body.id}} is not ready"}}
+```
+
+### aggregator
+Build one JSON object from earlier outputs.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `template` | string (≤1000000) | `"{\n  \"key\": \"{Label.field}\"\n}"` | run | Must be valid JSON after templating (`{{Label.path}}` or `{Label.path}` tokens), else the run fails. |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: The parsed object: `<Label>.<key>`.
+
+```json
+{"id":"summary","type":"aggregator","label":"Summary","config":{"template":"{\"orderId\":\"{{CreateOrder.body.id}}\",\"status\":\"{{CheckOrder.rows[0].status}}\"}"}}
+```
+
+### end
+Terminates a path; optionally loops back to an earlier node.
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `loop` | boolean | `false` |  |  |
+| `loopTargetNodeId` | string \| null | `null` | run | loop: the id of an earlier node to jump back to. |
+| `loopIterations` | integer 1..1000 | `1` |  | Re-entries: the looped section runs loopIterations + 1 times. |
+| `loopDelayMs` | integer 0..600000 | `1000` |  |  |
+| `loopExitRule` | Rule \| null | — |  | Checked after each pass; TRUE stops the loop early and continues along the end node's outgoing edges. Loop roots: `loop.iteration` (1-based), `loop.index`, `loop.total`, `loop.remaining`. |
+| `executionPolicy` | ExecutionPolicy | stop, no retry |  | See Execution policy. |
+
+Output: A snapshot of the run's outputs so far.
+
+```json
+{"id":"again","type":"end","label":"Repeat","config":{"loop":true,"loopTargetNodeId":"login","loopIterations":2,"loopDelayMs":500}}
+```
+
+### subscenario
+A group of nodes collapsed into one node (the builder's Group).
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `nodes / edges` | stored node[] / stored edge[] | none | yes | Stored form, complete configs; no defaults are merged for this type. Same graph rules. |
+| `reusableGroupId / reusableSourceScenarioId / reusableSourceNodeId / ungroupSnapshot` | app-managed | — |  | Written by the builder; omit them. |
+| `executionPolicy` | ExecutionPolicy | stop, no retry (engine) |  | See Execution policy. |
+
+Output: Its inner nodes publish under their own labels.
+
+```json
+{"id":"setup","type":"subscenario","label":"Setup","config":{"nodes":[{"id":"seed","type":"wait","position":{"x":0,"y":0},"data":{"label":"Settle","config":{"durationMs":500}}}],"edges":[]}}
+```
+
+### scenario-ref
+A reference to another scenario, embedded as a synced snapshot. Created by the app when a scenario is linked; the compact form cannot create or re-send one (in the stored form, send it back exactly as read).
+
+| Field | Type | Default | Req | Notes |
+| --- | --- | --- | --- | --- |
+| `referencedScenarioId` | string | — | yes |  |
+| `referencedScenarioVersion` | integer \| null | — | yes |  |
+| `referencedScenarioName / lastSyncedAt` | string | — | yes |  |
+| `nodes / edges` | stored node[] / stored edge[] | — | yes | The referenced scenario's graph snapshot. |
+| `executionPolicy` | ExecutionPolicy | stop, no retry (engine) |  | See Execution policy. |
+
+Output: Its inner nodes publish under their own labels.
+
+## Graph rules
+
+Rejected on save:
+- Node ids unique; edge ids unique; every edge's source and target is an existing node id.
+- `yes` / `no` edges only leave a condition node; `error` edges only leave a non-condition node; omit `type` (or `default`) for normal flow.
+- A condition node has exactly two outgoing edges: one `yes`, one `no`.
+- At least one start node (a node with no incoming edge) and no cycles — loop with an end node's `loop` settings, never with a back edge.
+- foreach / subscenario / scenario-ref bodies are checked with the same rules.
+
+Saved with a warning: more than one start node; nodes no start node reaches.

package/dist/ai/index.d.ts

@@ -6,6 +6,7 @@ export { buildUnifiedSystemPrompt, buildUnifiedUserPrompt } from "./prompts/unif
 export { buildDiagramSystemPrompt, buildDiagramUserPrompt } from "./prompts/diagram.js";
 export { buildScenarioSystemPrompt, buildScenarioUserPrompt, SCENARIO_AI_REFERENCE_TYPES, type BuildScenarioSystemPromptOptions, } from "./prompts/scenario.js";
 export { defaultScenarioNodeConfig, SCENARIO_NODE_DEFAULT_CONFIGS, } from "./prompts/scenarioNodeDefaults.js";
+export { renderScenarioNodeReference, SCENARIO_NODE_REFERENCE_TYPES, type RenderScenarioNodeReferenceOptions, } from "./prompts/scenarioNodeReference.js";
 export { isRecord as isAiRecord, parseEnvelope, scriptHasSyntaxError } from "./parse/shared.js";
 export { parseAiUnifiedOutput, type ParseAiUnifiedOptions } from "./parse/unified.js";
 export { parseAiDiagramOutput } from "./parse/diagram.js";

package/dist/ai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAOA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,EAC3B,KAAK,gCAAgC,GACtC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAOA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,EAC3B,KAAK,gCAAgC,GACtC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,kCAAkC,GACxC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/ai/index.js

@@ -12,6 +12,7 @@ export { buildUnifiedSystemPrompt, buildUnifiedUserPrompt } from "./prompts/unif
 export { buildDiagramSystemPrompt, buildDiagramUserPrompt } from "./prompts/diagram.js";
 export { buildScenarioSystemPrompt, buildScenarioUserPrompt, SCENARIO_AI_REFERENCE_TYPES, } from "./prompts/scenario.js";
 export { defaultScenarioNodeConfig, SCENARIO_NODE_DEFAULT_CONFIGS, } from "./prompts/scenarioNodeDefaults.js";
+export { renderScenarioNodeReference, SCENARIO_NODE_REFERENCE_TYPES, } from "./prompts/scenarioNodeReference.js";
 export { isRecord as isAiRecord, parseEnvelope, scriptHasSyntaxError } from "./parse/shared.js";
 export { parseAiUnifiedOutput } from "./parse/unified.js";
 export { parseAiDiagramOutput } from "./parse/diagram.js";

package/dist/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,0EAA0E;AAC1E,8EAA8E;AAC9E,2EAA2E;AAC3E,wEAAwE;AACxE,wEAAwE;AAExE,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,GAE5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAA8B,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,0EAA0E;AAC1E,8EAA8E;AAC9E,2EAA2E;AAC3E,wEAAwE;AACxE,wEAAwE;AAExE,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,GAE5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAE9B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAA8B,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/ai/prompts/scenario.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../../src/ai/prompts/scenario.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMvD,eAAO,MAAM,2BAA2B,iLAiB9B,CAAC;AAwCX,MAAM,WAAW,gCAAgC;IAC/C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC9C;AAqBD,eAAO,MAAM,yBAAyB,GACpC,UAAS,gCAAqC,KAC7C,MAwFW,CAAC;AAEf,eAAO,MAAM,uBAAuB,GAAI,OAAO,mBAAmB,KAAG,MA+CpE,CAAC"}
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../../src/ai/prompts/scenario.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAOvD,eAAO,MAAM,2BAA2B,iLAiB9B,CAAC;AAwCX,MAAM,WAAW,gCAAgC;IAC/C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC9C;AAqBD,eAAO,MAAM,yBAAyB,GACpC,UAAS,gCAAqC,KAC7C,MAwFW,CAAC;AAEf,eAAO,MAAM,uBAAuB,GAAI,OAAO,mBAAmB,KAAG,MA+CpE,CAAC"}

package/dist/ai/prompts/scenario.js

@@ -14,6 +14,7 @@
 import { REDIS_COMMAND_SPECS } from "../../host/redis/redisService.js";
 import { renderDbQueryReference } from "../../host/db/db-query-reference.js";
 import { defaultScenarioNodeConfig } from "./scenarioNodeDefaults.js";
+import { RESERVED_SCENARIO_LABELS } from "../../scenario-runner/labels.js";
 // Types shown in the reference. `subscenario` + `scenario-ref` are intentionally
 // omitted — they are advanced/nested and `scenario-ref` can't be spawned blank;
 // the model is told to avoid them.
@@ -46,9 +47,9 @@ const NODE_NOTES = {
     // Supported command list is derived from the runtime specs so it can
     // never drift from what the runtime actually accepts.
     `Run Redis commands on a stored connection. REQUIRED: connectionId (type=redis) + ≥1 non-empty entry in \`commands\`. Each entry is ONE command string; supported commands: ${Object.keys(REDIS_COMMAND_SPECS).join(", ")} — e.g. "GET order:{{CreateOrder.orderId}}", "HGETALL user:{{env.userId}}" or "SET key {{env.value}}". SCAN is Callman-managed: \`SCAN pattern [count]\` returns {keys,count,truncated}. Output exposed under the label + as redis.result.`,
-    kafka: "Consume OR publish (config.mode). CONSUME (mode:\"consume\"): REQUIRED connectionId (type=kafka) + topic + a matcher with ≥1 non-empty rule. TWO matchModes: (a) matchMode:\"regex\" → rules[0] is a single REGEX tested against the whole message, e.g. rules:[\"order.created\"]. (b) matchMode:\"rules\" → rules is a LIST OF EXPRESSIONS (expert-condition syntax), ALL must be true. Reference the captured event as kafkaEvent.<field>: for a JSON message its JSON keys are top-level, e.g. rules:[\"kafkaEvent.event == 'order.created'\", \"kafkaEvent.orderId == '{{CreateOrder.orderId}}'\"]. NEVER leave rules empty. PUBLISH (mode:\"publish\"): REQUIRED connectionId + topic + messageValue; optional messageKey, publishValueFormat \"json\"|\"raw\" (json validates the payload as JSON), messageHeaders:[{key,value,enabled:true}].",
-    condition: "The ONLY branching node and the ONLY node WITHOUT executionPolicy. Must have EXACTLY one outgoing edge type \"yes\" and one \"no\". TWO modes: mode:\"builder\" (default) uses rootGroup { operator:\"AND\"|\"OR\", children:[ rule | nested group ] } where each rule is { id, type:\"rule\", left, operator, right } (operands per the OPERANDS section); mode:\"expert\" uses expertExpression, a single string like \"response.status == 200 && {Login.token} != ''\". Prefer builder mode.",
-    assertion: "Pass/fail checkpoint (does NOT branch; on failure executionPolicy decides stop/continue). config.matchMode:\"all\" (every enabled check passes) | \"any\" (≥1 passes). checks:[{ id, name, enabled:true, rule }] with ≥1 enabled check — each rule is { left, operator, right } (operands per the OPERANDS section).",
+    kafka: "Consume OR publish (config.mode). CONSUME (mode:\"consume\"): REQUIRED connectionId (type=kafka) + topic + a matcher with ≥1 non-empty rule. TWO matchModes: (a) matchMode:\"regex\" → rules[0] is a single REGEX tested against the whole message, e.g. rules:[\"order.created\"]. (b) matchMode:\"rules\" → rules is a LIST OF EXPRESSIONS, each ONE comparison `left op right` (op ==, !=, ===, !==, >, <, >=, <=, contains), ALL must be true. Reference the captured event as kafkaEvent.<field>: for a JSON message its JSON keys are top-level, e.g. rules:[\"kafkaEvent.event == 'order.created'\", \"kafkaEvent.orderId == '{{CreateOrder.orderId}}'\"]. NEVER leave rules empty. PUBLISH (mode:\"publish\"): REQUIRED connectionId + topic + messageValue; optional messageKey, publishValueFormat \"json\"|\"raw\" (json validates the payload as JSON), messageHeaders:[{key,value,enabled:true}].",
+    condition: "The ONLY branching node and the ONLY node WITHOUT executionPolicy. Must have EXACTLY one outgoing edge type \"yes\" and one \"no\". TWO modes: mode:\"builder\" (default) uses rootGroup { operator:\"AND\"|\"OR\", children:[ rule | nested group ] } where each rule is { id, type:\"rule\", left, operator, right } (operands per the OPERANDS section); mode:\"expert\" uses expertExpression (ONLY read when mode is \"expert\"), a single string whose operands are {{path}} tokens — a bare path is a parse error — like \"{{Login.status}} == 200 && {{Login.body.token}} != ''\". Prefer builder mode.",
+    assertion: "Pass/fail checkpoint (does NOT branch; on failure executionPolicy decides stop/continue). config.matchMode:\"all\" (every enabled check passes) | \"any\" (≥1 passes). checks:[{ id, name, enabled:true, rule }] with ≥1 enabled check — each rule is { id, type:\"rule\", left, operator, right } (operands per the OPERANDS section).",
     script: "JS sandbox (Postman pm.*). REQUIRED: non-empty, syntactically-valid `script`; its `return` value is exposed downstream by the node label. Optional timeoutMs (default 3000). Can pm.environment.set(...), pm.expect(...), pm.test(...), and await pm.db.query / pm.redis.command (same formats as the DB & REDIS section) for logic a plain db/redis node can't express.",
     "set-vars": "No-code variable capture — prefer this over a script node for plain \"save X into a variable\" steps. config.assignments:[{ id, scope:\"environment\"|\"global\", key, value, enabled:true }] applied top-to-bottom (a later row can use an earlier row's variable). DEFAULT (template) row: `value` is template-resolved, e.g. \"{{CreateOrder.body.id}}\". EXTRACTOR row: add extractorType:\"jsonpath\"|\"regex\" + source + expression (`value` is then ignored). `source` is a BARE runtime dot-path WITHOUT braces (same semantics as condition operands), e.g. \"CreateOrder.body\". `expression` is a JSONPath like \"$.items[0].id\" or a JS regex source like \"ord-(\\\\d+)\". Regex rows may add `flags` (subset of \"gimsuy\") and `group` (capture group index, default: first group, else whole match). Optional select:\"first\" (default, writes one value) | \"all\" (writes a JSON array of every match). A failed extraction SKIPS that write and is reported in the node output — it does not fail the node.",
     poll: "Wait-until: repeats ONE embedded action until a condition passes or the budget runs out — prefer this over wait+loop chains for \"poll until ready\" steps. REQUIRED: actionType:\"request\"|\"db\"|\"redis\"|\"script\" + the MATCHING embedded config object (`request` | `db` | `redis` | `script`, same shape as the standalone node of that type) + successCondition (a full condition config: { mode:\"builder\", rootGroup } — same shape as the condition node, evaluated after EVERY tick against the tick's result, e.g. left { mode:\"runtime\", valueType:\"number\", value:\"response.status\" } for a request action) + intervalMs (delay between ticks, ≤ 3600000). OPTIONAL: maxAttempts (default 30, max 1000), timeoutMs (wall-clock cap, ≤ 86400000), backoffMultiplier (1..10, exponential backoff on the interval), maxDelayMs (backoff cap), onTimeout:\"fail\" (default — normal failure path, error edges apply) | \"continue\" (mark degraded and continue). Action errors are polled through (a failing tick is retried, not fatal); per-node retry is force-disabled — the loop IS the retry. Output: { attempts, maxAttempts, elapsedMs, timedOut, conditionResult, lastTickError? }; the last tick's action result is ALSO published like the standalone node would (response.*, rows, redis.result).",
@@ -111,20 +112,20 @@ export const buildScenarioSystemPrompt = (options = {}) => [
     "",
     "NODE ENVELOPE — every node is:",
     '{ "id": string (unique), "type": <one below>, "position": { "x": number, "y": number }, "data": { "label": string, "config": { ... } } }',
-    "- `label` is REQUIRED, non-empty, UNIQUE across the scenario, and must NOT be \"workflow\" or \"__meta\". Downstream nodes read a node's output by its label: {{Login.data.token}}.",
+    `- \`label\` is REQUIRED, non-empty, UNIQUE across the scenario, and must NOT be a reserved name (${RESERVED_SCENARIO_LABELS.map((label) => `"${label}"`).join(", ")}) — the engine drops such a node's output. Downstream nodes read a node's output by its label: {{Login.data.token}}.`,
     "- Every config EXCEPT `condition` carries an `executionPolicy` object (see defaults below).",
     "- position: the app AUTO-ARRANGES the whole graph (top-to-bottom flow, branches fanned out side-by-side, centered, never overlapping), so layout is NOT your concern — just give each node any distinct {x,y} (e.g. step y by 150). Focus on correct edges + config, not coordinates. Model the flow by EDGES (branches, merges), not by stacking every node in one long line.",
     "",
-    "EDGES — { \"id\": string, \"source\": <node id>, \"target\": <node id>, \"type\"?: \"default\" | \"yes\" | \"no\" }.",
+    "EDGES — { \"id\": string, \"source\": <node id>, \"target\": <node id>, \"type\"?: \"default\" | \"yes\" | \"no\" | \"error\" }.",
     "- Omit `type` (or use \"default\") for normal flow.",
     "- \"yes\"/\"no\" are ONLY used on the two edges leaving a `condition` node.",
+    "- \"error\" (any node except `condition`) is followed INSTEAD of the normal edges when that node fails.",
     "",
     "GRAPH RULES (a scenario that breaks these is rejected):",
-    "- Exactly ONE start node (a node with no incoming edge).",
-    "- No cycles (except an `end` node's explicit loop).",
+    "- No cycles — an `end` node's loop settings express a loop, never a back edge.",
     "- A `condition` node needs exactly one \"yes\" and one \"no\" outgoing edge.",
-    "- An `end` node needs ≥1 incoming edge.",
     "- Fill each node's REQUIRED fields (see notes per type).",
+    "ALSO: use exactly ONE start node (a node with no incoming edge) and give every `end` node ≥1 incoming edge.",
     "",
     "TEMPLATING — chain data between nodes:",
     "- {{env.KEY}} / {{KEY}} — environment/global variables.",

package/dist/ai/prompts/scenario.js.map

@@ -1 +1 @@
-{"version":3,"file":"scenario.js","sourceRoot":"","sources":["../../../src/ai/prompts/scenario.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scenario.js","sourceRoot":"","sources":["../../../src/ai/prompts/scenario.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,2EAA2E;AAC3E,EAAE;AACF,0EAA0E;AAC1E,oEAAoE;AACpE,8EAA8E;AAC9E,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,6EAA6E;AAC7E,yCAAyC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,iFAAiF;AACjF,gFAAgF;AAChF,mCAAmC;AACnC,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,SAAS;IACT,IAAI;IACJ,OAAO;IACP,OAAO;IACP,WAAW;IACX,WAAW;IACX,QAAQ;IACR,UAAU;IACV,MAAM;IACN,SAAS;IACT,WAAW;IACX,IAAI;IACJ,MAAM;IACN,cAAc;IACd,YAAY;IACZ,KAAK;CACG,CAAC;AAEX,iFAAiF;AACjF,iFAAiF;AACjF,+EAA+E;AAC/E,kDAAkD;AAClD,MAAM,UAAU,GAA2B;IACzC,OAAO,EACL,syEAAsyE;IAExyE,EAAE,EAAE,oaAAoa;IACxa,KAAK;IACH,qEAAqE;IACrE,sDAAsD;IACtD,8KAA8K,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,4OAA4O;IACvc,KAAK,EACH,g3BAAg3B;IACl3B,SAAS,EACP,ilBAAilB;IACnlB,SAAS,EACP,yUAAyU;IAC3U,MAAM,EACJ,0WAA0W;IAC5W,UAAU,EACR,m+BAAm+B;IACr+B,IAAI,EACF,owCAAowC;IACtwC,OAAO,EACL,ssEAAssE;IACxsE,SAAS,EACP,m0CAAm0C;IACr0C,EAAE,EAAE,umBAAumB;IAC3mB,IAAI,EAAE,+GAA+G;IACrH,YAAY,EACV,gQAAgQ;IAClQ,UAAU,EACR,iNAAiN;IACnN,GAAG,EAAE,0KAA0K;CAChL,CAAC;AAUF,MAAM,kBAAkB,GAAG,CAAC,gBAA2C,EAAU,EAAE,CACjF,2BAA2B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;IACvC,IAAI,MAAM,GAAY,IAAI,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO;QACL,cAAc,IAAI,GAAG;QACrB,IAAI;QACJ,+DAA+D;QAC/D,SAAS;QACT,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/B,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAElB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,UAA4C,EAAE,EACtC,EAAE,CACV;IACE,gRAAgR;IAChR,EAAE;IACF,6EAA6E;IAC7E,KAAK;IACL,IAAI,CAAC,SAAS,CACZ;QACE,KAAK,EAAE,gHAAgH;QACvH,QAAQ,EAAE;YACR,IAAI,EAAE,kCAAkC;YACxC,WAAW,EAAE,UAAU;YACvB,KAAK,EAAE;gBACL;oBACE,EAAE,EAAE,IAAI;oBACR,IAAI,EAAE,SAAS;oBACf,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;oBACxB,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;iBACrC;aACF;YACD,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAClE,YAAY,EAAE;gBACZ;oBACE,EAAE,EAAE,MAAM;oBACV,IAAI,EAAE,SAAS;oBACf,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;iBAC3F;aACF;SACF;KACF,EACD,IAAI,EACJ,CAAC,CACF;IACD,KAAK;IACL,oFAAoF;IACpF,EAAE;IACF,gCAAgC;IAChC,0IAA0I;IAC1I,oGAAoG,wBAAwB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,sHAAsH;IAC1R,6FAA6F;IAC7F,gXAAgX;IAChX,EAAE;IACF,kIAAkI;IAClI,qDAAqD;IACrD,6EAA6E;IAC7E,yGAAyG;IACzG,EAAE;IACF,yDAAyD;IACzD,gFAAgF;IAChF,8EAA8E;IAC9E,0DAA0D;IAC1D,6GAA6G;IAC7G,EAAE;IACF,wCAAwC;IACxC,yDAAyD;IACzD,kIAAkI;IAClI,kEAAkE;IAClE,mHAAmH;IACnH,EAAE;IACF,wEAAwE;IACxE,iTAAiT;IACjT,4UAA4U;IAC5U,4MAA4M;IAC5M,EAAE;IACF,6KAA6K;IAC7K,kWAAkW;IAClW,yNAAyN;IACzN,kNAAkN;IAClN,oOAAoO;IACpO,6UAA6U;IAC7U,grBAAgrB;IAChrB,EAAE;IACF,+UAA+U;IAC/U,EAAE;IACF,qOAAqO;IACrO,EAAE;IACF,qSAAqS;IACrS,EAAE;IACF,oDAAoD;IACpD,EAAE;IACF,6BAA6B;IAC7B,kBAAkB,CAAC,OAAO,CAAC,gBAAgB,IAAI,yBAAyB,CAAC;IACzE,EAAE;IACF,uEAAuE;IACvE,8fAA8f;IAC9f,8UAA8U;IAC9U,EAAE;IACF,sBAAsB,EAAE;CACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEf,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAA0B,EAAU,EAAE;IAC5E,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAClE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,iDAAiD,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC;IAChH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QAClE,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,iGAAiG,CAAC,CAAC;IAChH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;QAC1F,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,cAAc,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC9E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,IAAI,KAAK,MAAM,IAAI,QAAQ,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,gIAAgI,CAAC,CAAC;QAC7I,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,SAAS,CACZ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,EAAE,EAAE,EAChH,IAAI,EACJ,CAAC,CACF,CACF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,sBAAsB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC"}

package/dist/ai/prompts/scenarioNodeReference.d.ts

@@ -0,0 +1,16 @@
+import type { ScenarioNodeType } from "../../scenario-runner/types.js";
+export interface RenderScenarioNodeReferenceOptions {
+    /**
+     * The per-type defaults the compact form merges configs over. Default =
+     * core's `SCENARIO_NODE_DEFAULT_CONFIGS` (what callman-mcp merges over).
+     */
+    defaultConfigFor?: (type: string) => unknown;
+}
+/**
+ * The scenario node reference for API / MCP clients: the scenario shape, every
+ * node type's config fields (type, default, requirement, notes) with a minimal
+ * example, and the graph rules the server enforces.
+ */
+export declare const renderScenarioNodeReference: (options?: RenderScenarioNodeReferenceOptions) => string;
+export declare const SCENARIO_NODE_REFERENCE_TYPES: readonly ScenarioNodeType[];
+//# sourceMappingURL=scenarioNodeReference.d.ts.map

package/dist/ai/prompts/scenarioNodeReference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarioNodeReference.d.ts","sourceRoot":"","sources":["../../../src/ai/prompts/scenarioNodeReference.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAMvE,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC9C;AAm0BD;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GACtC,UAAS,kCAAuC,KAC/C,MAsGF,CAAC;AAGF,eAAO,MAAM,6BAA6B,EAAE,SAAS,gBAAgB,EAAoB,CAAC"}