licos-dev-cli 0.2.0__tar.gz → 0.2.1__tar.gz

{licos_dev_cli-0.2.0 → licos_dev_cli-0.2.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: licos-dev-cli
-Version: 0.2.0
+Version: 0.2.1
 Summary: LICOS Dev CLI - generate files and call model capabilities
 Requires-Python: >=3.10
 Requires-Dist: click>=8.1
-Requires-Dist: licos-dev-sdk>=0.2.0
+Requires-Dist: licos-dev-sdk>=0.2.1

{licos_dev_cli-0.2.0 → licos_dev_cli-0.2.1}/pyproject.toml

@@ -1,19 +1,19 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "licos-dev-cli"
-version = "0.2.0"
-description = "LICOS Dev CLI - generate files and call model capabilities"
-requires-python = ">=3.10"
-dependencies = [
-    "licos-dev-sdk>=0.2.0",
-    "click>=8.1",
-]
-
-[project.scripts]
-licos-dev = "licos_dev_cli.main:cli"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/licos_dev_cli"]
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "licos-dev-cli"
+version = "0.2.1"
+description = "LICOS Dev CLI - generate files and call model capabilities"
+requires-python = ">=3.10"
+dependencies = [
+    "licos-dev-sdk>=0.2.1",
+    "click>=8.1",
+]
+
+[project.scripts]
+licos-dev = "licos_dev_cli.main:cli"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/licos_dev_cli"]

{licos_dev_cli-0.2.0 → licos_dev_cli-0.2.1}/src/licos_dev_cli/main.py

@@ -1,522 +1,522 @@
-"""CLI entry point - wraps licos-dev-sdk functions as click commands."""
-
-from __future__ import annotations
-
-import sys
-import json
-import click
-
-# ── Helpers ──────────────────────────────────────────────────────────────────
-
-def _read_input(input_path: str | None, content: str | None) -> str:
-    """Read content from --input file, --content arg, or stdin."""
-    if input_path:
-        with open(input_path, "r", encoding="utf-8") as f:
-            return f.read()
-    if content:
-        return content
-    if not sys.stdin.isatty():
-        return sys.stdin.read()
-    raise click.UsageError("Provide --input, --content, or pipe via stdin.")
-
-
-def _read_json(input_path: str | None, content: str | None) -> object:
-    """Read and parse JSON from input."""
-    raw = _read_input(input_path, content)
-    return json.loads(raw)
-
-
-def _json_option(value: str | None, name: str) -> dict | list | None:
-    if not value:
-        return None
-    try:
-        return json.loads(value)
-    except json.JSONDecodeError as exc:
-        raise click.BadParameter(f"{name} must be valid JSON") from exc
-
-
-def _echo_json(value: object) -> None:
-    if hasattr(value, "to_dict"):
-        value = value.to_dict()
-    click.echo(json.dumps(value, ensure_ascii=False, indent=2))
-
-
-# ── CLI Group ────────────────────────────────────────────────────────────────
-
-@click.group()
-def cli():
-    """LICOS Dev - file generation and model CLI for AI agents."""
-    pass
-
-
-# ── PDF ──────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path", help="Input file (Markdown or HTML)")
-@click.option("-c", "--content", help="Direct content")
-@click.option("-f", "--filename", required=True, help="Output filename (no extension)")
-@click.option("-o", "--output-dir", default=None, help="Output directory")
-@click.option("--format", "content_type", default="markdown", help="Content type: markdown|html")
-@click.option("--page-size", default="A4", help="Page size: A4|LETTER")
-def pdf(input_path, content, filename, output_dir, content_type, page_size):
-    """Generate PDF from Markdown or HTML."""
-    from licos_dev_sdk import create_pdf
-    text = _read_input(input_path, content)
-    path = create_pdf(text, filename, content_type=content_type, output_dir=output_dir, page_size=page_size)
-    click.echo(path)
-
-
-# ── DOCX ─────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--format", "content_type", default="markdown")
-@click.option("--font", default="Arial")
-@click.option("--font-size", default=11, type=int)
-def docx(input_path, content, filename, output_dir, content_type, font, font_size):
-    """Generate DOCX from Markdown or HTML."""
-    from licos_dev_sdk import create_docx
-    text = _read_input(input_path, content)
-    path = create_docx(text, filename, content_type=content_type, output_dir=output_dir, font_name=font, font_size=font_size)
-    click.echo(path)
-
-
-# ── XLSX ─────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON data")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--sheet-name", default="Sheet1")
-@click.option("--header-color", default="4472C4")
-def xlsx(input_path, content, filename, output_dir, sheet_name, header_color):
-    """Generate XLSX from JSON data."""
-    from licos_dev_sdk import create_xlsx
-    data = _read_json(input_path, content)
-    path = create_xlsx(data, filename, output_dir=output_dir, sheet_name=sheet_name, header_color=header_color)
-    click.echo(path)
-
-
-# ── CSV ──────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON data")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-def csv(input_path, content, filename, output_dir):
-    """Generate CSV from JSON data."""
-    from licos_dev_sdk import create_csv
-    data = _read_json(input_path, content)
-    path = create_csv(data, filename, output_dir=output_dir)
-    click.echo(path)
-
-
-# ── PPTX ─────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--format", "content_type", default="markdown")
-def pptx(input_path, content, filename, output_dir, content_type):
-    """Generate PPTX from Markdown."""
-    from licos_dev_sdk import create_pptx
-    text = _read_input(input_path, content)
-    path = create_pptx(text, filename, content_type=content_type, output_dir=output_dir)
-    click.echo(path)
-
-
-# ── Chart ────────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON chart data")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--type", "chart_type", required=True, help="bar|line|pie|scatter|heatmap")
-@click.option("--format", "fmt", default="png", help="png|svg")
-@click.option("--title", default="")
-@click.option("--width", default=800, type=int)
-@click.option("--height", default=600, type=int)
-def chart(input_path, content, filename, output_dir, chart_type, fmt, title, width, height):
-    """Generate chart image from JSON data."""
-    from licos_dev_sdk import create_chart
-    data = _read_json(input_path, content)
-    path = create_chart(chart_type, data, filename, output_dir=output_dir, format=fmt, title=title, width=width, height=height)
-    click.echo(path)
-
-
-# ── Diagram ──────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="DOT source")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--format", "fmt", default="png", help="png|svg|pdf")
-def diagram(input_path, content, filename, output_dir, fmt):
-    """Generate diagram from Graphviz DOT source."""
-    from licos_dev_sdk import create_diagram
-    text = _read_input(input_path, content)
-    path = create_diagram(text, filename, output_dir=output_dir, format=fmt)
-    click.echo(path)
-
-
-# ── QR Code ──────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-d", "--data", required=True, help="Data to encode")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--size", default=300, type=int)
-def qrcode(data, filename, output_dir, size):
-    """Generate QR code PNG image."""
-    from licos_dev_sdk import create_qrcode
-    path = create_qrcode(data, filename, output_dir=output_dir, size=size)
-    click.echo(path)
-
-
-# ── Barcode ──────────────────────────────────────────────────────────────────
-
-@cli.command()
-@click.option("-d", "--data", required=True, help="Data to encode")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--type", "barcode_type", default="code128", help="code128|ean13|ean8|isbn13|upc")
-def barcode(data, filename, output_dir, barcode_type):
-    """Generate barcode PNG image."""
-    from licos_dev_sdk import create_barcode
-    path = create_barcode(data, filename, output_dir=output_dir, barcode_type=barcode_type)
-    click.echo(path)
-
-
-# ── ZIP ──────────────────────────────────────────────────────────────────────
-
-@cli.command("zip")
-@click.option("-p", "--paths", required=True, help="Comma-separated file/dir paths")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-def zip_cmd(paths, filename, output_dir):
-    """Create ZIP archive."""
-    from licos_dev_sdk import create_zip
-    source_paths = [p.strip() for p in paths.split(",")]
-    path = create_zip(source_paths, filename, output_dir=output_dir)
-    click.echo(path)
-
-
-# ── TAR.GZ ───────────────────────────────────────────────────────────────────
-
-@cli.command("tar")
-@click.option("-p", "--paths", required=True, help="Comma-separated file/dir paths")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-def tar_cmd(paths, filename, output_dir):
-    """Create TAR.GZ archive."""
-    from licos_dev_sdk import create_tar_gz
-    source_paths = [p.strip() for p in paths.split(",")]
-    path = create_tar_gz(source_paths, filename, output_dir=output_dir)
-    click.echo(path)
-
-
-# ── JSON ─────────────────────────────────────────────────────────────────────
-
-@cli.command("json")
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON or YAML content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-def json_cmd(input_path, content, filename, output_dir):
-    """Generate JSON file (accepts JSON or YAML input)."""
-    from licos_dev_sdk import create_json
-    raw = _read_input(input_path, content)
-    try:
-        data = json.loads(raw)
-    except json.JSONDecodeError:
-        import yaml
-        data = yaml.safe_load(raw)
-    path = create_json(data, filename, output_dir=output_dir)
-    click.echo(path)
-
-
-# ── YAML ─────────────────────────────────────────────────────────────────────
-
-@cli.command("yaml")
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON or YAML content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-def yaml_cmd(input_path, content, filename, output_dir):
-    """Generate YAML file (accepts JSON or YAML input)."""
-    from licos_dev_sdk import create_yaml
-    import yaml as yaml_lib
-    raw = _read_input(input_path, content)
-    try:
-        data = json.loads(raw)
-    except json.JSONDecodeError:
-        data = yaml_lib.safe_load(raw)
-    path = create_yaml(data, filename, output_dir=output_dir)
-    click.echo(path)
-
-
-# ── XML ──────────────────────────────────────────────────────────────────────
-
-@cli.command("xml")
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content", help="JSON content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--root-tag", default="root")
-def xml_cmd(input_path, content, filename, output_dir, root_tag):
-    """Generate XML file from JSON data."""
-    from licos_dev_sdk import create_xml
-    data = _read_json(input_path, content)
-    path = create_xml(data, filename, output_dir=output_dir, root_tag=root_tag)
-    click.echo(path)
-
-
-# ── HTML ─────────────────────────────────────────────────────────────────────
-
-@cli.command("html")
-@click.option("-i", "--input", "input_path")
-@click.option("-c", "--content")
-@click.option("-f", "--filename", required=True)
-@click.option("-o", "--output-dir", default=None)
-@click.option("--format", "content_type", default="markdown", help="markdown|html")
-def html_cmd(input_path, content, filename, output_dir, content_type):
-    """Generate HTML file from Markdown or raw HTML."""
-    from licos_dev_sdk import create_html
-    text = _read_input(input_path, content)
-    path = create_html(text, filename, output_dir=output_dir, content_type=content_type)
-    click.echo(path)
-
-
-# ── Model Catalog ────────────────────────────────────────────────────────────
-
-@cli.command("model-catalog")
-@click.option("--refresh", is_flag=True, help="Bypass local catalog cache")
-def model_catalog(refresh):
-    """Print platform model capability catalog."""
-    from licos_dev_sdk import fetch_model_catalogs
-
-    _echo_json(fetch_model_catalogs(refresh=refresh))
-
-
-# ── LLM ──────────────────────────────────────────────────────────────────────
-
-@cli.group("llm")
-def llm_group():
-    """Call chat/text model capabilities."""
-    pass
-
-
-@llm_group.command("invoke")
-@click.option("-p", "--prompt", help="User prompt. If omitted, --messages or stdin is used.")
-@click.option("--messages", help="OpenAI-style messages JSON array")
-@click.option("--model", default=None)
-@click.option("--temperature", default=None, type=float)
-@click.option("--max-completion-tokens", default=None, type=int)
-@click.option("--extra", default=None, help="Extra request fields as JSON object")
-def llm_invoke(prompt, messages, model, temperature, max_completion_tokens, extra):
-    """Run a non-streaming chat completion."""
-    from licos_dev_sdk import LLMClient
-
-    if messages:
-        message_payload = _json_option(messages, "--messages")
-    else:
-        message_payload = prompt if prompt is not None else _read_input(None, None)
-    extra_payload = _json_option(extra, "--extra") or {}
-    if not isinstance(extra_payload, dict):
-        raise click.BadParameter("--extra must be a JSON object")
-    result = LLMClient().invoke(
-        message_payload,
-        model=model,
-        temperature=temperature,
-        max_completion_tokens=max_completion_tokens,
-        **extra_payload,
-    )
-    _echo_json(result)
-
-
-@llm_group.command("stream")
-@click.option("-p", "--prompt", help="User prompt. If omitted, --messages or stdin is used.")
-@click.option("--messages", help="OpenAI-style messages JSON array")
-@click.option("--model", default=None)
-@click.option("--temperature", default=None, type=float)
-@click.option("--max-completion-tokens", default=None, type=int)
-@click.option("--extra", default=None, help="Extra request fields as JSON object")
-def llm_stream(prompt, messages, model, temperature, max_completion_tokens, extra):
-    """Run a streaming chat completion and print text chunks."""
-    from licos_dev_sdk import LLMClient
-
-    if messages:
-        message_payload = _json_option(messages, "--messages")
-    else:
-        message_payload = prompt if prompt is not None else _read_input(None, None)
-    extra_payload = _json_option(extra, "--extra") or {}
-    if not isinstance(extra_payload, dict):
-        raise click.BadParameter("--extra must be a JSON object")
-    for chunk in LLMClient().stream(
-        message_payload,
-        model=model,
-        temperature=temperature,
-        max_completion_tokens=max_completion_tokens,
-        **extra_payload,
-    ):
-        click.echo(chunk, nl=False)
-
-
-# ── Vision ───────────────────────────────────────────────────────────────────
-
-@cli.group("vision")
-def vision_group():
-    """Call chat vision model capabilities."""
-    pass
-
-
-@vision_group.command("understand")
-@click.option("--image-url", multiple=True, help="Image URL. Can be repeated.")
-@click.option("-p", "--prompt", default="Describe this image.")
-@click.option("--model", default=None)
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-def vision_understand(image_url, prompt, model, raw_request):
-    """Understand one or more images with the catalog vision model."""
-    from licos_dev_sdk import VisionClient
-
-    raw_payload = _json_option(raw_request, "--raw-request")
-    if raw_payload is not None and not isinstance(raw_payload, dict):
-        raise click.BadParameter("--raw-request must be a JSON object")
-    if raw_payload is None and not image_url:
-        raise click.UsageError("Provide --image-url or --raw-request.")
-    result = VisionClient().understand(
-        image_urls=list(image_url),
-        prompt=prompt,
-        model=model,
-        raw_request=raw_payload,
-    )
-    _echo_json(result)
-
-
-# ── Image Generation ─────────────────────────────────────────────────────────
-
-@cli.group("image-generation")
-def image_generation_group():
-    """Call image generation model capabilities."""
-    pass
-
-
-@image_generation_group.command("generate")
-@click.option("-p", "--prompt")
-@click.option("--negative-prompt", default=None)
-@click.option("--count", default=1, type=int)
-@click.option("--size", default=None)
-@click.option("--model", default=None)
-@click.option("--parameters", default=None, help="Parameters JSON object")
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
-def image_generate(prompt, negative_prompt, count, size, model, parameters, raw_request, no_wait):
-    """Generate images from a text prompt."""
-    from licos_dev_sdk import ImageGenerationClient
-
-    parameter_payload = _json_option(parameters, "--parameters") or {}
-    raw_payload = _json_option(raw_request, "--raw-request")
-    if not isinstance(parameter_payload, dict):
-        raise click.BadParameter("--parameters must be a JSON object")
-    if raw_payload is not None and not isinstance(raw_payload, dict):
-        raise click.BadParameter("--raw-request must be a JSON object")
-    if raw_payload is None and not prompt:
-        raise click.UsageError("Provide --prompt or --raw-request.")
-    result = ImageGenerationClient().generate(
-        prompt or "",
-        negative_prompt=negative_prompt,
-        count=count,
-        size=size,
-        model=model,
-        parameters=parameter_payload,
-        raw_request=raw_payload,
-        wait=not no_wait,
-    )
-    _echo_json(result)
-
-
-# ── Video Generation ─────────────────────────────────────────────────────────
-
-@cli.group("video-generation")
-def video_generation_group():
-    """Call video generation model capabilities."""
-    pass
-
-
-@video_generation_group.command("generate")
-@click.option("-p", "--prompt")
-@click.option("--image-url", default=None)
-@click.option("--model", default=None)
-@click.option("--parameters", default=None, help="Parameters JSON object")
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
-def video_generate(prompt, image_url, model, parameters, raw_request, no_wait):
-    """Generate a video from a text prompt and optional first-frame image."""
-    from licos_dev_sdk import VideoGenerationClient
-
-    parameter_payload = _json_option(parameters, "--parameters") or {}
-    raw_payload = _json_option(raw_request, "--raw-request")
-    if not isinstance(parameter_payload, dict):
-        raise click.BadParameter("--parameters must be a JSON object")
-    if raw_payload is not None and not isinstance(raw_payload, dict):
-        raise click.BadParameter("--raw-request must be a JSON object")
-    if raw_payload is None and not prompt:
-        raise click.UsageError("Provide --prompt or --raw-request.")
-    result = VideoGenerationClient().generate(
-        prompt or "",
-        image_url=image_url,
-        model=model,
-        parameters=parameter_payload,
-        raw_request=raw_payload,
-        wait=not no_wait,
-    )
-    _echo_json(result)
-
-
-# ── Audio / ASR ──────────────────────────────────────────────────────────────
-
-@cli.group("audio")
-def audio_group():
-    """Call audio model capabilities."""
-    pass
-
-
-@audio_group.command("recognize")
-@click.option("--audio-url", multiple=True, help="Audio URL. Can be repeated.")
-@click.option("--model", default=None)
-@click.option("--parameters", default=None, help="Parameters JSON object")
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
-def audio_recognize(audio_url, model, parameters, raw_request, no_wait):
-    """Recognize speech from one or more audio URLs."""
-    from licos_dev_sdk import SpeechRecognitionClient
-
-    parameter_payload = _json_option(parameters, "--parameters") or {}
-    raw_payload = _json_option(raw_request, "--raw-request")
-    if not isinstance(parameter_payload, dict):
-        raise click.BadParameter("--parameters must be a JSON object")
-    if raw_payload is not None and not isinstance(raw_payload, dict):
-        raise click.BadParameter("--raw-request must be a JSON object")
-    if raw_payload is None and not audio_url:
-        raise click.UsageError("Provide --audio-url or --raw-request.")
-    result = SpeechRecognitionClient().recognize(
-        audio_urls=list(audio_url),
-        model=model,
-        parameters=parameter_payload,
-        raw_request=raw_payload,
-        wait=not no_wait,
-    )
-    _echo_json(result)
-
-
-if __name__ == "__main__":
-    cli()
+"""CLI entry point - wraps licos-dev-sdk functions as click commands."""
+
+from __future__ import annotations
+
+import sys
+import json
+import click
+
+# ── Helpers ──────────────────────────────────────────────────────────────────
+
+def _read_input(input_path: str | None, content: str | None) -> str:
+    """Read content from --input file, --content arg, or stdin."""
+    if input_path:
+        with open(input_path, "r", encoding="utf-8") as f:
+            return f.read()
+    if content:
+        return content
+    if not sys.stdin.isatty():
+        return sys.stdin.read()
+    raise click.UsageError("Provide --input, --content, or pipe via stdin.")
+
+
+def _read_json(input_path: str | None, content: str | None) -> object:
+    """Read and parse JSON from input."""
+    raw = _read_input(input_path, content)
+    return json.loads(raw)
+
+
+def _json_option(value: str | None, name: str) -> dict | list | None:
+    if not value:
+        return None
+    try:
+        return json.loads(value)
+    except json.JSONDecodeError as exc:
+        raise click.BadParameter(f"{name} must be valid JSON") from exc
+
+
+def _echo_json(value: object) -> None:
+    if hasattr(value, "to_dict"):
+        value = value.to_dict()
+    click.echo(json.dumps(value, ensure_ascii=False, indent=2))
+
+
+# ── CLI Group ────────────────────────────────────────────────────────────────
+
+@click.group()
+def cli():
+    """LICOS Dev - file generation and model CLI for AI agents."""
+    pass
+
+
+# ── PDF ──────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path", help="Input file (Markdown or HTML)")
+@click.option("-c", "--content", help="Direct content")
+@click.option("-f", "--filename", required=True, help="Output filename (no extension)")
+@click.option("-o", "--output-dir", default=None, help="Output directory")
+@click.option("--format", "content_type", default="markdown", help="Content type: markdown|html")
+@click.option("--page-size", default="A4", help="Page size: A4|LETTER")
+def pdf(input_path, content, filename, output_dir, content_type, page_size):
+    """Generate PDF from Markdown or HTML."""
+    from licos_dev_sdk import create_pdf
+    text = _read_input(input_path, content)
+    path = create_pdf(text, filename, content_type=content_type, output_dir=output_dir, page_size=page_size)
+    click.echo(path)
+
+
+# ── DOCX ─────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--format", "content_type", default="markdown")
+@click.option("--font", default="Arial")
+@click.option("--font-size", default=11, type=int)
+def docx(input_path, content, filename, output_dir, content_type, font, font_size):
+    """Generate DOCX from Markdown or HTML."""
+    from licos_dev_sdk import create_docx
+    text = _read_input(input_path, content)
+    path = create_docx(text, filename, content_type=content_type, output_dir=output_dir, font_name=font, font_size=font_size)
+    click.echo(path)
+
+
+# ── XLSX ─────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON data")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--sheet-name", default="Sheet1")
+@click.option("--header-color", default="4472C4")
+def xlsx(input_path, content, filename, output_dir, sheet_name, header_color):
+    """Generate XLSX from JSON data."""
+    from licos_dev_sdk import create_xlsx
+    data = _read_json(input_path, content)
+    path = create_xlsx(data, filename, output_dir=output_dir, sheet_name=sheet_name, header_color=header_color)
+    click.echo(path)
+
+
+# ── CSV ──────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON data")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def csv(input_path, content, filename, output_dir):
+    """Generate CSV from JSON data."""
+    from licos_dev_sdk import create_csv
+    data = _read_json(input_path, content)
+    path = create_csv(data, filename, output_dir=output_dir)
+    click.echo(path)
+
+
+# ── PPTX ─────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--format", "content_type", default="markdown")
+def pptx(input_path, content, filename, output_dir, content_type):
+    """Generate PPTX from Markdown."""
+    from licos_dev_sdk import create_pptx
+    text = _read_input(input_path, content)
+    path = create_pptx(text, filename, content_type=content_type, output_dir=output_dir)
+    click.echo(path)
+
+
+# ── Chart ────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON chart data")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--type", "chart_type", required=True, help="bar|line|pie|scatter|heatmap")
+@click.option("--format", "fmt", default="png", help="png|svg")
+@click.option("--title", default="")
+@click.option("--width", default=800, type=int)
+@click.option("--height", default=600, type=int)
+def chart(input_path, content, filename, output_dir, chart_type, fmt, title, width, height):
+    """Generate chart image from JSON data."""
+    from licos_dev_sdk import create_chart
+    data = _read_json(input_path, content)
+    path = create_chart(chart_type, data, filename, output_dir=output_dir, format=fmt, title=title, width=width, height=height)
+    click.echo(path)
+
+
+# ── Diagram ──────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="DOT source")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--format", "fmt", default="png", help="png|svg|pdf")
+def diagram(input_path, content, filename, output_dir, fmt):
+    """Generate diagram from Graphviz DOT source."""
+    from licos_dev_sdk import create_diagram
+    text = _read_input(input_path, content)
+    path = create_diagram(text, filename, output_dir=output_dir, format=fmt)
+    click.echo(path)
+
+
+# ── QR Code ──────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-d", "--data", required=True, help="Data to encode")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--size", default=300, type=int)
+def qrcode(data, filename, output_dir, size):
+    """Generate QR code PNG image."""
+    from licos_dev_sdk import create_qrcode
+    path = create_qrcode(data, filename, output_dir=output_dir, size=size)
+    click.echo(path)
+
+
+# ── Barcode ──────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("-d", "--data", required=True, help="Data to encode")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--type", "barcode_type", default="code128", help="code128|ean13|ean8|isbn13|upc")
+def barcode(data, filename, output_dir, barcode_type):
+    """Generate barcode PNG image."""
+    from licos_dev_sdk import create_barcode
+    path = create_barcode(data, filename, output_dir=output_dir, barcode_type=barcode_type)
+    click.echo(path)
+
+
+# ── ZIP ──────────────────────────────────────────────────────────────────────
+
+@cli.command("zip")
+@click.option("-p", "--paths", required=True, help="Comma-separated file/dir paths")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def zip_cmd(paths, filename, output_dir):
+    """Create ZIP archive."""
+    from licos_dev_sdk import create_zip
+    source_paths = [p.strip() for p in paths.split(",")]
+    path = create_zip(source_paths, filename, output_dir=output_dir)
+    click.echo(path)
+
+
+# ── TAR.GZ ───────────────────────────────────────────────────────────────────
+
+@cli.command("tar")
+@click.option("-p", "--paths", required=True, help="Comma-separated file/dir paths")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def tar_cmd(paths, filename, output_dir):
+    """Create TAR.GZ archive."""
+    from licos_dev_sdk import create_tar_gz
+    source_paths = [p.strip() for p in paths.split(",")]
+    path = create_tar_gz(source_paths, filename, output_dir=output_dir)
+    click.echo(path)
+
+
+# ── JSON ─────────────────────────────────────────────────────────────────────
+
+@cli.command("json")
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON or YAML content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def json_cmd(input_path, content, filename, output_dir):
+    """Generate JSON file (accepts JSON or YAML input)."""
+    from licos_dev_sdk import create_json
+    raw = _read_input(input_path, content)
+    try:
+        data = json.loads(raw)
+    except json.JSONDecodeError:
+        import yaml
+        data = yaml.safe_load(raw)
+    path = create_json(data, filename, output_dir=output_dir)
+    click.echo(path)
+
+
+# ── YAML ─────────────────────────────────────────────────────────────────────
+
+@cli.command("yaml")
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON or YAML content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def yaml_cmd(input_path, content, filename, output_dir):
+    """Generate YAML file (accepts JSON or YAML input)."""
+    from licos_dev_sdk import create_yaml
+    import yaml as yaml_lib
+    raw = _read_input(input_path, content)
+    try:
+        data = json.loads(raw)
+    except json.JSONDecodeError:
+        data = yaml_lib.safe_load(raw)
+    path = create_yaml(data, filename, output_dir=output_dir)
+    click.echo(path)
+
+
+# ── XML ──────────────────────────────────────────────────────────────────────
+
+@cli.command("xml")
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content", help="JSON content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--root-tag", default="root")
+def xml_cmd(input_path, content, filename, output_dir, root_tag):
+    """Generate XML file from JSON data."""
+    from licos_dev_sdk import create_xml
+    data = _read_json(input_path, content)
+    path = create_xml(data, filename, output_dir=output_dir, root_tag=root_tag)
+    click.echo(path)
+
+
+# ── HTML ─────────────────────────────────────────────────────────────────────
+
+@cli.command("html")
+@click.option("-i", "--input", "input_path")
+@click.option("-c", "--content")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+@click.option("--format", "content_type", default="markdown", help="markdown|html")
+def html_cmd(input_path, content, filename, output_dir, content_type):
+    """Generate HTML file from Markdown or raw HTML."""
+    from licos_dev_sdk import create_html
+    text = _read_input(input_path, content)
+    path = create_html(text, filename, output_dir=output_dir, content_type=content_type)
+    click.echo(path)
+
+
+# ── Model Catalog ────────────────────────────────────────────────────────────
+
+@cli.command("model-catalog")
+@click.option("--refresh", is_flag=True, help="Bypass local catalog cache")
+def model_catalog(refresh):
+    """Print platform model capability catalog."""
+    from licos_dev_sdk import fetch_model_catalogs
+
+    _echo_json(fetch_model_catalogs(refresh=refresh))
+
+
+# ── LLM ──────────────────────────────────────────────────────────────────────
+
+@cli.group("llm")
+def llm_group():
+    """Call chat/text model capabilities."""
+    pass
+
+
+@llm_group.command("invoke")
+@click.option("-p", "--prompt", help="User prompt. If omitted, --messages or stdin is used.")
+@click.option("--messages", help="OpenAI-style messages JSON array")
+@click.option("--model", default=None)
+@click.option("--temperature", default=None, type=float)
+@click.option("--max-completion-tokens", default=None, type=int)
+@click.option("--extra", default=None, help="Extra request fields as JSON object")
+def llm_invoke(prompt, messages, model, temperature, max_completion_tokens, extra):
+    """Run a non-streaming chat completion."""
+    from licos_dev_sdk import LLMClient
+
+    if messages:
+        message_payload = _json_option(messages, "--messages")
+    else:
+        message_payload = prompt if prompt is not None else _read_input(None, None)
+    extra_payload = _json_option(extra, "--extra") or {}
+    if not isinstance(extra_payload, dict):
+        raise click.BadParameter("--extra must be a JSON object")
+    result = LLMClient().invoke(
+        message_payload,
+        model=model,
+        temperature=temperature,
+        max_completion_tokens=max_completion_tokens,
+        **extra_payload,
+    )
+    _echo_json(result)
+
+
+@llm_group.command("stream")
+@click.option("-p", "--prompt", help="User prompt. If omitted, --messages or stdin is used.")
+@click.option("--messages", help="OpenAI-style messages JSON array")
+@click.option("--model", default=None)
+@click.option("--temperature", default=None, type=float)
+@click.option("--max-completion-tokens", default=None, type=int)
+@click.option("--extra", default=None, help="Extra request fields as JSON object")
+def llm_stream(prompt, messages, model, temperature, max_completion_tokens, extra):
+    """Run a streaming chat completion and print text chunks."""
+    from licos_dev_sdk import LLMClient
+
+    if messages:
+        message_payload = _json_option(messages, "--messages")
+    else:
+        message_payload = prompt if prompt is not None else _read_input(None, None)
+    extra_payload = _json_option(extra, "--extra") or {}
+    if not isinstance(extra_payload, dict):
+        raise click.BadParameter("--extra must be a JSON object")
+    for chunk in LLMClient().stream(
+        message_payload,
+        model=model,
+        temperature=temperature,
+        max_completion_tokens=max_completion_tokens,
+        **extra_payload,
+    ):
+        click.echo(chunk, nl=False)
+
+
+# ── Vision ───────────────────────────────────────────────────────────────────
+
+@cli.group("vision")
+def vision_group():
+    """Call chat vision model capabilities."""
+    pass
+
+
+@vision_group.command("understand")
+@click.option("--image-url", multiple=True, help="Image URL. Can be repeated.")
+@click.option("-p", "--prompt", default="Describe this image.")
+@click.option("--model", default=None)
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+def vision_understand(image_url, prompt, model, raw_request):
+    """Understand one or more images with the catalog vision model."""
+    from licos_dev_sdk import VisionClient
+
+    raw_payload = _json_option(raw_request, "--raw-request")
+    if raw_payload is not None and not isinstance(raw_payload, dict):
+        raise click.BadParameter("--raw-request must be a JSON object")
+    if raw_payload is None and not image_url:
+        raise click.UsageError("Provide --image-url or --raw-request.")
+    result = VisionClient().understand(
+        image_urls=list(image_url),
+        prompt=prompt,
+        model=model,
+        raw_request=raw_payload,
+    )
+    _echo_json(result)
+
+
+# ── Image Generation ─────────────────────────────────────────────────────────
+
+@cli.group("image-generation")
+def image_generation_group():
+    """Call image generation model capabilities."""
+    pass
+
+
+@image_generation_group.command("generate")
+@click.option("-p", "--prompt")
+@click.option("--negative-prompt", default=None)
+@click.option("--count", default=1, type=int)
+@click.option("--size", default=None)
+@click.option("--model", default=None)
+@click.option("--parameters", default=None, help="Parameters JSON object")
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
+def image_generate(prompt, negative_prompt, count, size, model, parameters, raw_request, no_wait):
+    """Generate images from a text prompt."""
+    from licos_dev_sdk import ImageGenerationClient
+
+    parameter_payload = _json_option(parameters, "--parameters") or {}
+    raw_payload = _json_option(raw_request, "--raw-request")
+    if not isinstance(parameter_payload, dict):
+        raise click.BadParameter("--parameters must be a JSON object")
+    if raw_payload is not None and not isinstance(raw_payload, dict):
+        raise click.BadParameter("--raw-request must be a JSON object")
+    if raw_payload is None and not prompt:
+        raise click.UsageError("Provide --prompt or --raw-request.")
+    result = ImageGenerationClient().generate(
+        prompt or "",
+        negative_prompt=negative_prompt,
+        count=count,
+        size=size,
+        model=model,
+        parameters=parameter_payload,
+        raw_request=raw_payload,
+        wait=not no_wait,
+    )
+    _echo_json(result)
+
+
+# ── Video Generation ─────────────────────────────────────────────────────────
+
+@cli.group("video-generation")
+def video_generation_group():
+    """Call video generation model capabilities."""
+    pass
+
+
+@video_generation_group.command("generate")
+@click.option("-p", "--prompt")
+@click.option("--image-url", default=None)
+@click.option("--model", default=None)
+@click.option("--parameters", default=None, help="Parameters JSON object")
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
+def video_generate(prompt, image_url, model, parameters, raw_request, no_wait):
+    """Generate a video from a text prompt and optional first-frame image."""
+    from licos_dev_sdk import VideoGenerationClient
+
+    parameter_payload = _json_option(parameters, "--parameters") or {}
+    raw_payload = _json_option(raw_request, "--raw-request")
+    if not isinstance(parameter_payload, dict):
+        raise click.BadParameter("--parameters must be a JSON object")
+    if raw_payload is not None and not isinstance(raw_payload, dict):
+        raise click.BadParameter("--raw-request must be a JSON object")
+    if raw_payload is None and not prompt:
+        raise click.UsageError("Provide --prompt or --raw-request.")
+    result = VideoGenerationClient().generate(
+        prompt or "",
+        image_url=image_url,
+        model=model,
+        parameters=parameter_payload,
+        raw_request=raw_payload,
+        wait=not no_wait,
+    )
+    _echo_json(result)
+
+
+# ── Audio / ASR ──────────────────────────────────────────────────────────────
+
+@cli.group("audio")
+def audio_group():
+    """Call audio model capabilities."""
+    pass
+
+
+@audio_group.command("recognize")
+@click.option("--audio-url", multiple=True, help="Audio URL. Can be repeated.")
+@click.option("--model", default=None)
+@click.option("--parameters", default=None, help="Parameters JSON object")
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
+def audio_recognize(audio_url, model, parameters, raw_request, no_wait):
+    """Recognize speech from one or more audio URLs."""
+    from licos_dev_sdk import SpeechRecognitionClient
+
+    parameter_payload = _json_option(parameters, "--parameters") or {}
+    raw_payload = _json_option(raw_request, "--raw-request")
+    if not isinstance(parameter_payload, dict):
+        raise click.BadParameter("--parameters must be a JSON object")
+    if raw_payload is not None and not isinstance(raw_payload, dict):
+        raise click.BadParameter("--raw-request must be a JSON object")
+    if raw_payload is None and not audio_url:
+        raise click.UsageError("Provide --audio-url or --raw-request.")
+    result = SpeechRecognitionClient().recognize(
+        audio_urls=list(audio_url),
+        model=model,
+        parameters=parameter_payload,
+        raw_request=raw_payload,
+        wait=not no_wait,
+    )
+    _echo_json(result)
+
+
+if __name__ == "__main__":
+    cli()