@acorex-platform/module-conversation-client 0.0.38 → 0.0.46

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@acorex-platform/module-conversation-client",
-  "version": "0.0.38",
+  "version": "0.0.46",
   "sideEffects": false,
   "peerDependencies": {
     "@angular/common": "^21.0.0 || ^22.0.0",
     "@angular/core": "^21.0.0 || ^22.0.0"
   },
   "dependencies": {
-    "@acorex-platform/extension-rtc-core-gateway": "0.0.38",
+    "@acorex-platform/extension-rtc-core-gateway": "0.0.46",
     "tslib": "^2.3.0"
   },
   "module": "fesm2022/acorex-platform-module-conversation-client.mjs",
@@ -24,6 +24,18 @@
       "types": "./types/acorex-platform-module-conversation-client-contracts.d.ts",
       "default": "./fesm2022/acorex-platform-module-conversation-client-contracts.mjs"
     },
+    "./contracts/entities/channel-audience": {
+      "types": "./types/acorex-platform-module-conversation-client-contracts-entities-channel-audience.d.ts",
+      "default": "./fesm2022/acorex-platform-module-conversation-client-contracts-entities-channel-audience.mjs"
+    },
+    "./contracts/entities/channel-post": {
+      "types": "./types/acorex-platform-module-conversation-client-contracts-entities-channel-post.d.ts",
+      "default": "./fesm2022/acorex-platform-module-conversation-client-contracts-entities-channel-post.mjs"
+    },
+    "./contracts/entities/channel-receipt": {
+      "types": "./types/acorex-platform-module-conversation-client-contracts-entities-channel-receipt.d.ts",
+      "default": "./fesm2022/acorex-platform-module-conversation-client-contracts-entities-channel-receipt.mjs"
+    },
     "./contracts/entities/message": {
       "types": "./types/acorex-platform-module-conversation-client-contracts-entities-message.d.ts",
       "default": "./fesm2022/acorex-platform-module-conversation-client-contracts-entities-message.mjs"

package/types/acorex-platform-module-conversation-client-contracts-entities-channel-audience.d.ts

@@ -0,0 +1,5 @@
+import { AXPEntity } from '@acorex-platform/framework-shared/entity';
+
+declare function channelAudienceFactory(): Promise<AXPEntity | null>;
+
+export { channelAudienceFactory };

package/types/acorex-platform-module-conversation-client-contracts-entities-channel-post.d.ts

@@ -0,0 +1,5 @@
+import { AXPEntity } from '@acorex-platform/framework-shared/entity';
+
+declare function channelPostFactory(): Promise<AXPEntity | null>;
+
+export { channelPostFactory };

package/types/acorex-platform-module-conversation-client-contracts-entities-channel-receipt.d.ts

@@ -0,0 +1,5 @@
+import { AXPEntity } from '@acorex-platform/framework-shared/entity';
+
+declare function channelReceiptFactory(): Promise<AXPEntity | null>;
+
+export { channelReceiptFactory };

package/types/acorex-platform-module-conversation-client-contracts.d.ts

@@ -1,3 +1,4 @@
+import { AXPModuleManifest, AXPMultiLanguageString, AXPFileListItem } from '@acorex-platform/framework-shared/core';
 import { AXPEntityModel } from '@acorex-platform/framework-shared/entity';
 import { AXMConversationMessage as AXMConversationMessage$1, AXMConversationRoom as AXMConversationRoom$1 } from '@acorex-platform/module-conversation-client/contracts';
 
@@ -10,6 +11,8 @@ interface AXMCommentEntityData {
 
 declare const AXPConversationMenuKeys: {
     readonly Conversations: "Conversation:Menu:Conversations";
+    readonly Channels: "Conversation:Menu:Channels";
+    readonly Feed: "Conversation:Menu:ChannelFeed";
 };
 
 /**
@@ -24,6 +27,10 @@ declare const AXPCollaborationPermissionKeys: {
     readonly MaintainCommunications: "Collaboration:Permission:MaintainCommunications";
     readonly MaintainReservations: "Collaboration:Permission:MaintainReservations";
     readonly MaintainHelpDesk: "Collaboration:Permission:MaintainHelpDesk";
+    readonly ViewBulletins: "Collaboration:Permission:ViewBulletins";
+    readonly MaintainBulletins: "Collaboration:Permission:MaintainBulletins";
+    readonly PublishBulletins: "Collaboration:Permission:PublishBulletins";
+    readonly ModerateBulletinDiscussions: "Collaboration:Permission:ModerateBulletinDiscussions";
     readonly Setup: "Collaboration:Permission:Setup";
 };
 /**
@@ -33,6 +40,28 @@ declare const AXPCollaborationPermissionKeys: {
 declare const AXMPermissionsKeys: {
     readonly Conversation: {
         readonly Management: "Collaboration:Permission:MaintainConversations";
+        readonly ChannelPosts: {
+            readonly Management: "Collaboration:Permission:MaintainBulletins";
+            readonly View: "Collaboration:Permission:ViewBulletins";
+            readonly Edit: "Collaboration:Permission:MaintainBulletins";
+            readonly Delete: "Collaboration:Permission:MaintainBulletins";
+            readonly Create: "Collaboration:Permission:MaintainBulletins";
+            readonly Publish: "Collaboration:Permission:PublishBulletins";
+        };
+        readonly ChannelAudiences: {
+            readonly Management: "Collaboration:Permission:MaintainBulletins";
+            readonly View: "Collaboration:Permission:ViewBulletins";
+            readonly Edit: "Collaboration:Permission:MaintainBulletins";
+            readonly Delete: "Collaboration:Permission:MaintainBulletins";
+            readonly Create: "Collaboration:Permission:MaintainBulletins";
+        };
+        readonly ChannelReceipts: {
+            readonly Management: "Collaboration:Permission:MaintainBulletins";
+            readonly View: "Collaboration:Permission:ViewBulletins";
+            readonly Edit: "Collaboration:Permission:MaintainBulletins";
+            readonly Delete: "Collaboration:Permission:MaintainBulletins";
+            readonly Create: "Collaboration:Permission:MaintainBulletins";
+        };
     };
 };
 
@@ -61,9 +90,214 @@ declare const RootConfig: {
             readonly source: `${string}.Message`;
             readonly icon: "fa-light fa-message";
         };
+        readonly channelPost: {
+            readonly name: "ChannelPost";
+            readonly source: `${string}.ChannelPost`;
+            readonly title: `@${string}:entities.channel-post.title`;
+            readonly titlePlural: `@${string}:entities.channel-post.plural`;
+            readonly icon: "fa-light fa-bullhorn";
+        };
+        readonly channelAudience: {
+            readonly name: "ChannelAudience";
+            readonly source: `${string}.ChannelAudience`;
+            readonly title: `@${string}:entities.channel-audience.title`;
+            readonly titlePlural: `@${string}:entities.channel-audience.plural`;
+            readonly icon: "fa-light fa-users";
+        };
+        readonly channelReceipt: {
+            readonly name: "ChannelReceipt";
+            readonly source: `${string}.ChannelReceipt`;
+            readonly title: `@${string}:entities.channel-receipt.title`;
+            readonly titlePlural: `@${string}:entities.channel-receipt.plural`;
+            readonly icon: "fa-light fa-envelope-open";
+        };
+    };
+    readonly pages: {
+        readonly feed: {
+            readonly path: "announcements";
+            readonly title: `@${string}:pages.feed.title`;
+            readonly description: `@${string}:pages.feed.description`;
+            readonly icon: "fa-light fa-bullhorn";
+        };
+    };
+};
+declare const CHANNEL_POST_ENTITY_NAME: `${string}.ChannelPost`;
+declare const CHANNEL_AUDIENCE_ENTITY_NAME: `${string}.ChannelAudience`;
+declare const CHANNEL_RECEIPT_ENTITY_NAME: `${string}.ChannelReceipt`;
+
+/**
+ * Conversation Module Manifest.
+ * Defines module metadata, features, and provider references.
+ */
+declare const ConversationManifest: AXPModuleManifest;
+
+declare const AXMChannelErrorCodes: {
+    readonly InvalidTransition: "CHANNEL_INVALID_TRANSITION";
+    readonly ScheduleRequiresFuturePublishAt: "CHANNEL_SCHEDULE_REQUIRES_FUTURE_PUBLISH_AT";
+    readonly NotAddressed: "CHANNEL_NOT_ADDRESSED";
+};
+
+declare const AXPConversationQueryKeys: {
+    readonly ChannelFeed: {
+        readonly Get: "Conversation:ChannelFeed:Get";
+        readonly GetUnreadCount: "Conversation:ChannelFeed:GetUnreadCount";
+    };
+};
+declare const AXPConversationCommandKeys: {
+    readonly ChannelFeed: {
+        readonly MarkRead: "Conversation:ChannelFeed:MarkRead";
     };
 };
 
+type AXMChannelPostKind = 'announcement' | 'news' | 'event' | 'urgent';
+type AXMChannelPostStatus = 'draft' | 'scheduled' | 'published' | 'cancelled' | 'archived';
+type AXMChannelNotificationPolicy = 'in-app' | 'selected-channels' | 'urgent-override';
+type AXMChannelLifecycleAction = 'schedule' | 'publish' | 'cancel' | 'archive' | 'restore';
+interface AXMChannelPostEntityModel extends AXPEntityModel<string> {
+    roomId: string;
+    title: AXPMultiLanguageString;
+    body: AXPMultiLanguageString;
+    kind: AXMChannelPostKind;
+    status: AXMChannelPostStatus;
+    authorUserId: string;
+    publishAt?: Date | string;
+    publishedAt?: Date | string;
+    expiresAt?: Date | string;
+    eventStartsAt?: Date | string;
+    eventEndsAt?: Date | string;
+    eventLocation?: AXPMultiLanguageString;
+    isPinned: boolean;
+    pinRank?: number;
+    pinnedUntil?: Date | string;
+    allowReactions: boolean;
+    allowComments: boolean;
+    notificationPolicy?: AXMChannelNotificationPolicy;
+    publicationVersion: number;
+    gallery?: AXPFileListItem[];
+    attachments?: AXPFileListItem[];
+    tags?: AXPMultiLanguageString[];
+}
+
+interface AXMChannelFeedQueryInput {
+    skip?: number;
+    take?: number;
+    roomId?: string;
+}
+interface AXMChannelFeedItem {
+    id: string;
+    roomId: string;
+    title: AXPMultiLanguageString;
+    body: AXPMultiLanguageString;
+    kind: AXMChannelPostKind;
+    authorUserId: string;
+    publishedAt?: string;
+    eventStartsAt?: string;
+    eventEndsAt?: string;
+    eventLocation?: AXPMultiLanguageString;
+    isPinned: boolean;
+    allowReactions: boolean;
+    allowComments: boolean;
+    /** Total comments in the post thread, including replies. Omitted on older chat metadata. */
+    commentCount?: number;
+    isRead: boolean;
+    gallery: AXPFileListItem[];
+    attachments: AXPFileListItem[];
+    tags: AXPMultiLanguageString[];
+}
+interface AXMChannelMarkReadCommandInput {
+    postId?: string;
+    roomId?: string;
+}
+interface AXMChannelUnreadCount {
+    count: number;
+    byRoomId?: Record<string, number>;
+}
+
+/** Projects a channel post onto the chat/feed card shape stored on Message metadata. */
+declare function toChannelFeedItem(post: AXMChannelPostEntityModel, isRead: boolean, isPinned: boolean, commentCount?: number): AXMChannelFeedItem;
+/** Plain-text title for chat message payload (MLS or string). */
+declare function channelPostTitleText(title: unknown): string;
+declare function channelPostMessageName(postId: string): string;
+
+declare const CHANNEL_POST_PUBLISHED_EVENT_NAME: "Conversation.ChannelPostPublished";
+interface AXMChannelPublishedEvent {
+    eventName: typeof CHANNEL_POST_PUBLISHED_EVENT_NAME;
+    tenantId: string;
+    roomId: string;
+    postId: string;
+    publicationVersion: number;
+    title: string;
+    kind: AXMChannelPostKind;
+    canonicalUrl: string;
+    audienceSummary: string;
+    idempotencyKey: string;
+}
+interface AXMChannelDistributionSelection {
+    distributorKey: string;
+    destinationIds: readonly string[];
+}
+interface AXMChannelDistributionResult {
+    distributorKey: string;
+    destinationId: string;
+    externalReference?: string;
+}
+type AXMChannelDistributionOutcome = ({
+    status: 'fulfilled';
+} & AXMChannelDistributionResult) | {
+    status: 'skipped';
+    distributorKey: string;
+    destinationId: string;
+} | {
+    status: 'failed';
+    distributorKey: string;
+    destinationId: string;
+};
+interface AXMChannelDistributor {
+    readonly key: string;
+    distribute(event: AXMChannelPublishedEvent, destinationId: string): Promise<AXMChannelDistributionResult>;
+}
+declare const CHANNEL_DISTRIBUTOR: unique symbol;
+interface AXMChannelNotificationPort {
+    notify(event: AXMChannelPublishedEvent, recipientUserIds: readonly string[]): Promise<void>;
+}
+declare const CHANNEL_NOTIFICATION_PORT: unique symbol;
+
+type AXMChannelAudienceTargetType = 'organization' | 'user' | 'role' | 'team' | 'businessUnit' | 'position' | 'jobDefinition';
+type AXMChannelAudienceMode = 'include' | 'exclude';
+interface AXMChannelAudienceEntityModel extends AXPEntityModel<string> {
+    /** Channel-level audience when set (Conversation.Room id). */
+    roomId?: string;
+    /** Post-level audience when set (Conversation.ChannelPost id). */
+    postId?: string;
+    targetType: AXMChannelAudienceTargetType;
+    targetId?: string;
+    mode?: AXMChannelAudienceMode;
+    resolvedAt?: Date | string;
+    resolvedCount?: number;
+}
+interface AXMChannelAudienceMembership {
+    userId: string;
+    roleIds?: readonly string[];
+    teamIds?: readonly string[];
+    businessUnitIds?: readonly string[];
+    positionIds?: readonly string[];
+    jobDefinitionIds?: readonly string[];
+}
+
+declare function axmChannelAudienceRuleMatches(rule: AXMChannelAudienceEntityModel, member: AXMChannelAudienceMembership): boolean;
+declare function axmChannelAudienceIsVisible(rules: readonly AXMChannelAudienceEntityModel[], member: AXMChannelAudienceMembership): boolean;
+declare function axmResolveChannelAudienceUserIds(rules: readonly AXMChannelAudienceEntityModel[], members: readonly AXMChannelAudienceMembership[]): string[];
+
+/** Lookup entity for each audience target type. `organization` has no row lookup. */
+declare const AXM_CHANNEL_AUDIENCE_TARGET_ENTITY: Record<AXMChannelAudienceTargetType, string | null>;
+declare function axmChannelAudienceTargetEntity(targetType: string | null | undefined): string | null;
+declare function axmRoomAudienceRule(room: {
+    id?: string | null;
+    audienceTargetType?: string | null;
+    audienceTargetId?: string | null;
+    audienceMode?: string | null;
+}): AXMChannelAudienceEntityModel | null;
+
 /** Fields for one uploaded or remote media item. */
 interface AXMediaItemFields {
     /** HTTP(S) or other persistable URL; omit when only {@link mediaId} is stored. */
@@ -343,6 +577,8 @@ interface AXConversationMessageListThemeBackground {
 }
 /** Single CSS value (both themes) or per-theme `{ light, dark }` backgrounds. */
 type AXConversationMessageListBackground = string | AXConversationMessageListThemeBackground;
+/** Composer file/paste UI: overlay popup vs banner above the composer. */
+type AXConversationComposerAttachmentPresentation = 'overlay' | 'banner';
 /**
  * Extensible map for app-specific conversation data.
  * Aligned with `@acorex/components/conversation` — UI-only keys such as
@@ -356,6 +592,11 @@ interface AXConversationMetadata extends Record<string, unknown> {
      * Defaults to `true` when omitted.
      */
     reactionsEnabled?: boolean;
+    /**
+     * Composer attachment UI. Bot rooms default to `banner` when omitted;
+     * private/group/channel default to `overlay`.
+     */
+    composerAttachmentPresentation?: AXConversationComposerAttachmentPresentation;
     /** Optional composer draft for REST backends (not a canonical room field). */
     draft?: string;
 }
@@ -415,8 +656,68 @@ interface AXMConversationRoom extends AXPEntityModel<string> {
     entityRef?: AXMCommentEntityData;
     /** Comment thread topic/subject */
     topic?: string;
+    /** Single channel audience rule: target kind. */
+    audienceTargetType?: AXMChannelAudienceTargetType;
+    /** Single channel audience rule: selected target id. */
+    audienceTargetId?: string;
+    /** Single channel audience rule: include or exclude. */
+    audienceMode?: AXMChannelAudienceMode;
+    /** Lookup entity name derived from {@link audienceTargetType}. */
+    audienceTargetEntity?: string;
 }
 
+interface AXMChannelReceiptEntityModel extends AXPEntityModel<string> {
+    postId: string;
+    userId: string;
+    firstSeenAt?: Date | string;
+    readAt?: Date | string;
+    dismissedAt?: Date | string;
+}
+
+/** Persisted `Room.name` for the tenant-wide announcements channel (unique per tenant scope). */
+declare const AXM_CONVERSATION_ANNOUNCEMENT_CHANNEL_NAME = "system.tenant-announcements";
+/** `metadata.systemChannel` value for the tenant-wide announcements channel. */
+declare const AXM_CONVERSATION_ANNOUNCEMENT_CHANNEL_KEY = "announcements";
+/** Custom conversation message type rendered by the channel feed-item plugin. */
+declare const AXM_CONVERSATION_ANNOUNCEMENT_MESSAGE_TYPE = "channel-feed-item";
+/** Message metadata key that stores the `AXMChannelFeedItem` projection. */
+declare const AXM_CONVERSATION_ANNOUNCEMENT_FEED_ITEM_META_KEY = "channelFeedItem";
+/** Message metadata key that stores the source ChannelPost id. */
+declare const AXM_CONVERSATION_CHANNEL_POST_ID_META_KEY = "channelPostId";
+type AnnouncementChannelRef = {
+    name?: string | null;
+    metadata?: Record<string, unknown> | null;
+};
+/** True when the room is the tenant announcements channel. */
+declare function axmIsAnnouncementChannel(value: AnnouncementChannelRef | null | undefined): boolean;
+declare function axmAnnouncementChannelMetadata(): Record<string, unknown>;
+type ChannelRoomRef = {
+    kind?: string | null;
+    type?: string | null;
+    name?: string | null;
+    metadata?: Record<string, unknown> | null;
+};
+/** True when the room is an entity comment thread (not a chat inbox conversation). */
+declare function axmIsCommentRoom(value: {
+    kind?: string | null;
+} | null | undefined): boolean;
+/** True when the room is a chat channel (broadcast posts, no composer). */
+declare function axmIsChannelRoom(value: ChannelRoomRef | null | undefined): boolean;
+declare function axmChannelPostIdFromMessage(message: {
+    name?: string | null;
+    metadata?: Record<string, unknown> | null;
+} | null | undefined): string | null;
+
+/**
+ * Resolves tenant/application scope for a new {@link Conversation.Message} row.
+ * Prefer the parent room's stamped scope so call logs match sibling messages on read.
+ */
+declare function axmResolveConversationMessageScopeInfo(room: Record<string, unknown>, session: {
+    tenantId?: string;
+    applicationId?: string;
+}): Record<string, unknown> | undefined;
+declare function axmScopeInfoNeedsTenantStamp(scopeInfo: Record<string, unknown> | undefined, expectedTenantId: string): boolean;
+
 /** Minimal tool-call shape for assist-stream frontend broker round-trips (mirrors AXPAiToolCall). */
 interface ConversationAssistFrontendToolCall {
     id: string;
@@ -454,6 +755,11 @@ type ConversationAssistWireEvent = {
     call: ConversationAssistFrontendToolCall;
 };
 
+/** UI flags persisted on every AI (bot) room. */
+declare function axmAiChatConversationUiMetadata(): {
+    reactionsEnabled: false;
+    composerAttachmentPresentation: 'banner';
+};
 declare function axmExtractAssistIdFromMetadata(metadata: Record<string, unknown> | undefined): string | undefined;
 /**
  * Legacy detector for unsupported agent-as-chat rooms. Not an engine targeting API.
@@ -467,9 +773,20 @@ declare function axmIsUnsupportedLegacyAgentAssistConversation(metadata: Record<
 declare function axmConversationHasAiChat(metadata: Record<string, unknown> | undefined): boolean;
 declare function axmChatAiPeerParticipantId(catalogId: string): string;
 declare function axmReadAssistResponseStatus(metadata: Record<string, unknown> | undefined): string | undefined;
+type AxmAssistFollowUpStatus = 'preparing' | 'ready' | 'skipped';
+declare function axmReadAssistFollowUpStatus(metadata: Record<string, unknown> | undefined): AxmAssistFollowUpStatus | undefined;
 declare function axmReadReplyToUserMessageId(metadata: Record<string, unknown> | undefined): string | undefined;
 declare function extractMessageTextFromPayload(payload: unknown): string;
 declare function axmNormalizeConversationTitle(raw: string): string;
+/** System prompt for a lightweight follow-up-chip model call after the Assist answer. */
+declare const AXM_ASSIST_CONVERSATION_FOLLOW_UP_SYSTEM_PROMPT = "You generate short follow-up suggestion chips for a chat assistant.\n\nGiven the latest user message, assistant reply, optional this-turn tool evidence, optional earlier turns from **this same conversation**, and optional assist capabilities, reply with ONLY one JSON object:\n{\"type\":\"followUp\",\"content\":[{\"text\":\"chip label\",\"command\":{\"name\":\"Conversation:SendAssistChatMessage\",\"options\":{}}}]}\n\nRules:\n- Always propose 2\u20135 short, actionable next steps as Conversation:SendAssistChatMessage chips. Never return an empty content array.\n- Navigation chips (Entity:OpenList / Entity:OpenDetails) are extra and never replace send-message chips. Always include at least two send-message chips.\n- Default chips send the label as the next chat message via Conversation:SendAssistChatMessage.\n- **Priority:** ground every chip in the latest user message and the latest assistant reply. Earlier turns in this conversation may only inspire wording. Ignore any other conversation, tenant, or leftover memory.\n- Chip labels must continue **this exchange**. After a list or query (including an empty result), suggest the next obvious question or filter \u2014 a different date, range, person, or related view \u2014 in the user's language. After a create/update, offer the next step on that record.\n- Empty results still need concrete next steps (for example a different day, this week, or who is away), not generic filler.\n- Example: user asked who is on leave today and the assistant found none \u2192 chips such as \"leave tomorrow\", \"this week's leave\", \"who is away next week\" in the user's language.\n- Never emit generic filler such as \"Ask another question\", \"What else can you do?\", \"Ask me anything\", or their translations.\n- Navigation chips only when **this turn** created, updated, queried, opened a specific entity, or answered a how-to using PlatformManagement:ListPlatformNavigationForAi with a single Module.Entity. Never on greeting, thanks, goodbye, or orientation. Chip **text** must be in the same language as the user (never English when the user wrote Persian).\n  - List: {\"text\":\"<Open List or List {menu title} in the user's language>\",\"command\":{\"name\":\"Entity:OpenList\",\"options\":{\"entity\":\"Module.Entity\"}}}\n  - How-to / menu answers: Open List only (no Details unless a record id exists). Prefer a named chip such as \"List Users\" when the menu title is known.\n  - Details (only when this turn has a record id and the row was not just deleted): {\"text\":\"<Open Details in the user's language>\",\"command\":{\"name\":\"Entity:OpenDetails\",\"options\":{\"entity\":\"Module.Entity\",\"data\":{\"id\":\"<record-id>\"}}}}\n- Other chips remain send-message requests in the user's language.\n- Do not invent platform facts, IDs, or screens that were not mentioned and are not listed in assist capabilities.\n- When the exchange is orientation (greeting, thanks, goodbye, or no specific task yet), suggest what this assist can help with. Prefer the provided assist capabilities, rewritten as short chip labels in the user's language.\n- Use the same language as the user.\n- Do not repeat the assistant's full answer. Chip labels only.\n- No markdown fences, commentary, or extra keys.";
+declare function axmBuildAssistConversationFollowUpUserPrompt(input: {
+    userMessageText: string;
+    assistantMessageText: string;
+    assistGrounding?: string;
+    turnGrounding?: string;
+    threadInspiration?: string;
+}): string;
 /** System prompt for a lightweight title-only model call (first user message → sidebar title). */
 declare const AXM_ASSIST_CONVERSATION_TITLE_SYSTEM_PROMPT = "You generate short conversation titles for chat sidebars.\n\nGiven the user's first message, reply with ONLY a concise title (3\u20138 words, max 90 characters).\nUse the same language as the user's message (for example Persian if they wrote in Persian).\nDo not use quotes, colons, hashtags, or explanation. Output the title text only.";
 declare function axmSanitizeAiGeneratedConversationTitle(raw: string): string | null;
@@ -494,14 +811,127 @@ declare function axmCompareMessagesChronologically(a: {
     timestamp: unknown;
     metadata?: Record<string, unknown>;
 }): number;
+type AXMChronologicalMessage = {
+    id: string;
+    timestamp: unknown;
+    metadata?: Record<string, unknown>;
+    deleted?: boolean;
+};
+/** Messages that sort after {@link messageId} in conversation order (deleted rows excluded). */
+declare function axmMessagesAfterId<T extends AXMChronologicalMessage>(messages: readonly T[], messageId: string): T[];
+
+interface AxmFollowUpNavChipLabels {
+    list: string;
+    details: string;
+}
+/**
+ * Spoken language from the latest user text when that locale exists in the product;
+ * otherwise the system UI locale.
+ */
+declare function axmInferFollowUpChipLocale(spokenText: string, systemLocale?: string): string;
+/** Resolved Open List / Open Details labels — plain text, never i18n keys. */
+declare function axmResolveFollowUpNavChipLabels(spokenText: string, systemLocale?: string, options?: {
+    listEntityTitle?: string;
+}): AxmFollowUpNavChipLabels;
 
 interface AXMConversationAssistMessageHandler {
     maybeStartAfterUserMessage(userMessage: AXMConversationMessage): Promise<void>;
+    /**
+     * After a user edits an earlier turn: drop later messages, abort any live stream,
+     * and start a new Assist reply from the edited message.
+     */
+    maybeRegenerateAfterUserMessageEdit(userMessage: AXMConversationMessage): Promise<void>;
     retryAssistResponse(conversationId: string, messageId: string, options?: {
         replyToUserMessageId?: string;
     }): Promise<AXMConversationMessage>;
 }
 declare const AXM_CONVERSATION_ASSIST_MESSAGE_HANDLER: unique symbol;
 
-export { AXMPermissionsKeys, AXM_ASSIST_CONVERSATION_TITLE_SYSTEM_PROMPT, AXM_COMMENT_LIKE_EMOJI, AXM_CONVERSATION_ASSIST_MESSAGE_HANDLER, AXPCollaborationPermissionKeys, AXPConversationMenuKeys, RootConfig, axmBuildHeuristicConversationTitleFallback, axmChatAiPeerParticipantId, axmCoerceMessageTimestampMs, axmCompareMessagesChronologically, axmConversationHasAiChat, axmEnsureAssistMessageSortsAfterReplyTarget, axmExtractAssistIdFromMetadata, axmExtractDirectAgentIdFromMetadata, axmIsUnsupportedLegacyAgentAssistConversation, axmNormalizeConversationTitle, axmReadAssistResponseStatus, axmReadReplyToUserMessageId, axmResolveAssistMessageTimestamp, axmSanitizeAiGeneratedConversationTitle, extractMessageTextFromPayload };
-export type { AXAudioMediaItem, AXAudioPayload, AXConversationMessageListBackground, AXConversationMessageListThemeBackground, AXConversationMetadata, AXConversationSettings, AXConversationStatus, AXConversationType, AXFileMediaItem, AXFilePayload, AXImageMediaItem, AXImagePayload, AXLink, AXLinkPreview, AXLocationPayload, AXMCommentEntityData, AXMConversationAssistMessageHandler, AXMConversationMessage, AXMConversationReaction, AXMConversationRoom, AXMConversationRoomKind, AXMReactionType, AXMediaItemFields, AXMention, AXMessagePayload, AXMessageStatus, AXMessageType, AXNodePayload, AXParticipant, AXParticipantRole, AXParticipantStatus, AXPollOption, AXPollPayload, AXReaction, AXStickerPayload, AXSystemEventType, AXSystemPayload, AXTextFormat, AXTextPayload, AXUserProfile, AXVideoMediaItem, AXVideoPayload, AXVoicePayload, ConversationAssistFrontendToolCall, ConversationAssistWireEvent };
+/** Metadata key on a Conversation room for contextual assist launch payload. */
+declare const AXM_ASSIST_LAUNCH_CONTEXT_METADATA_KEY = "assistLaunchContext";
+/** v1 entity-row launch kind. Later callers may pass other kind strings (e.g. document). */
+declare const AXM_CONTEXTUAL_ASSIST_KIND_ENTITY_RECORD = "entity-record";
+/** v1 entity-row action name passed into the launcher. */
+declare const AXM_CONTEXTUAL_ASSIST_ACTION_ENTITY_RECORD = "entity.record.assist";
+/** Generic bag the contextual-assist launcher accepts from any host (entity, later document). */
+interface AXMContextualAssistContext {
+    kind: string;
+    actionName: string;
+    title?: string;
+    payload: Record<string, unknown>;
+}
+/** Column snapshot for an entity-record launch. */
+interface AXMContextualAssistColumnValue {
+    name: string;
+    title: string;
+    value: unknown;
+}
+/** Payload for {@link AXM_CONTEXTUAL_ASSIST_KIND_ENTITY_RECORD}. */
+interface AXMEntityRecordAssistPayload {
+    moduleName: string;
+    entityName: string;
+    entityTitle?: string;
+    recordId: string;
+    columns: AXMContextualAssistColumnValue[];
+}
+/**
+ * Payload key for a live designer/document JSON string.
+ * Sanitizer keeps this field much larger than ordinary string values.
+ */
+declare const AXM_CONTEXTUAL_ASSIST_LAYOUT_JSON_KEY = "layoutJson";
+/** Compact widget pointer for designer assist (selected node / current page). */
+interface AXMFormTemplateDesignerAssistWidgetRef {
+    type?: string;
+    name?: string;
+    path?: string;
+    childCount?: number;
+}
+/** Local list summary (not row data) for designer assist. */
+interface AXMFormTemplateDesignerAssistDataSourceRef {
+    id: string;
+    name: string;
+    itemCount: number;
+    columnNames: string[];
+}
+/**
+ * Payload for form-template designer assist.
+ * Optional {@link layoutJson} is the live canvas (same shape as File → Download JSON).
+ * Prefer designer outline/patch commands over shipping the full tree.
+ */
+interface AXMFormTemplateDesignerAssistPayload extends AXMEntityRecordAssistPayload {
+    scenario: string;
+    entityType: string;
+    surface: 'layout-designer';
+    layoutJson?: string;
+    layoutJsonTruncated?: boolean;
+    unsavedChanges?: boolean;
+    pageCount?: number;
+    currentPageIndex?: number;
+    currentPage?: AXMFormTemplateDesignerAssistWidgetRef;
+    selectedWidget?: AXMFormTemplateDesignerAssistWidgetRef | null;
+    dataSources?: AXMFormTemplateDesignerAssistDataSourceRef[];
+    widgetCounts?: Record<string, number>;
+    surfaceId?: string;
+    documentKind?: string;
+    rootWidget?: string;
+}
+
+/** Live designer JSON must survive sanitize so the specialist can edit the canvas. */
+declare const AXM_CONTEXTUAL_ASSIST_MAX_LAYOUT_JSON_CHARS = 100000;
+declare const AXM_CONTEXTUAL_ASSIST_STARTER_SYSTEM_PROMPT = "You generate short suggested starter questions for a chat assistant.\n\nThe user has not sent a message yet. They opened assist from a product surface (for example one entity record).\n\nReply with ONLY one JSON object:\n{\"items\":[{\"text\":\"short question\"}]}\n\nRules:\n- Return at most 3 items. Each text is one short suggested question or request the user could send.\n- Ground every chip only in the provided launch context. Do not invent ids, fields, or facts that are not in the context.\n- Use the same language as the locale (and any user-facing titles in the context).\n- Do not claim data was saved or that you already changed the record.\n- No markdown fences, commentary, or extra keys.";
+/**
+ * Reads {@link AXM_ASSIST_LAUNCH_CONTEXT_METADATA_KEY} from conversation metadata
+ * (including the nested `metadata.metadata` shape used by the conversation UI).
+ */
+declare function axmIsFormTemplateDesignerAssistLaunch(metadata: Record<string, unknown> | undefined): boolean;
+declare function axmExtractAssistLaunchContextFromMetadata(metadata: Record<string, unknown> | undefined): AXMContextualAssistContext | undefined;
+declare function axmSanitizeContextualAssistContext(context: AXMContextualAssistContext): AXMContextualAssistContext;
+declare function axmSanitizeContextualAssistValue(value: unknown): unknown;
+declare function axmShouldSkipContextualAssistKey(key: string): boolean;
+declare function axmBuildContextualAssistStarterUserPrompt(context: AXMContextualAssistContext, locale: string): string;
+/** System/user-visible injection prepended on every assist run for a launched room. */
+declare function axmFormatContextualAssistLaunchInjection(context: AXMContextualAssistContext): string;
+declare function axmParseContextualAssistStarterItems(rawText: string): string[];
+
+export { AXMChannelErrorCodes, AXMPermissionsKeys, AXM_ASSIST_CONVERSATION_FOLLOW_UP_SYSTEM_PROMPT, AXM_ASSIST_CONVERSATION_TITLE_SYSTEM_PROMPT, AXM_ASSIST_LAUNCH_CONTEXT_METADATA_KEY, AXM_CHANNEL_AUDIENCE_TARGET_ENTITY, AXM_COMMENT_LIKE_EMOJI, AXM_CONTEXTUAL_ASSIST_ACTION_ENTITY_RECORD, AXM_CONTEXTUAL_ASSIST_KIND_ENTITY_RECORD, AXM_CONTEXTUAL_ASSIST_LAYOUT_JSON_KEY, AXM_CONTEXTUAL_ASSIST_MAX_LAYOUT_JSON_CHARS, AXM_CONTEXTUAL_ASSIST_STARTER_SYSTEM_PROMPT, AXM_CONVERSATION_ANNOUNCEMENT_CHANNEL_KEY, AXM_CONVERSATION_ANNOUNCEMENT_CHANNEL_NAME, AXM_CONVERSATION_ANNOUNCEMENT_FEED_ITEM_META_KEY, AXM_CONVERSATION_ANNOUNCEMENT_MESSAGE_TYPE, AXM_CONVERSATION_ASSIST_MESSAGE_HANDLER, AXM_CONVERSATION_CHANNEL_POST_ID_META_KEY, AXPCollaborationPermissionKeys, AXPConversationCommandKeys, AXPConversationMenuKeys, AXPConversationQueryKeys, CHANNEL_AUDIENCE_ENTITY_NAME, CHANNEL_DISTRIBUTOR, CHANNEL_NOTIFICATION_PORT, CHANNEL_POST_ENTITY_NAME, CHANNEL_POST_PUBLISHED_EVENT_NAME, CHANNEL_RECEIPT_ENTITY_NAME, ConversationManifest, RootConfig, axmAiChatConversationUiMetadata, axmAnnouncementChannelMetadata, axmBuildAssistConversationFollowUpUserPrompt, axmBuildContextualAssistStarterUserPrompt, axmBuildHeuristicConversationTitleFallback, axmChannelAudienceIsVisible, axmChannelAudienceRuleMatches, axmChannelAudienceTargetEntity, axmChannelPostIdFromMessage, axmChatAiPeerParticipantId, axmCoerceMessageTimestampMs, axmCompareMessagesChronologically, axmConversationHasAiChat, axmEnsureAssistMessageSortsAfterReplyTarget, axmExtractAssistIdFromMetadata, axmExtractAssistLaunchContextFromMetadata, axmExtractDirectAgentIdFromMetadata, axmFormatContextualAssistLaunchInjection, axmInferFollowUpChipLocale, axmIsAnnouncementChannel, axmIsChannelRoom, axmIsCommentRoom, axmIsFormTemplateDesignerAssistLaunch, axmIsUnsupportedLegacyAgentAssistConversation, axmMessagesAfterId, axmNormalizeConversationTitle, axmParseContextualAssistStarterItems, axmReadAssistFollowUpStatus, axmReadAssistResponseStatus, axmReadReplyToUserMessageId, axmResolveAssistMessageTimestamp, axmResolveChannelAudienceUserIds, axmResolveConversationMessageScopeInfo, axmResolveFollowUpNavChipLabels, axmRoomAudienceRule, axmSanitizeAiGeneratedConversationTitle, axmSanitizeContextualAssistContext, axmSanitizeContextualAssistValue, axmScopeInfoNeedsTenantStamp, axmShouldSkipContextualAssistKey, channelPostMessageName, channelPostTitleText, extractMessageTextFromPayload, toChannelFeedItem };
+export type { AXAudioMediaItem, AXAudioPayload, AXConversationComposerAttachmentPresentation, AXConversationMessageListBackground, AXConversationMessageListThemeBackground, AXConversationMetadata, AXConversationSettings, AXConversationStatus, AXConversationType, AXFileMediaItem, AXFilePayload, AXImageMediaItem, AXImagePayload, AXLink, AXLinkPreview, AXLocationPayload, AXMChannelAudienceEntityModel, AXMChannelAudienceMembership, AXMChannelAudienceMode, AXMChannelAudienceTargetType, AXMChannelDistributionOutcome, AXMChannelDistributionResult, AXMChannelDistributionSelection, AXMChannelDistributor, AXMChannelFeedItem, AXMChannelFeedQueryInput, AXMChannelLifecycleAction, AXMChannelMarkReadCommandInput, AXMChannelNotificationPolicy, AXMChannelNotificationPort, AXMChannelPostEntityModel, AXMChannelPostKind, AXMChannelPostStatus, AXMChannelPublishedEvent, AXMChannelReceiptEntityModel, AXMChannelUnreadCount, AXMChronologicalMessage, AXMCommentEntityData, AXMContextualAssistColumnValue, AXMContextualAssistContext, AXMConversationAssistMessageHandler, AXMConversationMessage, AXMConversationReaction, AXMConversationRoom, AXMConversationRoomKind, AXMEntityRecordAssistPayload, AXMFormTemplateDesignerAssistDataSourceRef, AXMFormTemplateDesignerAssistPayload, AXMFormTemplateDesignerAssistWidgetRef, AXMReactionType, AXMediaItemFields, AXMention, AXMessagePayload, AXMessageStatus, AXMessageType, AXNodePayload, AXParticipant, AXParticipantRole, AXParticipantStatus, AXPollOption, AXPollPayload, AXReaction, AXStickerPayload, AXSystemEventType, AXSystemPayload, AXTextFormat, AXTextPayload, AXUserProfile, AXVideoMediaItem, AXVideoPayload, AXVoicePayload, AxmAssistFollowUpStatus, AxmFollowUpNavChipLabels, ConversationAssistFrontendToolCall, ConversationAssistWireEvent };