Metadata-Version: 2.4
Name: deepflow-openagent-cli
Version: 0.1.3
Summary: Command-line client for OpenAgent OpenAPI (agents, conversations, SSE chat, tools, channels, knowledge bases).
Author: DeepFlow AI
Project-URL: Repository, https://github.com/DeepFlowAI/OpenAgent
Keywords: deepflow,openagent,newagent,openapi,cli,sse,chat
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"

# deepflow-openagent-cli

Python command-line client for the OpenAgent OpenAPI: agents, conversations, SSE chat, tools, channels, documents, and knowledge bases.

## Install

```bash
pip install deepflow-openagent-cli
```

## Usage

```bash
export OPENAGENT_HOST="https://your-api-host"
export OPENAGENT_API_KEY="sk-..."
deepflow_openagent_cli docs list
deepflow_openagent_cli agents list
```

Equivalent module invocation:

```bash
python -m deepflow_openagent_cli docs list
```

## Configure API host and key

| Method | Variable / flag |
|--------|------------------|
| Host | `OPENAGENT_HOST` or `--host` |
| API key | `OPENAGENT_API_KEY` or `--api-key` |

Legacy `NEWAGENT_HOST` and `NEWAGENT_API_KEY` are still read as fallbacks.

When using flags, put global flags before the command:

```bash
deepflow_openagent_cli --host http://localhost:5001 --api-key sk-... agents list
```

## Common commands

```bash
deepflow_openagent_cli docs show chat.stream --json
deepflow_openagent_cli knowledge list --page 1 --per-page 10
deepflow_openagent_cli knowledge documents 1
deepflow_openagent_cli knowledge query-document 6670 --slice-id 512208 --line 1720
deepflow_openagent_cli chat 1 --message "Hello"
deepflow_openagent_cli steps 1 42
deepflow_openagent_cli steps get 1 42 100
```

## Development (build wheel/sdist locally)

From this directory:

```bash
pip install -e ".[dev]"
pytest
python -m build
```

Upload to PyPI (use a **new** API token; never commit tokens):

```bash
python -m twine upload dist/*
```

When prompted, username is `__token__` and password is the token value.
