aec-agent 1.0.3 → 1.0.4

package/dist/components/channel-platform-hub/teams/teams-adapter.js

@@ -0,0 +1,333 @@
+import { createPublicKey, verify } from "node:crypto";
+import { ADAPTER_REQUEST_TIMEOUT_MS, errorMessage, MAX_RETRY_AFTER_S, PlatformApiError, retryAfterHeader, sleep, } from "../adapter-kit.js";
+// ---------------------------------------------------------------------------
+// Microsoft Teams channel (A-100 phase 3) over the Bot Framework — no dependency.
+//
+// Teams cannot be polled: the Bot Framework POSTs every activity to the bot's
+// messaging endpoint, so the host must be reachable from the internet. In the
+// Azure Bot resource set the messaging endpoint to
+//   https://<host>/webhooks/channels/<channel id>
+// and add the Teams channel. Credentials: the bot's Microsoft App ID and a
+// client secret, plus the tenant id for a single-tenant bot.
+//
+// Inbound: every request carries a JWT signed by the Bot Framework; it is
+// checked (signature against the published keys, issuer, audience = app id,
+// lifetime, serviceUrl) before anything is read. Outbound: replies go to the
+// activity's serviceUrl with a token from Microsoft Entra (client credentials).
+// A conversation's serviceUrl is only known once it has sent a message, so the
+// bot cannot write first after a restart until then.
+// ---------------------------------------------------------------------------
+const DEFAULT_OPENID_METADATA_URL = "https://login.botframework.com/v1/.well-known/openidconfiguration";
+const BOT_FRAMEWORK_ISSUER = "https://api.botframework.com";
+const TOKEN_SCOPE = "https://api.botframework.com/.default";
+const MAX_MESSAGE_LENGTH = 4000;
+/** Clock skew allowed on token lifetimes. */
+const CLOCK_SKEW_S = 300;
+/** Signing keys are read again after this long, or sooner for an unknown key id. */
+const KEYS_TTL_MS = 24 * 60 * 60 * 1000;
+const KEYS_MIN_REFRESH_MS = 5 * 60 * 1000;
+const MAX_CONVERSATIONS = 10_000;
+/** The Microsoft Teams platform, for AgentCore.useChannelPlatform. Needs "appId" and "appPassword"; "tenantId" is optional. */
+export function teamsPlatform(options = {}) {
+    return {
+        name: "teams",
+        displayName: "Microsoft Teams",
+        credentialKeys: ["appId", "appPassword"],
+        optionalCredentialKeys: ["tenantId"],
+        ingress: "webhook",
+        create: (channel) => new TeamsAdapter({
+            ...options,
+            appId: channel.credentials["appId"] ?? "",
+            appPassword: channel.credentials["appPassword"] ?? "",
+            ...(channel.credentials["tenantId"] ? { tenantId: channel.credentials["tenantId"] } : {}),
+        }),
+    };
+}
+export class TeamsAdapter {
+    options;
+    capabilities = { maxMessageLength: MAX_MESSAGE_LENGTH, markdown: true, buttons: true };
+    fetchFn;
+    now;
+    controller = new AbortController();
+    sink;
+    token;
+    keys;
+    /** conversation id -> the serviceUrl its activities came from (verified). */
+    serviceUrls = new Map();
+    constructor(options) {
+        this.options = options;
+        this.fetchFn = options.fetch ?? fetch;
+        this.now = options.now ?? Date.now;
+    }
+    async start(sink) {
+        if (!this.options.appId || !this.options.appPassword)
+            throw new Error("Microsoft Teams needs the bot's app id and a client secret");
+        try {
+            // Checks the credentials: a token is only issued for a valid app id and secret.
+            await this.accessToken();
+        }
+        catch (err) {
+            if (err instanceof PlatformApiError && (err.status === 400 || err.status === 401)) {
+                throw new Error(`Microsoft rejected the app id or client secret${err.code ? ` (${err.code})` : ""}`);
+            }
+            throw err;
+        }
+        this.sink = sink;
+        return { id: this.options.appId, displayName: "Teams bot" };
+    }
+    async stop() {
+        this.controller.abort();
+        this.sink = undefined;
+    }
+    async handleWebhook(request) {
+        if (request.method.toUpperCase() !== "POST")
+            return { status: 405 };
+        let activity;
+        try {
+            activity = JSON.parse(request.body);
+        }
+        catch {
+            return { status: 400, body: { error: "The body is not JSON" } };
+        }
+        let claims;
+        try {
+            claims = await this.verifyToken(request.headers["authorization"] ?? "");
+        }
+        catch (err) {
+            return { status: 401, body: { error: `Unauthorized: ${errorMessage(err)}` } };
+        }
+        if (claims.serviceurl && activity.serviceUrl && trimSlash(claims.serviceurl) !== trimSlash(activity.serviceUrl)) {
+            return { status: 401, body: { error: "Unauthorized: the serviceUrl does not match the token" } };
+        }
+        if (activity.conversation?.id && activity.serviceUrl)
+            this.rememberServiceUrl(activity.conversation.id, activity.serviceUrl);
+        if (activity.type === "message")
+            this.onMessage(activity);
+        return { status: 200, body: {} };
+    }
+    async send(target, message) {
+        const serviceUrl = this.serviceUrlFor(target.chatId);
+        const sent = await this.withRetry(() => this.connector("POST", serviceUrl, `/v3/conversations/${encodeURIComponent(target.chatId)}/activities`, {
+            ...this.activity(message),
+            ...(target.replyToMessageId ? { replyToId: target.replyToMessageId } : {}),
+        }));
+        return { chatId: target.chatId, messageId: sent?.id ?? "" };
+    }
+    async edit(ref, message) {
+        if (!ref.messageId)
+            return;
+        const serviceUrl = this.serviceUrlFor(ref.chatId);
+        await this.withRetry(() => this.connector("PUT", serviceUrl, `/v3/conversations/${encodeURIComponent(ref.chatId)}/activities/${encodeURIComponent(ref.messageId)}`, { ...this.activity(message), id: ref.messageId }));
+    }
+    async sendTyping(target) {
+        const serviceUrl = this.serviceUrlFor(target.chatId);
+        await this.connector("POST", serviceUrl, `/v3/conversations/${encodeURIComponent(target.chatId)}/activities`, { type: "typing" });
+    }
+    // ---------------------------------------------------------------------------
+    onMessage(activity) {
+        const sink = this.sink;
+        const conversation = activity.conversation;
+        const from = activity.from;
+        if (!sink || !conversation?.id || !from?.id || !activity.id)
+            return;
+        const chat = {
+            id: conversation.id,
+            type: conversation.conversationType === "personal" ? "dm" : "group",
+            ...(conversation.name ? { title: conversation.name } : {}),
+        };
+        const sender = {
+            // The Entra object id is stable across chats and tenants' bots; the Teams id is the fallback.
+            id: from.aadObjectId ?? from.id,
+            ...(from.name ? { name: from.name } : {}),
+            ...(from.role === "bot" ? { isBot: true } : {}),
+        };
+        // An Adaptive Card button (Action.Submit) arrives as a message with a value.
+        const data = activity.value && typeof activity.value === "object" ? activity.value.aec : undefined;
+        if (typeof data === "string") {
+            sink.button({ chat, sender, messageId: activity.replyToId ?? activity.id, data });
+            return;
+        }
+        const botId = activity.recipient?.id;
+        let text = activity.text ?? "";
+        let mentionsBot = false;
+        for (const entity of activity.entities ?? []) {
+            if (entity.type === "mention" && botId && entity.mentioned?.id === botId) {
+                mentionsBot = true;
+                if (entity.text)
+                    text = text.split(entity.text).join(" ");
+            }
+        }
+        text = decodeEntities(text.replace(/<\/?at>/g, "").replace(/<[^>]+>/g, "")).replace(/[ \t]{2,}/g, " ").trim();
+        const message = {
+            messageId: activity.id,
+            chat,
+            sender,
+            text,
+            ...(mentionsBot ? { mentionsBot: true } : {}),
+        };
+        sink.message(message);
+    }
+    /** A message activity: Markdown text, or an Adaptive Card when it has buttons. */
+    activity(message) {
+        const textFormat = message.format === "markdown" ? "markdown" : "plain";
+        if (!message.buttons?.length)
+            return { type: "message", text: message.text, textFormat, attachments: [] };
+        return {
+            type: "message",
+            attachments: [
+                {
+                    contentType: "application/vnd.microsoft.card.adaptive",
+                    content: {
+                        type: "AdaptiveCard",
+                        $schema: "http://adaptivecards.io/schemas/adaptive-card.json",
+                        version: "1.4",
+                        body: [{ type: "TextBlock", text: message.text, wrap: true }],
+                        actions: message.buttons.flat().map(submitAction),
+                    },
+                },
+            ],
+        };
+    }
+    serviceUrlFor(conversationId) {
+        const url = this.serviceUrls.get(conversationId);
+        if (!url)
+            throw new Error("This Teams conversation has not sent the bot a message since the server started");
+        return url;
+    }
+    rememberServiceUrl(conversationId, serviceUrl) {
+        if (this.serviceUrls.size >= MAX_CONVERSATIONS && !this.serviceUrls.has(conversationId)) {
+            const oldest = this.serviceUrls.keys().next().value;
+            if (oldest !== undefined)
+                this.serviceUrls.delete(oldest);
+        }
+        this.serviceUrls.set(conversationId, serviceUrl);
+    }
+    // -- Outbound auth -----------------------------------------------------------
+    async accessToken() {
+        if (this.token && this.token.expiresAt - 5 * 60_000 > this.now())
+            return this.token.value;
+        const tenant = this.options.tenantId?.trim() || "botframework.com";
+        const url = this.options.tokenUrl ?? `https://login.microsoftonline.com/${encodeURIComponent(tenant)}/oauth2/v2.0/token`;
+        const res = await this.fetchFn(url, {
+            method: "POST",
+            headers: { "content-type": "application/x-www-form-urlencoded" },
+            body: new URLSearchParams({
+                grant_type: "client_credentials",
+                client_id: this.options.appId,
+                client_secret: this.options.appPassword,
+                scope: TOKEN_SCOPE,
+            }).toString(),
+            signal: AbortSignal.any([this.controller.signal, AbortSignal.timeout(ADAPTER_REQUEST_TIMEOUT_MS)]),
+        });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok || !data.access_token) {
+            throw new PlatformApiError(res.status, `Microsoft token request failed: ${data.error ?? `HTTP ${res.status}`}`, undefined, data.error);
+        }
+        this.token = { value: data.access_token, expiresAt: this.now() + (data.expires_in ?? 3600) * 1000 };
+        return data.access_token;
+    }
+    async withRetry(call) {
+        try {
+            return await call();
+        }
+        catch (err) {
+            if (!(err instanceof PlatformApiError) || err.status !== 429 || !err.retryAfter || err.retryAfter > MAX_RETRY_AFTER_S)
+                throw err;
+            await sleep(err.retryAfter * 1000, this.controller.signal);
+            return call();
+        }
+    }
+    /** One Bot Connector call. Only made to a serviceUrl taken from a verified activity. */
+    async connector(method, serviceUrl, path, body) {
+        const token = await this.accessToken();
+        const res = await this.fetchFn(`${trimSlash(serviceUrl)}${path}`, {
+            method,
+            headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
+            body: JSON.stringify(body),
+            signal: AbortSignal.any([this.controller.signal, AbortSignal.timeout(ADAPTER_REQUEST_TIMEOUT_MS)]),
+        });
+        if (!res.ok) {
+            const data = (await res.json().catch(() => ({})));
+            throw new PlatformApiError(res.status, `Teams ${method} activity failed: ${data.error?.message ?? data.error?.code ?? `HTTP ${res.status}`}`, res.status === 429 ? (retryAfterHeader(res) ?? 1) : undefined, data.error?.code);
+        }
+        return (await res.json().catch(() => undefined));
+    }
+    // -- Inbound auth (Bot Framework JWT) ----------------------------------------
+    async verifyToken(authorization) {
+        const match = /^Bearer\s+(\S+)$/i.exec(authorization.trim());
+        if (!match)
+            throw new Error("no bearer token");
+        const parts = match[1].split(".");
+        if (parts.length !== 3)
+            throw new Error("malformed token");
+        const [rawHeader, rawPayload, rawSignature] = parts;
+        let header;
+        let claims;
+        try {
+            header = JSON.parse(Buffer.from(rawHeader, "base64url").toString("utf8"));
+            claims = JSON.parse(Buffer.from(rawPayload, "base64url").toString("utf8"));
+        }
+        catch {
+            throw new Error("malformed token");
+        }
+        if (header.alg !== "RS256" || !header.kid)
+            throw new Error("unsupported token algorithm");
+        const jwk = await this.signingKey(header.kid);
+        const key = createPublicKey({ key: { ...jwk }, format: "jwk" });
+        const signed = Buffer.from(`${rawHeader}.${rawPayload}`);
+        if (!verify("RSA-SHA256", signed, key, Buffer.from(rawSignature, "base64url")))
+            throw new Error("bad signature");
+        if (claims.iss !== BOT_FRAMEWORK_ISSUER)
+            throw new Error("wrong issuer");
+        const audiences = Array.isArray(claims.aud) ? claims.aud : [claims.aud];
+        if (!audiences.includes(this.options.appId))
+            throw new Error("wrong audience");
+        const nowS = this.now() / 1000;
+        if (typeof claims.exp !== "number" || claims.exp + CLOCK_SKEW_S < nowS)
+            throw new Error("token expired");
+        if (typeof claims.nbf === "number" && claims.nbf - CLOCK_SKEW_S > nowS)
+            throw new Error("token not valid yet");
+        return claims;
+    }
+    /** The Bot Framework's signing key with this id, from its OpenID metadata (cached). */
+    async signingKey(kid) {
+        const fresh = this.keys && this.now() - this.keys.loadedAt < KEYS_TTL_MS;
+        const known = this.keys?.byId.get(kid);
+        if (known && fresh)
+            return known;
+        // An unknown key id reloads the keys, at most every few minutes.
+        if (!this.keys || !fresh || this.now() - this.keys.loadedAt > KEYS_MIN_REFRESH_MS)
+            await this.loadKeys();
+        const key = this.keys?.byId.get(kid);
+        if (!key)
+            throw new Error("unknown signing key");
+        return key;
+    }
+    async loadKeys() {
+        const signal = AbortSignal.any([this.controller.signal, AbortSignal.timeout(ADAPTER_REQUEST_TIMEOUT_MS)]);
+        const meta = (await (await this.fetchFn(this.options.openIdMetadataUrl ?? DEFAULT_OPENID_METADATA_URL, { signal })).json());
+        if (!meta.jwks_uri)
+            throw new Error("the Bot Framework's OpenID metadata has no jwks_uri");
+        const jwks = (await (await this.fetchFn(meta.jwks_uri, { signal })).json());
+        const byId = new Map();
+        for (const key of jwks.keys ?? []) {
+            // Keys endorsed for other channels only are not used for Teams.
+            if (!key.kid || key.kty !== "RSA")
+                continue;
+            if (Array.isArray(key.endorsements) && key.endorsements.length && !key.endorsements.includes("msteams"))
+                continue;
+            byId.set(key.kid, { kty: key.kty, n: key.n, e: key.e });
+        }
+        this.keys = { byId, loadedAt: this.now() };
+    }
+}
+function submitAction(button) {
+    return { type: "Action.Submit", title: button.label, data: { aec: button.data } };
+}
+function trimSlash(url) {
+    return url.replace(/\/+$/, "");
+}
+function decodeEntities(text) {
+    return text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&amp;/g, "&");
+}
+//# sourceMappingURL=teams-adapter.js.map

