luxin-cli 0.0.1 → 0.2.0

package/commands.json

@@ -0,0 +1,557 @@
+{
+  "schema": "image-skill.public-command-manifest.v1",
+  "command_prefix": "luxin",
+  "product_frame": "Luxin is a hosted thin CLI and public contract for agent-native durable creative media.",
+  "skill_url": "https://luxin.sh/skill.md",
+  "docs_url": "https://luxin.sh/cli.md",
+  "llms_url": "https://luxin.sh/llms.txt",
+  "commands": [
+    {
+      "id": "doctor",
+      "docs_anchor": "luxin-doctor",
+      "surface": "client",
+      "mutation": false,
+      "spend": false
+    },
+    {
+      "id": "trust",
+      "docs_anchor": "luxin-trust",
+      "surface": "client",
+      "mutation": false,
+      "spend": false
+    },
+    {
+      "id": "signup",
+      "docs_anchor": "luxin-signup-agent",
+      "surface": "hosted_cli",
+      "mutation": true,
+      "spend": false
+    },
+    {
+      "id": "claim",
+      "docs_anchor": "luxin-claim-request",
+      "surface": "hosted_cli",
+      "mutation": true,
+      "spend": false,
+      "subcommands": ["request"]
+    },
+    {
+      "id": "whoami",
+      "docs_anchor": "luxin-whoami",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false
+    },
+    {
+      "id": "usage",
+      "docs_anchor": "luxin-usage",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["quota"]
+    },
+    {
+      "id": "quota",
+      "docs_anchor": "luxin-quota",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false
+    },
+    {
+      "id": "credits",
+      "docs_anchor": "luxin-credits",
+      "surface": "hosted_cli",
+      "mutation": true,
+      "spend": true,
+      "subcommands": ["methods", "packs list", "quote", "buy", "status"]
+    },
+    {
+      "id": "capabilities",
+      "docs_anchor": "luxin-capabilities",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["list", "show"]
+    },
+    {
+      "id": "models",
+      "docs_anchor": "luxin-models",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["list", "show"]
+    },
+    {
+      "id": "create",
+      "docs_anchor": "luxin-create",
+      "surface": "hosted_cli",
+      "mutation": true,
+      "spend": true
+    },
+    {
+      "id": "upload",
+      "docs_anchor": "luxin-upload",
+      "surface": "client",
+      "mutation": true,
+      "spend": false
+    },
+    {
+      "id": "edit",
+      "docs_anchor": "luxin-edit",
+      "surface": "client",
+      "mutation": true,
+      "spend": true
+    },
+    {
+      "id": "assets",
+      "docs_anchor": "luxin-assets",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["show", "get"]
+    },
+    {
+      "id": "jobs",
+      "docs_anchor": "luxin-jobs",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["show", "wait"]
+    },
+    {
+      "id": "activity",
+      "docs_anchor": "luxin-activity",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["list", "show"]
+    },
+    {
+      "id": "feedback",
+      "docs_anchor": "luxin-feedback",
+      "surface": "hosted_cli",
+      "mutation": true,
+      "spend": false,
+      "subcommands": ["create"]
+    }
+  ],
+  "modality_aliases": [
+    { "alias": "image", "command": "create", "intent": null },
+    { "alias": "video", "command": "create", "intent": "video" },
+    { "alias": "audio", "command": "create", "intent": "audio" },
+    { "alias": "3d", "command": "create", "intent": "image-to-3d" },
+    { "alias": "image-to-3d", "command": "create", "intent": "image-to-3d" },
+    { "alias": "three-d", "command": "create", "intent": "image-to-3d" }
+  ],
+  "help_entries": [
+    {
+      "key": "",
+      "help": {
+        "command": "help",
+        "usage": "luxin <doctor|trust|signup|claim|whoami|usage|quota|credits|capabilities|models|create|upload|edit|assets|jobs|activity|feedback> --json",
+        "docs_url": "https://luxin.sh/cli.md",
+        "agent_skill": {
+          "url": "https://luxin.sh/skill.md",
+          "llms_url": "https://luxin.sh/llms.txt",
+          "cli_docs_url": "https://luxin.sh/cli.md",
+          "read_command": "curl -fsSL https://luxin.sh/skill.md",
+          "recommended_start_command": "luxin create --guide --prompt PROMPT --json",
+          "model_discovery_command": "luxin models list --available --operation image.generate --json",
+          "model_inspection_command": "luxin models show MODEL_ID --json",
+          "no_spend": true,
+          "purpose": "Read the agent skill before paid media work; it explains model discovery, guide flow, model parameters, quota, and self-fund recovery."
+        },
+        "commands": [
+          "doctor",
+          "trust",
+          "signup --agent --agent-name NAME --runtime RUNTIME",
+          "claim request --contact INBOX",
+          "whoami",
+          "usage quota",
+          "quota",
+          "credits methods",
+          "credits quote",
+          "credits packs list",
+          "credits buy",
+          "credits status",
+          "capabilities",
+          "capabilities list",
+          "capabilities show",
+          "models",
+          "models list",
+          "models show",
+          "create --guide",
+          "image create --guide",
+          "video create --guide",
+          "audio create --guide",
+          "3d create --guide",
+          "create --dry-run",
+          "create",
+          "image edit",
+          "upload",
+          "edit",
+          "assets show",
+          "assets get",
+          "jobs show",
+          "jobs wait",
+          "activity list",
+          "activity show",
+          "feedback create"
+        ]
+      }
+    },
+    {
+      "key": "doctor",
+      "help": {
+        "command": "luxin doctor help",
+        "usage": "luxin doctor --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-doctor",
+        "description": "Check hosted API reachability, CLI version, auth state, health, and live-spend recovery breadcrumbs.",
+        "optional_flags": ["--sweep-in-flight"]
+      }
+    },
+    {
+      "key": "trust",
+      "help": {
+        "command": "luxin trust help",
+        "usage": "luxin trust --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-trust",
+        "description": "Return npm provenance, hosted contract hashes, API health, and model availability evidence."
+      }
+    },
+    {
+      "key": "signup",
+      "help": {
+        "command": "luxin signup help",
+        "usage": "luxin signup --agent --agent-name NAME --runtime RUNTIME --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-signup-agent",
+        "required_flags": ["--agent", "--agent-name", "--runtime"],
+        "optional_flags": [
+          "--agent-contact",
+          "--show-token",
+          "--no-save",
+          "--token-stdin"
+        ]
+      }
+    },
+    {
+      "key": "claim",
+      "help": {
+        "command": "luxin claim help",
+        "usage": "luxin claim request --contact AGENT_OR_OPERATOR_INBOX --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-claim-request",
+        "subcommands": ["request"]
+      }
+    },
+    {
+      "key": "claim request",
+      "help": {
+        "command": "luxin claim request help",
+        "usage": "luxin claim request --contact AGENT_OR_OPERATOR_INBOX --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-claim-request",
+        "required_flags": ["--contact"],
+        "optional_flags": ["--token-stdin"]
+      }
+    },
+    {
+      "key": "whoami",
+      "help": {
+        "command": "luxin whoami help",
+        "usage": "luxin whoami --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-whoami"
+      }
+    },
+    {
+      "key": "usage",
+      "help": {
+        "command": "luxin usage help",
+        "usage": "luxin usage quota --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-usage",
+        "subcommands": ["quota"]
+      }
+    },
+    {
+      "key": "usage quota",
+      "help": {
+        "command": "luxin usage quota help",
+        "usage": "luxin usage quota --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-usage"
+      }
+    },
+    {
+      "key": "quota",
+      "help": {
+        "command": "luxin quota help",
+        "usage": "luxin quota --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-quota"
+      }
+    },
+    {
+      "key": "credits",
+      "help": {
+        "command": "luxin credits help",
+        "usage": "luxin credits <methods|packs list|quote|buy|status> --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-credits",
+        "subcommands": ["methods", "packs list", "quote", "buy", "status"]
+      }
+    },
+    {
+      "key": "credits methods",
+      "help": {
+        "command": "luxin credits methods help",
+        "usage": "luxin credits methods",
+        "docs_url": "https://luxin.sh/cli.md#luxin-credits"
+      }
+    },
+    {
+      "key": "credits packs",
+      "help": {
+        "command": "luxin credits packs help",
+        "usage": "luxin credits packs list --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-credits",
+        "subcommands": ["list"]
+      }
+    },
+    {
+      "key": "credits quote",
+      "help": {
+        "command": "luxin credits quote help",
+        "usage": "luxin credits quote --pack PACK_ID --payment-method stripe_x402.exact.usdc --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-credits",
+        "required_flags": ["--pack or --credits", "--payment-method"],
+        "optional_flags": ["--idempotency-key"]
+      }
+    },
+    {
+      "key": "credits buy",
+      "help": {
+        "command": "luxin credits buy help",
+        "usage": "luxin credits buy --provider stripe_x402 --quote-id QUOTE_ID --idempotency-key KEY --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-credits",
+        "required_flags": ["--provider", "--quote-id", "--idempotency-key"],
+        "supported_providers": ["stripe", "stripe_x402"]
+      }
+    },
+    {
+      "key": "credits status",
+      "help": {
+        "command": "luxin credits status help",
+        "usage": "luxin credits status --payment-attempt-id PAYMENT_ATTEMPT_ID --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-credits",
+        "required_flags": ["--payment-attempt-id"]
+      }
+    },
+    {
+      "key": "capabilities",
+      "help": {
+        "command": "luxin capabilities help",
+        "usage": "luxin capabilities <list|show> --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-capabilities",
+        "subcommands": ["list", "show"]
+      }
+    },
+    {
+      "key": "capabilities list",
+      "help": {
+        "command": "luxin capabilities list help",
+        "usage": "luxin capabilities list --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-capabilities"
+      }
+    },
+    {
+      "key": "capabilities show",
+      "help": {
+        "command": "luxin capabilities show help",
+        "usage": "luxin capabilities show CAPABILITY_ID --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-capabilities"
+      }
+    },
+    {
+      "key": "models",
+      "help": {
+        "command": "luxin models help",
+        "usage": "luxin models <list|show> --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-models",
+        "subcommands": ["list", "show"]
+      }
+    },
+    {
+      "key": "models list",
+      "help": {
+        "command": "luxin models list help",
+        "usage": "luxin models list --available --operation image.generate --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-models",
+        "optional_flags": [
+          "--available",
+          "--executable",
+          "--catalog-only",
+          "--operation",
+          "--modality",
+          "--provider",
+          "--query",
+          "--summary",
+          "--details"
+        ]
+      }
+    },
+    {
+      "key": "models show",
+      "help": {
+        "command": "luxin models show help",
+        "usage": "luxin models show MODEL_ID --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-models"
+      }
+    },
+    {
+      "key": "create",
+      "help": {
+        "command": "luxin create help",
+        "usage": "luxin create --prompt \"...\" --intent explore --max-estimated-usd-per-image 0.07 --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-create",
+        "optional_flags": [
+          "--guide",
+          "--dry-run",
+          "--model",
+          "--aspect-ratio",
+          "--output-count",
+          "--element-frontal",
+          "--element-reference",
+          "--reference-image",
+          "--model-parameters-json",
+          "--idempotency-key"
+        ]
+      }
+    },
+    {
+      "key": "upload",
+      "help": {
+        "command": "luxin upload help",
+        "usage": "luxin upload PATH_OR_URL --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-upload"
+      }
+    },
+    {
+      "key": "edit",
+      "help": {
+        "command": "luxin edit help",
+        "usage": "luxin edit --input image_... --prompt \"...\" --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-edit",
+        "required_flags": ["--input"],
+        "optional_flags": [
+          "--guide",
+          "--dry-run",
+          "--prompt",
+          "--model",
+          "--mask",
+          "--element-reference",
+          "--element-frontal",
+          "--reference-image",
+          "--model-parameters-json",
+          "--idempotency-key"
+        ]
+      }
+    },
+    {
+      "key": "assets",
+      "help": {
+        "command": "luxin assets help",
+        "usage": "luxin assets <show|get> ASSET_ID_OR_URL --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-assets",
+        "subcommands": ["show", "get"]
+      }
+    },
+    {
+      "key": "assets show",
+      "help": {
+        "command": "luxin assets show help",
+        "usage": "luxin assets show ASSET_ID_OR_URL --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-assets"
+      }
+    },
+    {
+      "key": "assets get",
+      "help": {
+        "command": "luxin assets get help",
+        "usage": "luxin assets get ASSET_ID_OR_URL --output PATH --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-assets"
+      }
+    },
+    {
+      "key": "jobs",
+      "help": {
+        "command": "luxin jobs help",
+        "usage": "luxin jobs <show|wait> JOB_ID --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-jobs",
+        "subcommands": ["show", "wait"]
+      }
+    },
+    {
+      "key": "jobs show",
+      "help": {
+        "command": "luxin jobs show help",
+        "usage": "luxin jobs show JOB_ID --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-jobs"
+      }
+    },
+    {
+      "key": "jobs wait",
+      "help": {
+        "command": "luxin jobs wait help",
+        "usage": "luxin jobs wait JOB_ID --timeout-ms 30000 --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-jobs"
+      }
+    },
+    {
+      "key": "activity",
+      "help": {
+        "command": "luxin activity help",
+        "usage": "luxin activity <list|show> --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-activity",
+        "subcommands": ["list", "show"]
+      }
+    },
+    {
+      "key": "activity list",
+      "help": {
+        "command": "luxin activity list help",
+        "usage": "luxin activity list --subject JOB_ID --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-activity"
+      }
+    },
+    {
+      "key": "activity show",
+      "help": {
+        "command": "luxin activity show help",
+        "usage": "luxin activity show REFERENCE --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-activity"
+      }
+    },
+    {
+      "key": "feedback",
+      "help": {
+        "command": "luxin feedback help",
+        "usage": "luxin feedback create --title TITLE --body BODY --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-feedback",
+        "subcommands": ["create"]
+      }
+    },
+    {
+      "key": "feedback create",
+      "help": {
+        "command": "luxin feedback create help",
+        "usage": "luxin feedback create --title TITLE --body BODY --type user_feedback --json",
+        "docs_url": "https://luxin.sh/cli.md#luxin-feedback",
+        "optional_flags": [
+          "--title",
+          "--body",
+          "--type",
+          "--severity",
+          "--confidence",
+          "--expected",
+          "--actual",
+          "--command"
+        ]
+      }
+    }
+  ]
+}