@pascal-app/core 1.0.3 → 1.0.5

package/dist/agent-operations/design-brief.js

@@ -0,0 +1,300 @@
+import { AXIS_DESIGN_MIN_WORDS, BEYOND_LAYERS, BEYOND_MIN_LAYERS, BRIEF_AXES, CATALOG_PLACEMENT_TOOLS, FURNISHING_CREATION_TOOLS, layerPieces, } from '../agent-tools/design-brief.js';
+import { AgentRefusal, refuse } from '../agent-tools/refusal.js';
+/**
+ * Furnishing follows the turn's design brief. A host that gates keeps the brief in force
+ * (`AgentContext.designBrief`, null while there is none) and each furnishing tool asks
+ * `requireFurnishing` before it runs, inside `run_batch` too. A host that does not gate leaves the
+ * context's brief out and nothing is refused (Pro, a person's own tools).
+ */
+export const NO_BRIEF = "Furnishing follows the turn's design brief: design_brief records what the request fixes, what it leaves open and where objects come from; until then the catalog can be searched and viewed, not placed, and no furnishing is made.";
+const openSource = (piece) => `The brief left the source open: ${piece} can be made with add_object or place_design (view_assets shows the catalog's for reference), or, for technical equipment, named in the brief's asIs after view_assets, with a reason.`;
+/**
+ * The function tags of the catalog's technical equipment: sanitaryware, kitchen, laundry and climate
+ * appliances, fixed services. A hosted item's `category` is its primary function tag; the built-in
+ * list carries function tags too. An item whose tags are not all technical is furniture here.
+ */
+const TECHNICAL_FUNCTIONS = new Set([
+    'plumbing',
+    'sinks',
+    'toilets',
+    'showers',
+    'bathtubs',
+    'appliances',
+    'appliance',
+    'kitchen-appliances',
+    'laundry-appliances',
+    'climate-appliances',
+    'utilities',
+]);
+export function isTechnicalEquipment(item) {
+    const tags = item.functionTags?.length ? item.functionTags : [item.category];
+    return tags.every((tag) => TECHNICAL_FUNCTIONS.has(tag));
+}
+const furnitureFact = (name) => `${name} is furniture: in an open brief furniture is made (add_object, place_design) or the request names a catalog source; asIs keeps technical equipment (sanitaryware, appliances).`;
+const notViewed = (ids) => `${ids.join(', ')} ${ids.length === 1 ? 'was' : 'were'} not viewed: asIs keeps a catalog piece only after view_assets showed it earlier in the same turn (chat) or session (MCP).`;
+const SOURCE_NOT_IN_REQUEST = "A source is set by the request: the brief's sourceQuote must be the person's own words naming it, a brand, the catalog or what is already there; this request names none, so its source is open.";
+/** Case, accents and spaces folded away: how a quote is compared with the request and the lists. */
+const fold = (text) => text
+    .normalize('NFD')
+    .replace(/\p{M}/gu, '')
+    .replace(/[\u2019\u2018]/g, "'")
+    .toLowerCase()
+    .replace(/\s+/g, ' ')
+    .trim();
+/**
+ * The words that name the catalog as a source, English and French, folded; a word matches from its
+ * start. Phrases, not single words, where a single word also names a room or a building ("a house
+ * with a library", "the existing house").
+ */
+const CATALOG_WORDS = [
+    'catalog',
+    'pascal library',
+    "pascal's library",
+    'bibliotheque pascal',
+    "pascal's items",
+    "pascal's objects",
+    'pascal items',
+    'pascal objects',
+    'from the stock',
+    'in stock',
+    'du stock',
+    'en stock',
+];
+/** The words that name what is already there as a source, English and French, folded. */
+const EXISTING_WORDS = [
+    'existing furniture',
+    'existing pieces',
+    'existing items',
+    'my furniture',
+    'my own furniture',
+    'current furniture',
+    'what is already there',
+    "what's already there",
+    'mes meubles',
+    'meubles existants',
+    'meubles actuels',
+    "ce qu'il y a",
+];
+const wordsRegex = (words) => new RegExp(`\\b(?:${words.map((word) => word.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('|')})`);
+const CATALOG_WORD = wordsRegex(CATALOG_WORDS);
+const EXISTING_WORD = wordsRegex(EXISTING_WORDS);
+/** Whether the quote, at least two words, names the brief's source: its brand, the catalog, what is already there. */
+function quoteNamesSource(source, brand, quote) {
+    const folded = fold(quote);
+    if (folded.split(' ').length < 2)
+        return false;
+    if (source === 'brand')
+        return Boolean(brand) && folded.includes(fold(brand));
+    return (source === 'catalog' ? CATALOG_WORD : EXISTING_WORD).test(folded);
+}
+/**
+ * Every axis is stated, bounded or open. A bounded axis quotes the person's own words: where
+ * the host lends the message (the chat, `requestText`) the quote is in it, folded as the
+ * source quote is; over MCP there is no message, so the quote is required by the contract and
+ * not compared with anything. An open axis carries a design statement of at least
+ * AXIS_DESIGN_MIN_WORDS words. The source axis is the `source` fields, checked separately.
+ */
+function requireAxes(input, context) {
+    const axes = input.axes ?? {};
+    const missing = BRIEF_AXES.filter((axis) => !axes[axis]);
+    if (missing.length)
+        refuse('axis_missing', `The brief reads the request axis by axis: ${missing.join(', ')} ${missing.length === 1 ? 'is' : 'are'} absent. Each axis is bounded by the person's words or open with a design statement; an axis the request does not touch is open.`, { axes: missing });
+    for (const axis of BRIEF_AXES) {
+        const reading = axes[axis];
+        if (reading.kind === 'bounded') {
+            const quote = fold(reading.quote);
+            if (!quote ||
+                (context.requestText !== undefined && !fold(context.requestText).includes(quote)))
+                refuse('axis_quote_not_in_request', `The ${axis} is bounded by the request's own words: its quote must be words of the person's message.`, { axis });
+        }
+        else if (fold(reading.design).split(' ').filter(Boolean).length < AXIS_DESIGN_MIN_WORDS)
+            refuse('axis_open_without_design', `The ${axis} is open: say how it is designed.`, { axis });
+    }
+    return axes;
+}
+/** The pieces `beyond` names, flattened: the brief's own list of the dressing. */
+export function dressingOf(beyond) {
+    return BEYOND_LAYERS.flatMap(([key]) => layerPieces(beyond[key]));
+}
+/**
+ * The dressing axis alone decides what `beyond` owes. Bounded, `beyond` may say none
+ * everywhere, except that the named pieces read as a minimum do not bound it: a dressing
+ * quote inside a minimum pieces quote is refused. Open, at least BEYOND_MIN_LAYERS of the
+ * layers name pieces.
+ */
+function requireDressing(input, axes) {
+    const dressing = axes.dressing;
+    if (dressing.kind === 'bounded') {
+        const pieces = axes.pieces;
+        if (pieces.kind === 'bounded' &&
+            (pieces.extent ?? 'minimum') === 'minimum' &&
+            fold(dressing.quote) &&
+            fold(pieces.quote).includes(fold(dressing.quote)))
+            refuse('dressing_bounded_by_minimum', 'The pieces the request names are a minimum: they do not bound the dressing. The dressing is bounded only by words that limit the pieces or the action.');
+        return;
+    }
+    const empty = BEYOND_LAYERS.filter(([key]) => layerPieces(input.beyond[key]).length === 0);
+    if (BEYOND_LAYERS.length - empty.length >= BEYOND_MIN_LAYERS)
+        return;
+    refuse('beyond_too_thin', `The request leaves the dressing open: beyond names pieces for at least ${BEYOND_MIN_LAYERS} of its ${BEYOND_LAYERS.length} layers (${BEYOND_LAYERS.map(([, label]) => label).join(', ')}); ${empty.map(([, label]) => label).join(', ')} say none.`, { layers: empty.map(([key]) => key) });
+}
+/** Whether `design_brief` reads the item library: an open brief naming pieces as they are. */
+export function briefReadsCatalog(tool, input) {
+    const { source, asIs } = asRecord(input);
+    return tool === 'design_brief' && source === 'open' && Array.isArray(asIs) && asIs.length > 0;
+}
+/**
+ * An open brief keeps a catalog piece as it is only if it is technical equipment and view_assets
+ * showed it to the agent (the session's `viewed`). Furniture is refused first: looking at it would
+ * change nothing.
+ */
+function requireAsIs(brief, context) {
+    const named = [...new Set((brief.asIs ?? []).map((piece) => piece.assetId))];
+    if (brief.source !== 'open' || !named.length)
+        return;
+    const furniture = named.flatMap((id) => {
+        const item = context.catalog?.find((candidate) => candidate.id === id);
+        return item && !isTechnicalEquipment(item) ? [{ id, name: item.name }] : [];
+    });
+    if (furniture.length)
+        refuse('brief_as_is_furniture', furniture.map(({ name }) => furnitureFact(name)).join(' '), {
+            pieces: furniture.map(({ id }) => id),
+        });
+    const viewed = new Set(context.session?.viewed ?? []);
+    const unseen = named.filter((id) => !viewed.has(id));
+    if (unseen.length)
+        refuse('brief_as_is_not_viewed', notViewed(unseen), { pieces: unseen });
+}
+const isCatalogPlacement = (tool) => CATALOG_PLACEMENT_TOOLS.includes(tool);
+const isCreation = (tool) => FURNISHING_CREATION_TOOLS.includes(tool);
+const asRecord = (value) => typeof value === 'object' && value !== null ? value : {};
+/** The catalog ids a placement call names. */
+function placedAssets(tool, input) {
+    const named = tool === 'place_items'
+        ? (Array.isArray(input.items) ? input.items : []).map((item) => asRecord(item).assetId)
+        : [input.assetId];
+    return [...new Set(named.filter((id) => typeof id === 'string'))];
+}
+/**
+ * Why a furnishing call may not run under this brief, or null. `brief` null is no brief yet. An
+ * `add_object` that names a `nodeId` edits an object that stands: it places and makes nothing.
+ * A batch holding a refused call is refused whole: the gate says nothing about its other calls.
+ */
+export function furnishingRefusal(tool, input, brief) {
+    if (tool === 'run_batch') {
+        const calls = asRecord(input).calls;
+        for (const [index, call] of (Array.isArray(calls) ? calls : []).entries()) {
+            const { tool: name, input: callInput } = asRecord(call);
+            if (typeof name !== 'string')
+                continue;
+            const refusal = furnishingRefusal(name, callInput, brief);
+            if (refusal)
+                return new AgentRefusal(refusal.code, `The batch's call ${index + 1} (${name}) is refused: ${refusal.message} Nothing in the batch was applied.`, { ...refusal.details, index, tool: name });
+        }
+        return null;
+    }
+    if (!(isCatalogPlacement(tool) || isCreation(tool)))
+        return null;
+    const args = asRecord(input);
+    if (tool === 'add_object' && typeof args.nodeId === 'string')
+        return null;
+    if (!brief)
+        return new AgentRefusal('design_brief_required', NO_BRIEF, { tool });
+    if (brief.source !== 'open' || isCreation(tool))
+        return null;
+    if (tool === 'furnish_room')
+        return new AgentRefusal('brief_source_open', openSource("the pieces of furnish_room's stock set"), {
+            tool,
+            source: brief.source,
+        });
+    const unnamed = placedAssets(tool, args).filter((id) => !brief.asIs?.some((piece) => piece.assetId === id));
+    return unnamed.length
+        ? new AgentRefusal('brief_source_open', openSource(unnamed.join(', ')), {
+            tool,
+            source: brief.source,
+            pieces: unnamed,
+        })
+        : null;
+}
+/** Throws the refusal when the host gates and the call may not run; a host with no brief to keep passes. */
+export function requireFurnishing(tool, input, brief) {
+    if (brief === undefined)
+        return;
+    const refusal = furnishingRefusal(tool, input, brief);
+    if (refusal)
+        throw refusal;
+}
+/** The operation of a furnishing tool, refusing as `requireFurnishing` says before it runs. */
+export function gatedByBrief(tool, operation) {
+    return (nodes, input, context) => {
+        requireFurnishing(tool, input, context.designBrief);
+        return operation(nodes, input, context);
+    };
+}
+/** What a brief opens and leaves closed, as facts. */
+export function briefUnlocks(brief) {
+    if (brief.source !== 'open')
+        return {
+            unlocks: [
+                `${CATALOG_PLACEMENT_TOOLS.join(', ')} place the catalog's pieces.`,
+                `${FURNISHING_CREATION_TOOLS.join(', ')} stay open for what the catalog lacks.`,
+            ],
+            closed: [],
+        };
+    const asIs = brief.asIs ?? [];
+    return {
+        unlocks: [
+            `${FURNISHING_CREATION_TOOLS.join(', ')} make the pieces.`,
+            ...(asIs.length
+                ? [
+                    `place_items and place_in_room place the technical equipment named in asIs: ${asIs.map((piece) => piece.assetId).join(', ')}.`,
+                ]
+                : []),
+        ],
+        closed: [
+            'furnish_room places a whole stock set.',
+            'Catalog pieces not named in asIs: place_items and place_in_room refuse them; view_assets shows the catalog for reference.',
+            'asIs keeps technical equipment (sanitaryware, appliances); furniture is made.',
+        ],
+    };
+}
+/**
+ * `design_brief`: the request read as a brief, recorded as the turn's design record. The operation
+ * echoes it with what it opens and hands it back for the host to keep with the session; nothing in
+ * the scene changes.
+ */
+export const designBrief = (_nodes, input, context) => {
+    const axes = requireAxes(input, context);
+    const brand = input.brand?.trim();
+    if (input.source === 'brand' && !brand)
+        refuse('brand_required', 'source brand names a range: give its name as brand ("IKEA").');
+    const quote = input.sourceQuote?.trim();
+    if (input.source !== 'open') {
+        if (!quote)
+            refuse('source_quote_required', `source ${input.source} is set by the request: give sourceQuote, the person's own words that name it ("IKEA furniture only"); a request that names no source is open.`);
+        if (!quoteNamesSource(input.source, brand, quote))
+            refuse('source_not_named', SOURCE_NOT_IN_REQUEST);
+        if (context.requestText !== undefined && !fold(context.requestText).includes(fold(quote)))
+            refuse('source_not_in_request', SOURCE_NOT_IN_REQUEST);
+    }
+    requireDressing(input, axes);
+    const brief = {
+        axes,
+        source: input.source,
+        ...(input.source !== 'open' && quote ? { sourceQuote: quote } : {}),
+        ...(input.source === 'brand' && brand ? { brand } : {}),
+        vision: input.vision,
+        beyond: input.beyond,
+        ...(input.source === 'open' && input.asIs?.length ? { asIs: input.asIs } : {}),
+    };
+    requireAsIs(brief, context);
+    return {
+        result: {
+            status: 'recorded',
+            brief,
+            dressing: dressingOf(input.beyond),
+            ...briefUnlocks(brief),
+        },
+        keep: { designBrief: brief },
+    };
+};

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

