layer 1.0.4__tar.gz → 1.0.6__tar.gz

{layer-1.0.4 → layer-1.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: layer
-Version: 1.0.4
+Version: 1.0.6
 Summary: Command-line interface for Layer — AI asset generation for game studios.
 Keywords: layer,ai,generative,game-development,cli
 Author: Layer
@@ -28,15 +28,18 @@ Description-Content-Type: text/markdown
 
 Command-line interface for [Layer](https://layer.ai) — AI asset generation for game studios.
 
-> **Pre-release.** This is an early build of the rewritten CLI. Asset generation is
-> landing next; today it covers signing in and choosing a workspace.
+Reaches the same models, workspaces, and Creative Unit balance as the app, from a
+terminal, a Makefile, or a CI job.
 
 ## Install
 
 ```sh
-uv tool install --prerelease=allow layer     # or: pipx install --pip-args=--pre layer
+uv tool install layer        # or: pipx install layer
 ```
 
+Python 3.10 and up — deliberately older than the services that build it, so the same
+package imports inside Blender, Maya, and Houdini.
+
 Working on the CLI itself? Install it from your checkout instead, so the `layer`
 command follows the branch you have out:
 
@@ -56,6 +59,36 @@ layer use my-studio
 For CI and other unattended runs, set `LAYER_API_KEY` to a personal access token instead
 of signing in.
 
+## Generate
+
+```sh
+layer generate image -p "a crystal sword icon, transparent background"
+layer generate video -d 5 --aspect-ratio 16:9 -p "camera pushes through the gate"
+layer generate mesh  -p "weathered treasure chest, game-ready"
+layer generate audio -p "arcade coin pickup"
+```
+
+Each waits for the run, prints what it cost, and writes the result into the working
+directory under a name derived from the prompt — never overwriting a file already there.
+`-o` takes a directory, or the exact filename when there is a single output;
+`--no-download` prints URLs instead.
+
+Leave `--base-model` off and the recommended model for that modality is chosen and
+named. The catalogue is read from your workspace, not shipped with the package:
+
+```sh
+layer base-models list --modality video
+layer base-models show bfl-flux-2-pro      # the keys --param accepts
+```
+
+Every run is priced before it executes. `--confirm` asks first; `--max-cost 8` refuses
+anything more expensive. For a long render, submit and collect later:
+
+```sh
+id=$(layer --json generate video --no-wait -p "..." | jq -r .inference_id)
+layer generate status "$id" --wait
+```
+
 ## Where settings come from
 
 Highest wins:
@@ -81,15 +114,21 @@ go to stderr, so a pipeline never has to filter them out.
 
 ```sh
 layer --json whoami | jq -r .workspace
+layer --json generate image -p "..." | jq -r '.files[].path'
 ```
 
 Exit codes: `0` ok, `1` error, `2` usage, `3` auth, `4` insufficient balance,
-`5` invalid input, `6` content policy, `7` timeout.
+`5` invalid input, `6` content policy, `7` timeout. They may gain members, never change
+meaning, so a caller can branch on them without parsing prose.
 
 ## Documentation
 
 <https://www.layer.ai/docs/cli>
 
+Driving Layer from an agent rather than a shell? There is an
+[MCP server](https://www.layer.ai/mcp) and an
+[Agent Skills pack](https://www.layer.ai/skills).
+
 ## Licence
 
 Apache-2.0

layer-1.0.6/README.md

@@ -0,0 +1,108 @@
+# layer
+
+Command-line interface for [Layer](https://layer.ai) — AI asset generation for game studios.
+
+Reaches the same models, workspaces, and Creative Unit balance as the app, from a
+terminal, a Makefile, or a CI job.
+
+## Install
+
+```sh
+uv tool install layer        # or: pipx install layer
+```
+
+Python 3.10 and up — deliberately older than the services that build it, so the same
+package imports inside Blender, Maya, and Houdini.
+
+Working on the CLI itself? Install it from your checkout instead, so the `layer`
+command follows the branch you have out:
+
+```sh
+task -d apps/cli-py install-cli
+```
+
+## Sign in
+
+```sh
+layer login                 # opens a browser
+layer login --device        # for SSH sessions and containers
+layer whoami
+layer use my-studio
+```
+
+For CI and other unattended runs, set `LAYER_API_KEY` to a personal access token instead
+of signing in.
+
+## Generate
+
+```sh
+layer generate image -p "a crystal sword icon, transparent background"
+layer generate video -d 5 --aspect-ratio 16:9 -p "camera pushes through the gate"
+layer generate mesh  -p "weathered treasure chest, game-ready"
+layer generate audio -p "arcade coin pickup"
+```
+
+Each waits for the run, prints what it cost, and writes the result into the working
+directory under a name derived from the prompt — never overwriting a file already there.
+`-o` takes a directory, or the exact filename when there is a single output;
+`--no-download` prints URLs instead.
+
+Leave `--base-model` off and the recommended model for that modality is chosen and
+named. The catalogue is read from your workspace, not shipped with the package:
+
+```sh
+layer base-models list --modality video
+layer base-models show bfl-flux-2-pro      # the keys --param accepts
+```
+
+Every run is priced before it executes. `--confirm` asks first; `--max-cost 8` refuses
+anything more expensive. For a long render, submit and collect later:
+
+```sh
+id=$(layer --json generate video --no-wait -p "..." | jq -r .inference_id)
+layer generate status "$id" --wait
+```
+
+## Where settings come from
+
+Highest wins:
+
+1. a command-line flag
+2. an environment variable — `LAYER_PROFILE`, `LAYER_WORKSPACE`, `LAYER_PROJECT`,
+   `LAYER_API_URL`, `LAYER_API_KEY`
+3. `layer.toml`, found by walking up from the working directory
+4. the active profile in `~/.layer/config.toml`
+
+Committing a `layer.toml` pins a checkout to its workspace, so two repos open in two
+terminals cannot generate into each other's:
+
+```toml
+workspace = "my-studio"
+project   = "season-12-art"
+```
+
+## Scripting
+
+`--json` puts the result on stdout and nothing else — progress, warnings, and errors all
+go to stderr, so a pipeline never has to filter them out.
+
+```sh
+layer --json whoami | jq -r .workspace
+layer --json generate image -p "..." | jq -r '.files[].path'
+```
+
+Exit codes: `0` ok, `1` error, `2` usage, `3` auth, `4` insufficient balance,
+`5` invalid input, `6` content policy, `7` timeout. They may gain members, never change
+meaning, so a caller can branch on them without parsing prose.
+
+## Documentation
+
+<https://www.layer.ai/docs/cli>
+
+Driving Layer from an agent rather than a shell? There is an
+[MCP server](https://www.layer.ai/mcp) and an
+[Agent Skills pack](https://www.layer.ai/skills).
+
+## Licence
+
+Apache-2.0

{layer-1.0.4 → layer-1.0.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "layer"
-version = "1.0.4"
+version = "1.0.6"
 description = "Command-line interface for Layer — AI asset generation for game studios."
 readme = "README.md"
 license = "Apache-2.0"

{layer-1.0.4 → layer-1.0.6}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "layer"
-version = "1.0.4"
+version = "1.0.6"
 description = "Command-line interface for Layer — AI asset generation for game studios."
 readme = "README.md"
 authors = [{ name = "Layer", email = "info@layer.ai" }]

{layer-1.0.4 → layer-1.0.6}/src/layer/_api/models.py

@@ -29,6 +29,22 @@ class AddProjectMembersBody(BaseModel):
     )
 
 
+class AudioOutputFormat(Enum):
+    """
+    Container for a delivered audio file.
+
+    Providers name these their own way and Layer never re-encodes what one returns, so the
+    format a caller asks for is only keepable on models whose capabilities list it. Members are
+    named for their wire value: the frontend artifacts preserve enum *names*, and a name that
+    differed from the value would hand clients a format string the request API rejects.
+    """
+
+    mp3 = "mp3"
+    wav = "wav"
+    aac = "aac"
+    flac = "flac"
+
+
 class BlueprintRunStatus(Enum):
     """
     Enum representing the status of a blueprint run.
@@ -1495,6 +1511,48 @@ class BaseModelCapabilitiesREST(BaseModel):
     generate_parts: bool | None = Field(False, title="Generate Parts")
     text_to_speech: bool | None = Field(False, title="Text To Speech")
     sound_effect: bool | None = Field(False, title="Sound Effect")
+    music: bool | None = Field(
+        False,
+        description="Composes music. Distinguishes a music model from a sound-effect model, which the modality and the duration range alone do not.",
+        title="Music",
+    )
+    lyrics: bool | None = Field(
+        False,
+        description="Takes sung words in a dedicated lyrics input, separate from the text prompt. This describes the input shape, not whether the model can sing: some families read lyrics written into the prompt instead, so a false value is not a reason to rule a model out for a song.",
+        title="Lyrics",
+    )
+    auto_duration: bool | None = Field(
+        False,
+        description="The model sets the output length itself, from the text or the input file. It has no duration control, so duration_seconds is ignored: do not promise a requested length.",
+        title="Auto Duration",
+    )
+    instrumental: bool | None = Field(
+        False,
+        description="Takes a flag that guarantees no vocals. On other music models, asking for an instrumental in the prompt is only a suggestion.",
+        title="Instrumental",
+    )
+    loop: bool | None = Field(
+        False,
+        description="Composes the clip to repeat with no audible seam when the `loop` parameter is set.",
+        title="Loop",
+    )
+    audio_inpaint: bool | None = Field(False, title="Audio Inpaint")
+    audio_outpaint: bool | None = Field(False, title="Audio Outpaint")
+    audio_segments: bool | None = Field(
+        False,
+        description="Scores a video stretch by stretch from a contiguous list of per-stretch briefs.",
+        title="Audio Segments",
+    )
+    output_formats: list[str] | None = Field(
+        None,
+        description="Containers this model can be asked to deliver. Layer never re-encodes a clip, so an empty list means the model returns what it returns and the format cannot be promised.",
+        title="Output Formats",
+    )
+    voice_reference_set_required: bool | None = Field(
+        False,
+        description="Speaks only in a trained voice, so a generation needs a reference set holding one. Without it the provider falls back to its own default voice.",
+        title="Voice Reference Set Required",
+    )
     camera_transform: bool | None = Field(False, title="Camera Transform")
     voice_changer: bool | None = Field(False, title="Voice Changer")
     audio_isolation: bool | None = Field(False, title="Audio Isolation")
@@ -2179,6 +2237,25 @@ class EstimateInferencePriceRequest(BaseModel):
     )
     generate_audio: bool | None = Field(None, description="Generate audio with video.", title="Generate Audio")
     keep_audio: bool | None = Field(None, description="Keep audio from input video.", title="Keep Audio")
+    instrumental: bool | None = Field(
+        None,
+        description="Guarantee a track with no vocals, on models whose capabilities report instrumental. Asking for one in the prompt is only a suggestion.",
+        title="Instrumental",
+    )
+    loop: bool | None = Field(
+        None,
+        description="Compose the clip to repeat with no audible seam, on models whose capabilities report loop.",
+        title="Loop",
+    )
+    output_format: AudioOutputFormat | None = Field(
+        None,
+        description="Container for the delivered file, one of the values the model's capabilities list under output_formats. Layer never re-encodes a clip, so a model that lists none delivers what it delivers.",
+    )
+    lyrics: str | None = Field(
+        None,
+        description="Words to be sung, for models whose capabilities report lyrics. A separate input from the prompt, which describes the music itself.",
+        title="Lyrics",
+    )
     fps: Fps | None = Field(None, description="FPS for LTX video generation (e.g. 25 or 50).", title="Fps")
     video_effects: list[ForgeVideoEffectInput] | None = Field(
         [], description="Video effects to apply.", title="Video Effects"
@@ -2287,6 +2364,25 @@ class EstimateInferencePriceV2Request(BaseModel):
     )
     generate_audio: bool | None = Field(None, description="Generate audio with video.", title="Generate Audio")
     keep_audio: bool | None = Field(None, description="Keep audio from input video.", title="Keep Audio")
+    instrumental: bool | None = Field(
+        None,
+        description="Guarantee a track with no vocals, on models whose capabilities report instrumental. Asking for one in the prompt is only a suggestion.",
+        title="Instrumental",
+    )
+    loop: bool | None = Field(
+        None,
+        description="Compose the clip to repeat with no audible seam, on models whose capabilities report loop.",
+        title="Loop",
+    )
+    output_format: AudioOutputFormat | None = Field(
+        None,
+        description="Container for the delivered file, one of the values the model's capabilities list under output_formats. Layer never re-encodes a clip, so a model that lists none delivers what it delivers.",
+    )
+    lyrics: str | None = Field(
+        None,
+        description="Words to be sung, for models whose capabilities report lyrics. A separate input from the prompt, which describes the music itself.",
+        title="Lyrics",
+    )
     fps: Fps | None = Field(None, description="FPS for LTX video generation (e.g. 25 or 50).", title="Fps")
     video_effects: list[ForgeVideoEffectInput] | None = Field(
         [], description="Video effects to apply.", title="Video Effects"
@@ -2389,6 +2485,25 @@ class ExecuteInferenceRequest(BaseModel):
     )
     generate_audio: bool | None = Field(None, description="Generate audio with video.", title="Generate Audio")
     keep_audio: bool | None = Field(None, description="Keep audio from input video.", title="Keep Audio")
+    instrumental: bool | None = Field(
+        None,
+        description="Guarantee a track with no vocals, on models whose capabilities report instrumental. Asking for one in the prompt is only a suggestion.",
+        title="Instrumental",
+    )
+    loop: bool | None = Field(
+        None,
+        description="Compose the clip to repeat with no audible seam, on models whose capabilities report loop.",
+        title="Loop",
+    )
+    output_format: AudioOutputFormat | None = Field(
+        None,
+        description="Container for the delivered file, one of the values the model's capabilities list under output_formats. Layer never re-encodes a clip, so a model that lists none delivers what it delivers.",
+    )
+    lyrics: str | None = Field(
+        None,
+        description="Words to be sung, for models whose capabilities report lyrics. A separate input from the prompt, which describes the music itself.",
+        title="Lyrics",
+    )
     fps: Fps | None = Field(None, description="FPS for LTX video generation (e.g. 25 or 50).", title="Fps")
     video_effects: list[ForgeVideoEffectInput] | None = Field(
         [], description="Video effects to apply.", title="Video Effects"
@@ -2506,6 +2621,25 @@ class ExecuteInferenceV2Request(BaseModel):
     )
     generate_audio: bool | None = Field(None, description="Generate audio with video.", title="Generate Audio")
     keep_audio: bool | None = Field(None, description="Keep audio from input video.", title="Keep Audio")
+    instrumental: bool | None = Field(
+        None,
+        description="Guarantee a track with no vocals, on models whose capabilities report instrumental. Asking for one in the prompt is only a suggestion.",
+        title="Instrumental",
+    )
+    loop: bool | None = Field(
+        None,
+        description="Compose the clip to repeat with no audible seam, on models whose capabilities report loop.",
+        title="Loop",
+    )
+    output_format: AudioOutputFormat | None = Field(
+        None,
+        description="Container for the delivered file, one of the values the model's capabilities list under output_formats. Layer never re-encodes a clip, so a model that lists none delivers what it delivers.",
+    )
+    lyrics: str | None = Field(
+        None,
+        description="Words to be sung, for models whose capabilities report lyrics. A separate input from the prompt, which describes the music itself.",
+        title="Lyrics",
+    )
     fps: Fps | None = Field(None, description="FPS for LTX video generation (e.g. 25 or 50).", title="Fps")
     video_effects: list[ForgeVideoEffectInput] | None = Field(
         [], description="Video effects to apply.", title="Video Effects"

layer-1.0.4/README.md

@@ -1,69 +0,0 @@
-# layer
-
-Command-line interface for [Layer](https://layer.ai) — AI asset generation for game studios.
-
-> **Pre-release.** This is an early build of the rewritten CLI. Asset generation is
-> landing next; today it covers signing in and choosing a workspace.
-
-## Install
-
-```sh
-uv tool install --prerelease=allow layer     # or: pipx install --pip-args=--pre layer
-```
-
-Working on the CLI itself? Install it from your checkout instead, so the `layer`
-command follows the branch you have out:
-
-```sh
-task -d apps/cli-py install-cli
-```
-
-## Sign in
-
-```sh
-layer login                 # opens a browser
-layer login --device        # for SSH sessions and containers
-layer whoami
-layer use my-studio
-```
-
-For CI and other unattended runs, set `LAYER_API_KEY` to a personal access token instead
-of signing in.
-
-## Where settings come from
-
-Highest wins:
-
-1. a command-line flag
-2. an environment variable — `LAYER_PROFILE`, `LAYER_WORKSPACE`, `LAYER_PROJECT`,
-   `LAYER_API_URL`, `LAYER_API_KEY`
-3. `layer.toml`, found by walking up from the working directory
-4. the active profile in `~/.layer/config.toml`
-
-Committing a `layer.toml` pins a checkout to its workspace, so two repos open in two
-terminals cannot generate into each other's:
-
-```toml
-workspace = "my-studio"
-project   = "season-12-art"
-```
-
-## Scripting
-
-`--json` puts the result on stdout and nothing else — progress, warnings, and errors all
-go to stderr, so a pipeline never has to filter them out.
-
-```sh
-layer --json whoami | jq -r .workspace
-```
-
-Exit codes: `0` ok, `1` error, `2` usage, `3` auth, `4` insufficient balance,
-`5` invalid input, `6` content policy, `7` timeout.
-
-## Documentation
-
-<https://www.layer.ai/docs/cli>
-
-## Licence
-
-Apache-2.0