experimental-ash 0.26.0 → 0.28.0

package/dist/src/public/channels/slack/slackChannel.js

@@ -1,251 +1 @@
-import { createLogger } from "#internal/logging.js";
-import { buildSlackBinding, slackContinuationToken, } from "#public/channels/slack/api.js";
-import { buildSlackTurnMessage, collectInboundFileParts, createSlackFetchFile, } from "#public/channels/slack/attachments.js";
-import { defaultEvents, defaultInputRequestedHandler, defaultOnAppMention, defaultOnDirectMessage, } from "#public/channels/slack/defaults.js";
-import { parseAppMentionEvent, parseDirectMessageEvent, prependSlackContext, } from "#public/channels/slack/inbound.js";
-import { SLACK_CHANNEL_DEFAULT_ROUTE } from "#public/channels/slack/constants.js";
-import { handleInteractionPost } from "#public/channels/slack/interactions.js";
-import { mergeUploadPolicy, } from "#public/channels/upload-policy.js";
-import { verifySlackRequest } from "#public/channels/slack/verify.js";
-import { defineChannel, POST, } from "#public/definitions/defineChannel.js";
-const log = createLogger("slack.channel");
-function rebuildSlackContext(state, session, credentials) {
-    const { thread, slack } = buildSlackBinding({
-        botToken: credentials?.botToken,
-        channelId: state.channelId ?? "",
-        threadTs: state.threadTs ?? "",
-        teamId: state.teamId ?? undefined,
-        onThreadTsChanged(ts) {
-            state.threadTs = ts;
-            if (state.channelId) {
-                session.setContinuationToken(slackContinuationToken(state.channelId, ts));
-            }
-        },
-    });
-    return { thread, slack, session, state };
-}
-/**
- * Slack channel factory. Wires up the Slack webhook route, mention
- * dispatch, interaction handling, and a baseline set of typing /
- * error / connection-auth event handlers.
- *
- * Defaults apply per field — pass `onAppMention` to fully replace the
- * default mention pipeline (auth derivation + `"Thinking…"` typing),
- * or pass an `events[type]` handler to replace only that one event.
- * Fields you don't supply keep their defaults.
- */
-export function slackChannel(config = {}) {
-    const uploadPolicy = mergeUploadPolicy(config.uploadPolicy);
-    const slackFetchFile = createSlackFetchFile({ botToken: config.credentials?.botToken });
-    const onAppMention = config.onAppMention ?? defaultOnAppMention;
-    const onDirectMessage = config.onDirectMessage ?? defaultOnDirectMessage;
-    const mergedEvents = {
-        ...defaultEvents,
-        ...config.events,
-        "input.requested": config.events?.["input.requested"] ?? defaultInputRequestedHandler(),
-    };
-    return defineChannel({
-        kindHint: "slack",
-        state: {
-            channelId: null,
-            threadTs: null,
-            teamId: null,
-            triggeringUserId: null,
-            pendingToolCallMessage: null,
-            pendingAuthMessageTs: {},
-        },
-        fetchFile: slackFetchFile,
-        context(state, session) {
-            return rebuildSlackContext(state, session, config.credentials);
-        },
-        routes: [
-            POST(config.route ?? SLACK_CHANNEL_DEFAULT_ROUTE, async (req, { send, waitUntil }) => {
-                const body = await verifyInbound(req, config.credentials);
-                if (body === null)
-                    return new Response("unauthorized", { status: 401 });
-                const contentType = req.headers.get("content-type") ?? "";
-                if (contentType.includes("application/x-www-form-urlencoded")) {
-                    return handleInteractionPost(body, { send, waitUntil }, { config });
-                }
-                return handleEventPost({
-                    body,
-                    send,
-                    waitUntil,
-                    onAppMention,
-                    onDirectMessage,
-                    uploadPolicy,
-                    credentials: config.credentials,
-                });
-            }),
-        ],
-        async receive(input, { send }) {
-            const receiveArgs = input.args;
-            const channelId = receiveArgs.channelId;
-            if (!channelId || typeof channelId !== "string") {
-                throw new Error("slackChannel().receive requires args.channelId.");
-            }
-            const requestedThreadTs = typeof receiveArgs.threadTs === "string" ? receiveArgs.threadTs : "";
-            const initialMessage = receiveArgs.initialMessage;
-            if (initialMessage && requestedThreadTs.length > 0) {
-                throw new Error("slackChannel().receive: `threadTs` and `initialMessage` are mutually exclusive.");
-            }
-            let threadTs = requestedThreadTs;
-            if (initialMessage) {
-                const { thread } = buildSlackBinding({
-                    botToken: config.credentials?.botToken,
-                    channelId,
-                    threadTs: "",
-                    teamId: undefined,
-                });
-                const postInput = {
-                    card: initialMessage.card,
-                };
-                if (initialMessage.fallbackText !== undefined) {
-                    postInput.fallbackText = initialMessage.fallbackText;
-                }
-                const posted = await thread.post(postInput);
-                threadTs = posted.id;
-            }
-            return send(input.message, {
-                auth: input.auth,
-                continuationToken: slackContinuationToken(channelId, threadTs),
-                state: {
-                    channelId,
-                    threadTs: threadTs || null,
-                    teamId: null,
-                    triggeringUserId: null,
-                },
-            });
-        },
-        events: mergedEvents,
-    });
-}
-/**
- * Handles an inbound non-interactivity Slack POST: parses the JSON
- * envelope, answers the URL-verification challenge, routes
- * `app_mention` events through `onAppMention` and `message`
- * events with `channel_type: "im"` through `onDirectMessage`, and
- * dispatches matching events via {@link dispatchInboundMessage} under
- * `waitUntil`. Returns the route's `200 OK` Response in every case
- * (Slack only cares that the webhook ACKs immediately).
- */
-async function handleEventPost(input) {
-    let envelope;
-    try {
-        envelope = JSON.parse(input.body);
-    }
-    catch (error) {
-        log.warn("inbound webhook body is not valid JSON", { error });
-        return new Response("ok");
-    }
-    if (typeof envelope.challenge === "string") {
-        return new Response(envelope.challenge, {
-            status: 200,
-            headers: { "content-type": "text/plain" },
-        });
-    }
-    const mention = parseAppMentionEvent(envelope);
-    if (mention) {
-        input.waitUntil(dispatchInboundMessage({
-            kind: "app_mention",
-            message: mention,
-            handler: input.onAppMention,
-            send: input.send,
-            uploadPolicy: input.uploadPolicy,
-            credentials: input.credentials,
-        }));
-        return new Response("ok");
-    }
-    const dm = parseDirectMessageEvent(envelope);
-    if (dm) {
-        input.waitUntil(dispatchInboundMessage({
-            kind: "direct_message",
-            message: dm,
-            handler: input.onDirectMessage,
-            send: input.send,
-            uploadPolicy: input.uploadPolicy,
-            credentials: input.credentials,
-        }));
-        return new Response("ok");
-    }
-    return new Response("ok");
-}
-/**
- * Verifies the inbound Slack request and returns its raw body, or
- * `null` when verification fails. Failures are logged so misconfigured
- * deployments are visible — the route returns 401 to Slack.
- */
-async function verifyInbound(req, credentials) {
-    try {
-        return await verifySlackRequest(req, {
-            signingSecret: credentials?.signingSecret ??
-                (credentials?.webhookVerifier ? undefined : process.env.SLACK_SIGNING_SECRET),
-            webhookVerifier: credentials?.webhookVerifier,
-        });
-    }
-    catch (error) {
-        log.warn("slack inbound verification failed", { error });
-        return null;
-    }
-}
-/**
- * Runs the inbound handler for an `app_mention` or direct message and,
- * when it returns a non-null result, dispatches the message to the
- * runtime via `send`. Errors are caught and logged so a misbehaving
- * handler never crashes the webhook ACK.
- */
-async function dispatchInboundMessage(input) {
-    const { message, kind } = input;
-    const { thread, slack } = buildSlackBinding({
-        botToken: input.credentials?.botToken,
-        channelId: message.channelId,
-        threadTs: message.threadTs,
-        teamId: message.teamId,
-    });
-    const slackCtx = { thread, slack };
-    let result;
-    try {
-        result = await input.handler(slackCtx, message);
-    }
-    catch (error) {
-        log.error(`${kind} handler failed`, { error });
-        return;
-    }
-    if (result === null || result === undefined)
-        return;
-    const fileParts = await collectInboundFileParts({
-        mention: message,
-        thread,
-        policy: input.uploadPolicy,
-    });
-    const baseMessage = buildSlackTurnMessage(message.markdown, fileParts);
-    const inboundContext = {
-        channelId: message.channelId,
-        fullName: message.author?.fullName,
-        teamId: message.teamId,
-        threadTs: message.threadTs,
-        userId: message.author?.userId ?? "",
-        userName: message.author?.userName,
-    };
-    const turnMessage = inboundContext.userId
-        ? prependSlackContext(baseMessage, inboundContext)
-        : baseMessage;
-    try {
-        await input.send({
-            message: turnMessage,
-            modelContext: result.modelContext,
-        }, {
-            auth: result.auth,
-            continuationToken: slackContinuationToken(message.channelId, message.threadTs),
-            state: {
-                channelId: message.channelId,
-                threadTs: message.threadTs,
-                teamId: message.teamId ?? null,
-                triggeringUserId: inboundContext.userId || null,
-            },
-        });
-    }
-    catch (error) {
-        log.error(`${kind} delivery failed`, { error });
-    }
-}
+import{createLogger}from"#internal/logging.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{POST,defineChannel}from"#public/definitions/defineChannel.js";import{buildSlackBinding,slackContinuationToken}from"#public/channels/slack/api.js";import{defaultEvents,defaultInputRequestedHandler,defaultOnAppMention,defaultOnDirectMessage}from"#public/channels/slack/defaults.js";import{buildSlackTurnMessage,collectInboundFileParts,createSlackFetchFile}from"#public/channels/slack/attachments.js";import{parseAppMentionEvent,parseDirectMessageEvent,prependSlackContext}from"#public/channels/slack/inbound.js";import{SLACK_CHANNEL_DEFAULT_ROUTE}from"#public/channels/slack/constants.js";import{handleInteractionPost}from"#public/channels/slack/interactions.js";import{verifySlackRequest}from"#public/channels/slack/verify.js";var log=createLogger(`slack.channel`);function rebuildSlackContext(e,t,n){let{thread:r,slack:a}=buildSlackBinding({botToken:n?.botToken,channelId:e.channelId??``,threadTs:e.threadTs??``,teamId:e.teamId??void 0,onThreadTsChanged(n){e.threadTs=n,e.channelId&&t.setContinuationToken(slackContinuationToken(e.channelId,n))}});return{thread:r,slack:a,session:t,state:e}}function slackChannel(e={}){let l=mergeUploadPolicy(e.uploadPolicy),u=createSlackFetchFile({botToken:e.credentials?.botToken}),f=e.onAppMention??defaultOnAppMention,p=e.onDirectMessage??defaultOnDirectMessage,m={...defaultEvents,...e.events,"input.requested":e.events?.[`input.requested`]??defaultInputRequestedHandler()};return defineChannel({kindHint:`slack`,state:{channelId:null,threadTs:null,teamId:null,triggeringUserId:null,pendingToolCallMessage:null,pendingAuthMessageTs:{}},fetchFile:u,context(t,n){return rebuildSlackContext(t,n,e.credentials)},routes:[POST(e.route??SLACK_CHANNEL_DEFAULT_ROUTE,async(t,{send:n,waitUntil:r})=>{let i=await verifyInbound(t,e.credentials);return i===null?new Response(`unauthorized`,{status:401}):(t.headers.get(`content-type`)??``).includes(`application/x-www-form-urlencoded`)?handleInteractionPost(i,{send:n,waitUntil:r},{config:e}):handleEventPost({body:i,send:n,waitUntil:r,onAppMention:f,onDirectMessage:p,uploadPolicy:l,credentials:e.credentials})})],async receive(t,{send:n}){let r=t.args,a=r.channelId;if(!a||typeof a!=`string`)throw Error(`slackChannel().receive requires args.channelId.`);let o=typeof r.threadTs==`string`?r.threadTs:``,s=r.initialMessage;if(s&&o.length>0)throw Error("slackChannel().receive: `threadTs` and `initialMessage` are mutually exclusive.");let c=o;if(s){let{thread:t}=buildSlackBinding({botToken:e.credentials?.botToken,channelId:a,threadTs:``,teamId:void 0}),n={card:s.card};s.fallbackText!==void 0&&(n.fallbackText=s.fallbackText),c=(await t.post(n)).id}return n(t.message,{auth:t.auth,continuationToken:slackContinuationToken(a,c),state:{channelId:a,threadTs:c||null,teamId:null,triggeringUserId:null}})},events:m})}async function handleEventPost(e){let t;try{t=JSON.parse(e.body)}catch(e){return log.warn(`inbound webhook body is not valid JSON`,{error:e}),new Response(`ok`)}if(typeof t.challenge==`string`)return new Response(t.challenge,{status:200,headers:{"content-type":`text/plain`}});let n=parseAppMentionEvent(t);if(n)return e.waitUntil(dispatchInboundMessage({kind:`app_mention`,message:n,handler:e.onAppMention,send:e.send,uploadPolicy:e.uploadPolicy,credentials:e.credentials})),new Response(`ok`);let r=parseDirectMessageEvent(t);return r&&e.waitUntil(dispatchInboundMessage({kind:`direct_message`,message:r,handler:e.onDirectMessage,send:e.send,uploadPolicy:e.uploadPolicy,credentials:e.credentials})),new Response(`ok`)}async function verifyInbound(e,t){try{return await verifySlackRequest(e,{signingSecret:t?.signingSecret??(t?.webhookVerifier?void 0:process.env.SLACK_SIGNING_SECRET),webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`slack inbound verification failed`,{error:e}),null}}async function dispatchInboundMessage(e){let{message:t,kind:n}=e,{thread:r,slack:a}=buildSlackBinding({botToken:e.credentials?.botToken,channelId:t.channelId,threadTs:t.threadTs,teamId:t.teamId}),o={thread:r,slack:a},s;try{s=await e.handler(o,t)}catch(e){log.error(`${n} handler failed`,{error:e});return}if(s==null)return;let c=await collectInboundFileParts({mention:t,thread:r,policy:e.uploadPolicy}),d=buildSlackTurnMessage(t.markdown,c),f={channelId:t.channelId,fullName:t.author?.fullName,teamId:t.teamId,threadTs:t.threadTs,userId:t.author?.userId??``,userName:t.author?.userName},p=f.userId?prependSlackContext(d,f):d;try{await e.send({message:p,modelContext:s.modelContext},{auth:s.auth,continuationToken:slackContinuationToken(t.channelId,t.threadTs),state:{channelId:t.channelId,threadTs:t.threadTs,teamId:t.teamId??null,triggeringUserId:f.userId||null}})}catch(e){log.error(`${n} delivery failed`,{error:e})}}export{slackChannel};

