cortex-agent-sdk 0.0.1__tar.gz → 0.0.2__tar.gz

{cortex_agent_sdk-0.0.1 → cortex_agent_sdk-0.0.2}/PKG-INFO

@@ -1,7 +1,9 @@
 Metadata-Version: 2.4
 Name: cortex-agent-sdk
-Version: 0.0.1
+Version: 0.0.2
 Summary: SDK async y multiproveedor para construir agentes con control explícito
+Project-URL: Repository, https://github.com/epok200/cortex_agent_sdk
+Project-URL: Issues, https://github.com/epok200/cortex_agent_sdk/issues
 Author: EPOK
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -20,14 +22,14 @@ Provides-Extra: all
 Requires-Dist: asyncpg>=0.31.0; extra == 'all'
 Requires-Dist: openai<3,>=2.52; extra == 'all'
 Requires-Dist: redis>=8.1.0; extra == 'all'
+Provides-Extra: gateway
+Requires-Dist: openai<3,>=2.52; extra == 'gateway'
 Provides-Extra: openai
 Requires-Dist: openai<3,>=2.52; extra == 'openai'
 Provides-Extra: postgres
 Requires-Dist: asyncpg>=0.31.0; extra == 'postgres'
 Provides-Extra: redis
 Requires-Dist: redis>=8.1.0; extra == 'redis'
-Provides-Extra: talos
-Requires-Dist: openai<3,>=2.52; extra == 'talos'
 Description-Content-Type: text/markdown
 
 # Cortex Agent SDK
@@ -60,7 +62,7 @@ El core instala únicamente Pydantic y JSON Schema. Los providers y transportes
 extras opcionales:
 
 - `openai`: engine de OpenAI Responses.
-- `talos`: conexión de OpenAI mediante Talos.
+- `gateway`: conexión mediante un endpoint compatible con OpenAI Responses.
 - `redis`: sesiones persistentes en Redis.
 - `postgres`: sesiones persistentes en PostgreSQL.
 - `all`: todas las integraciones disponibles.
@@ -86,6 +88,24 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
+## Gateway compatible
+
+`OpenAIEngine` también acepta un endpoint que conserve el protocolo de OpenAI Responses:
+
+```python
+import os
+
+from cortex_agent_sdk.gateway import OpenAICompatibleGateway
+from cortex_agent_sdk.openai import OpenAIEngine
+
+
+gateway = OpenAICompatibleGateway(
+    url=os.environ["CORTEX_GATEWAY_URL"],
+    api_key=os.environ["CORTEX_GATEWAY_API_KEY"],
+)
+engine = OpenAIEngine("your-model", gateway=gateway)
+```
+
 ## Tools
 
 Una función async decorada puede exponerse al modelo como respuesta final:
@@ -125,7 +145,7 @@ asyncio.run(main())
 - Hooks locales.
 - Timeouts para providers y tools.
 - Respuesta tipada con texto, usage, razón de salida y respuesta raw.
-- OpenAI Responses directo o mediante Talos.
+- OpenAI Responses directo o mediante un gateway compatible.
 
 Google conserva un namespace estable para la evolución multiproveedor, pero todavía no incluye un
 engine funcional. Anthropic y streaming están fuera de este alfa.
@@ -139,12 +159,14 @@ renovable, fencing token y compare-and-swap.
 Redis no requiere inicialización de schema:
 
 ```python
+import os
+
 from cortex_agent_sdk import Agent
 from cortex_agent_sdk.openai import OpenAIEngine
 from cortex_agent_sdk.redis import RedisSessionStore
 
 
-store = RedisSessionStore("redis://127.0.0.1:6379/0")
+store = RedisSessionStore(os.environ["REDIS_URL"])
 agent = Agent(
     OpenAIEngine("gpt-5.6-luna"),
     session_store=store,
@@ -157,10 +179,12 @@ await agent.aclose()
 PostgreSQL exige crear su tabla de forma explícita una vez:
 
 ```python
