@pascal-app/core 1.1.0 → 1.1.2

package/dist/agent-operations/scene-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-view.d.ts","sourceRoot":"","sources":["../../src/agent-operations/scene-view.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scene-view.d.ts","sourceRoot":"","sources":["../../src/agent-operations/scene-view.ts"],"names":[],"mappings":"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"}

package/dist/agent-operations/scene-view.js

@@ -4,8 +4,9 @@ import { levelGradeStanding } from '../lib/grade-standing.js';
 import { buildingGroundBox, levelGroundBox, terrainBetweenEyeAndBox } from '../lib/ground-window.js';
 import { distanceToSegment } from '../lib/room-topology-index.js';
 import { buildingStreet } from '../lib/site-placement.js';
+import { roofFaceOf, roofFaceShapes } from '../registry/roofs.js';
 import { getActiveRoofHeight } from '../schema/index.js';
-import { isCeilingGeometry, isRoofGeometry } from '../services/roof-level.js';
+import { coveredStoreyId, isCeilingGeometry, isRoofGeometry } from '../services/roof-level.js';
 import { EXPLODED_GAP, getLevelElevations } from '../services/storey.js';
 import { stairFootprintAABB } from '../systems/stair/stair-footprint.js';
 import { resolveWallExteriorSide } from '../systems/wall/wall-assembly.js';
