opensell-cli 0.1.0__py3-none-any.whl

opensell_cli/catalog.py

@@ -0,0 +1,39 @@
+# opensell_cli/catalog.py
+from __future__ import annotations
+
+import json
+
+import click
+from aixianyu_mcp.registry import TOOL_REGISTRY
+
+
+def build_catalog() -> dict:
+    """The CLI's machine-readable surface — the analog of MCP list_tools."""
+    commands = []
+    for name, spec in TOOL_REGISTRY.items():
+        props = spec.input_schema.get("properties", {})
+        required = set(spec.input_schema.get("required", []))
+        commands.append(
+            {
+                "command": name.replace("_", "-"),
+                "tool": name,
+                "scope": spec.scope,
+                "tier": spec.tier,
+                "description": spec.description,
+                "args": [
+                    {
+                        "name": pname,
+                        "type": pspec.get("type", "string"),
+                        "required": pname in required,
+                        "default": pspec.get("default"),
+                    }
+                    for pname, pspec in props.items()
+                ],
+            }
+        )
+    return {"commands": commands}
+
+
+@click.command("catalog", help="Emit the full command surface as JSON (for agents).")
+def catalog_command() -> None:
+    click.echo(json.dumps(build_catalog(), ensure_ascii=False, indent=2))

opensell_cli/cli.py

@@ -0,0 +1,76 @@
+# opensell_cli/cli.py
+from __future__ import annotations
+
+import asyncio
+import json
+
+import click
+from aixianyu_mcp.errors import MCPToolError
+from aixianyu_mcp.registry import TOOL_REGISTRY, ToolSpec
+
+from .catalog import catalog_command
+from .execute import run_tool
+from .output import emit_error, emit_success
+from .schema_to_click import options_for_schema
+
+
+def _decode_object_args(spec: ToolSpec, args: dict) -> dict:
+    """Return a copy of args with any type:object property (passed as a JSON
+    string) decoded. Malformed JSON becomes a clean Click usage error."""
+    props = spec.input_schema.get("properties", {})
+    out = dict(args)
+    for name, pspec in props.items():
+        if pspec.get("type") == "object" and isinstance(out.get(name), str):
+            try:
+                out[name] = json.loads(out[name])
+            except json.JSONDecodeError as exc:
+                raise click.BadParameter(
+                    f"must be a valid JSON object ({exc})",
+                    param_hint=f"--{name.replace('_', '-')}",
+                )
+    return out
+
+
+def _make_command(tool_name: str, spec: ToolSpec) -> click.Command:
+    def callback(**kwargs):
+        ctx = click.get_current_context()
+        args = {k: v for k, v in kwargs.items() if v is not None}
+        args = _decode_object_args(spec, args)
+        try:
+            result = asyncio.run(
+                run_tool(
+                    tool_name,
+                    args,
+                    base_url=ctx.obj["base_url"],
+                    token=ctx.obj["token"],
+                )
+            )
+            emit_success(result)
+        except MCPToolError as err:
+            emit_error(err)
+
+    return click.Command(
+        name=tool_name.replace("_", "-"),
+        params=options_for_schema(spec.input_schema),
+        callback=callback,
+        help=f"{spec.description}\n\nRequires scope: {spec.scope}",
+    )
+
+
+def build_cli() -> click.Group:
+    @click.group()
+    @click.option("--token", envvar="AIXIANYU_AGENT_TOKEN", default="")
+    @click.option("--base-url", envvar="AIXIANYU_BASE_URL", default=None)
+    @click.pass_context
+    def cli(ctx: click.Context, token: str, base_url: str | None):
+        """OPENSELL marketplace CLI for AI agents."""
+        ctx.obj = {"token": token, "base_url": base_url}
+
+    for name, spec in TOOL_REGISTRY.items():
+        cli.add_command(_make_command(name, spec))
+    cli.add_command(catalog_command)
+    return cli
+
+
+def main() -> None:
+    build_cli()()

opensell_cli/execute.py

@@ -0,0 +1,26 @@
+# opensell_cli/execute.py
+from __future__ import annotations
+
+import json
+from typing import Any
+
+from aixianyu_mcp.errors import MCPError, MCPToolError
+from aixianyu_mcp.rest_client import AixianyuRESTClient
+from aixianyu_mcp.server import TOOL_HANDLERS
+
+
+async def run_tool(name: str, args: dict, *, base_url: str | None, token: str) -> Any:
+    """Execute a registry tool by reusing the MCP handler, then unwrap the
+    TextContent result back into a plain Python object.
+
+    `name` is the snake_case registry/tool name (e.g. "get_item").
+    Raises MCPToolError on backend errors (handled by the caller).
+    """
+    client = AixianyuRESTClient(base_url=base_url, agent_token=token)
+    if name == "ping":
+        return await client.ping()
+    handler = TOOL_HANDLERS.get(name)
+    if handler is None:
+        raise MCPToolError(MCPError.SERVER_ERROR)
+    blocks = await handler(client, args)
+    return json.loads(blocks[0].text)

