@pinepaper.studio/mcp-server 1.6.7 → 1.6.9

package/dist/tools/engine-methods.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Engine methods a tool REFUSES without — guarded with `!==` in the emitters.
+ *
+ * A studio missing one of these cannot serve the tools that need it, and will
+ * say so by name when called. Probe them all at once with
+ * `pinepaper_query_capabilities { action: 'studio' }` instead of discovering
+ * it one call at a time.
+ */
+export declare const REQUIRED_ENGINE_METHODS: readonly string[];
+/**
+ * Engine methods a tool DEGRADES without — probed with `===` in the emitters.
+ *
+ * Their absence narrows an answer rather than failing it: a canvas that cannot
+ * be resized is not a failed compose. Reported separately so an older studio
+ * does not read as an unusable one.
+ */
+export declare const OPTIONAL_ENGINE_METHODS: readonly string[];
+//# sourceMappingURL=engine-methods.d.ts.map

package/dist/tools/engine-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-methods.d.ts","sourceRoot":"","sources":["../../src/tools/engine-methods.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAwMpD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAcpD,CAAC"}

package/dist/tools/engine-methods.js

@@ -0,0 +1,241 @@
+/* GENERATED — DO NOT EDIT.
+ *
+ * Source:    src/types/code-generator.ts (its own `typeof app.X` guards)
+ * Generator: scripts/sync-engine-methods.mjs
+ *
+ * Re-run the generator after adding or removing a guard. A hand edit here is a
+ * second copy of a list that already exists in the emitters, which is the
+ * drift this file was created to prevent.
+ */
+/**
+ * Engine methods a tool REFUSES without — guarded with `!==` in the emitters.
+ *
+ * A studio missing one of these cannot serve the tools that need it, and will
+ * say so by name when called. Probe them all at once with
+ * `pinepaper_query_capabilities { action: 'studio' }` instead of discovering
+ * it one call at a time.
+ */
+export const REQUIRED_ENGINE_METHODS = [
+    'addComment',
+    'addPhysicsBody3D',
+    'addRelation',
+    'addWorldActor',
+    'addWorldLight',
+    'addWorldMaterial',
+    'analyzeAudio',
+    'analyzePalette',
+    'animateItems',
+    'animateToBeat',
+    'applyChromaKey',
+    'applyDirectorShots',
+    'applyHatching',
+    'applyImageFilter',
+    'applyPhysicsImpulse3D',
+    'applyRelationPreset',
+    'applyStorySpec',
+    'applyTemplateWithParams',
+    'applyTextEffect',
+    'applyTextStyle',
+    'applyThreadPainting',
+    'applyTrackMatte',
+    'autoDirectStory',
+    'bindTimelineToScroll',
+    'booleanOp',
+    'breakApart',
+    'bringForward',
+    'bringToFront',
+    'buildSoundFromText',
+    'canvasToGround',
+    'captureFramesAt',
+    'chordFrequencies',
+    'composeCollage',
+    'configureWorld3D',
+    'convertTextToCollage',
+    'create',
+    'createCursiveText',
+    'createEquationPath',
+    'createEvent',
+    'createSceneGraph',
+    'createSound',
+    'createTilemap',
+    'createWorld3D',
+    'cropImage',
+    'defineComponent',
+    'deleteComment',
+    'deleteItem',
+    'describeWorld3D',
+    'detachComponentInstance',
+    'detectObjects',
+    'diffAgainstVersion',
+    'diffHistoryStates',
+    'distillArticle',
+    'dollyWorldCamera',
+    'ensureHeavyModules',
+    'estimateExportSize',
+    'exportBVH',
+    'exportDotLottie',
+    'exportEngine.exportToStore',
+    'exportEngine.listExports',
+    'exportEngine.readExport',
+    'exportEngine.releaseExport',
+    'exportEngine.sceneHasAudio',
+    'exportGLB',
+    'exportLottie',
+    'exportPNGSequence',
+    'extractObject',
+    'extrudeToMesh',
+    'findPath',
+    'fireProjectile3D',
+    'fitToFrame',
+    'flipItems',
+    'getCapabilities',
+    'getDependents',
+    'getItemProvenance',
+    'getLineage',
+    'getPathGeometry',
+    'getProgress',
+    'getTemplateParams',
+    'getTimeScale',
+    'getWorldNavTarget',
+    'groundHeightAt',
+    'importBVH',
+    'importFigmaSVG',
+    'importGLTFToWorld',
+    'importLayeredCharacter',
+    'importLottie',
+    'importOBJToWorld',
+    'importSpine',
+    'instantiateComponent',
+    'latheToMesh',
+    'lintScene',
+    'listArtboardPresets',
+    'listCameraTreatments',
+    'listCollagePatterns',
+    'listComments',
+    'listComponents',
+    'listDesignMedia',
+    'listFlowFields',
+    'listGeneratorMotions',
+    'listHatchOptions',
+    'listInstruments',
+    'listPercussion',
+    'listPhysicsBodies3D',
+    'listPositionForms',
+    'listReveals',
+    'listScrubAnchors',
+    'listSfx',
+    'listStaggerOrigins',
+    'listStitches',
+    'listStyles',
+    'listTextEffects',
+    'listTextStyles',
+    'listWorldLights',
+    'listWorldMaterials',
+    'listWorldMeshClips',
+    'listWorldMeshes',
+    'mapSystem.animateGlobeRotation',
+    'mapSystem.enableGlobeMode',
+    'mapSystem.pinItemToGlobe',
+    'mapSystem.rotateGlobeTo',
+    'mapSystem.stopWorldTour',
+    'mapSystem.tourItemAlongCoords',
+    'mapSystem.tourRegions',
+    'mapSystem.worldTour',
+    'matchCut',
+    'outlineStroke',
+    'panWorldCamera',
+    'patternFrom',
+    'placeSequence',
+    'planBook',
+    'playChord',
+    'playPercussion',
+    'playSfx',
+    'playSound',
+    'playSoundFromText',
+    'playTone',
+    'pulseEvent',
+    'raycastWorld',
+    'recolorPalette',
+    'recordFlipState',
+    'recordLineage',
+    'registerInstrument',
+    'registerPercussion',
+    'registerSfx',
+    'removePhysicsBody3D',
+    'removeSound',
+    'removeWorld3D',
+    'removeWorldLight',
+    'removeWorldMaterial',
+    'removeWorldMesh',
+    'renderSoundtrackWav',
+    'resolveComment',
+    'resolveDesignMedium',
+    'resolveTimelinePosition',
+    'retargetBVH',
+    'sendBackward',
+    'sendToBack',
+    'setArtboard',
+    'setCollageTreatment',
+    'setComponentOverride',
+    'setFontAxes',
+    'setItemConstraints',
+    'setItemLocked',
+    'setPhysicsVelocity3D',
+    'setProgress',
+    'setSoundPlacement',
+    'setTimeRemap',
+    'setTimeScale',
+    'setWorldLight',
+    'setWorldMaterial',
+    'setWorldMeshClip',
+    'setWorldMeshInstances',
+    'setWorldNavTarget',
+    'shatterImage',
+    'simplifyPath',
+    'solveODE',
+    'speedRamp',
+    'staggerDelays',
+    'staggerItems',
+    'stepPhysics3D',
+    'stickFigure',
+    'stickSet',
+    'stitchPoses',
+    'stopLiveMatte',
+    'stopSounds',
+    'storyFromText',
+    'syncComponent',
+    'timbreFromPath',
+    'togglePathClosed',
+    'unlockAllItems',
+    'unwrapText',
+    'updateComponentFromInstance',
+    'validateOp',
+    'validateScene',
+    'validateSceneGraph',
+    'worldLineOfSight',
+    'worldToCanvas',
+    'wrapText',
+];
+/**
+ * Engine methods a tool DEGRADES without — probed with `===` in the emitters.
+ *
+ * Their absence narrows an answer rather than failing it: a canvas that cannot
+ * be resized is not a failed compose. Reported separately so an older studio
+ * does not read as an unusable one.
+ */
+export const OPTIONAL_ENGINE_METHODS = [
+    '_resolveRaster',
+    'activeWindowOf',
+    'captureFrameDataURL',
+    'clearCanvas',
+    'instantiateOntology',
+    'itemRegistry.getAll',
+    'listFontAxes',
+    'listTextPalettes',
+    'registerItem',
+    'relationRegistry.exportForSave',
+    'sceneAt',
+    'setBackgroundColor',
+    'setCanvasSize',
+];
+//# sourceMappingURL=engine-methods.js.map