package/dist/src/public/channels/slack/thread.js

@@ -1,45 +1 @@
-/**
- * Loads messages that are useful as background context for the current
- * Slack thread turn.
- *
- * Returns an empty array when `message` is the thread root. For thread
- * replies, refreshes the bound Slack thread and returns its recent
- * messages before the triggering message, filtered by {@link options}.
- * Formatting and model-message role choice stay with the caller.
- */
-export async function loadThreadContextMessages(thread, message, options = {}) {
-    if (isThreadRootMessage(message)) {
-        return [];
-    }
-    await thread.refresh();
-    const currentIndex = thread.recentMessages.findIndex((entry) => entry.ts === message.ts);
-    const candidateMessages = currentIndex === -1 ? thread.recentMessages : thread.recentMessages.slice(0, currentIndex);
-    const priorMessages = candidateMessages.filter((entry) => entry.threadTs === message.threadTs && entry.ts !== message.ts);
-    return applySinceBoundary(priorMessages, options.since);
-}
-function isThreadRootMessage(message) {
-    return message.threadTs === message.ts;
-}
-function findLastIndex(items, predicate) {
-    for (let index = items.length - 1; index >= 0; index -= 1) {
-        if (predicate(items[index])) {
-            return index;
-        }
-    }
-    return -1;
-}
-function applySinceBoundary(messages, since) {
-    const boundary = since ?? "thread-root";
-    if (typeof boundary === "function") {
-        const lastMatchingIndex = findLastIndex(messages, boundary);
-        return messages.slice(lastMatchingIndex + 1);
-    }
-    switch (boundary) {
-        case "thread-root":
-            return [...messages];
-        case "last-agent-reply": {
-            const lastAgentReplyIndex = findLastIndex(messages, (entry) => entry.isMe);
-            return messages.slice(lastAgentReplyIndex + 1);
-        }
-    }
-}
+async function loadThreadContextMessages(e,t,n={}){if(isThreadRootMessage(t))return[];await e.refresh();let r=e.recentMessages.findIndex(e=>e.ts===t.ts);return applySinceBoundary((r===-1?e.recentMessages:e.recentMessages.slice(0,r)).filter(e=>e.threadTs===t.threadTs&&e.ts!==t.ts),n.since)}function isThreadRootMessage(e){return e.threadTs===e.ts}function findLastIndex(e,t){for(let n=e.length-1;n>=0;--n)if(t(e[n]))return n;return-1}function applySinceBoundary(e,t){let n=t??`thread-root`;if(typeof n==`function`){let t=findLastIndex(e,n);return e.slice(t+1)}switch(n){case`thread-root`:return[...e];case`last-agent-reply`:{let t=findLastIndex(e,e=>e.isMe);return e.slice(t+1)}}}export{loadThreadContextMessages};

