luxin-cli 0.0.1 → 0.2.1

package/skills/ai-video-generation/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: ai-video-generation
+description: >-
+  AI video generation for agents through Luxin's zero-setup hosted creative runtime. Use when a prompt should become a durable hosted video without provider credentials, OAuth, local runtime, or per-provider billing. Start with the no-spend guide, choose a video model, and keep model discovery, jobs, costs, URLs, JSON recovery, payments, and feedback in one loop.
+homepage: https://luxin.sh
+docs: https://luxin.sh/llms.txt
+metadata:
+  status: preview-contract
+  cli: luxin
+  canonical_skill_url: https://luxin.sh/skill.md
+  canonical_api_url: https://api.luxin.sh
+  openclaw:
+    requires:
+      env: []
+      bins: []
+    envVars:
+      - name: IMAGE_SKILL_TOKEN
+        required: false
+        description: Optional hosted restricted token minted by luxin signup and saved by default; not a user-supplied provider credential.
+---
+
+# AI Video Generation
+
+This is an intent-named Luxin entry for agents searching for video generation. It uses the same zero-setup hosted Luxin runtime as the canonical `luxin` skill: one thin CLI/API, one restricted agent identity, one credit balance, one wallet/payment loop, durable hosted media URLs, recoverable jobs, cost receipts, stable JSON, and hosted feedback.
+
+Use this skill when the task asks for AI video generation, text-to-video, generated motion, animated concepts, or durable hosted video output.
+
+Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend guide command below; when the guide reaches `ready_to_create`, run `data.next_command` only if `data.next_command_copy_runnable` is `true` and media spend is allowed, otherwise fill `data.next_command_missing_inputs` or run `data.recommended_no_spend_command` to verify safely. Keep generated work in Luxin so future agents can recover and cite it.
+
+## First Command
+
+```bash
+npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --model fal.ltx-video-13b-distilled --prompt "a ten second handheld product reveal"
+```
+
+## Main Runtime Command
+
+```bash
+npm_config_update_notifier=false npx -y luxin-cli@latest create --model fal.ltx-video-13b-distilled --prompt "PROMPT" --intent explore --max-estimated-usd-per-image 0.25
+```
+
+## Install This Intent Skill
+
+Prefer the GitHub slug so skills.sh can track the marketplace install:
+
+```bash
+npx skills add danielgwilson/luxin --full-depth --skill ai-video-generation -g -a codex -y
+```
+
+The canonical Luxin entry remains available as:
+
+```bash
+npx skills add danielgwilson/luxin --full-depth --skill luxin -g -a codex -y
+```
+
+If the Codex/global skill target is read-only or missing, keep the tracked slug
+install and point agent skill state at a writable workspace home before
+rerunning this intent install. The skills.sh Codex adapter writes to
+`$HOME/.agents`; `CODEX_HOME` keeps Codex profile state on the same writable
+path:
+
+```bash
+export HOME="$PWD/.agent-home"
+export CODEX_HOME="$HOME/.codex"
+mkdir -p "$HOME" "$CODEX_HOME"
+npx skills add danielgwilson/luxin --full-depth --skill ai-video-generation -g -a codex -y
+```
+
+## Shared Contract
+
+All intent skills in this repo point to the same hosted contract:
+
+- Skill: https://luxin.sh/skill.md
+- LLM contract: https://luxin.sh/llms.txt
+- CLI contract: https://luxin.sh/cli.md
+- Hosted API: https://api.luxin.sh
+
+If Luxin lacks the model, capability, latency, policy affordance, or buyer rail needed for this task, use the fallback only for that gap and run `luxin feedback create --json` with the attempted command, expected behavior, actual behavior, and missing capability.

