airbyte-agent-hubspot 0.15.20__py3-none-any.whl

airbyte_agent_hubspot/models.py

@@ -0,0 +1,438 @@
+"""
+Pydantic models for hubspot connector.
+
+This module contains Pydantic models used for authentication configuration
+and response envelope types.
+"""
+
+from __future__ import annotations
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing import TypeVar, Generic, Union, Any
+
+# Authentication configuration
+
+class HubspotAuthConfig(BaseModel):
+    """OAuth2 Authentication"""
+
+    model_config = ConfigDict(extra="forbid")
+
+    client_id: str
+    """Your HubSpot OAuth2 Client ID"""
+    client_secret: str
+    """Your HubSpot OAuth2 Client Secret"""
+    refresh_token: str
+    """Your HubSpot OAuth2 Refresh Token"""
+    access_token: str
+    """Your HubSpot OAuth2 Access Token (optional if refresh_token is provided)"""
+
+# ===== RESPONSE TYPE DEFINITIONS (PYDANTIC) =====
+
+class ContactProperties(BaseModel):
+    """Contact properties"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    createdate: Union[str | None, Any] = Field(default=None)
+    email: Union[str | None, Any] = Field(default=None)
+    firstname: Union[str | None, Any] = Field(default=None)
+    hs_object_id: Union[str | None, Any] = Field(default=None)
+    lastmodifieddate: Union[str | None, Any] = Field(default=None)
+    lastname: Union[str | None, Any] = Field(default=None)
+
+class Contact(BaseModel):
+    """HubSpot contact object"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    properties: Union[ContactProperties, Any] = Field(default=None)
+    created_at: Union[str, Any] = Field(default=None, alias="createdAt")
+    updated_at: Union[str, Any] = Field(default=None, alias="updatedAt")
+    archived: Union[bool, Any] = Field(default=None)
+    archived_at: Union[str | None, Any] = Field(default=None, alias="archivedAt")
+    properties_with_history: Union[dict[str, Any] | None, Any] = Field(default=None, alias="propertiesWithHistory")
+    associations: Union[dict[str, Any] | None, Any] = Field(default=None)
+    object_write_trace_id: Union[str | None, Any] = Field(default=None, alias="objectWriteTraceId")
+    url: Union[str | None, Any] = Field(default=None)
+
+class PagingNext(BaseModel):
+    """Nested schema for Paging.next"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    after: Union[str, Any] = Field(default=None, description="Cursor for next page")
+    """Cursor for next page"""
+    link: Union[str, Any] = Field(default=None, description="URL for next page")
+    """URL for next page"""
+
+class Paging(BaseModel):
+    """Pagination information"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    next: Union[PagingNext, Any] = Field(default=None)
+
+class ContactsList(BaseModel):
+    """Paginated list of contacts"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    results: Union[list[Contact], Any] = Field(default=None)
+    paging: Union[Paging, Any] = Field(default=None)
+    total: Union[int, Any] = Field(default=None)
+
+class CompanyProperties(BaseModel):
+    """Company properties"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    createdate: Union[str | None, Any] = Field(default=None)
+    domain: Union[str | None, Any] = Field(default=None)
+    hs_lastmodifieddate: Union[str | None, Any] = Field(default=None)
+    hs_object_id: Union[str | None, Any] = Field(default=None)
+    name: Union[str | None, Any] = Field(default=None)
+
+class Company(BaseModel):
+    """HubSpot company object"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    properties: Union[CompanyProperties, Any] = Field(default=None)
+    created_at: Union[str, Any] = Field(default=None, alias="createdAt")
+    updated_at: Union[str, Any] = Field(default=None, alias="updatedAt")
+    archived: Union[bool, Any] = Field(default=None)
+    archived_at: Union[str | None, Any] = Field(default=None, alias="archivedAt")
+    properties_with_history: Union[dict[str, Any] | None, Any] = Field(default=None, alias="propertiesWithHistory")
+    associations: Union[dict[str, Any] | None, Any] = Field(default=None)
+    object_write_trace_id: Union[str | None, Any] = Field(default=None, alias="objectWriteTraceId")
+    url: Union[str | None, Any] = Field(default=None)
+
+class CompaniesList(BaseModel):
+    """Paginated list of companies"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    results: Union[list[Company], Any] = Field(default=None)
+    paging: Union[Paging, Any] = Field(default=None)
+    total: Union[int, Any] = Field(default=None)
+
+class DealProperties(BaseModel):
+    """Deal properties"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    amount: Union[str | None, Any] = Field(default=None)
+    closedate: Union[str | None, Any] = Field(default=None)
+    createdate: Union[str | None, Any] = Field(default=None)
+    dealname: Union[str | None, Any] = Field(default=None)
+    dealstage: Union[str | None, Any] = Field(default=None)
+    hs_lastmodifieddate: Union[str | None, Any] = Field(default=None)
+    hs_object_id: Union[str | None, Any] = Field(default=None)
+    pipeline: Union[str | None, Any] = Field(default=None)
+
+class Deal(BaseModel):
+    """HubSpot deal object"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    properties: Union[DealProperties, Any] = Field(default=None)
+    created_at: Union[str, Any] = Field(default=None, alias="createdAt")
+    updated_at: Union[str, Any] = Field(default=None, alias="updatedAt")
+    archived: Union[bool, Any] = Field(default=None)
+    archived_at: Union[str | None, Any] = Field(default=None, alias="archivedAt")
+    properties_with_history: Union[dict[str, Any] | None, Any] = Field(default=None, alias="propertiesWithHistory")
+    associations: Union[dict[str, Any] | None, Any] = Field(default=None)
+    object_write_trace_id: Union[str | None, Any] = Field(default=None, alias="objectWriteTraceId")
+    url: Union[str | None, Any] = Field(default=None)
+
+class DealsList(BaseModel):
+    """Paginated list of deals"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    results: Union[list[Deal], Any] = Field(default=None)
+    paging: Union[Paging, Any] = Field(default=None)
+    total: Union[int, Any] = Field(default=None)
+
+class TicketProperties(BaseModel):
+    """Ticket properties"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    content: Union[str | None, Any] = Field(default=None)
+    createdate: Union[str | None, Any] = Field(default=None)
+    hs_lastmodifieddate: Union[str | None, Any] = Field(default=None)
+    hs_object_id: Union[str | None, Any] = Field(default=None)
+    hs_pipeline: Union[str | None, Any] = Field(default=None)
+    hs_pipeline_stage: Union[str | None, Any] = Field(default=None)
+    hs_ticket_category: Union[str | None, Any] = Field(default=None)
+    hs_ticket_priority: Union[str | None, Any] = Field(default=None)
+    subject: Union[str | None, Any] = Field(default=None)
+
+class Ticket(BaseModel):
+    """HubSpot ticket object"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    properties: Union[TicketProperties, Any] = Field(default=None)
+    created_at: Union[str, Any] = Field(default=None, alias="createdAt")
+    updated_at: Union[str, Any] = Field(default=None, alias="updatedAt")
+    archived: Union[bool, Any] = Field(default=None)
+    archived_at: Union[str | None, Any] = Field(default=None, alias="archivedAt")
+    properties_with_history: Union[dict[str, Any] | None, Any] = Field(default=None, alias="propertiesWithHistory")
+    associations: Union[dict[str, Any] | None, Any] = Field(default=None)
+    object_write_trace_id: Union[str | None, Any] = Field(default=None, alias="objectWriteTraceId")
+    url: Union[str | None, Any] = Field(default=None)
+
+class TicketsList(BaseModel):
+    """Paginated list of tickets"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    results: Union[list[Ticket], Any] = Field(default=None)
+    paging: Union[Paging, Any] = Field(default=None)
+    total: Union[int, Any] = Field(default=None)
+
+class SchemaPropertiesItemModificationmetadata(BaseModel):
+    """Nested schema for SchemaPropertiesItem.modificationMetadata"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    archivable: Union[bool, Any] = Field(default=None)
+    read_only_definition: Union[bool, Any] = Field(default=None, alias="readOnlyDefinition")
+    read_only_value: Union[bool, Any] = Field(default=None, alias="readOnlyValue")
+    read_only_options: Union[bool, Any] = Field(default=None, alias="readOnlyOptions")
+
+class SchemaPropertiesItem(BaseModel):
+    """Nested schema for Schema.properties_item"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    name: Union[str, Any] = Field(default=None)
+    label: Union[str, Any] = Field(default=None)
+    type: Union[str, Any] = Field(default=None)
+    field_type: Union[str, Any] = Field(default=None, alias="fieldType")
+    description: Union[str, Any] = Field(default=None)
+    group_name: Union[str, Any] = Field(default=None, alias="groupName")
+    display_order: Union[int, Any] = Field(default=None, alias="displayOrder")
+    calculated: Union[bool, Any] = Field(default=None)
+    external_options: Union[bool, Any] = Field(default=None, alias="externalOptions")
+    archived: Union[bool, Any] = Field(default=None)
+    has_unique_value: Union[bool, Any] = Field(default=None, alias="hasUniqueValue")
+    hidden: Union[bool, Any] = Field(default=None)
+    form_field: Union[bool, Any] = Field(default=None, alias="formField")
+    data_sensitivity: Union[str, Any] = Field(default=None, alias="dataSensitivity")
+    hubspot_defined: Union[bool, Any] = Field(default=None, alias="hubspotDefined")
+    updated_at: Union[str, Any] = Field(default=None, alias="updatedAt")
+    created_at: Union[str, Any] = Field(default=None, alias="createdAt")
+    options: Union[list[Any], Any] = Field(default=None)
+    created_user_id: Union[str, Any] = Field(default=None, alias="createdUserId")
+    updated_user_id: Union[str, Any] = Field(default=None, alias="updatedUserId")
+    show_currency_symbol: Union[bool, Any] = Field(default=None, alias="showCurrencySymbol")
+    modification_metadata: Union[SchemaPropertiesItemModificationmetadata, Any] = Field(default=None, alias="modificationMetadata")
+
+class SchemaAssociationsItem(BaseModel):
+    """Nested schema for Schema.associations_item"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    from_object_type_id: Union[str, Any] = Field(default=None, alias="fromObjectTypeId")
+    to_object_type_id: Union[str, Any] = Field(default=None, alias="toObjectTypeId")
+    name: Union[str, Any] = Field(default=None)
+    cardinality: Union[str, Any] = Field(default=None)
+    id: Union[str, Any] = Field(default=None)
+    inverse_cardinality: Union[str, Any] = Field(default=None, alias="inverseCardinality")
+    has_user_enforced_max_to_object_ids: Union[bool, Any] = Field(default=None, alias="hasUserEnforcedMaxToObjectIds")
+    has_user_enforced_max_from_object_ids: Union[bool, Any] = Field(default=None, alias="hasUserEnforcedMaxFromObjectIds")
+    max_to_object_ids: Union[int, Any] = Field(default=None, alias="maxToObjectIds")
+    max_from_object_ids: Union[int, Any] = Field(default=None, alias="maxFromObjectIds")
+    created_at: Union[str | None, Any] = Field(default=None, alias="createdAt")
+    updated_at: Union[str | None, Any] = Field(default=None, alias="updatedAt")
+
+class SchemaLabels(BaseModel):
+    """Display labels"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    singular: Union[str, Any] = Field(default=None)
+    plural: Union[str, Any] = Field(default=None)
+
+class Schema(BaseModel):
+    """Custom object schema definition"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    name: Union[str, Any] = Field(default=None)
+    labels: Union[SchemaLabels, Any] = Field(default=None)
+    object_type_id: Union[str, Any] = Field(default=None, alias="objectTypeId")
+    fully_qualified_name: Union[str, Any] = Field(default=None, alias="fullyQualifiedName")
+    required_properties: Union[list[str], Any] = Field(default=None, alias="requiredProperties")
+    searchable_properties: Union[list[str], Any] = Field(default=None, alias="searchableProperties")
+    primary_display_property: Union[str, Any] = Field(default=None, alias="primaryDisplayProperty")
+    secondary_display_properties: Union[list[str], Any] = Field(default=None, alias="secondaryDisplayProperties")
+    description: Union[str | None, Any] = Field(default=None)
+    allows_sensitive_properties: Union[bool, Any] = Field(default=None, alias="allowsSensitiveProperties")
+    archived: Union[bool, Any] = Field(default=None)
+    restorable: Union[bool, Any] = Field(default=None)
+    meta_type: Union[str, Any] = Field(default=None, alias="metaType")
+    created_by_user_id: Union[int, Any] = Field(default=None, alias="createdByUserId")
+    updated_by_user_id: Union[int, Any] = Field(default=None, alias="updatedByUserId")
+    properties: Union[list[SchemaPropertiesItem], Any] = Field(default=None)
+    associations: Union[list[SchemaAssociationsItem], Any] = Field(default=None)
+    created_at: Union[str, Any] = Field(default=None, alias="createdAt")
+    updated_at: Union[str, Any] = Field(default=None, alias="updatedAt")
+
+class SchemasList(BaseModel):
+    """List of custom object schemas"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    results: Union[list[Schema], Any] = Field(default=None)
+
+class CRMObjectProperties(BaseModel):
+    """Object properties"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    hs_createdate: Union[str | None, Any] = Field(default=None)
+    hs_lastmodifieddate: Union[str | None, Any] = Field(default=None)
+    hs_object_id: Union[str | None, Any] = Field(default=None)
+
+class CRMObject(BaseModel):
+    """Generic HubSpot CRM object (for custom objects)"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    properties: Union[CRMObjectProperties, Any] = Field(default=None)
+    created_at: Union[str, Any] = Field(default=None, alias="createdAt")
+    updated_at: Union[str, Any] = Field(default=None, alias="updatedAt")
+    archived: Union[bool, Any] = Field(default=None)
+    archived_at: Union[str | None, Any] = Field(default=None, alias="archivedAt")
+    properties_with_history: Union[dict[str, Any] | None, Any] = Field(default=None, alias="propertiesWithHistory")
+    associations: Union[dict[str, Any] | None, Any] = Field(default=None)
+    object_write_trace_id: Union[str | None, Any] = Field(default=None, alias="objectWriteTraceId")
+    url: Union[str | None, Any] = Field(default=None)
+
+class ObjectsList(BaseModel):
+    """Paginated list of generic CRM objects"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    results: Union[list[CRMObject], Any] = Field(default=None)
+    paging: Union[Paging, Any] = Field(default=None)
+
+# ===== METADATA TYPE DEFINITIONS (PYDANTIC) =====
+# Meta types for operations that extract metadata (e.g., pagination info)
+
+class ContactsListResultMeta(BaseModel):
+    """Metadata for contacts.list operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    next_cursor: Union[str, Any] = Field(default=None)
+    next_link: Union[str, Any] = Field(default=None)
+
+class ContactsSearchResultMeta(BaseModel):
+    """Metadata for contacts.search operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total: Union[int, Any] = Field(default=None)
+    next_cursor: Union[str, Any] = Field(default=None)
+    next_link: Union[str, Any] = Field(default=None)
+
+class CompaniesListResultMeta(BaseModel):
+    """Metadata for companies.list operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    next_cursor: Union[str, Any] = Field(default=None)
+    next_link: Union[str, Any] = Field(default=None)
+
+class CompaniesSearchResultMeta(BaseModel):
+    """Metadata for companies.search operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total: Union[int, Any] = Field(default=None)
+    next_cursor: Union[str, Any] = Field(default=None)
+    next_link: Union[str, Any] = Field(default=None)
+
+class DealsListResultMeta(BaseModel):
+    """Metadata for deals.list operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    next_cursor: Union[str, Any] = Field(default=None)
+    next_link: Union[str, Any] = Field(default=None)
+
+class DealsSearchResultMeta(BaseModel):
+    """Metadata for deals.search operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total: Union[int, Any] = Field(default=None)
+    next_cursor: Union[str, Any] = Field(default=None)
+    next_link: Union[str, Any] = Field(default=None)
+
+class TicketsListResultMeta(BaseModel):
+    """Metadata for tickets.list operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    next_cursor: Union[str, Any] = Field(default=None)
+    next_link: Union[str, Any] = Field(default=None)
+
+class TicketsSearchResultMeta(BaseModel):
+    """Metadata for tickets.search operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total: Union[int, Any] = Field(default=None)
+    next_cursor: Union[str, Any] = Field(default=None)
+    next_link: Union[str, Any] = Field(default=None)
+
+class ObjectsListResultMeta(BaseModel):
+    """Metadata for objects.list operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    next_cursor: Union[str, Any] = Field(default=None)
+    next_link: Union[str, Any] = Field(default=None)
+
+# ===== RESPONSE ENVELOPE MODELS =====
+
+# Type variables for generic envelope models
+T = TypeVar('T')
+S = TypeVar('S')
+
+
+class HubspotExecuteResult(BaseModel, Generic[T]):
+    """Response envelope with data only.
+
+    Used for actions that return data without metadata.
+    """
+    model_config = ConfigDict(extra="forbid")
+
+    data: T
+    """Response data containing the result of the action."""
+
+
+class HubspotExecuteResultWithMeta(HubspotExecuteResult[T], Generic[T, S]):
+    """Response envelope with data and metadata.
+
+    Used for actions that return both data and metadata (e.g., pagination info).
+    """
+    meta: S
+    """Metadata about the response (e.g., pagination cursors, record counts)."""
+
+
+# ===== OPERATION RESULT TYPE ALIASES =====
+
+# Concrete type aliases for each operation result.
+# These provide simpler, more readable type annotations than using the generic forms.
+
+ContactsListResult = HubspotExecuteResultWithMeta[list[Contact], ContactsListResultMeta]
+"""Result type for contacts.list operation with data and metadata."""
+
+ContactsSearchResult = HubspotExecuteResultWithMeta[list[Contact], ContactsSearchResultMeta]
+"""Result type for contacts.search operation with data and metadata."""
+
+CompaniesListResult = HubspotExecuteResultWithMeta[list[Company], CompaniesListResultMeta]
+"""Result type for companies.list operation with data and metadata."""
+
+CompaniesSearchResult = HubspotExecuteResultWithMeta[list[Company], CompaniesSearchResultMeta]
+"""Result type for companies.search operation with data and metadata."""
+
+DealsListResult = HubspotExecuteResultWithMeta[list[Deal], DealsListResultMeta]
+"""Result type for deals.list operation with data and metadata."""
+
+DealsSearchResult = HubspotExecuteResultWithMeta[list[Deal], DealsSearchResultMeta]
+"""Result type for deals.search operation with data and metadata."""
+
+TicketsListResult = HubspotExecuteResultWithMeta[list[Ticket], TicketsListResultMeta]
+"""Result type for tickets.list operation with data and metadata."""
+
+TicketsSearchResult = HubspotExecuteResultWithMeta[list[Ticket], TicketsSearchResultMeta]
+"""Result type for tickets.search operation with data and metadata."""
+
+SchemasListResult = HubspotExecuteResult[list[Schema]]
+"""Result type for schemas.list operation."""
+
+ObjectsListResult = HubspotExecuteResultWithMeta[list[CRMObject], ObjectsListResultMeta]
+"""Result type for objects.list operation with data and metadata."""
+

