@xfey/tutti 0.1.103 → 0.1.104

package/node_modules/@tutti/shared/dist/schemas/internal/platform-integration.js

@@ -0,0 +1,516 @@
+import { Type } from "@sinclair/typebox";
+import { Value } from "@sinclair/typebox/value";
+import { IdempotencyKeySchema, IsoDateTimeStringSchema, MessageIdSchema, RelayAccountRefSchema, RelayProjectRefSchema, } from "../domain/index.js";
+export const PlatformAdapterKeySchema = Type.String({
+    minLength: 1,
+    maxLength: 64,
+    pattern: "^[a-z][a-z0-9_-]*$",
+});
+export const IntegrationOwnedRefSchema = Type.String({
+    minLength: 1,
+    maxLength: 256,
+    pattern: "^[^\\u0000-\\u001f\\u007f]+$",
+});
+export const ExternalObjectRefSchema = Type.String({
+    minLength: 1,
+    maxLength: 512,
+    pattern: "^[^\\u0000-\\u001f\\u007f]+$",
+});
+export const PlatformInstallationLocatorSchema = Type.Object({
+    platform: PlatformAdapterKeySchema,
+    installation_ref: IntegrationOwnedRefSchema,
+}, { additionalProperties: false });
+export const PlatformConversationLocatorSchema = Type.Object({
+    installation: PlatformInstallationLocatorSchema,
+    conversation_ref: ExternalObjectRefSchema,
+    thread_ref: Type.Optional(ExternalObjectRefSchema),
+    parent_message_ref: Type.Optional(ExternalObjectRefSchema),
+}, { additionalProperties: false });
+export const ExternalMessageLocatorSchema = Type.Object({
+    conversation: PlatformConversationLocatorSchema,
+    message_ref: ExternalObjectRefSchema,
+}, { additionalProperties: false });
+export const ExternalSubjectLocatorSchema = Type.Object({
+    installation: PlatformInstallationLocatorSchema,
+    subject_kind: Type.Union([
+        Type.Literal("human"),
+        Type.Literal("bot"),
+        Type.Literal("app"),
+        Type.Literal("system"),
+    ]),
+    subject_ref: ExternalObjectRefSchema,
+}, { additionalProperties: false });
+export const TrustedHumanIntegrationActorContextSchema = Type.Object({
+    kind: Type.Literal("human"),
+    account_ref: RelayAccountRefSchema,
+    display_name: Type.String({ minLength: 1, maxLength: 256 }),
+    membership: Type.Object({
+        relay_project_ref: RelayProjectRefSchema,
+        label: Type.Union([Type.Literal("owner"), Type.Literal("member")]),
+    }, { additionalProperties: false }),
+    channel: Type.Union([
+        Type.Literal("platform_chat"),
+        Type.Literal("platform_h5"),
+        Type.Literal("platform_card_callback"),
+    ]),
+    external_subject: ExternalSubjectLocatorSchema,
+    binding_ref: IntegrationOwnedRefSchema,
+    verified_at: IsoDateTimeStringSchema,
+}, { additionalProperties: false });
+export const TrustedSystemIntegrationActorContextSchema = Type.Object({
+    kind: Type.Literal("system"),
+    purpose: Type.Union([
+        Type.Literal("live_ingestion"),
+        Type.Literal("history_backfill"),
+        Type.Literal("revision_observation"),
+        Type.Literal("attachment_handoff"),
+        Type.Literal("projection_retry"),
+        Type.Literal("reconciliation"),
+    ]),
+    installation: PlatformInstallationLocatorSchema,
+    binding_ref: Type.Optional(IntegrationOwnedRefSchema),
+    verified_at: IsoDateTimeStringSchema,
+}, { additionalProperties: false });
+export const TrustedIntegrationActorContextSchema = Type.Union([
+    TrustedHumanIntegrationActorContextSchema,
+    TrustedSystemIntegrationActorContextSchema,
+]);
+export const NormalizedConversationAuthorSchema = Type.Object({
+    account_ref: RelayAccountRefSchema,
+    display_name: Type.String({ minLength: 1, maxLength: 256 }),
+    external_subject: ExternalSubjectLocatorSchema,
+}, { additionalProperties: false });
+export const PreIdentityConversationAuthorSchema = Type.Object({
+    external_subject: ExternalSubjectLocatorSchema,
+}, { additionalProperties: false });
+export const NormalizedConversationMentionSchema = Type.Object({
+    external_subject: ExternalSubjectLocatorSchema,
+    account_ref: Type.Optional(RelayAccountRefSchema),
+    display_text: Type.Optional(Type.String({ minLength: 1, maxLength: 256 })),
+    target_kind: Type.Union([Type.Literal("person"), Type.Literal("tutti")]),
+}, { additionalProperties: false });
+export const NormalizedConversationContentSchema = Type.Union([
+    Type.Object({
+        kind: Type.Literal("text"),
+        text: Type.String({ minLength: 1, maxLength: 100_000 }),
+        mentions: Type.Array(NormalizedConversationMentionSchema, { maxItems: 128 }),
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("post"),
+        text: Type.String({ minLength: 1, maxLength: 100_000 }),
+        mentions: Type.Array(NormalizedConversationMentionSchema, { maxItems: 128 }),
+    }, { additionalProperties: false }),
+]);
+export const ExternalAttachmentDescriptorSchema = Type.Object({
+    attachment_ref: ExternalObjectRefSchema,
+    attachment_kind: Type.Union([
+        Type.Literal("file"),
+        Type.Literal("image"),
+        Type.Literal("audio"),
+        Type.Literal("video"),
+        Type.Literal("other"),
+    ]),
+    file_name: Type.Optional(Type.String({ minLength: 1, maxLength: 512 })),
+    media_type: Type.Optional(Type.String({ minLength: 1, maxLength: 255 })),
+    declared_size_bytes: Type.Optional(Type.Integer({ minimum: 0, maximum: Number.MAX_SAFE_INTEGER })),
+}, { additionalProperties: false });
+export const VerifiedAttachmentContentMetadataSchema = Type.Object({
+    attachment: ExternalAttachmentDescriptorSchema,
+    size_bytes: Type.Integer({ minimum: 0, maximum: Number.MAX_SAFE_INTEGER }),
+    sha256: Type.String({ pattern: "^sha256:[0-9a-f]{64}$" }),
+    media_type: Type.String({ minLength: 1, maxLength: 255 }),
+    verified_at: IsoDateTimeStringSchema,
+}, { additionalProperties: false });
+export const NormalizedConversationSourceSchema = Type.Object({
+    locator: ExternalMessageLocatorSchema,
+    revision_ref: ExternalObjectRefSchema,
+    author: NormalizedConversationAuthorSchema,
+    content: NormalizedConversationContentSchema,
+    attachments: Type.Array(ExternalAttachmentDescriptorSchema, { maxItems: 64 }),
+    external_created_at: IsoDateTimeStringSchema,
+    observed_at: IsoDateTimeStringSchema,
+    adapter_version: Type.String({ minLength: 1, maxLength: 128 }),
+}, { additionalProperties: false });
+export const PreIdentityNormalizedConversationSourceSchema = Type.Object({
+    locator: ExternalMessageLocatorSchema,
+    revision_ref: ExternalObjectRefSchema,
+    author: PreIdentityConversationAuthorSchema,
+    content: NormalizedConversationContentSchema,
+    attachments: Type.Array(ExternalAttachmentDescriptorSchema, { maxItems: 64 }),
+    external_created_at: IsoDateTimeStringSchema,
+    observed_at: IsoDateTimeStringSchema,
+    adapter_version: Type.String({ minLength: 1, maxLength: 128 }),
+}, { additionalProperties: false });
+export const ExternalConversationRevisionObservationSchema = Type.Union([
+    Type.Object({
+        kind: Type.Literal("edited"),
+        locator: ExternalMessageLocatorSchema,
+        revision_ref: ExternalObjectRefSchema,
+        content: NormalizedConversationContentSchema,
+        attachments: Type.Array(ExternalAttachmentDescriptorSchema, { maxItems: 64 }),
+        external_updated_at: IsoDateTimeStringSchema,
+        observed_at: IsoDateTimeStringSchema,
+        adapter_version: Type.String({ minLength: 1, maxLength: 128 }),
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("deleted"),
+        locator: ExternalMessageLocatorSchema,
+        revision_ref: ExternalObjectRefSchema,
+        external_updated_at: IsoDateTimeStringSchema,
+        observed_at: IsoDateTimeStringSchema,
+        adapter_version: Type.String({ minLength: 1, maxLength: 128 }),
+    }, { additionalProperties: false }),
+]);
+export const InboundIntegrationEventReceiptSchema = Type.Object({
+    receipt_key: IntegrationOwnedRefSchema,
+    installation: PlatformInstallationLocatorSchema,
+    external_event_ref: ExternalObjectRefSchema,
+    event_kind: Type.Union([
+        Type.Literal("conversation_source"),
+        Type.Literal("conversation_revision"),
+        Type.Literal("attachment"),
+        Type.Literal("card_action"),
+    ]),
+    received_at: IsoDateTimeStringSchema,
+    attempt: Type.Integer({ minimum: 1, maximum: 1_000_000 }),
+}, { additionalProperties: false });
+export const ConversationSourceIngestionEnvelopeSchema = Type.Object({
+    kind: Type.Literal("conversation_source"),
+    receipt: InboundIntegrationEventReceiptSchema,
+    actor: TrustedSystemIntegrationActorContextSchema,
+    source: NormalizedConversationSourceSchema,
+}, { additionalProperties: false });
+export const ConversationRevisionIngestionEnvelopeSchema = Type.Object({
+    kind: Type.Literal("conversation_revision"),
+    receipt: InboundIntegrationEventReceiptSchema,
+    actor: TrustedSystemIntegrationActorContextSchema,
+    observation: ExternalConversationRevisionObservationSchema,
+}, { additionalProperties: false });
+export const ConversationIngestionEnvelopeSchema = Type.Union([
+    ConversationSourceIngestionEnvelopeSchema,
+    ConversationRevisionIngestionEnvelopeSchema,
+]);
+export const IntegrationDeliveryDispositionSchema = Type.Union([
+    Type.Object({ kind: Type.Literal("created"), message_id: MessageIdSchema }, { additionalProperties: false }),
+    Type.Object({ kind: Type.Literal("duplicate"), message_id: MessageIdSchema }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("revision_recorded"),
+        message_id: MessageIdSchema,
+        revision_ref: ExternalObjectRefSchema,
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("stale_revision"),
+        message_id: MessageIdSchema,
+        revision_ref: ExternalObjectRefSchema,
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("unsupported"),
+        reason_code: Type.String({ minLength: 1, maxLength: 128 }),
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("unauthorized"),
+        reason_code: Type.Optional(Type.String({ minLength: 1, maxLength: 128 })),
+    }, { additionalProperties: false }),
+    Type.Object({ kind: Type.Literal("binding_missing") }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("host_unavailable"),
+        retryable: Type.Literal(true),
+        reason_code: Type.Optional(Type.String({ minLength: 1, maxLength: 128 })),
+        retry_after: Type.Optional(IsoDateTimeStringSchema),
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("host_incompatible"),
+        retryable: Type.Literal(true),
+        reason_code: Type.Literal("integration_source_ingestion_unsupported"),
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("invalid"),
+        reason_code: Type.String({ minLength: 1, maxLength: 128 }),
+    }, { additionalProperties: false }),
+]);
+export const IntegrationConversationSourceDeliveryRequestSchema = Type.Object({
+    protocol_version: Type.Literal(2),
+    command_id: IdempotencyKeySchema,
+    relay_project_ref: RelayProjectRefSchema,
+    binding_ref: IntegrationOwnedRefSchema,
+    receipt: InboundIntegrationEventReceiptSchema,
+    source: PreIdentityNormalizedConversationSourceSchema,
+}, { additionalProperties: false });
+export const FEISHU_CONVERSATION_PAIRING_CODE_LENGTH = 20;
+export const FeishuConversationPairingCodeSchema = Type.String({
+    minLength: FEISHU_CONVERSATION_PAIRING_CODE_LENGTH,
+    maxLength: FEISHU_CONVERSATION_PAIRING_CODE_LENGTH,
+    pattern: "^[A-Z2-7]+$",
+});
+export const FeishuSetupProjectionSchema = Type.Union([
+    Type.Object({ state: Type.Literal("account_handoff_required") }, { additionalProperties: false }),
+    Type.Object({
+        state: Type.Literal("pairing_required"),
+        pairing_code: FeishuConversationPairingCodeSchema,
+        command: Type.String({ minLength: 1, maxLength: 128 }),
+        expires_at: IsoDateTimeStringSchema,
+        visibility: Type.Literal("visible_once"),
+    }, { additionalProperties: false }),
+    Type.Object({
+        state: Type.Literal("pairing_required"),
+        expires_at: Type.Optional(IsoDateTimeStringSchema),
+        visibility: Type.Literal("not_recoverable"),
+    }, { additionalProperties: false }),
+    Type.Object({ state: Type.Literal("connected") }, { additionalProperties: false }),
+]);
+export const IntegrationConversationBindingRequestSchema = Type.Object({
+    protocol_version: Type.Literal(1),
+    pairing_code: FeishuConversationPairingCodeSchema,
+    binding_ref: IntegrationOwnedRefSchema,
+    installation: PlatformInstallationLocatorSchema,
+    conversation_ref: ExternalObjectRefSchema,
+    external_subject: ExternalSubjectLocatorSchema,
+    observed_at: IsoDateTimeStringSchema,
+}, { additionalProperties: false });
+export const IntegrationConversationBindingDispositionSchema = Type.Union([
+    Type.Object({
+        kind: Type.Literal("bound"),
+        relay_project_ref: RelayProjectRefSchema,
+        project_display_name: Type.String({ minLength: 1, maxLength: 256 }),
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("duplicate"),
+        relay_project_ref: RelayProjectRefSchema,
+        project_display_name: Type.String({ minLength: 1, maxLength: 256 }),
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("invalid"),
+        reason_code: Type.String({ minLength: 1, maxLength: 128 }),
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("unauthorized"),
+        reason_code: Type.String({ minLength: 1, maxLength: 128 }),
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("conflict"),
+        reason_code: Type.String({ minLength: 1, maxLength: 128 }),
+    }, { additionalProperties: false }),
+]);
+export const IntegrationConversationBindingResponseSchema = Type.Object({
+    protocol_version: Type.Literal(1),
+    disposition: IntegrationConversationBindingDispositionSchema,
+}, { additionalProperties: false });
+export const INTEGRATION_CONVERSATION_SOURCE_TUNNEL_PATH = "/internal/integration/v1/conversation-sources";
+export const TrustedConversationSourceIngestionCommandSchema = Type.Object({
+    protocol_version: Type.Literal(1),
+    command_id: IdempotencyKeySchema,
+    relay_project_ref: RelayProjectRefSchema,
+    binding_ref: IntegrationOwnedRefSchema,
+    receipt: InboundIntegrationEventReceiptSchema,
+    actor: TrustedHumanIntegrationActorContextSchema,
+    source: NormalizedConversationSourceSchema,
+}, { additionalProperties: false });
+export const IntegrationDeliveryTunnelMetadataSchema = Type.Object({
+    protocol_version: Type.Literal(1),
+    relay_project_ref: RelayProjectRefSchema,
+    installation: PlatformInstallationLocatorSchema,
+    binding_ref: IntegrationOwnedRefSchema,
+    receipt_key: IntegrationOwnedRefSchema,
+    verified_at: IsoDateTimeStringSchema,
+}, { additionalProperties: false });
+export const IntegrationConversationSourceDeliveryResponseSchema = Type.Object({
+    protocol_version: Type.Literal(1),
+    disposition: IntegrationDeliveryDispositionSchema,
+}, { additionalProperties: false });
+const PlatformOutboundTextContentSchema = Type.Object({
+    kind: Type.Literal("text"),
+    text: Type.String({ minLength: 1, maxLength: 4_000 }),
+}, { additionalProperties: false });
+const PlatformOutboundIntentFields = {
+    protocol_version: Type.Literal(1),
+    intent_ref: IdempotencyKeySchema,
+    relay_project_ref: RelayProjectRefSchema,
+    installation: PlatformInstallationLocatorSchema,
+    binding_ref: IntegrationOwnedRefSchema,
+    canonical_message_ref: MessageIdSchema,
+    trigger_message_ref: MessageIdSchema,
+    content: PlatformOutboundTextContentSchema,
+    created_at: IsoDateTimeStringSchema,
+    attempt: Type.Integer({ minimum: 1, maximum: 1_000_000 }),
+};
+export const PlatformOutboundTextIntentSchema = Type.Object(PlatformOutboundIntentFields, {
+    additionalProperties: false,
+});
+export const RelayAuthorizedPlatformOutboundTextIntentSchema = Type.Object({
+    ...PlatformOutboundIntentFields,
+    conversation_ref: ExternalObjectRefSchema,
+}, { additionalProperties: false });
+export const IntegrationOutboundClaimRequestSchema = Type.Object({
+    protocol_version: Type.Literal(1),
+    installation: PlatformInstallationLocatorSchema,
+}, { additionalProperties: false });
+export const IntegrationOutboundClaimResponseSchema = Type.Union([
+    Type.Object({
+        protocol_version: Type.Literal(1),
+        disposition: Type.Object({
+            kind: Type.Literal("idle"),
+            retry_after_ms: Type.Integer({ minimum: 100, maximum: 60_000 }),
+        }, { additionalProperties: false }),
+    }, { additionalProperties: false }),
+    Type.Object({
+        protocol_version: Type.Literal(1),
+        disposition: Type.Object({
+            kind: Type.Literal("claimed"),
+            claim_ref: IntegrationOwnedRefSchema,
+            claim_expires_at: IsoDateTimeStringSchema,
+            intent: RelayAuthorizedPlatformOutboundTextIntentSchema,
+        }, { additionalProperties: false }),
+    }, { additionalProperties: false }),
+]);
+export const IntegrationOutboundAckDispositionSchema = Type.Union([
+    Type.Object({
+        kind: Type.Literal("accepted"),
+        delivery_ref: IntegrationOwnedRefSchema,
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("duplicate"),
+        delivery_ref: IntegrationOwnedRefSchema,
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("rejected"),
+        reason_code: Type.String({ minLength: 1, maxLength: 128 }),
+    }, { additionalProperties: false }),
+]);
+export const IntegrationOutboundAckRequestSchema = Type.Object({
+    protocol_version: Type.Literal(1),
+    installation: PlatformInstallationLocatorSchema,
+    claim_ref: IntegrationOwnedRefSchema,
+    intent_ref: IdempotencyKeySchema,
+    disposition: IntegrationOutboundAckDispositionSchema,
+}, { additionalProperties: false });
+export const IntegrationOutboundAckResponseSchema = Type.Object({
+    protocol_version: Type.Literal(1),
+    disposition: Type.Union([
+        Type.Object({ kind: Type.Literal("acknowledged") }, { additionalProperties: false }),
+        Type.Object({
+            kind: Type.Literal("stale"),
+            reason_code: Type.String({ minLength: 1, maxLength: 128 }),
+        }, { additionalProperties: false }),
+    ]),
+}, { additionalProperties: false });
+export const PlatformOutboundHandoffDispositionSchema = Type.Union([
+    Type.Object({
+        kind: Type.Literal("accepted"),
+        delivery_ref: IntegrationOwnedRefSchema,
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("duplicate"),
+        delivery_ref: IntegrationOwnedRefSchema,
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Literal("unavailable"),
+        retryable: Type.Literal(true),
+        reason_code: Type.String({ minLength: 1, maxLength: 128 }),
+    }, { additionalProperties: false }),
+    Type.Object({
+        kind: Type.Union([
+            Type.Literal("invalid"),
+            Type.Literal("unauthorized"),
+            Type.Literal("unsupported"),
+        ]),
+        reason_code: Type.String({ minLength: 1, maxLength: 128 }),
+    }, { additionalProperties: false }),
+]);
+export const PlatformOutboundHandoffResponseSchema = Type.Object({
+    protocol_version: Type.Literal(1),
+    disposition: PlatformOutboundHandoffDispositionSchema,
+}, { additionalProperties: false });
+function sameInstallation(left, right) {
+    return left.platform === right.platform && left.installation_ref === right.installation_ref;
+}
+export function isConversationIngestionEnvelope(value) {
+    if (!Value.Check(ConversationIngestionEnvelopeSchema, value)) {
+        return false;
+    }
+    const envelope = value;
+    const locatorInstallation = envelope.kind === "conversation_source"
+        ? envelope.source.locator.conversation.installation
+        : envelope.observation.locator.conversation.installation;
+    if (!sameInstallation(envelope.receipt.installation, envelope.actor.installation) ||
+        !sameInstallation(envelope.receipt.installation, locatorInstallation)) {
+        return false;
+    }
+    return envelope.kind === "conversation_source"
+        ? envelope.actor.purpose === "live_ingestion" || envelope.actor.purpose === "history_backfill"
+        : envelope.actor.purpose === "revision_observation" ||
+            envelope.actor.purpose === "history_backfill";
+}
+function sameExternalSubject(left, right) {
+    return (left.subject_kind === right.subject_kind &&
+        left.subject_ref === right.subject_ref &&
+        sameInstallation(left.installation, right.installation));
+}
+export function isIntegrationConversationSourceDeliveryRequest(value) {
+    if (!Value.Check(IntegrationConversationSourceDeliveryRequestSchema, value)) {
+        return false;
+    }
+    const request = value;
+    const sourceInstallation = request.source.locator.conversation.installation;
+    const sourceSubject = request.source.author.external_subject;
+    return (request.receipt.event_kind === "conversation_source" &&
+        sourceSubject.subject_kind === "human" &&
+        sameInstallation(request.receipt.installation, sourceInstallation) &&
+        sameInstallation(request.receipt.installation, sourceSubject.installation));
+}
+export function isIntegrationConversationBindingRequest(value) {
+    if (!Value.Check(IntegrationConversationBindingRequestSchema, value)) {
+        return false;
+    }
+    return (value.installation.platform === "feishu" &&
+        value.external_subject.subject_kind === "human" &&
+        sameInstallation(value.installation, value.external_subject.installation));
+}
+export function isIntegrationConversationBindingResponse(value) {
+    return Value.Check(IntegrationConversationBindingResponseSchema, value);
+}
+export function isTrustedConversationSourceIngestionCommand(value) {
+    if (!Value.Check(TrustedConversationSourceIngestionCommandSchema, value)) {
+        return false;
+    }
+    const command = value;
+    const sourceInstallation = command.source.locator.conversation.installation;
+    const sourceAuthor = command.source.author;
+    return (command.receipt.event_kind === "conversation_source" &&
+        command.actor.membership.relay_project_ref === command.relay_project_ref &&
+        command.actor.binding_ref === command.binding_ref &&
+        command.actor.account_ref === sourceAuthor.account_ref &&
+        command.actor.display_name === sourceAuthor.display_name &&
+        sameExternalSubject(command.actor.external_subject, sourceAuthor.external_subject) &&
+        sameInstallation(command.receipt.installation, sourceInstallation) &&
+        sameInstallation(command.receipt.installation, sourceAuthor.external_subject.installation));
+}
+export function isIntegrationDeliveryTunnelMetadata(value) {
+    return Value.Check(IntegrationDeliveryTunnelMetadataSchema, value);
+}
+export function isIntegrationConversationSourceDeliveryResponse(value) {
+    return Value.Check(IntegrationConversationSourceDeliveryResponseSchema, value);
+}
+export function isPlatformOutboundTextIntent(value) {
+    return Value.Check(PlatformOutboundTextIntentSchema, value);
+}
+export function isRelayAuthorizedPlatformOutboundTextIntent(value) {
+    return Value.Check(RelayAuthorizedPlatformOutboundTextIntentSchema, value);
+}
+export function isIntegrationOutboundClaimRequest(value) {
+    return (Value.Check(IntegrationOutboundClaimRequestSchema, value) &&
+        value.installation.platform === "feishu");
+}
+export function isIntegrationOutboundClaimResponse(value) {
+    return Value.Check(IntegrationOutboundClaimResponseSchema, value);
+}
+export function isIntegrationOutboundAckRequest(value) {
+    return (Value.Check(IntegrationOutboundAckRequestSchema, value) &&
+        value.installation.platform === "feishu");
+}
+export function isIntegrationOutboundAckResponse(value) {
+    return Value.Check(IntegrationOutboundAckResponseSchema, value);
+}
+export function isPlatformOutboundHandoffResponse(value) {
+    return Value.Check(PlatformOutboundHandoffResponseSchema, value);
+}
+//# sourceMappingURL=platform-integration.js.map

