oci 2.151.0__py3-none-any.whl → 2.152.1__py3-none-any.whl

oci/addons/adk/auth/__init__.py

@@ -0,0 +1,5 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.

oci/addons/adk/auth/auth_provider.py

@@ -0,0 +1,28 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+from abc import ABC, abstractmethod
+from typing import Any, Dict
+
+
+class AuthProvider(ABC):
+    """Base class for authentication providers."""
+
+    @abstractmethod
+    def get_config(self) -> Dict[str, Any]:
+        """Get service-specific configuration.
+
+        Returns:
+            Dict[str, Any]: Configuration dictionary
+        """
+        pass
+
+    @abstractmethod
+    def get_auth_credentials(self) -> Any:
+        """Get authentication credentials.
+
+        Returns:
+            Any: Authentication credentials (e.g., API key, signer)
+        """
+        pass

oci/addons/adk/auth/factory.py

@@ -0,0 +1,78 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+from enum import Enum
+from typing import Optional
+
+import oci.config
+
+from oci.addons.adk.auth.auth_provider import AuthProvider
+from oci.addons.adk.auth.oci.instance_principal import OCIInstancePrincipalAuth
+from oci.addons.adk.auth.oci.resource_principal import OCIResourcePrincipalAuth
+from oci.addons.adk.auth.oci.session import OCISessionAuth
+from oci.addons.adk.auth.oci.user_principal import OCIUserPrincipalAuth
+
+
+class OCIAuthType(str, Enum):
+    """OCI authentication types as enumerator."""
+
+    API_KEY = "api_key"
+    SECURITY_TOKEN = "security_token"
+    INSTANCE_PRINCIPAL = "instance_principal"
+    RESOURCE_PRINCIPAL = "resource_principal"
+
+
+class AuthFactory:
+    """Factory for creating authentication providers."""
+
+    @staticmethod
+    def create_oci_auth(
+        auth_type: OCIAuthType,
+        config_path: Optional[str] = oci.config.DEFAULT_LOCATION,
+        profile: Optional[str] = oci.config.DEFAULT_PROFILE,
+        token: Optional[str] = None,
+        region: Optional[str] = None,
+    ) -> AuthProvider:
+        """Create OCI authentication provider.
+
+        Args:
+            auth_type (str): Type of OCI auth. One of: 'user_principal',
+            'instance_principal', 'security_token'
+
+            config_path (Optional[str]): Path to OCI config file. Required for
+            user_principal and session auth.
+
+            profile (Optional[str]): Profile name in config.
+            Only used with user_principal and session auth. Defaults to "DEFAULT".
+
+            token (Optional[str]): token string.
+            region (Optional[str]): OCI region.
+
+        Returns:
+            AuthProvider: OCI auth provider
+
+        Raises:
+            ValueError: If auth_type is invalid or required args are missing
+        """
+        # Validate auth_type first
+        if auth_type not in OCIAuthType:
+            raise ValueError(
+                f"Invalid auth_type: {auth_type}. Must be one of: "
+                f"{', '.join(repr(t) for t in OCIAuthType)}"
+            )
+
+        if auth_type == OCIAuthType.INSTANCE_PRINCIPAL:
+            return OCIInstancePrincipalAuth(security_token=token, region=region)
+
+        if auth_type == OCIAuthType.RESOURCE_PRINCIPAL:
+            return OCIResourcePrincipalAuth(security_token=token, region=region)
+
+        if auth_type == OCIAuthType.API_KEY:
+            return OCIUserPrincipalAuth(config_path=config_path, profile=profile)
+
+        if auth_type == OCIAuthType.SECURITY_TOKEN:
+            return OCISessionAuth(config_path=config_path, profile=profile)
+
+        # This code is unreachable since we validate auth_type at the start
+        raise ValueError(f"Unsupported auth_type: {auth_type}")  # pragma: no cover

oci/addons/adk/auth/oci/__init__.py

@@ -0,0 +1,5 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.

oci/addons/adk/auth/oci/instance_principal.py

