eve 0.83.3 → 0.84.1

package/dist/src/public/channels/slack/slackChannel.d.ts

@@ -1,14 +1,16 @@
-import type { UserContent } from "ai";
+import type { ChannelEventContext, ChannelEventOf, CommittedLine } from "#public/definitions/channel.js";
+import type { SessionEvent } from "#protocol/session-event.js";
+import type { MessageContent } from "#shared/message-content.js";
 import type { ChannelResolveSession, ChannelSource } from "#channel/channel-operations.js";
-import type { Session } from "#channel/session.js";
+import type { Delivery } from "#shared/delivery.js";
 import type { SessionAuthContext, TurnPolicy } from "#channel/types.js";
 import type { VercelConnectMetadata } from "#shared/vercel-connect-metadata.js";
-import type { CardElement } from "#compiled/chat/index.js";
+import type { CardElement } from "#public/channels/slack/cards.js";
 import type { SessionContext } from "#public/definitions/callback-context.js";
 import type { SessionHistoryMessage } from "#shared/session-history.js";
 import type { ChannelContinuationOps } from "#public/definitions/channel.js";
-import type { UnstampedMessageStreamEvent } from "#protocol/message.js";
-import type { InputRequest, InputResponse, StrictInputResponses, ValidatedInputResponse } from "#shared/input.js";
+import type { Answer, StrictAnswers, ValidatedAnswer } from "#shared/input.js";
+import type { Interaction } from "#channel/interaction-prompts.js";
 import { type SlackBotToken, type SlackHandle, type SlackThread, type SlackWorkspaceHandle } from "#public/channels/slack/api.js";
 import { type SlackTransportOptions } from "#public/channels/slack/transport.js";
 import { type SlackRenderedEvent, type SlackRenderer } from "#public/channels/slack/renderers.js";
@@ -23,11 +25,6 @@ import { type UndeliveredReplyState } from "#public/channels/undelivered-reply.j
 import { type Channel } from "#public/definitions/channel.js";
 import { type ChannelAudience } from "#shared/channel-audience.js";
 export type { SlackRespondOptions, SlackSendOptions, SlackSessionOperations, } from "#public/channels/slack/session-operations.js";
-type EventData<T extends UnstampedMessageStreamEvent["type"]> = Extract<UnstampedMessageStreamEvent, {
-    type: T;
-}> extends {
-    data: infer D;
-} ? D : undefined;
 /**
  * Base Slack context for inbound webhook handlers. These hooks run before the
  * runtime hydrates session state, so `state` is absent here.
@@ -58,9 +55,9 @@ export interface SlackEventContext extends SlackChannelContext, ChannelContinuat
 }
 export type { SlackApiResponse, SlackBotToken, SlackHandle, SlackThread, SlackWorkspaceHandle, } from "#public/channels/slack/api.js";
 export type { SlackWebhookVerifier } from "#public/channels/slack/verify.js";
-type SlackEventHandler<T extends UnstampedMessageStreamEvent["type"]> = (data: EventData<T>, channel: SlackEventContext, ctx: SessionContext) => void | Promise<void>;
+type SlackEventHandler<T extends SessionEvent["type"]> = (event: ChannelEventOf<T>, ctx: ChannelEventContext<SlackEventContext>) => void | Promise<void>;
 /**
- * Delivery surface handed to a renderer's `authorization.required` handler. The
+ * Delivery surface handed to a renderer's sign-in `interaction.opened` handler. The
  * connection challenge is a credential: anyone who completes the sign-in
  * binds their identity to this session's connection. So the only
  * delivery capabilities here are private ones, an ephemeral reply in the
@@ -86,7 +83,6 @@ export interface SlackAuthorizationEventContext {
      */
     readonly state: SlackChannelState;
 }
-type SlackSessionFailedHandler = (data: EventData<"session.failed">, channel: SlackEventContext) => void | Promise<void>;
 /**
  * JSON-serializable per-session state, stored verbatim across workflow
  * step boundaries. Anything written here must round-trip through
@@ -122,8 +118,7 @@ export interface SlackChannelState extends UndeliveredReplyState {
      */
     triggeringUserId?: string | null;
     /**
-     * Buffered text from a `message.completed` event whose `finishReason`
-     * was `"tool-calls"`. The default `actions.requested` handler uses the
+     * Buffered narration from a `content.completed` event (`phase: "narration"`). The default `call.requested` handler uses the
      * first non-empty line as the next typing indicator, surfacing the
      * model's pre-tool narration instead of the action label. Cleared at
      * `turn.started` and after use.
@@ -137,15 +132,15 @@ export interface SlackChannelState extends UndeliveredReplyState {
     /**
      * Connection name to Slack message ts. Each entry is the public
      * link-free status post created by the default
-     * `authorization.required` handler; the matching
-     * `authorization.completed` handler edits it in place to surface the
+     * sign-in `interaction.opened` handler; the matching
+     * sign-in `interaction.settled` handler edits it in place to surface the
      * resolution outcome.
      */
     pendingAuthMessageTs?: Record<string, string>;
     pendingApprovalCards?: Record<string, SlackPendingApprovalCard>;
     /**
      * Each recent turn's tool calls and the task card eve last wrote for it, by
-     * turn id. The default `turn.waiting` handler names the working tasks.
+     * turn id. The default `turn.paused` handler names the working tasks.
      */
     taskCards?: Record<string, SlackTaskCardState> | null;
     /**
@@ -160,7 +155,7 @@ export interface SlackChannelState extends UndeliveredReplyState {
     /**
      * Principal id to Slack user id, recorded as each message or input response
      * is delivered. Default handlers use it to address the principal named on
-     * `authorization.required` and approval events.
+     * sign-in `interaction.opened` and approval events.
      */
     slackUsersByPrincipal?: Record<string, string>;
     /**
@@ -259,9 +254,9 @@ export interface SlackEventRespondOptions {
  * Starts a session on the current Slack channel from `onEvent`. Call it zero,
  * one, or many times; each invocation returns the resulting session.
  */
-export type SlackEventSendFn = (message: string | UserContent, options: SlackEventSendOptions) => Promise<Session>;
+export type SlackEventSendFn = (message: MessageContent, options: SlackEventSendOptions) => Promise<Delivery>;
 /** Answers pending input requests on one Slack thread. */
-export type SlackEventRespondFn = <const TResponses extends readonly InputResponse[]>(inputResponses: StrictInputResponses<TResponses>, options: SlackEventRespondOptions) => ReturnType<SlackSessionOperations["respond"]>;
+export type SlackEventRespondFn = <const TResponses extends readonly Answer[]>(answers: StrictAnswers<TResponses>, options: SlackEventRespondOptions) => ReturnType<SlackSessionOperations["respond"]>;
 /**
  * Slack thread identity used by workspace-scoped inbound helpers.
  */
@@ -337,8 +332,8 @@ export interface SlackSlashCommandContext {
     /** Slack workspace identity and raw Web API escape hatch. */
     readonly slack: SlackWorkspaceHandle;
 }
