deepflow-openagent-cli 0.1.0__tar.gz → 0.1.3__tar.gz

{deepflow_openagent_cli-0.1.0 → deepflow_openagent_cli-0.1.3}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: deepflow-openagent-cli
-Version: 0.1.0
-Summary: Command-line client for NewAgent OpenAPI (agents, conversations, SSE chat, tools, channels, knowledge bases).
+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/newagent
+Project-URL: Repository, https://github.com/DeepFlowAI/OpenAgent
 Keywords: deepflow,openagent,newagent,openapi,cli,sse,chat
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -16,11 +16,12 @@ 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 NewAgent OpenAPI: agents, conversations, SSE chat, tools, channels, and knowledge bases.
+Python command-line client for the OpenAgent OpenAPI: agents, conversations, SSE chat, tools, channels, documents, and knowledge bases.
 
 ## Install
 
@@ -31,8 +32,8 @@ pip install deepflow-openagent-cli
 ## Usage
 
 ```bash
-export NEWAGENT_HOST="https://your-api-host"
-export NEWAGENT_API_KEY="sk-..."
+export OPENAGENT_HOST="https://your-api-host"
+export OPENAGENT_API_KEY="sk-..."
 deepflow_openagent_cli docs list
 deepflow_openagent_cli agents list
 ```
@@ -47,15 +48,36 @@ python -m deepflow_openagent_cli docs list
 
 | Method | Variable / flag |
 |--------|------------------|
