@cuylabs/agent-channel-teams 4.0.0 → 4.1.0

package/dist/index.d.ts

@@ -1,219 +1,13 @@
-import { AgentTurnSource, AgentEvent, ApprovalRequest, HumanInputRequest, ApprovalAction, ApprovalRememberScope, HumanInputResponse } from '@cuylabs/agent-core';
-import { M365ChannelOptions, M365TurnRequestContext, M365TurnPreparation, M365UserIdentity, M365ChannelAdapter, M365AmbientTurnContext } from '@cuylabs/agent-channel-m365';
-import { TurnContext, AuthConfiguration, CloudAdapter } from '@microsoft/agents-hosting';
-import { TeamsChannelData } from '@microsoft/agents-hosting-extensions-teams';
-export { BatchFailedEntriesResponse, BatchOperationResponse, BatchOperationStateResponse, CancelOperationResponse, ChannelInfo, FeedbackLoopData, MeetingNotification, NotificationInfo, OnBehalfOf, TeamDetails, TeamInfo, TeamsAttachmentDownloader, TeamsChannelAccount, TeamsChannelData, TeamsChannelDataSettings, TeamsInfo, TeamsMeetingInfo, TeamsMember, TeamsPagedMembersResult, TenantInfo, parseTeamsChannelData } from '@microsoft/agents-hosting-extensions-teams';
-import { Activity, Attachment } from '@microsoft/agents-activity';
+import { T as TeamsChannelOptions, a as TeamsChannelAdapter, b as TeamsActivityInfo, c as TeamsActivityKind } from './proactive-DF5XvDLJ.js';
+export { d as TeamsActivityHandler, e as TeamsActivityHandlers, f as TeamsActorReference, g as TeamsCardActionHandlers, h as TeamsConfigHandlers, i as TeamsConversationUpdateHandlers, j as TeamsHandlerContext, k as TeamsHandlerDecision, l as TeamsInvokeResult, m as TeamsMeetingHandlers, n as TeamsMessageActivityHandlers, o as TeamsMessageExtensionHandlers, p as TeamsProactiveCapture, q as TeamsSurface, r as TeamsTabHandlers, s as TeamsTaskModuleHandlers, t as TeamsTurnPreparation, u as TeamsTurnRequestContext, v as captureTeamsConversationReference, w as createTeamsInvokeActivity, x as sendTeamsInvoke } from './proactive-DF5XvDLJ.js';
 import { Server } from 'node:http';
+import { AgentTurnSource, ApprovalRequest, HumanInputRequest, ApprovalAction, ApprovalRememberScope, HumanInputResponse } from '@cuylabs/agent-core';
+import { AuthConfiguration, CloudAdapter, TurnContext } from '@microsoft/agents-hosting';
 import { Application } from 'express';
