mmt-mcp 1.44.5 → 1.45.0-pre

package/dist/examples/basic/05_api_test_suite/echo.mmt

@@ -1,9 +1,9 @@
 type: api
 title: Echo status
-url: https://test.mmt.dev/json
-method: get
 outputs:
   status_code: status
+url: https://test.mmt.dev/json
+method: get
 examples:
   - id: ok
     title: Happy path

package/dist/examples/examples-index.json

@@ -1063,6 +1063,88 @@
     "category": "intermediate",
     "title": "\"Suite memory stress\""
   },
+  {
+    "path": "intermediate/31_setenv_chain/api/login.mmt",
+    "type": "api",
+    "category": "intermediate",
+    "title": "Login"
+  },
+  {
+    "path": "intermediate/31_setenv_chain/api/whoami.mmt",
+    "type": "api",
+    "category": "intermediate",
+    "title": "Who am I"
+  },
+  {
+    "path": "intermediate/31_setenv_chain/env.mmt",
+    "type": "env",
+    "category": "intermediate"
+  },
+  {
+    "path": "intermediate/31_setenv_chain/server/auth_server.mmt",
+    "type": "server",
+    "category": "intermediate",
+    "title": "Setenv chain mock server"
+  },
+  {
+    "path": "intermediate/31_setenv_chain/suite.mmt",
+    "type": "suite",
+    "category": "intermediate",
+    "title": "Setenv across suite items"
+  },
+  {
+    "path": "intermediate/31_setenv_chain/test/login_test.mmt",
+    "type": "test",
+    "category": "intermediate",
+    "title": "Login then use the token"
+  },
+  {
+    "path": "intermediate/31_setenv_chain/test/prepare_test.mmt",
+    "type": "test",
+    "category": "intermediate",
+    "title": "Prepare environment"
+  },
+  {
+    "path": "intermediate/31_setenv_chain/test/whoami_test.mmt",
+    "type": "test",
+    "category": "intermediate",
+    "title": "Reuse the token in a later suite item"
+  },
+  {
+    "path": "intermediate/32_environment_live_variables/consume_session_api.mmt",
+    "type": "api",
+    "category": "intermediate",
+    "title": "Echo both live sessions"
+  },
+  {
+    "path": "intermediate/32_environment_live_variables/consume_session_test.mmt",
+    "type": "test",
+    "category": "intermediate",
+    "title": "Read live env from a test"
+  },
+  {
+    "path": "intermediate/32_environment_live_variables/create_session_api.mmt",
+    "type": "api",
+    "category": "intermediate",
+    "title": "Create session (API)"
+  },
+  {
+    "path": "intermediate/32_environment_live_variables/create_session_test.mmt",
+    "type": "test",
+    "category": "intermediate",
+    "title": "Create session (test)"
+  },
+  {
+    "path": "intermediate/32_environment_live_variables/multimeter.mmt",
+    "type": "env",
+    "category": "intermediate"
+  },
+  {
+    "path": "intermediate/32_environment_live_variables/suite.mmt",
+    "type": "suite",
+    "category": "intermediate",
+    "title": "Live env consumers"
+  },
   {
     "path": "professional/01_report_generation/api/echo.mmt",
     "type": "api",

package/dist/examples/intermediate/01_api_inputs_outputs/post_regex_outputs.mmt

@@ -1,6 +1,6 @@
 type: api
 title: Extract with regex
-description: |
+description: |-
   Extract values from the response using regular expressions.
   Use `body[/pattern/]` or `body./pattern/` to extract from the body.
   Use `headers[/pattern/]` or `headers./pattern/` to extract from headers.

package/dist/examples/intermediate/05_api_documentation/api/get_users.mmt

@@ -1,6 +1,6 @@
 type: api
 title: List users
-description: |
+description: |-
   Returns a list of all users in the system.
 
   <<o:name>> The user's display name

package/dist/examples/intermediate/05_api_documentation/api/post_create_user.mmt

@@ -1,6 +1,6 @@
 type: api
 title: Create user
-description: |
+description: |-
   Create a new user account with the given details.
 
   <<i:username>> The desired username (3-20 characters)

package/dist/examples/intermediate/05_api_documentation/api/ws_notifications.mmt

@@ -1,6 +1,6 @@
 type: api
 title: Notification stream
-description: |
+description: |-
   Subscribe to real-time notifications via WebSocket.
   Send a JSON message to start receiving events.
 

package/dist/examples/intermediate/06_imports/README.md

@@ -44,7 +44,7 @@ import:
 |---|---|---|
 | API definition | `.mmt` (`type: api`) | `call` step |
 | Test flow | `.mmt` (`type: test`) | `call` step (runs as a nested test) |
-| CSV data | `.csv` | `data` + `for` steps |
+| CSV data | `.csv` | `for` steps |
 | JavaScript module | `.js` / `.cjs` / `.mjs` | `js` steps |
 | Mock server | `.mmt` (`type: server`) | `run` step |
 

package/dist/examples/intermediate/09_csv_data_driven_test/README.md

@@ -39,7 +39,7 @@ test 123,POST
 - Unquoted numbers are auto-coerced (`"42"` → `42`); `true`/`false` become booleans.
 - Quoted values stay as strings (e.g. `"00123"` stays `"00123"`).
 
-### 2. Import the CSV and bind it with `data`
+### 2. Import the CSV and use it
 
 ```yaml
 import:
@@ -48,7 +48,7 @@ steps:
   - for: message of messages
 ```
 
-The `data` step binds the imported CSV alias into scope so it can be used in loops and expressions.
+The imported CSV alias is available in loops and expressions.
 
 ### 3. Loop with `for`
 
@@ -77,4 +77,3 @@ The `for` expression is standard JavaScript — `const row of messages` iterates
 - See [Simple Test](../../basic/02_simple_test/) for a basic test without CSV.
 - See [API Inputs & Outputs](../01_api_inputs_outputs/) for more input/output patterns.
 - See [Test docs — for/repeat](../../../docs/files/test/steps/control-flow.md#for-repeat) for the full `for`/`repeat` reference.
-- See [Test docs — data](../../../docs/files/test/steps/variables.md#data) for more on the `data` step.

package/dist/examples/intermediate/22_omit_keyword/omit_keyword.mmt

@@ -30,4 +30,4 @@ body:
   middleName: i:middle_name
   nickname: i:nickname
   bio: i:bio
-  bioText: i:bio_text
+  bioText: i:bio_text

package/dist/examples/intermediate/25_convert_to_mmt/postman/converted/api/ping.mmt

@@ -13,7 +13,7 @@ headers:
   Accept: application/json
 examples:
   - name: sample json
-    outputs:
+    expect:
       status: 200
       statusCode: 200
       id: 1

package/dist/examples/intermediate/31_setenv_chain/README.md

@@ -0,0 +1,24 @@
+# setenv chain
+
+`setenv` values are usable by the very next step, imported test, or suite item. They live in memory for the run and are never written to env files.
+
+| File | Purpose |
+|---|---|
+| `server/auth_server.mmt` | Local mock: `POST /login` returns a token, `GET /whoami` requires it |
+| `api/login.mmt` | API-level `setenv: session_token` |
+| `api/whoami.mmt` | Sends `Bearer <<e:session_token>>` |
+| `test/prepare_test.mmt` | Imported test with a `setenv` step |
+| `test/login_test.mmt` | Calls login, then whoami, in one run |
+| `test/whoami_test.mmt` | Calls whoami only; relies on an earlier suite item |
+| `suite.mmt` | Runs login test, then whoami test |
+
+## Run
+
+From the repo root:
+
+```sh
+npx testlight run examples/intermediate/31_setenv_chain/suite.mmt \
+  --env-file examples/intermediate/31_setenv_chain/env.mmt
+```
+
+The suite starts the mock server itself. To run a single test, start `server/auth_server.mmt` first.

package/dist/examples/intermediate/31_setenv_chain/api/login.mmt

@@ -0,0 +1,11 @@
+type: api
+title: Login
+description: Logs in and promotes the token to `session_token` with `setenv`
+protocol: http
+method: post
+url: <<e:base_url>>/login
+outputs:
+  token: body.token
+setenv:
+  session_token: body.token
+body: ""

package/dist/examples/intermediate/31_setenv_chain/api/whoami.mmt

@@ -0,0 +1,10 @@
+type: api
+title: Who am I
+description: Reads the current user using the token stored by `setenv`
+protocol: http
+method: get
+url: <<e:base_url>>/whoami
+headers:
+  Authorization: Bearer <<e:session_token>>
+outputs:
+  user: body.user

package/dist/examples/intermediate/31_setenv_chain/env.mmt

@@ -0,0 +1,4 @@
+type: env
+variables:
+  base_url: http://localhost:9131
+  session_token: ""

package/dist/examples/intermediate/31_setenv_chain/server/auth_server.mmt

@@ -0,0 +1,34 @@
+type: server
+title: Setenv chain mock server
+description: Issues a session token and only accepts requests that carry it
+port: 9131
+cors: true
+endpoints:
+  - method: post
+    path: /login
+    status: 200
+    format: json
+    body:
+      token: session-abc123
+  - method: get
+    path: /whoami
+    match:
+      headers:
+        Authorization: Bearer session-abc123
+    status: 200
+    format: json
+    body:
+      authenticated: true
+      user: alice
+  - method: get
+    path: /whoami
+    status: 401
+    format: json
+    body:
+      authenticated: false
+fallback:
+  status: 404
+  format: json
+  body:
+    errors:
+      - path not found

package/dist/examples/intermediate/31_setenv_chain/suite.mmt

@@ -0,0 +1,12 @@
+type: suite
+title: Setenv across suite items
+description: The first item sets `session_token`; the second item consumes it without logging in
+tags:
+  - example
+  - setenv
+servers:
+  - server/auth_server.mmt
+items:
+  - test/login_test.mmt
+  - then
+  - test/whoami_test.mmt

package/dist/examples/intermediate/31_setenv_chain/test/login_test.mmt

@@ -0,0 +1,24 @@
+type: test
+title: Login then use the token
+description: |-
+  The API-level `setenv` (login) and a test-level `setenv` step are both read
+  by the very next step in the same run.
+import:
+  login: ../api/login.mmt
+  whoami: ../api/whoami.mmt
+  prepare: ./prepare_test.mmt
+steps:
+  - call: login
+    expect:
+      status: 200
+  - call: whoami
+    expect:
+      status: 200
+      user: alice
+    report: all
+  - call: prepare
+  - check:
+      title: Setenv from an imported test is visible
+      actual: e:greeting
+      operator: ==
+      expected: hello-from-import

package/dist/examples/intermediate/31_setenv_chain/test/prepare_test.mmt

@@ -0,0 +1,6 @@
+type: test
+title: Prepare environment
+description: Imported by another test; its setenv step must still reach the caller
+steps:
+  - setenv:
+      greeting: hello-from-import

package/dist/examples/intermediate/31_setenv_chain/test/whoami_test.mmt

@@ -0,0 +1,11 @@
+type: test
+title: Reuse the token in a later suite item
+description: Does not log in; relies on `session_token` set by an earlier suite item
+import:
+  whoami: ../api/whoami.mmt
+steps:
+  - call: whoami
+    expect:
+      status: 200
+      user: alice
+    report: all

package/dist/examples/intermediate/32_environment_live_variables/README.md

@@ -0,0 +1,63 @@
+# Environment live variables (`./…mmt`)
+
+Env values that start with `./` and end with `.mmt` are **file-backed**. At run
+start each such path becomes a getter in the process env store. Reading
+`e:name` runs that file (default inputs) and uses the **first key** under its
+`outputs:` (YAML order). The target’s `cache:` controls reuse. A later
+`setenv` of `./x.mmt` stays a plain string — only the original env copy turns
+paths into getters.
+
+Works for any runnable type with `outputs:` (typically `api` or `test`).
+
+API files in this example call [https://test.mmt.dev/echo](https://test.mmt.dev/echo)
+(needs network).
+
+## Structure
+
+```
+32_environment_live_variables/
+├── multimeter.mmt              # session_api / session_test → ./create_*.mmt
+├── create_session_api.mmt      # API → outputs.session (uuid)
+├── create_session_test.mmt     # Test → outputs.session (uuid), cache: 2s
+├── consume_session_test.mmt    # Asserts both e: values look like UUIDs
+├── consume_session_api.mmt     # Optional: post both e: values to echo (Send)
+├── suite.mmt                   # Runs consume_session_test
+└── README.md
+```
+
+## Files
+
+| File | Role |
+|---|---|
+| `multimeter.mmt` | Env with file-backed `session_api` and `session_test` |
+| `create_session_api.mmt` | API that posts `r:uuid` to test.mmt.dev/echo and exposes `session` |
+| `create_session_test.mmt` | Test that sets `o:session` to `r:uuid` |
+| `consume_session_test.mmt` | Checks `e:session_*` with `=*` UUID regex |
+| `consume_session_api.mmt` | Optional API Send demo — body uses `e:session_*` |
+| `suite.mmt` | Runs `consume_session_test.mmt` |
+
+## Try it
+
+From the repo root:
+
+```sh
+npx testlight run examples/intermediate/32_environment_live_variables/suite.mmt \
+  --env-file examples/intermediate/32_environment_live_variables/multimeter.mmt
+
+# Or the test directly
+npx testlight run examples/intermediate/32_environment_live_variables/consume_session_test.mmt \
+  --env-file examples/intermediate/32_environment_live_variables/multimeter.mmt
+```
+
+### In VS Code
+
+1. Open this folder (or the repo) so `multimeter.mmt` is the workspace env.
+2. Reload the Environment panel if needed — file-backed values show a **file**
+   icon and an underlined, Ctrl/Cmd+clickable path.
+3. Run `suite.mmt` or `consume_session_test.mmt`. Optionally Send
+   `consume_session_api.mmt` to see both UUIDs in the echo body.
+
+## Notes
+
+- Checks use `=*` (regex), not `== xxx`, so random UUIDs still pass.
+- `cache: 2s` on the test target: two `e:session_test` reads in one run match.

package/dist/examples/intermediate/32_environment_live_variables/consume_session_api.mmt

@@ -0,0 +1,10 @@
+type: api
+title: Echo both live sessions
+description: |-
+  Whole-field e: tokens stay unresolved until Send/run so file-backed getters can run. The echo body should contain two UUIDs, not ./…mmt paths.
+url: https://test.mmt.dev/echo
+method: post
+format: json
+body:
+  session_api: e:session_api
+  session_test: e:session_test

package/dist/examples/intermediate/32_environment_live_variables/consume_session_test.mmt

@@ -0,0 +1,9 @@
+type: test
+title: Read live env from a test
+description: |
+  e:session_* runs the linked .mmt files and yields their first output (a UUID). Assert shape with the regex operator (=*).
+steps:
+  - check: <<e:session_test>> =* ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
+  - check: <<e:session_api>> =* ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
+  # Within cache: 2s, a second read of session_test returns the same UUID.
+  - check: <<e:session_test>> == <<e:session_test>>

package/dist/examples/intermediate/32_environment_live_variables/create_session_api.mmt

@@ -0,0 +1,11 @@
+type: api
+title: Create session (API)
+description: |-
+  File-backed env target. First outputs key (`session`) becomes the env value. Optional cache: reuses the result across e: reads within the window.
+outputs:
+  session: body.body.uuid
+url: https://test.mmt.dev/echo
+method: post
+format: json
+body:
+  uuid: r:uuid

package/dist/examples/intermediate/32_environment_live_variables/create_session_test.mmt

@@ -0,0 +1,9 @@
+type: test
+title: Create session (test)
+description: File-backed env target with a short cache window.
+outputs:
+  session: ''
+cache: 2s
+steps:
+  - set:
+      o:session: r:uuid

package/dist/examples/intermediate/32_environment_live_variables/multimeter.mmt

@@ -0,0 +1,4 @@
+type: env
+variables:
+  session_api: ./create_session_api.mmt
+  session_test: ./create_session_test.mmt

package/dist/examples/intermediate/32_environment_live_variables/suite.mmt

@@ -0,0 +1,7 @@
+type: suite
+title: Live env consumers
+description: >
+  Runs the test consumer. Needs network access to test.mmt.dev for
+  e:session_api (create_session_api.mmt).
+items:
+  - ./consume_session_test.mmt

package/dist/examples/professional/04_convert_to_mmt/openapi/converted/api/bearer-auth-check.mmt

@@ -1,6 +1,6 @@
 type: api
 title: Bearer auth check
-description: |
+description: |-
   Requires `Authorization: Bearer testtoken`. Any other token fails.
 url: https://test.mmt.dev/auth/bearer
 protocol: http

package/dist/examples/professional/04_convert_to_mmt/postman/converted/api/samples/get-sample-json.mmt

@@ -14,7 +14,7 @@ headers:
   Accept: application/json
 examples:
   - name: sample json
-    outputs:
+    expect:
       status: 200
       statusCode: 200
       id: 1

package/dist/examples/professional/11_token_resolution/api/current_header.mmt

@@ -34,7 +34,7 @@ headers:
   X-Angle-Both: "asda<<c:day>>asas"
   X-Quoted-Curly: "{{c:day}}"
   X-Curly-Whole: {{c:city}}
-  X-Text-Slice: <<c:city[0:1]>>
+  X-Text-Slice: c:city[0:1]
   X-Missing-Embed: "x<<c:not_a_token>>y"
 examples:
   - id: defaults

package/dist/examples/professional/11_token_resolution/api/env_header.mmt

@@ -35,7 +35,7 @@ headers:
   X-Quoted-Angle: "<<e:account_age>>"
   X-Angle-Prefix: "asda<<e:account_age>>"
   X-Angle-Suffix: "<<e:account_age>>asas"
-  X-Angle-Both: "asda<<e:feature_enabled>>asas"
+  X-Angle-Both: asda<<e:feature_enabled>>asas
   X-Quoted-Curly: "{{e:account_age}}"
   X-Curly-Whole: {{e:plan_label}}
   X-Text-Slice: <<e:service_url[0:8]>>

package/dist/guides/generate-test.md

@@ -121,10 +121,7 @@ Supported step forms:
 - let:
     <name>: <value>
 
-# 13) data: bind CSV alias (from import)
-- data: <alias>
-
-# 14) setenv: promote values into environment variables
+# 13) setenv: promote values into environment variables
 - setenv:
     <env_name>: <value>       # e.g. token: ${loginStep.token}
 ```
@@ -291,7 +288,6 @@ import:
   login: ./login.mmt
 
 steps:
-  - data: users
   - for: const user of users
     steps:
       - call: login