@adminforth/agent 1.51.1 → 1.52.0

package/dist/custom/composables/agentStore/useAgentChat.ts

@@ -14,15 +14,159 @@ type CreateAgentChatManagerOptions = {
   lastMessage: Ref<string>;
   activeModeName: Ref<string | null>;
   onOpenPage: (targetPath: string) => void;
+  onToolApprovalRequest: (sessionId: string, interrupt: unknown) => void;
 };
 
 export function createAgentChatManager({
   lastMessage,
   activeModeName,
   onOpenPage,
+  onToolApprovalRequest,
 }: CreateAgentChatManagerOptions) {
   const chats = new Map<string, Chat<any>>();
   const currentChat = shallowRef<Chat<any> | null>();
+  const agentApiBase = `${(import.meta as AgentImportMeta).env.VITE_ADMINFORTH_PUBLIC_PATH || ''}/adminapi/v1/agent`;
+
+  function replaceLastMessage(message: any) {
+    const chat = currentChat.value;
+
+    if (!chat) {
+      return;
+    }
+
+    chat.messages.splice(chat.messages.length - 1, 1, message);
+  }
+
+  function getOrCreateAssistantMessage() {
+    const chat = currentChat.value;
+    const lastChatMessage = chat?.lastMessage;
+
+    if (lastChatMessage?.role === 'assistant') {
+      return lastChatMessage;
+    }
+
+    const assistantMessage = {
+      role: 'assistant',
+      parts: [],
+    };
+
+    chat?.messages.push(assistantMessage);
+    return assistantMessage;
+  }
+
+  function appendTextDelta(delta: string) {
+    const assistantMessage = getOrCreateAssistantMessage();
+    const lastPart = assistantMessage.parts.at(-1);
+
+    if (lastPart?.type === 'text') {
+      lastPart.text = `${lastPart.text ?? ''}${delta}`;
+      lastPart.state = 'streaming';
+    } else {
+      assistantMessage.parts.push({
+        type: 'text',
+        text: delta,
+        state: 'streaming',
+      });
+    }
+
+    replaceLastMessage(assistantMessage);
+  }
+
+  function finishTextPart() {
+    const assistantMessage = currentChat.value?.lastMessage;
+    const lastPart = assistantMessage?.parts.at(-1);
+
+    if (assistantMessage?.role === 'assistant' && lastPart?.type === 'text') {
+      lastPart.state = 'done';
+      replaceLastMessage(assistantMessage);
+    }
+  }
+
+  function appendDataPart(type: string, data: unknown) {
+    const assistantMessage = getOrCreateAssistantMessage();
+
+    assistantMessage.parts.push({ type, data });
+    replaceLastMessage(assistantMessage);
+  }
+
+  function handleRealtimeChatData(dataPart: any) {
+    if (dataPart?.type === 'data-open-page' && typeof dataPart.data?.targetPath === 'string') {
+      onOpenPage(dataPart.data.targetPath);
+      return;
+    }
+
+    if (dataPart?.type === 'data-interrupt' && typeof dataPart.data?.sessionId === 'string') {
+      onToolApprovalRequest(dataPart.data.sessionId, dataPart.data.interrupt);
+    }
+  }
+
+  function handleManualApprovalStreamPart(dataPart: any) {
+    if (dataPart?.type === 'text-delta' && typeof dataPart.delta === 'string') {
+      appendTextDelta(dataPart.delta);
+      return;
+    }
+
+    if (dataPart?.type === 'text-end') {
+      finishTextPart();
+      return;
+    }
+
+    if (dataPart?.type === 'data-tool-call') {
+      appendDataPart('data-tool-call', dataPart.data);
+      return;
+    }
+
+    if (dataPart?.type === 'data-rendering') {
+      appendDataPart('data-rendering', dataPart.data);
+      return;
+    }
+
+    if (dataPart?.type === 'data-open-page' && typeof dataPart.data?.targetPath === 'string') {
+      onOpenPage(dataPart.data.targetPath);
+      return;
+    }
+
+    if (dataPart?.type === 'data-interrupt' && typeof dataPart.data?.sessionId === 'string') {
+      onToolApprovalRequest(dataPart.data.sessionId, dataPart.data.interrupt);
+    }
+  }
+
+  async function consumeAgentStream(response: Response) {
+    const reader = response.body?.getReader();
+
+    if (!reader) {
+      return;
+    }
+
+    const decoder = new TextDecoder();
+    let buffer = '';
+
+    while (true) {
+      const { value, done } = await reader.read();
+
+      if (done) {
+        break;
+      }
+
+      buffer += decoder.decode(value, { stream: true });
+      const events = buffer.split('\n\n');
+      buffer = events.pop() ?? '';
+
+      for (const event of events) {
+        const data = event
+          .split('\n')
+          .filter(line => line.startsWith('data:'))
+          .map(line => line.slice(5).trim())
+          .join('\n');
+
+        if (!data || data === '[DONE]') {
+          continue;
+        }
+
+        handleManualApprovalStreamPart(JSON.parse(data));
+      }
+    }
+  }
 
   function setCurrentChat(sessionId: string) {
     if (chats.has(sessionId)) {
@@ -30,7 +174,7 @@ export function createAgentChatManager({
     } else {
       const newChat = new Chat({
         transport: new DefaultChatTransport({
-          api: `${(import.meta as AgentImportMeta).env.VITE_ADMINFORTH_PUBLIC_PATH || ''}/adminapi/v1/agent/response`,
+          api: `${agentApiBase}/response`,
           credentials: 'include',
           prepareSendMessagesRequest({ messages }: any) {
             const message = lastMessage.value;
@@ -54,11 +198,7 @@ export function createAgentChatManager({
         onError(error: unknown) {
           console.error('Chat error:', error);
         },
-        onData(dataPart: any) {
-          if (dataPart?.type === 'data-open-page' && typeof dataPart.data?.targetPath === 'string') {
-            onOpenPage(dataPart.data.targetPath);
-          }
-        },
+        onData: handleRealtimeChatData,
       });
       chats.set(sessionId, newChat);
       currentChat.value = newChat;
@@ -69,9 +209,32 @@ export function createAgentChatManager({
     currentChat.value?.stop();
   }
 
+  async function submitToolApproval(sessionId: string, decision: 'approve' | 'reject') {
+    const response = await fetch(`${agentApiBase}/approval`, {
+      method: 'POST',
+      credentials: 'include',
+      headers: {
+        Accept: 'text/event-stream',
+        'Content-Type': 'application/json',
+        'x-vercel-ai-ui-message-stream': 'v1',
+      },
+      body: JSON.stringify({
+        sessionId,
+        decision,
+      }),
+    });
+
+    if (!response.ok) {
+      throw new Error(`Agent approval failed with status ${response.status}`);
+    }
+
+    await consumeAgentStream(response);
+  }
+
   return {
     currentChat,
     setCurrentChat,
     abortCurrentChatRequest,
+    submitToolApproval,
   };
 }

package/dist/custom/composables/agentStore/useAgentSessions.ts

@@ -17,6 +17,7 @@ type CreateAgentSessionManagerOptions = {
   currentChat: ShallowRef<Chat<any> | null | undefined>;
   trimmedUserMessage: ComputedRef<string>;
   isResponseInProgress: ComputedRef<boolean>;
+  isMessageInputBlocked: ComputedRef<boolean>;
   userMessageInput: Ref<any>;
   lastMessage: Ref<string>;
   blockCloseOfChat: Ref<boolean>;
@@ -32,6 +33,7 @@ export function createAgentSessionManager({
   currentChat,
   trimmedUserMessage,
   isResponseInProgress,
+  isMessageInputBlocked,
   userMessageInput,
   lastMessage,
   blockCloseOfChat,
@@ -130,7 +132,7 @@ export function createAgentSessionManager({
 
   async function sendMessage() {
     const message = trimmedUserMessage.value;
-    if (!message || isResponseInProgress.value) {
+    if (!message || isMessageInputBlocked.value) {
       return;
     }
     if (!currentSession.value || currentSession.value.sessionId === PRE_SESSION_ID) {

package/dist/custom/composables/useAgentStore.ts

@@ -53,10 +53,12 @@ export const useAgentStore = defineStore('agent', () => {
     currentChat,
     setCurrentChat,
     abortCurrentChatRequest,
+    submitToolApproval: submitToolApprovalResponse,
   } = createAgentChatManager({
     lastMessage,
     activeModeName,
     onOpenPage: openAgentPage,
+    onToolApprovalRequest: addToolApprovalMessage,
   });
   const {
     userMessagePlaceholder,
@@ -95,6 +97,75 @@ export const useAgentStore = defineStore('agent', () => {
     isAudioChatMode.value = isAudioChat;
   }
 
+  function getToolApprovalMessages(interrupt: unknown): string[] {
+    const interrupts = Array.isArray(interrupt) ? interrupt : [interrupt];
+
+    return interrupts.flatMap((item: any) => {
+      const value = item?.value ?? item;
+      const actionRequests = Array.isArray(value?.actionRequests) ? value.actionRequests : [];
+
+      return actionRequests.map((actionRequest: any) => (
+        typeof actionRequest?.description === 'string'
+          ? actionRequest.description
+          : String(actionRequest?.name ?? 'Tool execution pending approval')
+      ));
+    });
+  }
+
+  function addToolApprovalMessage(sessionId: string, interrupt: unknown) {
+    const approvalPart = {
+      type: 'data-tool-approval' as const,
+      data: {
+        sessionId,
+        status: 'pending' as const,
+        messages: getToolApprovalMessages(interrupt),
+      },
+    };
+    const lastChatMessage = currentChat.value?.lastMessage;
+
+    if (lastChatMessage?.role === 'assistant') {
+      lastChatMessage.parts.push(approvalPart);
+      currentChat.value?.messages.splice(currentChat.value.messages.length - 1, 1, lastChatMessage);
+      return;
+    }
+
+    currentChat.value?.messages.push({
+      role: 'assistant',
+      parts: [approvalPart],
+    });
+  }
+
+  async function submitToolApproval(sessionId: string, decision: 'approve' | 'reject') {
+    const message = currentChat.value?.messages
+      .findLast(candidate => candidate.role === 'assistant' && candidate.parts.some(part => {
+        return part.type === 'data-tool-approval'
+          && part.data?.sessionId === sessionId
+          && part.data?.status === 'pending';
+      }));
+    const approvalPart = message?.parts.find(part => {
+      return part.type === 'data-tool-approval'
+        && part.data?.sessionId === sessionId
+        && part.data?.status === 'pending';
+    });
+
+    if (approvalPart?.data) {
+      approvalPart.data.status = 'processing';
+    }
+
+    try {
+      await submitToolApprovalResponse(sessionId, decision);
+
+      if (approvalPart?.data) {
+        approvalPart.data.status = decision === 'approve' ? 'approved' : 'rejected';
+      }
+    } catch (error) {
+      if (approvalPart?.data) {
+        approvalPart.data.status = 'pending';
+      }
+      console.error('Error submitting tool approval', error);
+    }
+  }
+
   watch(isAudioChatMode, (newVal: boolean) => {
     if (newVal) {
       addSystemMessage(RESERVED_SYSTEM_MESSAGE_CONTENT.START_AUDIO_CHAT);
@@ -107,6 +178,18 @@ export const useAgentStore = defineStore('agent', () => {
   const isResponseInProgress = computed( () => {
     return currentChat.value?.status === 'streaming';
   });
+  const hasPendingToolApproval = computed(() => (
+    currentChat.value?.messages.some((message: any) => (
+      message.role === 'assistant'
+      && message.parts.some((part: any) => (
+        part.type === 'data-tool-approval'
+        && (part.data?.status === 'pending' || part.data?.status === 'processing')
+      ))
+    )) ?? false
+  ));
+  const isMessageInputBlocked = computed(() => (
+    isResponseInProgress.value || hasPendingToolApproval.value
+  ));
   const blockCloseOfChat = ref(false);
   const {
     sendMessage,
@@ -129,6 +212,7 @@ export const useAgentStore = defineStore('agent', () => {
     currentChat,
     trimmedUserMessage,
     isResponseInProgress,
+    isMessageInputBlocked,
     userMessageInput,
     lastMessage,
     blockCloseOfChat,
@@ -385,11 +469,14 @@ export const useAgentStore = defineStore('agent', () => {
     isSessionHistoryOpen,
     setSessionHistoryOpen,
     sendMessage,
+    submitToolApproval,
     userMessageInput,
     userMessagePlaceholder,
     chatMessages: computed(() => currentChat.value?.messages || []),
     trimmedUserMessage,
     isResponseInProgress,
+    hasPendingToolApproval,
+    isMessageInputBlocked,
     isTeleportedToBody,
     setIsTeleportedToBody,
     chatWidth,

package/dist/custom/conversation_area/MessageRenderer.vue

@@ -13,8 +13,12 @@
       :role="props.message.role" 
       :state="part.state ?? (props.message.role === 'user' ? 'done' : undefined)"
     />
+    <ToolApprovalRenderer
+      v-else-if="part.type === 'data-tool-approval'"
+      :data="part.data ?? {}"
+    />
     <SystemMessageRenderer 
-      v-else
+      v-else-if="part.type === 'text'"
       :message="part.text" 
     />
   </template>
@@ -30,6 +34,7 @@
   import { getMessageParts } from '../utils';
   import ProcessingTimeline from './ProcessingTimeline.vue';
   import SystemMessageRenderer from './SystemMessageRenderer.vue';
+  import ToolApprovalRenderer from './ToolApprovalRenderer.vue';
   import { RESERVED_SYSTEM_MESSAGE_CONTENT } from '../composables/agentStore/constants';
 
   const props = defineProps<{ 

package/dist/custom/conversation_area/ToolApprovalRenderer.vue

@@ -0,0 +1,98 @@
+<template>
+  <div class="mx-4 my-3 max-w-[min(34rem,calc(100%-2rem))] rounded-lg border border-lightPrimary/30 bg-lightNavbar p-4 text-lightListTableHeadingText shadow-sm dark:border-darkPrimary/40 dark:bg-darkNavbar dark:text-darkListTableHeadingText">
+    <div class="flex items-start gap-3">
+      <div class="mt-0.5 flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-lightPrimary/10 text-lightPrimary dark:bg-darkPrimary/15 dark:text-darkPrimary">
+        <IconExclamationCircleOutline class="h-5 w-5" />
+      </div>
+      <div class="min-w-0 flex-1">
+        <h3 class="text-sm font-semibold leading-5">{{ $t('Approval required') }}</h3>
+        <p class="mt-1 text-sm leading-5 text-lightListTableText dark:text-darkListTableText">
+          {{ $t('Review the agent message before continuing.') }}
+        </p>
+        <button
+          v-if="data.messages?.length"
+          type="button"
+          class="mt-3 inline-flex items-center gap-2 text-sm font-medium text-lightListTableHeadingText transition hover:opacity-80 dark:text-darkListTableHeadingText"
+          @click="isExpanded = !isExpanded"
+        >
+          <IconChevronDownOutline
+            class="h-4 w-4 transition-transform"
+            :class="isExpanded ? 'rotate-180' : ''"
+          />
+          {{ isExpanded ? $t('Hide details') : $t('Show details') }}
+          <span class="rounded-full bg-lightListTableText/10 px-2 py-0.5 text-xs text-lightListTableHeadingText dark:bg-darkListTableText/10 dark:text-darkListTableHeadingText">
+            {{ data.messages.length }}
+          </span>
+        </button>
+        <ul
+          v-if="isExpanded && data.messages?.length"
+          class="mt-3 space-y-1 text-sm leading-5 text-lightListTableHeadingText dark:text-darkListTableHeadingText"
+        >
+          <li
+            v-for="message in data.messages"
+            :key="message"
+            class="flex gap-2"
+          >
+            <span class="mt-2 h-1.5 w-1.5 shrink-0 rounded-full bg-lightListTableHeadingText dark:bg-darkListTableHeadingText" />
+            <span>{{ message }}</span>
+          </li>
+        </ul>
+        <div class="mt-4 flex flex-wrap gap-2">
+          <template v-if="data.status === 'pending'">
+            <button
+              type="button"
+              class="inline-flex h-9 items-center gap-2 rounded-md border border-lightButtonsBorder bg-lightButtonsBackground px-3 text-sm font-medium text-lightButtonsText transition hover:bg-lightButtonsHover dark:border-darkButtonsBorder dark:bg-darkButtonsBackground dark:text-darkButtonsText dark:hover:bg-darkButtonsHover"
+              @click="submit('approve')"
+            >
+              <IconCheckOutline class="h-4 w-4" />
+              {{ $t('Approve') }}
+            </button>
+            <button
+              type="button"
+              class="inline-flex h-9 items-center gap-2 rounded-md border border-lightListTableText/20 bg-transparent px-3 text-sm font-medium text-lightListTableHeadingText transition hover:bg-lightListTableText/10 dark:border-darkListTableText/20 dark:text-darkListTableHeadingText dark:hover:bg-darkListTableText/10"
+              @click="submit('reject')"
+            >
+              <IconCloseOutline class="h-4 w-4" />
+              {{ $t('Reject') }}
+            </button>
+          </template>
+          <span
+            v-else
+            class="inline-flex h-8 items-center gap-2 rounded-md border px-2.5 text-sm font-medium"
+            :class="data.status === 'processing'
+              ? 'border-lightListTableText/20 bg-lightListTableText/10 text-lightListTableHeadingText dark:border-darkListTableText/20 dark:bg-darkListTableText/10 dark:text-darkListTableHeadingText'
+              : data.status === 'approved'
+              ? 'border-lightListTableText/20 bg-lightListTableText/10 text-lightListTableHeadingText dark:border-darkListTableText/20 dark:bg-darkListTableText/10 dark:text-darkListTableHeadingText'
+              : 'border-lightListTableText/20 bg-lightListTableText/10 text-lightListTableHeadingText dark:border-darkListTableText/20 dark:bg-darkListTableText/10 dark:text-darkListTableHeadingText'"
+          >
+            <IconCheckOutline v-if="data.status === 'approved'" class="h-4 w-4" />
+            <IconCloseOutline v-else-if="data.status === 'rejected'" class="h-4 w-4" />
+            {{ data.status === 'processing' ? $t('Processing') : data.status === 'approved' ? $t('Approved') : $t('Rejected') }}
+          </span>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import type { IPartData } from '../types';
+import { useAgentStore } from '../composables/useAgentStore';
+import { ref } from 'vue';
+import { IconCheckOutline, IconChevronDownOutline, IconCloseOutline, IconExclamationCircleOutline } from '@iconify-prerendered/vue-flowbite';
+
+const props = defineProps<{
+  data: IPartData;
+}>();
+
+const agentStore = useAgentStore();
+const isExpanded = ref(false);
+
+function submit(decision: 'approve' | 'reject') {
+  if (!props.data.sessionId || props.data.status !== 'pending') {
+    return;
+  }
+
+  agentStore.submitToolApproval(props.data.sessionId, decision);
+}
+</script>

package/dist/custom/skills/mutate_data/SKILL.md

@@ -16,41 +16,22 @@ Use `start_custom_action` and `start_custom_bulk_action` for resource actions.
 
 - if there is a dedicated action for some routine (result of `get_resource` tool call, field actions), prefer this to manual updating of records, for example, if you want to approve some comment, prefer calling `approve` action instead of updating `approved` field of comment record (because in action there might be some additional logic like sending notification to user, updating some counters and so on)
 
-## Confirmation
+## Mutation context
 
-Before performing any state mutation including action calls edit/delete please fetch record which is going to be edited/deleted and show user record in format field → value (show several most important fields which can help user to understand what exactly record he is going to edit or delete). 
+Before performing any state mutation including action calls edit/delete please fetch record which is going to be edited/deleted and show user record in format field → value (show several most important fields which can help user to understand what exactly record he is going to edit or delete).
 
-Every confirmation must describe one exact fetched row. Never combine `_label`, primary key, link, or field values from different rows or different resources in one confirmation.
+Every mutation description must describe one exact fetched row. Never combine `_label`, primary key, link, or field values from different rows or different resources in one description.
 
 For field values with long texts show only several first words and add "..." at the end.
 Also please add related link to record with will be changed. Build it as `{ADMIN_BASE_PATH}resource/{resourceId}/show/{primary key}`. Use _label from `get_resource_data` as anchor text for link (use markdown link). Links should always be relative paths and must start with `ADMIN_BASE_PATH`. Do not add an extra slash after `ADMIN_BASE_PATH`.
 
-Before sending the confirmation, verify that the `resourceId`, `{primary key}`, `_label`, and all shown fields come from the same exact fetched row.
+Before calling the mutation tool, verify that the `resourceId`, `{primary key}`, `_label`, and all shown fields come from the same exact fetched row.
 
-Never show information about more than 10 records in one message. If a mutation plan affects more than 10 records, show only the 10 most important examples plus the total count if known, and ask the user to confirm the clearly described full batch.
+Never show information about more than 10 records in one message. If a mutation plan affects more than 10 records, show only the 10 most important examples plus the total count if known.
 
-And in the same message ask user for final confirmation.
+When creating new record, show user all data which you gonna create.
 
-When creating new record, show user all data which you gona create and in same message ask for confirmation.
-
-Accept any positive confirmation from user like "yes", "sure", "+", anything non-negative call to action, can be considered as confirmation.
-
-A confirmation is valid only for the clearly described mutation plan from the immediately previous assistant message.
-
-Never reuse an older confirmation for a later mutation.
-
-One confirmation may cover:
-- one single mutation
-- one explicitly described batch
-- one short sequence of related mutations that together implement the same user request
-
-If the confirmed plan contains several related mutation steps, execute that whole confirmed plan without asking again between those steps.
-
-Ask for confirmation again if the plan changes in any way: different record, different fields, different values, different number of records, different action, or any extra mutation that was not listed in the confirmation message.
-
-If you are creating or deleting multiple records in one batch, you may ask once for that exact batch, but list the whole batch explicitly in the confirmation message. Any extra record outside that described batch requires a new confirmation.
-
-After the confirmed plan is finished, do not treat that confirmation as still active for later requests.
+Do not ask user for textual confirmation. Dangerous tools are approved by the runtime approval UI.
 
 # Calling actions
 
@@ -60,7 +41,7 @@ Before calling any of this action you should understand whether this action is a
 
 ### Example
 
-If you want to block some user you can confirm that this action by saying:
+If you want to block some user you can describe the action by saying:
 
 ```I am going to block user:
 * Username: john_doe
@@ -69,7 +50,6 @@ If you want to block some user you can confirm that this action by saying:
 * Currently blocked: No // show this field only if it exists in user record
 
 View [John Doe]({ADMIN_BASE_PATH}resource/users/show/123)
-Are you sure?
 ```
 
 ## Updating
@@ -81,7 +61,7 @@ In addition to instructions above show user the table of edits (old value/new va
 
 ### Examples
 
-For example if you gonna modify user record, in confirmation please share full user info (not only username but also email, ip country - anything which help adminto check that that is correct user). Message could look like this:
+For example if you gonna modify user record, please share full user info (not only username but also email, ip country - anything which help adminto check that that is correct user). Message could look like this:
 
 ```
 I am going to update user:
@@ -91,8 +71,6 @@ I am going to update user:
 I am going to change email from john_doe@example.com to new_email@example.com
 
 View [John Doe]({ADMIN_BASE_PATH}resource/users/show/123)
-
-Are you sure?
 ```
 
 
@@ -102,7 +80,7 @@ To delete some record you can use `delete_record` tool. To delete record `allowe
 
 ### Example 
 
-If you gonna delete user record, in confirmation please share full user info (not only username but also email, ip country - anything which help adminto check that that is correct user). Message could look like this:
+If you gonna delete user record, please share full user info (not only username but also email, ip country - anything which help adminto check that that is correct user). Message could look like this:
 
 ```I am going to delete user:
 * Username: john_doe
@@ -111,8 +89,6 @@ If you gonna delete user record, in confirmation please share full user info (no
 * IP Country: USA
 
 View [John Doe]({ADMIN_BASE_PATH}resource/users/show/123)
-
-Are you sure?
 ```
 
 ## Creating
@@ -142,6 +118,4 @@ I am going to create user:
 * Email: john_doe@example.com
 
 View [John Doe]({ADMIN_BASE_PATH}resource/users/show/421) # 421 is id of new created record
-
-Are you sure?
 ```

package/dist/custom/types.ts

@@ -1,15 +1,18 @@
 export interface IPartData {
   toolCallId?: string;
   toolName?: string;
+  sessionId?: string;
   phase?: 'start' | 'end';
   label?: string;
   input?: any;
   output?: any;
   durationMs?: number;
   toolInfo?: string;
+  status?: 'pending' | 'processing' | 'approved' | 'rejected';
+  messages?: string[];
 }
 export interface IPart {
-  type: 'reasoning' | 'data-tool-call' | 'data-rendering' | 'text';
+  type: 'reasoning' | 'data-tool-call' | 'data-rendering' | 'data-tool-approval' | 'text';
   text?: string;
   state?: 'started' | 'thinking' | 'processing' | 'streaming' | 'done';
   data?: IPartData;

package/dist/endpoints/core.js

@@ -16,6 +16,10 @@ const agentResponseBodySchema = z.object({
     timeZone: z.string().optional(),
     currentPage: z.custom().optional(),
 }).strict();
+const agentApprovalBodySchema = z.object({
+    sessionId: z.string(),
+    decision: z.enum(["approve", "reject"]),
+}).strict();
 const agentSpeechResponseBodySchema = agentResponseBodySchema.omit({ message: true });
 export function setupCoreEndpoints(ctx, server) {
     server.endpoint({
@@ -63,6 +67,30 @@ export function setupCoreEndpoints(ctx, server) {
             return null;
         })
     });
+    server.endpoint({
+        method: 'POST',
+        path: `/agent/approval`,
+        handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, response, _raw_express_res, abortSignal }) {
+            const data = ctx.parseBody(agentApprovalBodySchema, body, response);
+            if (!data)
+                return;
+            const emit = createSseEventEmitter(_raw_express_res, {
+                vercelAiUiMessageStream: true,
+                closeActiveBlockOnToolStart: true,
+            });
+            yield ctx.handleTurn({
+                prompt: "",
+                sessionId: data.sessionId,
+                approvalDecision: data.decision,
+                abortSignal,
+                adminUser: adminUser,
+                emit,
+                failureLogMessage: "Agent approval response streaming failed",
+                abortLogMessage: "Agent approval response streaming aborted by the client",
+            });
+            return null;
+        })
+    });
     server.endpoint({
         method: 'POST',
         path: `/agent/speech-response`,

package/dist/index.js

@@ -66,7 +66,7 @@ export default class AdminForthAgentPlugin extends AdminForthPlugin {
             toolProvider,
         });
         const persistence = new TurnPersistenceService(() => this.adminforth, this.options);
-        this.agentTurnService = new AgentTurnService(new TurnLifecycleService(this.sessionStore, persistence), new TurnContextBuilder(() => this.adminforth), new AgentModeResolver(this.options), new AgentModelFactory((_a = this.options.maxTokens) !== null && _a !== void 0 ? _a : 1000), new TurnPromptBuilder({
+        this.agentTurnService = new AgentTurnService(new TurnLifecycleService(this.sessionStore, persistence, this.options), new TurnContextBuilder(() => this.adminforth), new AgentModeResolver(this.options), new AgentModelFactory((_a = this.options.maxTokens) !== null && _a !== void 0 ? _a : 1000), new TurnPromptBuilder({
             getAdminforth: () => this.adminforth,
             getAgentSystemPrompt: () => this.agentSystemPromptPromise,
         }), runtime, new TurnStreamConsumer());

package/dist/sessionStore.d.ts

@@ -14,6 +14,7 @@ export declare class AgentSessionStore {
         response: any;
     }[]>;
     getPreviousUserMessages(sessionId: string): Promise<PreviousUserMessage[]>;
+    getLatestTurn(sessionId: string): Promise<any>;
     getChatSurfaceSessionId(incoming: ChatSurfaceIncomingMessage): string;
     getOrCreateChatSurfaceSession(incoming: ChatSurfaceIncomingMessage, adminUser: AdminUser): Promise<string>;
 }