pygeai 0.2.7b42__py3-none-any.whl → 0.2.7b43__py3-none-any.whl

pygeai/man/man1/geai-proxy.1

@@ -92,6 +92,55 @@ The configuration file should be in JSON format with the following structure:
 }
 .fi
 
+.SH PUBLIC TOOL REGISTRATION
+Tools provided by both MCP and A2A servers can be published to GEAI under a public namespace
+by including the \fBpublic_prefix\fR field in their configuration entry.
+
+This allows tools to be registered under a well-defined global identifier, making them
+discoverable and shareable across proxies and clients.
+
+.SS MCP SERVER EXAMPLE WITH PUBLIC PREFIX
+The following configuration registers all tools from the \fBpuppeteer\fR MCP server under
+the public prefix \fIcom.globant.puppeteer\fR:
+
+.nf
+{
+  "mcpServers": {
+    "public_prefix": "com.globant.puppeteer",
+    "puppeteer": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
+    }
+  }
+}
+.fi
+
+.SS A2A SERVER EXAMPLE WITH PUBLIC PREFIX
+The following configuration registers the tools provided by the \fBhello-world\fR A2A agent
+under the prefix \fIcom.genexus.a2a.sampleagent\fR:
+
+.nf
+{
+  "a2aServers": {
+    "hello-world": {
+      "public_prefix": "com.genexus.a2a.sampleagent",
+      "url": "http://localhost:9999",
+      "headers": {
+        "Authorization": "Bearer fh84ff...."
+      }
+    }
+  }
+}
+.fi
+
+.SS RESULTING TOOL IDENTIFIERS
+When this prefix is set, all tools will be published using it. For example, a tool named
+\fBtranslate_text\fR would be available as:
+
+.nf
+com.genexus.a2a.sampleagent.translate_text
+.fi
+
 .SS 2. Proxy Authentication Configuration
 This section establishes the connection between the proxy and GEAI and manages user aliases.
 .TP
@@ -116,6 +165,33 @@ Generated new proxy ID: 37bae96b-bc99-4110-bb61-b912b28f9e32
 -> Insert proxy description:
 .fi
 
+.SH PROXY CONFIGURATION PARAMETERS
+During interactive setup, the following parameters are requested:
+
+.TP
+\fBproxy ID (UUID)\fR
+A unique identifier for this proxy instance. If left empty, the automatically generated UUID
+will be used.
+
+.TP
+\fBproxy API key\fR
+The API key used to authenticate the proxy with the GEAI backend. This must be an API token
+generated in GEAI for a specific project.
+
+.TP
+\fBproxy base URL\fR
+The base URL of the GEAI installation this proxy will connect to.
+For example: \fIhttps://api.beta.saia.ai\fR
+
+.TP
+\fBproxy name\fR
+A human-readable name assigned to this instance of \fBgeai-proxy\fR. This name is stored under the configured alias.
+
+.TP
+\fBproxy description\fR
+An optional description to help identify this proxy instance, especially when multiple proxies are used under different aliases.
+
+
 .SH USAGE
 To start the proxy server with a specific configuration and alias:
 .nf

pygeai/proxy/managers.py

@@ -59,8 +59,8 @@ class ServerManager:
 
         for server in self.servers.values():
             Console.write_stdout(f"Listing tools for server {server.name}", end="")
-            if server.public_preffix:
-                Console.write_stdout(f" | access scope:public prefix: {server.public_preffix}")
+            if server.public_prefix:
+                Console.write_stdout(f" | access scope:public prefix: {server.public_prefix}")
             else:
                 Console.write_stdout(" ! access scope:private")
 

pygeai/proxy/servers.py

@@ -40,7 +40,7 @@ class ToolServer(ABC):
         self.config = config
         self.settings = settings
         self.name: str = sever_name
-        self.public_preffix: str | None = None
+        self.public_prefix: str | None = None
         self.exit_stack: AsyncExitStack = AsyncExitStack()
 
     @abstractmethod
