deepflow-voicespeed-cli 0.1.0__py3-none-any.whl

deepflow_voicespeed_cli/__init__.py

@@ -0,0 +1,3 @@
+"""VoiceSpeed OpenAPI command line client."""
+
+__version__ = "0.1.0"

deepflow_voicespeed_cli/cli.py

@@ -0,0 +1,181 @@
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from typing import Any, Sequence
+
+from .client import VoiceSpeedApiError, VoiceSpeedClient, VoiceSpeedRequestError
+
+DEFAULT_BASE_URL = "http://localhost:5002"
+
+
+class CliError(Exception):
+    pass
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="voicespeed")
+    parser.add_argument(
+        "--base-url",
+        default=os.environ.get("VOICESPEED_BASE_URL", DEFAULT_BASE_URL),
+        help="VoiceSpeed server base URL. Defaults to VOICESPEED_BASE_URL or localhost.",
+    )
+    parser.add_argument(
+        "--api-key",
+        default=os.environ.get("VOICESPEED_API_KEY"),
+        help="VoiceSpeed OpenAPI key. Defaults to VOICESPEED_API_KEY.",
+    )
+
+    subparsers = parser.add_subparsers(dest="resource", required=True)
+    _add_agent_commands(subparsers)
+    _add_conversation_commands(subparsers)
+    return parser
+
+
+def _add_agent_commands(subparsers: argparse._SubParsersAction) -> None:
+    agents = subparsers.add_parser("agents", help="Manage OpenAPI agents")
+    actions = agents.add_subparsers(dest="action", required=True)
+
+    list_parser = actions.add_parser("list", help="List agents")
+    list_parser.add_argument("--status", choices=["enabled", "disabled"])
+    list_parser.add_argument("--page", type=int, default=1)
+    list_parser.add_argument("--per-page", type=int, default=20)
+    list_parser.set_defaults(handler=_handle_agents_list)
+
+    create_parser = actions.add_parser("create", help="Create an agent")
+    create_parser.add_argument("--name", required=True)
+    create_parser.add_argument("--description")
+    create_parser.set_defaults(handler=_handle_agents_create)
+
+    update_parser = actions.add_parser("update", help="Update an agent")
+    update_parser.add_argument("agent_id", type=int)
+    update_parser.add_argument("--name")
+    update_parser.add_argument("--description")
+    update_parser.set_defaults(handler=_handle_agents_update)
+
+    disable_parser = actions.add_parser("disable", help="Disable an agent")
+    disable_parser.add_argument("agent_id", type=int)
+    disable_parser.set_defaults(handler=_handle_agents_disable)
+
+    enable_parser = actions.add_parser("enable", help="Enable an agent")
+    enable_parser.add_argument("agent_id", type=int)
+    enable_parser.set_defaults(handler=_handle_agents_enable)
+
+    settings_parser = actions.add_parser(
+        "basic-settings",
+        help="Get agent basic engine settings",
+    )
+    settings_parser.add_argument("agent_id", type=int)
+    settings_parser.set_defaults(handler=_handle_agents_basic_settings)
+
+
+def _add_conversation_commands(subparsers: argparse._SubParsersAction) -> None:
+    conversation = subparsers.add_parser("conversation", help="Run OpenAPI chat")
+    actions = conversation.add_subparsers(dest="action", required=True)
+
+    run_parser = actions.add_parser("run", help="Run one conversation turn")
+    run_parser.add_argument("agent_id", type=int)
+    run_parser.add_argument("--message", required=True)
+    run_parser.add_argument("--mode", choices=["text2text", "text2voice"], default="text2text")
+    run_parser.set_defaults(handler=_handle_conversation_run)
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    try:
+        client = _build_client(args)
+        result = args.handler(client, args)
+        _print_json(result)
+        return 0
+    except CliError as exc:
+        print(str(exc), file=sys.stderr)
+        return 1
+    except VoiceSpeedApiError as exc:
+        print(f"HTTP {exc.status_code}: {exc.body}", file=sys.stderr)
+        return 1
+    except VoiceSpeedRequestError as exc:
+        print(f"Request failed: {exc}", file=sys.stderr)
+        return 1
+
+
+def _build_client(args: argparse.Namespace) -> VoiceSpeedClient:
+    if not args.api_key:
+        raise CliError("Missing API key. Use --api-key or VOICESPEED_API_KEY.")
+    return VoiceSpeedClient(base_url=args.base_url, api_key=args.api_key)
+
+
+def _print_json(value: Any) -> None:
+    if value is None:
+        return
+    print(json.dumps(value, ensure_ascii=False, indent=2))
+
+
+def _handle_agents_list(
+    client: VoiceSpeedClient,
+    args: argparse.Namespace,
+) -> Any:
+    return client.list_agents(
+        status=args.status,
+        page=args.page,
+        per_page=args.per_page,
+    )
+
+
+def _handle_agents_create(
+    client: VoiceSpeedClient,
+    args: argparse.Namespace,
+) -> Any:
+    return client.create_agent(name=args.name, description=args.description)
+
+
+def _handle_agents_update(
+    client: VoiceSpeedClient,
+    args: argparse.Namespace,
+) -> Any:
+    if args.name is None and args.description is None:
+        raise CliError("At least one of --name or --description is required.")
+    return client.update_agent(
+        args.agent_id,
+        name=args.name,
+        description=args.description,
+    )
+
+
+def _handle_agents_disable(
+    client: VoiceSpeedClient,
+    args: argparse.Namespace,
+) -> Any:
+    return client.set_agent_enabled(args.agent_id, enabled=False)
+
+
+def _handle_agents_enable(
+    client: VoiceSpeedClient,
+    args: argparse.Namespace,
+) -> Any:
+    return client.set_agent_enabled(args.agent_id, enabled=True)
+
+
+def _handle_agents_basic_settings(
+    client: VoiceSpeedClient,
+    args: argparse.Namespace,
+) -> Any:
+    return client.get_basic_settings(args.agent_id)
+
+
+def _handle_conversation_run(
+    client: VoiceSpeedClient,
+    args: argparse.Namespace,
+) -> Any:
+    return client.run_conversation(
+        args.agent_id,
+        message=args.message,
+        mode=args.mode,
+    )
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

