@pascal-app/core 1.0.6 → 1.1.0

package/dist/agent-tools/contract.d.ts

@@ -10,6 +10,8 @@ export type AgentToolAnnotations = {
     idempotentHint?: boolean;
     openWorldHint?: boolean;
 };
+/** The surfaces that register a shared agent tool: the MCP server and the hosted chat. */
+export type AgentToolSurface = 'mcp' | 'chat';
 /**
  * One agent tool as every surface registers it: the name and description the agent reads, and its
  * input schema. Zod only, so it can be imported where the hosted chat declares its tools.
@@ -17,10 +19,18 @@ export type AgentToolAnnotations = {
 export type AgentToolContract<Input extends Record<string, z.ZodType> = Record<string, z.ZodType>> = {
     name: string;
     title: string;
+    /** True on every surface: what one surface alone does goes in `surfaceNotes`. */
     description: string;
+    /**
+     * What only one surface's agent reads, where the tool behaves differently there (what renders
+     * a view, how long a record lasts). A surface registers `surfaceDescription(contract, surface)`.
+     */
+    surfaceNotes?: Partial<Record<AgentToolSurface, string>>;
     input: Input;
     annotations?: AgentToolAnnotations;
 };
+/** The description `surface` registers: the shared text, then that surface's own note. */
+export declare function surfaceDescription(contract: Pick<AgentToolContract, 'description' | 'surfaceNotes'>, surface: AgentToolSurface): string;
 /**
  * Where a plugin's tool runs. `'operation'`: a pure `AgentOperation` over the scene's nodes,
  * exported from the plugin's `./agent-operations`, so any surface can run it, a server included.

package/dist/agent-tools/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/agent-tools/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAC/F;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,KAAK,CAAA;IACZ,WAAW,CAAC,EAAE,oBAAoB,CAAA;CACnC,CAAA;AAEH;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,QAAQ,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG;IAChD,MAAM,EAAE,wBAAwB,CAAA;IAChC,yFAAyF;IACzF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,uGAAuG;AACvG,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,oGAAoG;IACpG,QAAQ,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,UAAU,EAAE,CAAC,CAAA;IACb;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,eAAe,EAAE,CAAA;IACjC,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAC/B,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/agent-tools/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,0FAA0F;AAC1F,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,CAAA;AAE7C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAC/F;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAA;IACxD,KAAK,EAAE,KAAK,CAAA;IACZ,WAAW,CAAC,EAAE,oBAAoB,CAAA;CACnC,CAAA;AAEH,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,cAAc,CAAC,EACjE,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAGR;AAED;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,QAAQ,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG;IAChD,MAAM,EAAE,wBAAwB,CAAA;IAChC,yFAAyF;IACzF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,uGAAuG;AACvG,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,oGAAoG;IACpG,QAAQ,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,UAAU,EAAE,CAAC,CAAA;IACb;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,eAAe,EAAE,CAAA;IACjC,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAC/B,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA"}

package/dist/agent-tools/contract.js

@@ -1 +1,5 @@
-export {};
+/** The description `surface` registers: the shared text, then that surface's own note. */
+export function surfaceDescription(contract, surface) {
+    const note = contract.surfaceNotes?.[surface];
+    return note ? `${contract.description}\n${note}` : contract.description;
+}

package/dist/agent-tools/corner-window.d.ts

