@pam-ai/pam-ordo-contracts 3.10.0 → 3.10.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -9,7 +9,7 @@ Pin consumers to an exact npm version:
9
9
  ```json
10
10
  {
11
11
  "dependencies": {
12
- "@pam-ai/pam-ordo-contracts": "3.10.0"
12
+ "@pam-ai/pam-ordo-contracts": "3.10.2"
13
13
  }
14
14
  }
15
15
  ```
@@ -38,6 +38,18 @@ legacy timed-escalation fields.
38
38
 
39
39
  The public npm artifact contains compiled TypeScript declarations, bundled OpenAPI, and shared fixtures. Consumers do not need GitHub repository credentials.
40
40
 
41
+ New DASH-273 verification runners must use the canonical v2 manifest exported at
42
+ `@pam-ai/pam-ordo-contracts/fixtures/dash-273/manifest.v2.json` with
43
+ `manifest.v2.schema.json`. Resolve each shared command fixture relative to the manifest file.
44
+ The v2 manifest records exact command and FIFO identities, the truthful starting boundary, and
45
+ whether coverage is projection-only, producer-only, or consumer-only. Conflict references are
46
+ typed as `{ "kind": "command" | "step", "id": "..." }`; command IDs resolve against the global
47
+ command catalog and step IDs resolve within their scenario.
48
+
49
+ The original `manifest.json` and `manifest.schema.json` exports remain byte-for-byte compatible
50
+ with published 3.10.1 for legacy readers. They retain ambiguous string conflict references and
51
+ must not be used by new runners that validate conflict semantics.
52
+
41
53
  ## Contract development
42
54
 
43
55
  `openapi/openapi.yaml` is the source of truth. Bundled JSON and generated TypeScript are committed for review.