@@ -0,0 +1,53 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+from typing import Any, Dict, Optional
+
+import oci
+
+from oci.addons.adk.auth.auth_provider import AuthProvider
+
+
+class OCIInstancePrincipalAuth(AuthProvider):
+    """OCI Authentication Provider using instance principal."""
+
+    def __init__(
+        self, security_token: Optional[str] = None, region: Optional[str] = None
+    ):
+        """Initialize OCI Instance Principal Auth Provider.
+
+        Args:
+            security_token (Optional[str]): Security token for authentication
+            region (Optional[str]): OCI region
+        """
+        self._signer: oci.signer.AbstractBaseSigner | None = None
+        self.region = region
+
+    def get_config(self) -> Dict[str, Any]:
+        """Get OCI configuration.
+
+        Returns:
+            Dict[str, Any]: OCI configuration dictionary with region and tenancy
+
+        Raises:
+            Exception: If instance principal auth is not configured
+        """
+        signer = self.get_auth_credentials()
+        config = {"region": signer.region, "tenancy": signer.tenancy_id}  # type: ignore[attr-defined]
+        if self.region:
+            config["region"] = self.region
+        return config
+
+    def get_auth_credentials(self) -> oci.signer.AbstractBaseSigner:
+        """Get OCI instance principal signer.
+
+        Returns:
+            oci.signer.AbstractBaseSigner: OCI instance principal signer
+
+        Raises:
+            Exception: If instance principal auth is not configured
+        """
+        if self._signer is None:
+            self._signer = oci.auth.signers.InstancePrincipalsSecurityTokenSigner()
+        return self._signer

oci/addons/adk/auth/oci/resource_principal.py

@@ -0,0 +1,53 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+from typing import Any, Dict, Optional
+
+import oci
+
+from oci.addons.adk.auth.auth_provider import AuthProvider
+
+
+class OCIResourcePrincipalAuth(AuthProvider):
+    """OCI Authentication Provider using resource principal."""
+
+    def __init__(
+        self, security_token: Optional[str] = None, region: Optional[str] = None
+    ):
+        """Initialize OCI Resource Principal Auth Provider.
+
+        Args:
+            security_token (Optional[str]): Security token for authentication
+            region (Optional[str]): OCI region
+        """
+        self._signer = None
+        self.region = region
+
+    def get_config(self) -> Dict[str, Any]:
+        """Get OCI configuration.
+
+        Returns:
+            Dict[str, Any]: OCI configuration dictionary with region and tenancy
+
+        Raises:
+            Exception: If resource principal auth is not configured
+        """
+        signer = self.get_auth_credentials()
+        config = {"region": signer.region, "tenancy": signer.tenancy_id}  # type: ignore[attr-defined]
+        if self.region:
+            config["region"] = self.region
+        return config
+
+    def get_auth_credentials(self) -> oci.signer.AbstractBaseSigner:
+        """Get OCI resource principal signer.
+
+        Returns:
+            oci.signer.AbstractBaseSigner: OCI resource principal signer
+
+        Raises:
+            Exception: If resource principal auth is not configured
+        """
+        if self._signer is None:
+            self._signer = oci.auth.signers.get_resource_principals_signer()
+        return self._signer  # type: ignore[return-value]

oci/addons/adk/auth/oci/session.py

