@pam-ai/pam-ordo-contracts 3.4.0

package/dist/generated.d.ts

@@ -0,0 +1,1848 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/v1/inbox/conversations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List canonical Inbox Conversations */
+        get: operations["listInboxConversations"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/conversations/{conversationId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get an authorized Conversation detail */
+        get: operations["getInboxConversation"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/conversations/{conversationId}/customer-notes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List active Customer notes through an authorized Conversation */
+        get: operations["listInboxCustomerNotes"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/contacts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 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.
+         */
+        get: operations["searchInboxContacts"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/notifications": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List the authenticated User's visible active notifications */
+        get: operations["listInboxNotifications"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/assign": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Assign the active WorkCycle */
+        post: operations["assignConversation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/snooze": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Snooze the active WorkCycle */
+        post: operations["snoozeConversation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/unsnooze": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Unsnooze the active WorkCycle */
+        post: operations["unsnoozeConversation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/set-reminder": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Set the owner Reminder */
+        post: operations["setConversationReminder"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/clear-reminder": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Clear the owner Reminder */
+        post: operations["clearConversationReminder"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/close": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Close the active WorkCycle */
+        post: operations["closeConversation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/acknowledge-attention": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Record an authorized viewer acknowledgement of active Needs Attention */
+        post: operations["acknowledgeInboxAttention"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/resolve-attention": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Resolve active Needs Attention without closing the WorkCycle */
+        post: operations["resolveInboxAttention"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/add-internal-comment": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Add an internal comment and fan out Mentions on the active WorkCycle */
+        post: operations["addInboxInternalComment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/advance-read-cursor": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Monotonically advance the authenticated viewer's Conversation read cursor */
+        post: operations["advanceInboxReadCursor"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/add-customer-note": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 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.
+         */
+        post: operations["addInboxCustomerNote"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/delete-customer-note": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 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.
+         */
+        post: operations["deleteInboxCustomerNote"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/mark-notification-read": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Mark one recipient-owned notification read */
+        post: operations["markInboxNotificationRead"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inbox/commands/dismiss-notification": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Dismiss one recipient-owned notification and mark it read */
+        post: operations["dismissInboxNotification"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /** @enum {string} */
+        InboxScope: "MY_INBOX" | "TEAM_INBOX" | "MENTIONS" | "CUSTOMERS" | "RO";
+        /** @enum {string} */
+        WorkCycleStatus: "OPEN" | "SNOOZED" | "RESOLVED";
+        /** @enum {string} */
+        AvailabilityState: "available" | "missing" | "stale" | "timeout" | "unauthorized" | "unsupported";
+        Availability: {
+            state: components["schemas"]["AvailabilityState"];
+            source?: string;
+            /** Format: date-time */
+            observedAt?: string;
+            reason?: string;
+        };
+        HydratedText: {
+            value?: string | null;
+            availability: components["schemas"]["Availability"];
+        };
+        HydratedStringList: {
+            value: string[] | null;
+            availability: components["schemas"]["Availability"];
+        };
+        Owner: {
+            userId: string;
+            teamId?: string | null;
+            displayName: components["schemas"]["HydratedText"];
+        };
+        Reminder: {
+            /** Format: uuid */
+            id: string;
+            /** Format: date-time */
+            dueAt: string;
+            note?: string | null;
+            /** @enum {string} */
+            status: "PENDING" | "FIRED" | "CLEARED" | "CANCELLED";
+            version: number;
+        };
+        AttentionSummary: {
+            /** Format: uuid */
+            id: string;
+            category: string;
+            /** @enum {string} */
+            status: "ACTIVE" | "RESOLVED";
+            /** Format: date-time */
+            openedAt: string;
+            version: number;
+        };
+        /** @description Derived read-time Overdue presentation. It is never a mutable lifecycle flag. */
+        OverdueSummary: {
+            isOverdue: boolean;
+            /**
+             * Format: date-time
+             * @description Derived threshold timestamp, or null when no waiting anchor or policy applies.
+             */
+            overdueAt: string | null;
+            /** @description True when a pending owner Reminder suppresses the Overdue badge without erasing waiting history. */
+            presentationSuppressedByReminder: boolean;
+        };
+        /**
+         * @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.
+         * @enum {string}
+         */
+        OrdoCapability: "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";
+        /** @description A configured target for one stable rooftop User identity. */
+        InboxPolicyUserTargetV1: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "USER";
+            userId: string;
+        };
+        /** @description A configured Team target identified by the dashboard user-group ID. The authority resolves this target to concrete eligible Users at use time. */
+        InboxPolicyTeamTargetV1: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "TEAM";
+            dashboardGroupId: string;
+        };
+        /** @description Retain work without an owner while keeping it manager-visible. */
+        InboxPolicyUnassignedTargetV1: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "UNASSIGNED";
+        };
+        InboxPolicyRecipientTargetV1: components["schemas"]["InboxPolicyUserTargetV1"] | components["schemas"]["InboxPolicyTeamTargetV1"];
+        InboxPolicyRoutingTargetV1: components["schemas"]["InboxPolicyUserTargetV1"] | components["schemas"]["InboxPolicyTeamTargetV1"] | components["schemas"]["InboxPolicyUnassignedTargetV1"];
+        InboxPolicyNeedsAttentionV1: {
+            enabled: boolean;
+            recipients: components["schemas"]["InboxPolicyRecipientTargetV1"][];
+        };
+        /** @description Behavior for one producer classification. Legacy escalation tiers are not accepted. */
+        InboxPolicyCategoryV1: {
+            category: string;
+            enabled: boolean;
+            createsWorkCycle: boolean;
+            routing: components["schemas"]["InboxPolicyRoutingTargetV1"];
+            needsAttention: components["schemas"]["InboxPolicyNeedsAttentionV1"];
+        };
+        InboxPolicyOverdueDisabledV1: {
+            /** @constant */
+            enabled: false;
+        };
+        InboxPolicyOverdueEnabledV1: {
+            /** @constant */
+            enabled: true;
+            thresholdMinutes: number;
+        };
+        InboxPolicyOverdueV1: components["schemas"]["InboxPolicyOverdueDisabledV1"] | components["schemas"]["InboxPolicyOverdueEnabledV1"];
+        /** @enum {string} */
+        InboxPolicyNotificationKindV1: "needs_attention" | "overdue" | "ro_opened" | "ro_closed";
+        InboxPolicyNotificationRuleV1: {
+            kind: components["schemas"]["InboxPolicyNotificationKindV1"];
+            enabled: boolean;
+            recipients: components["schemas"]["InboxPolicyRecipientTargetV1"][];
+        };
+        /** @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. */
+        InboxPolicyV1: {
+            /** @constant */
+            schemaVersion: 1;
+            categories: components["schemas"]["InboxPolicyCategoryV1"][];
+            overdue: components["schemas"]["InboxPolicyOverdueV1"];
+            notifications: components["schemas"]["InboxPolicyNotificationRuleV1"][];
+        };
+        /** @enum {string} */
+        InboxAuthorityPersonaV1: "SERVICE_ADVISOR" | "SERVICE_MANAGER" | "BDC_REPRESENTATIVE" | "BDC_MANAGER";
+        InboxTargetResolutionUserV1: {
+            userId: string;
+            persona: components["schemas"]["InboxAuthorityPersonaV1"];
+            capabilities: components["schemas"]["OrdoCapability"][];
+        };
+        /**
+         * @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.
+         * @enum {string}
+         */
+        InboxTargetResolutionStatusV1: "resolved" | "none" | "unavailable" | "ambiguous";
+        InboxTargetResolutionResultV1: {
+            target: components["schemas"]["InboxPolicyRecipientTargetV1"];
+            status: components["schemas"]["InboxTargetResolutionStatusV1"];
+            userIds: string[];
+        };
+        InboxTargetResolutionRequestV1: {
+            /** @constant */
+            schemaVersion: 1;
+            clientOrgId: string;
+            targets: components["schemas"]["InboxPolicyRecipientTargetV1"][];
+        };
+        InboxTargetResolutionResponseV1: {
+            /** @constant */
+            schemaVersion: 1;
+            clientOrgId: string;
+            results: components["schemas"]["InboxTargetResolutionResultV1"][];
+            /** @description Concrete eligible Users, deduplicated across every requested target. */
+            users: components["schemas"]["InboxTargetResolutionUserV1"][];
+        };
+        /** @description Read-time state specific to the authenticated viewer. */
+        ViewerState: {
+            unreadCount: number;
+            /** @description Whether the viewer has active Mentions-view membership for the current WorkCycle. */
+            isMentionWatcher: boolean;
+            unreadMentionCount: number;
+            /**
+             * Format: uuid
+             * @description Latest Interaction the authenticated viewer has read in this Conversation.
+             */
+            readThroughInteractionId?: string | null;
+            /** @description Authoritative Conversation sequence corresponding to readThroughInteractionId. */
+            readThroughSequenceNumber?: number | null;
+        };
+        /** @description Current conversation-wide AI projection; source availability is explicit per field. */
+        AiContext: {
+            summary: components["schemas"]["HydratedText"];
+            categories: components["schemas"]["HydratedStringList"];
+            sentiment: components["schemas"]["HydratedText"];
+            recommendedNextStep: components["schemas"]["HydratedText"];
+        };
+        /** @description Read-time counts and channel indicators for the visible Conversation context. */
+        InteractionSummary: {
+            totalCount: number;
+            inboundCount: number;
+            outboundCount: number;
+            internalCount: number;
+            channels: string[];
+        };
+        /** @enum {string} */
+        AvailableAction: "ASSIGN" | "SNOOZE" | "UNSNOOZE" | "SET_REMINDER" | "CLEAR_REMINDER" | "CLOSE" | "RESOLVE_ATTENTION" | "ADD_INTERNAL_COMMENT";
+        InboxRow: {
+            /** Format: uuid */
+            conversationId: string;
+            clientOrgId: string;
+            customerId: string;
+            workCycle: components["schemas"]["WorkCycleSummary"] | null;
+            owner: components["schemas"]["Owner"] | null;
+            reminder: components["schemas"]["Reminder"] | null;
+            attention: components["schemas"]["AttentionSummary"] | null;
+            overdue: components["schemas"]["OverdueSummary"];
+            /** Format: date-time */
+            latestActivityAt: string;
+            customerDisplayName: 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. */
+            customerPhone?: components["schemas"]["HydratedText"];
+            /** @description Current active RO context only; historical ROs remain customer context. */
+            activeRepairOrders: components["schemas"]["RepairOrderRef"][];
+            aiContext: components["schemas"]["AiContext"];
+            viewerState: components["schemas"]["ViewerState"];
+            interactionSummary: components["schemas"]["InteractionSummary"];
+            availableActions: components["schemas"]["AvailableAction"][];
+            availability: {
+                [key: string]: components["schemas"]["Availability"];
+            };
+        };
+        WorkCycleSummary: {
+            /** Format: uuid */
+            id: string;
+            cycleNumber: number;
+            status: components["schemas"]["WorkCycleStatus"];
+            /** Format: date-time */
+            openedAt: string;
+            /** Format: date-time */
+            oldestUnrespondedAt?: string | null;
+            /** Format: date-time */
+            snoozedAt?: string | null;
+            /** Format: date-time */
+            resolvedAt?: string | null;
+            version: number;
+        };
+        InboxCounts: {
+            total: number;
+            open: number;
+            snoozed: number;
+            overdue: number;
+            needsAttention: number;
+            resolved: number;
+        };
+        /**
+         * @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.
+         * @enum {string}
+         */
+        ContactRelationship: "OWN" | "COLLEAGUE" | "NONE";
+        ContactRow: {
+            customerId: string;
+            /** @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. */
+            customerSourceSystem: string;
+            customerName: components["schemas"]["HydratedText"];
+            customerPhone: components["schemas"]["HydratedText"];
+            vehicleLabel?: components["schemas"]["HydratedText"];
+            /** @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. */
+            openRepairOrder?: components["schemas"]["RepairOrderRef"] | 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. */
+            conversationId: string | null;
+            relationship: components["schemas"]["ContactRelationship"];
+            availability: components["schemas"]["Availability"];
+        };
+        ContactSearchResponse: {
+            data: {
+                contacts: components["schemas"]["ContactRow"][];
+            };
+        };
+        InboxListResponse: {
+            data: {
+                rows: components["schemas"]["InboxRow"][];
+                counts: components["schemas"]["InboxCounts"];
+            };
+            meta: {
+                /** @description Opaque keyset cursor. */
+                nextCursor: string | null;
+            };
+        };
+        InteractionRef: {
+            /** Format: uuid */
+            id: string;
+            /** @description Authenticated User who authored an internal comment; null for non-User senders. */
+            senderUserId?: string | null;
+            /**
+             * Format: uuid
+             * @description Root internal comment referenced by this comment. Replies are flattened to one level.
+             */
+            replyToInteractionId?: string | null;
+            /** @description Immutable recipient-specific Mention events created by this internal comment. */
+            mentions?: components["schemas"]["MentionRef"][];
+            /**
+             * 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.
+             */
+            workCycleId?: string | null;
+            sequenceNumber: number;
+            kind: string;
+            channel?: string | null;
+            /** @enum {string} */
+            direction: "INBOUND" | "OUTBOUND" | "INTERNAL";
+            /** Format: date-time */
+            occurredAt: string;
+            body?: components["schemas"]["HydratedText"] | null;
+            availability: components["schemas"]["Availability"];
+        };
+        MentionRef: {
+            /** Format: uuid */
+            id: string;
+            userId: string;
+            /** Format: date-time */
+            createdAt: string;
+        };
+        VehicleRef: {
+            sourceSystem: string;
+            externalId: string;
+            year: components["schemas"]["HydratedText"];
+            make: components["schemas"]["HydratedText"];
+            model: components["schemas"]["HydratedText"];
+            vin: components["schemas"]["HydratedText"];
+            availability: components["schemas"]["Availability"];
+        };
+        RepairOrderRef: {
+            sourceSystem: string;
+            externalId: string;
+            relationship: string;
+            displayNumber: components["schemas"]["HydratedText"];
+            status: components["schemas"]["HydratedText"];
+            vehicle: components["schemas"]["VehicleRef"] | null;
+            availability: components["schemas"]["Availability"];
+        };
+        ConversationDetailResponse: {
+            data: {
+                /** Format: uuid */
+                conversationId: string;
+                clientOrgId: string;
+                customerId: string;
+                version: number;
+                currentCycle: components["schemas"]["WorkCycleSummary"] | null;
+                owner: components["schemas"]["Owner"] | null;
+                reminder: components["schemas"]["Reminder"] | null;
+                attention: components["schemas"]["AttentionSummary"] | null;
+                overdue: components["schemas"]["OverdueSummary"];
+                customerDisplayName: 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. */
+                customerPhone?: components["schemas"]["HydratedText"];
+                aiContext: components["schemas"]["AiContext"];
+                viewerState: components["schemas"]["ViewerState"];
+                interactionSummary: components["schemas"]["InteractionSummary"];
+                cycles: components["schemas"]["WorkCycleSummary"][];
+                interactions: components["schemas"]["InteractionRef"][];
+                repairOrders: components["schemas"]["RepairOrderRef"][];
+                availableActions: components["schemas"]["AvailableAction"][];
+                availability: {
+                    [key: string]: components["schemas"]["Availability"];
+                };
+            };
+        };
+        /** @description Ordo-owned durable note attached to the Conversation Customer, not to a WorkCycle. */
+        CustomerNote: {
+            /** Format: uuid */
+            id: string;
+            body: string;
+            authorUserId: string;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+            version: number;
+        };
+        CustomerNoteListResponse: {
+            data: {
+                notes: components["schemas"]["CustomerNote"][];
+            };
+            meta: {
+                /** @description Opaque keyset cursor. */
+                nextCursor: string | null;
+            };
+        };
+        /** @enum {string} */
+        NotificationKind: "reminder_due" | "mention" | "internal_comment_reply" | "needs_attention" | "overdue" | "ro_opened" | "ro_closed";
+        /** @description Recipient-specific Ordo alert state. Opening or dismissing it never resolves domain work. */
+        InboxNotification: {
+            /** Format: uuid */
+            id: string;
+            kind: components["schemas"]["NotificationKind"];
+            /** Format: uuid */
+            conversationId: string;
+            /** Format: uuid */
+            workCycleId: string | null;
+            /** Format: uuid */
+            reminderId: string | null;
+            /** Format: uuid */
+            mentionId: string | null;
+            /** Format: uuid */
+            attentionCycleId: string | null;
+            /** Format: uuid */
+            interactionId: string | null;
+            title: string;
+            body: string;
+            payloadVersion: number;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            readAt: string | null;
+        };
+        NotificationListResponse: {
+            data: {
+                notifications: components["schemas"]["InboxNotification"][];
+                unreadCount: number;
+            };
+            meta: {
+                /** @description Opaque keyset cursor. */
+                nextCursor: string | null;
+            };
+        };
+        ProducerSourceV1: {
+            system: string;
+            eventId: string;
+            eventVersion: string;
+        };
+        ProducerConversationTargetV1: {
+            /** Format: uuid */
+            conversationId: string;
+        };
+        ProducerCustomerIdentityV1: {
+            customerSourceSystem: string;
+            customerExternalId: string;
+        };
+        ProducerCustomerTargetV1: {
+            customerIdentity: components["schemas"]["ProducerCustomerIdentityV1"];
+        };
+        ProducerSourceActivityTargetV1: components["schemas"]["ProducerConversationTargetV1"] | components["schemas"]["ProducerCustomerTargetV1"];
+        ProducerInteractionV1: {
+            /** @enum {string} */
+            kind: "sms" | "call" | "voicemail" | "ro_event" | "system_event";
+            channel?: string;
+            /** @enum {string} */
+            direction: "inbound" | "outbound" | "internal";
+            /** @enum {string} */
+            senderType: "customer" | "user" | "pam" | "system";
+            senderUserExternalId?: string;
+            /** @enum {string} */
+            lineType?: "pam" | "rooftop" | "advisor";
+            dynamoLocator?: {
+                partitionKey: string;
+                sortKey: string;
+            };
+        };
+        ProducerRepairOrderTransitionV1: {
+            /** @enum {string} */
+            transition: "RO_OPENED" | "RO_CLOSED";
+            sourceSystem: string;
+            externalId: string;
+        };
+        ProducerCustomerActivityPayloadV1: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            activityType: "customer_activity";
+            interaction: components["schemas"]["ProducerInteractionV1"];
+        };
+        ProducerApprovedResponsePayloadV1: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            activityType: "approved_customer_response";
+            interaction: components["schemas"]["ProducerInteractionV1"];
+        };
+        ProducerInformationalPayloadV1: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            activityType: "informational";
+            interaction: components["schemas"]["ProducerInteractionV1"];
+        };
+        ProducerRepairOrderPayloadV1: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            activityType: "repair_order_transition";
+            interaction: components["schemas"]["ProducerInteractionV1"];
+            repairOrder: components["schemas"]["ProducerRepairOrderTransitionV1"];
+        };
+        ProducerSourceActivityPayloadV1: components["schemas"]["ProducerCustomerActivityPayloadV1"] | components["schemas"]["ProducerApprovedResponsePayloadV1"] | components["schemas"]["ProducerInformationalPayloadV1"] | components["schemas"]["ProducerRepairOrderPayloadV1"];
+        ProducerAttentionRecipientV1: {
+            recipientUserExternalId: string;
+            /** @enum {string} */
+            configuredTargetType: "user" | "group" | "team";
+            configuredTargetExternalId: string;
+            policyVersion?: string;
+            routingSnapshot?: {
+                [key: string]: unknown;
+            };
+        };
+        ProducerAttentionPayloadV1: {
+            /** Format: uuid */
+            workCycleId: string;
+            category: string;
+            /** Format: uuid */
+            interactionRefId?: string;
+            policySnapshot: {
+                [key: string]: unknown;
+            };
+            recipients: components["schemas"]["ProducerAttentionRecipientV1"][];
+        };
+        ProducerReminderFirePayloadV1: {
+            /** Format: uuid */
+            reminderId: string;
+            /** Format: date-time */
+            dueAt: string;
+            expectedReminderVersion: number;
+        };
+        ProducerSnoozeReturnPayloadV1: {
+            /** Format: uuid */
+            workCycleId: string;
+            /** Format: date-time */
+            scheduledFor: string;
+            snoozeOperationId: string;
+        };
+        ProducerOverdueFirePayloadV1: {
+            /** Format: uuid */
+            workCycleId: string;
+            /** Format: date-time */
+            deadline: string;
+            /** Format: date-time */
+            oldestUnrespondedAt: string;
+            recipientUserExternalId: string;
+        };
+        ProducerSourceActivityCommandV1: {
+            /** @constant */
+            schemaVersion: 1;
+            operationId: string;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            commandType: "work_cycle.source_activity";
+            clientOrgId: string;
+            traceId: string;
+            /** Format: date-time */
+            occurredAt: string;
+            actor: {
+                /** @constant */
+                type: "source";
+            };
+            source: components["schemas"]["ProducerSourceV1"];
+            target: components["schemas"]["ProducerSourceActivityTargetV1"];
+            payload: components["schemas"]["ProducerSourceActivityPayloadV1"];
+        };
+        ProducerAttentionCommandV1: {
+            /** @constant */
+            schemaVersion: 1;
+            operationId: string;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            commandType: "attention.open_or_add_evidence";
+            clientOrgId: string;
+            traceId: string;
+            /** Format: date-time */
+            occurredAt: string;
+            actor: {
+                /** @enum {string} */
+                type: "source" | "pam";
+            };
+            source: components["schemas"]["ProducerSourceV1"];
+            target: components["schemas"]["ProducerConversationTargetV1"];
+            payload: components["schemas"]["ProducerAttentionPayloadV1"];
+        };
+        ProducerReminderFireCommandV1: {
+            /** @constant */
+            schemaVersion: 1;
+            operationId: string;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            commandType: "reminder.fire";
+            clientOrgId: string;
+            traceId: string;
+            /** Format: date-time */
+            occurredAt: string;
+            actor: {
+                /** @constant */
+                type: "system";
+            };
+            source: components["schemas"]["ProducerSourceV1"];
+            target: components["schemas"]["ProducerConversationTargetV1"];
+            payload: components["schemas"]["ProducerReminderFirePayloadV1"];
+        };
+        ProducerSnoozeReturnCommandV1: {
+            /** @constant */
+            schemaVersion: 1;
+            operationId: string;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            commandType: "snooze.return";
+            clientOrgId: string;
+            traceId: string;
+            /** Format: date-time */
+            occurredAt: string;
+            actor: {
+                /** @constant */
+                type: "system";
+            };
+            source: components["schemas"]["ProducerSourceV1"];
+            target: components["schemas"]["ProducerConversationTargetV1"];
+            payload: components["schemas"]["ProducerSnoozeReturnPayloadV1"];
+        };
+        ProducerOverdueFireCommandV1: {
+            /** @constant */
+            schemaVersion: 1;
+            operationId: string;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            commandType: "overdue.fire";
+            clientOrgId: string;
+            traceId: string;
+            /** Format: date-time */
+            occurredAt: string;
+            actor: {
+                /** @constant */
+                type: "system";
+            };
+            source: components["schemas"]["ProducerSourceV1"];
+            target: components["schemas"]["ProducerConversationTargetV1"];
+            payload: components["schemas"]["ProducerOverdueFirePayloadV1"];
+        };
+        /** @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. */
+        ProducerCommandV1: components["schemas"]["ProducerSourceActivityCommandV1"] | components["schemas"]["ProducerAttentionCommandV1"] | components["schemas"]["ProducerReminderFireCommandV1"] | components["schemas"]["ProducerSnoozeReturnCommandV1"] | components["schemas"]["ProducerOverdueFireCommandV1"];
+        CommandEnvelope: {
+            operationId: string;
+            clientOrgId: string;
+            /** Format: uuid */
+            conversationId: string;
+            /** Format: uuid */
+            workCycleId: string;
+            expectedVersion: number;
+        };
+        ActiveWorkCycleAppendEnvelope: {
+            operationId: string;
+            clientOrgId: string;
+            /** Format: uuid */
+            conversationId: string;
+            /** Format: uuid */
+            workCycleId: string;
+        };
+        ConversationOperationEnvelope: {
+            operationId: string;
+            clientOrgId: string;
+            /** Format: uuid */
+            conversationId: string;
+        };
+        NotificationCommand: {
+            operationId: string;
+            clientOrgId: string;
+            /** Format: uuid */
+            notificationId: string;
+        };
+        BaseCommand: components["schemas"]["CommandEnvelope"];
+        UserAssignmentTarget: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "USER";
+            userId: string;
+        };
+        /** @description Selects configured Team routing; the resulting owner remains an individual User. */
+        TeamRoutingAssignmentTarget: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "TEAM_ROUTING";
+            teamId: string;
+        };
+        AssignmentTarget: components["schemas"]["UserAssignmentTarget"] | components["schemas"]["TeamRoutingAssignmentTarget"];
+        AssignCommand: components["schemas"]["CommandEnvelope"] & {
+            target: components["schemas"]["AssignmentTarget"];
+        };
+        SnoozeCommand: components["schemas"]["CommandEnvelope"] & {
+            /** Format: date-time */
+            until: string;
+            reason?: string;
+        };
+        SetReminderCommand: components["schemas"]["CommandEnvelope"] & {
+            /** Format: date-time */
+            dueAt: string;
+            note?: string;
+        };
+        CloseCommand: components["schemas"]["CommandEnvelope"] & {
+            /**
+             * @description Optional one-click resolution key. The service uses completed when omitted; other requires a non-blank reason.
+             * @default completed
+             */
+            resolutionKey: string;
+            reason?: string;
+        };
+        AcknowledgeAttentionCommand: components["schemas"]["CommandEnvelope"] & {
+            /** Format: uuid */
+            attentionCycleId: string;
+        };
+        ResolveAttentionCommand: components["schemas"]["CommandEnvelope"] & {
+            /** Format: uuid */
+            attentionCycleId: string;
+            reason?: string;
+        };
+        AddInternalCommentCommand: components["schemas"]["ActiveWorkCycleAppendEnvelope"] & {
+            body: string;
+            mentionedUserIds: string[];
+            /** Format: uuid */
+            replyToInteractionRefId?: string;
+        };
+        AdvanceReadCursorCommand: components["schemas"]["ConversationOperationEnvelope"] & {
+            /** Format: uuid */
+            throughInteractionRefId: string;
+        };
+        AddCustomerNoteCommand: components["schemas"]["ConversationOperationEnvelope"] & {
+            body: string;
+        };
+        DeleteCustomerNoteCommand: components["schemas"]["ConversationOperationEnvelope"] & {
+            /** Format: uuid */
+            noteId: string;
+            expectedNoteVersion: number;
+        };
+        CommandResult: {
+            data: {
+                operationId: string;
+                applied: boolean;
+                replayed: boolean;
+                /** Format: uuid */
+                conversationId: string;
+                /** Format: uuid */
+                workCycleId: string;
+                resultingVersion: number;
+            };
+        };
+        InternalCommentResult: {
+            data: {
+                operationId: string;
+                applied: boolean;
+                replayed: boolean;
+                /** Format: uuid */
+                conversationId: string;
+                /** Format: uuid */
+                workCycleId: string;
+                resultingVersion: number;
+                /** Format: uuid */
+                interactionRefId: string;
+                sequenceNumber: number;
+                mentionCount: number;
+            };
+        };
+        ReadCursorResult: {
+            data: {
+                operationId: string;
+                applied: boolean;
+                replayed: boolean;
+                /** Format: uuid */
+                conversationId: string;
+                /** Format: uuid */
+                lastReadInteractionRefId: string;
+                lastReadSequenceNumber: number;
+            };
+        };
+        CustomerNoteCommandResult: {
+            data: {
+                operationId: string;
+                applied: boolean;
+                replayed: boolean;
+                /** Format: uuid */
+                conversationId: string;
+                /** Format: uuid */
+                noteId: string;
+                resultingNoteVersion: number;
+            };
+        };
+        NotificationCommandResult: {
+            data: {
+                operationId: string;
+                applied: boolean;
+                replayed: boolean;
+                /** Format: uuid */
+                notificationId: string;
+                /** Format: date-time */
+                readAt: string;
+                /** Format: date-time */
+                dismissedAt: string | null;
+            };
+        };
+        ErrorEnvelope: {
+            error: {
+                code: string;
+                message: string;
+                correlationId: string;
+                details?: {
+                    [key: string]: unknown;
+                };
+            };
+        };
+    };
+    responses: {
+        /** @description Applied or idempotently replayed command result. */
+        CommandApplied: {
+            headers: {
+                "x-correlation-id": components["headers"]["CorrelationId"];
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["CommandResult"];
+            };
+        };
+        /** @description Applied or idempotently replayed internal-comment result. */
+        InternalCommentApplied: {
+            headers: {
+                "x-correlation-id": components["headers"]["CorrelationId"];
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["InternalCommentResult"];
+            };
+        };
+        /** @description Applied, replayed, or monotonic no-op read-cursor result. */
+        ReadCursorAdvanced: {
+            headers: {
+                "x-correlation-id": components["headers"]["CorrelationId"];
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ReadCursorResult"];
+            };
+        };
+        /** @description Applied or idempotently replayed Customer-note mutation result. */
+        CustomerNoteCommandApplied: {
+            headers: {
+                "x-correlation-id": components["headers"]["CorrelationId"];
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["CustomerNoteCommandResult"];
+            };
+        };
+        /** @description Applied, replayed, or monotonic no-op notification state result. */
+        NotificationCommandApplied: {
+            headers: {
+                "x-correlation-id": components["headers"]["CorrelationId"];
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["NotificationCommandResult"];
+            };
+        };
+        /** @description Invalid input. */
+        BadRequest: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+        /** @description Missing or invalid dashboard identity. */
+        Unauthorized: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+        /** @description Authenticated but not authorized for rooftop or capability. */
+        Forbidden: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+        /** @description Not found without disclosing unauthorized record existence. */
+        NotFound: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+        /** @description Stale expectedVersion or command conflict; refresh and retry deliberately. */
+        Conflict: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+        /** @description Unexpected service error. */
+        InternalError: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+        /** @description A required upstream authority is temporarily unavailable. */
+        ServiceUnavailable: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+        /** @description Contract route is published but behavior is pending DASH-235 through DASH-237. */
+        NotImplemented: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+    };
+    parameters: {
+        /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+        ClientOrgId: string;
+        ConversationId: string;
+    };
+    requestBodies: {
+        BaseCommand: {
+            content: {
+                "application/json": components["schemas"]["BaseCommand"];
+            };
+        };
+        AssignCommand: {
+            content: {
+                "application/json": components["schemas"]["AssignCommand"];
+            };
+        };
+        SnoozeCommand: {
+            content: {
+                "application/json": components["schemas"]["SnoozeCommand"];
+            };
+        };
+        SetReminderCommand: {
+            content: {
+                "application/json": components["schemas"]["SetReminderCommand"];
+            };
+        };
+        CloseCommand: {
+            content: {
+                "application/json": components["schemas"]["CloseCommand"];
+            };
+        };
+        AcknowledgeAttentionCommand: {
+            content: {
+                "application/json": components["schemas"]["AcknowledgeAttentionCommand"];
+            };
+        };
+        ResolveAttentionCommand: {
+            content: {
+                "application/json": components["schemas"]["ResolveAttentionCommand"];
+            };
+        };
+        AddInternalCommentCommand: {
+            content: {
+                "application/json": components["schemas"]["AddInternalCommentCommand"];
+            };
+        };
+        AdvanceReadCursorCommand: {
+            content: {
+                "application/json": components["schemas"]["AdvanceReadCursorCommand"];
+            };
+        };
+        AddCustomerNoteCommand: {
+            content: {
+                "application/json": components["schemas"]["AddCustomerNoteCommand"];
+            };
+        };
+        DeleteCustomerNoteCommand: {
+            content: {
+                "application/json": components["schemas"]["DeleteCustomerNoteCommand"];
+            };
+        };
+        NotificationCommand: {
+            content: {
+                "application/json": components["schemas"]["NotificationCommand"];
+            };
+        };
+    };
+    headers: {
+        /** @description Stable request correlation identifier. */
+        CorrelationId: string;
+    };
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    listInboxConversations: {
+        parameters: {
+            query: {
+                scope: components["schemas"]["InboxScope"];
+                teamId?: string;
+                tab?: "OPEN" | "SNOOZED" | "OVERDUE" | "NEEDS_ATTENTION" | "RESOLVED";
+                labels?: string[];
+                from?: string;
+                to?: string;
+                query?: string;
+                sort?: "OPERATIONAL_URGENCY" | "LATEST_ACTIVITY";
+                /** @description Opaque keyset cursor. Clients must not decode it. */
+                cursor?: string;
+                limit?: number;
+            };
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Canonical Inbox page. Optional hydration failures never remove a row. */
+            200: {
+                headers: {
+                    "x-correlation-id": components["headers"]["CorrelationId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InboxListResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    getInboxConversation: {
+        parameters: {
+            query?: {
+                cycleId?: string;
+            };
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path: {
+                conversationId: components["parameters"]["ConversationId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Authorized Conversation detail. */
+            200: {
+                headers: {
+                    "x-correlation-id": components["headers"]["CorrelationId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ConversationDetailResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    listInboxCustomerNotes: {
+        parameters: {
+            query?: {
+                /** @description Opaque newest-first keyset cursor. Clients must not decode it. */
+                cursor?: string;
+                limit?: number;
+            };
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path: {
+                conversationId: components["parameters"]["ConversationId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Newest-first page of non-deleted notes for the Conversation Customer. */
+            200: {
+                headers: {
+                    "x-correlation-id": components["headers"]["CorrelationId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomerNoteListResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    searchInboxContacts: {
+        parameters: {
+            query: {
+                /** @description A name fragment, or a telephone number in any format. */
+                query: string;
+                /** @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. */
+                relationship?: "MINE" | "EVERYONE";
+                limit?: number;
+            };
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Matching Customers. A hydration gap degrades a field, never a row. */
+            200: {
+                headers: {
+                    "x-correlation-id": components["headers"]["CorrelationId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ContactSearchResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    listInboxNotifications: {
+        parameters: {
+            query?: {
+                /** @description Opaque newest-first snapshot cursor. Clients must not decode it. */
+                cursor?: string;
+                limit?: number;
+            };
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Newest-first page of visible, undismissed recipient notifications. */
+            200: {
+                headers: {
+                    "x-correlation-id": components["headers"]["CorrelationId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotificationListResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            500: components["responses"]["InternalError"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    assignConversation: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["AssignCommand"];
+        responses: {
+            200: components["responses"]["CommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    snoozeConversation: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["SnoozeCommand"];
+        responses: {
+            200: components["responses"]["CommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    unsnoozeConversation: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["BaseCommand"];
+        responses: {
+            200: components["responses"]["CommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    setConversationReminder: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["SetReminderCommand"];
+        responses: {
+            200: components["responses"]["CommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    clearConversationReminder: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["BaseCommand"];
+        responses: {
+            200: components["responses"]["CommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    closeConversation: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["CloseCommand"];
+        responses: {
+            200: components["responses"]["CommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    acknowledgeInboxAttention: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["AcknowledgeAttentionCommand"];
+        responses: {
+            200: components["responses"]["CommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    resolveInboxAttention: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["ResolveAttentionCommand"];
+        responses: {
+            200: components["responses"]["CommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    addInboxInternalComment: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["AddInternalCommentCommand"];
+        responses: {
+            200: components["responses"]["InternalCommentApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    advanceInboxReadCursor: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["AdvanceReadCursorCommand"];
+        responses: {
+            200: components["responses"]["ReadCursorAdvanced"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    addInboxCustomerNote: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["AddCustomerNoteCommand"];
+        responses: {
+            200: components["responses"]["CustomerNoteCommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    deleteInboxCustomerNote: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["DeleteCustomerNoteCommand"];
+        responses: {
+            200: components["responses"]["CustomerNoteCommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            501: components["responses"]["NotImplemented"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    markInboxNotificationRead: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["NotificationCommand"];
+        responses: {
+            200: components["responses"]["NotificationCommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+    dismissInboxNotification: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Authorized rooftop context. For commands this value must match body.clientOrgId; neither value is trusted without DASH-233 resolution. */
+                "x-client-org-id": components["parameters"]["ClientOrgId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: components["requestBodies"]["NotificationCommand"];
+        responses: {
+            200: components["responses"]["NotificationCommandApplied"];
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            500: components["responses"]["InternalError"];
+            503: components["responses"]["ServiceUnavailable"];
+        };
+    };
+}
+//# sourceMappingURL=generated.d.ts.map