package/dist/tools/engine-methods.js.map

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

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

@@ -0,0 +1,121 @@
+/**
+ * `pinepaper_character` — a symbol and some beats become a figure that performs.
+ *
+ * This clears a PHANTOM. The tool was defined here and dispatched nowhere
+ * (b06fcde): advertised in tools/list, counted in the manifest, offered by a
+ * toolkit, and answering every call with UNKNOWN_TOOL. A missing tool is
+ * invisible; a phantom is a capability the model is told it has and plans
+ * around, and only discovers is absent at call time.
+ *
+ * NOTHING HERE REIMPLEMENTS THE PERFORMANCE. `resolveCharacter` composes the
+ * drawing across the concept's ancestry and hands it to the vendored
+ * `performCharacter`, which returns ops naming exactly two tools this package
+ * already emits. Those ops go through the EXISTING `generateCreateItem` and
+ * `generateKeyframeAnimate`, so there is no second code path to drift: a figure
+ * is created and keyframed by the same generators as everything else.
+ *
+ * ── THE ONE ADAPTATION, AND WHY IT IS NOT OPTIONAL ──────────────────────────
+ *
+ * The cloud's ops are written for the cloud's rasterizer, and the two renderers
+ * disagree about what `position` means next to `pathData`.
+ *
+ * `performCharacter` emits geometry ALREADY SHIFTED to canvas coordinates — a
+ * pigeon asked for at (470, 250) comes back with `pathData` in the 400-700
+ * range — and pairs it with `position: {x: 0, y: 0}`, which its own renderer
+ * ignores. PinePaper does not ignore it. `create('path', …)` treats pathData as
+ * the OTHER convention — a shape authored around its own origin and placed by
+ * (x, y) — and its guard is `params.x !== undefined`, which `0` satisfies. So
+ * the ops as the cloud writes them would move every part's centre to (0, 0) and
+ * stack the whole figure on the canvas origin.
+ *
+ * That is not hypothetical: PinePaper's own comment at that line records it,
+ * "measured on a rigged figure whose 27 parts all drew correctly and all landed
+ * on the canvas origin, stacked, while every other signal (item count,
+ * registry, attachments) said the scene was fine."
+ *
+ * So each part is converted to PinePaper's convention here: the pathData is
+ * shifted to sit around its own bbox centre, and that centre is passed as the
+ * position. Same pixels, stated the way this engine reads them. Converting
+ * rather than re-authoring keeps `performCharacter` the single source of the
+ * performance — the adaptation is a coordinate convention, not a second
+ * implementation.
+ */
+import { type CharacterArgs } from '../../character/resolve.js';
+export interface CharacterOp {
+    tool: string;
+    args: Record<string, unknown>;
+}
+/**
+ * Restate one create op in PinePaper's pathData convention.
+ *
+ * A part whose pathData cannot be measured is passed through UNCHANGED rather
+ * than guessed at: it will be misplaced, which is visible, instead of being
+ * silently dropped, which is not.
+ */
+export declare function toEngineConvention(op: CharacterOp, centres?: Map<string, {
+    cx: number;
+    cy: number;
+}>): CharacterOp;
+/**
+ * Convert a whole program, not one op at a time.
+ *
+ * The keyframe tracks cannot be converted without knowing where the create ops
+ * actually placed each part, so the creates go first and record their centres.
+ * Converting op-by-op is what left the tracks anchored on a different point
+ * from the items they drive.
+ */
+export declare function convertOps(ops: CharacterOp[]): CharacterOp[];
+/**
+ * Plan a character call: ops in PinePaper's convention, or a refusal.
+ *
+ * Separated from the handler so it can be tested WITHOUT `handleToolCall`,
+ * which tries to reach a browser and times out at 5001ms.
+ */
+export declare function planCharacter(args: CharacterArgs): {
+    ok: true;
+    ops: CharacterOp[];
+    parts: string[];
+    tracks: number;
+    notes: string[];
+    concept: string;
+    root: string | null;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * The part the others hang off.
+ *
+ * `part_of_figure` points at a SIBLING, exactly as `glyph_of` points at the
+ * root glyph — there is no wrapper item, and inventing one would be the Paper
+ * group this design deliberately avoids. The body is the natural root because
+ * it is the part every other one is drawn against; failing that, the first in
+ * z-order, which is stable for a given concept.
+ */
+export declare function figureRoot(parts: string[]): string | null;
+/**
+ * The whole performance as one program.
+ *
+ * Emitted as a single block with one history save at the end, like
+ * `batch_create`: thirteen parts and eight tracks are ONE authoring act, and
+ * thirteen undo steps to remove one pigeon is not what anybody means by undo.
+ *
+ * Every interpolated value goes through `JSON.stringify`. Prose is DATA — an
+ * apostrophe in a refusal message, interpolated into a single-quoted literal,
+ * once made every generated `auto_walk` program a SyntaxError.
+ */
+export declare function generateCharacterCode(plan: {
+    ops: CharacterOp[];
+    parts: string[];
+    tracks: number;
+    notes: string[];
+    concept?: string;
+    root?: string | null;
+}, gen: {
+    generateCreateItem: (input: unknown) => string;
+    generateKeyframeAnimate: (input: unknown) => string;
+}, parse: {
+    createItem: (a: unknown) => unknown;
+    keyframeAnimate: (a: unknown) => unknown;
+}): string;
+//# sourceMappingURL=character.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/character.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGlF,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAE5E;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,WAAW,CAoGlH;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAa5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAC7C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACxH;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAShC;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAMzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE;IAAE,GAAG,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACtH,GAAG,EAAE;IACH,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;IAC/C,uBAAuB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CACrD,EACD,KAAK,EAAE;IAAE,UAAU,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IAAC,eAAe,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAA;CAAE,GACvF,MAAM,CAgGR"}