f66dcd438b
Measurement/angle parameters on the scene tools now accept a bare number OR a
natural-language string ("6 in", "180cm", "45°", "1.57rad"), canonicalized to
the unit the handler already expects (meters for length, radians/degrees for
angles) with min/max bounds and model-readable errors. Makes LLM tool calls
safer — "6 in" no longer has to be pre-converted to 0.1524, and a bad value is
rejected with a message the model can self-correct from.
A shared `measurement(kind, unit)` zod field wraps lingo's parseQuantity as a
`number | string` union+transform; numbers pass through unchanged (backward
compatible), so no handler changes were needed. Covers create_wall, cut_opening,
place_item, create_level, create_story_shell, create_roof,
create_stair_between_levels, create_room, add_door, add_window, photo_to_scene.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
112 lines
3.9 KiB
TypeScript
112 lines
3.9 KiB
TypeScript
import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
|
|
import type { AnyNodeId } from '@pascal-app/core/schema'
|
|
import { ItemNode } from '@pascal-app/core/schema'
|
|
import { z } from 'zod'
|
|
import type { SceneOperations } from '../operations'
|
|
import { findCatalogItem } from './asset-catalog'
|
|
import { ErrorCode, throwMcpError } from './errors'
|
|
import { projectWorldPointToWallLocalX, wallLength } from './geometry'
|
|
import { publishLiveSceneSnapshot } from './live-sync'
|
|
import { measurement } from './measurement'
|
|
import { NodeIdSchema, Vec3Schema } from './schemas'
|
|
|
|
export const placeItemInput = {
|
|
catalogItemId: z.string().min(1),
|
|
targetNodeId: NodeIdSchema,
|
|
position: Vec3Schema,
|
|
rotation: measurement('angle', 'rad', { description: 'Y-axis rotation.' }).optional(),
|
|
}
|
|
|
|
export const placeItemOutput = {
|
|
itemId: z.string(),
|
|
status: z.string().optional(),
|
|
}
|
|
|
|
export function registerPlaceItem(server: McpServer, bridge: SceneOperations): void {
|
|
server.registerTool(
|
|
'place_item',
|
|
{
|
|
title: 'Place item',
|
|
description:
|
|
'Place a catalog item into the scene. Target a level/slab/zone for floor items, a wall for wall-attached items, or a ceiling for ceiling-attached items. Do not target the site node directly.',
|
|
inputSchema: placeItemInput,
|
|
outputSchema: placeItemOutput,
|
|
},
|
|
async ({ catalogItemId, targetNodeId, position, rotation }) => {
|
|
const target = bridge.getNode(targetNodeId as AnyNodeId)
|
|
if (!target) {
|
|
throwMcpError(ErrorCode.InvalidParams, `Target node not found: ${targetNodeId}`)
|
|
}
|
|
const targetType = target.type
|
|
if (
|
|
targetType !== 'level' &&
|
|
targetType !== 'slab' &&
|
|
targetType !== 'zone' &&
|
|
targetType !== 'wall' &&
|
|
targetType !== 'ceiling'
|
|
) {
|
|
throwMcpError(
|
|
ErrorCode.InvalidRequest,
|
|
`Cannot place item on ${targetType}; target must be a level, slab, zone, wall, or ceiling. Site-level placement is not supported yet because site.children is reserved for buildings.`,
|
|
)
|
|
}
|
|
|
|
const catalogAsset = findCatalogItem(catalogItemId)
|
|
const baseAsset = catalogAsset ?? {
|
|
id: catalogItemId,
|
|
name: catalogItemId,
|
|
category: 'unknown',
|
|
thumbnail: '',
|
|
src: 'asset://placeholder',
|
|
dimensions: [0.5, 0.5, 0.5] as [number, number, number],
|
|
offset: [0, 0, 0] as [number, number, number],
|
|
rotation: [0, 0, 0] as [number, number, number],
|
|
scale: [1, 1, 1] as [number, number, number],
|
|
}
|
|
|
|
const requestedPosition = position as [number, number, number]
|
|
const parentId =
|
|
targetType === 'slab' || targetType === 'zone'
|
|
? bridge.resolveLevelId(targetNodeId as AnyNodeId)
|
|
: targetNodeId
|
|
|
|
if (!parentId) {
|
|
throwMcpError(
|
|
ErrorCode.InvalidParams,
|
|
`Could not resolve a level parent for target ${targetNodeId}`,
|
|
)
|
|
}
|
|
|
|
const wallExtras: { wallId: string; wallT: number } | Record<string, never> = {}
|
|
let itemPosition = requestedPosition
|
|
|
|
if (targetType === 'wall') {
|
|
const localX = projectWorldPointToWallLocalX(target, requestedPosition)
|
|
const length = wallLength(target)
|
|
itemPosition = [localX, requestedPosition[1], 0]
|
|
Object.assign(wallExtras, {
|
|
wallId: targetNodeId,
|
|
wallT: length === 0 ? 0 : localX / length,
|
|
})
|
|
}
|
|
|
|
const item = ItemNode.parse({
|
|
position: itemPosition,
|
|
rotation: [0, rotation ?? 0, 0],
|
|
asset: baseAsset,
|
|
...wallExtras,
|
|
})
|
|
const id = bridge.createNode(item, parentId as AnyNodeId)
|
|
await publishLiveSceneSnapshot(bridge, 'place_item')
|
|
const payload = {
|
|
itemId: id as string,
|
|
status: catalogAsset ? 'ok' : 'catalog_unavailable',
|
|
}
|
|
return {
|
|
content: [{ type: 'text' as const, text: JSON.stringify(payload) }],
|
|
structuredContent: payload,
|
|
}
|
|
},
|
|
)
|
|
}
|