experimental-ash 0.26.0 → 0.28.0

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

@@ -1,242 +1 @@
-/**
- * Slack HITL widget rendering + click-decode helpers.
- *
- * Wire format: select-style HITL widgets mint `action_id =
- * HITL_ACTION_PREFIX + requestId`. Button widgets add a stable suffix so
- * every button in the same Slack actions block has a unique `action_id`.
- * The decoder requires that suffix for button payloads.
- *
- * Buttons surface the selected option on `action.value`; radio and
- * static selects surface it on `selected_option.value`. The decoder
- * picks whichever is set so the renderer can pick a widget kind on
- * UX grounds without changing the read path.
- */
-import { truncateModalTitle, truncatePlainText, truncateSectionText, } from "#public/channels/slack/limits.js";
-/**
- * Wire-format prefix every framework HITL widget mints onto its
- * `action_id`. Exposed so end-user adapters that render their own
- * interactive widgets can avoid collisions.
- */
-export const HITL_ACTION_PREFIX = "ash_input:";
-/**
- * `action_id` prefix for the "Type your answer" button that opens a
- * freeform-answer modal. Splitting the prefix from {@link HITL_ACTION_PREFIX}
- * lets the route handler differentiate "this click is a final answer"
- * (resolve via `inputResponses`) from "this click needs a modal first"
- * (call `views.open`, then resolve on `view_submission`).
- */
-export const HITL_FREEFORM_ACTION_PREFIX = "ash_input_freeform:";
-/**
- * `view.callback_id` carried on the freeform-answer modal. Used to
- * route the inbound `view_submission` back to this channel.
- */
-export const HITL_FREEFORM_MODAL_CALLBACK_ID = "ash_input_freeform_submit";
-/**
- * `block_id` of the modal's text-input block — the route reads the
- * submitted text out of `view.state.values[block_id][action_id]`.
- */
-export const HITL_FREEFORM_MODAL_BLOCK_ID = "ash_freeform_block";
-/**
- * `action_id` of the text input inside the freeform answer modal.
- */
-export const HITL_FREEFORM_MODAL_ACTION_ID = "ash_freeform_text";
-/**
- * Maximum radio-button option count before the renderer falls back to
- * a `static_select` dropdown. Matches Slack's UX guidance (radio
- * groups stay readable up to ~6 items).
- */
-const RADIO_SELECT_OPTION_LIMIT = 6;
-const BUTTON_ACTION_ID_RE = /^(?<requestId>.+):button:\d+$/u;
-/**
- * Decodes one Slack interactivity action into an HITL response, or
- * returns `null` when the action does not match an HITL widget the
- * framework rendered.
- */
-export function deriveHitlResponse(action) {
-    if (!action.actionId.startsWith(HITL_ACTION_PREFIX))
-        return null;
-    const encodedRequestId = action.actionId.slice(HITL_ACTION_PREFIX.length);
-    if (action.selectedOptionValue !== undefined) {
-        return encodedRequestId
-            ? { optionId: action.selectedOptionValue, requestId: encodedRequestId }
-            : null;
-    }
-    if (action.value !== undefined) {
-        const requestId = BUTTON_ACTION_ID_RE.exec(encodedRequestId)?.groups?.requestId;
-        return requestId ? { optionId: action.value, requestId } : null;
-    }
-    return null;
-}
-/**
- * Returns `true` when the action id was minted by an HITL widget the
- * framework rendered. Used by the channel route to split inbound
- * clicks into the HITL path vs. the user-owned `onInteraction` path.
- */
-export function isHitlAction(actionId) {
-    return actionId.startsWith(HITL_ACTION_PREFIX);
-}
-/**
- * Renders one `InputRequest` as Block Kit blocks:
- *
- * - `display === "select"` with ≤ {@link RADIO_SELECT_OPTION_LIMIT}
- *   options → `radio_buttons`. Single-click answer, options stay
- *   visible.
- * - `display === "select"` with more options → `static_select`
- *   dropdown so the picker stays scrollable.
- * - Anything else with options → buttons. Best for visually distinct
- *   choices (approve / deny / cancel).
- * - No options (or `allowFreeform: true`) → a single "Type your answer"
- *   button that opens a Slack modal with a plain_text_input. The modal
- *   submission comes back as a `view_submission` webhook the channel
- *   resolves into an {@link InputResponse} carrying `text`.
- *
- * Always emits at least the prompt section.
- */
-export function renderInputRequestBlocks(request) {
-    const prompt = {
-        text: { text: truncateSectionText(request.prompt), type: "mrkdwn" },
-        type: "section",
-    };
-    const actionId = `${HITL_ACTION_PREFIX}${request.requestId}`;
-    const options = request.options;
-    const acceptsFreeform = request.allowFreeform === true || !options || options.length === 0;
-    if (options && options.length > 0 && request.display === "select") {
-        const widget = options.length <= RADIO_SELECT_OPTION_LIMIT
-            ? { type: "radio_buttons", action_id: actionId, options: options.map(buildOption) }
-            : {
-                type: "static_select",
-                action_id: actionId,
-                options: options.map(buildOption),
-                placeholder: { type: "plain_text", text: "Choose an option" },
-            };
-        return [prompt, { type: "actions", elements: [widget] }];
-    }
-    if (options && options.length > 0) {
-        return [
-            prompt,
-            {
-                type: "actions",
-                elements: options.map((opt, index) => buildButton(opt, actionId, index)),
-            },
-        ];
-    }
-    if (acceptsFreeform) {
-        return [
-            prompt,
-            {
-                type: "actions",
-                elements: [
-                    {
-                        type: "button",
-                        action_id: `${HITL_FREEFORM_ACTION_PREFIX}${request.requestId}`,
-                        text: { type: "plain_text", text: "Type your answer" },
-                        style: "primary",
-                        value: request.requestId,
-                    },
-                ],
-            },
-        ];
-    }
-    return [prompt];
-}
-/**
- * Builds the `views.open` payload for the freeform-answer modal. The
- * triggering `prompt` is preserved as a header section so the user can
- * re-read what they're answering inside the modal.
- *
- * Title is auto-truncated to the Slack modal-title limit.
- */
-export function buildFreeformModalView(input) {
-    const title = input.prompt ? truncateModalTitle(input.prompt) : "Your answer";
-    const promptBlocks = input.prompt
-        ? [{ type: "section", text: { type: "mrkdwn", text: truncateSectionText(input.prompt) } }]
-        : [];
-    return {
-        type: "modal",
-        callback_id: HITL_FREEFORM_MODAL_CALLBACK_ID,
-        private_metadata: JSON.stringify(input.metadata),
-        title: { type: "plain_text", text: title },
-        submit: { type: "plain_text", text: "Submit" },
-        close: { type: "plain_text", text: "Cancel" },
-        blocks: [
-            ...promptBlocks,
-            {
-                type: "input",
-                block_id: HITL_FREEFORM_MODAL_BLOCK_ID,
-                element: {
-                    type: "plain_text_input",
-                    action_id: HITL_FREEFORM_MODAL_ACTION_ID,
-                    multiline: true,
-                    placeholder: { type: "plain_text", text: "Type your answer here..." },
-                },
-                label: { type: "plain_text", text: "Answer" },
-            },
-        ],
-    };
-}
-/**
- * True when an `action_id` was minted by the framework's freeform-answer
- * button (the click that opens a modal — not the final answer).
- */
-export function isFreeformAction(actionId) {
-    return actionId.startsWith(HITL_FREEFORM_ACTION_PREFIX);
-}
-/**
- * Extracts the requestId from a freeform-answer button's `action_id`.
- */
-export function freeformRequestIdFromActionId(actionId) {
-    if (!isFreeformAction(actionId))
-        return undefined;
-    const slice = actionId.slice(HITL_FREEFORM_ACTION_PREFIX.length);
-    return slice.length > 0 ? slice : undefined;
-}
-function buildButton(opt, actionId, index) {
-    const button = {
-        action_id: `${actionId}:button:${index}`,
-        text: { text: truncatePlainText(opt.label), type: "plain_text" },
-        type: "button",
-        value: opt.id,
-    };
-    if (opt.style === "primary" || opt.style === "danger") {
-        button.style = opt.style;
-    }
-    return button;
-}
-function buildOption(opt) {
-    const option = {
-        text: { text: truncatePlainText(opt.label), type: "plain_text" },
-        value: opt.id,
-    };
-    const description = truncatePlainText(opt.description);
-    if (description && description.length > 0) {
-        option.description = { text: description, type: "plain_text" };
-    }
-    return option;
-}
-/**
- * Renders the "answered" replacement blocks for a previously-posted
- * HITL card. Preserves the original prompt block (so context stays
- * visible), appends a confirmation line naming the chosen answer, and
- * attributes the click to the user when their id is known.
- *
- * Slack's `chat.update` replaces every block in one shot, so the caller
- * passes the full list to `blocks` and the rendered fallback text to
- * `text`.
- */
-export function buildAnsweredBlocks(input) {
-    const blocks = [];
-    if (input.promptBlock !== undefined && input.promptBlock !== null) {
-        blocks.push(input.promptBlock);
-    }
-    blocks.push({
-        type: "section",
-        text: { type: "mrkdwn", text: `:white_check_mark: *${input.answerLabel}*` },
-    });
-    if (input.userId && input.userId.length > 0) {
-        blocks.push({
-            type: "context",
-            elements: [{ type: "mrkdwn", text: `Answered by <@${input.userId}>` }],
-        });
-    }
-    return blocks;
-}
+import{truncateModalTitle,truncatePlainText,truncateSectionText}from"#public/channels/slack/limits.js";var HITL_ACTION_PREFIX=`ash_input:`,HITL_FREEFORM_ACTION_PREFIX=`ash_input_freeform:`,HITL_FREEFORM_MODAL_CALLBACK_ID=`ash_input_freeform_submit`,HITL_FREEFORM_MODAL_BLOCK_ID=`ash_freeform_block`,HITL_FREEFORM_MODAL_ACTION_ID=`ash_freeform_text`,RADIO_SELECT_OPTION_LIMIT=6,BUTTON_ACTION_ID_RE=/^(?<requestId>.+):button:\d+$/u;function deriveHitlResponse(e){if(!e.actionId.startsWith(`ash_input:`))return null;let t=e.actionId.slice(HITL_ACTION_PREFIX.length);if(e.selectedOptionValue!==void 0)return t?{optionId:e.selectedOptionValue,requestId:t}:null;if(e.value!==void 0){let n=BUTTON_ACTION_ID_RE.exec(t)?.groups?.requestId;return n?{optionId:e.value,requestId:n}:null}return null}function isHitlAction(e){return e.startsWith(HITL_ACTION_PREFIX)}function renderInputRequestBlocks(e){let t={text:{text:truncateSectionText(e.prompt),type:`mrkdwn`},type:`section`},a=`${HITL_ACTION_PREFIX}${e.requestId}`,o=e.options,s=e.allowFreeform===!0||!o||o.length===0;return o&&o.length>0&&e.display===`select`?[t,{type:`actions`,elements:[o.length<=RADIO_SELECT_OPTION_LIMIT?{type:`radio_buttons`,action_id:a,options:o.map(buildOption)}:{type:`static_select`,action_id:a,options:o.map(buildOption),placeholder:{type:`plain_text`,text:`Choose an option`}}]}]:o&&o.length>0?[t,{type:`actions`,elements:o.map((e,t)=>buildButton(e,a,t))}]:s?[t,{type:`actions`,elements:[{type:`button`,action_id:`${HITL_FREEFORM_ACTION_PREFIX}${e.requestId}`,text:{type:`plain_text`,text:`Type your answer`},style:`primary`,value:e.requestId}]}]:[t]}function buildFreeformModalView(t){let r=t.prompt?truncateModalTitle(t.prompt):`Your answer`,i=t.prompt?[{type:`section`,text:{type:`mrkdwn`,text:truncateSectionText(t.prompt)}}]:[];return{type:`modal`,callback_id:HITL_FREEFORM_MODAL_CALLBACK_ID,private_metadata:JSON.stringify(t.metadata),title:{type:`plain_text`,text:r},submit:{type:`plain_text`,text:`Submit`},close:{type:`plain_text`,text:`Cancel`},blocks:[...i,{type:`input`,block_id:HITL_FREEFORM_MODAL_BLOCK_ID,element:{type:`plain_text_input`,action_id:HITL_FREEFORM_MODAL_ACTION_ID,multiline:!0,placeholder:{type:`plain_text`,text:`Type your answer here...`}},label:{type:`plain_text`,text:`Answer`}}]}}function isFreeformAction(e){return e.startsWith(HITL_FREEFORM_ACTION_PREFIX)}function freeformRequestIdFromActionId(e){if(!isFreeformAction(e))return;let t=e.slice(HITL_FREEFORM_ACTION_PREFIX.length);return t.length>0?t:void 0}function buildButton(e,n,r){let i={action_id:`${n}:button:${r}`,text:{text:truncatePlainText(e.label),type:`plain_text`},type:`button`,value:e.id};return(e.style===`primary`||e.style===`danger`)&&(i.style=e.style),i}function buildOption(e){let n={text:{text:truncatePlainText(e.label),type:`plain_text`},value:e.id},r=truncatePlainText(e.description);return r&&r.length>0&&(n.description={text:r,type:`plain_text`}),n}function buildAnsweredBlocks(e){let t=[];return e.promptBlock!==void 0&&e.promptBlock!==null&&t.push(e.promptBlock),t.push({type:`section`,text:{type:`mrkdwn`,text:`:white_check_mark: *${e.answerLabel}*`}}),e.userId&&e.userId.length>0&&t.push({type:`context`,elements:[{type:`mrkdwn`,text:`Answered by <@${e.userId}>`}]}),t}export{HITL_ACTION_PREFIX,HITL_FREEFORM_ACTION_PREFIX,HITL_FREEFORM_MODAL_ACTION_ID,HITL_FREEFORM_MODAL_BLOCK_ID,HITL_FREEFORM_MODAL_CALLBACK_ID,buildAnsweredBlocks,buildFreeformModalView,deriveHitlResponse,freeformRequestIdFromActionId,isFreeformAction,isHitlAction,renderInputRequestBlocks};

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