-
-interface TeamsInvokeResult<T = unknown> {
-    status: number;
-    body?: T;
-}
-declare function createTeamsInvokeActivity<T = unknown>(result: TeamsInvokeResult<T>): Activity;
-declare function sendTeamsInvoke<T = unknown>(context: TurnContext, body?: T, status?: number): Promise<void>;
-
-type TeamsSurface = "personal" | "channel" | "group" | "meeting" | "unknown";
-type TeamsActivityKind = "message" | "conversation-update" | "members-added" | "members-removed" | "channel-created" | "channel-deleted" | "channel-renamed" | "channel-restored" | "channel-shared" | "channel-unshared" | "team-renamed" | "team-archived" | "team-unarchived" | "team-deleted" | "team-hard-deleted" | "team-restored" | "message-edit" | "message-delete" | "message-restore" | "reaction" | "read-receipt" | "config-fetch" | "config-submit" | "file-consent" | "actionable-message-execute-action" | "adaptive-card-action" | "adaptive-card-search" | "card-submit" | "feedback" | "dialog-open" | "dialog-submit" | "task-fetch" | "task-submit" | "search-command" | "message-extension-query" | "message-extension-query-link" | "message-extension-anonymous-query-link" | "select-result" | "message-extension-select-item" | "message-extension-submit-action" | "message-extension-fetch-task" | "message-extension-query-setting-url" | "message-extension-setting" | "message-extension-card-button-clicked" | "tab-fetch" | "tab-submit" | "invoke" | "meeting-start" | "meeting-end" | "participants-join" | "participants-leave" | "meeting-room-join" | "meeting-room-leave" | "meeting-stage-view" | "meeting-smart-reply" | "meeting-reaction" | "meeting-poll-response" | "meeting-apps-installed" | "meeting-apps-uninstalled" | "meeting-recording-started" | "meeting-recording-stopped" | "meeting-focus-change" | "meeting-screen-share-start" | "meeting-screen-share-stop" | "other";
-interface TeamsActorReference {
-    id?: string;
-    displayName?: string;
-    tenantId?: string;
-    userPrincipalName?: string;
-}
-interface TeamsActivityInfo {
-    channelId: string;
-    conversationId: string;
-    activityId?: string;
-    messageId?: string;
-    replyToId?: string;
-    invokeName?: string;
-    eventType?: string;
-    tenantId?: string;
-    teamId?: string;
-    channelThreadId?: string;
-    meetingId?: string;
-    channelData?: TeamsChannelData;
-    surface: TeamsSurface;
-    kind: TeamsActivityKind;
-    actors: TeamsActorReference[];
-}
-interface TeamsTurnRequestContext extends M365TurnRequestContext {
-    teams: TeamsActivityInfo;
-    channelData?: TeamsChannelData;
-}
-type TeamsTurnPreparation = M365TurnPreparation;
-interface TeamsHandlerContext {
-    turnContext: TurnContext;
-    user: M365UserIdentity;
-    teams: TeamsActivityInfo;
-    channelData?: TeamsChannelData;
-    sessionId: string;
-    source: AgentTurnSource;
-    /**
-     * Start an agent turn inside the current Teams request context.
-     *
-     * This is useful for dialog submit/search-command handlers that still want
-     * to delegate their actual reasoning to agent-core.
-     */
-    runAgent(message: string, options?: {
-        abort?: AbortSignal;
-        system?: string;
-    }): AsyncGenerator<AgentEvent>;
-    /**
-     * Send an invoke response payload back to Teams.
-     */
-    sendInvoke(body?: unknown, status?: number): Promise<void>;
-}
-type TeamsHandlerDecision = void | "continue" | TeamsInvokeResult;
-type TeamsActivityHandler = (context: TeamsHandlerContext) => TeamsHandlerDecision | Promise<TeamsHandlerDecision>;
-interface TeamsConversationUpdateHandlers {
-    conversationUpdate?: TeamsActivityHandler;
-    membersAdded?: TeamsActivityHandler;
-    membersRemoved?: TeamsActivityHandler;
-    channelCreated?: TeamsActivityHandler;
-    channelDeleted?: TeamsActivityHandler;
-    channelRenamed?: TeamsActivityHandler;
-    channelRestored?: TeamsActivityHandler;
-    channelShared?: TeamsActivityHandler;
-    channelUnshared?: TeamsActivityHandler;
-    teamRenamed?: TeamsActivityHandler;
-    teamArchived?: TeamsActivityHandler;
-    teamUnarchived?: TeamsActivityHandler;
-    teamDeleted?: TeamsActivityHandler;
-    teamHardDeleted?: TeamsActivityHandler;
-    teamRestored?: TeamsActivityHandler;
-}
-interface TeamsMessageActivityHandlers {
-    messageEdited?: TeamsActivityHandler;
-    messageDeleted?: TeamsActivityHandler;
-    messageRestored?: TeamsActivityHandler;
-    reaction?: TeamsActivityHandler;
-    readReceipt?: TeamsActivityHandler;
-}
-interface TeamsCardActionHandlers {
-    cardSubmit?: TeamsActivityHandler;
-    adaptiveCardAction?: TeamsActivityHandler;
-    adaptiveCardSearch?: TeamsActivityHandler;
-    feedbackSubmit?: TeamsActivityHandler;
-    fileConsent?: TeamsActivityHandler;
-    actionableMessageExecuteAction?: TeamsActivityHandler;
-}
-interface TeamsConfigHandlers {
-    configFetch?: TeamsActivityHandler;
-    configSubmit?: TeamsActivityHandler;
-}
-interface TeamsTaskModuleHandlers {
-    dialogOpen?: TeamsActivityHandler;
-    dialogSubmit?: TeamsActivityHandler;
-    taskFetch?: TeamsActivityHandler;
-    taskSubmit?: TeamsActivityHandler;
-}
-interface TeamsMessageExtensionHandlers {
-    searchCommand?: TeamsActivityHandler;
-    selectResult?: TeamsActivityHandler;
-    messageExtensionQuery?: TeamsActivityHandler;
-    messageExtensionQueryLink?: TeamsActivityHandler;
-    messageExtensionAnonymousQueryLink?: TeamsActivityHandler;
-    messageExtensionSelectItem?: TeamsActivityHandler;
-    messageExtensionSubmitAction?: TeamsActivityHandler;
-    messageExtensionFetchTask?: TeamsActivityHandler;
-    messageExtensionQuerySettingUrl?: TeamsActivityHandler;
-    messageExtensionSetting?: TeamsActivityHandler;
-    messageExtensionCardButtonClicked?: TeamsActivityHandler;
-}
-interface TeamsTabHandlers {
-    tabFetch?: TeamsActivityHandler;
-    tabSubmit?: TeamsActivityHandler;
-}
-interface TeamsMeetingHandlers {
-    /** Fired when a Teams meeting starts. */
-    meetingStart?: TeamsActivityHandler;
-    /** Fired when a Teams meeting ends. */
-    meetingEnd?: TeamsActivityHandler;
-    /** Fired when participants join a Teams meeting. */
-    participantsJoin?: TeamsActivityHandler;
-    /** Fired when participants leave a Teams meeting. */
-    participantsLeave?: TeamsActivityHandler;
-    /** Fired when a physical meeting room joins a Teams meeting. */
-    meetingRoomJoin?: TeamsActivityHandler;
-    /** Fired when a physical meeting room leaves a Teams meeting. */
-    meetingRoomLeave?: TeamsActivityHandler;
-    /** Fired when the app is viewed in the meeting stage (invoke). */
-    meetingStageView?: TeamsActivityHandler;
-    /** Fired for smart reply recommendations during a meeting (invoke). */
-    meetingSmartReply?: TeamsActivityHandler;
-    /** Fired for emoji reactions during a meeting. */
-    meetingReaction?: TeamsActivityHandler;
-    /** Fired when a poll response is submitted during a meeting. */
-    meetingPollResponse?: TeamsActivityHandler;
-    /** Fired when apps are installed during a meeting. */
-    meetingAppsInstalled?: TeamsActivityHandler;
-    /** Fired when apps are uninstalled during a meeting. */
-    meetingAppsUninstalled?: TeamsActivityHandler;
-    /** Fired when meeting recording starts. */
-    meetingRecordingStarted?: TeamsActivityHandler;
-    /** Fired when meeting recording stops. */
-    meetingRecordingStopped?: TeamsActivityHandler;
-    /** Fired when the meeting focus changes. */
-    meetingFocusChange?: TeamsActivityHandler;
-    /** Fired when screen sharing starts in a meeting. */
-    meetingScreenShareStart?: TeamsActivityHandler;
-    /** Fired when screen sharing stops in a meeting. */
-    meetingScreenShareStop?: TeamsActivityHandler;
-}
-/**
- * Aggregate Teams handler surface grouped by capability.
- *
- * This keeps the public API centered on Teams concepts without exposing
- * Microsoft's `AgentApplication` routing types.
- */
-interface TeamsActivityHandlers extends TeamsConversationUpdateHandlers, TeamsMessageActivityHandlers, TeamsCardActionHandlers, TeamsConfigHandlers, TeamsTaskModuleHandlers, TeamsMessageExtensionHandlers, TeamsTabHandlers, TeamsMeetingHandlers {
-    invoke?: TeamsActivityHandler;
-}
-interface TeamsChannelOptions extends Omit<M365ChannelOptions, "prepareTurn"> {
-    /**
-     * Whether malformed Teams channelData should throw while parsing.
-     *
-     * Keep this enabled in tests and strict hosts that want SDK payload drift to
-     * fail fast. Disable it in production bots that should continue handling the
-     * turn with best-effort Teams metadata when an unexpected channelData shape
-     * arrives.
-     *
-     * @default true
-     */
-    strictChannelData?: boolean;
-    /**
-     * Teams-native turn preparation hook. The result is forwarded into the
-     * underlying M365 channel adapter.
-     */
-    prepareTurn?: (request: TeamsTurnRequestContext) => TeamsTurnPreparation | Promise<TeamsTurnPreparation>;
-    /**
-     * Teams-specific activity hooks that run before generic M365 handling.
-     *
-     * Notes:
-     * - the `"feedback"` kind falls through to `cardSubmit` when
-     *   `feedbackSubmit` is not defined
-     * - specialized Teams invoke kinds fall back to grouped handlers such as
-     *   `dialogOpen`, `searchCommand`, or `selectResult` when the narrow handler
-     *   is not provided
-     */
-    handlers?: TeamsActivityHandlers;
-    /**
-     * General-purpose middleware that runs on every turn before cuylabs
-     * processing. Gives raw `TurnContext` access for Microsoft SDK helpers
-     * or custom logic. Call `next()` to continue into the normal handler
-     * pipeline, or return without calling it to short-circuit.
-     */
-    onTurn?: (context: TurnContext, next: () => Promise<void>) => Promise<void>;
-}
-interface TeamsChannelAdapter extends M365ChannelAdapter {
-    /**
-     * The underlying generic M365 adapter used for ordinary message turns.
-     */
-    readonly m365: M365ChannelAdapter;
-}
+import { M365AmbientTurnContext } from '@cuylabs/agent-channel-m365';
+import { Attachment, Activity } from '@microsoft/agents-activity';
+export { BatchFailedEntriesResponse, BatchOperationResponse, BatchOperationStateResponse, CancelOperationResponse, ChannelInfo, FeedbackLoopData, MeetingNotification, NotificationInfo, OnBehalfOf, TeamDetails, TeamInfo, TeamsAttachmentDownloader, TeamsChannelAccount, TeamsChannelData, TeamsChannelDataSettings, TeamsInfo, TeamsMeetingInfo, TeamsMember, TeamsPagedMembersResult, TenantInfo, parseTeamsChannelData } from '@microsoft/agents-hosting-extensions-teams';
+export { Conversation, ConversationBuilder, ConversationClaims, ConversationReference, ConversationReferenceBuilder, CreateConversationOptions, CreateConversationOptionsBuilder, M365ConversationInput, M365ConversationRecord, ProactiveIdentity, captureM365ConversationReference, continueM365Conversation, restoreM365ConversationReference } from '@cuylabs/agent-channel-m365/proactive';
 
 declare function createTeamsChannelAdapter(options: TeamsChannelOptions): TeamsChannelAdapter;
 
