86 lines
3.4 KiB
TypeScript
86 lines
3.4 KiB
TypeScript
import type { BlockStreamingCoalesceConfig, DmPolicy, GroupPolicy } from "./types.base.js";
|
|
import type { DmConfig } from "./types.messages.js";
|
|
|
|
export type MSTeamsWebhookConfig = {
|
|
/** Port for the webhook server. Default: 3978. */
|
|
port?: number;
|
|
/** Path for the messages endpoint. Default: /api/messages. */
|
|
path?: string;
|
|
};
|
|
|
|
/** Reply style for MS Teams messages. */
|
|
export type MSTeamsReplyStyle = "thread" | "top-level";
|
|
|
|
/** Channel-level config for MS Teams. */
|
|
export type MSTeamsChannelConfig = {
|
|
/** Require @mention to respond. Default: true. */
|
|
requireMention?: boolean;
|
|
/** Reply style: "thread" replies to the message, "top-level" posts a new message. */
|
|
replyStyle?: MSTeamsReplyStyle;
|
|
};
|
|
|
|
/** Team-level config for MS Teams. */
|
|
export type MSTeamsTeamConfig = {
|
|
/** Default requireMention for channels in this team. */
|
|
requireMention?: boolean;
|
|
/** Default reply style for channels in this team. */
|
|
replyStyle?: MSTeamsReplyStyle;
|
|
/** Per-channel overrides. Key is conversation ID (e.g., "19:...@thread.tacv2"). */
|
|
channels?: Record<string, MSTeamsChannelConfig>;
|
|
};
|
|
|
|
export type MSTeamsConfig = {
|
|
/** If false, do not start the MS Teams provider. Default: true. */
|
|
enabled?: boolean;
|
|
/** Optional provider capability tags used for agent/runtime guidance. */
|
|
capabilities?: string[];
|
|
/** Allow channel-initiated config writes (default: true). */
|
|
configWrites?: boolean;
|
|
/** Azure Bot App ID (from Azure Bot registration). */
|
|
appId?: string;
|
|
/** Azure Bot App Password / Client Secret. */
|
|
appPassword?: string;
|
|
/** Azure AD Tenant ID (for single-tenant bots). */
|
|
tenantId?: string;
|
|
/** Webhook server configuration. */
|
|
webhook?: MSTeamsWebhookConfig;
|
|
/** Direct message access policy (default: pairing). */
|
|
dmPolicy?: DmPolicy;
|
|
/** Allowlist for DM senders (AAD object IDs or UPNs). */
|
|
allowFrom?: Array<string>;
|
|
/** Optional allowlist for group/channel senders (AAD object IDs or UPNs). */
|
|
groupAllowFrom?: Array<string>;
|
|
/**
|
|
* Controls how group/channel messages are handled:
|
|
* - "open": groups bypass allowFrom; mention-gating applies
|
|
* - "disabled": block all group messages
|
|
* - "allowlist": only allow group messages from senders in groupAllowFrom/allowFrom
|
|
*/
|
|
groupPolicy?: GroupPolicy;
|
|
/** Outbound text chunk size (chars). Default: 4000. */
|
|
textChunkLimit?: number;
|
|
/** Merge streamed block replies before sending. */
|
|
blockStreamingCoalesce?: BlockStreamingCoalesceConfig;
|
|
/**
|
|
* Allowed host suffixes for inbound attachment downloads.
|
|
* Use ["*"] to allow any host (not recommended).
|
|
*/
|
|
mediaAllowHosts?: Array<string>;
|
|
/** Default: require @mention to respond in channels/groups. */
|
|
requireMention?: boolean;
|
|
/** Max group/channel messages to keep as history context (0 disables). */
|
|
historyLimit?: number;
|
|
/** Max DM turns to keep as history context. */
|
|
dmHistoryLimit?: number;
|
|
/** Per-DM config overrides keyed by user ID. */
|
|
dms?: Record<string, DmConfig>;
|
|
/** Default reply style: "thread" replies to the message, "top-level" posts a new message. */
|
|
replyStyle?: MSTeamsReplyStyle;
|
|
/** Per-team config. Key is team ID (from the /team/ URL path segment). */
|
|
teams?: Record<string, MSTeamsTeamConfig>;
|
|
/** Max media size in MB (default: 100MB for OneDrive upload support). */
|
|
mediaMaxMb?: number;
|
|
/** SharePoint site ID for file uploads in group chats/channels (e.g., "contoso.sharepoint.com,guid1,guid2"). */
|
|
sharePointSiteId?: string;
|
|
};
|