@@ -0,0 +1,91 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+from typing import Any, Dict, Optional
+
+import oci
+
+from oci.addons.adk.auth.auth_provider import AuthProvider
+
+
+class OCISessionAuth(AuthProvider):
+    """OCI Authentication Provider using session authentication."""
+
+    def __init__(
+        self,
+        config_path: Optional[str] = oci.config.DEFAULT_LOCATION,
+        profile: Optional[str] = oci.config.DEFAULT_PROFILE,
+    ):
+        """Initialize OCI Session Auth Provider.
+
+        Args:
+            config_path (str): Path to OCI config file
+            profile (str): Profile name to use from config file. Defaults to "DEFAULT".
+        """
+        self.config_path = config_path
+        self.profile = profile
+        self._config: Optional[Dict[str, Any]] = None
+        self._signer: Optional[oci.signer.AbstractBaseSigner] = None
+
+    def get_config(self) -> Dict[str, Any]:
+        """Get OCI configuration from config file.
+
+        Returns:
+            Dict[str, Any]: OCI configuration
+
+        Raises:
+            oci.exceptions.InvalidConfig: If config validation fails
+            FileNotFoundError: If security token file not found
+        """
+        if self._config is None:
+            self._config = oci.config.from_file(
+                file_location=self.config_path, profile_name=self.profile
+            )
+
+            # Verify required fields for session auth
+            required_fields = ["key_file", "security_token_file", "region"]
+            missing_fields = [
+                field for field in required_fields if field not in (self._config or {})
+            ]
+            if missing_fields:
+                raise oci.exceptions.InvalidConfig(
+                    {field: "missing" for field in missing_fields}
+                )
+        return self._config or {}
+
+    def get_auth_credentials(self) -> oci.signer.AbstractBaseSigner:
+        """Get OCI signer using security token authentication.
+
+        Returns:
+            oci.signer.AbstractBaseSigner: OCI signer for authentication
+
+        Raises:
+            oci.exceptions.InvalidConfig: If config validation fails
+            FileNotFoundError: If key file or security token file not found
+        """
+        if self._signer is None:
+            config = self.get_config()
+
+            key_file = config.get("key_file")
+            if not key_file:
+                raise oci.exceptions.InvalidConfig({"key_file": "missing"})
+
+            security_token_file = config.get("security_token_file")
+            if not security_token_file:
+                raise oci.exceptions.InvalidConfig({"security_token_file": "missing"})
+
+            # Load private key
+            private_key = oci.signer.load_private_key_from_file(
+                key_file,
+                None,  # No passphrase
+            )
+
+            # Load security token
+            with open(security_token_file) as f:
+                security_token = f.read()
+
+            self._signer = oci.auth.signers.SecurityTokenSigner(
+                security_token, private_key
+            )
+        return self._signer

oci/addons/adk/auth/oci/user_principal.py

@@ -0,0 +1,64 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+from typing import Any, Dict, Optional
+
+import oci
+
+from oci.addons.adk.auth.auth_provider import AuthProvider
+
+
+class OCIUserPrincipalAuth(AuthProvider):
+    """OCI Authentication Provider using user principal."""
+
+    def __init__(
+        self,
+        config_path: Optional[str] = oci.config.DEFAULT_LOCATION,
+        profile: Optional[str] = oci.config.DEFAULT_PROFILE,
+    ):
+        """Initialize OCI User Principal Auth Provider.
+
+        Args:
+            config_path (Optional[str]): Path to OCI config file,
+                and defaults to '~/.oci/config'.
+            profile (Optional[str]): Profile to use from config file.
+                Defaults to 'DEFAULT' if not specified.
+        """
+        self.config_path = config_path
+        self.profile = profile
+        self._config = None
+        self._signer = None
+
+    def get_config(self) -> Dict[str, Any]:
+        """Get OCI configuration.
+
+        Returns:
+            Dict[str, Any]: OCI configuration dictionary
+
+        Raises:
+            oci.exceptions.ConfigFileError: If config file cannot be read
+            oci.exceptions.InvalidConfig: If config is invalid
+        """
+        if self._config is None:
+            # Use the specified profile when loading config
+            config = oci.config.from_file(self.config_path, self.profile)
+            # Validate config before caching
+            oci.config.validate_config(config)
+            self._config = config
+        return self._config or {}
+
+    def get_auth_credentials(self) -> oci.signer.AbstractBaseSigner:
+        """Get OCI signer for authentication.
+
+        Returns:
+            oci.signer.AbstractBaseSigner: OCI signer
+
+        Raises:
+            oci.exceptions.ConfigFileError: If config file cannot be read
+            oci.exceptions.InvalidConfig: If config is invalid
+        """
+        if self._signer is None:
+            config = self.get_config()
+            self._signer = oci.signer.Signer.from_config(config)
+        return self._signer  # type: ignore[return-value]

oci/addons/adk/constants.py

@@ -0,0 +1,17 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+"""
+Constants for the Agent Development Kit
+"""
+
+FREEFORM_TAGS = {"ConfiguredByADK": "ADK-Python"}
+
+DESC_SUFFIX = " created by ADK"
+
+DEFAULT_TIMEOUT = (10, 240)
+
+MAX_STATUS_CHECK = 20
+
+DEFAULT_SESSION_NAME = "Default Session"