@@ -311,8 +312,9 @@ function siteBox(node, baseY) {
     return null;
 }
 /**
- * A roof's box: its segments' footprints in the plan, from the roof's seat to the highest peak. A
- * roof holds no wall, so a roof, or the roof level it stands on, framed nothing.
+ * A roof's box: its segments' footprints and its faces' outlines (`capabilities.roofs`) in the
+ * plan, from the roof's seat (its faces' lowest eave, theirs being their own heights) to the
+ * highest peak. A roof holds no wall, so a roof, or the roof level it stands on, framed nothing.
  */
 function roofBox(nodes, roof, baseY) {
     const seat = baseY + roof.position[1];
@@ -321,11 +323,18 @@ function roofBox(nodes, roof, baseY) {
         x * Math.sin(angle) + z * Math.cos(angle),
     ];
     const points = [];
-    let peak = seat;
+    let floor = Number.POSITIVE_INFINITY;
+    let peak = Number.NEGATIVE_INFINITY;
+    for (const face of roofFaceShapes(roof, nodes)) {
+        points.push(...face.outline);
+        floor = Math.min(floor, baseY + face.low);
+        peak = Math.max(peak, baseY + face.high);
+    }
     for (const id of roof.children ?? []) {
         const segment = nodes[id];
         if (segment?.type !== 'roof-segment')
             continue;
+        floor = Math.min(floor, seat);
         for (const [sx, sz] of [
             [-1, -1],
             [1, -1],
@@ -338,12 +347,12 @@ function roofBox(nodes, roof, baseY) {
             const [px, pz] = turn([cx + segment.position[0], cz + segment.position[2]], -roof.rotation);
             points.push([px + roof.position[0], pz + roof.position[2]]);
         }
-        peak = Math.max(peak, seat + segment.position[1] + segment.wallHeight + getActiveRoofHeight(segment));
+        peak = Math.max(peak, seat, seat + segment.position[1] + segment.wallHeight + getActiveRoofHeight(segment));
     }
     if (!points.length)
         return null;
     return tall({
-        min: [Math.min(...points.map((p) => p[0])), seat, Math.min(...points.map((p) => p[1]))],
+        min: [Math.min(...points.map((p) => p[0])), floor, Math.min(...points.map((p) => p[1]))],
         max: [Math.max(...points.map((p) => p[0])), peak, Math.max(...points.map((p) => p[1]))],
     }, 0.3);
 }
@@ -454,19 +463,35 @@ export function sceneViewBounds(nodes, targetId, presentation) {
         if (pose)
             return placed(hostedItemBox(target, pose, baseOf(pose.levelId)), pose.levelId);
     }
+    const unreadFace = (id) => {
+        const child = nodes[id];
+        return !!child?.type.includes(':') && !roofFaceOf(child);
+    };
+    // A roof holding faces this runtime cannot read (their plugin not registered here) frames the
+    // storey it covers as well, up to its own level's top.
+    const coveredByTarget = target?.type === 'roof' && (target.children ?? []).some(unreadFace)
+        ? coveredStoreyId(nodes, target)
+        : null;
     const site = target && nodes[target.parentId ?? '']?.type === 'level'
         ? levelChildBox(nodes, target, baseOf(target.parentId))
         : null;
-    if (site)
+    if (site && !coveredByTarget)
         return placed(site, target.parentId);
     const levelOf = (node) => (node.parentId ? nodes[node.parentId] : undefined);
     const outlines = [];
     // With no walls yet, what the level holds frames it: furniture placed from a plan before the
     // walls are built, a site with its paving and fences. The roofs frame with the walls, and so does
-    // a plugin's node (a roof plane), whose shape core cannot read: up to its storey's top.
+    // a plugin's node (a roof plane), whose shape core cannot read: up to its storey's top. A roof's
+    // faces are read through their kind (`capabilities.roofs`); a plugin's this runtime has not
+    // registered frames as one on the level would.
     const held = [];
     const roofs = [];
     let pluginTop = Number.NEGATIVE_INFINITY;
+    const upToStoreyTop = (levelId, at) => {
+        const storey = elevations.get(levelId);
+        if (storey)
+            pluginTop = Math.max(pluginTop, baseOf(levelId) + storey.height + at.y);
+    };
     // biome-ignore lint/plugin: a view frames whatever the level holds
     for (const node of Object.values(nodes)) {
         const level = levelOf(node);
@@ -475,6 +500,7 @@ export function sceneViewBounds(nodes, targetId, presentation) {
         const inTarget = !target ||
             target.id === node.id ||
             target.id === level.id ||
+            level.id === coveredByTarget ||
             (target.type === 'building' && level.parentId === target.id);
         if (!inTarget)
             continue;
@@ -491,15 +517,14 @@ export function sceneViewBounds(nodes, targetId, presentation) {
             });
         else if (node.type === 'item')
             (isRoofGeometry(node) ? roofs : held).push(placedBox(itemBox(node, baseOf(level.id)), at));
-        else if (node.type.includes(':')) {
-            const storey = elevations.get(level.id);
-            if (storey)
-                pluginTop = Math.max(pluginTop, baseOf(level.id) + storey.height + at.y);
-        }
+        else if (node.type.includes(':'))
+            upToStoreyTop(level.id, at);
         else {
             const box = levelChildBox(nodes, node, baseOf(level.id));
             if (box)
                 (node.type === 'roof' ? roofs : held).push(placedBox(box, at));
+            if (node.type === 'roof' && (node.children ?? []).some(unreadFace))
+                upToStoreyTop(level.id, at);
         }
     }
     const upTo = (box) => pluginTop > box.max[1] ? { min: box.min, max: [box.max[0], pluginTop, box.max[2]] } : box;

package/dist/agent-operations/search-assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-assets.d.ts","sourceRoot":"","sources":["../../src/agent-operations/search-assets.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,KAAK,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AACvD,KAAK,iBAAiB,GAAG;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAcnE;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,iBAAiB,CAqC1D,CAAA"}
+{"version":3,"file":"search-assets.d.ts","sourceRoot":"","sources":["../../src/agent-operations/search-assets.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,KAAK,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AACvD,KAAK,iBAAiB,GAAG;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAcnE;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,iBAAiB,CA2C1D,CAAA"}

package/dist/agent-operations/search-assets.js

@@ -38,6 +38,12 @@ export const searchAssets = (_nodes, input, context) => {
             category: item.category,
             dimensions: item.dimensions ?? [1, 1, 1],
             attachTo: item.attachTo ?? null,
+            ...(item.script && {
+                params: item.script.manifest.params.map((spec) => ({
+                    ...spec,
+                    value: item.script.params[spec.id] ?? spec.default,
+                })),
+            }),
         }));
         return { query: query.text, total: found.total, truncated, results };
     });