@@ -0,0 +1,33 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "call:connection-inbound-001:v1:connection-inbound-001",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "call:connection-inbound-001",
7
+ "occurredAt": "2026-09-03T14:00:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_call_metadata",
11
+ "eventId": "connection-inbound-001",
12
+ "eventVersion": "v1:connection-inbound-001"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam-customers-service",
17
+ "customerExternalId": "customer-123"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "customer_activity",
22
+ "interaction": {
23
+ "kind": "voicemail",
24
+ "channel": "voice",
25
+ "direction": "inbound",
26
+ "senderType": "customer",
27
+ "dynamoLocator": {
28
+ "partitionKey": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
29
+ "sortKey": "2026-09-03T14:00:00.000Z"
30
+ }
31
+ }
32
+ }
33
+ }
@@ -0,0 +1,33 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "call:connection-outbound-002:v1:connection-outbound-002",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "call:connection-outbound-002",
7
+ "occurredAt": "2026-09-03T14:10:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_call_metadata",
11
+ "eventId": "connection-outbound-002",
12
+ "eventVersion": "v1:connection-outbound-002"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam-customers-service",
17
+ "customerExternalId": "customer-123"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "approved_customer_response",
22
+ "interaction": {
23
+ "kind": "voicemail",
24
+ "channel": "voice",
25
+ "direction": "outbound",
26
+ "senderType": "pam",
27
+ "dynamoLocator": {
28
+ "partitionKey": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
29
+ "sortKey": "2026-09-03T14:10:00.000Z"
30
+ }
31
+ }
32
+ }
33
+ }
@@ -0,0 +1,34 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "call:connection-outbound-001:v1:connection-outbound-001",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "call:connection-outbound-001",
7
+ "occurredAt": "2026-09-03T14:05:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_call_metadata",
11
+ "eventId": "connection-outbound-001",
12
+ "eventVersion": "v1:connection-outbound-001"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam-customers-service",
17
+ "customerExternalId": "customer-123"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "approved_customer_response",
22
+ "interaction": {
23
+ "kind": "call",
24
+ "channel": "voice",
25
+ "direction": "outbound",
26
+ "senderType": "user",
27
+ "senderUserExternalId": "user-advisor-1",
28
+ "dynamoLocator": {
29
+ "partitionKey": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
30
+ "sortKey": "2026-09-03T14:05:00.000Z"
31
+ }
32
+ }
33
+ }
34
+ }
@@ -0,0 +1,34 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "dash273:cross-rooftop-target",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_00000000-0000-4000-8000-000000000999",
6
+ "traceId": "trace-cross-rooftop-target",
7
+ "occurredAt": "2026-09-03T13:45:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_messaging_dynamodb",
11
+ "eventId": "01K4A3X8J7Q9B2YH6T5WCMNVPA",
12
+ "eventVersion": "1"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam-customers-service",
17
+ "customerExternalId": "customer-123"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "customer_activity",
22
+ "interaction": {
23
+ "kind": "sms",
24
+ "channel": "sms",
25
+ "direction": "inbound",
26
+ "senderType": "customer",
27
+ "lineType": "rooftop",
28
+ "dynamoLocator": {
29
+ "partitionKey": "DEALER#clone_aeef094b-616c-48fd-aefa-768eab85212c#FROM#+15551234567",
30
+ "sortKey": "MSG#01K4A3X8J7Q9B2YH6T5WCMNVPA"
31
+ }
32
+ }
33
+ }
34
+ }
@@ -0,0 +1,34 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "sms:d4d33fc88be2ece802758bfd7bd38f8028aeda050987dc37abcdc62ab754a9da",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "sms:conflicting-record",
7
+ "occurredAt": "2026-09-03T13:46:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_messaging_dynamodb",
11
+ "eventId": "conflicting-record",
12
+ "eventVersion": "1"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam-customers-service",
17
+ "customerExternalId": "customer-123"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "customer_activity",
22
+ "interaction": {
23
+ "kind": "sms",
24
+ "channel": "sms",
25
+ "direction": "inbound",
26
+ "senderType": "customer",
27
+ "lineType": "rooftop",
28
+ "dynamoLocator": {
29
+ "partitionKey": "DEALER#clone_aeef094b-616c-48fd-aefa-768eab85212c#FROM#+15551234567",
30
+ "sortKey": "MSG#conflicting-record"
31
+ }
32
+ }
33
+ }
34
+ }
@@ -0,0 +1,44 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "ordo:ro:dfd927e310f16012e6313c1991ba2da26c7fc65a3ec5ef9ef375aaed28402f8f",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "ordo:ro:dfd927e310f16012e6313c1991ba2da26c7fc65a3ec5ef9ef375aaed28402f8f",
7
+ "occurredAt": "2026-09-05T12:00:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_customers_service",
11
+ "eventId": "ordo:ro:dfd927e310f16012e6313c1991ba2da26c7fc65a3ec5ef9ef375aaed28402f8f",
12
+ "eventVersion": "2"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam_customers_service",
17
+ "customerExternalId": "00000000-0000-4000-8000-000000000001"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "repair_order_transition",
22
+ "interaction": { "kind": "ro_event", "direction": "internal", "senderType": "system" },
23
+ "repairOrder": {
24
+ "transition": "RO_CLOSED",
25
+ "sourceSystem": "pam_customers_service",
26
+ "externalId": "00000000-0000-4000-8000-000000000002",
27
+ "acceptedSource": {
28
+ "revision": "2",
29
+ "customerId": "00000000-0000-4000-8000-000000000001",
30
+ "advisorUserId": null,
31
+ "sourceEventId": "nexus-status-close-002",
32
+ "sourceOccurredAt": "2026-09-05T12:00:00.000Z",
33
+ "acceptedAt": "2026-09-05T12:00:01.000Z",
34
+ "provenance": {
35
+ "system": "nexus",
36
+ "dealerId": "synthetic-dealer",
37
+ "repairOrderId": "synthetic-ro-external",
38
+ "statusUpdateId": "nexus-status-close-002",
39
+ "originalStatus": "READY_FOR_PICKUP"
40
+ }
41
+ }
42
+ }
43
+ }
44
+ }
@@ -0,0 +1,44 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "ordo:ro:2ecb6bccc6bdd552bd7f7aca75d77eaf15f509297ab03e5ece9e4d7f42c517d3",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "ordo:ro:2ecb6bccc6bdd552bd7f7aca75d77eaf15f509297ab03e5ece9e4d7f42c517d3",
7
+ "occurredAt": "2026-09-05T13:00:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_customers_service",
11
+ "eventId": "ordo:ro:2ecb6bccc6bdd552bd7f7aca75d77eaf15f509297ab03e5ece9e4d7f42c517d3",
12
+ "eventVersion": "3"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam_customers_service",
17
+ "customerExternalId": "00000000-0000-4000-8000-000000000001"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "repair_order_transition",
22
+ "interaction": { "kind": "ro_event", "direction": "internal", "senderType": "system" },
23
+ "repairOrder": {
24
+ "transition": "RO_OPENED",
25
+ "sourceSystem": "pam_customers_service",
26
+ "externalId": "00000000-0000-4000-8000-000000000002",
27
+ "acceptedSource": {
28
+ "revision": "3",
29
+ "customerId": "00000000-0000-4000-8000-000000000001",
30
+ "advisorUserId": "user-advisor-2",
31
+ "sourceEventId": "nexus-status-conflict-003",
32
+ "sourceOccurredAt": "2026-09-05T13:00:00.000Z",
33
+ "acceptedAt": "2026-09-05T13:00:02.000Z",
34
+ "provenance": {
35
+ "system": "nexus",
36
+ "dealerId": "synthetic-dealer",
37
+ "repairOrderId": "synthetic-ro-external",
38
+ "statusUpdateId": "nexus-status-conflict-003",
39
+ "originalStatus": "CHECKED_IN"
40
+ }
41
+ }
42
+ }
43
+ }
44
+ }
@@ -0,0 +1,44 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "ordo:ro:71846f73c84962d4808377c61dc4cedaee4a5fb4d416be32636e5e140e520c8e",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "ordo:ro:71846f73c84962d4808377c61dc4cedaee4a5fb4d416be32636e5e140e520c8e",
7
+ "occurredAt": "2026-09-05T10:00:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_customers_service",
11
+ "eventId": "ordo:ro:71846f73c84962d4808377c61dc4cedaee4a5fb4d416be32636e5e140e520c8e",
12
+ "eventVersion": "1"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam_customers_service",
17
+ "customerExternalId": "00000000-0000-4000-8000-000000000001"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "repair_order_transition",
22
+ "interaction": { "kind": "ro_event", "direction": "internal", "senderType": "system" },
23
+ "repairOrder": {
24
+ "transition": "RO_OPENED",
25
+ "sourceSystem": "pam_customers_service",
26
+ "externalId": "00000000-0000-4000-8000-000000000002",
27
+ "acceptedSource": {
28
+ "revision": "1",
29
+ "customerId": "00000000-0000-4000-8000-000000000001",
30
+ "advisorUserId": "user-advisor-1",
31
+ "sourceEventId": "nexus-status-open-001",
32
+ "sourceOccurredAt": "2026-09-05T10:00:00.000Z",
33
+ "acceptedAt": "2026-09-05T10:00:01.000Z",
34
+ "provenance": {
35
+ "system": "nexus",
36
+ "dealerId": "synthetic-dealer",
37
+ "repairOrderId": "synthetic-ro-external",
38
+ "statusUpdateId": "nexus-status-open-001",
39
+ "originalStatus": "CHECKED_IN"
40
+ }
41
+ }
42
+ }
43
+ }
44
+ }
@@ -0,0 +1,44 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "ordo:ro:239037e50ba8b11593243cc82fce0036a7803a4ab1956620563abe787b207e9f",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "ordo:ro:239037e50ba8b11593243cc82fce0036a7803a4ab1956620563abe787b207e9f",
7
+ "occurredAt": "2026-09-05T13:00:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_customers_service",
11
+ "eventId": "ordo:ro:239037e50ba8b11593243cc82fce0036a7803a4ab1956620563abe787b207e9f",
12
+ "eventVersion": "3"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam_customers_service",
17
+ "customerExternalId": "00000000-0000-4000-8000-000000000001"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "repair_order_transition",
22
+ "interaction": { "kind": "ro_event", "direction": "internal", "senderType": "system" },
23
+ "repairOrder": {
24
+ "transition": "RO_OPENED",
25
+ "sourceSystem": "pam_customers_service",
26
+ "externalId": "00000000-0000-4000-8000-000000000002",
27
+ "acceptedSource": {
28
+ "revision": "3",
29
+ "customerId": "00000000-0000-4000-8000-000000000001",
30
+ "advisorUserId": "user-advisor-2",
31
+ "sourceEventId": "nexus-status-reopen-003",
32
+ "sourceOccurredAt": "2026-09-05T13:00:00.000Z",
33
+ "acceptedAt": "2026-09-05T13:00:01.000Z",
34
+ "provenance": {
35
+ "system": "nexus",
36
+ "dealerId": "synthetic-dealer",
37
+ "repairOrderId": "synthetic-ro-external",
38
+ "statusUpdateId": "nexus-status-reopen-003",
39
+ "originalStatus": "IN_PROGRESS"
40
+ }
41
+ }
42
+ }
43
+ }
44
+ }
@@ -0,0 +1,34 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "sms:d4d33fc88be2ece802758bfd7bd38f8028aeda050987dc37abcdc62ab754a9da",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "sms:01K4A3X8J7Q9B2YH6T5WCMNVPA",
7
+ "occurredAt": "2026-09-03T13:45:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_messaging_dynamodb",
11
+ "eventId": "01K4A3X8J7Q9B2YH6T5WCMNVPA",
12
+ "eventVersion": "1"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam-customers-service",
17
+ "customerExternalId": "customer-123"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "customer_activity",
22
+ "interaction": {
23
+ "kind": "sms",
24
+ "channel": "sms",
25
+ "direction": "inbound",
26
+ "senderType": "customer",
27
+ "lineType": "rooftop",
28
+ "dynamoLocator": {
29
+ "partitionKey": "DEALER#clone_aeef094b-616c-48fd-aefa-768eab85212c#FROM#+15551234567",
30
+ "sortKey": "MSG#01K4A3X8J7Q9B2YH6T5WCMNVPA"
31
+ }
32
+ }
33
+ }
34
+ }
@@ -0,0 +1,34 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "sms:af6e12bd9f597d46d262d2c8501674a973ffcae28e6effd326009f0f05366796",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "sms:01K4A3X8J7Q9B2YH6T5WCMNVPB",
7
+ "occurredAt": "2026-09-03T13:40:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_messaging_dynamodb",
11
+ "eventId": "01K4A3X8J7Q9B2YH6T5WCMNVPB",
12
+ "eventVersion": "1"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam-customers-service",
17
+ "customerExternalId": "customer-123"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "customer_activity",
22
+ "interaction": {
23
+ "kind": "sms",
24
+ "channel": "sms",
25
+ "direction": "inbound",
26
+ "senderType": "customer",
27
+ "lineType": "rooftop",
28
+ "dynamoLocator": {
29
+ "partitionKey": "DEALER#clone_aeef094b-616c-48fd-aefa-768eab85212c#FROM#+15551234567",
30
+ "sortKey": "MSG#01K4A3X8J7Q9B2YH6T5WCMNVPB"
31
+ }
32
+ }
33
+ }
34
+ }
@@ -0,0 +1,34 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "sms:126560deda94f895c00949bd94336ed8ad6cba47aac66612f541b9e08d6983d4",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "sms:01K4A3X8J7Q9B2YH6T5WCMNVPP",
7
+ "occurredAt": "2026-09-03T13:50:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_messaging_dynamodb",
11
+ "eventId": "01K4A3X8J7Q9B2YH6T5WCMNVPP",
12
+ "eventVersion": "1"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam-customers-service",
17
+ "customerExternalId": "customer-123"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "approved_customer_response",
22
+ "interaction": {
23
+ "kind": "sms",
24
+ "channel": "sms",
25
+ "direction": "outbound",
26
+ "senderType": "pam",
27
+ "lineType": "rooftop",
28
+ "dynamoLocator": {
29
+ "partitionKey": "DEALER#clone_aeef094b-616c-48fd-aefa-768eab85212c#FROM#+15551234567",
30
+ "sortKey": "MSG#01K4A3X8J7Q9B2YH6T5WCMNVPP"
31
+ }
32
+ }
33
+ }
34
+ }
@@ -0,0 +1,35 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "operationId": "sms:f6f8def3edb328a477dd4a5d318295360a9a03b3097a2973833b426374472d21",
4
+ "commandType": "work_cycle.source_activity",
5
+ "clientOrgId": "clone_aeef094b-616c-48fd-aefa-768eab85212c",
6
+ "traceId": "sms:01K4A3X8J7Q9B2YH6T5WCMNVPQ",
7
+ "occurredAt": "2026-09-03T13:55:00.000Z",
8
+ "actor": { "type": "source" },
9
+ "source": {
10
+ "system": "pam_messaging_dynamodb",
11
+ "eventId": "01K4A3X8J7Q9B2YH6T5WCMNVPQ",
12
+ "eventVersion": "1"
13
+ },
14
+ "target": {
15
+ "customerIdentity": {
16
+ "customerSourceSystem": "pam-customers-service",
17
+ "customerExternalId": "customer-123"
18
+ }
19
+ },
20
+ "payload": {
21
+ "activityType": "approved_customer_response",
22
+ "interaction": {
23
+ "kind": "sms",
24
+ "channel": "sms",
25
+ "direction": "outbound",
26
+ "senderType": "user",
27
+ "senderUserExternalId": "user-advisor-1",
28
+ "lineType": "rooftop",
29
+ "dynamoLocator": {
30
+ "partitionKey": "DEALER#clone_aeef094b-616c-48fd-aefa-768eab85212c#FROM#+15551234567",
31
+ "sortKey": "MSG#01K4A3X8J7Q9B2YH6T5WCMNVPQ"
32
+ }
33
+ }
34
+ }
35
+ }