squally-mcp 0.6.0 → 0.6.1
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 +3 -3
- package/dist/openapi/v1.json +3 -3
- package/dist/tools.js +4 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -28,8 +28,8 @@ agent can read:
|
|
|
28
28
|
request, job key, a link to the CI run, timing, pass/fail counts;
|
|
29
29
|
- **per-test results** for a run, including which shard ran what;
|
|
30
30
|
- for a failing attempt: the **error message and stack**, the **code snippet**
|
|
31
|
-
— **verbatim source code from your test file** — and the **
|
|
32
|
-
prompt
|
|
31
|
+
— **verbatim source code from your test file** — and the **full-context
|
|
32
|
+
prompt** (the text behind Copy the full context in Squally), which carries the same snippet plus an **ARIA snapshot of your
|
|
33
33
|
application at the moment of failure** (whatever was on screen, truncated to
|
|
34
34
|
3000 characters);
|
|
35
35
|
- **per-test metrics**: how often each test passed on the first try, passed
|
|
@@ -140,7 +140,7 @@ squally-mcp trusts your operating system's certificate store, like your browser
|
|
|
140
140
|
| `squally-list-projects` | Which projects exist. **Start here** — every other tool needs a `projectId` from it. | cheap |
|
|
141
141
|
| `squally-find-run` | Which runs happened — latest, or by branch, commit SHA, status or source. Counters only. | cheap |
|
|
142
142
|
| `squally-get-run` | One run with its per-test rows, across all shards. Which test is red. | cheap |
|
|
143
|
-
| `squally-debug-failure` | Every attempt of one test in one run: error, stack,
|
|
143
|
+
| `squally-debug-failure` | Every attempt of one test in one run: error, stack, full-context prompt. | cheap |
|
|
144
144
|
| `squally-get-test-metrics` | One test's stability, flaky rate and failure rate over a period. | cheap — one test |
|
|
145
145
|
| `squally-list-tests` | Every test with a CI run in the period, ranked by stability, flaky rate or failures. | cheap — two queries, paged |
|
|
146
146
|
| `squally-list-errors` | Error signatures in a period: what keeps failing, grouped, and how its runs ended. | cheap |
|
package/dist/openapi/v1.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
|
|
4
4
|
"info": {
|
|
5
5
|
"title": "Squally Read API",
|
|
6
|
-
"version": "1.0.0-beta.
|
|
6
|
+
"version": "1.0.0-beta.16",
|
|
7
7
|
"description": "Read access to a Squally organization's test results, for scripts, CI jobs and AI agents.\n\n**Authentication.** Every request carries an organization read key as `Authorization: Bearer sqly_ro_…`. A read key is organization-wide (every project), created by an organization admin in Organization › Read keys, and expires after 30, 60, 90, 180 days as chosen at creation. There is no renewal: create a new key and revoke the old one. Project ingest keys (`sqly_…`) are refused with `wrong_key_type`.\n\n**Expiry warning.** From 7 days before a key expires, every authenticated response carries `Squally-Key-Expires-At` with the expiry instant (ISO-8601).\n\n**Rate limit.** Currently 60 requests per 60 seconds per key, counted per `Authorization` header - a read key has its own budget, shared with nothing else. Over the limit the edge answers 429 without a JSON body.\n\n**Retries.** 429: wait 60 seconds, then retry. The edge counts requests per key in 60-second windows and sends no Retry-After header. 5xx: retry with exponential backoff, starting at 1 second and capped at 30 seconds. 400, 401, 403, 404: never retry - the same request gets the same answer.\n\n**Plans.** The read API is part of the Standard and Pro plans. A key of an organization on Free is answered 403 `tier_too_low`; keys are not revoked on a downgrade and work again after an upgrade.\n\n**Errors.** Every error is `{\"error\": \"<sentence>\", \"code\": \"<slug>\"}`. The sentence may be reworded; the slug may not. An id that does not exist and an id that belongs to another organization get the same 404, byte for byte.\n\n**Test names in paths.** Test names are Playwright title paths and often contain `/`: URL-encode them, including `/` as `%2F`.\n\n**Sharded runs** are returned as one logical run: /runs lists one row per logical run, and the run routes answer for all shards whichever shard's id you pass.\n\n**Stability.** v1, beta. The API may change until the beta ends; every change is listed in the changelog (docs/openapi/CHANGELOG.md)."
|
|
8
8
|
},
|
|
9
9
|
"servers": [
|
|
@@ -3136,7 +3136,7 @@
|
|
|
3136
3136
|
"get": {
|
|
3137
3137
|
"operationId": "listErrors",
|
|
3138
3138
|
"summary": "List errors",
|
|
3139
|
-
"description": "List errors. The project's errors in a period - failures grouped by fingerprint - most frequent first, over the finished runs of the source (see population), all shards of a run one run. Every count covers the period; firstSeen is the first occurrence still stored, not bounded by it. Moderate: one aggregate query.",
|
|
3139
|
+
"description": "List errors. The project's errors in a period - failures grouped by fingerprint - most frequent first: by occurrences, then runs, then tests, ties by fingerprint, so a page never changes order between two requests over the same data. Over the finished runs of the source (see population), all shards of a run one run. Every count covers the period; firstSeen is the first occurrence still stored, not bounded by it. Moderate: one aggregate query, paged in the database.",
|
|
3140
3140
|
"tags": [
|
|
3141
3141
|
"Errors"
|
|
3142
3142
|
],
|
|
@@ -5628,7 +5628,7 @@
|
|
|
5628
5628
|
"type": "null"
|
|
5629
5629
|
}
|
|
5630
5630
|
],
|
|
5631
|
-
"description": "A prompt for an assistant that has the repository open, byte-identical to the Copy
|
|
5631
|
+
"description": "A prompt for an assistant that has the repository open, byte-identical to the text that Copy the full context puts on the clipboard (Debug with AI on the attempt page). null for an attempt without a real failure (a pass, a test.fail() marker, no error text)."
|
|
5632
5632
|
},
|
|
5633
5633
|
"shard": {
|
|
5634
5634
|
"anyOf": [
|
package/dist/tools.js
CHANGED
|
@@ -51,9 +51,10 @@ export const TOOLS = [
|
|
|
51
51
|
title: "Debug a failing test",
|
|
52
52
|
operationId: "getRunTestAttempts",
|
|
53
53
|
description: "Every attempt of one test in one run, oldest first, each with the error, the stack and " +
|
|
54
|
-
"the
|
|
54
|
+
"the full-context prompt (the same text Copy the full context puts on the clipboard in " +
|
|
55
|
+
"Squally's Debug with AI panel). This is the " +
|
|
55
56
|
"tool for 'why did this test fail'. If the test name is ambiguous, pass filePath.",
|
|
56
|
-
answers: "Every attempt of one test in one run: error, stack,
|
|
57
|
+
answers: "Every attempt of one test in one run: error, stack, full-context prompt.",
|
|
57
58
|
cost: "cheap",
|
|
58
59
|
},
|
|
59
60
|
{
|
|
@@ -91,7 +92,7 @@ export const TOOLS = [
|
|
|
91
92
|
},
|
|
92
93
|
{
|
|
93
94
|
name: "squally-list-errors",
|
|
94
|
-
title: "List
|
|
95
|
+
title: "List errors",
|
|
95
96
|
operationId: "listErrors",
|
|
96
97
|
description: "The project's error signatures in a period: failures grouped by fingerprint, with how " +
|
|
97
98
|
"often and how recently each occurred. Answers 'is this failure one instance of something " +
|