@pascal-app/core 1.0.4 → 1.0.5

package/dist/agent-operations/__fixtures__/cases.js

@@ -1,10 +1,21 @@
 import { BuildingNode, CeilingNode, DoorNode, GuideNode, ItemNode, LevelNode, RoofNode, RoofSegmentNode, SlabNode, StairNode, StairSegmentNode, UnitNode, WallNode, WindowNode, ZoneNode, } from '../../schema/index.js';
+import { ADD_STAIR_CASES } from './add-stair-cases.js';
 import { CREATE_ROOM_CASES, FURNISH_ROOM_CASES } from './build-room-cases.js';
 import { PLACE_ITEMS_CASES } from './place-items-cases.js';
 import { FIND_BY_TYPE_CASES } from './find-by-type-cases.js';
+import { FINISH_CASES } from './finish-cases.js';
+import { LOT_INFO_CASES } from './lot-info-cases.js';
+import { CREATE_ROOF_CASES, MOVE_ROOFS_CASES } from './roof-cases.js';
 import { ROOM_CASES } from './room-cases.js';
+import { CHECK_ROOMS_CASES, VALIDATE_SCENE_CASES } from './scene-check-cases.js';
 import { SEARCH_ASSETS_CASES } from './search-assets-cases.js';
-import { ADD_LEVEL_CASES, ADD_WALL_CASES, CREATE_STAIR_CASES } from './structure-cases.js';
+import { VIEW_ASSETS_CASES } from './view-assets-cases.js';
+import { DESIGN_BRIEF_CASES } from './design-brief-cases.js';
+import { CORNER_WINDOW_CASES } from './corner-window-cases.js';
+import { MERGE_WINDOWS_CASES } from './merge-windows-cases.js';
+import { DESCRIBE_NODE_CASES, FIND_NODES_CASES } from './node-read-cases.js';
+import { GET_SITE_CASES, PLACE_BUILDING_CASES, SITE_LINE_CASES, SITE_VERIFY_CASES, } from './site-cases.js';
+import { ADD_FENCE_CASES, ADD_LEVEL_CASES, ADD_WALL_CASES, CREATE_STAIR_CASES, } from './structure-cases.js';
 import { VERIFY_SCENE_CASES } from './verify-scene-cases.js';
 const graph = (...nodes) => ({
     nodes: Object.fromEntries(nodes.map((node) => [node.id, node])),
@@ -155,6 +166,38 @@ function houseScene() {
     return graph(house, ground, upper, roofLevel, flat, wall, door, window, sideWall, zone, slab, ceiling, lamp, sofa, stair, flight, plan, upperWall, roof, roofSegment, shed, shedLevel);
 }
 const emptyScene = () => ({ nodes: {}, rootNodeIds: [] });
+/** Base chains are not the room/region finish, nor a promise that a ref renders. */
+export function finishReadbackScene() {
+    const scene = houseScene();
+    const wall = scene.nodes.wall_ground;
+    scene.nodes.wall_ground = {
+        ...wall,
+        slots: { a: 'library:concrete-drywall' },
+        faceRegions: [{ id: 'wainscot', face: 'a', v1: 0.9, finish: 'library:wood' }],
+    };
+    scene.nodes.wall_side = {
+        ...scene.nodes.wall_side,
+        legacyFaceMaterials: {
+            a: { material: { preset: 'white' }, materialPreset: 'library:preset-white' },
+        },
+        materialPreset: 'library:legacy-wall',
+    };
+    scene.nodes.zone_ground = {
+        ...scene.nodes.zone_ground,
+        boundaryWallIds: [wall.id],
+        wallMaterial: 'library:preset-white',
+        wallOverrides: [{ wallId: wall.id, face: 'a', finish: 'library:local-tile' }],
+    };
+    return scene;
+}
+/** Reject non-finite layout endpoints before JSON can silently turn them into null. */
+export function finiteReadbackProblems(value, path = 'result') {
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? [] : [`${path} is not finite`];
+    if (!value || typeof value !== 'object')
+        return [];
+    return Object.entries(value).flatMap(([key, entry]) => finiteReadbackProblems(entry, `${path}.${key}`));
+}
 /** A level no building holds. */
 function orphanLevelScene() {
     const level = LevelNode.parse({ id: 'level_orphan', level: 0 });
@@ -207,7 +250,6 @@ export const LIST_LEVELS_CASES = [
         scene: houseScene,
         input: {},
         context: { activeLevelId: 'level_upper' },
-        surfaces: ['core', 'chat'],
         expect: {
             result: {
                 activeLevelId: 'level_upper',
@@ -284,7 +326,6 @@ export const LEVEL_TARGET_CASES = [
         scene: houseScene,
         input: {},
         context: { activeLevelId: 'level_upper' },
-        surfaces: ['core', 'chat'],
         expect: { result: { levelId: 'level_upper' } },
     },
     {
@@ -355,6 +396,10 @@ export const GET_WALLS_CASES = [
                         height: 2.5,
                         resolvedHeight: 2.5,
                         heightIsExplicit: true,
+                        wallFaceChains: {
+                            a: { kind: 'default', ref: 'library:concrete-drywall' },
+                            b: { kind: 'default', ref: 'library:concrete-drywall' },
+                        },
                         openings: [
                             { id: 'door_ground', type: 'door' },
                             { id: 'window_ground', type: 'window' },
@@ -365,6 +410,10 @@ export const GET_WALLS_CASES = [
                         length: 4,
                         resolvedHeight: 2.8,
                         heightIsExplicit: false,
+                        wallFaceChains: {
+                            a: { kind: 'default', ref: 'library:concrete-drywall' },
+                            b: { kind: 'default', ref: 'library:concrete-drywall' },
+                        },
                         openings: [],
                     },
                 ],
@@ -393,6 +442,79 @@ export const GET_ZONES_CASES = [
                         ],
                         areaSqMeters: 12,
                         bounds: { width: 4, depth: 3 },
+                        wallMaterial: null,
+                        wallOverrides: [],
+                    },
+                ],
+            },
+        },
+    },
+];
+// Approved readback contract: preserve provenance, including a deliberate choice identical to
+// the fallback. Literal oracles deliberately do not call the finish resolver under test.
+export const FINISH_READBACK_CASES = [
+    ...['get_walls', 'get_level_summary'].map((tool) => ({
+        name: 'base face chains distinguish chosen default, unchosen default and legacy finishes',
+        tool,
+        scene: finishReadbackScene,
+        input: { levelId: 'level_ground' },
+        expect: {
+            result: {
+                walls: [
+                    {
+                        id: 'wall_ground',
+                        wallFaceChains: {
+                            a: { kind: 'ref', ref: 'library:concrete-drywall' },
+                            b: { kind: 'default', ref: 'library:concrete-drywall' },
+                        },
+                    },
+                    {
+                        id: 'wall_side',
+                        wallFaceChains: {
+                            a: {
+                                kind: 'legacy',
+                                spec: { material: { preset: 'white' }, materialPreset: 'library:preset-white' },
+                            },
+                            b: { kind: 'legacy', spec: { materialPreset: 'library:legacy-wall' } },
+                        },
+                    },
+                ],
+            },
+            check: (result) => finiteReadbackProblems(result),
+        },
+    })),
+    {
+        name: 'a chosen white room default and local face paint are persisted intent',
+        tool: 'get_zones',
+        scene: finishReadbackScene,
+        input: { levelId: 'level_ground' },
+        expect: {
+            result: {
+                zones: [
+                    {
+                        id: 'zone_ground',
+                        wallMaterial: 'library:preset-white',
+                        wallOverrides: [{ wallId: 'wall_ground', face: 'a', finish: 'library:local-tile' }],
+                    },
+                ],
+            },
+            check: (result) => finiteReadbackProblems(result),
+        },
+    },
+    {
+        name: 'another storey does not inherit the painted storey base chains',
+        tool: 'get_walls',
+        scene: finishReadbackScene,
+        input: { levelId: 'level_upper' },
+        expect: {
+            result: {
+                walls: [
+                    {
+                        id: 'wall_upper',
+                        wallFaceChains: {
+                            a: { kind: 'default', ref: 'library:concrete-drywall' },
+                            b: { kind: 'default', ref: 'library:concrete-drywall' },
+                        },
                     },
                 ],
             },
@@ -566,7 +688,6 @@ export const DUPLICATE_LEVEL_CASES = [
         scene: houseScene,
         input: {},
         context: { activeLevelId: 'level_upper' },
-        surfaces: ['core', 'chat'],
         expect: { result: { floorIndex: 2, copied: { level: 1, wall: 1 } } },
     },
     {
@@ -666,6 +787,44 @@ export const DELETE_NODE_CASES = [
         expect: { refusal: 'node_not_found', mentions: ['wall_missing'] },
     },
 ];
+/** The house's stair with design targets of its own, none of them the defaults. */
+const OWN_TARGETS = { maxRiserHeight: 0.19, minimumGoing: 0.26, targetGoing: 0.3, minimumHeadroom: 2.1 };
+function targetedStairScene() {
+    const scene = houseScene();
+    scene.nodes.stair_main = { ...scene.nodes.stair_main, designTargets: OWN_TARGETS };
+    return scene;
+}
+/** fit_stair's sizes and targets, said in inches (N1). */
+const FIT_STAIR_CASES = [
+    {
+        name: 'a straight flight 42 in wide',
+        tool: 'fit_stair',
+        scene: houseScene,
+        input: { stairId: 'stair_main', layout: 'straight', width: '42 in' },
+        expect: { result: { stairId: 'stair_main' }, after: { stair_main: { width: 1.0668 } } },
+    },
+    {
+        name: 'a target in inches changes that target, the stair keeps its others',
+        tool: 'fit_stair',
+        scene: targetedStairScene,
+        input: { stairId: 'stair_main', targets: { maxRiserHeight: '7 in' } },
+        expect: {
+            result: { stairId: 'stair_main' },
+            after: { stair_main: { designTargets: { ...OWN_TARGETS, maxRiserHeight: 0.1778 } } },
+        },
+    },
+    {
+        // The partial schema used to fill every target left out with its default.
+        name: 'a target given alone leaves the others as the stair has them, not the defaults',
+        tool: 'fit_stair',
+        scene: targetedStairScene,
+        input: { stairId: 'stair_main', targets: { targetGoing: 0.29 } },
+        expect: {
+            result: { stairId: 'stair_main' },
+            after: { stair_main: { designTargets: { ...OWN_TARGETS, targetGoing: 0.29 } } },
+        },
+    },
+];
 /** Every table the three runners run. */
 export const AGENT_TOOL_CASES = [
     ...LIST_LEVELS_CASES,
@@ -674,16 +833,36 @@ export const AGENT_TOOL_CASES = [
     ...GET_WALLS_CASES,
     ...GET_ZONES_CASES,
     ...GET_LEVEL_SUMMARY_CASES,
+    ...FINISH_READBACK_CASES,
     ...DUPLICATE_LEVEL_CASES,
     ...VERIFY_SCENE_CASES,
+    ...VALIDATE_SCENE_CASES,
+    ...CHECK_ROOMS_CASES,
     ...DELETE_NODE_CASES,
     ...ROOM_CASES,
     ...CREATE_ROOM_CASES,
     ...FURNISH_ROOM_CASES,
     ...SEARCH_ASSETS_CASES,
+    ...VIEW_ASSETS_CASES,
+    ...DESIGN_BRIEF_CASES,
     ...ADD_WALL_CASES,
+    ...ADD_FENCE_CASES,
+    ...CREATE_ROOF_CASES,
+    ...MOVE_ROOFS_CASES,
     ...ADD_LEVEL_CASES,
     ...CREATE_STAIR_CASES,
+    ...ADD_STAIR_CASES,
+    ...FIT_STAIR_CASES,
     ...PLACE_ITEMS_CASES,
     ...FIND_BY_TYPE_CASES,
+    ...FIND_NODES_CASES,
+    ...DESCRIBE_NODE_CASES,
+    ...CORNER_WINDOW_CASES,
+    ...MERGE_WINDOWS_CASES,
+    ...GET_SITE_CASES,
+    ...LOT_INFO_CASES,
+    ...PLACE_BUILDING_CASES,
+    ...SITE_LINE_CASES,
+    ...SITE_VERIFY_CASES,
+    ...FINISH_CASES,
 ];

package/dist/agent-operations/__fixtures__/corner-window-cases.d.ts

@@ -0,0 +1,3 @@
+import type { AgentToolCase } from './cases.js';
+export declare const CORNER_WINDOW_CASES: AgentToolCase[];
+//# sourceMappingURL=corner-window-cases.d.ts.map

package/dist/agent-operations/__fixtures__/corner-window-cases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corner-window-cases.d.ts","sourceRoot":"","sources":["../../../src/agent-operations/__fixtures__/corner-window-cases.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,SAAS,CAAA;AAgExD,eAAO,MAAM,mBAAmB,EAAE,aAAa,EAiG9C,CAAA"}

package/dist/agent-operations/__fixtures__/corner-window-cases.js

@@ -0,0 +1,155 @@
+import { BuildingNode, LevelNode, WallNode } from '../../schema/index.js';
+/**
+ * `add_corner_window`: a window that wraps the corner of a bay, built as one window on one face and
+ * recorded built until this tool. What goes wrong, written first: the two sides not joined or not
+ * reaching the corner; a bay's 135° refused or squared; a side wider than its wall, a point no two
+ * walls meet at, or a corner too shallow to be one, built anyway.
+ */
+/** Wall A runs into the corner at the origin; wall B leaves it at `degrees` from A. */
+function cornerScene(degrees) {
+    const rad = (degrees * Math.PI) / 180;
+    const a = WallNode.parse({ id: 'wall_ca', parentId: 'level_c', start: [4, 0], end: [0, 0] });
+    const b = WallNode.parse({
+        id: 'wall_cb',
+        parentId: 'level_c',
+        start: [0, 0],
+        end: [3 * Math.cos(rad), 3 * Math.sin(rad)],
+    });
+    const level = LevelNode.parse({ id: 'level_c', parentId: 'building_c', children: [a.id, b.id] });
+    const building = BuildingNode.parse({ id: 'building_c', children: [level.id] });
+    const nodes = [building, level, a, b];
+    return {
+        nodes: Object.fromEntries(nodes.map((node) => [node.id, node])),
+        rootNodeIds: [building.id],
+    };
+}
+/** Two storeys of the same square corner, stacked: their walls end at the same plan points. */
+function stackedScene() {
+    const ground = cornerScene(90);
+    const walls = ['wall_ca', 'wall_cb'].map((id) => WallNode.parse({
+        ...ground.nodes[id],
+        id: `${id}_up`,
+        parentId: 'level_u',
+    }));
+    const upper = LevelNode.parse({
+        id: 'level_u',
+        parentId: 'building_c',
+        level: 1,
+        children: walls.map((wall) => wall.id),
+    });
+    const building = BuildingNode.parse({ id: 'building_c', children: ['level_c', upper.id] });
+    return {
+        nodes: {
+            ...ground.nodes,
+            building_c: building,
+            [upper.id]: upper,
+            ...Object.fromEntries(walls.map((wall) => [wall.id, wall])),
+        },
+        rootNodeIds: ground.rootNodeIds,
+    };
+}
+const joined = (result, nodes) => {
+    const windows = result.windowIds.map((id) => nodes[id]);
+    const [a, b] = windows;
+    return a?.corner?.partnerId === b?.id && b?.corner?.partnerId === a?.id
+        ? []
+        : [`not joined: ${JSON.stringify(windows.map((w) => w?.corner))}`];
+};
+export const CORNER_WINDOW_CASES = [
+    {
+        name: 'two windows run to a square corner, joined, the glass fused',
+        tool: 'add_corner_window',
+        scene: () => cornerScene(90),
+        input: { corner: [0, 0], width: 1.2 },
+        expect: { result: { ok: true, wallIds: ['wall_ca', 'wall_cb'], post: 'none' }, check: joined },
+    },
+    {
+        name: "a bay's 135° corner, a side of its own width, with a post",
+        tool: 'add_corner_window',
+        scene: () => cornerScene(135),
+        input: { corner: [0, 0], width: 1.2, widths: { wall_cb: 0.9 }, post: 'post' },
+        expect: {
+            result: { ok: true, angle: 135, post: 'post' },
+            check: (result, nodes) => {
+                const sides = result.windowIds.map((id) => nodes[id]);
+                const onB = sides.find((window) => window.parentId === 'wall_cb');
+                return [
+                    ...joined(result, nodes),
+                    ...(onB?.width === 0.9 ? [] : [`wall_cb side ${onB?.width} m`]),
+                ];
+            },
+        },
+    },
+    {
+        name: 'a point where no two walls meet is refused',
+        tool: 'add_corner_window',
+        scene: () => cornerScene(90),
+        input: { corner: [2, 0], width: 1 },
+        expect: { refusal: 'no_corner', mentions: ['get_walls'] },
+    },
+    {
+        name: 'a corner nearly straight is refused, pointing to add_window',
+        tool: 'add_corner_window',
+        scene: () => cornerScene(176),
+        input: { corner: [0, 0], width: 1 },
+        expect: { refusal: 'corner_angle', mentions: ['add_window'] },
+    },
+    {
+        name: 'a side wider than its wall is refused, naming the wall',
+        tool: 'add_corner_window',
+        scene: () => cornerScene(90),
+        input: { corner: [0, 0], width: 3.5 },
+        expect: { refusal: 'width_exceeds_wall', mentions: ['wall_cb'] },
+    },
+    {
+        name: 'a style on a sliding corner window is refused and nothing is written',
+        tool: 'add_corner_window',
+        scene: () => cornerScene(90),
+        input: { corner: [0, 0], width: 1, windowType: 'sliding', style: 'double-hung' },
+        expect: { refusal: 'style_needs_fixed_window', mentions: ["'fixed'", 'sliding'] },
+    },
+    // Stacked storeys share their corners' points: with no level named the corner was ambiguous on
+    // every multi-storey house, and two walls named from two floors made one window across both.
+    {
+        name: 'on a two-storey house, the corner of the level named',
+        tool: 'add_corner_window',
+        scene: stackedScene,
+        input: { corner: [0, 0], width: 1.2, levelId: 'level_u' },
+        expect: {
+            result: { ok: true, wallIds: ['wall_ca_up', 'wall_cb_up'] },
+            check: joined,
+        },
+    },
+    {
+        name: 'on a two-storey house, with no level named, the corner of the floor in view',
+        tool: 'add_corner_window',
+        scene: stackedScene,
+        surfaces: ['core', 'mcp'],
+        context: { activeLevelId: 'level_u' },
+        input: { corner: [0, 0], width: 1.2 },
+        expect: { result: { ok: true, wallIds: ['wall_ca_up', 'wall_cb_up'] } },
+    },
+    {
+        name: 'two walls named from two floors are no corner',
+        tool: 'add_corner_window',
+        scene: stackedScene,
+        context: { activeLevelId: 'level_c' },
+        input: { corner: [0, 0], width: 1.2, wallIds: ['wall_ca', 'wall_cb_up'] },
+        expect: { refusal: 'no_corner', mentions: ['level_c'] },
+    },
+    // A casement keeps its frames at the corner: "fused glass" was offered, and drawn as frames.
+    {
+        name: 'a casement corner window meets at a post',
+        tool: 'add_corner_window',
+        scene: () => cornerScene(90),
+        input: { corner: [0, 0], width: 1, windowType: 'casement' },
+        expect: { result: { ok: true, post: 'post' }, check: joined },
+    },
+    {
+        name: 'fused glass on a casement corner window is refused',
+        tool: 'add_corner_window',
+        scene: () => cornerScene(90),
+        input: { corner: [0, 0], width: 1, windowType: 'casement', post: 'none' },
+        expect: { refusal: 'corner_not_fused', mentions: ['casement', 'fixed'] },
+    },
+];

package/dist/agent-operations/__fixtures__/design-brief-cases.d.ts

@@ -0,0 +1,14 @@
+import type { Beyond, BriefAxes, DesignBrief } from '../../agent-tools/design-brief.js';
+import type { AgentToolCase } from './cases.js';
+/** Seven of the eight layers name pieces: what an open request owes. */
+export declare const DRESSED: Beyond;
+/** The owner's bedroom, read axis by axis: action, size, pieces (a minimum) and openings bounded; style, materials and dressing open. */
+export declare const BEDROOM_AXES: BriefAxes;
+/** "add a lamp next to the sofa": action and dressing bounded by the same words, style open. */
+export declare const LAMP_AXES: BriefAxes;
+/** Every axis open, for the briefs whose subject is the source or the gate, not the reading. */
+export declare const OPEN_AXES: BriefAxes;
+/** A brief that opens every furnishing tool, for the tests whose subject is not the gate. */
+export declare const CATALOG_BRIEF: DesignBrief;
+export declare const DESIGN_BRIEF_CASES: AgentToolCase[];
+//# sourceMappingURL=design-brief-cases.d.ts.map

package/dist/agent-operations/__fixtures__/design-brief-cases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-brief-cases.d.ts","sourceRoot":"","sources":["../../../src/agent-operations/__fixtures__/design-brief-cases.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AA8B5C,wEAAwE;AACxE,eAAO,MAAM,OAAO,EAAE,MASrB,CAAA;AA8BD,yIAAyI;AACzI,eAAO,MAAM,YAAY,EAAE,SAY1B,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,SAAS,EAAE,SAQvB,CAAA;AAaD,gGAAgG;AAChG,eAAO,MAAM,SAAS,EAAE,SAQvB,CAAA;AA0BD,6FAA6F;AAC7F,eAAO,MAAM,aAAa,EAAE,WAO3B,CAAA;AAWD,eAAO,MAAM,kBAAkB,EAAE,aAAa,EA4jB7C,CAAA"}