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.
JavaScript 3d3d-assets3d-modelingagent-skillsagent-toolsai-agentsasset-pipelinecligame-assetsglbgltfmcpmcp-servermodel-context-protocolprocedural-generationprocedural-modelingtext-to-3dthreejstypescript
docs(site): document the tool surface and where it lives
Matt Kissinger41a7d9f3fcd9
diff --git a/site/src/Home.tsx b/site/src/Home.tsxindex 4fc43db2..23644c75 100644--- a/site/src/Home.tsx+++ b/site/src/Home.tsx@@ -5,6 +5,42 @@ import type { Specimen } from './types';const DOCS = `${REPO}/blob/main`;+/**+ * The seven tools the MCP server actually lists, in the order it lists them,+ * with the one-line version of what each is for. Anyone comparing this against+ * `tools/list` should find the same names in the same order.+ */+const TOOLS = [+ {+ name: 'kiln_list_primitives',+ line: 'Lists what the sandbox gives you: geometry helpers, materials, structure, animation, CSG, arrays, UV and textures, with exact signatures. A model calls this before writing anything, which is why it can work with no engine source in front of it.',+ },+ {+ name: 'kiln_validate',+ line: 'Static checks on a program before it runs. Missing meta or build(), keyframe typos, infinite loops, recursive build() calls, syntax errors. Cheap enough to run on every draft. There is no triangle budget and density is never warned about.',+ },+ {+ name: 'kiln_render',+ line: 'Runs the program, builds the GLB in memory, and returns the six-view contact sheet as an image along with triangle count, mesh and material counts, the bounding box, which part sits lowest, and any structural warnings. This is the tool that lets the model see.',+ },+ {+ name: 'kiln_screenshot_animation',+ line: 'Renders one named clip as six frames sampled across it, each labelled with its phase. Motion is the thing a still cannot show, so a rig that looks right and moves wrong is only catchable here.',+ },+ {+ name: 'kiln_view_interior',+ line: 'For anything you can walk into. Renders it with the roof lifted off as a floor plan plus two cutaways, so an interior that turned out solid is visible instead of hidden behind its own walls.',+ },+ {+ name: 'kiln_inspect',+ line: 'A close-up of one named part from any angle. The contact sheet is where you notice something is wrong, and this is where you find out what.',+ },+ {+ name: 'kiln_edit',+ line: 'Exact-string patches applied to an existing program, rendered in the same call. This is the refine verb, and the reason a second pass is a diff rather than a regeneration.',+ },+] as const;+/*** The exact configs from docs/install.md. They live here as data rather than as* prose so the tab switcher can render them uniformly, and every one of them is@@ -149,6 +185,31 @@ bun run kiln render examples/crate.kiln.js \\</p></section>+ <section className="band">+ <h2>The tools</h2>+ <p>+ Seven of them, and the whole surface is here. Four exist so the model can look at what it+ built, which is the part most asset pipelines leave out.+ </p>+ <dl className="tools">+ {TOOLS.map((t) => (+ <div key={t.name}>+ <dt>{t.name}</dt>+ <dd>{t.line}</dd>+ </div>+ ))}+ </dl>+ <p>+ All seven are defined once, in <a href={`${DOCS}/src/tools/registry.ts`}>one registry</a>,+ and reach you three ways. As an <b>MCP server</b> over stdio, which is what the configs+ below set up. As a <b>CLI</b>, where <code>kiln render</code> and{' '}+ <code>kiln generate</code> cover the offline path and a full authoring run. Or{' '}+ <b>in process</b>, by importing <code>kiln/tools</code> and mapping four fields per tool,+ if your harness is TypeScript and you would rather skip the transport. Nothing is+ reimplemented per transport, and a parity test fails the build if they drift.+ </p>+ </section>+<section className="band"><h2>Wire it into your agent</h2><p>diff --git a/site/src/styles.css b/site/src/styles.cssindex 1c3848dc..f8bdde5f 100644--- a/site/src/styles.css+++ b/site/src/styles.css@@ -788,6 +788,38 @@ button {text-overflow: ellipsis;}+/* ------------------------------------------------------------------ tools */++/*+ * A definition list, not cards. Seven tools with a sentence each is reference+ * material: the reader is scanning for the one that does the thing they want,+ * and a grid of boxes makes that scan slower, not faster.+ */+.tools {+ margin: 0 0 22px;+ border-top: 1px solid var(--rule);+}++.tools > div {+ display: grid;+ grid-template-columns: 13rem 1fr;+ gap: 0 20px;+ padding: 13px 0;+ border-bottom: 1px solid var(--rule);+}++.tools dt {+ font-family: var(--mono);+ font-size: 12.5px;+ color: var(--flame);+}++.tools dd {+ margin: 0;+ color: var(--dim);+ text-wrap: pretty;+}+/* --------------------------------------------------------------- repo map */.map {@@ -839,6 +871,12 @@ button {grid-template-columns: repeat(2, 1fr);}+ /* The tool name stops being a column and becomes a heading over its line. */+ .tools > div {+ grid-template-columns: 1fr;+ gap: 4px;+ }+.masthead {gap: 18px;padding: 24px 18px 20px;