package/dist/agent-operations/types.d.ts

@@ -1,8 +1,10 @@
 import type { ZodType } from 'zod';
 import type { DesignBrief } from '../agent-tools/design-brief.js';
-import type { AnyNode, AssetInput, Collection, CompiledGeometryScript, SceneMaterial, SceneMaterialId } from '../schema/index.js';
+import type { Steps } from '../lib/steps.js';
+import type { AnyNode, Collection, CompiledGeometryScript, SceneMaterial, SceneMaterialId } from '../schema/index.js';
 import type { AssetSearchResult } from './asset-catalog.js';
 import type { AssetViewFacts } from './asset-views.js';
+import type { CatalogAsset } from './catalog-asset.js';
 import type { SessionKeep, SessionRecord } from './scene-checkpoint.js';
 export type SceneNodes = Readonly<Record<string, AnyNode>>;
 /**
@@ -32,7 +34,7 @@ export type AgentContext = {
     };
     /** The agent's session so far. The host keeps it where its sessions live; it is never scene data. */
     session?: SessionRecord;
-    catalog?: readonly AssetInput[];
+    catalog?: readonly CatalogAsset[];
     /** The library's answers to the call's searches, by `assetSearchKey`; set, they are what search_assets lists. */
     catalogSearches?: Readonly<Record<string, AssetSearchResult>>;
     /**
@@ -118,6 +120,12 @@ export type AgentOperationOutcome = {
  * what the tool's contract parses; `never` by default so any operation fits a registry.
  */
 export type AgentOperation<Input = never> = (nodes: SceneNodes, input: Input, context: AgentContext) => AgentOperationOutcome;
+/**
+ * An operation that takes seconds on a large building, in steps: a batch's calls, verify_scene's
+ * checks. A host that can let other work run between them resumes it one step at a time; the
+ * operation of the same name runs it through (`inOneGo`), with the same outcome.
+ */
+export type AgentOperationSteps<Input = never> = (...args: Parameters<AgentOperation<Input>>) => Steps<AgentOperationOutcome>;
 /** Operations by tool name: core's `AGENT_OPERATIONS`, or a plugin's `./agent-operations` export. */
 export type AgentOperations = Readonly<Record<string, AgentOperation>>;
 //# sourceMappingURL=types.d.ts.map

package/dist/agent-operations/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent-operations/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent-operations/types.ts"],"names":[],"mappings":"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"}

package/dist/agent-operations/usage-checks.js

@@ -1,12 +1,27 @@
-import { usageIssues } from '../spatial/usage-field/findings.js';
+import { isUsageType, ROOM_ENTRY_TYPE, ROOM_FOLDED_TYPES } from '../agent-tools/verify-scene-usage.js';
+import { USAGE_TYPES, usageIssueSteps } from '../spatial/usage-field/findings.js';
 import { sdfChecksOn } from '../spatial/usage-field/flag.js';
 import { registerSceneCheck } from './verify-scene.js';
+/**
+ * The finding types a `type` question is about: itself, or what a room's one entry holds. A usage
+ * type no measurement gives is a misspelt one, and its answer names the types there are: every
+ * measurement is taken, as for a question with no type.
+ */
+function askedTypes(type) {
+    if (typeof type !== 'string' || type.length === 0)
+        return undefined;
+    if (type === ROOM_ENTRY_TYPE)
+        return new Set(ROOM_FOLDED_TYPES);
+    return isUsageType(type) && !USAGE_TYPES.has(type) ? undefined : new Set([type]);
+}
 /**
  * Passages, turning circles, pockets and wall objects, measured on the real shapes of the scene
- * (`spatial/usage-field`). Off unless a host turns usage checks on; off, it adds nothing.
+ * (`spatial/usage-field`). Off unless a host turns usage checks on; off, it adds nothing. A
+ * question about one finding type takes the measurements that give it, and none for a type that
+ * is not a usage finding.
  */
 registerSceneCheck({
     name: 'usage',
     order: 60,
-    run: (nodes) => (sdfChecksOn() ? usageIssues(nodes) : []),
+    run: (nodes, input) => sdfChecksOn() ? usageIssueSteps(nodes, { types: askedTypes(input.type) }) : [],
 });

