airbyte-agent-asana 0.19.27__py3-none-any.whl → 0.19.41__py3-none-any.whl

airbyte_agent_asana/__init__.py

@@ -14,15 +14,15 @@ from .models import (
     TasksListNextPage,
     TasksList,
     ProjectCompact,
-    ProjectCurrentStatusCreatedBy,
-    ProjectCurrentStatusAuthor,
-    ProjectCurrentStatus,
     ProjectMembersItem,
     ProjectWorkspace,
-    ProjectCurrentStatusUpdate,
-    ProjectOwner,
     ProjectTeam,
     ProjectFollowersItem,
+    ProjectCurrentStatusCreatedBy,
+    ProjectCurrentStatusAuthor,
+    ProjectCurrentStatus,
+    ProjectOwner,
+    ProjectCurrentStatusUpdate,
     Project,
     ProjectResponse,
     ProjectsListNextPage,
@@ -142,4 +142,4 @@ from .types import (
     TaskDependentsListParams
 )
 
-__all__ = ["AsanaConnector", "AsanaAuthConfig", "TaskCompactCreatedBy", "TaskCompact", "Task", "TaskResponse", "TasksListNextPage", "TasksList", "ProjectCompact", "ProjectCurrentStatusCreatedBy", "ProjectCurrentStatusAuthor", "ProjectCurrentStatus", "ProjectMembersItem", "ProjectWorkspace", "ProjectCurrentStatusUpdate", "ProjectOwner", "ProjectTeam", "ProjectFollowersItem", "Project", "ProjectResponse", "ProjectsListNextPage", "ProjectsList", "WorkspaceCompact", "Workspace", "WorkspaceResponse", "WorkspacesListNextPage", "WorkspacesList", "UserCompact", "UserWorkspacesItem", "User", "UserResponse", "UsersListNextPage", "UsersList", "TeamCompact", "TeamOrganization", "Team", "TeamResponse", "TeamsListNextPage", "TeamsList", "AttachmentCompact", "AttachmentParent", "Attachment", "AttachmentResponse", "AttachmentsListNextPage", "AttachmentsList", "TagCompact", "TagWorkspace", "Tag", "TagResponse", "TagsListNextPage", "TagsList", "SectionCompact", "SectionProject", "Section", "SectionResponse", "SectionsListNextPage", "SectionsList", "TasksListResultMeta", "ProjectTasksListResultMeta", "WorkspaceTaskSearchListResultMeta", "ProjectsListResultMeta", "TaskProjectsListResultMeta", "TeamProjectsListResultMeta", "WorkspaceProjectsListResultMeta", "WorkspacesListResultMeta", "UsersListResultMeta", "WorkspaceUsersListResultMeta", "TeamUsersListResultMeta", "WorkspaceTeamsListResultMeta", "UserTeamsListResultMeta", "AttachmentsListResultMeta", "WorkspaceTagsListResultMeta", "ProjectSectionsListResultMeta", "TaskSubtasksListResultMeta", "TaskDependenciesListResultMeta", "TaskDependentsListResultMeta", "AsanaExecuteResult", "AsanaExecuteResultWithMeta", "TasksListResult", "ProjectTasksListResult", "TasksGetResult", "WorkspaceTaskSearchListResult", "ProjectsListResult", "ProjectsGetResult", "TaskProjectsListResult", "TeamProjectsListResult", "WorkspaceProjectsListResult", "WorkspacesListResult", "WorkspacesGetResult", "UsersListResult", "UsersGetResult", "WorkspaceUsersListResult", "TeamUsersListResult", "TeamsGetResult", "WorkspaceTeamsListResult", "UserTeamsListResult", "AttachmentsListResult", "AttachmentsGetResult", "WorkspaceTagsListResult", "TagsGetResult", "ProjectSectionsListResult", "SectionsGetResult", "TaskSubtasksListResult", "TaskDependenciesListResult", "TaskDependentsListResult", "TasksListParams", "ProjectTasksListParams", "TasksGetParams", "WorkspaceTaskSearchListParams", "ProjectsListParams", "ProjectsGetParams", "TaskProjectsListParams", "TeamProjectsListParams", "WorkspaceProjectsListParams", "WorkspacesListParams", "WorkspacesGetParams", "UsersListParams", "UsersGetParams", "WorkspaceUsersListParams", "TeamUsersListParams", "TeamsGetParams", "WorkspaceTeamsListParams", "UserTeamsListParams", "AttachmentsListParams", "AttachmentsGetParams", "AttachmentsDownloadParams", "WorkspaceTagsListParams", "TagsGetParams", "ProjectSectionsListParams", "SectionsGetParams", "TaskSubtasksListParams", "TaskDependenciesListParams", "TaskDependentsListParams"]
+__all__ = ["AsanaConnector", "AsanaAuthConfig", "TaskCompactCreatedBy", "TaskCompact", "Task", "TaskResponse", "TasksListNextPage", "TasksList", "ProjectCompact", "ProjectMembersItem", "ProjectWorkspace", "ProjectTeam", "ProjectFollowersItem", "ProjectCurrentStatusCreatedBy", "ProjectCurrentStatusAuthor", "ProjectCurrentStatus", "ProjectOwner", "ProjectCurrentStatusUpdate", "Project", "ProjectResponse", "ProjectsListNextPage", "ProjectsList", "WorkspaceCompact", "Workspace", "WorkspaceResponse", "WorkspacesListNextPage", "WorkspacesList", "UserCompact", "UserWorkspacesItem", "User", "UserResponse", "UsersListNextPage", "UsersList", "TeamCompact", "TeamOrganization", "Team", "TeamResponse", "TeamsListNextPage", "TeamsList", "AttachmentCompact", "AttachmentParent", "Attachment", "AttachmentResponse", "AttachmentsListNextPage", "AttachmentsList", "TagCompact", "TagWorkspace", "Tag", "TagResponse", "TagsListNextPage", "TagsList", "SectionCompact", "SectionProject", "Section", "SectionResponse", "SectionsListNextPage", "SectionsList", "TasksListResultMeta", "ProjectTasksListResultMeta", "WorkspaceTaskSearchListResultMeta", "ProjectsListResultMeta", "TaskProjectsListResultMeta", "TeamProjectsListResultMeta", "WorkspaceProjectsListResultMeta", "WorkspacesListResultMeta", "UsersListResultMeta", "WorkspaceUsersListResultMeta", "TeamUsersListResultMeta", "WorkspaceTeamsListResultMeta", "UserTeamsListResultMeta", "AttachmentsListResultMeta", "WorkspaceTagsListResultMeta", "ProjectSectionsListResultMeta", "TaskSubtasksListResultMeta", "TaskDependenciesListResultMeta", "TaskDependentsListResultMeta", "AsanaExecuteResult", "AsanaExecuteResultWithMeta", "TasksListResult", "ProjectTasksListResult", "TasksGetResult", "WorkspaceTaskSearchListResult", "ProjectsListResult", "ProjectsGetResult", "TaskProjectsListResult", "TeamProjectsListResult", "WorkspaceProjectsListResult", "WorkspacesListResult", "WorkspacesGetResult", "UsersListResult", "UsersGetResult", "WorkspaceUsersListResult", "TeamUsersListResult", "TeamsGetResult", "WorkspaceTeamsListResult", "UserTeamsListResult", "AttachmentsListResult", "AttachmentsGetResult", "WorkspaceTagsListResult", "TagsGetResult", "ProjectSectionsListResult", "SectionsGetResult", "TaskSubtasksListResult", "TaskDependenciesListResult", "TaskDependentsListResult", "TasksListParams", "ProjectTasksListParams", "TasksGetParams", "WorkspaceTaskSearchListParams", "ProjectsListParams", "ProjectsGetParams", "TaskProjectsListParams", "TeamProjectsListParams", "WorkspaceProjectsListParams", "WorkspacesListParams", "WorkspacesGetParams", "UsersListParams", "UsersGetParams", "WorkspaceUsersListParams", "TeamUsersListParams", "TeamsGetParams", "WorkspaceTeamsListParams", "UserTeamsListParams", "AttachmentsListParams", "AttachmentsGetParams", "AttachmentsDownloadParams", "WorkspaceTagsListParams", "TagsGetParams", "ProjectSectionsListParams", "SectionsGetParams", "TaskSubtasksListParams", "TaskDependenciesListParams", "TaskDependentsListParams"]

airbyte_agent_asana/_vendored/connector_sdk/auth_strategies.py

@@ -610,9 +610,7 @@ class OAuth2AuthStrategy(AuthStrategy):
         has_refresh_token = bool(secrets.get("refresh_token"))
 
         if not has_access_token and not has_refresh_token:
-            raise AuthenticationError(
-                "Missing OAuth2 credentials. Provide either 'access_token' " "or 'refresh_token' (for refresh-token-only mode)."
-            )
+            raise AuthenticationError("Missing OAuth2 credentials. Provide either 'access_token' or 'refresh_token' (for refresh-token-only mode).")
 
     def can_refresh(self, secrets: OAuth2RefreshSecrets) -> bool:
         """Check if token refresh is possible.
@@ -1106,8 +1104,7 @@ class AuthStrategyFactory:
         strategy = cls._strategies.get(auth_type)
         if strategy is None:
             raise AuthenticationError(
-                f"Authentication type '{auth_type.value}' is not implemented. "
-                f"Supported types: {', '.join(s.value for s in cls._strategies.keys())}"
+                f"Authentication type '{auth_type.value}' is not implemented. Supported types: {', '.join(s.value for s in cls._strategies.keys())}"
             )
         return strategy
 

airbyte_agent_asana/_vendored/connector_sdk/auth_template.py

@@ -17,7 +17,7 @@ class MissingVariableError(ValueError):
     def __init__(self, var_name: str, available_fields: list):
         self.var_name = var_name
         self.available_fields = available_fields
-        super().__init__(f"Template variable '${{{var_name}}}' not found in config. " f"Available fields: {available_fields}")
+        super().__init__(f"Template variable '${{{var_name}}}' not found in config. Available fields: {available_fields}")
 
 
 def apply_template(template: str, values: Dict[str, str]) -> str:

airbyte_agent_asana/_vendored/connector_sdk/cloud_utils/client.py

@@ -13,7 +13,7 @@ class AirbyteCloudClient:
 
     Handles authentication, token caching, and API calls to:
     - Get bearer tokens for authentication
-    - Look up connector instances for users
+    - Look up connectors for users
     - Execute connectors via the cloud API
 
     Example:
@@ -22,15 +22,15 @@ class AirbyteCloudClient:
             client_secret="your-client-secret"
         )
 
-        # Get a connector instance
-        instance_id = await client.get_connector_instance_id(
+        # Get a connector ID
+        connector_id = await client.get_connector_id(
             external_user_id="user-123",
-            connector_definition_id="stripe-def-456"
+            connector_definition_id="550e8400-e29b-41d4-a716-446655440000"
         )
 
         # Execute the connector
         result = await client.execute_connector(
-            instance_id=instance_id,
+            connector_id=connector_id,
             entity="customers",
             action="list",
             params={"limit": 10}
@@ -105,37 +105,37 @@ class AirbyteCloudClient:
 
         return access_token
 
-    async def get_connector_instance_id(
+    async def get_connector_id(
         self,
         external_user_id: str,
         connector_definition_id: str,
     ) -> str:
-        """Get connector instance ID for a user.
+        """Get connector ID for a user.
 
-        Looks up the connector instance that belongs to the specified user
-        and connector definition. Validates that exactly one instance exists.
+        Looks up the connector that belongs to the specified user
+        and connector definition. Validates that exactly one connector exists.
 
         Args:
             external_user_id: User identifier in the Airbyte system
             connector_definition_id: UUID of the connector definition
 
         Returns:
-            Connector instance ID (UUID string)
+            Connector ID (UUID string)
 
         Raises:
-            ValueError: If 0 or more than 1 instance is found
+            ValueError: If 0 or more than 1 connector is found
             httpx.HTTPStatusError: If API returns 4xx/5xx status code
             httpx.RequestError: If network request fails
 
         Example:
-            instance_id = await client.get_connector_instance_id(
+            connector_id = await client.get_connector_id(
                 external_user_id="user-123",
                 connector_definition_id="550e8400-e29b-41d4-a716-446655440000"
             )
         """
 
         token = await self.get_bearer_token()
-        url = f"{self.API_BASE_URL}/api/v1/connectors/instances_for_user"
+        url = f"{self.API_BASE_URL}/api/v1/connectors/connectors_for_user"
         params = {
             "external_user_id": external_user_id,
             "definition_id": connector_definition_id,
@@ -146,24 +146,24 @@ class AirbyteCloudClient:
         response.raise_for_status()
 
         data = response.json()
-        instances = data["instances"]
+        connectors = data["connectors"]
 
-        if len(instances) == 0:
-            raise ValueError(f"No connector instance found for user '{external_user_id}' " f"and connector '{connector_definition_id}'")
+        if len(connectors) == 0:
+            raise ValueError(f"No connector found for user '{external_user_id}' and connector definition '{connector_definition_id}'")
 
-        if len(instances) > 1:
+        if len(connectors) > 1:
             raise ValueError(
-                f"Multiple connector instances found for user '{external_user_id}' "
-                f"and connector '{connector_definition_id}'. Expected exactly 1, "
-                f"found {len(instances)}"
+                f"Multiple connectors found for user '{external_user_id}' "
+                f"and connector definition '{connector_definition_id}'. Expected exactly 1, "
+                f"found {len(connectors)}"
             )
 
-        instance_id = instances[0]["id"]
-        return instance_id
+        connector_id = connectors[0]["id"]
+        return connector_id
 
     async def execute_connector(
         self,
-        instance_id: str,
+        connector_id: str,
         entity: str,
         action: str,
         params: dict[str, Any] | None,
@@ -171,7 +171,7 @@ class AirbyteCloudClient:
         """Execute a connector operation.
 
         Args:
-            instance_id: Connector instance UUID
+            connector_id: Connector UUID (source ID)
             entity: Entity name (e.g., "customers", "invoices")
             action: Operation action (e.g., "list", "get", "create")
             params: Optional parameters for the operation
@@ -185,14 +185,14 @@ class AirbyteCloudClient:
 
         Example:
             result = await client.execute_connector(
-                instance_id="inst-123",
+                connector_id="550e8400-e29b-41d4-a716-446655440000",
                 entity="customers",
                 action="list",
                 params={"limit": 10}
             )
         """
         token = await self.get_bearer_token()
-        url = f"{self.API_BASE_URL}/api/v1/connectors/instances/{instance_id}/execute"
+        url = f"{self.API_BASE_URL}/api/v1/connectors/sources/{connector_id}/execute"
         headers = {"Authorization": f"Bearer {token}"}
         request_body = {
             "entity": entity,

airbyte_agent_asana/_vendored/connector_sdk/connector_model_loader.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import logging
 import re
 from pathlib import Path
 from typing import Any
@@ -393,16 +394,24 @@ def convert_openapi_to_connector_model(spec: OpenAPIConnector) -> ConnectorModel
     for entity_name, endpoints_dict in entities_map.items():
         actions = list(endpoints_dict.keys())
 
-        # Get schema from components if available
+        # Get schema and stream_name from components if available
         schema = None
+        entity_stream_name = None
         if spec.components:
             # Look for a schema matching the entity name
             for schema_name, schema_def in spec.components.schemas.items():
                 if schema_def.x_airbyte_entity_name == entity_name or schema_name.lower() == entity_name.lower():
                     schema = schema_def.model_dump(by_alias=True)
+                    entity_stream_name = schema_def.x_airbyte_stream_name
                     break
 
-        entity = EntityDefinition(name=entity_name, actions=actions, endpoints=endpoints_dict, schema=schema)
+        entity = EntityDefinition(
+            name=entity_name,
+            stream_name=entity_stream_name,
+            actions=actions,
+            endpoints=endpoints_dict,
+            schema=schema,
+        )
         entities.append(entity)
 
     # Extract retry config from x-airbyte-retry-config extension
@@ -760,8 +769,6 @@ def _parse_auth_from_openapi(spec: OpenAPIConnector) -> AuthConfig:
             options.append(auth_option)
         except Exception as e:
             # Log warning but continue - skip invalid schemes
-            import logging
-
             logger = logging.getLogger(__name__)
             logger.warning(f"Skipping invalid security scheme '{scheme_name}': {e}")
             continue

airbyte_agent_asana/_vendored/connector_sdk/constants.py

@@ -74,5 +74,5 @@ except PackageNotFoundError:
     SDK_VERSION = "0.0.0-dev"
 """Current version of the Airbyte SDK."""
 
-MINIMUM_PYTHON_VERSION = "3.9"
+MINIMUM_PYTHON_VERSION = "3.13"
 """Minimum Python version required to run the SDK."""

airbyte_agent_asana/_vendored/connector_sdk/executor/hosted_executor.py

@@ -21,7 +21,7 @@ class HostedExecutor:
 
     The executor takes an external_user_id and uses the AirbyteCloudClient to:
     1. Authenticate with the Airbyte Platform (bearer token with caching)
-    2. Look up the user's connector instance
+    2. Look up the user's connector
     3. Execute the connector operation via the cloud API
 
     Implements ExecutorProtocol.
@@ -63,7 +63,7 @@ class HostedExecutor:
             airbyte_client_id: Airbyte client ID for authentication
             airbyte_client_secret: Airbyte client secret for authentication
             connector_definition_id: Connector definition ID used to look up
-                the user's connector instance.
+                the user's connector.
 
         Example:
             executor = HostedExecutor(
@@ -86,8 +86,8 @@ class HostedExecutor:
         """Execute connector via cloud API (ExecutorProtocol implementation).
 
         Flow:
-        1. Get connector id from connector model
-        2. Look up the user's connector instance ID
+        1. Get connector definition id from executor config
+        2. Look up the user's connector ID
         3. Execute the connector operation via the cloud API
         4. Parse the response into ExecutionResult
 
@@ -98,7 +98,7 @@ class HostedExecutor:
             ExecutionResult with success/failure status
 
         Raises:
-            ValueError: If no instance or multiple instances found for user
+            ValueError: If no connector or multiple connectors found for user
             httpx.HTTPStatusError: If API returns 4xx/5xx status code
             httpx.RequestError: If network request fails
 
@@ -126,24 +126,23 @@ class HostedExecutor:
                 # Step 1: Get connector definition id
                 connector_definition_id = self._connector_definition_id
 
-                # Step 2: Get the connector instance ID for this user
-                instance_id = await self._cloud_client.get_connector_instance_id(
+                # Step 2: Get the connector ID for this user
+                connector_id = await self._cloud_client.get_connector_id(
                     external_user_id=self._external_user_id,
                     connector_definition_id=connector_definition_id,
                 )
 
-                span.set_attribute("connector.instance_id", instance_id)
+                span.set_attribute("connector.connector_id", connector_id)
 
                 # Step 3: Execute the connector via the cloud API
                 response = await self._cloud_client.execute_connector(
-                    instance_id=instance_id,
+                    connector_id=connector_id,
                     entity=config.entity,
                     action=config.action,
                     params=config.params,
                 )
 
                 # Step 4: Parse the response into ExecutionResult
-                # The response_data is a dict from the API
                 result = self._parse_execution_result(response)
 
                 # Mark span as successful
@@ -152,7 +151,7 @@ class HostedExecutor:
                 return result
 
             except ValueError as e:
-                # Instance lookup validation error (0 or >1 instances)
+                # Connector lookup validation error (0 or >1 connectors)
                 span.set_attribute("connector.success", False)
                 span.set_attribute("connector.error_type", "ValueError")
                 span.record_exception(e)

airbyte_agent_asana/_vendored/connector_sdk/executor/local_executor.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import asyncio
+import inspect
 import logging
 import os
 import re
@@ -11,6 +12,7 @@ from collections.abc import AsyncIterator
 from typing import Any, Protocol
 from urllib.parse import quote
 
+from jinja2 import Environment, StrictUndefined
 from jsonpath_ng import parse as parse_jsonpath
 from opentelemetry import trace
 
@@ -506,8 +508,6 @@ class LocalExecutor:
             result = handler.execute_operation(config.entity, action, params)
 
             # Check if it's an async generator (download) or awaitable (standard)
-            import inspect
-
             if inspect.isasyncgen(result):
                 # Download operation: return generator directly
                 return ExecutionResult(
@@ -674,16 +674,16 @@ class LocalExecutor:
         return {key: value for key, value in params.items() if key in allowed_params}
 
     def _extract_body(self, allowed_fields: list[str], params: dict[str, Any]) -> dict[str, Any]:
-        """Extract body fields from params.
+        """Extract body fields from params, filtering out None values.
 
         Args:
             allowed_fields: List of allowed body field names
             params: All parameters
 
         Returns:
-            Dictionary of body fields
+            Dictionary of body fields with None values filtered out
         """
-        return {key: value for key, value in params.items() if key in allowed_fields}
+        return {key: value for key, value in params.items() if key in allowed_fields and value is not None}
 
     def _serialize_deep_object_params(self, params: dict[str, Any], deep_object_param_names: list[str]) -> dict[str, Any]:
         """Serialize deepObject parameters to bracket notation format.
@@ -814,7 +814,6 @@ class LocalExecutor:
             >>> _substitute_file_field_params("attachments[{attachment_index}].url", {"attachment_index": 0})
             "attachments[0].url"
         """
-        from jinja2 import Environment, StrictUndefined
 
         # Use custom delimiters to match OpenAPI path parameter syntax {var}
         # StrictUndefined raises clear error if a template variable is missing
@@ -837,15 +836,65 @@ class LocalExecutor:
             Request body dict or None if no body needed
         """
         if endpoint.graphql_body:
-            return self._build_graphql_body(endpoint.graphql_body, params)
+            # Extract defaults from query_params_schema for GraphQL variable interpolation
+            param_defaults = {name: schema.get("default") for name, schema in endpoint.query_params_schema.items() if "default" in schema}
+            return self._build_graphql_body(endpoint.graphql_body, params, param_defaults)
         elif endpoint.body_fields:
             return self._extract_body(endpoint.body_fields, params)
         return None
 
+    def _flatten_form_data(self, data: dict[str, Any], parent_key: str = "") -> dict[str, Any]:
+        """Flatten nested dict/list structures into bracket notation for form encoding.
+
+        Stripe and similar APIs require nested arrays/objects to be encoded using bracket
+        notation when using application/x-www-form-urlencoded content type.
+
+        Args:
+            data: Nested dict with arrays/objects to flatten
+            parent_key: Parent key for nested structures (used in recursion)
+
+        Returns:
+            Flattened dict with bracket notation keys
+
+        Examples:
+            >>> _flatten_form_data({"items": [{"price": "p1", "qty": 1}]})
+            {"items[0][price]": "p1", "items[0][qty]": 1}
+
+            >>> _flatten_form_data({"customer": "cus_123", "metadata": {"key": "value"}})
+            {"customer": "cus_123", "metadata[key]": "value"}
+        """
+        flattened = {}
+
+        for key, value in data.items():
+            new_key = f"{parent_key}[{key}]" if parent_key else key
+
+            if isinstance(value, dict):
+                # Recursively flatten nested dicts
+                flattened.update(self._flatten_form_data(value, new_key))
+            elif isinstance(value, list):
+                # Flatten arrays with indexed bracket notation
+                for i, item in enumerate(value):
+                    indexed_key = f"{new_key}[{i}]"
+                    if isinstance(item, dict):
+                        # Nested dict in array - recurse
+                        flattened.update(self._flatten_form_data(item, indexed_key))
+                    elif isinstance(item, list):
+                        # Nested list in array - recurse
+                        flattened.update(self._flatten_form_data({str(i): item}, new_key))
+                    else:
+                        # Primitive value in array
+                        flattened[indexed_key] = item
+            else:
+                # Primitive value - add directly
+                flattened[new_key] = value
+
+        return flattened
+
     def _determine_request_format(self, endpoint: EndpointDefinition, body: dict[str, Any] | None) -> dict[str, Any]:
         """Determine json/data parameters for HTTP request.
 
         GraphQL always uses JSON, regardless of content_type setting.
+        For form-encoded requests, nested structures are flattened into bracket notation.
 
         Args:
             endpoint: Endpoint definition
@@ -862,7 +911,9 @@ class LocalExecutor:
         if is_graphql or endpoint.content_type.value == "application/json":
             return {"json": body}
         elif endpoint.content_type.value == "application/x-www-form-urlencoded":
-            return {"data": body}
+            # Flatten nested structures for form encoding
+            flattened_body = self._flatten_form_data(body)
+            return {"data": flattened_body}
 
         return {}
 
@@ -903,12 +954,18 @@ class LocalExecutor:
 
         return query
 
-    def _build_graphql_body(self, graphql_config: dict[str, Any], params: dict[str, Any]) -> dict[str, Any]:
+    def _build_graphql_body(
+        self,
+        graphql_config: dict[str, Any],
+        params: dict[str, Any],
+        param_defaults: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
         """Build GraphQL request body with variable substitution and field selection.
 
         Args:
             graphql_config: GraphQL configuration from x-airbyte-body-type extension
             params: Parameters from execute() call
+            param_defaults: Default values for params from query_params_schema
 
         Returns:
             GraphQL request body: {"query": "...", "variables": {...}}
@@ -922,7 +979,7 @@ class LocalExecutor:
 
         # Substitute variables from params
         if "variables" in graphql_config and graphql_config["variables"]:
-            body["variables"] = self._interpolate_variables(graphql_config["variables"], params)
+            body["variables"] = self._interpolate_variables(graphql_config["variables"], params, param_defaults)
 
         # Add operation name if specified
         if "operationName" in graphql_config:
@@ -981,7 +1038,12 @@ class LocalExecutor:
         fields_str = " ".join(graphql_fields)
         return query.replace("{{ fields }}", fields_str)
 
-    def _interpolate_variables(self, variables: dict[str, Any], params: dict[str, Any]) -> dict[str, Any]:
+    def _interpolate_variables(
+        self,
+        variables: dict[str, Any],
+        params: dict[str, Any],
+        param_defaults: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
         """Recursively interpolate variables using params.
 
         Preserves types (doesn't stringify everything).
@@ -990,15 +1052,18 @@ class LocalExecutor:
         - Direct replacement: "{{ owner }}" → params["owner"] (preserves type)
         - Nested objects: {"input": {"name": "{{ name }}"}}
         - Arrays: [{"id": "{{ id }}"}]
-        - Unsubstituted placeholders: "{{ states }}" → None (for optional params)
+        - Default values: "{{ per_page }}" → param_defaults["per_page"] if not in params
+        - Unsubstituted placeholders: "{{ states }}" → None (for optional params without defaults)
 
         Args:
             variables: Variables dict with template placeholders
             params: Parameters to substitute
+            param_defaults: Default values for params from query_params_schema
 
         Returns:
             Interpolated variables dict with types preserved
         """
+        defaults = param_defaults or {}
 
         def interpolate_value(value: Any) -> Any:
             if isinstance(value, str):
@@ -1012,8 +1077,15 @@ class LocalExecutor:
                         value = value.replace(placeholder, str(param_value))
 
                 # Check if any unsubstituted placeholders remain
-                # If so, return None (treats as "not provided" for optional params)
                 if re.search(r"\{\{\s*\w+\s*\}\}", value):
+                    # Extract placeholder name and check for default value
+                    match = re.search(r"\{\{\s*(\w+)\s*\}\}", value)
+                    if match:
+                        param_name = match.group(1)
+                        if param_name in defaults:
+                            # Use default value (preserves type)
+                            return defaults[param_name]
+                    # No default found - return None (for optional params)
                     return None
 
                 return value
@@ -1056,7 +1128,7 @@ class LocalExecutor:
         if not action:
             return response_data
 
-        is_array_action = action in (Action.LIST, Action.SEARCH)
+        is_array_action = action in (Action.LIST, Action.API_SEARCH)
 
         try:
             # Parse and apply JSONPath expression
@@ -1151,17 +1223,14 @@ class LocalExecutor:
         if action not in (Action.CREATE, Action.UPDATE):
             return
 
-        # Check if endpoint has body fields defined
-        if not endpoint.body_fields:
+        # Get the request schema to find truly required fields
+        request_schema = endpoint.request_schema
+        if not request_schema:
             return
 
-        # For now, we treat all body_fields as potentially required for CREATE/UPDATE
-        # In a more advanced implementation, we could parse the request schema
-        # to identify truly required fields
-        missing_fields = []
-        for field in endpoint.body_fields:
-            if field not in params:
-                missing_fields.append(field)
+        # Only validate fields explicitly marked as required in the schema
+        required_fields = request_schema.get("required", [])
+        missing_fields = [field for field in required_fields if field not in params]
 
         if missing_fields:
             raise MissingParameterError(
@@ -1189,7 +1258,7 @@ class LocalExecutor:
 
 
 class _StandardOperationHandler:
-    """Handler for standard REST operations (GET, LIST, CREATE, UPDATE, DELETE, SEARCH, AUTHORIZE)."""
+    """Handler for standard REST operations (GET, LIST, CREATE, UPDATE, DELETE, API_SEARCH, AUTHORIZE)."""
 
     def __init__(self, context: _OperationContext):
         self.ctx = context
@@ -1202,7 +1271,7 @@ class _StandardOperationHandler:
             Action.CREATE,
             Action.UPDATE,
             Action.DELETE,
-            Action.SEARCH,
+            Action.API_SEARCH,
             Action.AUTHORIZE,
         }