// ===== Shared Enums =====

enum IntegrationType {
  Automatic
  OneClick
  API
  Webhook
  ViaThirdParty @alias("Via third-party")
  Manual
}

enum EntityStatus {
  Confirmed @alias("confirmed")
  Hypothetical @alias("hypothetical")
}

// ===== Helper Classes =====

class Position {
  x float @description("X coordinate (0-2000)")
  y float @description("Y coordinate (0-1500)")
}

class Dimensions {
  width float @description("Width in pixels")
  height float @description("Height in pixels")
}

// ===== UPSERT Operations =====

class UpsertNodeOperation {
  type "upsert_node"
  product_id string @description("UUID of the product from catalog")
  label string? @description("Optional custom label for the node")
  position Position @description("2D coordinates on canvas (0-2000 x, 0-1500 y)")
  parent_environment_id string? @description("ID of parent environment container (if any)")
  status EntityStatus @description("confirmed = user owns, hypothetical = recommendation")
  product_name string @description("Human-readable product name")
  tagline string? @description("Product tagline from catalog")
}

class UpsertEdgeOperation {
  type "upsert_edge"
  // DO NOT include edge_id - generated server-side
  source_product_id string @description("UUID of source node")
  target_product_id string @description("UUID of target node")
  label string @description("Edge label: '{integration_type}: {data_type}' (e.g., 'API: Customer data')")
  description string @description("ONE sentence describing data flow from source to target")
  bidirectional bool @description("true if data flows both ways")
  integration_type IntegrationType @description("How the integration works")
  status EntityStatus @description("confirmed or hypothetical")
}

operations

class DiagramCompositionResult {
  operations (UpsertNodeOperation | UpsertEdgeOperation | UpsertEnvironmentOperation | DeleteNodeOperation | DeleteEdgeOperation | DeleteEnvironmentOperation)[] @description("List of operations to apply")
}

function ComposeDiagram(
  request: DiagramCompositionRequest
) -> DiagramCompositionResult {

position

position

0.202.1

operations