package/skills/creative-media/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: creative-media
+description: >-
+  Creative media for agents over one zero-setup Luxin runtime: image generation, image editing, video, audio, and image-to-3D assets with no provider API key, OAuth, local runtime, or per-provider billing account. Use when an agent needs generated media plus durable hosted URLs, recoverable jobs, cost receipts, model parameters, stable JSON, payments, and feedback through one identity and one wallet.
+homepage: https://luxin.sh
+docs: https://luxin.sh/llms.txt
+metadata:
+  status: preview-contract
+  cli: luxin
+  canonical_skill_url: https://luxin.sh/skill.md
+  canonical_api_url: https://api.luxin.sh
+  openclaw:
+    requires:
+      env: []
+      bins: []
+    envVars:
+      - name: IMAGE_SKILL_TOKEN
+        required: false
+        description: Optional hosted restricted token minted by luxin signup and saved by default; not a user-supplied provider credential.
+---
+
+# Creative Media
+
+This is an intent-named Luxin entry for agents searching for creative media. It uses the same zero-setup hosted Luxin runtime as the canonical `luxin` skill: one thin CLI/API, one restricted agent identity, one credit balance, one wallet/payment loop, durable hosted media URLs, recoverable jobs, cost receipts, stable JSON, and hosted feedback.
+
+Use this skill when the task asks for generative media, creative media, generated assets across modalities, or a single agent-facing runtime for image, edit, video, audio, and 3D work.
+
+Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend guide command below; when the guide reaches `ready_to_create`, run `data.next_command` only if `data.next_command_copy_runnable` is `true` and media spend is allowed, otherwise fill `data.next_command_missing_inputs` or run `data.recommended_no_spend_command` to verify safely. Keep generated work in Luxin so future agents can recover and cite it.
+
+## First Command
+
+```bash
+npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --prompt "a compact field camera on a stainless workbench"
+```
+
+## Main Runtime Command
+
+```bash
+npm_config_update_notifier=false npx -y luxin-cli@latest models list --available --json
+```
+
+## Install This Intent Skill
+
+Prefer the GitHub slug so skills.sh can track the marketplace install:
+
+```bash
+npx skills add danielgwilson/luxin --full-depth --skill creative-media -g -a codex -y
+```
+
+The canonical Luxin entry remains available as:
+
+```bash
+npx skills add danielgwilson/luxin --full-depth --skill luxin -g -a codex -y
+```
+
+If the Codex/global skill target is read-only or missing, keep the tracked slug
+install and point agent skill state at a writable workspace home before
+rerunning this intent install. The skills.sh Codex adapter writes to
+`$HOME/.agents`; `CODEX_HOME` keeps Codex profile state on the same writable
+path:
+
+```bash
+export HOME="$PWD/.agent-home"
+export CODEX_HOME="$HOME/.codex"
+mkdir -p "$HOME" "$CODEX_HOME"
+npx skills add danielgwilson/luxin --full-depth --skill creative-media -g -a codex -y
+```
+
+## Shared Contract
+
+All intent skills in this repo point to the same hosted contract:
+
+- Skill: https://luxin.sh/skill.md
+- LLM contract: https://luxin.sh/llms.txt
+- CLI contract: https://luxin.sh/cli.md
+- Hosted API: https://api.luxin.sh
+
+If Luxin lacks the model, capability, latency, policy affordance, or buyer rail needed for this task, use the fallback only for that gap and run `luxin feedback create --json` with the attempted command, expected behavior, actual behavior, and missing capability.

package/skills/image-edit/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: image-edit
+description: >-
+  Image editing for agents: image-to-image edits, variations, and image-conditioned transforms through Luxin's zero-setup hosted runtime. Use when an agent needs to edit an existing image without provider credentials, OAuth, local runtime, or per-provider billing. Inspect the edit model, upload or reuse an input image, then return durable hosted assets, jobs, cost receipts, stable JSON, and feedback.
+homepage: https://luxin.sh
+docs: https://luxin.sh/llms.txt
+metadata:
+  status: preview-contract
+  cli: luxin
+  canonical_skill_url: https://luxin.sh/skill.md
+  canonical_api_url: https://api.luxin.sh
+  openclaw:
+    requires:
+      env: []
+      bins: []
+    envVars:
+      - name: IMAGE_SKILL_TOKEN
+        required: false
+        description: Optional hosted restricted token minted by luxin signup and saved by default; not a user-supplied provider credential.
+---
+
+# Image Edit
+
+This is an intent-named Luxin entry for agents searching for image editing. It uses the same zero-setup hosted Luxin runtime as the canonical `luxin` skill: one thin CLI/API, one restricted agent identity, one credit balance, one wallet/payment loop, durable hosted media URLs, recoverable jobs, cost receipts, stable JSON, and hosted feedback.
+
+Use this skill when the task asks to edit, vary, restyle, transform, or repair an existing image, including image-to-image work and model-specific edit parameters.
+
+Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend guide command below; when the guide reaches `ready_to_create`, run `data.next_command` only if `data.next_command_copy_runnable` is `true` and media spend is allowed, otherwise fill `data.next_command_missing_inputs` or run `data.recommended_no_spend_command` to verify safely. Keep generated work in Luxin so future agents can recover and cite it.
+
+## First Command
+
+```bash
+npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --model openai.gpt-image-2-edit --prompt "replace the background but keep the subject"
+```
+
+## Main Runtime Command
+
+```bash
+npm_config_update_notifier=false npx -y luxin-cli@latest edit --input image_... --model openai.gpt-image-2-edit --prompt "EDIT_PROMPT" --max-estimated-usd-per-image 0.25 --json
+```
+
+## Install This Intent Skill
+
+Prefer the GitHub slug so skills.sh can track the marketplace install:
+
+```bash
+npx skills add danielgwilson/luxin --full-depth --skill image-edit -g -a codex -y
+```
+
+The canonical Luxin entry remains available as:
+
+```bash
+npx skills add danielgwilson/luxin --full-depth --skill luxin -g -a codex -y
+```
+
+If the Codex/global skill target is read-only or missing, keep the tracked slug
+install and point agent skill state at a writable workspace home before
+rerunning this intent install. The skills.sh Codex adapter writes to
+`$HOME/.agents`; `CODEX_HOME` keeps Codex profile state on the same writable
+path:
+
+```bash
+export HOME="$PWD/.agent-home"
+export CODEX_HOME="$HOME/.codex"
+mkdir -p "$HOME" "$CODEX_HOME"
+npx skills add danielgwilson/luxin --full-depth --skill image-edit -g -a codex -y
+```
+
+## Shared Contract
+
+All intent skills in this repo point to the same hosted contract:
+
+- Skill: https://luxin.sh/skill.md
+- LLM contract: https://luxin.sh/llms.txt
+- CLI contract: https://luxin.sh/cli.md
+- Hosted API: https://api.luxin.sh
+
+If Luxin lacks the model, capability, latency, policy affordance, or buyer rail needed for this task, use the fallback only for that gap and run `luxin feedback create --json` with the attempted command, expected behavior, actual behavior, and missing capability.