package/dist/components/channel-platform-hub/teams/teams-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams-adapter.js","sourceRoot":"","sources":["../../../../src/components/channel-platform-hub/teams/teams-adapter.ts"],"names":[],"mappings":"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"}

package/dist/components/channel-platform-hub/telegram/telegram-adapter.d.ts

@@ -0,0 +1,46 @@
+import type { ChannelAccountInfo, ChannelAdapter, ChannelCapabilities, ChannelBotCommand, ChannelMessageRef, ChannelPlatform, ChannelSink, ChannelTarget, OutboundMessage } from "../types.js";
+export interface TelegramAdapterOptions {
+    /** From @BotFather, e.g. "123456:ABC-DEF...". */
+    botToken: string;
+    /** Default https://api.telegram.org — for a local Bot API server or tests. */
+    apiBaseUrl?: string;
+    /** How long one getUpdates call waits for messages (default 30 s). */
+    pollTimeoutSeconds?: number;
+    /** Default: the global fetch. */
+    fetch?: typeof fetch;
+}
+/** The Telegram platform, for AgentCore.useChannelPlatform. A channel needs the "botToken" credential. */
+export declare function telegramPlatform(options?: Omit<TelegramAdapterOptions, "botToken">): ChannelPlatform;
+export declare class TelegramAdapter implements ChannelAdapter {
+    private options;
+    readonly capabilities: ChannelCapabilities;
+    private readonly baseUrl;
+    private readonly pollTimeoutSeconds;
+    private readonly fetchFn;
+    private controller;
+    private loop?;
+    private offset;
+    private bot?;
+    constructor(options: TelegramAdapterOptions);
+    start(sink: ChannelSink): Promise<ChannelAccountInfo>;
+    stop(): Promise<void>;
+    send(target: ChannelTarget, message: OutboundMessage): Promise<ChannelMessageRef>;
+    edit(ref: ChannelMessageRef, message: OutboundMessage): Promise<void>;
+    /** The bot's command list (setMyCommands), which Telegram shows when the user types "/". */
+    setCommands(commands: ChannelBotCommand[]): Promise<void>;
+    sendTyping(target: ChannelTarget): Promise<void>;
+    /**
+     * sendMessage / editMessageText with the message's text: Markdown as HTML, and
+     * plain text again when Telegram cannot parse the HTML. A 429 asking for a short
+     * wait is retried once.
+     */
+    private withFormat;
+    private callWithRetry;
+    /** A button press: acknowledged at once (stops the button's spinner), then handed to the sink. */
+    private onCallback;
+    private poll;
+    private toInbound;
+    /** One Bot API call. The token is only in the URL, never in an error message. */
+    private call;
+}
+//# sourceMappingURL=telegram-adapter.d.ts.map