package/dist/agent-operations/verify-scene.d.ts

@@ -1,9 +1,10 @@
 import { type OpenWallEnd } from '../lib/room-graph.js';
+import { type Steps } from '../lib/steps.js';
 import type { UsageIssue } from '../spatial/usage-field/findings.js';
 import { type CeilingObjectObservation } from './ceiling-object-observations.js';
 import type { RoomCheckIssue } from './room-checks.js';
 import { type RoomFinding } from './room-findings.js';
-import type { AgentContext, AgentOperation, SceneNodes } from './types.js';
+import type { AgentContext, AgentOperation, AgentOperationSteps, SceneNodes } from './types.js';
 import type { RoomUnreachableIssue } from './unreachable-rooms-check.js';
 import { type WallEndShortIssue, type WallNearlyAlignedIssue } from './wall-joins.js';
 import { type WallObjectObservation } from './wall-object-observations.js';
@@ -57,12 +58,13 @@ export type VerifySceneInput = Readonly<Record<string, unknown>>;
 /**
  * A check verify_scene runs beyond its own, registered by the module that knows it (the facade
  * checks, the photo's), so verify_scene imports none of them. Checks before CHECKPOINT_ORDER run
- * ahead of the checkpoint's comparison, the rest after it.
+ * ahead of the checkpoint's comparison, the rest after it. A check that takes seconds on a large
+ * building answers in steps, and verify_scene stops where it does.
  */
 export type SceneCheck = {
     name: string;
     order: number;
-    run: (nodes: SceneNodes, input: VerifySceneInput, context: AgentContext) => SceneIssue[];
+    run: (nodes: SceneNodes, input: VerifySceneInput, context: AgentContext) => SceneIssue[] | Steps<SceneIssue[]>;
 };
 export declare const CHECKPOINT_ORDER = 100;
 /**
@@ -78,4 +80,6 @@ export declare function registerSceneReport(report: SceneReport): void;
 /** Runs a check in every verify_scene from now on; registering a check again replaces it. */
 export declare function registerSceneCheck(check: SceneCheck): void;
 export declare const verifyScene: AgentOperation<VerifySceneInput | undefined>;
+/** `verify_scene`, a step for each registered check and for each step of one that has them. */
+export declare const verifySceneSteps: AgentOperationSteps<VerifySceneInput | undefined>;
 //# sourceMappingURL=verify-scene.d.ts.map

package/dist/agent-operations/verify-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify-scene.d.ts","sourceRoot":"","sources":["../../src/agent-operations/verify-scene.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAexE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAajE,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,+BAA+B,CAAA;AAItC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,iBAAiB,CAAA;AAgBhE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAI5B,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,KAAK,qBAAqB,EAA0B,MAAM,4BAA4B,CAAA;AAE/F,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAClB,wBAAwB,GACxB,qBAAqB,GACrB,WAAW,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzE;IACE,IAAI,EAAE,qBAAqB,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB,GACD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1E;IACE,IAAI,EAAE,4BAA4B,CAAA;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;CAClB,GACD;IACE,IAAI,EAAE,eAAe,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAA;IACvB,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAA;IAClD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,GACD,iBAAiB,GACjB,sBAAsB,GACtB,UAAU,GACV,cAAc,GACd,oBAAoB,CAAA;AAExB,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEhE;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,KAAK,UAAU,EAAE,CAAA;CACzF,CAAA;AAED,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAInC;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AAI/F,+FAA+F;AAC/F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,QAItD;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,QAKnD;AAuLD,eAAO,MAAM,WAAW,EAAE,cAAc,CAAC,gBAAgB,GAAG,SAAS,CA2fpE,CAAA"}
+{"version":3,"file":"verify-scene.d.ts","sourceRoot":"","sources":["../../src/agent-operations/verify-scene.ts"],"names":[],"mappings":"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"}

