Metadata-Version: 2.4
Name: agentcore-sdk-agentrun-compat-core
Version: 0.1.0.post1
Summary: Core implementation for migrating AgentRun Python SDK applications to AgentCore
Author: AgentCore Team
License-Expression: Apache-2.0
Project-URL: Documentation, https://www.alibabacloud.com/help/en/agentcore/agentcore-product-overview
Keywords: agentcore,agentrun,compatibility,migration,alibaba-cloud
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSES/Apache-2.0.txt
License-File: THIRD_PARTY_NOTICES.md
Requires-Dist: requests>=2.28
Requires-Dist: python-dotenv>=1.0
Requires-Dist: pydash>=8.0.5
Requires-Dist: pydantic<3,>=2.12.4
Requires-Dist: PyYAML<7,>=6
Requires-Dist: litellm==1.95.0; python_version < "3.11"
Requires-Dist: litellm<2,>=1.95.0; python_version >= "3.11"
Provides-Extra: server
Requires-Dist: fastapi<1,>=0.104; extra == "server"
Requires-Dist: uvicorn>=0.24; extra == "server"
Requires-Dist: ag-ui-protocol>=0.1.10; extra == "server"
Provides-Extra: mcp
Requires-Dist: mcp<2,>=1.21.2; extra == "mcp"
Provides-Extra: credentials
Requires-Dist: alibabacloud-agentidentitydata20251127<3,>=2.0; extra == "credentials"
Requires-Dist: alibabacloud-tea-openapi>=0.3; extra == "credentials"
Provides-Extra: langchain
Requires-Dist: langchain<2,>=1.0.0; extra == "langchain"
Requires-Dist: langchain-openai<2,>=1.0.0; extra == "langchain"
Requires-Dist: langchain-deepseek<2,>=1.0.1; extra == "langchain"
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
Requires-Dist: pytest-cov>=5; extra == "dev"
Requires-Dist: httpx<1,>=0.27; extra == "dev"
Dynamic: license-file

# AgentCore AgentRun Compatibility SDK — Core

`agentcore-sdk-agentrun-compat-core` is the implementation package used by
`agentcore-sdk-agentrun-compat`. It helps applications written for the original
AgentRun Python SDK migrate to AgentCore.

Most users should not install this package directly. Install the compatibility
entry package instead:

```bash
python -m pip uninstall -y agentrun-sdk
python -m pip install agentcore-sdk-agentrun-compat
```

The SDK requires Python 3.10 or newer. The release gate builds and installs both
distributions in clean Python 3.10 and Python 3.12 containers. The distributions
are `py3-none-any` wheels.

The PyPI distribution was deliberately given a compatibility-specific name so
that it is not confused with the official AgentCore SDK. The Python import names
remain unchanged:

```python
from agentrun.agent_runtime import AgentRuntimeClient
from agentrun.utils.config import Config
```

The entry package installs this core package automatically and provides the
`agentrun` namespace. The core package itself provides the `agentcore`
namespace.

## Configuration

Set the AgentCore workspace and standard Alibaba Cloud credentials in the
runtime environment:

```bash
export AGENTCORE_WORKSPACE_ID="<workspace-id>"
export ALIBABA_CLOUD_ACCESS_KEY_ID="<access-key-id>"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="<access-key-secret>"
```

`AGENTCORE_ENDPOINT`, `AGENTCORE_REGION_ID`, `AGENTCORE_API_VERSION`, and
`ALIBABA_CLOUD_SECURITY_TOKEN` can be set when the deployment requires them.

The compatibility SDK implements the AgentRun-facing APIs that AgentCore can
carry. APIs that depend on capabilities not provided by AgentCore either expose
an explicit platform-difference error or require migration-specific input. See
the compatibility entry package README and the repository migration guide for
the supported migration boundary.

Do not install `agentrun-sdk` and `agentcore-sdk-agentrun-compat` in the same
environment: both provide the `agentrun` import namespace.
