@cavuno/board 4.48.0 → 4.50.0

package/CHANGELOG.md

@@ -3,6 +3,36 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.50.0 — 2026-10-19
+
+- New `board.taxonomy.places.suggest({ q, near, limit })`
+  (`GET /places/suggest`): suggests any town, city or neighbourhood by name,
+  not only places the board's jobs use, on boards where place search is on.
+  Pass `near` (`{ lat, lng }`, the visitor's approximate location) to rank
+  nearby places first. Each result is a `PublicPlace` with `jobCount` 0. Its
+  `slug` resolves with `board.taxonomy.places.resolve()` and works as the jobs
+  `location` filter, which then searches a radius around the place; without
+  `radius` that is 15 km for a neighbourhood, 25 km for a town and 50 km for a
+  city. A suggested place's `id` is not a `locationId` for job posting or
+  profiles. Where place search is off, `suggest` returns an empty list.
+- The board context has `features.placeSuggestions`: `true` where suggestions
+  are on. Check it before calling `suggest`.
+- A jobs, search or talent request whose `location` is a suggested place
+  returns 503 `locations_unavailable` when the place cannot be looked up
+  right now.
+- Removing an employer pipeline stage that still holds applicants returns 422
+  `employer_ats_unprocessable`; move the applicants to another stage first.
+
+## 4.49.0 — 2026-10-17
+
+- The generated API types include `submitAgentFeedback` (`POST /v1/feedback`):
+  coding agents can report anything in the Board API or SDK that got in their
+  way, as an Agent Feedback Protocol v0.1 report. No credentials are needed;
+  the discovery document is at
+  `https://api.cavuno.com/.well-known/agent-feedback`.
+- The README and the `cavuno-board-setup` skill explain how to report a
+  problem.
+
 ## 4.48.0 — 2026-10-15
 
 - Each `placeHierarchy` entry on `board.jobs.retrieve()` has a

package/README.md

@@ -119,6 +119,25 @@ Then ask your agent to set up the Cavuno board using the installed
 [Set up with an agent](https://cavuno.com/docs/sdk/installing/agent)
 for the review and verification workflow.
 
+## Reporting problems
+
+Coding agents (and people) can report anything in the Board API or SDK that
+got in the way: a missing capability, unclear documentation, a surprising
+response or an unhelpful error. Send an
+[Agent Feedback Protocol v0.1](https://trybackloop.com/spec/) report to
+`POST https://api.cavuno.com/v1/feedback`; no credentials are needed, and 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": "missing_capability", "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. Up to 20 reports every 5 minutes.
+Never include credentials or personal data.
+
 ## Resources
 
 - [SDK guides and reference](https://cavuno.com/docs/sdk)

package/dist/{_spec-Fw9b79TI.d.mts → _spec-Dvlsj5V6.d.mts}

@@ -2009,6 +2009,8 @@ interface components {
                 avgSalaryMin: number;
                 avgSalaryMax: number;
                 jobCount: number;
+                /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
+                currency?: string;
             }[];
         };
         LocationTitlesIndex: {
@@ -2023,6 +2025,8 @@ interface components {
                 avgSalaryMin: number;
                 avgSalaryMax: number;
                 jobCount: number;
+                /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
+                currency?: string;
             }[];
         };
         MarketSuggestion: {
@@ -2425,6 +2429,8 @@ interface components {
                 messaging: boolean;
                 /** @description Whether the board's public contact form is live. Matches `enabled` on `GET /v1/boards/{identifier}/contact`, so chrome can decide whether to link to the contact page from this context alone. When `false`, `POST /contact` rejects. */
                 contactPage: boolean;
+                /** @description Whether `GET /v1/boards/{identifier}/places/suggest` suggests any place on this board (cities, towns and suburbs beyond the board's own places). When `false` it returns an empty list: offer only the board's places (`GET /places?q=`) and do not call it. */
+                placeSuggestions: boolean;
             };
             /**
              * @description How the operator charges employers for the candidate directory. `paid_messaging` leaves profiles fully visible and spends a credit on a first cold message; `paid_unlocks_and_messaging` also redacts directory cards and gates the opaque `/p/{id}` profile route behind an unlock credit. `null` means the operator has not chosen explicitly, in which case infer it from the published `talent_access` plans: any plan granting profile unlocks means `paid_unlocks_and_messaging`, otherwise `paid_messaging`. The paywall is inert regardless when the board publishes no talent plan. An anonymous viewer has no entitlement read to derive this from, so it ships here rather than only on `me/talent-access`.
@@ -2948,10 +2954,12 @@ interface components {
                      */
                     lte?: string;
                 };
-                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). Pass `radius` to widen a city or locality to nearby jobs. Unresolvable slugs are ignored. */
+                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). Pass `radius` to widen a city or locality to nearby jobs. A place slug from `GET /places/suggest` returns jobs within `radius` km of that place, by default a distance that suits its size. Unresolvable slugs are ignored. */
                 location?: string;
-                /** @description Widen a city or locality `location` to also return jobs placed in a city or locality within this many kilometres of the place (1–250; decimals allowed, e.g. `8.05` for 5 miles). Omit for jobs in the place itself. Ignored for region and country places, and without `location`. */
+                /** @description Widen a city or locality `location` to also return jobs placed in a city or locality within this many kilometres of the place (1–250; decimals allowed, e.g. `8.05` for 5 miles). Omit for jobs in the place itself. Ignored for region and country places, and without `location`. For a place from `GET /places/suggest`, an omitted `radius` uses the place's own default distance: 15 km for a neighbourhood, 25 km for a town, 50 km for a city. */
                 radius?: number;
+                /** @description When `true` and `radius` is omitted, widen a city or locality `location` to the market default distance, computed from the resolved place: 25 miles (40.2336 km) in the US, GB, LR and MM, 50 km elsewhere. Regions, countries and places without coordinates are not widened. An explicit `radius` wins. A place from `places/suggest` always uses its own default (15 km neighbourhood, 25 km town, 50 km city), with or without `defaultRadius`. */
+                defaultRadius?: boolean;
                 /** @description Public custom job fields. Clauses are AND-matched; values within a clause are OR-matched. Up to 10 clauses and 10 values per clause. */
                 customFields?: {
                     key: string;
@@ -3295,6 +3303,8 @@ interface components {
             avgSalaryMin: number;
             avgSalaryMax: number;
             jobCount: number;
+            /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
+            currency?: string;
         };
         SalarySkillIndexItem: {
             /** @enum {string} */

package/dist/{_spec-Fw9b79TI.d.ts → _spec-Dvlsj5V6.d.ts}

@@ -2009,6 +2009,8 @@ interface components {
                 avgSalaryMin: number;
                 avgSalaryMax: number;
                 jobCount: number;
+                /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
+                currency?: string;
             }[];
         };
         LocationTitlesIndex: {
@@ -2023,6 +2025,8 @@ interface components {
                 avgSalaryMin: number;
                 avgSalaryMax: number;
                 jobCount: number;
+                /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
+                currency?: string;
             }[];
         };
         MarketSuggestion: {
@@ -2425,6 +2429,8 @@ interface components {
                 messaging: boolean;
                 /** @description Whether the board's public contact form is live. Matches `enabled` on `GET /v1/boards/{identifier}/contact`, so chrome can decide whether to link to the contact page from this context alone. When `false`, `POST /contact` rejects. */
                 contactPage: boolean;
+                /** @description Whether `GET /v1/boards/{identifier}/places/suggest` suggests any place on this board (cities, towns and suburbs beyond the board's own places). When `false` it returns an empty list: offer only the board's places (`GET /places?q=`) and do not call it. */
+                placeSuggestions: boolean;
             };
             /**
              * @description How the operator charges employers for the candidate directory. `paid_messaging` leaves profiles fully visible and spends a credit on a first cold message; `paid_unlocks_and_messaging` also redacts directory cards and gates the opaque `/p/{id}` profile route behind an unlock credit. `null` means the operator has not chosen explicitly, in which case infer it from the published `talent_access` plans: any plan granting profile unlocks means `paid_unlocks_and_messaging`, otherwise `paid_messaging`. The paywall is inert regardless when the board publishes no talent plan. An anonymous viewer has no entitlement read to derive this from, so it ships here rather than only on `me/talent-access`.
@@ -2948,10 +2954,12 @@ interface components {
                      */
                     lte?: string;
                 };
-                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). Pass `radius` to widen a city or locality to nearby jobs. Unresolvable slugs are ignored. */
+                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). Pass `radius` to widen a city or locality to nearby jobs. A place slug from `GET /places/suggest` returns jobs within `radius` km of that place, by default a distance that suits its size. Unresolvable slugs are ignored. */
                 location?: string;
