mmt-mcp 1.42.2-pre

package/dist/examples/intermediate/18_simple_mock_server/api/get_user.mmt

@@ -0,0 +1,12 @@
+type: api
+title: Get User by ID
+description: GET request with a path parameter to fetch a user
+inputs:
+  user_id: "42"
+outputs:
+  id: body.id
+  name: body.name
+  email: body.email
+url: http://localhost:9099/users/<<i:user_id>>
+method: get
+format: json

package/dist/examples/intermediate/18_simple_mock_server/api/search.mmt

@@ -0,0 +1,11 @@
+type: api
+title: Search
+description: GET request with a query parameter
+inputs:
+  q: multimeter
+outputs:
+  query: body.query
+  result_count: body.results.length
+url: http://localhost:9099/search?q=<<i:q>>
+method: get
+format: json

package/dist/examples/intermediate/18_simple_mock_server/server/mock_server.mmt

@@ -0,0 +1,46 @@
+type: server
+title: Sample Mock Server
+description: A mock server with GET and POST endpoints
+port: 9099
+cors: true
+endpoints:
+  - method: get
+    path: /health
+    status: 200
+    format: json
+    body:
+      status: ok
+      uptime: 12345
+  - method: get
+    path: /users/:id
+    status: 200
+    format: json
+    body:
+      id: "${url.id}"
+      name: Test User
+      email: testuser@example.com
+  - method: post
+    path: /users
+    status: 201
+    format: json
+    body:
+      id: r:uuid
+      name: "${body.name}"
+      email: "${body.email}"
+      message: User created
+  - method: get
+    path: /search
+    status: 200
+    format: json
+    body:
+      query: received
+      results:
+        - id: 1
+          title: First result
+        - id: 2
+          title: Second result
+fallback:
+  status: 404
+  format: json
+  body:
+    error: Not Found

package/dist/examples/intermediate/18_simple_mock_server/suite.mmt

@@ -0,0 +1,12 @@
+type: suite
+title: Mock Server Tests
+description: Starts the mock server and runs all API tests against it
+tags:
+  - example
+  - mock
+servers:
+  - server/mock_server.mmt
+items:
+  - test/health_test.mmt
+  - test/user_test.mmt
+  - test/search_test.mmt

package/dist/examples/intermediate/18_simple_mock_server/test/health_test.mmt

@@ -0,0 +1,13 @@
+type: test
+title: Health Check Test
+description: Starts the mock server, calls the health endpoint, and verifies the response
+import:
+  server: ../server/mock_server.mmt
+  health: ../api/get_health.mmt
+steps:
+  - run: server
+  - call: health
+    id: result
+    expect:
+      status_field: ok
+    report: all

package/dist/examples/intermediate/18_simple_mock_server/test/search_test.mmt

@@ -0,0 +1,15 @@
+type: test
+title: Search API Test
+description: Tests the GET search endpoint with a query parameter
+import:
+  server: ../server/mock_server.mmt
+  search: ../api/search.mmt
+steps:
+  - run: server
+  - call: search
+    id: result
+    inputs:
+      q: multimeter
+    expect:
+      query: received
+    report: all

package/dist/examples/intermediate/18_simple_mock_server/test/user_test.mmt

@@ -0,0 +1,27 @@
+type: test
+title: User API Test
+description: Tests GET user by ID and POST create user against the mock server
+import:
+  server: ../server/mock_server.mmt
+  getUser: ../api/get_user.mmt
+  createUser: ../api/create_user.mmt
+inputs:
+  user_id: "42"
+steps:
+  - run: server
+  - call: getUser
+    id: fetchedUser
+    inputs:
+      user_id: i:user_id
+    expect:
+      id: <<i:user_id>>
+      name: Test User
+    report: all
+  - call: createUser
+    id: newUser
+    inputs:
+      name: Bob
+      email: bob@example.com
+    expect:
+      message: User created
+    report: all

package/dist/examples/intermediate/19_environment_post_echo/README.md

