@pam-ai/pam-ordo-contracts 3.4.0

package/fixtures/conversation-detail-missing-body.json

@@ -0,0 +1,133 @@
+{
+  "data": {
+    "conversationId": "019c0000-0000-7000-8000-000000000001",
+    "clientOrgId": "fixture-rooftop",
+    "customerId": "customer-001",
+    "version": 4,
+    "currentCycle": {
+      "id": "019c0000-0000-7000-8000-000000000002",
+      "cycleNumber": 1,
+      "status": "OPEN",
+      "openedAt": "2026-08-31T12:00:00.000Z",
+      "oldestUnrespondedAt": "2026-08-31T12:05:00.000Z",
+      "snoozedAt": null,
+      "resolvedAt": null,
+      "version": 3
+    },
+    "owner": null,
+    "reminder": null,
+    "attention": null,
+    "overdue": {
+      "isOverdue": false,
+      "overdueAt": "2026-08-31T12:35:00.000Z",
+      "presentationSuppressedByReminder": false
+    },
+    "customerDisplayName": {
+      "value": null,
+      "availability": {
+        "state": "timeout",
+        "source": "pam-customers-service"
+      }
+    },
+    "customerPhone": {
+      "value": null,
+      "availability": {
+        "state": "timeout",
+        "source": "pam-customers-service"
+      }
+    },
+    "aiContext": {
+      "summary": {
+        "value": null,
+        "availability": {
+          "state": "timeout",
+          "source": "conversation-worker"
+        }
+      },
+      "categories": {
+        "value": null,
+        "availability": {
+          "state": "timeout",
+          "source": "conversation-worker"
+        }
+      },
+      "sentiment": {
+        "value": null,
+        "availability": {
+          "state": "timeout",
+          "source": "conversation-worker"
+        }
+      },
+      "recommendedNextStep": {
+        "value": null,
+        "availability": {
+          "state": "unsupported",
+          "source": "conversation-worker"
+        }
+      }
+    },
+    "viewerState": {
+      "unreadCount": 1,
+      "isMentionWatcher": false,
+      "unreadMentionCount": 0,
+      "readThroughInteractionId": null,
+      "readThroughSequenceNumber": null
+    },
+    "interactionSummary": {
+      "totalCount": 1,
+      "inboundCount": 1,
+      "outboundCount": 0,
+      "internalCount": 0,
+      "channels": ["SMS"]
+    },
+    "cycles": [
+      {
+        "id": "019c0000-0000-7000-8000-000000000002",
+        "cycleNumber": 1,
+        "status": "OPEN",
+        "openedAt": "2026-08-31T12:00:00.000Z",
+        "oldestUnrespondedAt": "2026-08-31T12:05:00.000Z",
+        "snoozedAt": null,
+        "resolvedAt": null,
+        "version": 3
+      }
+    ],
+    "interactions": [
+      {
+        "id": "019c0000-0000-7000-8000-000000000004",
+        "senderUserId": null,
+        "replyToInteractionId": null,
+        "mentions": [],
+        "workCycleId": "019c0000-0000-7000-8000-000000000002",
+        "sequenceNumber": 1,
+        "kind": "sms",
+        "channel": "SMS",
+        "direction": "INBOUND",
+        "occurredAt": "2026-08-31T12:05:00.000Z",
+        "body": {
+          "value": null,
+          "availability": {
+            "state": "missing",
+            "source": "pam_messaging_dynamodb"
+          }
+        },
+        "availability": {
+          "state": "missing",
+          "source": "pam_messaging_dynamodb"
+        }
+      }
+    ],
+    "repairOrders": [],
+    "availableActions": ["ASSIGN", "SNOOZE", "SET_REMINDER", "CLOSE"],
+    "availability": {
+      "customer": {
+        "state": "timeout",
+        "source": "pam-customers-service"
+      },
+      "repairOrders": {
+        "state": "available",
+        "source": "dms"
+      }
+    }
+  }
+}

package/fixtures/customer-note-command-result.json

@@ -0,0 +1,10 @@
+{
+  "data": {
+    "operationId": "note-create-01",
+    "applied": true,
+    "replayed": false,
+    "conversationId": "01a05847-dde0-7000-8000-000000000093",
+    "noteId": "019a1111-1111-7111-8111-111111111111",
+    "resultingNoteVersion": 1
+  }
+}

