@reveldigital/mcp-graphql-proxy 2.2.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.
@@ -1283,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)"
@@ -1459,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."
@@ -1486,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."
@@ -1548,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
 }
@@ -3246,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!]