@@ -333,6 +127,27 @@ declare function createTeamsApprovalRequestCard(input: TeamsApprovalCardRequest,
 declare function createTeamsHumanInputRequestCard(input: TeamsHumanInputCardRequest, options?: TeamsHumanInputCardOptions): Attachment;
 declare function parseTeamsInputRequestSubmit(value: unknown): TeamsInputRequestSubmit | undefined;
 
+/**
+ * Returns `true` when the activity carries an `activityTreatment: targeted`
+ * entity.
+ *
+ * Targeted activities are surfaced only to the recipient inside a group
+ * Teams conversation. This is a Teams-only concept; for non-group
+ * conversations Teams clients should not add the treatment.
+ */
+declare function isTargetedTeamsActivity(context: TurnContext): boolean;
+/**
+ * Marks an outbound activity as targeted for Teams group conversations.
+ *
+ * This helper mutates the activity by adding the `activityTreatment: targeted`
+ * entity. It is idempotent and returns the same activity for chaining. Teams
+ * only honors this treatment in group chat / channel contexts; callers may use
+ * it before `TurnContext.sendActivity()` applies the conversation reference.
+ *
+ * Use when sending a reply that should only be visible to one recipient inside
+ * a group chat or channel thread.
+ */
+declare function makeTargetedTeamsActivity(activity: Activity): Activity;
 interface ParseTeamsActivityOptions {
     strictChannelData?: boolean;
 }
@@ -360,4 +175,4 @@ declare const TEAMS_MEETING_INVOKE_NAMES: Readonly<Record<string, TeamsActivityK
 declare function parseTeamsActivity(context: TurnContext, options?: ParseTeamsActivityOptions): TeamsActivityInfo;
 declare function parseTeamsActivitySafe(context: TurnContext): TeamsActivityInfo;
 
-export { type MountTeamsAgentOptions, type MountTeamsAgentResult, type ParseTeamsActivityOptions, TEAMS_ACTIONABLE_MESSAGE_NAMES, TEAMS_ADAPTIVE_CARD_ACTION_NAMES, TEAMS_ADAPTIVE_CARD_SEARCH_NAMES, TEAMS_CARD_ACTION_SUBMIT_NAMES, TEAMS_CONFIG_FETCH_NAMES, TEAMS_CONFIG_SUBMIT_NAMES, TEAMS_CONVERSATION_UPDATE_EVENT_NAMES, TEAMS_FILE_CONSENT_NAMES, TEAMS_INPUT_REQUEST_APPROVAL_VERB, TEAMS_INPUT_REQUEST_HUMAN_VERB, TEAMS_MEETING_EVENT_NAMES, TEAMS_MEETING_INVOKE_NAMES, TEAMS_MESSAGE_EXTENSION_CARD_BUTTON_CLICKED_NAMES, TEAMS_MESSAGE_EXTENSION_FETCH_TASK_NAMES, TEAMS_MESSAGE_EXTENSION_QUERY_NAMES, TEAMS_MESSAGE_EXTENSION_QUERY_SETTING_URL_NAMES, TEAMS_MESSAGE_EXTENSION_SELECT_NAMES, TEAMS_MESSAGE_EXTENSION_SETTING_NAMES, TEAMS_MESSAGE_EXTENSION_SUBMIT_ACTION_NAMES, TEAMS_TAB_FETCH_NAMES, TEAMS_TAB_SUBMIT_NAMES, TEAMS_TASK_MODULE_FETCH_NAMES, TEAMS_TASK_MODULE_SUBMIT_NAMES, type TeamsActivityHandler, type TeamsActivityHandlers, type TeamsActivityInfo, type TeamsActivityKind, type TeamsActorReference, type TeamsAmbientTurnContext, type TeamsApprovalCardOptions, type TeamsApprovalCardRequest, type TeamsCardActionHandlers, type TeamsChannelAdapter, type TeamsChannelOptions, type TeamsConfigHandlers, type TeamsConversationUpdateHandlers, type TeamsDialogDefinition, type TeamsDialogMessageBody, type TeamsDialogResponse, type TeamsDialogSize, type TeamsHandlerContext, type TeamsHandlerDecision, type TeamsHumanInputCardOptions, type TeamsHumanInputCardRequest, type TeamsInputRequestEnvelope, type TeamsInputRequestSubmit, type TeamsInputRequestVerb, type TeamsInvokeResult, type TeamsMeetingHandlers, type TeamsMessageActivityHandlers, type TeamsMessageExtensionHandlers, type TeamsResolveInputPayload, type TeamsSearchAttachment, type TeamsSearchLayout, type TeamsSearchMessageBody, type TeamsSearchResponse, type TeamsSearchResult, type TeamsSearchResultBody, type TeamsSearchResultType, type TeamsSurface, type TeamsTabHandlers, type TeamsTaskModuleHandlers, type TeamsTurnPreparation, type TeamsTurnRequestContext, createTeamsApprovalRequestCard, createTeamsChannelAdapter, createTeamsDialog, createTeamsDialogMessage, createTeamsHumanInputRequestCard, createTeamsInvokeActivity, createTeamsSearchMessage, createTeamsSearchResult, currentTeamsTurnContext, mountTeamsAgent, parseTeamsActivity, parseTeamsActivitySafe, parseTeamsInputRequestSubmit, runWithTeamsTurnContext, sendTeamsInvoke };
+export { type MountTeamsAgentOptions, type MountTeamsAgentResult, type ParseTeamsActivityOptions, TEAMS_ACTIONABLE_MESSAGE_NAMES, TEAMS_ADAPTIVE_CARD_ACTION_NAMES, TEAMS_ADAPTIVE_CARD_SEARCH_NAMES, TEAMS_CARD_ACTION_SUBMIT_NAMES, TEAMS_CONFIG_FETCH_NAMES, TEAMS_CONFIG_SUBMIT_NAMES, TEAMS_CONVERSATION_UPDATE_EVENT_NAMES, TEAMS_FILE_CONSENT_NAMES, TEAMS_INPUT_REQUEST_APPROVAL_VERB, TEAMS_INPUT_REQUEST_HUMAN_VERB, TEAMS_MEETING_EVENT_NAMES, TEAMS_MEETING_INVOKE_NAMES, TEAMS_MESSAGE_EXTENSION_CARD_BUTTON_CLICKED_NAMES, TEAMS_MESSAGE_EXTENSION_FETCH_TASK_NAMES, TEAMS_MESSAGE_EXTENSION_QUERY_NAMES, TEAMS_MESSAGE_EXTENSION_QUERY_SETTING_URL_NAMES, TEAMS_MESSAGE_EXTENSION_SELECT_NAMES, TEAMS_MESSAGE_EXTENSION_SETTING_NAMES, TEAMS_MESSAGE_EXTENSION_SUBMIT_ACTION_NAMES, TEAMS_TAB_FETCH_NAMES, TEAMS_TAB_SUBMIT_NAMES, TEAMS_TASK_MODULE_FETCH_NAMES, TEAMS_TASK_MODULE_SUBMIT_NAMES, TeamsActivityInfo, TeamsActivityKind, type TeamsAmbientTurnContext, type TeamsApprovalCardOptions, type TeamsApprovalCardRequest, TeamsChannelAdapter, TeamsChannelOptions, type TeamsDialogDefinition, type TeamsDialogMessageBody, type TeamsDialogResponse, type TeamsDialogSize, type TeamsHumanInputCardOptions, type TeamsHumanInputCardRequest, type TeamsInputRequestEnvelope, type TeamsInputRequestSubmit, type TeamsInputRequestVerb, type TeamsResolveInputPayload, type TeamsSearchAttachment, type TeamsSearchLayout, type TeamsSearchMessageBody, type TeamsSearchResponse, type TeamsSearchResult, type TeamsSearchResultBody, type TeamsSearchResultType, createTeamsApprovalRequestCard, createTeamsChannelAdapter, createTeamsDialog, createTeamsDialogMessage, createTeamsHumanInputRequestCard, createTeamsSearchMessage, createTeamsSearchResult, currentTeamsTurnContext, isTargetedTeamsActivity, makeTargetedTeamsActivity, mountTeamsAgent, parseTeamsActivity, parseTeamsActivitySafe, parseTeamsInputRequestSubmit, runWithTeamsTurnContext };