@adecore/agents-react 0.38.0 → 0.39.0

package/src/host-hooks.ts

@@ -7,7 +7,7 @@
  */
 import type { ProviderPlatform } from '@adecore/agent-contracts';
 import { referablesOfChats, type Referables } from './chat/chat-references';
-import { useChatHost, type ChatHost, type CommandLook } from './host';
+import { useChatHost, type ChatHost, type CommandLook, type ComposerSendAction } from './host';
 
 export function useHostCodeMode(): 'light' | 'dark' {
     return useChatHost().code.useMode();
@@ -101,6 +101,14 @@ export function useHostComposerPlaceholder(...args: Parameters<ChatHost['useComp
     return useChatHost().useComposerPlaceholder(...args);
 }
 
+const NO_SEND_ACTIONS: readonly ComposerSendAction[] = [];
+const noSendActions = (): readonly ComposerSendAction[] => NO_SEND_ACTIONS;
+
+export function useHostComposerSendActions(scopeId: string, chatId: string): readonly ComposerSendAction[] {
+    const useSendActions = useChatHost().useComposerSendActions ?? noSendActions;
+    return useSendActions(scopeId, chatId);
+}
+
 export function useHostThreadCards(...args: Parameters<ChatHost['useThreadCards']>): ReturnType<ChatHost['useThreadCards']> {
     return useChatHost().useThreadCards(...args);
 }

package/src/host.ts

@@ -18,7 +18,9 @@ import type {
     ChatUiLinkPayload,
     ChatUiLinkReading,
     ChatVisual,
-    ProviderPlatform
+    ModelSelection,
+    ProviderPlatform,
+    RuntimeMode
 } from '@adecore/agent-contracts';
 import { isApplePlatform } from '@adecore/ui';
 import type { Referables } from './chat/chat-references';
@@ -168,6 +170,28 @@ export interface ComposerSlotProps {
     insert(text: string): void;
 }
 
+/* What a send action of the app's gets: the message as it stands when a person picks the action. */
+export interface ComposerSendDraft {
+    scopeId: string;
+    chatId: string;
+    /* The draft as Send would send it, trimmed and with its quote; empty when nothing is written. */
+    text: string;
+    provider: AgentKind;
+    selection: ModelSelection;
+    runtimeMode: RuntimeMode;
+}
+
+/* An action of the app's own in the menu beside the composer's send button, such as sending the draft later. */
+export interface ComposerSendAction {
+    /* Unique among the actions of one composer. */
+    id: string;
+    label: string;
+    icon?: LucideIcon;
+    disabled?: boolean;
+    /* Runs once a person picks it; the draft stays in the box, and the host shows a failure itself. */
+    run(draft: ComposerSendDraft): void;
+}
+
 /* What an app's own chips for a chat's sub-agents get, in place of the one flyout over the composer. */
 export interface SubagentSlotProps {
     chatId: string;
@@ -453,6 +477,8 @@ export interface ChatHost {
     useComposerPlaceholder(scopeId: string, chatId: string): string | null;
     /* The app's own control in the composer's row, after the pickers; null draws none. */
     ComposerSlot: ComponentType<ComposerSlotProps> | null;
+    /* Actions of the app's own behind a chevron on the send button, in the order given; left out, or none, Send stands alone. */
+    useComposerSendActions?(scopeId: string, chatId: string): readonly ComposerSendAction[];
     /* The app's own chips for a chat's sub-agents over the composer; null draws the one flyout. */
     SubagentSlot: ComponentType<SubagentSlotProps> | null;
     /* Cards of the app's own in a thread, in any order. Hand back the same array while none changed, or the thread lays out its rows again on every render. */

package/src/index.ts

@@ -9,6 +9,8 @@ export {
     type TimelineFind,
     type ComposerDictationProps,
     type ComposerSlotProps,
+    type ComposerSendAction,
+    type ComposerSendDraft,
     type SubagentSlotProps,
     type ThreadCard,
     type VisualHost,

package/src/locales/en/agent-chat.ts

@@ -391,6 +391,7 @@ export default {
         continue: 'Continue',
         continueHint: 'Continue the stopped turn',
         send: 'Send',
+        sendActions: 'More send options',
         clear: {
             title: 'Clear thread?',
             description: 'A turn is running.',

package/src/locales/nl/agent-chat.ts

@@ -391,6 +391,7 @@ export default {
         continue: 'Doorgaan',
         continueHint: 'Ga verder met de gestopte beurt',
         send: 'Versturen',
+        sendActions: 'Meer verzendopties',
         clear: {
             title: 'Thread wissen?',
             description: 'Er loopt een turn.',

package/src/providers/index.ts

@@ -1,6 +1,7 @@
 // Public API: exports.test.ts snapshots this list, so a name added or dropped here is an API change.
 export { AccountDot } from '../agents/AccountDot';
 export { AgentIcon } from '../agents/AgentIcon';
+export { AgentModelLabel } from '../agents/AgentModelLabel';
 export { ModelOptionControl } from '../agents/ModelOptionControl';
 export { ProviderLogo } from '../agents/ProviderLogo';
 export { type AccountEntry, accountsOfKind, ACCOUNT_TONE_CLASSES, accountStatusLine, canContinueOn, type AccountTone } from '../agents/accounts';

package/src/theme.css

@@ -288,6 +288,9 @@
 .composer-input .cm-editor .cm-scroller .cm-content { padding: 18px 14px 6px 20px; caret-color: var(--text); }
 .composer-input .cm-scroller .cm-content .cm-line { padding: 0; }
 .composer-input .cm-scroller .cm-content .cm-placeholder { color: var(--text-faint); }
+/* The same editor as a form field (`PromptEditor`): the field's inset, and room for a few lines before it scrolls. */
+.composer-input.prompt-editor .cm-editor { max-height: 240px; }
+.composer-input.prompt-editor .cm-editor .cm-scroller .cm-content { min-height: 80px; padding: 6px 10px; }
 .composer-hints, .composer-hints-extra { display: inline-flex; align-items: center; gap: 8px; white-space: nowrap; }
 /* The joiner starts with its own comma, so it sits against the lead without the gap. */
 .composer-hints-extra { margin-left: -8px; }