-                /** @description Widen a city or locality `location` to also return jobs placed in a city or locality within this many kilometres of the place (1–250; decimals allowed, e.g. `8.05` for 5 miles). Omit for jobs in the place itself. Ignored for region and country places, and without `location`. */
+                /** @description Widen a city or locality `location` to also return jobs placed in a city or locality within this many kilometres of the place (1–250; decimals allowed, e.g. `8.05` for 5 miles). Omit for jobs in the place itself. Ignored for region and country places, and without `location`. For a place from `GET /places/suggest`, an omitted `radius` uses the place's own default distance: 15 km for a neighbourhood, 25 km for a town, 50 km for a city. */
                 radius?: number;
+                /** @description When `true` and `radius` is omitted, widen a city or locality `location` to the market default distance, computed from the resolved place: 25 miles (40.2336 km) in the US, GB, LR and MM, 50 km elsewhere. Regions, countries and places without coordinates are not widened. An explicit `radius` wins. A place from `places/suggest` always uses its own default (15 km neighbourhood, 25 km town, 50 km city), with or without `defaultRadius`. */
+                defaultRadius?: boolean;
                 /** @description Public custom job fields. Clauses are AND-matched; values within a clause are OR-matched. Up to 10 clauses and 10 values per clause. */
                 customFields?: {
                     key: string;
@@ -3295,6 +3303,8 @@ interface components {
             avgSalaryMin: number;
             avgSalaryMax: number;
             jobCount: number;
+            /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
+            currency?: string;
         };
         SalarySkillIndexItem: {
             /** @enum {string} */

package/dist/{blog-Dlyky5Eo.d.mts → blog-DhlbCKam.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-Fw9b79TI.mjs';
+import { S as Schemas } from './_spec-Dvlsj5V6.mjs';
 
 /** Author shape embedded on posts (no `object` discriminator). */
 type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];

package/dist/{blog-DldIXX6n.d.ts → blog-WtDJZV-Z.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-Fw9b79TI.js';
+import { S as Schemas } from './_spec-Dvlsj5V6.js';
 
 /** Author shape embedded on posts (no `object` discriminator). */
 type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];

package/dist/{board-B1Ueww2w.d.ts → board-BiKb5_ZM.d.ts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-Fw9b79TI.js';
-import { L as ListEnvelope, t as RelatedSearch, a as CustomFieldFilter, O as ObjectReferenceFilter } from './jobs-rnatMRvm.js';
+import { S as Schemas } from './_spec-Dvlsj5V6.js';
+import { L as ListEnvelope, v as RelatedSearch, a as CustomFieldFilter, O as ObjectReferenceFilter } from './jobs-roZu2VmM.js';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */

package/dist/{board-DkwbMZdt.d.mts → board-CIbqqcEg.d.mts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-Fw9b79TI.mjs';
-import { L as ListEnvelope, t as RelatedSearch, a as CustomFieldFilter, O as ObjectReferenceFilter } from './jobs-oSTStcbC.mjs';
+import { S as Schemas } from './_spec-Dvlsj5V6.mjs';
+import { L as ListEnvelope, v as RelatedSearch, a as CustomFieldFilter, O as ObjectReferenceFilter } from './jobs-NgZT_lvs.mjs';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */

package/dist/{breadcrumbs-Bj8SieZi.d.mts → breadcrumbs-212hOj5L.d.mts}

@@ -1,5 +1,5 @@
-import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-DkwbMZdt.mjs';
-import { P as PublicJob } from './jobs-oSTStcbC.mjs';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-CIbqqcEg.mjs';
+import { P as PublicJob } from './jobs-NgZT_lvs.mjs';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any

package/dist/{breadcrumbs-CzFiddAt.d.ts → breadcrumbs-B0QBK24H.d.ts}

@@ -1,5 +1,5 @@
-import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-B1Ueww2w.js';
-import { P as PublicJob } from './jobs-rnatMRvm.js';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-BiKb5_ZM.js';
+import { P as PublicJob } from './jobs-roZu2VmM.js';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any