@@ -27,6 +27,7 @@ export declare const addCornerWindowTool: {
             louvered: "louvered";
             "single-hung": "single-hung";
             sliding: "sliding";
+            "tilt-turn": "tilt-turn";
         }>>;
         style: z.ZodOptional<z.ZodEnum<{
             casement: "casement";

package/dist/agent-tools/corner-window.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"corner-window.d.ts","sourceRoot":"","sources":["../../src/agent-tools/corner-window.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkD/B,CAAA"}
+{"version":3,"file":"corner-window.d.ts","sourceRoot":"","sources":["../../src/agent-tools/corner-window.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkD/B,CAAA"}

package/dist/agent-tools/corner-window.js

@@ -6,7 +6,7 @@ import { measurement } from './measurement.js';
 export const addCornerWindowTool = {
     name: 'add_corner_window',
     title: 'Add corner window',
-    description: "A window that wraps the corner where two walls meet: one window on each wall, both running to the corner and joined, the glass fused at the corner (post none, a fixed window's default) or meeting at a thin post (post post). Any angle the walls make, a bay's 135° as well as a square or an acute corner. The corner is the point the two walls end at ([x, z], as get_walls gives their ends); width is how far the glass runs along each wall from the corner, the same on both unless widths names a wall. Each side is placed by add_window's rules (height, sillHeight, windowType, style the same on both sides; with no sillHeight, centred on the lower of the two walls). The walls are the level's (levelId, default the floor the person is viewing): stacked storeys share their corners' points. Refused with a code: no_corner where no two walls of the level end at the point, corner_ambiguous where more than two do (name two with wallIds), corner_angle for a corner nearly folded back or nearly straight, corner_not_fused for post none on a window type other than fixed, width_exceeds_wall. Returns windowIds and wallIds; the editor's window panel shows the pair under Corner.",
+    description: "Add a window that wraps the corner where two walls meet, one window on each wall joined at the corner, and return their windowIds and wallIds. Both run to the corner, the glass fused there (post none, a fixed window's default) or meeting at a thin post (post post). Any angle the walls make, a bay's 135° as well as a square or an acute corner. The corner is the point the two walls end at ([x, z], as get_walls gives their ends); width is how far the glass runs along each wall from the corner, the same on both unless widths names a wall. Each side is placed by add_window's rules (height, sillHeight, windowType, style the same on both sides; with no sillHeight, centred on the lower of the two walls). The walls are the level's (levelId, default the floor the person is viewing): stacked storeys share their corners' points. Refused with a code: no_corner where no two walls of the level end at the point, corner_ambiguous where more than two do (name two with wallIds), corner_angle for a corner nearly folded back or nearly straight, corner_not_fused for post none on a window type other than fixed, width_exceeds_wall. The editor's window panel shows the pair under Corner.",
     input: {
         corner: z
             .array(z.number())

package/dist/agent-tools/create-room.d.ts

@@ -14,10 +14,41 @@ export declare const createRoomTool: {
         rename: z.ZodOptional<z.ZodBoolean>;
         outdoor: z.ZodOptional<z.ZodBoolean>;
         doors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            sidelightLeft: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+            sidelightRight: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+            transomHeight: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+            leafCount: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<6>, z.ZodLiteral<8>]>>;
+            slidingStyle: z.ZodOptional<z.ZodEnum<{
+                bypass: "bypass";
+                patio: "patio";
+            }>>;
+            slideDirection: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                right: "right";
+            }>>;
             wallIndex: z.ZodNumber;
             t: z.ZodOptional<z.ZodNumber>;
+            doorType: z.ZodOptional<z.ZodEnum<{
+                barn: "barn";
+                double: "double";
+                folding: "folding";
+                french: "french";
+                "garage-rollup": "garage-rollup";
+                "garage-sectional": "garage-sectional";
+                "garage-tiltup": "garage-tiltup";
+                hinged: "hinged";
+                pocket: "pocket";
+                sliding: "sliding";
+            }>>;
             width: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
             height: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+            handleStyle: z.ZodOptional<z.ZodEnum<{
+                bar: "bar";
+                knob: "knob";
+                lever: "lever";
+                "lever-curved": "lever-curved";
+                plate: "plate";
+            }>>;
             hingesSide: z.ZodOptional<z.ZodEnum<{
                 left: "left";
                 right: "right";
@@ -40,8 +71,62 @@ export declare const createRoomTool: {
             }>>;
         }, z.core.$strip>>>;
         windows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            hingesSide: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                right: "right";
+            }>>;
+            openingDirection: z.ZodOptional<z.ZodEnum<{
+                inward: "inward";
+                outward: "outward";
+            }>>;
+            tiltTurnMode: z.ZodOptional<z.ZodEnum<{
+                tilt: "tilt";
+                turn: "turn";
+            }>>;
+            rollerShutter: z.ZodOptional<z.ZodEnum<{
+                box: "box";
+                concealed: "concealed";
+                none: "none";
+            }>>;
+            rollerShutterBoxHeight: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+            rollerShutterOpen: z.ZodOptional<z.ZodNumber>;
+            shutterOpen: z.ZodOptional<z.ZodNumber>;
+            shutterSides: z.ZodOptional<z.ZodEnum<{
+                both: "both";
+                left: "left";
+                right: "right";
+            }>>;
+            sillOverhang: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+            sillInteriorDepth: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+            sillInteriorThickness: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+            sillInteriorOverhang: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+            columns: z.ZodOptional<z.ZodNumber>;
+            rows: z.ZodOptional<z.ZodNumber>;
+            windowHandle: z.ZodOptional<z.ZodBoolean>;
+            sashGrid: z.ZodOptional<z.ZodBoolean>;
+            sillInterior: z.ZodOptional<z.ZodBoolean>;
+            shutters: z.ZodOptional<z.ZodEnum<{
+                "board-batten": "board-batten";
+                louvered: "louvered";
+                none: "none";
+                panel: "panel";
+            }>>;
+            shutterWidth: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
             wallIndex: z.ZodNumber;
             t: z.ZodOptional<z.ZodNumber>;
+            windowType: z.ZodOptional<z.ZodEnum<{
+                awning: "awning";
+                bay: "bay";
+                bow: "bow";
+                casement: "casement";
+                "double-hung": "double-hung";
+                fixed: "fixed";
+                hopper: "hopper";
+                louvered: "louvered";
+                "single-hung": "single-hung";
+                sliding: "sliding";
+                "tilt-turn": "tilt-turn";
+            }>>;
             width: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
             height: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
             sillHeight: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;

package/dist/agent-tools/create-room.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-room.d.ts","sourceRoot":"","sources":["../../src/agent-tools/create-room.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAuBvB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8F1B,CAAA"}
+{"version":3,"file":"create-room.d.ts","sourceRoot":"","sources":["../../src/agent-tools/create-room.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAyBvB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmG1B,CAAA"}

package/dist/agent-tools/create-room.js

@@ -1,8 +1,10 @@
 import { z } from 'zod';
 import { DOOR_STYLES, WINDOW_STYLES } from '../building/opening-style-presets.js';
 import { FOUNDATION_BY_REGION_NOTE } from '../lib/foundation-construction.js';
+import { DoorHandleStyle, DoorType, WindowType } from '../schema/nodes/opening-types.js';
 import { levelTarget } from './levels.js';
 import { measurement } from './measurement.js';
+import { doorDetailFields, windowDetailFields } from './wall-openings.js';
 // A list of two, not a tuple: a tuple's list-form schema is refused by some clients.
 const point = z.array(z.number()).length(2);
 const onEdge = {
@@ -21,7 +23,7 @@ const onEdge = {
 export const createRoomTool = {
     name: 'create_room',
     title: 'Create room',
-    description: "Create a room on a level from its polygon: a wall per edge, an edge a wall already runs along reusing that wall (rooms share their boundary with their neighbour), and the room zone that names it. The floor plate and the ceiling are derived from the room — never author a slab or a ceiling for it. Declare the room's doors and windows in the same call by polygon edge (wallIndex) and t along it, no wall ids needed; each is placed with add_door's and add_window's rules, and one that cannot be is skipped and listed in skippedOpenings with its code. Returns zoneId, slabId, ceilingId, wallIds in edge order (null where no wall), doorIds, windowIds. outdoor: true draws a terrace instead: separators where no wall runs, no walls of its own and no ceiling. Where the walls already enclose a room the reconciler numbered, the call names that room instead of adding a second one; where they enclose a room with a name of its own (not a number the editor gave it), it is refused (room_named_by_person) unless rename is true, which you pass only when the person asked for the rename, so a name is never changed silently.",
+    description: "Create a room on a level from its polygon: a wall per edge, an edge a wall already runs along reusing that wall (rooms share their boundary with their neighbour), and the room zone that names it. The floor plate and the ceiling are derived from the room — never author a slab or a ceiling for it. Declare the room's doors and windows in the same call by polygon edge (wallIndex) and t along it, no wall ids needed; each is placed with add_door's and add_window's rules, and one that cannot be is skipped and listed in skippedOpenings with its code. Returns zoneId, slabId, ceilingId, wallIds in edge order (null where no wall), doorIds, windowIds. outdoor: true draws a terrace instead: separators where no wall runs, no walls of its own and no ceiling. Where the walls already enclose a room the reconciler numbered, the call names that room instead of adding a second one; where they enclose a room with a name of its own (not a number the editor gave it), it is refused (room_named_by_person) unless rename is true, which you pass only when the person asked for the rename, so a name is never changed silently. Not available in run_batch: the result needs the floor plate and ceiling derived by the host after reconciliation.",
     input: {
         ...levelTarget,
         name: z.string().min(1).describe('Room name, e.g. "Bedroom", "Kitchen".'),
@@ -51,6 +53,8 @@ export const createRoomTool = {
         doors: z
             .array(z.object({
             ...onEdge,
+            ...doorDetailFields,
+            doorType: DoorType.optional(),
             width: measurement('length', 'm', {
                 positive: true,
                 description: 'Door width (default 0.9 m).',
@@ -59,6 +63,7 @@ export const createRoomTool = {
                 positive: true,
                 description: 'Door height (default 2.1 m).',
             }).optional(),
+            handleStyle: DoorHandleStyle.optional().describe('Door handle style (default lever).'),
             hingesSide: z.enum(['left', 'right']).optional().describe('Hinge side (default left).'),
             swingDirection: z
                 .enum(['inward', 'outward'])
@@ -74,6 +79,8 @@ export const createRoomTool = {
         windows: z
             .array(z.object({
             ...onEdge,
+            ...windowDetailFields,
+            windowType: WindowType.optional().describe('How it opens (default fixed).'),
             width: measurement('length', 'm', {
                 positive: true,
                 description: 'Window width (default 1.5 m).',