@@ -0,0 +1,24 @@
+import type { AgentOperation } from './types.js';
+type DesignInput = string | Record<string, unknown>;
+type ValidateDesignInput = {
+    design: DesignInput;
+    parameters?: Record<string, number>;
+};
+type PlaceDesignInput = {
+    design: DesignInput;
+    hostId: string;
+    position: number[];
+    rotation?: number;
+    side?: 'front' | 'back';
+    surfaceId?: string;
+    parameters?: Record<string, number>;
+    slots?: Record<string, string>;
+    name?: string;
+    id?: string;
+};
+/** `validate_design`: a procedural recipe checked on its own; the scene is untouched. */
+export declare const validateDesignOperation: AgentOperation<ValidateDesignInput>;
+/** `place_design`: one instance of a validated design, created on its host. */
+export declare const placeDesign: AgentOperation<PlaceDesignInput>;
+export {};
+//# sourceMappingURL=designs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"designs.d.ts","sourceRoot":"","sources":["../../src/agent-operations/designs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEnD,KAAK,mBAAmB,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAA;AAEvF,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,yFAAyF;AACzF,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAAC,mBAAmB,CAKtE,CAAA;AAEF,+EAA+E;AAC/E,eAAO,MAAM,WAAW,EAAE,cAAc,CAAC,gBAAgB,CAqCxD,CAAA"}

