feat: sync SDK to OnePin API v0.41.87

.spec-sha

@@ -1 +1 @@
-6ace098c56527cf0a0e5018b67ec454412ee6926
+fde7e27884fc5355f46c368a3688c1653f937a2d

src/onepin/.fern/metadata.json

@@ -30,7 +30,7 @@
       }
     ]
   },
-  "originGitCommit": "9e634eff3eb65ab32b4a77b6fee5e0d27aa126cf",
+  "originGitCommit": "8161f2e78f880139a10f4fbd560a506103452095",
   "originGitCommitIsDirty": false,
   "invokedBy": "ci",
   "ciProvider": "github"

src/onepin/__init__.py

@@ -98,6 +98,7 @@
         NumericOption,
         PaginationMeta,
         PlanLimits,
+        PlanLimitsCreditsRenewal,
         PlanTier,
         PortOut,
         PronunciationSuggestion,
@@ -192,6 +193,9 @@
         WorkflowRunOverviewValidatorOut,
         WorkflowRunOverviewValidatorOutStatus,
         WorkflowRunOverviewWorkflowOut,
+        WorkflowRunSinkOutputDelivery,
+        WorkflowRunSinkOutputDeliveryCheck,
+        WorkflowRunSinkOutputLine,
         WorkflowRunSinkOutputOut,
         WorkflowRunStartIn,
         WorkflowRunStatusOut,
@@ -368,6 +372,7 @@
     "OnepinClient": "._client",
     "PaginationMeta": ".types",
     "PlanLimits": ".types",
+    "PlanLimitsCreditsRenewal": ".types",
     "PlanTier": ".types",
     "PortOut": ".types",
     "PronunciationSuggestion": ".types",
@@ -473,6 +478,9 @@
     "WorkflowRunOverviewValidatorOut": ".types",
     "WorkflowRunOverviewValidatorOutStatus": ".types",
     "WorkflowRunOverviewWorkflowOut": ".types",
+    "WorkflowRunSinkOutputDelivery": ".types",
+    "WorkflowRunSinkOutputDeliveryCheck": ".types",
+    "WorkflowRunSinkOutputLine": ".types",
     "WorkflowRunSinkOutputOut": ".types",
     "WorkflowRunStartIn": ".types",
     "WorkflowRunStatusOut": ".types",
@@ -639,6 +647,7 @@ def __dir__():
     "OnepinClient",
     "PaginationMeta",
     "PlanLimits",
+    "PlanLimitsCreditsRenewal",
     "PlanTier",
     "PortOut",
     "PronunciationSuggestion",
@@ -744,6 +753,9 @@ def __dir__():
     "WorkflowRunOverviewValidatorOut",
     "WorkflowRunOverviewValidatorOutStatus",
     "WorkflowRunOverviewWorkflowOut",
+    "WorkflowRunSinkOutputDelivery",
+    "WorkflowRunSinkOutputDeliveryCheck",
+    "WorkflowRunSinkOutputLine",
     "WorkflowRunSinkOutputOut",
     "WorkflowRunStartIn",
     "WorkflowRunStatusOut",

src/onepin/dictionary/types/list_dictionary_entries_api_v1dictionary_get_request_language.py

@@ -3,5 +3,6 @@
 import typing
 
 ListDictionaryEntriesApiV1DictionaryGetRequestLanguage = typing.Union[
-    typing.Literal["de-de", "en-gb", "en-us", "es-es", "fr-fr", "it-it", "ja-jp", "ko-kr", "pt-br", "zh-cn"], typing.Any
+    typing.Literal["de-de", "en-gb", "en-us", "es-es", "es-mx", "fr-fr", "ja-jp", "ko-kr", "pt-br", "pt-pt", "zh-cn"],
+    typing.Any,
 ]

src/onepin/dictionary/types/search_dictionary_entries_api_v1dictionary_search_get_request_language_item.py

@@ -3,5 +3,6 @@
 import typing
 
 SearchDictionaryEntriesApiV1DictionarySearchGetRequestLanguageItem = typing.Union[
-    typing.Literal["de-de", "en-gb", "en-us", "es-es", "fr-fr", "it-it", "ja-jp", "ko-kr", "pt-br", "zh-cn"], typing.Any
+    typing.Literal["de-de", "en-gb", "en-us", "es-es", "es-mx", "fr-fr", "ja-jp", "ko-kr", "pt-br", "pt-pt", "zh-cn"],
+    typing.Any,
 ]