@@ -1,149 +1,2 @@
-/**
- * Inbound Slack event → harness shaping.
- *
- * The channel calls these helpers on every inbound `app_mention` event
- * before handing it to the runtime:
- *
- * 1. {@link parseAppMentionEvent} parses Slack's webhook envelope into
- *    a channel-owned {@link SlackMessage}, with the body's text already
- *    re-rendered as GFM markdown so the agent does not see raw
- *    `<@U…>` / `<https://…|…>` fragments.
- * 2. {@link prependSlackContext} attaches a `<slack_context>` block
- *    naming the actor, channel, and thread so the agent's prompt always
- *    knows who and where it is talking.
- */
-import { slackMrkdwnToGfm } from "#public/channels/slack/mrkdwn.js";
-/**
- * Parses a Slack `app_mention` event into a {@link SlackMessage}.
- *
- * Returns `null` when the envelope is not an `app_mention` event or
- * when required fields (channel id, ts) are missing.
- */
-export function parseAppMentionEvent(envelope) {
-    if (envelope.type !== "event_callback")
-        return null;
-    const event = envelope.event;
-    if (!event || event.type !== "app_mention")
-        return null;
-    return buildSlackMessage(event, envelope.team_id);
-}
-/**
- * Parses a Slack `message` event with `channel_type: "im"` into a
- * {@link SlackMessage}.
- *
- * Returns `null` when:
- * - the envelope is not an IM `message` event,
- * - required fields (channel id, ts) are missing,
- * - the message carries a `subtype` (edits, deletes, joins, etc.), or
- * - the message was posted by a bot (`bot_id` set) — this prevents the
- *   bot's own DM replies from re-triggering the handler.
- */
-export function parseDirectMessageEvent(envelope) {
-    if (envelope.type !== "event_callback")
-        return null;
-    const event = envelope.event;
-    if (!event || event.type !== "message")
-        return null;
-    const message = event;
-    if (message.channel_type !== "im")
-        return null;
-    if (typeof message.subtype === "string" && message.subtype.length > 0)
-        return null;
-    if (typeof message.bot_id === "string" && message.bot_id.length > 0)
-        return null;
-    return buildSlackMessage(message, envelope.team_id);
-}
-function buildSlackMessage(event, envelopeTeamId) {
-    const channelId = typeof event.channel === "string" ? event.channel : "";
-    const ts = typeof event.ts === "string" ? event.ts : "";
-    if (!channelId || !ts)
-        return null;
-    const text = typeof event.text === "string" ? event.text : "";
-    const threadTs = typeof event.thread_ts === "string" ? event.thread_ts : ts;
-    const teamId = typeof envelopeTeamId === "string" ? envelopeTeamId : undefined;
-    return {
-        text,
-        markdown: slackMrkdwnToGfm(text),
-        ts,
-        threadTs,
-        channelId,
-        teamId,
-        author: parseAuthor(event),
-        attachments: parseAttachments(event.files),
-        raw: event,
-    };
-}
-function parseAuthor(event) {
-    const userId = typeof event.user === "string" ? event.user : "";
-    if (!userId)
-        return undefined;
-    return {
-        userId,
-        userName: typeof event.username === "string" ? event.username : undefined,
-        fullName: undefined,
-        isBot: typeof event.bot_id === "string" && event.bot_id.length > 0,
-        isMe: false,
-    };
-}
-function parseAttachments(files) {
-    if (!Array.isArray(files))
-        return [];
-    return files.map(toAttachment);
-}
-function toAttachment(file) {
-    const mimeType = typeof file.mimetype === "string" ? file.mimetype : undefined;
-    const url = typeof file.url_private === "string" ? file.url_private : undefined;
-    return {
-        id: typeof file.id === "string" ? file.id : "",
-        type: inferAttachmentType(mimeType),
-        url,
-        name: typeof file.name === "string" ? file.name : undefined,
-        mimeType,
-        size: typeof file.size === "number" ? file.size : undefined,
-    };
-}
-function inferAttachmentType(mimeType) {
-    if (mimeType === undefined)
-        return "file";
-    if (mimeType.startsWith("image/"))
-        return "image";
-    if (mimeType.startsWith("video/"))
-        return "video";
-    if (mimeType.startsWith("audio/"))
-        return "audio";
-    return "file";
-}
-/**
- * Renders one {@link SlackInboundContext} as a `<slack_context>` block.
- * Lines are deterministic and tag-delimited so the agent can pattern-match
- * the block out of its prompt if it wants to.
- */
-export function formatSlackContextBlock(context) {
-    const lines = [
-        "<slack_context>",
-        `user_id: ${context.userId}`,
-        ...(context.userName ? [`user_name: ${context.userName}`] : []),
-        ...(context.fullName ? [`full_name: ${context.fullName}`] : []),
-        `channel_id: ${context.channelId}`,
-        `thread_ts: ${context.threadTs}`,
-        ...(context.teamId ? [`team_id: ${context.teamId}`] : []),
-        "</slack_context>",
-    ];
-    return lines.join("\n");
-}
-/**
- * Prepends a `<slack_context>` block to the inbound turn message.
- *
- * Accepts either a raw string (no attachments) or a {@link UserContent}
- * array (text + file parts). In the array case the context block lands
- * as the first {@link TextPart} — followed by the original parts — so
- * attachments stay intact.
- */
-export function prependSlackContext(message, context) {
-    const block = formatSlackContextBlock(context);
-    if (typeof message === "string") {
-        return message.length > 0 ? `${block}\n\n${message}` : block;
-    }
-    const contextPart = { type: "text", text: block };
-    return [contextPart, ...message];
-}
+import{slackMrkdwnToGfm}from"#public/channels/slack/mrkdwn.js";function parseAppMentionEvent(e){if(e.type!==`event_callback`)return null;let t=e.event;return!t||t.type!==`app_mention`?null:buildSlackMessage(t,e.team_id)}function parseDirectMessageEvent(e){if(e.type!==`event_callback`)return null;let t=e.event;if(!t||t.type!==`message`)return null;let n=t;return n.channel_type!==`im`||typeof n.subtype==`string`&&n.subtype.length>0||typeof n.bot_id==`string`&&n.bot_id.length>0?null:buildSlackMessage(n,e.team_id)}function buildSlackMessage(t,n){let r=typeof t.channel==`string`?t.channel:``,i=typeof t.ts==`string`?t.ts:``;if(!r||!i)return null;let a=typeof t.text==`string`?t.text:``,o=typeof t.thread_ts==`string`?t.thread_ts:i,s=typeof n==`string`?n:void 0;return{text:a,markdown:slackMrkdwnToGfm(a),ts:i,threadTs:o,channelId:r,teamId:s,author:parseAuthor(t),attachments:parseAttachments(t.files),raw:t}}function parseAuthor(e){let t=typeof e.user==`string`?e.user:``;if(t)return{userId:t,userName:typeof e.username==`string`?e.username:void 0,fullName:void 0,isBot:typeof e.bot_id==`string`&&e.bot_id.length>0,isMe:!1}}function parseAttachments(e){return Array.isArray(e)?e.map(toAttachment):[]}function toAttachment(e){let t=typeof e.mimetype==`string`?e.mimetype:void 0,n=typeof e.url_private==`string`?e.url_private:void 0;return{id:typeof e.id==`string`?e.id:``,type:inferAttachmentType(t),url:n,name:typeof e.name==`string`?e.name:void 0,mimeType:t,size:typeof e.size==`number`?e.size:void 0}}function inferAttachmentType(e){return e===void 0?`file`:e.startsWith(`image/`)?`image`:e.startsWith(`video/`)?`video`:e.startsWith(`audio/`)?`audio`:`file`}function formatSlackContextBlock(e){return[`<slack_context>`,`user_id: ${e.userId}`,...e.userName?[`user_name: ${e.userName}`]:[],...e.fullName?[`full_name: ${e.fullName}`]:[],`channel_id: ${e.channelId}`,`thread_ts: ${e.threadTs}`,...e.teamId?[`team_id: ${e.teamId}`]:[],`</slack_context>`].join(`
+`)}function prependSlackContext(e,t){let n=formatSlackContextBlock(t);return typeof e==`string`?e.length>0?`${n}\n\n${e}`:n:[{type:`text`,text:n},...e]}export{formatSlackContextBlock,parseAppMentionEvent,parseDirectMessageEvent,prependSlackContext};

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