package/dist/src/public/channels/slack/verify.js

@@ -1,70 +1 @@
-/**
- * Slack inbound-webhook verification.
- *
- * The native channel replaces `createSlackAdapter`'s built-in HMAC
- * check with a self-contained verifier:
- *
- * 1. If the caller supplied a {@link SlackWebhookVerifier} (e.g.
- *    Connect's OIDC-based forwarder), delegate to it.
- * 2. Otherwise, recompute the Slack v0 HMAC and compare with
- *    `X-Slack-Signature`. Rejects requests older than five minutes to
- *    foil replay attacks.
- *
- * Returns the verified raw body string on success so the caller can
- * parse it without re-reading the request stream.
- */
-import { createHmac, timingSafeEqual } from "node:crypto";
-import { createLogger } from "#internal/logging.js";
-const log = createLogger("slack.verify");
-/**
- * Verifies an inbound Slack webhook and returns its raw body.
- *
- * Throws when neither a signing secret nor a custom verifier is
- * available, when signature/timestamp checks fail, or when the
- * caller-supplied verifier rejects.
- */
-export async function verifySlackRequest(request, options) {
-    const body = await request.text();
-    if (options.webhookVerifier !== undefined) {
-        const result = await options.webhookVerifier(request, body);
-        if (!result) {
-            throw new Error("slackChannel: inbound webhook verifier rejected the request.");
-        }
-        return typeof result === "string" ? result : body;
-    }
-    if (!options.signingSecret) {
-        throw new Error("slackChannel: missing signing secret. Pass credentials.signingSecret, " +
-            "set SLACK_SIGNING_SECRET, or supply credentials.webhookVerifier.");
-    }
-    const timestampHeader = request.headers.get("x-slack-request-timestamp") ?? "";
-    const signatureHeader = request.headers.get("x-slack-signature") ?? "";
-    if (!timestampHeader || !signatureHeader) {
-        throw new Error("slackChannel: inbound request missing Slack signature headers.");
-    }
-    const timestamp = Number(timestampHeader);
-    if (!Number.isFinite(timestamp)) {
-        throw new Error("slackChannel: inbound request has malformed timestamp.");
-    }
-    const maxSkew = options.maxSkewSeconds ?? 60 * 5;
-    const now = Math.floor(Date.now() / 1000);
-    if (Math.abs(now - timestamp) > maxSkew) {
-        throw new Error("slackChannel: inbound request timestamp outside allowed skew.");
-    }
-    const base = `v0:${timestampHeader}:${body}`;
-    const expected = `v0=${createHmac("sha256", options.signingSecret).update(base).digest("hex")}`;
-    if (!constantTimeCompare(expected, signatureHeader)) {
-        throw new Error("slackChannel: inbound request signature mismatch.");
-    }
-    return body;
-}
-function constantTimeCompare(a, b) {
-    if (a.length !== b.length)
-        return false;
-    try {
-        return timingSafeEqual(Buffer.from(a), Buffer.from(b));
-    }
-    catch (error) {
-        log.debug("timingSafeEqual threw", { error });
-        return false;
-    }
-}
+import{createLogger}from"#internal/logging.js";import{createHmac,timingSafeEqual}from"node:crypto";var log=createLogger(`slack.verify`);async function verifySlackRequest(e,n){let r=await e.text();if(n.webhookVerifier!==void 0){let t=await n.webhookVerifier(e,r);if(!t)throw Error(`slackChannel: inbound webhook verifier rejected the request.`);return typeof t==`string`?t:r}if(!n.signingSecret)throw Error(`slackChannel: missing signing secret. Pass credentials.signingSecret, set SLACK_SIGNING_SECRET, or supply credentials.webhookVerifier.`);let i=e.headers.get(`x-slack-request-timestamp`)??``,a=e.headers.get(`x-slack-signature`)??``;if(!i||!a)throw Error(`slackChannel: inbound request missing Slack signature headers.`);let o=Number(i);if(!Number.isFinite(o))throw Error(`slackChannel: inbound request has malformed timestamp.`);let s=n.maxSkewSeconds??300,c=Math.floor(Date.now()/1e3);if(Math.abs(c-o)>s)throw Error(`slackChannel: inbound request timestamp outside allowed skew.`);let l=`v0:${i}:${r}`;if(!constantTimeCompare(`v0=${createHmac(`sha256`,n.signingSecret).update(l).digest(`hex`)}`,a))throw Error(`slackChannel: inbound request signature mismatch.`);return r}function constantTimeCompare(e,t){if(e.length!==t.length)return!1;try{return timingSafeEqual(Buffer.from(e),Buffer.from(t))}catch(e){return log.debug(`timingSafeEqual threw`,{error:e}),!1}}export{verifySlackRequest};

