layer 1.0.5__tar.gz → 1.0.7__tar.gz

{layer-1.0.5 → layer-1.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: layer
-Version: 1.0.5
+Version: 1.0.7
 Summary: Command-line interface for Layer — AI asset generation for game studios.
 Keywords: layer,ai,generative,game-development,cli
 Author: Layer
@@ -20,7 +20,7 @@ Requires-Dist: tomli-w>=1.0.0,<2.0.0
 Requires-Dist: typer>=0.15.0,<1.0.0
 Requires-Python: >=3.10
 Project-URL: Homepage, https://layer.ai
-Project-URL: Documentation, https://www.layer.ai/docs/cli
+Project-URL: Documentation, https://layer.ai/docs/cli
 Project-URL: Changelog, https://github.com/layerai/app/releases
 Description-Content-Type: text/markdown
 
@@ -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,14 +114,20 @@ 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>
+<https://layer.ai/docs/cli>
+
+Driving Layer from an agent rather than a shell? There is an
+[MCP server](https://layer.ai/mcp) and an
+[Agent Skills pack](https://layer.ai/skills).
 
 ## Licence
 

layer-1.0.7/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://layer.ai/docs/cli>
+
+Driving Layer from an agent rather than a shell? There is an
+[MCP server](https://layer.ai/mcp) and an
+[Agent Skills pack](https://layer.ai/skills).
+
+## Licence
+
+Apache-2.0

{layer-1.0.5 → layer-1.0.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "layer"
-version = "1.0.5"
+version = "1.0.7"
 description = "Command-line interface for Layer — AI asset generation for game studios."
 readme = "README.md"
 license = "Apache-2.0"
@@ -35,7 +35,7 @@ email = "info@layer.ai"
 
 [project.urls]
 Homepage = "https://layer.ai"
-Documentation = "https://www.layer.ai/docs/cli"
+Documentation = "https://layer.ai/docs/cli"
 Changelog = "https://github.com/layerai/app/releases"
 
 [project.scripts]

{layer-1.0.5 → layer-1.0.7}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "layer"
-version = "1.0.5"
+version = "1.0.7"
 description = "Command-line interface for Layer — AI asset generation for game studios."
 readme = "README.md"
 authors = [{ name = "Layer", email = "info@layer.ai" }]
@@ -29,7 +29,7 @@ dependencies = [
 
 [project.urls]
 Homepage = "https://layer.ai"
-Documentation = "https://www.layer.ai/docs/cli"
+Documentation = "https://layer.ai/docs/cli"
 Changelog = "https://github.com/layerai/app/releases"
 
 [project.scripts]

{layer-1.0.5 → layer-1.0.7}/src/layer/__init__.py

@@ -1,7 +1,7 @@
 """Layer's command-line interface, and the client it is built on.
 
 The CLI is the product; this package is what it runs. The public surface here is small on
-purpose and grows as commands land — see https://www.layer.ai/docs/cli.
+purpose and grows as commands land — see https://layer.ai/docs/cli.
 """
 
 from importlib.metadata import version

{layer-1.0.5 → layer-1.0.7}/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.
@@ -1522,6 +1538,16 @@ class BaseModelCapabilitiesREST(BaseModel):
     )
     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.",
@@ -2221,6 +2247,10 @@ class EstimateInferencePriceRequest(BaseModel):
         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.",
@@ -2344,6 +2374,10 @@ class EstimateInferencePriceV2Request(BaseModel):
         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.",
@@ -2461,6 +2495,10 @@ class ExecuteInferenceRequest(BaseModel):
         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.",
@@ -2593,6 +2631,10 @@ class ExecuteInferenceV2Request(BaseModel):
         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.",

layer-1.0.5/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