@adonis-agora/agent 0.72.0 → 0.74.1

package/dist/src/channels/handler.d.ts

@@ -2,6 +2,8 @@ import type { HttpContext } from '@adonisjs/core/http';
 import { AgentService } from '../agent-service.js';
 import type { AttachmentLimits } from '../attachment-limits.js';
 import type { UiCapabilities } from '../genui/capabilities.js';
+import type { Catalog } from '../genui/catalog.js';
+import { type GenuiChannelBase, type GenuiChannels } from '../genui/channels.js';
 import type { ActionProposal } from '../spi/action-proposal-store.js';
 import type { AttachmentRef } from '../spi/attachment-staging.js';
 import type { Actor, PageContext } from '../types.js';
@@ -248,9 +250,19 @@ export interface ChannelHandleOptions {
     allowRemember?: boolean;
     /**
      * What the turn may draw. Default `{ components: [] }`: every component arrives as its
-     * `fallbackText`. Allow some with {@link renderComponent} to send them as files.
+     * `fallbackText`. Allow some with {@link renderComponent} to send them as files. With
+     * `genui({ channels })` configured for this channel ({@link ChannelAdapter.kind}, else `default`)
+     * the default is the channel's own: the components it can draw, delivered natively.
      */
     uiCapabilities?: UiCapabilities;
+    /**
+     * The genui setup this channel draws with — default: the app's (`AgentGenui` from the container).
+     * With `channels` configured for this channel, components arrive natively (their `channels`
+     * conversion: text, reply buttons, lists, images; their text summary otherwise), and a pressed
+     * button is the user's next turn, as a UI action. `false` → never (every component as its text).
+     * With a `service` handed in, the container is not read: pass `genui` too.
+     */
+    genui?: ChannelGenui | false;
     /**
      * A component the turn drew: what to send for it — a file (a chart as an image), text, several —
      * or `null`/`undefined` for its `fallbackText`. Rendered components are sent when the turn ends (or
@@ -297,6 +309,12 @@ export interface ChannelHandleOptions {
     /** A message whose handling failed (after its retries). Default: `console.error`. */
     onError?(error: unknown, message: InboundMessage): void;
 }