package/fixtures/customer-notes-page.json

@@ -0,0 +1,17 @@
+{
+  "data": {
+    "notes": [
+      {
+        "id": "019a1111-1111-7111-8111-111111111111",
+        "body": "Customer prefers text messages after 4 PM.",
+        "authorUserId": "user-omer",
+        "createdAt": "2026-09-02T16:00:00.000Z",
+        "updatedAt": "2026-09-02T16:00:00.000Z",
+        "version": 1
+      }
+    ]
+  },
+  "meta": {
+    "nextCursor": null
+  }
+}

package/fixtures/delete-customer-note-command.json

@@ -0,0 +1,7 @@
+{
+  "operationId": "note-delete-01",
+  "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
+  "conversationId": "01a05847-dde0-7000-8000-000000000093",
+  "noteId": "019a1111-1111-7111-8111-111111111111",
+  "expectedNoteVersion": 1
+}

package/fixtures/inbox-list-customer-no-work.json

@@ -0,0 +1,93 @@
+{
+  "data": {
+    "rows": [
+      {
+        "conversationId": "019c0000-0000-7000-8000-000000000011",
+        "clientOrgId": "fixture-rooftop",
+        "customerId": "customer-011",
+        "workCycle": null,
+        "owner": null,
+        "reminder": null,
+        "attention": null,
+        "overdue": {
+          "isOverdue": false,
+          "overdueAt": null,
+          "presentationSuppressedByReminder": false
+        },
+        "latestActivityAt": "2026-08-31T12:00:00.000Z",
+        "customerDisplayName": {
+          "value": "Jordan Customer",
+          "availability": {
+            "state": "available",
+            "source": "pam-customers-service"
+          }
+        },
+        "customerPhone": {
+          "value": "+17045550148",
+          "availability": {
+            "state": "available",
+            "source": "pam-customers-service"
+          }
+        },
+        "activeRepairOrders": [],
+        "aiContext": {
+          "summary": {
+            "value": null,
+            "availability": {
+              "state": "missing",
+              "source": "conversation-worker"
+            }
+          },
+          "categories": {
+            "value": null,
+            "availability": {
+              "state": "missing",
+              "source": "conversation-worker"
+            }
+          },
+          "sentiment": {
+            "value": null,
+            "availability": {
+              "state": "missing",
+              "source": "conversation-worker"
+            }
+          },
+          "recommendedNextStep": {
+            "value": null,
+            "availability": {
+              "state": "unsupported",
+              "source": "conversation-worker"
+            }
+          }
+        },
+        "viewerState": {
+          "unreadCount": 0,
+          "isMentionWatcher": false,
+          "unreadMentionCount": 0,
+          "readThroughInteractionId": null,
+          "readThroughSequenceNumber": null
+        },
+        "interactionSummary": {
+          "totalCount": 0,
+          "inboundCount": 0,
+          "outboundCount": 0,
+          "internalCount": 0,
+          "channels": []
+        },
+        "availableActions": [],
+        "availability": {}
+      }
+    ],
+    "counts": {
+      "total": 1,
+      "open": 0,
+      "snoozed": 0,
+      "overdue": 0,
+      "needsAttention": 0,
+      "resolved": 0
+    }
+  },
+  "meta": {
+    "nextCursor": null
+  }
+}

package/fixtures/inbox-list-partial-hydration.json