package/node_modules/@tutti/shared/dist/utils/feishu-diagnostics/index.d.ts

@@ -0,0 +1,10 @@
+export declare const FEISHU_DIAGNOSTIC_ID_HEADER = "x-tutti-feishu-diagnostic-id";
+export declare const FEISHU_WEB_RELEASE_HEADER = "x-tutti-feishu-web-release";
+export type FeishuRequestDiagnostics = {
+    diagnosticId: string;
+    webRelease: string;
+};
+export declare function isFeishuDiagnosticId(value: unknown): value is string;
+export declare function isFeishuWebRelease(value: unknown): value is string;
+export declare function isFeishuRequestDiagnostics(value: unknown): value is FeishuRequestDiagnostics;
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@tutti/shared/dist/utils/feishu-diagnostics/index.js

@@ -0,0 +1,19 @@
+export const FEISHU_DIAGNOSTIC_ID_HEADER = "x-tutti-feishu-diagnostic-id";
+export const FEISHU_WEB_RELEASE_HEADER = "x-tutti-feishu-web-release";
+const FEISHU_DIAGNOSTIC_ID_PATTERN = /^fdiag_[A-Za-z0-9_-]{16,64}$/u;
+const FEISHU_WEB_RELEASE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/u;
+export function isFeishuDiagnosticId(value) {
+    return typeof value === "string" && FEISHU_DIAGNOSTIC_ID_PATTERN.test(value);
+}
+export function isFeishuWebRelease(value) {
+    return typeof value === "string" && FEISHU_WEB_RELEASE_PATTERN.test(value);
+}
+export function isFeishuRequestDiagnostics(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "diagnosticId" in value &&
+        "webRelease" in value &&
+        isFeishuDiagnosticId(value.diagnosticId) &&
+        isFeishuWebRelease(value.webRelease));
+}
+//# sourceMappingURL=index.js.map