@@ -0,0 +1,33 @@
+# Environment POST Echo
+
+An intermediate environment-variable example that sends a POST request using env values in the URL, headers, and body.
+
+## Files
+
+| File | Description |
+|---|---|
+| `multimeter.mmt` | Defines `base_url` and `custom_header` variables |
+| `post_echo.mmt` | POST request using `<<e:base_url>>/echo`, `e:custom_header`, and env accessors |
+
+## How to use
+
+### In VS Code
+
+1. Open the Environment panel and load `multimeter.mmt`.
+2. Open `post_echo.mmt`.
+3. Click **Run**.
+
+### With the CLI
+
+```sh
+npx testlight run examples/intermediate/19_environment_post_echo/post_echo.mmt \
+  --env-file examples/intermediate/19_environment_post_echo/multimeter.mmt
+```
+
+## Key concepts
+
+- **`e:var`** references an environment variable as the whole value.
+- **`<<e:var>>`** embeds an environment variable inside a string.
+- **Accessors** like `<<e:custom_header[0:5]>>` reuse part of an env value.
+
+See [Environment docs](../../../docs/files/env/index.md) for full details.

package/dist/examples/intermediate/19_environment_post_echo/multimeter.mmt

@@ -0,0 +1,4 @@
+type: env
+variables:
+  base_url: https://test.mmt.dev
+  custom_header: multimeter-example

package/dist/examples/intermediate/19_environment_post_echo/post_echo.mmt

@@ -0,0 +1,12 @@
+type: api
+title: Post echo
+description: Send a JSON body to the echo endpoint using an environment-based URL and env accessors
+url: <<e:base_url>>/echo
+method: post
+format: json
+headers:
+  X-Custom: e:custom_header
+  X-Custom-Prefix: <<e:custom_header[0:5]>>
+body:
+  name: Multimeter
+  message: Hello from <<e:base_url[0:8]>>

package/dist/examples/intermediate/20_document_parameters/README.md