@@ -0,0 +1,175 @@
+{
+  "data": {
+    "rows": [
+      {
+        "conversationId": "019c0000-0000-7000-8000-000000000001",
+        "clientOrgId": "fixture-rooftop",
+        "customerId": "customer-001",
+        "workCycle": {
+          "id": "019c0000-0000-7000-8000-000000000002",
+          "cycleNumber": 1,
+          "status": "OPEN",
+          "openedAt": "2026-08-31T12:00:00.000Z",
+          "oldestUnrespondedAt": "2026-08-31T12:05:00.000Z",
+          "snoozedAt": null,
+          "resolvedAt": null,
+          "version": 3
+        },
+        "owner": null,
+        "reminder": null,
+        "attention": {
+          "id": "019c0000-0000-7000-8000-000000000003",
+          "category": "negative_sentiment",
+          "status": "ACTIVE",
+          "openedAt": "2026-08-31T12:10:00.000Z",
+          "version": 1
+        },
+        "overdue": {
+          "isOverdue": true,
+          "overdueAt": "2026-08-31T12:35:00.000Z",
+          "presentationSuppressedByReminder": false
+        },
+        "latestActivityAt": "2026-08-31T12:10:00.000Z",
+        "customerDisplayName": {
+          "value": null,
+          "availability": {
+            "state": "timeout",
+            "source": "pam-customers-service",
+            "reason": "Synthetic hydration timeout"
+          }
+        },
+        "customerPhone": {
+          "value": null,
+          "availability": {
+            "state": "timeout",
+            "source": "pam-customers-service",
+            "reason": "Synthetic hydration timeout"
+          }
+        },
+        "activeRepairOrders": [
+          {
+            "sourceSystem": "dms",
+            "externalId": "ro-1001",
+            "relationship": "ACTIVE",
+            "displayNumber": {
+              "value": "1001",
+              "availability": {
+                "state": "available",
+                "source": "pam-customers-service"
+              }
+            },
+            "status": {
+              "value": "OPEN",
+              "availability": {
+                "state": "available",
+                "source": "pam-customers-service"
+              }
+            },
+            "vehicle": {
+              "sourceSystem": "pam-customers-service",
+              "externalId": "vehicle-001",
+              "year": {
+                "value": "2024",
+                "availability": {
+                  "state": "available",
+                  "source": "pam-customers-service"
+                }
+              },
+              "make": {
+                "value": "Ford",
+                "availability": {
+                  "state": "available",
+                  "source": "pam-customers-service"
+                }
+              },
+              "model": {
+                "value": null,
+                "availability": {
+                  "state": "missing",
+                  "source": "pam-customers-service"
+                }
+              },
+              "vin": {
+                "value": "1FTFW1E50PKF00001",
+                "availability": {
+                  "state": "available",
+                  "source": "pam-customers-service"
+                }
+              },
+              "availability": {
+                "state": "available",
+                "source": "pam-customers-service"
+              }
+            },
+            "availability": {
+              "state": "available",
+              "source": "pam-customers-service"
+            }
+          }
+        ],
+        "aiContext": {
+          "summary": {
+            "value": "Customer is requesting an update on the active repair order.",
+            "availability": {
+              "state": "available",
+              "source": "conversation-worker"
+            }
+          },
+          "categories": {
+            "value": ["service_status_check"],
+            "availability": {
+              "state": "available",
+              "source": "conversation-worker"
+            }
+          },
+          "sentiment": {
+            "value": "negative",
+            "availability": {
+              "state": "available",
+              "source": "conversation-worker"
+            }
+          },
+          "recommendedNextStep": {
+            "value": null,
+            "availability": {
+              "state": "unsupported",
+              "source": "conversation-worker"
+            }
+          }
+        },
+        "viewerState": {
+          "unreadCount": 2,
+          "isMentionWatcher": true,
+          "unreadMentionCount": 1,
+          "readThroughInteractionId": "019c0000-0000-7000-8000-000000000004",
+          "readThroughSequenceNumber": 1
+        },
+        "interactionSummary": {
+          "totalCount": 3,
+          "inboundCount": 2,
+          "outboundCount": 1,
+          "internalCount": 0,
+          "channels": ["SMS"]
+        },
+        "availableActions": ["ASSIGN", "SNOOZE", "SET_REMINDER"],
+        "availability": {
+          "customer": {
+            "state": "timeout",
+            "source": "pam-customers-service"
+          }
+        }
+      }
+    ],
+    "counts": {
+      "total": 1,
+      "open": 1,
+      "snoozed": 0,
+      "overdue": 1,
+      "needsAttention": 1,
+      "resolved": 0
+    }
+  },
+  "meta": {
+    "nextCursor": null
+  }
+}

