@curviate/sdk 0.37.0 → 0.37.1

package/CHANGELOG.md

@@ -9,6 +9,48 @@ Versioning: semantic. Minor for additive changes, patch for bug fixes; no stabil
 
 ## [Unreleased]
 
+## [0.37.1] - 2026-09-23
+
+Fixture and types regenerated against the deployed production document
+(`https://api.curviate.com`, 127 paths, server
+`0b33680536a45681ed5ffe420006cb05c85fe683`). Description changes only; no type
+shape changed.
+
+### Changed
+
+- **Generated type descriptions follow the served document.** `is_sender` on
+  chat messages now documents that it is omitted when the connected account
+  cannot yet be identified (treat a missing value as unknown, not as received).
+  Recruiter search and project filters, and the job read's `sections`
+  parameter, are documented as trimmed before use rather than forwarded
+  verbatim.
+
+### Fixed
+
+- **The retry decision now honours `retry_hint.kind: "never"`.** A retryable
+  code (`INTERNAL`, `PLATFORM_ERROR`, `PLATFORM_RATE_LIMIT`,
+  `RATE_LIMIT_ACCOUNT`, `RATE_LIMIT_TENANT`) whose envelope carries
+  `retry_hint: { kind: "never" }`, an explicit server instruction that this
+  exact refusal will not change on a retry (for example, an upstream response
+  in a shape this API cannot read), is no longer retried on GETs. Previously
+  the retry gate consulted only the code table, so a structural-drift 502
+  (`PLATFORM_ERROR` with `retry_likely_to_succeed: false` and
+  `retry_hint.kind: "never"`) was retried up to three times against an answer
+  that could not change.
+
+  `retry_likely_to_succeed` is still not consulted by the retry decision. The
+  server currently defaults it to `false` on several generic
+  "unresolved error" paths that are not a per-cause verdict, and honouring it
+  as written would have silently stopped retrying most undecoded server
+  errors. Filed back rather than shipped; unaffected callers see no
+  behaviour change.
+
+- **An empty but present `Retry-After` header no longer reads as "retry in
+  0ms".** `Number("")` is `0`, which is finite and non-negative, so it passed
+  the same check a real delay does; it now falls back to the same
+  conservative 30s the unparseable HTTP-date form already gets. Found in
+  passing while touching this file for the fix above; unrelated to it.
+
 ## [0.37.0] - 2026-09-22
 
 Fixture and types regenerated against the deployed production document

package/dist/index.d.ts

@@ -2904,7 +2904,7 @@ interface components {
             }[];
             /** @description ISO-8601 UTC send timestamp. */
             timestamp?: string;
-            /** @description True if the connected account sent this message. */
+            /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
             is_sender?: boolean;
             is_seen?: boolean;
             is_delivered?: boolean;
@@ -10378,7 +10378,7 @@ interface operations {
                                 }[];
                                 /** @description ISO-8601 UTC send timestamp. */
                                 timestamp?: string;
-                                /** @description True if the connected account sent this message. */
+                                /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
                                 is_sender?: boolean;
                                 is_seen?: boolean;
                                 is_delivered?: boolean;
@@ -10803,7 +10803,7 @@ interface operations {
                             }[];
                             /** @description ISO-8601 UTC send timestamp. */
                             timestamp?: string;
-                            /** @description True if the connected account sent this message. */
+                            /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
                             is_sender?: boolean;
                             is_seen?: boolean;
                             is_delivered?: boolean;
@@ -11173,7 +11173,7 @@ interface operations {
                             }[];
                             /** @description ISO-8601 UTC send timestamp. */
                             timestamp?: string;
-                            /** @description True if the connected account sent this message. */
+                            /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
                             is_sender?: boolean;
                             is_seen?: boolean;
                             is_delivered?: boolean;
@@ -11557,7 +11557,7 @@ interface operations {
                         }[];
                         /** @description ISO-8601 UTC send timestamp. */
                         timestamp?: string;
-                        /** @description True if the connected account sent this message. */
+                        /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
                         is_sender?: boolean;
                         is_seen?: boolean;
                         is_delivered?: boolean;
@@ -12752,7 +12752,7 @@ interface operations {
                                 }[];
                                 /** @description ISO-8601 UTC send timestamp. */
                                 timestamp?: string;