@@ -0,0 +1,25 @@
+# Document Parameters
+
+An intermediate `type: doc` example that documents input parameters with options and ranges.
+
+## Files
+
+| File | Description |
+|---|---|
+| `document.mmt` | Renders the parameter documentation and enables Try buttons |
+| `api/search_users.mmt` | API with parameter descriptions, option lists, and a numeric range |
+
+## How to use
+
+1. Open `document.mmt` in VS Code with the Multimeter extension.
+2. Expand `Search users`.
+3. Review the documented parameters and their options/ranges.
+
+## Key concepts
+
+- **Options** use syntax like `<<i:role>> [admin, editor, viewer] Role description`.
+- **Ranges** use syntax like `<<i:page>> [1-5] Page number`.
+- **Output annotations** use `<<o:name>> Description`.
+- **`html.triable: true`** enables interactive Try buttons in rendered docs.
+
+See [Doc docs](../../../docs/files/doc/index.md#parameter-annotations-in-api-descriptions) for details.

package/dist/examples/intermediate/20_document_parameters/api/search_users.mmt

@@ -0,0 +1,28 @@
+type: api
+title: Search users
+description: |-
+  Search users with documented parameter options and ranges.
+
+  <<i:role>> [admin, editor, viewer] Filter users by role
+  <<i:page>> [1-5] Page number to fetch
+  <<i:sort>> [name, created_at, updated_at] Field used for sorting
+  <<i:include_inactive>> [true, false] Include inactive users in the result
+
+  <<o:count>> Number of users returned
+  <<o:request_method>> HTTP method used by the request
+inputs:
+  role: viewer
+  page: 1
+  sort: name
+  include_inactive: false
+outputs:
+  count: body.count
+  request_method: body.method
+url: https://test.mmt.dev/echo
+method: post
+format: json
+body:
+  role: i:role
+  page: i:page
+  sort: i:sort
+  include_inactive: i:include_inactive

package/dist/examples/intermediate/20_document_parameters/document.mmt

@@ -0,0 +1,6 @@
+type: doc
+title: Parameter Options and Ranges
+sources:
+  - api
+html:
+  triable: true

package/dist/examples/intermediate/21_manual_timeout/README.md

@@ -0,0 +1,22 @@
+# Manual Timeout
+
+This example shows how to override the default request timeout for one API request.
+
+## Files
+
+| File | Description |
+|---|---|
+| `manual_timeout.mmt` | Calls the public test endpoint with `timeout: 5000` and extracts status and duration outputs |
+
+## How To Use
+
+Open `manual_timeout.mmt` and run it from VS Code, or use the CLI:
+
+```sh
+npx testlight run examples/intermediate/21_manual_timeout/manual_timeout.mmt
+```
+
+## Key Concept
+
+- `timeout` is a per-request override in milliseconds.
+- If omitted, Multimeter uses `setting.http.timeout` from the env file, or the built-in default of `30000` milliseconds.

package/dist/examples/intermediate/21_manual_timeout/manual_timeout.mmt

@@ -0,0 +1,11 @@
+type: api
+title: Manual request timeout
+description: Override the default network timeout for this single API request.
+outputs:
+  status_code: status
+  response_time_ms: duration
+  message: body[message]
+url: https://test.mmt.dev/json
+method: get
+timeout: 5000
+format: json

package/dist/examples/intermediate/22_omit_keyword/README.md

@@ -0,0 +1,45 @@
+# Omit Keyword
+
+Intermediate example for the `omit` keyword in API inputs and outputs.
+
+## Files
+
+| File | Description |
+|---|---|
+| `omit_keyword.mmt` | Remove fields with `omit`, send real `null`, use quoted literals, and inspect echoed outputs |
+| `omit_keyword_test.mmt` | Test that verifies omit/null/literal-string behavior via the echo API |
+
+## How to use
+
+### In VS Code
+
+1. Open `omit_keyword.mmt`.
+2. Click **Run** and inspect the request body and output values.
+3. Change values in the **Inputs** panel:
+   - set `middle_name` to `omit` to remove it (output shows `omit`)
+   - set `middle_name` to `Lee` to send a normal string
+   - use `"omit"` when you want the literal string
+
+### With the CLI
+
+```sh
+npx testlight run examples/intermediate/22_omit_keyword/omit_keyword.mmt
+npx testlight run examples/intermediate/22_omit_keyword/omit_keyword_test.mmt
+```
+
+Override inputs from the command line:
+
+```sh
+npx testlight run examples/intermediate/22_omit_keyword/omit_keyword.mmt \
+  -e middle_name=Lee -e nickname='"omit"'
+```
+
+## Key concepts
+
+- **`omit` in inputs** — unquoted `omit` removes the target field from request objects (body/headers/query/cookies).
+- **`null` in inputs** — unquoted `null` sends a real null value.
+- **Quoted literals** — `"omit"` and `"null"` stay strings (like quoted numbers).
+- **`omit` in outputs** — shown when an extraction path is missing (for example `echoed_middle_name` when `middle_name` was omitted).
+- **`null` in outputs** — shown when the echoed field exists and its value is literally `null`.
+
+See [API docs — inputs](../../../docs/files/api/index.md#inputs) and [API docs — outputs](../../../docs/files/api/index.md#outputs).

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

@@ -0,0 +1,34 @@
+type: api
+title: Omit keyword
+description: |-
+  Use the `omit` keyword in inputs and see how it appears in outputs.
+
+  Inputs:
+  - `omit` (unquoted) removes the field from the request body
+  - `null` (unquoted) sends JSON null
+  - `"omit"` and `"null"` are literal strings
+
+  Outputs:
+  - missing path (for example `echoed_middle_name`) => omit
+  - existing null value (for example `echoed_bio`) => null
+inputs:
+  display_name: Alex
+  middle_name: omit
+  nickname: "omit"
+  bio: null
+  bio_text: "null"
+outputs:
+  echoed_display_name: body.body.displayName
+  echoed_middle_name: body.body.middleName
+  echoed_nickname: body.body.nickname
+  echoed_bio: body.body.bio
+  echoed_bio_text: body.body.bioText
+url: https://test.mmt.dev/echo
+method: post
+format: json
+body:
+  displayName: i:display_name
+  middleName: i:middle_name
+  nickname: i:nickname
+  bio: i:bio
+  bioText: i:bio_text

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

@@ -0,0 +1,19 @@
+type: test
+title: Omit keyword
+import:
+  profile: ./omit_keyword.mmt
+steps:
+  - call: profile
+    id: update
+    inputs:
+      display_name: Alex
+      middle_name: omit
+      nickname: "omit"
+      bio: null
+      bio_text: "null"
+    expect:
+      echoed_display_name: Alex
+      echoed_middle_name: omit
+      echoed_nickname: "omit"
+      echoed_bio: null
+      echoed_bio_text: "null"

package/dist/examples/intermediate/23_check_operators/README.md

@@ -0,0 +1,31 @@
+# Check Operators
+
+Intermediate example that exercises every comparison operator against a live echo response, using `expect` on the call plus `check` and `assert` steps.
+
+## Files
+
+| File | Description |
+|---|---|
+| `api/sample.mmt` | POST echo API with a fixed JSON body and named outputs |
+| `operators_test.mmt` | Test covering numeric, string, membership, regex, length, and fuzzy operators |
+
+## How to use
+
+### In VS Code
+
+1. Open `operators_test.mmt`.
+2. Click **Run test** and inspect expect / check / assert results in the report panel.
+
+### With the CLI
+
+```sh
+npx testlight run examples/intermediate/23_check_operators/operators_test.mmt
+```
+
+## Key concepts
+
+- **`expect` on `call`** — validate outputs inline (grouped as one report item).
+- **`check`** — log failures and continue.
+- **`assert`** — stop the flow on failure.
+- **Fuzzy operators** — `>N%` (at least N% similar) and `<N%` (less than N% similar); UI forms are `>%` / `<%` with a percent selector.
+- **YAML quoting** — operators that start with `>` (including `>80%` and `>%`) must be quoted in YAML.

package/dist/examples/intermediate/23_check_operators/api/sample.mmt

@@ -0,0 +1,27 @@
+type: api
+title: Operator sample payload
+description: Echoes a fixed JSON payload so comparison operators can be exercised against a live response
+outputs:
+  status_code: status
+  method: body.method
+  name: body.body.name
+  nickname: body.body.nickname
+  role: body.body.role
+  score: body.body.score
+  tags: body.body.tags
+  message: body.body.message
+  path: body.body.path
+url: https://test.mmt.dev/echo
+method: post
+format: json
+body:
+  name: Jonathan
+  nickname: Jon
+  role: admin
+  score: 85
+  tags:
+    - api
+    - test
+    - demo
+  message: Hello world from Multimeter
+  path: /api/v1/users

package/dist/examples/intermediate/23_check_operators/operators_test.mmt

@@ -0,0 +1,54 @@
+type: test
+title: Check operators
+description: |-
+  Exercises every comparison operator against a live server response using
+  expect on the call, plus check and assert steps.
+import:
+  sample: ./api/sample.mmt
+steps:
+  - call: sample
+    id: res
+    expect:
+      status_code: == 200
+      method: == POST
+      name: =C athan
+      nickname: =^ Jo
+      role: =$ min
+      score:
+        - ">= 80"
+        - <= 90
+      path: =* /users/
+      message: >60% Hello world from MMT
+      tags: =# 3
+  - assert: ${res.status_code} == 200
+  - assert: ${res.score} != 0
+  - assert: ${res.role} !@ guest,user
+  - check: ${res.score} > 50
+  - check: ${res.score} < 100
+  - check: ${res.name} !C xyz
+  - check: ${res.nickname} !^ Ad
+  - check: ${res.path} !$ /admin
+  - check: ${res.message} !* /error/i
+  - check: ${res.tags} !# 0
+  - check: ${res.role} =@ admin
+  - check: ${res.name} <40% completely-different
+  - check:
+      title: Fuzzy match with default percent
+      actual: ${res.message}
+      operator: >60%
+      expected: Hello world from MMT
+  - check:
+      title: Fuzzy match with default percent
+      actual: ${res.message}
+      operator: <50%
+      expected: Hi Universe
+  - check:
+      title: Path starts with /api/
+      actual: ${res.path}
+      operator: =^
+      expected: /api/
+  - assert:
+      title: Fuzzy match with default percent
+      actual: ${res.message}
+      operator: ==
+      expected: Hello world from Multimeter

package/dist/examples/intermediate/24_test_call_cache/README.md

@@ -0,0 +1,34 @@
+# Test Call Cache
+
+Advanced example: a session-style test declares `cache: 5m` so repeated `call:`s with the same title + inputs reuse outputs within one top-level run — a single test, suite, or nested suite hierarchy (second call skips nested HTTP).
+
+Design: `AI/sdd/sdd-test-call-cache.md`. User docs: [Test `.mmt` — cache](../../../docs/files/test/cache.md).
+
+## Files
+
+| File | Description |
+|------|-------------|
+| `api/login_echo.mmt` | Stand-in “login” API (echo) that returns a token-like field |
+| `create_session.mmt` | Cached test (`cache: 5m`) that calls the API and exports `token` |
+| `use_session_cache.mmt` | Parent: two identical session calls (cache hit) + one different user (miss) |
+
+## How to use
+
+### In VS Code
+
+1. Open `use_session_cache.mmt` and **Run**.
+2. First `call: session` performs HTTP; the second identical call should be served from cache (database icon next to pass/fail once the feature is wired in the UI).
+3. The third call uses different inputs → cache miss → HTTP again.
+
+### With the CLI
+
+```sh
+npx testlight run examples/intermediate/24_test_call_cache/use_session_cache.mmt
+```
+
+## Key concepts
+
+- **`cache` on the callee test** — scalar duration / epoch / date-time; not on `type: api` in phase 1.
+- **Key = title + inputs** — same session title and same inputs → same outputs.
+- **Bypass body only** — nested server/HTTP in the callee is skipped on hit; caller expects still run.
+- **Same top-level run** — shared across suite hierarchy until TTL expires or the run finishes; no disk.

package/dist/examples/intermediate/24_test_call_cache/api/login_echo.mmt

@@ -0,0 +1,19 @@
+type: api
+title: Login echo
+description: |-
+  Stand-in login endpoint for the call-cache example.
+  Echoes username back as a fake token payload.
+inputs:
+  username: alice
+  password: secret
+outputs:
+  token: body.body.token
+  user: body.body.user
+  status_code: status
+url: https://test.mmt.dev/echo
+method: post
+format: json
+body:
+  user: i:username
+  token: <<i:username>>-session-token
+  password: i:password

package/dist/examples/intermediate/24_test_call_cache/create_session.mmt

@@ -0,0 +1,28 @@
+type: test
+title: Create session
+description: |-
+  Expensive setup test: calls login once per distinct inputs.
+  `cache: 5m` means further calls in the same root run with the same
+  title + inputs reuse outputs and skip nested HTTP.
+import:
+  login: ./api/login_echo.mmt
+inputs:
+  user: alice
+  pass: secret
+outputs:
+  token: ''
+  user: ''
+cache: 5m
+steps:
+  - call: login
+    id: auth
+    title: Login (network)
+    inputs:
+      username: i:user
+      password: i:pass
+    expect:
+      status: =~ "200"
+      token: != null
+  - js: |
+      outputs.token = auth.token
+      outputs.user = auth.user

package/dist/examples/intermediate/24_test_call_cache/use_session_cache.mmt

@@ -0,0 +1,41 @@
+type: test
+title: Use cached session
+description: |-
+  Advanced cache example:
+  1) First call runs Create session (HTTP).
+  2) Second call — same inputs — returns cached outputs (DB icon in reports).
+  3) Third call — different user — cache miss, HTTP again.
+import:
+  session: ./create_session.mmt
+steps:
+  - call: session
+    id: first
+    title: Session for alice (miss → HTTP)
+    inputs:
+      user: alice
+      pass: secret
+    expect:
+      token: != null
+      user: == alice
+
+  - call: session
+    id: second
+    title: Session for alice again (hit → cache)
+    inputs:
+      user: alice
+      pass: secret
+    expect:
+      token: == ${first.token}
+      user: == alice
+
+  - call: session
+    id: third
+    title: Session for bob (miss → HTTP)
+    inputs:
+      user: bob
+      pass: other
+    expect:
+      token:
+        - != null
+        - != ${first.token}
+      user: == bob

