@pascal-app/core 1.0.1 → 1.0.4

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

@@ -0,0 +1,402 @@
+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<{
+        parcel: "parcel";
+        flood: "flood";
+        zoning: "zoning";
+        utilities: "utilities";
+        soils: "soils";
+        wetlands: "wetlands";
+        structures: "structures";
+        elevation: "elevation";
+        boundaries: "boundaries";
+        code_basis: "code_basis";
+    }>>>;
+    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<{
+        parcel: "parcel";
+        flood: "flood";
+        zoning: "zoning";
+        utilities: "utilities";
+        soils: "soils";
+        wetlands: "wetlands";
+        structures: "structures";
+        elevation: "elevation";
+        boundaries: "boundaries";
+        code_basis: "code_basis";
+    }>>>;
+    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 an installed plugin may use in this project, current prices and available media models. This lookup is free. Discoverability does not grant permission or spend credits.";
+    readonly input: {
+        pluginId: 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 pullKey: z.ZodString;
+        readonly maxCredits: z.ZodNumber;
+        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<{
+            parcel: "parcel";
+            flood: "flood";
+            zoning: "zoning";
+            utilities: "utilities";
+            soils: "soils";
+            wetlands: "wetlands";
+            structures: "structures";
+            elevation: "elevation";
+            boundaries: "boundaries";
+            code_basis: "code_basis";
+        }>>>;
+        readonly geometry: z.ZodOptional<z.ZodBoolean>;
+        readonly adjacent: z.ZodOptional<z.ZodBoolean>;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+    };
+    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 operationId: z.ZodString;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<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: "Generate an image, material or video using an available model from list_pascal_services. Charges this project's Pascal wallet up to maxCredits; returns a job ID to read with get_studio_generation. Uses authorized project snapshot/render references. Does not edit the scene. After a lost response, inspect the project's Studio history before submitting again; a new submission may charge again.";
+    readonly input: {
+        readonly modelId: z.ZodString;
+        readonly prompt: z.ZodOptional<z.ZodString>;
+        readonly sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                snapshot: "snapshot";
+                render: "render";
+            }>;
+            id: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            frame: z.ZodOptional<z.ZodEnum<{
+                start: "start";
+                end: "end";
+            }>>;
+        }, z.core.$strict>>>;
+        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 maxCredits: z.ZodNumber;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        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 id: z.ZodString;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+    };
+    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 an installed plugin may use in this project, current prices and available media models. This lookup is free. Discoverability does not grant permission or spend credits.";
+    readonly input: {
+        pluginId: 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 pullKey: z.ZodString;
+        readonly maxCredits: z.ZodNumber;
+        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<{
+            parcel: "parcel";
+            flood: "flood";
+            zoning: "zoning";
+            utilities: "utilities";
+            soils: "soils";
+            wetlands: "wetlands";
+            structures: "structures";
+            elevation: "elevation";
+            boundaries: "boundaries";
+            code_basis: "code_basis";
+        }>>>;
+        readonly geometry: z.ZodOptional<z.ZodBoolean>;
+        readonly adjacent: z.ZodOptional<z.ZodBoolean>;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+    };
+    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 operationId: z.ZodString;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<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: "Generate an image, material or video using an available model from list_pascal_services. Charges this project's Pascal wallet up to maxCredits; returns a job ID to read with get_studio_generation. Uses authorized project snapshot/render references. Does not edit the scene. After a lost response, inspect the project's Studio history before submitting again; a new submission may charge again.";
+    readonly input: {
+        readonly modelId: z.ZodString;
+        readonly prompt: z.ZodOptional<z.ZodString>;
+        readonly sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                snapshot: "snapshot";
+                render: "render";
+            }>;
+            id: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            frame: z.ZodOptional<z.ZodEnum<{
+                start: "start";
+                end: "end";
+            }>>;
+        }, z.core.$strict>>>;
+        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 maxCredits: z.ZodNumber;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        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 id: z.ZodString;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+    };
+    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 an installed plugin may use in this project, current prices and available media models. This lookup is free. Discoverability does not grant permission or spend credits.";
+    readonly input: {
+        pluginId: 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 pullKey: z.ZodString;
+        readonly maxCredits: z.ZodNumber;
+        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<{
+            parcel: "parcel";
+            flood: "flood";
+            zoning: "zoning";
+            utilities: "utilities";
+            soils: "soils";
+            wetlands: "wetlands";
+            structures: "structures";
+            elevation: "elevation";
+            boundaries: "boundaries";
+            code_basis: "code_basis";
+        }>>>;
+        readonly geometry: z.ZodOptional<z.ZodBoolean>;
+        readonly adjacent: z.ZodOptional<z.ZodBoolean>;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+    };
+    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 operationId: z.ZodString;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<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: "Generate an image, material or video using an available model from list_pascal_services. Charges this project's Pascal wallet up to maxCredits; returns a job ID to read with get_studio_generation. Uses authorized project snapshot/render references. Does not edit the scene. After a lost response, inspect the project's Studio history before submitting again; a new submission may charge again.";
+    readonly input: {
+        readonly modelId: z.ZodString;
+        readonly prompt: z.ZodOptional<z.ZodString>;
+        readonly sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                snapshot: "snapshot";
+                render: "render";
+            }>;
+            id: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            frame: z.ZodOptional<z.ZodEnum<{
+                start: "start";
+                end: "end";
+            }>>;
+        }, z.core.$strict>>>;
+        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 maxCredits: z.ZodNumber;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        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 id: z.ZodString;
+        readonly pluginId: z.ZodString;
+        readonly projectId: z.ZodOptional<z.ZodString>;
+    };
+    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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,mBAAmB,iIAWtB,CAAA;AAEV,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;CAO5B,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;kBAMhC,CAAA;AAwCH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;CAQzB,CAAA;AAEV,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBnB,CAAA;AAEV,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;CAQlB,CAAA;AAEV,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC1B,CAAA;AAEV,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;CAQ1B,CAAA;AAEV,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMhC,CAAA;AAEV,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAC1F,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAA;AAE1F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAEjD"}