-                                /** @description True if the connected account sent this message. */
+                                /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
                                 is_sender?: boolean;
                                 is_seen?: boolean;
                                 is_delivered?: boolean;
@@ -16514,7 +16514,7 @@ interface operations {
     getV1AccountIdJobsJobId: {
         parameters: {
             query?: {
-                /** @description Which additional sections to include on the response (e.g. hiring_team, salary, benefits). The exact set of accepted values is not finalized, supply the section names you need, comma-separated for more than one, and they are forwarded verbatim. Omit for the base fields only. */
+                /** @description Which additional sections to include on the response (e.g. hiring_team, salary, benefits). The exact set of accepted values is not finalized, supply the section names you need, comma-separated for more than one; each name is trimmed before use. Omit for the base fields only. */
                 with_sections?: string[];
             };
             header?: never;
@@ -20436,7 +20436,7 @@ interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    /** @description Free-text keyword search. Content, forwarded verbatim, never persisted. */
+                    /** @description Free-text keyword search. Trimmed before use; never persisted. */
                     keywords?: string;
                     /** @description Filter by candidate spotlight tags. */
                     spotlights?: string[];
@@ -20509,9 +20509,9 @@ interface operations {
                     project?: string;
                     /** @description Resolved JOB_FUNCTION parameter ids. */
                     job_function?: string[];
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by first name (trimmed before use; never persisted). */
                     first_name?: string;
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by last name (trimmed before use; never persisted). */
                     last_name?: string;
                     /** @description Filter to members who recently joined LinkedIn. */
                     recently_joined?: boolean;
@@ -20534,7 +20534,7 @@ interface operations {
                     group?: string[];
                     /** @description Filter to members who previously applied. */
                     is_past_applicant?: boolean;
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by an existing note's content (trimmed before use; never persisted). */
                     notes?: string;
                     /** @description Resolved TAG parameter ids. */
                     tags?: string[];
@@ -20922,7 +20922,7 @@ interface operations {
                 status?: ("ACTIVE" | "CLOSED" | "DRAFT" | "REVIEW")[];
                 /** @description Field to sort results by. Defaults to LAST_USED_BY_ME. */
                 sort_by?: "LAST_USED_BY_ME" | "MOST_USED_BY_ME" | "LAST_VIEWED_BY_ME" | "NEWEST_TO_OLDEST" | "OLDEST_TO_NEWEST" | "ALPHABETICAL" | "REVERSE_ALPHABETICAL";
-                /** @description Filter by project name (content, forwarded verbatim, never persisted). */
+                /** @description Filter by project name (trimmed before use; never persisted). */
                 keywords?: string;
                 /** @description Number of projects to return (1-100). Defaults to 10. */
                 limit?: number;
@@ -21785,7 +21785,7 @@ interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    /** @description Free-text keyword search. Content, forwarded verbatim, never persisted. */
+                    /** @description Free-text keyword search. Trimmed before use; never persisted. */
                     keywords?: string;
                     /** @description Filter by candidate spotlight tags. */
                     spotlights?: string[];
@@ -21858,9 +21858,9 @@ interface operations {
                     project?: string;
                     /** @description Resolved JOB_FUNCTION parameter ids. */
                     job_function?: string[];
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by first name (trimmed before use; never persisted). */
                     first_name?: string;
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by last name (trimmed before use; never persisted). */
                     last_name?: string;
                     /** @description Filter to members who recently joined LinkedIn. */
                     recently_joined?: boolean;
@@ -21883,7 +21883,7 @@ interface operations {
                     group?: string[];
                     /** @description Filter to members who previously applied. */
                     is_past_applicant?: boolean;
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by an existing note's content (trimmed before use; never persisted). */
                     notes?: string;
                     /** @description Resolved TAG parameter ids. */
                     tags?: string[];
@@ -23203,7 +23203,7 @@ interface operations {
                         reject_unqualified_applicants?: boolean;
                         reject_out_of_country_applicants?: boolean;
                     };
-                    /** @description Content; the new project's name, forwarded verbatim, never persisted. */
+                    /** @description The new project's name (trimmed before use); never persisted. */
                     project_name: string;
                 };
             };
@@ -24221,7 +24221,7 @@ interface operations {
                 "application/json": {
                     /** @description The ID of the JOB_POSTING channel from the Talent Pool. SDK-confirmed REQUIRED. */
                     channel_id: string;
-                    /** @description Free-text keyword search. Content, forwarded verbatim, never persisted. */
+                    /** @description Free-text keyword search. Trimmed before use; never persisted. */
                     keywords?: string;
                     /**
                      * @description Sort order for the applicant list.

package/dist/index.js

@@ -259,8 +259,11 @@ function defaultSleep(ms) {
 }
 function parseRetryAfterMs(header) {
   if (header == null) return void 0;
-  const seconds = Number(header);
-  if (Number.isFinite(seconds) && seconds >= 0) return seconds * 1e3;
+  const trimmed = header.trim();
+  if (trimmed !== "") {
+    const seconds = Number(trimmed);
+    if (Number.isFinite(seconds) && seconds >= 0) return seconds * 1e3;
+  }
   return 3e4;
 }
 function backoffDelay(n, jitter) {
@@ -404,7 +407,8 @@ async function execute(method, path, opts) {
     }
     const err = await errorFromResponse(res);
     const namesBudgetRow = err.budgetRow !== void 0;
-    const retryable = !isWrite && !namesBudgetRow && RETRYABLE_CODES.has(err.code) && attempt < opts.maxRetries;
+    const neverRetry = err.retryHint?.kind === "never";
+    const retryable = !isWrite && !namesBudgetRow && !neverRetry && RETRYABLE_CODES.has(err.code) && attempt < opts.maxRetries;
     if (retryable) {
       await sleep(retryDelay(err, attempt + 1, jitterFn()));
       attempt += 1;

package/package.json

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

package/src/generated/types.ts

@@ -2807,7 +2807,7 @@ export interface components {
             }[];
             /** @description ISO-8601 UTC send timestamp. */
             timestamp?: string;
-            /** @description True if the connected account sent this message. */
+            /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
             is_sender?: boolean;
             is_seen?: boolean;
             is_delivered?: boolean;
@@ -10282,7 +10282,7 @@ export interface operations {
                                 }[];
                                 /** @description ISO-8601 UTC send timestamp. */
                                 timestamp?: string;
-                                /** @description True if the connected account sent this message. */
+                                /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
                                 is_sender?: boolean;
                                 is_seen?: boolean;
                                 is_delivered?: boolean;
@@ -10707,7 +10707,7 @@ export interface operations {
                             }[];
                             /** @description ISO-8601 UTC send timestamp. */
                             timestamp?: string;
-                            /** @description True if the connected account sent this message. */
+                            /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
                             is_sender?: boolean;
                             is_seen?: boolean;
                             is_delivered?: boolean;
@@ -11077,7 +11077,7 @@ export interface operations {
                             }[];
                             /** @description ISO-8601 UTC send timestamp. */
                             timestamp?: string;
-                            /** @description True if the connected account sent this message. */
+                            /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
                             is_sender?: boolean;
                             is_seen?: boolean;
                             is_delivered?: boolean;
@@ -11461,7 +11461,7 @@ export interface operations {
                         }[];
                         /** @description ISO-8601 UTC send timestamp. */
                         timestamp?: string;
-                        /** @description True if the connected account sent this message. */
+                        /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
                         is_sender?: boolean;
                         is_seen?: boolean;
                         is_delivered?: boolean;
@@ -12656,7 +12656,7 @@ export interface operations {
                                 }[];
                                 /** @description ISO-8601 UTC send timestamp. */
                                 timestamp?: string;
-                                /** @description True if the connected account sent this message. */
+                                /** @description True if the connected account sent this message. Omitted when Curviate cannot yet identify the connected account; treat a missing value as unknown, not as received. */
                                 is_sender?: boolean;
                                 is_seen?: boolean;
                                 is_delivered?: boolean;
@@ -16418,7 +16418,7 @@ export interface operations {
     getV1AccountIdJobsJobId: {
         parameters: {
             query?: {
-                /** @description Which additional sections to include on the response (e.g. hiring_team, salary, benefits). The exact set of accepted values is not finalized, supply the section names you need, comma-separated for more than one, and they are forwarded verbatim. Omit for the base fields only. */
+                /** @description Which additional sections to include on the response (e.g. hiring_team, salary, benefits). The exact set of accepted values is not finalized, supply the section names you need, comma-separated for more than one; each name is trimmed before use. Omit for the base fields only. */
                 with_sections?: string[];
             };
             header?: never;
@@ -20340,7 +20340,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    /** @description Free-text keyword search. Content, forwarded verbatim, never persisted. */
+                    /** @description Free-text keyword search. Trimmed before use; never persisted. */
                     keywords?: string;
                     /** @description Filter by candidate spotlight tags. */
                     spotlights?: string[];
@@ -20413,9 +20413,9 @@ export interface operations {
                     project?: string;
                     /** @description Resolved JOB_FUNCTION parameter ids. */
                     job_function?: string[];
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by first name (trimmed before use; never persisted). */
                     first_name?: string;
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by last name (trimmed before use; never persisted). */
                     last_name?: string;
                     /** @description Filter to members who recently joined LinkedIn. */
                     recently_joined?: boolean;
@@ -20438,7 +20438,7 @@ export interface operations {
                     group?: string[];
                     /** @description Filter to members who previously applied. */
                     is_past_applicant?: boolean;
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by an existing note's content (trimmed before use; never persisted). */
                     notes?: string;
                     /** @description Resolved TAG parameter ids. */
                     tags?: string[];
@@ -20826,7 +20826,7 @@ export interface operations {
                 status?: ("ACTIVE" | "CLOSED" | "DRAFT" | "REVIEW")[];
                 /** @description Field to sort results by. Defaults to LAST_USED_BY_ME. */
                 sort_by?: "LAST_USED_BY_ME" | "MOST_USED_BY_ME" | "LAST_VIEWED_BY_ME" | "NEWEST_TO_OLDEST" | "OLDEST_TO_NEWEST" | "ALPHABETICAL" | "REVERSE_ALPHABETICAL";
-                /** @description Filter by project name (content, forwarded verbatim, never persisted). */
+                /** @description Filter by project name (trimmed before use; never persisted). */
                 keywords?: string;
                 /** @description Number of projects to return (1-100). Defaults to 10. */
                 limit?: number;
@@ -21689,7 +21689,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    /** @description Free-text keyword search. Content, forwarded verbatim, never persisted. */
+                    /** @description Free-text keyword search. Trimmed before use; never persisted. */
                     keywords?: string;
                     /** @description Filter by candidate spotlight tags. */
                     spotlights?: string[];
@@ -21762,9 +21762,9 @@ export interface operations {
                     project?: string;
                     /** @description Resolved JOB_FUNCTION parameter ids. */
                     job_function?: string[];
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by first name (trimmed before use; never persisted). */
                     first_name?: string;
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by last name (trimmed before use; never persisted). */
                     last_name?: string;
                     /** @description Filter to members who recently joined LinkedIn. */
                     recently_joined?: boolean;
@@ -21787,7 +21787,7 @@ export interface operations {
                     group?: string[];
                     /** @description Filter to members who previously applied. */
                     is_past_applicant?: boolean;
-                    /** @description Content, forwarded verbatim, never persisted. */
+                    /** @description Filter by an existing note's content (trimmed before use; never persisted). */
                     notes?: string;
                     /** @description Resolved TAG parameter ids. */
                     tags?: string[];
@@ -23107,7 +23107,7 @@ export interface operations {
                         reject_unqualified_applicants?: boolean;
                         reject_out_of_country_applicants?: boolean;
                     };
-                    /** @description Content; the new project's name, forwarded verbatim, never persisted. */
+                    /** @description The new project's name (trimmed before use); never persisted. */
                     project_name: string;
                 };
             };
@@ -24125,7 +24125,7 @@ export interface operations {
                 "application/json": {
                     /** @description The ID of the JOB_POSTING channel from the Talent Pool. SDK-confirmed REQUIRED. */
                     channel_id: string;
-                    /** @description Free-text keyword search. Content, forwarded verbatim, never persisted. */
+                    /** @description Free-text keyword search. Trimmed before use; never persisted. */
                     keywords?: string;
                     /**
                      * @description Sort order for the applicant list.