package/dist/src/public/channels/teams/api.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Minimal Microsoft Teams Bot Framework Connector REST wrapper.
+ *
+ * The native Teams channel talks directly to the Bot Framework Activity
+ * protocol instead of exposing BotBuilder or Teams SDK objects through
+ * Ash public APIs.
+ */
+import { type JsonObject } from "#shared/json.js";
+/** Microsoft application id, materialized directly or from an async secret provider. */
+export type TeamsAppId = string | (() => string | Promise<string>);
+/** Microsoft application password, materialized directly or from an async secret provider. */
+export type TeamsAppPassword = string | (() => string | Promise<string>);
+/** Microsoft tenant id, materialized directly or from an async secret provider. */
+export type TeamsTenantId = string | (() => string | Promise<string>);
+/** Fetch implementation override used by tests or non-standard runtimes. */
+export type TeamsFetch = typeof fetch;
+/** Result shape accepted from a caller-owned Bot Connector token provider. */
+export type TeamsAccessTokenResult = string | {
+    readonly accessToken: string;
+    readonly expiresAt?: Date | number;
+};
+/** Caller-owned Bot Connector token provider. */
+export type TeamsTokenProvider = () => TeamsAccessTokenResult | Promise<TeamsAccessTokenResult>;
+/** Credentials used by the native Teams channel. */
+export interface TeamsCredentials {
+    readonly appId?: TeamsAppId;
+    readonly appPassword?: TeamsAppPassword;
+    readonly tenantId?: TeamsTenantId;
+    readonly tokenProvider?: TeamsTokenProvider;
+}
+/** Shared Teams API options. */
+export interface TeamsApiOptions {
+    readonly credentials?: TeamsCredentials;
+    readonly fetch?: TeamsFetch;
+    readonly loginBaseUrl?: string;
+}
+/** Raw Teams Connector API response body. */
+export interface TeamsApiResponse {
+    readonly status: number;
+    readonly ok: boolean;
+    readonly body: unknown;
+}
+/** Minimal ResourceResponse object returned by Teams write operations. */
+export interface TeamsPostedActivity {
+    /** Teams/Bot Framework activity id, when one was returned. */
+    readonly id: string;
+    /** Connector's raw JSON response. */
+    readonly raw: unknown;
+}
+/** Bot Framework channel account shape surfaced by the native Teams channel. */
+export interface TeamsChannelAccount {
+    readonly aadObjectId?: string;
+    readonly id: string;
+    readonly name?: string;
+    readonly role?: string;
+}
+/** Bot Framework mention entity shape used by Teams messages. */
+export interface TeamsMention {
+    readonly mentioned: TeamsChannelAccount;
+    readonly text: string;
+    readonly type: "mention";
+}
+/** Bot Framework/Teams attachment shape supported by Ash-owned APIs. */
+export interface TeamsAttachment {
+    readonly content?: JsonObject;
+    readonly contentType: string;
+    readonly contentUrl?: string;
+    readonly name?: string;
+}
+/** JSON body supported by Teams message endpoints used by Ash. */
+export interface TeamsMessageBody {
+    readonly attachments?: readonly TeamsAttachment[];
+    readonly channelData?: JsonObject;
+    readonly entities?: readonly TeamsMention[];
+    readonly inputHint?: string;
+    readonly speak?: string;
+    readonly suggestedActions?: JsonObject;
+    readonly text?: string;
+    readonly textFormat?: "markdown" | "plain" | "xml";
+}
+/** Outbound Bot Framework activity body sent through the Connector API. */
+export interface TeamsOutboundActivity extends TeamsMessageBody {
+    readonly conversation?: JsonObject;
+    readonly from?: TeamsChannelAccount;
+    readonly recipient?: TeamsChannelAccount;
+    readonly replyToId?: string;
+    readonly type: "message" | "typing";
+}
+/** Conservative text budget for one Teams bot message. */
+export declare const TEAMS_MESSAGE_TEXT_MAX_LENGTH: number;
+/** Builds the channel-local continuation token for one Teams conversation/thread. */
+export declare function teamsContinuationToken(input: {
+    readonly conversationId: string;
+    readonly replyToActivityId?: string | null;
+    readonly tenantId?: string | null;
+}): string;
+/** Resolves a Teams app id, falling back to `MICROSOFT_APP_ID` then `TEAMS_APP_ID`. */
+export declare function resolveTeamsAppId(appId?: TeamsAppId): Promise<string>;
+/** Resolves a Teams app password, falling back to `MICROSOFT_APP_PASSWORD` then `TEAMS_APP_PASSWORD`. */
+export declare function resolveTeamsAppPassword(appPassword?: TeamsAppPassword): Promise<string>;
+/** Resolves a Teams tenant id, falling back to `MICROSOFT_TENANT_ID` then `TEAMS_TENANT_ID`. */
+export declare function resolveTeamsTenantId(tenantId?: TeamsTenantId): Promise<string | undefined>;
+/** Resolves a Bot Connector access token, using a custom provider or client credentials. */
+export declare function resolveTeamsAccessToken(options?: TeamsApiOptions): Promise<string>;
+/** Low-level Bot Framework Connector API call. */
+export declare function callTeamsConnectorApi(input: TeamsApiOptions & {
+    readonly body?: TeamsOutboundActivity | JsonObject;
+    readonly method?: "DELETE" | "GET" | "POST" | "PUT";
+    readonly path: string;
+    readonly serviceUrl: string;
+}): Promise<TeamsApiResponse>;
+/** Sends a non-reply activity to one Teams conversation. */
+export declare function sendTeamsActivity(input: TeamsApiOptions & {
+    readonly body: TeamsOutboundActivity;
+    readonly conversationId: string;
+    readonly serviceUrl: string;
+}): Promise<TeamsPostedActivity>;
+/** Sends a reply activity to one Teams conversation activity. */
+export declare function replyToTeamsActivity(input: TeamsApiOptions & {
+    readonly activityId: string;
+    readonly body: TeamsOutboundActivity;
+    readonly conversationId: string;
+    readonly serviceUrl: string;
+}): Promise<TeamsPostedActivity>;
+/** Updates an existing Teams bot activity. */
+export declare function updateTeamsActivity(input: TeamsApiOptions & {
+    readonly activityId: string;
+    readonly body: TeamsOutboundActivity;
+    readonly conversationId: string;
+    readonly serviceUrl: string;
+}): Promise<TeamsPostedActivity>;
+/** Triggers Teams' typing indicator for one conversation. */
+export declare function triggerTeamsTypingIndicator(input: TeamsApiOptions & {
+    readonly conversationId: string;
+    readonly serviceUrl: string;
+}): Promise<void>;
+/** Splits text into chunks that fit Teams' conservative message-size budget. */
+export declare function splitTeamsMessageText(content: string): readonly string[];
+/** Normalizes a string or message body into a Teams message activity body. */
+export declare function normalizeTeamsPostInput(message: string | TeamsMessageBody): TeamsMessageBody;