src/onepin/reference.md

@@ -2682,7 +2682,7 @@ client.voices.list()
 <dl>
 <dd>
 
-**search:** `typing.Optional[str]` — Full-text search against voice name, description, and tags.
+**search:** `typing.Optional[str]` — Searches name, tags, and the voice's summary-derived descriptor text (closely tracks the served description; summary beyond 200 chars is not searched).
 
 </dd>
 </dl>
@@ -5316,9 +5316,14 @@ attempt a workflow run. `remaining` is a display convenience derived from
 settled ledger entries and may temporarily exceed `balance` while a workflow
 run holds an open reserve. `used` reflects credits consumed in the current
 billing period. `plan_grant` is the total monthly credit allowance for the
-caller's plan, enabling a "X / Y used" display. `period_start` and
-`period_end` mark the boundaries of the current billing window; free-tier
-callers use a calendar-month boundary.
+caller's plan, enabling a "X / Y used" display. `period_start` is the current
+credit anchor and `period_end` is the next EXPECTED credit-reset boundary
+(`period_start` + 1 month), or null when no reset is promised — Free/one-time,
+unanchored, a canceling/ended entitlement, or a monthly renewal whose boundary
+passed without confirmed payment. `period_end` is the expected boundary, not a
+guaranteed grant time: monthly credits stay gated on successful Stripe payment.
+For an annual subscriber this GET may perform idempotent maintenance, granting
+any due intermediate monthly credits before returning; retries remain safe.
 </dd>
 </dl>
 </dd>

src/onepin/types/__init__.py

@@ -99,6 +99,7 @@
     from .numeric_option import NumericOption
     from .pagination_meta import PaginationMeta
     from .plan_limits import PlanLimits
+    from .plan_limits_credits_renewal import PlanLimitsCreditsRenewal
     from .plan_tier import PlanTier
     from .port_out import PortOut
     from .pronunciation_suggestion import PronunciationSuggestion
@@ -193,6 +194,9 @@
     from .workflow_run_overview_validator_out import WorkflowRunOverviewValidatorOut
     from .workflow_run_overview_validator_out_status import WorkflowRunOverviewValidatorOutStatus
     from .workflow_run_overview_workflow_out import WorkflowRunOverviewWorkflowOut
+    from .workflow_run_sink_output_delivery import WorkflowRunSinkOutputDelivery
+    from .workflow_run_sink_output_delivery_check import WorkflowRunSinkOutputDeliveryCheck
+    from .workflow_run_sink_output_line import WorkflowRunSinkOutputLine
     from .workflow_run_sink_output_out import WorkflowRunSinkOutputOut
     from .workflow_run_start_in import WorkflowRunStartIn
     from .workflow_run_status_out import WorkflowRunStatusOut
@@ -295,6 +299,7 @@
     "NumericOption": ".numeric_option",
     "PaginationMeta": ".pagination_meta",
     "PlanLimits": ".plan_limits",
+    "PlanLimitsCreditsRenewal": ".plan_limits_credits_renewal",
     "PlanTier": ".plan_tier",
     "PortOut": ".port_out",
     "PronunciationSuggestion": ".pronunciation_suggestion",
@@ -389,6 +394,9 @@
     "WorkflowRunOverviewValidatorOut": ".workflow_run_overview_validator_out",
     "WorkflowRunOverviewValidatorOutStatus": ".workflow_run_overview_validator_out_status",
     "WorkflowRunOverviewWorkflowOut": ".workflow_run_overview_workflow_out",
+    "WorkflowRunSinkOutputDelivery": ".workflow_run_sink_output_delivery",
+    "WorkflowRunSinkOutputDeliveryCheck": ".workflow_run_sink_output_delivery_check",
+    "WorkflowRunSinkOutputLine": ".workflow_run_sink_output_line",
     "WorkflowRunSinkOutputOut": ".workflow_run_sink_output_out",
     "WorkflowRunStartIn": ".workflow_run_start_in",
     "WorkflowRunStatusOut": ".workflow_run_status_out",
