Metadata-Version: 2.4
Name: stacklink-sdk
Version: 0.2.0
Summary: Python SDK for Stacklink sessions, tools, MCP, auth, workbench, logs, knowledge, and billing.
Author: Stacklink
License-Expression: LicenseRef-Proprietary
Project-URL: Documentation, https://docs.stacklink.in/docs/quickstart
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: openai
Requires-Dist: openai<3,>=2.0; extra == "openai"
Provides-Extra: openai-agents
Requires-Dist: openai-agents<0.19,>=0.18; extra == "openai-agents"
Provides-Extra: claude-agent
Requires-Dist: claude-agent-sdk<0.3,>=0.2; extra == "claude-agent"
Dynamic: license-file

# Stacklink Python SDK

Stacklink supplies executable, governed tools to an agent harness. The selected harness owns the model call, tool loop, and final answer.

Install the public package with the harness extra you use:

```bash
uv add 'stacklink-sdk[openai-agents]'
```

or:

```bash
uv add 'stacklink-sdk[claude-agent]'
```

The complete guides and certified recipes live at [docs.stacklink.in](https://docs.stacklink.in/docs/quickstart). PyPI is the package delivery system, not the primary documentation surface. Stacklink does not display registry download badges in its product or documentation.

## Certified agent harnesses

| Harness | Stacklink adapter |
|---|---|
| OpenAI Agents SDK | `create_stacklink_openai_agents_tools(session)` |
| Claude Agent SDK | `create_stacklink_claude_agent_tool_config(session)` |

Both start with one explicit Stacklink session:

```python
import os
from stacklink import Stacklink

stacklink = Stacklink(
    api_key=os.environ['STACKLINK_API_KEY'],
    base_url=os.getenv('STACKLINK_BASE_URL', 'https://api.stacklink.in'),
)
session = stacklink.sessions.create_bound({
    'externalTenantId': 'acme',
    'externalUserId': 'user_123',
    'metaTools': {'surface': 'connector'},
})

try:
    # Pass the selected Stacklink adapter output to your agent harness.
    pass
finally:
    session.close()
```

The complete OpenAI Agents and Claude Agent examples shown by the Stacklink Overview are generated from the executable files under `examples/sdk/`. The dashboard, documentation, and certification tests all read those same files.

The raw OpenAI `with_stacklink_memory` helper remains a separate Memory integration. It is not the agent-tool integration and is not part of basic Overview onboarding.

Environment variables are `STACKLINK_API_KEY`, optional `STACKLINK_BASE_URL`, and the model-provider credentials required by the selected harness. The SDK is proprietary and is provided under the applicable Stacklink agreement.
