@pascal-app/core 1.0.3 → 1.0.5

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

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const addFenceTool: {
+    name: string;
+    title: string;
+    description: string;
+    input: {
+        levelId: z.ZodOptional<z.ZodString>;
+        level: z.ZodOptional<z.ZodString>;
+        points: z.ZodArray<z.ZodArray<z.ZodNumber>>;
+        closed: z.ZodOptional<z.ZodBoolean>;
+        height: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            guard: "guard";
+            horizontal: "horizontal";
+            picket: "picket";
+            privacy: "privacy";
+            rail: "rail";
+            slat: "slat";
+        }>>;
+        baseStyle: z.ZodOptional<z.ZodEnum<{
+            floating: "floating";
+            grounded: "grounded";
+            raised: "raised";
+        }>>;
+        materialPreset: z.ZodOptional<z.ZodString>;
+    };
+};
+//# sourceMappingURL=fences.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fences.d.ts","sourceRoot":"","sources":["../../src/agent-tools/fences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;CAiCxB,CAAA"}

package/dist/agent-tools/fences.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { FenceBaseStyle, FenceStyle } from '../schema/nodes/fence-types.js';
+import { levelTarget } from './levels.js';
+import { measurement } from './measurement.js';
+export const addFenceTool = {
+    name: 'add_fence',
+    title: 'Add fence',
+    description: "Add a fence along points on a level: one fence per side, a whole run or a lot's boundary (closed) in one call. Privacy (solid panels) by default; picket for a picket fence, slat for vertical slats, rail for open rails, horizontal for cladding boards, guard for a deck's barrier. Fences stand on the level, as the editor's fence tool puts them. Refused with a code: a side shorter than 10 cm (fence_too_short), a roof level (roof_level).",
+    input: {
+        points: z
+            .array(z.array(z.number()).length(2))
+            .min(2)
+            .max(64)
+            .describe('[x, z] points in level coordinates (metres), the fence running through them in order.'),
+        closed: z
+            .boolean()
+            .optional()
+            .describe("Close the run back to the first point, as a lot's boundary."),
+        height: measurement('length', 'm', {
+            positive: true,
+            description: 'Fence height (default 1.8 m).',
+        }).optional(),
+        style: FenceStyle.optional().describe('slat | rail | privacy | horizontal | guard | picket (default privacy).'),
+        baseStyle: FenceBaseStyle.optional().describe('grounded (default: a kickboard on the ground), floating (the panel held off the ground on its posts) or raised (a bottom rail held above the ground, the posts to the ground: a deck guard).'),
+        materialPreset: z
+            .string()
+            .optional()
+            .describe('A library material (library:<id>), found with search_materials.'),
+        ...levelTarget,
+    },
+};

package/dist/agent-tools/find-by-type.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+/** Results a call lists when it names no limit; past it they are counted, not listed. */
+export declare const FIND_BY_TYPE_LIMIT = 200;
+export declare const findByTypeTool: {
+    name: string;
+    title: string;
+    description: string;
+    input: {
+        type: z.ZodOptional<z.ZodString>;
+        levelId: z.ZodOptional<z.ZodString>;
+        parentId: z.ZodOptional<z.ZodString>;
+        zoneId: z.ZodOptional<z.ZodString>;
+        sourceId: z.ZodOptional<z.ZodString>;
+        sourceIdPrefix: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    };
+};
+//# sourceMappingURL=find-by-type.d.ts.map

package/dist/agent-tools/find-by-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-by-type.d.ts","sourceRoot":"","sources":["../../src/agent-tools/find-by-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,yFAAyF;AACzF,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAErC,eAAO,MAAM,cAAc;IACzB,IAAI;IACJ,KAAK;IACL,WAAW;IACX,KAAK;QACH,IAAI;QAOJ,OAAO;QACP,QAAQ;QAGR,MAAM;QAGN,QAAQ;QAOR,cAAc;QAKd,KAAK;;CASR,CAAA"}