package/dist/src/public/channels/teams/api.js

@@ -0,0 +1,4 @@
+import{isObject}from"#shared/guards.js";import{parseJsonObject}from"#shared/json.js";var TEAMS_MESSAGE_TEXT_MAX_LENGTH=80*1024,DEFAULT_LOGIN_BASE_URL=`https://login.microsoftonline.com`,BOT_FRAMEWORK_TENANT=`botframework.com`,BOT_FRAMEWORK_SCOPE=`https://api.botframework.com/.default`,accessTokenCache=new Map;function teamsContinuationToken(e){return[e.tenantId??`_`,e.conversationId,e.replyToActivityId??``].map(e=>encodeURIComponent(e)).join(`:`)}async function resolveTeamsAppId(e){let t=e??process.env.MICROSOFT_APP_ID??process.env.TEAMS_APP_ID;if(!t)throw Error(`MICROSOFT_APP_ID or TEAMS_APP_ID is required.`);return typeof t==`function`?await t():t}async function resolveTeamsAppPassword(e){let t=e??process.env.MICROSOFT_APP_PASSWORD??process.env.TEAMS_APP_PASSWORD;if(!t)throw Error(`MICROSOFT_APP_PASSWORD or TEAMS_APP_PASSWORD is required.`);return typeof t==`function`?await t():t}async function resolveTeamsTenantId(e){let t=e??process.env.MICROSOFT_TENANT_ID??process.env.TEAMS_TENANT_ID;if(t)return typeof t==`function`?await t():t}async function resolveTeamsAccessToken(t={}){let n=t.credentials;if(n?.tokenProvider!==void 0)return normalizeAccessTokenResult(await n.tokenProvider()).accessToken;let o=await resolveTeamsAppId(n?.appId),s=await resolveTeamsAppPassword(n?.appPassword),c=await resolveTeamsTenantId(n?.tenantId),l=trimTrailingSlash(t.loginBaseUrl??DEFAULT_LOGIN_BASE_URL),u=`${l}:${c??BOT_FRAMEWORK_TENANT}:${o}`,d=accessTokenCache.get(u),f=Date.now();if(d!==void 0&&d.expiresAt-6e4>f)return d.accessToken;let p=`${l}/${encodeURIComponent(c??BOT_FRAMEWORK_TENANT)}/oauth2/v2.0/token`,m=new URLSearchParams({client_id:o,client_secret:s,grant_type:`client_credentials`,scope:BOT_FRAMEWORK_SCOPE}),h=await(t.fetch??fetch)(p,{body:m,headers:{"content-type":`application/x-www-form-urlencoded`},method:`POST`}),g=await parseResponseBody(h);if(!h.ok)throw Error(`Teams access-token request failed with HTTP ${h.status}.`);let _=isObject(g)?g:{},v=typeof _.access_token==`string`?_.access_token:``;if(!v)throw Error(`Teams access-token response did not include access_token.`);let y=typeof _.expires_in==`number`?_.expires_in:3600;return accessTokenCache.set(u,{accessToken:v,expiresAt:f+y*1e3}),v}async function callTeamsConnectorApi(e){let n=e.fetch??fetch,r=new Headers;r.set(`authorization`,`Bearer ${await resolveTeamsAccessToken(e)}`),r.set(`content-type`,`application/json; charset=utf-8`);let i={headers:r,method:e.method??`POST`};e.body!==void 0&&(i.body=JSON.stringify(parseJsonObject(e.body)));let a=await n(`${trimTrailingSlash(e.serviceUrl)}${e.path}`,i);return{body:await parseResponseBody(a),ok:a.ok,status:a.status}}async function sendTeamsActivity(e){let t=await callTeamsConnectorApi({...e,body:e.body,path:`/v3/conversations/${encodeURIComponent(e.conversationId)}/activities`});if(!t.ok)throw Error(`Teams send activity failed with HTTP ${t.status}.`);return toPostedActivity(t.body)}async function replyToTeamsActivity(e){let t=await callTeamsConnectorApi({...e,body:e.body,path:`/v3/conversations/${encodeURIComponent(e.conversationId)}/activities/${encodeURIComponent(e.activityId)}`});if(!t.ok)throw Error(`Teams reply activity failed with HTTP ${t.status}.`);return toPostedActivity(t.body)}async function updateTeamsActivity(e){let t=await callTeamsConnectorApi({...e,body:e.body,method:`PUT`,path:`/v3/conversations/${encodeURIComponent(e.conversationId)}/activities/${encodeURIComponent(e.activityId)}`});if(!t.ok)throw Error(`Teams update activity failed with HTTP ${t.status}.`);return toPostedActivity(t.body)}async function triggerTeamsTypingIndicator(e){let t=await callTeamsConnectorApi({...e,body:{type:`typing`},path:`/v3/conversations/${encodeURIComponent(e.conversationId)}/activities`});if(!t.ok)throw Error(`Teams typing indicator failed with HTTP ${t.status}.`)}function splitTeamsMessageText(e){if(e.length<=81920)return[e];let t=[],r=e;for(;r.length>TEAMS_MESSAGE_TEXT_MAX_LENGTH;){let e=r.lastIndexOf(`
+
+`,TEAMS_MESSAGE_TEXT_MAX_LENGTH);e<=0&&(e=r.lastIndexOf(`
+`,TEAMS_MESSAGE_TEXT_MAX_LENGTH)),e<=0&&(e=r.lastIndexOf(` `,TEAMS_MESSAGE_TEXT_MAX_LENGTH)),e<=0&&(e=TEAMS_MESSAGE_TEXT_MAX_LENGTH),t.push(r.slice(0,e).trimEnd()),r=r.slice(e).trimStart()}return t.push(r),t}function normalizeTeamsPostInput(e){return typeof e==`string`?{text:e,textFormat:`markdown`}:e}function normalizeAccessTokenResult(e){if(typeof e==`string`)return{accessToken:e};let t=e.expiresAt instanceof Date?e.expiresAt.getTime():e.expiresAt;return{accessToken:e.accessToken,expiresAt:t}}function toPostedActivity(t){let n=isObject(t)?t:{};return{id:typeof n.id==`string`?n.id:``,raw:t}}function trimTrailingSlash(e){return e.replace(/\/+$/,``)}async function parseResponseBody(e){let t=await e.text();if(!t)return null;try{return JSON.parse(t)}catch{return t}}export{TEAMS_MESSAGE_TEXT_MAX_LENGTH,callTeamsConnectorApi,normalizeTeamsPostInput,replyToTeamsActivity,resolveTeamsAccessToken,resolveTeamsAppId,resolveTeamsAppPassword,resolveTeamsTenantId,sendTeamsActivity,splitTeamsMessageText,teamsContinuationToken,triggerTeamsTypingIndicator,updateTeamsActivity};

