@lssm/lib.communication-spec 3.1.1

package/dist/fixtures/agent-omnichannel.d.ts

@@ -0,0 +1,682 @@
+export * from './agent-omnichannel-primitives.js';
+export declare const communicationDeliveryIntentFixture: {
+    schemaVersion: "1.0.0";
+    deliveryRef: string;
+    deliveryDigest: string;
+    scope: {
+        tenantRef: string;
+        workspaceRef?: string | undefined;
+        spaceRef?: string | undefined;
+        subjectRef: string;
+    };
+    source: {
+        kind: "agent" | "automation" | "notification" | "system";
+        sourceRef: string;
+    };
+    noticeClass?: "mandatory_notice" | "user_selected" | undefined;
+    profile: {
+        ref: string;
+        digest: string;
+        revision: number;
+    };
+    semantic: "calendar_event" | "communication";
+    classificationRefs: {
+        eventRef?: string | undefined;
+        automationRef?: string | undefined;
+        featureRef?: string | undefined;
+        applicationRef?: string | undefined;
+        productRef?: string | undefined;
+    };
+    lifecycleLink?: {
+        schemaVersion: "1.0.0";
+        linkRef: string;
+        profile: {
+            ref: string;
+            digest: string;
+            revision: number;
+        };
+        agentRef: string;
+        applicationRef: string;
+        scope: {
+            tenantRef: string;
+            workspaceRef?: string | undefined;
+            spaceRef?: string | undefined;
+            subjectRef: string;
+        };
+        runRef?: string | undefined;
+        taskRef?: string | undefined;
+        helpRequestRef?: string | undefined;
+        approvalRequestRef?: string | undefined;
+        backgroundResultRef?: string | undefined;
+        canonicalConversation?: {
+            ref: string;
+            digest: string;
+        } | undefined;
+        session?: {
+            ref: string;
+            digest: string;
+            revision: number;
+        } | undefined;
+        correlationRef: string;
+        evidenceRefs: string[];
+    } | undefined;
+    recipientRefs: string[];
+    contentProof: {
+        sha256: string;
+        contentRef: string;
+    };
+    requestedRoutes: {
+        ref: string;
+        digest: string;
+        revision: number;
+    }[];
+    preferenceSet: {
+        ref: string;
+        digest: string;
+        revision: number;
+    };
+    preferenceResolution: {
+        ref: string;
+        digest: string;
+    };
+    consentRefs: string[];
+    policyRefs: string[];
+    approvalRequestRef?: string | undefined;
+    idempotencyKey: string;
+    effectAuthority: "none";
+    createdAt: string;
+    expiresAt: string;
+    evidenceRefs: string[];
+};
+export declare const communicationDeliveryEligibilityFixture: {
+    schemaVersion: "1.0.0";
+    eligibilityRef: string;
+    eligibilityDigest: string;
+    deliveryRef: string;
+    intent: {
+        ref: string;
+        digest: string;
+    };
+    scope: {
+        tenantRef: string;
+        workspaceRef?: string | undefined;
+        spaceRef?: string | undefined;
+        subjectRef: string;
+    };
+    recipientRef: string;
+    route: {
+        ref: string;
+        digest: string;
+        revision: number;
+    };
+    channel: string;
+    semantic: "calendar_event" | "communication";
+    checks: {
+        checkRef: string;
+        category: "calendar_permission" | "connection" | "consent" | "cost" | "email_suppression" | "grant" | "installation_membership" | "policy" | "provider_health" | "push_device" | "quiet_hours" | "rate_limit" | "sms_opt_out" | "telegram_first_contact" | "whatsapp_service_window" | "whatsapp_template";
+        status: "failed" | "not_applicable" | "passed" | "unknown";
+        reasonCodes: string[];
+        evidenceRefs: string[];
+    }[];
+    result: "eligible" | "ineligible" | "unknown";
+    effectAuthority: "none";
+    evaluatedAt: string;
+    expiresAt: string;
+    evidenceRefs: string[];
+};
+export declare const communicationDeliveryProgressFixture: {
+    schemaVersion: "1.0.0";
+    progressRef: string;
+    progressDigest: string;
+    deliveryRef: string;
+    intent: {
+        ref: string;
+        digest: string;
+    };
+    scope: {
+        tenantRef: string;
+        workspaceRef?: string | undefined;
+        spaceRef?: string | undefined;
+        subjectRef: string;
+    };
+    recipientRef: string;
+    attemptRef: string;
+    route: {
+        ref: string;
+        digest: string;
+        revision: number;
+    };
+    status: "ambiguous" | "cancelled" | "delivered" | "dispatched" | "failed" | "policy_blocked" | "provider_accepted" | "queued" | "read";
+    providerReceiptRef?: string | undefined;
+    deliveryReceiptRef?: string | undefined;
+    readReceiptRef?: string | undefined;
+    reconciliation?: {
+        ref: string;
+        digest: string;
+    } | undefined;
+    failureCode?: string | undefined;
+    effectAuthority: "none";
+    occurredAt: string;
+    evidenceRefs: string[];
+};
+export declare const communicationFallbackDecisionFixture: {
+    schemaVersion: "1.0.0";
+    decisionRef: string;
+    fallbackDecisionDigest: string;
+    deliveryRef: string;
+    intent: {
+        ref: string;
+        digest: string;
+    };
+    scope: {
+        tenantRef: string;
+        workspaceRef?: string | undefined;
+        spaceRef?: string | undefined;
+        subjectRef: string;
+    };
+    recipientRef: string;
+    priorAttemptRef?: string | undefined;
+    priorProgress?: {
+        ref: string;
+        digest: string;
+    } | undefined;
+    priorOutcome: "ambiguous" | "definitive_failure" | "not_attempted" | "reconciled_failure";
+    state: "fail_closed" | "not_required" | "selected";
+    consideredRoutes: {
+        route: {
+            ref: string;
+            digest: string;
+            revision: number;
+        };
+        eligibility: "eligible" | "ineligible" | "unknown";
+        eligibilityDecision: {
+            ref: string;
+            digest: string;
+        };
+        reasonCodes: string[];
+    }[];
+    selectedRoute?: {
+        ref: string;
+        digest: string;
+        revision: number;
+    } | undefined;
+    preferenceSet: {
+        ref: string;
+        digest: string;
+        revision: number;
+    };
+    eligibilityDecisions: {
+        ref: string;
+        digest: string;
+    }[];
+    policyRefs: string[];
+    reconciliation: {
+        status: "not_required" | "pending" | "resolved";
+        binding?: {
+            ref: string;
+            digest: string;
+        } | undefined;
+    };
+    effectAuthority: "none";
+    decidedAt: string;
+    evidenceRefs: string[];
+};
+export declare const communicationAgentOmnichannelFixture: {
+    readonly routes: readonly [{
+        schemaVersion: "1.0.0";
+        routeRef: string;
+        revision: number;
+        scope: {
+            tenantRef: string;
+            workspaceRef?: string | undefined;
+            spaceRef?: string | undefined;
+            subjectRef: string;
+        };
+        channel: string;
+        destinationRef: string;
+        connectionRef?: string | undefined;
+        semantic: "calendar_event" | "communication";
+        deliveryMode: "direct" | "durable_in_app";
+        capabilityRefs: string[];
+        evidenceRefs: string[];
+        routeDigest: string;
+    }, {
+        schemaVersion: "1.0.0";
+        routeRef: string;
+        revision: number;
+        scope: {
+            tenantRef: string;
+            workspaceRef?: string | undefined;
+            spaceRef?: string | undefined;
+            subjectRef: string;
+        };
+        channel: string;
+        destinationRef: string;
+        connectionRef?: string | undefined;
+        semantic: "calendar_event" | "communication";
+        deliveryMode: "direct" | "durable_in_app";
+        capabilityRefs: string[];
+        evidenceRefs: string[];
+        routeDigest: string;
+    }];
+    readonly profile: {
+        schemaVersion: "1.0.0";
+        profileRef: string;
+        revision: number;
+        agentRef: string;
+        applicationRef: string;
+        scope: {
+            tenantRef: string;
+            workspaceRef?: string | undefined;
+            spaceRef?: string | undefined;
+            subjectRef: string;
+        };
+        routeBindings: {
+            ref: string;
+            digest: string;
+            revision: number;
+        }[];
+        connectionRefs: string[];
+        preferenceSet: {
+            ref: string;
+            digest: string;
+            revision: number;
+        };
+        policyRefs: string[];
+        evidenceRefs: string[];
+        createdAt: string;
+        updatedAt: string;
+        profileDigest: string;
+    };
+    readonly lifecycleLink: {
+        schemaVersion: "1.0.0";
+        linkRef: string;
+        profile: {
+            ref: string;
+            digest: string;
+            revision: number;
+        };
+        agentRef: string;
+        applicationRef: string;
+        scope: {
+            tenantRef: string;
+            workspaceRef?: string | undefined;
+            spaceRef?: string | undefined;
+            subjectRef: string;
+        };
+        runRef?: string | undefined;
+        taskRef?: string | undefined;
+        helpRequestRef?: string | undefined;
+        approvalRequestRef?: string | undefined;
+        backgroundResultRef?: string | undefined;
+        canonicalConversation?: {
+            ref: string;
+            digest: string;
+        } | undefined;
+        session?: {
+            ref: string;
+            digest: string;
+            revision: number;
+        } | undefined;
+        correlationRef: string;
+        evidenceRefs: string[];
+    };
+    readonly preferences: {
+        schemaVersion: "1.0.0";
+        preferenceSetRef: string;
+        revision: number;
+        scope: {
+            tenantRef: string;
+            workspaceRef?: string | undefined;
+            spaceRef?: string | undefined;
+            subjectRef: string;
+        };
+        target: {
+            kind: "event";
+            ref: string;
+        } | {
+            kind: "automation";
+            ref: string;
+        } | {
+            kind: "feature";
+            ref: string;
+        } | {
+            kind: "application";
+            ref: string;
+        } | {
+            kind: "product";
+            ref: string;
+        } | {
+            kind: "space";
+            ref: string;
+        } | {
+            kind: "person";
+            ref: string;
+        } | {
+            kind: "platform_default";
+            ref: "communication:preference-target:platform-default";
+        };
+        parentPreferenceSetRefs: string[];
+        authority: "preference_only";
+        globalEnabled: boolean;
+        routePreferences: {
+            routeRef: string;
+            channel: string;
+            enabled: boolean;
+            priority: number;
+            consentRef?: string | undefined;
+            quietHours?: {
+                start: string;
+                end: string;
+                timezone: string;
+            } | undefined;
+            digest?: {
+                enabled: boolean;
+                frequency: "daily" | "immediate" | "weekly";
+                deliveryTime?: string | undefined;
+            } | undefined;
+        }[];
+        fallback: {
+            enabled: boolean;
+            orderedRouteRefs: string[];
+            terminalRouteRef?: string | undefined;
+        };
+        updatedAt: string;
+        evidenceRefs: string[];
+        preferenceSetDigest: string;
+    };
+    readonly preferenceResolution: {
+        schemaVersion: "1.0.0";
+        resolutionRef: string;
+        scope: {
+            tenantRef: string;
+            workspaceRef?: string | undefined;
+            spaceRef?: string | undefined;
+            subjectRef: string;
+        };
+        subjectRef: string;
+        evaluatedPreferenceSets: {
+            preferenceSetRef: string;
+            revision: number;
+            digest: string;
+            target: {
+                kind: "event";
+                ref: string;
+            } | {
+                kind: "automation";
+                ref: string;
+            } | {
+                kind: "feature";
+                ref: string;
+            } | {
+                kind: "application";
+                ref: string;
+            } | {
+                kind: "product";
+                ref: string;
+            } | {
+                kind: "space";
+                ref: string;
+            } | {
+                kind: "person";
+                ref: string;
+            } | {
+                kind: "platform_default";
+                ref: "communication:preference-target:platform-default";
+            };
+        }[];
+        winningPreferenceSetRef: string;
+        winningTarget: {
+            kind: "event";
+            ref: string;
+        } | {
+            kind: "automation";
+            ref: string;
+        } | {
+            kind: "feature";
+            ref: string;
+        } | {
+            kind: "application";
+            ref: string;
+        } | {
+            kind: "product";
+            ref: string;
+        } | {
+            kind: "space";
+            ref: string;
+        } | {
+            kind: "person";
+            ref: string;
+        } | {
+            kind: "platform_default";
+            ref: "communication:preference-target:platform-default";
+        };
+        authority: "preference_only";
+        effectAuthority: "none";
+        resolvedAt: string;
+        evidenceRefs: string[];
+        resolutionDigest: string;
+    };
+    readonly deliveryIntent: {
+        schemaVersion: "1.0.0";
+        deliveryRef: string;
+        deliveryDigest: string;
+        scope: {
+            tenantRef: string;
+            workspaceRef?: string | undefined;
+            spaceRef?: string | undefined;
+            subjectRef: string;
+        };
+        source: {
+            kind: "agent" | "automation" | "notification" | "system";
+            sourceRef: string;
+        };
+        noticeClass?: "mandatory_notice" | "user_selected" | undefined;
+        profile: {
+            ref: string;
+            digest: string;
+            revision: number;
+        };
+        semantic: "calendar_event" | "communication";
+        classificationRefs: {
+            eventRef?: string | undefined;
+            automationRef?: string | undefined;
+            featureRef?: string | undefined;
+            applicationRef?: string | undefined;
+            productRef?: string | undefined;
+        };
+        lifecycleLink?: {
+            schemaVersion: "1.0.0";
+            linkRef: string;
+            profile: {
+                ref: string;
+                digest: string;
+                revision: number;
+            };
+            agentRef: string;
+            applicationRef: string;
+            scope: {
+                tenantRef: string;
+                workspaceRef?: string | undefined;
+                spaceRef?: string | undefined;
+                subjectRef: string;
+            };
+            runRef?: string | undefined;
+            taskRef?: string | undefined;
+            helpRequestRef?: string | undefined;
+            approvalRequestRef?: string | undefined;
+            backgroundResultRef?: string | undefined;
+            canonicalConversation?: {
+                ref: string;
+                digest: string;
+            } | undefined;
+            session?: {
+                ref: string;
+                digest: string;
+                revision: number;
+            } | undefined;
+            correlationRef: string;
+            evidenceRefs: string[];
+        } | undefined;
+        recipientRefs: string[];
+        contentProof: {
+            sha256: string;
+            contentRef: string;
+        };
+        requestedRoutes: {
+            ref: string;
+            digest: string;
+            revision: number;
+        }[];
+        preferenceSet: {
+            ref: string;
+            digest: string;
+            revision: number;
+        };
+        preferenceResolution: {
+            ref: string;
+            digest: string;
+        };
+        consentRefs: string[];
+        policyRefs: string[];
+        approvalRequestRef?: string | undefined;
+        idempotencyKey: string;
+        effectAuthority: "none";
+        createdAt: string;
+        expiresAt: string;
+        evidenceRefs: string[];
+    };
+    readonly eligibility: {
+        schemaVersion: "1.0.0";
+        eligibilityRef: string;
+        eligibilityDigest: string;
+        deliveryRef: string;
+        intent: {
+            ref: string;
+            digest: string;
+        };
+        scope: {
+            tenantRef: string;
+            workspaceRef?: string | undefined;
+            spaceRef?: string | undefined;
+            subjectRef: string;
+        };
+        recipientRef: string;
+        route: {
+            ref: string;
+            digest: string;
+            revision: number;
+        };
+        channel: string;
+        semantic: "calendar_event" | "communication";
+        checks: {
+            checkRef: string;
+            category: "calendar_permission" | "connection" | "consent" | "cost" | "email_suppression" | "grant" | "installation_membership" | "policy" | "provider_health" | "push_device" | "quiet_hours" | "rate_limit" | "sms_opt_out" | "telegram_first_contact" | "whatsapp_service_window" | "whatsapp_template";
+            status: "failed" | "not_applicable" | "passed" | "unknown";
+            reasonCodes: string[];
+            evidenceRefs: string[];
+        }[];
+        result: "eligible" | "ineligible" | "unknown";
+        effectAuthority: "none";
+        evaluatedAt: string;
+        expiresAt: string;
+        evidenceRefs: string[];
+    };
+    readonly progress: {
+        schemaVersion: "1.0.0";
+        progressRef: string;
+        progressDigest: string;
+        deliveryRef: string;
+        intent: {
+            ref: string;
+            digest: string;
+        };
+        scope: {
+            tenantRef: string;
+            workspaceRef?: string | undefined;
+            spaceRef?: string | undefined;
+            subjectRef: string;
+        };
+        recipientRef: string;
+        attemptRef: string;
+        route: {
+            ref: string;
+            digest: string;
+            revision: number;
+        };
+        status: "ambiguous" | "cancelled" | "delivered" | "dispatched" | "failed" | "policy_blocked" | "provider_accepted" | "queued" | "read";
+        providerReceiptRef?: string | undefined;
+        deliveryReceiptRef?: string | undefined;
+        readReceiptRef?: string | undefined;
+        reconciliation?: {
+            ref: string;
+            digest: string;
+        } | undefined;
+        failureCode?: string | undefined;
+        effectAuthority: "none";
+        occurredAt: string;
+        evidenceRefs: string[];
+    };
+    readonly fallbackDecision: {
+        schemaVersion: "1.0.0";
+        decisionRef: string;
+        fallbackDecisionDigest: string;
+        deliveryRef: string;
+        intent: {
+            ref: string;
+            digest: string;
+        };
+        scope: {
+            tenantRef: string;
+            workspaceRef?: string | undefined;
+            spaceRef?: string | undefined;
+            subjectRef: string;
+        };
+        recipientRef: string;
+        priorAttemptRef?: string | undefined;
+        priorProgress?: {
+            ref: string;
+            digest: string;
+        } | undefined;
+        priorOutcome: "ambiguous" | "definitive_failure" | "not_attempted" | "reconciled_failure";
+        state: "fail_closed" | "not_required" | "selected";
+        consideredRoutes: {
+            route: {
+                ref: string;
+                digest: string;
+                revision: number;
+            };
+            eligibility: "eligible" | "ineligible" | "unknown";
+            eligibilityDecision: {
+                ref: string;
+                digest: string;
+            };
+            reasonCodes: string[];
+        }[];
+        selectedRoute?: {
+            ref: string;
+            digest: string;
+            revision: number;
+        } | undefined;
+        preferenceSet: {
+            ref: string;
+            digest: string;
+            revision: number;
+        };
+        eligibilityDecisions: {
+            ref: string;
+            digest: string;
+        }[];
+        policyRefs: string[];
+        reconciliation: {
+            status: "not_required" | "pending" | "resolved";
+            binding?: {
+                ref: string;
+                digest: string;
+            } | undefined;
+        };
+        effectAuthority: "none";
+        decidedAt: string;
+        evidenceRefs: string[];
+    };
+};