deepflow-voicespeed-cli 0.1.2__tar.gz → 0.1.3__tar.gz

{deepflow_voicespeed_cli-0.1.2 → deepflow_voicespeed_cli-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepflow-voicespeed-cli
-Version: 0.1.2
+Version: 0.1.3
 Summary: Command line client for VoiceSpeed OpenAPI
 Home-page: https://github.com/DeepFlowAI/voicespeed
 License: Proprietary
@@ -36,6 +36,9 @@ voicespeed agents update 1 --name "Support Pro"
 voicespeed agents disable 1
 voicespeed agents enable 1
 voicespeed agents basic-settings 1
+voicespeed agents update-basic-settings 1 --prompt "You are a support assistant."
+voicespeed agents update-basic-settings 1 --prompt-file prompt.txt \
+  --opening-mode fixed_greeting --greeting "Hello, how can I help?"
 voicespeed conversation run 1 --message "Hello" --mode text2text \
   --variables '{"customer_name":"Ada"}'
 voicespeed calls preset-variables 1 call_42 \
@@ -44,6 +47,8 @@ voicespeed realtime-sessions create 1 --external-id call_42 \
   --variables '{"customer_name":"Ada"}'
 ```
 
+`agents update-basic-settings` changes only the fields passed on the command line. Use `--prompt-file`, `--runtime-context-file`, or `--greeting-file` for long text.
+
 `--variables` is a JSON object of text values. It is optional on `conversation run` and `realtime-sessions create`. `calls preset-variables` stores values for a FlowKit call before it starts; the call id is the same value later sent as `session_id`.
 
 All successful commands print formatted JSON.

{deepflow_voicespeed_cli-0.1.2 → deepflow_voicespeed_cli-0.1.3}/README.md

@@ -26,6 +26,9 @@ voicespeed agents update 1 --name "Support Pro"
 voicespeed agents disable 1
 voicespeed agents enable 1
 voicespeed agents basic-settings 1
+voicespeed agents update-basic-settings 1 --prompt "You are a support assistant."
+voicespeed agents update-basic-settings 1 --prompt-file prompt.txt \
+  --opening-mode fixed_greeting --greeting "Hello, how can I help?"
 voicespeed conversation run 1 --message "Hello" --mode text2text \
   --variables '{"customer_name":"Ada"}'
 voicespeed calls preset-variables 1 call_42 \
@@ -34,6 +37,8 @@ voicespeed realtime-sessions create 1 --external-id call_42 \
   --variables '{"customer_name":"Ada"}'
 ```
 
+`agents update-basic-settings` changes only the fields passed on the command line. Use `--prompt-file`, `--runtime-context-file`, or `--greeting-file` for long text.
+
 `--variables` is a JSON object of text values. It is optional on `conversation run` and `realtime-sessions create`. `calls preset-variables` stores values for a FlowKit call before it starts; the call id is the same value later sent as `session_id`.
 
 All successful commands print formatted JSON.

{deepflow_voicespeed_cli-0.1.2 → deepflow_voicespeed_cli-0.1.3}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = deepflow-voicespeed-cli
-version = 0.1.2
+version = 0.1.3
 description = Command line client for VoiceSpeed OpenAPI
 long_description = file: README.md
 long_description_content_type = text/markdown

{deepflow_voicespeed_cli-0.1.2 → deepflow_voicespeed_cli-0.1.3}/src/deepflow_voicespeed_cli/__init__.py

@@ -1,3 +1,3 @@
 """VoiceSpeed OpenAPI command line client."""
 
-__version__ = "0.1.2"
+__version__ = "0.1.3"

{deepflow_voicespeed_cli-0.1.2 → deepflow_voicespeed_cli-0.1.3}/src/deepflow_voicespeed_cli/cli.py

@@ -4,6 +4,7 @@ import argparse
 import json
 import os
 import sys
+from pathlib import Path
 from typing import Any, Sequence
 
 from .client import VoiceSpeedApiError, VoiceSpeedClient, VoiceSpeedRequestError
@@ -73,6 +74,44 @@ def _add_agent_commands(subparsers: argparse._SubParsersAction) -> None:
     settings_parser.add_argument("agent_id", type=int)
     settings_parser.set_defaults(handler=_handle_agents_basic_settings)
 
+    update_settings_parser = actions.add_parser(
+        "update-basic-settings",
+        help="Update agent basic engine settings",
+    )
+    update_settings_parser.add_argument("agent_id", type=int)
+    update_settings_parser.add_argument("--prompt")
+    update_settings_parser.add_argument("--prompt-file", help="Read the prompt from a text file")
+    update_settings_parser.add_argument("--runtime-context")
+    update_settings_parser.add_argument(
+        "--runtime-context-file",
+        help="Read the runtime context from a text file",
+    )
+    update_settings_parser.add_argument("--voice-llm")
+    update_settings_parser.add_argument("--text-llm")
+    update_settings_parser.add_argument(
+        "--text-think-mode",
+        action=argparse.BooleanOptionalAction,
+        default=None,
+    )
+    update_settings_parser.add_argument("--temperature", type=float)
+    update_settings_parser.add_argument("--diversity", type=float)
+    update_settings_parser.add_argument("--max-tokens", type=int)
+    update_settings_parser.add_argument("--context-turns", type=int)
+    update_settings_parser.add_argument(
+        "--call-direction",
+        choices=["inbound", "outbound"],
+    )
+    update_settings_parser.add_argument(
+        "--opening-mode",
+        choices=["none", "fixed_greeting", "model"],
+    )
+    update_settings_parser.add_argument("--greeting")
+    update_settings_parser.add_argument(
+        "--greeting-file",
+        help="Read the greeting from a text file",
+    )
+    update_settings_parser.set_defaults(handler=_handle_agents_update_basic_settings)
+
 
 def _add_conversation_commands(subparsers: argparse._SubParsersAction) -> None:
     conversation = subparsers.add_parser("conversation", help="Run OpenAPI chat")
@@ -238,6 +277,54 @@ def _handle_agents_basic_settings(
     return client.get_basic_settings(args.agent_id)
 
 
+def _handle_agents_update_basic_settings(
+    client: VoiceSpeedClient,
+    args: argparse.Namespace,
+) -> Any:
+    settings: dict[str, Any] = {}
+    _set_text_setting(settings, "prompt", args.prompt, args.prompt_file)
+    _set_text_setting(
+        settings,
+        "runtime_context",
+        args.runtime_context,
+        args.runtime_context_file,
+    )
+    _set_text_setting(settings, "greeting", args.greeting, args.greeting_file)
+    for key, value in {
+        "voice_llm": args.voice_llm,
+        "text_llm": args.text_llm,
+        "text_think_mode": args.text_think_mode,
+        "temperature": args.temperature,
+        "diversity": args.diversity,
+        "max_tokens": args.max_tokens,
+        "context_turns": args.context_turns,
+        "call_direction": args.call_direction,
+        "opening_mode": args.opening_mode,
+    }.items():
+        if value is not None:
+            settings[key] = value
+    if not settings:
+        raise CliError("At least one basic-setting field is required.")
+    return client.update_basic_settings(args.agent_id, settings)
+
+
+def _set_text_setting(
+    settings: dict[str, Any],
+    key: str,
+    value: str | None,
+    file_path: str | None,
+) -> None:
+    if value is not None and file_path is not None:
+        raise CliError(f"Use only one of --{key.replace('_', '-')} and --{key.replace('_', '-')}-file.")
+    if file_path is not None:
+        try:
+            value = Path(file_path).read_text(encoding="utf-8")
+        except OSError as exc:
+            raise CliError(f"Cannot read {key} file: {file_path}") from exc
+    if value is not None:
+        settings[key] = value
+
+
 def _handle_conversation_run(
     client: VoiceSpeedClient,
     args: argparse.Namespace,

{deepflow_voicespeed_cli-0.1.2 → deepflow_voicespeed_cli-0.1.3}/src/deepflow_voicespeed_cli/client.py

@@ -112,6 +112,13 @@ class VoiceSpeedClient:
     def get_basic_settings(self, agent_id: int) -> Any:
         return self.request("GET", f"/agents/{agent_id}/basic-settings")
 
+    def update_basic_settings(self, agent_id: int, settings: dict[str, Any]) -> Any:
+        return self.request(
+            "PUT",
+            f"/agents/{agent_id}/basic-settings",
+            payload=settings,
+        )
+
     def run_conversation(
         self,
         agent_id: int,

{deepflow_voicespeed_cli-0.1.2 → deepflow_voicespeed_cli-0.1.3}/src/deepflow_voicespeed_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepflow-voicespeed-cli
-Version: 0.1.2
+Version: 0.1.3
 Summary: Command line client for VoiceSpeed OpenAPI
 Home-page: https://github.com/DeepFlowAI/voicespeed
 License: Proprietary
@@ -36,6 +36,9 @@ voicespeed agents update 1 --name "Support Pro"
 voicespeed agents disable 1
 voicespeed agents enable 1
 voicespeed agents basic-settings 1
+voicespeed agents update-basic-settings 1 --prompt "You are a support assistant."
+voicespeed agents update-basic-settings 1 --prompt-file prompt.txt \
+  --opening-mode fixed_greeting --greeting "Hello, how can I help?"
 voicespeed conversation run 1 --message "Hello" --mode text2text \
   --variables '{"customer_name":"Ada"}'
 voicespeed calls preset-variables 1 call_42 \
@@ -44,6 +47,8 @@ voicespeed realtime-sessions create 1 --external-id call_42 \
   --variables '{"customer_name":"Ada"}'
 ```
 
+`agents update-basic-settings` changes only the fields passed on the command line. Use `--prompt-file`, `--runtime-context-file`, or `--greeting-file` for long text.
+
 `--variables` is a JSON object of text values. It is optional on `conversation run` and `realtime-sessions create`. `calls preset-variables` stores values for a FlowKit call before it starts; the call id is the same value later sent as `session_id`.
 
 All successful commands print formatted JSON.

{deepflow_voicespeed_cli-0.1.2 → deepflow_voicespeed_cli-0.1.3}/tests/test_cli.py

@@ -87,6 +87,85 @@ def test_client_builds_json_request():
     }
 
 
+def test_update_basic_settings_command(tmp_path):
+    prompt_file = tmp_path / "prompt.txt"
+    prompt_file.write_text("You are support.", encoding="utf-8")
+    client = Mock()
+    client.update_basic_settings.return_value = {"agent_id": 3, "configured": True}
+
+    with patch("deepflow_voicespeed_cli.cli.VoiceSpeedClient", return_value=client):
+        code = cli.main(
+            [
+                "--api-key",
+                "vsk_test",
+                "agents",
+                "update-basic-settings",
+                "3",
+                "--prompt-file",
+                str(prompt_file),
+                "--text-llm",
+                "text-model",
+                "--no-text-think-mode",
+                "--temperature",
+                "0.5",
+                "--opening-mode",
+                "fixed_greeting",
+                "--greeting",
+                "Hello.",
+            ]
+        )
+
+    assert code == 0
+    client.update_basic_settings.assert_called_once_with(
+        3,
+        {
+            "prompt": "You are support.",
+            "greeting": "Hello.",
+            "text_llm": "text-model",
+            "text_think_mode": False,
+            "temperature": 0.5,
+            "opening_mode": "fixed_greeting",
+        },
+    )
+
+
+def test_update_basic_settings_requires_a_field(capsys):
+    code = cli.main(
+        ["--api-key", "vsk_test", "agents", "update-basic-settings", "1"]
+    )
+
+    assert code == 1
+    assert "At least one basic-setting field" in capsys.readouterr().err
+
+
+def test_client_update_basic_settings_uses_put():
+    captured = {}
+
+    class FakeResponse:
+        def __enter__(self):
+            return self
+
+        def __exit__(self, _exc_type, _exc, _tb):
+            return None
+
+        def read(self):
+            return b'{"agent_id": 3, "configured": true}'
+
+    def fake_urlopen(req, timeout):
+        captured["req"] = req
+        return FakeResponse()
+
+    with patch("deepflow_voicespeed_cli.client.urlopen", fake_urlopen):
+        client = VoiceSpeedClient("http://example.com/", "vsk_test")
+        result = client.update_basic_settings(3, {"prompt": "You are support."})
+
+    req = captured["req"]
+    assert result["agent_id"] == 3
+    assert req.get_method() == "PUT"
+    assert req.full_url == "http://example.com/api/v1/openapi/agents/3/basic-settings"
+    assert json.loads(req.data.decode("utf-8")) == {"prompt": "You are support."}
+
+
 def test_conversation_run_command():
     client = Mock()
     client.run_conversation.return_value = {"reply": "hi"}