-| Host | `NEWAGENT_HOST` or `--host` |
-| API key | `NEWAGENT_API_KEY` or `--api-key` |
+| 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 build twine
+pip install -e ".[dev]"
+pytest
 python -m build
 ```
 

deepflow_openagent_cli-0.1.3/README.md

@@ -0,0 +1,69 @@
+# 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.

{deepflow_openagent_cli-0.1.0 → deepflow_openagent_cli-0.1.3}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepflow-openagent-cli"
-version = "0.1.0"
-description = "Command-line client for NewAgent OpenAPI (agents, conversations, SSE chat, tools, channels, knowledge bases)."
+version = "0.1.3"
+description = "Command-line client for OpenAgent OpenAPI (agents, conversations, SSE chat, tools, channels, knowledge bases)."
 readme = "README.md"
 requires-python = ">=3.11"
 authors = [{ name = "DeepFlow AI" }]
@@ -23,10 +23,10 @@ classifiers = [
 dependencies = []
 
 [project.optional-dependencies]
-dev = ["build>=1.0", "twine>=5.0"]
+dev = ["build>=1.0", "pytest>=8.0", "twine>=5.0"]
 
 [project.urls]
-Repository = "https://github.com/DeepFlowAI/newagent"
+Repository = "https://github.com/DeepFlowAI/OpenAgent"
 
 [project.scripts]
 deepflow_openagent_cli = "deepflow_openagent_cli.cli:main"

{deepflow_openagent_cli-0.1.0 → deepflow_openagent_cli-0.1.3}/src/deepflow_openagent_cli/__init__.py

@@ -1,3 +1,3 @@
 """DeepFlow OpenAgent CLI — published PyPI package."""
 
-__version__ = "0.1.0"
+__version__ = "0.1.3"

{deepflow_openagent_cli-0.1.0 → deepflow_openagent_cli-0.1.3}/src/deepflow_openagent_cli/cli.py

@@ -1,5 +1,5 @@
 """
-NewAgent OpenAPI command line client.
+OpenAgent OpenAPI command line client.
 
 Run with:
     deepflow_openagent_cli docs list
@@ -20,8 +20,10 @@ from urllib.request import Request, urlopen
 
 
 DEFAULT_HOST = "http://localhost:5001"
-ENV_HOST = "NEWAGENT_HOST"
-ENV_API_KEY = "NEWAGENT_API_KEY"
+ENV_HOST = "OPENAGENT_HOST"
+ENV_API_KEY = "OPENAGENT_API_KEY"
+LEGACY_ENV_HOST = "NEWAGENT_HOST"
+LEGACY_ENV_API_KEY = "NEWAGENT_API_KEY"
 
 
 class CliError(Exception):
@@ -56,6 +58,20 @@ def _param(name: str, type_: str, required: bool, description: str) -> ParamDoc:
 
 
 ENDPOINTS: tuple[EndpointDoc, ...] = (
+    EndpointDoc(
+        key="knowledge.list",
+        method="GET",
+        path="/api/v1/knowledge-bases",
+        scope="chat",
+        summary="List knowledge bases for the current tenant.",
+        query_params=[
+            _param("page", "integer", False, "Page number."),
+            _param("per_page", "integer", False, "Items per page, 1-100."),
+        ],
+        response="Paginated list of public knowledge base fields.",
+        errors=["401 missing or invalid API key", "403 scope missing", "422 validation error"],
+        example="deepflow_openagent_cli knowledge list --page 1 --per-page 10",
+    ),
     EndpointDoc(
         key="knowledge.search",
         method="POST",
@@ -90,6 +106,36 @@ ENDPOINTS: tuple[EndpointDoc, ...] = (
         errors=["401 missing or invalid API key", "404 document not found"],
         example="deepflow_openagent_cli knowledge markdown 1 20 --raw",
     ),
+    EndpointDoc(
+        key="knowledge.documents",
+        method="GET",
+        path="/api/v1/knowledge-bases/{kb_id}/documents",
+        scope="chat",
+        summary="List documents in a knowledge base without embedding Markdown content.",
+        path_params=[_param("kb_id", "integer", True, "Knowledge base ID.")],
+        query_params=[
+            _param("page", "integer", False, "Page number."),
+            _param("per_page", "integer", False, "Items per page, 1-100."),
+        ],
+        response="Paginated list with id, file_path, title, slice_count, updated_at, doc_meta, and markdown_url.",
+        errors=["401 missing or invalid API key", "403 scope missing", "404 knowledge base not found", "422 validation error"],
+        example="deepflow_openagent_cli knowledge documents 1 --page 1 --per-page 20",
+    ),
+    EndpointDoc(
+        key="documents.query",
+        method="POST",
+        path="/api/v1/documents/query",
+        scope="chat",
+        summary="Resolve a document reference by doc_id with optional slice_id and line.",
+        body_fields=[
+            _param("doc_id", "integer", True, "Document ID, positive integer."),
+            _param("slice_id", "integer", False, "Optional slice ID, must belong to doc_id when provided."),
+            _param("line", "integer", False, "Optional Markdown source line number, starting at 1."),
+        ],
+        response="Resolved document fields with optional slice and line details.",
+        errors=["401 missing or invalid API key", "403 scope missing", "422 validation error"],
+        example="deepflow_openagent_cli knowledge query-document 6670 --slice-id 512208 --line 1720",
+    ),
     EndpointDoc(
         key="conversations.create",
         method="POST",
@@ -195,6 +241,21 @@ ENDPOINTS: tuple[EndpointDoc, ...] = (
         errors=["401 missing or invalid API key", "404 conversation not found"],
         example="deepflow_openagent_cli steps 1 42",
     ),
+    EndpointDoc(
+        key="steps.get",
+        method="GET",
+        path="/api/v1/agents/{agent_id}/conversations/{conversation_id}/steps/{step_id}",
+        scope="chat",
+        summary="Get full execution step detail, including LLM request/response payload fields.",
+        path_params=[
+            _param("agent_id", "integer", True, "Agent ID."),
+            _param("conversation_id", "integer", True, "Conversation ID."),
+            _param("step_id", "integer", True, "Step ID."),
+        ],
+        response="StepDetailResponse with request_messages, request_tools, request_params, response fields, and child tool calls.",
+        errors=["401 missing or invalid API key", "404 step not found"],
+        example="deepflow_openagent_cli steps get 1 42 100",
+    ),
     EndpointDoc(
         key="agents.list",
         method="GET",
@@ -270,7 +331,7 @@ ENDPOINTS: tuple[EndpointDoc, ...] = (
         summary="Partially update system_prompt, model, selected_tool_ids, context, or pre_recall.",
         path_params=[_param("agent_id", "integer", True, "Agent ID.")],
         body_fields=[
-            _param("system_prompt", "string", False, "System prompt, max 10000 chars."),
+            _param("system_prompt", "string", False, "System prompt, max 30000 chars."),
             _param("model", "object", False, "Model config."),
             _param("selected_tool_ids", "array[integer]", False, "Enabled tool IDs."),
             _param("context", "object", False, "Context policy."),
@@ -301,7 +362,7 @@ ENDPOINTS: tuple[EndpointDoc, ...] = (
         body_fields=[
             _param("name", "string", True, "Tool name, 1-128 chars."),
             _param("description", "string", False, "Tool description."),
-            _param("tool_type", "string", True, "search, doc_query, notebook, tool_response_fetch, or python_code."),
+            _param("tool_type", "string", True, "search, doc_query, doc_grep, notebook, tool_response_fetch, or python_code."),
             _param("config", "object", False, "Tool config."),
         ],
         response="AgentToolResponse.",
@@ -475,7 +536,7 @@ ENDPOINT_BY_KEY = {endpoint.key: endpoint for endpoint in ENDPOINTS}
 
 
 class OpenApiClient:
-    """Small HTTP client for NewAgent OpenAPI endpoints."""
+    """Small HTTP client for OpenAgent OpenAPI endpoints."""
 
     def __init__(self, host: str, api_key: str | None) -> None:
         self.host = host.rstrip("/")
@@ -639,8 +700,8 @@ def handle_docs(args: argparse.Namespace) -> int:
 
 
 def client_from_args(args: argparse.Namespace) -> OpenApiClient:
-    host = args.host or os.getenv(ENV_HOST) or DEFAULT_HOST
-    api_key = args.api_key or os.getenv(ENV_API_KEY)
+    host = args.host or os.getenv(ENV_HOST) or os.getenv(LEGACY_ENV_HOST) or DEFAULT_HOST
+    api_key = args.api_key or os.getenv(ENV_API_KEY) or os.getenv(LEGACY_ENV_API_KEY)
     return OpenApiClient(host=host, api_key=api_key)
 
 
@@ -665,9 +726,28 @@ def run_request(
 
 
 def handle_knowledge(args: argparse.Namespace) -> int:
+    if args.knowledge_action == "list":
+        return run_request(args, "knowledge.list", query={"page": args.page, "per_page": args.per_page})
     if args.knowledge_action == "search":
         body = merge_payload(args, {"query": args.query})
         return run_request(args, "knowledge.search", {"kb_id": args.kb_id}, body=body)
+    if args.knowledge_action == "documents":
+        return run_request(
+            args,
+            "knowledge.documents",
+            {"kb_id": args.kb_id},
+            query={"page": args.page, "per_page": args.per_page},
+        )
+    if args.knowledge_action == "query-document":
+        return run_request(
+            args,
+            "documents.query",
+            body={
+                "doc_id": args.doc_id,
+                "slice_id": args.slice_id,
+                "line": args.line,
+            },
+        )
     return run_request(args, "knowledge.markdown", {"kb_id": args.kb_id, "doc_id": args.doc_id})
 
 
@@ -720,10 +800,24 @@ def handle_chat(args: argparse.Namespace) -> int:
 
 
 def handle_steps(args: argparse.Namespace) -> int:
+    action, values = parse_steps_args(args.steps_args)
+    if action == "get":
+        agent_id, conversation_id, step_id = values
+        return run_request(
+            args,
+            "steps.get",
+            {
+                "agent_id": agent_id,
+                "conversation_id": conversation_id,
+                "step_id": step_id,
+            },
+        )
+
+    agent_id, conversation_id = values
     return run_request(
         args,
         "steps.list",
-        {"agent_id": args.agent_id, "conversation_id": args.conversation_id},
+        {"agent_id": agent_id, "conversation_id": conversation_id},
     )
 
 
@@ -829,7 +923,7 @@ def add_common_args(parser: argparse.ArgumentParser) -> None:
 
 
 def build_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(description="NewAgent OpenAPI CLI")
+    parser = argparse.ArgumentParser(description="OpenAgent OpenAPI CLI")
     add_common_args(parser)
     subparsers = parser.add_subparsers(dest="command", required=True)
 
@@ -843,10 +937,21 @@ def build_parser() -> argparse.ArgumentParser:
 
     knowledge = subparsers.add_parser("knowledge", help="Knowledge base endpoints.")
     knowledge_sub = knowledge.add_subparsers(dest="knowledge_action", required=True)
+    knowledge_list = knowledge_sub.add_parser("list")
+    knowledge_list.add_argument("--page", type=int)
+    knowledge_list.add_argument("--per-page", type=int)
     knowledge_search = knowledge_sub.add_parser("search")
     knowledge_search.add_argument("kb_id", type=int)
     knowledge_search.add_argument("--query", required=True)
     add_json_args(knowledge_search)
+    knowledge_documents = knowledge_sub.add_parser("documents")
+    knowledge_documents.add_argument("kb_id", type=int)
+    knowledge_documents.add_argument("--page", type=int)
+    knowledge_documents.add_argument("--per-page", type=int)
+    knowledge_query_document = knowledge_sub.add_parser("query-document")
+    knowledge_query_document.add_argument("doc_id", type=int)
+    knowledge_query_document.add_argument("--slice-id", type=int)
+    knowledge_query_document.add_argument("--line", type=int)
     knowledge_markdown = knowledge_sub.add_parser("markdown")
     knowledge_markdown.add_argument("kb_id", type=int)
     knowledge_markdown.add_argument("doc_id", type=int)
@@ -891,9 +996,16 @@ def build_parser() -> argparse.ArgumentParser:
     add_json_args(chat)
     chat.set_defaults(handler=handle_chat)
 
-    steps = subparsers.add_parser("steps", help="List conversation execution steps.")
-    steps.add_argument("agent_id", type=int)
-    steps.add_argument("conversation_id", type=int)
+    steps = subparsers.add_parser(
+        "steps",
+        help="List conversation execution steps or get full step detail.",
+        description=(
+            "List conversation execution steps or get full step detail. "
+            "Forms: steps <agent_id> <conversation_id>; "
+            "steps get <agent_id> <conversation_id> <step_id>."
+        ),
+    )
+    steps.add_argument("steps_args", nargs="+", metavar="ARGS")
     steps.set_defaults(handler=handle_steps)
 
     agents = subparsers.add_parser("agents", help="Agent endpoints.")
@@ -929,7 +1041,7 @@ def build_parser() -> argparse.ArgumentParser:
     tool_create.add_argument("agent_id", type=int)
     tool_create.add_argument("--name", required=True)
     tool_create.add_argument("--description")
-    tool_create.add_argument("--tool-type", required=True, choices=["search", "doc_query", "notebook", "tool_response_fetch", "python_code"])
+    tool_create.add_argument("--tool-type", required=True, choices=["search", "doc_query", "doc_grep", "notebook", "tool_response_fetch", "python_code"])
     add_json_args(tool_create)
     for name in ("get", "delete"):
         tool_item = tool_sub.add_parser(name)
@@ -987,6 +1099,30 @@ def parse_bool(value: str) -> bool:
     raise argparse.ArgumentTypeError("Expected boolean: true/false")
 
 
+def parse_steps_args(values: list[str]) -> tuple[str, tuple[int, ...]]:
+    action = "list"
+    raw_values = values
+    if values[0] in {"list", "get", "detail"}:
+        action = "get" if values[0] == "detail" else values[0]
+        raw_values = values[1:]
+    elif len(values) == 3:
+        action = "get"
+
+    expected = 3 if action == "get" else 2
+    if len(raw_values) != expected:
+        raise CliError(
+            "Usage: steps <agent_id> <conversation_id> or "
+            "steps get <agent_id> <conversation_id> <step_id>."
+        )
+
+    try:
+        parsed = tuple(int(value) for value in raw_values)
+    except ValueError as exc:
+        raise CliError("steps arguments must be integers.") from exc
+
+    return action, parsed
+
+
 def main(argv: list[str] | None = None) -> int:
     parser = build_parser()
     args = parser.parse_args(argv)

{deepflow_openagent_cli-0.1.0 → deepflow_openagent_cli-0.1.3}/src/deepflow_openagent_cli.egg-info/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: deepflow-openagent-cli
-Version: 0.1.0
-Summary: Command-line client for NewAgent OpenAPI (agents, conversations, SSE chat, tools, channels, knowledge bases).
+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/newagent
+Project-URL: Repository, https://github.com/DeepFlowAI/OpenAgent
 Keywords: deepflow,openagent,newagent,openapi,cli,sse,chat
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -16,11 +16,12 @@ 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 NewAgent OpenAPI: agents, conversations, SSE chat, tools, channels, and knowledge bases.
+Python command-line client for the OpenAgent OpenAPI: agents, conversations, SSE chat, tools, channels, documents, and knowledge bases.
 
 ## Install
 
@@ -31,8 +32,8 @@ pip install deepflow-openagent-cli
 ## Usage
 
 ```bash