@@ -515,6 +523,7 @@ def __dir__():
     "NumericOption",
     "PaginationMeta",
     "PlanLimits",
+    "PlanLimitsCreditsRenewal",
     "PlanTier",
     "PortOut",
     "PronunciationSuggestion",
@@ -609,6 +618,9 @@ def __dir__():
     "WorkflowRunOverviewValidatorOut",
     "WorkflowRunOverviewValidatorOutStatus",
     "WorkflowRunOverviewWorkflowOut",
+    "WorkflowRunSinkOutputDelivery",
+    "WorkflowRunSinkOutputDeliveryCheck",
+    "WorkflowRunSinkOutputLine",
     "WorkflowRunSinkOutputOut",
     "WorkflowRunStartIn",
     "WorkflowRunStatusOut",

src/onepin/types/api_error_detail.py

@@ -9,6 +9,8 @@
 class ApiErrorDetail(UniversalBaseModel):
     field: str
     message: str
+    line_numbers: typing.Optional[typing.List[int]] = None
+    min_chars: typing.Optional[int] = None
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

src/onepin/types/balance_response.py

@@ -13,7 +13,26 @@ class BalanceResponse(UniversalBaseModel):
     Per-user credit balance + period anchor (consumed by GET /users/me/credits).
     """
 
-    balance: int
+    balance: int = pydantic.Field()
+    """
+    Total spendable credits = monthly_balance + free_balance.
+    """
+
+    monthly_balance: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Expiring bucket: the current paid cycle's allowance, replaced each renewal. 0 on Free.
+    """
+
+    free_balance: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Lifetime bucket: the one-time Free grant. Never expires; spent last (after monthly).
+    """
+
+    free_grant: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    All-time ceiling of the lifetime free bucket.
+    """
+
     used: typing.Optional[int] = pydantic.Field(default=None)
     """
     Ledger-derived credits used in the current billing period.
@@ -24,10 +43,28 @@ class BalanceResponse(UniversalBaseModel):
     Ledger-derived settled credits remaining for display only. Excludes in-flight open reserves, so this may exceed `balance` while a workflow is executing. Use `balance` for gate decisions.
     """
 
-    period_start: typing.Optional[dt.datetime] = None
-    period_end: typing.Optional[dt.datetime] = None
+    period_start: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    Start of the current credit period (the stored credit anchor). Null on Free/unanchored accounts.
+    """
+
+    period_end: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    Next EXPECTED credit-reset boundary (`period_start` + 1 calendar month), or null when no reset is currently promised: Free/one-time or unanchored accounts, a canceling/ended entitlement with no future grant, or a monthly renewal whose boundary has already passed without confirmed payment. This is the expected boundary, not a guaranteed grant time — monthly credits (including an annual subscription's renewal) stay gated on successful Stripe payment and may become available shortly after this time. An annual subscription's intermediate monthly boundaries are deterministic and are granted on access. Distinct from `CustomerSubscriptionResponse.current_period_end`, which remains the Stripe billing/entitlement boundary and must not be used as the credit-refresh time.
+    """
+
     plan_grant: int
     plan_tier: PlanTier
+    overage_rate_cents_per_credit: typing.Optional[float] = None
+    overage_cents: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Overage billed so far this billing cycle, in cents.
+    """
+
+    credits_absorbed: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Total credits discounted by floor-rounding this billing period.
+    """
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

src/onepin/types/estimate_response.py

@@ -22,6 +22,9 @@ class EstimateResponse(UniversalBaseModel):
     current_balance: int
     deficit_at_max: int
     can_run: bool
+    overage_rate_cents_per_credit: typing.Optional[float] = None
+    will_incur_overage: typing.Optional[bool] = None
+    estimated_overage_cents: typing.Optional[int] = None
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

src/onepin/types/plan_limits.py

@@ -4,6 +4,7 @@
 
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .plan_limits_credits_renewal import PlanLimitsCreditsRenewal
 
 
 class PlanLimits(UniversalBaseModel):
@@ -18,6 +19,9 @@ class PlanLimits(UniversalBaseModel):
     retention_days: typing.Optional[int] = None
     byok_enabled: typing.Optional[bool] = None
     auto_fix_enabled: typing.Optional[bool] = None