package/dist/src/public/channels/teams/attachments.d.ts

@@ -0,0 +1,25 @@
+import type { FilePart, UserContent } from "ai";
+import type { FetchFileResult } from "#channel/adapter.js";
+import type { TeamsAttachment } from "#public/channels/teams/api.js";
+import { type UploadPolicyInput } from "#public/channels/upload-policy.js";
+import type { UploadPolicy } from "#public/channels/upload-policy.js";
+/** File handling options for the native Teams channel. */
+export interface TeamsFilesConfig {
+    readonly allowedHosts?: readonly string[] | "*";
+    readonly enabled?: boolean;
+    readonly uploadPolicy?: UploadPolicyInput;
+}
+/** Normalized file handling policy used by the Teams channel. */
+export interface TeamsFilesPolicy {
+    readonly allowedHosts: readonly string[] | "*";
+    readonly enabled: boolean;
+    readonly uploadPolicy: UploadPolicy;
+}
+/** Normalizes author-provided Teams file options. */
+export declare function normalizeTeamsFilesPolicy(config: TeamsFilesConfig | undefined): TeamsFilesPolicy;
+/** Collects Teams attachment file parts when file support is explicitly enabled. */
+export declare function collectTeamsFileParts(attachments: readonly TeamsAttachment[], policy: TeamsFilesPolicy): FilePart[];
+/** Combines text + file parts into the UserContent shape expected by the harness. */
+export declare function buildTeamsTurnMessage(text: string, fileParts: readonly FilePart[]): string | UserContent;
+/** Creates a fetchFile function for Teams URL file parts. */
+export declare function createTeamsFetchFile(policy: TeamsFilesPolicy): (url: string) => Promise<FetchFileResult | null>;

package/dist/src/public/channels/teams/attachments.js

@@ -0,0 +1 @@
+import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{evaluateFilePart,formatUploadPolicyViolation,isUploadsDisabled,mergeUploadPolicy}from"#public/channels/upload-policy.js";var log=createLogger(`teams.attachments`);function normalizeTeamsFilesPolicy(e){return{allowedHosts:e?.allowedHosts??[],enabled:e?.enabled===!0,uploadPolicy:mergeUploadPolicy(e?.uploadPolicy)}}function collectTeamsFileParts(e,t){if(!t.enabled||isUploadsDisabled(t.uploadPolicy))return[];let a=[];for(let i of e){let e=toTeamsFilePart(i,a.length,t);if(e===null)continue;let o=evaluateFilePart(e,t.uploadPolicy);if(o!==null){log.warn(`dropped Teams attachment — ${formatUploadPolicyViolation(o)}`,{name:i.name});continue}a.push(e)}return a}function buildTeamsTurnMessage(e,t){return t.length===0?e:e.trim().length===0?[...t]:[{type:`text`,text:e},...t]}function createTeamsFetchFile(e){return async t=>{if(!e.enabled||!isAllowedUrl(t,e.allowedHosts))return null;let n=await fetch(t);if(!n.ok)throw Error(`Teams file fetch returned HTTP ${n.status} for ${t}.`);return{bytes:Buffer.from(await n.arrayBuffer()),mediaType:n.headers.get(`content-type`)??void 0}}}function toTeamsFilePart(e,t,n){let r=readAttachmentUrl(e);return!r||!isAllowedUrl(r,n.allowedHosts)?null:{data:new URL(r),filename:e.name??`teams-attachment-${t}`,mediaType:inferMediaType(e),type:`file`}}function readAttachmentUrl(e){return e.contentType===`application/vnd.microsoft.teams.file.download.info`&&isObject(e.content)&&typeof e.content.downloadUrl==`string`?e.content.downloadUrl:e.contentUrl&&!e.contentType.startsWith(`application/vnd.microsoft.card.`)?e.contentUrl:null}function inferMediaType(e){return e.contentType===`application/vnd.microsoft.teams.file.download.info`&&(isObject(e.content)&&typeof e.content.fileType==`string`?e.content.fileType:void 0)===`txt`?`text/plain`:e.contentType||`application/octet-stream`}function isAllowedUrl(e,t){if(t===`*`)return!0;let n;try{n=new URL(e)}catch{return!1}return t.some(e=>n.host===e||n.hostname===e)}export{buildTeamsTurnMessage,collectTeamsFileParts,createTeamsFetchFile,normalizeTeamsFilesPolicy};

package/dist/src/public/channels/teams/defaults.d.ts

