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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepflow-openagent-cli
-Version: 0.1.1
+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
@@ -67,6 +67,8 @@ 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)

{deepflow_openagent_cli-0.1.1 → deepflow_openagent_cli-0.1.3}/README.md

@@ -46,6 +46,8 @@ 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)

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepflow-openagent-cli"
-version = "0.1.1"
+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"

{deepflow_openagent_cli-0.1.1 → 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.1"
+__version__ = "0.1.3"

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

@@ -241,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",
@@ -316,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."),
@@ -785,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},
     )
 
 
@@ -967,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.")
@@ -1063,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.1 → deepflow_openagent_cli-0.1.3}/src/deepflow_openagent_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepflow-openagent-cli
-Version: 0.1.1
+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
@@ -67,6 +67,8 @@ 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)

{deepflow_openagent_cli-0.1.1 → deepflow_openagent_cli-0.1.3}/tests/test_cli.py

@@ -1,4 +1,6 @@
 import json
+from pathlib import Path
+import tomllib
 
 import pytest
 
@@ -16,7 +18,10 @@ from deepflow_openagent_cli.cli import (
 
 
 def test_version_matches_release() -> None:
-    assert __version__ == "0.1.1"
+    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:
@@ -27,6 +32,7 @@ def test_catalog_has_stable_unique_keys() -> None:
     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
 
 
@@ -129,6 +135,84 @@ def test_query_document_command_posts_body(
     ]
 
 
+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],