package/node_modules/@tutti/shared/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./command-idempotency/index.js";
+export * from "./feishu-diagnostics/index.js";
 export * from "./logging/index.js";
 export * from "./path-policy/index.js";
 export * from "./redaction/index.js";

package/node_modules/@tutti/shared/dist/utils/index.js

@@ -1,4 +1,5 @@
 export * from "./command-idempotency/index.js";
+export * from "./feishu-diagnostics/index.js";
 export * from "./logging/index.js";
 export * from "./path-policy/index.js";
 export * from "./redaction/index.js";

package/node_modules/@tutti/shared/dist/utils/redaction/index.d.ts

@@ -7,7 +7,7 @@ export declare const REDACTION_LABELS: {
     readonly hostSecret: "[REDACTED:host_secret]";
     readonly localPath: "[REDACTED:local_path]";
 };
-export declare const REDACTION_FIXTURES: readonly ["sk-proj-example-secret", "Authorization: Bearer example-token", "Cookie: tutti_session=example-session", "Cookie: tutti_preview_session=example-preview-session", "https://opaque.preview.tutti.now/__tutti_preview_bootstrap#token=example-preview-token", "http://127.0.0.1:4370/join/example-join-token", "http://127.0.0.1:4370/api/v1/join/example-join-token/accept", "http://127.0.0.1:4371/setup?token=example-runtime-token", "host_connection_token=example-host-token", "host_registration_secret=example-host-secret", "/Users/example/.tutti/auth.json", "/Users/example/project/.git/config", "/Users/example/.tutti/projects/proj_123/runs/act_123", "OPENAI_API_KEY=example"];
+export declare const REDACTION_FIXTURES: readonly ["sk-proj-example-secret", "Authorization: Bearer example-token", "Cookie: tutti_session=example-session", "Cookie: tutti_preview_session=example-preview-session", "Cookie: tutti_feishu_session=example-feishu-session", "https://opaque.preview.tutti.now/__tutti_preview_bootstrap#token=example-preview-token", "http://127.0.0.1:4370/join/example-join-token", "http://127.0.0.1:4370/api/v1/join/example-join-token/accept", "http://127.0.0.1:4371/setup?token=example-runtime-token", "host_connection_token=example-host-token", "host_registration_secret=example-host-secret", "TUTTI_FEISHU_APP_SECRET=example-feishu-app-secret", "authorization_code=example-feishu-authorization-code", "app_access_token=example-feishu-app-token", "user_access_token=example-feishu-user-token", "refresh_token=example-feishu-refresh-token", "/Users/example/.tutti/auth.json", "/Users/example/project/.git/config", "/Users/example/.tutti/projects/proj_123/runs/act_123", "OPENAI_API_KEY=example"];
 export declare function redactText(value: string): string;
 export declare function redactValue(value: unknown): unknown;
 export type RedactedError = {

package/node_modules/@tutti/shared/dist/utils/redaction/index.js

@@ -12,12 +12,18 @@ export const REDACTION_FIXTURES = [
     "Authorization: Bearer example-token",
     "Cookie: tutti_session=example-session",
     "Cookie: tutti_preview_session=example-preview-session",
+    "Cookie: tutti_feishu_session=example-feishu-session",
     "https://opaque.preview.tutti.now/__tutti_preview_bootstrap#token=example-preview-token",
     "http://127.0.0.1:4370/join/example-join-token",
     "http://127.0.0.1:4370/api/v1/join/example-join-token/accept",
     "http://127.0.0.1:4371/setup?token=example-runtime-token",
     "host_connection_token=example-host-token",
     "host_registration_secret=example-host-secret",
+    "TUTTI_FEISHU_APP_SECRET=example-feishu-app-secret",
+    "authorization_code=example-feishu-authorization-code",
+    "app_access_token=example-feishu-app-token",
+    "user_access_token=example-feishu-user-token",
+    "refresh_token=example-feishu-refresh-token",
     "/Users/example/.tutti/auth.json",
     "/Users/example/project/.git/config",
     "/Users/example/.tutti/projects/proj_123/runs/act_123",
@@ -48,6 +54,10 @@ const TEXT_REDACTION_RULES = [
         pattern: /\btutti_preview_session\s*=\s*[^;\s,]+/giu,
         replacement: `tutti_preview_session=${REDACTION_LABELS.cookie}`,
     },
+    {
+        pattern: /\btutti_feishu_session\s*=\s*[^;\s,]+/giu,
+        replacement: `tutti_feishu_session=${REDACTION_LABELS.cookie}`,
+    },
     {
         pattern: /(https?:\/\/[^\s"'`]+\/__tutti_preview_bootstrap)#token=[A-Za-z0-9._~+/%=-]+/giu,
         replacement: `$1#token=${REDACTION_LABELS.bearerToken}`,
@@ -88,6 +98,14 @@ const TEXT_REDACTION_RULES = [
         pattern: /\bhost_registration_secret\s*=\s*[^\s"'`&]+/giu,
         replacement: `host_registration_secret=${REDACTION_LABELS.hostSecret}`,
     },
+    {
+        pattern: /\bTUTTI_FEISHU_APP_SECRET\s*=\s*[^\s"'`&]+/giu,
+        replacement: `TUTTI_FEISHU_APP_SECRET=${REDACTION_LABELS.hostSecret}`,
+    },
+    {
+        pattern: /\b(authorization_code|app_access_token|user_access_token|refresh_token)\s*=\s*[^\s"'`&,]+/giu,
+        replacement: `$1=${REDACTION_LABELS.bearerToken}`,
+    },
     {
         pattern: /\bsk-(?:proj-)?[A-Za-z0-9_-]{8,}\b/gu,
         replacement: REDACTION_LABELS.providerApiKey,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfey/tutti",
-  "version": "0.1.103",
+  "version": "0.1.104",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",