@@ -0,0 +1,24 @@
+import type { SessionAuthContext } from "#channel/types.js";
+import type { ConnectionAuthorizationOutcome } from "#protocol/message.js";
+import { type TeamsMention } from "#public/channels/teams/api.js";
+import type { TeamsMessageActivity } from "#public/channels/teams/inbound.js";
+import type { TeamsChannelEvents, TeamsContext, TeamsInboundResult } from "#public/channels/teams/teamsChannel.js";
+/** Default auth projection for Teams message actors. */
+export declare function defaultTeamsAuth(message: TeamsMessageActivity): SessionAuthContext;
+/** Default message hook: mention-gated dispatch with Teams user auth. */
+export declare function defaultOnMessage(ctx: TeamsContext, message: TeamsMessageActivity): Promise<TeamsInboundResult>;
+/** Built-in Teams event handlers for typing, replies, HITL, auth cards, and terminal errors. */
+export declare const defaultEvents: TeamsChannelEvents;
+/** Title-cases a connection name for Teams auth card display. */
+export declare function formatConnectionDisplayName(connectionName: string): string;
+/** Builds final-state text for a completed connection authorization attempt. */
+export declare function buildAuthCompletedText(input: {
+    readonly displayName: string;
+    readonly outcome: ConnectionAuthorizationOutcome;
+    readonly reason?: string;
+}): string;
+/** Builds a Teams mention entity and matching text for one channel account. */
+export declare function teamsMentionUser(user: {
+    readonly id: string;
+    readonly name?: string;
+}): TeamsMention;

package/dist/src/public/channels/teams/defaults.js

@@ -0,0 +1,3 @@
+import{extractErrorId,formatErrorHint}from"#internal/logging.js";import{parseJsonObject}from"#shared/json.js";import{splitTeamsMessageText}from"#public/channels/teams/api.js";import{renderAnsweredInputRequestMessage,renderInputRequestMessage}from"#public/channels/teams/hitl.js";function defaultTeamsAuth(e){let t=e.tenantId,n={activity_id:e.id,conversation_id:e.conversation.id,scope:e.scope,user_id:e.from.id};e.from.name!==void 0&&(n.user_name=e.from.name),e.from.aadObjectId!==void 0&&(n.aad_object_id=e.from.aadObjectId),t!==void 0&&(n.tenant_id=t),e.teamId!==void 0&&(n.team_id=e.teamId),e.teamsChannelId!==void 0&&(n.channel_id=e.teamsChannelId);let r=t?`teams:${t}:${e.from.id}`:`teams:${e.from.id}`;return{attributes:n,authenticator:`teams-activity`,issuer:t?`teams:${t}`:`teams`,principalId:r,principalType:e.from.role===`bot`?`service`:`user`,subject:e.from.aadObjectId}}async function defaultOnMessage(e,t){return t.scope!==`personal`&&!t.isBotMentioned?null:(await e.thread.startTyping(),{auth:defaultTeamsAuth(t)})}var defaultEvents={async"turn.started"(e,t){await t.thread.startTyping()},async"actions.requested"(e,t){await t.thread.startTyping()},async"input.requested"(e,t){for(let n of e.requests)await t.thread.post(renderInputRequestMessage(n,{adaptiveCardVersion:t.adaptiveCardVersion}))},async"message.completed"(e,t){if(!(e.finishReason===`tool-calls`||!e.message))for(let n of splitTeamsMessageText(e.message))await t.thread.post(n)},async"session.failed"(n,r){let i=formatErrorHint(n),a=extractErrorId(n.details);await r.thread.post([`This session could not recover from an error${i}.`,``,`Start a new Teams conversation to continue.`,...a?[``,`Error id: ${a}`]:[]].join(`
+`))},async"turn.failed"(n,r){let i=formatErrorHint(n),a=extractErrorId(n.details);await r.thread.post([`I hit an error while handling your request${i}.`,``,`Please try again, rephrase, or reach out if it keeps failing.`,...a?[``,`Error id: ${a}`]:[]].join(`
+`))},async"connection.authorization_required"(e,t){let r=formatConnectionDisplayName(e.connectionName),i=e.authorization?.url,a=i?`Authorization required for ${r}: ${i}`:`Authorization required for ${r}.`,o=await t.thread.post({attachments:[{content:parseJsonObject({$schema:`http://adaptivecards.io/schemas/adaptive-card.json`,actions:i?[{title:`Sign in with ${r}`,type:`Action.OpenUrl`,url:i}]:[],body:[{text:`Authorization required for ${r}`,type:`TextBlock`,weight:`Bolder`,wrap:!0},{text:t.state.triggeringUser?`Requested by ${t.state.triggeringUser.name??t.state.triggeringUser.id}.`:`No triggering user is available for a private prompt.`,type:`TextBlock`,wrap:!0}],type:`AdaptiveCard`,version:t.adaptiveCardVersion}),contentType:`application/vnd.microsoft.card.adaptive`}],text:a});o.id&&(t.state.pendingAuthActivityId=o.id)},async"connection.authorization_completed"(e,t){let n=t.state.pendingAuthActivityId;if(!n)return;let r=buildAuthCompletedText({displayName:formatConnectionDisplayName(e.connectionName),outcome:e.outcome,reason:e.reason});await t.thread.update(n,renderAnsweredInputRequestMessage({prompt:r})),t.state.pendingAuthActivityId=null}};function formatConnectionDisplayName(e){return e.length===0?e:e.charAt(0).toUpperCase()+e.slice(1)}function buildAuthCompletedText(e){if(e.outcome===`authorized`)return`${e.displayName} connected.`;let t=e.reason===void 0?``:` (${e.reason})`;return`${e.displayName} authorization ${e.outcome}${t}.`}function teamsMentionUser(e){let t=e.name??e.id;return{mentioned:{id:e.id,name:e.name},text:`<at>${t}</at>`,type:`mention`}}export{buildAuthCompletedText,defaultEvents,defaultOnMessage,defaultTeamsAuth,formatConnectionDisplayName,teamsMentionUser};