oci/addons/adk/logger.py

@@ -0,0 +1,163 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+import logging
+import os
+from typing import Any, Optional, Union
+
+from rich.console import Console
+from rich.logging import RichHandler
+from rich.panel import Panel
+from rich.traceback import install as install_rich_traceback
+
+
+class ADKLogger:
+    """
+    A customized logger for the Agent Development Kit
+    that uses RichHandler for console output
+    and FileHandler for file output.
+    Maintains rich formatting for console output while
+    providing configurable logging levels and file output.
+    """
+
+    def __init__(
+        self,
+        name: str = "adk",
+        level: Union[int, str] = logging.INFO,
+        file_path: Optional[str] = None,
+        file_level: Union[int, str] = logging.DEBUG,
+        console: Optional[Console] = None,
+    ):
+        """
+        Initialize the ADK logger.
+
+        Args:
+            name: Logger name
+            level: Console logging level
+                (can be string like 'INFO' or int like logging.INFO)
+            file_path: Path to log file, if None, file logging is disabled
+            file_level: File logging level
+            console: Optional Rich console instance
+        """
+        # Convert string level to int if necessary
+        if isinstance(level, str):
+            level = getattr(logging, level.upper(), logging.INFO)
+
+        if isinstance(file_level, str):
+            file_level = getattr(logging, file_level.upper(), logging.DEBUG)
+
+        # Initialize Rich console or use the provided one
+        self.console = console or Console(log_time=False, log_path=False)
+
+        # Install rich traceback handler for better exception display
+        install_rich_traceback()
+
+        # Create logger
+        self.logger = logging.getLogger(name)
+        self.logger.setLevel(min(level, file_level))  # Set to lowest of the two levels
+        self.logger.propagate = False  # Prevent double logging
+
+        # Clear existing handlers if there are any
+        if self.logger.handlers:
+            self.logger.handlers.clear()
+
+        # Configure Rich handler for console output
+        self.shell_handler = RichHandler(
+            console=self.console,
+            rich_tracebacks=True,
+            markup=True,
+            show_time=True,
+            show_level=True,
+            show_path=False,
+            log_time_format="[%x %X] ",
+        )
+        self.shell_handler.setLevel(level)
+        self.logger.addHandler(self.shell_handler)
+
+        # Configure file handler if requested
+        self.file_handler = None
+        if file_path:
+            os.makedirs(os.path.dirname(file_path), exist_ok=True)
+            self.file_handler = logging.FileHandler(file_path)
+            self.file_handler.setLevel(file_level)
+            file_formatter = logging.Formatter(
+                "%(levelname)s %(asctime)s [%(name)s:%(filename)s:%(funcName)s:%(lineno)d] %(message)s"  # noqa: E501
+            )
+            self.file_handler.setFormatter(file_formatter)
+            self.logger.addHandler(self.file_handler)
+
+    # Forward standard logging methods to the underlying logger
+    def __getattr__(self, name: str) -> Any:
+        """
+        Forward any undefined attributes to the underlying logger.
+        This allows direct access to all standard logging methods like
+        debug(), info(), warning(), error(), etc.
+        """
+        return getattr(self.logger, name)
+
+    def print(
+        self,
+        message: Any,
+        title: Optional[str] = None,
+        border_style: str = "blue",
+        expand: bool = False,
+    ) -> None:
+        """
+        Print a message in a panel with rich formatting,
+        mirroring console.print(Panel()).
+
+        Args:
+            message: The message to print
+            title: Optional title for the panel
+            border_style: Style for the panel border
+            expand: Whether to expand the panel to fill the terminal width
+        """
+        panel = Panel(message, title=title, border_style=border_style, expand=expand)
+        self.console.print(panel)
+        # Also log to file if file handler is configured, but without rich formatting
+        if self.file_handler:
+            plain_message = f"[{title}] {str(message)}" if title else str(message)
+            self.logger.info(plain_message)
+
+    def print_exception(self, show_locals: bool = False) -> None:
+        """
+        Print an exception with rich formatting, mirroring console.print_exception().
+
+        Args:
+            show_locals: Whether to show local variables
+        """
+        self.console.print_exception(show_locals=show_locals)
+        self.logger.exception("Exception occurred")
+
+
+# Create a default logger instance
+default_logger = ADKLogger(
+    name="adk",
+    level=os.environ.get("ADK_LOG_LEVEL", "INFO"),
+    file_path=os.environ.get("ADK_LOG_FILE", None),
+)
+
+
+# Get a configured logger
+def get_logger(
+    name: str = "adk",
+    level: Union[int, str] = logging.INFO,
+    file_path: Optional[str] = None,
+) -> ADKLogger:
+    """
+    Create and return a configured ADKLogger instance.
+
+    Args:
+        name: Logger name
+        level: Logging level for console output
+        file_path: Path to log file, if None uses the default path
+
+    Returns:
+        ADKLogger instance
+    """
+    return ADKLogger(
+        name=name,
+        level=level,
+        file_path=file_path or os.environ.get("ADK_LOG_FILE", None),
+    )