package/dist/components/channel-platform-hub/telegram/telegram-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-adapter.d.ts","sourceRoot":"","sources":["../../../../src/components/channel-platform-hub/telegram/telegram-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EAEd,mBAAmB,EAEnB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,aAAa,EAEb,eAAe,EAChB,MAAM,aAAa,CAAC;AAyBrB,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iCAAiC;IACjC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,0GAA0G;AAC1G,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,IAAI,CAAC,sBAAsB,EAAE,UAAU,CAAM,GAAG,eAAe,CAOxG;AAED,qBAAa,eAAgB,YAAW,cAAc;IAWxC,OAAO,CAAC,OAAO;IAV3B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAA2E;IAErH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAgB;IAC7B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,GAAG,CAAC,CAAoC;IAEhD,YAAoB,OAAO,EAAE,sBAAsB,EAIlD;IAEK,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmB1D;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1B;IAEK,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAWtF;IAEK,IAAI,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1E;IAED,4FAA4F;IACtF,WAAW,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9D;IAEK,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrD;IAID;;;;OAIG;YACW,UAAU;YAcV,aAAa;IAU3B,kGAAkG;IAClG,OAAO,CAAC,UAAU;YAsBJ,IAAI;IAgDlB,OAAO,CAAC,SAAS;IA+BjB,iFAAiF;YACnE,IAAI;CAuBnB"}