Skip to content

Commit 34e486b

Browse files
docs(skill): complete API response refs + note network assertions cover made calls
- SKILL.md "Calling APIs directly" now shows the full reference set ({{name.status}}, {{name.response_body}}, {{name.response_body.<field>}}). - Network assertions doc + cookbook §3.2 + kiro Network row now note that network assertions also cover API calls you make directly in an objective, not just the requests the page makes on its own. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent deb628e commit 34e486b

8 files changed

Lines changed: 11 additions & 5 deletions

File tree

.agents/skills/kane-cli/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,7 @@ The agent can make API calls itself — not just observe the page's traffic. Phr
228228
assert {{login.status}} is 200"
229229
```
230230

231-
Reference the saved response as `{{login.status}}` and `{{login.response_body.<field>}}`; a pasted `curl` works too. Full grammar (curl, chaining, direct-call vs DevTools/Network) is in `references/objectives-cookbook.md` §3.5.
231+
Reference the saved response as `{{login.status}}`, `{{login.response_body}}`, or `{{login.response_body.<field>}}`; a pasted `curl` works too. Full grammar in `references/objectives-cookbook.md` §3.5.
232232

233233
### Chaining
234234

.agents/skills/kane-cli/references/objectives-cookbook.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,8 @@ Five subdomains. Each one is the right choice when the data you care about lives
8181

8282
The agent captures every HTTP request/response per step. **Resets each step** — assert on traffic in the same step it happens (or extract and carry forward).
8383

84+
These assertions also cover API calls **you** make directly in an objective (§3.5), not just the requests the page makes on its own — the agent records its own calls and you query them with the same fields below.
85+
8486
Queryable fields: `method`, `url`, `domain`, `path`, `query_params`, `resource_type`, `request_headers`, `request_body`, `response_status`, `response_headers`, `response_body`, `timing.duration_ms`, `timing.ttfb_ms`, `failed`, `failure_reason`.
8587

8688
```text

.claude/skills/kane-cli/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,7 @@ The agent can make API calls itself — not just observe the page's traffic. Phr
228228
assert {{login.status}} is 200"
229229
```
230230

231-
Reference the saved response as `{{login.status}}` and `{{login.response_body.<field>}}`; a pasted `curl` works too. Full grammar (curl, chaining, direct-call vs DevTools/Network) is in `references/objectives-cookbook.md` §3.5.
231+
Reference the saved response as `{{login.status}}`, `{{login.response_body}}`, or `{{login.response_body.<field>}}`; a pasted `curl` works too. Full grammar in `references/objectives-cookbook.md` §3.5.
232232

233233
### Chaining
234234

.claude/skills/kane-cli/references/objectives-cookbook.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,8 @@ Five subdomains. Each one is the right choice when the data you care about lives
8181

8282
The agent captures every HTTP request/response per step. **Resets each step** — assert on traffic in the same step it happens (or extract and carry forward).
8383

84+
These assertions also cover API calls **you** make directly in an objective (§3.5), not just the requests the page makes on its own — the agent records its own calls and you query them with the same fields below.
85+
8486
Queryable fields: `method`, `url`, `domain`, `path`, `query_params`, `resource_type`, `request_headers`, `request_body`, `response_status`, `response_headers`, `response_body`, `timing.duration_ms`, `timing.ttfb_ms`, `failed`, `failure_reason`.
8587

8688
```text

docs/user-guide/features/checkpoints/devtools/network.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Network assertions let you verify HTTP traffic — API responses, status codes, headers, response bodies, and request timing.
44

5-
> To **make** an API call yourself (seed data, hit a backend) rather than observe the page's traffic, see [API Calls](../../api-calls.md).
5+
> These network assertions also cover API calls **you** make directly in an objective — not just the requests the page makes on its own. The agent records its own calls and you query them with the same fields below. To *make* a call (seed data, hit a backend), see [API Calls](../../api-calls.md).
66
77
## How Capture Works
88

integrations/kiro-powers/steering/kane-cli-run.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@ Five domains. Each captures data the user cannot see on screen. The agent picks
116116

117117
| Subdomain | Captures | Scope | Common phrasing |
118118
|---|---|---|---|
119-
| **Network** | HTTP requests/responses — status codes, headers, response bodies, timing | Resets each step | "no API calls returned 5xx", "the POST /api/login returned 200", "all API responses completed under 2 seconds" |
119+
| **Network** | HTTP requests/responses, incl. API calls you make directly — status codes, headers, response bodies, timing | Resets each step | "no API calls returned 5xx", "the POST /api/login returned 200", "all API responses completed under 2 seconds" |
120120
| **Console** | `console.log/warn/error/info/debug` + uncaught JS exceptions | Resets each step. Top frame only | "no console errors", "no uncaught JS exceptions", "console contains '…'" |
121121
| **Performance** | Core Web Vitals — LCP, CLS, INP, FCP, TTFB | Per-navigation, point-in-time | "page LCP is under 2500ms", "CLS is below 0.1", "TTFB under 800ms" |
122122
| **Cookies** | All cookies including `httpOnly` — name, value, flags | Point-in-time, persists across steps | "a cookie named 'session_id' exists", "the session cookie is httpOnly", "no cookies without the Secure flag" |

skill-installer/skills/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,7 @@ The agent can make API calls itself — not just observe the page's traffic. Phr
228228
assert {{login.status}} is 200"
229229
```
230230

231-
Reference the saved response as `{{login.status}}` and `{{login.response_body.<field>}}`; a pasted `curl` works too. Full grammar (curl, chaining, direct-call vs DevTools/Network) is in `references/objectives-cookbook.md` §3.5.
231+
Reference the saved response as `{{login.status}}`, `{{login.response_body}}`, or `{{login.response_body.<field>}}`; a pasted `curl` works too. Full grammar in `references/objectives-cookbook.md` §3.5.
232232

233233
### Chaining
234234

skill-installer/skills/references/objectives-cookbook.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,8 @@ Five subdomains. Each one is the right choice when the data you care about lives
8181

8282
The agent captures every HTTP request/response per step. **Resets each step** — assert on traffic in the same step it happens (or extract and carry forward).
8383

84+
These assertions also cover API calls **you** make directly in an objective (§3.5), not just the requests the page makes on its own — the agent records its own calls and you query them with the same fields below.
85+
8486
Queryable fields: `method`, `url`, `domain`, `path`, `query_params`, `resource_type`, `request_headers`, `request_body`, `response_status`, `response_headers`, `response_body`, `timing.duration_ms`, `timing.ttfb_ms`, `failed`, `failure_reason`.
8587

8688
```text

0 commit comments

Comments
 (0)