@pinepaper.studio/mcp-server 1.6.28 → 1.6.29

package/dist/ontology/upstream-vocabulary.js

@@ -221,7 +221,7 @@ export const UPSTREAM_TYPES = Object.freeze({
     },
     "pp:Character": {
         "anchor": "wd:Q95074",
-        "description": "A figure that is ONE THING made of many drawn parts — addressed, placed, recoloured and directed as a unit. The graph could not say this before 2026-09-11: it could name a rigged character, a 3D world body and a drawn eye, and had no word for the ordinary case of a figure assembled from parts. Three realisations exist and they are not interchangeable: pp:RiggedCharacter is skeleton-driven (bones, IK, poses); pp:WorldCharacter is a body in a pp:World3D; and a figure composed from the design graph is a set of sibling parts bound by pp:partOfFigure, each carrying its own keyframe track. Abstract on purpose — there is no create(\"character\") and inventing one would be the phantom this file exists to prevent. The parts are made with create(\"path\") and bound by pp:partOfFigure — NOT by addParts, which writes pp:partOf and would cascade the root's position onto parts that already carry that motion in their own tracks. NO engineMethod is claimed here on purpose: there is no one call that makes a character, and naming the nearest one would send a model to the wrong door — which is the phantom in miniature. The composing door is the MCP pinepaper_character tool, which expands a concept and its beats into create + keyframe + pp:partOfFigure calls.",
+        "description": ("A figure that is ONE THING made of many drawn parts — addressed, placed, recoloured and directed as a unit. The graph could not say this before 2026-09-11: it could name a rigged character, a 3D world body and a drawn eye, and had no word for the ordinary case of a figure assembled from parts. Three realisations exist and they are not interchangeable: pp:RiggedCharacter is skeleton-driven (bones, IK, poses); pp:WorldCharacter is a body in a pp:World3D; and a figure composed from the design graph is a set of sibling parts bound by pp:partOfFigure, each carrying its own keyframe track. Abstract on purpose — there is no create(\"character\") and inventing one would be the phantom this file ex" + "ists to prevent. The parts are made with create(\"path\") and bound by pp:partOfFigure — NOT by addParts, which writes pp:partOf and would cascade the root's position onto parts that already carry that motion in their own tracks. NO engineMethod is claimed here on purpose: there is no one call that makes a character, and naming the nearest one would send a model to the wrong door — which is the phantom in miniature. The composing door is the MCP pinepaper_character tool, which expands a concept and its beats into create + keyframe + pp:partOfFigure calls."),
         "parentType": "pp:Concept"
     },
     "pp:CharacterAction": {
@@ -748,7 +748,7 @@ export const UPSTREAM_TYPES = Object.freeze({
     },
     "pp:ProceduralField": {
         "anchor": "wd:Q3519388",
-        "description": "A full-canvas surface whose pixels are COMPUTED rather than drawn — a generator's output, materialized as one raster the registry holds under its own id. It is a PLACE, not a decoration, and that distinction is the reason it is a node at all: a tunnel is a thing you can put something inside, so a rigged figure can run through one and a boat can sit on an ocean. A pp:ShaderEffectRelation, by contrast, is applied TO an item and dies with it. NOISE PROVENANCE: these programs call the SHARED pp:ShaderNode primitives from js/gpu/AuraNoiseGLSL.js, so a walk can descend from a field to the maths that draws it. Each used to inline its own hash and value noise — a third family beside the original auras' inline set and the shared one — which meant no usesShaderNode edge could be declared for any of them; that was corrected 2026-09-11 by porting them onto the shared module. pp:OceanField and pp:TunnelField declare no edge and that is not an omission: one is a sum of sine waves and the other a rotation, and neither hashes anything.",
+        "description": ("A full-canvas surface whose pixels are COMPUTED rather than drawn — a generator's output, materialized as one raster the registry holds under its own id. It is a PLACE, not a decoration, and that distinction is the reason it is a node at all: a tunnel is a thing you can put something inside, so a rigged figure can run through one and a boat can sit on an ocean. A pp:ShaderEffectRelation, by contrast, is applied TO an item and dies with it. NOISE PROVENANCE: these programs call the SHARED pp:ShaderNode primitives from js/gpu/AuraNoiseGLSL.js, so a walk can descend from a field to the maths that draws it. Each used to inline its own hash and value noise — a third family beside the original a" + "uras' inline set and the shared one — which meant no usesShaderNode edge could be declared for any of them; that was corrected 2026-09-11 by porting them onto the shared module. pp:OceanField and pp:TunnelField declare no edge and that is not an omission: one is a sum of sine waves and the other a rotation, and neither hashes anything."),
         "parentType": "pp:CanvasElement"
     },
     "pp:ProcessShape": {
@@ -820,7 +820,7 @@ export const UPSTREAM_TYPES = Object.freeze({
     },
     "pp:ShaderMesh": {
         "anchor": "wd:Q1154597",
-        "description": "Geometry in a 3D world drawn by an author-supplied vertex and fragment program. Unlike pp:WorldObject, which is a box with a colour, its SHAPE and its SHADING are both the author's: vertices and triangles supplied as data, transformed by a vertex program that may displace them per frame. A registry citizen under its own id, so relations can target it — anchor a label to a procedural surface, or drive its uniforms from an event. INSTANCED when created with `instances`: one mesh drawn N times in one draw call, each copy six floats [x, y, z, scale, rotY, variant] (scale > 0 — the default program reads 0 as unbound and draws it full size). app.setWorldMeshInstances rewrites the copies; app.setWorldMeshInstanceDriver moves them on the SCENE clock — per-channel expressions in t, i, n, col, row, cols, rows, u, v, d and the base values, or keyframes [{t, instances}] — inside renderAt, so it scrubs and exports frame-exact; app.addWorldBoxField lays a cols × rows field of boxes (BoxGeometry) as one instanced mesh (a pin-art board: motion y = A*sin(d*k - t*w)). The on-device assistant reaches all three through its pinepaper_world3d tool (cube_field, set_mesh_instances, animate_mesh_instances); the server MCP tool does not expose them yet. Neither the geometry nor a driver is persisted.",
+        "description": ("Geometry in a 3D world drawn by an author-supplied vertex and fragment program. Unlike pp:WorldObject, which is a box with a colour, its SHAPE and its SHADING are both the author's: vertices and triangles supplied as data, transformed by a vertex program that may displace them per frame. A registry citizen under its own id, so relations can target it — anchor a label to a procedural surface, or drive its uniforms from an event. INSTANCED when created with `instances`: one mesh drawn N times in one draw call, each copy six floats [x, y, z, scale, rotY, variant] (scale > 0 — the default program reads 0 as unbound and draws it full size). app.setWorldMeshInstances rewrites the copies; app.set" + "WorldMeshInstanceDriver moves them on the SCENE clock — per-channel expressions in t, i, n, col, row, cols, rows, u, v, d and the base values, or keyframes [{t, instances}] — inside renderAt, so it scrubs and exports frame-exact; app.addWorldBoxField lays a cols × rows field of boxes (BoxGeometry) as one instanced mesh (a pin-art board: motion y = A*sin(d*k - t*w)). The on-device assistant reaches all three through its pinepaper_world3d tool (cube_field, set_mesh_instances, animate_mesh_instances); the server MCP tool does not expose them yet. Neither the geometry nor a driver is persisted."),
         "parentType": "pp:WorldObject"
     },
     "pp:ShaderNode": {
@@ -1059,7 +1059,7 @@ export const UPSTREAM_TYPES = Object.freeze({
     },
     "pp:WorldMaterial": {
         "anchor": null,
-        "description": "A named, SHARED surface description referenced by many world objects: one node, many users, so a single edit restyles all of them. That sharing is the whole point — a per-object colour already existed, and a material that styled one thing would be a rename rather than a capability. Carries colour and emissive, and — since js/world3d/PBR.js landed a real Cook-Torrance GGX BRDF — metalness and roughness, in Three.js's names and with Three.js's defaults, so a material authored against Three, Blender or Substance means the same thing here. WHERE THEY ACTUALLY RENDER is the part an agent must not guess: metalness and roughness reach the shader ONLY on the mesh path (addWorldMesh, and imported OBJ/glTF, which ride them through the uniforms bag into DEFAULT_MESH_FRAG). A plain pp:WorldObject — a box or a scattered prop — is drawn by PART_FRAG/PROP_FRAG, which shade with the older lambert term and declare no such uniform, so a material's metalness on a box is stored, listed and ignored. emissiveIntensity IS read: World3D scales the material's emissive by it before the frame is built, so it reaches every path that draws emissive. aoMapIntensity, normalScale and envMapIntensity have been REMOVED — each one scales a MAP, and there is no aoMap, no normalMap and no envMap; a knob that scales nothing is the claim-about-nothing defect wearing a Three.js name, and being Three's spelling does not make it real. They come back with the maps they scale, together, and not before. (This sentence previously said all four were accepted-but-inert. That was true when written and false from the moment emissiveIntensity was wired and the other three deleted; it is corrected here rather than quietly dropped, because a drifted claim is worse than a missing one.) clearcoat, clearcoatRoughness, sheenColor and sheenRoughness are REAL on the mesh path and carry Three's names and Three's defaults, which are inert: clearcoat 0 and a black sheenColor mean a material authored before they existed lights identically. Clearcoat is a second, always-DIELECTRIC specular lobe with its own roughness — a clearcoated metal shows a white highlight over a coloured one, which is what separates a coat from extra gloss — and it ATTENUATES the base beneath it, because light the coat reflects never reaches the base. Sheen is the Charlie retroreflective lobe that peaks at GRAZING angles, where GGX cannot reach at any roughness; it is what makes cloth read as cloth. Both are additive over the same Cook-Torrance evaluation and, like metalness and roughness, reach the shader ONLY on the mesh path. transmission, ior, thickness and opacity are ABSENT, and for one shared reason rather than as an oversight: each needs depth-sorted transparency, which this renderer does not have. They are named here so an agent learns the GATE rather than guessing the knob was forgotten. setMaterial patches colour, emissive, metalness, roughness, emissiveIntensity, clearcoat, clearcoatRoughness, sheenColor and sheenRoughness. Anchored to nothing: a plausible-looking Wikidata concept would be worse than none.",
+        "description": ("A named, SHARED surface description referenced by many world objects: one node, many users, so a single edit restyles all of them. That sharing is the whole point — a per-object colour already existed, and a material that styled one thing would be a rename rather than a capability. Carries colour and emissive, and — since js/world3d/PBR.js landed a real Cook-Torrance GGX BRDF — metalness and roughness, in Three.js's names and with Three.js's defaults, so a material authored against Three, Blender or Substance means the same thing here. WHERE THEY ACTUALLY RENDER is the part an agent must not guess: metalness and roughness reach the shader ONLY on the mesh path (addWorldMesh, and imported O" + "BJ/glTF, which ride them through the uniforms bag into DEFAULT_MESH_FRAG). A plain pp:WorldObject — a box or a scattered prop — is drawn by PART_FRAG/PROP_FRAG, which shade with the older lambert term and declare no such uniform, so a material's metalness on a box is stored, listed and ignored. emissiveIntensity IS read: World3D scales the material's emissive by it before the frame is built, so it reaches every path that draws emissive. aoMapIntensity, normalScale and envMapIntensity have been REMOVED — each one scales a MAP, and there is no aoMap, no normalMap and no envMap; a knob that scales nothing is the claim-about-nothing defect wearing a Three.js name, and being Three's spelling do" + "es not make it real. They come back with the maps they scale, together, and not before. (This sentence previously said all four were accepted-but-inert. That was true when written and false from the moment emissiveIntensity was wired and the other three deleted; it is corrected here rather than quietly dropped, because a drifted claim is worse than a missing one.) clearcoat, clearcoatRoughness, sheenColor and sheenRoughness are REAL on the mesh path and carry Three's names and Three's defaults, which are inert: clearcoat 0 and a black sheenColor mean a material authored before they existed lights identically. Clearcoat is a second, always-DIELECTRIC specular lobe with its own roughness — a" + " clearcoated metal shows a white highlight over a coloured one, which is what separates a coat from extra gloss — and it ATTENUATES the base beneath it, because light the coat reflects never reaches the base. Sheen is the Charlie retroreflective lobe that peaks at GRAZING angles, where GGX cannot reach at any roughness; it is what makes cloth read as cloth. Both are additive over the same Cook-Torrance evaluation and, like metalness and roughness, reach the shader ONLY on the mesh path. transmission, ior, thickness and opacity are ABSENT, and for one shared reason rather than as an oversight: each needs depth-sorted transparency, which this renderer does not have. They are named here so an" + " agent learns the GATE rather than guessing the knob was forgotten. setMaterial patches colour, emissive, metalness, roughness, emissiveIntensity, clearcoat, clearcoatRoughness, sheenColor and sheenRoughness. Anchored to nothing: a plausible-looking Wikidata concept would be worse than none."),
         "parentType": "pp:CanvasElement"
     },
     "pp:WorldObject": {

package/dist/tools/craft-tools.js

@@ -117,23 +117,23 @@ export function generateUiKit(input) {
     const brandFaces = [brand?.headingFont, brand?.bodyFont].filter((f) => typeof f === 'string' && /^[\w \-]{1,60}$/.test(f.trim()));
     const ensure = (family, slot) => `  ${slot} = await (async function() {${emitEnsureFont(family).replace(/\n/g, '\n  ')}\n    return __font;\n  })();\n  if (${slot}) __fonts.push(${slot});`;
     const runtime = UI_KIT_RUNTIME.replace(KIT_DEFAULT_FONTS, KIT_LOADED_FONTS);
-    return `// UI kit: ${input.action}
-(async function() {
-  const __fonts = [];
-  let __geist, __geistMono, __b;
-${ensure('Geist', '__geist')}
-${ensure('Geist Mono', '__geistMono')}
-${[...new Set(brandFaces.map((f) => f.trim()))].map((f) => ensure(f, '__b')).join('\n')}
-  // Geist is the kit's face; a studio that cannot load it draws in Inter, its own face, not a browser substitute.
-  var __kitFace = (__geist && __geist.available === false) ? 'Inter' : 'Geist';
-  var __kitMono = (__geistMono && __geistMono.available === false) ? 'monospace' : 'Geist Mono';
-${runtime}
-${brand ? '' : "  if (typeof window !== 'undefined' && window.__ppActiveBrand) UIKit.brand(window.__ppActiveBrand);\n"}  var __before = app.itemRegistry ? app.itemRegistry.getAll().length : 0;
-${call}
-  return { success: true, tool: 'pinepaper_ui_kit', action: ${JSON.stringify(input.action)},
-    itemCount: app.itemRegistry ? app.itemRegistry.getAll().length - __before : null,
-    face: __kitFace, brand: ${brand ? "'call'" : "(typeof window !== 'undefined' && window.__ppActiveBrand) ? 'active brand kit' : 'kit defaults'"},
-    ...(__fonts.length ? { fonts: __fonts } : {}) };
-})();`;
+    return ("// UI kit: " +
+String(input.action) +
+"\n(async function() {\n  const __fonts = [];\n  let __geist, __geistMono, __b;\n" +
+String(ensure('Geist', '__geist')) +
+"\n" +
+String(ensure('Geist Mono', '__geistMono')) +
+"\n" +
+String([...new Set(brandFaces.map((f) => f.trim()))].map((f) => ensure(f, '__b')).join('\n')) +
+"\n  // Geist is the kit's face; a studio that cannot load it draws in Inter, its own face, not a browser substitute.\n  var __kitFace = (__geist && __geist.available === false) ? 'Inter' : 'Geist';\n  var __kitMono = (__geistMono && __geistMono.available === false) ? 'monospace' : 'Geist Mono';\n" +
+String(runtime) +
+"\n" +
+String(brand ? '' : "  if (typeof window !== 'undefined' && window.__ppActiveBrand) UIKit.brand(window.__ppActiveBrand);\n") +
+"  var __before = app.itemRegistry ? app.itemRegistry.getAll().length : 0;\n" +
+String(call) +
+"\n  return { success: true, tool: 'pinepaper_ui_kit', action: " +
+String(JSON.stringify(input.action)) +
+",\n    itemCount: app.itemRegistry ? app.itemRegistry.getAll().length - __before : null,\n    face: __kitFace, brand: " +
+String(brand ? "'call'" : "(typeof window !== 'undefined' && window.__ppActiveBrand) ? 'active brand kit' : 'kit defaults'") + ",\n    ...(__fonts.length ? { fonts: __fonts } : {}) };\n})();");
 }
 //# sourceMappingURL=craft-tools.js.map

package/dist/tools/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAqE/C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAYnE;AAED,0EAA0E;AAC1E,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD,yGAAyG;AACzG,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAAmG,CAAC;AAE5I,eAAO,MAAM,cAAc,QA8K+G,CAAC;AAW3I,eAAO,MAAM,eAAe,EAAE,IAAI,EAglTjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,CAO3D;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,EAAE,CAQrE"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAqE/C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAYnE;AAED,0EAA0E;AAC1E,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD,yGAAyG;AACzG,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAAmG,CAAC;AAE5I,eAAO,MAAM,cAAc,QA8K+G,CAAC;AAW3I,eAAO,MAAM,eAAe,EAAE,IAAI,EAilTjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,CAO3D;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,EAAE,CAQrE"}