Files
editor/packages/mcp/src/tools/cut-opening.ts
T
Aymeric RabotandClaude Opus 4.8 3273aac551 fix(mcp): restore >0 validation and reject ambiguous numbers in measurement()
Adversarial-review follow-ups to the lingo measurement() field:
- Add a `positive` option (strict > 0) and use it for the non-zero dimension
  params. Swapping z.number().positive() → measurement(..,{min:0}) had started
  admitting 0 (the core node schemas have no positivity backstop), so a zero-size
  wall/opening/roof could be created. Inclusive-0 fields (overhang, sill height,
  knee-wall height, opening offset, roof pitch) keep min:0.
- Escalate AMBIGUOUS_NUMBER to error so "1,234" fails instead of silently reading
  as 1234 — a 1000x hazard for European decimals. Matches lingo's own /ai fields.
- roofLevelElevation reverted to z.number() (it's a level ordinal, not meters);
  radians fields now advertise radian-appropriate examples.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-08 13:09:59 +02:00

82 lines
2.7 KiB
TypeScript

import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
import type { AnyNodeId } from '@pascal-app/core/schema'
import { DoorNode, WindowNode } from '@pascal-app/core/schema'
import { z } from 'zod'
import type { SceneOperations } from '../operations'
import { ErrorCode, throwMcpError } from './errors'
import { wallLength, wallLocalXFromT } from './geometry'
import { publishLiveSceneSnapshot } from './live-sync'
import { measurement } from './measurement'
import { NodeIdSchema } from './schemas'
export const cutOpeningInput = {
wallId: NodeIdSchema,
type: z.enum(['door', 'window']),
position: z.number().min(0).max(1),
width: measurement('length', 'm', { positive: true, description: 'Opening width.' }),
height: measurement('length', 'm', { positive: true, description: 'Opening height.' }),
}
export const cutOpeningOutput = {
openingId: z.string(),
}
export function registerCutOpening(server: McpServer, bridge: SceneOperations): void {
server.registerTool(
'cut_opening',
{
title: 'Cut opening',
description:
'Cut a door or window opening into an existing wall. position is a parametric 0..1 offset along the wall centreline.',
inputSchema: cutOpeningInput,
outputSchema: cutOpeningOutput,
},
async ({ wallId, type, position, width, height }) => {
const wall = bridge.getNode(wallId as AnyNodeId)
if (!wall) {
throwMcpError(ErrorCode.InvalidParams, `Wall not found: ${wallId}`)
}
if (wall.type !== 'wall') {
throwMcpError(ErrorCode.InvalidParams, `Node ${wallId} is a ${wall.type}, expected wall`)
}
const length = wallLength(wall)
if (length < width) {
throwMcpError(
ErrorCode.InvalidParams,
`Wall ${wallId} is ${length.toFixed(2)}m long, too short for a ${width.toFixed(2)}m opening`,
)
}
// `position` is public MCP ergonomics: 0..1 along the wall. Door/window
// nodes store wall-local meters in position[0], so convert before writing.
const base = {
wallId,
width,
height,
position: [wallLocalXFromT(wall, position, width), height / 2, 0] as [
number,
number,
number,
],
}
const opening =
type === 'door'
? DoorNode.parse(base)
: WindowNode.parse({
...base,
position: [base.position[0], 0.9 + height / 2, 0],
})
const id = bridge.createNode(opening, wallId as AnyNodeId)
await publishLiveSceneSnapshot(bridge, 'cut_opening')
const payload = { openingId: id as string }
return {
content: [{ type: 'text' as const, text: JSON.stringify(payload) }],
structuredContent: payload,
}
},
)
}