+import os
+
 from cortex_agent_sdk.postgres import PostgresSessionStore
 
 
-store = PostgresSessionStore("postgresql://user:password@localhost/app")
+store = PostgresSessionStore(os.environ["POSTGRES_URL"])
 await store.setup()
 ```
 
@@ -175,18 +199,6 @@ regresa `RUNTIME_CIERRE_TIMEOUT` para que la aplicación pueda reintentar el cie
 Una sesión dañada o deliberadamente descartada se elimina mediante
 `await agent.reset_session(session_id)`.
 
-## Desarrollo
-
-```bash
-uv sync --all-extras
-uv run ruff check .
-uv run pyright
-uv run pytest
-uv build --no-sources
-```
-
-Las pruebas que requieren red son opt-in y no forman parte de la suite normal.
-
 ## Licencia
 
 Apache License 2.0.

{cortex_agent_sdk-0.0.1 → cortex_agent_sdk-0.0.2}/README.md

@@ -28,7 +28,7 @@ El core instala únicamente Pydantic y JSON Schema. Los providers y transportes
 extras opcionales:
 
 - `openai`: engine de OpenAI Responses.
-- `talos`: conexión de OpenAI mediante Talos.
+- `gateway`: conexión mediante un endpoint compatible con OpenAI Responses.
 - `redis`: sesiones persistentes en Redis.
 - `postgres`: sesiones persistentes en PostgreSQL.
 - `all`: todas las integraciones disponibles.
@@ -54,6 +54,24 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
+## Gateway compatible
+
+`OpenAIEngine` también acepta un endpoint que conserve el protocolo de OpenAI Responses:
+
+```python
+import os
+
+from cortex_agent_sdk.gateway import OpenAICompatibleGateway
+from cortex_agent_sdk.openai import OpenAIEngine
+
+
+gateway = OpenAICompatibleGateway(
+    url=os.environ["CORTEX_GATEWAY_URL"],
+    api_key=os.environ["CORTEX_GATEWAY_API_KEY"],
+)
+engine = OpenAIEngine("your-model", gateway=gateway)
+```
+
 ## Tools
 
 Una función async decorada puede exponerse al modelo como respuesta final:
@@ -93,7 +111,7 @@ asyncio.run(main())
 - Hooks locales.
 - Timeouts para providers y tools.
 - Respuesta tipada con texto, usage, razón de salida y respuesta raw.
-- OpenAI Responses directo o mediante Talos.
+- OpenAI Responses directo o mediante un gateway compatible.
 
 Google conserva un namespace estable para la evolución multiproveedor, pero todavía no incluye un
 engine funcional. Anthropic y streaming están fuera de este alfa.
@@ -107,12 +125,14 @@ renovable, fencing token y compare-and-swap.
 Redis no requiere inicialización de schema:
 
 ```python
+import os
+
 from cortex_agent_sdk import Agent
 from cortex_agent_sdk.openai import OpenAIEngine
 from cortex_agent_sdk.redis import RedisSessionStore
 
 
