@reveldigital/mcp-graphql-proxy 2.1.0 → 2.3.0

package/src/types/schema.graphql

@@ -341,6 +341,23 @@ type Query {
     order: [AdHawkDeviceMediaImpressionsSortInput!] @cost(weight: "10")
   ): [AdHawkDeviceMediaImpressions] @cost(weight: "10")
   """
+  Gets alert rules for the authenticated account.
+  
+  
+  **Returns:**
+  List of alert rules
+  """
+  alertRule(
+    "Filter by specific alert rule IDs (encrypted)"
+    id: [String!]
+    "Filter by organization ID (encrypted)"
+    orgId: String
+    "Maximum number of items to return"
+    limit: Int
+    where: AlertRuleFilterInput @cost(weight: "10")
+    order: [AlertRuleSortInput!] @cost(weight: "10")
+  ): [AlertRule] @cost(weight: "10")
+  """
   Gets alerts for the authenticated account.
   
   
@@ -395,6 +412,20 @@ type Query {
     where: AuditEventFilterInput @cost(weight: "10")
     order: [AuditEventSortInput!] @cost(weight: "10")
   ): [AuditEvent!]! @cost(weight: "10")
+  """
+  Fetches a normalized dataset from a registered connector data source through the broker.
+  The caller never sends SQL; it references a datasetId on a
+  datasourceId plus validated params. The tenant is
+  resolved from the caller's API key / bearer, never supplied by the caller.
+  """
+  connectorData(
+    "The registered data source identifier."
+    datasourceId: String
+    "The registered dataset identifier on that source."
+    datasetId: String
+    "Optional validated parameters for the dataset (JSON object)."
+    params: [Any]
+  ): ConnectorData @cost(weight: "10")
   "Lists data tables in the account, with optional group filtering."
   dataTables(
     "Optional group ID to filter by"
@@ -438,6 +469,10 @@ type Query {
       inRange       value is between from and to (inclusive)
       outOfRange    value is outside [from, to]
     
+    Set operators (require a non-empty `values` array):
+      in            value matches one of the entries in `values`
+      notIn         value matches none of the entries in `values`
+    
     No-value operators (no `value` / `from` / `to`):
       isEmpty       column is null / empty string
       isNotEmpty    column has a value
@@ -465,6 +500,7 @@ type Query {
       {"price": {"op": "gte", "value": 25}}
       {"name": {"op": "contains", "value": "pizza"}}
       {"score": {"op": "inRange", "from": 0, "to": 100}}
+      {"category": {"op": "in", "values": ["Entree", "Dessert"]}}
       {"deletedAt": {"op": "isEmpty"}}
       {"publishAt": {"op": "beforeNow"}}
     
@@ -623,6 +659,17 @@ type Query {
 }
 
 type Mutation {
+  """
+  Create a new alert rule.
+  Example: An AI agent creates a rule that fires when a lobby display goes offline.
+  """
+  createAlertRule(input: AlertRuleInput): AlertRuleMutationResult
+    @cost(weight: "10")
+  "Update an existing alert rule."
+  updateAlertRule(input: AlertRuleInput): AlertRuleMutationResult
+    @cost(weight: "10")
+  "Delete an alert rule."
+  deleteAlertRule(id: String): AlertRuleMutationResult @cost(weight: "10")
   """
   Create a new data table with the specified column schema.
   Example: Create a menu board table with columns for item name, price, description, and image.
