@snaptrude/plugin-core 0.2.7 → 0.2.8

package/dist/index.js

@@ -17,8 +17,8 @@ var PluginVec3Api = class {
    * // { x: 1, y: 2, z: 3 }
    * ```
    */
-  new(x, y, z17) {
-    return { x, y, z: z17 };
+  new(x, y, z18) {
+    return { x, y, z: z18 };
   }
   /**
    * Add two vectors component-wise.
@@ -196,8 +196,8 @@ var PluginQuatApi = class {
    * @param w - The W (scalar) component
    * @returns A new {@linkcode PQuat}
    */
-  new(x, y, z17, w) {
-    return { x, y, z: z17, w };
+  new(x, y, z18, w) {
+    return { x, y, z: z18, w };
   }
   /**
    * Create an identity quaternion representing no rotation.
@@ -241,13 +241,13 @@ var PluginQuatApi = class {
    * @param z - Rotation around Z axis in **radians**
    * @returns A new {@linkcode PQuat}
    */
-  fromEuler(x, y, z17) {
+  fromEuler(x, y, z18) {
     const cx = Math.cos(x / 2);
     const sx = Math.sin(x / 2);
     const cy = Math.cos(y / 2);
     const sy = Math.sin(y / 2);
-    const cz = Math.cos(z17 / 2);
-    const sz = Math.sin(z17 / 2);
+    const cz = Math.cos(z18 / 2);
+    const sz = Math.sin(z18 / 2);
     return {
       x: sx * cy * cz + cx * sy * sz,
       y: cx * sy * cz - sx * cy * sz,
@@ -578,38 +578,478 @@ var PluginCoreApi = class {
   }
 };
 
-// src/api/entity/buildableEnvelope.ts
+// src/api/documentation/aiInspiration.ts
 import * as z7 from "zod";
+var JsonPrimitive = z7.union([z7.string(), z7.number(), z7.boolean(), z7.null()]);
+var JsonValue = z7.lazy(
+  () => z7.union([JsonPrimitive, z7.array(JsonValue), z7.record(z7.string(), JsonValue)])
+);
+var PluginAIInspirationRunMode = z7.enum(["blocking", "job"]);
+var PluginAIInspirationOutputKind = z7.enum([
+  "source",
+  "image",
+  "video"
+]);
+var PluginAIInspirationModelOutput = z7.enum(["image", "video"]);
+var PluginAIInspirationRuntimeProvider = z7.enum(["gpt", "fal"]);
+var PluginAIInspirationPromptStrategy = z7.enum([
+  "gpt-image",
+  "fal-image",
+  "fal-video"
+]);
+var PluginAIInspirationShapeKind = z7.enum(["image", "view", "video"]);
+var PluginAIInspirationVideoMode = z7.enum([
+  "animate",
+  "references",
+  "keyframes"
+]);
+var PluginAIInspirationVideoMotion = z7.enum([
+  "auto",
+  "slow-dolly",
+  "subtle-orbit",
+  "reveal"
+]);
+var PluginAIInspirationVideoDuration = z7.enum(["4s", "6s", "8s"]);
+var PluginAIInspirationJobStatus = z7.enum([
+  "queued",
+  "running",
+  "completed",
+  "failed",
+  "cancelled"
+]);
+var PluginAIInspirationWorkflowRunState = z7.enum([
+  "current",
+  "stale",
+  "running",
+  "failed",
+  "superseded"
+]);
+var PluginAIInspirationRegionHint = z7.object({
+  x: z7.number().finite(),
+  y: z7.number().finite(),
+  w: z7.number().finite().positive(),
+  h: z7.number().finite().positive()
+});
+var PluginAIInspirationPoint = z7.object({
+  x: z7.number().finite(),
+  y: z7.number().finite()
+});
+var PluginAIInspirationTextAnnotation = z7.object({
+  text: z7.string().min(1),
+  x: z7.number().finite().optional(),
+  y: z7.number().finite().optional()
+});
+var PluginAIInspirationSketchGuidance = z7.object({
+  visualShapeIds: z7.array(z7.string()).optional(),
+  textAnnotations: z7.array(PluginAIInspirationTextAnnotation).optional()
+});
+var PluginAIInspirationSiteOptions = z7.object({
+  includeSatellite: z7.boolean().optional(),
+  includeStreetView: z7.boolean().optional(),
+  includeAerial: z7.boolean().optional(),
+  aerialBearing: z7.number().finite().optional(),
+  aerialPitch: z7.number().finite().optional(),
+  selectedDiagramIds: z7.array(z7.string()).optional(),
+  location: z7.object({
+    lat: z7.number().finite(),
+    lng: z7.number().finite()
+  }).optional()
+});
+var PluginAIInspirationAppliedPreset = z7.object({
+  source: z7.enum(["curated", "user"]),
+  presetId: z7.string().min(1),
+  name: z7.string().min(1),
+  savedPresetKind: z7.enum(["prompt", "style"]).optional(),
+  stylePrompt: z7.string().optional(),
+  modelId: z7.string().optional(),
+  referenceImages: z7.array(
+    z7.object({
+      url: z7.string().min(1),
+      label: z7.string().optional(),
+      weight: z7.number().finite().optional()
+    })
+  ).optional(),
+  siteDefaults: z7.object({
+    includeSatellite: z7.boolean().optional(),
+    includeStreetView: z7.boolean().optional(),
+    includeAerial: z7.boolean().optional()
+  }).optional()
+});
+var PluginAIInspirationVideoOptions = z7.object({
+  mode: PluginAIInspirationVideoMode.optional(),
+  endFrameShapeId: z7.string().optional(),
+  motion: PluginAIInspirationVideoMotion.optional(),
+  duration: PluginAIInspirationVideoDuration.optional()
+});
+var PluginAIInspirationModel = z7.object({
+  id: z7.string(),
+  label: z7.string(),
+  supportsMultiImage: z7.boolean(),
+  output: PluginAIInspirationModelOutput,
+  isDefault: z7.boolean().optional()
+});
+var PluginAIInspirationModelCapability = z7.object({
+  id: z7.string(),
+  output: PluginAIInspirationModelOutput,
+  provider: PluginAIInspirationRuntimeProvider,
+  supportsRegionEdit: z7.boolean(),
+  supportsReferenceImages: z7.boolean(),
+  supportsStylePresets: z7.boolean(),
+  supportsSiteContext: z7.boolean(),
+  supportsSketchGuidance: z7.boolean(),
+  supportsKeyframes: z7.boolean(),
+  maxExtraImages: z7.number().int().nonnegative(),
+  promptStrategy: PluginAIInspirationPromptStrategy
+});
+var PluginAIInspirationListModelsResult = z7.object({
+  defaultModelId: z7.string(),
+  models: z7.array(PluginAIInspirationModel)
+});
+var PluginAIInspirationGetModelCapabilitiesArgs = z7.object({
+  modelId: z7.string().min(1)
+});
+var PluginAIInspirationGetModelCapabilitiesResult = z7.object({
+  capability: PluginAIInspirationModelCapability
+});
+var PluginAIInspirationShapeRef = z7.object({
+  shapeId: z7.string(),
+  assetId: z7.string().optional(),
+  kind: PluginAIInspirationShapeKind,
+  name: z7.string().optional(),
+  width: z7.number().finite().optional(),
+  height: z7.number().finite().optional(),
+  outputType: PluginAIInspirationOutputKind.optional(),
+  sourceUrl: z7.string().optional()
+});
+var PluginAIInspirationListSourcesArgs = z7.object({
+  includeGenerated: z7.boolean().optional(),
+  includeSourceUrl: z7.boolean().optional()
+});
+var PluginAIInspirationListSourcesResult = z7.object({
+  sources: z7.array(PluginAIInspirationShapeRef)
+});
+var PluginAIInspirationGetSelectionResult = z7.object({
+  selectedShapeIds: z7.array(z7.string()),
+  sources: z7.array(PluginAIInspirationShapeRef)
+});
+var PluginAIInspirationPresetReferenceImage = z7.object({
+  url: z7.string(),
+  label: z7.string().optional(),
+  weight: z7.number().finite().optional()
+});
+var PluginAIInspirationPreset = z7.object({
+  id: z7.string(),
+  name: z7.string(),
+  source: z7.enum(["curated", "user"]),
+  modelId: z7.string(),
+  categoryId: z7.string().optional(),
+  categoryLabel: z7.string().optional(),
+  description: z7.string().optional(),
+  previewImageUrl: z7.string().optional(),
+  prompt: z7.string().optional(),
+  stylePrompt: z7.string().optional(),
+  tags: z7.array(z7.string()).optional(),
+  referenceImages: z7.array(PluginAIInspirationPresetReferenceImage).optional(),
+  siteDefaults: PluginAIInspirationAppliedPreset.shape.siteDefaults.optional()
+});
+var PluginAIInspirationPresetCategory = z7.object({
+  id: z7.string(),
+  label: z7.string(),
+  description: z7.string().optional()
+});
+var PluginAIInspirationGetPresetCatalogResult = z7.object({
+  categories: z7.array(PluginAIInspirationPresetCategory),
+  presets: z7.array(PluginAIInspirationPreset)
+});
+var PluginAIInspirationOutput = z7.object({
+  outputType: z7.enum(["image", "video"]),
+  shapeId: z7.string(),
+  assetId: z7.string(),
+  outputUrl: z7.string().optional(),
+  position: PluginAIInspirationPoint.optional()
+});
+var PluginAIInspirationDebugSummary = z7.record(z7.string(), JsonValue);
+var PluginAIInspirationRunMetadata = z7.object({
+  geometryFidelity: z7.string().optional(),
+  debugSummary: PluginAIInspirationDebugSummary.optional(),
+  streetViewComposite: z7.object({
+    used: z7.boolean(),
+    renderMode: z7.enum(["prompt_refs_default", "masked_composite_pilot"]),
+    backgroundLabel: z7.string().optional()
+  }).optional()
+});
+var PluginAIInspirationGenerateArgs = z7.object({
+  sourceShapeId: z7.string().min(1),
+  prompt: z7.string().min(1).max(8e3),
+  modelId: z7.string().optional(),
+  referenceShapeIds: z7.array(z7.string()).max(12).optional(),
+  referenceStrength: z7.enum(["low", "medium", "high"]).optional(),
+  appliedPreset: PluginAIInspirationAppliedPreset.optional(),
+  site: PluginAIInspirationSiteOptions.optional(),
+  regionHint: PluginAIInspirationRegionHint.optional(),
+  sketchGuidance: PluginAIInspirationSketchGuidance.optional(),
+  video: PluginAIInspirationVideoOptions.optional(),
+  runMode: PluginAIInspirationRunMode.optional()
+});
+var PluginAIInspirationRunResult = z7.object({
+  jobId: z7.string().optional(),
+  output: PluginAIInspirationOutput.optional(),
+  outputs: z7.array(PluginAIInspirationOutput).optional(),
+  metadata: PluginAIInspirationRunMetadata.optional()
+});
+var PluginAIInspirationRefineArgs = z7.object({
+  sourceShapeId: z7.string().min(1),
+  upscaleFactor: z7.union([z7.literal(1.5), z7.literal(2), z7.literal(4)]).optional(),
+  runMode: PluginAIInspirationRunMode.optional()
+});
+var PluginAIInspirationJobProgress = z7.object({
+  currentStep: z7.number().int().nonnegative().optional(),
+  totalSteps: z7.number().int().nonnegative().optional(),
+  message: z7.string().optional()
+});
+var PluginAIInspirationJob = z7.object({
+  jobId: z7.string(),
+  status: PluginAIInspirationJobStatus,
+  createdAt: z7.number(),
+  updatedAt: z7.number(),
+  completedAt: z7.number().optional(),
+  method: z7.string(),
+  progress: PluginAIInspirationJobProgress.optional(),
+  result: PluginAIInspirationRunResult.optional(),
+  error: z7.string().optional()
+});
+var PluginAIInspirationJobArgs = z7.object({
+  jobId: z7.string().min(1)
+});
+var PluginAIInspirationGetJobResult = z7.object({
+  job: PluginAIInspirationJob
+});
+var PluginAIInspirationCancelJobResult = z7.object({
+  job: PluginAIInspirationJob
+});
+var PluginAIInspirationListJobsResult = z7.object({
+  jobs: z7.array(PluginAIInspirationJob)
+});
+var PluginAIInspirationWorkflowVideoConfig = z7.object({
+  mode: z7.string().optional(),
+  motion: z7.string().optional(),
+  duration: z7.string().optional(),
+  endFrameShapeId: z7.string().optional()
+});
+var PluginAIInspirationGenerationInputSnapshot = z7.object({
+  version: z7.literal(1),
+  meta: z7.record(z7.string(), JsonValue),
+  regionHint: PluginAIInspirationRegionHint.optional(),
+  sketchGuidance: z7.record(z7.string(), JsonValue).optional(),
+  sourceCameraHeading: z7.number().finite().optional()
+});
+var PluginAIInspirationWorkflowOperation = z7.object({
+  type: z7.enum(["generate-image", "refine", "generate-video"]),
+  label: z7.string(),
+  prompt: z7.string().optional(),
+  modelId: z7.string().optional(),
+  presetId: z7.string().optional(),
+  presetName: z7.string().optional(),
+  refineFactor: z7.number().finite().optional(),
+  sourceRole: z7.enum(["primary", "end-frame"]).optional(),
+  video: PluginAIInspirationWorkflowVideoConfig.optional(),
+  generationInput: PluginAIInspirationGenerationInputSnapshot.optional()
+});
+var PluginAIInspirationWorkflowNode = z7.object({
+  id: z7.string(),
+  shapeId: z7.string(),
+  assetId: z7.string().optional(),
+  kind: PluginAIInspirationOutputKind,
+  state: z7.string(),
+  runState: PluginAIInspirationWorkflowRunState.optional(),
+  staleReason: z7.string().optional(),
+  incomingEdgeIds: z7.array(z7.string()),
+  outgoingEdgeIds: z7.array(z7.string()),
+  createdAt: z7.number(),
+  updatedAt: z7.number()
+});
+var PluginAIInspirationWorkflowEdge = z7.object({
+  id: z7.string(),
+  sourceNodeId: z7.string(),
+  targetNodeId: z7.string(),
+  arrowShapeId: z7.string().optional(),
+  operation: PluginAIInspirationWorkflowOperation,
+  state: z7.string(),
+  runState: PluginAIInspirationWorkflowRunState.optional(),
+  staleReason: z7.string().optional(),
+  supersededByEdgeId: z7.string().optional(),
+  createdAt: z7.number(),
+  updatedAt: z7.number()
+});
+var PluginAIInspirationWorkflow = z7.object({
+  id: z7.string(),
+  rootNodeIds: z7.array(z7.string()),
+  nodeIds: z7.array(z7.string()),
+  edgeIds: z7.array(z7.string()),
+  nodes: z7.record(z7.string(), PluginAIInspirationWorkflowNode),
+  edges: z7.record(z7.string(), PluginAIInspirationWorkflowEdge),
+  createdAt: z7.number(),
+  updatedAt: z7.number()
+});
+var PluginAIInspirationGetWorkflowForShapeArgs = z7.object({
+  shapeId: z7.string().min(1)
+});
+var PluginAIInspirationGetWorkflowForShapeResult = z7.object({
+  workflow: PluginAIInspirationWorkflow.nullable(),
+  node: PluginAIInspirationWorkflowNode.nullable()
+});
+var PluginAIInspirationRerunPlanResult = z7.discriminatedUnion(
+  "status",
+  [
+    z7.object({
+      status: z7.literal("ready"),
+      workflowId: z7.string(),
+      sourceNode: PluginAIInspirationWorkflowNode,
+      edgeIds: z7.array(z7.string()),
+      edges: z7.array(PluginAIInspirationWorkflowEdge),
+      recipe: z7.lazy(() => PluginAIInspirationRecipe),
+      needsEndFrame: z7.boolean(),
+      defaultEndFrameShapeId: z7.string().nullable()
+    }),
+    z7.object({
+      status: z7.literal("unavailable"),
+      reason: z7.enum([
+        "not-in-workflow",
+        "source-only",
+        "running",
+        "missing-input"
+      ])
+    })
+  ]
+);
+var PluginAIInspirationRerunSelectedBranchArgs = z7.object({
+  shapeId: z7.string().min(1),
+  endFrameShapeId: z7.string().optional(),
+  runMode: PluginAIInspirationRunMode.optional()
+});
+var PluginAIInspirationRecipeSlot = z7.object({
+  id: z7.string(),
+  type: z7.enum(["source-image", "end-frame"]),
+  label: z7.string(),
+  required: z7.boolean()
+});
+var PluginAIInspirationRecipeStep = z7.object({
+  id: z7.string(),
+  operation: PluginAIInspirationWorkflowOperation,
+  outputKind: z7.enum(["image", "video"])
+});
+var PluginAIInspirationRecipeDraft = z7.object({
+  name: z7.string(),
+  summary: z7.string(),
+  slots: z7.array(PluginAIInspirationRecipeSlot),
+  steps: z7.array(PluginAIInspirationRecipeStep).min(1).max(20),
+  outputKind: z7.enum(["image", "video"]),
+  thumbnailUrl: z7.string().optional()
+});
+var PluginAIInspirationRecipe = PluginAIInspirationRecipeDraft.extend({
+  version: z7.literal(1),
+  id: z7.string(),
+  fingerprint: z7.string().optional(),
+  createdAt: z7.number(),
+  updatedAt: z7.number()
+});
+var PluginAIInspirationExtractionResult = z7.discriminatedUnion(
+  "status",
+  [
+    z7.object({
+      status: z7.literal("ready"),
+      draft: PluginAIInspirationRecipeDraft
+    }),
+    z7.object({
+      status: z7.literal("unavailable"),
+      reason: z7.enum([
+        "not-in-workflow",
+        "source-only",
+        "missing-workflow",
+        "missing-node",
+        "missing-input",
+        "invalid-workflow"
+      ])
+    })
+  ]
+);
+var PluginAIInspirationListRecipesResult = z7.object({
+  recipes: z7.array(PluginAIInspirationRecipe)
+});
+var PluginAIInspirationSaveRecipeArgs = z7.object({
+  draft: PluginAIInspirationRecipeDraft,
+  name: z7.string().min(1)
+});
+var PluginAIInspirationSaveRecipeResult = z7.discriminatedUnion(
+  "status",
+  [
+    z7.object({ status: z7.literal("saved"), recipe: PluginAIInspirationRecipe }),
+    z7.object({
+      status: z7.literal("duplicate"),
+      recipe: PluginAIInspirationRecipe
+    }),
+    z7.object({ status: z7.literal("invalid-name"), recipe: z7.null() }),
+    z7.object({ status: z7.literal("failed"), recipe: z7.null() })
+  ]
+);
+var PluginAIInspirationDeleteRecipeArgs = z7.object({
+  recipeId: z7.string().min(1)
+});
+var PluginAIInspirationDeleteRecipeResult = z7.object({
+  deleted: z7.boolean()
+});
+var PluginAIInspirationExtractRecipeFromShapeArgs = z7.object({
+  shapeId: z7.string().min(1)
+});
+var PluginAIInspirationRunRecipeArgs = z7.object({
+  recipeId: z7.string().optional(),
+  recipe: PluginAIInspirationRecipe.optional(),
+  slotShapeIds: z7.record(z7.string(), z7.string()),
+  runMode: PluginAIInspirationRunMode.optional()
+});
+var PluginDocumentationAIInspirationApi = class {
+  constructor() {
+  }
+};
+
+// src/api/documentation/index.ts
+var PluginDocumentationApi = class {
+  constructor() {
+  }
+};
+
+// src/api/entity/buildableEnvelope.ts
+import * as z8 from "zod";
 var PluginBuildableEnvelopeApi = class {
   constructor() {
   }
 };
-var PluginBuildableEnvelopePolygonVertex = z7.union([
-  z7.object({ x: z7.number().finite(), z: z7.number().finite() }).strict(),
-  z7.tuple([z7.number().finite(), z7.number().finite()])
+var PluginBuildableEnvelopePolygonVertex = z8.union([
+  z8.object({ x: z8.number().finite(), z: z8.number().finite() }).strict(),
+  z8.tuple([z8.number().finite(), z8.number().finite()])
 ]);
-var PluginBuildableEnvelopeVerticalCap = z7.discriminatedUnion("kind", [
-  z7.object({
-    kind: z7.literal("max_height"),
-    maxHeight: z7.number().finite().positive()
+var PluginBuildableEnvelopeVerticalCap = z8.discriminatedUnion("kind", [
+  z8.object({
+    kind: z8.literal("max_height"),
+    maxHeight: z8.number().finite().positive()
   }).strict(),
-  z7.object({
-    kind: z7.literal("max_floors"),
-    maxFloors: z7.number().finite().int().positive()
+  z8.object({
+    kind: z8.literal("max_floors"),
+    maxFloors: z8.number().finite().int().positive()
   }).strict()
 ]);
-var PluginBuildableEnvelopeSetbackTier = z7.object({
-  aboveHeight: z7.number().finite().nonnegative(),
-  front: z7.number().finite().nonnegative(),
-  side: z7.number().finite().nonnegative(),
-  rear: z7.number().finite().nonnegative()
+var PluginBuildableEnvelopeSetbackTier = z8.object({
+  aboveHeight: z8.number().finite().nonnegative(),
+  front: z8.number().finite().nonnegative(),
+  side: z8.number().finite().nonnegative(),
+  rear: z8.number().finite().nonnegative()
 }).strict();
 function refineSetbackTiers(args, ctx) {
   const tiers = args.setbacks;
   if (tiers.length === 0) return;
   if (tiers[0].aboveHeight !== 0) {
     ctx.addIssue({
-      code: z7.ZodIssueCode.custom,
+      code: z8.ZodIssueCode.custom,
       path: ["setbacks", 0, "aboveHeight"],
       message: "Ground tier required: setbacks[0].aboveHeight must be 0."
     });
@@ -617,125 +1057,125 @@ function refineSetbackTiers(args, ctx) {
   for (let i = 1; i < tiers.length; i++) {
     if (!(tiers[i].aboveHeight > tiers[i - 1].aboveHeight)) {
       ctx.addIssue({
-        code: z7.ZodIssueCode.custom,
+        code: z8.ZodIssueCode.custom,
         path: ["setbacks", i, "aboveHeight"],
         message: "Setback tiers must be ordered by strictly increasing aboveHeight."
       });
     }
   }
 }
-var PluginBuildableEnvelopeCreateArgs = z7.object({
-  sitePolygon: z7.array(PluginBuildableEnvelopePolygonVertex).min(3),
-  lengthUnit: z7.union([z7.literal("ft"), z7.literal("m")]),
-  setbacks: z7.array(PluginBuildableEnvelopeSetbackTier).min(1),
+var PluginBuildableEnvelopeCreateArgs = z8.object({
+  sitePolygon: z8.array(PluginBuildableEnvelopePolygonVertex).min(3),
+  lengthUnit: z8.union([z8.literal("ft"), z8.literal("m")]),
+  setbacks: z8.array(PluginBuildableEnvelopeSetbackTier).min(1),
   verticalCap: PluginBuildableEnvelopeVerticalCap,
-  floorToFloor: z7.number().finite().positive(),
-  farRatio: z7.number().finite().positive().optional(),
-  lotCoverageMaxPct: z7.number().finite().min(0).max(100).optional()
+  floorToFloor: z8.number().finite().positive(),
+  farRatio: z8.number().finite().positive().optional(),
+  lotCoverageMaxPct: z8.number().finite().min(0).max(100).optional()
 }).strict().superRefine(refineSetbackTiers);
-var PluginBuildableEnvelopeCreateResult = z7.object({
-  buildableEnvelopeId: z7.string().min(1)
+var PluginBuildableEnvelopeCreateResult = z8.object({
+  buildableEnvelopeId: z8.string().min(1)
 }).strict();
-var PluginBuildableEnvelopeUpdateArgs = z7.object({
-  buildableEnvelopeId: z7.string().min(1),
-  sitePolygon: z7.array(PluginBuildableEnvelopePolygonVertex).min(3),
-  lengthUnit: z7.union([z7.literal("ft"), z7.literal("m")]),
-  setbacks: z7.array(PluginBuildableEnvelopeSetbackTier).min(1),
+var PluginBuildableEnvelopeUpdateArgs = z8.object({
+  buildableEnvelopeId: z8.string().min(1),
+  sitePolygon: z8.array(PluginBuildableEnvelopePolygonVertex).min(3),
+  lengthUnit: z8.union([z8.literal("ft"), z8.literal("m")]),
+  setbacks: z8.array(PluginBuildableEnvelopeSetbackTier).min(1),
   verticalCap: PluginBuildableEnvelopeVerticalCap,
-  floorToFloor: z7.number().finite().positive(),
-  farRatio: z7.number().finite().positive().optional(),
-  lotCoverageMaxPct: z7.number().finite().min(0).max(100).optional()
+  floorToFloor: z8.number().finite().positive(),
+  farRatio: z8.number().finite().positive().optional(),
+  lotCoverageMaxPct: z8.number().finite().min(0).max(100).optional()
 }).strict().superRefine(refineSetbackTiers);
-var PluginBuildableEnvelopeUpdateResult = z7.object({
-  buildableEnvelopeId: z7.string().min(1)
+var PluginBuildableEnvelopeUpdateResult = z8.object({
+  buildableEnvelopeId: z8.string().min(1)
 }).strict();
 
 // src/api/entity/department.ts
-import * as z8 from "zod";
+import * as z9 from "zod";
 var PluginDepartmentApi = class {
   constructor() {
   }
 };
-var PluginDepartmentCreateArgs = z8.object({
-  name: z8.string(),
-  color: z8.string()
+var PluginDepartmentCreateArgs = z9.object({
+  name: z9.string(),
+  color: z9.string()
 });
-var PluginDepartmentCreateResult = z8.object({
-  departmentId: z8.string()
+var PluginDepartmentCreateResult = z9.object({
+  departmentId: z9.string()
 });
-var PluginDepartmentEntry = z8.object({
-  id: z8.string(),
-  name: z8.string(),
-  color: z8.string()
+var PluginDepartmentEntry = z9.object({
+  id: z9.string(),
+  name: z9.string(),
+  color: z9.string()
 });
-var PluginDepartmentGetAllResult = z8.object({
-  departments: z8.array(PluginDepartmentEntry)
+var PluginDepartmentGetAllResult = z9.object({
+  departments: z9.array(PluginDepartmentEntry)
 });
 
 // src/api/entity/referenceLine.ts
-import * as z9 from "zod";
+import * as z10 from "zod";
 var PluginReferenceLineApi = class {
   constructor() {
   }
 };
-var PluginReferenceLineCreateMultiArgs = z9.object({
+var PluginReferenceLineCreateMultiArgs = z10.object({
   profile: PProfile
 });
-var PluginReferenceLineCreateMultiResult = z9.object({
-  referenceLineIds: z9.array(z9.string())
+var PluginReferenceLineCreateMultiResult = z10.object({
+  referenceLineIds: z10.array(z10.string())
 });
-var PluginReferenceLineGetProperty = z9.enum([
+var PluginReferenceLineGetProperty = z10.enum([
   "curve"
 ]);
-var PluginReferenceLineGetArgs = z9.object({
-  referenceLineId: z9.string(),
-  properties: z9.array(PluginReferenceLineGetProperty)
+var PluginReferenceLineGetArgs = z10.object({
+  referenceLineId: z10.string(),
+  properties: z10.array(PluginReferenceLineGetProperty)
 });
-var PluginReferenceLineGetResult = z9.object({
+var PluginReferenceLineGetResult = z10.object({
   curve: PCurve
 }).partial();
-var PluginReferenceLineGetAllResult = z9.object({
-  referenceLineIds: z9.array(z9.string())
+var PluginReferenceLineGetAllResult = z10.object({
+  referenceLineIds: z10.array(z10.string())
 });
-var PluginReferenceLineDeleteArgs = z9.object({
-  referenceLineId: z9.string()
+var PluginReferenceLineDeleteArgs = z10.object({
+  referenceLineId: z10.string()
 });
 
 // src/api/entity/space.ts
-import * as z10 from "zod";
+import * as z11 from "zod";
 var PluginSpaceApi = class {
   constructor() {
   }
 };
-var PluginSpaceCreateRectangularArgs = z10.object({
+var PluginSpaceCreateRectangularArgs = z11.object({
   position: PVec3,
-  dimensions: z10.object({
-    width: z10.number(),
-    height: z10.number(),
-    depth: z10.number()
+  dimensions: z11.object({
+    width: z11.number(),
+    height: z11.number(),
+    depth: z11.number()
   })
 });
-var PluginSpaceCreateRectangularResult = z10.object({
-  spaceId: z10.string()
+var PluginSpaceCreateRectangularResult = z11.object({
+  spaceId: z11.string()
 });
-var PluginSpaceCreateFromProfileArgs = z10.object({
+var PluginSpaceCreateFromProfileArgs = z11.object({
   profile: PProfile,
-  innerProfiles: z10.array(PProfile).optional(),
-  extrudeHeight: z10.number(),
+  innerProfiles: z11.array(PProfile).optional(),
+  extrudeHeight: z11.number(),
   position: PVec3
 });
-var PluginSpaceCreateFromProfileResult = z10.object({
-  spaceId: z10.string()
+var PluginSpaceCreateFromProfileResult = z11.object({
+  spaceId: z11.string()
 });
-var PluginSpaceUpdateGeometryFromProfileArgs = z10.object({
-  spaceId: z10.string(),
+var PluginSpaceUpdateGeometryFromProfileArgs = z11.object({
+  spaceId: z11.string(),
   profile: PProfile,
-  extrudeHeight: z10.number()
+  extrudeHeight: z11.number()
 });
-var PluginSpaceUpdateGeometryFromProfileResult = z10.object({
-  spaceId: z10.string()
+var PluginSpaceUpdateGeometryFromProfileResult = z11.object({
+  spaceId: z11.string()
 });
-var PluginSpaceGetProperty = z10.enum([
+var PluginSpaceGetProperty = z11.enum([
   // Basic
   "id",
   "type",
@@ -763,11 +1203,11 @@ var PluginSpaceGetProperty = z10.enum([
   // Derived from adjacency manager
   "adjacency"
 ]);
-var PluginSpaceGetArgs = z10.object({
-  spaceId: z10.string(),
-  properties: z10.array(PluginSpaceGetProperty)
+var PluginSpaceGetArgs = z11.object({
+  spaceId: z11.string(),
+  properties: z11.array(PluginSpaceGetProperty)
 });
-var PluginSpaceType = z10.enum([
+var PluginSpaceType = z11.enum([
   "Room",
   "Program Block",
   "Balcony",
@@ -779,44 +1219,44 @@ var PluginSpaceType = z10.enum([
   "Envelope",
   "Parking"
 ]);
-var PluginSpaceGetResult = z10.object({
+var PluginSpaceGetResult = z11.object({
   // Basic
-  id: z10.string(),
-  type: z10.string(),
-  room_type: z10.string(),
-  name: z10.string(),
+  id: z11.string(),
+  type: z11.string(),
+  room_type: z11.string(),
+  name: z11.string(),
   // Derived from parametric data
-  area: z10.number(),
-  breadth: z10.number(),
-  depth: z10.number(),
-  height: z10.number(),
-  massType: z10.string().nullable(),
+  area: z11.number(),
+  breadth: z11.number(),
+  depth: z11.number(),
+  height: z11.number(),
+  massType: z11.string().nullable(),
   spaceType: PluginSpaceType.nullable(),
-  storey: z10.number().nullable(),
-  departmentId: z10.string().nullable(),
-  departmentName: z10.string(),
-  departmentColor: z10.string(),
+  storey: z11.number().nullable(),
+  departmentId: z11.string().nullable(),
+  departmentName: z11.string(),
+  departmentColor: z11.string(),
   // Derived from mesh
   position: PVec3,
   absolutePosition: PVec3,
   rotation: PVec3,
   rotationQuaternion: PQuat.nullable(),
   // Derived from brep
-  planPoints: z10.array(PVec3),
+  planPoints: z11.array(PVec3),
   profile: PProfile,
   // Derived from adjacency manager
-  adjacency: z10.array(z10.object({
-    spaceId: z10.string(),
-    value: z10.number()
+  adjacency: z11.array(z11.object({
+    spaceId: z11.string(),
+    value: z11.number()
   }))
 }).partial();
-var PluginSpaceGetAllResult = z10.object({
-  spacesIds: z10.array(z10.string())
+var PluginSpaceGetAllResult = z11.object({
+  spacesIds: z11.array(z11.string())
 });
-var PluginSpaceDeleteArgs = z10.object({
-  spaceId: z10.string()
+var PluginSpaceDeleteArgs = z11.object({
+  spaceId: z11.string()
 });
-var PluginMassType = z10.enum([
+var PluginMassType = z11.enum([
   "Plinth",
   "Void",
   "Pergola",
@@ -830,95 +1270,95 @@ var PluginMassType = z10.enum([
   "Mass",
   "Site"
 ]);
-var PluginWellKnownDepartmentId = z10.enum([
+var PluginWellKnownDepartmentId = z11.enum([
   "DEFAULT",
   "SITE",
   "ENVELOPE",
   "CORE"
 ]);
-var PluginDepartmentId = z10.union([
+var PluginDepartmentId = z11.union([
   PluginWellKnownDepartmentId,
-  z10.uuid()
+  z11.uuid()
 ]);
-var PluginSpaceUpdateArgs = z10.object({
-  spaceId: z10.string(),
-  properties: z10.object({
-    room_type: z10.string().optional(),
+var PluginSpaceUpdateArgs = z11.object({
+  spaceId: z11.string(),
+  properties: z11.object({
+    room_type: z11.string().optional(),
     massType: PluginMassType.optional(),
     spaceType: PluginSpaceType.optional(),
     departmentId: PluginDepartmentId.optional()
   })
 });
-var PluginSpaceUpdateResult = z10.object({
-  spaceId: z10.string(),
-  room_type: z10.string().optional(),
-  massType: z10.string().optional(),
-  spaceType: z10.string().optional(),
-  departmentId: z10.string().nullable().optional()
+var PluginSpaceUpdateResult = z11.object({
+  spaceId: z11.string(),
+  room_type: z11.string().optional(),
+  massType: z11.string().optional(),
+  spaceType: z11.string().optional(),
+  departmentId: z11.string().nullable().optional()
 });
-var PluginSpaceBulkCreateItem = z10.discriminatedUnion("kind", [
-  z10.object({
-    kind: z10.literal("rectangular"),
+var PluginSpaceBulkCreateItem = z11.discriminatedUnion("kind", [
+  z11.object({
+    kind: z11.literal("rectangular"),
     position: PVec3,
-    dimensions: z10.object({
-      width: z10.number(),
-      height: z10.number(),
-      depth: z10.number()
+    dimensions: z11.object({
+      width: z11.number(),
+      height: z11.number(),
+      depth: z11.number()
     }),
-    room_type: z10.string().optional(),
+    room_type: z11.string().optional(),
     spaceType: PluginSpaceType.optional(),
     massType: PluginMassType.optional(),
     departmentId: PluginDepartmentId.optional()
   }),
-  z10.object({
-    kind: z10.literal("profile"),
+  z11.object({
+    kind: z11.literal("profile"),
     profile: PProfile,
-    innerProfiles: z10.array(PProfile).optional(),
-    extrudeHeight: z10.number(),
+    innerProfiles: z11.array(PProfile).optional(),
+    extrudeHeight: z11.number(),
     position: PVec3,
-    room_type: z10.string().optional(),
+    room_type: z11.string().optional(),
     spaceType: PluginSpaceType.optional(),
     massType: PluginMassType.optional(),
     departmentId: PluginDepartmentId.optional()
   })
 ]);
-var PluginSpaceBulkCreateArgs = z10.object({
-  items: z10.array(PluginSpaceBulkCreateItem)
+var PluginSpaceBulkCreateArgs = z11.object({
+  items: z11.array(PluginSpaceBulkCreateItem)
 });
-var PluginSpaceBulkCreateResult = z10.object({
-  spaceIds: z10.array(z10.string())
+var PluginSpaceBulkCreateResult = z11.object({
+  spaceIds: z11.array(z11.string())
 });
-var PluginSpaceBulkUpdateItem = z10.object({
-  spaceId: z10.string(),
+var PluginSpaceBulkUpdateItem = z11.object({
+  spaceId: z11.string(),
   profile: PProfile.optional(),
-  extrudeHeight: z10.number().optional(),
-  properties: z10.object({
-    room_type: z10.string().optional(),
+  extrudeHeight: z11.number().optional(),
+  properties: z11.object({
+    room_type: z11.string().optional(),
     massType: PluginMassType.optional(),
     spaceType: PluginSpaceType.optional(),
     departmentId: PluginDepartmentId.optional()
   }).optional()
 });
-var PluginSpaceBulkUpdateArgs = z10.object({
-  items: z10.array(PluginSpaceBulkUpdateItem)
+var PluginSpaceBulkUpdateArgs = z11.object({
+  items: z11.array(PluginSpaceBulkUpdateItem)
 });
-var PluginSpaceBulkUpdateResult = z10.object({
-  spaces: z10.array(PluginSpaceUpdateResult)
+var PluginSpaceBulkUpdateResult = z11.object({
+  spaces: z11.array(PluginSpaceUpdateResult)
 });
-var PluginSpaceBulkDeleteArgs = z10.object({
-  spaceIds: z10.array(z10.string())
+var PluginSpaceBulkDeleteArgs = z11.object({
+  spaceIds: z11.array(z11.string())
 });
-var PluginSpaceBulkDeleteResult = z10.object({
-  deletedSpaceIds: z10.array(z10.string())
+var PluginSpaceBulkDeleteResult = z11.object({
+  deletedSpaceIds: z11.array(z11.string())
 });
 
 // src/api/entity/story.ts
-import * as z11 from "zod";
+import * as z12 from "zod";
 var PluginStoryApi = class {
   constructor() {
   }
 };
-var PluginStoryGetProperty = z11.enum([
+var PluginStoryGetProperty = z12.enum([
   "value",
   "id",
   "name",
@@ -928,44 +1368,44 @@ var PluginStoryGetProperty = z11.enum([
   "spacesCount",
   "totalArea"
 ]);
-var PluginStoryGetArgs = z11.object({
-  storyValue: z11.number().int(),
-  properties: z11.array(PluginStoryGetProperty)
+var PluginStoryGetArgs = z12.object({
+  storyValue: z12.number().int(),
+  properties: z12.array(PluginStoryGetProperty)
 });
-var PluginStoryGetResult = z11.object({
-  value: z11.number(),
-  id: z11.string(),
-  name: z11.string(),
-  height: z11.number(),
-  base: z11.number(),
-  hidden: z11.boolean(),
-  spacesCount: z11.number(),
-  totalArea: z11.number()
+var PluginStoryGetResult = z12.object({
+  value: z12.number(),
+  id: z12.string(),
+  name: z12.string(),
+  height: z12.number(),
+  base: z12.number(),
+  hidden: z12.boolean(),
+  spacesCount: z12.number(),
+  totalArea: z12.number()
 }).partial();
-var PluginStoryGetAllResult = z11.object({
-  stories: z11.array(
-    z11.object({
-      value: z11.number(),
-      id: z11.string(),
-      name: z11.string()
+var PluginStoryGetAllResult = z12.object({
+  stories: z12.array(
+    z12.object({
+      value: z12.number(),
+      id: z12.string(),
+      name: z12.string()
     })
   )
 });
-var PluginStoryCreateArgs = z11.object({
-  storyValue: z11.number().int(),
-  height: z11.number().optional()
+var PluginStoryCreateArgs = z12.object({
+  storyValue: z12.number().int(),
+  height: z12.number().optional()
 });
-var PluginStoryCreateResult = z11.object({
-  storyId: z11.string(),
-  storyValue: z11.number()
+var PluginStoryCreateResult = z12.object({
+  storyId: z12.string(),
+  storyValue: z12.number()
 });
-var PluginStoryUpdateArgs = z11.object({
-  storyValue: z11.number().int(),
-  height: z11.number()
+var PluginStoryUpdateArgs = z12.object({
+  storyValue: z12.number().int(),
+  height: z12.number()
 });
-var PluginStoryUpdateResult = z11.object({
-  storyValue: z11.number(),
-  height: z11.number()
+var PluginStoryUpdateResult = z12.object({
+  storyValue: z12.number(),
+  height: z12.number()
 });
 
 // src/api/entity/index.ts
@@ -975,53 +1415,53 @@ var PluginEntityApi = class {
 };
 
 // src/api/tools/copy.ts
-import * as z12 from "zod";
-var PluginCopyMode = z12.enum(["instance", "unique"]);
-var PluginCopyArgs = z12.object({
-  componentIds: z12.array(z12.string()).min(1),
+import * as z13 from "zod";
+var PluginCopyMode = z13.enum(["instance", "unique"]);
+var PluginCopyArgs = z13.object({
+  componentIds: z13.array(z13.string()).min(1),
   displacement: PVec3,
-  count: z12.number().int().positive().optional(),
+  count: z13.number().int().positive().optional(),
   copyMode: PluginCopyMode.optional()
 });
-var PluginCopyResult = z12.object({
-  copiedIds: z12.array(z12.string())
+var PluginCopyResult = z13.object({
+  copiedIds: z13.array(z13.string())
 });
 
 // src/api/tools/offset.ts
-import * as z13 from "zod";
-var PluginOffsetArgs = z13.object({
-  componentId: z13.string().min(1),
-  distance: z13.number(),
+import * as z14 from "zod";
+var PluginOffsetArgs = z14.object({
+  componentId: z14.string().min(1),
+  distance: z14.number(),
   profilePickPoint: PVec3.optional()
 });
-var PluginOffsetResult = z13.object({
-  createdIds: z13.array(z13.string()),
-  deletedIds: z13.array(z13.string())
+var PluginOffsetResult = z14.object({
+  createdIds: z14.array(z14.string()),
+  deletedIds: z14.array(z14.string())
 });
 
 // src/api/tools/selection.ts
-import * as z14 from "zod";
+import * as z15 from "zod";
 var PluginSelectionApi = class {
   constructor() {
   }
 };
-var PluginSelectionGetResult = z14.object({
-  selected: z14.array(z14.string())
+var PluginSelectionGetResult = z15.object({
+  selected: z15.array(z15.string())
 });
 
 // src/api/tools/transform.ts
-import * as z15 from "zod";
+import * as z16 from "zod";
 var PluginTransformApi = class {
   constructor() {
   }
 };
-var PluginMoveArgs = z15.object({
-  componentIds: z15.array(z15.string()),
+var PluginMoveArgs = z16.object({
+  componentIds: z16.array(z16.string()),
   displacement: PVec3
 });
-var PluginRotateArgs = z15.object({
-  componentIds: z15.array(z15.string()),
-  angle: z15.number(),
+var PluginRotateArgs = z16.object({
+  componentIds: z16.array(z16.string()),
+  angle: z16.number(),
   axis: PVec3,
   pivot: PVec3
 });
@@ -1033,12 +1473,12 @@ var PluginToolsApi = class {
 };
 
 // src/api/units/index.ts
-import * as z16 from "zod";
+import * as z17 from "zod";
 var PluginUnitsApi = class {
   constructor() {
   }
 };
-var PUnitType = z16.enum([
+var PUnitType = z17.enum([
   "meters",
   "feet-inches",
   "inches",
@@ -1047,21 +1487,21 @@ var PUnitType = z16.enum([
   "kilometers",
   "miles"
 ]);
-var PluginUnitsConvertFromArgs = z16.object({
+var PluginUnitsConvertFromArgs = z17.object({
   unit: PUnitType,
-  value: z16.number(),
-  degree: z16.number().int().min(1).max(3).optional()
+  value: z17.number(),
+  degree: z17.number().int().min(1).max(3).optional()
 });
-var PluginUnitsConvertFromResult = z16.object({
-  value: z16.number()
+var PluginUnitsConvertFromResult = z17.object({
+  value: z17.number()
 });
-var PluginUnitsConvertToArgs = z16.object({
+var PluginUnitsConvertToArgs = z17.object({
   unit: PUnitType,
-  value: z16.number(),
-  degree: z16.number().int().min(1).max(3).optional()
+  value: z17.number(),
+  degree: z17.number().int().min(1).max(3).optional()
 });
-var PluginUnitsConvertToResult = z16.object({
-  value: z16.number()
+var PluginUnitsConvertToResult = z17.object({
+  value: z17.number()
 });
 
 // src/api/index.ts
@@ -1077,6 +1517,71 @@ export {
   PQuat,
   PUnitType,
   PVec3,
+  PluginAIInspirationAppliedPreset,
+  PluginAIInspirationCancelJobResult,
+  PluginAIInspirationDebugSummary,
+  PluginAIInspirationDeleteRecipeArgs,
+  PluginAIInspirationDeleteRecipeResult,
+  PluginAIInspirationExtractRecipeFromShapeArgs,
+  PluginAIInspirationExtractionResult,
+  PluginAIInspirationGenerateArgs,
+  PluginAIInspirationGenerationInputSnapshot,
+  PluginAIInspirationGetJobResult,
+  PluginAIInspirationGetModelCapabilitiesArgs,
+  PluginAIInspirationGetModelCapabilitiesResult,
+  PluginAIInspirationGetPresetCatalogResult,
+  PluginAIInspirationGetSelectionResult,
+  PluginAIInspirationGetWorkflowForShapeArgs,
+  PluginAIInspirationGetWorkflowForShapeResult,
+  PluginAIInspirationJob,
+  PluginAIInspirationJobArgs,
+  PluginAIInspirationJobProgress,
+  PluginAIInspirationJobStatus,
+  PluginAIInspirationListJobsResult,
+  PluginAIInspirationListModelsResult,
+  PluginAIInspirationListRecipesResult,
+  PluginAIInspirationListSourcesArgs,
+  PluginAIInspirationListSourcesResult,
+  PluginAIInspirationModel,
+  PluginAIInspirationModelCapability,
+  PluginAIInspirationModelOutput,
+  PluginAIInspirationOutput,
+  PluginAIInspirationOutputKind,
+  PluginAIInspirationPoint,
+  PluginAIInspirationPreset,
+  PluginAIInspirationPresetCategory,
+  PluginAIInspirationPresetReferenceImage,
+  PluginAIInspirationPromptStrategy,
+  PluginAIInspirationRecipe,
+  PluginAIInspirationRecipeDraft,
+  PluginAIInspirationRecipeSlot,
+  PluginAIInspirationRecipeStep,
+  PluginAIInspirationRefineArgs,
+  PluginAIInspirationRegionHint,
+  PluginAIInspirationRerunPlanResult,
+  PluginAIInspirationRerunSelectedBranchArgs,
+  PluginAIInspirationRunMetadata,
+  PluginAIInspirationRunMode,
+  PluginAIInspirationRunRecipeArgs,
+  PluginAIInspirationRunResult,
+  PluginAIInspirationRuntimeProvider,
+  PluginAIInspirationSaveRecipeArgs,
+  PluginAIInspirationSaveRecipeResult,
+  PluginAIInspirationShapeKind,
+  PluginAIInspirationShapeRef,
+  PluginAIInspirationSiteOptions,
+  PluginAIInspirationSketchGuidance,
+  PluginAIInspirationTextAnnotation,
+  PluginAIInspirationVideoDuration,
+  PluginAIInspirationVideoMode,
+  PluginAIInspirationVideoMotion,
+  PluginAIInspirationVideoOptions,
+  PluginAIInspirationWorkflow,
+  PluginAIInspirationWorkflowEdge,
+  PluginAIInspirationWorkflowNode,
+  PluginAIInspirationWorkflowOperation,
+  PluginAIInspirationWorkflowRunState,
+  PluginAIInspirationWorkflowVideoConfig,
   PluginApi,
   PluginArcApi,
   PluginBuildableEnvelopeApi,
@@ -1098,6 +1603,8 @@ export {
   PluginDepartmentEntry,
   PluginDepartmentGetAllResult,
   PluginDepartmentId,
+  PluginDocumentationAIInspirationApi,
+  PluginDocumentationApi,
   PluginEntityApi,
   PluginGeomApi,
   PluginLineApi,