@cavuno/board 4.9.0 → 4.10.0

package/dist/index.mjs

@@ -15,7 +15,7 @@ import {
   isValidationError,
   resolveStorage,
   writeSession
-} from "./chunk-T46JASKG.mjs";
+} from "./chunk-XEJWXRLK.mjs";
 import {
   paginate
 } from "./chunk-DLSO6XXY.mjs";
@@ -39,7 +39,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.9.0";
+var SDK_VERSION = "4.10.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -1547,6 +1547,29 @@ function meNamespace(client) {
           );
         }
       },
+      /**
+       * Stripe Customer Portal for a company I am an approved member of.
+       * Surfaces every subscription on the company's Stripe customer (job
+       * posting + talent access). Not a talent-access portal — candidate
+       * `me.access.portal` is a different buyer.
+       */
+      billingPortal: {
+        /**
+         * Mint a Stripe Customer Portal session. Optional `returnPath` is
+         * resolved against the board origin.
+         *
+         * @example
+         * const { url } = await board.me.companies.billingPortal.create('acme', {
+         *   returnPath: '/employers/billing',
+         * });
+         */
+        create(slug, body, options) {
+          return client.fetch(
+            `/me/companies/${encodeURIComponent(slug)}/billing-portal`,
+            { ...options, method: "POST", body }
+          );
+        }
+      },
       /**
        * The read-only reporting funnel that backs the hosted employer jobs
        * table: per-job views / apply clicks / native applications,
@@ -1811,9 +1834,11 @@ function meNamespace(client) {
       }
     },
     /**
-     * The viewer's talent entitlement on this board — "does this
-     * employer have talent access?" for gating a Message-vs-upsell CTA.
-     * Candidates and unaffiliated viewers get `hasTalentAccess: false`.
+     * The employer talent-access paywall — "does this employer have
+     * talent access?" plus remaining company-scoped unlock/message credits
+     * and the charging model. Candidates and unaffiliated viewers get
+     * `hasTalentAccess: false`. Message credits spend inline on
+     * `conversations.start` (no separate spend endpoint).
      *
      * @example
      * const { hasTalentAccess } = await board.me.talentAccess.retrieve();
@@ -1821,12 +1846,94 @@ function meNamespace(client) {
     talentAccess: {
       /**
        * Retrieve the viewer's talent entitlement. Never cache — per-user.
+       * Credits are company-scoped; `companyId` is set when the viewer has
+       * exactly one approved membership, otherwise `null` (pass `companyId`
+       * on writes — `company_required` with more than one).
        *
        * @example
        * const access = await board.me.talentAccess.retrieve();
        */
       retrieve(options) {
         return client.fetch("/me/talent-access", options);
+      },
+      /**
+       * Per-candidate unlock and credit state for the opaque `/p/{id}`
+       * profile route. Named `/p/{handle}` is the share bypass.
+       *
+       * @example
+       * const gate = await board.me.talentAccess.retrieveCandidate(candidateId);
+       */
+      retrieveCandidate(candidateId, options) {
+        return client.fetch(
+          `/me/talent-access/candidates/${encodeURIComponent(candidateId)}`,
+          options
+        );
+      },
+      /**
+       * Start embedded checkout for a public `talent_access` plan and return
+       * a connected-account mount kit. Same shape as candidate-access
+       * checkout; session metadata is `origin: talent_access`. `companyId`
+       * is required when the viewer has more than one approved membership
+       * (`company_required`).
+       *
+       * @example
+       * const kit = await board.me.talentAccess.checkout({
+       *   planId,
+       *   returnPath: '/employers',
+       *   colorMode: 'light',
+       * });
+       */
+      checkout(body, options) {
+        return client.fetch(
+          "/me/talent-access/checkout",
+          { ...options, method: "POST", body }
+        );
+      },
+      /**
+       * Poll a talent-access checkout session: `open` (re-mountable via
+       * `clientSecret`), `complete`, or `expired`. The session must be
+       * `origin: talent_access` for this board user.
+       *
+       * @example
+       * const s = await board.me.talentAccess.retrieveCheckout(kit.sessionId);
+       */
+      retrieveCheckout(sessionId, options) {
+        return client.fetch(
+          `/me/talent-access/checkout/${encodeURIComponent(sessionId)}`,
+          options
+        );
+      },
+      /**
+       * Spend one profile-unlock credit. Idempotent: already-unlocked
+       * returns `{ alreadyUnlocked: true }` with no decrement. Credits are
+       * company-scoped; `companyId` is required with multiple approved
+       * memberships (`company_required`).
+       *
+       * @example
+       * const unlock = await board.me.talentAccess.unlock({ candidateId });
+       */
+      unlock(body, options) {
+        return client.fetch("/me/talent-access/unlocks", {
+          ...options,
+          method: "POST",
+          body
+        });
+      },
+      /**
+       * Swap the company's primary talent_access subscription to `planId`
+       * in place (prorated). Never a second checkout — Checkout would mint
+       * a parallel subscription. Requires an existing talent_access sub.
+       * `companyId` is required with multiple approved memberships.
+       *
+       * @example
+       * await board.me.talentAccess.upgrade({ planId });
+       */
+      upgrade(body, options) {
+        return client.fetch("/me/talent-access/upgrade", {
+          ...options,
+          method: "POST",
+          body
+        });
       }
     },
     /**

package/dist/{jobs-Iv6Wkvvf.d.ts → jobs-B-uO7ffG.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B9Ah8dNs.js';
+import { S as Schemas } from './_spec-BwUP7Wni.js';
 
 /**
  * Optional pagination metadata returned by Board API list operations.

package/dist/{jobs-B7q3BgIK.d.mts → jobs-BToqhRuU.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B9Ah8dNs.mjs';
+import { S as Schemas } from './_spec-BwUP7Wni.mjs';
 
 /**
  * Optional pagination metadata returned by Board API list operations.

package/dist/{search-DC0jatQN.d.mts → search-CvwKD0Va.d.mts}

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

package/dist/{search-CbDZwdyl.d.ts → search-Sl9-xi1z.d.ts}

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

package/dist/{seo-HCE7aCkh.d.mts → seo-B9b2AkSE.d.mts}

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

package/dist/{seo-BDFUuvXM.d.ts → seo-D1Vc_0HF.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B9Ah8dNs.js';
+import { S as Schemas } from './_spec-BwUP7Wni.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-HCE7aCkh.mjs';
-import './_spec-B9Ah8dNs.mjs';
+import { B as BoardSeo } from './seo-B9b2AkSE.mjs';
+import './_spec-BwUP7Wni.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-BDFUuvXM.js';
-import './_spec-B9Ah8dNs.js';
+import { B as BoardSeo } from './seo-D1Vc_0HF.js';
+import './_spec-BwUP7Wni.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-BmqWfLZi.mjs';
-import { e as JsonLdObject } from './breadcrumbs-BVQL2dNY.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-BVQL2dNY.mjs';
-import './_spec-B9Ah8dNs.mjs';
-import './board-B4jLqmxn.mjs';
-import './jobs-B7q3BgIK.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-C_xXYOxc.mjs';
+import { e as JsonLdObject } from './breadcrumbs-BK7AqNp2.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-BK7AqNp2.mjs';
+import './_spec-BwUP7Wni.mjs';
+import './board-CG8rDGTY.mjs';
+import './jobs-BToqhRuU.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-bh07fZ8Q.js';
-import { e as JsonLdObject } from './breadcrumbs-B1HVufC7.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-B1HVufC7.js';
-import './_spec-B9Ah8dNs.js';
-import './board-De8nLbk7.js';
-import './jobs-Iv6Wkvvf.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DC4BfQqF.js';
+import { e as JsonLdObject } from './breadcrumbs-qs9DC0yh.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-qs9DC0yh.js';
+import './_spec-BwUP7Wni.js';
+import './board-zdQ875ck.js';
+import './jobs-B-uO7ffG.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-B9Ah8dNs.mjs';
-import './search-DC0jatQN.mjs';
-import './board-B4jLqmxn.mjs';
-import './jobs-B7q3BgIK.mjs';
-import './seo-HCE7aCkh.mjs';
-import './blog-BmqWfLZi.mjs';
+import './_spec-BwUP7Wni.mjs';
+import './search-CvwKD0Va.mjs';
+import './board-CG8rDGTY.mjs';
+import './jobs-BToqhRuU.mjs';
+import './seo-B9b2AkSE.mjs';
+import './blog-C_xXYOxc.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-B9Ah8dNs.js';
-import './search-CbDZwdyl.js';
-import './board-De8nLbk7.js';
-import './jobs-Iv6Wkvvf.js';
-import './seo-BDFUuvXM.js';
-import './blog-bh07fZ8Q.js';
+import './_spec-BwUP7Wni.js';
+import './search-Sl9-xi1z.js';
+import './board-zdQ875ck.js';
+import './jobs-B-uO7ffG.js';
+import './seo-D1Vc_0HF.js';
+import './blog-DC4BfQqF.js';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/server.mjs

@@ -2,7 +2,7 @@ import {
   isNoStore,
   isUnauthorized,
   scopeToken
-} from "./chunk-T46JASKG.mjs";
+} from "./chunk-XEJWXRLK.mjs";
 
 // src/server/cookie.ts
 var COOKIE_ATTRIBUTES = "Path=/; HttpOnly; Secure; SameSite=Lax";

package/dist/sitemap.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-B9Ah8dNs.mjs';
-import './search-DC0jatQN.mjs';
-import './board-B4jLqmxn.mjs';
-import './jobs-B7q3BgIK.mjs';
-import './seo-HCE7aCkh.mjs';
-import './blog-BmqWfLZi.mjs';
+import './_spec-BwUP7Wni.mjs';
+import './search-CvwKD0Va.mjs';
+import './board-CG8rDGTY.mjs';
+import './jobs-BToqhRuU.mjs';
+import './seo-B9b2AkSE.mjs';
+import './blog-C_xXYOxc.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-B9Ah8dNs.js';
-import './search-CbDZwdyl.js';
-import './board-De8nLbk7.js';
-import './jobs-Iv6Wkvvf.js';
-import './seo-BDFUuvXM.js';
-import './blog-bh07fZ8Q.js';
+import './_spec-BwUP7Wni.js';
+import './search-Sl9-xi1z.js';
+import './board-zdQ875ck.js';
+import './jobs-B-uO7ffG.js';
+import './seo-D1Vc_0HF.js';
+import './blog-DC4BfQqF.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-DC0jatQN.mjs';
-import './_spec-B9Ah8dNs.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-CvwKD0Va.mjs';
+import './_spec-BwUP7Wni.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-CbDZwdyl.js';
-import './_spec-B9Ah8dNs.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-Sl9-xi1z.js';
+import './_spec-BwUP7Wni.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/package.json

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

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

@@ -64,6 +64,7 @@ Route each enabled capability to its focused skill:
 | Saved jobs and applications | `cavuno-board-applications` |
 | Messaging | `cavuno-board-messaging` |
 | Candidate paywall | `cavuno-board-paywall` |
+| Employer talent access | `cavuno-board-talent-access` |
 | Public job posting | `cavuno-board-post-a-job` |
 | Localized chrome | `cavuno-board-i18n` |
 | Metadata and structured data | `cavuno-board-seo` |

package/skills/cavuno-board-talent-access/SKILL.md

@@ -0,0 +1,149 @@
+---
+name: cavuno-board-talent-access
+description: Employer talent-access paywall with @cavuno/board. Use for charging models, remaining credits, per-candidate unlock gates, embedded checkout, in-place upgrades, or the company billing portal.
+---
+
+# Employer talent-access paywall
+
+Operators sell access to the candidate directory: profile-unlock credits and/or first-message credits. Credits are company-scoped. This is a different buyer from the candidate job-access paywall (`board.me.access.*`, skill `cavuno-board-paywall`).
+
+Two charging models (from `retrieve().accessModel`):
+
+- `paid_messaging` — full profiles; a first cold message spends a message credit.
+- `paid_unlocks_and_messaging` — directory cards redact; opaque `/p/{id}` requires an unlock credit; messaging stays credit-gated.
+
+When no public `talent_access` plan exists, `accessModel` is `none` and the paywall is inert.
+
+## Read the CTA and remaining credits
+
+`board.me.talentAccess.retrieve()` is the gating signal for a Message-vs-upsell CTA. Never cache it.
+
+```ts snippet
+const access = await board.me.talentAccess.retrieve();
+access.hasTalentAccess;
+access.accessModel;
+access.unlockCreditsRemaining;
+access.messageCreditsRemaining;
+access.hasUnlimitedUnlocks;
+access.hasUnlimitedMessages;
+access.companyId;
+```
+
+`companyId` is set when the viewer has exactly one approved membership. It is `null` when they have none or more than one — pass `companyId` on writes or the API returns `company_required`.
+
+## Gate one candidate
+
+Per-candidate already-unlocked state is a sibling read so the singleton never takes a candidate id.
+
+```ts snippet
+const gate = await board.me.talentAccess.retrieveCandidate('bu_candidate');
+if (!gate.alreadyUnlocked && !gate.hasUnlimitedUnlocks) {
+  renderUnlockCta(gate.unlockCreditsRemaining);
+}
+```
+
+## Mint and mount checkout
+
+`checkout` requires a signed-in approved employer and returns a mount kit. `returnPath` is relative; session metadata is `origin: talent_access`. Public talent plans come from `board.plans.list({ purpose: 'talent_access' })`.
+
+```ts snippet
+import { loadStripe } from '@stripe/stripe-js';
+
+const kit = await board.me.talentAccess.checkout({
+  planId: 'plan_1',
+  returnPath: '/employers',
+  colorMode: 'light',
+});
+
+const stripe = await loadStripe(kit.publishableKey, {
+  stripeAccount: kit.stripeAccountId,
+});
+```
+
+The kit contains `sessionId`, `clientSecret`, `stripeAccountId`, `publishableKey`, and `offerType`. The host owns Stripe.js and embedded-checkout mounting. Gate failures use `talent_access_unavailable`, `company_required`, and `stripe_not_connected`; handle them with `cavuno-board-errors`.
+
+## Confirm from remaining credits
+
+`retrieveCheckout` reports `open`, `complete`, or `expired`. Open sessions are remountable with their `clientSecret`; expired sessions require a new checkout. After completion, poll `retrieve()` because webhook delivery is asynchronous.
+
+```ts snippet
+const checkout = await board.me.talentAccess.retrieveCheckout(kit.sessionId);
+
+if (checkout.status === 'complete') {
+  let access = await board.me.talentAccess.retrieve();
+  for (let poll = 0; !access.hasTalentAccess && poll < 10; poll++) {
+    await new Promise((resolve) => setTimeout(resolve, 1000));
+    access = await board.me.talentAccess.retrieve();
+  }
+  if (access.hasTalentAccess) renderUnlockedDirectory();
+  else renderPendingAccess();
+}
+```
+
+## Spend an unlock
+
+Unlock is idempotent: a second call for the same company/candidate pair returns `alreadyUnlocked: true` with no decrement.
+
+```ts snippet
+const unlock = await board.me.talentAccess.unlock({
+  candidateId: 'bu_candidate',
+});
+if (unlock.alreadyUnlocked) renderProfile();
+else renderProfile(unlock.unlockCreditsRemaining);
+```
+
+`talent_access_required` means no plan or no remaining unlock credits.
+
+## Upgrade in place
+
+Out-of-credits plan changes call `upgrade`, never a second checkout. Checkout would mint a parallel subscription.
+
+```ts snippet
+await board.me.talentAccess.upgrade({ planId: 'plan_pro' });
+```
+
+`already_on_plan` means the company already holds that plan. `talent_access_required` means there is no current talent_access subscription to swap.
+
+## Open the company billing portal
+
+Job-posting and talent-access subscriptions share one Stripe customer per company. There is no `me.talentAccess.portal`.
+
+```ts snippet
+const { url } = await board.me.companies.billingPortal.create('acme', {
+  returnPath: '/employers/billing',
+});
+location.href = url;
+```
+
+## Message credits spend on start
+
+There is no separate message-credit spend endpoint. The composer gates on `hasTalentAccess` and remaining message credits; `conversations.start` still 403s `messaging_talent_access_required` on a cold send without credit.
+
+```ts snippet
+await board.me.conversations.start({
+  candidateBoardUserId: 'bu_candidate',
+  body: 'Hi, your profile looks like a great fit.',
+});
+```
+
+## Named vs opaque profile routes
+
+Named `/p/{handle}` is the share bypass and always shows a full `public` profile. Opaque `/p/{id}` is the unlock-gated route. When `accessModel === 'paid_unlocks_and_messaging'`, directory cards redact for viewers who are not unlimited.
+
+```ts snippet
+const named = await board.talent.retrieve('jane-doe');
+const opaque = await board.talent.retrieve('bu_candidate');
+```
+
+## Completion gate
+
+- `retrieve()` drives the Message-vs-upsell CTA and remaining-credit hints.
+- Opaque `/p/{id}` uses `retrieveCandidate` then `unlock`; named `/p/{handle}` does not.
+- Checkout reaches `complete`, then bounded `retrieve()` polling reaches `hasTalentAccess: true`.
+- `upgrade` is the out-of-credits plan swap; never a second checkout session.
+- Billing management uses `me.companies.billingPortal.create`, not a talent-access portal.
+- First-message spend stays on `conversations.start`.
+
+## 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.9.0",
+  "version": "4.10.0",
   "skills": [
     {
       "name": "cavuno-board-account",
@@ -154,6 +154,13 @@
       "path": "skills/cavuno-board-smoke-test/SKILL.md",
       "framework": null,
       "category": "core"
+    },
+    {
+      "name": "cavuno-board-talent-access",
+      "description": "Employer talent-access paywall with @cavuno/board. Use for charging models, remaining credits, per-candidate unlock gates, embedded checkout, in-place upgrades, or the company billing portal.",
+      "path": "skills/cavuno-board-talent-access/SKILL.md",
+      "framework": null,
+      "category": "core"
     }
   ]
 }