@@ -779,6 +826,60 @@ type Mutation {
   """
   reorderPlaylistSources(input: ReorderPlaylistSourcesInput): PlaylistMutationResult
     @cost(weight: "10")
+  """
+  Update a template's properties (name, tags, dimensions, colors, etc.).
+  Example: AI adjusts template dimensions to optimize for a new display resolution.
+  """
+  updateTemplate(input: UpdateTemplateInput): TemplateMutationResult
+    @cost(weight: "10")
+  """
+  Add a new module to a template.
+  Example: AI adds a new weather module to show real-time conditions in the corner.
+  """
+  addTemplateModule(input: AddTemplateModuleInput): ModuleMutationResult
+    @cost(weight: "10")
+  """
+  Update a module within a template.
+  Example: AI repositions a module based on engagement analytics, or changes the assigned playlist.
+  """
+  updateTemplateModule(input: UpdateTemplateModuleInput): ModuleMutationResult
+    @cost(weight: "10")
+  """
+  Remove a module from a template.
+  Example: AI removes an underperforming ad module to optimize content flow.
+  """
+  removeTemplateModule(input: RemoveTemplateModuleInput): ModuleMutationResult
+    @cost(weight: "10")
+  """
+  Reorder modules within a template by updating their sequence/z-order.
+  Example: AI reorders modules to bring important content to the front based on viewer engagement.
+  """
+  reorderTemplateModules(input: ReorderTemplateModulesInput): TemplateMutationResult
+    @cost(weight: "10")
+  """
+  Batch update multiple modules in a template at once.
+  Example: AI repositions all modules to create a new layout optimized for viewer attention.
+  """
+  batchUpdateTemplateModules(input: BatchUpdateTemplateModulesInput): BatchModuleMutationResult
+    @cost(weight: "10")
+  """
+  Set all options for a module (replaces existing options).
+  Example: AI configures a weather module with location, units, and API key settings.
+  """
+  setModuleOptions(input: SetModuleOptionsInput): ModuleMutationResult
+    @cost(weight: "10")
+  """
+  Add or update a single module option.
+  Example: AI updates the refresh interval for a web module.
+  """
+  upsertModuleOption(input: UpsertModuleOptionInput): ModuleOptionMutationResult
+    @cost(weight: "10")
+  """
+  Remove a module option by name.
+  Example: AI removes an outdated configuration setting from a module.
+  """
+  removeModuleOption(input: RemoveModuleOptionInput): ModuleOptionMutationResult
+    @cost(weight: "10")
 }
 
 "Aggregated audience metrics for a device over a time period"
@@ -1229,6 +1330,67 @@ type AlertDevice {
   name: String
 }
 
+"Full alert rule model. An alert rule defines the conditions that trigger alerts."
+type AlertRule {
+  "The alert rule id (encrypted)"
+  id: String
+  "The name of the alert rule"
+  name: String
+  """
+  The rule set configuration as a JSON string. See AlertRuleInput.ruleSet for the full
+  schema, supported condition types, operators, and value semantics.
+  """
+  ruleSet: String
+  """
+  Indicates whether the alert rule is currently enabled and will be evaluated.
+  When false, the rule is stored but never triggers alerts.
+  """
+  isEnabled: Boolean
+  "The look-back / evaluation period, in minutes, used by time-window based conditions."
+  period: Int
+  """
+  A legacy scalar threshold value retained for backward compatibility. Thresholds for new
+  rules are expressed inside the rule set (AlertRuleInput.ruleSet) via each item's "value" instead.
+  """
+  threshold: Int
+  "Optional HTTPS webhook URL that is invoked (HTTP POST) when the rule triggers."
+  webhookUrl: String
+  """
+  When true, the rule is evaluated against every device in the account and
+  DeviceIds is empty. When false, only DeviceIds are evaluated.
+  """
+  allDevices: Boolean
+  """
+  When true, all users in the account are notified and UserIds is empty.
+  When false, only the users in UserIds are notified.
+  """
+  allUsers: Boolean
+  "The date and time the alert rule was created"
+  createdOn: DateTime
+  "The date and time the alert rule was last updated"
+  updatedOn: DateTime
+  """
+  The devices explicitly associated with the rule (encrypted ids).
+  Empty when AllDevices is true.
+  """
+  deviceIds: [String]
+  """
+  The users explicitly notified by the rule (encrypted ids).
+  Empty when AllUsers is true.
+  """
+  userIds: [String]
+}
+
+"Result from an alert rule mutation."
+type AlertRuleMutationResult {
+  "Whether the operation was successful."
+  success: Boolean!
+  "The created or updated alert rule."
+  alertRule: AlertRule
+  "Error message if the operation failed."
+  error: String
+}
+
 "Alert rule summary (minimal info included with alerts)"
 type AlertRuleSummary {
   "The alert rule id (encrypted)"
@@ -1299,6 +1461,18 @@ type BatchDeleteDataTableRowsResult {
   error: String
 }
 
+"Result from batch updating multiple modules."
+type BatchModuleMutationResult {
+  "Total number of modules attempted."
+  totalModules: Int!
+  "Number of successful updates."
+  successCount: Int!
+  "Number of failed updates."
+  failureCount: Int!
+  "Per-module results."
+  results: [ModuleMutationResult]
+}
+
 type BatchRowResultModel {
   rowId: String
   success: Boolean!
@@ -1393,6 +1567,12 @@ type BulkCommandResult {
   results: [CommandResult]
 }
 
+"Describes a single column in a ConnectorData result."
+type ColumnMeta {
+  name: String
+  type: String
+}
+
 "Result from sending commands to a device."
 type CommandResult {
   "Whether the command was successfully queued."
@@ -1420,6 +1600,25 @@ type Condition {
   value4: String
 }
 
+"""
+A normalized, source-agnostic dataset returned by the connector broker. The same shape
+carries SQL rows, HTTP-JSON rows and RSS items alike. Mirrors the broker HTTP contract
+(POST {BrokerUrl}/v1/connector-data).
+"""
+type ConnectorData {
+  "The columns, in row order."
+  columns: [ColumnMeta]
+  """
+  Row-major data; each row is an array of cell values aligned to Columns.
+  Exposed through the JSON scalar so arbitrary SQL/JSON/RSS cell values flow through.
+  """
+  rows: [[Any]]
+  "Epoch milliseconds at which the broker last fetched the underlying data."
+  fetchedAt: Long!
+  "True when the broker served a cached copy while revalidating (stale-while-revalidate)."
+  stale: Boolean!
+}
+
 "Result from creating media from a URL."
 type CreateMediaResult {
   "Whether the upload was successful."
@@ -1482,8 +1681,12 @@ type DataTableRowModel {
   data: Any
   updatedAt: DateTime!
   """
-  Optimistic concurrency token. Pass this value back as `eTag` in
-  `updateDataTableRow` to ensure the row hasn't been changed since you read it.
+  Optimistic concurrency token. To ensure the row hasn't changed since you read it,
+  send this value back as the If-Match request header on the REST
+  updateDataTableRow (HTTP PUT) call, or as the eTag input field on
+  the GraphQL updateDataTableRow mutation. A stale token results in
+  409 Conflict (REST) or a mutation error (GraphQL). Note: the REST endpoint does
+  not read an eTag body property — it uses the If-Match header.
   """
   eTag: String
 }
@@ -1760,28 +1963,73 @@ type Media {
 }
 
 """
-Represents a module (zone/region) within a template layout.
-Modules define rectangular areas on screen where content from playlists is displayed.
+Represents a module (also called a zone or region) within a template layout.
+Modules/zones define rectangular areas on screen where content from playlists is displayed.
+The terms "module" and "zone" are used interchangeably throughout the API.
 """
 type Module {
-  "Module id"
+  "Module/zone unique identifier"
   id: String
-  "Module name"
+  "Module/zone name"
   name: String
-  "Module type"
+  "Module/zone type (e.g., 'Playlist', 'Clock', 'Weather', 'Ticker', 'Web')"
   type: String
-  "Left position"
+  "Left position in pixels from the top-left corner of the template"
   left: Int
-  "Top position"
+  "Top position in pixels from the top-left corner of the template"
   top: Int
-  "Width"
+  "Width of the module/zone in pixels"
   width: Int
-  "Height"
+  "Height of the module/zone in pixels"
   height: Int
-  "Playlist assigned to this module"
+  """
+  Playlist ID assigned to this module/zone.
+  Determines what content is displayed in this area of the screen.
+  """
   playlistId: String
-  "Sequence or Z-Order"
+  """
+  Sequence or Z-order for overlapping modules/zones.
+  Higher values appear in front of lower values.
+  """
   sequence: Int
+  """
+  Module/zone configuration options (key-value pairs).
+  Used to store type-specific settings like timezone for Clock zones, location for Weather zones, etc.
+  """
+  options: [ModuleOption]
+}
+
+"Result from a module mutation within a template."
+type ModuleMutationResult {
+  "Whether the operation was successful."
+  success: Boolean!
+  "The created or updated module."
+  module: Module
+  "Error message if the operation failed."
+  error: String
+}
+
+"""
+Represents a configuration option for a module/zone (key-value pair).
+Module/zone options store settings specific to each module/zone type.
+"""
+type ModuleOption {
+  "Module/zone option unique identifier"
+  id: String
+  "Option name/key (e.g., 'timezone', 'location', 'refresh_interval')"
+  name: String
+  "Option value (stored as string, parse as needed for the specific option)"
+  value: String
+}
+
+"Result from a module option mutation."
+type ModuleOptionMutationResult {
+  "Whether the operation was successful."
+  success: Boolean!
+  "The created or updated module option."
+  option: ModuleOption
+  "Error message if the operation failed."
+  error: String
 }
 
 """
@@ -2126,12 +2374,26 @@ type Template {
   width: Int
   "Height"
   height: Int
-  "Orientation (Landscape, Portrait, Landscape Reversed, Portrait Reversed)"
+  "Display orientation: Landscape, Portrait, Landscape Reversed, or Portrait Reversed"
   orientation: Int
-  "Modules or zones"
+  """
+  Collection of modules/zones that define content areas within this template.
+  Each module/zone represents a rectangular region where content from a playlist is displayed.
+  The terms "module" and "zone" are used interchangeably.
+  """
   modules: [Module]
 }
 
+"Result from a template mutation."
+type TemplateMutationResult {
+  "Whether the operation was successful."
+  success: Boolean!
+  "The updated template."
+  template: Template
+  "Error message if the operation failed."
+  error: String
+}
+
 "Result from updating media metadata."
 type UpdateMediaResult {
   "Whether the operation was successful."
@@ -2211,6 +2473,14 @@ input AddPlaylistSourceInput {
   position: Int
 }
 
+"Input for adding a module to a template."
+input AddTemplateModuleInput {
+  "The template ID to add the module to."
+  templateId: String
+  "The module to add."
+  module: ModuleInput
+}
+
 "Aggregated audience metrics for a device over a time period"
 input AdHawkAudienceMetricsFilterInput {
   and: [AdHawkAudienceMetricsFilterInput!]
@@ -3113,6 +3383,142 @@ input AlertFilterInput {
   isActive: BooleanOperationFilterInput
 }
 
+"Full alert rule model. An alert rule defines the conditions that trigger alerts."
+input AlertRuleFilterInput {
+  and: [AlertRuleFilterInput!]
+  or: [AlertRuleFilterInput!]
+  "The alert rule id (encrypted)"
+  id: StringOperationFilterInput
+  "The name of the alert rule"
+  name: StringOperationFilterInput
+  """
+  The rule set configuration as a JSON string. See AlertRuleInput.ruleSet for the full
+  schema, supported condition types, operators, and value semantics.
+  """
+  ruleSet: StringOperationFilterInput
+  """
+  Indicates whether the alert rule is currently enabled and will be evaluated.
+  When false, the rule is stored but never triggers alerts.
+  """
+  isEnabled: BooleanOperationFilterInput
+  "The look-back / evaluation period, in minutes, used by time-window based conditions."
+  period: IntOperationFilterInput
+  """
+  A legacy scalar threshold value retained for backward compatibility. Thresholds for new
+  rules are expressed inside the rule set (AlertRuleInput.ruleSet) via each item's "value" instead.
+  """
+  threshold: IntOperationFilterInput
+  "Optional HTTPS webhook URL that is invoked (HTTP POST) when the rule triggers."
+  webhookUrl: StringOperationFilterInput
+  """
+  When true, the rule is evaluated against every device in the account and
+  DeviceIds is empty. When false, only DeviceIds are evaluated.
+  """
+  allDevices: BooleanOperationFilterInput
+  """
+  When true, all users in the account are notified and UserIds is empty.
+  When false, only the users in UserIds are notified.
+  """
+  allUsers: BooleanOperationFilterInput
+  "The date and time the alert rule was created"
+  createdOn: DateTimeOperationFilterInput
+  "The date and time the alert rule was last updated"
+  updatedOn: DateTimeOperationFilterInput
+  """
+  The devices explicitly associated with the rule (encrypted ids).
+  Empty when AllDevices is true.
+  """
+  deviceIds: ListStringOperationFilterInput
+  """
+  The users explicitly notified by the rule (encrypted ids).
+  Empty when AllUsers is true.
+  """
+  userIds: ListStringOperationFilterInput
+}
+
+"GraphQL input for creating or updating an alert rule."
+input AlertRuleInput {
+  "The alert rule id (encrypted). Required for update, omitted for create."
+  id: String
+  "The name of the alert rule."
+  name: String
+  """
+  The rule set configuration, supplied as a JSON string (serialized JSON, not a nested object).
+  A rule set is an array of condition groups combined with logical AND; the items within each group
+  are combined with logical OR. Each item is { "type", "op", "value" }: "type" (required, case-sensitive)
+  is one of TimeOffline, LastUpdate, MemoryUsage, CpuUsage, DiskUsage, NoContent, BytesTxDay, BytesRxDay,
+  BytesTotalDay, BytesTxPeriod, BytesRxPeriod, BytesTotalPeriod, ClockSkew, DisplayDetected, BatteryVoltage,
+  BatteryPercentage, or SystemTemperature; "op" (optional) is EQ, NE, GT, LT, GTE, or LTE (defaults to EQ);
+  "value" (required) is a non-empty array of numbers. Example:
+  [{"items":[{"type":"CpuUsage","op":"GTE","value":[90]}]}]. Invalid rule sets are rejected. Null or empty
+  leaves the rule unevaluated.
+  """
+  ruleSet: String
+  "Indicates if the alert rule is enabled."
+  isEnabled: Boolean
+  """
+  The look-back / evaluation period, in minutes, used by time-window based conditions
+  such as NoContent. Ignored by conditions that read the current value.
+  """
+  period: Int
+  """
+  A legacy scalar threshold value retained for backward compatibility. New rules should
+  express thresholds inside RuleSet via each item's "value" instead.
+  """
+  threshold: Int
+  "Optional webhook URL that is invoked when the rule triggers."
+  webhookUrl: String
+  "If true, the rule applies to all devices in the account."
+  allDevices: Boolean
+  "If true, the rule notifies all users in the account."
+  allUsers: Boolean
+  "The devices to associate with the rule (encrypted ids). Ignored when AllDevices is true."
+  deviceIds: [String]
+  "The users to notify (encrypted ids). Ignored when AllUsers is true."
+  userIds: [String]
+}
+
+"Full alert rule model. An alert rule defines the conditions that trigger alerts."
+input AlertRuleSortInput {
+  "The alert rule id (encrypted)"
+  id: SortEnumType @cost(weight: "10")
+  "The name of the alert rule"
+  name: SortEnumType @cost(weight: "10")
+  """
+  The rule set configuration as a JSON string. See AlertRuleInput.ruleSet for the full
+  schema, supported condition types, operators, and value semantics.
+  """
+  ruleSet: SortEnumType @cost(weight: "10")
+  """
+  Indicates whether the alert rule is currently enabled and will be evaluated.
+  When false, the rule is stored but never triggers alerts.
+  """
+  isEnabled: SortEnumType @cost(weight: "10")
+  "The look-back / evaluation period, in minutes, used by time-window based conditions."
+  period: SortEnumType @cost(weight: "10")
+  """
+  A legacy scalar threshold value retained for backward compatibility. Thresholds for new
+  rules are expressed inside the rule set (AlertRuleInput.ruleSet) via each item's "value" instead.
+  """
+  threshold: SortEnumType @cost(weight: "10")
+  "Optional HTTPS webhook URL that is invoked (HTTP POST) when the rule triggers."
+  webhookUrl: SortEnumType @cost(weight: "10")
+  """
+  When true, the rule is evaluated against every device in the account and
+  DeviceIds is empty. When false, only DeviceIds are evaluated.
+  """
+  allDevices: SortEnumType @cost(weight: "10")
+  """
+  When true, all users in the account are notified and UserIds is empty.
+  When false, only the users in UserIds are notified.
+  """
+  allUsers: SortEnumType @cost(weight: "10")
+  "The date and time the alert rule was created"
+  createdOn: SortEnumType @cost(weight: "10")
+  "The date and time the alert rule was last updated"
+  updatedOn: SortEnumType @cost(weight: "10")
+}
+
 "Alert rule summary (minimal info included with alerts)"
 input AlertRuleSummaryFilterInput {
   and: [AlertRuleSummaryFilterInput!]
@@ -3262,6 +3668,14 @@ input BatchDeleteDataTableRowsInput {
   rowIds: [String]
 }
 
+"Input for batch updating multiple modules in a template."
+input BatchUpdateTemplateModulesInput {
+  "The template ID."
+  templateId: String
+  "List of module updates to apply."
+  modules: [UpdateTemplateModuleInput]
+}
+
 """
 Represents Bluetooth Low Energy (BLE) beacon configuration for a device.
 Beacons enable proximity-based interactions, allowing mobile devices to detect nearby digital signage
@@ -3956,6 +4370,13 @@ input ListFilterInputTypeOfModuleFilterInput {
   any: Boolean @cost(weight: "10")
 }
 
+input ListFilterInputTypeOfModuleOptionFilterInput {
+  all: ModuleOptionFilterInput @cost(weight: "10")
+  none: ModuleOptionFilterInput @cost(weight: "10")
+  some: ModuleOptionFilterInput @cost(weight: "10")
+  any: Boolean @cost(weight: "10")
+}
+
 input ListFilterInputTypeOfScheduleDeviceFilterInput {
   all: ScheduleDeviceFilterInput @cost(weight: "10")
   none: ScheduleDeviceFilterInput @cost(weight: "10")
@@ -4148,30 +4569,96 @@ input MediaSortInput {
 }
 
 """
-Represents a module (zone/region) within a template layout.
-Modules define rectangular areas on screen where content from playlists is displayed.
+Represents a module (also called a zone or region) within a template layout.
+Modules/zones define rectangular areas on screen where content from playlists is displayed.
+The terms "module" and "zone" are used interchangeably throughout the API.
 """
 input ModuleFilterInput {
   and: [ModuleFilterInput!]
   or: [ModuleFilterInput!]
-  "Module id"
+  "Module/zone unique identifier"
   id: StringOperationFilterInput
-  "Module name"
+  "Module/zone name"
   name: StringOperationFilterInput
-  "Module type"
+  "Module/zone type (e.g., 'Playlist', 'Clock', 'Weather', 'Ticker', 'Web')"
   type: StringOperationFilterInput
-  "Left position"
+  "Left position in pixels from the top-left corner of the template"
   left: IntOperationFilterInput
-  "Top position"
+  "Top position in pixels from the top-left corner of the template"
   top: IntOperationFilterInput
-  "Width"
+  "Width of the module/zone in pixels"
   width: IntOperationFilterInput
-  "Height"
+  "Height of the module/zone in pixels"
   height: IntOperationFilterInput
-  "Playlist assigned to this module"
+  """
+  Playlist ID assigned to this module/zone.
+  Determines what content is displayed in this area of the screen.
+  """
   playlistId: StringOperationFilterInput
-  "Sequence or Z-Order"
+  """
+  Sequence or Z-order for overlapping modules/zones.
+  Higher values appear in front of lower values.
+  """
   sequence: IntOperationFilterInput
+  """
+  Module/zone configuration options (key-value pairs).
+  Used to store type-specific settings like timezone for Clock zones, location for Weather zones, etc.
+  """
+  options: ListFilterInputTypeOfModuleOptionFilterInput
+}
+
+"Input for a module within a template - used when adding modules."
+input ModuleInput {
+  "Module name."
+  name: String
+  "Module type (e.g., 'Playlist', 'Clock', 'Weather', 'Ticker', 'Web')."
+  type: String
+  "Left position in pixels."
+  left: Int
+  "Top position in pixels."
+  top: Int
+  "Width in pixels."
+  width: Int
+  "Height in pixels."
+  height: Int
+  "Playlist ID assigned to this module."
+  playlistId: String
+  "Z-order/sequence for overlapping modules."
+  sequence: Int
+}
+
+"""
+Represents a configuration option for a module/zone (key-value pair).
+Module/zone options store settings specific to each module/zone type.
+"""
+input ModuleOptionFilterInput {
+  and: [ModuleOptionFilterInput!]
+  or: [ModuleOptionFilterInput!]
+  "Module/zone option unique identifier"
+  id: StringOperationFilterInput
+  "Option name/key (e.g., 'timezone', 'location', 'refresh_interval')"
+  name: StringOperationFilterInput
+  "Option value (stored as string, parse as needed for the specific option)"
+  value: StringOperationFilterInput
+}
+
+"""
+Request model for creating or updating a module/zone option.
+Used to set configuration values for specific module/zone types.
+"""
+input ModuleOptionRequestInput {
+  "Option name/key (e.g., 'timezone', 'location', 'url')"
+  name: String
+  "Option value (string representation that will be parsed based on the option type)"
+  value: String
+}
+
+"Represents a module ID and its new sequence number for reordering."
+input ModuleSequenceInput {
+  "The module ID."
+  moduleId: String
+  "The new sequence/z-order value."
+  sequence: Int!
 }
 
 input NullableOfAdHawkAgeRangeOperationFilterInput {
@@ -4401,6 +4888,24 @@ input PlaylistTypeOperationFilterInput {
   nin: [PlaylistType!] @cost(weight: "10")
 }
 
+"Input for removing a module option by name."
+input RemoveModuleOptionInput {
+  "The template ID."
+  templateId: String
+  "The module ID."
+  moduleId: String
+  "The option name to remove."
+  optionName: String
+}
+
+"Input for removing a module from a template."
+input RemoveTemplateModuleInput {
+  "The template ID containing the module."
+  templateId: String
+  "The module ID to remove."
+  moduleId: String
+}
+
 "Input for reordering rows in a data table."
 input ReorderDataTableRowsInput {
   "The table ID containing the rows."
@@ -4417,6 +4922,14 @@ input ReorderPlaylistSourcesInput {
   sourceIds: [String]
 }
 
+"Input for reordering modules within a template."
+input ReorderTemplateModulesInput {
+  "The template ID."
+  templateId: String
+  "List of module IDs with their new sequence numbers."
+  moduleSequences: [ModuleSequenceInput]
+}
+
 "Input for rolling back a row to a previous version."
 input RollbackDataTableRowInput {
   "The table ID containing the row."
@@ -4647,6 +5160,16 @@ input ScheduleTypeOperationFilterInput {
   nin: [ScheduleType!] @cost(weight: "10")
 }
 
+"Input for setting all options for a module (replaces existing)."
+input SetModuleOptionsInput {
+  "The template ID."
+  templateId: String
+  "The module ID."
+  moduleId: String
+  "List of options to set (replaces all existing options)."
+  options: [ModuleOptionRequestInput]
+}
+
 """
 Represents a content item within a playlist. A source defines what content to display
 and for how long. Sources can reference media files, templates, embedded playlists, URLs, or other content types.
@@ -4764,9 +5287,13 @@ input TemplateFilterInput {
   width: IntOperationFilterInput
   "Height"
   height: IntOperationFilterInput
-  "Orientation (Landscape, Portrait, Landscape Reversed, Portrait Reversed)"
+  "Display orientation: Landscape, Portrait, Landscape Reversed, or Portrait Reversed"
   orientation: IntOperationFilterInput
-  "Modules or zones"
+  """
+  Collection of modules/zones that define content areas within this template.
+  Each module/zone represents a rectangular region where content from a playlist is displayed.
+  The terms "module" and "zone" are used interchangeably.
+  """
   modules: ListFilterInputTypeOfModuleFilterInput
 }
 
@@ -4801,7 +5328,7 @@ input TemplateSortInput {
   width: SortEnumType @cost(weight: "10")
   "Height"
   height: SortEnumType @cost(weight: "10")
-  "Orientation (Landscape, Portrait, Landscape Reversed, Portrait Reversed)"
+  "Display orientation: Landscape, Portrait, Landscape Reversed, or Portrait Reversed"
   orientation: SortEnumType @cost(weight: "10")
 }
 
@@ -4889,6 +5416,62 @@ input UpdatePlaylistSourceInput {
   source: SourceInput
 }
 
+"Input for updating a template's properties."
+input UpdateTemplateInput {
+  "The template ID to update."
+  templateId: String
+  "Template name."
+  name: String
+  "Group ID to assign the template to."
+  groupId: String
+  "Tags (newline-delimited values stored in Description field)."
+  tags: String
+  "Template script for custom logic."
+  script: String
+  "Background color (e.g., '#000000')."
+  backColor: String
+  "Template width in pixels."
+  width: Int
+  "Template height in pixels."
+  height: Int
+  "Display orientation (0=Landscape, 1=Portrait, 2=Landscape Reversed, 3=Portrait Reversed)."
+  orientation: Int
+}
+
+"Input for updating an existing module within a template."
+input UpdateTemplateModuleInput {
+  "The template ID containing the module."
+  templateId: String
+  "The module ID to update."
+  moduleId: String
+  "Module name."
+  name: String
+  "Module type."
+  type: String
+  "Left position in pixels."
+  left: Int
+  "Top position in pixels."
+  top: Int
+  "Width in pixels."
+  width: Int
+  "Height in pixels."
+  height: Int
+  "Playlist ID assigned to this module."
+  playlistId: String
+  "Z-order/sequence."
+  sequence: Int
+}
+
+"Input for upserting (create or update) a single module option."
+input UpsertModuleOptionInput {
+  "The template ID."
+  templateId: String
+  "The module ID."
+  moduleId: String
+  "The option to create or update (matched by name)."
+  option: ModuleOptionRequestInput
+}
+
 "User model"
 input UserFilterInput {
   and: [UserFilterInput!]