@pinepaper.studio/mcp-server 1.5.5 → 1.6.0

package/dist/tools/handlers/ontology.js

@@ -15,7 +15,7 @@
  */
 import { errorResult, executeOrGenerate } from '../handlers.js';
 import { codeGenerator } from '../../types/code-generator.js';
-import { AnalyzeDesignInputSchema, ValidateDesignInputSchema, QueryOntologyInputSchema, GetCanvasOntologyInputSchema, ErrorCodes, } from '../../types/schemas.js';
+import { AnalyzeDesignInputSchema, ValidateDesignInputSchema, ValidateInputSchema, QueryOntologyInputSchema, GetCanvasOntologyInputSchema, ErrorCodes, } from '../../types/schemas.js';
 export const ontologyHandlers = {
     pinepaper_get_canvas_ontology: async (args, options) => {
         const input = GetCanvasOntologyInputSchema.parse(args);
@@ -57,7 +57,7 @@ export const ontologyHandlers = {
     },
     pinepaper_validate_design: async (args, _options) => {
         const input = ValidateDesignInputSchema.parse(args);
-        const { DesignGraph, KnowledgeGraphValidator } = await import('../../ontology/index.js');
+        const { DesignGraph, KnowledgeGraphValidator, validateDefinitionSemantics } = await import('../../ontology/index.js');
         const dg = new DesignGraph();
         const validator = new KnowledgeGraphValidator();
         const definition = input.definition;
@@ -67,13 +67,25 @@ export const ontologyHandlers = {
             const graph = dg.extractFromDefinition(definition);
             quality = validator.scoreQuality(definition, graph);
         }
+        // Structured semantic diagnostics (FxTool's S3.4 OntologyValidator, ported) — dangling
+        // relation targets, unknown item/relation types (+nearest-id), duplicate edges,
+        // relation cycles, keyframe order/easing. Runs Node-side, no browser round-trip.
+        const semantics = validateDefinitionSemantics(definition);
         return {
             content: [{
                     type: 'text',
-                    text: JSON.stringify({ validation, quality }, null, 2),
+                    text: JSON.stringify({ validation, quality, diagnostics: semantics }, null, 2),
                 }],
         };
     },
+    // Semantic validation of the LIVE scene or a proposed op (FxTool OntologyValidator).
+    // Distinct from validate_design (server-side template scoring): this runs in the
+    // browser and returns structured diagnostics {code, severity, message, target, fix}.
+    pinepaper_validate: async (args, options) => {
+        const input = ValidateInputSchema.parse(args);
+        const code = codeGenerator.generateValidate(input);
+        return executeOrGenerate(code, 'Semantic validation — structured diagnostics (references, relation types, params, cycles)', options, 'pinepaper_validate');
+    },
     pinepaper_query_ontology: async (args, _options) => {
         const input = QueryOntologyInputSchema.parse(args);
         const { PP_VOCABULARY, RELATION_TYPE_MAP } = await import('../../ontology/vocabulary.js');

package/dist/tools/handlers/ontology.js.map

@@ -1 +1 @@
-{"version":3,"file":"ontology.js","sourceRoot":"","sources":["../../../src/tools/handlers/ontology.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ontology.js","sourceRoot":"","sources":["../../../src/tools/handlers/ontology.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAA6B,MAAM,oCAAoC,CAAC;AAwH/F,OAAO,EAAE,WAAW,EAAW,MAAM,kBAAkB,CAAC;AACxD,OAAO,EACL,0BAA0B,EAI3B,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,YAAY,EAA0C,MAAM,uBAAuB,CAAC;AA4B7F;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAOlD;AA+CD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAOhD;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;IAC/C,oEAAoE;IACpE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sEAAsE;IACtE,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AA6DD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAwBhB;AAyBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAmMzB;AAMD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,MAAM,CASR;AA0ED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAkBzB"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAA6B,MAAM,oCAAoC,CAAC;AAyI/F,OAAO,EAAE,WAAW,EAAW,MAAM,kBAAkB,CAAC;AACxD,OAAO,EACL,0BAA0B,EAI3B,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,YAAY,EAA0C,MAAM,uBAAuB,CAAC;AA4B7F;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAOlD;AA+CD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAOhD;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;IAC/C,oEAAoE;IACpE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sEAAsE;IACtE,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AA2ED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAwBhB;AAyBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAqMzB;AAMD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,MAAM,CASR;AA0ED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAkBzB"}

package/dist/tools/handlers.js

@@ -6,7 +6,7 @@
  * Supports browser execution via Puppeteer.
  */
 import { codeGenerator } from '../types/code-generator.js';
-import { CreateItemInputSchema, ModifyItemInputSchema, DeleteItemInputSchema, AddRelationInputSchema, RemoveRelationInputSchema, QueryRelationsInputSchema, AnimateItemInputSchema, KeyframeAnimateInputSchema, ExecuteGeneratorInputSchema, ApplyEffectInputSchema, GetItemsInputSchema, PlayTimelineInputSchema, SetBackgroundColorInputSchema, SetCanvasSizeInputSchema, ImportSVGInputSchema, ImportMermaidInputSchema, AddFilterInputSchema, CreateGlossySphereInputSchema, CreateDiagonalStripesInputSchema, BatchCreateInputSchema, BatchModifyInputSchema, CreateGridInputSchema, CreateSceneInputSchema, GetPerformanceMetricsInputSchema, DiagnosticReportInputSchema, SearchAssetsInputSchema, ImportAssetInputSchema, P5DrawInputSchema, 
+import { CreateItemInputSchema, ModifyItemInputSchema, DeleteItemInputSchema, AddRelationInputSchema, RemoveRelationInputSchema, QueryRelationsInputSchema, AnimateItemInputSchema, KeyframeAnimateInputSchema, ExecuteGeneratorInputSchema, ApplyEffectInputSchema, GetItemsInputSchema, PlayTimelineInputSchema, SetBackgroundColorInputSchema, SetCanvasSizeInputSchema, ImportSVGInputSchema, ImportMermaidInputSchema, AddFilterInputSchema, CreateGlossySphereInputSchema, CreateDiagonalStripesInputSchema, BatchCreateInputSchema, BatchModifyInputSchema, CreateGridInputSchema, GeometryInputSchema, EquationPathInputSchema, EventInputSchema, ConstructionSequenceInputSchema, ValidateSceneInputSchema, CaptureFramesInputSchema, InstantiateOntologyInputSchema, LintSceneInputSchema, MediaInputSchema, CropImageInputSchema, ChromaKeyInputSchema, RiggingInputSchema, GroupInputSchema, CameraDirectorInputSchema, DetectObjectsInputSchema, ExtractObjectInputSchema, ArrangeInputSchema, CreateSceneInputSchema, GetPerformanceMetricsInputSchema, DiagnosticReportInputSchema, SearchAssetsInputSchema, ImportAssetInputSchema, P5DrawInputSchema, 
 // Diagram schemas
 CreateDiagramShapeInputSchema, ConnectInputSchema, ConnectPortsInputSchema, AddPortsInputSchema, AutoLayoutInputSchema, GetDiagramShapesInputSchema, UpdateConnectorInputSchema, RemoveConnectorInputSchema, DiagramModeInputSchema, 
 // Agent flow mode schemas
@@ -125,10 +125,26 @@ function successResult(code, description) {
     }
     return { content };
 }
-function executedResult(code, result, screenshot, description) {
+function executedResult(code, result, screenshot, description, report) {
     const resultObj = { success: true, result };
     if (description)
         resultObj.description = description;
+    // Surface the governor's model-actionable feedback (app.runGenerated report):
+    // warnings (e.g. "500 items created one-by-one — prefer a pattern"), item count,
+    // and guard trips. Omitted entirely on pre-governor FxTool builds (no report).
+    if (report) {
+        const warnings = Array.isArray(report.warnings) ? report.warnings : [];
+        const items = report.items;
+        const governor = {};
+        if (warnings.length)
+            governor.warnings = warnings;
+        if (items && typeof items.created === 'number')
+            governor.itemsCreated = items.created;
+        if (report.guard?.tripped)
+            governor.loopGuardTripped = true;
+        if (Object.keys(governor).length)
+            resultObj.governor = governor;
+    }
     const content = [
         { type: 'text', text: JSON.stringify(resultObj, null, 2) },
         { type: 'text', text: `Generated code:\n\`\`\`javascript\n${code}\n\`\`\`` },
@@ -374,12 +390,15 @@ ${code}
     if (!result.success) {
         // Capture canvas state for error context
         const canvasState = await captureCanvasState(controller);
-        return errorResult(ErrorCodes.EXECUTION_ERROR, result.error || 'Failed to execute code in browser', { code }, {
+        return errorResult(ErrorCodes.EXECUTION_ERROR, result.error || 'Failed to execute code in browser', 
+        // errorCode surfaces the governor's structured code (PP_ITEM_BUDGET,
+        // PP_LOOP_BUDGET, PP_TIMEOUT) so the model can correct on the next turn.
+        { code, errorCode: result.errorCode, governorReport: result.report }, {
             toolName,
             canvasState: canvasState || undefined,
         });
     }
-    return executedResult(code, result.result, result.screenshot, description);
+    return executedResult(code, result.result, result.screenshot, description, result.report);
 }
 // =============================================================================
 // I18N HELPER FUNCTIONS
@@ -697,6 +716,108 @@ async function handleToolCallInner(toolName, args, options, tracker, baseTimerId
                 const description = `Creates a ${input.cols}x${input.rows} grid${input.animated ? ' with wave animation' : ''}`;
                 return executeOrGenerate(code, description, options, 'pinepaper_create_grid');
             }
+            case 'pinepaper_geometry': {
+                const input = GeometryInputSchema.parse(args);
+                const code = codeGenerator.generateGeometry(input);
+                const description = `Geometry construction: ${input.operation}${input.createAs ? ' (+ create item)' : ''}`;
+                return executeOrGenerate(code, description, options, 'pinepaper_geometry');
+            }
+            case 'pinepaper_equation_path': {
+                const input = EquationPathInputSchema.parse(args);
+                const code = codeGenerator.generateEquationPath(input);
+                const description = `Equation-driven path: ${input.kind}${input.preset ? ` (${input.preset})` : ''}`;
+                return executeOrGenerate(code, description, options, 'pinepaper_equation_path');
+            }
+            case 'pinepaper_event': {
+                const input = EventInputSchema.parse(args);
+                const code = codeGenerator.generateEvent(input);
+                const description = input.action === 'create'
+                    ? `Create event "${input.name}"`
+                    : `Pulse event ${input.eventId}`;
+                return executeOrGenerate(code, description, options, 'pinepaper_event');
+            }
+            case 'pinepaper_construction_sequence': {
+                const input = ConstructionSequenceInputSchema.parse(args);
+                const code = codeGenerator.generateConstructionSequence(input);
+                const description = `Construction sequence: ${input.action}`;
+                return executeOrGenerate(code, description, options, 'pinepaper_construction_sequence');
+            }
+            case 'pinepaper_group': {
+                const input = GroupInputSchema.parse(args);
+                const code = codeGenerator.generateGroup(input);
+                const description = input.action === 'ungroup' ? `Ungroup ${input.groupId ?? ''}`
+                    : input.action === 'break_apart' ? `Break apart ${input.itemId ?? ''} into movable parts`
+                        : `Group ${(input.itemIds ?? []).length} item(s)${input.groupName ? ` as "${input.groupName}"` : ''}`;
+                return executeOrGenerate(code, description, options, 'pinepaper_group');
+            }
+            case 'pinepaper_camera_director': {
+                const input = CameraDirectorInputSchema.parse(args);
+                const code = codeGenerator.generateCameraDirector(input);
+                const description = input.action === 'shots'
+                    ? `Camera director: ${(input.shots ?? []).length} shot(s)`
+                    : 'Camera director: auto-direct walkthrough';
+                return executeOrGenerate(code, description, options, 'pinepaper_camera_director');
+            }
+            case 'pinepaper_detect_objects': {
+                const input = DetectObjectsInputSchema.parse(args);
+                const code = codeGenerator.generateDetectObjects(input);
+                const description = `Detect objects${input.asNodes ? ' (as design nodes)' : ''}`;
+                return executeOrGenerate(code, description, options, 'pinepaper_detect_objects');
+            }
+            case 'pinepaper_extract_object': {
+                const input = ExtractObjectInputSchema.parse(args);
+                const code = codeGenerator.generateExtractObject(input);
+                const description = `Extract object${input.label ? ` "${input.label}"` : ''} from image`;
+                return executeOrGenerate(code, description, options, 'pinepaper_extract_object');
+            }
+            case 'pinepaper_arrange': {
+                const input = ArrangeInputSchema.parse(args);
+                const code = codeGenerator.generateArrange(input);
+                const description = `Arrange ${input.itemId}: ${input.action}`;
+                return executeOrGenerate(code, description, options, 'pinepaper_arrange');
+            }
+            case 'pinepaper_validate_scene': {
+                const input = ValidateSceneInputSchema.parse(args);
+                const code = codeGenerator.generateValidateScene(input);
+                const description = input.ops ? `Pre-validate ${input.ops.length} proposed op(s)` : 'Audit the live scene';
+                return executeOrGenerate(code, description, options, 'pinepaper_validate_scene');
+            }
+            case 'pinepaper_capture_frames': {
+                const input = CaptureFramesInputSchema.parse(args);
+                const code = codeGenerator.generateCaptureFrames(input);
+                const description = `Deterministic capture of ${input.times.length} frame(s)`;
+                return executeOrGenerate(code, description, options, 'pinepaper_capture_frames');
+            }
+            case 'pinepaper_instantiate_ontology': {
+                const input = InstantiateOntologyInputSchema.parse(args);
+                const code = codeGenerator.generateInstantiateOntology(input);
+                return executeOrGenerate(code, 'Instantiate ontology → scene', options, 'pinepaper_instantiate_ontology');
+            }
+            case 'pinepaper_lint_scene': {
+                const input = LintSceneInputSchema.parse(args);
+                const code = codeGenerator.generateLintScene(input);
+                return executeOrGenerate(code, 'Lint scene (relational density)', options, 'pinepaper_lint_scene');
+            }
+            case 'pinepaper_media': {
+                const input = MediaInputSchema.parse(args);
+                const code = codeGenerator.generateMedia(input);
+                return executeOrGenerate(code, `Media: ${input.action}`, options, 'pinepaper_media');
+            }
+            case 'pinepaper_crop_image': {
+                const input = CropImageInputSchema.parse(args);
+                const code = codeGenerator.generateCropImage(input);
+                return executeOrGenerate(code, `Crop image ${input.itemId}`, options, 'pinepaper_crop_image');
+            }
+            case 'pinepaper_chroma_key': {
+                const input = ChromaKeyInputSchema.parse(args);
+                const code = codeGenerator.generateChromaKey(input);
+                return executeOrGenerate(code, `Chroma-key image ${input.itemId}`, options, 'pinepaper_chroma_key');
+            }
+            case 'pinepaper_rigging': {
+                const input = RiggingInputSchema.parse(args);
+                const code = codeGenerator.generateRigging(input);
+                return executeOrGenerate(code, `Rigging: ${input.action}`, options, 'pinepaper_rigging');
+            }
             // -----------------------------------------------------------------------
             // RELATION TOOLS
             // -----------------------------------------------------------------------
@@ -753,7 +874,7 @@ async function handleToolCallInner(toolName, args, options, tracker, baseTimerId
             }
             case 'pinepaper_play_timeline': {
                 const input = PlayTimelineInputSchema.parse(args);
-                const code = codeGenerator.generatePlayTimeline(input.action, input.duration, input.loop, input.time);
+                const code = codeGenerator.generatePlayTimeline(input.action, input.duration, input.loop, input.time, input.deterministic);
                 return executeOrGenerate(code, `Timeline action: ${input.action}`, options, 'pinepaper_play_timeline');
             }
             // -----------------------------------------------------------------------
@@ -1784,6 +1905,15 @@ You can now start creating new items on a clean canvas.`,
                         'pinepaper_batch_create',
                         'pinepaper_batch_modify',
                         'pinepaper_create_grid',
+                        'pinepaper_geometry',
+                        'pinepaper_construction_sequence',
+                        'pinepaper_group',
+                        'pinepaper_camera_director',
+                        'pinepaper_detect_objects',
+                        'pinepaper_extract_object',
+                        'pinepaper_arrange',
+                        'pinepaper_validate_scene',
+                        'pinepaper_capture_frames',
                         'pinepaper_add_relation',
                         'pinepaper_remove_relation',
                         'pinepaper_query_relations',
@@ -1850,11 +1980,12 @@ You can now start creating new items on a clean canvas.`,
                         // Letter collage tools
                         'pinepaper_create_letter_collage',
                         'pinepaper_animate_letter_collage',
-                        // Map tools (4 action-dispatched)
+                        // Map tools (5 action-dispatched)
                         'pinepaper_map',
                         'pinepaper_map_regions',
                         'pinepaper_map_animation',
                         'pinepaper_map_data',
+                        'pinepaper_globe',
                         // Font tools
                         'pinepaper_font',
                         // Image import tools