@pam-ai/pam-ordo-contracts 3.4.0

package/openapi/openapi.json

@@ -0,0 +1,4577 @@
+{
+  "openapi": "3.1.0",
+  "info": {
+    "title": "PAM Unified Inbox API",
+    "version": "3.4.0",
+    "description": "Versioned contract for canonical Ordo reads, commands, and recipient notifications.",
+    "license": {
+      "name": "Proprietary",
+      "identifier": "LicenseRef-Proprietary"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://{apiId}.execute-api.us-east-1.amazonaws.com",
+      "variables": {
+        "apiId": {
+          "default": "example"
+        }
+      }
+    }
+  ],
+  "security": [
+    {
+      "dashboardIdentity": []
+    }
+  ],
+  "tags": [
+    {
+      "name": "Inbox reads",
+      "description": "Canonical paginated Inbox and Conversation detail reads."
+    },
+    {
+      "name": "Inbox commands",
+      "description": "Versioned idempotent synchronous commands."
+    }
+  ],
+  "paths": {
+    "/v1/inbox/conversations": {
+      "get": {
+        "summary": "List canonical Inbox Conversations",
+        "operationId": "listInboxConversations",
+        "tags": [
+          "Inbox reads"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          },
+          {
+            "name": "scope",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "$ref": "#/components/schemas/InboxScope"
+            }
+          },
+          {
+            "name": "teamId",
+            "in": "query",
+            "schema": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          {
+            "name": "tab",
+            "in": "query",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "OPEN",
+                "SNOOZED",
+                "OVERDUE",
+                "NEEDS_ATTENTION",
+                "RESOLVED"
+              ]
+            }
+          },
+          {
+            "name": "labels",
+            "in": "query",
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "maxItems": 20
+            },
+            "style": "form",
+            "explode": true
+          },
+          {
+            "name": "from",
+            "in": "query",
+            "schema": {
+              "type": "string",
+              "format": "date-time"
+            }
+          },
+          {
+            "name": "to",
+            "in": "query",
+            "schema": {
+              "type": "string",
+              "format": "date-time"
+            }
+          },
+          {
+            "name": "query",
+            "in": "query",
+            "schema": {
+              "type": "string",
+              "maxLength": 256
+            }
+          },
+          {
+            "name": "sort",
+            "in": "query",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "OPERATIONAL_URGENCY",
+                "LATEST_ACTIVITY"
+              ],
+              "default": "OPERATIONAL_URGENCY"
+            }
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "description": "Opaque keyset cursor. Clients must not decode it.",
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2048
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100,
+              "default": 25
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Canonical Inbox page. Optional hydration failures never remove a row.",
+            "headers": {
+              "x-correlation-id": {
+                "$ref": "#/components/headers/CorrelationId"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InboxListResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/conversations/{conversationId}": {
+      "get": {
+        "summary": "Get an authorized Conversation detail",
+        "operationId": "getInboxConversation",
+        "tags": [
+          "Inbox reads"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/ConversationId"
+          },
+          {
+            "name": "cycleId",
+            "in": "query",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Authorized Conversation detail.",
+            "headers": {
+              "x-correlation-id": {
+                "$ref": "#/components/headers/CorrelationId"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ConversationDetailResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/conversations/{conversationId}/customer-notes": {
+      "get": {
+        "summary": "List active Customer notes through an authorized Conversation",
+        "operationId": "listInboxCustomerNotes",
+        "tags": [
+          "Inbox reads"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/ConversationId"
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "description": "Opaque newest-first keyset cursor. Clients must not decode it.",
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2048
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100,
+              "default": 25
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Newest-first page of non-deleted notes for the Conversation Customer.",
+            "headers": {
+              "x-correlation-id": {
+                "$ref": "#/components/headers/CorrelationId"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CustomerNoteListResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/contacts": {
+      "get": {
+        "summary": "Search the rooftop's Customers to start an outbound Conversation",
+        "description": "The outbound half of the Inbox. The Inbox itself is incoming-only, so a Conversation an advisor needs to START cannot be found in it: the Customer may have no thread at all, only an open repair order, or a thread another advisor owns. This searches the whole rooftop's Customers rather than the reader's own Conversations, and reports how each one already relates to them so the picker can say what opening it will do. Requires VIEW_CUSTOMER_DIRECTORY, which is a stronger grant than VIEW_OWN_INBOX: it exposes Customers the reader has never messaged. Contact detail is hydrated from the system that masters it, so a hydration gap degrades a field and never removes a Customer.",
+        "operationId": "searchInboxContacts",
+        "tags": [
+          "Inbox reads"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          },
+          {
+            "name": "query",
+            "in": "query",
+            "required": true,
+            "description": "A name fragment, or a telephone number in any format.",
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            }
+          },
+          {
+            "name": "relationship",
+            "in": "query",
+            "description": "Which side of the directory to read. MINE returns only Customers whose Conversation the reader owns; EVERYONE returns the rest. One set is always in the way of the other, so this is a switch rather than a filter.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "MINE",
+                "EVERYONE"
+              ],
+              "default": "MINE"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 50,
+              "default": 25
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Matching Customers. A hydration gap degrades a field, never a row.",
+            "headers": {
+              "x-correlation-id": {
+                "$ref": "#/components/headers/CorrelationId"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ContactSearchResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/notifications": {
+      "get": {
+        "summary": "List the authenticated User's visible active notifications",
+        "operationId": "listInboxNotifications",
+        "tags": [
+          "Inbox reads"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "description": "Opaque newest-first snapshot cursor. Clients must not decode it.",
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2048
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100,
+              "default": 25
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Newest-first page of visible, undismissed recipient notifications.",
+            "headers": {
+              "x-correlation-id": {
+                "$ref": "#/components/headers/CorrelationId"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotificationListResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/assign": {
+      "post": {
+        "summary": "Assign the active WorkCycle",
+        "operationId": "assignConversation",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/AssignCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/CommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/snooze": {
+      "post": {
+        "summary": "Snooze the active WorkCycle",
+        "operationId": "snoozeConversation",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/SnoozeCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/CommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/unsnooze": {
+      "post": {
+        "summary": "Unsnooze the active WorkCycle",
+        "operationId": "unsnoozeConversation",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/BaseCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/CommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/set-reminder": {
+      "post": {
+        "summary": "Set the owner Reminder",
+        "operationId": "setConversationReminder",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/SetReminderCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/CommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/clear-reminder": {
+      "post": {
+        "summary": "Clear the owner Reminder",
+        "operationId": "clearConversationReminder",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/BaseCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/CommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/close": {
+      "post": {
+        "summary": "Close the active WorkCycle",
+        "operationId": "closeConversation",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/CloseCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/CommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/acknowledge-attention": {
+      "post": {
+        "summary": "Record an authorized viewer acknowledgement of active Needs Attention",
+        "operationId": "acknowledgeInboxAttention",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/AcknowledgeAttentionCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/CommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/resolve-attention": {
+      "post": {
+        "summary": "Resolve active Needs Attention without closing the WorkCycle",
+        "operationId": "resolveInboxAttention",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/ResolveAttentionCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/CommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/add-internal-comment": {
+      "post": {
+        "summary": "Add an internal comment and fan out Mentions on the active WorkCycle",
+        "operationId": "addInboxInternalComment",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/AddInternalCommentCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/InternalCommentApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/advance-read-cursor": {
+      "post": {
+        "summary": "Monotonically advance the authenticated viewer's Conversation read cursor",
+        "operationId": "advanceInboxReadCursor",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/AdvanceReadCursorCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/ReadCursorAdvanced"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/add-customer-note": {
+      "post": {
+        "summary": "Add a durable note to the authorized Conversation Customer",
+        "description": "Requires the ADD_CUSTOMER_NOTE capability. Adding a note has no ownership dimension -- a note belongs to the Customer rather than to a WorkCycle or an owner -- so there is no OWNED/ANY pair for it.",
+        "operationId": "addInboxCustomerNote",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/AddCustomerNoteCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/CustomerNoteCommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/delete-customer-note": {
+      "post": {
+        "summary": "Soft-delete a durable Customer note",
+        "description": "Requires the DELETE_ANY_CUSTOMER_NOTE capability. Kept separate from ADD_CUSTOMER_NOTE and deliberately ANY-scoped. A delete removes a durable Customer fact from every future WorkCycle and from the context Pam reads before replying. That is a stronger act than adding one and is not implied by it. A narrower DELETE_OWN_CUSTOMER_NOTE can be added later without changing this operation because CustomerNote carries authorUserId.",
+        "operationId": "deleteInboxCustomerNote",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/DeleteCustomerNoteCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/CustomerNoteCommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "501": {
+            "$ref": "#/components/responses/NotImplemented"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/mark-notification-read": {
+      "post": {
+        "summary": "Mark one recipient-owned notification read",
+        "operationId": "markInboxNotificationRead",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/NotificationCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NotificationCommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    },
+    "/v1/inbox/commands/dismiss-notification": {
+      "post": {
+        "summary": "Dismiss one recipient-owned notification and mark it read",
+        "operationId": "dismissInboxNotification",
+        "tags": [
+          "Inbox commands"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClientOrgId"
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/NotificationCommand"
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/NotificationCommandApplied"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          },
+          "503": {
+            "$ref": "#/components/responses/ServiceUnavailable"
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "securitySchemes": {
+      "dashboardIdentity": {
+        "type": "http",
+        "scheme": "bearer",
+        "bearerFormat": "JWT",
+        "description": "Existing dashboard identity; DASH-233 owns enforcement."
+      }
+    },
+    "headers": {
+      "CorrelationId": {
+        "description": "Stable request correlation identifier.",
+        "schema": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "parameters": {
+      "ClientOrgId": {
+        "name": "x-client-org-id",
+        "in": "header",
+        "required": true,
+        "description": "Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution.",
+        "schema": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "ConversationId": {
+        "name": "conversationId",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "format": "uuid"
+        }
+      }
+    },
+    "schemas": {
+      "InboxScope": {
+        "type": "string",
+        "enum": [
+          "MY_INBOX",
+          "TEAM_INBOX",
+          "MENTIONS",
+          "CUSTOMERS",
+          "RO"
+        ]
+      },
+      "WorkCycleStatus": {
+        "type": "string",
+        "enum": [
+          "OPEN",
+          "SNOOZED",
+          "RESOLVED"
+        ]
+      },
+      "AvailabilityState": {
+        "type": "string",
+        "enum": [
+          "available",
+          "missing",
+          "stale",
+          "timeout",
+          "unauthorized",
+          "unsupported"
+        ]
+      },
+      "Availability": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "state"
+        ],
+        "properties": {
+          "state": {
+            "$ref": "#/components/schemas/AvailabilityState"
+          },
+          "source": {
+            "type": "string"
+          },
+          "observedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "reason": {
+            "type": "string",
+            "maxLength": 512
+          }
+        }
+      },
+      "HydratedText": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "availability"
+        ],
+        "properties": {
+          "value": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "availability": {
+            "$ref": "#/components/schemas/Availability"
+          }
+        }
+      },
+      "HydratedStringList": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "value",
+          "availability"
+        ],
+        "properties": {
+          "value": {
+            "oneOf": [
+              {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "uniqueItems": true
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "availability": {
+            "$ref": "#/components/schemas/Availability"
+          }
+        }
+      },
+      "Owner": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "userId",
+          "displayName"
+        ],
+        "properties": {
+          "userId": {
+            "type": "string"
+          },
+          "teamId": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "displayName": {
+            "$ref": "#/components/schemas/HydratedText"
+          }
+        }
+      },
+      "Reminder": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "dueAt",
+          "status",
+          "version"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "dueAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "note": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 2000
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "PENDING",
+              "FIRED",
+              "CLEARED",
+              "CANCELLED"
+            ]
+          },
+          "version": {
+            "type": "integer",
+            "minimum": 1
+          }
+        }
+      },
+      "AttentionSummary": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "category",
+          "status",
+          "openedAt",
+          "version"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "category": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "ACTIVE",
+              "RESOLVED"
+            ]
+          },
+          "openedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "version": {
+            "type": "integer",
+            "minimum": 1
+          }
+        }
+      },
+      "OverdueSummary": {
+        "description": "Derived read-time Overdue presentation. It is never a mutable lifecycle flag.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "isOverdue",
+          "overdueAt",
+          "presentationSuppressedByReminder"
+        ],
+        "properties": {
+          "isOverdue": {
+            "type": "boolean"
+          },
+          "overdueAt": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "date-time",
+            "description": "Derived threshold timestamp, or null when no waiting anchor or policy applies."
+          },
+          "presentationSuppressedByReminder": {
+            "type": "boolean",
+            "description": "True when a pending owner Reminder suppresses the Overdue badge without erasing waiting history."
+          }
+        }
+      },
+      "OrdoCapability": {
+        "description": "A single Ordo product capability. Capabilities are the only authorization vocabulary for Ordo surfaces. They are not a second half of the dashboard's resource/action permission model and do not divide the work with it. Resource permissions govern legacy dashboard surfaces and nothing else; capabilities govern Ordo surfaces and nothing else; neither is a fallback or an outer gate for the other. A same-named resource is a coincidence of vocabulary rather than a related grant, so REPAIR_ORDERS:READ says nothing about VIEW_OPEN_REPAIR_ORDERS and a User may hold either without the other. Resolved per rooftop by pam-permissions-service from the User's role, and enforced by pam-ordo-service. The distribution across personas is the approved capability contract in section 3.3 of the Ordo Product and Engineering Specification.",
+        "type": "string",
+        "enum": [
+          "VIEW_OWN_INBOX",
+          "VIEW_TEAM_INBOX",
+          "VIEW_CUSTOMER_DIRECTORY",
+          "SWITCH_ROOFTOP",
+          "VIEW_ANY_ROOFTOP_CONVERSATION",
+          "VIEW_OPEN_REPAIR_ORDERS",
+          "VIEW_ALL_OPEN_REPAIR_ORDERS",
+          "ASSIGN_OWNED_WORK",
+          "ASSIGN_ANY_WORK",
+          "CLOSE_OWNED_WORK",
+          "CLOSE_ANY_WORK",
+          "RESOLVE_NEEDS_ATTENTION",
+          "MENTION_USERS",
+          "ADD_CUSTOMER_NOTE",
+          "DELETE_ANY_CUSTOMER_NOTE"
+        ]
+      },
+      "InboxPolicyUserTargetV1": {
+        "description": "A configured target for one stable rooftop User identity.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "type",
+          "userId"
+        ],
+        "properties": {
+          "type": {
+            "type": "string",
+            "const": "USER"
+          },
+          "userId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          }
+        }
+      },
+      "InboxPolicyTeamTargetV1": {
+        "description": "A configured Team target identified by the dashboard user-group ID. The authority resolves this target to concrete eligible Users at use time.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "type",
+          "dashboardGroupId"
+        ],
+        "properties": {
+          "type": {
+            "type": "string",
+            "const": "TEAM"
+          },
+          "dashboardGroupId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          }
+        }
+      },
+      "InboxPolicyUnassignedTargetV1": {
+        "description": "Retain work without an owner while keeping it manager-visible.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "type"
+        ],
+        "properties": {
+          "type": {
+            "type": "string",
+            "const": "UNASSIGNED"
+          }
+        }
+      },
+      "InboxPolicyRecipientTargetV1": {
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/InboxPolicyUserTargetV1"
+          },
+          {
+            "$ref": "#/components/schemas/InboxPolicyTeamTargetV1"
+          }
+        ],
+        "discriminator": {
+          "propertyName": "type",
+          "mapping": {
+            "USER": "#/components/schemas/InboxPolicyUserTargetV1",
+            "TEAM": "#/components/schemas/InboxPolicyTeamTargetV1"
+          }
+        }
+      },
+      "InboxPolicyRoutingTargetV1": {
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/InboxPolicyUserTargetV1"
+          },
+          {
+            "$ref": "#/components/schemas/InboxPolicyTeamTargetV1"
+          },
+          {
+            "$ref": "#/components/schemas/InboxPolicyUnassignedTargetV1"
+          }
+        ],
+        "discriminator": {
+          "propertyName": "type",
+          "mapping": {
+            "USER": "#/components/schemas/InboxPolicyUserTargetV1",
+            "TEAM": "#/components/schemas/InboxPolicyTeamTargetV1",
+            "UNASSIGNED": "#/components/schemas/InboxPolicyUnassignedTargetV1"
+          }
+        }
+      },
+      "InboxPolicyNeedsAttentionV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "enabled",
+          "recipients"
+        ],
+        "properties": {
+          "enabled": {
+            "type": "boolean"
+          },
+          "recipients": {
+            "type": "array",
+            "maxItems": 50,
+            "uniqueItems": true,
+            "items": {
+              "$ref": "#/components/schemas/InboxPolicyRecipientTargetV1"
+            }
+          }
+        }
+      },
+      "InboxPolicyCategoryV1": {
+        "description": "Behavior for one producer classification. Legacy escalation tiers are not accepted.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "category",
+          "enabled",
+          "createsWorkCycle",
+          "routing",
+          "needsAttention"
+        ],
+        "properties": {
+          "category": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "createsWorkCycle": {
+            "type": "boolean"
+          },
+          "routing": {
+            "$ref": "#/components/schemas/InboxPolicyRoutingTargetV1"
+          },
+          "needsAttention": {
+            "$ref": "#/components/schemas/InboxPolicyNeedsAttentionV1"
+          }
+        }
+      },
+      "InboxPolicyOverdueDisabledV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "enabled"
+        ],
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "const": false
+          }
+        }
+      },
+      "InboxPolicyOverdueEnabledV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "enabled",
+          "thresholdMinutes"
+        ],
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "const": true
+          },
+          "thresholdMinutes": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 10080
+          }
+        }
+      },
+      "InboxPolicyOverdueV1": {
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/InboxPolicyOverdueDisabledV1"
+          },
+          {
+            "$ref": "#/components/schemas/InboxPolicyOverdueEnabledV1"
+          }
+        ]
+      },
+      "InboxPolicyNotificationKindV1": {
+        "type": "string",
+        "enum": [
+          "needs_attention",
+          "overdue",
+          "ro_opened",
+          "ro_closed"
+        ]
+      },
+      "InboxPolicyNotificationRuleV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "kind",
+          "enabled",
+          "recipients"
+        ],
+        "properties": {
+          "kind": {
+            "$ref": "#/components/schemas/InboxPolicyNotificationKindV1"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "recipients": {
+            "type": "array",
+            "maxItems": 50,
+            "uniqueItems": true,
+            "items": {
+              "$ref": "#/components/schemas/InboxPolicyRecipientTargetV1"
+            }
+          }
+        }
+      },
+      "InboxPolicyV1": {
+        "description": "Strict rooftop policy stored at ClientInfo.pamConfig.ordoInbox. policyVersion is derived by consumers from canonical normalized policy content and is not stored inside the policy. Legacy timed escalation configuration is outside this schema and must never be translated implicitly.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "schemaVersion",
+          "categories",
+          "overdue",
+          "notifications"
+        ],
+        "properties": {
+          "schemaVersion": {
+            "type": "integer",
+            "const": 1
+          },
+          "categories": {
+            "type": "array",
+            "maxItems": 100,
+            "uniqueItems": true,
+            "items": {
+              "$ref": "#/components/schemas/InboxPolicyCategoryV1"
+            }
+          },
+          "overdue": {
+            "$ref": "#/components/schemas/InboxPolicyOverdueV1"
+          },
+          "notifications": {
+            "type": "array",
+            "maxItems": 20,
+            "uniqueItems": true,
+            "items": {
+              "$ref": "#/components/schemas/InboxPolicyNotificationRuleV1"
+            }
+          }
+        }
+      },
+      "InboxAuthorityPersonaV1": {
+        "type": "string",
+        "enum": [
+          "SERVICE_ADVISOR",
+          "SERVICE_MANAGER",
+          "BDC_REPRESENTATIVE",
+          "BDC_MANAGER"
+        ]
+      },
+      "InboxTargetResolutionUserV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "userId",
+          "persona",
+          "capabilities"
+        ],
+        "properties": {
+          "userId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "persona": {
+            "$ref": "#/components/schemas/InboxAuthorityPersonaV1"
+          },
+          "capabilities": {
+            "type": "array",
+            "maxItems": 32,
+            "uniqueItems": true,
+            "items": {
+              "$ref": "#/components/schemas/OrdoCapability"
+            }
+          }
+        }
+      },
+      "InboxTargetResolutionStatusV1": {
+        "description": "resolved has at least one eligible User; none has no eligible User; unavailable means the authority could not answer; ambiguous means the Team identity maps to more than one authoritative group.",
+        "type": "string",
+        "enum": [
+          "resolved",
+          "none",
+          "unavailable",
+          "ambiguous"
+        ]
+      },
+      "InboxTargetResolutionResultV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "target",
+          "status",
+          "userIds"
+        ],
+        "properties": {
+          "target": {
+            "$ref": "#/components/schemas/InboxPolicyRecipientTargetV1"
+          },
+          "status": {
+            "$ref": "#/components/schemas/InboxTargetResolutionStatusV1"
+          },
+          "userIds": {
+            "type": "array",
+            "maxItems": 250,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 512
+            }
+          }
+        }
+      },
+      "InboxTargetResolutionRequestV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "schemaVersion",
+          "clientOrgId",
+          "targets"
+        ],
+        "properties": {
+          "schemaVersion": {
+            "type": "integer",
+            "const": 1
+          },
+          "clientOrgId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "targets": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 100,
+            "uniqueItems": true,
+            "items": {
+              "$ref": "#/components/schemas/InboxPolicyRecipientTargetV1"
+            }
+          }
+        }
+      },
+      "InboxTargetResolutionResponseV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "schemaVersion",
+          "clientOrgId",
+          "results",
+          "users"
+        ],
+        "properties": {
+          "schemaVersion": {
+            "type": "integer",
+            "const": 1
+          },
+          "clientOrgId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "results": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 100,
+            "items": {
+              "$ref": "#/components/schemas/InboxTargetResolutionResultV1"
+            }
+          },
+          "users": {
+            "description": "Concrete eligible Users, deduplicated across every requested target.",
+            "type": "array",
+            "maxItems": 250,
+            "uniqueItems": true,
+            "items": {
+              "$ref": "#/components/schemas/InboxTargetResolutionUserV1"
+            }
+          }
+        }
+      },
+      "ViewerState": {
+        "description": "Read-time state specific to the authenticated viewer.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "unreadCount",
+          "isMentionWatcher",
+          "unreadMentionCount"
+        ],
+        "properties": {
+          "unreadCount": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "isMentionWatcher": {
+            "type": "boolean",
+            "description": "Whether the viewer has active Mentions-view membership for the current WorkCycle."
+          },
+          "unreadMentionCount": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "readThroughInteractionId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uuid",
+            "description": "Latest Interaction the authenticated viewer has read in this Conversation."
+          },
+          "readThroughSequenceNumber": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "minimum": 1,
+            "description": "Authoritative Conversation sequence corresponding to readThroughInteractionId."
+          }
+        }
+      },
+      "AiContext": {
+        "description": "Current conversation-wide AI projection; source availability is explicit per field.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "summary",
+          "categories",
+          "sentiment",
+          "recommendedNextStep"
+        ],
+        "properties": {
+          "summary": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "categories": {
+            "$ref": "#/components/schemas/HydratedStringList"
+          },
+          "sentiment": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "recommendedNextStep": {
+            "$ref": "#/components/schemas/HydratedText"
+          }
+        }
+      },
+      "InteractionSummary": {
+        "description": "Read-time counts and channel indicators for the visible Conversation context.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "totalCount",
+          "inboundCount",
+          "outboundCount",
+          "internalCount",
+          "channels"
+        ],
+        "properties": {
+          "totalCount": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "inboundCount": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "outboundCount": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "internalCount": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "channels": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "uniqueItems": true
+          }
+        }
+      },
+      "AvailableAction": {
+        "type": "string",
+        "enum": [
+          "ASSIGN",
+          "SNOOZE",
+          "UNSNOOZE",
+          "SET_REMINDER",
+          "CLEAR_REMINDER",
+          "CLOSE",
+          "RESOLVE_ATTENTION",
+          "ADD_INTERNAL_COMMENT"
+        ]
+      },
+      "InboxRow": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "conversationId",
+          "clientOrgId",
+          "customerId",
+          "workCycle",
+          "owner",
+          "reminder",
+          "attention",
+          "overdue",
+          "latestActivityAt",
+          "customerDisplayName",
+          "activeRepairOrders",
+          "aiContext",
+          "viewerState",
+          "interactionSummary",
+          "availableActions",
+          "availability"
+        ],
+        "properties": {
+          "conversationId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "clientOrgId": {
+            "type": "string"
+          },
+          "customerId": {
+            "type": "string"
+          },
+          "workCycle": {
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/WorkCycleSummary"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "owner": {
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/Owner"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "reminder": {
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/Reminder"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "attention": {
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/AttentionSummary"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "overdue": {
+            "$ref": "#/components/schemas/OverdueSummary"
+          },
+          "latestActivityAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "customerDisplayName": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "customerPhone": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/HydratedText"
+              }
+            ],
+            "description": "The Customer's contact telephone number, for placing an outbound call. Optional because no producer can supply it yet: Ordo stores a Customer reference and no payload, so this arrives with external Customer hydration. Absent and `{ value: null }` mean different things - absent is a producer that does not publish the field, null with an availability is a source that could not supply it."
+          },
+          "activeRepairOrders": {
+            "type": "array",
+            "description": "Current active RO context only; historical ROs remain customer context.",
+            "items": {
+              "$ref": "#/components/schemas/RepairOrderRef"
+            }
+          },
+          "aiContext": {
+            "$ref": "#/components/schemas/AiContext"
+          },
+          "viewerState": {
+            "$ref": "#/components/schemas/ViewerState"
+          },
+          "interactionSummary": {
+            "$ref": "#/components/schemas/InteractionSummary"
+          },
+          "availableActions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AvailableAction"
+            },
+            "uniqueItems": true
+          },
+          "availability": {
+            "type": "object",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/Availability"
+            }
+          }
+        }
+      },
+      "WorkCycleSummary": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "cycleNumber",
+          "status",
+          "openedAt",
+          "version"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "cycleNumber": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "status": {
+            "$ref": "#/components/schemas/WorkCycleStatus"
+          },
+          "openedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "oldestUnrespondedAt": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "date-time"
+          },
+          "snoozedAt": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "date-time"
+          },
+          "resolvedAt": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "date-time"
+          },
+          "version": {
+            "type": "integer",
+            "minimum": 1
+          }
+        }
+      },
+      "InboxCounts": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "total",
+          "open",
+          "snoozed",
+          "overdue",
+          "needsAttention",
+          "resolved"
+        ],
+        "properties": {
+          "total": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "open": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "snoozed": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "overdue": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "needsAttention": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "resolved": {
+            "type": "integer",
+            "minimum": 0
+          }
+        }
+      },
+      "ContactRelationship": {
+        "description": "How a Customer already relates to the reader, which decides what opening them does. OWN is the reader's own thread. COLLEAGUE is a thread somebody else at the rooftop has been handling — opening it shows their history, which is the point when you are about to ring a Customer another advisor has been working. NONE is a Customer nobody has messaged at all; the thread opens empty. COLLEAGUE and NONE are deliberately distinct: conflating them would let a picker promise an empty thread and then drop the reader into somebody else's conversation mid-sentence.",
+        "type": "string",
+        "enum": [
+          "OWN",
+          "COLLEAGUE",
+          "NONE"
+        ]
+      },
+      "ContactRow": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "customerId",
+          "customerSourceSystem",
+          "customerName",
+          "customerPhone",
+          "conversationId",
+          "relationship",
+          "availability"
+        ],
+        "properties": {
+          "customerId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "customerSourceSystem": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The system that issued customerId. Part of the Customer key, carried because an external id alone is not a Customer - two source systems may both issue the same one and mean different people."
+          },
+          "customerName": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "customerPhone": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "vehicleLabel": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "openRepairOrder": {
+            "description": "The Customer's open repair order, when they have one. Open only: a finished one says nothing that changes the call the advisor is about to make, because the car has gone home.",
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/RepairOrderRef"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "conversationId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The Customer's most recent Conversation, or null when they have none. Null is a fact about the Customer rather than a hydration gap."
+          },
+          "relationship": {
+            "$ref": "#/components/schemas/ContactRelationship"
+          },
+          "availability": {
+            "$ref": "#/components/schemas/Availability"
+          }
+        }
+      },
+      "ContactSearchResponse": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "properties": {
+          "data": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "contacts"
+            ],
+            "properties": {
+              "contacts": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/ContactRow"
+                }
+              }
+            }
+          }
+        }
+      },
+      "InboxListResponse": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "data",
+          "meta"
+        ],
+        "properties": {
+          "data": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "rows",
+              "counts"
+            ],
+            "properties": {
+              "rows": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/InboxRow"
+                }
+              },
+              "counts": {
+                "$ref": "#/components/schemas/InboxCounts"
+              }
+            }
+          },
+          "meta": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "nextCursor"
+            ],
+            "properties": {
+              "nextCursor": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "description": "Opaque keyset cursor."
+              }
+            }
+          }
+        }
+      },
+      "InteractionRef": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "sequenceNumber",
+          "kind",
+          "direction",
+          "occurredAt",
+          "availability"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "senderUserId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Authenticated User who authored an internal comment; null for non-User senders."
+          },
+          "replyToInteractionId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uuid",
+            "description": "Root internal comment referenced by this comment. Replies are flattened to one level."
+          },
+          "mentions": {
+            "type": "array",
+            "maxItems": 50,
+            "description": "Immutable recipient-specific Mention events created by this internal comment.",
+            "items": {
+              "$ref": "#/components/schemas/MentionRef"
+            }
+          },
+          "workCycleId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uuid",
+            "description": "WorkCycle that was active when this Interaction was ingested, mirroring conversation_interaction_refs.work_cycle_id. Null is authoritative and means the Interaction belongs to no cycle, which is expected for RO transitions and other non-work events. Optional only to keep this addition a minor version; every producer emits it unconditionally and pam-ordo-service asserts that in its contract tests, so consumers should treat an absent field as a producer defect rather than a supported state. Consumers must never infer cycle membership from interaction timestamps."
+          },
+          "sequenceNumber": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "kind": {
+            "type": "string"
+          },
+          "channel": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "direction": {
+            "type": "string",
+            "enum": [
+              "INBOUND",
+              "OUTBOUND",
+              "INTERNAL"
+            ]
+          },
+          "occurredAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "body": {
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/HydratedText"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "availability": {
+            "$ref": "#/components/schemas/Availability"
+          }
+        }
+      },
+      "MentionRef": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "userId",
+          "createdAt"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "userId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "VehicleRef": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "sourceSystem",
+          "externalId",
+          "year",
+          "make",
+          "model",
+          "vin",
+          "availability"
+        ],
+        "properties": {
+          "sourceSystem": {
+            "type": "string"
+          },
+          "externalId": {
+            "type": "string"
+          },
+          "year": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "make": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "model": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "vin": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "availability": {
+            "$ref": "#/components/schemas/Availability"
+          }
+        }
+      },
+      "RepairOrderRef": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "sourceSystem",
+          "externalId",
+          "relationship",
+          "displayNumber",
+          "status",
+          "vehicle",
+          "availability"
+        ],
+        "properties": {
+          "sourceSystem": {
+            "type": "string"
+          },
+          "externalId": {
+            "type": "string"
+          },
+          "relationship": {
+            "type": "string"
+          },
+          "displayNumber": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "status": {
+            "$ref": "#/components/schemas/HydratedText"
+          },
+          "vehicle": {
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/VehicleRef"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "availability": {
+            "$ref": "#/components/schemas/Availability"
+          }
+        }
+      },
+      "ConversationDetailResponse": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "properties": {
+          "data": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "conversationId",
+              "clientOrgId",
+              "customerId",
+              "version",
+              "currentCycle",
+              "owner",
+              "reminder",
+              "attention",
+              "overdue",
+              "customerDisplayName",
+              "aiContext",
+              "viewerState",
+              "interactionSummary",
+              "cycles",
+              "interactions",
+              "repairOrders",
+              "availableActions",
+              "availability"
+            ],
+            "properties": {
+              "conversationId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "clientOrgId": {
+                "type": "string"
+              },
+              "customerId": {
+                "type": "string"
+              },
+              "version": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "currentCycle": {
+                "oneOf": [
+                  {
+                    "$ref": "#/components/schemas/WorkCycleSummary"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "owner": {
+                "oneOf": [
+                  {
+                    "$ref": "#/components/schemas/Owner"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "reminder": {
+                "oneOf": [
+                  {
+                    "$ref": "#/components/schemas/Reminder"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "attention": {
+                "oneOf": [
+                  {
+                    "$ref": "#/components/schemas/AttentionSummary"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "overdue": {
+                "$ref": "#/components/schemas/OverdueSummary"
+              },
+              "customerDisplayName": {
+                "$ref": "#/components/schemas/HydratedText"
+              },
+              "customerPhone": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/HydratedText"
+                  }
+                ],
+                "description": "The Customer's contact telephone number, for placing an outbound call. Optional because no producer can supply it yet: Ordo stores a Customer reference and no payload, so this arrives with external Customer hydration. Absent and `{ value: null }` mean different things - absent is a producer that does not publish the field, null with an availability is a source that could not supply it."
+              },
+              "aiContext": {
+                "$ref": "#/components/schemas/AiContext"
+              },
+              "viewerState": {
+                "$ref": "#/components/schemas/ViewerState"
+              },
+              "interactionSummary": {
+                "$ref": "#/components/schemas/InteractionSummary"
+              },
+              "cycles": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/WorkCycleSummary"
+                }
+              },
+              "interactions": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/InteractionRef"
+                }
+              },
+              "repairOrders": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/RepairOrderRef"
+                }
+              },
+              "availableActions": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/AvailableAction"
+                },
+                "uniqueItems": true
+              },
+              "availability": {
+                "type": "object",
+                "additionalProperties": {
+                  "$ref": "#/components/schemas/Availability"
+                }
+              }
+            }
+          }
+        }
+      },
+      "CustomerNote": {
+        "description": "Ordo-owned durable note attached to the Conversation Customer, not to a WorkCycle.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "body",
+          "authorUserId",
+          "createdAt",
+          "updatedAt",
+          "version"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "body": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 10000
+          },
+          "authorUserId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updatedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "version": {
+            "type": "integer",
+            "minimum": 1
+          }
+        }
+      },
+      "CustomerNoteListResponse": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "data",
+          "meta"
+        ],
+        "properties": {
+          "data": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "notes"
+            ],
+            "properties": {
+              "notes": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/CustomerNote"
+                }
+              }
+            }
+          },
+          "meta": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "nextCursor"
+            ],
+            "properties": {
+              "nextCursor": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "description": "Opaque keyset cursor."
+              }
+            }
+          }
+        }
+      },
+      "NotificationKind": {
+        "type": "string",
+        "enum": [
+          "reminder_due",
+          "mention",
+          "internal_comment_reply",
+          "needs_attention",
+          "overdue",
+          "ro_opened",
+          "ro_closed"
+        ]
+      },
+      "InboxNotification": {
+        "description": "Recipient-specific Ordo alert state. Opening or dismissing it never resolves domain work.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "kind",
+          "conversationId",
+          "workCycleId",
+          "reminderId",
+          "mentionId",
+          "attentionCycleId",
+          "interactionId",
+          "title",
+          "body",
+          "payloadVersion",
+          "createdAt",
+          "readAt"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "kind": {
+            "$ref": "#/components/schemas/NotificationKind"
+          },
+          "conversationId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "workCycleId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uuid"
+          },
+          "reminderId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uuid"
+          },
+          "mentionId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uuid"
+          },
+          "attentionCycleId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uuid"
+          },
+          "interactionId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uuid"
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "body": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 2000
+          },
+          "payloadVersion": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "readAt": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "date-time"
+          }
+        }
+      },
+      "NotificationListResponse": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "data",
+          "meta"
+        ],
+        "properties": {
+          "data": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "notifications",
+              "unreadCount"
+            ],
+            "properties": {
+              "notifications": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/InboxNotification"
+                }
+              },
+              "unreadCount": {
+                "type": "integer",
+                "minimum": 0
+              }
+            }
+          },
+          "meta": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "nextCursor"
+            ],
+            "properties": {
+              "nextCursor": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "description": "Opaque keyset cursor."
+              }
+            }
+          }
+        }
+      },
+      "ProducerSourceV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "system",
+          "eventId",
+          "eventVersion"
+        ],
+        "properties": {
+          "system": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "eventId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "eventVersion": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          }
+        }
+      },
+      "ProducerConversationTargetV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "conversationId"
+        ],
+        "properties": {
+          "conversationId": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      },
+      "ProducerCustomerIdentityV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "customerSourceSystem",
+          "customerExternalId"
+        ],
+        "properties": {
+          "customerSourceSystem": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "customerExternalId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          }
+        }
+      },
+      "ProducerCustomerTargetV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "customerIdentity"
+        ],
+        "properties": {
+          "customerIdentity": {
+            "$ref": "#/components/schemas/ProducerCustomerIdentityV1"
+          }
+        }
+      },
+      "ProducerSourceActivityTargetV1": {
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/ProducerConversationTargetV1"
+          },
+          {
+            "$ref": "#/components/schemas/ProducerCustomerTargetV1"
+          }
+        ]
+      },
+      "ProducerInteractionV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "kind",
+          "direction",
+          "senderType"
+        ],
+        "properties": {
+          "kind": {
+            "type": "string",
+            "enum": [
+              "sms",
+              "call",
+              "voicemail",
+              "ro_event",
+              "system_event"
+            ]
+          },
+          "channel": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "direction": {
+            "type": "string",
+            "enum": [
+              "inbound",
+              "outbound",
+              "internal"
+            ]
+          },
+          "senderType": {
+            "type": "string",
+            "enum": [
+              "customer",
+              "user",
+              "pam",
+              "system"
+            ]
+          },
+          "senderUserExternalId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "lineType": {
+            "type": "string",
+            "enum": [
+              "pam",
+              "rooftop",
+              "advisor"
+            ]
+          },
+          "dynamoLocator": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "partitionKey",
+              "sortKey"
+            ],
+            "properties": {
+              "partitionKey": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 2048
+              },
+              "sortKey": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 2048
+              }
+            }
+          }
+        }
+      },
+      "ProducerRepairOrderTransitionV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "transition",
+          "sourceSystem",
+          "externalId"
+        ],
+        "properties": {
+          "transition": {
+            "type": "string",
+            "enum": [
+              "RO_OPENED",
+              "RO_CLOSED"
+            ]
+          },
+          "sourceSystem": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "externalId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          }
+        }
+      },
+      "ProducerCustomerActivityPayloadV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "activityType",
+          "interaction"
+        ],
+        "properties": {
+          "activityType": {
+            "type": "string",
+            "const": "customer_activity"
+          },
+          "interaction": {
+            "$ref": "#/components/schemas/ProducerInteractionV1"
+          }
+        }
+      },
+      "ProducerApprovedResponsePayloadV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "activityType",
+          "interaction"
+        ],
+        "properties": {
+          "activityType": {
+            "type": "string",
+            "const": "approved_customer_response"
+          },
+          "interaction": {
+            "$ref": "#/components/schemas/ProducerInteractionV1"
+          }
+        }
+      },
+      "ProducerInformationalPayloadV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "activityType",
+          "interaction"
+        ],
+        "properties": {
+          "activityType": {
+            "type": "string",
+            "const": "informational"
+          },
+          "interaction": {
+            "$ref": "#/components/schemas/ProducerInteractionV1"
+          }
+        }
+      },
+      "ProducerRepairOrderPayloadV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "activityType",
+          "interaction",
+          "repairOrder"
+        ],
+        "properties": {
+          "activityType": {
+            "type": "string",
+            "const": "repair_order_transition"
+          },
+          "interaction": {
+            "$ref": "#/components/schemas/ProducerInteractionV1"
+          },
+          "repairOrder": {
+            "$ref": "#/components/schemas/ProducerRepairOrderTransitionV1"
+          }
+        }
+      },
+      "ProducerSourceActivityPayloadV1": {
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/ProducerCustomerActivityPayloadV1"
+          },
+          {
+            "$ref": "#/components/schemas/ProducerApprovedResponsePayloadV1"
+          },
+          {
+            "$ref": "#/components/schemas/ProducerInformationalPayloadV1"
+          },
+          {
+            "$ref": "#/components/schemas/ProducerRepairOrderPayloadV1"
+          }
+        ],
+        "discriminator": {
+          "propertyName": "activityType",
+          "mapping": {
+            "customer_activity": "#/components/schemas/ProducerCustomerActivityPayloadV1",
+            "approved_customer_response": "#/components/schemas/ProducerApprovedResponsePayloadV1",
+            "informational": "#/components/schemas/ProducerInformationalPayloadV1",
+            "repair_order_transition": "#/components/schemas/ProducerRepairOrderPayloadV1"
+          }
+        }
+      },
+      "ProducerAttentionRecipientV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "recipientUserExternalId",
+          "configuredTargetType",
+          "configuredTargetExternalId"
+        ],
+        "properties": {
+          "recipientUserExternalId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "configuredTargetType": {
+            "type": "string",
+            "enum": [
+              "user",
+              "group",
+              "team"
+            ]
+          },
+          "configuredTargetExternalId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "policyVersion": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "routingSnapshot": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        }
+      },
+      "ProducerAttentionPayloadV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "workCycleId",
+          "category",
+          "policySnapshot",
+          "recipients"
+        ],
+        "properties": {
+          "workCycleId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "category": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "interactionRefId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "policySnapshot": {
+            "type": "object",
+            "additionalProperties": true
+          },
+          "recipients": {
+            "type": "array",
+            "maxItems": 100,
+            "items": {
+              "$ref": "#/components/schemas/ProducerAttentionRecipientV1"
+            }
+          }
+        }
+      },
+      "ProducerReminderFirePayloadV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "reminderId",
+          "dueAt",
+          "expectedReminderVersion"
+        ],
+        "properties": {
+          "reminderId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "dueAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "expectedReminderVersion": {
+            "type": "integer",
+            "minimum": 1
+          }
+        }
+      },
+      "ProducerSnoozeReturnPayloadV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "workCycleId",
+          "scheduledFor",
+          "snoozeOperationId"
+        ],
+        "properties": {
+          "workCycleId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "scheduledFor": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "snoozeOperationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          }
+        }
+      },
+      "ProducerOverdueFirePayloadV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "workCycleId",
+          "deadline",
+          "oldestUnrespondedAt",
+          "recipientUserExternalId"
+        ],
+        "properties": {
+          "workCycleId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "deadline": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "oldestUnrespondedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "recipientUserExternalId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          }
+        }
+      },
+      "ProducerSourceActivityCommandV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "schemaVersion",
+          "operationId",
+          "commandType",
+          "clientOrgId",
+          "traceId",
+          "occurredAt",
+          "actor",
+          "source",
+          "target",
+          "payload"
+        ],
+        "properties": {
+          "schemaVersion": {
+            "type": "integer",
+            "const": 1
+          },
+          "operationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "commandType": {
+            "type": "string",
+            "const": "work_cycle.source_activity"
+          },
+          "clientOrgId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "traceId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          },
+          "occurredAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "actor": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "type"
+            ],
+            "properties": {
+              "type": {
+                "type": "string",
+                "const": "source"
+              }
+            }
+          },
+          "source": {
+            "$ref": "#/components/schemas/ProducerSourceV1"
+          },
+          "target": {
+            "$ref": "#/components/schemas/ProducerSourceActivityTargetV1"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/ProducerSourceActivityPayloadV1"
+          }
+        }
+      },
+      "ProducerAttentionCommandV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "schemaVersion",
+          "operationId",
+          "commandType",
+          "clientOrgId",
+          "traceId",
+          "occurredAt",
+          "actor",
+          "source",
+          "target",
+          "payload"
+        ],
+        "properties": {
+          "schemaVersion": {
+            "type": "integer",
+            "const": 1
+          },
+          "operationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "commandType": {
+            "type": "string",
+            "const": "attention.open_or_add_evidence"
+          },
+          "clientOrgId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "traceId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          },
+          "occurredAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "actor": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "type"
+            ],
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "source",
+                  "pam"
+                ]
+              }
+            }
+          },
+          "source": {
+            "$ref": "#/components/schemas/ProducerSourceV1"
+          },
+          "target": {
+            "$ref": "#/components/schemas/ProducerConversationTargetV1"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/ProducerAttentionPayloadV1"
+          }
+        }
+      },
+      "ProducerReminderFireCommandV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "schemaVersion",
+          "operationId",
+          "commandType",
+          "clientOrgId",
+          "traceId",
+          "occurredAt",
+          "actor",
+          "source",
+          "target",
+          "payload"
+        ],
+        "properties": {
+          "schemaVersion": {
+            "type": "integer",
+            "const": 1
+          },
+          "operationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "commandType": {
+            "type": "string",
+            "const": "reminder.fire"
+          },
+          "clientOrgId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "traceId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          },
+          "occurredAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "actor": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "type"
+            ],
+            "properties": {
+              "type": {
+                "type": "string",
+                "const": "system"
+              }
+            }
+          },
+          "source": {
+            "$ref": "#/components/schemas/ProducerSourceV1"
+          },
+          "target": {
+            "$ref": "#/components/schemas/ProducerConversationTargetV1"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/ProducerReminderFirePayloadV1"
+          }
+        }
+      },
+      "ProducerSnoozeReturnCommandV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "schemaVersion",
+          "operationId",
+          "commandType",
+          "clientOrgId",
+          "traceId",
+          "occurredAt",
+          "actor",
+          "source",
+          "target",
+          "payload"
+        ],
+        "properties": {
+          "schemaVersion": {
+            "type": "integer",
+            "const": 1
+          },
+          "operationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "commandType": {
+            "type": "string",
+            "const": "snooze.return"
+          },
+          "clientOrgId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "traceId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          },
+          "occurredAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "actor": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "type"
+            ],
+            "properties": {
+              "type": {
+                "type": "string",
+                "const": "system"
+              }
+            }
+          },
+          "source": {
+            "$ref": "#/components/schemas/ProducerSourceV1"
+          },
+          "target": {
+            "$ref": "#/components/schemas/ProducerConversationTargetV1"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/ProducerSnoozeReturnPayloadV1"
+          }
+        }
+      },
+      "ProducerOverdueFireCommandV1": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "schemaVersion",
+          "operationId",
+          "commandType",
+          "clientOrgId",
+          "traceId",
+          "occurredAt",
+          "actor",
+          "source",
+          "target",
+          "payload"
+        ],
+        "properties": {
+          "schemaVersion": {
+            "type": "integer",
+            "const": 1
+          },
+          "operationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "commandType": {
+            "type": "string",
+            "const": "overdue.fire"
+          },
+          "clientOrgId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "traceId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          },
+          "occurredAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "actor": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "type"
+            ],
+            "properties": {
+              "type": {
+                "type": "string",
+                "const": "system"
+              }
+            }
+          },
+          "source": {
+            "$ref": "#/components/schemas/ProducerSourceV1"
+          },
+          "target": {
+            "$ref": "#/components/schemas/ProducerConversationTargetV1"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/ProducerOverdueFirePayloadV1"
+          }
+        }
+      },
+      "ProducerCommandV1": {
+        "description": "Versioned internal FIFO producer command. Serialized SQS bodies are limited to 64 KiB by producers and consumers even though JSON Schema cannot express a byte-size limit.",
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/ProducerSourceActivityCommandV1"
+          },
+          {
+            "$ref": "#/components/schemas/ProducerAttentionCommandV1"
+          },
+          {
+            "$ref": "#/components/schemas/ProducerReminderFireCommandV1"
+          },
+          {
+            "$ref": "#/components/schemas/ProducerSnoozeReturnCommandV1"
+          },
+          {
+            "$ref": "#/components/schemas/ProducerOverdueFireCommandV1"
+          }
+        ],
+        "discriminator": {
+          "propertyName": "commandType",
+          "mapping": {
+            "work_cycle.source_activity": "#/components/schemas/ProducerSourceActivityCommandV1",
+            "attention.open_or_add_evidence": "#/components/schemas/ProducerAttentionCommandV1",
+            "reminder.fire": "#/components/schemas/ProducerReminderFireCommandV1",
+            "snooze.return": "#/components/schemas/ProducerSnoozeReturnCommandV1",
+            "overdue.fire": "#/components/schemas/ProducerOverdueFireCommandV1"
+          }
+        }
+      },
+      "CommandEnvelope": {
+        "type": "object",
+        "required": [
+          "operationId",
+          "clientOrgId",
+          "conversationId",
+          "workCycleId",
+          "expectedVersion"
+        ],
+        "properties": {
+          "operationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "clientOrgId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "conversationId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "workCycleId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "expectedVersion": {
+            "type": "integer",
+            "minimum": 1
+          }
+        }
+      },
+      "ActiveWorkCycleAppendEnvelope": {
+        "type": "object",
+        "required": [
+          "operationId",
+          "clientOrgId",
+          "conversationId",
+          "workCycleId"
+        ],
+        "properties": {
+          "operationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "clientOrgId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "conversationId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "workCycleId": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      },
+      "ConversationOperationEnvelope": {
+        "type": "object",
+        "required": [
+          "operationId",
+          "clientOrgId",
+          "conversationId"
+        ],
+        "properties": {
+          "operationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "clientOrgId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "conversationId": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      },
+      "NotificationCommand": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "operationId",
+          "clientOrgId",
+          "notificationId"
+        ],
+        "properties": {
+          "operationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "clientOrgId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "notificationId": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      },
+      "BaseCommand": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CommandEnvelope"
+          }
+        ],
+        "unevaluatedProperties": false
+      },
+      "UserAssignmentTarget": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "type",
+          "userId"
+        ],
+        "properties": {
+          "type": {
+            "type": "string",
+            "const": "USER"
+          },
+          "userId": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "TeamRoutingAssignmentTarget": {
+        "description": "Selects configured Team routing; the resulting owner remains an individual User.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "type",
+          "teamId"
+        ],
+        "properties": {
+          "type": {
+            "type": "string",
+            "const": "TEAM_ROUTING"
+          },
+          "teamId": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "AssignmentTarget": {
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/UserAssignmentTarget"
+          },
+          {
+            "$ref": "#/components/schemas/TeamRoutingAssignmentTarget"
+          }
+        ],
+        "discriminator": {
+          "propertyName": "type",
+          "mapping": {
+            "USER": "#/components/schemas/UserAssignmentTarget",
+            "TEAM_ROUTING": "#/components/schemas/TeamRoutingAssignmentTarget"
+          }
+        }
+      },
+      "AssignCommand": {
+        "unevaluatedProperties": false,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CommandEnvelope"
+          },
+          {
+            "type": "object",
+            "required": [
+              "target"
+            ],
+            "properties": {
+              "target": {
+                "$ref": "#/components/schemas/AssignmentTarget"
+              }
+            }
+          }
+        ]
+      },
+      "SnoozeCommand": {
+        "unevaluatedProperties": false,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CommandEnvelope"
+          },
+          {
+            "type": "object",
+            "required": [
+              "until"
+            ],
+            "properties": {
+              "until": {
+                "type": "string",
+                "format": "date-time"
+              },
+              "reason": {
+                "type": "string",
+                "maxLength": 1000
+              }
+            }
+          }
+        ]
+      },
+      "SetReminderCommand": {
+        "unevaluatedProperties": false,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CommandEnvelope"
+          },
+          {
+            "type": "object",
+            "required": [
+              "dueAt"
+            ],
+            "properties": {
+              "dueAt": {
+                "type": "string",
+                "format": "date-time"
+              },
+              "note": {
+                "type": "string",
+                "maxLength": 2000
+              }
+            }
+          }
+        ]
+      },
+      "CloseCommand": {
+        "unevaluatedProperties": false,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CommandEnvelope"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "resolutionKey": {
+                "type": "string",
+                "minLength": 1,
+                "default": "completed",
+                "description": "Optional one-click resolution key. The service uses completed when omitted; other requires a non-blank reason."
+              },
+              "reason": {
+                "type": "string",
+                "maxLength": 2000
+              }
+            }
+          }
+        ]
+      },
+      "AcknowledgeAttentionCommand": {
+        "unevaluatedProperties": false,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CommandEnvelope"
+          },
+          {
+            "type": "object",
+            "required": [
+              "attentionCycleId"
+            ],
+            "properties": {
+              "attentionCycleId": {
+                "type": "string",
+                "format": "uuid"
+              }
+            }
+          }
+        ]
+      },
+      "ResolveAttentionCommand": {
+        "unevaluatedProperties": false,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CommandEnvelope"
+          },
+          {
+            "type": "object",
+            "required": [
+              "attentionCycleId"
+            ],
+            "properties": {
+              "attentionCycleId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "reason": {
+                "type": "string",
+                "maxLength": 2000
+              }
+            }
+          }
+        ]
+      },
+      "AddInternalCommentCommand": {
+        "unevaluatedProperties": false,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ActiveWorkCycleAppendEnvelope"
+          },
+          {
+            "type": "object",
+            "required": [
+              "body",
+              "mentionedUserIds"
+            ],
+            "properties": {
+              "body": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 10000,
+                "pattern": ".*\\S.*"
+              },
+              "mentionedUserIds": {
+                "type": "array",
+                "minItems": 0,
+                "maxItems": 50,
+                "uniqueItems": true,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "replyToInteractionRefId": {
+                "type": "string",
+                "format": "uuid"
+              }
+            }
+          }
+        ]
+      },
+      "AdvanceReadCursorCommand": {
+        "unevaluatedProperties": false,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ConversationOperationEnvelope"
+          },
+          {
+            "type": "object",
+            "required": [
+              "throughInteractionRefId"
+            ],
+            "properties": {
+              "throughInteractionRefId": {
+                "type": "string",
+                "format": "uuid"
+              }
+            }
+          }
+        ]
+      },
+      "AddCustomerNoteCommand": {
+        "unevaluatedProperties": false,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ConversationOperationEnvelope"
+          },
+          {
+            "type": "object",
+            "required": [
+              "body"
+            ],
+            "properties": {
+              "body": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 10000,
+                "pattern": ".*\\S.*"
+              }
+            }
+          }
+        ]
+      },
+      "DeleteCustomerNoteCommand": {
+        "unevaluatedProperties": false,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ConversationOperationEnvelope"
+          },
+          {
+            "type": "object",
+            "required": [
+              "noteId",
+              "expectedNoteVersion"
+            ],
+            "properties": {
+              "noteId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "expectedNoteVersion": {
+                "type": "integer",
+                "minimum": 1
+              }
+            }
+          }
+        ]
+      },
+      "CommandResult": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "properties": {
+          "data": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "operationId",
+              "applied",
+              "replayed",
+              "conversationId",
+              "workCycleId",
+              "resultingVersion"
+            ],
+            "properties": {
+              "operationId": {
+                "type": "string"
+              },
+              "applied": {
+                "type": "boolean"
+              },
+              "replayed": {
+                "type": "boolean"
+              },
+              "conversationId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "workCycleId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "resultingVersion": {
+                "type": "integer",
+                "minimum": 1
+              }
+            }
+          }
+        }
+      },
+      "InternalCommentResult": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "properties": {
+          "data": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "operationId",
+              "applied",
+              "replayed",
+              "conversationId",
+              "workCycleId",
+              "resultingVersion",
+              "interactionRefId",
+              "sequenceNumber",
+              "mentionCount"
+            ],
+            "properties": {
+              "operationId": {
+                "type": "string"
+              },
+              "applied": {
+                "type": "boolean"
+              },
+              "replayed": {
+                "type": "boolean"
+              },
+              "conversationId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "workCycleId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "resultingVersion": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "interactionRefId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "sequenceNumber": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "mentionCount": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 50
+              }
+            }
+          }
+        }
+      },
+      "ReadCursorResult": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "properties": {
+          "data": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "operationId",
+              "applied",
+              "replayed",
+              "conversationId",
+              "lastReadInteractionRefId",
+              "lastReadSequenceNumber"
+            ],
+            "properties": {
+              "operationId": {
+                "type": "string"
+              },
+              "applied": {
+                "type": "boolean"
+              },
+              "replayed": {
+                "type": "boolean"
+              },
+              "conversationId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "lastReadInteractionRefId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "lastReadSequenceNumber": {
+                "type": "integer",
+                "minimum": 1
+              }
+            }
+          }
+        }
+      },
+      "CustomerNoteCommandResult": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "properties": {
+          "data": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "operationId",
+              "applied",
+              "replayed",
+              "conversationId",
+              "noteId",
+              "resultingNoteVersion"
+            ],
+            "properties": {
+              "operationId": {
+                "type": "string"
+              },
+              "applied": {
+                "type": "boolean"
+              },
+              "replayed": {
+                "type": "boolean"
+              },
+              "conversationId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "noteId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "resultingNoteVersion": {
+                "type": "integer",
+                "minimum": 1
+              }
+            }
+          }
+        }
+      },
+      "NotificationCommandResult": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "properties": {
+          "data": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "operationId",
+              "applied",
+              "replayed",
+              "notificationId",
+              "readAt",
+              "dismissedAt"
+            ],
+            "properties": {
+              "operationId": {
+                "type": "string"
+              },
+              "applied": {
+                "type": "boolean"
+              },
+              "replayed": {
+                "type": "boolean"
+              },
+              "notificationId": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "readAt": {
+                "type": "string",
+                "format": "date-time"
+              },
+              "dismissedAt": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "format": "date-time"
+              }
+            }
+          }
+        }
+      },
+      "ErrorEnvelope": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "error"
+        ],
+        "properties": {
+          "error": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "code",
+              "message",
+              "correlationId"
+            ],
+            "properties": {
+              "code": {
+                "type": "string"
+              },
+              "message": {
+                "type": "string"
+              },
+              "correlationId": {
+                "type": "string"
+              },
+              "details": {
+                "type": "object",
+                "additionalProperties": true
+              }
+            }
+          }
+        }
+      }
+    },
+    "requestBodies": {
+      "BaseCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/BaseCommand"
+            }
+          }
+        }
+      },
+      "AssignCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/AssignCommand"
+            }
+          }
+        }
+      },
+      "SnoozeCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/SnoozeCommand"
+            }
+          }
+        }
+      },
+      "SetReminderCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/SetReminderCommand"
+            }
+          }
+        }
+      },
+      "CloseCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/CloseCommand"
+            }
+          }
+        }
+      },
+      "AcknowledgeAttentionCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/AcknowledgeAttentionCommand"
+            }
+          }
+        }
+      },
+      "ResolveAttentionCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/ResolveAttentionCommand"
+            }
+          }
+        }
+      },
+      "AddInternalCommentCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/AddInternalCommentCommand"
+            }
+          }
+        }
+      },
+      "AdvanceReadCursorCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/AdvanceReadCursorCommand"
+            }
+          }
+        }
+      },
+      "AddCustomerNoteCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/AddCustomerNoteCommand"
+            }
+          }
+        }
+      },
+      "DeleteCustomerNoteCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/DeleteCustomerNoteCommand"
+            }
+          }
+        }
+      },
+      "NotificationCommand": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/NotificationCommand"
+            }
+          }
+        }
+      }
+    },
+    "responses": {
+      "CommandApplied": {
+        "description": "Applied or idempotently replayed command result.",
+        "headers": {
+          "x-correlation-id": {
+            "$ref": "#/components/headers/CorrelationId"
+          }
+        },
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/CommandResult"
+            }
+          }
+        }
+      },
+      "InternalCommentApplied": {
+        "description": "Applied or idempotently replayed internal-comment result.",
+        "headers": {
+          "x-correlation-id": {
+            "$ref": "#/components/headers/CorrelationId"
+          }
+        },
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/InternalCommentResult"
+            }
+          }
+        }
+      },
+      "ReadCursorAdvanced": {
+        "description": "Applied, replayed, or monotonic no-op read-cursor result.",
+        "headers": {
+          "x-correlation-id": {
+            "$ref": "#/components/headers/CorrelationId"
+          }
+        },
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/ReadCursorResult"
+            }
+          }
+        }
+      },
+      "CustomerNoteCommandApplied": {
+        "description": "Applied or idempotently replayed Customer-note mutation result.",
+        "headers": {
+          "x-correlation-id": {
+            "$ref": "#/components/headers/CorrelationId"
+          }
+        },
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/CustomerNoteCommandResult"
+            }
+          }
+        }
+      },
+      "NotificationCommandApplied": {
+        "description": "Applied, replayed, or monotonic no-op notification state result.",
+        "headers": {
+          "x-correlation-id": {
+            "$ref": "#/components/headers/CorrelationId"
+          }
+        },
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/NotificationCommandResult"
+            }
+          }
+        }
+      },
+      "BadRequest": {
+        "description": "Invalid input.",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/ErrorEnvelope"
+            }
+          }
+        }
+      },
+      "Unauthorized": {
+        "description": "Missing or invalid dashboard identity.",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/ErrorEnvelope"
+            }
+          }
+        }
+      },
+      "Forbidden": {
+        "description": "Authenticated but not authorized for rooftop or capability.",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/ErrorEnvelope"
+            }
+          }
+        }
+      },
+      "NotFound": {
+        "description": "Not found without disclosing unauthorized record existence.",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/ErrorEnvelope"
+            }
+          }
+        }
+      },
+      "Conflict": {
+        "description": "Stale expectedVersion or command conflict; refresh and retry deliberately.",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/ErrorEnvelope"
+            }
+          }
+        }
+      },
+      "InternalError": {
+        "description": "Unexpected service error.",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/ErrorEnvelope"
+            }
+          }
+        }
+      },
+      "ServiceUnavailable": {
+        "description": "A required upstream authority is temporarily unavailable.",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/ErrorEnvelope"
+            }
+          }
+        }
+      },
+      "NotImplemented": {
+        "description": "Contract route is published but behavior is pending DASH-235 through DASH-237.",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/ErrorEnvelope"
+            }
+          }
+        }
+      }
+    }
+  }
+}