-/** Context handed to `slackChannel({ onInputResponse })` before eve resumes HITL. */
-export interface SlackInputResponseContext extends SlackContext {
+/** Context handed to `slackChannel({ onAnswers })` before eve resumes HITL. */
+export interface SlackAnswerContext extends SlackContext {
     /** Auth derived from the Slack user who submitted the signed interaction. */
     readonly defaultAuth: SessionAuthContext;
 }
@@ -425,20 +420,20 @@ export type SlackShortcut = {
     readonly teamId?: string;
 };
 /** Decoded eve-owned HITL response submitted through Slack interactivity. */
-export type SlackInputResponseSubmission = {
+export type SlackAnswerSubmission = {
     readonly type: "block_actions";
-    readonly inputResponses: readonly ValidatedInputResponse[];
+    readonly answers: readonly ValidatedAnswer[];
     readonly actions: readonly SlackInteractionAction[];
     readonly messageTs?: string;
     readonly user: SlackInteractionUser;
 } | {
     readonly type: "view_submission";
-    readonly inputResponses: readonly ValidatedInputResponse[];
+    readonly answers: readonly ValidatedAnswer[];
     readonly messageTs: string;
     readonly user: SlackInteractionUser;
 };
 /** Result of a Slack HITL response admission hook. Return `null` to reject. */
-export type SlackInputResponseResult = {
+export type SlackAnswerResult = {
     readonly auth: SessionAuthContext | null;
 } | null;
 /**
@@ -456,28 +451,26 @@ export type SlackMentionResult = {
     readonly history?: readonly SessionHistoryMessage[];
     readonly title?: string;
 } | null;
-export type SlackMentionResultOrPromise = SlackMentionResult | Promise<SlackMentionResult>;
 /**
  * Alias of {@link SlackMentionResult} for the `onDirectMessage` signature,
  * so DM handlers do not read in terms of "mention".
  */
 export type SlackInboundResult = SlackMentionResult;
 /** {@link SlackInboundResult}, or a promise resolving to one. */
-export type SlackInboundResultOrPromise = SlackMentionResultOrPromise;
 /**
  * eve's full-context Slack event handlers: the innermost link of every
- * channel's renderer chain. The default `authorization.required` handler keeps
+ * channel's renderer chain. The default sign-in `interaction.opened` handler keeps
  * the full {@link SlackEventContext} because it owns the public link-free
  * status, which authored renderers, limited to private delivery, can't post.
  */
 export type SlackChannelInternalEvents = {
-    readonly [T in Exclude<SlackRenderedEvent, "session.failed">]?: SlackEventHandler<T>;
+    readonly [T in SlackRenderedEvent]?: SlackEventHandler<T>;
 } & {
-    readonly "session.failed"?: SlackSessionFailedHandler;
+    readonly committed?: (line: CommittedLine, ctx: Parameters<SlackEventHandler<"turn.started">>[1]) => void | Promise<void>;
 };
 export type SlackApprovalChannel = "direct-message" | "thread";
 /** Input request passed to a {@link SlackApprovalChannelResolver}. */
-export type SlackApprovalRequest = InputRequest;
+export type SlackApprovalRequest = Interaction;
 /** Chooses the Slack destination for one input request. */
 export type SlackApprovalChannelResolver = (request: SlackApprovalRequest, ctx: SessionContext) => SlackApprovalChannel | Promise<SlackApprovalChannel>;
 export interface SlackChannelConfig {
@@ -517,7 +510,7 @@ export interface SlackChannelConfig {
      * `onDirectMessage` handlers take precedence for their event types. Other
      * channel messages are ignored when this hook is omitted.
      */
-    onMessage?(ctx: SlackInboundMessageContext, message: SlackMessage): SlackInboundResultOrPromise;
+    onMessage?(ctx: SlackInboundMessageContext, message: SlackMessage): SlackMentionResult | Promise<SlackMentionResult>;
     /**
      * Invoked when a Slack `app_mention` event arrives (only `app_mention`;
      * other event types are ignored). Decides whether to dispatch and with
@@ -529,7 +522,7 @@ export interface SlackChannelConfig {
      * dispatching. Thrown errors are caught and logged and the mention is
      * dropped. Defaults to a workspace-scoped auth derivation.
      */
-    onAppMention?(ctx: SlackInboundMessageContext, message: SlackMessage): SlackMentionResultOrPromise;
+    onAppMention?(ctx: SlackInboundMessageContext, message: SlackMessage): SlackMentionResult | Promise<SlackMentionResult>;
     /**
      * Invoked on a direct message: a Slack `message` event with
      * `channel_type: "im"`. Subtype messages (edits, deletes, joins, etc.)
@@ -545,7 +538,7 @@ export interface SlackChannelConfig {
      * Requires the bot's Slack app to subscribe to `message.im` with the
      * `im:history` scope.
      */
-    onDirectMessage?(ctx: SlackInboundMessageContext, message: SlackMessage): SlackInboundResultOrPromise;
+    onDirectMessage?(ctx: SlackInboundMessageContext, message: SlackMessage): SlackMentionResult | Promise<SlackMentionResult>;
     /**
      * Fallback handler for signed Slack Events API callbacks. An authored
      * `onAppMention` or `onDirectMessage` takes precedence for events accepted
@@ -608,7 +601,7 @@ export interface SlackChannelConfig {
      * accepts the response with the submitting user's auth, regardless of other
      * authored handlers.
      */
-    onInputResponse?(ctx: SlackInputResponseContext, submission: SlackInputResponseSubmission): SlackInputResponseResult | Promise<SlackInputResponseResult>;
+    onAnswers?(ctx: SlackAnswerContext, submission: SlackAnswerSubmission): SlackAnswerResult | Promise<SlackAnswerResult>;
     /**
      * Renderers that wrap eve's default Slack rendering, outermost first. Omit
      * it and eve renders with its default alone. Each renderer can acknowledge

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

@@ -1 +1 @@
-import{markEventHandled}from"./utils.js";import{attachInputText}from"#internal/input-text.js";import{createLogger,logError}from"#internal/logging.js";import{normalizeChannelAudience}from"#shared/channel-audience.js";import{setChannelBuildMetadata}from"#channel/compiled-channel.js";import{defaultDeliverResult}from"#channel/adapter.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{maxBytesOf}from"#internal/attachments/limited-read.js";import{withUndeliveredReplyNote}from"#public/channels/undelivered-reply.js";import{resolveSlackTransportOptions}from"#public/channels/slack/transport.js";import{buildSlackAuthContext,slackUserIdFromAuthContext}from"#public/channels/slack/auth.js";import{buildSlackBinding,buildSlackWorkspaceHandle,fetchSlackThreadWindow,slackContinuationToken}from"#public/channels/slack/api.js";import{parseMessageEvent,parseSlackEventEnvelope,slackEventBotUserId,slackEventInstallationTeamId,slackEventReceivingBotUserId,slackMessageFromWebhookPayload}from"#public/channels/slack/inbound.js";import{defaultInputRequestedHandler}from"#public/channels/slack/approval-cards.js";import{withFinalReplyDelivery}from"#public/channels/slack/reply-delivery.js";import{defaultEvents,defaultOnMessage,defaultReceived}from"#public/channels/slack/defaults.js";import{composeSlackRenderers}from"#public/channels/slack/renderers.js";import{loadThreadContextMessages}from"#public/channels/slack/thread.js";import{parseSlackWebhookBody}from"#compiled/@chat-adapter/slack/webhook.js";import{bindSlackSessionOperations,withSlackResponder}from"#public/channels/slack/session-operations.js";import{buildSlackTurnMessage,collectInboundFileParts,createSlackFetchFile}from"#public/channels/slack/attachments.js";import{renderDefaultSlackTaskCard,withTaskCards}from"#public/channels/slack/task-card.js";import{formatSlackInboundMessage,formatSlackThreadContext,slackThreadSessionHistory}from"#public/channels/slack/model-context.js";import{isPrivateSlackConversation}from"#public/channels/slack/privacy.js";import{SLACK_CHANNEL_DEFAULT_ROUTE}from"#public/channels/slack/constants.js";import{defineSlackAppManifest}from"#public/channels/slack/app-manifest.js";import{handleInteractionPost}from"#public/channels/slack/interactions.js";import{verifySlackRequest as verifySlackRequest$1}from"#public/channels/slack/verify.js";const log=createLogger(`slack.channel`);function rebuildSlackContext(e,t,n,r){let{thread:i,slack:a}=buildSlackBinding({api:n,botToken:r?.botToken,channelId:e.channelId??``,threadTs:e.threadTs??``,installationTeamId:e.installationTeamId??void 0,teamId:e.teamId??void 0,onThreadTsChanged(n){e.threadTs=n,e.channelId&&t.continuation?.alias(slackContinuationToken(e.channelId,n))},onPosted(){e.postedInThread=!0}});return{thread:i,slack:a,state:e}}function slackChannel(e={}){let t=resolveSlackTransportOptions(e.api),n=mergeUploadPolicy(e.uploadPolicy),r=createSlackFetchFile({api:t,botToken:e.credentials?.botToken,maxBytes:maxBytesOf(n)}),i=e.onInputResponse??defaultOnInputResponse,a=composeSlackRenderers(e.renderers??[],{events:{...defaultEvents,"input.requested":defaultInputRequestedHandler(e.approvalChannel)},received:defaultReceived,taskCard:renderDefaultSlackTaskCard}),o=a.events[`turn.started`],s=withTaskCards({...a.events,"message.completed":withFinalReplyDelivery(a.events[`message.completed`]),async"turn.started"(e,t,n){let r=slackUserIdFromAuthContext(n.session.auth.current);r!==void 0&&(t.state.triggeringUserId=r),await o?.(e,t,n)}},a.taskCard),c=new Set,l=defineChannel({kindHint:`slack`,turnPolicy:e.turnPolicy,uploadPolicy:e.uploadPolicy,state:{channelId:null,threadTs:null,teamId:null,installationTeamId:null,triggeringUserId:null,triggeringMessageTs:null,pendingToolCallMessage:null,pendingAuthMessageTs:{},pendingApprovalCards:{},slackUsersByPrincipal:{}},fetchFile:r,metadata(e){return{channelId:e.channelId,teamId:e.teamId,threadTs:e.threadTs,triggeringUserId:e.triggeringUserId??null}},audience:({state:e})=>e.audience??`unknown`,context(n,r){return rebuildSlackContext(n,r,t,e.credentials)},deliver(e,t){return recordSlackPrincipal(t.state,t.session.auth.current,e),defaultDeliverResult(withUndeliveredReplyNote(t.state,e,`Slack`))},routes:[POST(e.route??SLACK_CHANNEL_DEFAULT_ROUTE,async(r,o)=>{let{waitUntil:s}=o,{from:l,resolveSession:u}=o,d=await verifyInbound(r,e.credentials);return d===null?new Response(`unauthorized`,{status:401}):shouldDropSlackHttpTimeoutRetry(r.headers)?new Response(`ok`):(r.headers.get(`content-type`)??``).includes(`application/x-www-form-urlencoded`)?handleInteractionPost(d,{from:l,resolveSession:u,waitUntil:s},{api:t,config:e,onInputResponse:i}):handleEventPost({api:t,body:d,from:l,resolveSession:u,waitUntil:s,config:e,received:a.received,uploadPolicy:n,handledEvents:c,headers:r.headers})})],receive(n,{from:r}){return receiveOnSlack(n,{from:r,api:t,credentials:e.credentials})},events:s}),u=e.credentials,d=defineSlackAppManifest({botName:e.botName});return setChannelBuildMetadata(l,e=>({externalCredentials:u?.vercelConnect,manifest:d.build(e)})),l}function defaultOnInputResponse(e){return{auth:e.defaultAuth}}async function receiveOnSlack(e,t){let n=e.target,r=n.channelId;if(!r||typeof r!=`string`)throw Error(`slackChannel().receive requires target.channelId.`);let i=typeof n.threadTs==`string`?n.threadTs:``,a=typeof n.installationTeamId==`string`?n.installationTeamId:t.installationTeamId,o=n.initialMessage;if(o&&i.length>0)throw Error("slackChannel().receive: `threadTs` and `initialMessage` are mutually exclusive.");let s=i;if(o){let{thread:e}=buildSlackBinding({api:t.api,botToken:t.credentials?.botToken,channelId:r,threadTs:``,installationTeamId:a,teamId:t.teamId}),n={card:o.card};o.fallbackText!==void 0&&(n.fallbackText=o.fallbackText),s=(await e.post(n)).id}let c=s||crypto.randomUUID(),l=n.audience===void 0?void 0:normalizeChannelAudience(n.audience),u={channelId:r,installationTeamId:a??null,threadTs:s||null,teamId:t.teamId??null,triggeringUserId:t.triggeringUserId??null};return l!==void 0&&(u.audience=l),t.from(slackContinuationToken(r,c)).send(e.message,{auth:e.auth,history:e.history,state:u,title:e.title})}function shouldDropSlackHttpTimeoutRetry(e){return Number(e.get(`x-slack-retry-num`)??`0`)>=1&&e.get(`x-slack-retry-reason`)===`http_timeout`}async function handleEventPost(e){let{config:t}=e,n,r;try{n=parseSlackWebhookBody(e.body,{headers:e.headers}),r=parseSlackEventEnvelope(e.body)}catch(e){return log.warn(`inbound webhook body is not valid JSON`,{error:e}),new Response(`ok`)}if(n.kind===`url_verification`)return new Response(n.challenge,{status:200,headers:{"content-type":`text/plain`}});if(r===null)return new Response(`ok`);let i=typeof r.api_app_id==`string`?r.api_app_id:void 0,a=slackEventBotUserId(r),o=slackEventReceivingBotUserId(r),s=slackEventInstallationTeamId(r),dispatch=null,c=null,dispatchMessage=(n,r,c)=>()=>dispatchSlackMessage({api:e.api,appId:i,botUserId:a,receivingBotUserId:o,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,handler:c,installationTeamId:s,kind:n,message:r,received:e.received,resolvesTypedInput:t.onInputResponse===void 0&&t.approvalChannel===void 0,threadContext:t.threadContext,uploadPolicy:e.uploadPolicy});if(n.kind===`app_mention`||n.kind===`direct_message`){let e=n.kind,r=slackMessageFromWebhookPayload(n,s);if(r!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},r)){let n=(e===`app_mention`?t.onAppMention:t.onDirectMessage)??t.onMessage;n===void 0?c=dispatchMessage(e,r,defaultOnMessage):dispatch=dispatchMessage(e,r,n)}}let l=t.onMessage;if(dispatch===null&&l!==void 0){let e=parseMessageEvent(r);e!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},e)&&(a===void 0||!e.text.includes(`<@${a}`))&&(dispatch=dispatchMessage(`channel_message`,e,l))}let u=t.onEvent;if(dispatch===null&&u!==void 0&&(dispatch=()=>dispatchSlackEvent({api:e.api,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,envelope:r,handler:u,installationTeamId:s})),dispatch??=c,dispatch===null)return new Response(`ok`);let d=r.event_id;if(d){if(e.handledEvents.has(d))return log.warn(`received a duplicate event`,{event_id:d,event_time:r.event_time,retry_num:n.retry?.num??`(null)`,retry_reason:n.retry?.reason??`(null)`}),new Response(`ok`);markEventHandled(d,e.handledEvents)}return e.waitUntil(dispatch()),new Response(`ok`)}function isSelfAuthoredSlackMessage(e,t){return e.botUserId!==void 0&&t.author?.userId===e.botUserId||e.appId!==void 0&&t.raw.app_id===e.appId}async function dispatchSlackMessage(e){let t=slackContinuationToken(e.message.channelId,e.message.threadTs),{thread:n,slack:r}=buildSlackBinding({api:e.api,appId:e.appId,botToken:e.credentials?.botToken,botUserId:e.botUserId,channelId:e.message.channelId,threadTs:e.message.threadTs,threadHasReplies:e.message.threadTs!==e.message.ts,installationTeamId:e.installationTeamId,teamId:e.message.teamId}),i=e.message.author,a={channelId:e.message.channelId,installationTeamId:e.installationTeamId??null,teamId:e.message.teamId??null,threadTs:e.message.threadTs,triggeringMessageTs:e.message.ts,triggeringUserId:i?.userId??null},o=bindSlackSessionOperations({address:t,defaultAuth:i===void 0?null:buildSlackAuthContext({channelId:e.message.channelId,fullName:i.fullName,installationTeamId:e.installationTeamId,isBot:i.isBot,teamId:e.message.teamId,threadTs:e.message.threadTs,userId:i.userId,userName:i.userName}),from:e.from,resolveSession:e.resolveSession,state:a}),s,isDMOrPrivateChannel=()=>s??=isPrivateSlackConversation({channelId:e.message.channelId,raw:e.message.raw,request:r.request}),c=e.kind===`app_mention`||e.botUserId!==void 0&&e.message.text.includes(`<@${e.botUserId}`),l={...o,isBotMentioned:()=>c,isDMOrPrivateChannel,isSubscribed:async()=>await o.resolveSession()!==void 0,slack:r,thread:n},u=e.kind===`channel_message`?void 0:acknowledgeMessage(e.received,e.message,{slack:r,thread:n}),d;try{d=await e.handler(l,e.message)}catch(t){logError(log,`${e.kind} handler failed`,t,{channelId:e.message.channelId})}if(d==null){u!==void 0&&(await u,await n.startTyping());return}await(u??acknowledgeMessage(e.received,e.message,{slack:r,thread:n}));let f=await isDMOrPrivateChannel();a.audience=e.kind===`direct_message`||f?`private`:`public`,await deliverSlackMessage({botUserId:e.receivingBotUserId,credentials:e.credentials,kind:e.kind,isPrivateConversation:f,isMentioned:c,message:e.message,resolvesTypedInput:e.resolvesTypedInput,result:d,sessionOperations:o,thread:n,threadContext:e.threadContext,uploadPolicy:e.uploadPolicy})}async function acknowledgeMessage(e,t,n){try{await e(t,n)}catch(e){logError(log,`received renderer failed`,e,{channelId:t.channelId})}}async function dispatchSlackEvent(e){let t=e.envelope.event.team_id,n=typeof t==`string`?t:typeof e.envelope.team_id==`string`?e.envelope.team_id:void 0,r=[],sourceFor=t=>e.from(slackContinuationToken(t.channelId,t.threadTs)),i={cancel:({target:e,turnId:t})=>sourceFor(e).cancel({turnId:t}),clear:({target:e})=>sourceFor(e).clear(),compact:({target:e})=>sourceFor(e).compact(),envelope:e.envelope,reset:({reason:e,target:t})=>sourceFor(t).reset({reason:e}),resolveSession:({target:t})=>e.resolveSession(slackContinuationToken(t.channelId,t.threadTs)),respond:(t,{auth:n,target:r})=>sourceFor(r).respond(t,{auth:n,state:withSlackResponder(void 0,typeof e.envelope.event.user==`string`?e.envelope.event.user:void 0)}),send:(t,{auth:r,history:i,target:a,title:o})=>receiveOnSlack({auth:r,history:i,message:t,target:a,title:o},{from:e.from,api:e.api,credentials:e.credentials,installationTeamId:e.installationTeamId,teamId:n,...typeof e.envelope.event.user==`string`?{triggeringUserId:e.envelope.event.user}:{}}),slack:buildSlackWorkspaceHandle({api:e.api,botToken:e.credentials?.botToken,installationTeamId:e.installationTeamId,teamId:n}),waitUntil(e){r.push(e)}};try{await e.handler(i,e.envelope.event)}catch(t){logError(log,`event handler failed`,t,{eventId:e.envelope.event_id,eventType:e.envelope.event.type})}await Promise.allSettled(r)}async function verifyInbound(e,t){try{return await verifySlackRequest$1(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 deliverSlackMessage(e){let{message:t,thread:n}=e;try{let r=e.threadContext===void 0?[]:await loadThreadContextMessages(n,t,e.threadContext),i=r.length>0&&e.result.history===void 0&&await e.sessionOperations.resolveSession()===void 0,a=i?void 0:formatSlackThreadContext(r),o=e.result.history??(i?slackThreadSessionHistory(r):void 0),s=await collectInboundFileParts({botUserId:e.botUserId,fetchThreadWindow:(e,t)=>fetchSlackThreadWindow(n,e,t),isMentioned:e.kind===`app_mention`,mention:t,thread:n,policy:e.uploadPolicy}),c={botUserId:e.botUserId,channelId:t.channelId,fullName:t.author?.fullName,isMentioned:e.isMentioned,teamId:t.teamId,threadTs:t.threadTs,userId:t.author?.userId??``,userName:t.author?.userName},l=formatSlackInboundMessage(c,t),u=buildSlackTurnMessage(a===void 0?l:`${a}\n\n${l}`,s),d=e.result.context??[],f=e.isPrivateConversation?`Private message`:e.result.title??t.markdown,p=e.resolvesTypedInput?slackTypedText(t.text,e.botUserId):``,m=attachInputText({auth:e.result.auth,title:f,...d.length>0&&{context:d},...o!==void 0&&{history:o}},s.length===0?p:void 0);await e.sessionOperations.send(u,m)}catch(n){logError(log,`${e.kind} delivery failed`,n,{channelId:t.channelId})}}function slackTypedText(e,t){return t===void 0?e:e.replace(RegExp(`<@${t}(?:\\|[^>]*)?>`,`gu`),``).trim()}function recordSlackPrincipal(e,t,n){if(t===null)return;let r=n.state?.triggeringUserId,i=slackUserIdFromAuthContext(t)??(typeof r==`string`?r:void 0);i!==void 0&&(e.slackUsersByPrincipal={...e.slackUsersByPrincipal,[t.principalId]:i})}export{slackChannel};
+import{markEventHandled}from"./utils.js";import{attachInputText}from"#internal/input-text.js";import{createLogger,logError}from"#internal/logging.js";import{normalizeChannelAudience}from"#shared/channel-audience.js";import{setChannelBuildMetadata}from"#channel/compiled-channel.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{maxBytesOf}from"#internal/attachments/limited-read.js";import{withUndeliveredReplyNote}from"#public/channels/undelivered-reply.js";import{buildSlackBinding,buildSlackWorkspaceHandle,fetchSlackThreadWindow,slackContinuationToken}from"#public/channels/slack/api.js";import{buildSlackAuthContext,slackUserIdFromAuthContext}from"#public/channels/slack/auth.js";import{resolveSlackTransportOptions}from"#public/channels/slack/transport.js";import{parseMessageEvent,parseSlackEventEnvelope,slackEventBotUserId,slackEventInstallationTeamId,slackEventReceivingBotUserId,slackMessageFromWebhookPayload}from"#public/channels/slack/inbound.js";import{withFinalReplyDelivery}from"#public/channels/slack/reply-delivery.js";import{defaultEvents,defaultInteractionOpenedHandler,defaultOnMessage,defaultReceived}from"#public/channels/slack/defaults.js";import{composeSlackRenderers}from"#public/channels/slack/renderers.js";import{loadThreadContextMessages}from"#public/channels/slack/thread.js";import{parseSlackWebhookBody}from"#compiled/@chat-adapter/slack/webhook.js";import{bindSlackSessionOperations,withSlackResponder}from"#public/channels/slack/session-operations.js";import{buildSlackTurnMessage,collectInboundFileParts,createSlackFetchFile}from"#public/channels/slack/attachments.js";import{renderDefaultSlackTaskCard,withTaskCards}from"#public/channels/slack/task-card.js";import{formatSlackInboundMessage,formatSlackThreadContext,slackThreadSessionHistory}from"#public/channels/slack/model-context.js";import{isPrivateSlackConversation}from"#public/channels/slack/privacy.js";import{SLACK_CHANNEL_DEFAULT_ROUTE}from"#public/channels/slack/constants.js";import{defineSlackAppManifest}from"#public/channels/slack/app-manifest.js";import{handleInteractionPost}from"#public/channels/slack/interactions.js";import{verifySlackRequest as verifySlackRequest$1}from"#public/channels/slack/verify.js";const log=createLogger(`slack.channel`);function rebuildSlackContext(e,t,n,r){let{thread:i,slack:a}=buildSlackBinding({api:n,botToken:r?.botToken,channelId:e.channelId??``,threadTs:e.threadTs??``,installationTeamId:e.installationTeamId??void 0,teamId:e.teamId??void 0,onThreadTsChanged(n){e.threadTs=n,e.channelId&&t.continuation?.alias(slackContinuationToken({channelId:e.channelId,threadTs:n}))},onPosted(){e.postedInThread=!0}});return{thread:i,slack:a,state:e}}function slackChannel(e={}){let t=resolveSlackTransportOptions(e.api),n=mergeUploadPolicy(e.uploadPolicy),r=createSlackFetchFile({api:t,botToken:e.credentials?.botToken,maxBytes:maxBytesOf(n)}),i=e.onAnswers??defaultOnAnswers,a=composeSlackRenderers(e.renderers??[],{events:{...defaultEvents,"interaction.opened":defaultInteractionOpenedHandler(e.approvalChannel)},received:defaultReceived,taskCard:renderDefaultSlackTaskCard}),o=a.events[`turn.started`],s=withTaskCards({...a.events,"content.completed":withFinalReplyDelivery(a.events[`content.completed`]),async"turn.started"(e,t){let{channel:n}=t,r=slackUserIdFromAuthContext(t.session.auth.current);r!==void 0&&(n.state.triggeringUserId=r),await o?.(e,t)}},a.taskCard),c=new Set,l=defineChannel({turnPolicy:e.turnPolicy,uploadPolicy:e.uploadPolicy,state:{channelId:null,threadTs:null,teamId:null,installationTeamId:null,triggeringUserId:null,triggeringMessageTs:null,pendingToolCallMessage:null,pendingAuthMessageTs:{},pendingApprovalCards:{},slackUsersByPrincipal:{}},fetchFile:r,metadata(e){return{channelId:e.channelId,teamId:e.teamId,threadTs:e.threadTs,triggeringUserId:e.triggeringUserId??null}},audience:({state:e})=>e.audience??`unknown`,context(n,r){return rebuildSlackContext(n,r,t,e.credentials)},deliver(e,t){return recordSlackPrincipal(t.state,t.session.auth.current,e),withUndeliveredReplyNote(t.state,e,`Slack`)},routes:[POST(e.route??SLACK_CHANNEL_DEFAULT_ROUTE,async(r,o)=>{let{waitUntil:s}=o,{from:l,resolveSession:u}=o,d=await verifyInbound(r,e.credentials);return d===null?new Response(`unauthorized`,{status:401}):shouldDropSlackHttpTimeoutRetry(r.headers)?new Response(`ok`):(r.headers.get(`content-type`)??``).includes(`application/x-www-form-urlencoded`)?handleInteractionPost(d,{from:l,resolveSession:u,waitUntil:s},{api:t,config:e,onAnswers:i}):handleEventPost({api:t,body:d,from:l,resolveSession:u,waitUntil:s,config:e,received:a.received,uploadPolicy:n,handledEvents:c,headers:r.headers})})],receive(n,{from:r}){return receiveOnSlack(n,{from:r,api:t,credentials:e.credentials})},events:s}),u=e.credentials,d=defineSlackAppManifest({botName:e.botName});return setChannelBuildMetadata(l,e=>({externalCredentials:u?.vercelConnect,manifest:d.build(e)})),l}function defaultOnAnswers(e){return{auth:e.defaultAuth}}async function receiveOnSlack(e,t){let n=e.target,r=n.channelId;if(!r||typeof r!=`string`)throw Error(`slackChannel().receive requires target.channelId.`);let i=typeof n.threadTs==`string`?n.threadTs:``,a=typeof n.installationTeamId==`string`?n.installationTeamId:t.installationTeamId,o=n.initialMessage;if(o&&i.length>0)throw Error("slackChannel().receive: `threadTs` and `initialMessage` are mutually exclusive.");let s=i;if(o){let{thread:e}=buildSlackBinding({api:t.api,botToken:t.credentials?.botToken,channelId:r,threadTs:``,installationTeamId:a,teamId:t.teamId}),n={card:o.card};o.fallbackText!==void 0&&(n.fallbackText=o.fallbackText),s=(await e.post(n)).id}let c=s||crypto.randomUUID(),l=n.audience===void 0?void 0:normalizeChannelAudience(n.audience),u={channelId:r,installationTeamId:a??null,threadTs:s||null,teamId:t.teamId??null,triggeringUserId:t.triggeringUserId??null};return l!==void 0&&(u.audience=l),t.from(slackContinuationToken({channelId:r,threadTs:c})).send(e.message,{auth:e.auth,history:e.history,state:u,title:e.title})}function shouldDropSlackHttpTimeoutRetry(e){return Number(e.get(`x-slack-retry-num`)??`0`)>=1&&e.get(`x-slack-retry-reason`)===`http_timeout`}async function handleEventPost(e){let{config:t}=e,n,r;try{n=parseSlackWebhookBody(e.body,{headers:e.headers}),r=parseSlackEventEnvelope(e.body)}catch(e){return log.warn(`inbound webhook body is not valid JSON`,{error:e}),new Response(`ok`)}if(n.kind===`url_verification`)return new Response(n.challenge,{status:200,headers:{"content-type":`text/plain`}});if(r===null)return new Response(`ok`);let i=typeof r.api_app_id==`string`?r.api_app_id:void 0,a=slackEventBotUserId(r),o=slackEventReceivingBotUserId(r),s=slackEventInstallationTeamId(r),dispatch=null,c=null,dispatchMessage=(n,r,c)=>()=>dispatchSlackMessage({api:e.api,appId:i,botUserId:a,receivingBotUserId:o,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,handler:c,installationTeamId:s,kind:n,message:r,received:e.received,resolvesTypedInput:t.onAnswers===void 0&&t.approvalChannel===void 0,threadContext:t.threadContext,uploadPolicy:e.uploadPolicy});if(n.kind===`app_mention`||n.kind===`direct_message`){let e=n.kind,r=slackMessageFromWebhookPayload(n,s);if(r!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},r)){let n=(e===`app_mention`?t.onAppMention:t.onDirectMessage)??t.onMessage;n===void 0?c=dispatchMessage(e,r,defaultOnMessage):dispatch=dispatchMessage(e,r,n)}}let l=t.onMessage;if(dispatch===null&&l!==void 0){let e=parseMessageEvent(r);e!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},e)&&(a===void 0||!e.text.includes(`<@${a}`))&&(dispatch=dispatchMessage(`channel_message`,e,l))}let u=t.onEvent;if(dispatch===null&&u!==void 0&&(dispatch=()=>dispatchSlackEvent({api:e.api,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,envelope:r,handler:u,installationTeamId:s})),dispatch??=c,dispatch===null)return new Response(`ok`);let d=r.event_id;if(d){if(e.handledEvents.has(d))return log.warn(`received a duplicate event`,{event_id:d,event_time:r.event_time,retry_num:n.retry?.num??`(null)`,retry_reason:n.retry?.reason??`(null)`}),new Response(`ok`);markEventHandled(d,e.handledEvents)}return e.waitUntil(dispatch()),new Response(`ok`)}function isSelfAuthoredSlackMessage(e,t){return e.botUserId!==void 0&&t.author?.userId===e.botUserId||e.appId!==void 0&&t.raw.app_id===e.appId}async function dispatchSlackMessage(e){let t=slackContinuationToken({channelId:e.message.channelId,threadTs:e.message.threadTs}),{thread:n,slack:r}=buildSlackBinding({api:e.api,appId:e.appId,botToken:e.credentials?.botToken,botUserId:e.botUserId,channelId:e.message.channelId,threadTs:e.message.threadTs,threadHasReplies:e.message.threadTs!==e.message.ts,installationTeamId:e.installationTeamId,teamId:e.message.teamId}),i=e.message.author,a={channelId:e.message.channelId,installationTeamId:e.installationTeamId??null,teamId:e.message.teamId??null,threadTs:e.message.threadTs,triggeringMessageTs:e.message.ts,triggeringUserId:i?.userId??null},o=bindSlackSessionOperations({address:t,defaultAuth:i===void 0?null:buildSlackAuthContext({channelId:e.message.channelId,fullName:i.fullName,installationTeamId:e.installationTeamId,isBot:i.isBot,teamId:e.message.teamId,threadTs:e.message.threadTs,userId:i.userId,userName:i.userName}),from:e.from,resolveSession:e.resolveSession,state:a}),s,isDMOrPrivateChannel=()=>s??=isPrivateSlackConversation({channelId:e.message.channelId,raw:e.message.raw,request:r.request}),c=e.kind===`app_mention`||e.botUserId!==void 0&&e.message.text.includes(`<@${e.botUserId}`),l={...o,isBotMentioned:()=>c,isDMOrPrivateChannel,isSubscribed:async()=>await o.resolveSession()!==void 0,slack:r,thread:n},u=e.kind===`channel_message`?void 0:acknowledgeMessage(e.received,e.message,{slack:r,thread:n}),d;try{d=await e.handler(l,e.message)}catch(t){logError(log,`${e.kind} handler failed`,t,{channelId:e.message.channelId})}if(d==null){u!==void 0&&(await u,await n.startTyping());return}await(u??acknowledgeMessage(e.received,e.message,{slack:r,thread:n}));let f=await isDMOrPrivateChannel();a.audience=e.kind===`direct_message`||f?`private`:`public`,await deliverSlackMessage({botUserId:e.receivingBotUserId,credentials:e.credentials,kind:e.kind,isPrivateConversation:f,isMentioned:c,message:e.message,resolvesTypedInput:e.resolvesTypedInput,result:d,sessionOperations:o,thread:n,threadContext:e.threadContext,uploadPolicy:e.uploadPolicy})}async function acknowledgeMessage(e,t,n){try{await e(t,n)}catch(e){logError(log,`received renderer failed`,e,{channelId:t.channelId})}}async function dispatchSlackEvent(e){let t=e.envelope.event.team_id,n=typeof t==`string`?t:typeof e.envelope.team_id==`string`?e.envelope.team_id:void 0,r=[],sourceFor=t=>e.from(slackContinuationToken({channelId:t.channelId,threadTs:t.threadTs})),i={cancel:({target:e,turnId:t})=>sourceFor(e).cancel({turnId:t}),clear:({target:e})=>sourceFor(e).clear(),compact:({target:e})=>sourceFor(e).compact(),envelope:e.envelope,reset:({reason:e,target:t})=>sourceFor(t).reset({reason:e}),resolveSession:({target:t})=>e.resolveSession(slackContinuationToken({channelId:t.channelId,threadTs:t.threadTs})),respond:(t,{auth:n,target:r})=>sourceFor(r).respond(t,{auth:n,state:withSlackResponder(void 0,typeof e.envelope.event.user==`string`?e.envelope.event.user:void 0)}),send:(t,{auth:r,history:i,target:a,title:o})=>receiveOnSlack({auth:r,history:i,message:t,target:a,title:o},{from:e.from,api:e.api,credentials:e.credentials,installationTeamId:e.installationTeamId,teamId:n,...typeof e.envelope.event.user==`string`?{triggeringUserId:e.envelope.event.user}:{}}),slack:buildSlackWorkspaceHandle({api:e.api,botToken:e.credentials?.botToken,installationTeamId:e.installationTeamId,teamId:n}),waitUntil(e){r.push(e)}};try{await e.handler(i,e.envelope.event)}catch(t){logError(log,`event handler failed`,t,{eventId:e.envelope.event_id,eventType:e.envelope.event.type})}await Promise.allSettled(r)}async function verifyInbound(e,t){try{return await verifySlackRequest$1(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 deliverSlackMessage(e){let{message:t,thread:n}=e;try{let r=e.threadContext===void 0?[]:await loadThreadContextMessages(n,t,e.threadContext),i=r.length>0&&e.result.history===void 0&&await e.sessionOperations.resolveSession()===void 0,a=i?void 0:formatSlackThreadContext(r),o=e.result.history??(i?slackThreadSessionHistory(r):void 0),s=await collectInboundFileParts({botUserId:e.botUserId,fetchThreadWindow:(e,t)=>fetchSlackThreadWindow(n,e,t),isMentioned:e.kind===`app_mention`,mention:t,thread:n,policy:e.uploadPolicy}),c={botUserId:e.botUserId,channelId:t.channelId,fullName:t.author?.fullName,isMentioned:e.isMentioned,teamId:t.teamId,threadTs:t.threadTs,userId:t.author?.userId??``,userName:t.author?.userName},l=formatSlackInboundMessage(c,t),u=buildSlackTurnMessage(a===void 0?l:`${a}\n\n${l}`,s),d=e.result.context??[],f=e.isPrivateConversation?`Private message`:e.result.title??t.markdown,p=e.resolvesTypedInput?slackTypedText(t.text,e.botUserId):``,m=attachInputText({auth:e.result.auth,title:f,...d.length>0&&{context:d},...o!==void 0&&{history:o}},s.length===0?p:void 0);await e.sessionOperations.send(u,m)}catch(n){logError(log,`${e.kind} delivery failed`,n,{channelId:t.channelId})}}function slackTypedText(e,t){return t===void 0?e:e.replace(RegExp(`<@${t}(?:\\|[^>]*)?>`,`gu`),``).trim()}function recordSlackPrincipal(e,t,n){if(t===null)return;let r=n.state?.triggeringUserId,i=slackUserIdFromAuthContext(t)??(typeof r==`string`?r:void 0);i!==void 0&&(e.slackUsersByPrincipal={...e.slackUsersByPrincipal,[t.principalId]:i})}export{slackChannel};

package/dist/src/public/channels/slack/task-card.d.ts

@@ -1,4 +1,4 @@
-import { type TaskCardTurn, type TaskCardView } from "#channel/task-card.js";
+import { type TaskCard } from "#channel/task-card.js";
 import type { SlackTaskCard } from "#public/channels/slack/renderers.js";
 import type { SlackChannelInternalEvents } from "#public/channels/slack/slackChannel.js";
 /**
@@ -8,17 +8,17 @@ import type { SlackChannelInternalEvents } from "#public/channels/slack/slackCha
  * with `eve__task_cancel` shows as done, since it no longer needed the work; a
  * failed task, or one stopped any other way, shows as an error.
  */
-export declare function renderDefaultSlackTaskCard(view: TaskCardView): SlackTaskCard | null;
-/** A turn's tracked calls, and the card eve last wrote for it. */
+export declare function renderDefaultSlackTaskCard(snapshot: TaskCard): SlackTaskCard | null;
+/** The card message eve last wrote for a turn: the card that begins at `since`. */
 export interface SlackTaskCardState {
-    readonly turn: TaskCardTurn;
     readonly ts?: string;
     readonly fingerprint?: string;
+    /** Where the card it shows begins; absent for the turn's first. */
+    readonly since?: number;
 }
 /**
- * Keeps each turn's task card current from the session's own events. It runs
- * around the renderer chain, so the card never depends on which handlers a
- * renderer keeps: eve tracks the turn's calls first, runs the chain's handler,
- * then writes the card `taskCard` returns if it changed.
+ * Keeps each turn's task cards current from the session's tables, once per commit. It runs after
+ * the renderer chain's own `committed`, so the card never depends on which handlers a renderer
+ * keeps, and writes each card `taskCard` returns if it changed.
  */
-export declare function withTaskCards(events: SlackChannelInternalEvents, taskCard: (view: TaskCardView) => SlackTaskCard | null): SlackChannelInternalEvents;
+export declare function withTaskCards(events: SlackChannelInternalEvents, taskCard: (card: TaskCard) => SlackTaskCard | null): SlackChannelInternalEvents;

package/dist/src/public/channels/slack/task-card.js

@@ -1 +1 @@
-import{createHash}from"node:crypto";import{createLogger,logError}from"#internal/logging.js";import{normalizeChannelAudience}from"#shared/channel-audience.js";import{contextStorage}from"#context/container.js";import{ScheduleIdKey}from"#context/keys.js";import{displayName}from"#shared/display-name.js";import{AGENT_TOOL_NAME}from"#tools/framework/agent-contract.js";import{formatDuration}from"#shared/format-duration.js";import{truncateMessageText}from"#public/channels/slack/limits.js";import{closeSettledTasks,taskCardView,trackTaskCardEvent}from"#channel/task-card.js";import{restoreStatus}from"#public/channels/slack/thread-status.js";const log=createLogger(`slack.task-card`);function renderDefaultSlackTaskCard(e){if(e.tasks.length===0)return null;let t=collapseEarlierRows(e.tasks).map(toSlackTask),n=planTitle(e),r=slackBlockId(e.turnId),i=t.length===1?[{block_id:r,type:`task_card`,...t[0]}]:[{block_id:r,type:`plan`,tasks:t,title:n}],a=e.tasks.map(e=>e.title).join(`, `);return{blocks:i,text:truncateMessageText(`${n}: ${a}`)}}function planTitle(e){let{tasks:t}=e;if(e.state===`blocked`){let e=t.find(e=>e.blockedOn!==void 0)?.blockedOn;return waitingText(e?.kind??`input`)}let n=t.length,names=e=>n>1?agentNames(e):void 0;if(e.state===`working`){let e=t.filter(e=>e.status===`working`),r=n-e.length;if(r===0){let e=names(t);return e===void 0?`Working on ${countTasks(n)}`:`Asking ${e}`}let i=`${String(r)} of ${countTasks(n)} done`,a=names(e);return a===void 0?i:`Waiting on ${a} · ${i}`}let r=t.filter(e=>e.status===`failed`).length,i=t.filter(isInterrupted).length,a=[];r>0&&a.push(`${String(r)} failed`),i>0&&a.push(`${String(i)} stopped`);let o=turnDuration(t),s=`Finished ${countTasks(n)}${o===void 0?``:` in ${o}`}`;return a.length===0?s:`${s}: ${a.join(`, `)}`}function agentNames(e){if(e.some(e=>e.kind!==`agent`||e.name===AGENT_TOOL_NAME))return;let t=[...new Set(e.map(e=>displayName(e.name)))];if(!(t.length===0||t.length>3))return t.length<=2?t.join(` and `):`${t.slice(0,-1).join(`, `)}, and ${t.at(-1)}`}function turnDuration(e){let t=e.flatMap(e=>e.settledAt===void 0?[]:[Date.parse(e.settledAt)]);if(t.length===0)return;let n=Math.min(...e.map(e=>Date.parse(e.startedAt)));return shownDuration(Math.max(...t)-n)}function taskDuration(e){if(e.settledAt!==void 0)return shownDuration(Date.parse(e.settledAt)-Date.parse(e.startedAt))}function shownDuration(e){return Number.isFinite(e)&&e>=1e3?formatDuration(e):void 0}function isInterrupted(e){return e.status===`cancelled`&&e.cancelReason!==`task_cancel`}function countTasks(e){return e===1?`1 task`:`${String(e)} tasks`}function collapseEarlierRows(e){if(e.length<=50)return e;let t=e.length-49,n=new Set(e.filter(e=>e.status!==`working`).slice(0,t).map(e=>e.id)),r=e.filter(e=>!n.has(e.id));if(n.size===0)return r.slice(-50);let i=e.some(e=>n.has(e.id)&&(e.status===`failed`||isInterrupted(e)));return[{id:`earlier`,kind:`tool`,name:`earlier`,startedAt:e[0].startedAt,status:i?`failed`:`completed`,taskId:`earlier`,title:`${countTasks(n.size)} finished earlier`},...r].slice(-50)}function toSlackTask(e){let t={status:slackStatus(e),task_id:slackTaskId(e.id),title:truncate(e.title,80)};e.blockedOn!==void 0&&(t.details=richText(blockerLine(e.blockedOn)));let n=outputLine(e);return n!==void 0&&(t.output=richText(n)),t}function slackStatus(e){switch(e.status){case`working`:case`blocked`:return`in_progress`;case`completed`:return`complete`;case`cancelled`:return isInterrupted(e)?`error`:`complete`;case`failed`:return`error`}}function outputLine(e){let t=taskDuration(e);switch(e.status){case`completed`:{if(t===void 0)return e.summary;let n=`Done in ${t}`;return e.summary===void 0?n:`${n}: ${e.summary}`}case`failed`:{let n=t===void 0?`Failed`:`Failed after ${t}`;return e.summary===void 0?n:`${n}: ${e.summary}`}case`cancelled`:return stoppedLine(e.cancelReason);default:return}}function stoppedLine(e){switch(e){case`task_cancel`:return`Stopped early since it was no longer needed`;case`turn_cancelled`:return`Stopped by request`;case`turn_ended`:return`Stopped when the turn ended`;case void 0:return`Stopped`}}function blockerLine(e){let t=waitingText(e.kind);return e.label===void 0?t:`${t}: ${e.label}`}function waitingText(e){switch(e){case`approval`:return`Waiting for approval`;case`authorization`:return`Waiting for sign-in`;case`input`:return`Waiting for a response`}}function richText(e){return{elements:[{elements:[{text:truncate(e,100),type:`text`}],type:`rich_text_section`}],type:`rich_text`}}function truncate(e,t){if(e.length<=t)return e;let n=e.slice(0,t-1),r=n.lastIndexOf(` `);return`${(r>t/2?n.slice(0,r):n).trimEnd()}…`}function slackTaskId(e){return e.replace(/[^a-zA-Z0-9_-]/g,`_`).slice(-200)}function slackBlockId(e){return`eve_task_card_${slackTaskId(e)}`}const TRACKED_EVENTS=[`actions.requested`,`action.result`,`task.started`,`task.settled`,`input.requested`,`input.resolved`,`authorization.required`,`authorization.completed`,`turn.completed`,`turn.failed`,`turn.cancelled`];function withTaskCards(e,t){let n={};for(let r of TRACKED_EVENTS){let i=e[r];n[r]=async(e,n,a)=>{let o={data:e,type:r};o.type===`task.started`&&await closeSettledCard(n,o.data,t);let s=trackTaskCardEvent(trackedTurns(n.state),o,new Date().toISOString());for(let[e,t]of Object.entries(s))rememberTurn(n.state,e,t);try{await i?.(e,n,a)}finally{for(let e of Object.keys(s))await writeTaskCard(n,e,t)}}}return{...e,...n}}async function closeSettledCard(e,t,n){let r=e.state.taskCards?.[t.turnId],i=r&&closeSettledTasks(r.turn,t.callId);i!==void 0&&(e.state.taskCards={...e.state.taskCards,[t.turnId]:{...r,turn:i.closed}},await writeTaskCard(e,t.turnId,n),e.state.taskCards={...e.state.taskCards,[t.turnId]:{turn:i.open}})}function trackedTurns(e){return Object.fromEntries(Object.entries(e.taskCards??{}).map(([e,t])=>[e,t.turn]))}function rememberTurn(e,t,n){let r={...e.taskCards,[t]:{...e.taskCards?.[t],turn:n}},i=Object.keys(r);for(let e of i.slice(0,Math.max(0,i.length-20)))delete r[e];e.taskCards=r}async function writeTaskCard(e,t,n){let r=e.state.taskCards?.[t];if(r===void 0)return;let i=normalizeChannelAudience(e.state.audience),a=taskCardView(t,r.turn,{audience:i}),{channelId:o,threadTs:s}=e.state,c=contextStorage.getStore()?.get(ScheduleIdKey)!==void 0,l=o&&s&&!c?{channelId:o,threadTs:s}:void 0,u=l===void 0?null:renderCard(n,a);if(l!==void 0&&u!==null){let n=createHash(`sha256`).update(JSON.stringify(u)).digest(`base64url`);if(n!==r.fingerprint){let i=await writeCardWithRetry(e.slack,{...l,card:u,ts:r.ts});if(i===void 0)return;e.state.taskCards={...e.state.taskCards,[t]:{fingerprint:n,ts:i,turn:r.turn}},i!==r.ts&&a.state===`working`&&await restoreStatus(e)}}a.state===`finished`&&forgetTurn(e.state,t)}function forgetTurn(e,t){let{[t]:n,...r}=e.taskCards??{};e.taskCards=r}function renderCard(e,t){try{return e(t)}catch(e){return logError(log,`task card renderer failed`,e,{turnId:t.turnId}),null}}async function writeCardWithRetry(e,t){for(let n of[1,2])try{return await writeCard(e,t)}catch(e){logError(log,`task card write failed`,e,{attempt:n}),n===1&&await new Promise(e=>setTimeout(e,1e3))}}async function writeCard(e,t){let n={blocks:t.card.blocks,channel:t.channelId,text:t.card.text};if(t.ts!==void 0){let r=await e.request(`chat.update`,{...n,ts:t.ts});if(r.ok===!0)return t.ts;if(r.error!==`message_not_found`)throw slackError(r.error)}let r=await e.request(`chat.postMessage`,{...n,thread_ts:t.threadTs,unfurl_links:!1,unfurl_media:!1});if(r.ok!==!0)throw slackError(r.error);if(typeof r.ts!=`string`||r.ts===``)throw Error(`Slack did not return a ts for the task card.`);return r.ts}function slackError(e){return Error(`Slack task card failed: ${e??`unknown_error`}`)}export{renderDefaultSlackTaskCard,withTaskCards};
+import{createHash}from"node:crypto";import{callLabel,callOutputSource,callState,openInteractions}from"#protocol/session-projection/selectors.js";import{createLogger,logError}from"#internal/logging.js";import{normalizeChannelAudience}from"#shared/channel-audience.js";import{sessionTables}from"#protocol/session-projection/session-view.js";import{contextStorage}from"#context/container.js";import{ScheduleIdKey}from"#context/keys.js";import{displayName}from"#protocol/session-projection/display-name.js";import{AGENT_TOOL_NAME}from"#tools/framework/agent-contract.js";import{formatDuration}from"#shared/format-duration.js";import{firstSentence,normalizePresentationText}from"#shared/presentation-text.js";import{truncateMessageText}from"#public/channels/slack/limits.js";import{taskCards}from"#channel/task-card.js";import{restoreStatus}from"#public/channels/slack/thread-status.js";const log=createLogger(`slack.task-card`);function renderDefaultSlackTaskCard(e){let t=sessionTables(e.view),n={...e,view:t,calls:e.calls.flatMap(e=>t.calls[e.callId]??[])},r=n.calls.filter(e=>e.taskId!==void 0);if(r.length===0)return null;let{earlier:i,rows:a}=collapseEarlierRows(n.view,r),o=planTitle(n,r),s=[...i===void 0?[]:[i],...a.map(e=>toSlackTask(n,e))],c=slackBlockId(n.turnId),l=s.length===1?[{block_id:c,type:`task_card`,...s[0]}]:[{block_id:c,type:`plan`,tasks:s,title:o}],u=r.map(e=>callLabel(e)).join(`, `);return{blocks:l,text:truncateMessageText(`${o}: ${u}`)}}function planTitle(e,t){let{view:n}=e;if(e.state===`blocked`)return waitingText(t.flatMap(e=>openInteractions(n,{about:{callId:e.callId}}))[0]?.request.kind);let r=t.length,names=e=>r>1?agentNames(n,e):void 0;if(e.state===`working`){let e=t.filter(e=>e.status!==`settled`),n=r-e.length;if(n===0){let e=names(t);return e===void 0?`Working on ${countTasks(r)}`:`Asking ${e}`}let i=`${String(n)} of ${countTasks(r)} done`,a=names(e);return a===void 0?i:`Waiting on ${a} · ${i}`}let i=t.filter(e=>failedTask(n,e)).length,a=t.filter(e=>isInterrupted(n,e)).length,o=[];i>0&&o.push(`${String(i)} failed`),a>0&&o.push(`${String(a)} stopped`);let s=turnDuration(t),c=`Finished ${countTasks(r)}${s===void 0?``:` in ${s}`}`;return o.length===0?c:`${c}: ${o.join(`, `)}`}function agentNames(e,t){let agent=t=>(t.taskId===void 0?void 0:e.tasks[t.taskId]?.kind)??t.capability.kind;if(t.some(e=>agent(e)!==`agent`||e.capability.name===AGENT_TOOL_NAME))return;let n=[...new Set(t.map(e=>displayName(e.capability.name)))];if(!(n.length===0||n.length>3))return n.length<=2?n.join(` and `):`${n.slice(0,-1).join(`, `)}, and ${n.at(-1)}`}function turnDuration(e){let t=e.flatMap(e=>e.endedAt===void 0?[]:[Date.parse(e.endedAt)]);if(t.length===0)return;let n=Math.min(...e.map(e=>Date.parse(e.startedAt)));return shownDuration(Math.max(...t)-n)}function taskDuration(e){if(e.endedAt!==void 0)return shownDuration(Date.parse(e.endedAt)-Date.parse(e.startedAt))}function shownDuration(e){return Number.isFinite(e)&&e>=1e3?formatDuration(e):void 0}function failedTask(e,t){let n=callState(e,t.callId);return n===`failed`||n===`rejected`}function isInterrupted(e,t){return callState(e,t.callId)===`cancelled`&&t.reason!==`task-cancel`}function countTasks(e){return e===1?`1 task`:`${String(e)} tasks`}function collapseEarlierRows(e,t){if(t.length<=50)return{rows:t};let n=t.length-49,r=t.filter(e=>e.status===`settled`).slice(0,n),i=new Set(r.map(e=>e.callId)),a=t.filter(e=>!i.has(e.callId));return r.length===0?{rows:a.slice(-50)}:{earlier:{status:r.some(t=>failedTask(e,t)||isInterrupted(e,t))?`error`:`complete`,task_id:`earlier`,title:truncate(`${countTasks(r.length)} finished earlier`,80)},rows:a.slice(-49)}}function toSlackTask(e,t){let{view:n}=e,r={status:slackStatus(n,t),task_id:slackTaskId(t.callId),title:truncate(callLabel(t),80)},i=openInteractions(n,{about:{callId:t.callId}}).at(-1);i!==void 0&&(r.details=richText(blockerLine(e,i)));let a=outputLine(e,t);return a!==void 0&&(r.output=richText(a)),r}function slackStatus(e,t){switch(callState(e,t.callId)){case`completed`:return`complete`;case`cancelled`:return isInterrupted(e,t)?`error`:`complete`;case`failed`:case`rejected`:return`error`;default:return`in_progress`}}function outputLine(e,t){let{view:n}=e,r=taskDuration(t);switch(callState(n,t.callId)){case`completed`:{let e=brief(resultText(callOutputSource(n,t.callId)?.output??t.output));if(r===void 0)return e;let i=`Done in ${r}`;return e===void 0?i:`${i}: ${e}`}case`failed`:case`rejected`:{let n=r===void 0?`Failed`:`Failed after ${r}`,i=e.audience===`private`?brief(t.error?.message):void 0;return i===void 0?n:`${n}: ${i}`}case`cancelled`:return stoppedLine(t.reason);default:return}}function stoppedLine(e){switch(e){case`task-cancel`:return`Stopped early since it was no longer needed`;case`turn-cancelled`:return`Stopped by request`;case`turn-ended`:return`Stopped when the turn ended`;default:return`Stopped`}}function blockerLine(e,t){let{request:n}=t,r=waitingText(n.kind);if(e.audience!==`private`)return r;let i=n.kind===`sign-in`?n.signIn?.displayName??n.signIn?.name??n.prompt:n.prompt,a=i===void 0?``:normalizePresentationText(i);return a===``?r:`${r}: ${a.slice(0,200)}`}function waitingText(e){switch(e){case`approval`:return`Waiting for approval`;case`sign-in`:return`Waiting for sign-in`;default:return`Waiting for a response`}}function resultText(e){if(typeof e==`string`)return e;if(typeof e!=`object`||!e||Array.isArray(e))return;let t=e;return t.message??t.text??t.summary}function brief(e){return typeof e==`string`?firstSentence(e):void 0}function richText(e){return{elements:[{elements:[{text:truncate(e,100),type:`text`}],type:`rich_text_section`}],type:`rich_text`}}function truncate(e,t){if(e.length<=t)return e;let n=e.slice(0,t-1),r=n.lastIndexOf(` `);return`${(r>t/2?n.slice(0,r):n).trimEnd()}…`}function slackTaskId(e){return e.replace(/[^a-zA-Z0-9_-]/g,`_`).slice(-200)}function slackBlockId(e){return`eve_task_card_${slackTaskId(e)}`}function withTaskCards(e,t){let n=e.committed;return{...e,async committed(e,r){try{await n?.(e,r)}finally{let{channel:n,view:i}=r,a=new Set([...e.facts.flatMap(e=>e.scope?.turnId??[]),...Object.keys(n.state.taskCards??{})]);for(let e of a)await writeTaskCards(n,sessionTables(i),e,t)}}}}async function writeTaskCards(e,t,n,r){if(t.turns[n]===void 0)return;let i=normalizeChannelAudience(e.state.audience),a=taskCards(t,n,i),o=e.state.taskCards?.[n]?.since??0;for(let t of a)t.since<o||(t.since>(e.state.taskCards?.[n]?.since??0)&&rememberCard(e.state,n,{since:t.since}),await writeChangedCard(e,n,t,r));a.at(-1)?.state===`finished`&&forgetTurn(e.state,n)}async function writeChangedCard(e,t,n,r){let{channelId:i,threadTs:a}=e.state,o=contextStorage.getStore()?.get(ScheduleIdKey)!==void 0;if(!i||!a||o)return;let s=renderCard(r,n);if(s===null)return;let c=e.state.taskCards?.[t]??{},l=createHash(`sha256`).update(JSON.stringify(s)).digest(`base64url`);if(l===c.fingerprint)return;let u=await writeCardWithRetry(e.slack,{card:s,channelId:i,threadTs:a,ts:c.ts});u!==void 0&&(rememberCard(e.state,t,{...c,fingerprint:l,ts:u}),u!==c.ts&&n.state===`working`&&await restoreStatus(e))}function rememberCard(e,t,n){let r={...e.taskCards,[t]:n},i=Object.keys(r);for(let e of i.slice(0,Math.max(0,i.length-20)))delete r[e];e.taskCards=r}function forgetTurn(e,t){let{[t]:n,...r}=e.taskCards??{};e.taskCards=r}function renderCard(e,t){try{return e(t)}catch(e){return logError(log,`task card renderer failed`,e,{turnId:t.turnId}),null}}async function writeCardWithRetry(e,t){for(let n of[1,2])try{return await writeCard(e,t)}catch(e){logError(log,`task card write failed`,e,{attempt:n}),n===1&&await new Promise(e=>setTimeout(e,1e3))}}async function writeCard(e,t){let n={blocks:t.card.blocks,channel:t.channelId,text:t.card.text};if(t.ts!==void 0){let r=await e.request(`chat.update`,{...n,ts:t.ts});if(r.ok===!0)return t.ts;if(r.error!==`message_not_found`)throw slackError(r.error)}let r=await e.request(`chat.postMessage`,{...n,thread_ts:t.threadTs,unfurl_links:!1,unfurl_media:!1});if(r.ok!==!0)throw slackError(r.error);if(typeof r.ts!=`string`||r.ts===``)throw Error(`Slack did not return a ts for the task card.`);return r.ts}function slackError(e){return Error(`Slack task card failed: ${e??`unknown_error`}`)}export{renderDefaultSlackTaskCard,withTaskCards};

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

@@ -1,3 +1,5 @@
+import type { TeamsChannelCredentials } from "#public/channels/teams/credentials.js";
+export type { TeamsChannelCredentials } from "#public/channels/teams/credentials.js";
 /**
  * Minimal Microsoft Teams Bot Framework Connector REST wrapper.
  *
@@ -22,15 +24,9 @@ export type TeamsAccessTokenResult = string | {
 /** 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 credentials?: TeamsChannelCredentials;
     /** Fetch override for tests or non-standard runtimes. */
     readonly fetch?: TeamsFetch;
     /**

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

@@ -1,4 +1,4 @@
-import type { FilePart, UserContent } from "ai";
+import type { MessageContent, MessageFilePart } from "#shared/message-content.js";
 import type { FetchFileResult } from "#channel/adapter.js";
 import { type TeamsApiOptions, type TeamsAttachment } from "#public/channels/teams/api.js";
 import { type UploadPolicyInput } from "#public/channels/upload-policy.js";
@@ -24,9 +24,9 @@ export interface TeamsFilesPolicy {
 /** Normalizes author-provided Teams file options. */
 export declare function normalizeTeamsFilesPolicy(config: TeamsFilesConfig | undefined): TeamsFilesPolicy;
 /** Collects Teams attachment file parts unless file support is disabled. */
-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;
+export declare function collectTeamsFileParts(attachments: readonly TeamsAttachment[], policy: TeamsFilesPolicy): MessageFilePart[];
+/** Combines text + file parts into the MessagePart[] shape expected by the harness. */
+export declare function buildTeamsTurnMessage(text: string, fileParts: readonly MessageFilePart[]): MessageContent;
 /**
  * Builds the channel `fetchFile` resolver for Teams file URLs. Returns null when
  * files are disabled or the URL host is not in `allowedHosts`; otherwise fetches

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

@@ -7,31 +7,28 @@
  */
 import type { Session } from "#channel/session.js";
 import type { SessionAuthContext } from "#channel/types.js";
-import type { AuthorizationRequiredStreamEvent } from "#protocol/message.js";
+import type { SignIn } from "#channel/sign-in.js";
 import type { TeamsChannelAccount, TeamsMessageBody } from "#public/channels/teams/api.js";
 import type { TeamsInvokeActivity } from "#public/channels/teams/inbound.js";
 import { type JsonObject } from "#shared/json.js";
-type AuthorizationRequired = AuthorizationRequiredStreamEvent["data"];
 /** Identifies one sign-in attempt from the shared card's button press. */
 export interface TeamsAuthorizationReveal {
-    readonly attemptId?: string;
+    readonly interactionId: string;
     readonly name: string;
     readonly replyToActivityId?: string;
 }
 /** A connection's display name for its sign-in cards (`linear` → `Linear`). */
 export declare function teamsAuthorizationDisplayName(event: {
-    readonly authorization?: {
-        readonly displayName?: string;
-    };
+    readonly displayName: string;
     readonly name: string;
 }): string;
 /** The full sign-in card, link and code included, for the person signing in alone. */
-export declare function renderTeamsAuthorizationPrompt(event: AuthorizationRequired, options: {
+export declare function renderTeamsAuthorizationPrompt(event: SignIn, options: {
     readonly adaptiveCardVersion: string;
     readonly requester: string | undefined;
 }): TeamsMessageBody;
 /** The shared sign-in card: who must sign in, and a button that shows them the challenge. */
-export declare function renderTeamsAuthorizationStatus(event: AuthorizationRequired, options: {
+export declare function renderTeamsAuthorizationStatus(event: SignIn, options: {
     readonly adaptiveCardVersion: string;
     readonly replyToActivityId: string | undefined;
     readonly requester: string | undefined;
@@ -50,4 +47,3 @@ export declare function answerTeamsAuthorizationReveal(input: {
     readonly resolveSession: () => Promise<Session | undefined>;
     readonly reveal: TeamsAuthorizationReveal;
 }): Promise<JsonObject>;
-export {};

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

@@ -1 +1 @@
-import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{displayProperName}from"#shared/display-name.js";import{parseJsonObject}from"#shared/json.js";import{findPendingAuthorization}from"#channel/pending-authorization.js";import{TEAMS_ADAPTIVE_CARD_CONTENT_TYPE,teamsInvokeResponse}from"#public/channels/teams/hitl.js";const log=createLogger(`teams.authorization`),NOT_YOURS=`Only the person who needs to sign in can open this sign-in.`,TEAMS_AUTHORIZATION_DATA_KEY=`eve_authorization`;function teamsAuthorizationDisplayName(e){return e.authorization?.displayName??displayProperName(e.name)}function renderTeamsAuthorizationPrompt(e,t){let n=teamsAuthorizationDisplayName(e),r=e.authorization?.url,i=e.authorization?.instructions,a=e.authorization?.userCode,o=a?`If ${n} asks for a confirmation code, enter ${a}.`:void 0,s=[r?`Authorization required for ${n}: ${r}`:`Authorization required for ${n}.`,i,o].filter(Boolean).join(` `);return{attachments:[adaptiveCard(t.adaptiveCardVersion,{actions:r?[{title:`Sign in with ${n}`,type:`Action.OpenUrl`,url:r}]:[],body:[heading(`Authorization required for ${n}`),textBlock(t.requester?`Requested by ${t.requester}.`:`No triggering user is available for a private prompt.`),...[i,o].filter(e=>!!e).map(e=>textBlock(e))]})],text:s}}function renderTeamsAuthorizationStatus(e,t){let n=teamsAuthorizationDisplayName(e),r=t.requester?`${t.requester} must sign in to continue. Only they can open the sign-in.`:`Only the person who needs to sign in can open it.`,i={attemptId:e.attemptId,name:e.name,replyToActivityId:t.replyToActivityId},a=`Authorization required for ${n}. ${r}`;return{attachments:[adaptiveCard(t.adaptiveCardVersion,{actions:[{data:{[TEAMS_AUTHORIZATION_DATA_KEY]:i},title:`Sign in`,type:`Action.Execute`,verb:`eve.authorization.reveal`}],body:[heading(`Authorization required for ${n}`),textBlock(r)]})],text:a}}function readTeamsAuthorizationReveal(e){let t=isObject(e.value?.action)?e.value.action:null,n=(t&&isObject(t.data)?t.data:null)?.[TEAMS_AUTHORIZATION_DATA_KEY];return!isObject(n)||typeof n.name!=`string`?null:{attemptId:typeof n.attemptId==`string`?n.attemptId:void 0,name:n.name,replyToActivityId:typeof n.replyToActivityId==`string`?n.replyToActivityId:void 0}}async function answerTeamsAuthorizationReveal(e){if(e.auth===null)return teamsInvokeResponse({message:NOT_YOURS});let{name:t,attemptId:n}=e.reveal,r;try{let i=await e.resolveSession();r=i&&await findPendingAuthorization(i,e=>e.name===t&&e.attemptId===n)}catch(e){log.error(`Teams sign-in lookup failed`,{error:e})}if(r===void 0)return teamsInvokeResponse({message:`This sign-in is no longer active.`});if(e.auth.principalId!==r.principalId)return teamsInvokeResponse({message:NOT_YOURS});let i=renderTeamsAuthorizationPrompt(r,{adaptiveCardVersion:e.adaptiveCardVersion,requester:e.presser.name??e.presser.id});return parseJsonObject({statusCode:200,type:TEAMS_ADAPTIVE_CARD_CONTENT_TYPE,value:i.attachments?.[0]?.content})}function adaptiveCard(e,t){return{content:parseJsonObject({$schema:`http://adaptivecards.io/schemas/adaptive-card.json`,...t,type:`AdaptiveCard`,version:e}),contentType:TEAMS_ADAPTIVE_CARD_CONTENT_TYPE}}function heading(e){return{text:e,type:`TextBlock`,weight:`Bolder`,wrap:!0}}function textBlock(e){return{text:e,type:`TextBlock`,wrap:!0}}export{answerTeamsAuthorizationReveal,readTeamsAuthorizationReveal,renderTeamsAuthorizationPrompt,renderTeamsAuthorizationStatus,teamsAuthorizationDisplayName};
+import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{parseJsonObject}from"#shared/json.js";import{findPendingAuthorization}from"#channel/pending-authorization.js";import{TEAMS_ADAPTIVE_CARD_CONTENT_TYPE,teamsInvokeResponse}from"#public/channels/teams/hitl.js";const log=createLogger(`teams.authorization`),NOT_YOURS=`Only the person who needs to sign in can open this sign-in.`,TEAMS_AUTHORIZATION_DATA_KEY=`eve_authorization`;function teamsAuthorizationDisplayName(e){return e.displayName}function renderTeamsAuthorizationPrompt(e,t){let n=teamsAuthorizationDisplayName(e),r=e.url,i=e.instructions,a=e.userCode,o=a?`If ${n} asks for a confirmation code, enter ${a}.`:void 0,s=[r?`Authorization required for ${n}: ${r}`:`Authorization required for ${n}.`,i,o].filter(Boolean).join(` `);return{attachments:[adaptiveCard(t.adaptiveCardVersion,{actions:r?[{title:`Sign in with ${n}`,type:`Action.OpenUrl`,url:r}]:[],body:[heading(`Authorization required for ${n}`),textBlock(t.requester?`Requested by ${t.requester}.`:`No triggering user is available for a private prompt.`),...[i,o].filter(e=>!!e).map(e=>textBlock(e))]})],text:s}}function renderTeamsAuthorizationStatus(e,t){let n=teamsAuthorizationDisplayName(e),r=t.requester?`${t.requester} must sign in to continue. Only they can open the sign-in.`:`Only the person who needs to sign in can open it.`,i={interactionId:e.interactionId,name:e.name,replyToActivityId:t.replyToActivityId},a=`Authorization required for ${n}. ${r}`;return{attachments:[adaptiveCard(t.adaptiveCardVersion,{actions:[{data:{[TEAMS_AUTHORIZATION_DATA_KEY]:i},title:`Sign in`,type:`Action.Execute`,verb:`eve.authorization.reveal`}],body:[heading(`Authorization required for ${n}`),textBlock(r)]})],text:a}}function readTeamsAuthorizationReveal(e){let t=isObject(e.value?.action)?e.value.action:null,n=(t&&isObject(t.data)?t.data:null)?.[TEAMS_AUTHORIZATION_DATA_KEY];return!isObject(n)||typeof n.name!=`string`||typeof n.interactionId!=`string`?null:{interactionId:n.interactionId,name:n.name,replyToActivityId:typeof n.replyToActivityId==`string`?n.replyToActivityId:void 0}}async function answerTeamsAuthorizationReveal(e){if(e.auth===null)return teamsInvokeResponse({message:NOT_YOURS});let{name:t,interactionId:n}=e.reveal,r;try{let i=await e.resolveSession();r=i&&await findPendingAuthorization(i,e=>e.name===t&&e.interactionId===n)}catch(e){log.error(`Teams sign-in lookup failed`,{error:e})}if(r===void 0)return teamsInvokeResponse({message:`This sign-in is no longer active.`});if(e.auth.principalId!==r.principalId)return teamsInvokeResponse({message:NOT_YOURS});let i=renderTeamsAuthorizationPrompt(r,{adaptiveCardVersion:e.adaptiveCardVersion,requester:e.presser.name??e.presser.id});return parseJsonObject({statusCode:200,type:TEAMS_ADAPTIVE_CARD_CONTENT_TYPE,value:i.attachments?.[0]?.content})}function adaptiveCard(e,t){return{content:parseJsonObject({$schema:`http://adaptivecards.io/schemas/adaptive-card.json`,...t,type:`AdaptiveCard`,version:e}),contentType:TEAMS_ADAPTIVE_CARD_CONTENT_TYPE}}function heading(e){return{text:e,type:`TextBlock`,weight:`Bolder`,wrap:!0}}function textBlock(e){return{text:e,type:`TextBlock`,wrap:!0}}export{answerTeamsAuthorizationReveal,readTeamsAuthorizationReveal,renderTeamsAuthorizationPrompt,renderTeamsAuthorizationStatus,teamsAuthorizationDisplayName};

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

@@ -0,0 +1,13 @@
+import type { TeamsAppId } from "#public/channels/teams/api.js";
+import type { TeamsAppPassword } from "#public/channels/teams/api.js";
+import type { TeamsTenantId } from "#public/channels/teams/api.js";
+import type { TeamsTokenProvider } from "#public/channels/teams/api.js";
+import type { TeamsWebhookVerifier } from "#public/channels/teams/verify.js";
+/** Credentials for the Teams channel and its API. */
+export interface TeamsChannelCredentials {
+    readonly appId?: TeamsAppId;
+    readonly appPassword?: TeamsAppPassword;
+    readonly tenantId?: TeamsTenantId;
+    readonly tokenProvider?: TeamsTokenProvider;
+    readonly webhookVerifier?: TeamsWebhookVerifier;
+}

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

@@ -0,0 +1 @@
+export{};

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

@@ -1,5 +1,5 @@
+import { signInEndedText } from "#channel/sign-in.js";
 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 { TeamsInvokeActivity, TeamsMessageActivity } from "#public/channels/teams/inbound.js";
 import type { TeamsChannelEvents, TeamsContext, TeamsInboundResult } from "#public/channels/teams/teamsChannel.js";
@@ -12,11 +12,7 @@ export declare const defaultEvents: TeamsChannelEvents;
 /** A connection name for the Teams auth card (`linear` → `Linear`). */
 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;
+export declare const buildAuthCompletedText: typeof signInEndedText;
 /** Builds a Teams mention entity and matching text for one channel account. */
 export declare function teamsMentionUser(user: {
     readonly id: string;

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

@@ -1,3 +1 @@
-import{extractErrorId,formatErrorHint}from"#internal/logging.js";import{displayProperName}from"#shared/display-name.js";import{resolvedPromptAnswer}from"#channel/resolved-prompt.js";import{splitTeamsMessageText}from"#public/channels/teams/api.js";import{renderAnsweredInputRequestMessage,renderInputRequestMessage}from"#public/channels/teams/hitl.js";import{renderTeamsAuthorizationPrompt,renderTeamsAuthorizationStatus,teamsAuthorizationDisplayName}from"#public/channels/teams/authorization.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.from.role===`bot`||t.from.id===t.recipient.id||t.scope!==`personal`&&!t.isBotMentioned?null:(await e.thread.startTyping(),{auth:defaultTeamsAuth(t)})}const defaultEvents={async"turn.started"(e,t,n){await t.thread.startTyping()},async"actions.requested"(e,t,n){await t.thread.startTyping()},async"input.requested"(e,t,n){for(let n of e.requests){let e=await t.thread.post(renderInputRequestMessage(n,{adaptiveCardVersion:t.adaptiveCardVersion,replyToActivityId:t.teams.replyToActivityId}));if(!e.id)continue;let r={activityId:e.id,prompt:n.prompt};t.state.pendingPromptCards={...t.state.pendingPromptCards,[n.requestId]:n.kind===`question`?{...r,options:(n.options??[]).map(({id:e,label:t})=>({id:e,label:t}))}:r}}},async"approval.settled"(e,t,n){let r=t.state.pendingPromptCards??{},i=r[e.requestId];if(i===void 0)return;let a=t.state.approvalResponderAccounts?.[e.responderPrincipalId],o=e.outcome===`approved`?`Approved`:`Cancelled`,s=a?.name??a?.id;await t.thread.update(i.activityId,renderAnsweredInputRequestMessage({includeText:!1,label:s===void 0?o:`${o} by ${s}`,prompt:i.prompt}));let c={...r};delete c[e.requestId],t.state.pendingPromptCards=c},async"input.resolved"(e,t,n){for(let n of e.resolutions){let e=t.state.pendingPromptCards??{},r=e[n.requestId];if(r===void 0)continue;await t.thread.update(r.activityId,renderAnsweredInputRequestMessage({includeText:!1,label:resolvedPromptAnswer(n,r.options),prompt:r.prompt}));let{[n.requestId]:i,...a}=e;t.state.pendingPromptCards=a}},async"message.completed"(e,t,n){if(e.finishReason!==`tool-calls`&&e.message)for(let n of splitTeamsMessageText(e.message))await t.thread.post(n)},async"session.failed"(e,t){let n=formatErrorHint(e),r=extractErrorId(e.details);await t.thread.post([`This session could not recover from an error${n}.`,``,`Start a new Teams conversation to continue.`,...r?[``,`Error id: ${r}`]:[]].join(`
-`))},async"turn.failed"(e,t,n){if(e.terminal)return;let r=formatErrorHint(e),i=extractErrorId(e.details);await t.thread.post([`I hit an error while handling your request${r}.`,``,`Please try again, rephrase, or reach out if it keeps failing.`,...i?[``,`Error id: ${i}`]:[]].join(`
-`))},async"authorization.required"(e,t,n){let r=signInAccount(e,t.state),i={adaptiveCardVersion:t.adaptiveCardVersion,replyToActivityId:t.teams.replyToActivityId,requester:r?r.name??r.id:void 0},a=await t.thread.post(t.state.conversationType===`personal`?renderTeamsAuthorizationPrompt(e,i):renderTeamsAuthorizationStatus(e,i));a.id&&(t.state.pendingAuthActivityId=a.id)},async"authorization.completed"(e,t,n){e.outcome===`authorized`&&await t.thread.startTyping();let r=t.state.pendingAuthActivityId;if(!r)return;let i=buildAuthCompletedText({displayName:teamsAuthorizationDisplayName(e),outcome:e.outcome,reason:e.reason});await t.thread.update(r,renderAnsweredInputRequestMessage({prompt:i})),t.state.pendingAuthActivityId=null}};function signInAccount(e,t){let n=e.principalId===void 0?void 0:t.approvalResponderAccounts?.[e.principalId];return n===void 0?e.candidateId===void 0?t.triggeringUser:null:n}function formatConnectionDisplayName(e){return displayProperName(e)}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};
+import{postedIn,signInEndedText}from"#channel/sign-in.js";import{displayProperName}from"#protocol/session-projection/display-name.js";import{resolvedPromptAnswer}from"#channel/resolved-prompt.js";import{surfaceEvents}from"#channel/surface.js";import{splitTeamsMessageText}from"#public/channels/teams/api.js";import{renderAnsweredInteractionMessage,renderInteractionMessage}from"#public/channels/teams/hitl.js";import{renderTeamsAuthorizationPrompt,renderTeamsAuthorizationStatus}from"#public/channels/teams/authorization.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.from.role===`bot`||t.from.id===t.recipient.id||t.scope!==`personal`&&!t.isBotMentioned?null:(await e.thread.startTyping(),{auth:defaultTeamsAuth(t)})}async function showTeamsRequest(e,t){let n=await e.thread.post(renderInteractionMessage(t,{adaptiveCardVersion:e.adaptiveCardVersion,replyToActivityId:e.teams.replyToActivityId}));if(!n.id)return;let r={activityId:n.id,prompt:t.request.prompt};e.state.pendingPromptCards={...e.state.pendingPromptCards,[t.interactionId]:t.request.kind===`question`?{...r,options:(t.request.options??[]).map(({id:e,label:t})=>({id:e,label:t}))}:r}}async function settleTeamsRequest(e,t){let{[t.interactionId]:n,...r}=e.state.pendingPromptCards??{};if(n===void 0)return;let{kind:i,outcome:a,responder:o}=t,s=i===`approval`&&o!==void 0&&(a===`accepted`||a===`declined`),c=resolvedPromptAnswer(t,n.options);if(s){let t=e.state.approvalResponderAccounts?.[o.id],n=t?.name??t?.id,r=a===`accepted`?`Approved`:`Cancelled`;c=n===void 0?r:`${r} by ${n}`}await e.thread.update(n.activityId,renderAnsweredInteractionMessage({includeText:!1,label:c,prompt:n.prompt})),e.state.pendingPromptCards=r}function teamsSignIns(e){return{private:e.state.conversationType===`personal`,postChallenge:async t=>(await e.thread.post(renderTeamsAuthorizationPrompt(t,signInOptions(e,t)))).id,post:async t=>(await e.thread.post({text:t})).id,postStatus:async t=>(await e.thread.post(renderTeamsAuthorizationStatus(t,signInOptions(e,t)))).id,async edit(t,n){await e.thread.update(t,renderAnsweredInteractionMessage({prompt:n}))},typing:()=>e.thread.startTyping(),posted:postedIn(e.state,`pendingAuthActivityIds`)}}function signInOptions(e,t){let n=(t.principalId===void 0?void 0:e.state.approvalResponderAccounts?.[t.principalId])??(t.responseId===void 0?e.state.triggeringUser:null);return{adaptiveCardVersion:e.adaptiveCardVersion,replyToActivityId:e.teams.replyToActivityId,requester:n==null?void 0:n.name??n.id}}const defaultEvents=surfaceEvents({typing:e=>e.thread.startTyping(),async post(e,t){for(let n of splitTeamsMessageText(t))await e.thread.post(n)},restart:`Teams conversation`,requests:{show:showTeamsRequest,settle:settleTeamsRequest},signIns:teamsSignIns});function formatConnectionDisplayName(e){return displayProperName(e)}const buildAuthCompletedText=signInEndedText;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

@@ -1,7 +1,8 @@
 /**
  * Teams Adaptive Card rendering and decode helpers for eve HITL prompts.
  */
-import { type InputRequest, type ValidatedInputResponse } from "#shared/input.js";
+import { type ValidatedAnswer } from "#shared/input.js";
+import type { Interaction } from "#channel/interaction-prompts.js";
 import type { TeamsActivity } from "#public/channels/teams/inbound.js";
 import type { TeamsAttachment, TeamsMessageBody } from "#public/channels/teams/api.js";
 import { type JsonObject } from "#shared/json.js";
@@ -18,7 +19,7 @@ export declare const TEAMS_HITL_REQUEST_KIND_KEY = "kind";
 /** Prompt carried on approval actions so a response can recover its card record. */
 export declare const TEAMS_HITL_PROMPT_KEY = "prompt";
 /** Renders one input request as a Teams message body containing an Adaptive Card. */
-export declare function renderInputRequestMessage(request: InputRequest, options?: {
+export declare function renderInteractionMessage(request: Interaction, options?: {
     readonly adaptiveCardVersion?: string;
     readonly replyToActivityId?: string;
 }): TeamsMessageBody;
@@ -27,12 +28,12 @@ export declare function renderInputRequestMessage(request: InputRequest, options
  * `options.adaptiveCardVersion` sets the card schema version (default "1.5").
  * Long prompt, choice, and action text is truncated to Teams card limits.
  */
-export declare function renderInputRequestAttachment(request: InputRequest, options?: {
+export declare function renderInteractionAttachment(request: Interaction, options?: {
     readonly adaptiveCardVersion?: string;
     readonly replyToActivityId?: string;
 }): TeamsAttachment;
 /** Renders an answered Teams card that replaces a pending HITL prompt. */
-export declare function renderAnsweredInputRequestMessage(input: {
+export declare function renderAnsweredInteractionMessage(input: {
     readonly includeText?: boolean;
     readonly label?: string;
     readonly prompt: string;
@@ -43,7 +44,7 @@ export declare function renderAnsweredInputRequestMessage(input: {
  */
 export declare function renderInactiveInputRequestMessage(prompt: string | undefined, label: string): TeamsMessageBody;
 /** Returns true when a Teams activity carries an eve HITL submit payload. */
-export declare function isTeamsInputResponseActivity(activity: TeamsActivity): boolean;
+export declare function isTeamsAnswerActivity(activity: TeamsActivity): boolean;
 /** Returns whether an eve HITL activity answers a tool approval. */
 export declare function isTeamsToolApprovalResponseActivity(activity: TeamsActivity): boolean;
 /** Reads the original prompt from a tool-approval submit activity. */
@@ -52,11 +53,11 @@ export declare function readTeamsToolApprovalPrompt(activity: TeamsActivity): st
 export declare function readTeamsInputPrompt(activity: TeamsActivity): string | undefined;
 /**
  * Decodes the eve HITL submit payload from a Teams activity. Returns a single
- * `InputResponse` (option selection, freeform text, or a bare requestId
+ * `Answer` (option selection, freeform text, or a bare requestId
  * acknowledgement), or an empty array when the activity has no recognizable
  * HITL payload or requestId.
  */
-export declare function deriveTeamsInputResponses(activity: TeamsActivity): readonly ValidatedInputResponse[];
+export declare function deriveTeamsAnswers(activity: TeamsActivity): readonly ValidatedAnswer[];
 /**
  * Builds the HTTP body Teams expects after an Adaptive Card invoke action.
  * Defaults to statusCode 200 and message "Answer received."; `type` is always