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
feat(core): kiln.generate() public entry + types
Matt Kissingere159f5c85e65
diff --git a/index.ts b/index.tsnew file mode 100644index 00000000..9c4b5e61--- /dev/null+++ b/index.ts@@ -0,0 +1,100 @@+/**+ * @pixel-forge/core - Kiln public API+ *+ * Headless Kiln pipeline: prompt -> Claude -> code -> GLB Buffer.+ *+ * This is the W1.1 spike surface. W2 will migrate the server and client to+ * consume these entry points (replacing the duplicate copies currently+ * living in packages/{client,shared,server}).+ */++import type { KilnCodeMeta } from './render';+import { renderGLB } from './render';+import { generateKilnCode } from './generate';++export { renderGLB } from './render';+export { generateKilnCode } from './generate';+export { validate, validateKilnCode } from './validation';+export {+ buildUserPrompt,+ getSystemPrompt,+ STYLE_TEMPLATES,+ KILN_SYSTEM_PROMPT,+ type KilnGenerateRequest,+ type RenderMode,+ type AssetCategory,+ type AssetStyle,+ type AssetBudget,+} from './prompt';+export type { KilnCodeMeta, RenderResult, ExecutedKilnCode } from './render';+export type { KilnGenerateResult } from './generate';+export { executeKilnCode } from './render';+export {+ buildSandboxGlobals,+ countTriangles,+ countMaterials,+ getJointNames,+} from './primitives';++// =============================================================================+// Top-level `generate()` - the full pipeline: prompt -> code -> GLB+// =============================================================================++export interface KilnGenerateOptions {+ /** Spike supports glb only. Ignored if set otherwise. */+ mode?: 'glb';+ category?: 'character' | 'prop' | 'vfx' | 'environment';+ style?: 'low-poly' | 'stylized' | 'voxel' | 'detailed' | 'realistic';+ referenceImageUrl?: string;+ /**+ * Whether to ask the LLM to emit an animate() function. Defaults to true to+ * match the server's behavior.+ */+ includeAnimation?: boolean;+}++export interface KilnGenerateOutput {+ /** The JS code the LLM produced. */+ code: string;+ /** Rendered GLB, ready to write to disk. */+ glb: Buffer;+ /** Extracted from the code's `const meta = {...}` block, plus `tris`. */+ meta: KilnCodeMeta;+ /** Non-fatal issues (e.g. animation target missing). */+ warnings: string[];+}++/**+ * End-to-end Kiln generation: call Claude, validate the code, render GLB.+ *+ * Throws on any hard failure (LLM error, invalid code, render failure).+ * Non-fatal issues surface via `warnings`.+ */+export async function generate(+ prompt: string,+ opts: KilnGenerateOptions = {}+): Promise<KilnGenerateOutput> {+ const category = opts.category ?? 'prop';++ const genResult = await generateKilnCode({+ prompt,+ mode: 'glb',+ category,+ style: opts.style,+ includeAnimation: opts.includeAnimation ?? true,+ referenceImageUrl: opts.referenceImageUrl,+ });++ if (!genResult.success || !genResult.code) {+ throw new Error(`Kiln code generation failed: ${genResult.error ?? 'unknown error'}`);+ }++ const render = await renderGLB(genResult.code);++ return {+ code: genResult.code,+ glb: render.glb,+ meta: render.meta,+ warnings: render.warnings,+ };+}