package/dist/agent-operations/designs.js

@@ -0,0 +1,48 @@
+import { refuse } from '../agent-tools/refusal.js';
+import { validateDesign } from '../procedural-items/design.js';
+import { DesignPlacementError, planDesignPlacement } from '../procedural-items/design-placement.js';
+/** `validate_design`: a procedural recipe checked on its own; the scene is untouched. */
+export const validateDesignOperation = (_nodes, { design, parameters }) => ({
+    result: validateDesign(design, { parameters }),
+});
+/** `place_design`: one instance of a validated design, created on its host. */
+export const placeDesign = (nodes, input) => {
+    const [x, y, z] = input.position;
+    if (x === undefined || y === undefined || z === undefined) {
+        refuse('invalid_placement', 'position must hold three coordinates.', {
+            position: input.position,
+        });
+    }
+    let placement;
+    try {
+        placement = planDesignPlacement(nodes, {
+            ...input,
+            position: [x, y, z],
+        });
+    }
+    catch (error) {
+        if (!(error instanceof DesignPlacementError))
+            throw error;
+        refuse(error.code, error.message, {
+            message: error.message,
+            ...(error.diagnostics.length > 0 ? { diagnostics: error.diagnostics.slice(0, 8) } : {}),
+        });
+    }
+    const { node, parentId, hostUpdate } = placement;
+    return {
+        result: { designId: node.id, parentId, surfaceId: input.surfaceId ?? null },
+        changes: {
+            create: [{ node: node, parentId }],
+            ...(hostUpdate
+                ? {
+                    update: [
+                        {
+                            id: hostUpdate.id,
+                            data: { attachments: hostUpdate.attachments },
+                        },
+                    ],
+                }
+                : {}),
+        },
+    };
+};