@@ -1,13 +1 @@
-export { slackChannel, } from "#public/channels/slack/slackChannel.js";
-export { slackContinuationToken, } from "#public/channels/slack/api.js";
-export { defaultSlackAuth } from "#public/channels/slack/defaults.js";
-export { loadThreadContextMessages, } from "#public/channels/slack/thread.js";
-export { cardToBlocks, cardToFallbackText, } from "#public/channels/slack/blocks.js";
-/**
- * Card builders and element types re-exported from the vendored chat
- * SDK module. These are pure data factories — they return plain typed
- * objects that the channel hands to {@link cardToBlocks} at post time.
- * The chat SDK runtime (`Chat`, `Thread`, `Adapter`, etc.) is not
- * imported and not reachable through this entry point.
- */
-export { Actions, Button, Card, CardLink, CardText, Divider, ExternalSelect, Field, Fields, Image, LinkButton, Modal, RadioSelect, Section, Select, SelectOption, Table, TextInput, cardChildToFallbackText, isCardElement, } from "#compiled/chat/index.js";
+import{Actions,Button,Card,CardLink,CardText,Divider,ExternalSelect,Field,Fields,Image,LinkButton,Modal,RadioSelect,Section,Select,SelectOption,Table,TextInput,cardChildToFallbackText,isCardElement}from"#compiled/chat/index.js";import{cardToBlocks,cardToFallbackText}from"#public/channels/slack/blocks.js";import{slackContinuationToken}from"#public/channels/slack/api.js";import{slackChannel}from"#public/channels/slack/slackChannel.js";import{defaultSlackAuth}from"#public/channels/slack/defaults.js";import{loadThreadContextMessages}from"#public/channels/slack/thread.js";export{Actions,Button,Card,CardLink,CardText,Divider,ExternalSelect,Field,Fields,Image,LinkButton,Modal,RadioSelect,Section,Select,SelectOption,Table,TextInput,cardChildToFallbackText,cardToBlocks,cardToFallbackText,defaultSlackAuth,isCardElement,loadThreadContextMessages,slackChannel,slackContinuationToken};