@@ -105,7 +105,7 @@ class A2AServer(ToolServer):
         """
         try:
             self.httpx_client = httpx.AsyncClient(timeout=60.0)
-            self.public_preffix = self.config.get("publicpreffix")
+            self.public_prefix = self.config.get("public_prefix")
             headers = self.config.get("headers")
             if headers:
                 self.httpx_client.headers.update(headers)
@@ -138,7 +138,7 @@ class A2AServer(ToolServer):
         }
         tools = []
         for skill in self.agent_card.skills:
-            tools.append(ProxiedTool(self.name, skill.id, skill.description, self.public_preffix, input_schema))
+            tools.append(ProxiedTool(self.name, skill.id, skill.description, self.public_prefix, input_schema))
         return tools
 
     async def execute_tool(
@@ -197,7 +197,7 @@ class MCPServer(ToolServer):
         self.session: ClientSession | None = None
 
     async def initialize(self) -> None:
-        self.public_preffix = self.config.get("publicpreffix")
+        self.public_prefix = self.config.get("public_prefix")
         transport = self.config.get("transport") or (
             "sse" if "uri" in self.config else "stdio"
         )
@@ -264,7 +264,7 @@ class MCPServer(ToolServer):
                             self.name,
                             tool.name,
                             tool.description,
-                            self.public_preffix,
+                            self.public_prefix,
                             tool.inputSchema
                         )
                     )

pygeai/proxy/tool.py

@@ -9,7 +9,7 @@ class ProxiedTool:
     :param server_name: str - Name of the server exposing the tool
     :param name: str - Name of the tool
     :param description: str - Description of the tool's functionality
-    :param public_preffix: str - Public prefix of the tool
+    :param public_prefix: str - Public prefix of the tool
     :param input_schema: dict[str, Any] - JSON schema defining the expected input for the tool
     :return: ProxiedTool - Instance of the ProxiedTool class
     :raises: ValueError - If any required parameter is invalid or missing
@@ -20,7 +20,7 @@ class ProxiedTool:
         server_name: str,
         name: str,
         description: str,
-        public_preffix: str,
+        public_prefix: str,
         input_schema: dict[str, Any]
     ) -> None:
         self.server_name: str = server_name
@@ -28,7 +28,7 @@ class ProxiedTool:
         self.openai_compatible_name: str = self._get_openai_compatible_name(name)
         self.description: str = description
         self.input_schema: dict[str, Any] = input_schema
-        self.public_preffix: str = public_preffix
+        self.public_prefix: str = public_prefix
 
     def get_full_name(self) -> str:
         """Get the full name of the tool."""
@@ -36,12 +36,12 @@ class ProxiedTool:
 
     def is_public(self) -> bool:
         """Check if the tool is public."""
-        return self.public_preffix is not None
+        return self.public_prefix is not None
 
     def get_public_name(self) -> str:
         """Get the public name of the tool."""
         return (
-            f"{self.public_preffix}.{self.name if self.server_name in self.public_preffix else self.get_full_name()}"
+            f"{self.public_prefix}.{self.name if self.server_name in self.public_prefix else self.get_full_name()}"
         )
 
     def format_for_llm(self) -> str:

{pygeai-0.2.7b42.dist-info → pygeai-0.2.7b43.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygeai
-Version: 0.2.7b42
+Version: 0.2.7b43
 Summary: Software Development Kit to interact with Globant Enterprise AI.
 Author-email: Globant <geai-sdk@globant.com>
 License-Expression: MIT

{pygeai-0.2.7b42.dist-info → pygeai-0.2.7b43.dist-info}/RECORD

@@ -167,7 +167,7 @@ pygeai/lab/tools/endpoints.py,sha256=VPd2jBSDW4rpCa4h3kBPWJ9JA2G2ecBYQop-lffTSbI
 pygeai/lab/tools/mappers.py,sha256=6xcR7lIOYrvUG8SERQIx_bsK-_To316BUql8UPLHWco,4978
 pygeai/man/__init__.py,sha256=gqGI92vUPt6RPweoWX3mTUYPWNDlm6aGUjQOnYXqthk,53
 pygeai/man/man1/__init__.py,sha256=CFvES6cP_sbhgpm-I-QSbPC1f7Bw7cFsMW2-sxm4FtM,54
-pygeai/man/man1/geai-proxy.1,sha256=QUFClbwUf6zIl7vpmFCDTg7vbk2D75m98G3BAGiD-OU,4084
+pygeai/man/man1/geai-proxy.1,sha256=Q9li_XOxdCIHa2EWb_UuebJU3QKeyDju1lO4NVlpLnU,6255
 pygeai/man/man1/geai.1,sha256=dRJjqXLu4PRr5tELX-TveOrvp-J085rTV0NbqL5I30Q,51162
 pygeai/migration/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pygeai/migration/strategies.py,sha256=fedXqdtnAY57eeMI3RP5KhkjzVtYD654G51pMJb41fw,10041
@@ -186,9 +186,9 @@ pygeai/organization/limits/mappers.py,sha256=nINHaXOnZLnpc39PG3xf_7HX6tS9_-cT-H5
 pygeai/proxy/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pygeai/proxy/clients.py,sha256=YPRUS3JAbEXgIGZ_dg8VwEXLxvG_hl51o70uudqjYB0,7857
 pygeai/proxy/config.py,sha256=41fACnnhB21OhnohVPW4sbM8aZbAAEgGo7-dUaM_fpM,5057
-pygeai/proxy/managers.py,sha256=swORE-WLtcTPglNpRc2AuHVjnbq0SX2ppnWQWYA44iQ,11134
-pygeai/proxy/servers.py,sha256=ys2bzIRIoBxEuzQOxviFaQGznm3CuymXHSkeKu4xm6U,11236
-pygeai/proxy/tool.py,sha256=BB6G5cg0768qz1tARB1pL0wBhSKr8SeWVGna0hfGmzg,2245
+pygeai/proxy/managers.py,sha256=hXxVeWvkwfb7QrwOGcKyL9qW_wdNTxcpW84ppqwQ0SU,11132
+pygeai/proxy/servers.py,sha256=ZJEnfT5gogTrr9LYir0kRkUDzW6RJjNFWceqN1sIeKM,11231
+pygeai/proxy/tool.py,sha256=vG1THJNHCPNr5Y_3J7NlTu20hlATzsejOe07soPMDAE,2238
 pygeai/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pygeai/tests/admin/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pygeai/tests/admin/test_clients.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -475,9 +475,9 @@ pygeai/vendor/a2a/utils/helpers.py,sha256=6Tbd8SVfXvdNEk6WYmLOjrAxkzFf1aIg8dkFfB
 pygeai/vendor/a2a/utils/message.py,sha256=gc_EKO69CJ4HkR76IFgsy-kENJz1dn7CfSgWJWvt-gs,2197
 pygeai/vendor/a2a/utils/task.py,sha256=BYRA_L1HpoUGJAVlyHML0lCM9Awhf2Ovjj7oPFXKbh0,1647
 pygeai/vendor/a2a/utils/telemetry.py,sha256=VvSp1Ztqaobkmq9-3sNhhPEilJS32-JTSfKzegkj6FU,10861
-pygeai-0.2.7b42.dist-info/licenses/LICENSE,sha256=eHfqo7-AWS8cMq0cg03lq7owsLeCmZA-xS5L0kuHnl8,1474
-pygeai-0.2.7b42.dist-info/METADATA,sha256=8ib_II6z_LMPUaR07YA4dt6gzeGwtxtfJFxYnHq2kPo,6883
-pygeai-0.2.7b42.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pygeai-0.2.7b42.dist-info/entry_points.txt,sha256=OAmwuXVCQBTCE3HeVegVd37hbhCcp9TPahvdrCuMYWw,178
-pygeai-0.2.7b42.dist-info/top_level.txt,sha256=bJFwp2tURmCfB94yXDF7ylvdSJXFDDJsyUOb-7PJgwc,7
-pygeai-0.2.7b42.dist-info/RECORD,,
+pygeai-0.2.7b43.dist-info/licenses/LICENSE,sha256=eHfqo7-AWS8cMq0cg03lq7owsLeCmZA-xS5L0kuHnl8,1474
+pygeai-0.2.7b43.dist-info/METADATA,sha256=3mnn2OxImq9D3jPuwwWkFB-NhjPBAUP0FWUQrHhNdXI,6883
+pygeai-0.2.7b43.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pygeai-0.2.7b43.dist-info/entry_points.txt,sha256=OAmwuXVCQBTCE3HeVegVd37hbhCcp9TPahvdrCuMYWw,178
+pygeai-0.2.7b43.dist-info/top_level.txt,sha256=bJFwp2tURmCfB94yXDF7ylvdSJXFDDJsyUOb-7PJgwc,7
+pygeai-0.2.7b43.dist-info/RECORD,,