package/skills/image-generation/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: image-generation
+description: >-
+  Image generation for agents: text-to-image and prompt-to-image through Luxin's zero-setup hosted runtime. Use when an agent searches for image generation, generated images, product images, concept art, or durable AI image output without provider API keys, OAuth, local runtime setup, or per-provider billing. Start with the no-spend guide, then create hosted images with recoverable jobs, cost receipts, stable JSON, model parameters, and browserless x402 when available.
+homepage: https://luxin.sh
+docs: https://luxin.sh/llms.txt
+metadata:
+  status: preview-contract
+  cli: luxin
+  canonical_skill_url: https://luxin.sh/skill.md
+  canonical_api_url: https://api.luxin.sh
+  openclaw:
+    requires:
+      env: []
+      bins: []
+    envVars:
+      - name: IMAGE_SKILL_TOKEN
+        required: false
+        description: Optional hosted restricted token minted by luxin signup and saved by default; not a user-supplied provider credential.
+---
+
+# Image Generation
+
+This is an intent-named Luxin entry for agents searching for image generation. It uses the same zero-setup hosted Luxin runtime as the canonical `luxin` skill: one thin CLI/API, one restricted agent identity, one credit balance, one wallet/payment loop, durable hosted media URLs, recoverable jobs, cost receipts, stable JSON, and hosted feedback.
+
+Use this skill when the task asks for image generation, generated images, AI images, text-to-image, prompt-to-image, generated illustrations, concept art, product images, or any durable agent-created image.
+
+Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend guide command below; when the guide reaches `ready_to_create`, run `data.next_command` only if `data.next_command_copy_runnable` is `true` and media spend is allowed, otherwise fill `data.next_command_missing_inputs` or run `data.recommended_no_spend_command` to verify safely. Keep generated work in Luxin so future agents can recover and cite it.
+
+## First Command
+
+```bash
+npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --model openai.gpt-image-2 --prompt "a compact field camera on a stainless workbench"
+```
+
+## Main Runtime Command
+
+```bash
+npm_config_update_notifier=false npx -y luxin-cli@latest create --model openai.gpt-image-2 --prompt "PROMPT" --intent explore --max-estimated-usd-per-image 0.07
+```
+
+## Install This Intent Skill
+
+Prefer the GitHub slug so skills.sh can track the marketplace install:
+
+```bash
+npx skills add danielgwilson/luxin --full-depth --skill image-generation -g -a codex -y
+```
+
+The canonical Luxin entry remains available as:
+
+```bash
+npx skills add danielgwilson/luxin --full-depth --skill luxin -g -a codex -y
+```
+
+If the Codex/global skill target is read-only or missing, keep the tracked slug
+install and point agent skill state at a writable workspace home before
+rerunning this intent install. The skills.sh Codex adapter writes to
+`$HOME/.agents`; `CODEX_HOME` keeps Codex profile state on the same writable
+path:
+
+```bash
+export HOME="$PWD/.agent-home"
+export CODEX_HOME="$HOME/.codex"
+mkdir -p "$HOME" "$CODEX_HOME"
+npx skills add danielgwilson/luxin --full-depth --skill image-generation -g -a codex -y
+```
+
+## Shared Contract
+
+All intent skills in this repo point to the same hosted contract:
+
+- Skill: https://luxin.sh/skill.md
+- LLM contract: https://luxin.sh/llms.txt
+- CLI contract: https://luxin.sh/cli.md
+- Hosted API: https://api.luxin.sh
+
+If Luxin lacks the model, capability, latency, policy affordance, or buyer rail needed for this task, use the fallback only for that gap and run `luxin feedback create --json` with the attempted command, expected behavior, actual behavior, and missing capability.