package/dist/examples/intermediate/25_convert_to_mmt/README.md

@@ -0,0 +1,17 @@
+# Convert to MMT
+
+Minimal source files that show the **Convert to MMT...** workflow. Right-click a source file, convert it, and compare the result with the matching `converted/` folder.
+
+Each format is one request or one operation so the mapping stays easy to read.
+
+| Folder | Source | What you get |
+|---|---|---|
+| `openapi/` | `source.openapi.yaml` | One `type: api` file |
+| `postman/` | `source.postman_collection.json` | API, test, and suite files |
+| `wsdl/` | `source.wsdl` | One SOAP `type: api` file |
+| `http/` | `source.http` | API plus a test that calls it |
+| `bruno/` | `source.bru` | API plus a test that calls it |
+
+All live HTTP examples target [test.mmt.dev](https://test.mmt.dev).
+
+For the full sandbox endpoint set across every format (OpenAPI, HTTP, Bruno, Postman, WSDL), see [professional convert](../../professional/04_convert_to_mmt/).

package/dist/examples/intermediate/25_convert_to_mmt/bruno/README.md

@@ -0,0 +1,5 @@
+# Bruno convert (basic)
+
+`source.bru` is a one-request Bruno file. **Convert to MMT...** produces an API file and a test that calls it under `converted/`.
+
+See the [convert overview](../README.md) for the other formats.

package/dist/examples/intermediate/25_convert_to_mmt/bruno/converted/api/create-user.mmt

@@ -0,0 +1,11 @@
+type: api
+title: Create user
+tags:
+  - bruno
+url: https://test.mmt.dev/echo
+method: post
+format: json
+headers:
+  Content-Type: application/json
+body:
+  name: Ada