package/fixtures/inbox-policy-v1.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": 1,
+  "categories": [
+    {
+      "category": "unresolved_call",
+      "enabled": true,
+      "createsWorkCycle": true,
+      "routing": { "type": "TEAM", "dashboardGroupId": "group-bdc" },
+      "needsAttention": {
+        "enabled": true,
+        "recipients": [
+          { "type": "TEAM", "dashboardGroupId": "group-bdc-managers" },
+          { "type": "USER", "userId": "user-operations-lead" }
+        ]
+      }
+    },
+    {
+      "category": "informational_status",
+      "enabled": true,
+      "createsWorkCycle": false,
+      "routing": { "type": "UNASSIGNED" },
+      "needsAttention": { "enabled": false, "recipients": [] }
+    }
+  ],
+  "overdue": { "enabled": true, "thresholdMinutes": 30 },
+  "notifications": [
+    {
+      "kind": "ro_closed",
+      "enabled": true,
+      "recipients": [{ "type": "TEAM", "dashboardGroupId": "group-service" }]
+    }
+  ]
+}

package/fixtures/inbox-target-resolution-request-v1.json

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": 1,
+  "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
+  "targets": [
+    { "type": "TEAM", "dashboardGroupId": "group-bdc" },
+    { "type": "USER", "userId": "user-operations-lead" }
+  ]
+}

package/fixtures/inbox-target-resolution-response-v1.json

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
+  "results": [
+    {
+      "target": { "type": "TEAM", "dashboardGroupId": "group-bdc" },
+      "status": "resolved",
+      "userIds": ["user-bdc-1"]
+    },
+    {
+      "target": { "type": "USER", "userId": "user-operations-lead" },
+      "status": "none",
+      "userIds": []
+    }
+  ],
+  "users": [
+    {
+      "userId": "user-bdc-1",
+      "persona": "BDC_REPRESENTATIVE",
+      "capabilities": ["VIEW_OWN_INBOX", "ASSIGN_OWNED_WORK"]
+    }
+  ]
+}

package/fixtures/internal-comment-result.json

@@ -0,0 +1,13 @@
+{
+  "data": {
+    "operationId": "internal-comment-01",
+    "applied": true,
+    "replayed": false,
+    "conversationId": "01a05847-dde0-7000-8000-000000000001",
+    "workCycleId": "01a05847-dde0-7000-8000-000000000002",
+    "resultingVersion": 3,
+    "interactionRefId": "01a05847-dde0-7000-8000-000000000011",
+    "sequenceNumber": 8,
+    "mentionCount": 1
+  }
+}

package/fixtures/manifest.json

@@ -0,0 +1,32 @@
+{
+  "contact-search.json": "ContactSearchResponse",
+  "inbox-list-partial-hydration.json": "InboxListResponse",
+  "inbox-list-customer-no-work.json": "InboxListResponse",
+  "conversation-detail-missing-body.json": "ConversationDetailResponse",
+  "assign-command.json": "AssignCommand",
+  "assign-team-routing-command.json": "AssignCommand",
+  "acknowledge-attention-command.json": "AcknowledgeAttentionCommand",
+  "resolve-attention-command.json": "ResolveAttentionCommand",
+  "add-internal-comment-command.json": "AddInternalCommentCommand",
+  "advance-read-cursor-command.json": "AdvanceReadCursorCommand",
+  "customer-notes-page.json": "CustomerNoteListResponse",
+  "add-customer-note-command.json": "AddCustomerNoteCommand",
+  "delete-customer-note-command.json": "DeleteCustomerNoteCommand",
+  "command-result.json": "CommandResult",
+  "internal-comment-result.json": "InternalCommentResult",
+  "read-cursor-result.json": "ReadCursorResult",
+  "customer-note-command-result.json": "CustomerNoteCommandResult",
+  "notification-list.json": "NotificationListResponse",
+  "notification-command.json": "NotificationCommand",
+  "notification-command-result.json": "NotificationCommandResult",
+  "version-conflict.json": "ErrorEnvelope",
+  "permissions-unavailable.json": "ErrorEnvelope",
+  "producer-source-activity-command-v1.json": "ProducerCommandV1",
+  "producer-attention-command-v1.json": "ProducerCommandV1",
+  "producer-reminder-fire-command-v1.json": "ProducerCommandV1",
+  "producer-snooze-return-command-v1.json": "ProducerCommandV1",
+  "producer-overdue-fire-command-v1.json": "ProducerCommandV1",
+  "inbox-policy-v1.json": "InboxPolicyV1",
+  "inbox-target-resolution-request-v1.json": "InboxTargetResolutionRequestV1",
+  "inbox-target-resolution-response-v1.json": "InboxTargetResolutionResponseV1"
+}

package/fixtures/notification-command-result.json