package/dist/agent-operations/door-clearance.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Door access keep-outs for MCP layout tools.
+ *
+ * Furniture that overlaps a door clear zone is reported as blocking the door.
+ * Used by furnish_room (skip placements) and verify_scene (layout issues).
+ *
+ * See docs/layout-clearance-error-log.md for pitfalls (levels, gap sign, scale).
+ */
+import { type AnyNode } from '../schema/index.js';
+import { type Vec2 } from './plan-geometry.js';
+export type PlanAabb = {
+    minX: number;
+    maxX: number;
+    minZ: number;
+    maxZ: number;
+};
+export type ItemFootprintFailureReason = 'missing_dimensions' | 'non_finite_position' | 'non_finite_rotation' | 'non_finite_dimensions' | 'non_positive_plan_dimensions' | 'non_finite_scale' | 'zero_plan_scale' | 'non_planar_rotation' | 'unsupported_attachment';
+export type ItemFootprintInspection = {
+    ok: true;
+    aabb: PlanAabb;
+    sourceDimensions: [number, number, number];
+    effectiveDimensions: [number, number, number];
+    rotationY: number;
+} | {
+    ok: false;
+    reason: ItemFootprintFailureReason;
+};
+export type DoorKeepout = {
+    doorId: string;
+    wallId: string;
+    levelId: string | null;
+    /** World-space AABB: the full clear depth on the swing side, a walkway on the other. */
+    aabb: PlanAabb;
+    width: number;
+    localX: number;
+    /** The door's height: an item whose bottom is above it does not block the door. */
+    height: number;
+};
+/**
+ * Wall shape these helpers accept. Deliberately structural rather than
+ * `Pick<WallNode, …>`: `keepoutForPolygonEdge` feeds in synthetic `edge-N`
+ * segments for room edges that do not have a wall node yet, so the id cannot
+ * be the branded `wall_${string}`.
+ */
+export type WallSegmentLike = {
+    id: string;
+    start: Vec2;
+    end: Vec2;
+};
+/**
+ * Door shape these helpers accept — a real `DoorNode` or a planned opening.
+ * `Pick<AnyNode, 'position' | 'width'>` does not work: those keys exist on
+ * only some members of the `AnyNode` union, so `Pick` rejects them.
+ */
+export type DoorOpeningLike = {
+    id: string;
+    position?: readonly number[];
+    width?: number;
+    height?: number;
+    /** Which face the leaf swings towards: 'inward' is the wall's +normal side, as the door plan draws it. */
+    swingDirection?: 'inward' | 'outward';
+};
+/** Plan depth (m) cleared on each side of the wall face through the opening. */
+export declare const DEFAULT_DOOR_CLEAR_DEPTH = 0.65;
+/** Extra half-width (m) beyond the door leaf along the wall. */
+export declare const DEFAULT_DOOR_SIDE_PAD = 0.05;
+/** Plan depth (m) kept free on the side a door does not swing to: room to walk through. */
+export declare const DOOR_WALKWAY_DEPTH = 0.35;
+/**
+ * True when A and B come closer than `gap` meters (including penetration).
+ * `gap` is the **minimum free space required** between boxes:
+ * expand each box by gap/2, then test intersection.
+ */
+export declare function aabbsOverlap(a: PlanAabb, b: PlanAabb, gap?: number): boolean;
+/**
+ * Walk parentId chain to the enclosing level id (pure; no bridge required).
+ */
+export declare function resolveNodeLevelId(nodeId: string, byId: Map<string, AnyNode>): string | null;
+/**
+ * Axis-aligned item footprint in plan (x/z), rotation-aware.
+ * Prefer scaled dimensions when the node is available.
+ */
+export declare function itemPlanAabb(position: [number, number, number] | number[], dimensions: [number, number, number] | number[] | undefined, rotationYRad?: number): PlanAabb;
+/** Scaled plan footprint used by legacy placement and door-clearance callers. */
+export declare function itemNodePlanAabb(node: AnyNode): PlanAabb | null;
+/**
+ * Script bounds need not be centred on the item origin, and the asset's own corrective scale,
+ * rotation and offset sit inside the node's scale, as `scriptItemBoundsInLevel` measures them;
+ * catalog bounds are normalized.
+ */
+export declare function itemNodePlanCorners(node: Extract<AnyNode, {
+    type: 'item';
+}>): Vec2[];
+export declare function inspectItemPlanFootprint(node: Extract<AnyNode, {
+    type: 'item';
+}>, options?: {
+    floorOnly?: boolean;
+}): ItemFootprintInspection;
+/**
+ * Build a rectangular keep-out around a wall door, extruded perpendicular to the wall
+ * on both faces so either swing side is protected.
+ */
+export declare function doorKeepoutFromWall(wall: WallSegmentLike, door: DoorOpeningLike, options?: {
+    clearDepth?: number;
+    sidePad?: number;
+    levelId?: string | null;
+}): DoorKeepout | null;
+export declare function collectDoorKeepouts(nodes: Iterable<AnyNode>, options?: {
+    clearDepth?: number;
+    sidePad?: number;
+    levelId?: string;
+}): DoorKeepout[];
+export declare function itemBlocksDoorKeepout(itemAabb: PlanAabb, keepout: DoorKeepout): boolean;
+export type BlockedDoorIssue = {
+    doorId: string;
+    wallId: string;
+    itemId: string;
+    levelId?: string | null;
+    itemName?: string;
+    message: string;
+};
+export declare function findBlockedDoors(args: {
+    nodes: Iterable<AnyNode>;
+    clearDepth?: number;
+    sidePad?: number;
+    /** When set, only doors and items on this level are considered. */
+    levelId?: string;
+}): BlockedDoorIssue[];
+/**
+ * Synthetic keep-outs for a room polygon edge that will host a door (before doors exist).
+ * Used by furnish_room when doorWallIndex is known.
+ */
+export declare function keepoutForPolygonEdge(polygon: Vec2[], edgeIndex: number, options?: {
+    t?: number;
+    width?: number;
+    clearDepth?: number;
+    sidePad?: number;
+}): PlanAabb | null;
+/**
+ * Whether an existing keep-out already covers this room-edge planned zone
+ * (so we do not double-count a real door on that edge).
+ *
+ * Requires the planned keep-out **center** to lie inside the existing keep-out,
+ * and the existing box to cover a large fraction of the planned area.
+ * Plain AABB overlap is not enough (nearby hallway doors must not suppress
+ * this room's entrance keep-out).
+ */
+export declare function keepoutCoversPlanned(existing: PlanAabb, planned: PlanAabb): boolean;
+export declare function aabbFromPlan(a: PlanAabb): PlanAabb;
+//# sourceMappingURL=door-clearance.d.ts.map

