@senguoyun/dsh-arkme 0.1.16 → 0.1.23

package/lib/types/types.d.ts

@@ -41,6 +41,108 @@ export interface ArkmeContactAddResult {
     state: 'ready' | 'pending';
     source: ArkmeSourceItem;
 }
+export type ArkmeDirectorySectionKind = 'groups' | 'bots' | 'unmarked-speakers' | 'teams' | 'contacts';
+/** Browser-safe directory row. Provider-private identifiers never cross this boundary. */
+export type ArkmeDirectoryItem = {
+    kind: 'group';
+    sourceRef: string;
+    displayName: string;
+    avatarRef?: string;
+    groupAvatar?: ArkmeGroupAvatarPresentation;
+} | {
+    kind: 'bot';
+    botRef: string;
+    displayName: string;
+    avatarRef?: string;
+} | {
+    kind: 'unmarked-speaker';
+    candidateRef: string;
+    speakerToken?: string;
+    displayName: string;
+    subtitle: string;
+} | {
+    kind: 'team';
+    rowKey: string;
+    displayName: string;
+    publicId?: string;
+    avatarRef?: string;
+} | {
+    kind: 'contact';
+    contactRef: string;
+    displayName: string;
+    nickname: string;
+    remark: string;
+    accountName?: string;
+    avatarRef?: string;
+    letter: string;
+};
+export interface ArkmeDirectoryPage {
+    section: ArkmeDirectorySectionKind;
+    items: ArkmeDirectoryItem[];
+    total: number;
+    hasMore: boolean;
+    nextCursor?: string;
+    projectionState?: 'fresh' | 'stale' | 'building' | 'failed';
+    retryAfterMillis?: number;
+    cursorStale?: boolean;
+}
+export interface ArkmeDirectoryContactProfile {
+    contactRef: string;
+    displayName: string;
+    nickname: string;
+    remark: string;
+    avatarRef?: string;
+}
+export type ArkmeUnmarkedSpeakerInferenceState = 'pending' | 'ready' | 'failed' | 'unavailable';
+export interface ArkmeUnmarkedSpeakerInference {
+    state: ArkmeUnmarkedSpeakerInferenceState;
+    recommendedSpeakerRef?: string;
+    recommendedDisplayName?: string;
+    retryable?: boolean;
+}
+export interface ArkmeUnmarkedSpeakerChoice {
+    speakerRef: string;
+    displayName: string;
+    source: 'recommended' | 'manual';
+}
+/** Browser-safe detail projection for one opaque unmarked-speaker candidate ref. */
+export interface ArkmeUnmarkedSpeakerOptions {
+    candidateRef: string;
+    candidateVersion: string;
+    speakerToken?: string;
+    appearanceDays: number;
+    validAudioDurationMillis: number;
+    segmentCount: number;
+    latestAtMillis: number;
+    conversationSummaryState?: 'ready' | 'pending' | 'unavailable';
+    conversationSummary?: string;
+    inference: ArkmeUnmarkedSpeakerInference;
+    speakerChoices: ArkmeUnmarkedSpeakerChoice[];
+}
+export interface ArkmeUnmarkedSpeakerInferenceRetry {
+    candidateRef: string;
+    inference: ArkmeUnmarkedSpeakerInference;
+}
+export interface ArkmeUnmarkedSpeakerSegment {
+    segmentRef: string;
+    date: string;
+    sessionLabel: string;
+    timeRange: string;
+    durationMillis: number;
+    transcript: string;
+    mediaRef?: string;
+}
+export interface ArkmeUnmarkedSpeakerSegmentPage {
+    items: ArkmeUnmarkedSpeakerSegment[];
+    total: number;
+    hasMore: boolean;
+    nextCursor?: string;
+    cursorStale?: boolean;
+}
+export type ArkmeUnmarkedSpeakerMarkOutcome = 'marked' | 'stale' | 'conflict' | 'candidate_not_found' | 'speaker_not_found';
+export interface ArkmeUnmarkedSpeakerMarkResult {
+    outcome: ArkmeUnmarkedSpeakerMarkOutcome;
+}
 export interface ArkmeMyVoiceprint {
     hasVoiceprint: boolean;
     nickname: string;
@@ -123,6 +225,7 @@ export interface ArkmeSelfRecordItem {
     templateKind: number;
     status: number;
     version: number;
+    creationSource?: number;
     localState?: 'synced' | 'pending' | 'failed';
     lastError?: string;
     displayKind?: number;
@@ -213,6 +316,8 @@ export interface ArkmeBotSummary {
     description: string;
     status: ArkmeBotStatus;
     directChatAvailable: boolean;
+    /** Account-bound opaque reference resolved through image.read. */
+    avatarRef?: string;
 }
 export interface ArkmeBotList {
     items: ArkmeBotSummary[];
@@ -248,8 +353,23 @@ export interface ArkmeWorldAvatarFallback {
     colorIndex: number;
     label: string;
 }
+/** Immutable display snapshot emitted after one extension version becomes public. */
+export interface ArkmeWorldExtensionPublication {
+    extensionId: string;
+    version: string;
+    name: string;
+    description: string;
+    iconRef?: string;
+    previewRefs: string[];
+    visibility: 'public';
+    runtimeDshRange?: string;
+    desktopRequired: boolean;
+    publishedAtMillis: number;
+}
 export interface ArkmeWorldFeedItem {
     recordRef: string;
+    /** Opaque, viewer-bound reference for opening this non-self author's card. */
+    authorRef?: string;
     authorName: string;
     avatarRef?: string;
     avatarFallback?: ArkmeWorldAvatarFallback;
@@ -264,6 +384,8 @@ export interface ArkmeWorldFeedItem {
     videoCount: number;
     voiceCount: number;
     extendCount: number;
+    recordType?: 'extension_publication';
+    extensionPublication?: ArkmeWorldExtensionPublication;
 }
 export interface ArkmeWorldFeedPage {
     items: ArkmeWorldFeedItem[];
@@ -271,6 +393,11 @@ export interface ArkmeWorldFeedPage {
     hasMore: boolean;
     nextOffset?: number;
 }
+/** Viewer-specific display label for one opaque World author reference. */
+export interface ArkmeWorldAuthorLabel {
+    authorRef: string;
+    authorName: string;
+}
 export interface ArkmeWorldVoiceprintAvailabilityItem {
     recordRef: string;
     playable: boolean;
@@ -310,6 +437,8 @@ export interface ArkmeWorldVoiceprintInviteResult {
 export interface ArkmeWorldInteractionItem {
     interactionRef: string;
     parentRef: string;
+    /** Opaque, viewer-bound reference for opening this non-self author's card. */
+    authorRef?: string;
     authorName: string;
     avatarRef?: string;
     avatarFallback?: ArkmeWorldAvatarFallback;
@@ -399,7 +528,7 @@ export interface ArkmeArrangementReminderWriteResult {
     updatedCount?: number;
 }
 export type ArkmeWorldVisibility = 'visible' | 'pending_review' | 'rejected' | 'unknown' | 'not_published';
-export declare const ARKME_WORLD_PUBLISH_MAX_IMAGES = 9;
+export declare const ARKME_WORLD_PUBLISH_MAX_IMAGES = 27;
 export declare const ARKME_WORLD_PUBLISH_MAX_IMAGE_BYTES: number;
 export interface ArkmeWorldPublishResult {
     recordSaved: boolean;
@@ -456,6 +585,8 @@ export interface ArkmeSearchHistoryResult {
 }
 export interface ArkmeSearchAssetItem {
     fileAssetUid: string;
+    /** Opaque browser-safe reference for streaming this search asset through the plugin media proxy. */
+    mediaRef?: string;
     fileUid?: string;
     fileName?: string;
     mimeType?: string;
@@ -494,6 +625,7 @@ export interface ArkmeSearchRecordItem {
     nickname?: string;
     templateKind?: number;
     displayKind?: number;
+    creationSource?: number;
     sourceTitle?: string;
     media: ArkmeSearchAssetItem[];
     files: ArkmeSearchAssetItem[];
@@ -502,6 +634,8 @@ export interface ArkmeSearchRecordItem {
     recordDurationMillis?: number;
     sceneItemCount?: number;
     sceneItemSize?: number;
+    /** Current-account navigation target for opening this hit in its owning Arkme conversation. */
+    targetSource?: ArkmeSourceItem;
 }
 export interface ArkmeSearchSourceAggregate {
     sourceKind: number;
@@ -535,6 +669,96 @@ export interface ArkmeRecordingSearchResult {
     nextCursor?: string;
     queryGuard: ArkmeSearchQueryGuard;
 }
+export type ArkmeCallMediaType = 'audio' | 'video' | 'unknown';
+export type ArkmeCallSummaryStatus = 'idle' | 'pending' | 'done' | 'failed';
+export interface ArkmeCallHistoryOptions {
+    limit?: number;
+    cursor?: string;
+    includeRecentContacts?: boolean;
+}
+export interface ArkmeCallHistoryItem {
+    callRef: string;
+    stableId: string;
+    peerDisplayName: string;
+    peerUserId?: number;
+    peerAvatarRef?: string;
+    mediaType: ArkmeCallMediaType;
+    startedAtMillis: number;
+    acceptedAtMillis: number;
+    endedAtMillis: number;
+    durationSeconds: number;
+    callResult: string;
+    resultLabel: string;
+    summaryStatus: ArkmeCallSummaryStatus;
+    summaryPreview?: string;
+    summaryUpdatedAtMillis?: number;
+    canOpenDetail: boolean;
+    canRedial: boolean;
+    chatSessionUid?: string;
+    sharedTopicId?: number;
+}
+export interface ArkmeCallRecentContact {
+    userId: number;
+    displayName: string;
+    avatarRef?: string;
+    sharedTopicId?: number;
+}
+export interface ArkmeCallHistoryPage {
+    items: ArkmeCallHistoryItem[];
+    recentContacts?: ArkmeCallRecentContact[];
+    hasMore: boolean;
+    nextCursor?: string;
+}
+export interface ArkmeCallParticipant {
+    userId?: number;
+    displayName: string;
+    isCurrentUser?: boolean;
+    avatarRef?: string;
+}
+export interface ArkmeCallTranscriptSegment {
+    segmentId: string;
+    speakerDisplayName: string;
+    speakerUserId?: number;
+    text: string;
+    startMillis: number;
+    endMillis: number;
+}
+export interface ArkmeCallVideoRecord {
+    available: boolean;
+    source: 'real' | 'sample';
+    videoUrl?: string;
+    posterUrl?: string;
+    perspectives?: ArkmeCallVideoPerspective[];
+}
+export interface ArkmeCallVideoPerspective {
+    perspective: 'self' | 'peer' | 'main' | 'unknown';
+    label?: string;
+    videoUrl?: string;
+    posterUrl?: string;
+}
+export interface ArkmeCallDetail {
+    callRef: string;
+    title: string;
+    mediaType: ArkmeCallMediaType;
+    startedAtMillis: number;
+    acceptedAtMillis: number;
+    endedAtMillis: number;
+    durationSeconds: number;
+    callResult: string;
+    resultLabel: string;
+    summaryStatus: ArkmeCallSummaryStatus;
+    summaryText?: string;
+    summaryUpdatedAtMillis?: number;
+    transcriptPending: boolean;
+    transcriptFailed: boolean;
+    videoRecord?: ArkmeCallVideoRecord;
+    participants: ArkmeCallParticipant[];
+    transcriptSegments: ArkmeCallTranscriptSegment[];
+}
+export interface ArkmeCallSummaryRetryResult {
+    status: 'submitted';
+    detail: ArkmeCallDetail;
+}
 export interface ArkmeProviderCapabilities {
     contractVersion: typeof ARKME_PROVIDER_CONTRACT_VERSION;
     provider: '@senguoyun/dsh-arkme';
@@ -556,11 +780,17 @@ export interface ArkmeProviderCapabilities {
         imageLibrary?: true;
         sourceDirectory: true;
         sourceTimeline: true;
+        /** Forward snapshots include typed transcripts and account-bound attachment references. */
+        forwardContent?: true;
         sourceTextSend: true;
+        /** Recipient read/unread summaries and group member detail for current-user-sent messages. */
+        messageReadReceipts?: true;
         richContentRead: boolean;
         richContentSend: boolean;
         fileUpload: boolean;
         outgoingCall: true;
+        /** Browser-safe call-history list/detail and explicit summary retry are available. */
+        callHistory?: true;
         groupMembers: true;
         groupMemberAdd?: true;
         userCard: true;
@@ -609,6 +839,7 @@ export interface ArkmeProviderCapabilities {
         maxImageBytes: number;
         maxRelatedRecordingPageSize?: number;
         maxRelatedRecordingCursorLength?: number;
+        maxMessageReadReceiptItems?: number;
         maxUploadBytes: number;
     };
 }
@@ -688,8 +919,18 @@ export interface ArkmeSourceItem {
     sourceRef: string;
     /** Stable Host-projected directory identity. Consumers must treat it as opaque when present. */
     sourceKey?: string;
-    /** Opaque reference to this topic's parent. Present only when both topics are in the same directory response. */
+    /** Private-chat peer identity when this source is a one-to-one chat. */
+    peerUserId?: number;
+    /** Opaque reference to this topic's parent when both topic labels are available in the same response. */
     parentSourceRef?: string;
+    /** Opaque topic identity for reconciling hierarchy across paginated directory responses. */
+    topicHierarchyKey?: string;
+    /** Opaque parent topic identity. A child stays hidden until this key is present in the loaded tree. */
+    parentTopicHierarchyKey?: string;
+    /** Some direct child topics are still on later pages of the personal-topic directory. */
+    hasPendingChildren?: boolean;
+    /** Server-persisted order within this topic's sibling group. */
+    siblingOrder?: number;
     kind: ArkmeSourceKind;
     displayName: string;
     /** Opaque Provider image reference; consumers resolve it through image.read. */
@@ -701,6 +942,7 @@ export interface ArkmeSourceItem {
     latestPreview?: string;
     activeAtMillis: number;
     unreadCount: number;
+    hasUnreadMention?: boolean;
     /** Effective chat notification state. True when mute is on or push notifications are disabled. */
     isMuted?: boolean;
     latestSequence?: number;
@@ -709,6 +951,7 @@ export interface ArkmeSourceItem {
 export interface ArkmeSourceList {
     directory: ArkmeSourceDirectory;
     items: ArkmeSourceItem[];
+    total?: number;
     hasMore: boolean;
     nextCursor?: string;
 }
@@ -718,11 +961,51 @@ export interface ArkmeTopicCreateResult {
     /** Present only when the requested parent relation and the automatic orphan cleanup both failed. */
     warning?: string;
 }
+/** Result of moving a personal topic to a different hierarchy parent. */
+export interface ArkmeTopicHierarchyMoveResult {
+    sourceRef: string;
+    parentSourceRef?: string;
+    siblingOrder: number;
+}
+/** Result of renaming one personal topic. The opaque reference changes with the title. */
+export interface ArkmeTopicRenameResult {
+    sourceRef: string;
+    displayName: string;
+}
+/** Result of dissolving one personal topic while retaining its child topics. */
+export interface ArkmeTopicDissolveResult {
+    sourceRef: string;
+    movedChildSourceRefs: string[];
+    movedRecordCount: number;
+    /** Undefined means the records returned to the default category. */
+    recordTargetSourceRef?: string;
+}
+/** Live status for a long-running topic dissolve operation. */
+export interface ArkmeTopicDissolveProgress {
+    requestId: string;
+    stage: 'reading' | 'migrating' | 'promoting' | 'dissolving' | 'completed' | 'failed';
+    completedRecordCount: number;
+    totalRecordCount: number;
+    error?: string;
+}
+/** A viewer-bound dissolve task that can be restored after the page reloads. */
+export interface ArkmeTopicDissolveTask extends ArkmeTopicDissolveProgress {
+    sourceRef: string;
+    parentSourceRef?: string;
+}
 export interface ArkmeTimelineCursor {
     sendAtMillis?: number;
     itemUid?: string;
     beforeSequence?: number;
 }
+/** A browser-safe topic projection attached to an item in the aggregate self feed. */
+export interface ArkmeTimelineSelfTopic {
+    /** Browser-safe stable key for resolving the current topic from the self topic tree. */
+    topicHierarchyKey: string;
+    /** Available immediately when the feed includes the topic title. */
+    sourceRef?: string;
+    title?: string;
+}
 export interface ArkmeTimelineItem {
     itemUid: string;
     /** Account-bound opaque reference for reporting this concrete group-chat message. */
@@ -734,6 +1017,8 @@ export interface ArkmeTimelineItem {
     /** Opaque Provider image reference for the concrete message sender. */
     avatarRef?: string;
     isMe: boolean;
+    /** Browser-safe projection of whether this incoming message mentions the current viewer. */
+    mentionsViewer?: boolean;
     sendAtMillis: number;
     title: string;
     textContent: string;
@@ -750,14 +1035,64 @@ export interface ArkmeTimelineItem {
     contentBlocks?: ArkmeContentBlock[];
     /** Record owner reported media refs, but their delivery projection was temporarily unavailable. */
     mediaUnavailable?: boolean;
+    /** Present only for a categorized record in the aggregate “发给自己” feed. */
+    selfTopic?: ArkmeTimelineSelfTopic;
     /** Browser-safe Chat forward snapshot. It is present only for explicit `render_kind=forward_records` payloads. */
     forwardRecords?: ArkmeForwardRecordsPreview;
 }
+/** Identity of one message returned by an Arkme private/group timeline. */
+export interface ArkmeMessageReadReceiptQueryItem {
+    itemUid: string;
+    sequence: number;
+}
+export declare const ARKME_MESSAGE_READ_RECEIPT_MAX_ITEMS: 50;
+export type ArkmeMessageReadReceiptStatus = 'read' | 'partially_read' | 'unread';
+/** Read/unread aggregate for one current-user-sent private/group message. */
+export interface ArkmeMessageReadReceiptSummary extends ArkmeMessageReadReceiptQueryItem {
+    readCount: number;
+    unreadCount: number;
+    /** Active human recipients, excluding the sender. */
+    totalMemberCount: number;
+    status: ArkmeMessageReadReceiptStatus;
+}
+export interface ArkmeMessageReadReceiptSummaryList {
+    sourceRef: string;
+    conversationKind: 'private_chat' | 'group_chat';
+    items: ArkmeMessageReadReceiptSummary[];
+}
+export interface ArkmeMessageReadReceiptMember {
+    /** Account- and conversation-bound member reference. */
+    memberRef: string;
+    displayName: string;
+    avatarRef?: string;
+    readStatus: 'read' | 'unread';
+    /** Present only when this member has read the message. */
+    readAtMillis?: number;
+}
+/** Member-level receipt detail for one current-user-sent group message. */
+export interface ArkmeMessageReadReceiptDetail extends ArkmeMessageReadReceiptQueryItem {
+    sourceRef: string;
+    readCount: number;
+    unreadCount: number;
+    totalMemberCount: number;
+    items: ArkmeMessageReadReceiptMember[];
+}
 export interface ArkmeForwardRecordsPreview {
     title: string;
     createdAtMillis: number;
     summaryLines: string[];
     items: ArkmeForwardRecordPreviewItem[];
+    /** The bounded snapshot omitted additional records or nested content. */
+    truncated?: true;
+}
+export interface ArkmeForwardTranscriptSegment {
+    speakerName: string;
+    textContent: string;
+    /** Offsets in the forwarded recording, not wall-clock timestamps. */
+    startMillis: number;
+    endMillis: number;
+    contentBlocks?: ArkmeContentBlock[];
+    mediaUnavailable?: true;
 }
 export interface ArkmeForwardRecordPreviewItem {
     senderName: string;
@@ -767,9 +1102,14 @@ export interface ArkmeForwardRecordPreviewItem {
     title: string;
     textContent: string;
     contentLabel?: string;
+    sourceType?: 'record' | 'chat_record' | 'long_recording_segments' | 'agent' | 'ai_letter' | 'unknown';
+    segments?: ArkmeForwardTranscriptSegment[];
+    contentBlocks?: ArkmeContentBlock[];
+    mediaUnavailable?: true;
+    truncated?: true;
 }
 export interface ArkmeTimelineAgentSource {
-    kind: 'agent';
+    kind: 'agent' | 'dsh_agent_input';
     displayName: string;
     label: string;
 }
@@ -827,6 +1167,8 @@ export interface ArkmeContentBlock {
     size: number;
     durationSec?: number;
     sortOrder: number;
+    /** Backend media render role. 3 means a standalone chat sticker. */
+    renderRole?: 1 | 3;
 }
 export interface ArkmeUploadedAsset {
     fileAssetUid: string;
@@ -835,6 +1177,31 @@ export interface ArkmeUploadedAsset {
     size: number;
     fileKind: 1 | 2 | 3 | 4;
 }
+export interface ArkmeFavoriteSticker {
+    fileAssetUid: string;
+    fileName: string;
+    mimeType: string;
+    size: number;
+    fileKind: 1;
+    isAnimated: boolean;
+    isAvailable: boolean;
+    mediaRef?: string;
+    unavailableReason?: string;
+}
+export interface ArkmeFavoriteStickerList {
+    items: ArkmeFavoriteSticker[];
+    itemCount: number;
+    updatedAtMillis: number;
+}
+export interface ArkmeFavoriteStickerAddInput {
+    fileAssetUid: string;
+    fileName: string;
+    mimeType: string;
+    size: number;
+    fileKind: 1;
+    isAnimated?: boolean;
+}
+export type ArkmeFavoriteStickerManageAction = 'move-to-front' | 'delete';
 export interface ArkmeRichSendInput {
     title?: string;
     textContent?: string;
@@ -842,9 +1209,16 @@ export interface ArkmeRichSendInput {
     thinkingDurationMillis?: number;
     assets?: ArkmeUploadedAsset[];
     humanMentions?: ArkmeHumanMentionInput[];
+    botMentions?: ArkmeBotMentionInput[];
 }
 export interface ArkmeHumanMentionInput {
-    memberRef: string;
+    memberRef?: string;
+    all?: boolean;
+    startIndex: number;
+    length: number;
+}
+export interface ArkmeBotMentionInput {
+    botRef: string;
     startIndex: number;
     length: number;
 }
@@ -1033,11 +1407,25 @@ export interface ArkmeConversationMemberItem {
     recordCount: number;
     mentionCount: number;
 }
+export type ArkmeConversationMemberJoinAction = 'invite' | 'direct_add';
+export interface ArkmeConversationMemberJoinPerson {
+    memberRef?: string;
+    displayName: string;
+    isSelf: boolean;
+}
+export interface ArkmeConversationMemberJoinEvent {
+    eventId: string;
+    action: ArkmeConversationMemberJoinAction;
+    occurredAtMillis: number;
+    inviter: ArkmeConversationMemberJoinPerson;
+    invitees: ArkmeConversationMemberJoinPerson[];
+}
 export interface ArkmeConversationMemberList {
     source: ArkmeSourceItem;
     items: ArkmeConversationMemberItem[];
     total: number;
     activeCount: number;
+    joinEvents?: ArkmeConversationMemberJoinEvent[];
 }
 export type ArkmeConversationMemberRecordMode = 'owner' | 'mentioned';
 export interface ArkmeConversationMemberRecordPage {
@@ -1069,6 +1457,7 @@ export interface ArkmeGroupBotCandidate {
     name: string;
     description: string;
     installed: boolean;
+    avatarRef?: string;
 }
 export interface ArkmeGroupBotCandidateList {
     groupSourceRef: string;
@@ -1117,6 +1506,11 @@ export interface ArkmeUserCardSnapshot {
     displayName: string;
     avatarRef?: string;
 }
+export interface ArkmeOfficialAuthorProfile {
+    userId: number;
+    displayName: string;
+    avatarRef?: string;
+}
 export interface ArkmeOpenPrivateChatResult {
     source: ArkmeSourceItem;
 }
@@ -1551,6 +1945,10 @@ export interface ArkmePluginUpdateInstallSnapshot {
     phase: ArkmePluginUpdateInstallPhase;
     previousVersion: string;
     targetVersion: string;
+    targetArtifactPath?: string;
+    targetArtifactSha512?: string;
+    appVersion?: string;
+    dshVersion?: string;
     message: string;
     updatedAtMillis: number;
 }
@@ -1574,6 +1972,10 @@ export type ArkmeChatClientEvent = {
         source: ArkmeSourceItem;
         timelineItems: ArkmeTimelineItem[];
     }>;
+} | {
+    type: 'projection-invalidated';
+    revision: number;
+    projection: 'record';
 } | {
     type: 'message-notification';
     revision: number;
@@ -1593,9 +1995,15 @@ export type ArkmeChatClientEvent = {
     sourceKey?: string;
     effectiveReadSequence: number;
     unreadCount: number;
+} | {
+    type: 'read-receipts-invalidated';
+    revision: number;
+    /** Account-bound conversation identity; raw Chat session and reader identities stay in Host memory. */
+    sourceKey: string;
+    throughSequence: number;
 };
-export type ArkmePluginOperation = 'provider.capabilities' | 'provider.state' | 'chat.realtime.state' | 'auth.status' | 'auth.config' | 'auth.begin' | 'auth.poll' | 'auth.test.login' | 'auth.phone.send' | 'auth.phone.verify' | 'auth.logout' | 'contacts.search' | 'contacts.add' | 'group.create' | 'bots.create' | 'records.summary' | 'records.cache' | 'records.refresh' | 'records.search' | 'records.list' | 'records.create' | 'records.outbox' | 'records.retry' | 'calendar.buckets' | 'calendar.records' | 'user.profile' | 'user.profile.refresh' | 'image.read' | 'images.list' | 'world.feed' | 'world.mine' | 'world.user' | 'world.voiceprint.availability' | 'world.voiceprint.playback.generate' | 'world.voiceprint.social-context' | 'world.voiceprint.invite' | 'world.interactions.list' | 'world.interactions.create-text' | 'world.image.read' | 'world.publish-text' | 'world.publish-file-assets' | 'arrangements.list' | 'arrangements.detail' | 'arrangements.mutate' | 'arrangements.reminder-enabled' | 'arrangements.reminders.summary' | 'arrangements.reminders.list' | 'arrangements.reminders.mark-read' | 'arrangements.reminders.mark-all-read' | 'arrangements.reminders.clear' | 'extensions.reviews.list' | 'extensions.reviews.create' | 'extensions.audit.check' | 'sources.list' | 'source.timeline' | 'source.members' | 'source.member-records' | 'source.mark-read' | 'source.send-text' | 'related-recordings.eligibility' | 'related-recordings.page' | 'source.ai-polish.settings' | 'source.ai-polish.notices' | 'source.ai-polish.generate-rule' | 'source.ai-polish.confirm-enable' | 'source.ai-polish.prepare-disable' | 'source.ai-polish.confirm-disable' | 'source.ai-polish.retry' | 'group.members' | 'group.member-candidates' | 'group.invite-preview' | 'group.members.add' | 'group.bots' | 'group.bot.add' | 'group.settings' | 'group.notification.set' | 'group.rename' | 'group.leave' | 'group.dissolve' | 'group.report' | 'user.card' | 'chat.private.open' | 'chat.member.private.open' | 'source.send-rich' | 'source.long-article.detail' | 'source.long-article.update' | 'source.long-article.draft.get' | 'source.long-article.draft.put' | 'source.long-article.draft.delete' | 'calls.outgoing.intent.claim' | 'calls.outgoing.intent.resolve' | 'calls.outgoing.prepare' | 'calls.outgoing.heartbeat' | 'calls.outgoing.release' | 'extensions.mine.list' | 'extensions.mine.publish' | 'extensions.catalog.list' | 'extensions.catalog.detail' | 'extensions.install.preview' | 'extensions.delete' | 'extensions.metadata.update' | 'extensions.share.rotate' | 'extensions.share.detail' | 'extensions.installed-list' | 'extensions.enabled-state' | 'extensions.persistent.client-state' | 'extensions.enabled.set' | 'extensions.preview.delete' | 'extensions.preview.reorder' | 'extensions.catalog.list' | 'extensions.classification.tree' | 'extensions.classification.items';
-export type ArkmeHostOperation = ArkmePluginOperation | 'provider.instance' | 'voiceprint.status' | 'voiceprint.grants' | 'voiceprint.people' | 'voiceprint.person' | 'voiceprint.person.voiceprints' | 'voiceprint.person.invite' | 'voiceprint.invite' | 'voiceprint.revoke' | 'voiceprint.restore' | 'dsh-beta-community.entry-state' | 'dsh-beta-community.join' | 'recordings.calendar' | 'recordings.day' | 'search.records' | 'search.scene' | 'search.recordings' | 'search.history' | 'search.history.create' | 'ai-video.list' | 'files.assets' | 'topic.create' | 'arko.profile' | 'arko.session' | 'arko.new-session' | 'arko.models' | 'arko.model.activate' | 'arko.history' | 'arko.ask' | 'arko.run.status' | 'arko.cancel' | 'plugin.update.status' | 'plugin.update.check' | 'plugin.update.acknowledge' | 'plugin.update.install' | 'plugin.update.install-status' | 'source.interwoven-moments' | 'source.interwoven-detail' | 'extensions.catalog.list' | 'extensions.classification.tree' | 'extensions.classification.items' | 'extensions.catalog.detail' | 'extensions.audit.check' | 'extensions.my-list' | 'extensions.delete' | 'extensions.updates' | 'extensions.install.preview' | 'extensions.install.start' | 'extensions.install.status' | 'extensions.install.pause' | 'extensions.install.resume' | 'extensions.uninstall' | 'extensions.restart' | 'extensions.persistent.invoke' | 'extensions.bundle.invoke';
+export type ArkmePluginOperation = 'provider.capabilities' | 'provider.state' | 'chat.realtime.state' | 'auth.status' | 'auth.config' | 'auth.begin' | 'auth.poll' | 'auth.test.login' | 'auth.phone.send' | 'auth.phone.verify' | 'auth.logout' | 'contacts.search' | 'contacts.add' | 'chat.private.open-from-contact' | 'group.create' | 'bots.list' | 'bots.create' | 'records.summary' | 'records.cache' | 'records.refresh' | 'records.search' | 'records.list' | 'records.create' | 'records.outbox' | 'records.retry' | 'calendar.buckets' | 'calendar.records' | 'user.profile' | 'user.profile.refresh' | 'image.read' | 'images.list' | 'world.feed' | 'world.mine' | 'world.user' | 'world.author-labels' | 'chat.world.private.open' | 'chat.official-author.profile' | 'chat.official-author.private.open' | 'world.voiceprint.availability' | 'world.voiceprint.playback.generate' | 'world.voiceprint.social-context' | 'world.voiceprint.invite' | 'world.interactions.list' | 'world.interactions.create-text' | 'world.image.read' | 'world.publish-text' | 'world.publish-file-assets' | 'arrangements.list' | 'arrangements.detail' | 'arrangements.mutate' | 'arrangements.reminder-enabled' | 'arrangements.reminders.summary' | 'arrangements.reminders.list' | 'arrangements.reminders.mark-read' | 'arrangements.reminders.mark-all-read' | 'arrangements.reminders.clear' | 'extensions.reviews.list' | 'extensions.reviews.create' | 'extensions.audit.check' | 'sources.list' | 'source.timeline' | 'source.members' | 'source.member-records' | 'source.mark-read' | 'source.read-receipts.summary-list' | 'source.read-receipts.detail' | 'source.send-text' | 'related-recordings.eligibility' | 'related-recordings.page' | 'source.ai-polish.settings' | 'source.ai-polish.notices' | 'source.ai-polish.generate-rule' | 'source.ai-polish.confirm-enable' | 'source.ai-polish.prepare-disable' | 'source.ai-polish.confirm-disable' | 'source.ai-polish.retry' | 'group.members' | 'group.member-candidates' | 'group.invite-preview' | 'group.members.add' | 'group.bots' | 'group.bot.add' | 'group.settings' | 'group.notification.set' | 'group.rename' | 'group.leave' | 'group.dissolve' | 'group.report' | 'user.card' | 'chat.private.open' | 'chat.member.private.open' | 'source.send-rich' | 'favorite-stickers.list' | 'favorite-stickers.add' | 'favorite-stickers.send' | 'favorite-stickers.manage' | 'source.long-article.detail' | 'source.long-article.update' | 'source.long-article.draft.get' | 'source.long-article.draft.put' | 'source.long-article.draft.delete' | 'calls.outgoing.intent.claim' | 'calls.outgoing.intent.resolve' | 'calls.outgoing.prepare' | 'calls.outgoing.heartbeat' | 'calls.outgoing.release' | 'calls.outgoing.diag' | 'calls.history.list' | 'calls.history.detail' | 'calls.history.summary.retry' | 'extensions.mine.list' | 'extensions.mine.publish' | 'extensions.catalog.list' | 'extensions.catalog.detail' | 'extensions.install.preview' | 'extensions.delete' | 'extensions.metadata.update' | 'extensions.share.rotate' | 'extensions.share.detail' | 'extensions.installed-list' | 'extensions.enabled-state' | 'extensions.persistent.client-state' | 'extensions.enabled.set' | 'extensions.preview.delete' | 'extensions.preview.reorder' | 'extensions.catalog.list' | 'extensions.classification.tree' | 'extensions.classification.items' | 'topic.hierarchy.move' | 'topic.rename' | 'topic.dissolve' | 'topic.dissolve.status' | 'topic.dissolve.active';
+export type ArkmeHostOperation = ArkmePluginOperation | 'provider.instance' | 'directory.list' | 'directory.contact.profile' | 'directory.contact.world' | 'directory.contact.open-chat' | 'directory.group.open-chat' | 'directory.bot.open-chat' | 'unmarked-speakers.options' | 'unmarked-speakers.retry-inference' | 'unmarked-speakers.segments' | 'unmarked-speakers.mark' | 'voiceprint.status' | 'voiceprint.grants' | 'voiceprint.people' | 'voiceprint.person' | 'voiceprint.person.voiceprints' | 'voiceprint.person.invite' | 'voiceprint.invite' | 'voiceprint.revoke' | 'voiceprint.restore' | 'dsh-beta-community.entry-state' | 'dsh-beta-community.join' | 'recordings.calendar' | 'recordings.day' | 'search.records' | 'search.scene' | 'search.recordings' | 'search.history' | 'search.history.create' | 'ai-video.list' | 'files.assets' | 'topic.create' | 'topic.hierarchy.move' | 'topic.rename' | 'topic.dissolve' | 'topic.dissolve.status' | 'topic.dissolve.active' | 'arko.profile' | 'arko.session' | 'arko.new-session' | 'arko.models' | 'arko.model.activate' | 'arko.history' | 'arko.ask' | 'arko.run.status' | 'arko.cancel' | 'plugin.update.status' | 'plugin.update.check' | 'plugin.update.acknowledge' | 'plugin.update.install' | 'plugin.update.install-status' | 'source.interwoven-moments' | 'source.interwoven-detail' | 'extensions.catalog.list' | 'extensions.classification.tree' | 'extensions.classification.items' | 'extensions.catalog.detail' | 'extensions.audit.check' | 'extensions.my-list' | 'extensions.delete' | 'extensions.updates' | 'extensions.install.preview' | 'extensions.install.start' | 'extensions.install.status' | 'extensions.install.pause' | 'extensions.install.resume' | 'extensions.uninstall' | 'extensions.restart' | 'extensions.client.failure' | 'extensions.bundle.client-state' | 'extensions.persistent.invoke' | 'extensions.bundle.invoke';
 export interface ArkmePluginRequest {
     operation: ArkmeHostOperation;
     params?: Record<string, unknown>;