-export NEWAGENT_HOST="https://your-api-host"
-export NEWAGENT_API_KEY="sk-..."
+export OPENAGENT_HOST="https://your-api-host"
+export OPENAGENT_API_KEY="sk-..."
 deepflow_openagent_cli docs list
 deepflow_openagent_cli agents list
 ```
@@ -47,15 +48,36 @@ python -m deepflow_openagent_cli docs list
 
 | Method | Variable / flag |
 |--------|------------------|
-| Host | `NEWAGENT_HOST` or `--host` |
-| API key | `NEWAGENT_API_KEY` or `--api-key` |
+| 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 build twine
+pip install -e ".[dev]"
+pytest
 python -m build
 ```
 

{deepflow_openagent_cli-0.1.0 → deepflow_openagent_cli-0.1.3}/src/deepflow_openagent_cli.egg-info/SOURCES.txt

@@ -8,4 +8,5 @@ src/deepflow_openagent_cli.egg-info/SOURCES.txt
 src/deepflow_openagent_cli.egg-info/dependency_links.txt
 src/deepflow_openagent_cli.egg-info/entry_points.txt
 src/deepflow_openagent_cli.egg-info/requires.txt
-src/deepflow_openagent_cli.egg-info/top_level.txt
+src/deepflow_openagent_cli.egg-info/top_level.txt
+tests/test_cli.py

