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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepflow-openagent-cli
-Version: 0.1.3
+Version: 0.1.4
 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
@@ -69,6 +69,12 @@ deepflow_openagent_cli knowledge query-document 6670 --slice-id 512208 --line 17
 deepflow_openagent_cli chat 1 --message "Hello"
 deepflow_openagent_cli steps 1 42
 deepflow_openagent_cli steps get 1 42 100
+deepflow_openagent_cli steps feedback 1 42 100 --rating like --comment "Helpful answer"
+
+# Python code tool (create → update config → debug execute)
+deepflow_openagent_cli tools create 1 --name order_query --tool-type python_code
+deepflow_openagent_cli tools update 1 2 --json '{"config":{"code":"import openagent\nopenagent.set_output(openagent.args)","parameters_json":"{\"type\":\"object\",\"properties\":{\"order_id\":{\"type\":\"string\"}},\"required\":[\"order_id\"]}"}}'
+deepflow_openagent_cli tools execute 1 2 --json '{"brief":"查订单","order_id":"A1"}'
 ```
 
 ## Development (build wheel/sdist locally)

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

@@ -48,6 +48,12 @@ deepflow_openagent_cli knowledge query-document 6670 --slice-id 512208 --line 17
 deepflow_openagent_cli chat 1 --message "Hello"
 deepflow_openagent_cli steps 1 42
 deepflow_openagent_cli steps get 1 42 100
+deepflow_openagent_cli steps feedback 1 42 100 --rating like --comment "Helpful answer"
+
+# Python code tool (create → update config → debug execute)
+deepflow_openagent_cli tools create 1 --name order_query --tool-type python_code
+deepflow_openagent_cli tools update 1 2 --json '{"config":{"code":"import openagent\nopenagent.set_output(openagent.args)","parameters_json":"{\"type\":\"object\",\"properties\":{\"order_id\":{\"type\":\"string\"}},\"required\":[\"order_id\"]}"}}'
+deepflow_openagent_cli tools execute 1 2 --json '{"brief":"查订单","order_id":"A1"}'
 ```
 
 ## Development (build wheel/sdist locally)

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepflow-openagent-cli"
-version = "0.1.3"
+version = "0.1.4"
 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.3 → deepflow_openagent_cli-0.1.4}/src/deepflow_openagent_cli/__init__.py

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

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

@@ -256,6 +256,25 @@ ENDPOINTS: tuple[EndpointDoc, ...] = (
         errors=["401 missing or invalid API key", "404 step not found"],
         example="deepflow_openagent_cli steps get 1 42 100",
     ),