+    credits_renewal: typing.Optional[PlanLimitsCreditsRenewal] = None
+    downloads_enabled: typing.Optional[bool] = None
+    overage_rate_cents_per_credit: typing.Optional[float] = None
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

src/onepin/types/plan_limits_credits_renewal.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+PlanLimitsCreditsRenewal = typing.Union[typing.Literal["monthly", "one_time"], typing.Any]

src/onepin/types/voice_out.py

@@ -73,11 +73,6 @@ class VoiceOut(UniversalBaseModel):
     Freeform keyword tags for filtering and search.
     """
 
-    descriptor: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    Short one-line voice personality descriptor.
-    """
-
     uses_count: typing.Optional[int] = pydantic.Field(default=None)
     """
     Number of times this voice has been used in workflow runs across the platform.

src/onepin/types/voice_similar_out.py

@@ -73,11 +73,6 @@ class VoiceSimilarOut(UniversalBaseModel):
     Freeform keyword tags for filtering and search.
     """
 
-    descriptor: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    Short one-line voice personality descriptor.
-    """
-
     uses_count: typing.Optional[int] = pydantic.Field(default=None)
     """
     Number of times this voice has been used in workflow runs across the platform.

src/onepin/types/workflow_run_detail_out.py

@@ -36,6 +36,11 @@ class WorkflowRunDetailOut(UniversalBaseModel):
     has_export: typing.Optional[bool] = None
     triggered_by: typing.Optional[TriggeredByOut] = None
     credits: typing.Optional[int] = None
+    credits_absorbed: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Credits discounted by floor-rounding for this run. This is the sub-credit remainder above the charged (floored) credits; charged credits plus this value reconstructs true cost only for fully covered, uncapped runs. Returns 0 for unsettled or legacy runs.
+    """
+
     definition_snapshot: typing.Optional[typing.Dict[str, typing.Any]] = None
 
     if IS_PYDANTIC_V2:

src/onepin/types/workflow_run_outputs_out.py

@@ -11,6 +11,11 @@ class WorkflowRunOutputsOut(UniversalBaseModel):
     run_id: str
     run_status: str
     credits: typing.Optional[int] = None
+    credits_absorbed: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Credits discounted by floor-rounding for this run. This is the sub-credit remainder above the charged (floored) credits; charged credits plus this value reconstructs true cost only for fully covered, uncapped runs. Returns 0 for unsettled or legacy runs.
+    """
+
     outputs: typing.List[WorkflowRunSinkOutputOut]
 
     if IS_PYDANTIC_V2:

src/onepin/types/workflow_run_sink_output_delivery.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .workflow_run_sink_output_delivery_check import WorkflowRunSinkOutputDeliveryCheck
+
+
+class WorkflowRunSinkOutputDelivery(UniversalBaseModel):
+    passed: bool
+    failing_checks: typing.List[WorkflowRunSinkOutputDeliveryCheck]
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

src/onepin/types/workflow_run_sink_output_delivery_check.py

@@ -0,0 +1,22 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class WorkflowRunSinkOutputDeliveryCheck(UniversalBaseModel):
+    kind: str
+    label: str
+    score: typing.Optional[float] = None
+    threshold: typing.Optional[float] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

src/onepin/types/workflow_run_sink_output_line.py

@@ -0,0 +1,22 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .workflow_run_sink_output_delivery import WorkflowRunSinkOutputDelivery
+
+
+class WorkflowRunSinkOutputLine(UniversalBaseModel):
+    audio_files: typing.Optional[typing.List[typing.Dict[str, typing.Any]]] = None
+    recommended_audio_file_index: typing.Optional[int] = None
+    delivery: typing.Optional[WorkflowRunSinkOutputDelivery] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

src/onepin/types/workflow_run_sink_output_out.py

@@ -4,14 +4,15 @@
 
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .workflow_run_sink_output_line import WorkflowRunSinkOutputLine
 
 
 class WorkflowRunSinkOutputOut(UniversalBaseModel):
     node_id: str
     node_type: str
     display_name: str
     status: str
-    lines: typing.List[typing.Dict[str, typing.Any]]
+    lines: typing.List[WorkflowRunSinkOutputLine]
     line_count: int
     truncated: bool