opensell_cli/output.py

@@ -0,0 +1,34 @@
+# opensell_cli/output.py
+from __future__ import annotations
+
+import json
+import sys
+from typing import Any
+
+from aixianyu_mcp.errors import MCPToolError
+
+# Stable exit codes per MCPError name. Covers every enum member so a newly
+# added error can never fall through to an undefined code.
+EXIT_CODES: dict[str, int] = {
+    "INVALID_ARGS": 1,
+    "UNAUTHORIZED": 2,
+    "INSUFFICIENT_SCOPE": 3,
+    "AGENT_SANDBOX_LIMIT": 4,
+    "INSUFFICIENT_BALANCE": 5,
+    "RATE_LIMITED": 6,
+    "ITEM_NOT_FOUND": 7,
+    "CONVERSATION_NOT_FOUND": 7,
+    "SERVER_ERROR": 8,
+}
+
+
+def emit_success(payload: Any) -> None:
+    """Print the tool payload as JSON to stdout and exit 0."""
+    sys.stdout.write(json.dumps(payload, ensure_ascii=False) + "\n")
+    raise SystemExit(0)
+
+
+def emit_error(err: MCPToolError) -> None:
+    """Print the normalized error to stderr and exit with its mapped code."""
+    sys.stderr.write(json.dumps(err.to_dict(), ensure_ascii=False) + "\n")
+    raise SystemExit(EXIT_CODES.get(err.error.name, 8))

opensell_cli/schema_to_click.py

@@ -0,0 +1,38 @@
+# opensell_cli/schema_to_click.py
+from __future__ import annotations
+
+import click
+
+_SCALAR = {"integer": click.INT, "number": click.FLOAT, "string": click.STRING}
+
+
+def options_for_schema(schema: dict) -> list[click.Option]:
+    """Build one click.Option per JSON-Schema property.
+
+    - property name `item_id` -> flag `--item-id` (Click maps it back to the
+      `item_id` callback kwarg automatically).
+    - integer/number/string -> matching Click types; enum -> click.Choice;
+      boolean -> is_flag; object -> STRING (a JSON string, decoded at dispatch).
+    - names in `required` are required unless they declare a `default`.
+    """
+    props = schema.get("properties", {})
+    required = set(schema.get("required", []))
+    options: list[click.Option] = []
+    for name, spec in props.items():
+        flag = "--" + name.replace("_", "-")
+        help_text = spec.get("description", "")
+        if spec.get("type") == "boolean":
+            options.append(click.Option([flag], is_flag=True, help=help_text))
+            continue
+        kwargs: dict = {"help": help_text, "required": name in required}
+        if "default" in spec:
+            kwargs["default"] = spec["default"]
+            kwargs["required"] = False
+        if "enum" in spec:
+            kwargs["type"] = click.Choice(spec["enum"])
+        elif spec.get("type") == "object":
+            kwargs["type"] = click.STRING
+        else:
+            kwargs["type"] = _SCALAR.get(spec.get("type"), click.STRING)
+        options.append(click.Option([flag], **kwargs))
+    return options

opensell_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: opensell-cli
+Version: 0.1.0
+Summary: OPENSELL marketplace CLI for AI agents
+Requires-Python: >=3.12
+Requires-Dist: aixianyu-mcp
+Requires-Dist: click>=8.1
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.2.0; extra == 'dev'

opensell_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+opensell_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+opensell_cli/catalog.py,sha256=CAKXQYxCdfqkAY-yKNvtS4zpOUlLTMeZntV-CNqms5o,1274
+opensell_cli/cli.py,sha256=6rguZ-bROEuy4XG56tLWOcW6xCuEyxjUN2Gg6v-myQo,2497
+opensell_cli/execute.py,sha256=4Kv-rveF6H-6iSGI01SuuKTyCUpbXL8p5CiUA51u0iI,937
+opensell_cli/output.py,sha256=YCKE7pynGv7rk2JeZelizEj3brDagoOvppmdDDGeorE,1013
+opensell_cli/schema_to_click.py,sha256=ao79n_tXw3udJ1MFBvFF66gECnELzUYWz4YjpZvSrtw,1559
+opensell_cli-0.1.0.dist-info/METADATA,sha256=aRxpVTxwXhyuNV8JassHAo1MLUVbtRMHdYzo5DKYWXc,301
+opensell_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+opensell_cli-0.1.0.dist-info/entry_points.txt,sha256=EzNEBt2PpKdkmBsNyI4J6tRsuXVHHCAzdnX_54Fo-d8,51
+opensell_cli-0.1.0.dist-info/RECORD,,

opensell_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

opensell_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+opensell = opensell_cli.cli:main