@cavuno/board 4.48.0 → 4.49.0

package/skills/cavuno-board-jobs/SKILL.md

@@ -20,9 +20,9 @@ widget uses `embed.jobs`.
 
 `JobsListQuery` accepts `limit` (1–100), `cursor`, `offset`, `companyId`,
 `companySlug`, `remoteOption`, `employmentType`, `seniority`, `location` with
-`radius` in kilometres, `category`, and `skill`. Repeated `seniority` values
-are OR-matched. `offset` takes precedence over `cursor`, so choose one paging
-mode per request.
+`radius` in kilometres or `defaultRadius`, `category`, and `skill`. Repeated
+`seniority` values are OR-matched. `offset` takes precedence over `cursor`, so
+choose one paging mode per request.
 
 ```ts snippet
 const first = await board.jobs.list({
@@ -58,6 +58,24 @@ const page = await board.jobs.list({
 });
 ```
 
+### List a location page in one request
+
+`defaultRadius: true` with a `location` and no `radius` widens a city or
+locality to the market default distance: 25 miles (40.2336 km) in the US, GB,
+LR and MM, 50 km elsewhere. Regions, countries and places without coordinates
+are not widened, and an explicit `radius` wins. The server picks the distance
+from the place it already resolves, so a location page can fetch its jobs in
+parallel with `taxonomy.places.resolve` instead of after it. `jobs.search` takes the
+same flag in `filters`.
+
+```ts snippet
+const nearby = await board.jobs.list({
+  location: 'houston-texas-united-states',
+  defaultRadius: true,
+  limit: 20,
+});
+```
+
 ## Search
 
 `jobs.search` posts `JobsSearchBody`: free-text `query`, structured `filters`,
@@ -88,6 +106,18 @@ job.company?.slug;
 const rail = await board.jobs.similar('senior-chef', { limit: 5 });
 ```
 
+A starter that renders the country-gated Apply flow opts in per request with
+`capabilities: ['apply-gateway-v1']`. The opt-in travels in the URL, so the
+response stays shared-cacheable. The older `x-cavuno-board-capabilities`
+header returns the same body but is never cached.
+
+```ts snippet
+const gated = await board.jobs.retrieve('senior-chef', {
+  capabilities: ['apply-gateway-v1'],
+});
+gated.applyAction; // 'gateway_external' | 'gateway_native' | …
+```
+
 ## Surface candidate gating
 
 On a gated board, `gatedCount` reports results withheld from the current

package/skills/cavuno-board-setup/SKILL.md

@@ -82,6 +82,19 @@ Pause with a concrete blocker when the board identifier or a required test crede
 
 **Complete when:** doctor, direct API probes, implemented-surface checks, and the production-build probe all pass or each skipped credentialed check is reported.
 
+## Reporting problems
+
+When Cavuno itself gets in the way (a missing capability, unclear or wrong documentation, a surprising response, an unhelpful error, a bug or slow performance), report it, even if you found a workaround. `POST https://api.cavuno.com/v1/feedback` accepts [Agent Feedback Protocol v0.1](https://trybackloop.com/spec/) reports without credentials; the discovery document is at `https://api.cavuno.com/.well-known/agent-feedback`.
+
+```bash
+curl https://api.cavuno.com/v1/feedback \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -d '{ "type": "unclear_documentation", "goal": "What you were trying to do", "message": "What got in the way", "agent": { "name": "my-agent", "model": "model-name" } }'
+```
+
+`type`, `goal` and `message` are required; fill `agent.name` and `agent.model`. Up to 20 reports every 5 minutes. Never include credentials, `pk_…` keys, personal data or your user's private content. Send the report, then continue with the task.
+
 ## Cavuno SDK reference
 
 For setup and API details beyond this workflow, use the [Cavuno Board SDK documentation](https://cavuno.com/docs/sdk).

package/skills/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.48.0",
+  "version": "4.49.0",
   "skills": [
     {
       "name": "cavuno-board-account",