+    EndpointDoc(
+        key="steps.feedback",
+        method="POST",
+        path="/api/v1/agents/{agent_id}/conversations/{conversation_id}/steps/{step_id}/feedback",
+        scope="chat",
+        summary="Submit or overwrite like/dislike feedback for one completed assistant_message step.",
+        path_params=[
+            _param("agent_id", "integer", True, "Agent ID."),
+            _param("conversation_id", "integer", True, "Conversation ID."),
+            _param("step_id", "integer", True, "Assistant message Step ID."),
+        ],
+        body_fields=[
+            _param("rating", "string", True, "Feedback rating: like or dislike."),
+            _param("comment", "string", False, "Optional feedback comment, max 500 characters."),
+        ],
+        response="StepFeedbackResponse with step_id, feedback_rating, feedback_comment, and feedback_updated_at.",
+        errors=["400 invalid step state", "401 missing or invalid API key", "403 scope missing", "404 step not found", "422 validation error"],
+        example="deepflow_openagent_cli steps feedback 1 42 100 --rating like --comment 'Helpful answer'",
+    ),
     EndpointDoc(
         key="agents.list",
         method="GET",
@@ -360,14 +379,24 @@ ENDPOINTS: tuple[EndpointDoc, ...] = (
         summary="Create a custom tool for an agent.",
         path_params=[_param("agent_id", "integer", True, "Agent ID.")],
         body_fields=[
-            _param("name", "string", True, "Tool name, 1-128 chars."),
+            _param("name", "string", True, "Tool name, 1-128 chars, pattern ^[a-zA-Z0-9_-]+$."),
             _param("description", "string", False, "Tool description."),
             _param("tool_type", "string", True, "search, doc_query, doc_grep, notebook, tool_response_fetch, or python_code."),
-            _param("config", "object", False, "Tool config."),
+            _param(
+                "config",
+                "object",
+                False,
+                "Tool config. python_code uses code (Python source) and parameters_json (JSON Schema text string).",
+            ),
         ],
         response="AgentToolResponse.",
-        errors=["401 missing or invalid API key", "403 scope missing", "404 agent not found", "422 validation error"],
-        example="deepflow_openagent_cli tools create 1 --name Search --tool-type search --json '{\"config\":{\"kb_ids\":[1]}}'",
+        errors=["401 missing or invalid API key", "403 scope missing", "404 agent not found", "400/422 validation error"],
+        example=(
+            "deepflow_openagent_cli tools create 1 --name order_query --tool-type python_code "
+            "--json '{\"config\":{\"code\":\"import openagent\\nopenagent.set_output(openagent.args)\","
+            "\"parameters_json\":\"{\\\"type\\\":\\\"object\\\",\\\"properties\\\":{\\\"order_id\\\":{\\\"type\\\":\\\"string\\\"}},"
+            "\\\"required\\\":[\\\"order_id\\\"]}\"}}'"
+        ),
     ),
     EndpointDoc(
         key="tools.get",
@@ -394,13 +423,22 @@ ENDPOINTS: tuple[EndpointDoc, ...] = (
             _param("tool_id", "integer", True, "Tool ID."),
         ],
         body_fields=[
-            _param("name", "string", False, "Tool name."),
+            _param("name", "string", False, "Tool name, pattern ^[a-zA-Z0-9_-]+$."),
             _param("description", "string", False, "Tool description."),
-            _param("config", "object", False, "Tool config."),
+            _param(
+                "config",
+                "object",
+                False,
+                "Tool config. python_code: {code, parameters_json}; search/doc_*: {kb_ids}; human_handoff: {service_hours_id, route_fields}.",
+            ),
         ],
         response="AgentToolResponse.",
-        errors=["401 missing or invalid API key", "403 scope missing", "404 tool not found", "422 validation error"],
-        example="deepflow_openagent_cli tools update 1 2 --json '{\"config\":{\"kb_ids\":[1,2]}}'",
+        errors=["401 missing or invalid API key", "403 scope missing", "404 tool not found", "400/422 validation error"],
+        example=(
+            "deepflow_openagent_cli tools update 1 2 --json "
+            "'{\"config\":{\"code\":\"import openagent\\nopenagent.set_output(\\\"ok\\\")\","
+            "\"parameters_json\":\"{\\\"type\\\":\\\"object\\\",\\\"properties\\\":{}}\"}}'"
+        ),
     ),
     EndpointDoc(
         key="tools.toggle",
@@ -442,10 +480,12 @@ ENDPOINTS: tuple[EndpointDoc, ...] = (
             _param("tool_id", "integer", True, "Tool ID."),
         ],
         query_params=[_param("conversation_id", "integer", False, "Conversation ID for tool context.")],
-        body_fields=[_param("*", "object", False, "Tool-specific arguments.")],
-        response="ToolExecuteResponse.",
+        body_fields=[
+            _param("*", "object", False, "Tool-specific arguments. python_code example: brief + business params from parameters_json."),
+        ],
+        response="ToolExecuteResponse with tool_name, tool_type, arguments, result, duration_ms.",
         errors=["401 missing or invalid API key", "403 scope missing", "404 tool not found", "422 validation error"],
-        example="deepflow_openagent_cli tools execute 1 2 --json '{\"query\":\"pricing\"}'",
+        example="deepflow_openagent_cli tools execute 1 2 --json '{\"brief\":\"查订单\",\"order_id\":\"A1\"}'",
     ),
     EndpointDoc(
         key="channels.list",
@@ -812,6 +852,21 @@ def handle_steps(args: argparse.Namespace) -> int:
                 "step_id": step_id,
             },
         )
