airbyte-agent-shopify 0.1.16__py3-none-any.whl → 0.1.21__py3-none-any.whl

airbyte_agent_shopify/__init__.py

@@ -13,14 +13,14 @@ from .models import (
     CustomerAddressList,
     MarketingConsent,
     OrderAddress,
-    LineItem,
-    Fulfillment,
     Transaction,
     Refund,
+    LineItem,
+    Fulfillment,
     Order,
     OrderList,
-    ProductVariant,
     ProductImage,
+    ProductVariant,
     Product,
     ProductList,
     ProductVariantList,
@@ -88,6 +88,7 @@ from .models import (
     MetafieldProductImagesListResultMeta,
     CustomerAddressListResultMeta,
     FulfillmentOrdersListResultMeta,
+    ShopifyCheckResult,
     ShopifyExecuteResult,
     ShopifyExecuteResultWithMeta,
     CustomersListResult,
@@ -186,14 +187,14 @@ __all__ = [
     "CustomerAddressList",
     "MarketingConsent",
     "OrderAddress",
-    "LineItem",
-    "Fulfillment",
     "Transaction",
     "Refund",
+    "LineItem",
+    "Fulfillment",
     "Order",
     "OrderList",
-    "ProductVariant",
     "ProductImage",
+    "ProductVariant",
     "Product",
     "ProductList",
     "ProductVariantList",
@@ -261,6 +262,7 @@ __all__ = [
     "MetafieldProductImagesListResultMeta",
     "CustomerAddressListResultMeta",
     "FulfillmentOrdersListResultMeta",
+    "ShopifyCheckResult",
     "ShopifyExecuteResult",
     "ShopifyExecuteResultWithMeta",
     "CustomersListResult",

airbyte_agent_shopify/_vendored/connector_sdk/connector_model_loader.py

@@ -496,6 +496,9 @@ def convert_openapi_to_connector_model(spec: OpenAPIConnector) -> ConnectorModel
             # Extract untested flag
             untested = getattr(operation, "x_airbyte_untested", None) or False
 
+            # Extract preferred_for_check flag
+            preferred_for_check = getattr(operation, "x_airbyte_preferred_for_check", None) or False
+
             # Create endpoint definition
             endpoint = EndpointDefinition(
                 method=method_name.upper(),
@@ -520,6 +523,7 @@ def convert_openapi_to_connector_model(spec: OpenAPIConnector) -> ConnectorModel
                 graphql_body=graphql_body,
                 file_field=file_field,
                 untested=untested,
+                preferred_for_check=preferred_for_check,
             )
 
             # Add to entities map

airbyte_agent_shopify/_vendored/connector_sdk/executor/hosted_executor.py

@@ -164,6 +164,11 @@ class HostedExecutor:
                 span.record_exception(e)
                 raise
 
+    async def check(self) -> ExecutionResult:
+        """Perform a health check via the cloud API."""
+        config = ExecutionConfig(entity="*", action="check", params={})
+        return await self.execute(config)
+
     def _parse_execution_result(self, response: dict) -> ExecutionResult:
         """Parse API response into ExecutionResult.
 

airbyte_agent_shopify/_vendored/connector_sdk/executor/local_executor.py

@@ -70,6 +70,14 @@ class _OperationContext:
         self.validate_required_body_fields = executor._validate_required_body_fields
         self.extract_records = executor._extract_records
 
+    @property
+    def standard_handler(self) -> _StandardOperationHandler | None:
+        """Return the standard operation handler, or None if not registered."""
+        for h in self.executor._operation_handlers:
+            if isinstance(h, _StandardOperationHandler):
+                return h
+        return None
+
 
 class _OperationHandler(Protocol):
     """Protocol for operation handlers."""
@@ -544,6 +552,79 @@ class LocalExecutor:
             # These are "expected" execution errors - return them in ExecutionResult
             return ExecutionResult(success=False, data={}, error=str(e))
 
+    async def check(self) -> ExecutionResult:
+        """Perform a health check by running a lightweight list operation.
+
+        Finds the operation marked with preferred_for_check=True, or falls back
+        to the first list operation. Executes it with limit=1 to verify
+        connectivity and credentials.
+
+        Returns:
+            ExecutionResult with data containing status, error, and checked operation details.
+        """
+        check_entity = None
+        check_endpoint = None
+
+        # Look for preferred check operation
+        for (ent_name, op_action), endpoint in self._operation_index.items():
+            if getattr(endpoint, "preferred_for_check", False):
+                check_entity = ent_name
+                check_endpoint = endpoint
+                break
+
+        # Fallback to first list operation
+        if check_endpoint is None:
+            for (ent_name, op_action), endpoint in self._operation_index.items():
+                if op_action == Action.LIST:
+                    check_entity = ent_name
+                    check_endpoint = endpoint
+                    break
+
+        if check_endpoint is None or check_entity is None:
+            return ExecutionResult(
+                success=True,
+                data={
+                    "status": "unhealthy",
+                    "error": "No list operation available for health check",
+                },
+            )
+
+        # Find the standard handler to execute the list operation
+        standard_handler = next(
+            (h for h in self._operation_handlers if isinstance(h, _StandardOperationHandler)),
+            None,
+        )
+
+        if standard_handler is None:
+            return ExecutionResult(
+                success=True,
+                data={
+                    "status": "unhealthy",
+                    "error": "No standard handler available",
+                },
+            )
+
+        try:
+            await standard_handler.execute_operation(check_entity, Action.LIST, {"limit": 1})
+            return ExecutionResult(
+                success=True,
+                data={
+                    "status": "healthy",
+                    "checked_entity": check_entity,
+                    "checked_action": "list",
+                },
+            )
+        except Exception as e:
+            return ExecutionResult(
+                success=True,
+                data={
+                    "status": "unhealthy",
+                    "error": str(e),
+                    "checked_entity": check_entity,
+                    "checked_action": "list",
+                },
+            )
+
     async def _execute_operation(
         self,
         entity: str,

airbyte_agent_shopify/_vendored/connector_sdk/executor/models.py

@@ -154,6 +154,18 @@ class ExecutorProtocol(Protocol):
         """
         ...
 
+    async def check(self) -> ExecutionResult:
+        """Perform a health check to verify connectivity and credentials.
+
+        Returns:
+            ExecutionResult with data containing:
+                - status: "healthy" or "unhealthy"
+                - error: Error message if unhealthy
+                - checked_entity: Entity used for the check
+                - checked_action: Action used for the check
+        """
+        ...
+
 
 # ============================================================================
 # Executor Exceptions

airbyte_agent_shopify/_vendored/connector_sdk/introspection.py

@@ -380,7 +380,11 @@ def describe_entities(model: ConnectorModelProtocol) -> list[dict[str, Any]]:
     return entities
 
 
-def generate_tool_description(model: ConnectorModelProtocol) -> str:
+def generate_tool_description(
+    model: ConnectorModelProtocol,
+    *,
+    enable_hosted_mode_features: bool = True,
+) -> str:
     """Generate AI tool description from connector metadata.
 
     Produces a detailed description that includes:
@@ -393,6 +397,7 @@ def generate_tool_description(model: ConnectorModelProtocol) -> str:
 
     Args:
         model: Object conforming to ConnectorModelProtocol (e.g., ConnectorModel)
+        enable_hosted_mode_features: When False, omit hosted-mode search guidance from the docstring.
 
     Returns:
         Formatted description string suitable for AI tool documentation
@@ -402,8 +407,9 @@ def generate_tool_description(model: ConnectorModelProtocol) -> str:
     # at the first empty line and only keeps the initial section.
 
     # Entity/action parameter details (including pagination params like limit, starting_after)
-    search_field_paths = _collect_search_field_paths(model)
-    lines.append("ENTITIES AND PARAMETERS:")
+    search_field_paths = _collect_search_field_paths(model) if enable_hosted_mode_features else {}
+    # Avoid a "PARAMETERS:" header because some docstring parsers treat it as a params section marker.
+    lines.append("ENTITIES (ACTIONS + PARAMS):")
     for entity in model.entities:
         lines.append(f"  {entity.name}:")
         actions = getattr(entity, "actions", []) or []
@@ -427,8 +433,9 @@ def generate_tool_description(model: ConnectorModelProtocol) -> str:
     lines.append("  To paginate: pass starting_after=<last_id> while has_more is true")
 
     lines.append("GUIDELINES:")
-    lines.append('  - Prefer cached search over direct API calls when using execute(): action="search" whenever possible.')
-    lines.append("  - Direct API actions (list/get/download) are slower and should be used only if search cannot answer the query.")
+    if enable_hosted_mode_features:
+        lines.append('  - Prefer cached search over direct API calls when using execute(): action="search" whenever possible.')
+        lines.append("  - Direct API actions (list/get/download) are slower and should be used only if search cannot answer the query.")
     lines.append("  - Keep results small: use params.fields, params.query.filter, small params.limit, and cursor pagination.")
     lines.append("  - If output is too large, refine the query with tighter filters/fields/limit.")
 

airbyte_agent_shopify/_vendored/connector_sdk/schema/operations.py

@@ -86,6 +86,16 @@ class Operation(BaseModel):
             "Validation will generate a warning instead of an error when cassettes are missing."
         ),
     )
+    x_airbyte_preferred_for_check: bool | None = Field(
+        None,
+        alias="x-airbyte-preferred-for-check",
+        description=(
+            "Mark this list operation as the preferred operation for health checks. "
+            "When the CHECK action is executed, this operation will be used instead of "
+            "falling back to the first available list operation. Choose a lightweight, "
+            "always-available endpoint (e.g., users, accounts)."
+        ),
+    )
 
     # Future extensions (commented out, defined for future use)
     # from .extensions import PaginationConfig

airbyte_agent_shopify/_vendored/connector_sdk/telemetry/tracker.py

@@ -3,7 +3,7 @@
 import logging
 import platform
 import sys
-from datetime import datetime
+from datetime import UTC, datetime
 
 from ..observability import ObservabilitySession
 
@@ -56,7 +56,7 @@ class SegmentTracker:
 
         try:
             event = ConnectorInitEvent(
-                timestamp=datetime.utcnow(),
+                timestamp=datetime.now(UTC),
                 session_id=self.session.session_id,
                 user_id=self.session.user_id,
                 execution_context=self.session.execution_context,
@@ -99,7 +99,7 @@ class SegmentTracker:
 
         try:
             event = OperationEvent(
-                timestamp=datetime.utcnow(),
+                timestamp=datetime.now(UTC),
                 session_id=self.session.session_id,
                 user_id=self.session.user_id,
                 execution_context=self.session.execution_context,
@@ -129,7 +129,7 @@ class SegmentTracker:
 
         try:
             event = SessionEndEvent(
-                timestamp=datetime.utcnow(),
+                timestamp=datetime.now(UTC),
                 session_id=self.session.session_id,
                 user_id=self.session.user_id,
                 execution_context=self.session.execution_context,

airbyte_agent_shopify/_vendored/connector_sdk/types.py

@@ -15,7 +15,16 @@ from .schema.security import AirbyteAuthConfig
 
 
 class Action(str, Enum):
-    """Supported actions for Entity operations."""
+    """Supported actions for Entity operations.
+
+    Standard CRUD actions:
+        GET, CREATE, UPDATE, DELETE, LIST
+
+    Special actions:
+        API_SEARCH - Search via API endpoint
+        DOWNLOAD - Download file content
+        AUTHORIZE - OAuth authorization flow
+    """
 
     GET = "get"
     CREATE = "create"
@@ -223,6 +232,12 @@ class EndpointDefinition(BaseModel):
         description="Mark operation as untested to skip cassette validation (from x-airbyte-untested extension)",
     )
 
+    # Health check support (Airbyte extension)
+    preferred_for_check: bool = Field(
+        False,
+        description="Mark this list operation as preferred for health checks (from x-airbyte-preferred-for-check extension)",
+    )
+
 
 class EntityDefinition(BaseModel):
     """Definition of an API entity."""

airbyte_agent_shopify/_vendored/connector_sdk/validation.py

@@ -810,11 +810,31 @@ def validate_connector_readiness(connector_dir: str | Path) -> Dict[str, Any]:
 
     success = operations_missing_cassettes == 0 and cassettes_invalid == 0 and total_operations > 0
 
+    # Check for preferred_for_check on at least one list operation
+    has_preferred_check = False
+    for entity in config.entities:
+        for action_val in entity.actions:
+            endpoint = entity.endpoints.get(action_val)
+            if endpoint and getattr(endpoint, "preferred_for_check", False):
+                has_preferred_check = True
+                break
+        if has_preferred_check:
+            break
+
+    readiness_warnings = []
+    if not has_preferred_check:
+        readiness_warnings.append(
+            "No operation has x-airbyte-preferred-for-check: true. "
+            "Add this extension to a lightweight list operation (e.g., users.list) "
+            "to enable reliable health checks."
+        )
+
     return {
         "success": success,
         "connector_name": config.name,
         "connector_path": str(connector_path),
         "validation_results": validation_results,
+        "readiness_warnings": readiness_warnings,
         "summary": {
             "total_operations": total_operations,
             "operations_with_cassettes": operations_with_cassettes,

airbyte_agent_shopify/connector.py

@@ -74,6 +74,7 @@ if TYPE_CHECKING:
     from .models import ShopifyAuthConfig
 # Import response models and envelope models at runtime
 from .models import (
+    ShopifyCheckResult,
     ShopifyExecuteResult,
     ShopifyExecuteResultWithMeta,
     CustomersListResult,
@@ -900,6 +901,40 @@ class ShopifyConnector:
             # No extractors - return raw response data
             return result.data
 
+    # ===== HEALTH CHECK METHOD =====
+
+    async def check(self) -> ShopifyCheckResult:
+        """
+        Perform a health check to verify connectivity and credentials.
+
+        Executes a lightweight list operation (limit=1) to validate that
+        the connector can communicate with the API and credentials are valid.
+
+        Returns:
+            ShopifyCheckResult with status ("healthy" or "unhealthy") and optional error message
+
+        Example:
+            result = await connector.check()
+            if result.status == "healthy":
+                print("Connection verified!")
+            else:
+                print(f"Check failed: {result.error}")
+        """
+        result = await self._executor.check()
+
+        if result.success and isinstance(result.data, dict):
+            return ShopifyCheckResult(
+                status=result.data.get("status", "unhealthy"),
+                error=result.data.get("error"),
+                checked_entity=result.data.get("checked_entity"),
+                checked_action=result.data.get("checked_action"),
+            )
+        else:
+            return ShopifyCheckResult(
+                status="unhealthy",
+                error=result.error or "Unknown error during health check",
+            )
+
     # ===== INTROSPECTION METHODS =====
 
     @classmethod
@@ -908,6 +943,7 @@ class ShopifyConnector:
         func: _F | None = None,
         *,
         update_docstring: bool = True,
+        enable_hosted_mode_features: bool = True,
         max_output_chars: int | None = DEFAULT_MAX_OUTPUT_CHARS,
     ) -> _F | Callable[[_F], _F]:
         """
@@ -926,12 +962,16 @@ class ShopifyConnector:
 
         Args:
             update_docstring: When True, append connector capabilities to __doc__.
+            enable_hosted_mode_features: When False, omit hosted-mode search sections from docstrings.
             max_output_chars: Max serialized output size before raising. Use None to disable.
         """
 
         def decorate(inner: _F) -> _F:
             if update_docstring:
-                description = generate_tool_description(ShopifyConnectorModel)
+                description = generate_tool_description(
+                    ShopifyConnectorModel,
+                    enable_hosted_mode_features=enable_hosted_mode_features,
+                )
                 original_doc = inner.__doc__ or ""
                 if original_doc.strip():
                     full_doc = f"{original_doc.strip()}\n{description}"

airbyte_agent_shopify/connector_model.py

@@ -388,6 +388,7 @@ ShopifyConnectorModel: ConnectorModel = ConnectorModel(
                     },
                     record_extractor='$.customers',
                     meta_extractor={'next_page_url': '@link.next'},
+                    preferred_for_check=True,
                 ),
                 Action.GET: EndpointDefinition(
                     method='GET',

airbyte_agent_shopify/models.py

@@ -119,6 +119,55 @@ class OrderAddress(BaseModel):
     latitude: Union[float | None, Any] = Field(default=None)
     longitude: Union[float | None, Any] = Field(default=None)
 
+class Transaction(BaseModel):
+    """An order transaction"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[int, Any] = Field(default=None)
+    order_id: Union[int | None, Any] = Field(default=None)
+    kind: Union[str | None, Any] = Field(default=None)
+    gateway: Union[str | None, Any] = Field(default=None)
+    status: Union[str | None, Any] = Field(default=None)
+    message: Union[str | None, Any] = Field(default=None)
+    created_at: Union[str | None, Any] = Field(default=None)
+    test: Union[bool | None, Any] = Field(default=None)
+    authorization: Union[str | None, Any] = Field(default=None)
+    location_id: Union[int | None, Any] = Field(default=None)
+    user_id: Union[int | None, Any] = Field(default=None)
+    parent_id: Union[int | None, Any] = Field(default=None)
+    processed_at: Union[str | None, Any] = Field(default=None)
+    device_id: Union[int | None, Any] = Field(default=None)
+    error_code: Union[str | None, Any] = Field(default=None)
+    source_name: Union[str | None, Any] = Field(default=None)
+    receipt: Union[dict[str, Any] | None, Any] = Field(default=None)
+    currency_exchange_adjustment: Union[dict[str, Any] | None, Any] = Field(default=None)
+    amount: Union[str | None, Any] = Field(default=None)
+    currency: Union[str | None, Any] = Field(default=None)
+    payment_id: Union[str | None, Any] = Field(default=None)
+    total_unsettled_set: Union[dict[str, Any] | None, Any] = Field(default=None)
+    manual_payment_gateway: Union[bool | None, Any] = Field(default=None)
+    admin_graphql_api_id: Union[str | None, Any] = Field(default=None)
+
+class Refund(BaseModel):
+    """An order refund"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[int, Any] = Field(default=None)
+    order_id: Union[int | None, Any] = Field(default=None)
+    created_at: Union[str | None, Any] = Field(default=None)
+    note: Union[str | None, Any] = Field(default=None)
+    user_id: Union[int | None, Any] = Field(default=None)
+    processed_at: Union[str | None, Any] = Field(default=None)
+    restock: Union[bool | None, Any] = Field(default=None)
+    duties: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
+    total_duties_set: Union[dict[str, Any] | None, Any] = Field(default=None)
+    return_: Union[dict[str, Any] | None, Any] = Field(default=None, alias="return")
+    refund_line_items: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
+    transactions: Union[list[Transaction] | None, Any] = Field(default=None)
+    order_adjustments: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
+    admin_graphql_api_id: Union[str | None, Any] = Field(default=None)
+    refund_shipping_lines: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
+
 class LineItem(BaseModel):
     """LineItem type definition"""
     model_config = ConfigDict(extra="allow", populate_by_name=True)
@@ -176,55 +225,6 @@ class Fulfillment(BaseModel):
     name: Union[str | None, Any] = Field(default=None)
     admin_graphql_api_id: Union[str | None, Any] = Field(default=None)
 
-class Transaction(BaseModel):
-    """An order transaction"""
-    model_config = ConfigDict(extra="allow", populate_by_name=True)
-
-    id: Union[int, Any] = Field(default=None)
-    order_id: Union[int | None, Any] = Field(default=None)
-    kind: Union[str | None, Any] = Field(default=None)
-    gateway: Union[str | None, Any] = Field(default=None)
-    status: Union[str | None, Any] = Field(default=None)
-    message: Union[str | None, Any] = Field(default=None)
-    created_at: Union[str | None, Any] = Field(default=None)
-    test: Union[bool | None, Any] = Field(default=None)
-    authorization: Union[str | None, Any] = Field(default=None)
-    location_id: Union[int | None, Any] = Field(default=None)
-    user_id: Union[int | None, Any] = Field(default=None)
-    parent_id: Union[int | None, Any] = Field(default=None)
-    processed_at: Union[str | None, Any] = Field(default=None)
-    device_id: Union[int | None, Any] = Field(default=None)
-    error_code: Union[str | None, Any] = Field(default=None)
-    source_name: Union[str | None, Any] = Field(default=None)
-    receipt: Union[dict[str, Any] | None, Any] = Field(default=None)
-    currency_exchange_adjustment: Union[dict[str, Any] | None, Any] = Field(default=None)
-    amount: Union[str | None, Any] = Field(default=None)
-    currency: Union[str | None, Any] = Field(default=None)
-    payment_id: Union[str | None, Any] = Field(default=None)
-    total_unsettled_set: Union[dict[str, Any] | None, Any] = Field(default=None)
-    manual_payment_gateway: Union[bool | None, Any] = Field(default=None)
-    admin_graphql_api_id: Union[str | None, Any] = Field(default=None)
-
-class Refund(BaseModel):
-    """An order refund"""
-    model_config = ConfigDict(extra="allow", populate_by_name=True)
-
-    id: Union[int, Any] = Field(default=None)
-    order_id: Union[int | None, Any] = Field(default=None)
-    created_at: Union[str | None, Any] = Field(default=None)
-    note: Union[str | None, Any] = Field(default=None)
-    user_id: Union[int | None, Any] = Field(default=None)
-    processed_at: Union[str | None, Any] = Field(default=None)
-    restock: Union[bool | None, Any] = Field(default=None)
-    duties: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
-    total_duties_set: Union[dict[str, Any] | None, Any] = Field(default=None)
-    return_: Union[dict[str, Any] | None, Any] = Field(default=None, alias="return")
-    refund_line_items: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
-    transactions: Union[list[Transaction] | None, Any] = Field(default=None)
-    order_adjustments: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
-    admin_graphql_api_id: Union[str | None, Any] = Field(default=None)
-    refund_shipping_lines: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
-
 class Order(BaseModel):
     """A Shopify order"""
     model_config = ConfigDict(extra="allow", populate_by_name=True)
@@ -329,6 +329,22 @@ class OrderList(BaseModel):
 
     orders: Union[list[Order], Any] = Field(default=None)
 
+class ProductImage(BaseModel):
+    """A product image"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[int, Any] = Field(default=None)
+    product_id: Union[int | None, Any] = Field(default=None)
+    position: Union[int | None, Any] = Field(default=None)
+    created_at: Union[str | None, Any] = Field(default=None)
+    updated_at: Union[str | None, Any] = Field(default=None)
+    alt: Union[str | None, Any] = Field(default=None)
+    width: Union[int | None, Any] = Field(default=None)
+    height: Union[int | None, Any] = Field(default=None)
+    src: Union[str | None, Any] = Field(default=None)
+    variant_ids: Union[list[int] | None, Any] = Field(default=None)
+    admin_graphql_api_id: Union[str | None, Any] = Field(default=None)
+
 class ProductVariant(BaseModel):
     """A product variant"""
     model_config = ConfigDict(extra="allow", populate_by_name=True)
@@ -360,22 +376,6 @@ class ProductVariant(BaseModel):
     requires_shipping: Union[bool | None, Any] = Field(default=None)
     admin_graphql_api_id: Union[str | None, Any] = Field(default=None)
 
-class ProductImage(BaseModel):
-    """A product image"""
-    model_config = ConfigDict(extra="allow", populate_by_name=True)
-
-    id: Union[int, Any] = Field(default=None)
-    product_id: Union[int | None, Any] = Field(default=None)
-    position: Union[int | None, Any] = Field(default=None)
-    created_at: Union[str | None, Any] = Field(default=None)
-    updated_at: Union[str | None, Any] = Field(default=None)
-    alt: Union[str | None, Any] = Field(default=None)
-    width: Union[int | None, Any] = Field(default=None)
-    height: Union[int | None, Any] = Field(default=None)
-    src: Union[str | None, Any] = Field(default=None)
-    variant_ids: Union[list[int] | None, Any] = Field(default=None)
-    admin_graphql_api_id: Union[str | None, Any] = Field(default=None)
-
 class Product(BaseModel):
     """A Shopify product"""
     model_config = ConfigDict(extra="allow", populate_by_name=True)
@@ -1064,6 +1064,25 @@ class FulfillmentOrdersListResultMeta(BaseModel):
 
     next_page_url: Union[str | None, Any] = Field(default=None)
 
+# ===== CHECK RESULT MODEL =====
+
+class ShopifyCheckResult(BaseModel):
+    """Result of a health check operation.
+
+    Returned by the check() method to indicate connectivity and credential status.
+    """
+    model_config = ConfigDict(extra="forbid")
+
+    status: str
+    """Health check status: 'healthy' or 'unhealthy'."""
+    error: str | None = None
+    """Error message if status is 'unhealthy', None otherwise."""
+    checked_entity: str | None = None
+    """Entity name used for the health check."""
+    checked_action: str | None = None
+    """Action name used for the health check."""
+
+
 # ===== RESPONSE ENVELOPE MODELS =====
 
 # Type variables for generic envelope models

{airbyte_agent_shopify-0.1.16.dist-info → airbyte_agent_shopify-0.1.21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-shopify
-Version: 0.1.16
+Version: 0.1.21
 Summary: Airbyte Shopify Connector for AI platforms
 Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
 Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
@@ -119,10 +119,11 @@ async def shopify_execute(entity: str, action: str, params: dict | None = None):
     return await connector.execute(entity, action, params or {})
 ```
 
-
 ## Full documentation
 
-This connector supports the following entities and actions.
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
 
 | Entity | Actions |
 |--------|---------|
@@ -160,14 +161,17 @@ This connector supports the following entities and actions.
 | Fulfillment Orders | [List](./REFERENCE.md#fulfillment-orders-list), [Get](./REFERENCE.md#fulfillment-orders-get) |
 
 
-For all authentication options, see the connector's [authentication documentation](AUTH.md).
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
 
-For detailed documentation on available actions and parameters, see this connector's [full reference documentation](./REFERENCE.md).
+### Shopify API docs
 
-For the service's official API docs, see the [Shopify API reference](https://shopify.dev/docs/api/admin-rest).
+See the official [Shopify API reference](https://shopify.dev/docs/api/admin-rest).
 
 ## Version information
 
-- **Package version:** 0.1.16
+- **Package version:** 0.1.21
 - **Connector version:** 0.1.2
-- **Generated with Connector SDK commit SHA:** 71f48c102ce98c9298e5102761e740f0d97eb71b
+- **Generated with Connector SDK commit SHA:** e4eb233f8dd57ad9bc825064625222a988db2cc6
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/shopify/CHANGELOG.md)

{airbyte_agent_shopify-0.1.16.dist-info → airbyte_agent_shopify-0.1.21.dist-info}/RECORD

@@ -1,28 +1,28 @@
-airbyte_agent_shopify/__init__.py,sha256=uFn4x1bUldfWTPBITTIGYrjD5bRufgEVvKVviDOUd_0,9661
-airbyte_agent_shopify/connector.py,sha256=uDA7DNbgXNQQ94sp2Kinq2Rgu2FgBZEWzbgKTLEteZM,93793
-airbyte_agent_shopify/connector_model.py,sha256=AVa7n--wns14y5tdsiKymVUMS7HboqVD8sdzvKPlBRM,691010
-airbyte_agent_shopify/models.py,sha256=hBMmLBLBlmqU8TdcJGpm3fQyyDVP3BEpDJ5C2cInBso,60917
+airbyte_agent_shopify/__init__.py,sha256=PwhhDf0vQAlVsyozc8tVdQOSmOfCUvojDtyCCX7kMVo,9711
+airbyte_agent_shopify/connector.py,sha256=Cb-QAQkxfmusiOQrJ-T0H_AnT7EC5DnXrVvu190OVGA,95344
+airbyte_agent_shopify/connector_model.py,sha256=sOJVGigcB608cmTP4pqI1v9kgnRRUS8pbQSrs8NCyhg,691056
+airbyte_agent_shopify/models.py,sha256=OB0rD380IQXbvGPtqbsX0IA3qm47fN6mAIR1nfqwmyk,61514
 airbyte_agent_shopify/types.py,sha256=AwQ4PR2wZmHNuryriCFdRxf9q48J1mnPwspUB1b-L_o,10221
 airbyte_agent_shopify/_vendored/__init__.py,sha256=ILl7AHXMui__swyrjxrh9yRa4dLiwBvV6axPWFWty80,38
 airbyte_agent_shopify/_vendored/connector_sdk/__init__.py,sha256=T5o7roU6NSpH-lCAGZ338sE5dlh4ZU6i6IkeG1zpems,1949
 airbyte_agent_shopify/_vendored/connector_sdk/auth_strategies.py,sha256=5Sb9moUp623o67Q2wMa8iZldJH08y4gQdoutoO_75Iw,42088
 airbyte_agent_shopify/_vendored/connector_sdk/auth_template.py,sha256=nju4jqlFC_KI82ILNumNIyiUtRJcy7J94INIZ0QraI4,4454
-airbyte_agent_shopify/_vendored/connector_sdk/connector_model_loader.py,sha256=AW9bsdggzuc3ydy2bYYF33L6LxLKLQer9Wm47IOuQw0,41492
+airbyte_agent_shopify/_vendored/connector_sdk/connector_model_loader.py,sha256=ecm0Cdj1SyhDOpEi2wUzzrJNkgt0wViB0Q-YTrDPsjU,41698
 airbyte_agent_shopify/_vendored/connector_sdk/constants.py,sha256=AtzOvhDMWbRJgpsQNWl5tkogHD6mWgEY668PgRmgtOY,2737
 airbyte_agent_shopify/_vendored/connector_sdk/exceptions.py,sha256=ss5MGv9eVPmsbLcLWetuu3sDmvturwfo6Pw3M37Oq5k,481
 airbyte_agent_shopify/_vendored/connector_sdk/extensions.py,sha256=XWRRoJOOrwUHSKbuQt5DU7CCu8ePzhd_HuP7c_uD77w,21376
 airbyte_agent_shopify/_vendored/connector_sdk/http_client.py,sha256=09Fclbq4wrg38EM2Yh2kHiykQVXqdAGby024elcEz8E,28027
-airbyte_agent_shopify/_vendored/connector_sdk/introspection.py,sha256=kRVI4TDQDLdcCnTBUML8ycAtdqAQufVh-027sMkb4i8,19165
+airbyte_agent_shopify/_vendored/connector_sdk/introspection.py,sha256=e9uWn2ofpeehoBbzNgts_bjlKLn8ayA1Y3OpDC3b7ZA,19517
 airbyte_agent_shopify/_vendored/connector_sdk/secrets.py,sha256=J9ezMu4xNnLW11xY5RCre6DHP7YMKZCqwGJfk7ufHAM,6855
-airbyte_agent_shopify/_vendored/connector_sdk/types.py,sha256=in8gHsn5nsScujOfHZmkOgNmqmJKiPyNNjg59m5fGWc,8807
+airbyte_agent_shopify/_vendored/connector_sdk/types.py,sha256=sRZ4rRkJXGfqdjfF3qb0kzrw_tu1cn-CmFSZKMMgF7o,9269
 airbyte_agent_shopify/_vendored/connector_sdk/utils.py,sha256=G4LUXOC2HzPoND2v4tQW68R9uuPX9NQyCjaGxb7Kpl0,1958
-airbyte_agent_shopify/_vendored/connector_sdk/validation.py,sha256=4MPrxYmQh8TbCU0KdvvRKe35Lg1YYLEBd0u4aKySl_E,32122
+airbyte_agent_shopify/_vendored/connector_sdk/validation.py,sha256=2Qof3QiOEEupTsT6F1MvMDCZTPl4IuzkeUUvn_IYFjg,32905
 airbyte_agent_shopify/_vendored/connector_sdk/cloud_utils/__init__.py,sha256=4799Hv9f2zxDVj1aLyQ8JpTEuFTp_oOZMRz-NZCdBJg,134
 airbyte_agent_shopify/_vendored/connector_sdk/cloud_utils/client.py,sha256=YxdRpQr9XjDzih6csSseBVGn9kfMtaqbOCXP0TPuzFY,7189
 airbyte_agent_shopify/_vendored/connector_sdk/executor/__init__.py,sha256=EmG9YQNAjSuYCVB4D5VoLm4qpD1KfeiiOf7bpALj8p8,702
-airbyte_agent_shopify/_vendored/connector_sdk/executor/hosted_executor.py,sha256=ydHcG-biRS1ITT5ELwPShdJW-KYpvK--Fos1ipNgHho,6995
-airbyte_agent_shopify/_vendored/connector_sdk/executor/local_executor.py,sha256=tVbfstxOrm5qJt1NawTwjhIIpDgPCC4wSrKM5eALPSQ,74064
-airbyte_agent_shopify/_vendored/connector_sdk/executor/models.py,sha256=lYVT_bNcw-PoIks4WHNyl2VY-lJVf2FntzINSOBIheE,5845
+airbyte_agent_shopify/_vendored/connector_sdk/executor/hosted_executor.py,sha256=AC5aJtdcMPQfRuam0ZGE4QdhUBu2oGEmNZ6oVQLHTE8,7212
+airbyte_agent_shopify/_vendored/connector_sdk/executor/local_executor.py,sha256=abtQOMZhJBrvE3ioKi-g-R_GZJZozYJNczYySQEEIX8,76981
+airbyte_agent_shopify/_vendored/connector_sdk/executor/models.py,sha256=mUUBnuShKXxVIfsTOhMiI2rn2a-50jJG7SFGKT_P6Jk,6281
 airbyte_agent_shopify/_vendored/connector_sdk/http/__init__.py,sha256=y8fbzZn-3yV9OxtYz8Dy6FFGI5v6TOqADd1G3xHH3Hw,911
 airbyte_agent_shopify/_vendored/connector_sdk/http/config.py,sha256=6J7YIIwHC6sRu9i-yKa5XvArwK2KU60rlnmxzDZq3lw,3283
 airbyte_agent_shopify/_vendored/connector_sdk/http/exceptions.py,sha256=eYdYmxqcwA6pgrSoRXNfR6_nRBGRH6upp2-r1jcKaZo,3586
@@ -46,12 +46,12 @@ airbyte_agent_shopify/_vendored/connector_sdk/schema/base.py,sha256=IoAucZQ0j0xT
 airbyte_agent_shopify/_vendored/connector_sdk/schema/components.py,sha256=nJIPieavwX3o3ODvdtLHPk84d_V229xmg6LDfwEHjzc,8119
 airbyte_agent_shopify/_vendored/connector_sdk/schema/connector.py,sha256=mSZk1wr2YSdRj9tTRsPAuIlCzd_xZLw-Bzl1sMwE0rE,3731
 airbyte_agent_shopify/_vendored/connector_sdk/schema/extensions.py,sha256=5hgpFHK7fzpzegCkJk882DeIP79bCx_qairKJhvPMZ8,9590
-airbyte_agent_shopify/_vendored/connector_sdk/schema/operations.py,sha256=RpzGtAI4yvAtMHAfMUMcUwgHv_qJojnKlNb75_agUF8,5729
+airbyte_agent_shopify/_vendored/connector_sdk/schema/operations.py,sha256=St-A75m6sZUZlsoM6WcoPaShYu_X1K19pdyPvJbabOE,6214
 airbyte_agent_shopify/_vendored/connector_sdk/schema/security.py,sha256=1CVCavrPdHHyk7B6JtUD75yRS_hWLCemZF1zwGbdqxg,9036
 airbyte_agent_shopify/_vendored/connector_sdk/telemetry/__init__.py,sha256=RaLgkBU4dfxn1LC5Y0Q9rr2PJbrwjxvPgBLmq8_WafE,211
 airbyte_agent_shopify/_vendored/connector_sdk/telemetry/config.py,sha256=tLmQwAFD0kP1WyBGWBS3ysaudN9H3e-3EopKZi6cGKg,885
 airbyte_agent_shopify/_vendored/connector_sdk/telemetry/events.py,sha256=8Y1NbXiwISX-V_wRofY7PqcwEXD0dLMnntKkY6XFU2s,1328
-airbyte_agent_shopify/_vendored/connector_sdk/telemetry/tracker.py,sha256=Ftrk0_ddfM7dZG8hF9xBuPwhbc9D6JZ7Q9qs5o3LEyA,5579
-airbyte_agent_shopify-0.1.16.dist-info/METADATA,sha256=vzGjdAedaMX_-w0h9_jQ-v5AUi21PZgAwyFf1OIAvYI,7842
-airbyte_agent_shopify-0.1.16.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-airbyte_agent_shopify-0.1.16.dist-info/RECORD,,
+airbyte_agent_shopify/_vendored/connector_sdk/telemetry/tracker.py,sha256=SginFQbHqVUVYG82NnNzG34O-tAQ_wZYjGDcuo0q4Kk,5584
+airbyte_agent_shopify-0.1.21.dist-info/METADATA,sha256=fTADX3J6fivQ9s2kLhgiuraAgiMkafFJA9E6sKVUabY,7999
+airbyte_agent_shopify-0.1.21.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+airbyte_agent_shopify-0.1.21.dist-info/RECORD,,