pygeai 0.4.0b11__tar.gz → 0.6.0b2__tar.gz

{pygeai-0.4.0b11/pygeai.egg-info → pygeai-0.6.0b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygeai
-Version: 0.4.0b11
+Version: 0.6.0b2
 Summary: Software Development Kit to interact with Globant Enterprise AI.
 Author-email: Globant <geai-sdk@globant.com>
 License-Expression: MIT
@@ -48,7 +48,7 @@ By using the Python SDK to interact with Globant Enterprise AI, you agree with t
 [Terms and Conditions](https://www.globant.com/enterprise-ai/terms-of-use)
 
 ## Compatibility
-This package is compatible with the Globant Enterprise AI release from June 2025.
+This package is compatible with the Globant Enterprise AI release from November 2025.
 
 ## Configuration
 
@@ -60,22 +60,50 @@ Before using the SDK, you need to define `GEAI_API_KEY` (`$SAIA_APITOKEN`) and `
 
 **Note:** If you plan to use the [Evaluation Module](https://wiki.genexus.com/enterprise-ai/wiki?896,Evaluation), you must also define `GEAI_API_EVAL_URL`
 
+### Credentials file
+The credentials file is organized via profiles, so one can interact with different instances of Globant Enterprise AI by just
+referencing which profile one wishes to use. This also applies to different levels of permissions.
+
+The structure of the credentials file is as follows:
+
+```
+[default]
+geai_api_key = <API_TOKEN>
+geai_api_base_url = <GEAI_BASE_URL>
+geai_api_evaul_url = <GEAI_EVALUATION_MODULE_URL>
+
+[<another alias>]
+geai_api_key = <API_TOKEN>
+geai_api_base_url = <GEAI_BASE_URL>
+geai_api_evaul_url = <GEAI_EVALUATION_MODULE_URL>
+
+```
+
+After setting the profiles, one can use them with the --alias option, for example:
+
+```bash 
+geai --alias test llm list-providers
+```
+
 ## Modules
 
-The SDK consists of several modules, all accessible through a meta-package:
-
-- **`pygeai`**: This meta-package encapsulates all components of the SDK.
-- **`pygeai-cli`**: This package provides a command-line tool for interacting with the SDK.
-- **`pygeai-chat`**: This package offers facilities to chat with assistants/agents created in Globant Enterprise AI.
-- **`pygeai-dbg`**: This package includes a debugger to troubleshoot potential SDK issues and gain detailed insights into its operations.
-- **`pygeai-core`**: This package handles interactions with the fundamental components of Globant Enterprise AI, including users, groups, permissions, API keys, organizations, and [Projects](https://wiki.genexus.com/enterprise-ai/wiki?565,Projects).
-- **`pygeai-admin`**: This package enables interactions with the Globant Enterprise AI instance.
-- **`pygeai-lab`**: This package facilitates interactions with AI LAB.
-- **`pygeai-evaluation`**: This package provides functionality from the evaluation module.
-- **`pygeai-gam`**: This package allows interaction with [GAM] (https://wiki.genexus.com/commwiki/wiki?24746,Table+of+contents%3AGeneXus+Access+Manager+%28GAM%29,).
-- **`pygeai-assistant`**: This package handles interactions with various Assistants, including [Data Analyst Assistants](https://wiki.genexus.com/enterprise-ai/wiki?886,Data+Analyst+Assistant+2.0), [RAG Assistants](https://wiki.genexus.com/enterprise-ai/wiki?44,RAG+Assistants+Introduction), [Chat with Data Assistants](https://wiki.genexus.com/enterprise-ai/wiki?159,Chat+with+Data+Assistant), [Chat with API Assistants](https://wiki.genexus.com/enterprise-ai/wiki?110,API+Assistant), and [Chat Assistants](https://wiki.genexus.com/enterprise-ai/wiki?708,Chat+Assistant).
-- **`pygeai-organization`**: This package facilitates interactions with Organizations in Globant Enterprise AI.
-- **`pygeai-flows`**: This package enables interactions with [Flows](https://wiki.genexus.com/enterprise-ai/wiki?321,Flows+in+Globant+Enterprise+AI) [in development]. 
+The SDK consists of several modules, all accessible through a single package `pygeai`:
+
+- **`pygeai`**: The package encapsulates all components of the SDK.
+- **`admin`**: Allows the user to interact with some of the administration endpoints of Globant Enterprise AI.
+- **`assistant`**: This module handles interactions with various Assistants, including [Data Analyst Assistants](https://wiki.genexus.com/enterprise-ai/wiki?886,Data+Analyst+Assistant+2.0), [RAG Assistants](https://wiki.genexus.com/enterprise-ai/wiki?44,RAG+Assistants+Introduction), [Chat with Data Assistants](https://wiki.genexus.com/enterprise-ai/wiki?159,Chat+with+Data+Assistant), [Chat with API Assistants](https://wiki.genexus.com/enterprise-ai/wiki?110,API+Assistant), and [Chat Assistants](https://wiki.genexus.com/enterprise-ai/wiki?708,Chat+Assistant [soon to be deprecated]).
+- **`chat`**: This module offers facilities to chat with assistants/agents created in Globant Enterprise AI.
+- **`core`**: This module handles interactions with the fundamental components of Globant Enterprise.
+- **`cli`**: This module provides a command-line tool for interacting with the SDK.
+- **`dbg`**: This module includes a debugger to troubleshoot potential SDK issues and gain detailed insights into its operations.
+- **`evaluation`**: This module provides functionality for the evaluation module.
+- **`flows`**: This module enables interactions with [Flows](https://wiki.genexus.com/enterprise-ai/wiki?321,Flows+in+Globant+Enterprise+AI) [in development]. 
+- **`gam`**: This module allows interaction with [GAM] (https://wiki.genexus.com/commwiki/wiki?24746,Table+of+contents%3AGeneXus+Access+Manager+%28GAM%29,).
+- **`health`**: Provides an easy way to check the status of the Globant Enterprise AI instance one is using.
+- **`lab`**: This module facilitates interactions with [The Lab] (https://docs.globant.ai/en/wiki?1671,The+Lab).
+- **`organization`**: This module facilitates interactions with Organizations and [Projects](https://wiki.genexus.com/enterprise-ai/wiki?565,Projects) in Globant Enterprise AI.
+- **`migration`**: This module provides functionality to migrate Agents, Tools and Projects between instances and organizations.
+- **`proxy`**: This module handles [integrations with MCP and A2A] (https://docs.globant.ai/en/wiki?1179,Importing+Tools+using+MCP+and+A2A+Servers).
 
 ## Usage
 

{pygeai-0.4.0b11 → pygeai-0.6.0b2}/README.md

@@ -9,7 +9,7 @@ By using the Python SDK to interact with Globant Enterprise AI, you agree with t
 [Terms and Conditions](https://www.globant.com/enterprise-ai/terms-of-use)
 
 ## Compatibility
-This package is compatible with the Globant Enterprise AI release from June 2025.
+This package is compatible with the Globant Enterprise AI release from November 2025.
 
 ## Configuration
 
@@ -21,22 +21,50 @@ Before using the SDK, you need to define `GEAI_API_KEY` (`$SAIA_APITOKEN`) and `
 
 **Note:** If you plan to use the [Evaluation Module](https://wiki.genexus.com/enterprise-ai/wiki?896,Evaluation), you must also define `GEAI_API_EVAL_URL`
 
+### Credentials file
+The credentials file is organized via profiles, so one can interact with different instances of Globant Enterprise AI by just
+referencing which profile one wishes to use. This also applies to different levels of permissions.
+
+The structure of the credentials file is as follows:
+
+```
+[default]
+geai_api_key = <API_TOKEN>
+geai_api_base_url = <GEAI_BASE_URL>
+geai_api_evaul_url = <GEAI_EVALUATION_MODULE_URL>
+
+[<another alias>]
+geai_api_key = <API_TOKEN>
+geai_api_base_url = <GEAI_BASE_URL>
+geai_api_evaul_url = <GEAI_EVALUATION_MODULE_URL>
+
+```
+
+After setting the profiles, one can use them with the --alias option, for example:
+
+```bash 
+geai --alias test llm list-providers
+```
+
 ## Modules
 
-The SDK consists of several modules, all accessible through a meta-package:
-
-- **`pygeai`**: This meta-package encapsulates all components of the SDK.
-- **`pygeai-cli`**: This package provides a command-line tool for interacting with the SDK.
-- **`pygeai-chat`**: This package offers facilities to chat with assistants/agents created in Globant Enterprise AI.
-- **`pygeai-dbg`**: This package includes a debugger to troubleshoot potential SDK issues and gain detailed insights into its operations.
-- **`pygeai-core`**: This package handles interactions with the fundamental components of Globant Enterprise AI, including users, groups, permissions, API keys, organizations, and [Projects](https://wiki.genexus.com/enterprise-ai/wiki?565,Projects).
-- **`pygeai-admin`**: This package enables interactions with the Globant Enterprise AI instance.
-- **`pygeai-lab`**: This package facilitates interactions with AI LAB.
-- **`pygeai-evaluation`**: This package provides functionality from the evaluation module.
-- **`pygeai-gam`**: This package allows interaction with [GAM] (https://wiki.genexus.com/commwiki/wiki?24746,Table+of+contents%3AGeneXus+Access+Manager+%28GAM%29,).
-- **`pygeai-assistant`**: This package handles interactions with various Assistants, including [Data Analyst Assistants](https://wiki.genexus.com/enterprise-ai/wiki?886,Data+Analyst+Assistant+2.0), [RAG Assistants](https://wiki.genexus.com/enterprise-ai/wiki?44,RAG+Assistants+Introduction), [Chat with Data Assistants](https://wiki.genexus.com/enterprise-ai/wiki?159,Chat+with+Data+Assistant), [Chat with API Assistants](https://wiki.genexus.com/enterprise-ai/wiki?110,API+Assistant), and [Chat Assistants](https://wiki.genexus.com/enterprise-ai/wiki?708,Chat+Assistant).
-- **`pygeai-organization`**: This package facilitates interactions with Organizations in Globant Enterprise AI.
-- **`pygeai-flows`**: This package enables interactions with [Flows](https://wiki.genexus.com/enterprise-ai/wiki?321,Flows+in+Globant+Enterprise+AI) [in development]. 
+The SDK consists of several modules, all accessible through a single package `pygeai`:
+
+- **`pygeai`**: The package encapsulates all components of the SDK.
+- **`admin`**: Allows the user to interact with some of the administration endpoints of Globant Enterprise AI.
+- **`assistant`**: This module handles interactions with various Assistants, including [Data Analyst Assistants](https://wiki.genexus.com/enterprise-ai/wiki?886,Data+Analyst+Assistant+2.0), [RAG Assistants](https://wiki.genexus.com/enterprise-ai/wiki?44,RAG+Assistants+Introduction), [Chat with Data Assistants](https://wiki.genexus.com/enterprise-ai/wiki?159,Chat+with+Data+Assistant), [Chat with API Assistants](https://wiki.genexus.com/enterprise-ai/wiki?110,API+Assistant), and [Chat Assistants](https://wiki.genexus.com/enterprise-ai/wiki?708,Chat+Assistant [soon to be deprecated]).
+- **`chat`**: This module offers facilities to chat with assistants/agents created in Globant Enterprise AI.
+- **`core`**: This module handles interactions with the fundamental components of Globant Enterprise.
+- **`cli`**: This module provides a command-line tool for interacting with the SDK.
+- **`dbg`**: This module includes a debugger to troubleshoot potential SDK issues and gain detailed insights into its operations.
+- **`evaluation`**: This module provides functionality for the evaluation module.
+- **`flows`**: This module enables interactions with [Flows](https://wiki.genexus.com/enterprise-ai/wiki?321,Flows+in+Globant+Enterprise+AI) [in development]. 
+- **`gam`**: This module allows interaction with [GAM] (https://wiki.genexus.com/commwiki/wiki?24746,Table+of+contents%3AGeneXus+Access+Manager+%28GAM%29,).
+- **`health`**: Provides an easy way to check the status of the Globant Enterprise AI instance one is using.
+- **`lab`**: This module facilitates interactions with [The Lab] (https://docs.globant.ai/en/wiki?1671,The+Lab).
+- **`organization`**: This module facilitates interactions with Organizations and [Projects](https://wiki.genexus.com/enterprise-ai/wiki?565,Projects) in Globant Enterprise AI.
+- **`migration`**: This module provides functionality to migrate Agents, Tools and Projects between instances and organizations.
+- **`proxy`**: This module handles [integrations with MCP and A2A] (https://docs.globant.ai/en/wiki?1179,Importing+Tools+using+MCP+and+A2A+Servers).
 
 ## Usage
 

{pygeai-0.4.0b11 → pygeai-0.6.0b2}/pygeai/__init__.py

@@ -4,7 +4,7 @@ import sys
 from pathlib import Path
 
 __author__ = 'Globant'
-__version__ = '0.4.0'
+__version__ = '0.6.0'
 
 # Add vendor directory to Python path
 package_root = Path(__file__).parent

pygeai-0.6.0b2/pygeai/auth/clients.py

@@ -0,0 +1,55 @@
+from json import JSONDecodeError
+
+from pygeai import logger
+from pygeai.auth.endpoints import GET_USER_PROFILE_INFO, GET_OAUTH2_ACCESS_TOKEN
+from pygeai.core.base.clients import BaseClient
+from pygeai.core.common.exceptions import InvalidAPIResponseException
+
+
+class AuthClient(BaseClient):
+
+    def get_oauth2_access_token(
+            self,
+            client_id: str,
+            username: str,
+            password: str,
+            scope: str = "gam_user_data gam_user_roles"
+    ) -> dict:
+        """
+        Retrieves the list of projects that the user is authorized to access within a specific organization.
+
+        :param client_id: str - The client identifier provided by Globant
+        :param username: str - Username for authentication
+        :param password: str - Password for authentication
+        :param scope: str - Space-separated list of requested scopes
+        :return: dict - The API response containing the list of authorized projects in JSON format.
+        """
+        response = self.api_service.get(
+            endpoint=GET_OAUTH2_ACCESS_TOKEN,
+            params={
+                "client_id": client_id,
+                "scope": scope,
+                "username": username,
+                "password": password
+            }
+        )
+        try:
+            return response.json()
+        except JSONDecodeError as e:
+            logger.error(f"Unable to obtain Oauth2 access token: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
+            raise InvalidAPIResponseException(f"Unable to  obtain Oauth2 access token: {response.text}")
+
+    def get_user_profile_information(self, access_token: str) -> dict:
+        """
+        Get user profile information
+
+        :param access_token: str - Token obtained in the POST to /oauth/access_token
+        :return: dict - The API response containing the user profile information
+        """
+        self.api_service.token = access_token
+        response = self.api_service.get(endpoint=GET_USER_PROFILE_INFO)
+        try:
+            return response.json()
+        except JSONDecodeError as e:
+            logger.error(f"Unable to retrieve user profile information: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
+            raise InvalidAPIResponseException(f"Unable to retrieve user profile information: {response.text}")

pygeai-0.6.0b2/pygeai/auth/endpoints.py

@@ -0,0 +1,2 @@
+GET_OAUTH2_ACCESS_TOKEN = "/oauth/access_token"      # POST -> Obtain an OAuth 2.0 access token
+GET_USER_PROFILE_INFO = "/openid/userinfo"          # GET -> Retrieve user profile information

{pygeai-0.4.0b11 → pygeai-0.6.0b2}/pygeai/cli/__init__.py

@@ -4,5 +4,4 @@ GEAI - ClI
 Command line interface to interact with Globant Enterprise AI.
 """
 
-__version__ = '0.4.0'
 

pygeai-0.6.0b2/pygeai/cli/commands/auth.py

@@ -0,0 +1,123 @@
+from pygeai.auth.clients import AuthClient
+from pygeai.cli.commands import Command, Option, ArgumentsEnum
+from pygeai.cli.commands.builders import build_help_text
+from pygeai.cli.texts.help import AUTH_HELP_TEXT
+from pygeai.core.common.exceptions import MissingRequirementException, WrongArgumentError
+from pygeai.core.utils.console import Console
+
+
+def show_help():
+    """
+    Displays help text in stdout
+    """
+    help_text = build_help_text(auth_commands, AUTH_HELP_TEXT)
+    Console.write_stdout(help_text)
+
+
+def get_oauth2_access_token(option_list: list):
+    client_id = None
+    username = None
+    password = None
+    scope = "gam_user_data gam_user_roles"
+    for option_flag, option_arg in option_list:
+        if option_flag.name == "client_id":
+            client_id = option_arg
+        if option_flag.name == "username":
+            username = option_arg
+        if option_flag.name == "password":
+            password = option_arg
+        if option_flag.name == "scope":
+            scope = option_arg
+
+    if not (client_id and username and password):
+        raise MissingRequirementException("Cannot obtain Oauth2 access token without client_id, username and password")
+
+    client = AuthClient()
+    result = client.get_oauth2_access_token(
+        client_id=client_id,
+        username=username,
+        password=password,
+        scope=scope
+    )
+    Console.write_stdout(f"Authorized projects detail: \n{result}")
+
+
+get_oauth2_access_token_options = [
+    Option(
+        "client_id",
+        ["--client-id", "--cid"],
+        "The client identifier provided by Globant.",
+        True
+    ),
+    Option(
+        "username",
+        ["--username", "-u"],
+        "Username for authentication.",
+        True
+    ),
+    Option(
+        "password",
+        ["--password", "-p"],
+        "Password for authentication.",
+        True
+    ),
+    Option(
+        "scope",
+        ["--scope", "-s"],
+        "Space-separated list of requested scopes. (Optional)",
+        True
+    ),
+
+]
+
+
+def get_user_profile_information(option_list: list):
+    access_token = None
+    for option_flag, option_arg in option_list:
+        if option_flag.name == "access_token":
+            access_token = option_arg
+
+    client = AuthClient()
+    result = client.get_user_profile_information(access_token=access_token)
+    Console.write_stdout(f"User profile information: \n{result}")
+
+
+get_user_profile_information_options = [
+    Option(
+        "access_token",
+        ["--access-token", "--token"],
+        "Token obtained with the --get-access-token option",
+        True
+    ),
+]
+
+
+auth_commands = [
+    Command(
+        "help",
+        ["help", "h"],
+        "Display help text",
+        show_help,
+        ArgumentsEnum.NOT_AVAILABLE,
+        [],
+        []
+    ),
+    Command(
+        "get_oauth2_access_token",
+        ["get-access-token", "gat"],
+        "Get Oauth acess token for Globant Enterprise AI instance",
+        get_oauth2_access_token,
+        ArgumentsEnum.REQUIRED,
+        [],
+        get_oauth2_access_token_options
+    ),
+    Command(
+        "get_user_profile_information_options",
+        ["get-user-information", "get-user-info", "gui"],
+        "Retrieve user profile information",
+        get_user_profile_information_options,
+        ArgumentsEnum.REQUIRED,
+        [],
+        get_user_profile_information_options
+    ),
+]

{pygeai-0.4.0b11 → pygeai-0.6.0b2}/pygeai/cli/commands/base.py

@@ -1,6 +1,7 @@
 from pygeai.cli.commands import ArgumentsEnum, Command, Option
 from pygeai.cli.commands.admin import admin_commands
 from pygeai.cli.commands.assistant import assistant_commands
+from pygeai.cli.commands.auth import auth_commands
 from pygeai.cli.commands.builders import build_help_text
 from pygeai.cli.commands.chat import chat_commands
 from pygeai.cli.commands.configuration import configure, configuration_options
@@ -20,7 +21,7 @@ from pygeai.cli.commands.secrets import secrets_commands
 from pygeai.cli.commands.usage_limits import usage_limit_commands
 from pygeai.cli.commands.version import check_new_version
 from pygeai.cli.texts.help import HELP_TEXT
-from pygeai.cli import __version__ as cli_version
+from pygeai import __version__ as cli_version
 from pygeai.core.utils.console import Console
 from pygeai.health.clients import HealthClient
 
@@ -155,6 +156,16 @@ base_commands = [
         admin_commands,
         []
     ),
+    Command(
+        "auth",
+        ["auth"],
+        "Invoke auth endpoints for token generation",
+        None,
+        ArgumentsEnum.REQUIRED,
+        auth_commands,
+        []
+    ),
+
     Command(
         "llm",
         ["llm"],