deepflow_voicespeed_cli/client.py

@@ -0,0 +1,142 @@
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass
+from typing import Any
+from urllib.error import HTTPError, URLError
+from urllib.parse import urlencode
+from urllib.request import Request, urlopen
+
+
+class VoiceSpeedClientError(Exception):
+    """Base error raised by the VoiceSpeed client."""
+
+
+class VoiceSpeedApiError(VoiceSpeedClientError):
+    def __init__(self, status_code: int, body: str) -> None:
+        self.status_code = status_code
+        self.body = body
+        super().__init__(f"HTTP {status_code}: {body}")
+
+
+class VoiceSpeedRequestError(VoiceSpeedClientError):
+    pass
+
+
+@dataclass
+class VoiceSpeedClient:
+    base_url: str
+    api_key: str
+    timeout: float = 30.0
+
+    def __post_init__(self) -> None:
+        self.base_url = self.base_url.rstrip("/")
+        self.api_key = self.api_key.strip()
+        if not self.api_key:
+            raise ValueError("Missing API key")
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        *,
+        query: dict[str, Any] | None = None,
+        payload: dict[str, Any] | None = None,
+    ) -> Any:
+        url = f"{self.base_url}/api/v1/openapi{path}"
+        clean_query = {
+            key: value for key, value in (query or {}).items() if value is not None
+        }
+        if clean_query:
+            url = f"{url}?{urlencode(clean_query)}"
+
+        body = None
+        headers = {
+            "Accept": "application/json",
+            "Authorization": f"Bearer {self.api_key}",
+        }
+        if payload is not None:
+            body = json.dumps(payload).encode("utf-8")
+            headers["Content-Type"] = "application/json"
+
+        req = Request(url, data=body, headers=headers, method=method.upper())
+        try:
+            with urlopen(req, timeout=self.timeout) as resp:
+                return self._parse_response(resp.read())
+        except HTTPError as exc:
+            raise VoiceSpeedApiError(exc.code, self._read_error_body(exc)) from exc
+        except URLError as exc:
+            raise VoiceSpeedRequestError(str(exc.reason)) from exc
+        except OSError as exc:
+            raise VoiceSpeedRequestError(str(exc)) from exc
+
+    def list_agents(
+        self,
+        *,
+        status: str | None = None,
+        page: int = 1,
+        per_page: int = 20,
+    ) -> Any:
+        return self.request(
+            "GET",
+            "/agents",
+            query={"status": status, "page": page, "per_page": per_page},
+        )
+
+    def create_agent(self, *, name: str, description: str | None = None) -> Any:
+        return self.request(
+            "POST",
+            "/agents",
+            payload={"name": name, "description": description},
+        )
+
+    def update_agent(
+        self,
+        agent_id: int,
+        *,
+        name: str | None = None,
+        description: str | None = None,
+    ) -> Any:
+        payload = {
+            key: value
+            for key, value in {"name": name, "description": description}.items()
+            if value is not None
+        }
+        return self.request("PATCH", f"/agents/{agent_id}", payload=payload)
+
+    def set_agent_enabled(self, agent_id: int, *, enabled: bool) -> Any:
+        action = "enable" if enabled else "disable"
+        return self.request("POST", f"/agents/{agent_id}/{action}")
+
+    def get_basic_settings(self, agent_id: int) -> Any:
+        return self.request("GET", f"/agents/{agent_id}/basic-settings")
+
+    def run_conversation(
+        self,
+        agent_id: int,
+        *,
+        message: str,
+        mode: str = "text2text",
+    ) -> Any:
+        return self.request(
+            "POST",
+            f"/agents/{agent_id}/conversation",
+            payload={"message": message, "mode": mode},
+        )
+
+    @staticmethod
+    def _parse_response(data: bytes) -> Any:
+        if not data:
+            return None
+        text = data.decode("utf-8")
+        try:
+            return json.loads(text)
+        except json.JSONDecodeError:
+            return text
+
+    @staticmethod
+    def _read_error_body(exc: HTTPError) -> str:
+        body = exc.read()
+        if not body:
+            return exc.reason
+        return body.decode("utf-8", errors="replace")