airbyte_agent_hubspot/types.py

@@ -0,0 +1,217 @@
+"""
+Type definitions for hubspot connector.
+"""
+from __future__ import annotations
+
+# Use typing_extensions.TypedDict for Pydantic compatibility on Python < 3.12
+try:
+    from typing_extensions import TypedDict, NotRequired
+except ImportError:
+    from typing import TypedDict, NotRequired  # type: ignore[attr-defined]
+
+
+
+# ===== NESTED PARAM TYPE DEFINITIONS =====
+# Nested parameter schemas discovered during parameter extraction
+
+class ContactsSearchParamsFiltergroupsItemFiltersItem(TypedDict):
+    """Nested schema for ContactsSearchParamsFiltergroupsItem.filters_item"""
+    operator: NotRequired[str]
+    propertyName: NotRequired[str]
+    value: NotRequired[str]
+    values: NotRequired[list[str]]
+
+class ContactsSearchParamsFiltergroupsItem(TypedDict):
+    """Nested schema for ContactsSearchParams.filterGroups_item"""
+    filters: NotRequired[list[ContactsSearchParamsFiltergroupsItemFiltersItem]]
+
+class ContactsSearchParamsSortsItem(TypedDict):
+    """Nested schema for ContactsSearchParams.sorts_item"""
+    propertyName: NotRequired[str]
+    direction: NotRequired[str]
+
+class CompaniesSearchParamsFiltergroupsItemFiltersItem(TypedDict):
+    """Nested schema for CompaniesSearchParamsFiltergroupsItem.filters_item"""
+    operator: NotRequired[str]
+    propertyName: NotRequired[str]
+    value: NotRequired[str]
+    values: NotRequired[list[str]]
+
+class CompaniesSearchParamsFiltergroupsItem(TypedDict):
+    """Nested schema for CompaniesSearchParams.filterGroups_item"""
+    filters: NotRequired[list[CompaniesSearchParamsFiltergroupsItemFiltersItem]]
+
+class CompaniesSearchParamsSortsItem(TypedDict):
+    """Nested schema for CompaniesSearchParams.sorts_item"""
+    propertyName: NotRequired[str]
+    direction: NotRequired[str]
+
+class DealsSearchParamsFiltergroupsItemFiltersItem(TypedDict):
+    """Nested schema for DealsSearchParamsFiltergroupsItem.filters_item"""
+    operator: NotRequired[str]
+    propertyName: NotRequired[str]
+    value: NotRequired[str]
+    values: NotRequired[list[str]]
+
+class DealsSearchParamsFiltergroupsItem(TypedDict):
+    """Nested schema for DealsSearchParams.filterGroups_item"""
+    filters: NotRequired[list[DealsSearchParamsFiltergroupsItemFiltersItem]]
+
+class DealsSearchParamsSortsItem(TypedDict):
+    """Nested schema for DealsSearchParams.sorts_item"""
+    propertyName: NotRequired[str]
+    direction: NotRequired[str]
+
+class TicketsSearchParamsFiltergroupsItemFiltersItem(TypedDict):
+    """Nested schema for TicketsSearchParamsFiltergroupsItem.filters_item"""
+    operator: NotRequired[str]
+    propertyName: NotRequired[str]
+    value: NotRequired[str]
+    values: NotRequired[list[str]]
+
+class TicketsSearchParamsFiltergroupsItem(TypedDict):
+    """Nested schema for TicketsSearchParams.filterGroups_item"""
+    filters: NotRequired[list[TicketsSearchParamsFiltergroupsItemFiltersItem]]
+
+class TicketsSearchParamsSortsItem(TypedDict):
+    """Nested schema for TicketsSearchParams.sorts_item"""
+    propertyName: NotRequired[str]
+    direction: NotRequired[str]
+
+# ===== OPERATION PARAMS TYPE DEFINITIONS =====
+
+class ContactsListParams(TypedDict):
+    """Parameters for contacts.list operation"""
+    limit: NotRequired[int]
+    after: NotRequired[str]
+    associations: NotRequired[str]
+    properties: NotRequired[str]
+    properties_with_history: NotRequired[str]
+    archived: NotRequired[bool]
+
+class ContactsGetParams(TypedDict):
+    """Parameters for contacts.get operation"""
+    contact_id: str
+    properties: NotRequired[str]
+    properties_with_history: NotRequired[str]
+    associations: NotRequired[str]
+    id_property: NotRequired[str]
+    archived: NotRequired[bool]
+
+class ContactsSearchParams(TypedDict):
+    """Parameters for contacts.search operation"""
+    filter_groups: NotRequired[list[ContactsSearchParamsFiltergroupsItem]]
+    properties: NotRequired[list[str]]
+    limit: NotRequired[int]
+    after: NotRequired[str]
+    sorts: NotRequired[list[ContactsSearchParamsSortsItem]]
+    query: NotRequired[str]
+
+class CompaniesListParams(TypedDict):
+    """Parameters for companies.list operation"""
+    limit: NotRequired[int]
+    after: NotRequired[str]
+    associations: NotRequired[str]
+    properties: NotRequired[str]
+    properties_with_history: NotRequired[str]
+    archived: NotRequired[bool]
+
+class CompaniesGetParams(TypedDict):
+    """Parameters for companies.get operation"""
+    company_id: str
+    properties: NotRequired[str]
+    properties_with_history: NotRequired[str]
+    associations: NotRequired[str]
+    id_property: NotRequired[str]
+    archived: NotRequired[bool]
+
+class CompaniesSearchParams(TypedDict):
+    """Parameters for companies.search operation"""
+    filter_groups: NotRequired[list[CompaniesSearchParamsFiltergroupsItem]]
+    properties: NotRequired[list[str]]
+    limit: NotRequired[int]
+    after: NotRequired[str]
+    sorts: NotRequired[list[CompaniesSearchParamsSortsItem]]
+    query: NotRequired[str]
+
+class DealsListParams(TypedDict):
+    """Parameters for deals.list operation"""
+    limit: NotRequired[int]
+    after: NotRequired[str]
+    associations: NotRequired[str]
+    properties: NotRequired[str]
+    properties_with_history: NotRequired[str]
+    archived: NotRequired[bool]
+
+class DealsGetParams(TypedDict):
+    """Parameters for deals.get operation"""
+    deal_id: str
+    properties: NotRequired[str]
+    properties_with_history: NotRequired[str]
+    associations: NotRequired[str]
+    id_property: NotRequired[str]
+    archived: NotRequired[bool]
+
+class DealsSearchParams(TypedDict):
+    """Parameters for deals.search operation"""
+    filter_groups: NotRequired[list[DealsSearchParamsFiltergroupsItem]]
+    properties: NotRequired[list[str]]
+    limit: NotRequired[int]
+    after: NotRequired[str]
+    sorts: NotRequired[list[DealsSearchParamsSortsItem]]
+    query: NotRequired[str]
+
+class TicketsListParams(TypedDict):
+    """Parameters for tickets.list operation"""
+    limit: NotRequired[int]
+    after: NotRequired[str]
+    associations: NotRequired[str]
+    properties: NotRequired[str]
+    properties_with_history: NotRequired[str]
+    archived: NotRequired[bool]
+
+class TicketsGetParams(TypedDict):
+    """Parameters for tickets.get operation"""
+    ticket_id: str
+    properties: NotRequired[str]
+    properties_with_history: NotRequired[str]
+    associations: NotRequired[str]
+    id_property: NotRequired[str]
+    archived: NotRequired[bool]
+
+class TicketsSearchParams(TypedDict):
+    """Parameters for tickets.search operation"""
+    filter_groups: NotRequired[list[TicketsSearchParamsFiltergroupsItem]]
+    properties: NotRequired[list[str]]
+    limit: NotRequired[int]
+    after: NotRequired[str]
+    sorts: NotRequired[list[TicketsSearchParamsSortsItem]]
+    query: NotRequired[str]
+
+class SchemasListParams(TypedDict):
+    """Parameters for schemas.list operation"""
+    archived: NotRequired[bool]
+
+class SchemasGetParams(TypedDict):
+    """Parameters for schemas.get operation"""
+    object_type: str
+
+class ObjectsListParams(TypedDict):
+    """Parameters for objects.list operation"""
+    object_type: str
+    limit: NotRequired[int]
+    after: NotRequired[str]
+    properties: NotRequired[str]
+    archived: NotRequired[bool]
+    associations: NotRequired[str]
+    properties_with_history: NotRequired[str]
+
+class ObjectsGetParams(TypedDict):
+    """Parameters for objects.get operation"""
+    object_type: str
+    object_id: str
+    properties: NotRequired[str]
+    archived: NotRequired[bool]
+    associations: NotRequired[str]
+    id_property: NotRequired[str]
+    properties_with_history: NotRequired[str]