package/dist/agent-tools/find-by-type.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { NodeId } from './node-id.js';
+/** Results a call lists when it names no limit; past it they are counted, not listed. */
+export const FIND_BY_TYPE_LIMIT = 200;
+export const findByTypeTool = {
+    name: 'find_by_type',
+    title: 'Find by type',
+    description: `Find everything of one type in the scene, wherever it lives: nodes of that kind (column, door, window, wall, stair, imported-mesh, a plugin's kind…), items of that category, lights (any item that emits light), and typed parts inside scripted objects, windows and doors (a porch's columns, a window's grille). Narrow it to a level, a parent, a zone or an importer's source ids; without a type, every node the other filters match. A word that names nothing (no node kind, nor an item category or part type in this scene) is refused with the kinds the scene holds. Each result gives the node's id, name, kind, level and parent, with its metadata and provenance when it has them (one over 1 KB is named in omitted instead); get_node reads a node whole. Parts are read-only: they come back with their object's id, the part id and, for objects directly on a level, its bounds in level coordinates; edit them through their object. count says how many match; past limit (${FIND_BY_TYPE_LIMIT} unless asked) the rest are left out of results, with truncated: narrow the call or raise limit.`,
+    input: {
+        type: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('What to find, one word: a node kind (wall, slab, imported-mesh, fixture:bench), an item category, light, or a part type (column, beam, panel, railing, trim…). Omit it to find every node the other filters match.'),
+        levelId: NodeId.optional().describe('Only this level. Default: every level.'),
+        parentId: NodeId.optional().describe("Only the nodes directly under this one: a wall's doors and windows, a roof's segments, a level's walls."),
+        zoneId: NodeId.optional().describe("Only what stands in this zone: on the zone's level, its plan point inside the zone's outline and outside its holes (a wall's midpoint, a polygon's centroid, a door or window where its wall puts it, a block or mesh by the middle of its geometry, a part with bounds by their middle)."),
+        sourceId: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('Only the nodes an importer recorded under this source id (provenance.refs[].id, or legacy metadata.sourceIds), exactly. Characters outside printable ASCII also match their percent-encoded form.'),
+        sourceIdPrefix: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('Only the nodes with a source id starting with this.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe(`How many results to list at most. Default ${FIND_BY_TYPE_LIMIT}; count still says how many match.`),
+    },
+};

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

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const FURNISHED_ROOM_TYPES: readonly ['bedroom', 'kitchen', 'bathroom', 'living', 'dining', 'hallway', 'entry', 'laundry', 'storage'];
+/** The fixed set of each room type, as agent-operations/furnish-room.ts lays it out (a test holds them together). */
+export declare const FURNISH_ROOM_SETS = "bedroom: double-bed (a side of 3.2 m or more) or single-bed, two bedside-table, dresser (10 m\u00B2 or more), closet (13 m\u00B2 or more); kitchen: kitchen (back wall of 2.6 m or more) or kitchen-counter, stove (back wall of 3.5 m or more), fridge; bathroom: toilet, bathroom-sink, bathtub (6.5 m\u00B2 or more) or shower-square; living: sofa, coffee-table, livingroom-chair, tv-stand; dining: dining-table, two dining-chair (four when both sides are 3 m or more); laundry: washing-machine, drying-rack; entry and hallway: coat-rack (both sides 1.4 m or more); storage: closet.";
+export declare const furnishRoomTool: {
+    name: string;
+    title: string;
+    description: string;
+    input: {
+        levelId: z.ZodOptional<z.ZodString>;
+        level: z.ZodOptional<z.ZodString>;
+        zoneId: z.ZodOptional<z.ZodString>;
+        polygon: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodNumber>>>;
+        roomType: z.ZodEnum<{
+            bathroom: "bathroom";
+            bedroom: "bedroom";
+            dining: "dining";
+            entry: "entry";
+            hallway: "hallway";
+            kitchen: "kitchen";
+            laundry: "laundry";
+            living: "living";
+            storage: "storage";
+        }>;
+        doorWallIndex: z.ZodOptional<z.ZodNumber>;
+    };
+};
+//# sourceMappingURL=furnish-room.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"furnish-room.d.ts","sourceRoot":"","sources":["../../src/agent-tools/furnish-room.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,oBAAoB,YAC/B,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,CACD,CAAA;AAEV,qHAAqH;AACrH,eAAO,MAAM,iBAAiB,skBACwhB,CAAA;AAEtjB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAwB3B,CAAA"}

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

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { levelTarget } from './levels.js';
+import { NodeId } from './node-id.js';
+export const FURNISHED_ROOM_TYPES = [
+    'bedroom',
+    'kitchen',
+    'bathroom',
+    'living',
+    'dining',
+    'hallway',
+    'entry',
+    'laundry',
+    'storage',
+];
+/** The fixed set of each room type, as agent-operations/furnish-room.ts lays it out (a test holds them together). */
+export const FURNISH_ROOM_SETS = 'bedroom: double-bed (a side of 3.2 m or more) or single-bed, two bedside-table, dresser (10 m² or more), closet (13 m² or more); kitchen: kitchen (back wall of 2.6 m or more) or kitchen-counter, stove (back wall of 3.5 m or more), fridge; bathroom: toilet, bathroom-sink, bathtub (6.5 m² or more) or shower-square; living: sofa, coffee-table, livingroom-chair, tv-stand; dining: dining-table, two dining-chair (four when both sides are 3 m or more); laundry: washing-machine, drying-rack; entry and hallway: coat-rack (both sides 1.4 m or more); storage: closet.';
+export const furnishRoomTool = {
+    name: 'furnish_room',
+    title: 'Furnish room',
+    description: `Place the catalog's fixed furniture set for a room type: one set per type, not matched to a style. The bed, sofa, counters or toilet go against the wall facing the door, the rest along a side wall, each set off its wall by its own depth. Name the room by zoneId (its level and outline come with it), or give its polygon and level. The door wall is the edge a door of the room stands on, else doorWallIndex, else edge 0. Nothing lands in a door's clear zone or on another item: a piece that does not fit is nudged, else skipped, and skipped says why. Items stand on the room's level. The set per room type: ${FURNISH_ROOM_SETS} The result lists each piece placed with its size and id, and each piece skipped with its reason. view_scene with interior { zoneId } shows the room from inside, at a person's height.`,
+    input: {
+        zoneId: NodeId.optional().describe('The room: zoneId from create_room, or an id from get_zones.'),
+        ...levelTarget,
+        polygon: z
+            .array(z.array(z.number()).length(2))
+            .min(3)
+            .optional()
+            .describe("The room's corners as [x, z] in metres, when there is no zoneId."),
+        roomType: z.enum(FURNISHED_ROOM_TYPES).describe('What the room is for.'),
+        doorWallIndex: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('The polygon edge (i → i + 1) to treat as the door wall: for a room with no door yet, or to override the one found.'),
+    },
+};

package/dist/agent-tools/hosted-services.d.ts

@@ -0,0 +1,438 @@
+import { z } from 'zod';
+export declare const SITE_CONTEXT_LAYERS: readonly ['parcel', 'zoning', 'flood', 'code_basis', 'elevation', 'utilities', 'soils', 'wetlands', 'structures', 'boundaries'];
+export declare const siteContextInput: {
+    address: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodOptional<z.ZodNumber>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+    layers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        boundaries: "boundaries";
+        code_basis: "code_basis";
+        elevation: "elevation";
+        flood: "flood";
+        parcel: "parcel";
+        soils: "soils";
+        structures: "structures";
+        utilities: "utilities";
+        wetlands: "wetlands";
+        zoning: "zoning";
+    }>>>;
+    geometry: z.ZodOptional<z.ZodBoolean>;
+    adjacent: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const siteContextInputSchema: z.ZodObject<{
+    address: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodOptional<z.ZodNumber>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+    layers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        boundaries: "boundaries";
+        code_basis: "code_basis";
+        elevation: "elevation";
+        flood: "flood";
+        parcel: "parcel";
+        soils: "soils";
+        structures: "structures";
+        utilities: "utilities";
+        wetlands: "wetlands";
+        zoning: "zoning";
+    }>>>;
+    geometry: z.ZodOptional<z.ZodBoolean>;
+    adjacent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const listPascalServicesTool: {
+    readonly name: 'list_pascal_services';
+    readonly action: 'catalog';
+    readonly title: 'List Pascal services';
+    readonly description: "List the hosted services this project may use, current prices and available media models: those of an installed plugin, or without pluginId Pascal's own Studio and its default models. This lookup is free. Discoverability does not grant permission or spend credits.";
+    readonly input: {
+        pluginId: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodOptional<z.ZodString>;
+    };
+    readonly annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare const pullSiteDataTool: {
+    readonly name: 'pull_site_data';
+    readonly action: 'site.pull';
+    readonly title: 'Pull site context';
+    readonly description: 'Retrieve sourced parcel, terrain/elevation, flood, wetlands and other selected site context for a hosted project. Uses the fixed Pascal credit price from list_pascal_services, bounded by maxCredits. Keep pullKey for retries. Returns a retained operation; use get_site_pull while running or to reopen it free. Partial coverage and unknowns remain explicit. Does not edit the scene.';
+    readonly input: {
+        readonly address: z.ZodOptional<z.ZodString>;
+        readonly latitude: z.ZodOptional<z.ZodNumber>;
+        readonly longitude: z.ZodOptional<z.ZodNumber>;
+        readonly layers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            boundaries: "boundaries";
+            code_basis: "code_basis";
+            elevation: "elevation";
+            flood: "flood";
+            parcel: "parcel";
+            soils: "soils";
+            structures: "structures";
+            utilities: "utilities";
+            wetlands: "wetlands";
+            zoning: "zoning";
+        }>>>;
+        readonly geometry: z.ZodOptional<z.ZodBoolean>;
+        readonly adjacent: z.ZodOptional<z.ZodBoolean>;
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly pullKey: z.ZodString;
+        readonly maxCredits: z.ZodNumber;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+};
+export declare const getSitePullTool: {
+    readonly name: 'get_site_pull';
+    readonly action: 'site.result';
+    readonly title: 'Read saved site context';
+    readonly description: 'Read a retained site operation and its sourced result for this project and plugin without another charge. May reconcile an interrupted operation and its refund. Does not start another pull or edit the scene.';
+    readonly input: {
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly operationId: z.ZodString;
+    };
+    readonly annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare const generateStudioMediaTool: {
+    readonly name: 'generate_studio_media';
+    readonly action: 'studio.generate';
+    readonly title: 'Generate project media';
+    readonly description: "Render an image, material or video of the project with a model from list_pascal_services, charged to this project's Pascal wallet. A call without quoteToken answers a quote (status 'quote': the model, settings, sources and the exact credits) and charges nothing: tell the person what it costs and ask before rendering, then call again with the same input and the quote's quoteToken to submit. When the person said the cost doesn't matter, pass confirm: false with maxCredits to submit at once. A submission answers a job to read with get_studio_generation. Sources are project snapshot or render ids, or a view_scene viewId (type 'view': the frame you looked at, kept in the project's Studio gallery once it is rendered); a source that is gone is refused, never dropped. Keep generationKey for retries: the same key and input never charge twice. Does not edit the scene.";
+    readonly input: {
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly modelId: z.ZodString;
+        readonly prompt: z.ZodOptional<z.ZodString>;
+        readonly sources: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodEnum<{
+                render: "render";
+                snapshot: "snapshot";
+            }>;
+            id: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            frame: z.ZodOptional<z.ZodEnum<{
+                end: "end";
+                start: "start";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"view">;
+            id: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            frame: z.ZodOptional<z.ZodEnum<{
+                end: "end";
+                start: "start";
+            }>>;
+        }, z.core.$strict>], "type">>>;
+        readonly settings: z.ZodOptional<z.ZodObject<{
+            aspectRatio: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
+            resolution: z.ZodOptional<z.ZodString>;
+            quality: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        readonly generationKey: z.ZodString;
+        readonly quoteToken: z.ZodOptional<z.ZodString>;
+        readonly confirm: z.ZodOptional<z.ZodBoolean>;
+        readonly maxCredits: z.ZodOptional<z.ZodNumber>;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+};
+export declare const getStudioGenerationTool: {
+    readonly name: 'get_studio_generation';
+    readonly action: 'studio.status';
+    readonly title: 'Read project media generation';
+    readonly description: 'Poll or reopen a media job created for this project and plugin without another charge. May reconcile provider completion or failure and its refund. Does not submit another generation or edit the scene.';
+    readonly input: {
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly id: z.ZodString;
+        readonly includePreview: z.ZodOptional<z.ZodBoolean>;
+    };
+    readonly annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+/** Released hosted operations; workflow implementation and admission belong to the host. */
+export declare const HOSTED_SERVICE_TOOL_CONTRACTS: readonly [{
+    readonly name: 'list_pascal_services';
+    readonly action: 'catalog';
+    readonly title: 'List Pascal services';
+    readonly description: "List the hosted services this project may use, current prices and available media models: those of an installed plugin, or without pluginId Pascal's own Studio and its default models. This lookup is free. Discoverability does not grant permission or spend credits.";
+    readonly input: {
+        pluginId: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodOptional<z.ZodString>;
+    };
+    readonly annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+}, {
+    readonly name: 'pull_site_data';
+    readonly action: 'site.pull';
+    readonly title: 'Pull site context';
+    readonly description: 'Retrieve sourced parcel, terrain/elevation, flood, wetlands and other selected site context for a hosted project. Uses the fixed Pascal credit price from list_pascal_services, bounded by maxCredits. Keep pullKey for retries. Returns a retained operation; use get_site_pull while running or to reopen it free. Partial coverage and unknowns remain explicit. Does not edit the scene.';
+    readonly input: {
+        readonly address: z.ZodOptional<z.ZodString>;
+        readonly latitude: z.ZodOptional<z.ZodNumber>;
+        readonly longitude: z.ZodOptional<z.ZodNumber>;
+        readonly layers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            boundaries: "boundaries";
+            code_basis: "code_basis";
+            elevation: "elevation";
+            flood: "flood";
+            parcel: "parcel";
+            soils: "soils";
+            structures: "structures";
+            utilities: "utilities";
+            wetlands: "wetlands";
+            zoning: "zoning";
+        }>>>;
+        readonly geometry: z.ZodOptional<z.ZodBoolean>;
+        readonly adjacent: z.ZodOptional<z.ZodBoolean>;
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly pullKey: z.ZodString;
+        readonly maxCredits: z.ZodNumber;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+}, {
+    readonly name: 'get_site_pull';
+    readonly action: 'site.result';
+    readonly title: 'Read saved site context';
+    readonly description: 'Read a retained site operation and its sourced result for this project and plugin without another charge. May reconcile an interrupted operation and its refund. Does not start another pull or edit the scene.';
+    readonly input: {
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly operationId: z.ZodString;
+    };
+    readonly annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+}, {
+    readonly name: 'generate_studio_media';
+    readonly action: 'studio.generate';
+    readonly title: 'Generate project media';
+    readonly description: "Render an image, material or video of the project with a model from list_pascal_services, charged to this project's Pascal wallet. A call without quoteToken answers a quote (status 'quote': the model, settings, sources and the exact credits) and charges nothing: tell the person what it costs and ask before rendering, then call again with the same input and the quote's quoteToken to submit. When the person said the cost doesn't matter, pass confirm: false with maxCredits to submit at once. A submission answers a job to read with get_studio_generation. Sources are project snapshot or render ids, or a view_scene viewId (type 'view': the frame you looked at, kept in the project's Studio gallery once it is rendered); a source that is gone is refused, never dropped. Keep generationKey for retries: the same key and input never charge twice. Does not edit the scene.";
+    readonly input: {
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly modelId: z.ZodString;
+        readonly prompt: z.ZodOptional<z.ZodString>;
+        readonly sources: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodEnum<{
+                render: "render";
+                snapshot: "snapshot";
+            }>;
+            id: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            frame: z.ZodOptional<z.ZodEnum<{
+                end: "end";
+                start: "start";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"view">;
+            id: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            frame: z.ZodOptional<z.ZodEnum<{
+                end: "end";
+                start: "start";
+            }>>;
+        }, z.core.$strict>], "type">>>;
+        readonly settings: z.ZodOptional<z.ZodObject<{
+            aspectRatio: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
+            resolution: z.ZodOptional<z.ZodString>;
+            quality: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        readonly generationKey: z.ZodString;
+        readonly quoteToken: z.ZodOptional<z.ZodString>;
+        readonly confirm: z.ZodOptional<z.ZodBoolean>;
+        readonly maxCredits: z.ZodOptional<z.ZodNumber>;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+}, {
+    readonly name: 'get_studio_generation';
+    readonly action: 'studio.status';
+    readonly title: 'Read project media generation';
+    readonly description: 'Poll or reopen a media job created for this project and plugin without another charge. May reconcile provider completion or failure and its refund. Does not submit another generation or edit the scene.';
+    readonly input: {
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly id: z.ZodString;
+        readonly includePreview: z.ZodOptional<z.ZodBoolean>;
+    };
+    readonly annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+}];
+export type HostedServiceToolName = (typeof HOSTED_SERVICE_TOOL_CONTRACTS)[number]['name'];
+export type HostedServiceAction = (typeof HOSTED_SERVICE_TOOL_CONTRACTS)[number]['action'];
+export declare function findHostedServiceTool(name: string): {
+    readonly name: 'list_pascal_services';
+    readonly action: 'catalog';
+    readonly title: 'List Pascal services';
+    readonly description: "List the hosted services this project may use, current prices and available media models: those of an installed plugin, or without pluginId Pascal's own Studio and its default models. This lookup is free. Discoverability does not grant permission or spend credits.";
+    readonly input: {
+        pluginId: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodOptional<z.ZodString>;
+    };
+    readonly annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+} | {
+    readonly name: 'pull_site_data';
+    readonly action: 'site.pull';
+    readonly title: 'Pull site context';
+    readonly description: 'Retrieve sourced parcel, terrain/elevation, flood, wetlands and other selected site context for a hosted project. Uses the fixed Pascal credit price from list_pascal_services, bounded by maxCredits. Keep pullKey for retries. Returns a retained operation; use get_site_pull while running or to reopen it free. Partial coverage and unknowns remain explicit. Does not edit the scene.';
+    readonly input: {
+        readonly address: z.ZodOptional<z.ZodString>;
+        readonly latitude: z.ZodOptional<z.ZodNumber>;
+        readonly longitude: z.ZodOptional<z.ZodNumber>;
+        readonly layers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            boundaries: "boundaries";
+            code_basis: "code_basis";
+            elevation: "elevation";
+            flood: "flood";
+            parcel: "parcel";
+            soils: "soils";
+            structures: "structures";
+            utilities: "utilities";
+            wetlands: "wetlands";
+            zoning: "zoning";
+        }>>>;
+        readonly geometry: z.ZodOptional<z.ZodBoolean>;
+        readonly adjacent: z.ZodOptional<z.ZodBoolean>;
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly pullKey: z.ZodString;
+        readonly maxCredits: z.ZodNumber;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+} | {
+    readonly name: 'get_site_pull';
+    readonly action: 'site.result';
+    readonly title: 'Read saved site context';
+    readonly description: 'Read a retained site operation and its sourced result for this project and plugin without another charge. May reconcile an interrupted operation and its refund. Does not start another pull or edit the scene.';
+    readonly input: {
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly operationId: z.ZodString;
+    };
+    readonly annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+} | {
+    readonly name: 'generate_studio_media';
+    readonly action: 'studio.generate';
+    readonly title: 'Generate project media';
+    readonly description: "Render an image, material or video of the project with a model from list_pascal_services, charged to this project's Pascal wallet. A call without quoteToken answers a quote (status 'quote': the model, settings, sources and the exact credits) and charges nothing: tell the person what it costs and ask before rendering, then call again with the same input and the quote's quoteToken to submit. When the person said the cost doesn't matter, pass confirm: false with maxCredits to submit at once. A submission answers a job to read with get_studio_generation. Sources are project snapshot or render ids, or a view_scene viewId (type 'view': the frame you looked at, kept in the project's Studio gallery once it is rendered); a source that is gone is refused, never dropped. Keep generationKey for retries: the same key and input never charge twice. Does not edit the scene.";
+    readonly input: {
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly modelId: z.ZodString;
+        readonly prompt: z.ZodOptional<z.ZodString>;
+        readonly sources: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodEnum<{
+                render: "render";
+                snapshot: "snapshot";
+            }>;
+            id: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            frame: z.ZodOptional<z.ZodEnum<{
+                end: "end";
+                start: "start";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"view">;
+            id: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            frame: z.ZodOptional<z.ZodEnum<{
+                end: "end";
+                start: "start";
+            }>>;
+        }, z.core.$strict>], "type">>>;
+        readonly settings: z.ZodOptional<z.ZodObject<{
+            aspectRatio: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
+            resolution: z.ZodOptional<z.ZodString>;
+            quality: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        readonly generationKey: z.ZodString;
+        readonly quoteToken: z.ZodOptional<z.ZodString>;
+        readonly confirm: z.ZodOptional<z.ZodBoolean>;
+        readonly maxCredits: z.ZodOptional<z.ZodNumber>;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+} | {
+    readonly name: 'get_studio_generation';
+    readonly action: 'studio.status';
+    readonly title: 'Read project media generation';
+    readonly description: 'Poll or reopen a media job created for this project and plugin without another charge. May reconcile provider completion or failure and its refund. Does not submit another generation or edit the scene.';
+    readonly input: {
+        readonly pluginId: z.ZodOptional<z.ZodString>;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+        readonly id: z.ZodString;
+        readonly includePreview: z.ZodOptional<z.ZodBoolean>;
+    };
+    readonly annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+} | undefined;
+//# sourceMappingURL=hosted-services.d.ts.map

package/dist/agent-tools/hosted-services.d.ts.map

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