oci/addons/adk/run/__init__.py

@@ -0,0 +1,5 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.

oci/addons/adk/run/response.py

@@ -0,0 +1,56 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+"""
+ADK run response
+"""
+
+import json
+from typing import Any, Dict
+
+from pydantic import BaseModel, Field, computed_field
+
+from oci.addons.adk.logger import default_logger as logger
+
+
+class RunResponse(BaseModel):
+    """Response from the agent run containing the final output."""
+
+    data: Dict[str, Any] = Field(..., description="Raw response from the agent")
+    session_id: str = Field(..., description="Session ID used for the response")
+
+    @computed_field  # type: ignore[prop-decorator]
+    @property
+    def final_output(self) -> str | None:
+        """Direct access to the agent message text as output"""
+        return self._get_nested_text()
+
+    @computed_field(deprecated="Use 'final_output' instead")  # type: ignore[prop-decorator]
+    @property
+    def output(self) -> str | None:
+        """Direct access to the agent message text as output"""
+        return self.final_output
+
+    def _get_nested_text(self) -> str | None:
+        """Safely extract text from nested data structure."""
+        try:
+            return self.data["message"]["content"]["text"]
+        except (KeyError, TypeError):
+            return None
+
+    def pretty_print(self, print_data: bool = False) -> None:
+        """Pretty print this run response."""
+        if self.final_output is None:
+            logger.warning("NO TEXT AVAILABLE IN RESPONSE")
+
+        message_text = f"agent text message:\n[bold green]{self.final_output}[/bold green]"
+
+        if print_data:
+            message_text += f"\n\ndata:\n[bold magenta]{json.dumps(self.data, indent=4)}[/bold magenta]"  # noqa: E501
+
+        logger.print(
+            message_text,
+            title="Agent run response",
+            border_style="blue",
+        )

oci/addons/adk/run/types.py

@@ -0,0 +1,32 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+"""
+ADK Run action models
+"""
+
+from pydantic import BaseModel, Field
+
+
+class FunctionCall(BaseModel):
+    """Represents a function call that is required from the client."""
+
+    name: str = Field(..., alias="name")
+    arguments: str | dict = Field(..., alias="arguments")
+
+
+class PerformedAction(BaseModel):
+    """Represents an action that was performed by the agent."""
+
+    action_id: str = Field(..., alias="action_id")
+    performed_action_type: str = Field(..., alias="performed_action_type")
+    function_call_output: str = Field(..., alias="function_call_output")
+
+
+class RequiredAction(BaseModel):
+    """Represents an action that is required from the client."""
+
+    action_id: str = Field(..., alias="action_id")
+    required_action_type: str = Field(..., alias="required_action_type")
+    function_call: FunctionCall = Field(..., alias="function_call")

oci/addons/adk/tool/__init__.py

@@ -0,0 +1,13 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+"""
+Default import behavior for oci.addons.adk.tool
+"""
+
+from oci.addons.adk.tool.function_tool import FunctionTool
+from oci.addons.adk.tool.tool import tool
+from oci.addons.adk.tool.toolkit import Toolkit
+
+__all__ = ["FunctionTool", "Toolkit", "tool"]