Metadata-Version: 2.5
Name: agentex-sdk
Version: 0.28.1
Summary: Agent Development Kit (ADK) overlay for the Agentex API — FastACP server, Temporal workflows, LLM provider integrations, observability
Project-URL: Homepage, https://github.com/scaleapi/scale-agentex-python
Project-URL: Repository, https://github.com/scaleapi/scale-agentex-python
Author-email: Agentex <roxanne.farhad@scale.com>
License-Expression: Apache-2.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: <4,>=3.12
Requires-Dist: agentex-client>=0.13.0
Requires-Dist: aiohttp<4,>=3.10.10
Requires-Dist: claude-agent-sdk>=0.1.0
Requires-Dist: cloudpickle>=3.1.1
Requires-Dist: ddtrace>=3.13.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: jinja2<4,>=3.1.3
Requires-Dist: json-log-formatter>=1.1.1
Requires-Dist: jsonref<2,>=1.1.0
Requires-Dist: jsonschema<5,>=4.23.0
Requires-Dist: kubernetes<36.0.0,>=25.0.0
Requires-Dist: langgraph-checkpoint>=2.0.0
Requires-Dist: litellm<2,>=1.83.7
Requires-Dist: mcp>=1.4.1
Requires-Dist: openai-agents<0.15,>=0.14.3
Requires-Dist: openai<2.45,>=2.2
Requires-Dist: opentelemetry-api>=1.20.0
Requires-Dist: opentelemetry-sdk>=1.20.0
Requires-Dist: pydantic-ai-slim<2,>=1.0
Requires-Dist: python-on-whales<0.74,>=0.73.0
Requires-Dist: pyyaml<7,>=6.0.2
Requires-Dist: questionary<3,>=2.0.1
Requires-Dist: redis<8,>=5.2.0
Requires-Dist: rich<14,>=13.9.2
Requires-Dist: scale-gp-beta>=0.5.0
Requires-Dist: scale-gp>=0.1.0a59
Requires-Dist: starlette>=0.49.1
Requires-Dist: temporalio<2,>=1.26.0
Requires-Dist: typer<0.17,>=0.16
Requires-Dist: uvicorn>=0.31.1
Requires-Dist: watchfiles<1.0,>=0.24.0
Requires-Dist: yaspin>=3.1.0
Description-Content-Type: text/markdown

# agentex-sdk

The Agent Development Kit (ADK) overlay for the Agentex API.

## What's in here

This package ships everything under `agentex.lib.*`:

- **ACP server** (`agentex.lib.sdk.fastacp`) — FastAPI-based agent control plane.
- **Temporal workflows** (`agentex.lib.core.temporal`) — durable agent execution.
- **CLI** (`agentex.lib.cli`) — `agentex init`, `agentex run`, deploy helpers.
- **LLM provider integrations** (`agentex.lib.adk.providers`, `agentex.lib.core.temporal.plugins`) — OpenAI Agents, Claude Agent SDK, pydantic-ai, langgraph, litellm.
- **Observability** (`agentex.lib.core.tracing`, `agentex.lib.core.observability`) — SGP, Datadog, OpenTelemetry tracing processors.

## Installation

```sh
pip install agentex-sdk
```

This automatically pulls in [`agentex-client`](../) (the slim Stainless-generated REST client) so `from agentex import Agentex, AsyncAgentex` works the same as before.

## When to use this vs `agentex-client`

- **`agentex-sdk`** — you're authoring agents. Pulls everything: ACP server, Temporal, MCP, LLM providers, observability, CLI. ~37 deps.
- **`agentex-client`** — you only need to call the Agentex REST API. No agent authoring, no Temporal workflows, no FastACP server, no provider integrations. 6 deps.

The two packages contribute disjoint files to the `agentex.*` namespace — `agentex/lib/*` ships only from `agentex-sdk`.

## Workflow logging

Use the workflow logger in Temporal workflow code:

```python
from agentex.lib.core.temporal.logging import make_workflow_logger

logger = make_workflow_logger(__name__)
```

It suppresses logs while Temporal replays recorded history and adds top-level
`workflow_id` and `run_id` fields during workflow execution. It preserves the
message, caller fields, and exception details. Outside workflows, including in
activities, it behaves like the ordinary SDK logger.

New Temporal templates use this helper. Existing agents must replace their own
workflow loggers to get the same behavior. This does not create trace context or
add trace IDs to workflows that lack it. Temporal's worker diagnostics still report
replay failures.

## Repo layout

This package is hand-authored and lives at `adk/` inside [scaleapi/scale-agentex-python](https://github.com/scaleapi/scale-agentex-python). Stainless codegen never touches `adk/**` — it's outside the generated surface. The sibling `agentex-client` package lives at the repo root and IS Stainless-generated.

The wheel source is assembled from `src/agentex/lib/**` by `adk/hatch_build.py`.
