@curviate/sdk 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -7,6 +7,28 @@ Versioning: semantic — minor for additive changes, patch for bug fixes; no sta
 
 ---
 
+## [0.10.0] — 2026-07-03
+
+### Added
+
+- **New `jobs` namespace.** `jobs.get(jobIdOrUrl)` retrieves one public LinkedIn job posting's full detail — title, company, location, description, applicant count, and more. Accepts either a bare numeric job id (e.g. `"4428113858"`) or a full job URL (`"https://www.linkedin.com/jobs/view/4428113858"`) — the SDK extracts the numeric id client-side, so both forms issue the identical request. Passing a value with no extractable numeric id throws `CurviateError({ code: "INVALID_REQUEST" })` synchronously, before any network call. Type: `JobPosting`.
+- `recruiter.getJob(jobIdOrUrl)` — the Recruiter-lens sibling, retrieving any public job posting (not only the operator's own postings). Accepts the same bare-id-or-URL forms as `jobs.get()` and returns the identical `JobPosting` type (no separate response shape to learn). Extends the Recruiter surface to 18 methods.
+
+## [0.9.0] — 2026-07-03
+
+### Added
+
+- **Account enrichment fields.** `accounts.list()` items and `accounts.get()` now carry six cached account-detail fields, populated by an async background enrichment on every successful account activation: `username`, `premium_id`, `public_identifier`, `substrate_created_at` (ISO-8601 UTC), `signatures` (`{title, content}[]`), and `groups` (`string[]`). All six are `null`/`[]` until the account's first enrichment pass completes — never `undefined`, never a missing key. Types: `AccountListPage`, `AccountDetail`.
+- `accounts.get()` gains `seat_id` (`string | null`) — the seat the account occupies, `null` for an admin seatless account. Previously only `accounts.list()` items carried this field.
+
+### Changed
+
+- `connected_at` (on both `accounts.list()` items and `accounts.get()`) and `last_checked_at` (`accounts.get()`) now consistently emit ISO-8601 UTC (`…Z`) timestamps — a prior docs-vs-runtime drift meant these could reach callers in raw Postgres wire format. No type change (already typed as `string`/`string | null`); this is a runtime-correctness fix reflected in the regenerated example values.
+- Regenerated types from the current API surface. No resource method signatures changed — purely additive response fields.
+- `quotas[]` (on `accounts.get()`) is now documented as advisory usage-safety recommendations: daily families never cause a rejected request; only `account.per_minute` is a binding limit enforced with HTTP 429. `recommended_throttle_hint` semantics documented per level (`none` / `slow_down` / `backoff` are advisory; `stop` is reserved for the binding per-minute limit). JSDoc-only — no type shape change.
+
+---
+
 ## [0.8.0] — 2026-07-02
 
 ### Added

package/dist/index.d.ts

@@ -164,8 +164,23 @@ interface paths {
                                 headline?: string | null;
                                 /** @description The seat this account occupies. */
                                 seat_id?: string | null;
-                                /** @description ISO-8601 connection timestamp. */
-                                connected_at?: string;
+                                /** @description ISO-8601 UTC connection timestamp. */
+                                connected_at?: string | null;
+                                /** @description Cached account username. Null until enriched. */
+                                username?: string | null;
+                                /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                                premium_id?: string | null;
+                                /** @description Cached public profile identifier. Null until enriched. */
+                                public_identifier?: string | null;
+                                /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                                substrate_created_at?: string | null;
+                                /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                                signatures?: {
+                                    title?: string;
+                                    content?: string;
+                                }[];
+                                /** @description Cached group names the account belongs to. Empty until enriched. */
+                                groups?: string[];
                             }[];
                             /** @description Next-page cursor; null on the last page. */
                             cursor?: string | null;
@@ -508,9 +523,28 @@ interface paths {
                             auth_method?: string;
                             full_name?: string | null;
                             headline?: string | null;
+                            /** @description ISO-8601 UTC connection timestamp. */
                             connected_at?: string | null;
+                            /** @description ISO-8601 UTC time the account state was last checked. */
                             last_checked_at?: string;
-                            /** @description Per-account quota view — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, account.per_minute). */
+                            /** @description The seat this account occupies (null for an admin seatless account). */
+                            seat_id?: string | null;
+                            /** @description Cached account username. Null until enriched. */
+                            username?: string | null;
+                            /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                            premium_id?: string | null;
+                            /** @description Cached public profile identifier. Null until enriched. */
+                            public_identifier?: string | null;
+                            /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                            substrate_created_at?: string | null;
+                            /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                            signatures?: {
+                                title?: string;
+                                content?: string;
+                            }[];
+                            /** @description Cached group names the account belongs to. Empty until enriched. */
+                            groups?: string[];
+                            /** @description Usage-safety recommendations for this account — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, profile.endorse, account.per_minute). These are advisory only: Curviate never rejects a request because a daily recommendation is exceeded; only account.per_minute is a binding limit enforced with HTTP 429. */
                             quotas?: {
                                 /** @description Quota family (e.g. messages.daily, account.per_minute). */
                                 quota_name?: string;
@@ -521,7 +555,7 @@ interface paths {
                                 /** @description ISO-8601 UTC time the current window resets. */
                                 reset_time?: string;
                                 /**
-                                 * @description Pacing hint.
+                                 * @description Pacing recommendation for this family, advisory only. `none` (under 80% consumed), `slow_down` (80-99% consumed), and `backoff` (100%+ consumed) never block a request. `stop` is reserved exclusively for `account.per_minute` — the sole binding limit, whose breach is enforced with HTTP 429.
                                  * @enum {string}
                                  */
                                 recommended_throttle_hint?: "none" | "slow_down" | "backoff" | "stop";
@@ -2486,6 +2520,176 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/jobs/{job_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get job posting
+         * @description Returns one public LinkedIn job posting's full detail — title, company, location, description, and applicant count.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description The connected LinkedIn account to retrieve the job posting on behalf of. */
+                    account_id: string;
+                };
+                header?: never;
+                path: {
+                    /** @description The numeric id of the job posting, e.g. 4428113858. This is the number in a LinkedIn job URL (https://www.linkedin.com/jobs/view/4428113858) and the job_urn value in a POST /v1/search/jobs result. Pass the number only — a full URL is not accepted by the API (the SDK and CLI extract the id from a URL for you). */
+                    job_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The job posting's full detail. Content fields (title, description) are returned verbatim and are never stored. */
+                200: {
+                    headers: {
+                        "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                        RateLimit: components["headers"]["RateLimit"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /**
+                             * @description Response type discriminator.
+                             * @enum {string}
+                             */
+                            object: "job_posting";
+                            /** @description The job posting's numeric identifier. */
+                            id: string;
+                            /** @description Job title (content pass-through — never stored). */
+                            title: string;
+                            /** @description Hiring company's display name. */
+                            company: string;
+                            /** @description The hiring company's id — pass it to GET /v1/profiles/companies/{company_id}. */
+                            company_id: string;
+                            /** @description Posting lifecycle state (e.g. active). */
+                            state: string;
+                            /** @description Job location, or null when not set. */
+                            location: string | null;
+                            /** @description Posting cost, in the currency the account bills in. */
+                            cost: number;
+                            /** @description Number of applicants so far. */
+                            applicants_counter: number;
+                            /** @description Full job description text (content pass-through — never stored). */
+                            description: string;
+                            /** @description ISO-8601 UTC timestamp the posting was created, or null when not set. */
+                            created_at: string | null;
+                            /** @description ISO-8601 UTC timestamp the posting was published, or null when not set. */
+                            published_at: string | null;
+                            /** @description Hiring team members associated with this posting, when the posting exposes any. */
+                            hiring_team: unknown[];
+                        };
+                    };
+                };
+                /** @description Missing or empty account_id. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid API key. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account does not have the required Core seat. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account_id does not belong to this tenant, or the job posting was not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account is restricted and cannot be queried. */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited — slow down and retry after the hinted delay. */
+                429: {
+                    headers: {
+                        "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                        RateLimit: components["headers"]["RateLimit"];
+                        "Retry-After": components["headers"]["Retry-After"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal error. */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description A temporary error occurred. Please try again. */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Service unavailable. */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Gateway timeout. */
+                504: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/chats": {
         parameters: {
             query?: never;
@@ -11178,6 +11382,176 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/recruiter/jobs/{job_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get job posting
+         * @description Returns one public LinkedIn job posting's full detail (RECRUITER lens) — title, company, location, description, and applicant count. Requires a Recruiter seat.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description The connected LinkedIn account to retrieve the job posting on behalf of. */
+                    account_id: string;
+                };
+                header?: never;
+                path: {
+                    /** @description The numeric id of the job posting, e.g. 4428113858. This is the number in a LinkedIn job URL (https://www.linkedin.com/jobs/view/4428113858) and the job_urn value in a POST /v1/search/jobs result. Pass the number only — a full URL is not accepted by the API (the SDK and CLI extract the id from a URL for you). */
+                    job_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The job posting's full detail (RECRUITER lens — the same job_posting shape as the Core retrieve; content fields are returned verbatim and never stored). Requires a Recruiter seat. */
+                200: {
+                    headers: {
+                        "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                        RateLimit: components["headers"]["RateLimit"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /**
+                             * @description Response type discriminator.
+                             * @enum {string}
+                             */
+                            object: "job_posting";
+                            /** @description The job posting's numeric identifier. */
+                            id: string;
+                            /** @description Job title (content pass-through — never stored). */
+                            title: string;
+                            /** @description Hiring company's display name. */
+                            company: string;
+                            /** @description The hiring company's id — pass it to GET /v1/profiles/companies/{company_id}. */
+                            company_id: string;
+                            /** @description Posting lifecycle state (e.g. active). */
+                            state: string;
+                            /** @description Job location, or null when not set. */
+                            location: string | null;
+                            /** @description Posting cost, in the currency the account bills in. */
+                            cost: number;
+                            /** @description Number of applicants so far. */
+                            applicants_counter: number;
+                            /** @description Full job description text (content pass-through — never stored). */
+                            description: string;
+                            /** @description ISO-8601 UTC timestamp the posting was created, or null when not set. */
+                            created_at: string | null;
+                            /** @description ISO-8601 UTC timestamp the posting was published, or null when not set. */
+                            published_at: string | null;
+                            /** @description Hiring team members associated with this posting, when the posting exposes any. */
+                            hiring_team: unknown[];
+                        };
+                    };
+                };
+                /** @description Missing or empty account_id. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid API key, or LinkedIn authentication failed. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account does not have the required Recruiter seat. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account_id does not belong to this tenant, or the job posting was not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account is restricted and cannot be queried. */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited — slow down and retry after the hinted delay. */
+                429: {
+                    headers: {
+                        "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                        RateLimit: components["headers"]["RateLimit"];
+                        "Retry-After": components["headers"]["Retry-After"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal error. */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description A temporary error occurred. Please try again. */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Service unavailable. */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Gateway timeout. */
+                504: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/recruiter/jobs/{job_id}/applicants": {
         parameters: {
             query?: never;
@@ -15047,6 +15421,11 @@ declare class AccountsResource {
     /**
      * List the tenant's connected LinkedIn accounts, cursor-paginated.
      *
+     * Each item also carries a small set of cached account-detail fields
+     * (`username`, `premium_id`, `public_identifier`, `substrate_created_at`,
+     * `signatures`, `groups`) populated by an async background enrichment —
+     * `null`/`[]` until the account's first enrichment pass completes.
+     *
      * @param params - optional `limit` (1–250) and `cursor` (from a prior page).
      * @returns a page of accounts and the next-page `cursor` (null when exhausted).
      *
@@ -15077,7 +15456,14 @@ declare class AccountsResource {
     createConnectLink(body: AccountConnectLinkBody): Promise<AccountConnectLinkResult>;
     /**
      * Return metadata and current state for one connected account, including the
-     * central `quotas[]` view for all tracked quota families.
+     * central `quotas[]` view for all tracked quota families and `seat_id` (the
+     * seat this account occupies, `null` for an admin seatless account).
+     *
+     * This is a stale-while-revalidate read — it always returns immediately
+     * from the cached row (never blocks on a live substrate call), and the
+     * six cached enrichment fields (`username`, `premium_id`,
+     * `public_identifier`, `substrate_created_at`, `signatures`, `groups`) are
+     * `null`/`[]` until the account's first enrichment pass completes.
      */
     get(accountId: string): Promise<AccountDetail>;
     /**
@@ -15200,23 +15586,23 @@ declare class MessagingResource {
  */
 
 /** Strip `account_id` from a query-param type (injected by the account-scoped context). */
-type WithoutAccountId<T> = Omit<T, "account_id">;
+type WithoutAccountId$1<T> = Omit<T, "account_id">;
 type ProfileDetail = paths["/v1/profiles/me"]["get"]["responses"]["200"]["content"]["application/json"];
 /** Caller-facing query params for `profiles.getMe()` — `account_id` is injected by context. */
-type ProfileGetMeParams = WithoutAccountId<paths["/v1/profiles/me"]["get"]["parameters"]["query"]>;
+type ProfileGetMeParams = WithoutAccountId$1<paths["/v1/profiles/me"]["get"]["parameters"]["query"]>;
 type ProfileGetResult = paths["/v1/profiles/{profile_id}"]["get"]["responses"]["200"]["content"]["application/json"];
 /** Caller-facing query params for `profiles.get()` — `account_id` is injected by context. */
-type ProfileGetParams = WithoutAccountId<paths["/v1/profiles/{profile_id}"]["get"]["parameters"]["query"]>;
+type ProfileGetParams = WithoutAccountId$1<paths["/v1/profiles/{profile_id}"]["get"]["parameters"]["query"]>;
 type ConnectionListPage = paths["/v1/profiles/relations"]["get"]["responses"]["200"]["content"]["application/json"];
-type ConnectionListParams = WithoutAccountId<paths["/v1/profiles/relations"]["get"]["parameters"]["query"]>;
+type ConnectionListParams = WithoutAccountId$1<paths["/v1/profiles/relations"]["get"]["parameters"]["query"]>;
 type FollowerListPage = paths["/v1/profiles/{profile_id}/followers"]["get"]["responses"]["200"]["content"]["application/json"];
-type FollowerListParams = WithoutAccountId<NonNullable<paths["/v1/profiles/{profile_id}/followers"]["get"]["parameters"]["query"]>>;
+type FollowerListParams = WithoutAccountId$1<NonNullable<paths["/v1/profiles/{profile_id}/followers"]["get"]["parameters"]["query"]>>;
 type ProfilePostListPage = paths["/v1/profiles/{profile_id}/posts"]["get"]["responses"]["200"]["content"]["application/json"];
-type ProfilePostListParams = WithoutAccountId<NonNullable<paths["/v1/profiles/{profile_id}/posts"]["get"]["parameters"]["query"]>>;
+type ProfilePostListParams = WithoutAccountId$1<NonNullable<paths["/v1/profiles/{profile_id}/posts"]["get"]["parameters"]["query"]>>;
 type ProfileCommentListPage = paths["/v1/profiles/{profile_id}/comments"]["get"]["responses"]["200"]["content"]["application/json"];
-type ProfileCommentListParams = WithoutAccountId<NonNullable<paths["/v1/profiles/{profile_id}/comments"]["get"]["parameters"]["query"]>>;
+type ProfileCommentListParams = WithoutAccountId$1<NonNullable<paths["/v1/profiles/{profile_id}/comments"]["get"]["parameters"]["query"]>>;
 type ProfileReactionListPage = paths["/v1/profiles/{profile_id}/reactions"]["get"]["responses"]["200"]["content"]["application/json"];
-type ProfileReactionListParams = WithoutAccountId<NonNullable<paths["/v1/profiles/{profile_id}/reactions"]["get"]["parameters"]["query"]>>;
+type ProfileReactionListParams = WithoutAccountId$1<NonNullable<paths["/v1/profiles/{profile_id}/reactions"]["get"]["parameters"]["query"]>>;
 type CompanyProfile = paths["/v1/profiles/companies/{company_id}"]["get"]["responses"]["200"]["content"]["application/json"];
 type EndorseBody = paths["/v1/profiles/{profile_id}/endorse"]["post"]["requestBody"]["content"]["application/json"];
 type EndorseResult = paths["/v1/profiles/{profile_id}/endorse"]["post"]["responses"]["200"]["content"]["application/json"];
@@ -15492,12 +15878,48 @@ declare class SalesNavigatorResource {
 }
 
 /**
- * Recruiter resource — 17 methods (tier: recruiter).
+ * Jobs resource — 1 method.
+ *
+ * Account-scoped: the bound context injects `account_id` into every request.
+ */
+
+/** Strip `account_id` from a query-param type (injected by the account-scoped context). */
+type WithoutAccountId<T> = Omit<T, "account_id">;
+/**
+ * The job-posting shape returned by `jobs.get()` and `recruiter.getJob()` —
+ * the two endpoints return the same shape (Core vs. Recruiter lens), so this
+ * is the single canonical type; `recruiter.ts` reuses it rather than
+ * deriving a duplicate from its own path.
+ */
+type JobPosting = paths["/v1/jobs/{job_id}"]["get"]["responses"]["200"]["content"]["application/json"];
+/** Caller-facing query params for `jobs.get()` — `account_id` is injected by context. */
+type JobGetParams = WithoutAccountId<paths["/v1/jobs/{job_id}"]["get"]["parameters"]["query"]>;
+declare class JobsResource {
+    protected readonly ctx: RequestContext;
+    constructor(ctx: RequestContext);
+    /**
+     * Retrieve one public LinkedIn job posting's full detail.
+     * `GET /v1/jobs/{job_id}`
+     *
+     * Accepts a bare numeric job id or a full job URL
+     * (`https://www.linkedin.com/jobs/view/{id}`) — the id is extracted
+     * client-side; the wire request always carries the numeric id. Throws
+     * `CurviateError({ code: 'INVALID_REQUEST' })` synchronously if neither
+     * form can be recognized.
+     * The `account_id` is injected by the account-scoped context.
+     */
+    get(jobIdOrUrl: string, params?: JobGetParams): Promise<JobPosting>;
+}
+
+/**
+ * Recruiter resource — 18 methods (tier: recruiter).
  *
  * Account-scoped: the bound context injects `account_id` into every request.
  * `startChat` accepts optional `attachments[]`, `voice_message`, and
  * `video_message`; the SDK builds the `FormData` body automatically.
  * `downloadResume` returns `Promise<ArrayBuffer>` (binary response).
+ * `getJob` returns the same `JobPosting` shape as `jobs.get()` — reused, not
+ * redefined, since both endpoints share the underlying job-posting retrieve.
  */
 
 type RecruiterSyncMessagesParams = NonNullable<paths["/v1/recruiter/messages/sync"]["get"]["parameters"]["query"]>;
@@ -15613,6 +16035,18 @@ declare class RecruiterResource {
      * `POST /v1/recruiter/jobs/{job_id}/checkpoint`
      */
     solveJobCheckpoint(jobId: string, body: RecruiterSolveJobCheckpointBody): Promise<RecruiterSolveJobCheckpointResult>;
+    /**
+     * Get a job posting via the Recruiter lens (any public posting, not only
+     * the operator's own). `GET /v1/recruiter/jobs/{job_id}`
+     *
+     * Accepts a bare numeric job id or a full job URL
+     * (`https://www.linkedin.com/jobs/view/{id}`) — the id is extracted
+     * client-side, mirroring `jobs.get()`. Throws
+     * `CurviateError({ code: 'INVALID_REQUEST' })` synchronously if neither
+     * form can be recognized. Returns the same `JobPosting` shape as
+     * `jobs.get()`.
+     */
+    getJob(jobIdOrUrl: string): Promise<JobPosting>;
     /**
      * List applicants for a job posting.
      * `GET /v1/recruiter/jobs/{job_id}/applicants`
@@ -15691,9 +16125,9 @@ declare class WebhooksResource {
  * Resource namespace assembly.
  *
  * The root client and every `account(id)` accessor expose the same set of
- * resource namespaces. All 9 namespaces are fully implemented:
+ * resource namespaces. All 10 namespaces are fully implemented:
  * accounts, messaging, profiles, invites, search, posts,
- * salesNavigator, recruiter, and webhooks.
+ * salesNavigator, recruiter, jobs, and webhooks.
  */
 
 /** The full namespace surface, shared by the root client and account scopes. */
@@ -15706,6 +16140,7 @@ interface ResourceNamespaces {
     posts: PostsResource;
     salesNavigator: SalesNavigatorResource;
     recruiter: RecruiterResource;
+    jobs: JobsResource;
     webhooks: WebhooksResource;
 }
 /**
@@ -15739,6 +16174,7 @@ declare class Curviate {
     readonly posts: PostsResource;
     readonly salesNavigator: SalesNavigatorResource;
     readonly recruiter: RecruiterResource;
+    readonly jobs: JobsResource;
     readonly webhooks: WebhooksResource;
     constructor(config: CurviateConfig);
     /**

package/dist/index.js

@@ -308,6 +308,11 @@ var AccountsResource = class {
   /**
    * List the tenant's connected LinkedIn accounts, cursor-paginated.
    *
+   * Each item also carries a small set of cached account-detail fields
+   * (`username`, `premium_id`, `public_identifier`, `substrate_created_at`,
+   * `signatures`, `groups`) populated by an async background enrichment —
+   * `null`/`[]` until the account's first enrichment pass completes.
+   *
    * @param params - optional `limit` (1–250) and `cursor` (from a prior page).
    * @returns a page of accounts and the next-page `cursor` (null when exhausted).
    *
@@ -368,7 +373,14 @@ var AccountsResource = class {
   }
   /**
    * Return metadata and current state for one connected account, including the
-   * central `quotas[]` view for all tracked quota families.
+   * central `quotas[]` view for all tracked quota families and `seat_id` (the
+   * seat this account occupies, `null` for an admin seatless account).
+   *
+   * This is a stale-while-revalidate read — it always returns immediately
+   * from the cached row (never blocks on a live substrate call), and the
+   * six cached enrichment fields (`username`, `premium_id`,
+   * `public_identifier`, `substrate_created_at`, `signatures`, `groups`) are
+   * `null`/`[]` until the account's first enrichment pass completes.
    */
   get(accountId) {
     return this.ctx.request({
@@ -1031,6 +1043,21 @@ var SalesNavigatorResource = class {
   }
 };
 
+// src/internal/job-id.ts
+var JOB_URL_ID_PATTERN = /\/jobs\/view\/(\d+)/;
+function resolveJobId(idOrUrl) {
+  const trimmed = idOrUrl.trim();
+  if (/^\d+$/.test(trimmed)) return trimmed;
+  const match = trimmed.match(JOB_URL_ID_PATTERN);
+  if (match) return match[1];
+  throw new CurviateError({
+    code: "INVALID_REQUEST",
+    message: `Could not extract a numeric job id from "${idOrUrl}". Pass a bare numeric id (e.g. "4428113858") or a LinkedIn job URL (e.g. "https://www.linkedin.com/jobs/view/4428113858").`,
+    userFixable: true,
+    retryLikelyToSucceed: false
+  });
+}
+
 // src/resources/recruiter.ts
 function buildFormData4(scalars, attachments, voice_message, video_message) {
   const form = new FormData();
@@ -1246,6 +1273,24 @@ var RecruiterResource = class {
       accountIdIn: "body"
     });
   }
+  /**
+   * Get a job posting via the Recruiter lens (any public posting, not only
+   * the operator's own). `GET /v1/recruiter/jobs/{job_id}`
+   *
+   * Accepts a bare numeric job id or a full job URL
+   * (`https://www.linkedin.com/jobs/view/{id}`) — the id is extracted
+   * client-side, mirroring `jobs.get()`. Throws
+   * `CurviateError({ code: 'INVALID_REQUEST' })` synchronously if neither
+   * form can be recognized. Returns the same `JobPosting` shape as
+   * `jobs.get()`.
+   */
+  getJob(jobIdOrUrl) {
+    const jobId = resolveJobId(jobIdOrUrl);
+    return this.ctx.request({
+      method: "GET",
+      path: `/v1/recruiter/jobs/${jobId}`
+    });
+  }
   /**
    * List applicants for a job posting.
    * `GET /v1/recruiter/jobs/{job_id}/applicants`
@@ -1280,6 +1325,32 @@ var RecruiterResource = class {
   }
 };
 
+// src/resources/jobs.ts
+var JobsResource = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  /**
+   * Retrieve one public LinkedIn job posting's full detail.
+   * `GET /v1/jobs/{job_id}`
+   *
+   * Accepts a bare numeric job id or a full job URL
+   * (`https://www.linkedin.com/jobs/view/{id}`) — the id is extracted
+   * client-side; the wire request always carries the numeric id. Throws
+   * `CurviateError({ code: 'INVALID_REQUEST' })` synchronously if neither
+   * form can be recognized.
+   * The `account_id` is injected by the account-scoped context.
+   */
+  get(jobIdOrUrl, params) {
+    const jobId = resolveJobId(jobIdOrUrl);
+    return this.ctx.request({
+      method: "GET",
+      path: `/v1/jobs/${jobId}`,
+      ...params ? { query: params } : {}
+    });
+  }
+};
+
 // src/resources/webhooks.ts
 var WebhooksResource = class {
   constructor(ctx) {
@@ -1365,6 +1436,7 @@ function buildNamespaces(ctx) {
     posts: new PostsResource(ctx),
     salesNavigator: new SalesNavigatorResource(ctx),
     recruiter: new RecruiterResource(ctx),
+    jobs: new JobsResource(ctx),
     webhooks: new WebhooksResource(ctx)
   };
 }
@@ -1388,6 +1460,7 @@ var Curviate = class {
     this.posts = ns.posts;
     this.salesNavigator = ns.salesNavigator;
     this.recruiter = ns.recruiter;
+    this.jobs = ns.jobs;
     this.webhooks = ns.webhooks;
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curviate/sdk",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "private": false,
   "description": "TypeScript SDK for the Curviate API.",
   "license": "MIT",

package/src/generated/types.ts

@@ -55,8 +55,23 @@ export interface paths {
                                 headline?: string | null;
                                 /** @description The seat this account occupies. */
                                 seat_id?: string | null;
-                                /** @description ISO-8601 connection timestamp. */
-                                connected_at?: string;
+                                /** @description ISO-8601 UTC connection timestamp. */
+                                connected_at?: string | null;
+                                /** @description Cached account username. Null until enriched. */
+                                username?: string | null;
+                                /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                                premium_id?: string | null;
+                                /** @description Cached public profile identifier. Null until enriched. */
+                                public_identifier?: string | null;
+                                /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                                substrate_created_at?: string | null;
+                                /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                                signatures?: {
+                                    title?: string;
+                                    content?: string;
+                                }[];
+                                /** @description Cached group names the account belongs to. Empty until enriched. */
+                                groups?: string[];
                             }[];
                             /** @description Next-page cursor; null on the last page. */
                             cursor?: string | null;
@@ -399,9 +414,28 @@ export interface paths {
                             auth_method?: string;
                             full_name?: string | null;
                             headline?: string | null;
+                            /** @description ISO-8601 UTC connection timestamp. */
                             connected_at?: string | null;
+                            /** @description ISO-8601 UTC time the account state was last checked. */
                             last_checked_at?: string;
-                            /** @description Per-account quota view — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, account.per_minute). */
+                            /** @description The seat this account occupies (null for an admin seatless account). */
+                            seat_id?: string | null;
+                            /** @description Cached account username. Null until enriched. */
+                            username?: string | null;
+                            /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                            premium_id?: string | null;
+                            /** @description Cached public profile identifier. Null until enriched. */
+                            public_identifier?: string | null;
+                            /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                            substrate_created_at?: string | null;
+                            /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                            signatures?: {
+                                title?: string;
+                                content?: string;
+                            }[];
+                            /** @description Cached group names the account belongs to. Empty until enriched. */
+                            groups?: string[];
+                            /** @description Usage-safety recommendations for this account — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, profile.endorse, account.per_minute). These are advisory only: Curviate never rejects a request because a daily recommendation is exceeded; only account.per_minute is a binding limit enforced with HTTP 429. */
                             quotas?: {
                                 /** @description Quota family (e.g. messages.daily, account.per_minute). */
                                 quota_name?: string;
@@ -412,7 +446,7 @@ export interface paths {
                                 /** @description ISO-8601 UTC time the current window resets. */
                                 reset_time?: string;
                                 /**
-                                 * @description Pacing hint.
+                                 * @description Pacing recommendation for this family, advisory only. `none` (under 80% consumed), `slow_down` (80-99% consumed), and `backoff` (100%+ consumed) never block a request. `stop` is reserved exclusively for `account.per_minute` — the sole binding limit, whose breach is enforced with HTTP 429.
                                  * @enum {string}
                                  */
                                 recommended_throttle_hint?: "none" | "slow_down" | "backoff" | "stop";
@@ -2377,6 +2411,176 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/jobs/{job_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get job posting
+         * @description Returns one public LinkedIn job posting's full detail — title, company, location, description, and applicant count.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description The connected LinkedIn account to retrieve the job posting on behalf of. */
+                    account_id: string;
+                };
+                header?: never;
+                path: {
+                    /** @description The numeric id of the job posting, e.g. 4428113858. This is the number in a LinkedIn job URL (https://www.linkedin.com/jobs/view/4428113858) and the job_urn value in a POST /v1/search/jobs result. Pass the number only — a full URL is not accepted by the API (the SDK and CLI extract the id from a URL for you). */
+                    job_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The job posting's full detail. Content fields (title, description) are returned verbatim and are never stored. */
+                200: {
+                    headers: {
+                        "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                        RateLimit: components["headers"]["RateLimit"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /**
+                             * @description Response type discriminator.
+                             * @enum {string}
+                             */
+                            object: "job_posting";
+                            /** @description The job posting's numeric identifier. */
+                            id: string;
+                            /** @description Job title (content pass-through — never stored). */
+                            title: string;
+                            /** @description Hiring company's display name. */
+                            company: string;
+                            /** @description The hiring company's id — pass it to GET /v1/profiles/companies/{company_id}. */
+                            company_id: string;
+                            /** @description Posting lifecycle state (e.g. active). */
+                            state: string;
+                            /** @description Job location, or null when not set. */
+                            location: string | null;
+                            /** @description Posting cost, in the currency the account bills in. */
+                            cost: number;
+                            /** @description Number of applicants so far. */
+                            applicants_counter: number;
+                            /** @description Full job description text (content pass-through — never stored). */
+                            description: string;
+                            /** @description ISO-8601 UTC timestamp the posting was created, or null when not set. */
+                            created_at: string | null;
+                            /** @description ISO-8601 UTC timestamp the posting was published, or null when not set. */
+                            published_at: string | null;
+                            /** @description Hiring team members associated with this posting, when the posting exposes any. */
+                            hiring_team: unknown[];
+                        };
+                    };
+                };
+                /** @description Missing or empty account_id. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid API key. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account does not have the required Core seat. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account_id does not belong to this tenant, or the job posting was not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account is restricted and cannot be queried. */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited — slow down and retry after the hinted delay. */
+                429: {
+                    headers: {
+                        "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                        RateLimit: components["headers"]["RateLimit"];
+                        "Retry-After": components["headers"]["Retry-After"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal error. */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description A temporary error occurred. Please try again. */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Service unavailable. */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Gateway timeout. */
+                504: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/chats": {
         parameters: {
             query?: never;
@@ -11069,6 +11273,176 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/recruiter/jobs/{job_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get job posting
+         * @description Returns one public LinkedIn job posting's full detail (RECRUITER lens) — title, company, location, description, and applicant count. Requires a Recruiter seat.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description The connected LinkedIn account to retrieve the job posting on behalf of. */
+                    account_id: string;
+                };
+                header?: never;
+                path: {
+                    /** @description The numeric id of the job posting, e.g. 4428113858. This is the number in a LinkedIn job URL (https://www.linkedin.com/jobs/view/4428113858) and the job_urn value in a POST /v1/search/jobs result. Pass the number only — a full URL is not accepted by the API (the SDK and CLI extract the id from a URL for you). */
+                    job_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The job posting's full detail (RECRUITER lens — the same job_posting shape as the Core retrieve; content fields are returned verbatim and never stored). Requires a Recruiter seat. */
+                200: {
+                    headers: {
+                        "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                        RateLimit: components["headers"]["RateLimit"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /**
+                             * @description Response type discriminator.
+                             * @enum {string}
+                             */
+                            object: "job_posting";
+                            /** @description The job posting's numeric identifier. */
+                            id: string;
+                            /** @description Job title (content pass-through — never stored). */
+                            title: string;
+                            /** @description Hiring company's display name. */
+                            company: string;
+                            /** @description The hiring company's id — pass it to GET /v1/profiles/companies/{company_id}. */
+                            company_id: string;
+                            /** @description Posting lifecycle state (e.g. active). */
+                            state: string;
+                            /** @description Job location, or null when not set. */
+                            location: string | null;
+                            /** @description Posting cost, in the currency the account bills in. */
+                            cost: number;
+                            /** @description Number of applicants so far. */
+                            applicants_counter: number;
+                            /** @description Full job description text (content pass-through — never stored). */
+                            description: string;
+                            /** @description ISO-8601 UTC timestamp the posting was created, or null when not set. */
+                            created_at: string | null;
+                            /** @description ISO-8601 UTC timestamp the posting was published, or null when not set. */
+                            published_at: string | null;
+                            /** @description Hiring team members associated with this posting, when the posting exposes any. */
+                            hiring_team: unknown[];
+                        };
+                    };
+                };
+                /** @description Missing or empty account_id. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid API key, or LinkedIn authentication failed. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account does not have the required Recruiter seat. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account_id does not belong to this tenant, or the job posting was not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The account is restricted and cannot be queried. */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited — slow down and retry after the hinted delay. */
+                429: {
+                    headers: {
+                        "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                        RateLimit: components["headers"]["RateLimit"];
+                        "Retry-After": components["headers"]["Retry-After"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal error. */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description A temporary error occurred. Please try again. */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Service unavailable. */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Gateway timeout. */
+                504: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/recruiter/jobs/{job_id}/applicants": {
         parameters: {
             query?: never;