package/dist/agent-operations/door-clearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"door-clearance.d.ts","sourceRoot":"","sources":["../../src/agent-operations/door-clearance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,OAAO,EAAuB,MAAM,WAAW,CAAA;AAG7D,OAAO,EAAE,KAAK,IAAI,EAAc,MAAM,iBAAiB,CAAA;AAEvD,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,0BAA0B,GAClC,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,uBAAuB,GACvB,8BAA8B,GAC9B,kBAAkB,GAClB,iBAAiB,GACjB,qBAAqB,GACrB,wBAAwB,CAAA;AAE5B,MAAM,MAAM,uBAAuB,GAC/B;IACE,EAAE,EAAE,IAAI,CAAA;IACR,IAAI,EAAE,QAAQ,CAAA;IACd,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7C,SAAS,EAAE,MAAM,CAAA;CAClB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,CAAA;AAErD,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,wFAAwF;IACxF,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,CAAA;AAEpE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0GAA0G;IAC1G,cAAc,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;CACtC,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,OAAO,CAAA;AAC5C,gEAAgE;AAChE,eAAO,MAAM,qBAAqB,OAAO,CAAA;AACzC,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,OAAO,CAAA;AAGtC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAI,GAAG,OAAO,CAGvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAe5F;AAmBD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,EAC7C,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,SAAS,EAC3D,YAAY,SAAI,GACf,QAAQ,CAcV;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAkB/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,EAAE,CAwBpF;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACxC,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,uBAAuB,CA+EzB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3E,WAAW,GAAG,IAAI,CAmDpB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EACxB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE,WAAW,EAAE,CAqBf;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAEvF;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,gBAAgB,EAAE,CA0CrB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,EAAE,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9E,QAAQ,GAAG,IAAI,CAyBjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAgBnF;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAElD"}