Skip to content

armgit / kiln

Public Imported from GitHub
0

Build and revise procedural 3D assets with your coding agent. Local MCP server, CLI and TypeScript engine with rendered review, editable source and GLB export.

docs: document Studio developer boundary

Matt Kissinger5a00f2f58b02
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 06732c8b..92e9d0e3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,11 @@ for the consuming app's lockfile + tarball provenance, not public npm releases.
## [Unreleased]
+### Documentation
+- Clarified that `@kiln/engine` remains private execution infrastructure. External developer access
+ is mediated by Studio `/v1`, private SDK/skills, and future AgentCore Gateway product tools rather
+ than direct engine, raw Forge, or composer harness exposure.
+
### Added — scene composer (`@kiln/engine/composer`, `/composer/agent`)
A THREE-free scene-composition surface: a `PlacementModel` single-source-of-truth with a
small scene DSL (`scene()`/`asset()`), terrain-agnostic hierarchy-aware layout, an overlap
diff --git a/README.md b/README.md
index d35505cf..62048fe9 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,21 @@ pipeline** — just the text-to-GLB engine Kiln Studio runs in production.
> for local dev, CI, and both Docker images — NOT a path-link (`file:../kiln` hits a Windows
> `EPERM` copying native deps). See `../plan/`.
+## External Access Boundary
+
+Do not expose this engine package, its raw tool surface, or its composer harness directly to external
+users. The approved private developer interface lives in the sibling `kiln-studio` repo:
+
+- Studio `/v1` is the product contract for REST, SDK, and future AgentCore Gateway MCP tools.
+- Studio owns `DeveloperClient` auth, scopes, quotas, audit, S3/Dynamo ownership, and artifact URLs.
+- The generation AgentCore Runtime and this engine stay private execution infrastructure.
+- Product-level tools may expose asset/pack/scene planning, validation, generation, composition, and
+ downloads, but not raw `kiln_render`, `kiln_screenshot`, `scene_place`, `scene_render`,
+ `scene_finalize`, transcripts, storage keys, or provider keys.
+
+For current access and distribution decisions, see
+`../kiln-studio/docs/launch/11-private-developer-platform-prod-handoff.md`.
+
## Install
```bash