package/dist/src/public/channels/teams/hitl.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Teams Adaptive Card rendering and decode helpers for Ash HITL prompts.
+ */
+import type { InputRequest, InputResponse } from "#runtime/input/types.js";
+import type { TeamsActivity } from "#public/channels/teams/inbound.js";
+import type { TeamsAttachment, TeamsMessageBody } from "#public/channels/teams/api.js";
+/** Adaptive Card attachment content type used by Teams. */
+export declare const TEAMS_ADAPTIVE_CARD_CONTENT_TYPE = "application/vnd.microsoft.card.adaptive";
+/** Hidden data property used by Ash HITL Adaptive Card actions. */
+export declare const TEAMS_HITL_DATA_KEY = "ash_input";
+/** ChoiceSet input id used for select-style HITL requests. */
+export declare const TEAMS_HITL_CHOICE_INPUT_ID = "ash_option";
+/** Text input id used for freeform HITL requests. */
+export declare const TEAMS_HITL_FREEFORM_INPUT_ID = "ash_freeform_text";
+/** Renders one input request as a Teams message body containing an Adaptive Card. */
+export declare function renderInputRequestMessage(request: InputRequest, options?: {
+    readonly adaptiveCardVersion?: string;
+}): TeamsMessageBody;
+/** Renders one input request as a Teams Adaptive Card attachment. */
+export declare function renderInputRequestAttachment(request: InputRequest, options?: {
+    readonly adaptiveCardVersion?: string;
+}): TeamsAttachment;
+/** Renders an answered Teams card that replaces a pending HITL prompt. */
+export declare function renderAnsweredInputRequestMessage(input: {
+    readonly label?: string;
+    readonly prompt: string;
+}): TeamsMessageBody;
+/** Returns true when a Teams activity carries an Ash HITL submit payload. */
+export declare function isTeamsInputResponseActivity(activity: TeamsActivity): boolean;
+/** Decodes one Teams activity into HITL input responses. */
+export declare function deriveTeamsInputResponses(activity: TeamsActivity): readonly InputResponse[];
+/** Builds the HTTP body Teams expects after an Adaptive Card invoke action. */
+export declare function teamsInvokeResponse(input?: {
+    readonly message?: string;
+    readonly statusCode?: number;
+}): Record<string, unknown>;

package/dist/src/public/channels/teams/hitl.js

@@ -0,0 +1 @@
+import{isObject}from"#shared/guards.js";import{parseJsonObject}from"#shared/json.js";import{TEAMS_ADAPTIVE_CARD_ACTION_LIMIT,TEAMS_ADAPTIVE_CARD_ACTION_TITLE_MAX_LENGTH,TEAMS_ADAPTIVE_CARD_CHOICE_TITLE_MAX_LENGTH,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH}from"#public/channels/teams/limits.js";var TEAMS_ADAPTIVE_CARD_CONTENT_TYPE=`application/vnd.microsoft.card.adaptive`,TEAMS_HITL_DATA_KEY=`ash_input`,TEAMS_HITL_CHOICE_INPUT_ID=`ash_option`,TEAMS_HITL_FREEFORM_INPUT_ID=`ash_freeform_text`;function renderInputRequestMessage(e,t={}){return{attachments:[renderInputRequestAttachment(e,t)],text:e.prompt}}function renderInputRequestAttachment(e,n={}){return{content:parseJsonObject({$schema:`http://adaptivecards.io/schemas/adaptive-card.json`,actions:renderActions(e),body:[{text:truncate(e.prompt,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH),type:`TextBlock`,wrap:!0},...renderInputs(e)],type:`AdaptiveCard`,version:n.adaptiveCardVersion??`1.5`}),contentType:TEAMS_ADAPTIVE_CARD_CONTENT_TYPE}}function renderAnsweredInputRequestMessage(e){return{attachments:[{content:parseJsonObject({$schema:`http://adaptivecards.io/schemas/adaptive-card.json`,body:[{text:truncate(e.prompt,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH),type:`TextBlock`,wrap:!0},{color:`good`,text:e.label?`Answered: ${e.label}`:`Answered`,type:`TextBlock`,wrap:!0}],type:`AdaptiveCard`,version:`1.5`}),contentType:TEAMS_ADAPTIVE_CARD_CONTENT_TYPE}],text:e.label?`Answered: ${e.label}`:`Answered`}}function isTeamsInputResponseActivity(e){return deriveTeamsInputResponses(e).length>0}function deriveTeamsInputResponses(e){let t=readActivityValue(e);if(!t)return[];let n=readHitlPayload(t);if(!n)return[];let r=typeof n.requestId==`string`?n.requestId:``;if(!r)return[];let i=typeof n.optionId==`string`?n.optionId:typeof t.ash_option==`string`?t[TEAMS_HITL_CHOICE_INPUT_ID]:void 0,a=typeof t.ash_freeform_text==`string`?t[TEAMS_HITL_FREEFORM_INPUT_ID]:void 0;return i===void 0?a===void 0?[{requestId:r}]:[{requestId:r,text:a}]:[{optionId:i,requestId:r}]}function teamsInvokeResponse(e={}){return{statusCode:e.statusCode??200,type:`application/vnd.microsoft.activity.message`,value:e.message??`Answer received.`}}function renderInputs(e){return e.display===`select`&&e.options&&e.options.length>0?[{choices:e.options.map(e=>({title:truncate(e.label,TEAMS_ADAPTIVE_CARD_CHOICE_TITLE_MAX_LENGTH),value:e.id})),id:TEAMS_HITL_CHOICE_INPUT_ID,isMultiSelect:!1,style:`compact`,type:`Input.ChoiceSet`}]:e.allowFreeform===!0||!e.options||e.options.length===0?[{id:TEAMS_HITL_FREEFORM_INPUT_ID,isMultiline:!0,placeholder:`Type your answer`,type:`Input.Text`}]:[]}function renderActions(e){let t=e.options;return t&&t.length>0&&e.display!==`select`?t.slice(0,TEAMS_ADAPTIVE_CARD_ACTION_LIMIT).map(t=>({data:{[TEAMS_HITL_DATA_KEY]:{optionId:t.id,requestId:e.requestId}},title:truncate(t.label,TEAMS_ADAPTIVE_CARD_ACTION_TITLE_MAX_LENGTH),type:`Action.Submit`})):[{data:{[TEAMS_HITL_DATA_KEY]:{requestId:e.requestId}},title:`Submit`,type:`Action.Submit`}]}function readActivityValue(e){return e.type===`message`?readMessageValue(e):e.type===`invoke`?readInvokeValue(e):null}function readMessageValue(e){return e.value??null}function readInvokeValue(t){let n=t.value;if(!n)return null;let r=isObject(n.action)?n.action:null;return(r&&isObject(r.data)?r.data:null)??n}function readHitlPayload(t){let n=t[TEAMS_HITL_DATA_KEY];if(isObject(n))return n;let r=isObject(t.action)?t.action:null,i=(r&&isObject(r.data)?r.data:null)?.[TEAMS_HITL_DATA_KEY];return isObject(i)?i:null}function truncate(e,t){if(e.length<=t)return e;let n=Math.max(0,t-3);return`${e.slice(0,n).trimEnd()}...`}export{TEAMS_ADAPTIVE_CARD_CONTENT_TYPE,TEAMS_HITL_CHOICE_INPUT_ID,TEAMS_HITL_DATA_KEY,TEAMS_HITL_FREEFORM_INPUT_ID,deriveTeamsInputResponses,isTeamsInputResponseActivity,renderAnsweredInputRequestMessage,renderInputRequestAttachment,renderInputRequestMessage,teamsInvokeResponse};