+    if action == "feedback":
+        agent_id, conversation_id, step_id = values
+        body = merge_payload(args, {"rating": args.rating, "comment": args.comment})
+        if "rating" not in body:
+            raise CliError("Missing feedback rating. Pass --rating like|dislike or include rating in --json.")
+        return run_request(
+            args,
+            "steps.feedback",
+            {
+                "agent_id": agent_id,
+                "conversation_id": conversation_id,
+                "step_id": step_id,
+            },
+            body=body,
+        )
 
     agent_id, conversation_id = values
     return run_request(
@@ -998,14 +1053,18 @@ def build_parser() -> argparse.ArgumentParser:
 
     steps = subparsers.add_parser(
         "steps",
-        help="List conversation execution steps or get full step detail.",
+        help="List, inspect, or submit feedback for conversation execution steps.",
         description=(
-            "List conversation execution steps or get full step detail. "
+            "List conversation execution steps, get full step detail, or submit feedback. "
             "Forms: steps <agent_id> <conversation_id>; "
-            "steps get <agent_id> <conversation_id> <step_id>."
+            "steps get <agent_id> <conversation_id> <step_id>; "
+            "steps feedback <agent_id> <conversation_id> <step_id> --rating like."
         ),
     )
     steps.add_argument("steps_args", nargs="+", metavar="ARGS")
+    steps.add_argument("--rating", choices=["like", "dislike"])
+    steps.add_argument("--comment")
+    add_json_args(steps)
     steps.set_defaults(handler=handle_steps)
 
     agents = subparsers.add_parser("agents", help="Agent endpoints.")
@@ -1102,17 +1161,18 @@ def parse_bool(value: str) -> bool:
 def parse_steps_args(values: list[str]) -> tuple[str, tuple[int, ...]]:
     action = "list"
     raw_values = values
-    if values[0] in {"list", "get", "detail"}:
+    if values[0] in {"list", "get", "detail", "feedback"}:
         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
+    expected = 3 if action in {"get", "feedback"} else 2
     if len(raw_values) != expected:
         raise CliError(
             "Usage: steps <agent_id> <conversation_id> or "
-            "steps get <agent_id> <conversation_id> <step_id>."
+            "steps get <agent_id> <conversation_id> <step_id> or "
+            "steps feedback <agent_id> <conversation_id> <step_id> --rating like|dislike."
         )
 
     try:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepflow-openagent-cli
-Version: 0.1.3
+Version: 0.1.4
 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
@@ -69,6 +69,12 @@ deepflow_openagent_cli knowledge query-document 6670 --slice-id 512208 --line 17
 deepflow_openagent_cli chat 1 --message "Hello"
 deepflow_openagent_cli steps 1 42
 deepflow_openagent_cli steps get 1 42 100
+deepflow_openagent_cli steps feedback 1 42 100 --rating like --comment "Helpful answer"
+
+# Python code tool (create → update config → debug execute)
+deepflow_openagent_cli tools create 1 --name order_query --tool-type python_code
+deepflow_openagent_cli tools update 1 2 --json '{"config":{"code":"import openagent\nopenagent.set_output(openagent.args)","parameters_json":"{\"type\":\"object\",\"properties\":{\"order_id\":{\"type\":\"string\"}},\"required\":[\"order_id\"]}"}}'
+deepflow_openagent_cli tools execute 1 2 --json '{"brief":"查订单","order_id":"A1"}'
 ```
 
 ## Development (build wheel/sdist locally)

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

@@ -247,3 +247,108 @@ def test_tools_create_accepts_doc_grep(
     assert calls[0][0] == "tools.create"
     assert calls[0][1] == {"agent_id": 1}
     assert calls[0][3]["tool_type"] == "doc_grep"
+
+
+def test_tools_create_accepts_python_code(
+    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)
+
+    config = {
+        "code": "import openagent\nopenagent.set_output(openagent.args)",
+        "parameters_json": '{"type":"object","properties":{"order_id":{"type":"string"}},"required":["order_id"]}',
+    }
+    exit_code = main(
+        [
+            "--host",
+            "http://localhost:5001",
+            "--api-key",
+            "sk-test",
+            "tools",
+            "create",
+            "1",
+            "--name",
+            "order_query",
+            "--tool-type",
+            "python_code",
+            "--json",
+            json.dumps({"config": config}),
+        ]
+    )
+
+    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"] == "python_code"
+    assert calls[0][3]["name"] == "order_query"
+    assert calls[0][3]["config"] == config
+
+
+def test_tools_update_and_execute_python_code(
+    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)
+
+    update_body = {
+        "config": {
+            "code": "import openagent\nopenagent.set_output('ok')",
+            "parameters_json": '{"type":"object","properties":{}}',
+        }
+    }
+    exit_code = main(
+        [
+            "--host",
+            "http://localhost:5001",
+            "--api-key",
+            "sk-test",
+            "tools",
+            "update",
+            "1",
+            "2",
+            "--json",
+            json.dumps(update_body),
+        ]
+    )
+    captured = capsys.readouterr()
+    assert exit_code == 0
+    assert json.loads(captured.out) == {"ok": True}
+    assert calls[0][0] == "tools.update"
+    assert calls[0][1] == {"agent_id": 1, "tool_id": 2}
+    assert calls[0][3] == update_body
+
+    exit_code = main(
+        [
+            "--host",
+            "http://localhost:5001",
+            "--api-key",
+            "sk-test",
+            "tools",
+            "execute",
+            "1",
+            "2",
+            "--json",
+            '{"brief":"查订单","order_id":"A1"}',
+        ]
+    )
+    captured = capsys.readouterr()
+    assert exit_code == 0
+    assert json.loads(captured.out) == {"ok": True}
+    assert calls[1][0] == "tools.execute"
+    assert calls[1][1] == {"agent_id": 1, "tool_id": 2}
+    assert calls[1][3] == {"brief": "查订单", "order_id": "A1"}