package/dist/agent-operations/verify-scene.js

@@ -7,6 +7,7 @@ import { HIDDEN_SITE_NOTE } from '../lib/node-visibility.js';
 import { wallSupportForNodes } from '../lib/opening-floor-datum.js';
 import { detectOpenWallEnds } from '../lib/room-graph.js';
 import { siteBrief } from '../lib/site-placement.js';
+import { inOneGo } from '../lib/steps.js';
 import { nodeRegistry } from '../registry/index.js';
 import { AnyNode as AnyNodeSchema, } from '../schema/index.js';
 import { nodeSchemaForKind } from '../schema/compiled-node-parsers.js';
@@ -206,7 +207,9 @@ function checkSchemas(scene, hostSchema) {
  */
 /** A flight of this many risers or fewer is a step up to a door, not a staircase: no going or comfort target applies. */
 const SHORT_FLIGHT_STEPS = 3;
-export const verifyScene = (scene, input, context) => {
+export const verifyScene = (scene, input, context) => inOneGo(verifySceneSteps(scene, input, context));
+/** `verify_scene`, a step for each registered check and for each step of one that has them. */
+export const verifySceneSteps = function* (scene, input, context) {
     const { errors, unknownKinds, unread, measured: nodes } = checkSchemas(scene, context.nodeSchema);
     const onLevel = (levelId) => nodesOnLevel(nodes, levelId);
     const ofType = (content, type) => content.filter((node) => node.type === type);
@@ -526,9 +529,16 @@ export const verifyScene = (scene, input, context) => {
     issues.push(...layoutIssuesFromScene(Object.values(settled)));
     issues.push(...ceilingObjectObservations(settled));
     issues.push(...wallObjectObservations(settled));
-    for (const check of checks)
-        if (check.order < CHECKPOINT_ORDER)
-            issues.push(...check.run(settled, input ?? {}, context));
+    const registered = function* (beforeCheckpoint) {
+        for (const check of checks) {
+            if (check.order < CHECKPOINT_ORDER !== beforeCheckpoint)
+                continue;
+            const found = check.run(settled, input ?? {}, context);
+            issues.push(...(Array.isArray(found) ? found : yield* found));
+            yield;
+        }
+    };
+    yield* registered(true);
     // What the edits since the host's checkpoint lost, by place.
     const hosted = context.checkpoint
         ? changesSince(context.checkpoint, scene)
@@ -541,9 +551,7 @@ export const verifyScene = (scene, input, context) => {
     const since = typeof input?.since === 'string' ? reviewSince(session, input.since, scene) : null;
     if (since?.places)
         issues.push(...since.places.issues);
-    for (const check of checks)
-        if (check.order >= CHECKPOINT_ORDER)
-            issues.push(...check.run(settled, input ?? {}, context));
+    yield* registered(false);
     const occupiedStoryCount = levels.filter((level) => level.isOccupiedStory).length;
     issues.splice(0, issues.length, ...withoutDuplicatePockets(issues));
     const issueGroups = sceneIssueGroups(issues, nodes);

package/dist/agent-tools/assets.js

@@ -5,7 +5,7 @@ export const SEARCH_ASSETS_MAX_LIMIT = 60;
 export const searchAssetsTool = {
     name: 'search_assets',
     title: 'Search assets',
-    description: `Search the item library (furniture, fixtures, lights, plants, outdoor) by keyword, with one or several queries in a call. The catalog is a limited set that varies by server: what a search returns is what exists. Results provide valid asset ids and placement facts when these are not already known. A query matches the items whose name, id, category or tags hold every one of its words. Returns one group per query, best matches first (the name exactly, then words of the name, words starting it, the category, a tag), at most limit items (${SEARCH_ASSETS_LIMIT} unless set, up to ${SEARCH_ASSETS_MAX_LIMIT}); total counts every match and truncated says the limit cut some, with a hint on how to narrow. Each item has its id, name, category, dimensions [width, height, depth] in metres and attachTo (null on the floor, else 'wall', 'wall-side' or 'ceiling'). Related lookups (sofa, coffee table, tv stand) can share a call.`,
+    description: `Search the item library (furniture, fixtures, lights, plants, outdoor) by keyword, with one or several queries in a call. The catalog is a limited set that varies by server: what a search returns is what exists. Results provide valid asset ids and placement facts when these are not already known. A query matches the items whose name, id, category or tags hold every one of its words. Returns one group per query, best matches first (the name exactly, then words of the name, words starting it, the category, a tag), at most limit items (${SEARCH_ASSETS_LIMIT} unless set, up to ${SEARCH_ASSETS_MAX_LIMIT}); total counts every match and truncated says the limit cut some, with a hint on how to narrow. Each item has its id, name, category, dimensions [width, height, depth] in metres and attachTo (null on the floor, else 'wall', 'wall-side' or 'ceiling'). An item with params is built from code and listed before plain models the query names as well: once placed, add_object with its nodeId and new params resizes or reshapes it to the room. Related lookups (sofa, coffee table, tv stand) can share a call.`,
     input: {
         queries: z
             .array(z.object({

package/dist/building/__fixtures__/wall-opening-cases.d.ts

@@ -802,36 +802,6 @@ export declare function openingScene(): {
             level: number;
             baseElevation: number;
             height?: number | undefined;
-        } | {
-            object: "node";
-            name?: string | undefined;
-            parentId: string | null;
-            visible: boolean;
-            camera?: {
-                position: [number, number, number];
-                target: [number, number, number];
-                mode: "orthographic" | "perspective";
-                fov?: number | undefined;
-                zoom?: number | undefined;
-            } | undefined;
-            metadata: Record<string, unknown>;
-            provenance?: {
-                refs: {
-                    ns?: string | undefined;
-                    id: string;
-                    role?: "absorbed" | "alias" | "derived" | "piece" | "primary" | undefined;
-                }[];
-                lineage?: {
-                    op: "attach" | "convert" | "duplicate" | "import" | "make-independent" | "merge" | "promote" | "split";
-                    fromIds: string[];
-                } | undefined;
-            } | undefined;
-            id: `building_${string}`;
-            type: "building";
-            children: (`elevator_${string}` | `level_${string}` | `unit_${string}`)[];
-            position: [number, number, number];
-            rotation: [number, number, number];
-            groundLevelId?: `level_${string}` | undefined;
         } | {
             object: "node";
             name?: string | undefined;
@@ -1060,6 +1030,36 @@ export declare function openingScene(): {
             panicBarStyle: "crossbar" | "touchbar";
             panicBarRods: boolean;
             panicBarHeight: number;
+        } | {
+            object: "node";
+            name?: string | undefined;
+            parentId: string | null;
+            visible: boolean;
+            camera?: {
+                position: [number, number, number];
+                target: [number, number, number];
+                mode: "orthographic" | "perspective";
+                fov?: number | undefined;
+                zoom?: number | undefined;
+            } | undefined;
+            metadata: Record<string, unknown>;
+            provenance?: {
+                refs: {
+                    ns?: string | undefined;
+                    id: string;
+                    role?: "absorbed" | "alias" | "derived" | "piece" | "primary" | undefined;
+                }[];
+                lineage?: {
+                    op: "attach" | "convert" | "duplicate" | "import" | "make-independent" | "merge" | "promote" | "split";
+                    fromIds: string[];
+                } | undefined;
+            } | undefined;
+            id: `building_${string}`;
+            type: "building";
+            children: (`elevator_${string}` | `level_${string}` | `unit_${string}`)[];
+            position: [number, number, number];
+            rotation: [number, number, number];
+            groundLevelId?: `level_${string}` | undefined;
         };
     };
     rootNodeIds: `building_${string}`[];