package/dist/agent-tools/hosted-services.js

@@ -0,0 +1,148 @@
+import { z } from 'zod';
+export const SITE_CONTEXT_LAYERS = [
+    'parcel',
+    'zoning',
+    'flood',
+    'code_basis',
+    'elevation',
+    'utilities',
+    'soils',
+    'wetlands',
+    'structures',
+    'boundaries',
+];
+export const siteContextInput = {
+    address: z.string().trim().min(1).max(500).optional(),
+    latitude: z.number().finite().min(-90).max(90).optional(),
+    longitude: z.number().finite().min(-180).max(180).optional(),
+    layers: z.array(z.enum(SITE_CONTEXT_LAYERS)).min(1).max(SITE_CONTEXT_LAYERS.length).optional(),
+    geometry: z.boolean().optional(),
+    adjacent: z.boolean().optional(),
+};
+export const siteContextInputSchema = z
+    .object(siteContextInput)
+    .strict()
+    .refine((input) => input.address || (input.latitude !== undefined && input.longitude !== undefined), 'An address or coordinates are required.');
+const context = {
+    pluginId: z
+        .string()
+        .regex(/^[a-z0-9-]+:[a-z0-9-]+$/)
+        .describe("The installed Pascal plugin whose service grant this request uses. Read get_scene.installedPlugins or the host's plugin list; an ID is not permission."),
+    projectId: z
+        .string()
+        .regex(/^project_[A-Za-z0-9_-]+$/)
+        .optional()
+        .describe('The hosted project to use. Omit only when the host has an active hosted project. Local scene IDs do not authorize hosted services.'),
+};
+const maxCredits = z
+    .number()
+    .int()
+    .nonnegative()
+    .max(Number.MAX_SAFE_INTEGER)
+    .describe('The maximum Pascal credits approved for this operation. Read list_pascal_services for the price; the gateway refuses a higher charge.');
+const readAnnotations = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+const resultAnnotations = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+export const listPascalServicesTool = {
+    name: 'list_pascal_services',
+    action: 'catalog',
+    title: 'List Pascal services',
+    description: 'List the hosted services an installed plugin may use in this project, current prices and available media models. This lookup is free. Discoverability does not grant permission or spend credits.',
+    input: context,
+    annotations: readAnnotations,
+};
+export const pullSiteDataTool = {
+    name: 'pull_site_data',
+    action: 'site.pull',
+    title: 'Pull site context',
+    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.',
+    input: {
+        ...context,
+        ...siteContextInput,
+        pullKey: z
+            .string()
+            .regex(/^[A-Za-z0-9_-]{8,128}$/)
+            .describe('A unique key for this requested pull. Reuse the same key and input after a lost response; changing either starts a different operation or is refused.'),
+        maxCredits,
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+export const getSitePullTool = {
+    name: 'get_site_pull',
+    action: 'site.result',
+    title: 'Read saved site context',
+    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.',
+    input: { ...context, operationId: z.string().min(1).max(128) },
+    annotations: resultAnnotations,
+};
+export const generateStudioMediaTool = {
+    name: 'generate_studio_media',
+    action: 'studio.generate',
+    title: 'Generate project media',
+    description: "Generate an image, material or video using an available model from list_pascal_services. Charges this project's Pascal wallet up to maxCredits; returns a job ID to read with get_studio_generation. Uses authorized project snapshot/render references. Does not edit the scene. After a lost response, inspect the project's Studio history before submitting again; a new submission may charge again.",
+    input: {
+        ...context,
+        modelId: z.string().min(1).max(100),
+        prompt: z.string().max(400_000).optional(),
+        sources: z
+            .array(z
+            .object({
+            type: z.enum(['snapshot', 'render']),
+            id: z.string().min(1).max(128),
+            role: z.string().max(100).optional(),
+            frame: z.enum(['start', 'end']).optional(),
+        })
+            .strict())
+            .max(32)
+            .optional(),
+        settings: z
+            .object({
+            aspectRatio: z.string().max(100).optional(),
+            durationSeconds: z.number().finite().positive().optional(),
+            resolution: z.string().max(100).optional(),
+            quality: z.string().max(100).optional(),
+        })
+            .strict()
+            .optional(),
+        maxCredits,
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+};
+export const getStudioGenerationTool = {
+    name: 'get_studio_generation',
+    action: 'studio.status',
+    title: 'Read project media generation',
+    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.',
+    input: { ...context, id: z.string().min(1).max(128) },
+    annotations: resultAnnotations,
+};
+/** Released hosted operations; workflow implementation and admission belong to the host. */
+export const HOSTED_SERVICE_TOOL_CONTRACTS = [
+    listPascalServicesTool,
+    pullSiteDataTool,
+    getSitePullTool,
+    generateStudioMediaTool,
+    getStudioGenerationTool,
+];
+export function findHostedServiceTool(name) {
+    return HOSTED_SERVICE_TOOL_CONTRACTS.find((tool) => tool.name === name);
+}