deepflow_voicespeed_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: deepflow-voicespeed-cli
+Version: 0.1.0
+Summary: Command line client for VoiceSpeed OpenAPI
+Home-page: https://github.com/DeepFlowAI/voicespeed
+License: Proprietary
+Keywords: voicespeed,deepflow,cli,openapi
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# deepflow-voicespeed-cli
+
+Command line client for VoiceSpeed OpenAPI.
+
+## Install
+
+```bash
+pip install deepflow-voicespeed-cli
+```
+
+## Configure
+
+```bash
+export VOICESPEED_BASE_URL=http://localhost:5002
+export VOICESPEED_API_KEY=YOUR_API_KEY
+```
+
+Both values can also be passed with `--base-url` and `--api-key`.
+
+## Usage
+
+```bash
+voicespeed agents list --status enabled
+voicespeed agents create --name "Support" --description "Demo agent"
+voicespeed agents update 1 --name "Support Pro"
+voicespeed agents disable 1
+voicespeed agents enable 1
+voicespeed agents basic-settings 1
+voicespeed conversation run 1 --message "Hello" --mode text2text
+```
+
+All successful commands print formatted JSON.

deepflow_voicespeed_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+deepflow_voicespeed_cli/__init__.py,sha256=FTA-PNbav1HDBMe-WNKrW53T1L5FK_jQ_XXcYHfZhco,69
+deepflow_voicespeed_cli/cli.py,sha256=K3Kiy6Qecr7svbVBLMTNXqMHH3pOHHfTjtXQUIwv-wU,5698
+deepflow_voicespeed_cli/client.py,sha256=03UFuwQa6mAsZjIH_w0NZp21XSzA6_2xnQqAm2anikA,4191
+deepflow_voicespeed_cli-0.1.0.dist-info/METADATA,sha256=1T_z-WEpT_C67VNsJKwJxawifwJ9xBz1fNHx52144S4,995
+deepflow_voicespeed_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+deepflow_voicespeed_cli-0.1.0.dist-info/entry_points.txt,sha256=865sc9SU_pNJhazfQNnO_Ch5xD7ZZVRCP7vLJQEmi-k,64
+deepflow_voicespeed_cli-0.1.0.dist-info/top_level.txt,sha256=kUuQDQ_5K-JlkryPqCDbKmBXB1jJ0V6ogRVHVsNDE2c,24
+deepflow_voicespeed_cli-0.1.0.dist-info/RECORD,,

deepflow_voicespeed_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

deepflow_voicespeed_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+voicespeed = deepflow_voicespeed_cli.cli:main

deepflow_voicespeed_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+deepflow_voicespeed_cli