@statelyai/mcp 0.9.5 → 0.9.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -17
- package/dist/index.cjs +31 -12
- package/dist/index.d.cts +1 -1
- package/dist/index.d.mts +1 -1
- package/dist/index.mjs +32 -13
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -538,21 +538,21 @@ Tool errors carry a `code` from a closed set. An upstream `code` is only
|
|
|
538
538
|
preserved when it is one of these values; anything else falls back to the
|
|
539
539
|
default for the HTTP status class, so clients never see an invented code.
|
|
540
540
|
|
|
541
|
-
| Code
|
|
542
|
-
|
|
|
543
|
-
| `bad_request`
|
|
544
|
-
| `unauthenticated`
|
|
545
|
-
| `forbidden`
|
|
546
|
-
| `not_found`
|
|
547
|
-
| `conflict`
|
|
548
|
-
| `payload_too_large`
|
|
549
|
-
| `rate_limited`
|
|
550
|
-
| `capability_disabled` | The operation is not enabled on this deployment.
|
|
551
|
-
| `upstream_error`
|
|
552
|
-
| `internal_error`
|
|
553
|
-
| `upstream_timeout`
|
|
554
|
-
| `invalid_input`
|
|
555
|
-
| `input_too_large`
|
|
541
|
+
| Code | Meaning |
|
|
542
|
+
| --------------------- | ------------------------------------------------------------- |
|
|
543
|
+
| `bad_request` | Malformed request, and the default for unmapped 4xx statuses. |
|
|
544
|
+
| `unauthenticated` | Missing or rejected credentials (HTTP 401). |
|
|
545
|
+
| `forbidden` | Authenticated but not allowed (HTTP 403). |
|
|
546
|
+
| `not_found` | No such project, machine, or route (HTTP 404). |
|
|
547
|
+
| `conflict` | Version or state conflict (HTTP 409). |
|
|
548
|
+
| `payload_too_large` | Upstream rejected the request size (HTTP 413). |
|
|
549
|
+
| `rate_limited` | Too many requests (HTTP 429). |
|
|
550
|
+
| `capability_disabled` | The operation is not enabled on this deployment. |
|
|
551
|
+
| `upstream_error` | Server-side HTTP failure, and the default for 5xx statuses. |
|
|
552
|
+
| `internal_error` | Unhandled failure inside a tool handler. |
|
|
553
|
+
| `upstream_timeout` | The Stately API did not answer within `apiTimeoutMs`. |
|
|
554
|
+
| `invalid_input` | Local input validation failed before any API call. |
|
|
555
|
+
| `input_too_large` | Input exceeded `maxSourceBytes` before any API call. |
|
|
556
556
|
|
|
557
557
|
Migration: 4xx responses that previously surfaced an unrecognized upstream code
|
|
558
558
|
verbatim (or `upstream_error` from a proxy) now report the status-class default
|
|
@@ -577,6 +577,9 @@ Self-host Stately Studio, then replace the hosted URL above with your
|
|
|
577
577
|
deployment's `/api/mcp` endpoint, for example
|
|
578
578
|
`https://studio.example.com/api/mcp`.
|
|
579
579
|
|
|
580
|
+
When the editor runs with `AUTH_PROVIDER=none`, MCP tool calls do not require a
|
|
581
|
+
bearer credential. Keep the endpoint behind your own trusted access boundary.
|
|
582
|
+
|
|
580
583
|
After deployment, run the protocol and MCP App canary with a read-only bearer
|
|
581
584
|
credential:
|
|
582
585
|
|
|
@@ -586,8 +589,9 @@ STATELY_MCP_CANARY_TOKEN=... pnpm verify:mcp:canary
|
|
|
586
589
|
```
|
|
587
590
|
|
|
588
591
|
It verifies tool discovery, fetches and hashes the advertised app template,
|
|
589
|
-
|
|
590
|
-
|
|
592
|
+
checks compatibility URLs used by previously created visualizations, and runs
|
|
593
|
+
a minimal visualization. The scheduled production workflow requires the
|
|
594
|
+
`STATELY_MCP_CANARY_TOKEN` repository secret and fails when it is absent.
|
|
591
595
|
|
|
592
596
|
For enterprise self-hosting options, [see pricing and contact
|
|
593
597
|
us](https://stately.ai/pricing).
|