@@ -0,0 +1,10 @@
+{
+  "data": {
+    "operationId": "notification-read-01",
+    "applied": true,
+    "replayed": false,
+    "notificationId": "019a2222-2222-7222-8222-222222222222",
+    "readAt": "2026-09-03T12:05:00.000Z",
+    "dismissedAt": null
+  }
+}

package/fixtures/notification-command.json

@@ -0,0 +1,5 @@
+{
+  "operationId": "notification-read-01",
+  "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
+  "notificationId": "019a2222-2222-7222-8222-222222222222"
+}

package/fixtures/notification-list.json

@@ -0,0 +1,25 @@
+{
+  "data": {
+    "notifications": [
+      {
+        "id": "019a2222-2222-7222-8222-222222222222",
+        "kind": "mention",
+        "conversationId": "01a05847-dde0-7000-8000-000000000093",
+        "workCycleId": "01a05847-dde0-7000-8000-000000000194",
+        "reminderId": null,
+        "mentionId": "019a3333-3333-7333-8333-333333333333",
+        "attentionCycleId": null,
+        "interactionId": "019a4444-4444-7444-8444-444444444444",
+        "title": "New mention",
+        "body": "You were mentioned in an internal comment.",
+        "payloadVersion": 1,
+        "createdAt": "2026-09-03T12:00:00.000Z",
+        "readAt": null
+      }
+    ],
+    "unreadCount": 1
+  },
+  "meta": {
+    "nextCursor": null
+  }
+}

package/fixtures/permissions-unavailable.json

@@ -0,0 +1,7 @@
+{
+  "error": {
+    "code": "PERMISSIONS_AUTHORITY_UNAVAILABLE",
+    "message": "The permissions authority is temporarily unavailable.",
+    "correlationId": "fixture-correlation-503"
+  }
+}

package/fixtures/producer-attention-command-v1.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "operationId": "attention:evidence:01",
+  "commandType": "attention.open_or_add_evidence",
+  "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
+  "traceId": "trace-attention-01",
+  "occurredAt": "2026-09-03T13:46:00.000Z",
+  "actor": { "type": "pam" },
+  "source": {
+    "system": "conversation-worker",
+    "eventId": "classification-456",
+    "eventVersion": "3"
+  },
+  "target": { "conversationId": "0199082e-8d80-7000-8000-000000000001" },
+  "payload": {
+    "workCycleId": "0199082e-8d80-7000-8000-000000000002",
+    "category": "frustrated_customer",
+    "policySnapshot": { "policyVersion": "attention-v3" },
+    "recipients": [
+      {
+        "recipientUserExternalId": "user-manager-1",
+        "configuredTargetType": "group",
+        "configuredTargetExternalId": "bdc-managers",
+        "policyVersion": "attention-v3"
+      }
+    ]
+  }
+}

package/fixtures/producer-invalid-actor-command-v1.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 1,
+  "operationId": "invalid-actor",
+  "commandType": "overdue.fire",
+  "clientOrgId": "clone-test",
+  "traceId": "trace-invalid",
+  "occurredAt": "2026-09-03T14:15:00.000Z",
+  "actor": { "type": "source" },
+  "source": { "system": "scheduler", "eventId": "1", "eventVersion": "1" },
+  "target": { "conversationId": "0199082e-8d80-7000-8000-000000000001" },
+  "payload": {
+    "workCycleId": "0199082e-8d80-7000-8000-000000000002",
+    "deadline": "2026-09-03T14:15:00.000Z",
+    "oldestUnrespondedAt": "2026-09-03T13:45:00.000Z",
+    "recipientUserExternalId": "user-owner-1"
+  }
+}

package/fixtures/producer-invalid-customer-identity-v1.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "operationId": "invalid-identity",
+  "commandType": "work_cycle.source_activity",
+  "clientOrgId": "clone-test",
+  "traceId": "trace-invalid",
+  "occurredAt": "2026-09-03T13:45:00.000Z",
+  "actor": { "type": "source" },
+  "source": { "system": "sms", "eventId": "1", "eventVersion": "1" },
+  "target": { "customerIdentity": { "customerSourceSystem": "customers" } },
+  "payload": {
+    "activityType": "customer_activity",
+    "interaction": { "kind": "sms", "direction": "inbound", "senderType": "customer" }
+  }
+}