{deepflow_openagent_cli-0.1.0 → deepflow_openagent_cli-0.1.3}/src/deepflow_openagent_cli.egg-info/requires.txt

@@ -1,4 +1,5 @@
 
 [dev]
 build>=1.0
+pytest>=8.0
 twine>=5.0

deepflow_openagent_cli-0.1.3/tests/test_cli.py

@@ -0,0 +1,249 @@
+import json
+from pathlib import Path
+import tomllib
+
+import pytest
+
+from deepflow_openagent_cli import __version__
+from deepflow_openagent_cli.cli import (
+    CliError,
+    ENDPOINTS,
+    OpenApiClient,
+    build_parser,
+    client_from_args,
+    get_endpoint,
+    load_json_payload,
+    main,
+)
+
+
+def test_version_matches_release() -> None:
+    pyproject = Path(__file__).resolve().parents[1] / "pyproject.toml"
+    metadata = tomllib.loads(pyproject.read_text(encoding="utf-8"))
+
+    assert __version__ == metadata["project"]["version"]
+
+
+def test_catalog_has_stable_unique_keys() -> None:
+    keys = [endpoint.key for endpoint in ENDPOINTS]
+
+    assert len(keys) == len(set(keys))
+    assert "knowledge.list" in keys
+    assert "knowledge.documents" in keys
+    assert "documents.query" in keys
+    assert "chat.stream" in keys
+    assert "steps.get" in keys
+    assert "channels.secret_key" in keys
+
+
+def test_get_endpoint_unknown_key_raises_clear_error() -> None:
+    with pytest.raises(CliError, match="Unknown endpoint"):
+        get_endpoint("missing.endpoint")
+
+
+def test_load_json_payload_rejects_non_object() -> None:
+    with pytest.raises(CliError, match="must be an object"):
+        load_json_payload("[1, 2, 3]", None)
+
+
+def test_build_url_formats_path_and_query() -> None:
+    client = OpenApiClient("http://localhost:5001/", "sk-test")
+    endpoint = get_endpoint("knowledge.documents")
+
+    url = client._build_url(
+        endpoint,
+        {"kb_id": 1},
+        {"page": 2, "per_page": 20, "source": None},
+    )
+
+    assert url == "http://localhost:5001/api/v1/knowledge-bases/1/documents?page=2&per_page=20"
+
+
+def test_client_from_args_reads_openagent_env(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setenv("OPENAGENT_HOST", "https://api.example.com")
+    monkeypatch.setenv("OPENAGENT_API_KEY", "sk-openagent")
+    args = build_parser().parse_args(["docs", "list"])
+
+    client = client_from_args(args)
+
+    assert client.host == "https://api.example.com"
+    assert client.api_key == "sk-openagent"
+
+
+def test_client_from_args_reads_legacy_newagent_env(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.delenv("OPENAGENT_HOST", raising=False)
+    monkeypatch.delenv("OPENAGENT_API_KEY", raising=False)
+    monkeypatch.setenv("NEWAGENT_HOST", "https://legacy.example.com")
+    monkeypatch.setenv("NEWAGENT_API_KEY", "sk-legacy")
+    args = build_parser().parse_args(["docs", "list"])
+
+    client = client_from_args(args)
+
+    assert client.host == "https://legacy.example.com"
+    assert client.api_key == "sk-legacy"
+
+
+def test_docs_show_json_outputs_endpoint_detail(capsys: pytest.CaptureFixture[str]) -> None:
+    exit_code = main(["docs", "show", "documents.query", "--json"])
+
+    captured = capsys.readouterr()
+    assert exit_code == 0
+    payload = json.loads(captured.out)
+    assert payload["method"] == "POST"
+    assert payload["scope"] == "chat"
+
+
+def test_query_document_command_posts_body(
+    monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    calls = []
+
+    def fake_request(self, endpoint_key, path_params=None, query=None, body=None, *, stream=False):
+        calls.append((endpoint_key, path_params, query, body, stream))
+        return b'{"ok": true}'
+
+    monkeypatch.setattr(OpenApiClient, "request", fake_request)
+
+    exit_code = main(
+        [
+            "--host",
+            "http://localhost:5001",
+            "--api-key",
+            "sk-test",
+            "knowledge",
+            "query-document",
+            "6670",
+            "--slice-id",
+            "512208",
+            "--line",
+            "1720",
+        ]
+    )
+
+    captured = capsys.readouterr()
+    assert exit_code == 0
+    assert json.loads(captured.out) == {"ok": True}
+    assert calls == [
+        (
+            "documents.query",
+            None,
+            None,
+            {"doc_id": 6670, "slice_id": 512208, "line": 1720},
+            False,
+        )
+    ]
+
+
+def test_steps_list_keeps_legacy_short_form(
+    monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    calls = []
+
+    def fake_request(self, endpoint_key, path_params=None, query=None, body=None, *, stream=False):
+        calls.append((endpoint_key, path_params, query, body, stream))
+        return b'{"ok": true}'
+
+    monkeypatch.setattr(OpenApiClient, "request", fake_request)
+
+    exit_code = main(
+        [
+            "--host",
+            "http://localhost:5001",
+            "--api-key",
+            "sk-test",
+            "steps",
+            "1",
+            "42",
+        ]
+    )
+
+    captured = capsys.readouterr()
+    assert exit_code == 0
+    assert json.loads(captured.out) == {"ok": True}
+    assert calls == [
+        (
+            "steps.list",
+            {"agent_id": 1, "conversation_id": 42},
+            None,
+            None,
+            False,
+        )
+    ]
+
+
+def test_steps_get_fetches_full_step_detail(
+    monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    calls = []
+
+    def fake_request(self, endpoint_key, path_params=None, query=None, body=None, *, stream=False):
+        calls.append((endpoint_key, path_params, query, body, stream))
+        return b'{"ok": true}'
+
+    monkeypatch.setattr(OpenApiClient, "request", fake_request)
+
+    exit_code = main(
+        [
+            "--host",
+            "http://localhost:5001",
+            "--api-key",
+            "sk-test",
+            "steps",
+            "get",
+            "1",
+            "42",
+            "100",
+        ]
+    )
+
+    captured = capsys.readouterr()
+    assert exit_code == 0
+    assert json.loads(captured.out) == {"ok": True}
+    assert calls == [
+        (
+            "steps.get",
+            {"agent_id": 1, "conversation_id": 42, "step_id": 100},
+            None,
+            None,
+            False,
+        )
+    ]
+
+
+def test_tools_create_accepts_doc_grep(
+    monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    calls = []
+
+    def fake_request(self, endpoint_key, path_params=None, query=None, body=None, *, stream=False):
+        calls.append((endpoint_key, path_params, query, body, stream))
+        return b'{"ok": true}'
+
+    monkeypatch.setattr(OpenApiClient, "request", fake_request)
+
+    exit_code = main(
+        [
+            "--host",
+            "http://localhost:5001",
+            "--api-key",
+            "sk-test",
+            "tools",
+            "create",
+            "1",
+            "--name",
+            "Doc Grep",
+            "--tool-type",
+            "doc_grep",
+        ]
+    )
+
+    captured = capsys.readouterr()
+    assert exit_code == 0
+    assert json.loads(captured.out) == {"ok": True}
+    assert calls[0][0] == "tools.create"
+    assert calls[0][1] == {"agent_id": 1}
+    assert calls[0][3]["tool_type"] == "doc_grep"

deepflow_openagent_cli-0.1.0/README.md

@@ -1,48 +0,0 @@
-# deepflow-openagent-cli
-
-Python command-line client for the NewAgent OpenAPI: agents, conversations, SSE chat, tools, channels, and knowledge bases.
-
-## Install
-
-```bash
-pip install deepflow-openagent-cli
-```
-
-## Usage
-
-```bash
-export NEWAGENT_HOST="https://your-api-host"
-export NEWAGENT_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 | `NEWAGENT_HOST` or `--host` |
-| API key | `NEWAGENT_API_KEY` or `--api-key` |
-
-## Development (build wheel/sdist locally)
-
-From this directory:
-
-```bash
-pip install build twine
-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.