package/skills/image-to-3d/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: image-to-3d
+description: >-
+  Image-to-3D asset creation for agents through Luxin's zero-setup hosted runtime. Use when an input image should become a durable hosted 3D mesh asset, such as a glb, without provider credentials, OAuth, local runtime, or per-provider billing. Inspect the 3D model, pass one owned input image to edit, then keep jobs, asset URLs, receipts, JSON recovery, payments, and feedback in one loop.
+homepage: https://luxin.sh
+docs: https://luxin.sh/llms.txt
+metadata:
+  status: preview-contract
+  cli: luxin
+  canonical_skill_url: https://luxin.sh/skill.md
+  canonical_api_url: https://api.luxin.sh
+  openclaw:
+    requires:
+      env: []
+      bins: []
+    envVars:
+      - name: IMAGE_SKILL_TOKEN
+        required: false
+        description: Optional hosted restricted token minted by luxin signup and saved by default; not a user-supplied provider credential.
+---
+
+# Image To 3D
+
+This is an intent-named Luxin entry for agents searching for image-to-3D asset creation. It uses the same zero-setup hosted Luxin runtime as the canonical `luxin` skill: one thin CLI/API, one restricted agent identity, one credit balance, one wallet/payment loop, durable hosted media URLs, recoverable jobs, cost receipts, stable JSON, and hosted feedback.
+
+Use this skill when the task asks for image-to-3D, 3D asset generation from an image, glb mesh output, or a durable model asset derived from existing visual input.
+
+Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend guide command below; when the guide reaches `ready_to_create`, run `data.next_command` only if `data.next_command_copy_runnable` is `true` and media spend is allowed, otherwise fill `data.next_command_missing_inputs` or run `data.recommended_no_spend_command` to verify safely. Keep generated work in Luxin so future agents can recover and cite it.
+
+## First Command
+
+```bash
+npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --model fal.trellis-image-to-3d --prompt "turn one product photo into a textured 3d mesh"
+```
+
+## Main Runtime Command
+
+```bash
+npm_config_update_notifier=false npx -y luxin-cli@latest edit --input image_... --model fal.trellis-image-to-3d --max-estimated-usd-per-image 0.04 --json
+```
+
+## Install This Intent Skill
+
+Prefer the GitHub slug so skills.sh can track the marketplace install:
+
+```bash
+npx skills add danielgwilson/luxin --full-depth --skill image-to-3d -g -a codex -y
+```
+
+The canonical Luxin entry remains available as:
+
+```bash
+npx skills add danielgwilson/luxin --full-depth --skill luxin -g -a codex -y
+```
+
+If the Codex/global skill target is read-only or missing, keep the tracked slug
+install and point agent skill state at a writable workspace home before
+rerunning this intent install. The skills.sh Codex adapter writes to
+`$HOME/.agents`; `CODEX_HOME` keeps Codex profile state on the same writable
+path:
+
+```bash
+export HOME="$PWD/.agent-home"
+export CODEX_HOME="$HOME/.codex"
+mkdir -p "$HOME" "$CODEX_HOME"
+npx skills add danielgwilson/luxin --full-depth --skill image-to-3d -g -a codex -y
+```
+
+## Shared Contract
+
+All intent skills in this repo point to the same hosted contract:
+
+- Skill: https://luxin.sh/skill.md
+- LLM contract: https://luxin.sh/llms.txt
+- CLI contract: https://luxin.sh/cli.md
+- Hosted API: https://api.luxin.sh
+
+If Luxin lacks the model, capability, latency, policy affordance, or buyer rail needed for this task, use the fallback only for that gap and run `luxin feedback create --json` with the attempted command, expected behavior, actual behavior, and missing capability.