From 5b308dfdf13b530ca3cd6b3a8e68d799e7fcdca2 Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Mon, 16 Nov 2026 14:11:18 -0600 Subject: [PATCH 01/18] feat(agentex): serve Slack webhook triggers over Socket Mode A Slack app can only push events to a public Request URL, and Slack publishes no source IP ranges, so an agentex ingress restricted to an IP allowlist cannot receive them. Socket Mode reverses the direction: agentex dials out to Slack and receives events over a websocket. A Slack webhook trigger can now carry an app-level token (xapp-...). It is stored Fernet-encrypted with the existing credential encryption key, next to the agent forward path that an HTTP delivery would have carried in its URL. With SLACK_SOCKET_MODE_ENABLED set, each API process holds one Socket Mode connection per such trigger, refreshed every minute, and forwards each events_api envelope to the agent's forward path with the same body and X-Slack-Retry-* headers. The envelope is acked only after the agent answers 2xx within 2.5s, so a failed or slow forward is redelivered by Slack. A token Slack rejects (revoked, invalid, wrong type) logs one error and stops that connection instead of looping in slack_sdk's reconnect retries; it is retried only once the trigger is re-registered. The bridge refuses to start without the encryption key. Adds slack-sdk 3.44.1 (aiohttp backend, no optional extras). Co-Authored-By: Claude Opus 5.5 --- ..._api_key_slack_socket_mode_f3a5c7e9b1d2.py | 37 + .../docs/docs/development_guides/webhooks.md | 30 + agentex/openapi.yaml | 9 + agentex/pyproject.toml | 4 + agentex/src/adapters/orm.py | 6 + agentex/src/api/app.py | 12 + agentex/src/api/routes/agent_api_keys.py | 23 + agentex/src/api/schemas/agent_api_keys.py | 9 + agentex/src/config/environment_variables.py | 6 + agentex/src/domain/entities/agent_api_keys.py | 8 + .../repositories/agent_api_key_repository.py | 21 + .../services/slack_socket_mode_bridge.py | 330 +++++++ .../use_cases/agent_api_keys_use_case.py | 4 + .../services/test_slack_socket_mode_bridge.py | 133 +++ uv.lock | 877 +++++++++--------- 15 files changed, 1076 insertions(+), 433 deletions(-) create mode 100644 agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py create mode 100644 agentex/src/domain/services/slack_socket_mode_bridge.py create mode 100644 agentex/tests/unit/services/test_slack_socket_mode_bridge.py diff --git a/agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py b/agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py new file mode 100644 index 00000000..26b1052a --- /dev/null +++ b/agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py @@ -0,0 +1,37 @@ +"""agent api key slack socket mode + +Revision ID: f3a5c7e9b1d2 +Revises: e2f4a6c8b0d1 +Create Date: 2026-11-16 12:00:00.000000 + +Adds two nullable columns to ``agent_api_keys`` so a Slack webhook trigger can be +served over Socket Mode: the encrypted app-level token and the agent subpath to +forward to. Metadata-only (nullable, no default, no backfill); IF NOT EXISTS makes +a re-run a no-op. +""" + +from collections.abc import Sequence + +from alembic import op + +# revision identifiers, used by Alembic. +revision: str = "f3a5c7e9b1d2" +down_revision: str | None = "e2f4a6c8b0d1" +branch_labels: str | Sequence[str] | None = None +depends_on: str | Sequence[str] | None = None + + +def upgrade() -> None: + op.execute( + "ALTER TABLE agent_api_keys " + "ADD COLUMN IF NOT EXISTS app_token_encrypted VARCHAR, " + "ADD COLUMN IF NOT EXISTS forward_path VARCHAR;" + ) + + +def downgrade() -> None: + op.execute( + "ALTER TABLE agent_api_keys " + "DROP COLUMN IF EXISTS forward_path, " + "DROP COLUMN IF EXISTS app_token_encrypted;" + ) diff --git a/agentex/docs/docs/development_guides/webhooks.md b/agentex/docs/docs/development_guides/webhooks.md index a80a6c98..b808effb 100644 --- a/agentex/docs/docs/development_guides/webhooks.md +++ b/agentex/docs/docs/development_guides/webhooks.md @@ -177,6 +177,36 @@ curl -X POST $HOST/agent_api_keys \ }' ``` +#### Slack over Socket Mode + +If Slack cannot reach agentex over HTTP (for example, the ingress only admits an IP allowlist, and Slack publishes no source IPs), agentex can receive the app's events over [Socket Mode](https://docs.slack.dev/apis/events-api/using-socket-mode) instead. +Create an app-level token with the `connections:write` scope under Basic Information, enable Socket Mode on the app, and register the trigger with that token: + +```bash +curl -X POST $HOST/agent_api_keys/webhook-trigger \ + -H "Content-Type: application/json" \ + -d '{ + "agent_name": "", + "source": "slack", + "name": "A123ABC456", + "secret": "abcdefg12345", + "forward_path": "slack/events", + "app_token": "xapp-..." + }' +``` + +Each agentex API process then holds one Socket Mode connection for the app and POSTs every Events API payload to `forward_path` on the agent, the same route and body an HTTP delivery would reach (`url_verification` never happens over a socket). +Slack's `retry_attempt` arrives as the usual `X-Slack-Retry-Num` and `X-Slack-Retry-Reason` headers. +An event is acknowledged only after the agent answers 2xx within 2.5 seconds; otherwise Slack redelivers it. +Interactivity and slash-command payloads are not forwarded. + +Operator notes: + +- Socket Mode is off unless `SLACK_SOCKET_MODE_ENABLED=true`, and it refuses to start without `AGENTEX_CREDENTIAL_ENCRYPTION_KEY`, which encrypts the stored app token. +- **One owner per Slack app.** Slack delivers each event to one of the app's open connections. If an agent, or a second agentex environment, also opens a socket for the same app, events are split between them and each side misses some. Register a given app's token in exactly one environment, and remove any Socket Mode client from the agent. +- Slack allows at most 10 open connections per app. Every API process opens one, so more than 10 API processes (replicas times workers) exceeds the cap. +- If Slack rejects the token (revoked, invalid, wrong type), agentex logs one error and stops that app's connection. To change the token, delete the trigger and register it again; agentex picks up added and removed triggers within a minute. + ### Deleting API Keys If you'd like to remove an existing API key for whatever reason, first grab its ID by listing the keys for the appropriate agent as above. diff --git a/agentex/openapi.yaml b/agentex/openapi.yaml index b9e0d51b..2bd0287d 100644 --- a/agentex/openapi.yaml +++ b/agentex/openapi.yaml @@ -5313,6 +5313,15 @@ components: an existing webhook secret. For Slack, this is required and must be the Slack app's Signing Secret. For Linear, this is required and must be the Linear OAuth app's webhook signing secret. + app_token: + anyOf: + - type: string + - type: 'null' + title: App Token + description: Slack only. The app's app-level token (xapp-..., scope connections:write). + When set, agentex receives the app's events over Socket Mode and forwards + them to forward_path, so the app needs no public Request URL. Stored encrypted + and never returned. base_url: anyOf: - type: string diff --git a/agentex/pyproject.toml b/agentex/pyproject.toml index 5e5ba384..9599dddd 100644 --- a/agentex/pyproject.toml +++ b/agentex/pyproject.toml @@ -42,6 +42,10 @@ dependencies = [ # (vulnerable OpenSSL bundled in the wheels). Floor kept at the patched minimum # so a re-resolve can't regress below it. "cryptography>=50.0.0", + # Socket Mode client for Slack webhook triggers. Its aiohttp backend reuses the + # aiohttp already pinned above; the [optional] extra is not wanted (it would pull + # websockets>=16, which conflicts with websockets~=14.2). + "slack-sdk>=3.44.1,<4", ] [dependency-groups] diff --git a/agentex/src/adapters/orm.py b/agentex/src/adapters/orm.py index a53718f8..b867d4f2 100644 --- a/agentex/src/adapters/orm.py +++ b/agentex/src/adapters/orm.py @@ -186,6 +186,12 @@ class AgentAPIKeyORM(BaseORM): name = Column(String(256), nullable=False, index=True) api_key_type = Column(SQLAlchemyEnum(AgentAPIKeyType), nullable=False) api_key = Column(String, nullable=False) + # Slack app-level token (Fernet, src/utils/credential_encryption.py); set only on + # Slack triggers whose events arrive over Socket Mode instead of HTTP. + app_token_encrypted = Column(String, nullable=True) + # The agent subpath a socket-delivered event is POSTed to. Over HTTP it is read + # from the request URL, which a socket delivery does not have. + forward_path = Column(String, nullable=True) # Indexes for efficient querying __table_args__ = ( diff --git a/agentex/src/api/app.py b/agentex/src/api/app.py index 6ce11d99..0c0871b0 100644 --- a/agentex/src/api/app.py +++ b/agentex/src/api/app.py @@ -54,6 +54,9 @@ ) from src.config.environment_variables import EnvVarKeys from src.domain.exceptions import GenericException +from src.domain.services.slack_socket_mode_bridge import ( + create_slack_socket_mode_bridge, +) from src.utils.logging import make_logger logger = make_logger(__name__) @@ -108,6 +111,15 @@ async def lifespan(_: FastAPI): if global_deps.postgres_metrics_collector: await global_deps.postgres_metrics_collector.start_collection() + if resolve_environment_variable_dependency( + EnvVarKeys.SLACK_SOCKET_MODE_ENABLED + ): + bridge = create_slack_socket_mode_bridge() + if bridge is not None: + # Pushed after the dependency shutdowns, so it runs before them. + cleanup.push_async_callback(bridge.stop) + await bridge.start() + yield diff --git a/agentex/src/api/routes/agent_api_keys.py b/agentex/src/api/routes/agent_api_keys.py index 660bd4a6..1f57b5eb 100644 --- a/agentex/src/api/routes/agent_api_keys.py +++ b/agentex/src/api/routes/agent_api_keys.py @@ -20,6 +20,7 @@ from src.domain.services.authorization_service import DAuthorizationService from src.domain.use_cases.agent_api_keys_use_case import DAgentAPIKeysUseCase from src.domain.use_cases.agents_use_case import DAgentsUseCase +from src.utils import credential_encryption from src.utils.agent_api_key_authorization import ( API_KEY_NOT_FOUND_MESSAGE, _check_api_key_or_collapse_to_404, @@ -183,12 +184,34 @@ async def create_webhook_trigger( detail="forward_path must not contain control characters.", ) + app_token_encrypted = None + if request.app_token is not None: + if request.source != AgentAPIKeyType.SLACK: + raise HTTPException( + status_code=400, + detail="app_token is only supported for Slack triggers.", + ) + if not request.app_token.startswith("xapp-"): + raise HTTPException( + status_code=400, + detail="app_token must be a Slack app-level token (xapp-...).", + ) + if not credential_encryption.is_configured(): + raise HTTPException( + status_code=503, + detail="This deployment cannot store app tokens: credential " + "encryption is not configured.", + ) + app_token_encrypted = credential_encryption.encrypt(request.app_token) + secret = request.secret if request.secret is not None else secrets.token_hex(32) agent_api_key_entity = await agent_api_key_use_case.create( agent_id=agent.id, api_key=str(secret), name=request.name, api_key_type=request.source, + app_token_encrypted=app_token_encrypted, + forward_path=forward_path if app_token_encrypted else None, ) encoded_agent_name = quote(request.agent_name, safe="") diff --git a/agentex/src/api/schemas/agent_api_keys.py b/agentex/src/api/schemas/agent_api_keys.py index d9cf4224..a63724b6 100644 --- a/agentex/src/api/schemas/agent_api_keys.py +++ b/agentex/src/api/schemas/agent_api_keys.py @@ -84,6 +84,15 @@ class CreateWebhookTriggerRequest(BaseModel): "app's webhook signing secret." ), ) + app_token: str | None = Field( + None, + description=( + "Slack only. The app's app-level token (xapp-..., scope connections:write). " + "When set, agentex receives the app's events over Socket Mode and forwards " + "them to forward_path, so the app needs no public Request URL. Stored " + "encrypted and never returned." + ), + ) base_url: str | None = Field( None, description="Optional public agentex base URL for the returned webhook_url; " diff --git a/agentex/src/config/environment_variables.py b/agentex/src/config/environment_variables.py index d49d0a25..42242c08 100644 --- a/agentex/src/config/environment_variables.py +++ b/agentex/src/config/environment_variables.py @@ -60,6 +60,7 @@ class EnvVarKeys(str, Enum): ENABLE_HEALTH_CHECK_WORKFLOW = "ENABLE_HEALTH_CHECK_WORKFLOW" ENABLE_AGENT_RUN_SCHEDULES = "ENABLE_AGENT_RUN_SCHEDULES" WEBHOOK_REQUEST_TIMEOUT = "WEBHOOK_REQUEST_TIMEOUT" + SLACK_SOCKET_MODE_ENABLED = "SLACK_SOCKET_MODE_ENABLED" RETENTION_CLEANUP_ENABLED = "RETENTION_CLEANUP_ENABLED" RETENTION_CLEANUP_AGENT_ALLOWLIST = "RETENTION_CLEANUP_AGENT_ALLOWLIST" RETENTION_CLEANUP_IDLE_DAYS = "RETENTION_CLEANUP_IDLE_DAYS" @@ -199,6 +200,8 @@ class EnvironmentVariables(BaseModel): # Gates the agent run schedules API. Off by default; enabled in development. ENABLE_AGENT_RUN_SCHEDULES: bool = False WEBHOOK_REQUEST_TIMEOUT: float = 15.0 # Webhook request timeout in seconds + # Hold Slack Socket Mode connections for Slack triggers that carry an app token. + SLACK_SOCKET_MODE_ENABLED: bool = False RETENTION_CLEANUP_ENABLED: bool = False RETENTION_CLEANUP_AGENT_ALLOWLIST: list[str] = [] RETENTION_CLEANUP_IDLE_DAYS: int = 7 @@ -317,6 +320,9 @@ def refresh(cls, force_refresh: bool = False) -> EnvironmentVariables | None: WEBHOOK_REQUEST_TIMEOUT=float( os.environ.get(EnvVarKeys.WEBHOOK_REQUEST_TIMEOUT, "15.0") ), + SLACK_SOCKET_MODE_ENABLED=_parse_bool_env( + EnvVarKeys.SLACK_SOCKET_MODE_ENABLED, default=False + ), RETENTION_CLEANUP_ENABLED=_parse_bool_env( EnvVarKeys.RETENTION_CLEANUP_ENABLED, default=False ), diff --git a/agentex/src/domain/entities/agent_api_keys.py b/agentex/src/domain/entities/agent_api_keys.py index cc4c839b..c774cf01 100644 --- a/agentex/src/domain/entities/agent_api_keys.py +++ b/agentex/src/domain/entities/agent_api_keys.py @@ -26,3 +26,11 @@ class AgentAPIKeyEntity(BaseModel): description="The type of the API key (either internal or external)", ) api_key: str = Field(..., description="The API key") + app_token_encrypted: str | None = Field( + None, + description="Encrypted Slack app-level token; set when the trigger is served " + "over Socket Mode.", + ) + forward_path: str | None = Field( + None, description="Agent subpath a Socket Mode event is forwarded to." + ) diff --git a/agentex/src/domain/repositories/agent_api_key_repository.py b/agentex/src/domain/repositories/agent_api_key_repository.py index 9ffd1a27..c9bb7bab 100644 --- a/agentex/src/domain/repositories/agent_api_key_repository.py +++ b/agentex/src/domain/repositories/agent_api_key_repository.py @@ -1,3 +1,4 @@ +import builtins from typing import Annotated from fastapi import Depends @@ -12,6 +13,7 @@ DDatabaseAsyncReadWriteSessionMaker, ) from src.domain.entities.agent_api_keys import AgentAPIKeyEntity, AgentAPIKeyType +from src.domain.entities.agents import AgentStatus from src.utils.logging import make_logger logger = make_logger(__name__) @@ -170,6 +172,25 @@ async def get_external_by_agent_id_and_key( row = result.scalars().first() return AgentAPIKeyEntity.model_validate(row) if row else None + async def list_slack_socket_mode_triggers( + self, + ) -> builtins.list[AgentAPIKeyEntity]: + """Slack triggers that carry an app token, on agents that are not deleted.""" + async with self.start_async_db_session(allow_writes=False) as session: + query = ( + select(AgentAPIKeyORM) + .join(AgentORM, AgentORM.id == AgentAPIKeyORM.agent_id) + .where( + AgentAPIKeyORM.api_key_type == AgentAPIKeyType.SLACK, + AgentAPIKeyORM.app_token_encrypted.is_not(None), + AgentORM.status != AgentStatus.DELETED, + ) + ) + result = await session.execute(query) + return [ + AgentAPIKeyEntity.model_validate(row) for row in result.scalars().all() + ] + async def delete_by_agent_name_and_key_name( self, agent_name: str, key_name: str, api_key_type: AgentAPIKeyType ) -> None: diff --git a/agentex/src/domain/services/slack_socket_mode_bridge.py b/agentex/src/domain/services/slack_socket_mode_bridge.py new file mode 100644 index 00000000..31175584 --- /dev/null +++ b/agentex/src/domain/services/slack_socket_mode_bridge.py @@ -0,0 +1,330 @@ +"""Receive Slack webhook-trigger events over Socket Mode instead of HTTP. + +A Slack trigger registered with an app-level token gets one Socket Mode connection +per API process. Slack spreads an app's events across its open connections (at most +10 per app) and delivers each envelope to one of them, so every process can hold a +connection without duplicating work. Each ``events_api`` envelope is forwarded to +the agent exactly as ``/agents/forward`` would forward the HTTP delivery, and acked +only once the agent has accepted it: an unacked envelope is redelivered by Slack, +which is the retry path when an agent is slow or down. + +A Slack app must be owned by exactly one Socket Mode client. If an agent (or another +agentex environment) also holds a socket for the same app, Slack splits the events +between them. +""" + +from __future__ import annotations + +import asyncio +import json +from dataclasses import dataclass +from functools import partial +from typing import Any + +import httpx +from slack_sdk.errors import SlackApiError +from slack_sdk.socket_mode.aiohttp import SocketModeClient +from slack_sdk.socket_mode.request import SocketModeRequest +from slack_sdk.socket_mode.response import SocketModeResponse + +from src.adapters.crud_store.exceptions import ItemDoesNotExist +from src.config.dependencies import ( + database_async_read_only_session_maker, + database_async_read_write_engine, + database_async_read_write_session_maker, + httpx_client, +) +from src.domain.entities.agent_api_keys import AgentAPIKeyEntity +from src.domain.entities.agents import AgentStatus +from src.domain.repositories.agent_api_key_repository import AgentAPIKeyRepository +from src.domain.repositories.agent_repository import AgentRepository +from src.utils import credential_encryption +from src.utils.acp_url import resolve_acp_url +from src.utils.logging import make_logger + +logger = make_logger(__name__) + +# Slack expects an ack within 3s; leave headroom for the ack frame itself. +ACK_DEADLINE_SECONDS = 2.5 +REFRESH_INTERVAL_SECONDS = 60.0 + +# apps.connections.open errors that no retry can fix. +REJECTED_TOKEN_ERRORS = frozenset( + { + "invalid_auth", + "token_revoked", + "account_inactive", + "not_allowed_token_type", + "not_authed", + "token_expired", + } +) + + +class AppTokenRejected(Exception): + """Slack refused the app token; the connection for it has been stopped.""" + + +class _TriggerSocketModeClient(SocketModeClient): + def __init__(self, trigger: AgentAPIKeyEntity, **kwargs: Any) -> None: + super().__init__(**kwargs) + self.trigger = trigger + self.rejected = False + + async def issue_new_wss_url(self) -> str: + # Overridden rather than wrapped: slack_sdk also calls this on every + # reconnect, and on a revoked token its connect/monitor loops would retry + # (and log a traceback) every few seconds forever. + try: + response = await self.web_client.apps_connections_open( + app_token=self.app_token + ) + except SlackApiError as exc: + error = exc.response.get("error") + if error in REJECTED_TOKEN_ERRORS: + # slack_sdk's loops all run `while not self.closed`. + self.closed = True + self.auto_reconnect_enabled = False + self.rejected = True + logger.error( + "Slack rejected the app token for Socket Mode trigger %s " + "(app %s, agent %s): %s. Not reconnecting until the trigger is " + "re-registered with a new token.", + self.trigger.id, + self.trigger.name, + self.trigger.agent_id, + error, + ) + raise AppTokenRejected(error) from exc + raise + return response["url"] + + +@dataclass +class _Connection: + app_token_encrypted: str + client: _TriggerSocketModeClient + # Held so the task isn't garbage-collected while connect() is still retrying. + connect_task: asyncio.Task + + +class SlackSocketModeBridge: + def __init__( + self, + agent_api_key_repository: AgentAPIKeyRepository, + agent_repository: AgentRepository, + http_client: httpx.AsyncClient, + ): + self._agent_api_key_repo = agent_api_key_repository + self._agent_repo = agent_repository + self._http_client = http_client + self._connections: dict[str, _Connection] = {} + # (trigger id, ciphertext) pairs whose token is known bad. Keyed on the + # ciphertext so a re-registered token is tried again. + self._rejected: set[tuple[str, str]] = set() + self._task: asyncio.Task | None = None + + async def start(self) -> None: + if self._task is None: + self._task = asyncio.create_task(self._run()) + + async def stop(self) -> None: + if self._task is not None: + self._task.cancel() + try: + await self._task + except asyncio.CancelledError: + pass + self._task = None + for trigger_id in list(self._connections): + await self._close(trigger_id) + + async def _run(self) -> None: + while True: + try: + await self.refresh() + except Exception: + logger.exception("Refreshing Slack Socket Mode triggers failed") + await asyncio.sleep(REFRESH_INTERVAL_SECONDS) + + async def refresh(self) -> None: + """Open connections for new triggers and close them for removed ones.""" + triggers = { + t.id: t + for t in await self._agent_api_key_repo.list_slack_socket_mode_triggers() + } + for trigger_id, connection in list(self._connections.items()): + trigger = triggers.get(trigger_id) + if ( + trigger is None + or trigger.app_token_encrypted != connection.app_token_encrypted + or connection.client.closed + ): + if connection.client.rejected: + self._rejected.add((trigger_id, connection.app_token_encrypted)) + await self._close(trigger_id) + for trigger in triggers.values(): + if trigger.id in self._connections: + continue + if (trigger.id, trigger.app_token_encrypted) in self._rejected: + continue + await self._open(trigger) + + async def _open(self, trigger: AgentAPIKeyEntity) -> None: + assert trigger.app_token_encrypted + try: + app_token = credential_encryption.decrypt(trigger.app_token_encrypted) + except credential_encryption.CredentialEncryptionError as exc: + logger.error( + "Cannot read the app token for Slack Socket Mode trigger %s: %s", + trigger.id, + exc, + ) + self._rejected.add((trigger.id, trigger.app_token_encrypted)) + return + + client = _TriggerSocketModeClient(trigger=trigger, app_token=app_token) + client.socket_mode_request_listeners.append(partial(self._on_request, trigger)) + try: + # Called once up front so a rejected token stops here instead of + # inside connect()'s retry loop; connect() reuses the URL. + client.wss_uri = await client.issue_new_wss_url() + except AppTokenRejected: + self._rejected.add((trigger.id, trigger.app_token_encrypted)) + await client.close() + return + except Exception as exc: + # Transient (network, rate limit): connect() fetches a URL and retries. + logger.warning( + "Opening Slack Socket Mode for trigger %s failed (%s); retrying", + trigger.id, + type(exc).__name__, + ) + self._connections[trigger.id] = _Connection( + app_token_encrypted=trigger.app_token_encrypted, + client=client, + connect_task=asyncio.create_task(client.connect()), + ) + logger.info( + "Slack Socket Mode connecting for trigger %s (app %s, agent %s)", + trigger.id, + trigger.name, + trigger.agent_id, + ) + + async def _close(self, trigger_id: str) -> None: + connection = self._connections.pop(trigger_id) + connection.connect_task.cancel() + try: + await connection.client.close() + except Exception: + logger.exception( + "Closing Slack Socket Mode connection for trigger %s failed", + trigger_id, + ) + + async def _on_request( + self, + trigger: AgentAPIKeyEntity, + client: SocketModeClient, + request: SocketModeRequest, + ) -> None: + if request.type != "events_api": + # Interactivity and slash commands have no HTTP forward equivalent on + # a webhook trigger; leaving them unacked surfaces the gap to the user. + logger.warning( + "Ignoring Slack Socket Mode %s envelope for trigger %s", + request.type, + trigger.id, + ) + return + if await self.forward_event( + trigger, + request.payload, + retry_attempt=request.retry_attempt, + retry_reason=request.retry_reason, + ): + await client.send_socket_mode_response( + SocketModeResponse(envelope_id=request.envelope_id) + ) + + async def forward_event( + self, + trigger: AgentAPIKeyEntity, + payload: dict, + retry_attempt: int | None, + retry_reason: str | None, + ) -> bool: + """POST an Events API payload to the trigger's agent route. + + Returns whether the agent accepted it (2xx) within the ack deadline; the + caller acks only then, so anything else is redelivered by Slack. + """ + headers = {"content-type": "application/json"} + # Over HTTP Slack sends these only on redeliveries; the first delivery + # over a socket has retry_attempt 0. + if retry_attempt: + headers["x-slack-retry-num"] = str(retry_attempt) + if retry_reason: + headers["x-slack-retry-reason"] = retry_reason + try: + async with asyncio.timeout(ACK_DEADLINE_SECONDS): + agent = await self._agent_repo.get(id=trigger.agent_id) + if agent.status == AgentStatus.DELETED or not agent.acp_url: + logger.warning( + "Slack Socket Mode trigger %s: agent %s is deleted or has " + "no ACP URL", + trigger.id, + trigger.agent_id, + ) + return False + url = ( + f"{resolve_acp_url(agent.acp_url)}/" + f"{(trigger.forward_path or '').lstrip('/')}" + ) + response = await self._http_client.post( + url, content=json.dumps(payload).encode(), headers=headers + ) + except (TimeoutError, httpx.HTTPError, ItemDoesNotExist) as exc: + logger.warning( + "Forwarding Slack Socket Mode event for trigger %s failed (%s); " + "leaving it unacked for redelivery", + trigger.id, + type(exc).__name__, + ) + return False + if not response.is_success: + logger.warning( + "Agent %s answered %s to a Slack Socket Mode event for trigger %s; " + "leaving it unacked for redelivery", + trigger.agent_id, + response.status_code, + trigger.id, + ) + return False + return True + + +def create_slack_socket_mode_bridge() -> SlackSocketModeBridge | None: + """Build the bridge from the global dependencies, or None if it can't run. + + App tokens are stored encrypted, so without the encryption key no trigger can + be served; refuse once here rather than failing per trigger. + """ + if not credential_encryption.is_configured(): + logger.error( + "SLACK_SOCKET_MODE_ENABLED is set but %s is not configured; Slack " + "Socket Mode is disabled.", + credential_encryption.ENV_KEY, + ) + return None + engine = database_async_read_write_engine() + rw_session_maker = database_async_read_write_session_maker(engine) + ro_session_maker = database_async_read_only_session_maker(engine) + return SlackSocketModeBridge( + agent_api_key_repository=AgentAPIKeyRepository( + rw_session_maker, ro_session_maker + ), + agent_repository=AgentRepository(rw_session_maker, ro_session_maker), + http_client=httpx_client(), + ) diff --git a/agentex/src/domain/use_cases/agent_api_keys_use_case.py b/agentex/src/domain/use_cases/agent_api_keys_use_case.py index ccea009d..bd759970 100644 --- a/agentex/src/domain/use_cases/agent_api_keys_use_case.py +++ b/agentex/src/domain/use_cases/agent_api_keys_use_case.py @@ -107,6 +107,8 @@ async def create( agent_id: str, api_key_type: AgentAPIKeyType, api_key: str, + app_token_encrypted: str | None = None, + forward_path: str | None = None, ) -> AgentAPIKeyEntity: agent = await self.get_agent(agent_id=agent_id) if not agent: @@ -130,6 +132,8 @@ async def create( agent_id=agent.id, api_key_type=api_key_type, api_key=api_key, + app_token_encrypted=app_token_encrypted, + forward_path=forward_path, ) return await self.agent_api_key_repo.create(item=agent_api_key) diff --git a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py new file mode 100644 index 00000000..631b3468 --- /dev/null +++ b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py @@ -0,0 +1,133 @@ +"""Ack and reconnect behaviour of the Slack Socket Mode bridge.""" + +import asyncio +from unittest.mock import AsyncMock, MagicMock + +import httpx +import pytest +from slack_sdk.errors import SlackApiError +from slack_sdk.socket_mode.request import SocketModeRequest +from slack_sdk.web.async_client import AsyncWebClient +from src.domain.entities.agent_api_keys import AgentAPIKeyEntity, AgentAPIKeyType +from src.domain.entities.agents import AgentStatus +from src.domain.services import slack_socket_mode_bridge as mod +from src.domain.services.slack_socket_mode_bridge import SlackSocketModeBridge + +TRIGGER = AgentAPIKeyEntity( + id="key-1", + agent_id="agent-1", + name="A123", + api_key_type=AgentAPIKeyType.SLACK, + api_key="signing-secret", + app_token_encrypted="ciphertext", + forward_path="slack/events", +) + + +def _bridge(handler) -> tuple[SlackSocketModeBridge, MagicMock]: + agent_repo = MagicMock() + agent_repo.get = AsyncMock( + return_value=MagicMock(status=AgentStatus.READY, acp_url="http://agent:8000") + ) + key_repo = MagicMock() + key_repo.list_slack_socket_mode_triggers = AsyncMock(return_value=[TRIGGER]) + bridge = SlackSocketModeBridge( + agent_api_key_repository=key_repo, + agent_repository=agent_repo, + http_client=httpx.AsyncClient(transport=httpx.MockTransport(handler)), + ) + return bridge, key_repo + + +def _envelope(retry_attempt: int = 0, retry_reason: str = "") -> SocketModeRequest: + return SocketModeRequest( + type="events_api", + envelope_id="env-1", + payload={"type": "event_callback", "api_app_id": "A123"}, + retry_attempt=retry_attempt, + retry_reason=retry_reason, + ) + + +@pytest.mark.unit +class TestEnvelopeAck: + async def test_acks_after_agent_accepts(self): + seen: list[httpx.Request] = [] + + def handler(request: httpx.Request) -> httpx.Response: + seen.append(request) + return httpx.Response(200) + + bridge, _ = _bridge(handler) + client = MagicMock(send_socket_mode_response=AsyncMock()) + + await bridge._on_request(TRIGGER, client, _envelope()) + + assert str(seen[0].url) == "http://agent:8000/slack/events" + assert "x-slack-retry-num" not in seen[0].headers + client.send_socket_mode_response.assert_awaited_once() + assert client.send_socket_mode_response.await_args.args[0].envelope_id == ( + "env-1" + ) + + async def test_no_ack_when_agent_rejects(self): + bridge, _ = _bridge(lambda request: httpx.Response(503)) + client = MagicMock(send_socket_mode_response=AsyncMock()) + + await bridge._on_request(TRIGGER, client, _envelope()) + + client.send_socket_mode_response.assert_not_awaited() + + async def test_no_ack_when_agent_misses_deadline(self, monkeypatch): + monkeypatch.setattr(mod, "ACK_DEADLINE_SECONDS", 0.05) + + async def slow(request: httpx.Request) -> httpx.Response: + await asyncio.sleep(1) + return httpx.Response(200) + + bridge, _ = _bridge(slow) + client = MagicMock(send_socket_mode_response=AsyncMock()) + + await bridge._on_request(TRIGGER, client, _envelope()) + + client.send_socket_mode_response.assert_not_awaited() + + async def test_retry_attempt_becomes_retry_headers(self): + seen: list[httpx.Request] = [] + + def handler(request: httpx.Request) -> httpx.Response: + seen.append(request) + return httpx.Response(200) + + bridge, _ = _bridge(handler) + client = MagicMock(send_socket_mode_response=AsyncMock()) + + await bridge._on_request( + TRIGGER, client, _envelope(retry_attempt=2, retry_reason="timeout") + ) + + assert seen[0].headers["x-slack-retry-num"] == "2" + assert seen[0].headers["x-slack-retry-reason"] == "timeout" + + +@pytest.mark.unit +class TestRejectedToken: + async def test_rejected_token_stops_without_retrying(self, monkeypatch): + monkeypatch.setattr(mod.credential_encryption, "decrypt", lambda _: "xapp-1") + connections_open = AsyncMock( + side_effect=SlackApiError( + "rejected", {"ok": False, "error": "invalid_auth"} + ) + ) + monkeypatch.setattr(AsyncWebClient, "apps_connections_open", connections_open) + connect = AsyncMock() + monkeypatch.setattr(mod._TriggerSocketModeClient, "connect", connect) + bridge, _ = _bridge(lambda request: httpx.Response(200)) + + await bridge.refresh() + # A later refresh with the same stored token must not try it again. + await bridge.refresh() + + connections_open.assert_awaited_once() + connect.assert_not_awaited() + assert bridge._connections == {} diff --git a/uv.lock b/uv.lock index c9be1692..ef9f9ce5 100644 --- a/uv.lock +++ b/uv.lock @@ -30,15 +30,15 @@ name = "agentex" version = "0.1.0" source = { virtual = "." } dependencies = [ - { name = "agentex-sdk" }, - { name = "temporalio" }, + { name = "agentex-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "temporalio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] [package.dev-dependencies] dev = [ - { name = "httpx", extra = ["http2"] }, - { name = "pre-commit" }, - { name = "ruff" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pre-commit", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "ruff", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] [package.metadata] @@ -59,62 +59,63 @@ name = "agentex-backend" version = "0.1.0" source = { editable = "agentex" } dependencies = [ - { name = "aiodocker" }, - { name = "aiohttp" }, - { name = "alembic" }, - { name = "asyncpg" }, - { name = "cryptography" }, - { name = "datadog" }, - { name = "ddtrace" }, - { name = "docker" }, - { name = "fastapi" }, - { name = "httpx", extra = ["http2"] }, - { name = "json-log-formatter" }, - { name = "kubernetes-asyncio" }, - { name = "litellm" }, - { name = "opentelemetry-api" }, - { name = "opentelemetry-exporter-otlp" }, - { name = "opentelemetry-sdk" }, - { name = "psycopg2-binary" }, - { name = "pymongo" }, - { name = "python-dotenv" }, - { name = "python-multipart" }, - { name = "pyyaml" }, - { name = "redis" }, - { name = "sqlalchemy" }, - { name = "temporalio" }, - { name = "tzdata" }, - { name = "uvicorn", extra = ["standard"] }, - { name = "websockets" }, + { name = "aiodocker", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "aiohttp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "alembic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "asyncpg", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "cryptography", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "datadog", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "ddtrace", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "docker", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "fastapi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "json-log-formatter", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "kubernetes-asyncio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "litellm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-exporter-otlp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "psycopg2-binary", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pymongo", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-multipart", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "redis", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "slack-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "sqlalchemy", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "temporalio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tzdata", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "uvicorn", extra = ["standard"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "websockets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] [package.dev-dependencies] dev = [ - { name = "agentex-sdk" }, - { name = "pre-commit" }, - { name = "pytest" }, - { name = "pytest-asyncio" }, - { name = "pytest-cov" }, - { name = "ruff" }, - { name = "vulture" }, + { name = "agentex-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pre-commit", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pytest-asyncio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pytest-cov", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "ruff", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "vulture", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] dev-no-docker = [ - { name = "greenlet" }, - { name = "pgserver" }, - { name = "redislite" }, + { name = "greenlet", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pgserver", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "redislite", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] test = [ - { name = "asyncpg" }, - { name = "factory-boy" }, - { name = "greenlet" }, - { name = "httpx", extra = ["http2"] }, - { name = "httpx2" }, - { name = "pgserver" }, - { name = "pytest" }, - { name = "pytest-asyncio" }, - { name = "pytest-cov" }, - { name = "redislite" }, - { name = "testcontainers" }, + { name = "asyncpg", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "factory-boy", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "greenlet", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx2", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pgserver", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pytest-asyncio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pytest-cov", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "redislite", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "testcontainers", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] [package.metadata] @@ -141,6 +142,7 @@ requires-dist = [ { name = "python-multipart", specifier = ">=0.0.32" }, { name = "pyyaml", specifier = ">=6.0,<7" }, { name = "redis", specifier = ">=5.1.0,<6" }, + { name = "slack-sdk", specifier = ">=3.44.1,<4" }, { name = "sqlalchemy", specifier = ">=2.0.35,<3" }, { name = "temporalio", specifier = ">=1.18.0,<2" }, { name = "tzdata", specifier = ">=2025.2" }, @@ -182,47 +184,47 @@ name = "agentex-sdk" version = "0.9.4" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "aiohttp" }, - { name = "anthropic" }, - { name = "anyio" }, + { name = "aiohttp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anthropic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, { name = "claude-agent-sdk", version = "0.1.48", source = { registry = "https://pypi.org/simple" }, marker = "sys_platform == 'linux'" }, - { name = "claude-agent-sdk", version = "0.1.49", source = { registry = "https://pypi.org/simple" }, marker = "sys_platform != 'linux'" }, - { name = "cloudpickle" }, - { name = "datadog" }, - { name = "ddtrace" }, - { name = "distro" }, - { name = "fastapi" }, - { name = "httpx", extra = ["http2"] }, - { name = "ipykernel" }, - { name = "jinja2" }, - { name = "json-log-formatter" }, - { name = "jsonref" }, - { name = "jsonschema" }, - { name = "kubernetes" }, - { name = "langgraph-checkpoint" }, - { name = "litellm" }, - { name = "mcp", extra = ["cli"] }, - { name = "openai" }, - { name = "openai-agents" }, - { name = "pydantic" }, - { name = "pytest" }, - { name = "pytest-asyncio" }, - { name = "python-on-whales" }, - { name = "pyyaml" }, - { name = "questionary" }, - { name = "redis" }, - { name = "rich" }, - { name = "scale-gp" }, - { name = "scale-gp-beta" }, - { name = "sniffio" }, - { name = "temporalio" }, - { name = "typer" }, - { name = "typing-extensions" }, - { name = "tzdata" }, - { name = "tzlocal" }, - { name = "uvicorn" }, - { name = "watchfiles" }, - { name = "yaspin" }, + { name = "claude-agent-sdk", version = "0.1.49", source = { registry = "https://pypi.org/simple" }, marker = "sys_platform == 'darwin'" }, + { name = "cloudpickle", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "datadog", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "ddtrace", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "distro", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "fastapi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "ipykernel", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jinja2", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "json-log-formatter", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jsonref", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jsonschema", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "kubernetes", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "langgraph-checkpoint", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "litellm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "mcp", extra = ["cli"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "openai", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "openai-agents", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pytest-asyncio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-on-whales", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "questionary", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "redis", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "rich", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "scale-gp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "scale-gp-beta", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "sniffio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "temporalio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typer", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tzdata", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tzlocal", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "uvicorn", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "watchfiles", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "yaspin", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/3f/e9/f5d81d87e0f743ffab3aac0477db21eba31d740bb28434e7836e0231c53a/agentex_sdk-0.9.4.tar.gz", hash = "sha256:dd5133c8bc878c006063cc9504a409a40e1683200fa5a02f692f5466676f44a8", size = 879600, upload-time = "2026-02-18T18:00:17.317Z" } wheels = [ @@ -234,7 +236,7 @@ name = "aiodocker" version = "0.23.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "aiohttp" }, + { name = "aiohttp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/78/cb/c0fa4944604a182db4c062fea84fbdd77d2e508932dd0052ec784040ac13/aiodocker-0.23.0.tar.gz", hash = "sha256:45ede291063c7d1c24e78a766013c25e85b354a3bdcca68fe2bca64348e4dee2", size = 135218, upload-time = "2024-09-23T04:52:54.975Z" } wheels = [ @@ -255,14 +257,14 @@ name = "aiohttp" version = "3.14.5" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "aiohappyeyeballs" }, - { name = "aiosignal" }, - { name = "attrs" }, - { name = "frozenlist" }, - { name = "multidict" }, - { name = "propcache" }, - { name = "typing-extensions" }, - { name = "yarl" }, + { name = "aiohappyeyeballs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "aiosignal", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "attrs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "frozenlist", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "multidict", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "propcache", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "yarl", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/6c/4c/bdccd81e9ee225b69c60e7766c9a5b05364f118f4d383713b89a682d772d/aiohttp-3.14.5.tar.gz", hash = "sha256:5558a7f5a05af9ecf744af91e5baefc436f93c9333e656c27ec253f9a6bbe178", size = 8078052, upload-time = "2026-10-11T01:05:12.408Z" } wheels = [ @@ -289,8 +291,8 @@ name = "aiosignal" version = "1.4.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "frozenlist" }, - { name = "typing-extensions" }, + { name = "frozenlist", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/61/62/06741b579156360248d1ec624842ad0edf697050bbaf7c3e46394e106ad1/aiosignal-1.4.0.tar.gz", hash = "sha256:f47eecd9468083c2029cc99945502cb7708b082c232f9aca65da147157b251c7", size = 25007, upload-time = "2025-07-03T22:54:43.528Z" } wheels = [ @@ -302,9 +304,9 @@ name = "alembic" version = "1.16.5" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "mako" }, - { name = "sqlalchemy" }, - { name = "typing-extensions" }, + { name = "mako", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "sqlalchemy", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/9a/ca/4dc52902cf3491892d464f5265a81e9dff094692c8a049a3ed6a05fe7ee8/alembic-1.16.5.tar.gz", hash = "sha256:a88bb7f6e513bd4301ecf4c7f2206fe93f9913f9b48dac3b78babde2d6fe765e", size = 1969868, upload-time = "2025-08-27T18:02:05.668Z" } wheels = [ @@ -334,14 +336,14 @@ name = "anthropic" version = "0.85.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio" }, - { name = "distro" }, - { name = "docstring-parser" }, - { name = "httpx", extra = ["http2"] }, - { name = "jiter" }, - { name = "pydantic" }, - { name = "sniffio" }, - { name = "typing-extensions" }, + { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "distro", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "docstring-parser", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jiter", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "sniffio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/c5/08/c620a0eb8625539a8ea9f5a6e06f13d131be0bc8b5b714c235d4b25dd1b5/anthropic-0.85.0.tar.gz", hash = "sha256:d45b2f38a1efb1a5d15515a426b272179a0d18783efa2bb4c3925fa773eb50b9", size = 542034, upload-time = "2026-03-16T17:00:44.324Z" } wheels = [ @@ -353,8 +355,8 @@ name = "anyio" version = "4.14.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "idna" }, - { name = "typing-extensions" }, + { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/61/cc/a381afa6efea9f496eff839d4a6a1aed3bfafc7b3ab4b0d1b243a12573dd/anyio-4.14.2.tar.gz", hash = "sha256:cfa139f3ed1a23ee8f88a145ddb5ac7605b8bbfd8592baacd7ce3d8bb4313c7f", size = 260176, upload-time = "2026-07-12T20:29:07.082Z" } wheels = [ @@ -434,7 +436,7 @@ name = "cffi" version = "2.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pycparser", marker = "implementation_name != 'PyPy'" }, + { name = "pycparser", marker = "(implementation_name != 'PyPy' and sys_platform == 'darwin') or (implementation_name != 'PyPy' and sys_platform == 'linux')" }, ] sdist = { url = "https://files.pythonhosted.org/packages/eb/56/b1ba7935a17738ae8453301356628e8147c79dbb825bcbc73dc7401f9846/cffi-2.0.0.tar.gz", hash = "sha256:44d1b5909021139fe36001ae048dbdde8214afa20200eda0f64c068cac5d5529", size = 523588, upload-time = "2025-09-08T23:24:04.541Z" } wheels = [ @@ -484,8 +486,8 @@ resolution-markers = [ "sys_platform == 'linux'", ] dependencies = [ - { name = "anyio" }, - { name = "mcp" }, + { name = "anyio", marker = "sys_platform == 'linux'" }, + { name = "mcp", marker = "sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/6c/dd/2818538efd18ed4ef72d4775efa75bb36cbea0fa418eda51df85ee9c2424/claude_agent_sdk-0.1.48.tar.gz", hash = "sha256:ee294d3f02936c0b826119ffbefcf88c67731cf8c2d2cb7111ccc97f76344272", size = 87375, upload-time = "2026-03-07T00:21:37.087Z" } wheels = [ @@ -501,8 +503,8 @@ resolution-markers = [ "sys_platform == 'darwin'", ] dependencies = [ - { name = "anyio" }, - { name = "mcp" }, + { name = "anyio", marker = "sys_platform == 'darwin'" }, + { name = "mcp", marker = "sys_platform == 'darwin'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/03/cf/2bd8d55bab57e458044a5e530a2320fecfcc91ec5546972b2c3db15fd09a/claude_agent_sdk-0.1.49.tar.gz", hash = "sha256:6a93f7e51951623d94c0b35172d1d25d7c44f8dd083568d3252a6ed3ac8719bf", size = 95079, upload-time = "2026-03-20T17:31:09.274Z" } wheels = [ @@ -570,7 +572,7 @@ name = "cryptography" version = "50.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "cffi", marker = "platform_python_implementation != 'PyPy'" }, + { name = "cffi", marker = "(platform_python_implementation != 'PyPy' and sys_platform == 'darwin') or (platform_python_implementation != 'PyPy' and sys_platform == 'linux')" }, ] sdist = { url = "https://files.pythonhosted.org/packages/de/41/6cbdcf9142d00fe82836fbb51e503e58088575cf7a0fe1dbff6695bf0840/cryptography-50.0.0.tar.gz", hash = "sha256:eeac2acb5a20ed25e0ad6d1df9891a520b78b404266b6d11778f25d5d691a6c9", size = 880201, upload-time = "2026-07-31T14:25:10.11Z" } wheels = [ @@ -605,7 +607,7 @@ name = "datadog" version = "0.52.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "requests" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/a9/e6/ec5e4b4dbecd63cecae94009ef6dde9ab421d7d0022e6027586cc3776921/datadog-0.52.1.tar.gz", hash = "sha256:44c6deb563c4522dba206fba2e2bb93d3b04113c40191851ba3a241d82b5fd0b", size = 368037, upload-time = "2025-07-31T15:49:43.425Z" } wheels = [ @@ -617,11 +619,11 @@ name = "ddtrace" version = "4.15.6" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "bytecode" }, - { name = "ddtrace-internal" }, - { name = "envier" }, - { name = "opentelemetry-api" }, - { name = "wrapt" }, + { name = "bytecode", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "ddtrace-internal", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "envier", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "wrapt", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/f6/94/f0f005257dc49a7062c6fed98a6dbcca7691e9d1db5c64e8a2d14f204cac/ddtrace-4.15.6.tar.gz", hash = "sha256:2914f646d4ae338c644b814c4ad80c963e7aadfb39d1e67b0367a15d5c4bc0db", size = 2655968, upload-time = "2026-10-08T09:46:58.392Z" } wheels = [ @@ -694,8 +696,8 @@ name = "docker" version = "7.1.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "requests" }, - { name = "urllib3" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/91/9b/4a2ea29aeba62471211598dac5d96825bb49348fa07e906ea930394a83ce/docker-7.1.0.tar.gz", hash = "sha256:ad8c70e6e3f8926cb8a92619b832b4ea5299e2831c14284663184e200546fa6c", size = 117834, upload-time = "2024-05-23T11:13:57.216Z" } wheels = [ @@ -734,7 +736,7 @@ name = "factory-boy" version = "3.3.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "faker" }, + { name = "faker", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/ba/98/75cacae9945f67cfe323829fc2ac451f64517a8a330b572a06a323997065/factory_boy-3.3.3.tar.gz", hash = "sha256:866862d226128dfac7f2b4160287e899daf54f2612778327dd03d0e2cb1e3d03", size = 164146, upload-time = "2025-02-03T09:49:04.433Z" } wheels = [ @@ -746,7 +748,7 @@ name = "faker" version = "37.8.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "tzdata" }, + { name = "tzdata", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/3a/da/1336008d39e5d4076dddb4e0f3a52ada41429274bf558a3cc28030d324a3/faker-37.8.0.tar.gz", hash = "sha256:090bb5abbec2b30949a95ce1ba6b20d1d0ed222883d63483a0d4be4a970d6fb8", size = 1912113, upload-time = "2025-09-15T20:24:13.592Z" } wheels = [ @@ -758,11 +760,11 @@ name = "fastapi" version = "0.136.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "annotated-doc" }, - { name = "pydantic" }, - { name = "starlette" }, - { name = "typing-extensions" }, - { name = "typing-inspection" }, + { name = "annotated-doc", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "starlette", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-inspection", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/81/2d/ff8d91d7b564d464629a0fd50a4489c97fcb836ac230bf3a7269232a9b1f/fastapi-0.136.3.tar.gz", hash = "sha256:e487fae93ad408e6f47641ee4dfe389864fd7bec92e547ea8498fc13f43e83ab", size = 396410, upload-time = "2026-05-23T18:53:15.192Z" } wheels = [ @@ -842,9 +844,9 @@ name = "google-auth" version = "2.40.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "cachetools" }, - { name = "pyasn1-modules" }, - { name = "rsa" }, + { name = "cachetools", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyasn1-modules", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "rsa", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/9e/9b/e92ef23b84fa10a64ce4831390b7a4c2e53c0132568d99d4ae61d04c8855/google_auth-2.40.3.tar.gz", hash = "sha256:500c3a29adedeb36ea9cf24b8d10858e152f2412e3ca37829b3fa18e33d63b77", size = 281029, upload-time = "2025-06-04T18:04:57.577Z" } wheels = [ @@ -856,7 +858,7 @@ name = "googleapis-common-protos" version = "1.72.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "protobuf" }, + { name = "protobuf", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/e5/7b/adfd75544c415c487b33061fe7ae526165241c1ea133f9a9125a56b39fd8/googleapis_common_protos-1.72.0.tar.gz", hash = "sha256:e55a601c1b32b52d7a3e65f43563e2aa61bcd737998ee672ac9b951cd49319f5", size = 147433, upload-time = "2025-11-06T18:29:24.087Z" } wheels = [ @@ -886,7 +888,7 @@ name = "griffe" version = "1.14.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "colorama" }, + { name = "colorama", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/ec/d7/6c09dd7ce4c7837e4cdb11dce980cb45ae3cd87677298dc3b781b6bce7d3/griffe-1.14.0.tar.gz", hash = "sha256:9d2a15c1eca966d68e00517de5d69dd1bc5c9f2335ef6c1775362ba5b8651a13", size = 424684, upload-time = "2025-09-05T15:02:29.167Z" } wheels = [ @@ -898,7 +900,7 @@ name = "grpcio" version = "1.76.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/b6/e0/318c1ce3ae5a17894d5791e87aea147587c9e702f24122cc7a5c8bbaeeb1/grpcio-1.76.0.tar.gz", hash = "sha256:7be78388d6da1a25c0d5ec506523db58b18be22d9c37d8d3a32c08be4987bd73", size = 12785182, upload-time = "2025-10-21T16:23:12.106Z" } wheels = [ @@ -926,8 +928,8 @@ name = "h2" version = "4.4.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "hpack" }, - { name = "hyperframe" }, + { name = "hpack", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "hyperframe", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/e7/85/7c366e69d84c17bb778fe41419e1fbcce3033d5b7ce29bbffff0a98b859f/h2-4.4.1.tar.gz", hash = "sha256:4e866ffb1a869ae14dd9b5e6beb5c24a13da0495ad72b65925ded182521c1516", size = 2157281, upload-time = "2026-08-03T11:45:09.509Z" } wheels = [ @@ -962,8 +964,8 @@ name = "httpcore" version = "1.0.9" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "certifi" }, - { name = "h11" }, + { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "h11", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" } wheels = [ @@ -975,8 +977,8 @@ name = "httpcore2" version = "2.4.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "h11" }, - { name = "truststore" }, + { name = "h11", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "truststore", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/7b/9b/2b1d1833a58236d1f6ee755e027a3917da0db59cc9708554cefc440ee8b6/httpcore2-2.4.0.tar.gz", hash = "sha256:3093a8ab8980d9f910b9cb4351df9186a0ad2350a6284a9107ac9a362a584422", size = 64618, upload-time = "2026-06-11T06:35:53.425Z" } wheels = [ @@ -1002,10 +1004,10 @@ name = "httpx" version = "0.28.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio" }, - { name = "certifi" }, - { name = "httpcore" }, - { name = "idna" }, + { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpcore", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" } wheels = [ @@ -1014,7 +1016,7 @@ wheels = [ [package.optional-dependencies] http2 = [ - { name = "h2" }, + { name = "h2", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] [[package]] @@ -1031,11 +1033,11 @@ name = "httpx2" version = "2.4.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio" }, - { name = "httpcore2" }, - { name = "idna" }, - { name = "truststore" }, - { name = "typing-extensions" }, + { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpcore2", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "truststore", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/fc/60/b43ced4ccf26e95b396dbf67051d3e5042b645917d4da0469dd82a3bdd4f/httpx2-2.4.0.tar.gz", hash = "sha256:32e0734b61eb0824b3f56a9e98d6d92d381a3ef12c0045aa917ee63df6c411ef", size = 81691, upload-time = "2026-06-11T06:35:54.538Z" } wheels = [ @@ -1047,14 +1049,14 @@ name = "huggingface-hub" version = "0.35.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "filelock" }, - { name = "fsspec" }, - { name = "hf-xet", marker = "platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'arm64' or platform_machine == 'x86_64'" }, - { name = "packaging" }, - { name = "pyyaml" }, - { name = "requests" }, - { name = "tqdm" }, - { name = "typing-extensions" }, + { name = "filelock", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "fsspec", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "hf-xet", marker = "(platform_machine == 'aarch64' and sys_platform == 'darwin') or (platform_machine == 'amd64' and sys_platform == 'darwin') or (platform_machine == 'arm64' and sys_platform == 'darwin') or (platform_machine == 'x86_64' and sys_platform == 'darwin') or (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'amd64' and sys_platform == 'linux') or (platform_machine == 'arm64' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')" }, + { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tqdm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/a5/53/7c546f1a1034edaf17c54de94a1c36e481124c27e5190a85dcc1be43ffe1/huggingface_hub-0.35.2.tar.gz", hash = "sha256:3a5c03aa272f267a6892e701e5ef1bb2d0d46a487550fda978b5255bcd52f376", size = 461678, upload-time = "2025-09-29T09:50:30.883Z" } wheels = [ @@ -1093,7 +1095,7 @@ name = "importlib-metadata" version = "8.5.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "zipp" }, + { name = "zipp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/cd/12/33e59336dca5be0c398a7482335911a33aa0e20776128f038019f1a95f1b/importlib_metadata-8.5.0.tar.gz", hash = "sha256:71522656f0abace1d072b9e5481a48f07c138e00f079c38c8f883823f9c26bd7", size = 55304, upload-time = "2024-09-11T14:56:08.937Z" } wheels = [ @@ -1114,19 +1116,19 @@ name = "ipykernel" version = "6.30.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "appnope", marker = "sys_platform != 'linux'" }, - { name = "comm" }, - { name = "debugpy" }, - { name = "ipython" }, - { name = "jupyter-client" }, - { name = "jupyter-core" }, - { name = "matplotlib-inline" }, - { name = "nest-asyncio" }, - { name = "packaging" }, - { name = "psutil" }, - { name = "pyzmq" }, - { name = "tornado" }, - { name = "traitlets" }, + { name = "appnope", marker = "sys_platform == 'darwin'" }, + { name = "comm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "debugpy", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "ipython", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jupyter-client", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jupyter-core", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "matplotlib-inline", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "nest-asyncio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "psutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyzmq", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tornado", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "traitlets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/bb/76/11082e338e0daadc89c8ff866185de11daf67d181901038f9e139d109761/ipykernel-6.30.1.tar.gz", hash = "sha256:6abb270161896402e76b91394fcdce5d1be5d45f456671e5080572f8505be39b", size = 166260, upload-time = "2025-08-04T15:47:35.018Z" } wheels = [ @@ -1138,15 +1140,15 @@ name = "ipython" version = "9.6.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "decorator" }, - { name = "ipython-pygments-lexers" }, - { name = "jedi" }, - { name = "matplotlib-inline" }, - { name = "pexpect" }, - { name = "prompt-toolkit" }, - { name = "pygments" }, - { name = "stack-data" }, - { name = "traitlets" }, + { name = "decorator", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "ipython-pygments-lexers", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jedi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "matplotlib-inline", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pexpect", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "prompt-toolkit", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pygments", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "stack-data", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "traitlets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/2a/34/29b18c62e39ee2f7a6a3bba7efd952729d8aadd45ca17efc34453b717665/ipython-9.6.0.tar.gz", hash = "sha256:5603d6d5d356378be5043e69441a072b50a5b33b4503428c77b04cb8ce7bc731", size = 4396932, upload-time = "2025-09-29T10:55:53.948Z" } wheels = [ @@ -1158,7 +1160,7 @@ name = "ipython-pygments-lexers" version = "1.1.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pygments" }, + { name = "pygments", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/ef/4c/5dd1d8af08107f88c7f741ead7a40854b8ac24ddf9ae850afbcf698aa552/ipython_pygments_lexers-1.1.1.tar.gz", hash = "sha256:09c0138009e56b6854f9535736f4171d855c8c08a563a0dcd8022f78355c7e81", size = 8393, upload-time = "2025-01-17T11:24:34.505Z" } wheels = [ @@ -1170,7 +1172,7 @@ name = "jedi" version = "0.19.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "parso" }, + { name = "parso", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/72/3a/79a912fbd4d8dd6fbb02bf69afd3bb72cf0c729bb3063c6f4498603db17a/jedi-0.19.2.tar.gz", hash = "sha256:4770dc3de41bde3966b02eb84fbcf557fb33cce26ad23da12c742fb50ecb11f0", size = 1231287, upload-time = "2024-11-11T01:41:42.873Z" } wheels = [ @@ -1182,7 +1184,7 @@ name = "jinja2" version = "3.1.6" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "markupsafe" }, + { name = "markupsafe", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/df/bf/f7da0350254c0ed7c72f3e33cef02e048281fec7ecec5f032d4aac52226b/jinja2-3.1.6.tar.gz", hash = "sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d", size = 245115, upload-time = "2025-03-05T20:05:02.478Z" } wheels = [ @@ -1218,7 +1220,7 @@ name = "jsonpatch" version = "1.33" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "jsonpointer" }, + { name = "jsonpointer", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/78/18813351fe5d63acad16aec57f94ec2b70a09e53ca98145589e185423873/jsonpatch-1.33.tar.gz", hash = "sha256:9fcd4009c41e6d12348b4a0ff2563ba56a2923a7dfee731d004e212e1ee5030c", size = 21699, upload-time = "2023-06-26T12:07:29.144Z" } wheels = [ @@ -1248,10 +1250,10 @@ name = "jsonschema" version = "4.23.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "attrs" }, - { name = "jsonschema-specifications" }, - { name = "referencing" }, - { name = "rpds-py" }, + { name = "attrs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jsonschema-specifications", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "referencing", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "rpds-py", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/38/2e/03362ee4034a4c917f697890ccd4aec0800ccf9ded7f511971c75451deec/jsonschema-4.23.0.tar.gz", hash = "sha256:d71497fef26351a33265337fa77ffeb82423f3ea21283cd9467bb03999266bc4", size = 325778, upload-time = "2024-07-08T18:40:05.546Z" } wheels = [ @@ -1263,7 +1265,7 @@ name = "jsonschema-specifications" version = "2025.9.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "referencing" }, + { name = "referencing", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" } wheels = [ @@ -1275,11 +1277,11 @@ name = "jupyter-client" version = "8.6.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "jupyter-core" }, - { name = "python-dateutil" }, - { name = "pyzmq" }, - { name = "tornado" }, - { name = "traitlets" }, + { name = "jupyter-core", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-dateutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyzmq", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tornado", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "traitlets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/71/22/bf9f12fdaeae18019a468b68952a60fe6dbab5d67cd2a103cac7659b41ca/jupyter_client-8.6.3.tar.gz", hash = "sha256:35b3a0947c4a6e9d589eb97d7d4cd5e90f910ee73101611f01283732bd6d9419", size = 342019, upload-time = "2024-09-17T10:44:17.613Z" } wheels = [ @@ -1291,8 +1293,8 @@ name = "jupyter-core" version = "5.8.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "platformdirs" }, - { name = "traitlets" }, + { name = "platformdirs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "traitlets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/99/1b/72906d554acfeb588332eaaa6f61577705e9ec752ddb486f302dafa292d9/jupyter_core-5.8.1.tar.gz", hash = "sha256:0a5f9706f70e64786b75acba995988915ebd4601c8a52e534a40b51c95f59941", size = 88923, upload-time = "2025-05-27T07:38:16.655Z" } wheels = [ @@ -1304,16 +1306,16 @@ name = "kubernetes" version = "27.2.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "certifi" }, - { name = "google-auth" }, - { name = "oauthlib" }, - { name = "python-dateutil" }, - { name = "pyyaml" }, - { name = "requests" }, - { name = "requests-oauthlib" }, - { name = "six" }, - { name = "urllib3" }, - { name = "websocket-client" }, + { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "google-auth", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "oauthlib", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-dateutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests-oauthlib", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "six", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "websocket-client", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/93/bc/49b39ae6415fac500fdaf70e3940b89a44dffb963dad9238f8474bcda666/kubernetes-27.2.0.tar.gz", hash = "sha256:d479931c6f37561dbfdf28fc5f46384b1cb8b28f9db344ed4a232ce91990825a", size = 781963, upload-time = "2023-07-17T22:13:53.555Z" } wheels = [ @@ -1325,12 +1327,12 @@ name = "kubernetes-asyncio" version = "31.1.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "aiohttp" }, - { name = "certifi" }, - { name = "python-dateutil" }, - { name = "pyyaml" }, - { name = "six" }, - { name = "urllib3" }, + { name = "aiohttp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-dateutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "six", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/14/50/7a80c0ddcb65be04d0ddcbf6a4f80a12ae71f1cac131d79223647b50fb47/kubernetes_asyncio-31.1.1.tar.gz", hash = "sha256:393bb60a2740d482651d474956296b341348c3e4f883b171740e5a4bf105a87b", size = 962760, upload-time = "2024-12-08T22:25:25.703Z" } wheels = [ @@ -1342,15 +1344,15 @@ name = "langchain-core" version = "1.3.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "jsonpatch" }, - { name = "langchain-protocol" }, - { name = "langsmith" }, - { name = "packaging" }, - { name = "pydantic" }, - { name = "pyyaml" }, - { name = "tenacity" }, - { name = "typing-extensions" }, - { name = "uuid-utils" }, + { name = "jsonpatch", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "langchain-protocol", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "langsmith", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tenacity", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "uuid-utils", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/d3/ae/8b74458fc3850ec3d150eb9f45e857db129dafa801fb5cf173dfc9f8bbf3/langchain_core-1.3.3.tar.gz", hash = "sha256:fa510a5db8efdc0c6ff41c0939fb5c00a0183c11f6b84233e892e3227ff69182", size = 915041, upload-time = "2026-05-05T19:02:36.612Z" } wheels = [ @@ -1362,7 +1364,7 @@ name = "langchain-protocol" version = "0.0.15" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/4f/24/9777489d6fbbee64af0c8f96d4f840239c408cf694f3394672807dafc490/langchain_protocol-0.0.15.tar.gz", hash = "sha256:9ab2d11ee73944754f10e037e717098d3a6796f0e58afa9cadda6154e7655ade", size = 5862, upload-time = "2026-05-01T22:30:04.748Z" } wheels = [ @@ -1374,8 +1376,8 @@ name = "langgraph-checkpoint" version = "4.0.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "langchain-core" }, - { name = "ormsgpack" }, + { name = "langchain-core", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "ormsgpack", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/b1/44/a8df45d1e8b4637e29789fa8bae1db022c953cc7ac80093cfc52e923547e/langgraph_checkpoint-4.0.1.tar.gz", hash = "sha256:b433123735df11ade28829e40ce25b9be614930cd50245ff2af60629234befd9", size = 158135, upload-time = "2026-02-27T21:06:16.092Z" } wheels = [ @@ -1387,15 +1389,15 @@ name = "langsmith" version = "0.7.20" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "httpx", extra = ["http2"] }, - { name = "orjson", marker = "platform_python_implementation != 'PyPy'" }, - { name = "packaging" }, - { name = "pydantic" }, - { name = "requests" }, - { name = "requests-toolbelt" }, - { name = "uuid-utils" }, - { name = "xxhash" }, - { name = "zstandard" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "orjson", marker = "(platform_python_implementation != 'PyPy' and sys_platform == 'darwin') or (platform_python_implementation != 'PyPy' and sys_platform == 'linux')" }, + { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests-toolbelt", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "uuid-utils", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "xxhash", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "zstandard", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/80/c6/cbdc6638207f68a3c61ec0b64fa593f6b11de3170d03c852238c31b54960/langsmith-0.7.20.tar.gz", hash = "sha256:fa983a74f75648ee0e80d3f9751162b6f9a438896d5f9bdb6cba9abda451e234", size = 1134732, upload-time = "2026-03-18T00:03:39.129Z" } wheels = [ @@ -1407,19 +1409,19 @@ name = "litellm" version = "1.96.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "aiohttp" }, - { name = "click" }, - { name = "fastuuid" }, - { name = "httpx", extra = ["http2"] }, - { name = "importlib-metadata" }, - { name = "jinja2" }, - { name = "jsonschema" }, - { name = "openai" }, - { name = "pydantic" }, - { name = "pydantic-settings" }, - { name = "python-dotenv" }, - { name = "tiktoken" }, - { name = "tokenizers" }, + { name = "aiohttp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "click", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "fastuuid", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "importlib-metadata", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jinja2", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jsonschema", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "openai", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic-settings", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tiktoken", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tokenizers", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/79/fe/d03be8a6be6914fabacef29457a2b3d02128c52c448cc6f3019b8e63488b/litellm-1.96.2.tar.gz", hash = "sha256:80d477ae092b05ce023b5084542cb3cb75999b52b1dd2e4d834fb348effc9399", size = 17682558, upload-time = "2026-08-11T21:12:24.117Z" } wheels = [ @@ -1436,7 +1438,7 @@ name = "mako" version = "1.4.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "markupsafe" }, + { name = "markupsafe", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/5a/09/e07c4b5579a79f4b16f8d4f29f6c54514ac787c4ad506b8c4f28a0e6b0bf/mako-1.4.3.tar.gz", hash = "sha256:cd6537fe88d5fec315c55c2f8529bc4ce7a9a352ad7db3eeaa6a66e2dd4ec37a", size = 412799, upload-time = "2026-09-22T20:54:31.509Z" } wheels = [ @@ -1448,7 +1450,7 @@ name = "markdown-it-py" version = "4.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "mdurl" }, + { name = "mdurl", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3", size = 73070, upload-time = "2025-08-11T12:57:52.854Z" } wheels = [ @@ -1476,7 +1478,7 @@ name = "matplotlib-inline" version = "0.1.7" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "traitlets" }, + { name = "traitlets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/99/5b/a36a337438a14116b16480db471ad061c36c3694df7c2084a0da7ba538b7/matplotlib_inline-0.1.7.tar.gz", hash = "sha256:8423b23ec666be3d16e16b60bdd8ac4e86e840ebd1dd11a30b9f117f2fa0ab90", size = 8159, upload-time = "2024-04-15T13:44:44.803Z" } wheels = [ @@ -1488,19 +1490,19 @@ name = "mcp" version = "1.23.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio" }, - { name = "httpx", extra = ["http2"] }, - { name = "httpx-sse" }, - { name = "jsonschema" }, - { name = "pydantic" }, - { name = "pydantic-settings" }, - { name = "pyjwt", extra = ["crypto"] }, - { name = "python-multipart" }, - { name = "sse-starlette" }, - { name = "starlette" }, - { name = "typing-extensions" }, - { name = "typing-inspection" }, - { name = "uvicorn" }, + { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx-sse", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jsonschema", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic-settings", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyjwt", extra = ["crypto"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-multipart", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "sse-starlette", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "starlette", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-inspection", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "uvicorn", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/25/1a/9c8a5362e3448d585081d6c7aa95898a64e0ac59d3e26169ae6c3ca5feaf/mcp-1.23.0.tar.gz", hash = "sha256:84e0c29316d0a8cf0affd196fd000487ac512aa3f771b63b2ea864e22961772b", size = 596506, upload-time = "2025-12-02T13:40:02.558Z" } wheels = [ @@ -1509,8 +1511,8 @@ wheels = [ [package.optional-dependencies] cli = [ - { name = "python-dotenv" }, - { name = "typer" }, + { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typer", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] [[package]] @@ -1560,7 +1562,7 @@ name = "nexus-rpc" version = "1.3.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/2e/f2/d54f5c03d8f4672ccc0875787a385f53dcb61f98a8ae594b5620e85b9cb3/nexus_rpc-1.3.0.tar.gz", hash = "sha256:e56d3b57b60d707ce7a72f83f23f106b86eca1043aa658e44582ab5ff30ab9ad", size = 75650, upload-time = "2025-12-08T22:59:13.002Z" } wheels = [ @@ -1590,14 +1592,14 @@ name = "openai" version = "2.24.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio" }, - { name = "distro" }, - { name = "httpx", extra = ["http2"] }, - { name = "jiter" }, - { name = "pydantic" }, - { name = "sniffio" }, - { name = "tqdm" }, - { name = "typing-extensions" }, + { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "distro", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jiter", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "sniffio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tqdm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/55/13/17e87641b89b74552ed408a92b231283786523edddc95f3545809fab673c/openai-2.24.0.tar.gz", hash = "sha256:1e5769f540dbd01cb33bc4716a23e67b9d695161a734aff9c5f925e2bf99a673", size = 658717, upload-time = "2026-02-24T20:02:07.958Z" } wheels = [ @@ -1609,13 +1611,13 @@ name = "openai-agents" version = "0.4.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "griffe" }, - { name = "mcp" }, - { name = "openai" }, - { name = "pydantic" }, - { name = "requests" }, - { name = "types-requests" }, - { name = "typing-extensions" }, + { name = "griffe", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "mcp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "openai", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "types-requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/2d/8e/71fd262046587a5b2b097aec6ce677f7bb23c81b3129da31942b7a0d0b26/openai_agents-0.4.2.tar.gz", hash = "sha256:281caff839b3ab2cf3bc52110abe93caca004985c41bf07de8e60d03c4a7528e", size = 1925615, upload-time = "2025-10-24T21:46:34.119Z" } wheels = [ @@ -1627,7 +1629,7 @@ name = "opentelemetry-api" version = "1.45.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/19/14/cf3a6b6448849656e1e5f4e2101f3988dc6789724050096aba1bc5ccf592/opentelemetry_api-1.45.2.tar.gz", hash = "sha256:d7b0008e21e5fd61cbe7a7f34ca3b6905a78ab677d9bc395e299359c75cda6b4", size = 73277, upload-time = "2026-10-29T17:29:37.888Z" } wheels = [ @@ -1639,7 +1641,7 @@ name = "opentelemetry-exporter-http-transport" version = "0.66b1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-api" }, + { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/62/0c/e3ebdb4b507f66afcc905e6885a4946969bd75b45988492643356fbbdc63/opentelemetry_exporter_http_transport-0.66b1.tar.gz", hash = "sha256:443080203bf52586ce0b2ad901e8951c61833eab1aa539ae6f1f16fe9e8e7952", size = 11693, upload-time = "2026-10-06T17:32:59.65Z" } wheels = [ @@ -1648,7 +1650,7 @@ wheels = [ [package.optional-dependencies] requests = [ - { name = "requests" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] [[package]] @@ -1656,8 +1658,8 @@ name = "opentelemetry-exporter-otlp" version = "1.45.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-exporter-otlp-proto-grpc" }, - { name = "opentelemetry-exporter-otlp-proto-http" }, + { name = "opentelemetry-exporter-otlp-proto-grpc", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-exporter-otlp-proto-http", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/e3/6f/5a561048ea372894f22f58f70e8478e4cd97d9a4e2d6f014559584a29bc5/opentelemetry_exporter_otlp-1.45.1.tar.gz", hash = "sha256:d0ac35592e77663a9fabf2740b4818c57196b1b764e0c8449d0d7bb2c7b2bc67", size = 6094, upload-time = "2026-10-06T17:33:00.966Z" } wheels = [ @@ -1669,7 +1671,7 @@ name = "opentelemetry-exporter-otlp-common" version = "0.66b1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-sdk" }, + { name = "opentelemetry-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/cb/19/41de712173f43057e4532d42ece7d0c6d4210d353e5752433cb14987643f/opentelemetry_exporter_otlp_common-0.66b1.tar.gz", hash = "sha256:6b1403487a2185ac1feb45fd5546fdf8630ce71c36bcefaadf51e2130e9e23f9", size = 14325, upload-time = "2026-10-06T17:33:01.725Z" } wheels = [ @@ -1681,7 +1683,7 @@ name = "opentelemetry-exporter-otlp-proto-common" version = "1.45.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-proto" }, + { name = "opentelemetry-proto", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/c1/8e/65e85e5137991a3c493b11682151d198638a5bc1dd4b4c5f67e013c57d7c/opentelemetry_exporter_otlp_proto_common-1.45.1.tar.gz", hash = "sha256:2e4adcc3a67bcf57804fc49514f0ef64974ca7590aa3491da389852b4a0628f6", size = 18873, upload-time = "2026-10-06T17:33:04.471Z" } wheels = [ @@ -1693,14 +1695,14 @@ name = "opentelemetry-exporter-otlp-proto-grpc" version = "1.45.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "googleapis-common-protos" }, - { name = "grpcio" }, - { name = "opentelemetry-api" }, - { name = "opentelemetry-exporter-otlp-common" }, - { name = "opentelemetry-exporter-otlp-proto-common" }, - { name = "opentelemetry-proto" }, - { name = "opentelemetry-sdk" }, - { name = "typing-extensions" }, + { name = "googleapis-common-protos", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "grpcio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-exporter-otlp-common", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-exporter-otlp-proto-common", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-proto", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/d6/00/a82af0be959dc58495740b169c6669a86e0811f6cd353a01eda34d255db3/opentelemetry_exporter_otlp_proto_grpc-1.45.1.tar.gz", hash = "sha256:3b3dcfbfdcb4e35149fcf309972282054b45228f5c10547d0095d6578510a9a0", size = 25997, upload-time = "2026-10-06T17:33:05.114Z" } wheels = [ @@ -1712,15 +1714,15 @@ name = "opentelemetry-exporter-otlp-proto-http" version = "1.45.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "googleapis-common-protos" }, - { name = "opentelemetry-api" }, - { name = "opentelemetry-exporter-http-transport", extra = ["requests"] }, - { name = "opentelemetry-exporter-otlp-common" }, - { name = "opentelemetry-exporter-otlp-proto-common" }, - { name = "opentelemetry-proto" }, - { name = "opentelemetry-sdk" }, - { name = "requests" }, - { name = "typing-extensions" }, + { name = "googleapis-common-protos", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-exporter-http-transport", extra = ["requests"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-exporter-otlp-common", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-exporter-otlp-proto-common", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-proto", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/1b/17/26487707ea4caa97b17e6e4b5fa72133a53512ffa2f5cf7a49ef284b29cb/opentelemetry_exporter_otlp_proto_http-1.45.1.tar.gz", hash = "sha256:45c218405ce3fd879596924b1874bf9a8f6880206d61065c5a912c8e5c297fb7", size = 28839, upload-time = "2026-10-06T17:33:05.713Z" } wheels = [ @@ -1732,7 +1734,7 @@ name = "opentelemetry-proto" version = "1.45.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "protobuf" }, + { name = "protobuf", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/4b/7f/15f014fb195da6c2dbb6c71399b8e76824878718e94de6454038488eed28/opentelemetry_proto-1.45.1.tar.gz", hash = "sha256:79e0fb95e4616691a469439238aa9224d75779b3e108e895d1aa125ab29ca77c", size = 46488, upload-time = "2026-10-06T17:33:11.49Z" } wheels = [ @@ -1744,9 +1746,9 @@ name = "opentelemetry-sdk" version = "1.45.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-api" }, - { name = "opentelemetry-semantic-conventions" }, - { name = "typing-extensions" }, + { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-semantic-conventions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/7b/1a/74a21d4d6969fb8b432ac397e66112a8167a6deb267ea4559dbaf2fe91ef/opentelemetry_sdk-1.45.2.tar.gz", hash = "sha256:7eec4de13dd21ff3a1670dcb0e02079e692736f94d733dfdce5af461d884248d", size = 221705, upload-time = "2026-10-29T17:29:54.685Z" } wheels = [ @@ -1758,8 +1760,8 @@ name = "opentelemetry-semantic-conventions" version = "0.66b2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-api" }, - { name = "typing-extensions" }, + { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/37/3f/50f95972b50e8e353f5b9342034c9cd17730f1956f009ce6a3fbbd89f9ce/opentelemetry_semantic_conventions-0.66b2.tar.gz", hash = "sha256:7da5f1a5dc4383eb66711d4d3d3e71824d9403ac1559fea021cc103c1a4c4976", size = 150246, upload-time = "2026-10-29T17:29:55.682Z" } wheels = [ @@ -1824,7 +1826,7 @@ name = "pexpect" version = "4.9.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "ptyprocess" }, + { name = "ptyprocess", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/92/cc564bf6381ff43ce1f4d06852fc19a2f11d180f23dc32d9588bee2f149d/pexpect-4.9.0.tar.gz", hash = "sha256:ee7d41123f3c9911050ea2c2dac107568dc43b2d3b0c7557a33212c398ead30f", size = 166450, upload-time = "2023-11-25T09:07:26.339Z" } wheels = [ @@ -1836,9 +1838,9 @@ name = "pgserver" version = "0.1.4" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "fasteners" }, - { name = "platformdirs" }, - { name = "psutil" }, + { name = "fasteners", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "platformdirs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "psutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] wheels = [ { url = "https://files.pythonhosted.org/packages/92/e3/9f8eea535ab4f2906a9924eccc5fb3a7bcff3e02222fbe338d9c24639750/pgserver-0.1.4-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:dc34f88561b18bc08edd98a84528f99a3720fe713a4e39a4a6210a4d009fe465", size = 10378168, upload-time = "2024-06-08T18:41:40.377Z" }, @@ -1869,11 +1871,11 @@ name = "pre-commit" version = "4.3.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "cfgv" }, - { name = "identify" }, - { name = "nodeenv" }, - { name = "pyyaml" }, - { name = "virtualenv" }, + { name = "cfgv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "identify", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "nodeenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "virtualenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/ff/29/7cf5bbc236333876e4b41f56e06857a87937ce4bf91e117a6991a2dbb02a/pre_commit-4.3.0.tar.gz", hash = "sha256:499fe450cc9d42e9d58e606262795ecb64dd05438943c62b66f6a8673da30b16", size = 193792, upload-time = "2025-08-09T18:56:14.651Z" } wheels = [ @@ -1885,7 +1887,7 @@ name = "prompt-toolkit" version = "3.0.52" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "wcwidth" }, + { name = "wcwidth", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/a1/96/06e01a7b38dce6fe1db213e061a4602dd6032a8a97ef6c1a862537732421/prompt_toolkit-3.0.52.tar.gz", hash = "sha256:28cde192929c8e7321de85de1ddbe736f1375148b02f2e17edd840042b1be855", size = 434198, upload-time = "2025-08-27T15:24:02.057Z" } wheels = [ @@ -1991,7 +1993,7 @@ name = "pyasn1-modules" version = "0.4.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pyasn1" }, + { name = "pyasn1", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/e9/e6/78ebbb10a8c8e4b61a59249394a4a594c1a7af95593dc933a349c8d00964/pyasn1_modules-0.4.2.tar.gz", hash = "sha256:677091de870a80aae844b1ca6134f54652fa2c8c5a52aa396440ac3106e941e6", size = 307892, upload-time = "2025-03-28T02:41:22.17Z" } wheels = [ @@ -2012,10 +2014,10 @@ name = "pydantic" version = "2.12.5" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "annotated-types" }, - { name = "pydantic-core" }, - { name = "typing-extensions" }, - { name = "typing-inspection" }, + { name = "annotated-types", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic-core", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-inspection", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/69/44/36f1a6e523abc58ae5f928898e4aca2e0ea509b5aa6f6f392a5d882be928/pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49", size = 821591, upload-time = "2025-11-26T15:11:46.471Z" } wheels = [ @@ -2027,7 +2029,7 @@ name = "pydantic-core" version = "2.41.5" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" } wheels = [ @@ -2053,9 +2055,9 @@ name = "pydantic-settings" version = "2.15.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pydantic" }, - { name = "python-dotenv" }, - { name = "typing-inspection" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-inspection", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/68/ca/31c57507b13119d7d3cfa1576dad2911a4861e3be07b579395f4e9d393f9/pydantic_settings-2.15.0.tar.gz", hash = "sha256:694b793e84f766ba76a90ebdefc01d0a9a045dab0382bee70393da93712ad117", size = 261253, upload-time = "2026-08-07T09:24:57.419Z" } wheels = [ @@ -2082,7 +2084,7 @@ wheels = [ [package.optional-dependencies] crypto = [ - { name = "cryptography" }, + { name = "cryptography", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] [[package]] @@ -2090,7 +2092,7 @@ name = "pymongo" version = "4.19.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "dnspython" }, + { name = "dnspython", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/8b/a9d214044153cb7d9141229d3e1b171cdf4f460fa07cade9354c4ce2f84d/pymongo-4.19.0.tar.gz", hash = "sha256:3c510dd3c5d9b392d3b33bb5d2a594758acfe8f026fca654253f947ce0af9d40", size = 2689381, upload-time = "2026-10-14T19:48:19.629Z" } wheels = [ @@ -2108,10 +2110,10 @@ name = "pytest" version = "8.4.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "iniconfig" }, - { name = "packaging" }, - { name = "pluggy" }, - { name = "pygments" }, + { name = "iniconfig", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pluggy", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pygments", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/a3/5c/00a0e072241553e1a7496d638deababa67c5058571567b92a7eaa258397c/pytest-8.4.2.tar.gz", hash = "sha256:86c0d0b93306b961d58d62a4db4879f27fe25513d4b969df351abdddb3c30e01", size = 1519618, upload-time = "2025-09-04T14:34:22.711Z" } wheels = [ @@ -2123,8 +2125,8 @@ name = "pytest-asyncio" version = "1.2.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pytest" }, - { name = "typing-extensions" }, + { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/86/9e3c5f48f7b7b638b216e4b9e645f54d199d7abbbab7a64a13b4e12ba10f/pytest_asyncio-1.2.0.tar.gz", hash = "sha256:c609a64a2a8768462d0c99811ddb8bd2583c33fd33cf7f21af1c142e824ffb57", size = 50119, upload-time = "2025-09-12T07:33:53.816Z" } wheels = [ @@ -2136,8 +2138,8 @@ name = "pytest-cov" version = "5.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "coverage" }, - { name = "pytest" }, + { name = "coverage", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/74/67/00efc8d11b630c56f15f4ad9c7f9223f1e5ec275aaae3fa9118c6a223ad2/pytest-cov-5.0.0.tar.gz", hash = "sha256:5837b58e9f6ebd335b0f8060eecce69b662415b16dc503883a02f45dfeb14857", size = 63042, upload-time = "2024-03-24T20:16:34.856Z" } wheels = [ @@ -2149,7 +2151,7 @@ name = "python-dateutil" version = "2.9.0.post0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "six" }, + { name = "six", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/66/c0/0c8b6ad9f17a802ee498c46e004a0eb49bc148f2fd230864601a86dcf6db/python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3", size = 342432, upload-time = "2024-03-01T18:36:20.211Z" } wheels = [ @@ -2161,7 +2163,7 @@ name = "python-discovery" version = "1.6.7" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "filelock" }, + { name = "filelock", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/a3/0b/908da9ef8a14b600fc188eee8d63ede071996114613721153f6fc9ea3cd5/python_discovery-1.6.7.tar.gz", hash = "sha256:7f7c28568c8ec3d988d8bddbdbec8e65f08e8767e52f734e18b8b498549b9b70", size = 117807, upload-time = "2026-10-28T06:24:21.878Z" } wheels = [ @@ -2191,11 +2193,11 @@ name = "python-on-whales" version = "0.73.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pydantic" }, - { name = "requests" }, - { name = "tqdm" }, - { name = "typer" }, - { name = "typing-extensions" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tqdm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typer", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/40/c3/f57dd3e7d20af8a0399bb87471eac4698e0686b04073eef4bc291204a709/python_on_whales-0.73.0.tar.gz", hash = "sha256:c76bf3633550e5c948fb4215918364f45efaddb2e09df5ddd169132f7ffdc249", size = 112019, upload-time = "2024-09-06T10:23:12.846Z" } wheels = [ @@ -2222,7 +2224,7 @@ name = "pyzmq" version = "27.1.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "cffi", marker = "implementation_name == 'pypy'" }, + { name = "cffi", marker = "(implementation_name == 'pypy' and sys_platform == 'darwin') or (implementation_name == 'pypy' and sys_platform == 'linux')" }, ] sdist = { url = "https://files.pythonhosted.org/packages/04/0b/3c9baedbdf613ecaa7aa07027780b8867f57b6293b6ee50de316c9f3222b/pyzmq-27.1.0.tar.gz", hash = "sha256:ac0765e3d44455adb6ddbf4417dcce460fc40a05978c08efdf2948072f6db540", size = 281750, upload-time = "2025-09-08T23:10:18.157Z" } wheels = [ @@ -2240,7 +2242,7 @@ name = "questionary" version = "2.1.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "prompt-toolkit" }, + { name = "prompt-toolkit", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/f6/45/eafb0bba0f9988f6a2520f9ca2df2c82ddfa8d67c95d6625452e97b204a5/questionary-2.1.1.tar.gz", hash = "sha256:3d7e980292bb0107abaa79c68dd3eee3c561b83a0f89ae482860b181c8bd412d", size = 25845, upload-time = "2025-08-28T19:00:20.851Z" } wheels = [ @@ -2252,7 +2254,7 @@ name = "redis" version = "5.3.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pyjwt" }, + { name = "pyjwt", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/6a/cf/128b1b6d7086200c9f387bd4be9b2572a30b90745ef078bd8b235042dc9f/redis-5.3.1.tar.gz", hash = "sha256:ca49577a531ea64039b5a36db3d6cd1a0c7a60c34124d46924a45b956e8cf14c", size = 4626200, upload-time = "2025-07-25T08:06:27.778Z" } wheels = [ @@ -2264,9 +2266,9 @@ name = "redislite" version = "6.2.912183" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "psutil" }, - { name = "redis" }, - { name = "setuptools" }, + { name = "psutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "redis", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "setuptools", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/af/7d/b6fc82af45ed2aa31f6c8b2035df009ff9fd8be01ad8a691155cc167f1f2/redislite-6.2.912183.tar.gz", hash = "sha256:40642495cc53bd5ca3cc186355a7235795ef4b36dd167cb77c7e6837d23e5dd6", size = 2555087, upload-time = "2023-12-01T22:19:28.526Z" } wheels = [ @@ -2278,9 +2280,9 @@ name = "referencing" version = "0.36.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "attrs" }, - { name = "rpds-py" }, - { name = "typing-extensions" }, + { name = "attrs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "rpds-py", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/2f/db/98b5c277be99dd18bfd91dd04e1b759cad18d1a338188c936e92f921c7e2/referencing-0.36.2.tar.gz", hash = "sha256:df2e89862cd09deabbdba16944cc3f10feb6b3e6f18e902f7cc25609a34775aa", size = 74744, upload-time = "2025-01-25T08:48:16.138Z" } wheels = [ @@ -2311,10 +2313,10 @@ name = "requests" version = "2.33.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "certifi" }, - { name = "charset-normalizer" }, - { name = "idna" }, - { name = "urllib3" }, + { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "charset-normalizer", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/34/64/8860370b167a9721e8956ae116825caff829224fbca0ca6e7bf8ddef8430/requests-2.33.0.tar.gz", hash = "sha256:c7ebc5e8b0f21837386ad0e1c8fe8b829fa5f544d8df3b2253bff14ef29d7652", size = 134232, upload-time = "2026-03-25T15:10:41.586Z" } wheels = [ @@ -2326,8 +2328,8 @@ name = "requests-oauthlib" version = "2.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "oauthlib" }, - { name = "requests" }, + { name = "oauthlib", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/f2/05f29bc3913aea15eb670be136045bf5c5bbf4b99ecb839da9b422bb2c85/requests-oauthlib-2.0.0.tar.gz", hash = "sha256:b3dffaebd884d8cd778494369603a9e7b58d29111bf6b41bdc2dcd87203af4e9", size = 55650, upload-time = "2024-03-22T20:32:29.939Z" } wheels = [ @@ -2339,7 +2341,7 @@ name = "requests-toolbelt" version = "1.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "requests" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/f3/61/d7545dafb7ac2230c70d38d31cbfe4cc64f7144dc41f6e4e4b78ecd9f5bb/requests-toolbelt-1.0.0.tar.gz", hash = "sha256:7681a0a3d047012b5bdc0ee37d7f8f07ebe76ab08caeccfc3921ce23c88d5bc6", size = 206888, upload-time = "2023-05-01T04:11:33.229Z" } wheels = [ @@ -2351,8 +2353,8 @@ name = "rich" version = "13.9.4" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "markdown-it-py" }, - { name = "pygments" }, + { name = "markdown-it-py", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pygments", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/ab/3a/0316b28d0761c6734d6bc14e770d85506c986c85ffb239e688eeaab2c2bc/rich-13.9.4.tar.gz", hash = "sha256:439594978a49a09530cff7ebc4b5c7103ef57baf48d5ea3184f21d9a2befa098", size = 223149, upload-time = "2024-11-01T16:43:57.873Z" } wheels = [ @@ -2384,7 +2386,7 @@ name = "rsa" version = "4.9.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pyasn1" }, + { name = "pyasn1", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/da/8a/22b7beea3ee0d44b1916c0c1cb0ee3af23b700b6da9f04991899d0c555d4/rsa-4.9.1.tar.gz", hash = "sha256:e7bdbfdb5497da4c07dfd35530e1a902659db6ff241e39d9953cad06ebd0ae75", size = 29034, upload-time = "2025-04-16T09:51:18.218Z" } wheels = [ @@ -2419,12 +2421,12 @@ name = "scale-gp" version = "0.1.0a59" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio" }, - { name = "distro" }, - { name = "httpx", extra = ["http2"] }, - { name = "pydantic" }, - { name = "sniffio" }, - { name = "typing-extensions" }, + { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "distro", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "sniffio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/c3/3e/c944564757c0a737937c3c87ef61ccfd5138bbe5201fa93edc704124a297/scale_gp-0.1.0a59.tar.gz", hash = "sha256:b7c1e6edb431824f44b8ed2e49969345465e45a1978c1ab6462a7db6d8718f1a", size = 408472, upload-time = "2025-02-05T18:01:22.365Z" } wheels = [ @@ -2436,12 +2438,12 @@ name = "scale-gp-beta" version = "0.1.0a20" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio" }, - { name = "distro" }, - { name = "httpx", extra = ["http2"] }, - { name = "pydantic" }, - { name = "sniffio" }, - { name = "typing-extensions" }, + { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "distro", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "sniffio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/86/2b/a6a373ec8d33fad8b553182aa1ceade94434752c935a4ce16ca84d188c0f/scale_gp_beta-0.1.0a20.tar.gz", hash = "sha256:a2be5c1afcb9171d3c2d6f15b45f4512105c79ab12be8e7ef5a22167ac77fb88", size = 157799, upload-time = "2025-06-12T14:46:17.73Z" } wheels = [ @@ -2475,6 +2477,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050, upload-time = "2024-12-04T17:35:26.475Z" }, ] +[[package]] +name = "slack-sdk" +version = "3.44.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/6e/4e/371068dd7281139307e60cd18553b96b9c8c391a4c3040617192713a3cc4/slack_sdk-3.44.1.tar.gz", hash = "sha256:ca19505423789fa2a3189ff486f989f02e49289f008d0a5813df7255b3fb93ea", size = 256661, upload-time = "2026-09-03T14:21:13.879Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ab/fc/67352b742fc6fa520a550581b0284f5757e4e31a32327c2a00276747fd30/slack_sdk-3.44.1-py2.py3-none-any.whl", hash = "sha256:d6f20a0fbe3fecf9cac955c99d686301b48a645b7045472c3a0cdd186d7c42b2", size = 319865, upload-time = "2026-09-03T14:21:12.405Z" }, +] + [[package]] name = "sniffio" version = "1.3.1" @@ -2489,8 +2500,8 @@ name = "sqlalchemy" version = "2.0.43" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "greenlet", marker = "platform_machine == 'AMD64' or platform_machine == 'WIN32' or platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'ppc64le' or platform_machine == 'win32' or platform_machine == 'x86_64'" }, - { name = "typing-extensions" }, + { name = "greenlet", marker = "(platform_machine == 'AMD64' and sys_platform == 'darwin') or (platform_machine == 'WIN32' and sys_platform == 'darwin') or (platform_machine == 'aarch64' and sys_platform == 'darwin') or (platform_machine == 'amd64' and sys_platform == 'darwin') or (platform_machine == 'ppc64le' and sys_platform == 'darwin') or (platform_machine == 'win32' and sys_platform == 'darwin') or (platform_machine == 'x86_64' and sys_platform == 'darwin') or (platform_machine == 'AMD64' and sys_platform == 'linux') or (platform_machine == 'WIN32' and sys_platform == 'linux') or (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'amd64' and sys_platform == 'linux') or (platform_machine == 'ppc64le' and sys_platform == 'linux') or (platform_machine == 'win32' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/d7/bc/d59b5d97d27229b0e009bd9098cd81af71c2fa5549c580a0a67b9bed0496/sqlalchemy-2.0.43.tar.gz", hash = "sha256:788bfcef6787a7764169cfe9859fe425bf44559619e1d9f56f5bddf2ebf6f417", size = 9762949, upload-time = "2025-08-11T14:24:58.438Z" } wheels = [ @@ -2508,7 +2519,7 @@ name = "sse-starlette" version = "3.0.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio" }, + { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/6f/22ed6e33f8a9e76ca0a412405f31abb844b779d52c5f96660766edcd737c/sse_starlette-3.0.2.tar.gz", hash = "sha256:ccd60b5765ebb3584d0de2d7a6e4f745672581de4f5005ab31c3a25d10b52b3a", size = 20985, upload-time = "2025-07-27T09:07:44.565Z" } wheels = [ @@ -2520,9 +2531,9 @@ name = "stack-data" version = "0.6.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "asttokens" }, - { name = "executing" }, - { name = "pure-eval" }, + { name = "asttokens", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "executing", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pure-eval", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/28/e3/55dcc2cfbc3ca9c29519eb6884dd1415ecb53b0e934862d3559ddcb7e20b/stack_data-0.6.3.tar.gz", hash = "sha256:836a778de4fec4dcd1dcd89ed8abff8a221f58308462e1c4aa2a3cf30148f0b9", size = 44707, upload-time = "2023-09-30T13:58:05.479Z" } wheels = [ @@ -2534,8 +2545,8 @@ name = "starlette" version = "1.3.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio" }, - { name = "typing-extensions" }, + { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/eb/e3/7c1dc7381d9f8ab7d854328ebfa884e62cb3f3d8549ddfd37c7814f42afa/starlette-1.3.1.tar.gz", hash = "sha256:05d0213193f2fbaae60e2ecb593b4add4262ad4e46536b54abe36f11a71724e0", size = 2703240, upload-time = "2026-06-12T09:23:11.602Z" } wheels = [ @@ -2547,10 +2558,10 @@ name = "temporalio" version = "1.23.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "nexus-rpc" }, - { name = "protobuf" }, - { name = "types-protobuf" }, - { name = "typing-extensions" }, + { name = "nexus-rpc", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "protobuf", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "types-protobuf", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/67/48/ba7413e2fab8dcd277b9df00bafa572da24e9ca32de2f38d428dc3a2825c/temporalio-1.23.0.tar.gz", hash = "sha256:72750494b00eb73ded9db76195e3a9b53ff548780f73d878ec3f807ee3191410", size = 1933051, upload-time = "2026-02-18T17:48:22.353Z" } wheels = [ @@ -2583,12 +2594,12 @@ name = "testcontainers" version = "4.13.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "docker" }, - { name = "httpx", extra = ["http2"] }, - { name = "python-dotenv" }, - { name = "typing-extensions" }, - { name = "urllib3" }, - { name = "wrapt" }, + { name = "docker", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "wrapt", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/52/ce/4fd72abe8372cc8c737c62da9dadcdfb6921b57ad8932f7a0feb605e5bf5/testcontainers-4.13.1.tar.gz", hash = "sha256:4a6c5b2faa3e8afb91dff18b389a14b485f3e430157727b58e65d30c8dcde3f3", size = 77955, upload-time = "2025-09-24T22:47:47.2Z" } wheels = [ @@ -2600,8 +2611,8 @@ name = "tiktoken" version = "0.12.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "regex" }, - { name = "requests" }, + { name = "regex", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/7d/ab/4d017d0f76ec3171d469d80fc03dfbb4e48a4bcaddaa831b31d526f05edc/tiktoken-0.12.0.tar.gz", hash = "sha256:b18ba7ee2b093863978fcb14f74b3707cdc8d4d4d3836853ce7ec60772139931", size = 37806, upload-time = "2025-10-06T20:22:45.419Z" } wheels = [ @@ -2618,7 +2629,7 @@ name = "tokenizers" version = "0.22.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "huggingface-hub" }, + { name = "huggingface-hub", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/73/6f/f80cfef4a312e1fb34baf7d85c72d4411afde10978d4657f8cdd811d3ccc/tokenizers-0.22.2.tar.gz", hash = "sha256:473b83b915e547aa366d1eee11806deaf419e17be16310ac0a14077f1e28f917", size = 372115, upload-time = "2026-01-05T10:45:15.988Z" } wheels = [ @@ -2682,10 +2693,10 @@ name = "typer" version = "0.16.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "click" }, - { name = "rich" }, - { name = "shellingham" }, - { name = "typing-extensions" }, + { name = "click", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "rich", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "shellingham", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/43/78/d90f616bf5f88f8710ad067c1f8705bf7618059836ca084e5bb2a0855d75/typer-0.16.1.tar.gz", hash = "sha256:d358c65a464a7a90f338e3bb7ff0c74ac081449e53884b12ba658cbd72990614", size = 102836, upload-time = "2025-08-18T19:18:22.898Z" } wheels = [ @@ -2706,7 +2717,7 @@ name = "types-requests" version = "2.31.0.6" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "types-urllib3" }, + { name = "types-urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/f9/b8/c1e8d39996b4929b918aba10dba5de07a8b3f4c8487bb61bb79882544e69/types-requests-2.31.0.6.tar.gz", hash = "sha256:cd74ce3b53c461f1228a9b783929ac73a666658f223e28ed29753771477b3bd0", size = 15535, upload-time = "2023-09-27T06:19:38.443Z" } wheels = [ @@ -2736,7 +2747,7 @@ name = "typing-inspection" version = "0.4.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions" }, + { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" } wheels = [ @@ -2794,8 +2805,8 @@ name = "uvicorn" version = "0.35.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "click" }, - { name = "h11" }, + { name = "click", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "h11", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/5e/42/e0e305207bb88c6b8d3061399c6a961ffe5fbb7e2aa63c9234df7259e9cd/uvicorn-0.35.0.tar.gz", hash = "sha256:bc662f087f7cf2ce11a1d7fd70b90c9f98ef2e2831556dd078d131b96cc94a01", size = 78473, upload-time = "2025-06-28T16:15:46.058Z" } wheels = [ @@ -2804,12 +2815,12 @@ wheels = [ [package.optional-dependencies] standard = [ - { name = "httptools" }, - { name = "python-dotenv" }, - { name = "pyyaml" }, - { name = "uvloop", marker = "platform_python_implementation != 'PyPy'" }, - { name = "watchfiles" }, - { name = "websockets" }, + { name = "httptools", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "uvloop", marker = "(platform_python_implementation != 'PyPy' and sys_platform == 'darwin') or (platform_python_implementation != 'PyPy' and sys_platform == 'linux')" }, + { name = "watchfiles", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "websockets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] [[package]] @@ -2831,11 +2842,11 @@ name = "virtualenv" version = "21.15.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "distlib" }, - { name = "filelock" }, - { name = "packaging" }, - { name = "platformdirs" }, - { name = "python-discovery" }, + { name = "distlib", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "filelock", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "platformdirs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-discovery", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/b2/24/20282bc8e69ff8dee680dc2b95e9dc81fa7e7894b14c1a8d06330e97fef7/virtualenv-21.15.1.tar.gz", hash = "sha256:e79c90b8f601701599c25905e02839924fede2c798d52325670d24fbdaab74ee", size = 5517048, upload-time = "2026-10-28T01:12:50.919Z" } wheels = [ @@ -2856,7 +2867,7 @@ name = "watchfiles" version = "0.24.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio" }, + { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/c8/27/2ba23c8cc85796e2d41976439b08d52f691655fdb9401362099502d1f0cf/watchfiles-0.24.0.tar.gz", hash = "sha256:afb72325b74fa7a428c009c1b8be4b4d7c2afedafb2982827ef2156646df2fe1", size = 37870, upload-time = "2024-08-28T16:21:37.42Z" } wheels = [ @@ -2949,9 +2960,9 @@ name = "yarl" version = "1.25.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "idna" }, - { name = "multidict" }, - { name = "propcache" }, + { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "multidict", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "propcache", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/75/16/e8be8e2fb175bbf41a0680381a319f1199fae256588241a2ac8677eafb49/yarl-1.25.1.tar.gz", hash = "sha256:03dd38de09bc213e9a8b29761eec33ee1d5318dac0e49d8af36e4d27830e23a7", size = 246245, upload-time = "2026-09-15T19:35:02.264Z" } wheels = [ @@ -2978,7 +2989,7 @@ name = "yaspin" version = "3.4.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "termcolor" }, + { name = "termcolor", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/8d/c5/826a862dcfcb9e85321f96d6f1b4b96b3b9bf37df6f63dce9cffd0b17053/yaspin-3.4.0.tar.gz", hash = "sha256:a83a81ac7a9d161e116fb668a7e4d10d87fb18d02b4b08a17b7e472f465f3c90", size = 42396, upload-time = "2025-12-06T12:33:51.889Z" } wheels = [ From 6eab343c52ba642c9b3166be94c9f98e2880819d Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Mon, 16 Nov 2026 14:50:56 -0600 Subject: [PATCH 02/18] feat(agentex): run the Slack Socket Mode bridge as its own process Slack caps an app at 10 Socket Mode connections. Holding one per API uvicorn worker ties the connection count to API scale (replicas times workers), which can exceed that cap well before the API is large. The bridge now runs only from src/run_slack_socket_mode_bridge.py, set up like the Temporal worker (global dependencies, observability, SIGTERM cancels the main task and unwinds cleanup). Connections per app equal the number of bridge replicas. The API lifespan no longer starts it, and SLACK_SOCKET_MODE_ENABLED is gone: running the entrypoint is the switch. The process serves /healthz and /readyz on port 5004. Readiness only requires the trigger list to have loaded, so a revoked token does not take a replica out. On SIGTERM the sockets close first, so Slack moves delivery to the remaining replicas. Without the credential encryption key the process logs one error and exits. Co-Authored-By: Claude Opus 5.5 --- .../docs/docs/development_guides/webhooks.md | 8 +- agentex/src/api/app.py | 12 --- agentex/src/config/environment_variables.py | 6 -- .../services/slack_socket_mode_bridge.py | 15 ++- agentex/src/run_slack_socket_mode_bridge.py | 101 ++++++++++++++++++ .../unit/api/test_observability_lifespan.py | 8 ++ .../services/test_slack_socket_mode_bridge.py | 50 +++++++++ 7 files changed, 174 insertions(+), 26 deletions(-) create mode 100644 agentex/src/run_slack_socket_mode_bridge.py diff --git a/agentex/docs/docs/development_guides/webhooks.md b/agentex/docs/docs/development_guides/webhooks.md index b808effb..e90f515c 100644 --- a/agentex/docs/docs/development_guides/webhooks.md +++ b/agentex/docs/docs/development_guides/webhooks.md @@ -195,16 +195,18 @@ curl -X POST $HOST/agent_api_keys/webhook-trigger \ }' ``` -Each agentex API process then holds one Socket Mode connection for the app and POSTs every Events API payload to `forward_path` on the agent, the same route and body an HTTP delivery would reach (`url_verification` never happens over a socket). +The Slack Socket Mode bridge then holds one connection for the app and POSTs every Events API payload to `forward_path` on the agent, the same route and body an HTTP delivery would reach (`url_verification` never happens over a socket). Slack's `retry_attempt` arrives as the usual `X-Slack-Retry-Num` and `X-Slack-Retry-Reason` headers. An event is acknowledged only after the agent answers 2xx within 2.5 seconds; otherwise Slack redelivers it. Interactivity and slash-command payloads are not forwarded. Operator notes: -- Socket Mode is off unless `SLACK_SOCKET_MODE_ENABLED=true`, and it refuses to start without `AGENTEX_CREDENTIAL_ENCRYPTION_KEY`, which encrypts the stored app token. +- The bridge is its own process, not part of the API: run `python src/run_slack_socket_mode_bridge.py` (from `agentex/`, the same image as the API) as a separate Deployment with 2 replicas, one process each. It needs the same database settings as the API plus `AGENTEX_CREDENTIAL_ENCRYPTION_KEY`, which encrypts the stored app token; without that key it logs one error and exits. API pods never open sockets. +- Probes are served on port 5004: `/healthz` for liveness and `/readyz` for readiness. Readiness means the trigger list has loaded; it does not wait for every Slack connection, so one revoked token doesn't take a replica out. +- On SIGTERM the bridge closes its sockets, and Slack moves delivery to the other replica. - **One owner per Slack app.** Slack delivers each event to one of the app's open connections. If an agent, or a second agentex environment, also opens a socket for the same app, events are split between them and each side misses some. Register a given app's token in exactly one environment, and remove any Socket Mode client from the agent. -- Slack allows at most 10 open connections per app. Every API process opens one, so more than 10 API processes (replicas times workers) exceeds the cap. +- Each bridge replica opens one connection per app, so connections per app equal the replica count. Slack allows at most 10 per app; keep the replica count at or below that. - If Slack rejects the token (revoked, invalid, wrong type), agentex logs one error and stops that app's connection. To change the token, delete the trigger and register it again; agentex picks up added and removed triggers within a minute. ### Deleting API Keys diff --git a/agentex/src/api/app.py b/agentex/src/api/app.py index 0c0871b0..6ce11d99 100644 --- a/agentex/src/api/app.py +++ b/agentex/src/api/app.py @@ -54,9 +54,6 @@ ) from src.config.environment_variables import EnvVarKeys from src.domain.exceptions import GenericException -from src.domain.services.slack_socket_mode_bridge import ( - create_slack_socket_mode_bridge, -) from src.utils.logging import make_logger logger = make_logger(__name__) @@ -111,15 +108,6 @@ async def lifespan(_: FastAPI): if global_deps.postgres_metrics_collector: await global_deps.postgres_metrics_collector.start_collection() - if resolve_environment_variable_dependency( - EnvVarKeys.SLACK_SOCKET_MODE_ENABLED - ): - bridge = create_slack_socket_mode_bridge() - if bridge is not None: - # Pushed after the dependency shutdowns, so it runs before them. - cleanup.push_async_callback(bridge.stop) - await bridge.start() - yield diff --git a/agentex/src/config/environment_variables.py b/agentex/src/config/environment_variables.py index 42242c08..d49d0a25 100644 --- a/agentex/src/config/environment_variables.py +++ b/agentex/src/config/environment_variables.py @@ -60,7 +60,6 @@ class EnvVarKeys(str, Enum): ENABLE_HEALTH_CHECK_WORKFLOW = "ENABLE_HEALTH_CHECK_WORKFLOW" ENABLE_AGENT_RUN_SCHEDULES = "ENABLE_AGENT_RUN_SCHEDULES" WEBHOOK_REQUEST_TIMEOUT = "WEBHOOK_REQUEST_TIMEOUT" - SLACK_SOCKET_MODE_ENABLED = "SLACK_SOCKET_MODE_ENABLED" RETENTION_CLEANUP_ENABLED = "RETENTION_CLEANUP_ENABLED" RETENTION_CLEANUP_AGENT_ALLOWLIST = "RETENTION_CLEANUP_AGENT_ALLOWLIST" RETENTION_CLEANUP_IDLE_DAYS = "RETENTION_CLEANUP_IDLE_DAYS" @@ -200,8 +199,6 @@ class EnvironmentVariables(BaseModel): # Gates the agent run schedules API. Off by default; enabled in development. ENABLE_AGENT_RUN_SCHEDULES: bool = False WEBHOOK_REQUEST_TIMEOUT: float = 15.0 # Webhook request timeout in seconds - # Hold Slack Socket Mode connections for Slack triggers that carry an app token. - SLACK_SOCKET_MODE_ENABLED: bool = False RETENTION_CLEANUP_ENABLED: bool = False RETENTION_CLEANUP_AGENT_ALLOWLIST: list[str] = [] RETENTION_CLEANUP_IDLE_DAYS: int = 7 @@ -320,9 +317,6 @@ def refresh(cls, force_refresh: bool = False) -> EnvironmentVariables | None: WEBHOOK_REQUEST_TIMEOUT=float( os.environ.get(EnvVarKeys.WEBHOOK_REQUEST_TIMEOUT, "15.0") ), - SLACK_SOCKET_MODE_ENABLED=_parse_bool_env( - EnvVarKeys.SLACK_SOCKET_MODE_ENABLED, default=False - ), RETENTION_CLEANUP_ENABLED=_parse_bool_env( EnvVarKeys.RETENTION_CLEANUP_ENABLED, default=False ), diff --git a/agentex/src/domain/services/slack_socket_mode_bridge.py b/agentex/src/domain/services/slack_socket_mode_bridge.py index 31175584..98e90f78 100644 --- a/agentex/src/domain/services/slack_socket_mode_bridge.py +++ b/agentex/src/domain/services/slack_socket_mode_bridge.py @@ -1,9 +1,10 @@ """Receive Slack webhook-trigger events over Socket Mode instead of HTTP. A Slack trigger registered with an app-level token gets one Socket Mode connection -per API process. Slack spreads an app's events across its open connections (at most -10 per app) and delivers each envelope to one of them, so every process can hold a -connection without duplicating work. Each ``events_api`` envelope is forwarded to +per bridge process (``src/run_slack_socket_mode_bridge.py``), never per API worker: +Slack caps an app at 10 open connections. Slack delivers each envelope to one of the +app's connections, so several bridge replicas don't duplicate work, and when one +closes its socket the others keep receiving. Each ``events_api`` envelope is forwarded to the agent exactly as ``/agents/forward`` would forward the HTTP delivery, and acked only once the agent has accepted it: an unacked envelope is redelivered by Slack, which is the retry path when an agent is slow or down. @@ -123,6 +124,9 @@ def __init__( # ciphertext so a re-registered token is tried again. self._rejected: set[tuple[str, str]] = set() self._task: asyncio.Task | None = None + # Set once the trigger list has loaded. Deliberately not tied to sockets + # being connected: one revoked token must not take the bridge out. + self.ready = False async def start(self) -> None: if self._task is None: @@ -153,6 +157,7 @@ async def refresh(self) -> None: t.id: t for t in await self._agent_api_key_repo.list_slack_socket_mode_triggers() } + self.ready = True for trigger_id, connection in list(self._connections.items()): trigger = triggers.get(trigger_id) if ( @@ -313,8 +318,8 @@ def create_slack_socket_mode_bridge() -> SlackSocketModeBridge | None: """ if not credential_encryption.is_configured(): logger.error( - "SLACK_SOCKET_MODE_ENABLED is set but %s is not configured; Slack " - "Socket Mode is disabled.", + "%s is not configured, so stored Slack app tokens cannot be read; " + "the Slack Socket Mode bridge will not start.", credential_encryption.ENV_KEY, ) return None diff --git a/agentex/src/run_slack_socket_mode_bridge.py b/agentex/src/run_slack_socket_mode_bridge.py new file mode 100644 index 00000000..ea2143be --- /dev/null +++ b/agentex/src/run_slack_socket_mode_bridge.py @@ -0,0 +1,101 @@ +"""Slack Socket Mode bridge entry point. + +Runs the bridge as its own process so the number of Socket Mode connections per +Slack app equals the number of bridge replicas, independent of how many API pods +and uvicorn workers there are. Slack caps an app at 10 connections. + +Serves ``/healthz`` (liveness) and ``/readyz`` (trigger list loaded) on +``PROBE_PORT``. On SIGTERM the sockets are closed, so Slack moves delivery to the +remaining replicas. +""" + +# ruff: noqa: E402 +# Instrument libraries before dependency modules bind their constructors. +from src.utils import observability + +if __name__ == "__main__": + observability.initialize_worker() + +import asyncio +import signal +from contextlib import AsyncExitStack + +from aiohttp import web + +from src.adapters.http.adapter_httpx import HttpxGateway +from src.config import dependencies +from src.config.dependencies import startup_global_dependencies +from src.domain.services.slack_socket_mode_bridge import ( + SlackSocketModeBridge, + create_slack_socket_mode_bridge, +) +from src.utils.logging import make_logger +from src.utils.otel_metrics import shutdown_otel_metrics + +logger = make_logger(__name__) + +PROBE_PORT = 5004 + + +def build_probe_app(bridge: SlackSocketModeBridge) -> web.Application: + async def healthz(_: web.Request) -> web.Response: + return web.Response(text="ok") + + async def readyz(_: web.Request) -> web.Response: + if bridge.ready: + return web.Response(text="ok") + return web.Response(status=503, text="triggers not loaded") + + app = web.Application() + app.router.add_get("/healthz", healthz) + app.router.add_get("/readyz", readyz) + return app + + +async def main(probe_port: int = PROBE_PORT) -> None: + async with AsyncExitStack() as cleanup: + if observability.uses_observability_adapter(): + cleanup.push_async_callback(asyncio.to_thread, observability.shutdown) + else: + cleanup.callback(shutdown_otel_metrics) + cleanup.callback(dependencies.shutdown) + cleanup.push_async_callback(dependencies.async_shutdown) + cleanup.push_async_callback(HttpxGateway.close_clients) + await startup_global_dependencies() + + bridge = create_slack_socket_mode_bridge() + if bridge is None: + raise SystemExit(1) + + runner = web.AppRunner(build_probe_app(bridge)) + await runner.setup() + cleanup.push_async_callback(runner.cleanup) + await web.TCPSite(runner, port=probe_port).start() + + # Last pushed, so on shutdown the sockets close before anything else. + cleanup.push_async_callback(bridge.stop) + await bridge.start() + logger.info("Slack Socket Mode bridge started (probes on :%s)", probe_port) + await asyncio.Event().wait() + + +async def _run_cli() -> None: + """Run cleanup on SIGTERM as well as keyboard interruption.""" + loop = asyncio.get_running_loop() + main_task = asyncio.create_task(main()) + + def request_shutdown() -> None: + if not main_task.cancelling(): + main_task.cancel() + + loop.add_signal_handler(signal.SIGTERM, request_shutdown) + try: + await main_task + except asyncio.CancelledError: + logger.info("Received shutdown signal, Slack Socket Mode bridge stopped") + finally: + loop.remove_signal_handler(signal.SIGTERM) + + +if __name__ == "__main__": + asyncio.run(_run_cli()) diff --git a/agentex/tests/unit/api/test_observability_lifespan.py b/agentex/tests/unit/api/test_observability_lifespan.py index 9d6a6ad8..520f29c8 100644 --- a/agentex/tests/unit/api/test_observability_lifespan.py +++ b/agentex/tests/unit/api/test_observability_lifespan.py @@ -51,8 +51,15 @@ def close_adapter(): "GlobalDependencies", lambda: SimpleNamespace(postgres_metrics_collector=None), ) + from src.domain.services.slack_socket_mode_bridge import SlackSocketModeBridge from src.utils import observability + async def start_bridge(self): + record("slack-socket-mode") + + # Sockets belong to the dedicated bridge process; per-API-worker sockets + # would exceed Slack's 10-connection cap per app. + monkeypatch.setattr(SlackSocketModeBridge, "start", start_bridge) monkeypatch.setattr(observability, "shutdown", close_adapter) monkeypatch.setattr(observability, "uses_observability_adapter", lambda: managed) @@ -70,3 +77,4 @@ async def run(): assert calls[-4:] == expected assert ("metrics-init" in calls) is not managed assert ("serve" in calls) is (failure != "startup") + assert "slack-socket-mode" not in calls diff --git a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py index 631b3468..5642de5e 100644 --- a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py +++ b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py @@ -5,6 +5,7 @@ import httpx import pytest +import src.run_slack_socket_mode_bridge as entrypoint from slack_sdk.errors import SlackApiError from slack_sdk.socket_mode.request import SocketModeRequest from slack_sdk.web.async_client import AsyncWebClient @@ -131,3 +132,52 @@ async def test_rejected_token_stops_without_retrying(self, monkeypatch): connections_open.assert_awaited_once() connect.assert_not_awaited() assert bridge._connections == {} + # A dead token must not hold the bridge out of readiness. + assert bridge.ready + + +@pytest.mark.unit +class TestShutdown: + async def test_stop_closes_open_sockets(self, monkeypatch): + monkeypatch.setattr(mod.credential_encryption, "decrypt", lambda _: "xapp-1") + monkeypatch.setattr( + AsyncWebClient, + "apps_connections_open", + AsyncMock(return_value={"url": "wss://example.invalid"}), + ) + monkeypatch.setattr(mod._TriggerSocketModeClient, "connect", AsyncMock()) + bridge, _ = _bridge(lambda request: httpx.Response(200)) + await bridge.refresh() + client = bridge._connections[TRIGGER.id].client + + await bridge.stop() + + assert client.closed + assert client.aiohttp_client_session.closed + assert bridge._connections == {} + + async def test_sigterm_path_stops_bridge(self, monkeypatch): + fake = MagicMock(start=AsyncMock(), stop=AsyncMock(), ready=True) + monkeypatch.setattr(entrypoint, "startup_global_dependencies", AsyncMock()) + monkeypatch.setattr(entrypoint, "create_slack_socket_mode_bridge", lambda: fake) + monkeypatch.setattr(entrypoint.dependencies, "async_shutdown", AsyncMock()) + monkeypatch.setattr(entrypoint.HttpxGateway, "close_clients", AsyncMock()) + + task = asyncio.create_task(entrypoint.main(probe_port=0)) + while not fake.start.await_count: + await asyncio.sleep(0) + # _run_cli turns SIGTERM into this cancellation. + task.cancel() + with pytest.raises(asyncio.CancelledError): + await task + + fake.stop.assert_awaited_once() + + async def test_refuses_to_start_without_encryption_key(self, monkeypatch): + monkeypatch.setattr(entrypoint, "startup_global_dependencies", AsyncMock()) + monkeypatch.setattr(mod.credential_encryption, "is_configured", lambda: False) + monkeypatch.setattr(entrypoint.dependencies, "async_shutdown", AsyncMock()) + monkeypatch.setattr(entrypoint.HttpxGateway, "close_clients", AsyncMock()) + + with pytest.raises(SystemExit): + await entrypoint.main(probe_port=0) From 32a901f3293e1f650a8ca0a51d4a91b40041cbf1 Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Mon, 16 Nov 2026 14:54:39 -0600 Subject: [PATCH 03/18] docs(agentex): launch the Slack bridge with python -m, like the worker Co-Authored-By: Claude Opus 5.5 --- agentex/docs/docs/development_guides/webhooks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/agentex/docs/docs/development_guides/webhooks.md b/agentex/docs/docs/development_guides/webhooks.md index e90f515c..cf0ee475 100644 --- a/agentex/docs/docs/development_guides/webhooks.md +++ b/agentex/docs/docs/development_guides/webhooks.md @@ -202,7 +202,7 @@ Interactivity and slash-command payloads are not forwarded. Operator notes: -- The bridge is its own process, not part of the API: run `python src/run_slack_socket_mode_bridge.py` (from `agentex/`, the same image as the API) as a separate Deployment with 2 replicas, one process each. It needs the same database settings as the API plus `AGENTEX_CREDENTIAL_ENCRYPTION_KEY`, which encrypts the stored app token; without that key it logs one error and exits. API pods never open sockets. +- The bridge is its own process, not part of the API: run `python -m src.run_slack_socket_mode_bridge` (from `agentex/`, the same image as the API, like the Temporal worker's `python -m src.temporal.run_worker`) as a separate Deployment with 2 replicas, one process each. It needs the same database settings as the API plus `AGENTEX_CREDENTIAL_ENCRYPTION_KEY`, which encrypts the stored app token; without that key it logs one error and exits. API pods never open sockets. - Probes are served on port 5004: `/healthz` for liveness and `/readyz` for readiness. Readiness means the trigger list has loaded; it does not wait for every Slack connection, so one revoked token doesn't take a replica out. - On SIGTERM the bridge closes its sockets, and Slack moves delivery to the other replica. - **One owner per Slack app.** Slack delivers each event to one of the app's open connections. If an agent, or a second agentex environment, also opens a socket for the same app, events are split between them and each side misses some. Register a given app's token in exactly one environment, and remove any Socket Mode client from the agent. From a3fe635f6aff5c6f24cd70dab2c89deca728b06d Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Mon, 16 Nov 2026 16:26:50 -0600 Subject: [PATCH 04/18] build(agentex): lock only the slack-sdk addition The earlier lock was re-resolved by a different uv and rewrote platform markers on every package. Regenerated from main's lock with uv 0.12.12, which keeps lock revision 3, pinning slack-sdk 3.46.0. Co-Authored-By: Claude Opus 5.5 --- uv.lock | 874 ++++++++++++++++++++++++++++---------------------------- 1 file changed, 437 insertions(+), 437 deletions(-) diff --git a/uv.lock b/uv.lock index ef9f9ce5..ced36825 100644 --- a/uv.lock +++ b/uv.lock @@ -30,15 +30,15 @@ name = "agentex" version = "0.1.0" source = { virtual = "." } dependencies = [ - { name = "agentex-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "temporalio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "agentex-sdk" }, + { name = "temporalio" }, ] [package.dev-dependencies] dev = [ - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pre-commit", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "ruff", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"] }, + { name = "pre-commit" }, + { name = "ruff" }, ] [package.metadata] @@ -59,63 +59,63 @@ name = "agentex-backend" version = "0.1.0" source = { editable = "agentex" } dependencies = [ - { name = "aiodocker", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "aiohttp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "alembic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "asyncpg", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "cryptography", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "datadog", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "ddtrace", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "docker", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "fastapi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "json-log-formatter", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "kubernetes-asyncio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "litellm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-exporter-otlp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "psycopg2-binary", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pymongo", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-multipart", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "redis", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "slack-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "sqlalchemy", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "temporalio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "tzdata", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "uvicorn", extra = ["standard"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "websockets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "aiodocker" }, + { name = "aiohttp" }, + { name = "alembic" }, + { name = "asyncpg" }, + { name = "cryptography" }, + { name = "datadog" }, + { name = "ddtrace" }, + { name = "docker" }, + { name = "fastapi" }, + { name = "httpx", extra = ["http2"] }, + { name = "json-log-formatter" }, + { name = "kubernetes-asyncio" }, + { name = "litellm" }, + { name = "opentelemetry-api" }, + { name = "opentelemetry-exporter-otlp" }, + { name = "opentelemetry-sdk" }, + { name = "psycopg2-binary" }, + { name = "pymongo" }, + { name = "python-dotenv" }, + { name = "python-multipart" }, + { name = "pyyaml" }, + { name = "redis" }, + { name = "slack-sdk" }, + { name = "sqlalchemy" }, + { name = "temporalio" }, + { name = "tzdata" }, + { name = "uvicorn", extra = ["standard"] }, + { name = "websockets" }, ] [package.dev-dependencies] dev = [ - { name = "agentex-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pre-commit", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pytest-asyncio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pytest-cov", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "ruff", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "vulture", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "agentex-sdk" }, + { name = "pre-commit" }, + { name = "pytest" }, + { name = "pytest-asyncio" }, + { name = "pytest-cov" }, + { name = "ruff" }, + { name = "vulture" }, ] dev-no-docker = [ - { name = "greenlet", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pgserver", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "redislite", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "greenlet" }, + { name = "pgserver" }, + { name = "redislite" }, ] test = [ - { name = "asyncpg", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "factory-boy", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "greenlet", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx2", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pgserver", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pytest-asyncio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pytest-cov", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "redislite", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "testcontainers", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "asyncpg" }, + { name = "factory-boy" }, + { name = "greenlet" }, + { name = "httpx", extra = ["http2"] }, + { name = "httpx2" }, + { name = "pgserver" }, + { name = "pytest" }, + { name = "pytest-asyncio" }, + { name = "pytest-cov" }, + { name = "redislite" }, + { name = "testcontainers" }, ] [package.metadata] @@ -184,47 +184,47 @@ name = "agentex-sdk" version = "0.9.4" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "aiohttp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "anthropic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "aiohttp" }, + { name = "anthropic" }, + { name = "anyio" }, { name = "claude-agent-sdk", version = "0.1.48", source = { registry = "https://pypi.org/simple" }, marker = "sys_platform == 'linux'" }, - { name = "claude-agent-sdk", version = "0.1.49", source = { registry = "https://pypi.org/simple" }, marker = "sys_platform == 'darwin'" }, - { name = "cloudpickle", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "datadog", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "ddtrace", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "distro", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "fastapi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "ipykernel", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jinja2", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "json-log-formatter", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jsonref", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jsonschema", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "kubernetes", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "langgraph-checkpoint", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "litellm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "mcp", extra = ["cli"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "openai", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "openai-agents", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pytest-asyncio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-on-whales", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "questionary", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "redis", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "rich", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "scale-gp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "scale-gp-beta", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "sniffio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "temporalio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typer", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "tzdata", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "tzlocal", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "uvicorn", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "watchfiles", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "yaspin", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "claude-agent-sdk", version = "0.1.49", source = { registry = "https://pypi.org/simple" }, marker = "sys_platform != 'linux'" }, + { name = "cloudpickle" }, + { name = "datadog" }, + { name = "ddtrace" }, + { name = "distro" }, + { name = "fastapi" }, + { name = "httpx", extra = ["http2"] }, + { name = "ipykernel" }, + { name = "jinja2" }, + { name = "json-log-formatter" }, + { name = "jsonref" }, + { name = "jsonschema" }, + { name = "kubernetes" }, + { name = "langgraph-checkpoint" }, + { name = "litellm" }, + { name = "mcp", extra = ["cli"] }, + { name = "openai" }, + { name = "openai-agents" }, + { name = "pydantic" }, + { name = "pytest" }, + { name = "pytest-asyncio" }, + { name = "python-on-whales" }, + { name = "pyyaml" }, + { name = "questionary" }, + { name = "redis" }, + { name = "rich" }, + { name = "scale-gp" }, + { name = "scale-gp-beta" }, + { name = "sniffio" }, + { name = "temporalio" }, + { name = "typer" }, + { name = "typing-extensions" }, + { name = "tzdata" }, + { name = "tzlocal" }, + { name = "uvicorn" }, + { name = "watchfiles" }, + { name = "yaspin" }, ] sdist = { url = "https://files.pythonhosted.org/packages/3f/e9/f5d81d87e0f743ffab3aac0477db21eba31d740bb28434e7836e0231c53a/agentex_sdk-0.9.4.tar.gz", hash = "sha256:dd5133c8bc878c006063cc9504a409a40e1683200fa5a02f692f5466676f44a8", size = 879600, upload-time = "2026-02-18T18:00:17.317Z" } wheels = [ @@ -236,7 +236,7 @@ name = "aiodocker" version = "0.23.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "aiohttp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "aiohttp" }, ] sdist = { url = "https://files.pythonhosted.org/packages/78/cb/c0fa4944604a182db4c062fea84fbdd77d2e508932dd0052ec784040ac13/aiodocker-0.23.0.tar.gz", hash = "sha256:45ede291063c7d1c24e78a766013c25e85b354a3bdcca68fe2bca64348e4dee2", size = 135218, upload-time = "2024-09-23T04:52:54.975Z" } wheels = [ @@ -257,14 +257,14 @@ name = "aiohttp" version = "3.14.5" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "aiohappyeyeballs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "aiosignal", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "attrs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "frozenlist", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "multidict", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "propcache", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "yarl", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "aiohappyeyeballs" }, + { name = "aiosignal" }, + { name = "attrs" }, + { name = "frozenlist" }, + { name = "multidict" }, + { name = "propcache" }, + { name = "typing-extensions" }, + { name = "yarl" }, ] sdist = { url = "https://files.pythonhosted.org/packages/6c/4c/bdccd81e9ee225b69c60e7766c9a5b05364f118f4d383713b89a682d772d/aiohttp-3.14.5.tar.gz", hash = "sha256:5558a7f5a05af9ecf744af91e5baefc436f93c9333e656c27ec253f9a6bbe178", size = 8078052, upload-time = "2026-10-11T01:05:12.408Z" } wheels = [ @@ -291,8 +291,8 @@ name = "aiosignal" version = "1.4.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "frozenlist", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "frozenlist" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/61/62/06741b579156360248d1ec624842ad0edf697050bbaf7c3e46394e106ad1/aiosignal-1.4.0.tar.gz", hash = "sha256:f47eecd9468083c2029cc99945502cb7708b082c232f9aca65da147157b251c7", size = 25007, upload-time = "2025-07-03T22:54:43.528Z" } wheels = [ @@ -304,9 +304,9 @@ name = "alembic" version = "1.16.5" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "mako", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "sqlalchemy", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "mako" }, + { name = "sqlalchemy" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/9a/ca/4dc52902cf3491892d464f5265a81e9dff094692c8a049a3ed6a05fe7ee8/alembic-1.16.5.tar.gz", hash = "sha256:a88bb7f6e513bd4301ecf4c7f2206fe93f9913f9b48dac3b78babde2d6fe765e", size = 1969868, upload-time = "2025-08-27T18:02:05.668Z" } wheels = [ @@ -336,14 +336,14 @@ name = "anthropic" version = "0.85.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "distro", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "docstring-parser", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jiter", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "sniffio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anyio" }, + { name = "distro" }, + { name = "docstring-parser" }, + { name = "httpx", extra = ["http2"] }, + { name = "jiter" }, + { name = "pydantic" }, + { name = "sniffio" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/c5/08/c620a0eb8625539a8ea9f5a6e06f13d131be0bc8b5b714c235d4b25dd1b5/anthropic-0.85.0.tar.gz", hash = "sha256:d45b2f38a1efb1a5d15515a426b272179a0d18783efa2bb4c3925fa773eb50b9", size = 542034, upload-time = "2026-03-16T17:00:44.324Z" } wheels = [ @@ -355,8 +355,8 @@ name = "anyio" version = "4.14.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "idna" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/61/cc/a381afa6efea9f496eff839d4a6a1aed3bfafc7b3ab4b0d1b243a12573dd/anyio-4.14.2.tar.gz", hash = "sha256:cfa139f3ed1a23ee8f88a145ddb5ac7605b8bbfd8592baacd7ce3d8bb4313c7f", size = 260176, upload-time = "2026-07-12T20:29:07.082Z" } wheels = [ @@ -436,7 +436,7 @@ name = "cffi" version = "2.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pycparser", marker = "(implementation_name != 'PyPy' and sys_platform == 'darwin') or (implementation_name != 'PyPy' and sys_platform == 'linux')" }, + { name = "pycparser", marker = "implementation_name != 'PyPy'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/eb/56/b1ba7935a17738ae8453301356628e8147c79dbb825bcbc73dc7401f9846/cffi-2.0.0.tar.gz", hash = "sha256:44d1b5909021139fe36001ae048dbdde8214afa20200eda0f64c068cac5d5529", size = 523588, upload-time = "2025-09-08T23:24:04.541Z" } wheels = [ @@ -486,8 +486,8 @@ resolution-markers = [ "sys_platform == 'linux'", ] dependencies = [ - { name = "anyio", marker = "sys_platform == 'linux'" }, - { name = "mcp", marker = "sys_platform == 'linux'" }, + { name = "anyio" }, + { name = "mcp" }, ] sdist = { url = "https://files.pythonhosted.org/packages/6c/dd/2818538efd18ed4ef72d4775efa75bb36cbea0fa418eda51df85ee9c2424/claude_agent_sdk-0.1.48.tar.gz", hash = "sha256:ee294d3f02936c0b826119ffbefcf88c67731cf8c2d2cb7111ccc97f76344272", size = 87375, upload-time = "2026-03-07T00:21:37.087Z" } wheels = [ @@ -503,8 +503,8 @@ resolution-markers = [ "sys_platform == 'darwin'", ] dependencies = [ - { name = "anyio", marker = "sys_platform == 'darwin'" }, - { name = "mcp", marker = "sys_platform == 'darwin'" }, + { name = "anyio" }, + { name = "mcp" }, ] sdist = { url = "https://files.pythonhosted.org/packages/03/cf/2bd8d55bab57e458044a5e530a2320fecfcc91ec5546972b2c3db15fd09a/claude_agent_sdk-0.1.49.tar.gz", hash = "sha256:6a93f7e51951623d94c0b35172d1d25d7c44f8dd083568d3252a6ed3ac8719bf", size = 95079, upload-time = "2026-03-20T17:31:09.274Z" } wheels = [ @@ -572,7 +572,7 @@ name = "cryptography" version = "50.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "cffi", marker = "(platform_python_implementation != 'PyPy' and sys_platform == 'darwin') or (platform_python_implementation != 'PyPy' and sys_platform == 'linux')" }, + { name = "cffi", marker = "platform_python_implementation != 'PyPy'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/de/41/6cbdcf9142d00fe82836fbb51e503e58088575cf7a0fe1dbff6695bf0840/cryptography-50.0.0.tar.gz", hash = "sha256:eeac2acb5a20ed25e0ad6d1df9891a520b78b404266b6d11778f25d5d691a6c9", size = 880201, upload-time = "2026-07-31T14:25:10.11Z" } wheels = [ @@ -607,7 +607,7 @@ name = "datadog" version = "0.52.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests" }, ] sdist = { url = "https://files.pythonhosted.org/packages/a9/e6/ec5e4b4dbecd63cecae94009ef6dde9ab421d7d0022e6027586cc3776921/datadog-0.52.1.tar.gz", hash = "sha256:44c6deb563c4522dba206fba2e2bb93d3b04113c40191851ba3a241d82b5fd0b", size = 368037, upload-time = "2025-07-31T15:49:43.425Z" } wheels = [ @@ -619,11 +619,11 @@ name = "ddtrace" version = "4.15.6" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "bytecode", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "ddtrace-internal", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "envier", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "wrapt", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "bytecode" }, + { name = "ddtrace-internal" }, + { name = "envier" }, + { name = "opentelemetry-api" }, + { name = "wrapt" }, ] sdist = { url = "https://files.pythonhosted.org/packages/f6/94/f0f005257dc49a7062c6fed98a6dbcca7691e9d1db5c64e8a2d14f204cac/ddtrace-4.15.6.tar.gz", hash = "sha256:2914f646d4ae338c644b814c4ad80c963e7aadfb39d1e67b0367a15d5c4bc0db", size = 2655968, upload-time = "2026-10-08T09:46:58.392Z" } wheels = [ @@ -696,8 +696,8 @@ name = "docker" version = "7.1.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests" }, + { name = "urllib3" }, ] sdist = { url = "https://files.pythonhosted.org/packages/91/9b/4a2ea29aeba62471211598dac5d96825bb49348fa07e906ea930394a83ce/docker-7.1.0.tar.gz", hash = "sha256:ad8c70e6e3f8926cb8a92619b832b4ea5299e2831c14284663184e200546fa6c", size = 117834, upload-time = "2024-05-23T11:13:57.216Z" } wheels = [ @@ -736,7 +736,7 @@ name = "factory-boy" version = "3.3.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "faker", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "faker" }, ] sdist = { url = "https://files.pythonhosted.org/packages/ba/98/75cacae9945f67cfe323829fc2ac451f64517a8a330b572a06a323997065/factory_boy-3.3.3.tar.gz", hash = "sha256:866862d226128dfac7f2b4160287e899daf54f2612778327dd03d0e2cb1e3d03", size = 164146, upload-time = "2025-02-03T09:49:04.433Z" } wheels = [ @@ -748,7 +748,7 @@ name = "faker" version = "37.8.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "tzdata", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "tzdata" }, ] sdist = { url = "https://files.pythonhosted.org/packages/3a/da/1336008d39e5d4076dddb4e0f3a52ada41429274bf558a3cc28030d324a3/faker-37.8.0.tar.gz", hash = "sha256:090bb5abbec2b30949a95ce1ba6b20d1d0ed222883d63483a0d4be4a970d6fb8", size = 1912113, upload-time = "2025-09-15T20:24:13.592Z" } wheels = [ @@ -760,11 +760,11 @@ name = "fastapi" version = "0.136.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "annotated-doc", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "starlette", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-inspection", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "annotated-doc" }, + { name = "pydantic" }, + { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, ] sdist = { url = "https://files.pythonhosted.org/packages/81/2d/ff8d91d7b564d464629a0fd50a4489c97fcb836ac230bf3a7269232a9b1f/fastapi-0.136.3.tar.gz", hash = "sha256:e487fae93ad408e6f47641ee4dfe389864fd7bec92e547ea8498fc13f43e83ab", size = 396410, upload-time = "2026-05-23T18:53:15.192Z" } wheels = [ @@ -844,9 +844,9 @@ name = "google-auth" version = "2.40.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "cachetools", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyasn1-modules", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "rsa", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "cachetools" }, + { name = "pyasn1-modules" }, + { name = "rsa" }, ] sdist = { url = "https://files.pythonhosted.org/packages/9e/9b/e92ef23b84fa10a64ce4831390b7a4c2e53c0132568d99d4ae61d04c8855/google_auth-2.40.3.tar.gz", hash = "sha256:500c3a29adedeb36ea9cf24b8d10858e152f2412e3ca37829b3fa18e33d63b77", size = 281029, upload-time = "2025-06-04T18:04:57.577Z" } wheels = [ @@ -858,7 +858,7 @@ name = "googleapis-common-protos" version = "1.72.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "protobuf", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "protobuf" }, ] sdist = { url = "https://files.pythonhosted.org/packages/e5/7b/adfd75544c415c487b33061fe7ae526165241c1ea133f9a9125a56b39fd8/googleapis_common_protos-1.72.0.tar.gz", hash = "sha256:e55a601c1b32b52d7a3e65f43563e2aa61bcd737998ee672ac9b951cd49319f5", size = 147433, upload-time = "2025-11-06T18:29:24.087Z" } wheels = [ @@ -888,7 +888,7 @@ name = "griffe" version = "1.14.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "colorama", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "colorama" }, ] sdist = { url = "https://files.pythonhosted.org/packages/ec/d7/6c09dd7ce4c7837e4cdb11dce980cb45ae3cd87677298dc3b781b6bce7d3/griffe-1.14.0.tar.gz", hash = "sha256:9d2a15c1eca966d68e00517de5d69dd1bc5c9f2335ef6c1775362ba5b8651a13", size = 424684, upload-time = "2025-09-05T15:02:29.167Z" } wheels = [ @@ -900,7 +900,7 @@ name = "grpcio" version = "1.76.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/b6/e0/318c1ce3ae5a17894d5791e87aea147587c9e702f24122cc7a5c8bbaeeb1/grpcio-1.76.0.tar.gz", hash = "sha256:7be78388d6da1a25c0d5ec506523db58b18be22d9c37d8d3a32c08be4987bd73", size = 12785182, upload-time = "2025-10-21T16:23:12.106Z" } wheels = [ @@ -928,8 +928,8 @@ name = "h2" version = "4.4.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "hpack", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "hyperframe", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "hpack" }, + { name = "hyperframe" }, ] sdist = { url = "https://files.pythonhosted.org/packages/e7/85/7c366e69d84c17bb778fe41419e1fbcce3033d5b7ce29bbffff0a98b859f/h2-4.4.1.tar.gz", hash = "sha256:4e866ffb1a869ae14dd9b5e6beb5c24a13da0495ad72b65925ded182521c1516", size = 2157281, upload-time = "2026-08-03T11:45:09.509Z" } wheels = [ @@ -964,8 +964,8 @@ name = "httpcore" version = "1.0.9" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "h11", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "certifi" }, + { name = "h11" }, ] sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" } wheels = [ @@ -977,8 +977,8 @@ name = "httpcore2" version = "2.4.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "h11", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "truststore", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "h11" }, + { name = "truststore" }, ] sdist = { url = "https://files.pythonhosted.org/packages/7b/9b/2b1d1833a58236d1f6ee755e027a3917da0db59cc9708554cefc440ee8b6/httpcore2-2.4.0.tar.gz", hash = "sha256:3093a8ab8980d9f910b9cb4351df9186a0ad2350a6284a9107ac9a362a584422", size = 64618, upload-time = "2026-06-11T06:35:53.425Z" } wheels = [ @@ -1004,10 +1004,10 @@ name = "httpx" version = "0.28.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpcore", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anyio" }, + { name = "certifi" }, + { name = "httpcore" }, + { name = "idna" }, ] sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" } wheels = [ @@ -1016,7 +1016,7 @@ wheels = [ [package.optional-dependencies] http2 = [ - { name = "h2", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "h2" }, ] [[package]] @@ -1033,11 +1033,11 @@ name = "httpx2" version = "2.4.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpcore2", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "truststore", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anyio" }, + { name = "httpcore2" }, + { name = "idna" }, + { name = "truststore" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/fc/60/b43ced4ccf26e95b396dbf67051d3e5042b645917d4da0469dd82a3bdd4f/httpx2-2.4.0.tar.gz", hash = "sha256:32e0734b61eb0824b3f56a9e98d6d92d381a3ef12c0045aa917ee63df6c411ef", size = 81691, upload-time = "2026-06-11T06:35:54.538Z" } wheels = [ @@ -1049,14 +1049,14 @@ name = "huggingface-hub" version = "0.35.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "filelock", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "fsspec", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "hf-xet", marker = "(platform_machine == 'aarch64' and sys_platform == 'darwin') or (platform_machine == 'amd64' and sys_platform == 'darwin') or (platform_machine == 'arm64' and sys_platform == 'darwin') or (platform_machine == 'x86_64' and sys_platform == 'darwin') or (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'amd64' and sys_platform == 'linux') or (platform_machine == 'arm64' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')" }, - { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "tqdm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "filelock" }, + { name = "fsspec" }, + { name = "hf-xet", marker = "platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'arm64' or platform_machine == 'x86_64'" }, + { name = "packaging" }, + { name = "pyyaml" }, + { name = "requests" }, + { name = "tqdm" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/a5/53/7c546f1a1034edaf17c54de94a1c36e481124c27e5190a85dcc1be43ffe1/huggingface_hub-0.35.2.tar.gz", hash = "sha256:3a5c03aa272f267a6892e701e5ef1bb2d0d46a487550fda978b5255bcd52f376", size = 461678, upload-time = "2025-09-29T09:50:30.883Z" } wheels = [ @@ -1095,7 +1095,7 @@ name = "importlib-metadata" version = "8.5.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "zipp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "zipp" }, ] sdist = { url = "https://files.pythonhosted.org/packages/cd/12/33e59336dca5be0c398a7482335911a33aa0e20776128f038019f1a95f1b/importlib_metadata-8.5.0.tar.gz", hash = "sha256:71522656f0abace1d072b9e5481a48f07c138e00f079c38c8f883823f9c26bd7", size = 55304, upload-time = "2024-09-11T14:56:08.937Z" } wheels = [ @@ -1116,19 +1116,19 @@ name = "ipykernel" version = "6.30.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "appnope", marker = "sys_platform == 'darwin'" }, - { name = "comm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "debugpy", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "ipython", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jupyter-client", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jupyter-core", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "matplotlib-inline", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "nest-asyncio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "psutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyzmq", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "tornado", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "traitlets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "appnope", marker = "sys_platform != 'linux'" }, + { name = "comm" }, + { name = "debugpy" }, + { name = "ipython" }, + { name = "jupyter-client" }, + { name = "jupyter-core" }, + { name = "matplotlib-inline" }, + { name = "nest-asyncio" }, + { name = "packaging" }, + { name = "psutil" }, + { name = "pyzmq" }, + { name = "tornado" }, + { name = "traitlets" }, ] sdist = { url = "https://files.pythonhosted.org/packages/bb/76/11082e338e0daadc89c8ff866185de11daf67d181901038f9e139d109761/ipykernel-6.30.1.tar.gz", hash = "sha256:6abb270161896402e76b91394fcdce5d1be5d45f456671e5080572f8505be39b", size = 166260, upload-time = "2025-08-04T15:47:35.018Z" } wheels = [ @@ -1140,15 +1140,15 @@ name = "ipython" version = "9.6.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "decorator", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "ipython-pygments-lexers", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jedi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "matplotlib-inline", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pexpect", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "prompt-toolkit", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pygments", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "stack-data", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "traitlets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "decorator" }, + { name = "ipython-pygments-lexers" }, + { name = "jedi" }, + { name = "matplotlib-inline" }, + { name = "pexpect" }, + { name = "prompt-toolkit" }, + { name = "pygments" }, + { name = "stack-data" }, + { name = "traitlets" }, ] sdist = { url = "https://files.pythonhosted.org/packages/2a/34/29b18c62e39ee2f7a6a3bba7efd952729d8aadd45ca17efc34453b717665/ipython-9.6.0.tar.gz", hash = "sha256:5603d6d5d356378be5043e69441a072b50a5b33b4503428c77b04cb8ce7bc731", size = 4396932, upload-time = "2025-09-29T10:55:53.948Z" } wheels = [ @@ -1160,7 +1160,7 @@ name = "ipython-pygments-lexers" version = "1.1.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pygments", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pygments" }, ] sdist = { url = "https://files.pythonhosted.org/packages/ef/4c/5dd1d8af08107f88c7f741ead7a40854b8ac24ddf9ae850afbcf698aa552/ipython_pygments_lexers-1.1.1.tar.gz", hash = "sha256:09c0138009e56b6854f9535736f4171d855c8c08a563a0dcd8022f78355c7e81", size = 8393, upload-time = "2025-01-17T11:24:34.505Z" } wheels = [ @@ -1172,7 +1172,7 @@ name = "jedi" version = "0.19.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "parso", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "parso" }, ] sdist = { url = "https://files.pythonhosted.org/packages/72/3a/79a912fbd4d8dd6fbb02bf69afd3bb72cf0c729bb3063c6f4498603db17a/jedi-0.19.2.tar.gz", hash = "sha256:4770dc3de41bde3966b02eb84fbcf557fb33cce26ad23da12c742fb50ecb11f0", size = 1231287, upload-time = "2024-11-11T01:41:42.873Z" } wheels = [ @@ -1184,7 +1184,7 @@ name = "jinja2" version = "3.1.6" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "markupsafe", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "markupsafe" }, ] sdist = { url = "https://files.pythonhosted.org/packages/df/bf/f7da0350254c0ed7c72f3e33cef02e048281fec7ecec5f032d4aac52226b/jinja2-3.1.6.tar.gz", hash = "sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d", size = 245115, upload-time = "2025-03-05T20:05:02.478Z" } wheels = [ @@ -1220,7 +1220,7 @@ name = "jsonpatch" version = "1.33" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "jsonpointer", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jsonpointer" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/78/18813351fe5d63acad16aec57f94ec2b70a09e53ca98145589e185423873/jsonpatch-1.33.tar.gz", hash = "sha256:9fcd4009c41e6d12348b4a0ff2563ba56a2923a7dfee731d004e212e1ee5030c", size = 21699, upload-time = "2023-06-26T12:07:29.144Z" } wheels = [ @@ -1250,10 +1250,10 @@ name = "jsonschema" version = "4.23.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "attrs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jsonschema-specifications", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "referencing", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "rpds-py", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "attrs" }, + { name = "jsonschema-specifications" }, + { name = "referencing" }, + { name = "rpds-py" }, ] sdist = { url = "https://files.pythonhosted.org/packages/38/2e/03362ee4034a4c917f697890ccd4aec0800ccf9ded7f511971c75451deec/jsonschema-4.23.0.tar.gz", hash = "sha256:d71497fef26351a33265337fa77ffeb82423f3ea21283cd9467bb03999266bc4", size = 325778, upload-time = "2024-07-08T18:40:05.546Z" } wheels = [ @@ -1265,7 +1265,7 @@ name = "jsonschema-specifications" version = "2025.9.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "referencing", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "referencing" }, ] sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" } wheels = [ @@ -1277,11 +1277,11 @@ name = "jupyter-client" version = "8.6.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "jupyter-core", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-dateutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyzmq", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "tornado", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "traitlets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jupyter-core" }, + { name = "python-dateutil" }, + { name = "pyzmq" }, + { name = "tornado" }, + { name = "traitlets" }, ] sdist = { url = "https://files.pythonhosted.org/packages/71/22/bf9f12fdaeae18019a468b68952a60fe6dbab5d67cd2a103cac7659b41ca/jupyter_client-8.6.3.tar.gz", hash = "sha256:35b3a0947c4a6e9d589eb97d7d4cd5e90f910ee73101611f01283732bd6d9419", size = 342019, upload-time = "2024-09-17T10:44:17.613Z" } wheels = [ @@ -1293,8 +1293,8 @@ name = "jupyter-core" version = "5.8.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "platformdirs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "traitlets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "platformdirs" }, + { name = "traitlets" }, ] sdist = { url = "https://files.pythonhosted.org/packages/99/1b/72906d554acfeb588332eaaa6f61577705e9ec752ddb486f302dafa292d9/jupyter_core-5.8.1.tar.gz", hash = "sha256:0a5f9706f70e64786b75acba995988915ebd4601c8a52e534a40b51c95f59941", size = 88923, upload-time = "2025-05-27T07:38:16.655Z" } wheels = [ @@ -1306,16 +1306,16 @@ name = "kubernetes" version = "27.2.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "google-auth", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "oauthlib", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-dateutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "requests-oauthlib", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "six", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "websocket-client", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "certifi" }, + { name = "google-auth" }, + { name = "oauthlib" }, + { name = "python-dateutil" }, + { name = "pyyaml" }, + { name = "requests" }, + { name = "requests-oauthlib" }, + { name = "six" }, + { name = "urllib3" }, + { name = "websocket-client" }, ] sdist = { url = "https://files.pythonhosted.org/packages/93/bc/49b39ae6415fac500fdaf70e3940b89a44dffb963dad9238f8474bcda666/kubernetes-27.2.0.tar.gz", hash = "sha256:d479931c6f37561dbfdf28fc5f46384b1cb8b28f9db344ed4a232ce91990825a", size = 781963, upload-time = "2023-07-17T22:13:53.555Z" } wheels = [ @@ -1327,12 +1327,12 @@ name = "kubernetes-asyncio" version = "31.1.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "aiohttp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-dateutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "six", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "aiohttp" }, + { name = "certifi" }, + { name = "python-dateutil" }, + { name = "pyyaml" }, + { name = "six" }, + { name = "urllib3" }, ] sdist = { url = "https://files.pythonhosted.org/packages/14/50/7a80c0ddcb65be04d0ddcbf6a4f80a12ae71f1cac131d79223647b50fb47/kubernetes_asyncio-31.1.1.tar.gz", hash = "sha256:393bb60a2740d482651d474956296b341348c3e4f883b171740e5a4bf105a87b", size = 962760, upload-time = "2024-12-08T22:25:25.703Z" } wheels = [ @@ -1344,15 +1344,15 @@ name = "langchain-core" version = "1.3.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "jsonpatch", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "langchain-protocol", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "langsmith", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "tenacity", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "uuid-utils", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "jsonpatch" }, + { name = "langchain-protocol" }, + { name = "langsmith" }, + { name = "packaging" }, + { name = "pydantic" }, + { name = "pyyaml" }, + { name = "tenacity" }, + { name = "typing-extensions" }, + { name = "uuid-utils" }, ] sdist = { url = "https://files.pythonhosted.org/packages/d3/ae/8b74458fc3850ec3d150eb9f45e857db129dafa801fb5cf173dfc9f8bbf3/langchain_core-1.3.3.tar.gz", hash = "sha256:fa510a5db8efdc0c6ff41c0939fb5c00a0183c11f6b84233e892e3227ff69182", size = 915041, upload-time = "2026-05-05T19:02:36.612Z" } wheels = [ @@ -1364,7 +1364,7 @@ name = "langchain-protocol" version = "0.0.15" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/4f/24/9777489d6fbbee64af0c8f96d4f840239c408cf694f3394672807dafc490/langchain_protocol-0.0.15.tar.gz", hash = "sha256:9ab2d11ee73944754f10e037e717098d3a6796f0e58afa9cadda6154e7655ade", size = 5862, upload-time = "2026-05-01T22:30:04.748Z" } wheels = [ @@ -1376,8 +1376,8 @@ name = "langgraph-checkpoint" version = "4.0.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "langchain-core", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "ormsgpack", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "langchain-core" }, + { name = "ormsgpack" }, ] sdist = { url = "https://files.pythonhosted.org/packages/b1/44/a8df45d1e8b4637e29789fa8bae1db022c953cc7ac80093cfc52e923547e/langgraph_checkpoint-4.0.1.tar.gz", hash = "sha256:b433123735df11ade28829e40ce25b9be614930cd50245ff2af60629234befd9", size = 158135, upload-time = "2026-02-27T21:06:16.092Z" } wheels = [ @@ -1389,15 +1389,15 @@ name = "langsmith" version = "0.7.20" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "orjson", marker = "(platform_python_implementation != 'PyPy' and sys_platform == 'darwin') or (platform_python_implementation != 'PyPy' and sys_platform == 'linux')" }, - { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "requests-toolbelt", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "uuid-utils", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "xxhash", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "zstandard", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httpx", extra = ["http2"] }, + { name = "orjson", marker = "platform_python_implementation != 'PyPy'" }, + { name = "packaging" }, + { name = "pydantic" }, + { name = "requests" }, + { name = "requests-toolbelt" }, + { name = "uuid-utils" }, + { name = "xxhash" }, + { name = "zstandard" }, ] sdist = { url = "https://files.pythonhosted.org/packages/80/c6/cbdc6638207f68a3c61ec0b64fa593f6b11de3170d03c852238c31b54960/langsmith-0.7.20.tar.gz", hash = "sha256:fa983a74f75648ee0e80d3f9751162b6f9a438896d5f9bdb6cba9abda451e234", size = 1134732, upload-time = "2026-03-18T00:03:39.129Z" } wheels = [ @@ -1409,19 +1409,19 @@ name = "litellm" version = "1.96.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "aiohttp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "click", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "fastuuid", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "importlib-metadata", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jinja2", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jsonschema", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "openai", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic-settings", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "tiktoken", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "tokenizers", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "aiohttp" }, + { name = "click" }, + { name = "fastuuid" }, + { name = "httpx", extra = ["http2"] }, + { name = "importlib-metadata" }, + { name = "jinja2" }, + { name = "jsonschema" }, + { name = "openai" }, + { name = "pydantic" }, + { name = "pydantic-settings" }, + { name = "python-dotenv" }, + { name = "tiktoken" }, + { name = "tokenizers" }, ] sdist = { url = "https://files.pythonhosted.org/packages/79/fe/d03be8a6be6914fabacef29457a2b3d02128c52c448cc6f3019b8e63488b/litellm-1.96.2.tar.gz", hash = "sha256:80d477ae092b05ce023b5084542cb3cb75999b52b1dd2e4d834fb348effc9399", size = 17682558, upload-time = "2026-08-11T21:12:24.117Z" } wheels = [ @@ -1438,7 +1438,7 @@ name = "mako" version = "1.4.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "markupsafe", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "markupsafe" }, ] sdist = { url = "https://files.pythonhosted.org/packages/5a/09/e07c4b5579a79f4b16f8d4f29f6c54514ac787c4ad506b8c4f28a0e6b0bf/mako-1.4.3.tar.gz", hash = "sha256:cd6537fe88d5fec315c55c2f8529bc4ce7a9a352ad7db3eeaa6a66e2dd4ec37a", size = 412799, upload-time = "2026-09-22T20:54:31.509Z" } wheels = [ @@ -1450,7 +1450,7 @@ name = "markdown-it-py" version = "4.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "mdurl", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "mdurl" }, ] sdist = { url = "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3", size = 73070, upload-time = "2025-08-11T12:57:52.854Z" } wheels = [ @@ -1478,7 +1478,7 @@ name = "matplotlib-inline" version = "0.1.7" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "traitlets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "traitlets" }, ] sdist = { url = "https://files.pythonhosted.org/packages/99/5b/a36a337438a14116b16480db471ad061c36c3694df7c2084a0da7ba538b7/matplotlib_inline-0.1.7.tar.gz", hash = "sha256:8423b23ec666be3d16e16b60bdd8ac4e86e840ebd1dd11a30b9f117f2fa0ab90", size = 8159, upload-time = "2024-04-15T13:44:44.803Z" } wheels = [ @@ -1490,19 +1490,19 @@ name = "mcp" version = "1.23.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx-sse", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jsonschema", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic-settings", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyjwt", extra = ["crypto"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-multipart", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "sse-starlette", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "starlette", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-inspection", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "uvicorn", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anyio" }, + { name = "httpx", extra = ["http2"] }, + { name = "httpx-sse" }, + { name = "jsonschema" }, + { name = "pydantic" }, + { name = "pydantic-settings" }, + { name = "pyjwt", extra = ["crypto"] }, + { name = "python-multipart" }, + { name = "sse-starlette" }, + { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, + { name = "uvicorn" }, ] sdist = { url = "https://files.pythonhosted.org/packages/25/1a/9c8a5362e3448d585081d6c7aa95898a64e0ac59d3e26169ae6c3ca5feaf/mcp-1.23.0.tar.gz", hash = "sha256:84e0c29316d0a8cf0affd196fd000487ac512aa3f771b63b2ea864e22961772b", size = 596506, upload-time = "2025-12-02T13:40:02.558Z" } wheels = [ @@ -1511,8 +1511,8 @@ wheels = [ [package.optional-dependencies] cli = [ - { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typer", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "python-dotenv" }, + { name = "typer" }, ] [[package]] @@ -1562,7 +1562,7 @@ name = "nexus-rpc" version = "1.3.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/2e/f2/d54f5c03d8f4672ccc0875787a385f53dcb61f98a8ae594b5620e85b9cb3/nexus_rpc-1.3.0.tar.gz", hash = "sha256:e56d3b57b60d707ce7a72f83f23f106b86eca1043aa658e44582ab5ff30ab9ad", size = 75650, upload-time = "2025-12-08T22:59:13.002Z" } wheels = [ @@ -1592,14 +1592,14 @@ name = "openai" version = "2.24.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "distro", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "jiter", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "sniffio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "tqdm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anyio" }, + { name = "distro" }, + { name = "httpx", extra = ["http2"] }, + { name = "jiter" }, + { name = "pydantic" }, + { name = "sniffio" }, + { name = "tqdm" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/55/13/17e87641b89b74552ed408a92b231283786523edddc95f3545809fab673c/openai-2.24.0.tar.gz", hash = "sha256:1e5769f540dbd01cb33bc4716a23e67b9d695161a734aff9c5f925e2bf99a673", size = 658717, upload-time = "2026-02-24T20:02:07.958Z" } wheels = [ @@ -1611,13 +1611,13 @@ name = "openai-agents" version = "0.4.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "griffe", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "mcp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "openai", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "types-requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "griffe" }, + { name = "mcp" }, + { name = "openai" }, + { name = "pydantic" }, + { name = "requests" }, + { name = "types-requests" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/2d/8e/71fd262046587a5b2b097aec6ce677f7bb23c81b3129da31942b7a0d0b26/openai_agents-0.4.2.tar.gz", hash = "sha256:281caff839b3ab2cf3bc52110abe93caca004985c41bf07de8e60d03c4a7528e", size = 1925615, upload-time = "2025-10-24T21:46:34.119Z" } wheels = [ @@ -1629,7 +1629,7 @@ name = "opentelemetry-api" version = "1.45.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/19/14/cf3a6b6448849656e1e5f4e2101f3988dc6789724050096aba1bc5ccf592/opentelemetry_api-1.45.2.tar.gz", hash = "sha256:d7b0008e21e5fd61cbe7a7f34ca3b6905a78ab677d9bc395e299359c75cda6b4", size = 73277, upload-time = "2026-10-29T17:29:37.888Z" } wheels = [ @@ -1641,7 +1641,7 @@ name = "opentelemetry-exporter-http-transport" version = "0.66b1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-api" }, ] sdist = { url = "https://files.pythonhosted.org/packages/62/0c/e3ebdb4b507f66afcc905e6885a4946969bd75b45988492643356fbbdc63/opentelemetry_exporter_http_transport-0.66b1.tar.gz", hash = "sha256:443080203bf52586ce0b2ad901e8951c61833eab1aa539ae6f1f16fe9e8e7952", size = 11693, upload-time = "2026-10-06T17:32:59.65Z" } wheels = [ @@ -1650,7 +1650,7 @@ wheels = [ [package.optional-dependencies] requests = [ - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests" }, ] [[package]] @@ -1658,8 +1658,8 @@ name = "opentelemetry-exporter-otlp" version = "1.45.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-exporter-otlp-proto-grpc", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-exporter-otlp-proto-http", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-exporter-otlp-proto-grpc" }, + { name = "opentelemetry-exporter-otlp-proto-http" }, ] sdist = { url = "https://files.pythonhosted.org/packages/e3/6f/5a561048ea372894f22f58f70e8478e4cd97d9a4e2d6f014559584a29bc5/opentelemetry_exporter_otlp-1.45.1.tar.gz", hash = "sha256:d0ac35592e77663a9fabf2740b4818c57196b1b764e0c8449d0d7bb2c7b2bc67", size = 6094, upload-time = "2026-10-06T17:33:00.966Z" } wheels = [ @@ -1671,7 +1671,7 @@ name = "opentelemetry-exporter-otlp-common" version = "0.66b1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-sdk" }, ] sdist = { url = "https://files.pythonhosted.org/packages/cb/19/41de712173f43057e4532d42ece7d0c6d4210d353e5752433cb14987643f/opentelemetry_exporter_otlp_common-0.66b1.tar.gz", hash = "sha256:6b1403487a2185ac1feb45fd5546fdf8630ce71c36bcefaadf51e2130e9e23f9", size = 14325, upload-time = "2026-10-06T17:33:01.725Z" } wheels = [ @@ -1683,7 +1683,7 @@ name = "opentelemetry-exporter-otlp-proto-common" version = "1.45.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-proto", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-proto" }, ] sdist = { url = "https://files.pythonhosted.org/packages/c1/8e/65e85e5137991a3c493b11682151d198638a5bc1dd4b4c5f67e013c57d7c/opentelemetry_exporter_otlp_proto_common-1.45.1.tar.gz", hash = "sha256:2e4adcc3a67bcf57804fc49514f0ef64974ca7590aa3491da389852b4a0628f6", size = 18873, upload-time = "2026-10-06T17:33:04.471Z" } wheels = [ @@ -1695,14 +1695,14 @@ name = "opentelemetry-exporter-otlp-proto-grpc" version = "1.45.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "googleapis-common-protos", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "grpcio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-exporter-otlp-common", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-exporter-otlp-proto-common", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-proto", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "googleapis-common-protos" }, + { name = "grpcio" }, + { name = "opentelemetry-api" }, + { name = "opentelemetry-exporter-otlp-common" }, + { name = "opentelemetry-exporter-otlp-proto-common" }, + { name = "opentelemetry-proto" }, + { name = "opentelemetry-sdk" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/d6/00/a82af0be959dc58495740b169c6669a86e0811f6cd353a01eda34d255db3/opentelemetry_exporter_otlp_proto_grpc-1.45.1.tar.gz", hash = "sha256:3b3dcfbfdcb4e35149fcf309972282054b45228f5c10547d0095d6578510a9a0", size = 25997, upload-time = "2026-10-06T17:33:05.114Z" } wheels = [ @@ -1714,15 +1714,15 @@ name = "opentelemetry-exporter-otlp-proto-http" version = "1.45.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "googleapis-common-protos", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-exporter-http-transport", extra = ["requests"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-exporter-otlp-common", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-exporter-otlp-proto-common", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-proto", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-sdk", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "googleapis-common-protos" }, + { name = "opentelemetry-api" }, + { name = "opentelemetry-exporter-http-transport", extra = ["requests"] }, + { name = "opentelemetry-exporter-otlp-common" }, + { name = "opentelemetry-exporter-otlp-proto-common" }, + { name = "opentelemetry-proto" }, + { name = "opentelemetry-sdk" }, + { name = "requests" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/1b/17/26487707ea4caa97b17e6e4b5fa72133a53512ffa2f5cf7a49ef284b29cb/opentelemetry_exporter_otlp_proto_http-1.45.1.tar.gz", hash = "sha256:45c218405ce3fd879596924b1874bf9a8f6880206d61065c5a912c8e5c297fb7", size = 28839, upload-time = "2026-10-06T17:33:05.713Z" } wheels = [ @@ -1734,7 +1734,7 @@ name = "opentelemetry-proto" version = "1.45.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "protobuf", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "protobuf" }, ] sdist = { url = "https://files.pythonhosted.org/packages/4b/7f/15f014fb195da6c2dbb6c71399b8e76824878718e94de6454038488eed28/opentelemetry_proto-1.45.1.tar.gz", hash = "sha256:79e0fb95e4616691a469439238aa9224d75779b3e108e895d1aa125ab29ca77c", size = 46488, upload-time = "2026-10-06T17:33:11.49Z" } wheels = [ @@ -1746,9 +1746,9 @@ name = "opentelemetry-sdk" version = "1.45.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "opentelemetry-semantic-conventions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-api" }, + { name = "opentelemetry-semantic-conventions" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/7b/1a/74a21d4d6969fb8b432ac397e66112a8167a6deb267ea4559dbaf2fe91ef/opentelemetry_sdk-1.45.2.tar.gz", hash = "sha256:7eec4de13dd21ff3a1670dcb0e02079e692736f94d733dfdce5af461d884248d", size = 221705, upload-time = "2026-10-29T17:29:54.685Z" } wheels = [ @@ -1760,8 +1760,8 @@ name = "opentelemetry-semantic-conventions" version = "0.66b2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "opentelemetry-api", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "opentelemetry-api" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/37/3f/50f95972b50e8e353f5b9342034c9cd17730f1956f009ce6a3fbbd89f9ce/opentelemetry_semantic_conventions-0.66b2.tar.gz", hash = "sha256:7da5f1a5dc4383eb66711d4d3d3e71824d9403ac1559fea021cc103c1a4c4976", size = 150246, upload-time = "2026-10-29T17:29:55.682Z" } wheels = [ @@ -1826,7 +1826,7 @@ name = "pexpect" version = "4.9.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "ptyprocess", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "ptyprocess" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/92/cc564bf6381ff43ce1f4d06852fc19a2f11d180f23dc32d9588bee2f149d/pexpect-4.9.0.tar.gz", hash = "sha256:ee7d41123f3c9911050ea2c2dac107568dc43b2d3b0c7557a33212c398ead30f", size = 166450, upload-time = "2023-11-25T09:07:26.339Z" } wheels = [ @@ -1838,9 +1838,9 @@ name = "pgserver" version = "0.1.4" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "fasteners", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "platformdirs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "psutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "fasteners" }, + { name = "platformdirs" }, + { name = "psutil" }, ] wheels = [ { url = "https://files.pythonhosted.org/packages/92/e3/9f8eea535ab4f2906a9924eccc5fb3a7bcff3e02222fbe338d9c24639750/pgserver-0.1.4-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:dc34f88561b18bc08edd98a84528f99a3720fe713a4e39a4a6210a4d009fe465", size = 10378168, upload-time = "2024-06-08T18:41:40.377Z" }, @@ -1871,11 +1871,11 @@ name = "pre-commit" version = "4.3.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "cfgv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "identify", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "nodeenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "virtualenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "cfgv" }, + { name = "identify" }, + { name = "nodeenv" }, + { name = "pyyaml" }, + { name = "virtualenv" }, ] sdist = { url = "https://files.pythonhosted.org/packages/ff/29/7cf5bbc236333876e4b41f56e06857a87937ce4bf91e117a6991a2dbb02a/pre_commit-4.3.0.tar.gz", hash = "sha256:499fe450cc9d42e9d58e606262795ecb64dd05438943c62b66f6a8673da30b16", size = 193792, upload-time = "2025-08-09T18:56:14.651Z" } wheels = [ @@ -1887,7 +1887,7 @@ name = "prompt-toolkit" version = "3.0.52" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "wcwidth", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "wcwidth" }, ] sdist = { url = "https://files.pythonhosted.org/packages/a1/96/06e01a7b38dce6fe1db213e061a4602dd6032a8a97ef6c1a862537732421/prompt_toolkit-3.0.52.tar.gz", hash = "sha256:28cde192929c8e7321de85de1ddbe736f1375148b02f2e17edd840042b1be855", size = 434198, upload-time = "2025-08-27T15:24:02.057Z" } wheels = [ @@ -1993,7 +1993,7 @@ name = "pyasn1-modules" version = "0.4.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pyasn1", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyasn1" }, ] sdist = { url = "https://files.pythonhosted.org/packages/e9/e6/78ebbb10a8c8e4b61a59249394a4a594c1a7af95593dc933a349c8d00964/pyasn1_modules-0.4.2.tar.gz", hash = "sha256:677091de870a80aae844b1ca6134f54652fa2c8c5a52aa396440ac3106e941e6", size = 307892, upload-time = "2025-03-28T02:41:22.17Z" } wheels = [ @@ -2014,10 +2014,10 @@ name = "pydantic" version = "2.12.5" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "annotated-types", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic-core", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-inspection", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "annotated-types" }, + { name = "pydantic-core" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, ] sdist = { url = "https://files.pythonhosted.org/packages/69/44/36f1a6e523abc58ae5f928898e4aca2e0ea509b5aa6f6f392a5d882be928/pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49", size = 821591, upload-time = "2025-11-26T15:11:46.471Z" } wheels = [ @@ -2029,7 +2029,7 @@ name = "pydantic-core" version = "2.41.5" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" } wheels = [ @@ -2055,9 +2055,9 @@ name = "pydantic-settings" version = "2.15.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-inspection", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic" }, + { name = "python-dotenv" }, + { name = "typing-inspection" }, ] sdist = { url = "https://files.pythonhosted.org/packages/68/ca/31c57507b13119d7d3cfa1576dad2911a4861e3be07b579395f4e9d393f9/pydantic_settings-2.15.0.tar.gz", hash = "sha256:694b793e84f766ba76a90ebdefc01d0a9a045dab0382bee70393da93712ad117", size = 261253, upload-time = "2026-08-07T09:24:57.419Z" } wheels = [ @@ -2084,7 +2084,7 @@ wheels = [ [package.optional-dependencies] crypto = [ - { name = "cryptography", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "cryptography" }, ] [[package]] @@ -2092,7 +2092,7 @@ name = "pymongo" version = "4.19.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "dnspython", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "dnspython" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/8b/a9d214044153cb7d9141229d3e1b171cdf4f460fa07cade9354c4ce2f84d/pymongo-4.19.0.tar.gz", hash = "sha256:3c510dd3c5d9b392d3b33bb5d2a594758acfe8f026fca654253f947ce0af9d40", size = 2689381, upload-time = "2026-10-14T19:48:19.629Z" } wheels = [ @@ -2110,10 +2110,10 @@ name = "pytest" version = "8.4.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "iniconfig", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pluggy", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pygments", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "iniconfig" }, + { name = "packaging" }, + { name = "pluggy" }, + { name = "pygments" }, ] sdist = { url = "https://files.pythonhosted.org/packages/a3/5c/00a0e072241553e1a7496d638deababa67c5058571567b92a7eaa258397c/pytest-8.4.2.tar.gz", hash = "sha256:86c0d0b93306b961d58d62a4db4879f27fe25513d4b969df351abdddb3c30e01", size = 1519618, upload-time = "2025-09-04T14:34:22.711Z" } wheels = [ @@ -2125,8 +2125,8 @@ name = "pytest-asyncio" version = "1.2.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pytest" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/86/9e3c5f48f7b7b638b216e4b9e645f54d199d7abbbab7a64a13b4e12ba10f/pytest_asyncio-1.2.0.tar.gz", hash = "sha256:c609a64a2a8768462d0c99811ddb8bd2583c33fd33cf7f21af1c142e824ffb57", size = 50119, upload-time = "2025-09-12T07:33:53.816Z" } wheels = [ @@ -2138,8 +2138,8 @@ name = "pytest-cov" version = "5.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "coverage", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "coverage" }, + { name = "pytest" }, ] sdist = { url = "https://files.pythonhosted.org/packages/74/67/00efc8d11b630c56f15f4ad9c7f9223f1e5ec275aaae3fa9118c6a223ad2/pytest-cov-5.0.0.tar.gz", hash = "sha256:5837b58e9f6ebd335b0f8060eecce69b662415b16dc503883a02f45dfeb14857", size = 63042, upload-time = "2024-03-24T20:16:34.856Z" } wheels = [ @@ -2151,7 +2151,7 @@ name = "python-dateutil" version = "2.9.0.post0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "six", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "six" }, ] sdist = { url = "https://files.pythonhosted.org/packages/66/c0/0c8b6ad9f17a802ee498c46e004a0eb49bc148f2fd230864601a86dcf6db/python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3", size = 342432, upload-time = "2024-03-01T18:36:20.211Z" } wheels = [ @@ -2163,7 +2163,7 @@ name = "python-discovery" version = "1.6.7" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "filelock", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "filelock" }, ] sdist = { url = "https://files.pythonhosted.org/packages/a3/0b/908da9ef8a14b600fc188eee8d63ede071996114613721153f6fc9ea3cd5/python_discovery-1.6.7.tar.gz", hash = "sha256:7f7c28568c8ec3d988d8bddbdbec8e65f08e8767e52f734e18b8b498549b9b70", size = 117807, upload-time = "2026-10-28T06:24:21.878Z" } wheels = [ @@ -2193,11 +2193,11 @@ name = "python-on-whales" version = "0.73.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "tqdm", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typer", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pydantic" }, + { name = "requests" }, + { name = "tqdm" }, + { name = "typer" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/40/c3/f57dd3e7d20af8a0399bb87471eac4698e0686b04073eef4bc291204a709/python_on_whales-0.73.0.tar.gz", hash = "sha256:c76bf3633550e5c948fb4215918364f45efaddb2e09df5ddd169132f7ffdc249", size = 112019, upload-time = "2024-09-06T10:23:12.846Z" } wheels = [ @@ -2224,7 +2224,7 @@ name = "pyzmq" version = "27.1.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "cffi", marker = "(implementation_name == 'pypy' and sys_platform == 'darwin') or (implementation_name == 'pypy' and sys_platform == 'linux')" }, + { name = "cffi", marker = "implementation_name == 'pypy'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/04/0b/3c9baedbdf613ecaa7aa07027780b8867f57b6293b6ee50de316c9f3222b/pyzmq-27.1.0.tar.gz", hash = "sha256:ac0765e3d44455adb6ddbf4417dcce460fc40a05978c08efdf2948072f6db540", size = 281750, upload-time = "2025-09-08T23:10:18.157Z" } wheels = [ @@ -2242,7 +2242,7 @@ name = "questionary" version = "2.1.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "prompt-toolkit", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "prompt-toolkit" }, ] sdist = { url = "https://files.pythonhosted.org/packages/f6/45/eafb0bba0f9988f6a2520f9ca2df2c82ddfa8d67c95d6625452e97b204a5/questionary-2.1.1.tar.gz", hash = "sha256:3d7e980292bb0107abaa79c68dd3eee3c561b83a0f89ae482860b181c8bd412d", size = 25845, upload-time = "2025-08-28T19:00:20.851Z" } wheels = [ @@ -2254,7 +2254,7 @@ name = "redis" version = "5.3.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pyjwt", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyjwt" }, ] sdist = { url = "https://files.pythonhosted.org/packages/6a/cf/128b1b6d7086200c9f387bd4be9b2572a30b90745ef078bd8b235042dc9f/redis-5.3.1.tar.gz", hash = "sha256:ca49577a531ea64039b5a36db3d6cd1a0c7a60c34124d46924a45b956e8cf14c", size = 4626200, upload-time = "2025-07-25T08:06:27.778Z" } wheels = [ @@ -2266,9 +2266,9 @@ name = "redislite" version = "6.2.912183" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "psutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "redis", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "setuptools", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "psutil" }, + { name = "redis" }, + { name = "setuptools" }, ] sdist = { url = "https://files.pythonhosted.org/packages/af/7d/b6fc82af45ed2aa31f6c8b2035df009ff9fd8be01ad8a691155cc167f1f2/redislite-6.2.912183.tar.gz", hash = "sha256:40642495cc53bd5ca3cc186355a7235795ef4b36dd167cb77c7e6837d23e5dd6", size = 2555087, upload-time = "2023-12-01T22:19:28.526Z" } wheels = [ @@ -2280,9 +2280,9 @@ name = "referencing" version = "0.36.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "attrs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "rpds-py", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "attrs" }, + { name = "rpds-py" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/2f/db/98b5c277be99dd18bfd91dd04e1b759cad18d1a338188c936e92f921c7e2/referencing-0.36.2.tar.gz", hash = "sha256:df2e89862cd09deabbdba16944cc3f10feb6b3e6f18e902f7cc25609a34775aa", size = 74744, upload-time = "2025-01-25T08:48:16.138Z" } wheels = [ @@ -2313,10 +2313,10 @@ name = "requests" version = "2.33.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "charset-normalizer", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "certifi" }, + { name = "charset-normalizer" }, + { name = "idna" }, + { name = "urllib3" }, ] sdist = { url = "https://files.pythonhosted.org/packages/34/64/8860370b167a9721e8956ae116825caff829224fbca0ca6e7bf8ddef8430/requests-2.33.0.tar.gz", hash = "sha256:c7ebc5e8b0f21837386ad0e1c8fe8b829fa5f544d8df3b2253bff14ef29d7652", size = 134232, upload-time = "2026-03-25T15:10:41.586Z" } wheels = [ @@ -2328,8 +2328,8 @@ name = "requests-oauthlib" version = "2.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "oauthlib", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "oauthlib" }, + { name = "requests" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/f2/05f29bc3913aea15eb670be136045bf5c5bbf4b99ecb839da9b422bb2c85/requests-oauthlib-2.0.0.tar.gz", hash = "sha256:b3dffaebd884d8cd778494369603a9e7b58d29111bf6b41bdc2dcd87203af4e9", size = 55650, upload-time = "2024-03-22T20:32:29.939Z" } wheels = [ @@ -2341,7 +2341,7 @@ name = "requests-toolbelt" version = "1.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "requests" }, ] sdist = { url = "https://files.pythonhosted.org/packages/f3/61/d7545dafb7ac2230c70d38d31cbfe4cc64f7144dc41f6e4e4b78ecd9f5bb/requests-toolbelt-1.0.0.tar.gz", hash = "sha256:7681a0a3d047012b5bdc0ee37d7f8f07ebe76ab08caeccfc3921ce23c88d5bc6", size = 206888, upload-time = "2023-05-01T04:11:33.229Z" } wheels = [ @@ -2353,8 +2353,8 @@ name = "rich" version = "13.9.4" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "markdown-it-py", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pygments", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "markdown-it-py" }, + { name = "pygments" }, ] sdist = { url = "https://files.pythonhosted.org/packages/ab/3a/0316b28d0761c6734d6bc14e770d85506c986c85ffb239e688eeaab2c2bc/rich-13.9.4.tar.gz", hash = "sha256:439594978a49a09530cff7ebc4b5c7103ef57baf48d5ea3184f21d9a2befa098", size = 223149, upload-time = "2024-11-01T16:43:57.873Z" } wheels = [ @@ -2386,7 +2386,7 @@ name = "rsa" version = "4.9.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pyasn1", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "pyasn1" }, ] sdist = { url = "https://files.pythonhosted.org/packages/da/8a/22b7beea3ee0d44b1916c0c1cb0ee3af23b700b6da9f04991899d0c555d4/rsa-4.9.1.tar.gz", hash = "sha256:e7bdbfdb5497da4c07dfd35530e1a902659db6ff241e39d9953cad06ebd0ae75", size = 29034, upload-time = "2025-04-16T09:51:18.218Z" } wheels = [ @@ -2421,12 +2421,12 @@ name = "scale-gp" version = "0.1.0a59" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "distro", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "sniffio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anyio" }, + { name = "distro" }, + { name = "httpx", extra = ["http2"] }, + { name = "pydantic" }, + { name = "sniffio" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/c3/3e/c944564757c0a737937c3c87ef61ccfd5138bbe5201fa93edc704124a297/scale_gp-0.1.0a59.tar.gz", hash = "sha256:b7c1e6edb431824f44b8ed2e49969345465e45a1978c1ab6462a7db6d8718f1a", size = 408472, upload-time = "2025-02-05T18:01:22.365Z" } wheels = [ @@ -2438,12 +2438,12 @@ name = "scale-gp-beta" version = "0.1.0a20" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "distro", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "sniffio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anyio" }, + { name = "distro" }, + { name = "httpx", extra = ["http2"] }, + { name = "pydantic" }, + { name = "sniffio" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/86/2b/a6a373ec8d33fad8b553182aa1ceade94434752c935a4ce16ca84d188c0f/scale_gp_beta-0.1.0a20.tar.gz", hash = "sha256:a2be5c1afcb9171d3c2d6f15b45f4512105c79ab12be8e7ef5a22167ac77fb88", size = 157799, upload-time = "2025-06-12T14:46:17.73Z" } wheels = [ @@ -2479,11 +2479,11 @@ wheels = [ [[package]] name = "slack-sdk" -version = "3.44.1" +version = "3.46.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/6e/4e/371068dd7281139307e60cd18553b96b9c8c391a4c3040617192713a3cc4/slack_sdk-3.44.1.tar.gz", hash = "sha256:ca19505423789fa2a3189ff486f989f02e49289f008d0a5813df7255b3fb93ea", size = 256661, upload-time = "2026-09-03T14:21:13.879Z" } +sdist = { url = "https://files.pythonhosted.org/packages/7a/43/9eb4f5172ec64d8c25f9fa397d3ca283782d356a60809e4b68ade81fde1a/slack_sdk-3.46.0.tar.gz", hash = "sha256:25215ca293d2954ed759b87573b4c833cb3f82ebff371355936515c688411dbb", size = 266040, upload-time = "2026-10-30T05:08:27.384Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/ab/fc/67352b742fc6fa520a550581b0284f5757e4e31a32327c2a00276747fd30/slack_sdk-3.44.1-py2.py3-none-any.whl", hash = "sha256:d6f20a0fbe3fecf9cac955c99d686301b48a645b7045472c3a0cdd186d7c42b2", size = 319865, upload-time = "2026-09-03T14:21:12.405Z" }, + { url = "https://files.pythonhosted.org/packages/a3/5c/0be529c9a48ccd7b452c6ca47ad1ab5e5e2f7f2cf53d8f34970aebffd0e8/slack_sdk-3.46.0-py2.py3-none-any.whl", hash = "sha256:6286d89da97ea193c853609131515e6f1b3edf86866d6e5aad0dba9dcf1cb72d", size = 325190, upload-time = "2026-10-30T05:08:25.985Z" }, ] [[package]] @@ -2500,8 +2500,8 @@ name = "sqlalchemy" version = "2.0.43" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "greenlet", marker = "(platform_machine == 'AMD64' and sys_platform == 'darwin') or (platform_machine == 'WIN32' and sys_platform == 'darwin') or (platform_machine == 'aarch64' and sys_platform == 'darwin') or (platform_machine == 'amd64' and sys_platform == 'darwin') or (platform_machine == 'ppc64le' and sys_platform == 'darwin') or (platform_machine == 'win32' and sys_platform == 'darwin') or (platform_machine == 'x86_64' and sys_platform == 'darwin') or (platform_machine == 'AMD64' and sys_platform == 'linux') or (platform_machine == 'WIN32' and sys_platform == 'linux') or (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'amd64' and sys_platform == 'linux') or (platform_machine == 'ppc64le' and sys_platform == 'linux') or (platform_machine == 'win32' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "greenlet", marker = "platform_machine == 'AMD64' or platform_machine == 'WIN32' or platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'ppc64le' or platform_machine == 'win32' or platform_machine == 'x86_64'" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/d7/bc/d59b5d97d27229b0e009bd9098cd81af71c2fa5549c580a0a67b9bed0496/sqlalchemy-2.0.43.tar.gz", hash = "sha256:788bfcef6787a7764169cfe9859fe425bf44559619e1d9f56f5bddf2ebf6f417", size = 9762949, upload-time = "2025-08-11T14:24:58.438Z" } wheels = [ @@ -2519,7 +2519,7 @@ name = "sse-starlette" version = "3.0.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anyio" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/6f/22ed6e33f8a9e76ca0a412405f31abb844b779d52c5f96660766edcd737c/sse_starlette-3.0.2.tar.gz", hash = "sha256:ccd60b5765ebb3584d0de2d7a6e4f745672581de4f5005ab31c3a25d10b52b3a", size = 20985, upload-time = "2025-07-27T09:07:44.565Z" } wheels = [ @@ -2531,9 +2531,9 @@ name = "stack-data" version = "0.6.3" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "asttokens", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "executing", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pure-eval", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "asttokens" }, + { name = "executing" }, + { name = "pure-eval" }, ] sdist = { url = "https://files.pythonhosted.org/packages/28/e3/55dcc2cfbc3ca9c29519eb6884dd1415ecb53b0e934862d3559ddcb7e20b/stack_data-0.6.3.tar.gz", hash = "sha256:836a778de4fec4dcd1dcd89ed8abff8a221f58308462e1c4aa2a3cf30148f0b9", size = 44707, upload-time = "2023-09-30T13:58:05.479Z" } wheels = [ @@ -2545,8 +2545,8 @@ name = "starlette" version = "1.3.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anyio" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/eb/e3/7c1dc7381d9f8ab7d854328ebfa884e62cb3f3d8549ddfd37c7814f42afa/starlette-1.3.1.tar.gz", hash = "sha256:05d0213193f2fbaae60e2ecb593b4add4262ad4e46536b54abe36f11a71724e0", size = 2703240, upload-time = "2026-06-12T09:23:11.602Z" } wheels = [ @@ -2558,10 +2558,10 @@ name = "temporalio" version = "1.23.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "nexus-rpc", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "protobuf", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "types-protobuf", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "nexus-rpc" }, + { name = "protobuf" }, + { name = "types-protobuf" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/67/48/ba7413e2fab8dcd277b9df00bafa572da24e9ca32de2f38d428dc3a2825c/temporalio-1.23.0.tar.gz", hash = "sha256:72750494b00eb73ded9db76195e3a9b53ff548780f73d878ec3f807ee3191410", size = 1933051, upload-time = "2026-02-18T17:48:22.353Z" } wheels = [ @@ -2594,12 +2594,12 @@ name = "testcontainers" version = "4.13.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "docker", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "httpx", extra = ["http2"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "wrapt", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "docker" }, + { name = "httpx", extra = ["http2"] }, + { name = "python-dotenv" }, + { name = "typing-extensions" }, + { name = "urllib3" }, + { name = "wrapt" }, ] sdist = { url = "https://files.pythonhosted.org/packages/52/ce/4fd72abe8372cc8c737c62da9dadcdfb6921b57ad8932f7a0feb605e5bf5/testcontainers-4.13.1.tar.gz", hash = "sha256:4a6c5b2faa3e8afb91dff18b389a14b485f3e430157727b58e65d30c8dcde3f3", size = 77955, upload-time = "2025-09-24T22:47:47.2Z" } wheels = [ @@ -2611,8 +2611,8 @@ name = "tiktoken" version = "0.12.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "regex", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "requests", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "regex" }, + { name = "requests" }, ] sdist = { url = "https://files.pythonhosted.org/packages/7d/ab/4d017d0f76ec3171d469d80fc03dfbb4e48a4bcaddaa831b31d526f05edc/tiktoken-0.12.0.tar.gz", hash = "sha256:b18ba7ee2b093863978fcb14f74b3707cdc8d4d4d3836853ce7ec60772139931", size = 37806, upload-time = "2025-10-06T20:22:45.419Z" } wheels = [ @@ -2629,7 +2629,7 @@ name = "tokenizers" version = "0.22.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "huggingface-hub", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "huggingface-hub" }, ] sdist = { url = "https://files.pythonhosted.org/packages/73/6f/f80cfef4a312e1fb34baf7d85c72d4411afde10978d4657f8cdd811d3ccc/tokenizers-0.22.2.tar.gz", hash = "sha256:473b83b915e547aa366d1eee11806deaf419e17be16310ac0a14077f1e28f917", size = 372115, upload-time = "2026-01-05T10:45:15.988Z" } wheels = [ @@ -2693,10 +2693,10 @@ name = "typer" version = "0.16.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "click", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "rich", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "shellingham", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "click" }, + { name = "rich" }, + { name = "shellingham" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/43/78/d90f616bf5f88f8710ad067c1f8705bf7618059836ca084e5bb2a0855d75/typer-0.16.1.tar.gz", hash = "sha256:d358c65a464a7a90f338e3bb7ff0c74ac081449e53884b12ba658cbd72990614", size = 102836, upload-time = "2025-08-18T19:18:22.898Z" } wheels = [ @@ -2717,7 +2717,7 @@ name = "types-requests" version = "2.31.0.6" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "types-urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "types-urllib3" }, ] sdist = { url = "https://files.pythonhosted.org/packages/f9/b8/c1e8d39996b4929b918aba10dba5de07a8b3f4c8487bb61bb79882544e69/types-requests-2.31.0.6.tar.gz", hash = "sha256:cd74ce3b53c461f1228a9b783929ac73a666658f223e28ed29753771477b3bd0", size = 15535, upload-time = "2023-09-27T06:19:38.443Z" } wheels = [ @@ -2747,7 +2747,7 @@ name = "typing-inspection" version = "0.4.2" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "typing-extensions" }, ] sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" } wheels = [ @@ -2805,8 +2805,8 @@ name = "uvicorn" version = "0.35.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "click", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "h11", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "click" }, + { name = "h11" }, ] sdist = { url = "https://files.pythonhosted.org/packages/5e/42/e0e305207bb88c6b8d3061399c6a961ffe5fbb7e2aa63c9234df7259e9cd/uvicorn-0.35.0.tar.gz", hash = "sha256:bc662f087f7cf2ce11a1d7fd70b90c9f98ef2e2831556dd078d131b96cc94a01", size = 78473, upload-time = "2025-06-28T16:15:46.058Z" } wheels = [ @@ -2815,12 +2815,12 @@ wheels = [ [package.optional-dependencies] standard = [ - { name = "httptools", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "uvloop", marker = "(platform_python_implementation != 'PyPy' and sys_platform == 'darwin') or (platform_python_implementation != 'PyPy' and sys_platform == 'linux')" }, - { name = "watchfiles", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "websockets", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "httptools" }, + { name = "python-dotenv" }, + { name = "pyyaml" }, + { name = "uvloop", marker = "platform_python_implementation != 'PyPy'" }, + { name = "watchfiles" }, + { name = "websockets" }, ] [[package]] @@ -2842,11 +2842,11 @@ name = "virtualenv" version = "21.15.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "distlib", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "filelock", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "platformdirs", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "python-discovery", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "distlib" }, + { name = "filelock" }, + { name = "packaging" }, + { name = "platformdirs" }, + { name = "python-discovery" }, ] sdist = { url = "https://files.pythonhosted.org/packages/b2/24/20282bc8e69ff8dee680dc2b95e9dc81fa7e7894b14c1a8d06330e97fef7/virtualenv-21.15.1.tar.gz", hash = "sha256:e79c90b8f601701599c25905e02839924fede2c798d52325670d24fbdaab74ee", size = 5517048, upload-time = "2026-10-28T01:12:50.919Z" } wheels = [ @@ -2867,7 +2867,7 @@ name = "watchfiles" version = "0.24.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "anyio" }, ] sdist = { url = "https://files.pythonhosted.org/packages/c8/27/2ba23c8cc85796e2d41976439b08d52f691655fdb9401362099502d1f0cf/watchfiles-0.24.0.tar.gz", hash = "sha256:afb72325b74fa7a428c009c1b8be4b4d7c2afedafb2982827ef2156646df2fe1", size = 37870, upload-time = "2024-08-28T16:21:37.42Z" } wheels = [ @@ -2960,9 +2960,9 @@ name = "yarl" version = "1.25.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "multidict", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, - { name = "propcache", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "idna" }, + { name = "multidict" }, + { name = "propcache" }, ] sdist = { url = "https://files.pythonhosted.org/packages/75/16/e8be8e2fb175bbf41a0680381a319f1199fae256588241a2ac8677eafb49/yarl-1.25.1.tar.gz", hash = "sha256:03dd38de09bc213e9a8b29761eec33ee1d5318dac0e49d8af36e4d27830e23a7", size = 246245, upload-time = "2026-09-15T19:35:02.264Z" } wheels = [ @@ -2989,7 +2989,7 @@ name = "yaspin" version = "3.4.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "termcolor", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" }, + { name = "termcolor" }, ] sdist = { url = "https://files.pythonhosted.org/packages/8d/c5/826a862dcfcb9e85321f96d6f1b4b96b3b9bf37df6f63dce9cffd0b17053/yaspin-3.4.0.tar.gz", hash = "sha256:a83a81ac7a9d161e116fb668a7e4d10d87fb18d02b4b08a17b7e472f465f3c90", size = 42396, upload-time = "2025-12-06T12:33:51.889Z" } wheels = [ From bee13e3362b4b6adcff8406e595c37822e82fc41 Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Mon, 16 Nov 2026 20:22:48 -0600 Subject: [PATCH 05/18] fix(agentex): sign Socket Mode forwards and serve one trigger per Slack app - Sign each forwarded event with the trigger's signing secret, so an agent that verifies Slack signatures accepts it as it would an HTTP delivery. - Ack when the agent answers with X-Slack-No-Retry: 1, as over HTTP. - Keep slack_sdk's rate-limit backoff when opening a connection; only token errors that no retry can fix stop the connection. - Refuse a second Socket Mode trigger for an app another trigger serves, and connect only the earliest one if duplicates exist: Slack splits an app's events across its connections. - Start the bridge on one small Postgres engine and an HTTP client instead of the API's global dependencies (Temporal, MongoDB, Redis, Kubernetes config), so the probe server comes up without waiting on them. Co-Authored-By: Claude Opus 5.5 --- .../docs/docs/development_guides/webhooks.md | 8 +- agentex/src/api/routes/agent_api_keys.py | 9 ++ .../repositories/agent_api_key_repository.py | 10 +- .../services/slack_socket_mode_bridge.py | 139 ++++++++++++------ .../use_cases/agent_api_keys_use_case.py | 6 + agentex/src/run_slack_socket_mode_bridge.py | 45 ++++-- .../tests/unit/api/test_webhook_trigger.py | 43 +++++- .../services/test_slack_socket_mode_bridge.py | 131 +++++++++++++++-- 8 files changed, 316 insertions(+), 75 deletions(-) diff --git a/agentex/docs/docs/development_guides/webhooks.md b/agentex/docs/docs/development_guides/webhooks.md index cf0ee475..cd33c29f 100644 --- a/agentex/docs/docs/development_guides/webhooks.md +++ b/agentex/docs/docs/development_guides/webhooks.md @@ -196,16 +196,18 @@ curl -X POST $HOST/agent_api_keys/webhook-trigger \ ``` The Slack Socket Mode bridge then holds one connection for the app and POSTs every Events API payload to `forward_path` on the agent, the same route and body an HTTP delivery would reach (`url_verification` never happens over a socket). +Each POST carries `X-Slack-Signature` and `X-Slack-Request-Timestamp` computed with the trigger's signing secret, so an agent that verifies Slack signatures itself accepts it as it would an HTTP delivery. Slack's `retry_attempt` arrives as the usual `X-Slack-Retry-Num` and `X-Slack-Retry-Reason` headers. -An event is acknowledged only after the agent answers 2xx within 2.5 seconds; otherwise Slack redelivers it. +An event is acknowledged only after the agent answers 2xx within 2.5 seconds, or answers with `X-Slack-No-Retry: 1` as it can over HTTP; otherwise Slack redelivers it. +Delivery is at least once: an event whose acknowledgement is lost, for example when a bridge replica stops mid-forward, reaches the agent again. Interactivity and slash-command payloads are not forwarded. Operator notes: -- The bridge is its own process, not part of the API: run `python -m src.run_slack_socket_mode_bridge` (from `agentex/`, the same image as the API, like the Temporal worker's `python -m src.temporal.run_worker`) as a separate Deployment with 2 replicas, one process each. It needs the same database settings as the API plus `AGENTEX_CREDENTIAL_ENCRYPTION_KEY`, which encrypts the stored app token; without that key it logs one error and exits. API pods never open sockets. +- The bridge is its own process, not part of the API: run `python -m src.run_slack_socket_mode_bridge` (from `agentex/`, the same image as the API, like the Temporal worker's `python -m src.temporal.run_worker`) as a separate Deployment with 2 replicas, one process each. It needs only `DATABASE_URL` and `AGENTEX_CREDENTIAL_ENCRYPTION_KEY`, which encrypts the stored app token; without that key it logs one error and exits. It does not connect to Temporal, MongoDB or Redis. API pods never open sockets. - Probes are served on port 5004: `/healthz` for liveness and `/readyz` for readiness. Readiness means the trigger list has loaded; it does not wait for every Slack connection, so one revoked token doesn't take a replica out. - On SIGTERM the bridge closes its sockets, and Slack moves delivery to the other replica. -- **One owner per Slack app.** Slack delivers each event to one of the app's open connections. If an agent, or a second agentex environment, also opens a socket for the same app, events are split between them and each side misses some. Register a given app's token in exactly one environment, and remove any Socket Mode client from the agent. +- **One owner per Slack app.** Slack delivers each event to one of the app's open connections. If an agent, or a second agentex environment, also opens a socket for the same app, events are split between them and each side misses some. Register a given app's token in exactly one environment, and remove any Socket Mode client from the agent. Within one environment, registering a second Socket Mode trigger for an app another trigger already serves returns 409; if two such triggers exist anyway, the bridge connects only the earliest-registered one and logs an error. - Each bridge replica opens one connection per app, so connections per app equal the replica count. Slack allows at most 10 per app; keep the replica count at or below that. - If Slack rejects the token (revoked, invalid, wrong type), agentex logs one error and stops that app's connection. To change the token, delete the trigger and register it again; agentex picks up added and removed triggers within a minute. diff --git a/agentex/src/api/routes/agent_api_keys.py b/agentex/src/api/routes/agent_api_keys.py index 1f57b5eb..a79abcdf 100644 --- a/agentex/src/api/routes/agent_api_keys.py +++ b/agentex/src/api/routes/agent_api_keys.py @@ -202,6 +202,15 @@ async def create_webhook_trigger( detail="This deployment cannot store app tokens: credential " "encryption is not configured.", ) + # Slack gives each event to one of an app's connections, so a second + # Socket Mode trigger for the same app would take part of the first + # one's events. + if await agent_api_key_use_case.has_slack_socket_mode_trigger(request.name): + raise HTTPException( + status_code=409, + detail=f"Slack app '{request.name}' is already served over Socket " + "Mode by another trigger; delete that trigger first.", + ) app_token_encrypted = credential_encryption.encrypt(request.app_token) secret = request.secret if request.secret is not None else secrets.token_hex(32) diff --git a/agentex/src/domain/repositories/agent_api_key_repository.py b/agentex/src/domain/repositories/agent_api_key_repository.py index c9bb7bab..c4bd2dd0 100644 --- a/agentex/src/domain/repositories/agent_api_key_repository.py +++ b/agentex/src/domain/repositories/agent_api_key_repository.py @@ -173,9 +173,13 @@ async def get_external_by_agent_id_and_key( return AgentAPIKeyEntity.model_validate(row) if row else None async def list_slack_socket_mode_triggers( - self, + self, app_id: str | None = None ) -> builtins.list[AgentAPIKeyEntity]: - """Slack triggers that carry an app token, on agents that are not deleted.""" + """Slack triggers that carry an app token, on agents that are not deleted. + + Args: + app_id: Only triggers for this Slack app (the trigger name), if given. + """ async with self.start_async_db_session(allow_writes=False) as session: query = ( select(AgentAPIKeyORM) @@ -186,6 +190,8 @@ async def list_slack_socket_mode_triggers( AgentORM.status != AgentStatus.DELETED, ) ) + if app_id is not None: + query = query.where(AgentAPIKeyORM.name == app_id) result = await session.execute(query) return [ AgentAPIKeyEntity.model_validate(row) for row in result.scalars().all() diff --git a/agentex/src/domain/services/slack_socket_mode_bridge.py b/agentex/src/domain/services/slack_socket_mode_bridge.py index 98e90f78..8e14f962 100644 --- a/agentex/src/domain/services/slack_socket_mode_bridge.py +++ b/agentex/src/domain/services/slack_socket_mode_bridge.py @@ -5,7 +5,8 @@ Slack caps an app at 10 open connections. Slack delivers each envelope to one of the app's connections, so several bridge replicas don't duplicate work, and when one closes its socket the others keep receiving. Each ``events_api`` envelope is forwarded to -the agent exactly as ``/agents/forward`` would forward the HTTP delivery, and acked +the agent exactly as ``/agents/forward`` would forward the HTTP delivery, signed with the +trigger's signing secret as Slack signs one, and acked only once the agent has accepted it: an unacked envelope is redelivered by Slack, which is the retry path when an agent is slow or down. @@ -17,7 +18,10 @@ from __future__ import annotations import asyncio +import hashlib +import hmac import json +import time from dataclasses import dataclass from functools import partial from typing import Any @@ -27,14 +31,10 @@ from slack_sdk.socket_mode.aiohttp import SocketModeClient from slack_sdk.socket_mode.request import SocketModeRequest from slack_sdk.socket_mode.response import SocketModeResponse +from sqlalchemy.ext.asyncio import AsyncEngine from src.adapters.crud_store.exceptions import ItemDoesNotExist -from src.config.dependencies import ( - database_async_read_only_session_maker, - database_async_read_write_engine, - database_async_read_write_session_maker, - httpx_client, -) +from src.config.dependencies import database_async_read_write_session_maker from src.domain.entities.agent_api_keys import AgentAPIKeyEntity from src.domain.entities.agents import AgentStatus from src.domain.repositories.agent_api_key_repository import AgentAPIKeyRepository @@ -73,13 +73,12 @@ def __init__(self, trigger: AgentAPIKeyEntity, **kwargs: Any) -> None: self.rejected = False async def issue_new_wss_url(self) -> str: - # Overridden rather than wrapped: slack_sdk also calls this on every - # reconnect, and on a revoked token its connect/monitor loops would retry - # (and log a traceback) every few seconds forever. + # slack_sdk also calls this on every reconnect, and on a revoked token its + # connect/monitor loops would retry (and log a traceback) every few seconds + # forever. The base method still handles rate limiting (it waits out + # Retry-After); only the errors no retry can fix stop the connection. try: - response = await self.web_client.apps_connections_open( - app_token=self.app_token - ) + return await super().issue_new_wss_url() except SlackApiError as exc: error = exc.response.get("error") if error in REJECTED_TOKEN_ERRORS: @@ -98,7 +97,52 @@ async def issue_new_wss_url(self) -> str: ) raise AppTokenRejected(error) from exc raise - return response["url"] + + +def _one_trigger_per_app( + triggers: list[AgentAPIKeyEntity], +) -> dict[str, AgentAPIKeyEntity]: + """Keep the earliest-registered trigger for each Slack app, keyed by trigger id. + + Slack hands each event to one of an app's connections, so two triggers for the + same app would each see only part of its events. Registration refuses a second + socket trigger for an app; this covers rows that predate that check. + """ + by_app: dict[str, list[AgentAPIKeyEntity]] = {} + for trigger in triggers: + by_app.setdefault(trigger.name or "", []).append(trigger) + kept: dict[str, AgentAPIKeyEntity] = {} + for app_id, candidates in by_app.items(): + candidates.sort(key=lambda t: (t.created_at is None, t.created_at, t.id)) + owner, *duplicates = candidates + if duplicates: + logger.error( + "Slack app %s has %d Socket Mode triggers; serving only trigger %s " + "(agent %s) and ignoring %s", + app_id, + len(candidates), + owner.id, + owner.agent_id, + ", ".join(t.id for t in duplicates), + ) + kept[owner.id] = owner + return kept + + +def _slack_signature_headers( + signing_secret: str, body: bytes, timestamp: int +) -> dict[str, str]: + """The headers Slack sets on an HTTP delivery, for the same body. + + An agent that checks Slack's v0 signature itself then accepts a socket delivery + exactly as it would an HTTP one. + """ + basis = f"v0:{timestamp}:".encode() + body + digest = hmac.new(signing_secret.encode(), basis, hashlib.sha256).hexdigest() + return { + "x-slack-request-timestamp": str(timestamp), + "x-slack-signature": f"v0={digest}", + } @dataclass @@ -153,10 +197,9 @@ async def _run(self) -> None: async def refresh(self) -> None: """Open connections for new triggers and close them for removed ones.""" - triggers = { - t.id: t - for t in await self._agent_api_key_repo.list_slack_socket_mode_triggers() - } + triggers = _one_trigger_per_app( + await self._agent_api_key_repo.list_slack_socket_mode_triggers() + ) self.ready = True for trigger_id, connection in list(self._connections.items()): trigger = triggers.get(trigger_id) @@ -262,10 +305,15 @@ async def forward_event( ) -> bool: """POST an Events API payload to the trigger's agent route. - Returns whether the agent accepted it (2xx) within the ack deadline; the + Returns whether the agent accepted it (2xx) within the ack deadline, or + declined a redelivery with ``X-Slack-No-Retry: 1`` as it can over HTTP; the caller acks only then, so anything else is redelivered by Slack. """ - headers = {"content-type": "application/json"} + body = json.dumps(payload).encode() + headers = { + "content-type": "application/json", + **_slack_signature_headers(trigger.api_key, body, int(time.time())), + } # Over HTTP Slack sends these only on redeliveries; the first delivery # over a socket has retry_attempt 0. if retry_attempt: @@ -288,7 +336,7 @@ async def forward_event( f"{(trigger.forward_path or '').lstrip('/')}" ) response = await self._http_client.post( - url, content=json.dumps(payload).encode(), headers=headers + url, content=body, headers=headers ) except (TimeoutError, httpx.HTTPError, ItemDoesNotExist) as exc: logger.warning( @@ -298,38 +346,37 @@ async def forward_event( type(exc).__name__, ) return False - if not response.is_success: - logger.warning( - "Agent %s answered %s to a Slack Socket Mode event for trigger %s; " - "leaving it unacked for redelivery", + if response.is_success: + return True + if response.headers.get("x-slack-no-retry") == "1": + logger.info( + "Agent %s answered %s with X-Slack-No-Retry to a Slack Socket Mode " + "event for trigger %s; acking so Slack does not redeliver it", trigger.agent_id, response.status_code, trigger.id, ) - return False - return True + return True + logger.warning( + "Agent %s answered %s to a Slack Socket Mode event for trigger %s; " + "leaving it unacked for redelivery", + trigger.agent_id, + response.status_code, + trigger.id, + ) + return False -def create_slack_socket_mode_bridge() -> SlackSocketModeBridge | None: - """Build the bridge from the global dependencies, or None if it can't run. +def create_slack_socket_mode_bridge( + engine: AsyncEngine, http_client: httpx.AsyncClient +) -> SlackSocketModeBridge: + """Build the bridge on one database engine and HTTP client. - App tokens are stored encrypted, so without the encryption key no trigger can - be served; refuse once here rather than failing per trigger. + The bridge only reads triggers and agents, so every session uses ``engine``. """ - if not credential_encryption.is_configured(): - logger.error( - "%s is not configured, so stored Slack app tokens cannot be read; " - "the Slack Socket Mode bridge will not start.", - credential_encryption.ENV_KEY, - ) - return None - engine = database_async_read_write_engine() - rw_session_maker = database_async_read_write_session_maker(engine) - ro_session_maker = database_async_read_only_session_maker(engine) + session_maker = database_async_read_write_session_maker(engine) return SlackSocketModeBridge( - agent_api_key_repository=AgentAPIKeyRepository( - rw_session_maker, ro_session_maker - ), - agent_repository=AgentRepository(rw_session_maker, ro_session_maker), - http_client=httpx_client(), + agent_api_key_repository=AgentAPIKeyRepository(session_maker, session_maker), + agent_repository=AgentRepository(session_maker, session_maker), + http_client=http_client, ) diff --git a/agentex/src/domain/use_cases/agent_api_keys_use_case.py b/agentex/src/domain/use_cases/agent_api_keys_use_case.py index bd759970..387c2469 100644 --- a/agentex/src/domain/use_cases/agent_api_keys_use_case.py +++ b/agentex/src/domain/use_cases/agent_api_keys_use_case.py @@ -226,6 +226,12 @@ async def get_by_agent_id_and_name( agent_id=agent_id, name=name, api_key_type=api_key_type ) + async def has_slack_socket_mode_trigger(self, app_id: str) -> bool: + """Whether a live agent already serves this Slack app over Socket Mode.""" + return bool( + await self.agent_api_key_repo.list_slack_socket_mode_triggers(app_id=app_id) + ) + async def get_external_by_agent_id_and_key( self, agent_id: str, api_key: str ) -> AgentAPIKeyEntity | None: diff --git a/agentex/src/run_slack_socket_mode_bridge.py b/agentex/src/run_slack_socket_mode_bridge.py index ea2143be..0d1d4e39 100644 --- a/agentex/src/run_slack_socket_mode_bridge.py +++ b/agentex/src/run_slack_socket_mode_bridge.py @@ -20,15 +20,17 @@ import signal from contextlib import AsyncExitStack +import httpx from aiohttp import web +from sqlalchemy.ext.asyncio import AsyncEngine, create_async_engine -from src.adapters.http.adapter_httpx import HttpxGateway -from src.config import dependencies -from src.config.dependencies import startup_global_dependencies +from src.config.environment_variables import EnvironmentVariables from src.domain.services.slack_socket_mode_bridge import ( SlackSocketModeBridge, create_slack_socket_mode_bridge, ) +from src.utils import credential_encryption +from src.utils.database import async_db_engine_creator from src.utils.logging import make_logger from src.utils.otel_metrics import shutdown_otel_metrics @@ -37,6 +39,23 @@ PROBE_PORT = 5004 +def create_engine(database_url: str) -> AsyncEngine: + """The bridge's only database connection: a small pool for trigger and agent reads. + + The bridge does not load the API's global dependencies (Temporal, MongoDB, + Redis, Kubernetes config); it needs none of them, and waiting on them would + delay the probe server. + """ + return create_async_engine( + "postgresql+asyncpg://", + async_creator=async_db_engine_creator(database_url), + pool_size=2, + max_overflow=3, + pool_pre_ping=True, + pool_recycle=3600, + ) + + def build_probe_app(bridge: SlackSocketModeBridge) -> web.Application: async def healthz(_: web.Request) -> web.Response: return web.Response(text="ok") @@ -58,15 +77,23 @@ async def main(probe_port: int = PROBE_PORT) -> None: cleanup.push_async_callback(asyncio.to_thread, observability.shutdown) else: cleanup.callback(shutdown_otel_metrics) - cleanup.callback(dependencies.shutdown) - cleanup.push_async_callback(dependencies.async_shutdown) - cleanup.push_async_callback(HttpxGateway.close_clients) - await startup_global_dependencies() - bridge = create_slack_socket_mode_bridge() - if bridge is None: + # App tokens are stored encrypted, so without the key no trigger can be + # served; refuse once here rather than failing per trigger. + if not credential_encryption.is_configured(): + logger.error( + "%s is not configured, so stored Slack app tokens cannot be read; " + "the Slack Socket Mode bridge will not start.", + credential_encryption.ENV_KEY, + ) raise SystemExit(1) + engine = create_engine(EnvironmentVariables.refresh().DATABASE_URL) + cleanup.push_async_callback(engine.dispose) + http_client = httpx.AsyncClient() + cleanup.push_async_callback(http_client.aclose) + bridge = create_slack_socket_mode_bridge(engine, http_client) + runner = web.AppRunner(build_probe_app(bridge)) await runner.setup() cleanup.push_async_callback(runner.cleanup) diff --git a/agentex/tests/unit/api/test_webhook_trigger.py b/agentex/tests/unit/api/test_webhook_trigger.py index ca9fb3a3..8040cc12 100644 --- a/agentex/tests/unit/api/test_webhook_trigger.py +++ b/agentex/tests/unit/api/test_webhook_trigger.py @@ -15,7 +15,15 @@ @pytest.mark.unit @pytest.mark.asyncio class TestCreateWebhookTrigger: - async def _call(self, monkeypatch, request, *, existing=None, base_env=None): + async def _call( + self, + monkeypatch, + request, + *, + existing=None, + base_env=None, + app_served_over_socket=False, + ): # The agent-authorization helper does real authz work; stub it to a no-op. monkeypatch.setattr(mod, "_check_agent_or_collapse_to_404", AsyncMock()) if base_env is not None: @@ -28,6 +36,9 @@ async def _call(self, monkeypatch, request, *, existing=None, base_env=None): akuc = MagicMock() akuc.get_by_agent_id_and_name = AsyncMock(return_value=existing) + akuc.has_slack_socket_mode_trigger = AsyncMock( + return_value=app_served_over_socket + ) akuc.create = AsyncMock( return_value=MagicMock(id="key-1", api_key_type=request.source) ) @@ -95,7 +106,9 @@ async def test_forward_path_reserved_chars_are_url_encoded(self, monkeypatch): name="o/r", forward_path="github-pr/cfg-9?mode=review#frag ment", ) - resp, _ = await self._call(monkeypatch, req, base_env="https://sgp.example.com/") + resp, _ = await self._call( + monkeypatch, req, base_env="https://sgp.example.com/" + ) assert ( resp.webhook_path @@ -154,7 +167,10 @@ async def test_slack_without_secret_rejected(self, monkeypatch): # Slack signs with the app's existing Signing Secret — we can't generate one, # so omitting it must 400 rather than store a random value that never matches. req = CreateWebhookTriggerRequest( - agent_name="a", source=AgentAPIKeyType.SLACK, name="my-app", forward_path="slack" + agent_name="a", + source=AgentAPIKeyType.SLACK, + name="my-app", + forward_path="slack", ) with pytest.raises(HTTPException) as exc: await self._call(monkeypatch, req) @@ -172,10 +188,29 @@ async def test_slack_with_provided_secret_ok(self, monkeypatch): assert resp.secret == "slack-signing-secret" assert akuc.create.await_args.kwargs["api_key"] == "slack-signing-secret" + async def test_second_socket_trigger_for_a_slack_app_conflicts(self, monkeypatch): + # Slack splits an app's events across its connections, so a second + # Socket Mode trigger would silently take part of the first one's events. + monkeypatch.setattr(mod.credential_encryption, "is_configured", lambda: True) + req = CreateWebhookTriggerRequest( + agent_name="b", + source=AgentAPIKeyType.SLACK, + name="A123", + forward_path="slack/events", + secret="slack-signing-secret", + app_token="xapp-1-A123-example", + ) + with pytest.raises(HTTPException) as exc: + await self._call(monkeypatch, req, app_served_over_socket=True) + assert exc.value.status_code == 409 + async def test_linear_without_secret_rejected(self, monkeypatch): # Linear signs with the OAuth app's webhook signing secret, like Slack. req = CreateWebhookTriggerRequest( - agent_name="a", source=AgentAPIKeyType.LINEAR, name="client-id", forward_path="linear/webhook" + agent_name="a", + source=AgentAPIKeyType.LINEAR, + name="client-id", + forward_path="linear/webhook", ) with pytest.raises(HTTPException) as exc: await self._call(monkeypatch, req) diff --git a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py index 5642de5e..56c8236a 100644 --- a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py +++ b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py @@ -1,18 +1,22 @@ """Ack and reconnect behaviour of the Slack Socket Mode bridge.""" import asyncio +from datetime import UTC, datetime from unittest.mock import AsyncMock, MagicMock import httpx import pytest +import slack_sdk.socket_mode.async_client as sdk_async_client import src.run_slack_socket_mode_bridge as entrypoint from slack_sdk.errors import SlackApiError from slack_sdk.socket_mode.request import SocketModeRequest from slack_sdk.web.async_client import AsyncWebClient +from slack_sdk.web.slack_response import SlackResponse from src.domain.entities.agent_api_keys import AgentAPIKeyEntity, AgentAPIKeyType from src.domain.entities.agents import AgentStatus from src.domain.services import slack_socket_mode_bridge as mod from src.domain.services.slack_socket_mode_bridge import SlackSocketModeBridge +from src.domain.use_cases.slack_gateway_use_case import verify_signature TRIGGER = AgentAPIKeyEntity( id="key-1", @@ -25,13 +29,13 @@ ) -def _bridge(handler) -> tuple[SlackSocketModeBridge, MagicMock]: +def _bridge(handler, triggers=(TRIGGER,)) -> tuple[SlackSocketModeBridge, MagicMock]: agent_repo = MagicMock() agent_repo.get = AsyncMock( return_value=MagicMock(status=AgentStatus.READY, acp_url="http://agent:8000") ) key_repo = MagicMock() - key_repo.list_slack_socket_mode_triggers = AsyncMock(return_value=[TRIGGER]) + key_repo.list_slack_socket_mode_triggers = AsyncMock(return_value=list(triggers)) bridge = SlackSocketModeBridge( agent_api_key_repository=key_repo, agent_repository=agent_repo, @@ -110,6 +114,104 @@ def handler(request: httpx.Request) -> httpx.Response: assert seen[0].headers["x-slack-retry-num"] == "2" assert seen[0].headers["x-slack-retry-reason"] == "timeout" + async def test_forward_passes_slacks_own_signature_check(self): + seen: list[httpx.Request] = [] + + def handler(request: httpx.Request) -> httpx.Response: + seen.append(request) + return httpx.Response(200) + + bridge, _ = _bridge(handler) + client = MagicMock(send_socket_mode_response=AsyncMock()) + + await bridge._on_request(TRIGGER, client, _envelope()) + + forwarded = seen[0] + assert verify_signature( + TRIGGER.api_key, + forwarded.headers["x-slack-request-timestamp"], + forwarded.headers["x-slack-signature"], + forwarded.content, + ) + assert not verify_signature( + "another-secret", + forwarded.headers["x-slack-request-timestamp"], + forwarded.headers["x-slack-signature"], + forwarded.content, + ) + + async def test_acks_when_agent_declines_redelivery(self): + bridge, _ = _bridge( + lambda request: httpx.Response(400, headers={"X-Slack-No-Retry": "1"}) + ) + client = MagicMock(send_socket_mode_response=AsyncMock()) + + await bridge._on_request(TRIGGER, client, _envelope()) + + client.send_socket_mode_response.assert_awaited_once() + + +@pytest.mark.unit +class TestOneConnectionPerApp: + async def test_only_the_earliest_trigger_for_an_app_connects(self, monkeypatch): + monkeypatch.setattr(mod.credential_encryption, "decrypt", lambda _: "xapp-1") + monkeypatch.setattr( + AsyncWebClient, + "apps_connections_open", + AsyncMock(return_value={"url": "wss://example.invalid"}), + ) + monkeypatch.setattr(mod._TriggerSocketModeClient, "connect", AsyncMock()) + later = TRIGGER.model_copy( + update={ + "id": "key-2", + "agent_id": "agent-2", + "created_at": datetime(2026, 2, 1, tzinfo=UTC), + } + ) + earlier = TRIGGER.model_copy( + update={"created_at": datetime(2026, 1, 1, tzinfo=UTC)} + ) + bridge, _ = _bridge(lambda request: httpx.Response(200), [later, earlier]) + + await bridge.refresh() + + assert list(bridge._connections) == [earlier.id] + await bridge.stop() + + +@pytest.mark.unit +class TestRateLimited: + async def test_rate_limit_waits_and_retries_instead_of_rejecting(self, monkeypatch): + rate_limited = SlackApiError( + "ratelimited", + SlackResponse( + client=None, + http_verb="POST", + api_url="https://slack.com/api/apps.connections.open", + req_args={}, + data={"ok": False, "error": "ratelimited"}, + headers={"Retry-After": "7"}, + status_code=429, + ), + ) + monkeypatch.setattr( + AsyncWebClient, + "apps_connections_open", + AsyncMock(side_effect=[rate_limited, {"url": "wss://example.invalid"}]), + ) + slept: list[float] = [] + + async def fake_sleep(delay: float) -> None: + slept.append(delay) + + monkeypatch.setattr(sdk_async_client.asyncio, "sleep", fake_sleep) + client = mod._TriggerSocketModeClient(trigger=TRIGGER, app_token="xapp-1") + + assert await client.issue_new_wss_url() == "wss://example.invalid" + assert slept == [7] + assert not client.rejected + await client.close() + @pytest.mark.unit class TestRejectedToken: @@ -156,12 +258,16 @@ async def test_stop_closes_open_sockets(self, monkeypatch): assert client.aiohttp_client_session.closed assert bridge._connections == {} - async def test_sigterm_path_stops_bridge(self, monkeypatch): + async def test_cancelling_main_stops_bridge_and_disposes_engine(self, monkeypatch): fake = MagicMock(start=AsyncMock(), stop=AsyncMock(), ready=True) - monkeypatch.setattr(entrypoint, "startup_global_dependencies", AsyncMock()) - monkeypatch.setattr(entrypoint, "create_slack_socket_mode_bridge", lambda: fake) - monkeypatch.setattr(entrypoint.dependencies, "async_shutdown", AsyncMock()) - monkeypatch.setattr(entrypoint.HttpxGateway, "close_clients", AsyncMock()) + engine = MagicMock(dispose=AsyncMock()) + monkeypatch.setattr( + entrypoint.credential_encryption, "is_configured", lambda: True + ) + monkeypatch.setattr(entrypoint, "create_engine", lambda url: engine) + monkeypatch.setattr( + entrypoint, "create_slack_socket_mode_bridge", lambda engine, client: fake + ) task = asyncio.create_task(entrypoint.main(probe_port=0)) while not fake.start.await_count: @@ -172,12 +278,15 @@ async def test_sigterm_path_stops_bridge(self, monkeypatch): await task fake.stop.assert_awaited_once() + engine.dispose.assert_awaited_once() async def test_refuses_to_start_without_encryption_key(self, monkeypatch): - monkeypatch.setattr(entrypoint, "startup_global_dependencies", AsyncMock()) - monkeypatch.setattr(mod.credential_encryption, "is_configured", lambda: False) - monkeypatch.setattr(entrypoint.dependencies, "async_shutdown", AsyncMock()) - monkeypatch.setattr(entrypoint.HttpxGateway, "close_clients", AsyncMock()) + create_engine = MagicMock() + monkeypatch.setattr(entrypoint, "create_engine", create_engine) + monkeypatch.setattr( + entrypoint.credential_encryption, "is_configured", lambda: False + ) with pytest.raises(SystemExit): await entrypoint.main(probe_port=0) + create_engine.assert_not_called() From 77085899ac3fa9d97c8f0bb8838dca172aac636f Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Tue, 17 Nov 2026 16:52:06 -0600 Subject: [PATCH 06/18] fix(agentex): name the Socket Mode columns for Slack and trim the bridge docs The new agent_api_keys columns become slack_socket_mode_app_token_encrypted and slack_socket_mode_forward_path, so the names say what they hold and the ORM comments go. The migration is unreleased, so it is edited in place. The docs point to Slack's Socket Mode guide for app setup and drop the operator notes that restated deployment detail. Co-Authored-By: Claude Opus 5.5 --- ..._api_key_slack_socket_mode_f3a5c7e9b1d2.py | 8 +++--- .../docs/docs/development_guides/webhooks.md | 11 +++----- agentex/src/adapters/orm.py | 8 ++---- agentex/src/api/routes/agent_api_keys.py | 4 +-- agentex/src/domain/entities/agent_api_keys.py | 4 +-- .../repositories/agent_api_key_repository.py | 2 +- .../services/slack_socket_mode_bridge.py | 26 +++++++++++++------ .../use_cases/agent_api_keys_use_case.py | 8 +++--- .../services/test_slack_socket_mode_bridge.py | 4 +-- 9 files changed, 38 insertions(+), 37 deletions(-) diff --git a/agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py b/agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py index 26b1052a..a786e118 100644 --- a/agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py +++ b/agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py @@ -24,14 +24,14 @@ def upgrade() -> None: op.execute( "ALTER TABLE agent_api_keys " - "ADD COLUMN IF NOT EXISTS app_token_encrypted VARCHAR, " - "ADD COLUMN IF NOT EXISTS forward_path VARCHAR;" + "ADD COLUMN IF NOT EXISTS slack_socket_mode_app_token_encrypted VARCHAR, " + "ADD COLUMN IF NOT EXISTS slack_socket_mode_forward_path VARCHAR;" ) def downgrade() -> None: op.execute( "ALTER TABLE agent_api_keys " - "DROP COLUMN IF EXISTS forward_path, " - "DROP COLUMN IF EXISTS app_token_encrypted;" + "DROP COLUMN IF EXISTS slack_socket_mode_forward_path, " + "DROP COLUMN IF EXISTS slack_socket_mode_app_token_encrypted;" ) diff --git a/agentex/docs/docs/development_guides/webhooks.md b/agentex/docs/docs/development_guides/webhooks.md index cd33c29f..3b2c07a9 100644 --- a/agentex/docs/docs/development_guides/webhooks.md +++ b/agentex/docs/docs/development_guides/webhooks.md @@ -179,8 +179,8 @@ curl -X POST $HOST/agent_api_keys \ #### Slack over Socket Mode -If Slack cannot reach agentex over HTTP (for example, the ingress only admits an IP allowlist, and Slack publishes no source IPs), agentex can receive the app's events over [Socket Mode](https://docs.slack.dev/apis/events-api/using-socket-mode) instead. -Create an app-level token with the `connections:write` scope under Basic Information, enable Socket Mode on the app, and register the trigger with that token: +If Slack cannot reach agentex over HTTP (for example, when agentex runs in a private network), agentex can receive the app's events over [Socket Mode](https://docs.slack.dev/apis/events-api/using-socket-mode) instead. +Enable Socket Mode on the app and create an app-level token as that guide describes, then register the trigger with that token: ```bash curl -X POST $HOST/agent_api_keys/webhook-trigger \ @@ -204,12 +204,7 @@ Interactivity and slash-command payloads are not forwarded. Operator notes: -- The bridge is its own process, not part of the API: run `python -m src.run_slack_socket_mode_bridge` (from `agentex/`, the same image as the API, like the Temporal worker's `python -m src.temporal.run_worker`) as a separate Deployment with 2 replicas, one process each. It needs only `DATABASE_URL` and `AGENTEX_CREDENTIAL_ENCRYPTION_KEY`, which encrypts the stored app token; without that key it logs one error and exits. It does not connect to Temporal, MongoDB or Redis. API pods never open sockets. -- Probes are served on port 5004: `/healthz` for liveness and `/readyz` for readiness. Readiness means the trigger list has loaded; it does not wait for every Slack connection, so one revoked token doesn't take a replica out. -- On SIGTERM the bridge closes its sockets, and Slack moves delivery to the other replica. -- **One owner per Slack app.** Slack delivers each event to one of the app's open connections. If an agent, or a second agentex environment, also opens a socket for the same app, events are split between them and each side misses some. Register a given app's token in exactly one environment, and remove any Socket Mode client from the agent. Within one environment, registering a second Socket Mode trigger for an app another trigger already serves returns 409; if two such triggers exist anyway, the bridge connects only the earliest-registered one and logs an error. -- Each bridge replica opens one connection per app, so connections per app equal the replica count. Slack allows at most 10 per app; keep the replica count at or below that. -- If Slack rejects the token (revoked, invalid, wrong type), agentex logs one error and stops that app's connection. To change the token, delete the trigger and register it again; agentex picks up added and removed triggers within a minute. +- The bridge is its own process, not part of the API: run `python -m src.run_slack_socket_mode_bridge` (from `agentex/`, the same image as the API, like the Temporal worker's `python -m src.temporal.run_worker`) as a separate Deployment with 2 replicas, one process each. It needs only `DATABASE_URL` and `AGENTEX_CREDENTIAL_ENCRYPTION_KEY`, which encrypts the stored app token; without that key it logs one error and exits. It does not connect to Temporal, MongoDB or Redis. ### Deleting API Keys diff --git a/agentex/src/adapters/orm.py b/agentex/src/adapters/orm.py index b867d4f2..de9a4b10 100644 --- a/agentex/src/adapters/orm.py +++ b/agentex/src/adapters/orm.py @@ -186,12 +186,8 @@ class AgentAPIKeyORM(BaseORM): name = Column(String(256), nullable=False, index=True) api_key_type = Column(SQLAlchemyEnum(AgentAPIKeyType), nullable=False) api_key = Column(String, nullable=False) - # Slack app-level token (Fernet, src/utils/credential_encryption.py); set only on - # Slack triggers whose events arrive over Socket Mode instead of HTTP. - app_token_encrypted = Column(String, nullable=True) - # The agent subpath a socket-delivered event is POSTed to. Over HTTP it is read - # from the request URL, which a socket delivery does not have. - forward_path = Column(String, nullable=True) + slack_socket_mode_app_token_encrypted = Column(String, nullable=True) + slack_socket_mode_forward_path = Column(String, nullable=True) # Indexes for efficient querying __table_args__ = ( diff --git a/agentex/src/api/routes/agent_api_keys.py b/agentex/src/api/routes/agent_api_keys.py index a79abcdf..9ea4ad19 100644 --- a/agentex/src/api/routes/agent_api_keys.py +++ b/agentex/src/api/routes/agent_api_keys.py @@ -219,8 +219,8 @@ async def create_webhook_trigger( api_key=str(secret), name=request.name, api_key_type=request.source, - app_token_encrypted=app_token_encrypted, - forward_path=forward_path if app_token_encrypted else None, + slack_socket_mode_app_token_encrypted=app_token_encrypted, + slack_socket_mode_forward_path=forward_path if app_token_encrypted else None, ) encoded_agent_name = quote(request.agent_name, safe="") diff --git a/agentex/src/domain/entities/agent_api_keys.py b/agentex/src/domain/entities/agent_api_keys.py index c774cf01..fa137930 100644 --- a/agentex/src/domain/entities/agent_api_keys.py +++ b/agentex/src/domain/entities/agent_api_keys.py @@ -26,11 +26,11 @@ class AgentAPIKeyEntity(BaseModel): description="The type of the API key (either internal or external)", ) api_key: str = Field(..., description="The API key") - app_token_encrypted: str | None = Field( + slack_socket_mode_app_token_encrypted: str | None = Field( None, description="Encrypted Slack app-level token; set when the trigger is served " "over Socket Mode.", ) - forward_path: str | None = Field( + slack_socket_mode_forward_path: str | None = Field( None, description="Agent subpath a Socket Mode event is forwarded to." ) diff --git a/agentex/src/domain/repositories/agent_api_key_repository.py b/agentex/src/domain/repositories/agent_api_key_repository.py index c4bd2dd0..8d481bfd 100644 --- a/agentex/src/domain/repositories/agent_api_key_repository.py +++ b/agentex/src/domain/repositories/agent_api_key_repository.py @@ -186,7 +186,7 @@ async def list_slack_socket_mode_triggers( .join(AgentORM, AgentORM.id == AgentAPIKeyORM.agent_id) .where( AgentAPIKeyORM.api_key_type == AgentAPIKeyType.SLACK, - AgentAPIKeyORM.app_token_encrypted.is_not(None), + AgentAPIKeyORM.slack_socket_mode_app_token_encrypted.is_not(None), AgentORM.status != AgentStatus.DELETED, ) ) diff --git a/agentex/src/domain/services/slack_socket_mode_bridge.py b/agentex/src/domain/services/slack_socket_mode_bridge.py index 8e14f962..17112c41 100644 --- a/agentex/src/domain/services/slack_socket_mode_bridge.py +++ b/agentex/src/domain/services/slack_socket_mode_bridge.py @@ -205,7 +205,8 @@ async def refresh(self) -> None: trigger = triggers.get(trigger_id) if ( trigger is None - or trigger.app_token_encrypted != connection.app_token_encrypted + or trigger.slack_socket_mode_app_token_encrypted + != connection.app_token_encrypted or connection.client.closed ): if connection.client.rejected: @@ -214,21 +215,28 @@ async def refresh(self) -> None: for trigger in triggers.values(): if trigger.id in self._connections: continue - if (trigger.id, trigger.app_token_encrypted) in self._rejected: + if ( + trigger.id, + trigger.slack_socket_mode_app_token_encrypted, + ) in self._rejected: continue await self._open(trigger) async def _open(self, trigger: AgentAPIKeyEntity) -> None: - assert trigger.app_token_encrypted + assert trigger.slack_socket_mode_app_token_encrypted try: - app_token = credential_encryption.decrypt(trigger.app_token_encrypted) + app_token = credential_encryption.decrypt( + trigger.slack_socket_mode_app_token_encrypted + ) except credential_encryption.CredentialEncryptionError as exc: logger.error( "Cannot read the app token for Slack Socket Mode trigger %s: %s", trigger.id, exc, ) - self._rejected.add((trigger.id, trigger.app_token_encrypted)) + self._rejected.add( + (trigger.id, trigger.slack_socket_mode_app_token_encrypted) + ) return client = _TriggerSocketModeClient(trigger=trigger, app_token=app_token) @@ -238,7 +246,9 @@ async def _open(self, trigger: AgentAPIKeyEntity) -> None: # inside connect()'s retry loop; connect() reuses the URL. client.wss_uri = await client.issue_new_wss_url() except AppTokenRejected: - self._rejected.add((trigger.id, trigger.app_token_encrypted)) + self._rejected.add( + (trigger.id, trigger.slack_socket_mode_app_token_encrypted) + ) await client.close() return except Exception as exc: @@ -249,7 +259,7 @@ async def _open(self, trigger: AgentAPIKeyEntity) -> None: type(exc).__name__, ) self._connections[trigger.id] = _Connection( - app_token_encrypted=trigger.app_token_encrypted, + app_token_encrypted=trigger.slack_socket_mode_app_token_encrypted, client=client, connect_task=asyncio.create_task(client.connect()), ) @@ -333,7 +343,7 @@ async def forward_event( return False url = ( f"{resolve_acp_url(agent.acp_url)}/" - f"{(trigger.forward_path or '').lstrip('/')}" + f"{(trigger.slack_socket_mode_forward_path or '').lstrip('/')}" ) response = await self._http_client.post( url, content=body, headers=headers diff --git a/agentex/src/domain/use_cases/agent_api_keys_use_case.py b/agentex/src/domain/use_cases/agent_api_keys_use_case.py index 387c2469..a61280d8 100644 --- a/agentex/src/domain/use_cases/agent_api_keys_use_case.py +++ b/agentex/src/domain/use_cases/agent_api_keys_use_case.py @@ -107,8 +107,8 @@ async def create( agent_id: str, api_key_type: AgentAPIKeyType, api_key: str, - app_token_encrypted: str | None = None, - forward_path: str | None = None, + slack_socket_mode_app_token_encrypted: str | None = None, + slack_socket_mode_forward_path: str | None = None, ) -> AgentAPIKeyEntity: agent = await self.get_agent(agent_id=agent_id) if not agent: @@ -132,8 +132,8 @@ async def create( agent_id=agent.id, api_key_type=api_key_type, api_key=api_key, - app_token_encrypted=app_token_encrypted, - forward_path=forward_path, + slack_socket_mode_app_token_encrypted=slack_socket_mode_app_token_encrypted, + slack_socket_mode_forward_path=slack_socket_mode_forward_path, ) return await self.agent_api_key_repo.create(item=agent_api_key) diff --git a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py index 56c8236a..09447fd5 100644 --- a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py +++ b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py @@ -24,8 +24,8 @@ name="A123", api_key_type=AgentAPIKeyType.SLACK, api_key="signing-secret", - app_token_encrypted="ciphertext", - forward_path="slack/events", + slack_socket_mode_app_token_encrypted="ciphertext", + slack_socket_mode_forward_path="slack/events", ) From 19fb99c57d16082698bfa65d898e5f690070ec7b Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Tue, 17 Nov 2026 17:30:56 -0600 Subject: [PATCH 07/18] refactor(agentex): keep Slack Socket Mode settings in their own table agent_api_keys holds one secret per row. The app token and forward path are a second credential and a routing setting that only some Slack triggers have, so they move to slack_socket_mode_apps: one row per Slack app, keyed to its trigger with ON DELETE CASCADE. A unique constraint on slack_app_id now enforces one owner per app, which the route's check-then-insert could not under concurrent registrations. The route maps the violation to the same 409, and the bridge no longer picks a winner among duplicate triggers. Soft-deleting an agent keeps its keys, so registration first drops a row left by a deleted agent. The migration replaces the unreleased add-columns revision under the same id. Co-Authored-By: Claude Opus 5.5 --- ..._api_key_slack_socket_mode_f3a5c7e9b1d2.py | 37 -------- ...200_slack_socket_mode_apps_f3a5c7e9b1d2.py | 48 ++++++++++ agentex/src/adapters/orm.py | 30 ++++++- agentex/src/api/routes/agent_api_keys.py | 43 +++++---- agentex/src/domain/entities/agent_api_keys.py | 28 ++++-- .../repositories/agent_api_key_repository.py | 84 +++++++++++++---- .../services/slack_socket_mode_bridge.py | 89 ++++++------------- .../use_cases/agent_api_keys_use_case.py | 23 +++-- .../test_slack_socket_mode_apps.py | 82 +++++++++++++++++ .../tests/unit/api/test_webhook_trigger.py | 26 +++++- .../services/test_slack_socket_mode_bridge.py | 63 +++++-------- 11 files changed, 367 insertions(+), 186 deletions(-) delete mode 100644 agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py create mode 100644 agentex/database/migrations/alembic/versions/2026_11_16_1200_slack_socket_mode_apps_f3a5c7e9b1d2.py create mode 100644 agentex/tests/integration/api/agent_api_keys/test_slack_socket_mode_apps.py diff --git a/agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py b/agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py deleted file mode 100644 index a786e118..00000000 --- a/agentex/database/migrations/alembic/versions/2026_11_16_1200_agent_api_key_slack_socket_mode_f3a5c7e9b1d2.py +++ /dev/null @@ -1,37 +0,0 @@ -"""agent api key slack socket mode - -Revision ID: f3a5c7e9b1d2 -Revises: e2f4a6c8b0d1 -Create Date: 2026-11-16 12:00:00.000000 - -Adds two nullable columns to ``agent_api_keys`` so a Slack webhook trigger can be -served over Socket Mode: the encrypted app-level token and the agent subpath to -forward to. Metadata-only (nullable, no default, no backfill); IF NOT EXISTS makes -a re-run a no-op. -""" - -from collections.abc import Sequence - -from alembic import op - -# revision identifiers, used by Alembic. -revision: str = "f3a5c7e9b1d2" -down_revision: str | None = "e2f4a6c8b0d1" -branch_labels: str | Sequence[str] | None = None -depends_on: str | Sequence[str] | None = None - - -def upgrade() -> None: - op.execute( - "ALTER TABLE agent_api_keys " - "ADD COLUMN IF NOT EXISTS slack_socket_mode_app_token_encrypted VARCHAR, " - "ADD COLUMN IF NOT EXISTS slack_socket_mode_forward_path VARCHAR;" - ) - - -def downgrade() -> None: - op.execute( - "ALTER TABLE agent_api_keys " - "DROP COLUMN IF EXISTS slack_socket_mode_forward_path, " - "DROP COLUMN IF EXISTS slack_socket_mode_app_token_encrypted;" - ) diff --git a/agentex/database/migrations/alembic/versions/2026_11_16_1200_slack_socket_mode_apps_f3a5c7e9b1d2.py b/agentex/database/migrations/alembic/versions/2026_11_16_1200_slack_socket_mode_apps_f3a5c7e9b1d2.py new file mode 100644 index 00000000..f9a31d0a --- /dev/null +++ b/agentex/database/migrations/alembic/versions/2026_11_16_1200_slack_socket_mode_apps_f3a5c7e9b1d2.py @@ -0,0 +1,48 @@ +"""slack socket mode apps + +Revision ID: f3a5c7e9b1d2 +Revises: e2f4a6c8b0d1 +Create Date: 2026-11-16 12:00:00.000000 + +Creates ``slack_socket_mode_apps``: one row per Slack app whose events agentex +receives over Socket Mode, attached to the app's Slack webhook trigger in +``agent_api_keys``. The table is new and empty, so its constraints build without +scanning anything; the foreign key briefly locks ``agent_api_keys`` and does not scan +it. IF NOT EXISTS makes a re-run a no-op. +""" + +from collections.abc import Sequence + +from alembic import op + +# revision identifiers, used by Alembic. +revision: str = "f3a5c7e9b1d2" +down_revision: str | None = "e2f4a6c8b0d1" +branch_labels: str | Sequence[str] | None = None +depends_on: str | Sequence[str] | None = None + + +def upgrade() -> None: + op.execute( + """ + CREATE TABLE IF NOT EXISTS slack_socket_mode_apps ( + id VARCHAR NOT NULL PRIMARY KEY, + agent_api_key_id VARCHAR NOT NULL, + agent_id VARCHAR(64) NOT NULL, + slack_app_id VARCHAR(256) NOT NULL, + app_token_encrypted VARCHAR NOT NULL, + forward_path VARCHAR NOT NULL, + created_at TIMESTAMP WITH TIME ZONE DEFAULT now(), + CONSTRAINT uq_slack_socket_mode_apps_slack_app_id UNIQUE (slack_app_id), + CONSTRAINT uq_slack_socket_mode_apps_agent_api_key + UNIQUE (agent_api_key_id, agent_id), + CONSTRAINT fk_slack_socket_mode_apps_agent_api_key + FOREIGN KEY (agent_api_key_id, agent_id) + REFERENCES agent_api_keys (id, agent_id) ON DELETE CASCADE + ); + """ + ) + + +def downgrade() -> None: + op.execute("DROP TABLE IF EXISTS slack_socket_mode_apps;") diff --git a/agentex/src/adapters/orm.py b/agentex/src/adapters/orm.py index de9a4b10..95a5fe8d 100644 --- a/agentex/src/adapters/orm.py +++ b/agentex/src/adapters/orm.py @@ -5,11 +5,13 @@ Column, DateTime, ForeignKey, + ForeignKeyConstraint, Index, Integer, LargeBinary, String, Text, + UniqueConstraint, func, text, ) @@ -186,8 +188,6 @@ class AgentAPIKeyORM(BaseORM): name = Column(String(256), nullable=False, index=True) api_key_type = Column(SQLAlchemyEnum(AgentAPIKeyType), nullable=False) api_key = Column(String, nullable=False) - slack_socket_mode_app_token_encrypted = Column(String, nullable=True) - slack_socket_mode_forward_path = Column(String, nullable=True) # Indexes for efficient querying __table_args__ = ( @@ -204,6 +204,32 @@ class AgentAPIKeyORM(BaseORM): ) +class SlackSocketModeAppORM(BaseORM): + __tablename__ = "slack_socket_mode_apps" + id = Column(String, primary_key=True, default=orm_id) + agent_api_key_id = Column(String, nullable=False) + agent_id = Column(String(64), nullable=False) + slack_app_id = Column(String(256), nullable=False) + app_token_encrypted = Column(String, nullable=False) + forward_path = Column(String, nullable=False) + created_at = Column(DateTime(timezone=True), server_default=func.now()) + + __table_args__ = ( + UniqueConstraint("slack_app_id", name="uq_slack_socket_mode_apps_slack_app_id"), + UniqueConstraint( + "agent_api_key_id", + "agent_id", + name="uq_slack_socket_mode_apps_agent_api_key", + ), + ForeignKeyConstraint( + ["agent_api_key_id", "agent_id"], + ["agent_api_keys.id", "agent_api_keys.agent_id"], + ondelete="CASCADE", + name="fk_slack_socket_mode_apps_agent_api_key", + ), + ) + + class AgentRunScheduleORM(BaseORM): __tablename__ = "agent_run_schedules" id = Column(String, primary_key=True, default=orm_id) diff --git a/agentex/src/api/routes/agent_api_keys.py b/agentex/src/api/routes/agent_api_keys.py index 9ea4ad19..88fc9626 100644 --- a/agentex/src/api/routes/agent_api_keys.py +++ b/agentex/src/api/routes/agent_api_keys.py @@ -4,7 +4,7 @@ from fastapi import APIRouter, HTTPException, Query -from src.adapters.crud_store.exceptions import ItemDoesNotExist +from src.adapters.crud_store.exceptions import DuplicateItemError, ItemDoesNotExist from src.api.schemas.agent_api_keys import ( AgentAPIKey, CreateAPIKeyRequest, @@ -102,6 +102,14 @@ async def create_api_key( ) +def _slack_app_already_served(app_id: str) -> HTTPException: + return HTTPException( + status_code=409, + detail=f"Slack app '{app_id}' is already served over Socket Mode by another " + "trigger; delete that trigger first.", + ) + + @router.post( "/webhook-trigger", response_model=CreateWebhookTriggerResponse, @@ -204,24 +212,29 @@ async def create_webhook_trigger( ) # Slack gives each event to one of an app's connections, so a second # Socket Mode trigger for the same app would take part of the first - # one's events. + # one's events. The table's unique constraint enforces this; checking first + # keeps the auth registration in create() from running for a request that + # is bound to fail. if await agent_api_key_use_case.has_slack_socket_mode_trigger(request.name): - raise HTTPException( - status_code=409, - detail=f"Slack app '{request.name}' is already served over Socket " - "Mode by another trigger; delete that trigger first.", - ) + raise _slack_app_already_served(request.name) app_token_encrypted = credential_encryption.encrypt(request.app_token) secret = request.secret if request.secret is not None else secrets.token_hex(32) - agent_api_key_entity = await agent_api_key_use_case.create( - agent_id=agent.id, - api_key=str(secret), - name=request.name, - api_key_type=request.source, - slack_socket_mode_app_token_encrypted=app_token_encrypted, - slack_socket_mode_forward_path=forward_path if app_token_encrypted else None, - ) + try: + agent_api_key_entity = await agent_api_key_use_case.create( + agent_id=agent.id, + api_key=str(secret), + name=request.name, + api_key_type=request.source, + slack_socket_mode_app_token_encrypted=app_token_encrypted, + slack_socket_mode_forward_path=forward_path, + ) + except DuplicateItemError: + # Only the Socket Mode insert has a unique key a client can collide on: a + # concurrent registration for the same app got there first. + if app_token_encrypted is None: + raise + raise _slack_app_already_served(request.name) from None encoded_agent_name = quote(request.agent_name, safe="") encoded_forward_path = quote(forward_path, safe="/") diff --git a/agentex/src/domain/entities/agent_api_keys.py b/agentex/src/domain/entities/agent_api_keys.py index fa137930..4fb97b36 100644 --- a/agentex/src/domain/entities/agent_api_keys.py +++ b/agentex/src/domain/entities/agent_api_keys.py @@ -26,11 +26,27 @@ class AgentAPIKeyEntity(BaseModel): description="The type of the API key (either internal or external)", ) api_key: str = Field(..., description="The API key") - slack_socket_mode_app_token_encrypted: str | None = Field( - None, - description="Encrypted Slack app-level token; set when the trigger is served " - "over Socket Mode.", + + +class SlackSocketModeAppEntity(BaseModel): + """A Slack app whose events agentex receives over Socket Mode. + + Attached to the app's Slack webhook trigger (an ``AgentAPIKeyEntity`` of type + ``slack``), which still holds the signing secret. + """ + + id: str = Field(..., description="The unique identifier of the row.") + agent_api_key_id: str = Field( + ..., description="The Slack webhook trigger this app's events are served for." + ) + agent_id: str = Field(..., description="The agent that owns the trigger.") + slack_app_id: str = Field( + ..., description="The Slack app id; at most one row per app." + ) + app_token_encrypted: str = Field( + ..., description="The app-level token (xapp-...), encrypted." ) - slack_socket_mode_forward_path: str | None = Field( - None, description="Agent subpath a Socket Mode event is forwarded to." + forward_path: str = Field( + ..., description="The agent subpath each event is POSTed to." ) + created_at: datetime | None = Field(None, description="When the row was created.") diff --git a/agentex/src/domain/repositories/agent_api_key_repository.py b/agentex/src/domain/repositories/agent_api_key_repository.py index 8d481bfd..30d1c9e6 100644 --- a/agentex/src/domain/repositories/agent_api_key_repository.py +++ b/agentex/src/domain/repositories/agent_api_key_repository.py @@ -2,17 +2,22 @@ from typing import Annotated from fastapi import Depends -from sqlalchemy import select +from sqlalchemy import delete, insert, select from src.adapters.crud_store.adapter_postgres import ( PostgresCRUDRepository, + async_sql_exception_handler, ) from src.adapters.crud_store.exceptions import ItemDoesNotExist -from src.adapters.orm import AgentAPIKeyORM, AgentORM +from src.adapters.orm import AgentAPIKeyORM, AgentORM, SlackSocketModeAppORM from src.config.dependencies import ( DDatabaseAsyncReadOnlySessionMaker, DDatabaseAsyncReadWriteSessionMaker, ) -from src.domain.entities.agent_api_keys import AgentAPIKeyEntity, AgentAPIKeyType +from src.domain.entities.agent_api_keys import ( + AgentAPIKeyEntity, + AgentAPIKeyType, + SlackSocketModeAppEntity, +) from src.domain.entities.agents import AgentStatus from src.utils.logging import make_logger @@ -172,29 +177,74 @@ async def get_external_by_agent_id_and_key( row = result.scalars().first() return AgentAPIKeyEntity.model_validate(row) if row else None - async def list_slack_socket_mode_triggers( - self, app_id: str | None = None - ) -> builtins.list[AgentAPIKeyEntity]: - """Slack triggers that carry an app token, on agents that are not deleted. + async def create_with_slack_socket_mode_app( + self, item: AgentAPIKeyEntity, app: SlackSocketModeAppEntity + ) -> AgentAPIKeyEntity: + """Create a Slack trigger and its Socket Mode app row in one transaction. + + A row left behind by a soft-deleted agent is removed first: deleting an agent + keeps its keys, and the app must stay registrable on another agent. + + Raises: + DuplicateItemError: A live agent already serves this Slack app. + """ + async with ( + self.start_async_db_session(True) as session, + async_sql_exception_handler(), + ): + deleted_agents = select(AgentORM.id).where( + AgentORM.status == AgentStatus.DELETED + ) + await session.execute( + delete(SlackSocketModeAppORM).where( + SlackSocketModeAppORM.slack_app_id == app.slack_app_id, + SlackSocketModeAppORM.agent_id.in_(deleted_agents), + ) + ) + values = {k: v for k, v in item.to_dict().items() if v is not None} + row = ( + await session.execute( + insert(AgentAPIKeyORM) + .values(**values) + .returning(*AgentAPIKeyORM.__table__.columns) + ) + ).one() + await session.execute( + insert(SlackSocketModeAppORM).values( + **{k: v for k, v in app.to_dict().items() if v is not None} + ) + ) + await session.commit() + return AgentAPIKeyEntity.model_validate(dict(row._mapping)) + + async def list_slack_socket_mode_apps( + self, slack_app_id: str | None = None + ) -> builtins.list[tuple[AgentAPIKeyEntity, SlackSocketModeAppEntity]]: + """Socket Mode apps on agents that are not deleted, each with its trigger. Args: - app_id: Only triggers for this Slack app (the trigger name), if given. + slack_app_id: Only this Slack app, if given. """ async with self.start_async_db_session(allow_writes=False) as session: query = ( - select(AgentAPIKeyORM) - .join(AgentORM, AgentORM.id == AgentAPIKeyORM.agent_id) - .where( - AgentAPIKeyORM.api_key_type == AgentAPIKeyType.SLACK, - AgentAPIKeyORM.slack_socket_mode_app_token_encrypted.is_not(None), - AgentORM.status != AgentStatus.DELETED, + select(AgentAPIKeyORM, SlackSocketModeAppORM) + .join( + SlackSocketModeAppORM, + (SlackSocketModeAppORM.agent_api_key_id == AgentAPIKeyORM.id) + & (SlackSocketModeAppORM.agent_id == AgentAPIKeyORM.agent_id), ) + .join(AgentORM, AgentORM.id == AgentAPIKeyORM.agent_id) + .where(AgentORM.status != AgentStatus.DELETED) ) - if app_id is not None: - query = query.where(AgentAPIKeyORM.name == app_id) + if slack_app_id is not None: + query = query.where(SlackSocketModeAppORM.slack_app_id == slack_app_id) result = await session.execute(query) return [ - AgentAPIKeyEntity.model_validate(row) for row in result.scalars().all() + ( + AgentAPIKeyEntity.model_validate(trigger), + SlackSocketModeAppEntity.model_validate(app), + ) + for trigger, app in result.all() ] async def delete_by_agent_name_and_key_name( diff --git a/agentex/src/domain/services/slack_socket_mode_bridge.py b/agentex/src/domain/services/slack_socket_mode_bridge.py index 17112c41..99483427 100644 --- a/agentex/src/domain/services/slack_socket_mode_bridge.py +++ b/agentex/src/domain/services/slack_socket_mode_bridge.py @@ -35,7 +35,10 @@ from src.adapters.crud_store.exceptions import ItemDoesNotExist from src.config.dependencies import database_async_read_write_session_maker -from src.domain.entities.agent_api_keys import AgentAPIKeyEntity +from src.domain.entities.agent_api_keys import ( + AgentAPIKeyEntity, + SlackSocketModeAppEntity, +) from src.domain.entities.agents import AgentStatus from src.domain.repositories.agent_api_key_repository import AgentAPIKeyRepository from src.domain.repositories.agent_repository import AgentRepository @@ -99,36 +102,6 @@ async def issue_new_wss_url(self) -> str: raise -def _one_trigger_per_app( - triggers: list[AgentAPIKeyEntity], -) -> dict[str, AgentAPIKeyEntity]: - """Keep the earliest-registered trigger for each Slack app, keyed by trigger id. - - Slack hands each event to one of an app's connections, so two triggers for the - same app would each see only part of its events. Registration refuses a second - socket trigger for an app; this covers rows that predate that check. - """ - by_app: dict[str, list[AgentAPIKeyEntity]] = {} - for trigger in triggers: - by_app.setdefault(trigger.name or "", []).append(trigger) - kept: dict[str, AgentAPIKeyEntity] = {} - for app_id, candidates in by_app.items(): - candidates.sort(key=lambda t: (t.created_at is None, t.created_at, t.id)) - owner, *duplicates = candidates - if duplicates: - logger.error( - "Slack app %s has %d Socket Mode triggers; serving only trigger %s " - "(agent %s) and ignoring %s", - app_id, - len(candidates), - owner.id, - owner.agent_id, - ", ".join(t.id for t in duplicates), - ) - kept[owner.id] = owner - return kept - - def _slack_signature_headers( signing_secret: str, body: bytes, timestamp: int ) -> dict[str, str]: @@ -197,58 +170,52 @@ async def _run(self) -> None: async def refresh(self) -> None: """Open connections for new triggers and close them for removed ones.""" - triggers = _one_trigger_per_app( - await self._agent_api_key_repo.list_slack_socket_mode_triggers() - ) + served = { + trigger.id: (trigger, app) + for trigger, app in await self._agent_api_key_repo.list_slack_socket_mode_apps() + } self.ready = True for trigger_id, connection in list(self._connections.items()): - trigger = triggers.get(trigger_id) + current = served.get(trigger_id) if ( - trigger is None - or trigger.slack_socket_mode_app_token_encrypted - != connection.app_token_encrypted + current is None + or current[1].app_token_encrypted != connection.app_token_encrypted or connection.client.closed ): if connection.client.rejected: self._rejected.add((trigger_id, connection.app_token_encrypted)) await self._close(trigger_id) - for trigger in triggers.values(): + for trigger, app in served.values(): if trigger.id in self._connections: continue - if ( - trigger.id, - trigger.slack_socket_mode_app_token_encrypted, - ) in self._rejected: + if (trigger.id, app.app_token_encrypted) in self._rejected: continue - await self._open(trigger) + await self._open(trigger, app) - async def _open(self, trigger: AgentAPIKeyEntity) -> None: - assert trigger.slack_socket_mode_app_token_encrypted + async def _open( + self, trigger: AgentAPIKeyEntity, app: SlackSocketModeAppEntity + ) -> None: try: - app_token = credential_encryption.decrypt( - trigger.slack_socket_mode_app_token_encrypted - ) + app_token = credential_encryption.decrypt(app.app_token_encrypted) except credential_encryption.CredentialEncryptionError as exc: logger.error( "Cannot read the app token for Slack Socket Mode trigger %s: %s", trigger.id, exc, ) - self._rejected.add( - (trigger.id, trigger.slack_socket_mode_app_token_encrypted) - ) + self._rejected.add((trigger.id, app.app_token_encrypted)) return client = _TriggerSocketModeClient(trigger=trigger, app_token=app_token) - client.socket_mode_request_listeners.append(partial(self._on_request, trigger)) + client.socket_mode_request_listeners.append( + partial(self._on_request, trigger, app) + ) try: # Called once up front so a rejected token stops here instead of # inside connect()'s retry loop; connect() reuses the URL. client.wss_uri = await client.issue_new_wss_url() except AppTokenRejected: - self._rejected.add( - (trigger.id, trigger.slack_socket_mode_app_token_encrypted) - ) + self._rejected.add((trigger.id, app.app_token_encrypted)) await client.close() return except Exception as exc: @@ -259,7 +226,7 @@ async def _open(self, trigger: AgentAPIKeyEntity) -> None: type(exc).__name__, ) self._connections[trigger.id] = _Connection( - app_token_encrypted=trigger.slack_socket_mode_app_token_encrypted, + app_token_encrypted=app.app_token_encrypted, client=client, connect_task=asyncio.create_task(client.connect()), ) @@ -284,6 +251,7 @@ async def _close(self, trigger_id: str) -> None: async def _on_request( self, trigger: AgentAPIKeyEntity, + app: SlackSocketModeAppEntity, client: SocketModeClient, request: SocketModeRequest, ) -> None: @@ -298,6 +266,7 @@ async def _on_request( return if await self.forward_event( trigger, + app, request.payload, retry_attempt=request.retry_attempt, retry_reason=request.retry_reason, @@ -309,6 +278,7 @@ async def _on_request( async def forward_event( self, trigger: AgentAPIKeyEntity, + app: SlackSocketModeAppEntity, payload: dict, retry_attempt: int | None, retry_reason: str | None, @@ -341,10 +311,7 @@ async def forward_event( trigger.agent_id, ) return False - url = ( - f"{resolve_acp_url(agent.acp_url)}/" - f"{(trigger.slack_socket_mode_forward_path or '').lstrip('/')}" - ) + url = f"{resolve_acp_url(agent.acp_url)}/{app.forward_path.lstrip('/')}" response = await self._http_client.post( url, content=body, headers=headers ) diff --git a/agentex/src/domain/use_cases/agent_api_keys_use_case.py b/agentex/src/domain/use_cases/agent_api_keys_use_case.py index a61280d8..e6edd884 100644 --- a/agentex/src/domain/use_cases/agent_api_keys_use_case.py +++ b/agentex/src/domain/use_cases/agent_api_keys_use_case.py @@ -22,6 +22,7 @@ from src.domain.entities.agent_api_keys import ( AgentAPIKeyEntity, AgentAPIKeyType, + SlackSocketModeAppEntity, ) from src.domain.entities.agents import AgentEntity, AgentStatus from src.domain.repositories.agent_api_key_repository import ( @@ -108,7 +109,7 @@ async def create( api_key_type: AgentAPIKeyType, api_key: str, slack_socket_mode_app_token_encrypted: str | None = None, - slack_socket_mode_forward_path: str | None = None, + slack_socket_mode_forward_path: str = "", ) -> AgentAPIKeyEntity: agent = await self.get_agent(agent_id=agent_id) if not agent: @@ -132,10 +133,20 @@ async def create( agent_id=agent.id, api_key_type=api_key_type, api_key=api_key, - slack_socket_mode_app_token_encrypted=slack_socket_mode_app_token_encrypted, - slack_socket_mode_forward_path=slack_socket_mode_forward_path, ) - return await self.agent_api_key_repo.create(item=agent_api_key) + if slack_socket_mode_app_token_encrypted is None: + return await self.agent_api_key_repo.create(item=agent_api_key) + return await self.agent_api_key_repo.create_with_slack_socket_mode_app( + item=agent_api_key, + app=SlackSocketModeAppEntity( + id=orm_id(), + agent_api_key_id=api_key_id, + agent_id=agent.id, + slack_app_id=name, + app_token_encrypted=slack_socket_mode_app_token_encrypted, + forward_path=slack_socket_mode_forward_path, + ), + ) async def _register_api_key_in_auth( self, @@ -229,7 +240,9 @@ async def get_by_agent_id_and_name( async def has_slack_socket_mode_trigger(self, app_id: str) -> bool: """Whether a live agent already serves this Slack app over Socket Mode.""" return bool( - await self.agent_api_key_repo.list_slack_socket_mode_triggers(app_id=app_id) + await self.agent_api_key_repo.list_slack_socket_mode_apps( + slack_app_id=app_id + ) ) async def get_external_by_agent_id_and_key( diff --git a/agentex/tests/integration/api/agent_api_keys/test_slack_socket_mode_apps.py b/agentex/tests/integration/api/agent_api_keys/test_slack_socket_mode_apps.py new file mode 100644 index 00000000..a2a581e7 --- /dev/null +++ b/agentex/tests/integration/api/agent_api_keys/test_slack_socket_mode_apps.py @@ -0,0 +1,82 @@ +"""The slack_socket_mode_apps table's guarantees, against a real Postgres.""" + +import pytest +from src.adapters.crud_store.exceptions import DuplicateItemError +from src.domain.entities.agent_api_keys import ( + AgentAPIKeyEntity, + AgentAPIKeyType, + SlackSocketModeAppEntity, +) +from src.domain.entities.agents import ACPType, AgentEntity, AgentStatus +from src.utils.ids import orm_id + +SLACK_APP_ID = "A123" + + +async def _agent(repos, name: str) -> AgentEntity: + return await repos["agent_repository"].create( + AgentEntity( + id=orm_id(), + name=name, + description="Socket Mode test agent", + acp_url="http://test-acp:8000", + acp_type=ACPType.SYNC, + ) + ) + + +async def _register(repos, agent: AgentEntity) -> AgentAPIKeyEntity: + trigger = AgentAPIKeyEntity( + id=orm_id(), + name=SLACK_APP_ID, + agent_id=agent.id, + api_key_type=AgentAPIKeyType.SLACK, + api_key="signing-secret", + ) + return await repos["agent_api_key_repository"].create_with_slack_socket_mode_app( + item=trigger, + app=SlackSocketModeAppEntity( + id=orm_id(), + agent_api_key_id=trigger.id, + agent_id=agent.id, + slack_app_id=SLACK_APP_ID, + app_token_encrypted="ciphertext", + forward_path="slack/events", + ), + ) + + +@pytest.mark.asyncio +@pytest.mark.integration +class TestSlackSocketModeApps: + async def test_one_live_agent_per_slack_app(self, isolated_repositories): + repos = isolated_repositories + key_repo = repos["agent_api_key_repository"] + first = await _agent(repos, "first-agent") + second = await _agent(repos, "second-agent") + await _register(repos, first) + + with pytest.raises(DuplicateItemError): + await _register(repos, second) + # The failed registration must not leave its trigger row behind. + assert not await key_repo.get_by_agent_id_and_name( + agent_id=second.id, name=SLACK_APP_ID, api_key_type=AgentAPIKeyType.SLACK + ) + + # Deleting an agent keeps its keys, so its stale row must not hold the app. + await repos["agent_repository"].update( + first.model_copy(update={"status": AgentStatus.DELETED}) + ) + trigger = await _register(repos, second) + + served = await key_repo.list_slack_socket_mode_apps() + assert [(t.id, app.agent_id) for t, app in served] == [(trigger.id, second.id)] + + async def test_deleting_the_trigger_removes_the_app(self, isolated_repositories): + repos = isolated_repositories + key_repo = repos["agent_api_key_repository"] + trigger = await _register(repos, await _agent(repos, "socket-agent")) + + await key_repo.delete(trigger.id) + + assert await key_repo.list_slack_socket_mode_apps() == [] diff --git a/agentex/tests/unit/api/test_webhook_trigger.py b/agentex/tests/unit/api/test_webhook_trigger.py index 8040cc12..84d28b61 100644 --- a/agentex/tests/unit/api/test_webhook_trigger.py +++ b/agentex/tests/unit/api/test_webhook_trigger.py @@ -7,6 +7,7 @@ import pytest import src.api.routes.agent_api_keys as mod from fastapi import HTTPException +from src.adapters.crud_store.exceptions import DuplicateItemError from src.api.routes.agent_api_keys import create_webhook_trigger from src.api.schemas.agent_api_keys import CreateWebhookTriggerRequest from src.domain.entities.agent_api_keys import AgentAPIKeyType @@ -23,6 +24,7 @@ async def _call( existing=None, base_env=None, app_served_over_socket=False, + create_error=None, ): # The agent-authorization helper does real authz work; stub it to a no-op. monkeypatch.setattr(mod, "_check_agent_or_collapse_to_404", AsyncMock()) @@ -40,7 +42,8 @@ async def _call( return_value=app_served_over_socket ) akuc.create = AsyncMock( - return_value=MagicMock(id="key-1", api_key_type=request.source) + return_value=MagicMock(id="key-1", api_key_type=request.source), + side_effect=create_error, ) resp = await create_webhook_trigger( @@ -188,10 +191,22 @@ async def test_slack_with_provided_secret_ok(self, monkeypatch): assert resp.secret == "slack-signing-secret" assert akuc.create.await_args.kwargs["api_key"] == "slack-signing-secret" - async def test_second_socket_trigger_for_a_slack_app_conflicts(self, monkeypatch): + @pytest.mark.parametrize( + ("served", "create_error"), + [ + pytest.param(True, None, id="already-registered"), + # A concurrent registration passed the same check and inserted first; + # the table's unique constraint is what catches it. + pytest.param(False, DuplicateItemError("dup"), id="concurrent-insert"), + ], + ) + async def test_second_socket_trigger_for_a_slack_app_conflicts( + self, monkeypatch, served, create_error + ): # Slack splits an app's events across its connections, so a second # Socket Mode trigger would silently take part of the first one's events. monkeypatch.setattr(mod.credential_encryption, "is_configured", lambda: True) + monkeypatch.setattr(mod.credential_encryption, "encrypt", lambda _: "ct") req = CreateWebhookTriggerRequest( agent_name="b", source=AgentAPIKeyType.SLACK, @@ -201,7 +216,12 @@ async def test_second_socket_trigger_for_a_slack_app_conflicts(self, monkeypatch app_token="xapp-1-A123-example", ) with pytest.raises(HTTPException) as exc: - await self._call(monkeypatch, req, app_served_over_socket=True) + await self._call( + monkeypatch, + req, + app_served_over_socket=served, + create_error=create_error, + ) assert exc.value.status_code == 409 async def test_linear_without_secret_rejected(self, monkeypatch): diff --git a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py index 09447fd5..3d2fb1d6 100644 --- a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py +++ b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py @@ -1,7 +1,6 @@ """Ack and reconnect behaviour of the Slack Socket Mode bridge.""" import asyncio -from datetime import UTC, datetime from unittest.mock import AsyncMock, MagicMock import httpx @@ -12,7 +11,11 @@ from slack_sdk.socket_mode.request import SocketModeRequest from slack_sdk.web.async_client import AsyncWebClient from slack_sdk.web.slack_response import SlackResponse -from src.domain.entities.agent_api_keys import AgentAPIKeyEntity, AgentAPIKeyType +from src.domain.entities.agent_api_keys import ( + AgentAPIKeyEntity, + AgentAPIKeyType, + SlackSocketModeAppEntity, +) from src.domain.entities.agents import AgentStatus from src.domain.services import slack_socket_mode_bridge as mod from src.domain.services.slack_socket_mode_bridge import SlackSocketModeBridge @@ -24,18 +27,26 @@ name="A123", api_key_type=AgentAPIKeyType.SLACK, api_key="signing-secret", - slack_socket_mode_app_token_encrypted="ciphertext", - slack_socket_mode_forward_path="slack/events", +) +APP = SlackSocketModeAppEntity( + id="app-1", + agent_api_key_id=TRIGGER.id, + agent_id=TRIGGER.agent_id, + slack_app_id="A123", + app_token_encrypted="ciphertext", + forward_path="slack/events", ) -def _bridge(handler, triggers=(TRIGGER,)) -> tuple[SlackSocketModeBridge, MagicMock]: +def _bridge( + handler, served=((TRIGGER, APP),) +) -> tuple[SlackSocketModeBridge, MagicMock]: agent_repo = MagicMock() agent_repo.get = AsyncMock( return_value=MagicMock(status=AgentStatus.READY, acp_url="http://agent:8000") ) key_repo = MagicMock() - key_repo.list_slack_socket_mode_triggers = AsyncMock(return_value=list(triggers)) + key_repo.list_slack_socket_mode_apps = AsyncMock(return_value=list(served)) bridge = SlackSocketModeBridge( agent_api_key_repository=key_repo, agent_repository=agent_repo, @@ -66,7 +77,7 @@ def handler(request: httpx.Request) -> httpx.Response: bridge, _ = _bridge(handler) client = MagicMock(send_socket_mode_response=AsyncMock()) - await bridge._on_request(TRIGGER, client, _envelope()) + await bridge._on_request(TRIGGER, APP, client, _envelope()) assert str(seen[0].url) == "http://agent:8000/slack/events" assert "x-slack-retry-num" not in seen[0].headers @@ -79,7 +90,7 @@ async def test_no_ack_when_agent_rejects(self): bridge, _ = _bridge(lambda request: httpx.Response(503)) client = MagicMock(send_socket_mode_response=AsyncMock()) - await bridge._on_request(TRIGGER, client, _envelope()) + await bridge._on_request(TRIGGER, APP, client, _envelope()) client.send_socket_mode_response.assert_not_awaited() @@ -93,7 +104,7 @@ async def slow(request: httpx.Request) -> httpx.Response: bridge, _ = _bridge(slow) client = MagicMock(send_socket_mode_response=AsyncMock()) - await bridge._on_request(TRIGGER, client, _envelope()) + await bridge._on_request(TRIGGER, APP, client, _envelope()) client.send_socket_mode_response.assert_not_awaited() @@ -108,7 +119,7 @@ def handler(request: httpx.Request) -> httpx.Response: client = MagicMock(send_socket_mode_response=AsyncMock()) await bridge._on_request( - TRIGGER, client, _envelope(retry_attempt=2, retry_reason="timeout") + TRIGGER, APP, client, _envelope(retry_attempt=2, retry_reason="timeout") ) assert seen[0].headers["x-slack-retry-num"] == "2" @@ -124,7 +135,7 @@ def handler(request: httpx.Request) -> httpx.Response: bridge, _ = _bridge(handler) client = MagicMock(send_socket_mode_response=AsyncMock()) - await bridge._on_request(TRIGGER, client, _envelope()) + await bridge._on_request(TRIGGER, APP, client, _envelope()) forwarded = seen[0] assert verify_signature( @@ -146,39 +157,11 @@ async def test_acks_when_agent_declines_redelivery(self): ) client = MagicMock(send_socket_mode_response=AsyncMock()) - await bridge._on_request(TRIGGER, client, _envelope()) + await bridge._on_request(TRIGGER, APP, client, _envelope()) client.send_socket_mode_response.assert_awaited_once() -@pytest.mark.unit -class TestOneConnectionPerApp: - async def test_only_the_earliest_trigger_for_an_app_connects(self, monkeypatch): - monkeypatch.setattr(mod.credential_encryption, "decrypt", lambda _: "xapp-1") - monkeypatch.setattr( - AsyncWebClient, - "apps_connections_open", - AsyncMock(return_value={"url": "wss://example.invalid"}), - ) - monkeypatch.setattr(mod._TriggerSocketModeClient, "connect", AsyncMock()) - later = TRIGGER.model_copy( - update={ - "id": "key-2", - "agent_id": "agent-2", - "created_at": datetime(2026, 2, 1, tzinfo=UTC), - } - ) - earlier = TRIGGER.model_copy( - update={"created_at": datetime(2026, 1, 1, tzinfo=UTC)} - ) - bridge, _ = _bridge(lambda request: httpx.Response(200), [later, earlier]) - - await bridge.refresh() - - assert list(bridge._connections) == [earlier.id] - await bridge.stop() - - @pytest.mark.unit class TestRateLimited: async def test_rate_limit_waits_and_retries_instead_of_rejecting(self, monkeypatch): From a196cdc289a92a9854c16bcd12e86d5316539023 Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Wed, 18 Nov 2026 11:47:27 -0600 Subject: [PATCH 08/18] fix(agentex): reopen a Slack Socket Mode connection that never connects slack_sdk's connect() fetches a WebSocket URL once and, if the first connection attempt fails, retries that same URL forever. Slack issues those URLs as temporary, so a network error at the wrong moment could leave an app with no connection until the bridge restarted. Each refresh now reopens a connection that has not been connected for a whole refresh interval, which fetches a new URL. Adds end-to-end tests that run the real route, Postgres and slack_sdk client against a fake Slack (apps.connections.open plus a Socket Mode WebSocket) and a fake agent: a delivered event arrives signed and is acked, an event the agent refuses is acked only on the redelivery it accepts, deleting the trigger closes the socket, and a connection stuck on a dead URL is reopened. Co-Authored-By: Claude Opus 5.5 --- .../services/slack_socket_mode_bridge.py | 21 +- .../test_slack_socket_mode_bridge_e2e.py | 261 ++++++++++++++++++ 2 files changed, 280 insertions(+), 2 deletions(-) create mode 100644 agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py diff --git a/agentex/src/domain/services/slack_socket_mode_bridge.py b/agentex/src/domain/services/slack_socket_mode_bridge.py index 99483427..3020ed03 100644 --- a/agentex/src/domain/services/slack_socket_mode_bridge.py +++ b/agentex/src/domain/services/slack_socket_mode_bridge.py @@ -22,7 +22,7 @@ import hmac import json import time -from dataclasses import dataclass +from dataclasses import dataclass, field from functools import partial from typing import Any @@ -124,6 +124,7 @@ class _Connection: client: _TriggerSocketModeClient # Held so the task isn't garbage-collected while connect() is still retrying. connect_task: asyncio.Task + last_connected: float = field(default_factory=time.monotonic) class SlackSocketModeBridge: @@ -169,7 +170,8 @@ async def _run(self) -> None: await asyncio.sleep(REFRESH_INTERVAL_SECONDS) async def refresh(self) -> None: - """Open connections for new triggers and close them for removed ones.""" + """Open connections for new triggers, close them for removed ones, and + reopen any that has not connected for a whole refresh interval.""" served = { trigger.id: (trigger, app) for trigger, app in await self._agent_api_key_repo.list_slack_socket_mode_apps() @@ -185,6 +187,21 @@ async def refresh(self) -> None: if connection.client.rejected: self._rejected.add((trigger_id, connection.app_token_encrypted)) await self._close(trigger_id) + elif await connection.client.is_connected(): + connection.last_connected = time.monotonic() + elif ( + time.monotonic() - connection.last_connected >= REFRESH_INTERVAL_SECONDS + ): + # slack_sdk's connect() retries a failed first connection with the + # same WebSocket URL forever, and Slack issues those URLs as + # temporary. Reopening fetches a new one. + logger.warning( + "Slack Socket Mode for trigger %s has not connected for %ss; " + "reopening it", + trigger_id, + REFRESH_INTERVAL_SECONDS, + ) + await self._close(trigger_id) for trigger, app in served.values(): if trigger.id in self._connections: continue diff --git a/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py b/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py new file mode 100644 index 00000000..71bd5a1f --- /dev/null +++ b/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py @@ -0,0 +1,261 @@ +"""The Socket Mode bridge end to end, with fakes for Slack and the agent. + +Registration goes through the real route, the trigger through real Postgres, and the +socket through the real slack_sdk client. Only Slack's servers and the agent are fake: +``FakeSlack`` serves ``apps.connections.open`` and a Socket Mode WebSocket that sends +``hello`` and then whatever envelopes the test pushes; ``FakeAgent`` records each +forwarded request. +""" + +import asyncio +import json +from collections.abc import AsyncIterator +from dataclasses import dataclass, field + +import httpx +import pytest +import pytest_asyncio +from aiohttp import WSMsgType, web +from cryptography.fernet import Fernet +from multidict import CIMultiDict +from slack_sdk.web.async_client import AsyncWebClient +from src.domain.entities.agents import ACPType, AgentEntity +from src.domain.services import slack_socket_mode_bridge as mod +from src.domain.services.slack_socket_mode_bridge import SlackSocketModeBridge +from src.domain.use_cases.slack_gateway_use_case import verify_signature +from src.utils import credential_encryption +from src.utils.ids import orm_id + +SLACK_APP_ID = "A123" +SIGNING_SECRET = "signing-secret" +WAIT_SECONDS = 5.0 + + +async def _serve(app: web.Application) -> tuple[web.AppRunner, str]: + runner = web.AppRunner(app) + await runner.setup() + site = web.TCPSite(runner, "127.0.0.1", 0) + await site.start() + port = site._server.sockets[0].getsockname()[1] # type: ignore[union-attr] + return runner, f"http://127.0.0.1:{port}" + + +@dataclass +class FakeSlack: + base_url: str = "" + connections_opened: int = 0 + # Each URL is good for one connection attempt; set to fail the first one, as a + # network blip would. + fail_first_attempt: bool = False + tried_urls: list[str] = field(default_factory=list) + sockets: list[web.WebSocketResponse] = field(default_factory=list) + acks: asyncio.Queue[str] = field(default_factory=asyncio.Queue) + connected: asyncio.Event = field(default_factory=asyncio.Event) + closed: asyncio.Event = field(default_factory=asyncio.Event) + + def app(self) -> web.Application: + app = web.Application() + app.router.add_post("/api/apps.connections.open", self._open) + app.router.add_get("/link", self._link) + return app + + async def _open(self, request: web.Request) -> web.Response: + self.connections_opened += 1 + ws_url = self.base_url.replace("http://", "ws://") + ws_url += f"/link?ticket={self.connections_opened}" + return web.json_response({"ok": True, "url": ws_url}) + + async def _link(self, request: web.Request) -> web.StreamResponse: + ticket = request.query["ticket"] + first_attempt = not self.tried_urls + if ticket in self.tried_urls: + self.tried_urls.append(ticket) + return web.Response(status=401) + self.tried_urls.append(ticket) + if first_attempt and self.fail_first_attempt: + return web.Response(status=503) + ws = web.WebSocketResponse(autoping=True) + await ws.prepare(request) + self.sockets.append(ws) + await ws.send_json({"type": "hello", "num_connections": len(self.sockets)}) + self.connected.set() + async for message in ws: + if message.type == WSMsgType.TEXT: + await self.acks.put(json.loads(message.data)["envelope_id"]) + self.closed.set() + return ws + + async def deliver(self, envelope_id: str, retry_attempt: int = 0) -> dict: + payload = {"type": "event_callback", "api_app_id": SLACK_APP_ID} + await self.sockets[-1].send_json( + { + "type": "events_api", + "envelope_id": envelope_id, + "payload": payload, + "accepts_response_payload": False, + "retry_attempt": retry_attempt, + "retry_reason": "timeout" if retry_attempt else "", + } + ) + return payload + + +@dataclass +class FakeAgent: + status: int = 200 + requests: asyncio.Queue[tuple[str, CIMultiDict[str], bytes]] = field( + default_factory=asyncio.Queue + ) + + def app(self) -> web.Application: + app = web.Application() + app.router.add_post("/{tail:.*}", self._receive) + return app + + async def _receive(self, request: web.Request) -> web.Response: + body = await request.read() + await self.requests.put((request.path, CIMultiDict(request.headers), body)) + return web.Response(status=self.status) + + +@pytest_asyncio.fixture +async def fakes(monkeypatch) -> AsyncIterator[tuple[FakeSlack, FakeAgent]]: + slack, agent = FakeSlack(), FakeAgent() + slack_runner, slack.base_url = await _serve(slack.app()) + agent_runner, agent_url = await _serve(agent.app()) + agent.url = agent_url # type: ignore[attr-defined] + + class ClientAgainstFakeSlack(mod._TriggerSocketModeClient): + def __init__(self, **kwargs): + super().__init__( + web_client=AsyncWebClient( + token=kwargs["app_token"], base_url=f"{slack.base_url}/api/" + ), + ping_interval=0.5, + **kwargs, + ) + + monkeypatch.setattr(mod, "_TriggerSocketModeClient", ClientAgainstFakeSlack) + credential_encryption.reset_cache() + monkeypatch.setenv(credential_encryption.ENV_KEY, Fernet.generate_key().decode()) + yield slack, agent + credential_encryption.reset_cache() + await slack_runner.cleanup() + await agent_runner.cleanup() + + +@pytest.mark.asyncio +@pytest.mark.integration +class TestSlackSocketModeBridgeEndToEnd: + @pytest_asyncio.fixture + async def bridge( + self, isolated_client, isolated_repositories, fakes + ) -> AsyncIterator[SlackSocketModeBridge]: + _, agent = fakes + await isolated_repositories["agent_repository"].create( + AgentEntity( + id=orm_id(), + name="socket-agent", + description="Socket Mode end-to-end agent", + acp_url=agent.url, + acp_type=ACPType.SYNC, + ) + ) + response = await isolated_client.post( + "/agent_api_keys/webhook-trigger", + json={ + "agent_name": "socket-agent", + "source": "slack", + "name": SLACK_APP_ID, + "secret": SIGNING_SECRET, + "forward_path": "slack/events", + "app_token": "xapp-1-A123-fake", + }, + ) + assert response.status_code == 200, response.text + self.key_id = response.json()["key_id"] + + async with httpx.AsyncClient() as http_client: + bridge = SlackSocketModeBridge( + agent_api_key_repository=isolated_repositories[ + "agent_api_key_repository" + ], + agent_repository=isolated_repositories["agent_repository"], + http_client=http_client, + ) + yield bridge + await bridge.stop() + + async def test_event_reaches_the_agent_signed_and_is_acked(self, bridge, fakes): + slack, agent = fakes + await bridge.refresh() + await asyncio.wait_for(slack.connected.wait(), WAIT_SECONDS) + + payload = await slack.deliver("env-1") + path, headers, body = await asyncio.wait_for(agent.requests.get(), WAIT_SECONDS) + + assert path == "/slack/events" + assert json.loads(body) == payload + assert verify_signature( + SIGNING_SECRET, + headers["X-Slack-Request-Timestamp"], + headers["X-Slack-Signature"], + body, + ) + assert "X-Slack-Retry-Num" not in headers + assert await asyncio.wait_for(slack.acks.get(), WAIT_SECONDS) == "env-1" + + async def test_unaccepted_event_is_acked_only_on_a_redelivery_the_agent_takes( + self, bridge, fakes + ): + slack, agent = fakes + await bridge.refresh() + await asyncio.wait_for(slack.connected.wait(), WAIT_SECONDS) + agent.status = 503 + + await slack.deliver("env-1") + await asyncio.wait_for(agent.requests.get(), WAIT_SECONDS) + with pytest.raises(TimeoutError): + await asyncio.wait_for(slack.acks.get(), mod.ACK_DEADLINE_SECONDS) + + agent.status = 200 + await slack.deliver("env-1", retry_attempt=1) + _, headers, _ = await asyncio.wait_for(agent.requests.get(), WAIT_SECONDS) + + assert headers["X-Slack-Retry-Num"] == "1" + assert headers["X-Slack-Retry-Reason"] == "timeout" + assert await asyncio.wait_for(slack.acks.get(), WAIT_SECONDS) == "env-1" + + async def test_deleting_the_trigger_closes_the_socket( + self, bridge, fakes, isolated_client + ): + slack, _ = fakes + await bridge.refresh() + await asyncio.wait_for(slack.connected.wait(), WAIT_SECONDS) + + response = await isolated_client.delete(f"/agent_api_keys/{self.key_id}") + assert response.status_code == 200, response.text + await bridge.refresh() + + await asyncio.wait_for(slack.closed.wait(), WAIT_SECONDS) + assert bridge._connections == {} + assert slack.connections_opened == 1 + + async def test_a_connection_stuck_on_a_dead_url_is_reopened( + self, bridge, fakes, monkeypatch + ): + slack, _ = fakes + slack.fail_first_attempt = True + + await bridge.refresh() + while len(slack.tried_urls) < 3: + await asyncio.sleep(0.1) + # slack_sdk keeps retrying the URL it was given, which is now dead. + assert set(slack.tried_urls) == {"1"} + assert not slack.connected.is_set() + + monkeypatch.setattr(mod, "REFRESH_INTERVAL_SECONDS", 0) + await bridge.refresh() + + await asyncio.wait_for(slack.connected.wait(), WAIT_SECONDS) + assert slack.connections_opened == 2 From 92348dbf6421e061279fb84fc58f27bea42f176f Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Wed, 18 Nov 2026 11:59:04 -0600 Subject: [PATCH 09/18] fix(agentex): open each Slack Socket Mode app in its own task Fetching an app's WebSocket URL waits out Slack's Retry-After when the app is rate-limited. That fetch ran inside refresh(), so one rate-limited app held up connecting every later app, removing deleted triggers and reopening stuck connections. It now runs in the app's own connection task, and the next refresh records a rejected token from the closed client. The bridge factory moves to the entrypoint, so the domain service no longer builds database sessions or repositories, and the pool settings are named. Co-Authored-By: Claude Opus 5.5 --- .../services/slack_socket_mode_bridge.py | 54 ++++++++----------- agentex/src/run_slack_socket_mode_bridge.py | 33 +++++++++--- .../services/test_slack_socket_mode_bridge.py | 43 +++++++++++++++ 3 files changed, 91 insertions(+), 39 deletions(-) diff --git a/agentex/src/domain/services/slack_socket_mode_bridge.py b/agentex/src/domain/services/slack_socket_mode_bridge.py index 3020ed03..962a4e75 100644 --- a/agentex/src/domain/services/slack_socket_mode_bridge.py +++ b/agentex/src/domain/services/slack_socket_mode_bridge.py @@ -31,10 +31,8 @@ from slack_sdk.socket_mode.aiohttp import SocketModeClient from slack_sdk.socket_mode.request import SocketModeRequest from slack_sdk.socket_mode.response import SocketModeResponse -from sqlalchemy.ext.asyncio import AsyncEngine from src.adapters.crud_store.exceptions import ItemDoesNotExist -from src.config.dependencies import database_async_read_write_session_maker from src.domain.entities.agent_api_keys import ( AgentAPIKeyEntity, SlackSocketModeAppEntity, @@ -227,32 +225,39 @@ async def _open( client.socket_mode_request_listeners.append( partial(self._on_request, trigger, app) ) + self._connections[trigger.id] = _Connection( + app_token_encrypted=app.app_token_encrypted, + client=client, + connect_task=asyncio.create_task(self._connect(trigger, client)), + ) + logger.info( + "Slack Socket Mode connecting for trigger %s (app %s, agent %s)", + trigger.id, + trigger.name, + trigger.agent_id, + ) + + async def _connect( + self, trigger: AgentAPIKeyEntity, client: _TriggerSocketModeClient + ) -> None: + # Runs in the app's own task: fetching the URL can wait out Slack's + # Retry-After, which must not hold up refresh() or the other apps. try: - # Called once up front so a rejected token stops here instead of - # inside connect()'s retry loop; connect() reuses the URL. + # Fetched before connect() so a rejected token stops here instead of + # inside connect()'s retry loop; connect() reuses the URL. The next + # refresh() finds the client closed and records the rejection. client.wss_uri = await client.issue_new_wss_url() except AppTokenRejected: - self._rejected.add((trigger.id, app.app_token_encrypted)) await client.close() return except Exception as exc: - # Transient (network, rate limit): connect() fetches a URL and retries. + # Transient (network): connect() fetches a URL and retries. logger.warning( "Opening Slack Socket Mode for trigger %s failed (%s); retrying", trigger.id, type(exc).__name__, ) - self._connections[trigger.id] = _Connection( - app_token_encrypted=app.app_token_encrypted, - client=client, - connect_task=asyncio.create_task(client.connect()), - ) - logger.info( - "Slack Socket Mode connecting for trigger %s (app %s, agent %s)", - trigger.id, - trigger.name, - trigger.agent_id, - ) + await client.connect() async def _close(self, trigger_id: str) -> None: connection = self._connections.pop(trigger_id) @@ -359,18 +364,3 @@ async def forward_event( trigger.id, ) return False - - -def create_slack_socket_mode_bridge( - engine: AsyncEngine, http_client: httpx.AsyncClient -) -> SlackSocketModeBridge: - """Build the bridge on one database engine and HTTP client. - - The bridge only reads triggers and agents, so every session uses ``engine``. - """ - session_maker = database_async_read_write_session_maker(engine) - return SlackSocketModeBridge( - agent_api_key_repository=AgentAPIKeyRepository(session_maker, session_maker), - agent_repository=AgentRepository(session_maker, session_maker), - http_client=http_client, - ) diff --git a/agentex/src/run_slack_socket_mode_bridge.py b/agentex/src/run_slack_socket_mode_bridge.py index 0d1d4e39..74611eec 100644 --- a/agentex/src/run_slack_socket_mode_bridge.py +++ b/agentex/src/run_slack_socket_mode_bridge.py @@ -24,11 +24,11 @@ from aiohttp import web from sqlalchemy.ext.asyncio import AsyncEngine, create_async_engine +from src.config.dependencies import database_async_read_write_session_maker from src.config.environment_variables import EnvironmentVariables -from src.domain.services.slack_socket_mode_bridge import ( - SlackSocketModeBridge, - create_slack_socket_mode_bridge, -) +from src.domain.repositories.agent_api_key_repository import AgentAPIKeyRepository +from src.domain.repositories.agent_repository import AgentRepository +from src.domain.services.slack_socket_mode_bridge import SlackSocketModeBridge from src.utils import credential_encryption from src.utils.database import async_db_engine_creator from src.utils.logging import make_logger @@ -37,6 +37,10 @@ logger = make_logger(__name__) PROBE_PORT = 5004 +# The bridge reads triggers once a minute and one agent per forwarded event. +DB_POOL_SIZE = 2 +DB_MAX_OVERFLOW = 3 +DB_POOL_RECYCLE_SECONDS = 3600 def create_engine(database_url: str) -> AsyncEngine: @@ -49,10 +53,25 @@ def create_engine(database_url: str) -> AsyncEngine: return create_async_engine( "postgresql+asyncpg://", async_creator=async_db_engine_creator(database_url), - pool_size=2, - max_overflow=3, + pool_size=DB_POOL_SIZE, + max_overflow=DB_MAX_OVERFLOW, pool_pre_ping=True, - pool_recycle=3600, + pool_recycle=DB_POOL_RECYCLE_SECONDS, + ) + + +def create_slack_socket_mode_bridge( + engine: AsyncEngine, http_client: httpx.AsyncClient +) -> SlackSocketModeBridge: + """Build the bridge on one database engine and HTTP client. + + The bridge only reads triggers and agents, so every session uses ``engine``. + """ + session_maker = database_async_read_write_session_maker(engine) + return SlackSocketModeBridge( + agent_api_key_repository=AgentAPIKeyRepository(session_maker, session_maker), + agent_repository=AgentRepository(session_maker, session_maker), + http_client=http_client, ) diff --git a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py index 3d2fb1d6..a6a3973c 100644 --- a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py +++ b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py @@ -196,6 +196,48 @@ async def fake_sleep(delay: float) -> None: await client.close() +@pytest.mark.unit +class TestOneAppCannotStallTheOthers: + async def test_a_rate_limited_app_does_not_hold_up_refresh(self, monkeypatch): + other_trigger = TRIGGER.model_copy(update={"id": "key-2", "name": "B456"}) + other_app = APP.model_copy( + update={ + "id": "app-2", + "agent_api_key_id": "key-2", + "slack_app_id": "B456", + "app_token_encrypted": "ciphertext-2", + } + ) + monkeypatch.setattr( + mod.credential_encryption, + "decrypt", + {"ciphertext": "xapp-waiting", "ciphertext-2": "xapp-ready"}.__getitem__, + ) + + async def connections_open(self, **kwargs): + if kwargs["app_token"] == "xapp-waiting": + # Stands in for waiting out a long Retry-After. + await asyncio.Event().wait() + return {"url": "wss://example.invalid"} + + monkeypatch.setattr(AsyncWebClient, "apps_connections_open", connections_open) + connected = asyncio.Event() + monkeypatch.setattr( + mod._TriggerSocketModeClient, + "connect", + AsyncMock(side_effect=lambda: connected.set()), + ) + bridge, _ = _bridge( + lambda request: httpx.Response(200), + [(TRIGGER, APP), (other_trigger, other_app)], + ) + + await asyncio.wait_for(bridge.refresh(), 1) + await asyncio.wait_for(connected.wait(), 1) + + await bridge.stop() + + @pytest.mark.unit class TestRejectedToken: async def test_rejected_token_stops_without_retrying(self, monkeypatch): @@ -211,6 +253,7 @@ async def test_rejected_token_stops_without_retrying(self, monkeypatch): bridge, _ = _bridge(lambda request: httpx.Response(200)) await bridge.refresh() + await bridge._connections[TRIGGER.id].connect_task # A later refresh with the same stored token must not try it again. await bridge.refresh() From 1700101ac30b9bf5decc7e01bcde6336f7f35bc3 Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Wed, 18 Nov 2026 12:08:31 -0600 Subject: [PATCH 10/18] fix(agentex): check that a Slack app token belongs to the app it registers The Slack app id is the trigger's name and unique across agents, and registration only checked the token's xapp- prefix. Any caller who could update an agent could reserve another team's app with a made-up token, and the real owner would then get 409. Registration now opens one Socket Mode connection, reads the app id from Slack's hello message, and refuses the request unless it matches. A token Slack rejects returns 400; failing to reach Slack returns 502. The bridge checks the same field on every connect and closes a connection whose token belongs to another app. Co-Authored-By: Claude Opus 5.5 --- .../docs/docs/development_guides/webhooks.md | 2 +- agentex/src/api/routes/agent_api_keys.py | 27 ++++++ .../services/slack_socket_mode_bridge.py | 71 +++++++++++++- .../test_slack_socket_mode_bridge_e2e.py | 96 ++++++++++++++----- .../tests/unit/api/test_webhook_trigger.py | 37 +++++++ 5 files changed, 209 insertions(+), 24 deletions(-) diff --git a/agentex/docs/docs/development_guides/webhooks.md b/agentex/docs/docs/development_guides/webhooks.md index 3b2c07a9..9766281d 100644 --- a/agentex/docs/docs/development_guides/webhooks.md +++ b/agentex/docs/docs/development_guides/webhooks.md @@ -180,7 +180,7 @@ curl -X POST $HOST/agent_api_keys \ #### Slack over Socket Mode If Slack cannot reach agentex over HTTP (for example, when agentex runs in a private network), agentex can receive the app's events over [Socket Mode](https://docs.slack.dev/apis/events-api/using-socket-mode) instead. -Enable Socket Mode on the app and create an app-level token as that guide describes, then register the trigger with that token: +Enable Socket Mode on the app and create an app-level token as that guide describes, then register the trigger with that token. Registration connects to Slack once to check that the token belongs to the app named in `name`, and returns 400 if it does not: ```bash curl -X POST $HOST/agent_api_keys/webhook-trigger \ diff --git a/agentex/src/api/routes/agent_api_keys.py b/agentex/src/api/routes/agent_api_keys.py index 88fc9626..7a5035ad 100644 --- a/agentex/src/api/routes/agent_api_keys.py +++ b/agentex/src/api/routes/agent_api_keys.py @@ -17,6 +17,7 @@ AuthorizedOperationType, ) from src.domain.entities.agent_api_keys import AgentAPIKeyType +from src.domain.services import slack_socket_mode_bridge from src.domain.services.authorization_service import DAuthorizationService from src.domain.use_cases.agent_api_keys_use_case import DAgentAPIKeysUseCase from src.domain.use_cases.agents_use_case import DAgentsUseCase @@ -102,6 +103,29 @@ async def create_api_key( ) +async def _check_app_token_belongs_to(app_token: str, app_id: str) -> None: + try: + token_app_id = await slack_socket_mode_bridge.read_slack_app_id(app_token) + except slack_socket_mode_bridge.AppTokenRejected as exc: + raise HTTPException( + status_code=400, detail=f"Slack rejected app_token: {exc}." + ) from exc + except Exception as exc: + logger.warning( + "Reading the Slack app id for app_token failed (%s)", type(exc).__name__ + ) + raise HTTPException( + status_code=502, + detail="Could not confirm with Slack which app app_token belongs to; " + "try again.", + ) from exc + if token_app_id != app_id: + raise HTTPException( + status_code=400, + detail=f"app_token belongs to Slack app '{token_app_id}', not '{app_id}'.", + ) + + def _slack_app_already_served(app_id: str) -> HTTPException: return HTTPException( status_code=409, @@ -210,6 +234,9 @@ async def create_webhook_trigger( detail="This deployment cannot store app tokens: credential " "encryption is not configured.", ) + # The app id is the trigger's name and is unique across agents, so an + # unchecked one would let any caller reserve someone else's app. + await _check_app_token_belongs_to(request.app_token, request.name) # Slack gives each event to one of an app's connections, so a second # Socket Mode trigger for the same app would take part of the first # one's events. The table's unique constraint enforces this; checking first diff --git a/agentex/src/domain/services/slack_socket_mode_bridge.py b/agentex/src/domain/services/slack_socket_mode_bridge.py index 962a4e75..95949666 100644 --- a/agentex/src/domain/services/slack_socket_mode_bridge.py +++ b/agentex/src/domain/services/slack_socket_mode_bridge.py @@ -26,11 +26,13 @@ from functools import partial from typing import Any +import aiohttp import httpx from slack_sdk.errors import SlackApiError from slack_sdk.socket_mode.aiohttp import SocketModeClient from slack_sdk.socket_mode.request import SocketModeRequest from slack_sdk.socket_mode.response import SocketModeResponse +from slack_sdk.web.async_client import AsyncWebClient from src.adapters.crud_store.exceptions import ItemDoesNotExist from src.domain.entities.agent_api_keys import ( @@ -49,6 +51,7 @@ # Slack expects an ack within 3s; leave headroom for the ack frame itself. ACK_DEADLINE_SECONDS = 2.5 REFRESH_INTERVAL_SECONDS = 60.0 +HELLO_TIMEOUT_SECONDS = 10.0 # apps.connections.open errors that no retry can fix. REJECTED_TOKEN_ERRORS = frozenset( @@ -64,7 +67,44 @@ class AppTokenRejected(Exception): - """Slack refused the app token; the connection for it has been stopped.""" + """Slack refused the app token.""" + + +class AppIdUnavailable(Exception): + """Slack's hello message did not name the app.""" + + +def _hello_app_id(message: dict) -> str | None: + return (message.get("connection_info") or {}).get("app_id") + + +async def read_slack_app_id(app_token: str) -> str: + """The id of the Slack app an app-level token belongs to. + + Slack names the app in the hello message that starts every Socket Mode + connection, so this opens one and closes it after that message. An event Slack + hands this connection in the meantime goes unacked, so Slack redelivers it. + + Raises: + AppTokenRejected: Slack refused the token. + AppIdUnavailable: The hello message did not name the app. + SlackApiError, aiohttp.ClientError, TimeoutError: Slack could not be + reached or answered unexpectedly; a retry may succeed. + """ + try: + response = await AsyncWebClient().apps_connections_open(app_token=app_token) + except SlackApiError as exc: + error = exc.response.get("error") + if error in REJECTED_TOKEN_ERRORS: + raise AppTokenRejected(error) from exc + raise + async with aiohttp.ClientSession() as session: + async with session.ws_connect(response["url"]) as ws: + hello = await ws.receive_json(timeout=HELLO_TIMEOUT_SECONDS) + app_id = _hello_app_id(hello) + if not app_id: + raise AppIdUnavailable(f"Slack sent {hello.get('type')!r} without an app id") + return app_id class _TriggerSocketModeClient(SocketModeClient): @@ -222,6 +262,7 @@ async def _open( return client = _TriggerSocketModeClient(trigger=trigger, app_token=app_token) + client.message_listeners.append(partial(self._check_hello, trigger, app)) client.socket_mode_request_listeners.append( partial(self._on_request, trigger, app) ) @@ -259,6 +300,34 @@ async def _connect( ) await client.connect() + async def _check_hello( + self, + trigger: AgentAPIKeyEntity, + app: SlackSocketModeAppEntity, + client: _TriggerSocketModeClient, + message: dict, + raw_message: str | None, + ) -> None: + """Close a connection whose token turns out to belong to a different app. + + Registration checks this too; checking on every connect keeps a socket + from serving another app's events to this trigger's agent. + """ + if message.get("type") != "hello": + return + app_id = _hello_app_id(message) + if app_id == app.slack_app_id: + return + logger.error( + "The app token for Slack Socket Mode trigger %s belongs to app %s, not " + "%s; closing the connection until the trigger is re-registered.", + trigger.id, + app_id, + app.slack_app_id, + ) + client.rejected = True + await client.close() + async def _close(self, trigger_id: str) -> None: connection = self._connections.pop(trigger_id) connection.connect_task.cancel() diff --git a/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py b/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py index 71bd5a1f..86e5bdb0 100644 --- a/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py +++ b/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py @@ -43,6 +43,8 @@ async def _serve(app: web.Application) -> tuple[web.AppRunner, str]: @dataclass class FakeSlack: base_url: str = "" + # The app Slack names in hello, i.e. the app the token belongs to. + app_id: str = SLACK_APP_ID connections_opened: int = 0 # Each URL is good for one connection attempt; set to fail the first one, as a # network blip would. @@ -77,7 +79,13 @@ async def _link(self, request: web.Request) -> web.StreamResponse: ws = web.WebSocketResponse(autoping=True) await ws.prepare(request) self.sockets.append(ws) - await ws.send_json({"type": "hello", "num_connections": len(self.sockets)}) + await ws.send_json( + { + "type": "hello", + "num_connections": len(self.sockets), + "connection_info": {"app_id": self.app_id}, + } + ) self.connected.set() async for message in ws: if message.type == WSMsgType.TEXT: @@ -85,6 +93,14 @@ async def _link(self, request: web.Request) -> web.StreamResponse: self.closed.set() return ws + def forget_connections(self) -> None: + """Clear what registration's own app-id check left behind.""" + self.connections_opened = 0 + self.tried_urls.clear() + self.sockets.clear() + self.connected.clear() + self.closed.clear() + async def deliver(self, envelope_id: str, retry_attempt: int = 0) -> dict: payload = {"type": "event_callback", "api_app_id": SLACK_APP_ID} await self.sockets[-1].send_json( @@ -136,6 +152,12 @@ def __init__(self, **kwargs): ) monkeypatch.setattr(mod, "_TriggerSocketModeClient", ClientAgainstFakeSlack) + # Registration's app-id check builds its own client. + monkeypatch.setattr( + mod, + "AsyncWebClient", + lambda **kwargs: AsyncWebClient(base_url=f"{slack.base_url}/api/", **kwargs), + ) credential_encryption.reset_cache() monkeypatch.setenv(credential_encryption.ENV_KEY, Fernet.generate_key().decode()) yield slack, agent @@ -144,6 +166,29 @@ def __init__(self, **kwargs): await agent_runner.cleanup() +async def _register(isolated_client, isolated_repositories, agent_url: str): + await isolated_repositories["agent_repository"].create( + AgentEntity( + id=orm_id(), + name="socket-agent", + description="Socket Mode end-to-end agent", + acp_url=agent_url, + acp_type=ACPType.SYNC, + ) + ) + return await isolated_client.post( + "/agent_api_keys/webhook-trigger", + json={ + "agent_name": "socket-agent", + "source": "slack", + "name": SLACK_APP_ID, + "secret": SIGNING_SECRET, + "forward_path": "slack/events", + "app_token": "xapp-1-A123-fake", + }, + ) + + @pytest.mark.asyncio @pytest.mark.integration class TestSlackSocketModeBridgeEndToEnd: @@ -151,29 +196,11 @@ class TestSlackSocketModeBridgeEndToEnd: async def bridge( self, isolated_client, isolated_repositories, fakes ) -> AsyncIterator[SlackSocketModeBridge]: - _, agent = fakes - await isolated_repositories["agent_repository"].create( - AgentEntity( - id=orm_id(), - name="socket-agent", - description="Socket Mode end-to-end agent", - acp_url=agent.url, - acp_type=ACPType.SYNC, - ) - ) - response = await isolated_client.post( - "/agent_api_keys/webhook-trigger", - json={ - "agent_name": "socket-agent", - "source": "slack", - "name": SLACK_APP_ID, - "secret": SIGNING_SECRET, - "forward_path": "slack/events", - "app_token": "xapp-1-A123-fake", - }, - ) + slack, agent = fakes + response = await _register(isolated_client, isolated_repositories, agent.url) assert response.status_code == 200, response.text self.key_id = response.json()["key_id"] + slack.forget_connections() async with httpx.AsyncClient() as http_client: bridge = SlackSocketModeBridge( @@ -259,3 +286,28 @@ async def test_a_connection_stuck_on_a_dead_url_is_reopened( await asyncio.wait_for(slack.connected.wait(), WAIT_SECONDS) assert slack.connections_opened == 2 + + async def test_registration_refuses_a_token_for_another_app( + self, isolated_client, isolated_repositories, fakes + ): + slack, agent = fakes + slack.app_id = "B999" + + response = await _register(isolated_client, isolated_repositories, agent.url) + + assert response.status_code == 400, response.text + assert "B999" in response.text + key_repo = isolated_repositories["agent_api_key_repository"] + assert await key_repo.list_slack_socket_mode_apps() == [] + + async def test_bridge_drops_a_token_that_names_another_app(self, bridge, fakes): + slack, agent = fakes + slack.app_id = "B999" + + await bridge.refresh() + await asyncio.wait_for(slack.closed.wait(), WAIT_SECONDS) + await bridge.refresh() + + assert bridge._connections == {} + assert slack.connections_opened == 1 + assert agent.requests.empty() diff --git a/agentex/tests/unit/api/test_webhook_trigger.py b/agentex/tests/unit/api/test_webhook_trigger.py index 84d28b61..c6515aa6 100644 --- a/agentex/tests/unit/api/test_webhook_trigger.py +++ b/agentex/tests/unit/api/test_webhook_trigger.py @@ -11,6 +11,7 @@ from src.api.routes.agent_api_keys import create_webhook_trigger from src.api.schemas.agent_api_keys import CreateWebhookTriggerRequest from src.domain.entities.agent_api_keys import AgentAPIKeyType +from src.domain.services.slack_socket_mode_bridge import AppTokenRejected @pytest.mark.unit @@ -25,9 +26,18 @@ async def _call( base_env=None, app_served_over_socket=False, create_error=None, + token_app_id="A123", ): # The agent-authorization helper does real authz work; stub it to a no-op. monkeypatch.setattr(mod, "_check_agent_or_collapse_to_404", AsyncMock()) + read_app_id = ( + AsyncMock(side_effect=token_app_id) + if isinstance(token_app_id, Exception) + else AsyncMock(return_value=token_app_id) + ) + monkeypatch.setattr( + mod.slack_socket_mode_bridge, "read_slack_app_id", read_app_id + ) if base_env is not None: monkeypatch.setenv("AGENTEX_PUBLIC_URL", base_env) else: @@ -224,6 +234,33 @@ async def test_second_socket_trigger_for_a_slack_app_conflicts( ) assert exc.value.status_code == 409 + @pytest.mark.parametrize( + ("token_app_id", "status"), + [ + # Without this check any caller could reserve another team's app id. + pytest.param("B999", 400, id="token-for-another-app"), + pytest.param( + AppTokenRejected("invalid_auth"), 400, id="token-rejected-by-slack" + ), + pytest.param(TimeoutError(), 502, id="slack-unreachable"), + ], + ) + async def test_app_token_must_belong_to_the_named_app( + self, monkeypatch, token_app_id, status + ): + monkeypatch.setattr(mod.credential_encryption, "is_configured", lambda: True) + req = CreateWebhookTriggerRequest( + agent_name="b", + source=AgentAPIKeyType.SLACK, + name="A123", + forward_path="slack/events", + secret="slack-signing-secret", + app_token="xapp-1-A123-example", + ) + with pytest.raises(HTTPException) as exc: + await self._call(monkeypatch, req, token_app_id=token_app_id) + assert exc.value.status_code == status + async def test_linear_without_secret_rejected(self, monkeypatch): # Linear signs with the OAuth app's webhook signing secret, like Slack. req = CreateWebhookTriggerRequest( From 3dd42c5801af2d50c2edc5b7ea0e061537ae7b0c Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Wed, 18 Nov 2026 12:29:43 -0600 Subject: [PATCH 11/18] fix(agentex): let a Slack Socket Mode app wait out its rate limit The check that reopens a never-connected app counted from when the connection opened, so a URL fetch still waiting out a Retry-After longer than a refresh interval was cancelled and restarted, asking Slack again sooner than it allowed. The clock now starts when a URL arrives. Co-Authored-By: Claude Opus 5.5 --- .../services/slack_socket_mode_bridge.py | 20 +++++++++---- .../test_slack_socket_mode_bridge_e2e.py | 3 +- .../services/test_slack_socket_mode_bridge.py | 28 +++++++++++++++++++ 3 files changed, 44 insertions(+), 7 deletions(-) diff --git a/agentex/src/domain/services/slack_socket_mode_bridge.py b/agentex/src/domain/services/slack_socket_mode_bridge.py index 95949666..59d89536 100644 --- a/agentex/src/domain/services/slack_socket_mode_bridge.py +++ b/agentex/src/domain/services/slack_socket_mode_bridge.py @@ -112,6 +112,9 @@ def __init__(self, trigger: AgentAPIKeyEntity, **kwargs: Any) -> None: super().__init__(**kwargs) self.trigger = trigger self.rejected = False + # When the last WebSocket URL arrived. None while the first fetch is still + # under way, which may mean waiting out Slack's Retry-After. + self.url_fetched_at: float | None = None async def issue_new_wss_url(self) -> str: # slack_sdk also calls this on every reconnect, and on a revoked token its @@ -119,7 +122,7 @@ async def issue_new_wss_url(self) -> str: # forever. The base method still handles rate limiting (it waits out # Retry-After); only the errors no retry can fix stop the connection. try: - return await super().issue_new_wss_url() + url = await super().issue_new_wss_url() except SlackApiError as exc: error = exc.response.get("error") if error in REJECTED_TOKEN_ERRORS: @@ -138,6 +141,8 @@ async def issue_new_wss_url(self) -> str: ) raise AppTokenRejected(error) from exc raise + self.url_fetched_at = time.monotonic() + return url def _slack_signature_headers( @@ -227,15 +232,18 @@ async def refresh(self) -> None: await self._close(trigger_id) elif await connection.client.is_connected(): connection.last_connected = time.monotonic() - elif ( - time.monotonic() - connection.last_connected >= REFRESH_INTERVAL_SECONDS + elif connection.client.url_fetched_at is not None and ( + time.monotonic() + - max(connection.last_connected, connection.client.url_fetched_at) + >= REFRESH_INTERVAL_SECONDS ): # slack_sdk's connect() retries a failed first connection with the # same WebSocket URL forever, and Slack issues those URLs as - # temporary. Reopening fetches a new one. + # temporary. Reopening fetches a new one. The clock starts when a + # URL arrives, so waiting out Retry-After never counts against it. logger.warning( - "Slack Socket Mode for trigger %s has not connected for %ss; " - "reopening it", + "Slack Socket Mode for trigger %s has not connected within %ss " + "of getting its URL; reopening it", trigger_id, REFRESH_INTERVAL_SECONDS, ) diff --git a/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py b/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py index 86e5bdb0..629fad99 100644 --- a/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py +++ b/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py @@ -19,6 +19,7 @@ from cryptography.fernet import Fernet from multidict import CIMultiDict from slack_sdk.web.async_client import AsyncWebClient +from src.domain.entities.agent_api_keys import AgentAPIKeyType from src.domain.entities.agents import ACPType, AgentEntity from src.domain.services import slack_socket_mode_bridge as mod from src.domain.services.slack_socket_mode_bridge import SlackSocketModeBridge @@ -180,7 +181,7 @@ async def _register(isolated_client, isolated_repositories, agent_url: str): "/agent_api_keys/webhook-trigger", json={ "agent_name": "socket-agent", - "source": "slack", + "source": AgentAPIKeyType.SLACK.value, "name": SLACK_APP_ID, "secret": SIGNING_SECRET, "forward_path": "slack/events", diff --git a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py index a6a3973c..42ccc763 100644 --- a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py +++ b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py @@ -238,6 +238,34 @@ async def connections_open(self, **kwargs): await bridge.stop() +@pytest.mark.unit +class TestRateLimitWaitIsNotCutShort: + async def test_refresh_leaves_a_url_fetch_that_is_still_waiting(self, monkeypatch): + monkeypatch.setattr(mod.credential_encryption, "decrypt", lambda _: "xapp-1") + fetches = 0 + + async def connections_open(self, **kwargs): + nonlocal fetches + fetches += 1 + # Stands in for waiting out a Retry-After longer than a refresh interval. + await asyncio.Event().wait() + + monkeypatch.setattr(AsyncWebClient, "apps_connections_open", connections_open) + monkeypatch.setattr(mod._TriggerSocketModeClient, "connect", AsyncMock()) + bridge, _ = _bridge(lambda request: httpx.Response(200)) + await bridge.refresh() + while not fetches: + await asyncio.sleep(0) + waiting = bridge._connections[TRIGGER.id] + + monkeypatch.setattr(mod, "REFRESH_INTERVAL_SECONDS", 0) + await bridge.refresh() + + assert bridge._connections[TRIGGER.id] is waiting + assert fetches == 1 + await bridge.stop() + + @pytest.mark.unit class TestRejectedToken: async def test_rejected_token_stops_without_retrying(self, monkeypatch): From 0f5d96f5e4314cd0bf630079d9fa4af6e6c4fd66 Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Wed, 18 Nov 2026 12:53:49 -0600 Subject: [PATCH 12/18] fix(agentex): remove the auth registration when an API key insert fails create() registers the key for authorization before inserting it. When the insert fails, as it now can when two registrations race for one Slack app, the registration was left behind with no row or id anyone could delete it by. A failed insert now removes it before the error propagates. Co-Authored-By: Claude Opus 5.5 --- .../use_cases/agent_api_keys_use_case.py | 33 ++++++++++------- .../test_agents_api_keys_use_case.py | 35 ++++++++++++++++--- 2 files changed, 51 insertions(+), 17 deletions(-) diff --git a/agentex/src/domain/use_cases/agent_api_keys_use_case.py b/agentex/src/domain/use_cases/agent_api_keys_use_case.py index e6edd884..908c226d 100644 --- a/agentex/src/domain/use_cases/agent_api_keys_use_case.py +++ b/agentex/src/domain/use_cases/agent_api_keys_use_case.py @@ -134,19 +134,26 @@ async def create( api_key_type=api_key_type, api_key=api_key, ) - if slack_socket_mode_app_token_encrypted is None: - return await self.agent_api_key_repo.create(item=agent_api_key) - return await self.agent_api_key_repo.create_with_slack_socket_mode_app( - item=agent_api_key, - app=SlackSocketModeAppEntity( - id=orm_id(), - agent_api_key_id=api_key_id, - agent_id=agent.id, - slack_app_id=name, - app_token_encrypted=slack_socket_mode_app_token_encrypted, - forward_path=slack_socket_mode_forward_path, - ), - ) + try: + if slack_socket_mode_app_token_encrypted is None: + return await self.agent_api_key_repo.create(item=agent_api_key) + return await self.agent_api_key_repo.create_with_slack_socket_mode_app( + item=agent_api_key, + app=SlackSocketModeAppEntity( + id=orm_id(), + agent_api_key_id=api_key_id, + agent_id=agent.id, + slack_app_id=name, + app_token_encrypted=slack_socket_mode_app_token_encrypted, + forward_path=slack_socket_mode_forward_path, + ), + ) + except Exception: + # The key was registered for authorization before the insert, and a + # failed insert leaves no row or id anyone could delete it by. A + # concurrent registration for the same Slack app ends here. + await self._deregister_api_key_from_auth(api_key_id=api_key_id) + raise async def _register_api_key_in_auth( self, diff --git a/agentex/tests/unit/use_cases/test_agents_api_keys_use_case.py b/agentex/tests/unit/use_cases/test_agents_api_keys_use_case.py index 4bee562a..8efdf6af 100644 --- a/agentex/tests/unit/use_cases/test_agents_api_keys_use_case.py +++ b/agentex/tests/unit/use_cases/test_agents_api_keys_use_case.py @@ -3,7 +3,7 @@ import pytest from fastapi import HTTPException -from src.adapters.crud_store.exceptions import ItemDoesNotExist +from src.adapters.crud_store.exceptions import DuplicateItemError, ItemDoesNotExist from src.domain.entities.agent_api_keys import AgentAPIKeyType from src.domain.entities.agents import ACPType, AgentEntity, AgentStatus from src.domain.repositories.agent_api_key_repository import AgentAPIKeyRepository @@ -161,6 +161,35 @@ async def test_delete_by_agent_id( api_key_type=AgentAPIKeyType.EXTERNAL, ) + async def test_failed_insert_removes_the_auth_registration( + self, agent_api_keys_use_case, agent_repository, sample_agent + ): + # Two registrations for one Slack app can both pass the route's duplicate + # check; the loser's insert fails after its key was registered for auth. + auth = agent_api_keys_use_case.authorization_service + auth.principal_context = {"user_id": "user-1"} + first = await create_or_get_agent(agent_repository, sample_agent) + second = await agent_repository.create( + sample_agent.model_copy(update={"id": str(uuid4()), "name": "second"}) + ) + for agent in (first, second): + create = agent_api_keys_use_case.create( + name="A123", + agent_id=agent.id, + api_key_type=AgentAPIKeyType.SLACK, + api_key="signing-secret", + slack_socket_mode_app_token_encrypted="ciphertext", + slack_socket_mode_forward_path="slack/events", + ) + if agent is first: + await create + else: + with pytest.raises(DuplicateItemError): + await create + + losing_key = auth.register_resource.await_args_list[-1].kwargs["resource"] + auth.deregister_resource.assert_awaited_once_with(resource=losing_key) + async def test_create_external_api_key( self, agent_api_keys_use_case, agent_repository, sample_agent ): @@ -268,9 +297,7 @@ def test_returns_none_for_empty_credentials(self): assert extract_agent_key_from_authorization("AgentKey ") is None def test_strips_surrounding_whitespace(self): - assert ( - extract_agent_key_from_authorization(" AgentKey abc123 ") == "abc123" - ) + assert extract_agent_key_from_authorization(" AgentKey abc123 ") == "abc123" @pytest.mark.asyncio From 7d62c41af548c81f728ef6ca0f396283895637c9 Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Wed, 18 Nov 2026 16:21:36 -0600 Subject: [PATCH 13/18] feat(agentex): update a Slack trigger's Socket Mode settings, and run the bridge in compose PUT /agent_api_keys/{id}/slack_socket_mode turns Socket Mode on for an existing Slack trigger or replaces its app token and forward path, after the same token checks as registration. DELETE on the same path turns it off and keeps the trigger. Previously a token could only be changed by deleting and re-registering the trigger. The bridge now reopens a connection whenever its row changes, not only its token. docker compose gains an agentex-slack-socket-bridge service behind the "slack" profile, and the API and the bridge read AGENTEX_CREDENTIAL_ENCRYPTION_KEY from the environment, empty by default. Without the profile nothing changes for make dev. Co-Authored-By: Claude Opus 5.5 --- agentex/docker-compose.yml | 29 ++++ .../docs/docs/development_guides/webhooks.md | 2 + agentex/openapi.yaml | 102 +++++++++++ agentex/src/api/routes/agent_api_keys.py | 162 ++++++++++++++---- agentex/src/api/schemas/agent_api_keys.py | 23 +++ .../repositories/agent_api_key_repository.py | 75 ++++++-- .../services/slack_socket_mode_bridge.py | 11 +- .../use_cases/agent_api_keys_use_case.py | 42 ++++- .../test_slack_socket_mode_apps.py | 105 +++++++++++- .../test_slack_socket_mode_bridge_e2e.py | 22 +++ 10 files changed, 522 insertions(+), 51 deletions(-) diff --git a/agentex/docker-compose.yml b/agentex/docker-compose.yml index 8a2523df..2ca01e0e 100644 --- a/agentex/docker-compose.yml +++ b/agentex/docker-compose.yml @@ -160,6 +160,7 @@ services: - ENVIRONMENT=development - UVICORN_PORT=5003 - DATABASE_URL=postgresql://postgres:postgres@agentex-postgres:5432/agentex + - AGENTEX_CREDENTIAL_ENCRYPTION_KEY=${AGENTEX_CREDENTIAL_ENCRYPTION_KEY:-} - TEMPORAL_ADDRESS=agentex-temporal:7233 - REDIS_URL=redis://agentex-redis:6379 - MONGODB_URI=mongodb://agentex-mongodb:27017 @@ -276,6 +277,34 @@ services: user: root restart: unless-stopped + agentex-slack-socket-bridge: + container_name: agentex-slack-socket-bridge + profiles: ["slack"] + build: + context: .. + dockerfile: agentex/Dockerfile + target: dev + args: + SOURCE_DIR: agentex + environment: + - ENVIRONMENT=development + - DATABASE_URL=postgresql://postgres:postgres@agentex-postgres:5432/agentex + - AGENTEX_CREDENTIAL_ENCRYPTION_KEY=${AGENTEX_CREDENTIAL_ENCRYPTION_KEY:-} + ports: + - "5004:5004" + volumes: + - .:/app:cached + depends_on: + agentex-postgres: + condition: service_healthy + agentex: + condition: service_started + networks: + - agentex-network + command: python -m src.run_slack_socket_mode_bridge + user: root + restart: unless-stopped + volumes: agentex-temporal-postgres-data: agentex-postgres-data: diff --git a/agentex/docs/docs/development_guides/webhooks.md b/agentex/docs/docs/development_guides/webhooks.md index 9766281d..3e2e38fa 100644 --- a/agentex/docs/docs/development_guides/webhooks.md +++ b/agentex/docs/docs/development_guides/webhooks.md @@ -202,6 +202,8 @@ An event is acknowledged only after the agent answers 2xx within 2.5 seconds, or Delivery is at least once: an event whose acknowledgement is lost, for example when a bridge replica stops mid-forward, reaches the agent again. Interactivity and slash-command payloads are not forwarded. +To switch an existing Slack trigger to Socket Mode, or change its token or forward path, `PUT /agent_api_keys//slack_socket_mode` with `app_token` and `forward_path`; it runs the same token check as registration. `DELETE /agent_api_keys//slack_socket_mode` turns Socket Mode off and keeps the trigger. The bridge applies either change within a minute. + Operator notes: - The bridge is its own process, not part of the API: run `python -m src.run_slack_socket_mode_bridge` (from `agentex/`, the same image as the API, like the Temporal worker's `python -m src.temporal.run_worker`) as a separate Deployment with 2 replicas, one process each. It needs only `DATABASE_URL` and `AGENTEX_CREDENTIAL_ENCRYPTION_KEY`, which encrypts the stored app token; without that key it logs one error and exits. It does not connect to Temporal, MongoDB or Redis. diff --git a/agentex/openapi.yaml b/agentex/openapi.yaml index 2bd0287d..4a405f70 100644 --- a/agentex/openapi.yaml +++ b/agentex/openapi.yaml @@ -2858,6 +2858,69 @@ paths: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' + /agent_api_keys/{id}/slack_socket_mode: + put: + tags: + - Agent APIKeys + summary: Serve a Slack trigger over Socket Mode + description: Turn Socket Mode on for an existing Slack trigger, or replace its + app token and forward path. The bridge picks the change up within a minute. + operationId: set_slack_socket_mode_agent_api_keys__id__slack_socket_mode_put + parameters: + - name: id + in: path + required: true + schema: + type: string + title: Id + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/SetSlackSocketModeRequest' + responses: + '200': + description: Successful Response + content: + application/json: + schema: + $ref: '#/components/schemas/SlackSocketMode' + '422': + description: Validation Error + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPValidationError' + delete: + tags: + - Agent APIKeys + summary: Stop serving a Slack trigger over Socket Mode + description: Remove the trigger's app token. The trigger itself stays, and the + bridge closes its connection within a minute. + operationId: delete_slack_socket_mode_agent_api_keys__id__slack_socket_mode_delete + parameters: + - name: id + in: path + required: true + schema: + type: string + title: Id + responses: + '200': + description: Successful Response + content: + application/json: + schema: + type: string + title: Response Delete Slack Socket Mode Agent Api Keys Id Slack + Socket Mode Delete + '422': + description: Validation Error + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPValidationError' /agent_api_keys/name/{name}: get: tags: @@ -6399,6 +6462,25 @@ components: required: - content title: SendMessageRequest + SetSlackSocketModeRequest: + properties: + app_token: + type: string + title: App Token + description: The Slack app's app-level token (xapp-..., scope connections:write). + It must belong to the app the trigger is named for. Stored encrypted and + never returned. + forward_path: + type: string + title: Forward Path + description: Subpath of the agent each event is POSTed to, e.g. 'slack/events'. + type: object + required: + - app_token + - forward_path + title: SetSlackSocketModeRequest + description: Turn Socket Mode on for an existing Slack trigger, or replace its + settings. SkipRunScheduleRequest: properties: scheduled_time: @@ -6410,6 +6492,26 @@ components: required: - scheduled_time title: SkipRunScheduleRequest + SlackSocketMode: + properties: + key_id: + type: string + title: Key Id + description: The Slack trigger's agent API key id. + slack_app_id: + type: string + title: Slack App Id + description: The Slack app served over Socket Mode. + forward_path: + type: string + title: Forward Path + description: Subpath of the agent each event is POSTed to. + type: object + required: + - key_id + - slack_app_id + - forward_path + title: SlackSocketMode Span: properties: id: diff --git a/agentex/src/api/routes/agent_api_keys.py b/agentex/src/api/routes/agent_api_keys.py index 7a5035ad..11bcbc9f 100644 --- a/agentex/src/api/routes/agent_api_keys.py +++ b/agentex/src/api/routes/agent_api_keys.py @@ -11,12 +11,14 @@ CreateAPIKeyResponse, CreateWebhookTriggerRequest, CreateWebhookTriggerResponse, + SetSlackSocketModeRequest, + SlackSocketMode, ) from src.api.schemas.authorization_types import ( AgentexResourceType, AuthorizedOperationType, ) -from src.domain.entities.agent_api_keys import AgentAPIKeyType +from src.domain.entities.agent_api_keys import AgentAPIKeyEntity, AgentAPIKeyType from src.domain.services import slack_socket_mode_bridge from src.domain.services.authorization_service import DAuthorizationService from src.domain.use_cases.agent_api_keys_use_case import DAgentAPIKeysUseCase @@ -134,6 +136,52 @@ def _slack_app_already_served(app_id: str) -> HTTPException: ) +def _clean_forward_path(forward_path: str) -> str: + cleaned = forward_path.lstrip("/") + if _has_control_chars(cleaned): + raise HTTPException( + status_code=400, + detail="forward_path must not contain control characters.", + ) + return cleaned + + +async def _encrypt_checked_app_token( + app_token: str, + app_id: str, + agent_api_key_use_case: DAgentAPIKeysUseCase, + *, + except_key_id: str | None = None, +) -> str: + """Check an app token for the Slack app ``app_id`` and return it encrypted. + + ``except_key_id`` is the trigger being updated, which may already serve the app. + """ + if not app_token.startswith("xapp-"): + raise HTTPException( + status_code=400, + detail="app_token must be a Slack app-level token (xapp-...).", + ) + if not credential_encryption.is_configured(): + raise HTTPException( + status_code=503, + detail="This deployment cannot store app tokens: credential " + "encryption is not configured.", + ) + # The app id is the trigger's name and is unique across agents, so an + # unchecked one would let any caller reserve someone else's app. + await _check_app_token_belongs_to(app_token, app_id) + # Slack gives each event to one of an app's connections, so a second Socket + # Mode trigger for the same app would take part of the first one's events. The + # table's unique constraint enforces this; checking first keeps create()'s auth + # registration from running for a request that is bound to fail. + if await agent_api_key_use_case.has_slack_socket_mode_trigger( + app_id, except_key_id=except_key_id + ): + raise _slack_app_already_served(app_id) + return credential_encryption.encrypt(app_token) + + @router.post( "/webhook-trigger", response_model=CreateWebhookTriggerResponse, @@ -209,12 +257,7 @@ async def create_webhook_trigger( ), ) - forward_path = request.forward_path.lstrip("/") - if _has_control_chars(forward_path): - raise HTTPException( - status_code=400, - detail="forward_path must not contain control characters.", - ) + forward_path = _clean_forward_path(request.forward_path) app_token_encrypted = None if request.app_token is not None: @@ -223,28 +266,9 @@ async def create_webhook_trigger( status_code=400, detail="app_token is only supported for Slack triggers.", ) - if not request.app_token.startswith("xapp-"): - raise HTTPException( - status_code=400, - detail="app_token must be a Slack app-level token (xapp-...).", - ) - if not credential_encryption.is_configured(): - raise HTTPException( - status_code=503, - detail="This deployment cannot store app tokens: credential " - "encryption is not configured.", - ) - # The app id is the trigger's name and is unique across agents, so an - # unchecked one would let any caller reserve someone else's app. - await _check_app_token_belongs_to(request.app_token, request.name) - # Slack gives each event to one of an app's connections, so a second - # Socket Mode trigger for the same app would take part of the first - # one's events. The table's unique constraint enforces this; checking first - # keeps the auth registration in create() from running for a request that - # is bound to fail. - if await agent_api_key_use_case.has_slack_socket_mode_trigger(request.name): - raise _slack_app_already_served(request.name) - app_token_encrypted = credential_encryption.encrypt(request.app_token) + app_token_encrypted = await _encrypt_checked_app_token( + request.app_token, request.name, agent_api_key_use_case + ) secret = request.secret if request.secret is not None else secrets.token_hex(32) try: @@ -282,6 +306,86 @@ async def create_webhook_trigger( ) +async def _slack_trigger_for_update( + key_id: str, + agent_api_key_use_case: DAgentAPIKeysUseCase, + authorization_service: DAuthorizationService, +) -> AgentAPIKeyEntity: + trigger = await agent_api_key_use_case.get(id=key_id) + await _check_api_key_or_collapse_to_404( + authorization_service, trigger.id, AuthorizedOperationType.read + ) + # The same permission registering the trigger needed. + await _check_agent_or_collapse_to_404( + authorization_service, trigger.agent_id, AuthorizedOperationType.update + ) + if not await agent_api_key_use_case.get_agent(agent_id=trigger.agent_id): + raise ItemDoesNotExist(API_KEY_NOT_FOUND_MESSAGE) + if trigger.api_key_type != AgentAPIKeyType.SLACK: + raise HTTPException( + status_code=400, detail="Socket Mode applies only to Slack triggers." + ) + return trigger + + +@router.put( + "/{id}/slack_socket_mode", + response_model=SlackSocketMode, + summary="Serve a Slack trigger over Socket Mode", + description="Turn Socket Mode on for an existing Slack trigger, or replace its " + "app token and forward path. The bridge picks the change up within a minute.", +) +async def set_slack_socket_mode( + id: str, + request: SetSlackSocketModeRequest, + agent_api_key_use_case: DAgentAPIKeysUseCase, + authorization_service: DAuthorizationService, +) -> SlackSocketMode: + trigger = await _slack_trigger_for_update( + id, agent_api_key_use_case, authorization_service + ) + forward_path = _clean_forward_path(request.forward_path) + app_token_encrypted = await _encrypt_checked_app_token( + request.app_token, + trigger.name, + agent_api_key_use_case, + except_key_id=trigger.id, + ) + try: + app = await agent_api_key_use_case.set_slack_socket_mode( + trigger=trigger, + app_token_encrypted=app_token_encrypted, + forward_path=forward_path, + ) + except DuplicateItemError: + raise _slack_app_already_served(trigger.name) from None + return SlackSocketMode( + key_id=trigger.id, slack_app_id=app.slack_app_id, forward_path=app.forward_path + ) + + +@router.delete( + "/{id}/slack_socket_mode", + response_model=str, + summary="Stop serving a Slack trigger over Socket Mode", + description="Remove the trigger's app token. The trigger itself stays, and the " + "bridge closes its connection within a minute.", +) +async def delete_slack_socket_mode( + id: str, + agent_api_key_use_case: DAgentAPIKeysUseCase, + authorization_service: DAuthorizationService, +) -> str: + trigger = await _slack_trigger_for_update( + id, agent_api_key_use_case, authorization_service + ) + if not await agent_api_key_use_case.delete_slack_socket_mode(trigger.id): + raise HTTPException( + status_code=404, detail="This trigger is not served over Socket Mode." + ) + return f"Socket Mode turned off for agent API key {trigger.id}" + + @router.get( "", response_model=list[AgentAPIKey], diff --git a/agentex/src/api/schemas/agent_api_keys.py b/agentex/src/api/schemas/agent_api_keys.py index a63724b6..c2089f63 100644 --- a/agentex/src/api/schemas/agent_api_keys.py +++ b/agentex/src/api/schemas/agent_api_keys.py @@ -118,3 +118,26 @@ class CreateWebhookTriggerResponse(BaseModel): None, description="Full webhook URL to paste into the source (None if no base URL configured).", ) + + +class SetSlackSocketModeRequest(BaseModel): + """Turn Socket Mode on for an existing Slack trigger, or replace its settings.""" + + app_token: str = Field( + ..., + description="The Slack app's app-level token (xapp-..., scope " + "connections:write). It must belong to the app the trigger is named for. " + "Stored encrypted and never returned.", + ) + forward_path: str = Field( + ..., + description="Subpath of the agent each event is POSTed to, e.g. 'slack/events'.", + ) + + +class SlackSocketMode(BaseModel): + key_id: str = Field(..., description="The Slack trigger's agent API key id.") + slack_app_id: str = Field(..., description="The Slack app served over Socket Mode.") + forward_path: str = Field( + ..., description="Subpath of the agent each event is POSTed to." + ) diff --git a/agentex/src/domain/repositories/agent_api_key_repository.py b/agentex/src/domain/repositories/agent_api_key_repository.py index 30d1c9e6..57803572 100644 --- a/agentex/src/domain/repositories/agent_api_key_repository.py +++ b/agentex/src/domain/repositories/agent_api_key_repository.py @@ -3,6 +3,8 @@ from fastapi import Depends from sqlalchemy import delete, insert, select +from sqlalchemy.dialects.postgresql import insert as pg_insert +from sqlalchemy.ext.asyncio import AsyncSession from src.adapters.crud_store.adapter_postgres import ( PostgresCRUDRepository, async_sql_exception_handler, @@ -24,6 +26,23 @@ logger = make_logger(__name__) +async def _drop_deleted_agents_slack_app( + session: AsyncSession, slack_app_id: str +) -> None: + """Remove a Socket Mode row a soft-deleted agent left for this Slack app. + + Deleting an agent keeps its keys, and the app must stay registrable on another + agent despite the unique constraint on the app id. + """ + deleted_agents = select(AgentORM.id).where(AgentORM.status == AgentStatus.DELETED) + await session.execute( + delete(SlackSocketModeAppORM).where( + SlackSocketModeAppORM.slack_app_id == slack_app_id, + SlackSocketModeAppORM.agent_id.in_(deleted_agents), + ) + ) + + class AgentAPIKeyRepository(PostgresCRUDRepository[AgentAPIKeyORM, AgentAPIKeyEntity]): def __init__( self, @@ -182,9 +201,6 @@ async def create_with_slack_socket_mode_app( ) -> AgentAPIKeyEntity: """Create a Slack trigger and its Socket Mode app row in one transaction. - A row left behind by a soft-deleted agent is removed first: deleting an agent - keeps its keys, and the app must stay registrable on another agent. - Raises: DuplicateItemError: A live agent already serves this Slack app. """ @@ -192,15 +208,7 @@ async def create_with_slack_socket_mode_app( self.start_async_db_session(True) as session, async_sql_exception_handler(), ): - deleted_agents = select(AgentORM.id).where( - AgentORM.status == AgentStatus.DELETED - ) - await session.execute( - delete(SlackSocketModeAppORM).where( - SlackSocketModeAppORM.slack_app_id == app.slack_app_id, - SlackSocketModeAppORM.agent_id.in_(deleted_agents), - ) - ) + await _drop_deleted_agents_slack_app(session, app.slack_app_id) values = {k: v for k, v in item.to_dict().items() if v is not None} row = ( await session.execute( @@ -217,6 +225,49 @@ async def create_with_slack_socket_mode_app( await session.commit() return AgentAPIKeyEntity.model_validate(dict(row._mapping)) + async def upsert_slack_socket_mode_app( + self, app: SlackSocketModeAppEntity + ) -> SlackSocketModeAppEntity: + """Serve an existing trigger over Socket Mode, or replace its token and path. + + Raises: + DuplicateItemError: A live agent's other trigger serves this Slack app. + """ + async with ( + self.start_async_db_session(True) as session, + async_sql_exception_handler(), + ): + await _drop_deleted_agents_slack_app(session, app.slack_app_id) + values = {k: v for k, v in app.to_dict().items() if v is not None} + row = ( + await session.execute( + pg_insert(SlackSocketModeAppORM) + .values(**values) + .on_conflict_do_update( + constraint="uq_slack_socket_mode_apps_agent_api_key", + set_={ + "app_token_encrypted": app.app_token_encrypted, + "forward_path": app.forward_path, + }, + ) + .returning(*SlackSocketModeAppORM.__table__.columns) + ) + ).one() + await session.commit() + return SlackSocketModeAppEntity.model_validate(dict(row._mapping)) + + async def delete_slack_socket_mode_app(self, agent_api_key_id: str) -> bool: + """Remove a trigger's Socket Mode row; False if it had none.""" + async with self.start_async_db_session(True) as session: + result = await session.execute( + delete(SlackSocketModeAppORM) + .where(SlackSocketModeAppORM.agent_api_key_id == agent_api_key_id) + .returning(SlackSocketModeAppORM.id) + ) + deleted = result.first() is not None + await session.commit() + return deleted + async def list_slack_socket_mode_apps( self, slack_app_id: str | None = None ) -> builtins.list[tuple[AgentAPIKeyEntity, SlackSocketModeAppEntity]]: diff --git a/agentex/src/domain/services/slack_socket_mode_bridge.py b/agentex/src/domain/services/slack_socket_mode_bridge.py index 59d89536..2e7abd14 100644 --- a/agentex/src/domain/services/slack_socket_mode_bridge.py +++ b/agentex/src/domain/services/slack_socket_mode_bridge.py @@ -163,7 +163,8 @@ def _slack_signature_headers( @dataclass class _Connection: - app_token_encrypted: str + # The row the connection was opened from; its listeners hold this copy. + app: SlackSocketModeAppEntity client: _TriggerSocketModeClient # Held so the task isn't garbage-collected while connect() is still retrying. connect_task: asyncio.Task @@ -222,13 +223,15 @@ async def refresh(self) -> None: self.ready = True for trigger_id, connection in list(self._connections.items()): current = served.get(trigger_id) + # A changed row (new token or forward path) reopens the connection, so + # its listeners pick the change up. if ( current is None - or current[1].app_token_encrypted != connection.app_token_encrypted + or current[1] != connection.app or connection.client.closed ): if connection.client.rejected: - self._rejected.add((trigger_id, connection.app_token_encrypted)) + self._rejected.add((trigger_id, connection.app.app_token_encrypted)) await self._close(trigger_id) elif await connection.client.is_connected(): connection.last_connected = time.monotonic() @@ -275,7 +278,7 @@ async def _open( partial(self._on_request, trigger, app) ) self._connections[trigger.id] = _Connection( - app_token_encrypted=app.app_token_encrypted, + app=app, client=client, connect_task=asyncio.create_task(self._connect(trigger, client)), ) diff --git a/agentex/src/domain/use_cases/agent_api_keys_use_case.py b/agentex/src/domain/use_cases/agent_api_keys_use_case.py index 908c226d..92460481 100644 --- a/agentex/src/domain/use_cases/agent_api_keys_use_case.py +++ b/agentex/src/domain/use_cases/agent_api_keys_use_case.py @@ -244,14 +244,46 @@ async def get_by_agent_id_and_name( agent_id=agent_id, name=name, api_key_type=api_key_type ) - async def has_slack_socket_mode_trigger(self, app_id: str) -> bool: - """Whether a live agent already serves this Slack app over Socket Mode.""" - return bool( - await self.agent_api_key_repo.list_slack_socket_mode_apps( - slack_app_id=app_id + async def has_slack_socket_mode_trigger( + self, app_id: str, except_key_id: str | None = None + ) -> bool: + """Whether a live agent already serves this Slack app over Socket Mode. + + Args: + app_id: The Slack app id. + except_key_id: A trigger to ignore, such as the one being updated. + """ + served = await self.agent_api_key_repo.list_slack_socket_mode_apps( + slack_app_id=app_id + ) + return any(trigger.id != except_key_id for trigger, _ in served) + + async def set_slack_socket_mode( + self, + trigger: AgentAPIKeyEntity, + app_token_encrypted: str, + forward_path: str, + ) -> SlackSocketModeAppEntity: + """Serve a Slack trigger over Socket Mode, or replace its token and path. + + Raises: + DuplicateItemError: Another live trigger serves the same Slack app. + """ + return await self.agent_api_key_repo.upsert_slack_socket_mode_app( + SlackSocketModeAppEntity( + id=orm_id(), + agent_api_key_id=trigger.id, + agent_id=trigger.agent_id, + slack_app_id=trigger.name, + app_token_encrypted=app_token_encrypted, + forward_path=forward_path, ) ) + async def delete_slack_socket_mode(self, key_id: str) -> bool: + """Stop serving a trigger over Socket Mode; False if it was not.""" + return await self.agent_api_key_repo.delete_slack_socket_mode_app(key_id) + async def get_external_by_agent_id_and_key( self, agent_id: str, api_key: str ) -> AgentAPIKeyEntity | None: diff --git a/agentex/tests/integration/api/agent_api_keys/test_slack_socket_mode_apps.py b/agentex/tests/integration/api/agent_api_keys/test_slack_socket_mode_apps.py index a2a581e7..22b05bcc 100644 --- a/agentex/tests/integration/api/agent_api_keys/test_slack_socket_mode_apps.py +++ b/agentex/tests/integration/api/agent_api_keys/test_slack_socket_mode_apps.py @@ -1,6 +1,10 @@ -"""The slack_socket_mode_apps table's guarantees, against a real Postgres.""" +"""The slack_socket_mode_apps table and its endpoints, against a real Postgres.""" + +from unittest.mock import AsyncMock import pytest +import pytest_asyncio +from cryptography.fernet import Fernet from src.adapters.crud_store.exceptions import DuplicateItemError from src.domain.entities.agent_api_keys import ( AgentAPIKeyEntity, @@ -8,6 +12,8 @@ SlackSocketModeAppEntity, ) from src.domain.entities.agents import ACPType, AgentEntity, AgentStatus +from src.domain.services import slack_socket_mode_bridge +from src.utils import credential_encryption from src.utils.ids import orm_id SLACK_APP_ID = "A123" @@ -80,3 +86,100 @@ async def test_deleting_the_trigger_removes_the_app(self, isolated_repositories) await key_repo.delete(trigger.id) assert await key_repo.list_slack_socket_mode_apps() == [] + + +@pytest_asyncio.fixture +async def socket_mode_api(isolated_client, monkeypatch): + """The HTTP API, with an encryption key and Slack's app-id check answered locally.""" + credential_encryption.reset_cache() + monkeypatch.setenv(credential_encryption.ENV_KEY, Fernet.generate_key().decode()) + monkeypatch.setattr( + slack_socket_mode_bridge, + "read_slack_app_id", + AsyncMock(return_value=SLACK_APP_ID), + ) + yield isolated_client + credential_encryption.reset_cache() + + +async def _http_trigger(repos, agent: AgentEntity, source=AgentAPIKeyType.SLACK): + return await repos["agent_api_key_repository"].create( + AgentAPIKeyEntity( + id=orm_id(), + name=SLACK_APP_ID, + agent_id=agent.id, + api_key_type=source, + api_key="signing-secret", + ) + ) + + +@pytest.mark.asyncio +@pytest.mark.integration +class TestSlackSocketModeEndpoints: + async def test_put_turns_socket_mode_on_then_replaces_it( + self, socket_mode_api, isolated_repositories + ): + repos = isolated_repositories + trigger = await _http_trigger(repos, await _agent(repos, "socket-agent")) + url = f"/agent_api_keys/{trigger.id}/slack_socket_mode" + + first = await socket_mode_api.put( + url, json={"app_token": "xapp-1", "forward_path": "slack/events"} + ) + # The trigger already serving the app must not conflict with itself. + second = await socket_mode_api.put( + url, json={"app_token": "xapp-2", "forward_path": "/slack/v2"} + ) + + assert first.status_code == 200, first.text + assert second.status_code == 200, second.text + served = await repos["agent_api_key_repository"].list_slack_socket_mode_apps() + assert [(t.id, app.forward_path) for t, app in served] == [ + (trigger.id, "slack/v2") + ] + + async def test_put_conflicts_with_another_trigger_for_the_app( + self, socket_mode_api, isolated_repositories + ): + repos = isolated_repositories + await _register(repos, await _agent(repos, "first-agent")) + other = await _http_trigger(repos, await _agent(repos, "second-agent")) + + response = await socket_mode_api.put( + f"/agent_api_keys/{other.id}/slack_socket_mode", + json={"app_token": "xapp-1", "forward_path": "slack/events"}, + ) + + assert response.status_code == 409, response.text + + async def test_put_refuses_a_trigger_that_is_not_slack( + self, socket_mode_api, isolated_repositories + ): + repos = isolated_repositories + trigger = await _http_trigger( + repos, await _agent(repos, "github-agent"), AgentAPIKeyType.GITHUB + ) + + response = await socket_mode_api.put( + f"/agent_api_keys/{trigger.id}/slack_socket_mode", + json={"app_token": "xapp-1", "forward_path": "slack/events"}, + ) + + assert response.status_code == 400, response.text + + async def test_delete_turns_socket_mode_off_and_keeps_the_trigger( + self, socket_mode_api, isolated_repositories + ): + repos = isolated_repositories + trigger = await _register(repos, await _agent(repos, "socket-agent")) + url = f"/agent_api_keys/{trigger.id}/slack_socket_mode" + + assert (await socket_mode_api.delete(url)).status_code == 200 + assert (await socket_mode_api.delete(url)).status_code == 404 + + key_repo = repos["agent_api_key_repository"] + assert await key_repo.list_slack_socket_mode_apps() == [] + assert ( + await socket_mode_api.get(f"/agent_api_keys/{trigger.id}") + ).status_code == 200 diff --git a/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py b/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py index 629fad99..4c46636c 100644 --- a/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py +++ b/agentex/tests/integration/services/test_slack_socket_mode_bridge_e2e.py @@ -312,3 +312,25 @@ async def test_bridge_drops_a_token_that_names_another_app(self, bridge, fakes): assert bridge._connections == {} assert slack.connections_opened == 1 assert agent.requests.empty() + + async def test_a_new_forward_path_takes_effect_after_refresh( + self, bridge, fakes, isolated_client + ): + slack, agent = fakes + await bridge.refresh() + await asyncio.wait_for(slack.connected.wait(), WAIT_SECONDS) + + response = await isolated_client.put( + f"/agent_api_keys/{self.key_id}/slack_socket_mode", + json={"app_token": "xapp-1-A123-fake", "forward_path": "slack/v2"}, + ) + assert response.status_code == 200, response.text + slack.forget_connections() + await bridge.refresh() + await asyncio.wait_for(slack.connected.wait(), WAIT_SECONDS) + + await slack.deliver("env-1") + path, _, _ = await asyncio.wait_for(agent.requests.get(), WAIT_SECONDS) + + assert path == "/slack/v2" + assert await asyncio.wait_for(slack.acks.get(), WAIT_SECONDS) == "env-1" From 025373b4000f6f67c4883e5b30fbe2713ac55895 Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Wed, 18 Nov 2026 16:58:20 -0600 Subject: [PATCH 14/18] chore(stlc): seal the python custom code integrated for this branch The python generate step conflicted applying custom code onto this branch's regenerated SDK. stlc build integrated it locally, pushed the result and its sealed refs to the python staging repo, and wrote this tracking file so CI builds from the integrated state instead of hitting the conflict again. Co-Authored-By: Claude Opus 5.5 --- .../python/2026-11-18T22-54-38-804Z-custom-code.json | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 stainless/custom-code/python/2026-11-18T22-54-38-804Z-custom-code.json diff --git a/stainless/custom-code/python/2026-11-18T22-54-38-804Z-custom-code.json b/stainless/custom-code/python/2026-11-18T22-54-38-804Z-custom-code.json new file mode 100644 index 00000000..3867f4a4 --- /dev/null +++ b/stainless/custom-code/python/2026-11-18T22-54-38-804Z-custom-code.json @@ -0,0 +1,6 @@ +{ + "base": "3333f66834c4eb08b1da3a1f3620f6de86e374fc", + "integrated": "a0efbbaec9dba5ec2e71f62fbcb6911e34a941c6", + "filename": "2026-11-18T22-54-38-804Z-custom-code.json", + "branch": "kenairhodes/slack-socket-mode-bridge" +} From f010ef058c3f5922e4da4f557b7603019d4ebfa6 Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Wed, 18 Nov 2026 17:09:11 -0600 Subject: [PATCH 15/18] Revert "chore(stlc): seal the python custom code integrated for this branch" This reverts commit d67521af9e37d7d5416f544874c011c9197b6f82. --- .../python/2026-11-18T22-54-38-804Z-custom-code.json | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 stainless/custom-code/python/2026-11-18T22-54-38-804Z-custom-code.json diff --git a/stainless/custom-code/python/2026-11-18T22-54-38-804Z-custom-code.json b/stainless/custom-code/python/2026-11-18T22-54-38-804Z-custom-code.json deleted file mode 100644 index 3867f4a4..00000000 --- a/stainless/custom-code/python/2026-11-18T22-54-38-804Z-custom-code.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "base": "3333f66834c4eb08b1da3a1f3620f6de86e374fc", - "integrated": "a0efbbaec9dba5ec2e71f62fbcb6911e34a941c6", - "filename": "2026-11-18T22-54-38-804Z-custom-code.json", - "branch": "kenairhodes/slack-socket-mode-bridge" -} From 07780d292f64ec24a7320a44d75a97b455716ae9 Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Wed, 18 Nov 2026 17:09:47 -0600 Subject: [PATCH 16/18] chore(agentex): name the compose profile for the bridge slack-socket-mode Co-Authored-By: Claude Opus 5.5 --- agentex/docker-compose.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/agentex/docker-compose.yml b/agentex/docker-compose.yml index 2ca01e0e..f53a49be 100644 --- a/agentex/docker-compose.yml +++ b/agentex/docker-compose.yml @@ -279,7 +279,7 @@ services: agentex-slack-socket-bridge: container_name: agentex-slack-socket-bridge - profiles: ["slack"] + profiles: ["slack-socket-mode"] build: context: .. dockerfile: agentex/Dockerfile From 916c3cf820bb4ec6521b3763772fc0af0679ac56 Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Wed, 18 Nov 2026 17:20:56 -0600 Subject: [PATCH 17/18] fix(agentex): check access before loading a key in the Socket Mode routes The settings routes loaded the key first, so a missing id returned "Item with id ... does not exist." while a key the caller could not read returned "Agent api_key not found.", letting a caller tell whether another account's key exists. They now check access first, as GET /agent_api_keys/{id} does, and map a failed load to the same message. Co-Authored-By: Claude Opus 5.5 --- agentex/src/api/routes/agent_api_keys.py | 9 ++- .../unit/api/test_slack_socket_mode_routes.py | 61 +++++++++++++++++++ 2 files changed, 68 insertions(+), 2 deletions(-) create mode 100644 agentex/tests/unit/api/test_slack_socket_mode_routes.py diff --git a/agentex/src/api/routes/agent_api_keys.py b/agentex/src/api/routes/agent_api_keys.py index 11bcbc9f..5c900da7 100644 --- a/agentex/src/api/routes/agent_api_keys.py +++ b/agentex/src/api/routes/agent_api_keys.py @@ -311,10 +311,15 @@ async def _slack_trigger_for_update( agent_api_key_use_case: DAgentAPIKeysUseCase, authorization_service: DAuthorizationService, ) -> AgentAPIKeyEntity: - trigger = await agent_api_key_use_case.get(id=key_id) + # Check before loading: a missing key and one the caller cannot read must both + # return the same 404, or the response reveals whether another account's key exists. await _check_api_key_or_collapse_to_404( - authorization_service, trigger.id, AuthorizedOperationType.read + authorization_service, key_id, AuthorizedOperationType.read ) + try: + trigger = await agent_api_key_use_case.get(id=key_id) + except ItemDoesNotExist: + raise ItemDoesNotExist(API_KEY_NOT_FOUND_MESSAGE) from None # The same permission registering the trigger needed. await _check_agent_or_collapse_to_404( authorization_service, trigger.agent_id, AuthorizedOperationType.update diff --git a/agentex/tests/unit/api/test_slack_socket_mode_routes.py b/agentex/tests/unit/api/test_slack_socket_mode_routes.py new file mode 100644 index 00000000..6a5a6c3f --- /dev/null +++ b/agentex/tests/unit/api/test_slack_socket_mode_routes.py @@ -0,0 +1,61 @@ +"""Access checks on the Slack Socket Mode settings routes.""" + +from unittest.mock import AsyncMock, MagicMock + +import pytest +import src.api.routes.agent_api_keys as mod +from src.adapters.authorization.exceptions import AuthorizationError +from src.adapters.crud_store.exceptions import ItemDoesNotExist +from src.api.schemas.agent_api_keys import SetSlackSocketModeRequest +from src.utils.agent_api_key_authorization import API_KEY_NOT_FOUND_MESSAGE + +MISSING = ItemDoesNotExist("Item with id 'key-1' does not exist.") + + +def _set(use_case, authorization): + return mod.set_slack_socket_mode( + id="key-1", + request=SetSlackSocketModeRequest(app_token="xapp-1", forward_path="slack"), + agent_api_key_use_case=use_case, + authorization_service=authorization, + ) + + +def _delete(use_case, authorization): + return mod.delete_slack_socket_mode( + id="key-1", + agent_api_key_use_case=use_case, + authorization_service=authorization, + ) + + +@pytest.mark.unit +@pytest.mark.asyncio +@pytest.mark.parametrize("route", [_set, _delete], ids=["put", "delete"]) +@pytest.mark.parametrize( + ("readable", "stored"), + [ + pytest.param(False, MagicMock(id="key-1"), id="another-accounts-key"), + pytest.param(False, MISSING, id="no-such-key"), + # An access grant left behind for a key that is gone. + pytest.param(True, MISSING, id="stale-grant"), + ], +) +async def test_a_key_the_caller_cannot_see_looks_the_same_as_a_missing_one( + route, readable, stored +): + # Different 404s would tell a caller whether another account's key exists. + authorization = MagicMock() + authorization.check = AsyncMock( + side_effect=None if readable else AuthorizationError("denied") + ) + use_case = MagicMock() + use_case.get = AsyncMock( + side_effect=stored if isinstance(stored, Exception) else None, + return_value=stored, + ) + + with pytest.raises(ItemDoesNotExist) as exc: + await route(use_case, authorization) + + assert str(exc.value.message) == API_KEY_NOT_FOUND_MESSAGE From dbc7f89a4fa4ca66f8fe13ce83f2b047f325e69f Mon Sep 17 00:00:00 2001 From: Kenai Rhodes Date: Thu, 19 Nov 2026 10:59:24 -0600 Subject: [PATCH 18/18] fix(agentex): load the environment before the bridge checks its key In development, EnvironmentVariables.refresh() loads agentex/.env into the environment. The bridge checked AGENTEX_CREDENTIAL_ENCRYPTION_KEY before that ran, so a key set only in .env, which the API does pick up, made the bridge exit and deliver nothing. It now loads the environment first. Co-Authored-By: Claude Opus 5.5 --- agentex/src/run_slack_socket_mode_bridge.py | 4 ++- .../services/test_slack_socket_mode_bridge.py | 27 +++++++++++++++++++ 2 files changed, 30 insertions(+), 1 deletion(-) diff --git a/agentex/src/run_slack_socket_mode_bridge.py b/agentex/src/run_slack_socket_mode_bridge.py index 74611eec..2ccaac3a 100644 --- a/agentex/src/run_slack_socket_mode_bridge.py +++ b/agentex/src/run_slack_socket_mode_bridge.py @@ -97,6 +97,8 @@ async def main(probe_port: int = PROBE_PORT) -> None: else: cleanup.callback(shutdown_otel_metrics) + # Loads agentex/.env in development, which may be where the key is. + env = EnvironmentVariables.refresh() # App tokens are stored encrypted, so without the key no trigger can be # served; refuse once here rather than failing per trigger. if not credential_encryption.is_configured(): @@ -107,7 +109,7 @@ async def main(probe_port: int = PROBE_PORT) -> None: ) raise SystemExit(1) - engine = create_engine(EnvironmentVariables.refresh().DATABASE_URL) + engine = create_engine(env.DATABASE_URL) cleanup.push_async_callback(engine.dispose) http_client = httpx.AsyncClient() cleanup.push_async_callback(http_client.aclose) diff --git a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py index 42ccc763..93fd1e6a 100644 --- a/agentex/tests/unit/services/test_slack_socket_mode_bridge.py +++ b/agentex/tests/unit/services/test_slack_socket_mode_bridge.py @@ -7,6 +7,7 @@ import pytest import slack_sdk.socket_mode.async_client as sdk_async_client import src.run_slack_socket_mode_bridge as entrypoint +from cryptography.fernet import Fernet from slack_sdk.errors import SlackApiError from slack_sdk.socket_mode.request import SocketModeRequest from slack_sdk.web.async_client import AsyncWebClient @@ -334,6 +335,32 @@ async def test_cancelling_main_stops_bridge_and_disposes_engine(self, monkeypatc fake.stop.assert_awaited_once() engine.dispose.assert_awaited_once() + async def test_reads_the_key_from_the_environment_file(self, monkeypatch): + # In development the key may exist only in agentex/.env, which + # EnvironmentVariables.refresh() loads into the environment. + class Started(Exception): + pass + + def refresh_loading_env_file(): + monkeypatch.setenv( + entrypoint.credential_encryption.ENV_KEY, + Fernet.generate_key().decode(), + ) + return MagicMock(DATABASE_URL="postgresql://example.invalid/agentex") + + monkeypatch.delenv(entrypoint.credential_encryption.ENV_KEY, raising=False) + entrypoint.credential_encryption.reset_cache() + monkeypatch.setattr( + entrypoint.EnvironmentVariables, "refresh", refresh_loading_env_file + ) + monkeypatch.setattr(entrypoint, "create_engine", MagicMock(side_effect=Started)) + + try: + with pytest.raises(Started): + await entrypoint.main(probe_port=0) + finally: + entrypoint.credential_encryption.reset_cache() + async def test_refuses_to_start_without_encryption_key(self, monkeypatch): create_engine = MagicMock() monkeypatch.setattr(entrypoint, "create_engine", create_engine)