-store = RedisSessionStore("redis://127.0.0.1:6379/0")
+store = RedisSessionStore(os.environ["REDIS_URL"])
 agent = Agent(
     OpenAIEngine("gpt-5.6-luna"),
     session_store=store,
@@ -125,10 +145,12 @@ await agent.aclose()
 PostgreSQL exige crear su tabla de forma explícita una vez:
 
 ```python
+import os
+
 from cortex_agent_sdk.postgres import PostgresSessionStore
 
 
-store = PostgresSessionStore("postgresql://user:password@localhost/app")
+store = PostgresSessionStore(os.environ["POSTGRES_URL"])
 await store.setup()
 ```
 
@@ -143,18 +165,6 @@ regresa `RUNTIME_CIERRE_TIMEOUT` para que la aplicación pueda reintentar el cie
 Una sesión dañada o deliberadamente descartada se elimina mediante
 `await agent.reset_session(session_id)`.
 
-## Desarrollo
-
-```bash
-uv sync --all-extras
-uv run ruff check .
-uv run pyright
-uv run pytest
-uv build --no-sources
-```
-
-Las pruebas que requieren red son opt-in y no forman parte de la suite normal.
-
 ## Licencia
 
 Apache License 2.0.

{cortex_agent_sdk-0.0.1 → cortex_agent_sdk-0.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cortex-agent-sdk"
-version = "0.0.1"
+version = "0.0.2"
 description = "SDK async y multiproveedor para construir agentes con control explícito"
 readme = "README.md"
 license = "Apache-2.0"
@@ -21,11 +21,15 @@ dependencies = [
     "pydantic>=2.13,<3",
 ]
 
+[project.urls]
+Repository = "https://github.com/epok200/cortex_agent_sdk"
+Issues = "https://github.com/epok200/cortex_agent_sdk/issues"
+
 [project.optional-dependencies]
 openai = [
     "openai>=2.52,<3",
 ]
-talos = [
+gateway = [
     "openai>=2.52,<3",
 ]
 all = [

{cortex_agent_sdk-0.0.1 → cortex_agent_sdk-0.0.2}/src/cortex_agent_sdk/gateway.py

@@ -1,23 +1,22 @@
 from pydantic import AnyHttpUrl, BaseModel, ConfigDict, Field, SecretStr
 
 
-class TalosGateway(BaseModel):
-    """Conexión interna a Talos para un engine nativo."""
+class OpenAICompatibleGateway(BaseModel):
+    """Conexión autenticada a un endpoint compatible con OpenAI Responses."""
 
     model_config = ConfigDict(extra="forbid", frozen=True)
 
     url: AnyHttpUrl
-    project_token: SecretStr = Field(min_length=32)
+    api_key: SecretStr = Field(min_length=32)
 
     def __init__(
         self,
         *,
         url: str | AnyHttpUrl,
-        project_token: str | SecretStr,
+        api_key: str | SecretStr,
     ) -> None:
-        super().__init__(url=url, project_token=project_token)
+        super().__init__(url=url, api_key=api_key)
 
     @property
-    def openai_base_url(self) -> str:
+    def base_url(self) -> str:
         return f"{str(self.url).rstrip('/')}/v1"
-

{cortex_agent_sdk-0.0.1 → cortex_agent_sdk-0.0.2}/src/cortex_agent_sdk/openai/engine.py

@@ -9,7 +9,7 @@ from pydantic import BaseModel, JsonValue, TypeAdapter, ValidationError
 
 from cortex_agent_sdk.engine import EngineRequest, EngineResult, ToolCall, Usage
 from cortex_agent_sdk.errores import AppError, CodigoError
-from cortex_agent_sdk.gateway import TalosGateway
+from cortex_agent_sdk.gateway import OpenAICompatibleGateway
 from cortex_agent_sdk.history.models import (
     ProviderState,
     ProviderValue,
@@ -39,7 +39,7 @@ class OpenAIEngine:
         model: str,
         *,
         api_key: str | None = None,
-        gateway: TalosGateway | None = None,
+        gateway: OpenAICompatibleGateway | None = None,
         options: OpenAIOptions | None = None,
         client: AsyncOpenAI | None = None,
     ) -> None:
@@ -133,12 +133,12 @@ class OpenAIEngine:
     def _create_client(
         self,
         api_key: str | None,
-        gateway: TalosGateway | None,
+        gateway: OpenAICompatibleGateway | None,
     ) -> AsyncOpenAI:
         if gateway is not None:
             return AsyncOpenAI(
-                api_key=gateway.project_token.get_secret_value(),
-                base_url=gateway.openai_base_url,
+                api_key=gateway.api_key.get_secret_value(),
+                base_url=gateway.base_url,
                 max_retries=0,
                 timeout=self._options.timeout_seconds,
             )
@@ -301,4 +301,3 @@ def _stop_reason(response) -> str | None:
     if incomplete is not None:
         return incomplete.reason
     return response.status
-