@cavuno/board 4.48.0 → 4.50.0

package/dist/{jobs-oSTStcbC.d.mts → jobs-roZu2VmM.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-Fw9b79TI.mjs';
+import { S as Schemas } from './_spec-Dvlsj5V6.js';
 
 /**
  * Optional pagination metadata returned by Board API list operations.
@@ -111,9 +111,21 @@ type JobsListQuery = {
     /**
      * Widen a city or locality `location` to jobs placed in a city or
      * locality within this many km of it (1–250, decimals allowed). Omit for
-     * jobs in the place itself. Ignored for region and country places.
+     * jobs in the place itself. Ignored for region and country places. For a
+     * place from `taxonomy.places.suggest()`, an omitted radius uses the
+     * place's own default distance (15 km neighbourhood, 25 km town, 50 km city).
      */
     radius?: number;
+    /**
+     * With `location` and no `radius`: widen a city or locality to the market
+     * default distance (25 mi in the US, GB, LR and MM; 50 km elsewhere),
+     * computed from the resolved place. Regions and countries are not
+     * widened; an explicit `radius` wins. Saves resolving the place first to
+     * pick the radius. A place from `places.suggest` always uses its own
+     * default (15 km neighbourhood, 25 km town, 50 km city), with or without
+     * this flag.
+     */
+    defaultRadius?: boolean;
     /** Category slug seed (the `/jobs/[keyword]` page) — server resolves it to the English source name; unresolvable → 404. */
     category?: string;
     /** Skill slug seed (the `/jobs/skills/[skill]` page) — server-resolved; unresolvable → 404. */
@@ -121,6 +133,20 @@ type JobsListQuery = {
     /** Sparse fieldset (Medusa-style `+field`). Only `'+description'` is supported — adds `description` to each card. */
     fields?: string;
 };
+/**
+ * An opt-in capability token for `jobs.retrieve`. `apply-gateway-v1` selects
+ * the country-gated Apply shape (opaque Sponsored Apply).
+ */
+type JobCapability = 'apply-gateway-v1';
+type JobRetrieveQuery = {
+    /**
+     * Capability opt-ins, sent as the `capabilities` query parameter. Same
+     * effect as the `x-cavuno-board-capabilities` header, but the response
+     * stays shared-cacheable under its own URL; the header form is never
+     * cached.
+     */
+    capabilities?: JobCapability[];
+};
 type JobsSimilarQuery = {
     /** How many similar jobs to return (1–20; default 5). */
     limit?: number;
@@ -143,4 +169,4 @@ type ObjectReferenceFilter = {
  */
 type JobsSearchBody = Schemas['PublicSearchJobsBody'];
 
-export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, ObjectReferenceFilter as O, PublicJob as P, RemoteOption as R, Seniority as S, CustomFieldFilter as a, JobCollectionChoiceQuery as b, JobsListQuery as c, JobCardListEnvelope as d, JobsSearchBody as e, JobCardSearchEnvelope as f, JobsSimilarQuery as g, SearchEnvelope as h, CustomFieldValue as i, CustomFilterValue as j, EducationRequirement as k, JobCatalogPagination as l, JobCollectionChoiceList as m, JobCollectionFieldDefinition as n, JobCompany as o, JobCustomEmploymentType as p, OfficeLocation as q, OffsetPagination as r, PublicJobCard as s, RelatedSearch as t, RemotePermit as u, RemoteTimezone as v, ResolvedJobCollectionField as w, StorefrontPagination as x };
+export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, ObjectReferenceFilter as O, PublicJob as P, RemoteOption as R, Seniority as S, CustomFieldFilter as a, JobCollectionChoiceQuery as b, JobsListQuery as c, JobCardListEnvelope as d, JobRetrieveQuery as e, JobsSearchBody as f, JobCardSearchEnvelope as g, JobsSimilarQuery as h, SearchEnvelope as i, CustomFieldValue as j, CustomFilterValue as k, EducationRequirement as l, JobCapability as m, JobCatalogPagination as n, JobCollectionChoiceList as o, JobCollectionFieldDefinition as p, JobCompany as q, JobCustomEmploymentType as r, OfficeLocation as s, OffsetPagination as t, PublicJobCard as u, RelatedSearch as v, RemotePermit as w, RemoteTimezone as x, ResolvedJobCollectionField as y, StorefrontPagination as z };

package/dist/{search-CKvtGE6t.d.ts → search-DGuJBU-G.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-Fw9b79TI.js';
+import { S as Schemas } from './_spec-Dvlsj5V6.js';
 
 type Awaitable<T> = T | Promise<T>;
 /**

package/dist/{search-uiAE7AFt.d.mts → search-Dlo0GUG5.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-Fw9b79TI.mjs';
+import { S as Schemas } from './_spec-Dvlsj5V6.mjs';
 
 type Awaitable<T> = T | Promise<T>;
 /**

package/dist/{seo-Cz0544dX.d.mts → seo-BDZfybrw.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-Fw9b79TI.mjs';
+import { S as Schemas } from './_spec-Dvlsj5V6.mjs';
 
 /**
  * The public SEO-infra payload (`board.seo()`) — platform infrastructure a

package/dist/{seo-C2WvBFEi.d.ts → seo-DcrK1vzk.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-Fw9b79TI.js';
+import { S as Schemas } from './_spec-Dvlsj5V6.js';
 
 /**
  * The public SEO-infra payload (`board.seo()`) — platform infrastructure a

package/dist/seo-files.d.mts

@@ -1,5 +1,5 @@
-import { B as BoardSeo } from './seo-Cz0544dX.mjs';
-import './_spec-Fw9b79TI.mjs';
+import { B as BoardSeo } from './seo-BDZfybrw.mjs';
+import './_spec-Dvlsj5V6.mjs';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies

package/dist/seo-files.d.ts

@@ -1,5 +1,5 @@
-import { B as BoardSeo } from './seo-C2WvBFEi.js';
-import './_spec-Fw9b79TI.js';
+import { B as BoardSeo } from './seo-DcrK1vzk.js';
+import './_spec-Dvlsj5V6.js';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies

package/dist/seo.d.mts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-Dlyky5Eo.mjs';
-import { e as JsonLdObject } from './breadcrumbs-Bj8SieZi.mjs';
-export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-Bj8SieZi.mjs';
-import './_spec-Fw9b79TI.mjs';
-import './board-DkwbMZdt.mjs';
-import './jobs-oSTStcbC.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DhlbCKam.mjs';
+import { e as JsonLdObject } from './breadcrumbs-212hOj5L.mjs';
+export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-212hOj5L.mjs';
+import './_spec-Dvlsj5V6.mjs';
+import './board-CIbqqcEg.mjs';
+import './jobs-NgZT_lvs.mjs';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/seo.d.ts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DldIXX6n.js';
-import { e as JsonLdObject } from './breadcrumbs-CzFiddAt.js';
-export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-CzFiddAt.js';
-import './_spec-Fw9b79TI.js';
-import './board-B1Ueww2w.js';
-import './jobs-rnatMRvm.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-WtDJZV-Z.js';
+import { e as JsonLdObject } from './breadcrumbs-B0QBK24H.js';
+export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-B0QBK24H.js';
+import './_spec-Dvlsj5V6.js';
+import './board-BiKb5_ZM.js';
+import './jobs-roZu2VmM.js';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/server.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-Fw9b79TI.mjs';
-import './search-uiAE7AFt.mjs';
-import './jobs-oSTStcbC.mjs';
-import './board-DkwbMZdt.mjs';
-import './seo-Cz0544dX.mjs';
-import './blog-Dlyky5Eo.mjs';
+import './_spec-Dvlsj5V6.mjs';
+import './search-Dlo0GUG5.mjs';
+import './jobs-NgZT_lvs.mjs';
+import './board-CIbqqcEg.mjs';
+import './seo-BDZfybrw.mjs';
+import './blog-DhlbCKam.mjs';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/server.d.ts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.js';
-import './_spec-Fw9b79TI.js';
-import './search-CKvtGE6t.js';
-import './jobs-rnatMRvm.js';
-import './board-B1Ueww2w.js';
-import './seo-C2WvBFEi.js';
-import './blog-DldIXX6n.js';
+import './_spec-Dvlsj5V6.js';
+import './search-DGuJBU-G.js';
+import './jobs-roZu2VmM.js';
+import './board-BiKb5_ZM.js';
+import './seo-DcrK1vzk.js';
+import './blog-WtDJZV-Z.js';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/sitemap.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-Fw9b79TI.mjs';
-import './search-uiAE7AFt.mjs';
-import './jobs-oSTStcbC.mjs';
-import './board-DkwbMZdt.mjs';
-import './seo-Cz0544dX.mjs';
-import './blog-Dlyky5Eo.mjs';
+import './_spec-Dvlsj5V6.mjs';
+import './search-Dlo0GUG5.mjs';
+import './jobs-NgZT_lvs.mjs';
+import './board-CIbqqcEg.mjs';
+import './seo-BDZfybrw.mjs';
+import './blog-DhlbCKam.mjs';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.d.ts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.js';
-import './_spec-Fw9b79TI.js';
-import './search-CKvtGE6t.js';
-import './jobs-rnatMRvm.js';
-import './board-B1Ueww2w.js';
-import './seo-C2WvBFEi.js';
-import './blog-DldIXX6n.js';
+import './_spec-Dvlsj5V6.js';
+import './search-DGuJBU-G.js';
+import './jobs-roZu2VmM.js';
+import './board-BiKb5_ZM.js';
+import './seo-DcrK1vzk.js';
+import './blog-WtDJZV-Z.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-uiAE7AFt.mjs';
-import './_spec-Fw9b79TI.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-Dlo0GUG5.mjs';
+import './_spec-Dvlsj5V6.mjs';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/suggest.d.ts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-CKvtGE6t.js';
-import './_spec-Fw9b79TI.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-DGuJBU-G.js';
+import './_spec-Dvlsj5V6.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavuno/board",
-  "version": "4.48.0",
+  "version": "4.50.0",
   "description": "Build custom job boards and careers pages with Cavuno’s TypeScript SDK.",
   "keywords": [
     "api-client",

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.50.0",
   "skills": [
     {
       "name": "cavuno-board-account",