+/** What a channel draws generative UI with — `AgentGenui` is one. */
+export interface ChannelGenui {
+    catalog: Catalog;
+    channels?: GenuiChannels;
+    base?: GenuiChannelBase;
+}
 /** The route handler `channels.handle()` returns. */
 export interface ChannelRouteHandler {
     (ctx: HttpContext): Promise<void>;
@@ -321,6 +339,16 @@ export declare function proposalButtonIds(proposalId: string): {
 export interface ChannelAddress {
     name: string;
     conversation: string;
+    /** The adapter's {@link ChannelAdapter.kind}, when it has one — what `turnChannel` reads first. */
+    kind?: string;
+    /**
+     * How many reply buttons and list rows the adapter shows (its capabilities): what a tool result's
+     * `delivered` describes choices by, the way the handler will send them.
+     */
+    choices?: {
+        buttons: number;
+        lists: number;
+    };
 }
 /**
  * The webhook route for one channel. Each request is verified (`401` when it is not the provider's),

package/dist/src/channels/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/channels/handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/channels/handler.ts"],"names":[],"mappings":"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"}

package/dist/src/channels/handler.js

@@ -1,6 +1,10 @@
+import { createHash } from 'node:crypto';
 import { DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY, parseTextActionProposalCommand, } from '../action-proposal-text.js';
 import { AgentService, AttachmentRefusedError } from '../agent-service.js';
 import { onAgentEngine, registeredAgentEngine } from '../durable/agent-run-context.js';
+import { uiActionText } from '../genui/actions.js';
+import { channelButtonAction, renderChannelMessages, resolveGenuiChannel, } from '../genui/channels.js';
+import { AgentGenui } from '../genui/factory.js';
 import { durableExecutor, inlineExecutor, jobId, registerChannelWorkflows, withRetries, } from './executor.js';
 import { ChannelMediaTooLargeError } from './http.js';
 import { toChannelMarkdown } from './markdown.js';
@@ -9,6 +13,11 @@ import { splitMessage } from './split.js';
 import { InMemoryChannelStore, lucidChannelStore } from './store.js';
 import { channelTextsFor, mergeTexts, } from './texts.js';
 const BUTTON_ID = /^agora:(approve|reject):([^\s]+)$/;
+/** A component's button (or list entry): `ui:<ref>`, short enough for Telegram's 64-byte callback data. */
+const UI_BUTTON_ID = /^ui:([A-Za-z0-9_-]{6,32})$/;
+/** How long a component's buttons stay pressable, and how many per conversation are remembered by label. */
+const UI_BUTTON_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+const MAX_UI_BUTTONS = 40;
 /** The tail of a proposal id a button carries — Telegram's `callback_data` holds 64 bytes. */
 const BUTTON_REF_LENGTH = 32;
 const OUTCOME_POLL_MS = 500;
@@ -59,6 +68,8 @@ function record(value) {
 }
 /** `image/jpeg` → `jpeg`, for a file that arrives without a name. */
 const extensionOf = (contentType) => (contentType.split('/')[1] ?? 'bin').split(/[;+]/)[0] ?? 'bin';
+/** Where a natively drawn component sits in a turn's text, until it is sent. */
+const NATIVE_MARK = '\u0000agora-native\u0000';
 const replyList = (value) => value === null || value === undefined ? [] : Array.isArray(value) ? value : [value];
 /** The component a frame carries (a live one, or a replayed `ui` event), else `null`. */
 function componentOf(frame, position) {
@@ -144,6 +155,36 @@ export function handleChannel(adapter, options) {
     const { capabilities } = adapter;
     const buttons = (capabilities.buttons ?? 0) >= 2;
     const name = adapter.name;
+    /** What the channel is (`whatsapp`, `telegram`) — the turn's channel, whatever it is named. */
+    const kind = adapter.kind ?? adapter.name;
+    let resolvedGenui;
+    /** The genui setup, and this channel's options in it — `null` when it draws nothing natively. */
+    const genuiFor = () => {
+        resolvedGenui ??= (async () => {
+            if (options.genui === false)
+                return null;
+            if (options.genui !== undefined)
+                return options.genui;
+            // A service handed in (a test, another framework): no container to read the app's genui from.
+            if (options.service !== undefined)
+                return null;
+            try {
+                const { default: app } = await import('@adonisjs/core/services/app');
+                if (!app.container.hasBinding(AgentGenui))
+                    return null;
+                return (await app.container.make(AgentGenui));
+            }
+            catch {
+                return null;
+            }
+        })();
+        return resolvedGenui.then((genui) => {
+            if (genui === null || genui.channels === undefined)
+                return null;
+            const channel = resolveGenuiChannel(genui.base ?? {}, genui.channels, kind);
+            return channel.configured ? { genui, channel } : null;
+        });
+    };
     let resolvedService;
     const serviceFor = (given) => {
         if (options.service)
@@ -273,6 +314,125 @@ export function handleChannel(adapter, options) {
         const saved = await store.get(cardsKey(conversation));
         return new Set(saved === null ? [] : JSON.parse(saved));
     };
+    const uiButtonKey = (ref) => `${name}:ui:${ref}`;
+    const uiButtonsKey = (conversation) => `${name}:uibuttons:${conversation}`;
+    /**
+     * Remember a component's buttons — by id for the press, and by label for a provider that forwards
+     * only the label (Whatsmiau). Each id is derived from the run, the component and its place, so a
+     * phase that runs again names the same buttons.
+     */
+    const rememberUiButtons = async (store, conversation, seed, message, entries) => {
+        const ids = [];
+        const index = await store.get(uiButtonsKey(conversation));
+        const known = index === null ? [] : JSON.parse(index);
+        for (const [position, button] of entries.entries()) {
+            const ref = createHash('sha256')
+                .update(`${seed}:${position}`)
+                .digest('base64url')
+                .slice(0, 16);
+            const saved = {
+                conversation,
+                button,
+                ...(message.componentId !== undefined ? { componentId: message.componentId } : {}),
+                ...(message.title !== undefined ? { title: message.title } : {}),
+            };
+            await store.set(uiButtonKey(ref), JSON.stringify(saved), UI_BUTTON_TTL_MS);
+            ids.push(`ui:${ref}`);
+            known.push(ref);
+        }
+        await store.set(uiButtonsKey(conversation), JSON.stringify([...new Set(known)].slice(-MAX_UI_BUTTONS)), UI_BUTTON_TTL_MS);
+        return ids;
+    };
+    /** The component button a press (or, for a provider without ids, its label) names, if any. */
+    const pressedUiButton = async (store, message) => {
+        const match = message.buttonId === undefined ? null : UI_BUTTON_ID.exec(message.buttonId);
+        if (match !== null) {
+            const saved = await store.get(uiButtonKey(match[1] ?? ''));
+            const button = saved === null ? null : JSON.parse(saved);
+            return button !== null && button.conversation === message.conversation ? button : null;
+        }
+        if (message.buttonId !== undefined || message.buttonWithoutId !== true)
+            return null;
+        const index = await store.get(uiButtonsKey(message.conversation));
+        const label = foldLabel(message.text);
+        for (const ref of (index === null ? [] : JSON.parse(index)).reverse()) {
+            const saved = await store.get(uiButtonKey(ref));
+            const button = saved === null ? null : JSON.parse(saved);
+            if (button !== null && foldLabel(button.button.label) === label)
+                return button;
+        }
+        return null;
+    };
+    /**
+     * One natively drawn message out: an image with its caption, text with reply buttons, a list (as
+     * reply buttons when it fits and the channel has no lists, as numbered text when neither does), or
+     * text — in the channel's markdown and limits.
+     */
+    const sendNative = async (store, out, conversation, seed, message) => {
+        const markdown = (text) => toChannelMarkdown(text, capabilities.markdown);
+        const text = message.text ?? '';
+        if (message.image !== undefined) {
+            const { image } = message;
+            await out.reply({
+                media: {
+                    kind: 'image',
+                    ...(image.url !== undefined ? { url: image.url } : {}),
+                    ...(image.data !== undefined ? { data: Buffer.from(image.data) } : {}),
+                    contentType: image.contentType ?? 'image/png',
+                },
+                caption: text,
+                fallbackText: text,
+            }, 'reply');
+        }
+        const choices = message.list?.items ?? message.buttons ?? [];
+        if (choices.length === 0) {
+            if (message.image === undefined && text.trim() !== '')
+                await out.text(text, 'reply');
+            return;
+        }
+        const body = message.image === undefined ? text : '';
+        const numbered = [
+            body,
+            ...(message.list?.title !== undefined ? [`*${message.list.title}*`] : []),
+            choices
+                .map((choice, index) => `${index + 1}. ${choice.label}${choice.description ? ` — ${choice.description}` : ''}`)
+                .join('\n'),
+        ]
+            .filter((part) => part.trim() !== '')
+            .join('\n\n');
+        const maxButtons = capabilities.buttons ?? 0;
+        const asButtons = message.list === undefined || (capabilities.lists ?? 0) === 0;
+        if (asButtons && choices.length <= maxButtons) {
+            const ids = await rememberUiButtons(store, conversation, seed, message, choices);
+            await out.send({
+                text: markdown(body.trim() === '' ? (message.title ?? '…') : body).slice(0, capabilities.maxLength),
+                buttons: choices.map((choice, index) => ({ id: ids[index] ?? '', label: choice.label })),
+                fallbackText: markdown(numbered).slice(0, capabilities.maxLength),
+            }, 'reply');
+            return;
+        }
+        const maxRows = capabilities.lists ?? 0;
+        if (maxRows > 0) {
+            const rows = choices.slice(0, maxRows);
+            const ids = await rememberUiButtons(store, conversation, seed, message, rows);
+            await out.send({
+                text: markdown(body.trim() === '' ? (message.title ?? '…') : body).slice(0, capabilities.maxLength),
+                list: {
+                    button: message.list?.button ?? 'Options',
+                    ...(message.list?.title !== undefined ? { title: message.list.title } : {}),
+                    rows: rows.map((row, index) => ({
+                        id: ids[index] ?? '',
+                        title: row.label,
+                        ...(row.description !== undefined ? { description: row.description } : {}),
+                    })),
+                },
+                fallbackText: markdown(numbered).slice(0, capabilities.maxLength),
+            }, 'reply');
+            return;
+        }
+        // Neither buttons nor lists: the choices as numbered text.
+        await out.text(numbered, 'reply');
+    };
     const sendProposal = async (service, store, texts, out, conversation, proposal, withId) => {
         const summary = texts.proposal(proposal);
         const footer = typeof texts.footer === 'function' ? texts.footer(proposal) : texts.footer;
@@ -606,6 +766,9 @@ export function handleChannel(adapter, options) {
         const proposals = new Map();
         /** Components rendered as files, by id (a later one replaces), sent before the text. */
         const rendered = new Map();
+        /** Components drawn natively (genui channels), by id, sent where they came in the text. */
+        const natives = new Map();
+        const native = await genuiFor();
         const asText = new Set();
         let wroteText = false;
         let failed = false;
@@ -620,10 +783,20 @@ export function handleChannel(adapter, options) {
             for (const { replies } of batch)
                 for (const reply of replies)
                     await out.reply(reply, 'reply');
-            const text = parts.join('').trim();
+            // Text and natively drawn components, in the order the turn produced them.
+            const segments = parts.join('').split(NATIVE_MARK);
             parts.length = 0;
-            if (text !== '')
-                await out.text(text, 'reply');
+            for (const [index, segment] of segments.entries()) {
+                if (index % 2 === 0) {
+                    if (segment.trim() !== '')
+                        await out.text(segment.trim(), 'reply');
+                    continue;
+                }
+                const messages = natives.get(segment) ?? [];
+                for (const [position, message] of messages.entries())
+                    await sendNative(store, out, conversation, `${runId}:${segment}:${position}`, message);
+            }
+            natives.clear();
             if (end && !wroteText && batch.length > 0) {
                 const after = texts.componentsOnly?.(batch.map(({ component }) => component));
                 if (after !== undefined && after !== '')
@@ -650,7 +823,33 @@ export function handleChannel(adapter, options) {
                     break;
                 const frame = next.value;
                 const component = componentOf(frame, position++);
-                if (component !== null) {
+                if (component !== null && native !== null) {
+                    // A genui channel: the component as this channel draws it, where it came in the text.
+                    const replies = options.renderComponent
+                        ? replyList(await options.renderComponent(component, {
+                            actor,
+                            conversation,
+                            runId,
+                            rendered: rendered.size,
+                        }))
+                        : [];
+                    if (replies.length > 0) {
+                        rendered.set(component.id, { component, replies });
+                        continue;
+                    }
+                    const drawn = await renderChannelMessages(native.genui.catalog, {
+                        id: component.id,
+                        name: component.name,
+                        props: (component.data ?? {}),
+                    }, native.channel);
+                    if (drawn.length === 0)
+                        continue;
+                    wroteText = true;
+                    if (!natives.has(component.id))
+                        parts.push(`${NATIVE_MARK}${component.id}${NATIVE_MARK}`);
+                    natives.set(component.id, drawn);
+                }
+                else if (component !== null) {
                     const replies = options.renderComponent
                         ? replyList(await options.renderComponent(component, {
                             actor,
@@ -753,6 +952,7 @@ export function handleChannel(adapter, options) {
                     failed = true;
                     // A failed turn shows none of what it drew before failing.
                     rendered.clear();
+                    natives.clear();
                 }
             }
         }
@@ -848,10 +1048,22 @@ export function handleChannel(adapter, options) {
         }
         if (await pressButton(service, out, actor, threadId, message))
             return done(null);
-        const media = await attachMedia(service, texts, out, actor, message);
+        // A component's button (or list entry): the user's next turn, as a UI action — the same thing a
+        // sandbox's `agent.send` and an A2UI button become.
+        const uiButton = await pressedUiButton(store, message);
+        const media = uiButton === null ? await attachMedia(service, texts, out, actor, message) : null;
         let inbound = {
-            text: [message.text, ...media.extra].filter((part) => part.trim() !== '').join('\n\n'),
-            attachments: media.refs,
+            text: uiButton !== null
+                ? uiActionText(channelButtonAction(uiButton.button, {
+                    ...(uiButton.componentId !== undefined
+                        ? { componentId: uiButton.componentId }
+                        : {}),
+                    ...(uiButton.title !== undefined ? { title: uiButton.title } : {}),
+                }))
+                : [message.text, ...(media?.extra ?? [])]
+                    .filter((part) => part.trim() !== '')
+                    .join('\n\n'),
+            attachments: media?.refs ?? [],
         };
         if (options.transformInbound)
             inbound = await options.transformInbound(inbound, {
@@ -873,7 +1085,15 @@ export function handleChannel(adapter, options) {
         const pageContext = typeof options.pageContext === 'function'
             ? options.pageContext(message)
             : (options.pageContext ?? { kind: name });
-        const channel = { name, conversation: message.conversation };
+        const channel = {
+            name,
+            conversation: message.conversation,
+            ...(adapter.kind !== undefined ? { kind: adapter.kind } : {}),
+            choices: { buttons: capabilities.buttons ?? 0, lists: capabilities.lists ?? 0 },
+        };
+        // A channel genui draws for: the turn may push whatever this channel can draw (the tools are
+        // narrowed to it), and the components arrive whole, for the history and for native delivery.
+        const drawsNatively = options.uiCapabilities === undefined && (await genuiFor()) !== null;
         const sendOptions = { textDecisions: false };
         let sent;
         try {
@@ -883,7 +1103,9 @@ export function handleChannel(adapter, options) {
                 ...(threadId !== null ? { threadId } : {}),
                 ...(options.agentName !== undefined ? { agentName: options.agentName } : {}),
                 ...(inbound.attachments.length > 0 ? { attachments: inbound.attachments } : {}),
-                uiCapabilities: options.uiCapabilities ?? { components: [] },
+                ...(drawsNatively
+                    ? {}
+                    : { uiCapabilities: options.uiCapabilities ?? { components: [] } }),
                 pageContext: { ...pageContext, channel },
                 hostContext: {
                     channel: name,