@stack-spot/ai-chat-widget 1.27.0 → 1.27.1-beta.0

package/src/chat-interceptors/quick-commands.ts

@@ -1,5 +1,5 @@
 import { aiClient, CancelledError, FixedChatRequest, StackspotAPIError } from '@stack-spot/portal-network'
-import { QuickCommandFetchResponseResult, QuickCommandPromptResponse2, QuickCommandResponse } from '@stack-spot/portal-network/api/ai'
+import { QuickCommandFetchResponseResult, QuickCommandPromptResponse2, QuickCommandResponse, QuickCommandStepFetchResponse } from '@stack-spot/portal-network/api/ai'
 import { Dictionary, interpolate, translate } from '@stack-spot/portal-translate'
 import type { editor } from 'monaco-editor'
 import { ulid } from 'ulid'
@@ -23,6 +23,7 @@ interface QCContext {
   code?: string,
   executionId: string,
   signal: AbortSignal,
+  isRemote?: boolean,
 }
 
 /**
@@ -71,7 +72,26 @@ export function createQuickCommandInterceptor(widget: WidgetState, getEditor: ()
    */
   async function runFetchStep(ctx: QCContext, stepIndex: number) {
     const { qc: { slug, steps }, code, context, resultMap, executionId, signal } = ctx
-    const step = steps![stepIndex]
+    const step = steps![stepIndex] as QuickCommandStepFetchResponse
+    if (step.is_remote) {
+      ctx.isRemote = true
+
+      const { data } = await aiClient.fetchStepOfQuickCommandRemotely.mutate({
+        slug, stepSlug: step.slug,
+        quickCommandsExecutionRequest: { code_selection: code, context, slugs_executions: resultMap, qc_execution_id: executionId },
+      })
+
+      //data is the return of the request in the QC so we do not have full control over the response
+      //We handle the usual format with body, status_code and headers, but we might also handle other formats
+      const responseData = data as any
+      resultMap[step.slug] = {
+        status: responseData.status_code || 200,
+        data: JSON.stringify(responseData.body) ?? JSON.stringify(responseData),
+        headers: responseData.headers ?? {},
+      }
+      return
+    }
+
     const { headers, data, method, url } = await aiClient.fetchStepOfQuickCommand.mutate({
       slug,
       stepSlug: step.slug,
@@ -208,7 +228,7 @@ export function createQuickCommandInterceptor(widget: WidgetState, getEditor: ()
   /**
    * This registers a quick command event in the backend (analytics).
    */
-  async function registerAnalyticsEvent({ qc, executionId, code = '', context }: QCContext, status: string, start: number) {
+  async function registerAnalyticsEvent({ qc, isRemote, executionId, code = '', context }: QCContext, status: string, start: number) {
     const now = new Date().getTime()
     try {
       await aiClient.createEvent.mutate({
@@ -221,6 +241,8 @@ export function createQuickCommandInterceptor(widget: WidgetState, getEditor: ()
             slug: qc.slug,
             qc_execution_id: executionId,
             id: qc.id,
+            //@ts-ignore
+            is_remote: isRemote,
           },
           code,
           context,

package/src/components/AgentCard/dictionary.ts

@@ -2,7 +2,8 @@ import { Dictionary } from '@stack-spot/portal-translate'
 
 export const dictionary = {
   en: {
-    builtin: 'Built-in',
+    'built_in': 'Embutido',
+    workspace: 'Spot',
     personal: 'Personal',
     account: 'Account',
     shared: 'Shared',
@@ -10,7 +11,8 @@ export const dictionary = {
     create: 'Create',
   },
   pt: {
-    builtin: 'Embutido',
+    'built_in': 'Embutido',
+    workspace: 'Spot',
     personal: 'Personal',
     account: 'Conta',
     shared: 'Compartilhado',

package/src/components/Selector/index.tsx

@@ -2,7 +2,7 @@ import { IconBox, Text } from '@citric/core'
 import { ExternalLink } from '@citric/icons'
 import { IconButton } from '@citric/ui'
 import { useKeyboardControls } from '@stack-spot/portal-components'
-import { VisibilityLevelEnum } from '@stack-spot/portal-network/api/ai'
+import { AgentVisibilityLevel } from '@stack-spot/portal-network'
 import { Dictionary, interpolate, useTranslate } from '@stack-spot/portal-translate'
 import React, { FC, useCallback, useEffect, useMemo, useRef, useState } from 'react'
 import { useCurrentChatState } from '../../context/hooks'
@@ -12,8 +12,7 @@ import { Fading } from '../Fading'
 import { FallbackBoundary } from '../FallbackBoundary'
 import { SelectorBox } from './styled'
 
-type SectionVisibility = VisibilityLevelEnum | 'built-in'
-
+type SectionVisibility =  AgentVisibilityLevel
 type SelectorShortcut = '/' | '@'
 
 interface Item {
@@ -268,7 +267,7 @@ const dictionary = {
     personal: 'Personal',
     account: 'Account',
     shared: 'Shared',
-    'built-in': 'Built-in',
+    'built_in': 'Built-in',
     workspace: 'Spot',
     error: 'Could not load the $0s.',
     noData: 'You don\'t have any $0 yet.',
@@ -282,7 +281,7 @@ const dictionary = {
     account: 'Conta',
     shared: 'Compartilhado',
     workspace: 'Spot',
-    'built-in': 'Embutido',
+    'built_in': 'Embutido',
     error: 'Não foi possível carregar os $0s.',
     noData: 'Você ainda não possui $0s.',
     noResults: 'Não $0s para mostrar aqui.',

package/src/state/types.ts

@@ -4,7 +4,7 @@ export interface Labeled {
 }
 
 export interface LabeledWithImage extends Labeled {
-  image?: string,
+  image?: string | undefined | null,
 }
 
 export interface LabeledAgent extends LabeledWithImage {

package/src/utils/tools.ts

@@ -1,11 +1,9 @@
-import { BuiltinToolResponse, ToolkitsInAgentResponse } from '@stack-spot/portal-network/api/agent'
+import { BuiltinToolkitResponse, BuiltinToolResponse } from '@stack-spot/portal-network/api/agent'
+import { keyBy } from 'lodash'
 
 export type ToolWithImage = BuiltinToolResponse & { id: string, image?: string }
 
-export function toolById(id: string, toolkits: ToolkitsInAgentResponse | undefined): ToolWithImage | undefined {
-  for (const toolkit of toolkits?.builtins ?? []) {
-    for (const tool of toolkit.tools ?? []) {
-      if (tool.id === id) return { ...tool, id, image: toolkit.image_url }
-    }
-  }
+export function toolById(id: string, toolkits: BuiltinToolkitResponse[] | undefined): ToolWithImage | undefined {
+  const tools = toolkits?.map(({ image_url, tools }) => tools?.map((tool) => ({ ...tool, id: tool.id!, image: image_url! }))).flat()
+  return keyBy(tools, 'id')[id]
 }

package/src/views/Agents/AgentDescription.tsx

@@ -1,29 +1,21 @@
 import { Text } from '@citric/core'
 import { Badge, Skeleton } from '@citric/ui'
-import { agentClient, AgentVisibilityLevel } from '@stack-spot/portal-network'
+import { agentToolsClient } from '@stack-spot/portal-network'
 import { useMemo } from 'react'
 import { ToolBadge } from '../../components/ToolBadge'
+import { toolById } from '../../utils/tools'
 import { useAgentsDictionary } from './dictionary'
 import { AgentDescriptionBox } from './styled'
 
-interface Props {
-  agentId?: string,
-  llm?: string,
-  description?: string,
-  numberOfKnowledgeSources: number,
-  visibility: AgentVisibilityLevel,
-}
-
-export const AgentDescription = ({ agentId, llm, description, numberOfKnowledgeSources, visibility }: Props) => {
+export const AgentDescription = ({ agentId }: { agentId?: string }) => {
   const t = useAgentsDictionary()
-  const [agent, , , { isLoading }] = agentClient.agentById.useStatefulQuery(
-    { agentId: agentId!, builtIn: visibility === 'BUILT-IN' },
-    { enabled: !!agentId },
-  )
+  const [agent, , , { isLoading }] = agentToolsClient.agent.useStatefulQuery({ agentId: agentId! }, { enabled: !!agentId })
+  const [toolKits, , , { isLoading: isLoadingToolKit }] = agentToolsClient.tools.useStatefulQuery()
+  const numberOfKnowledgeSources = agent?.knowledge_source_config?.knowledge_sources.length ?? 0
   
   const knowledgeSources = useMemo(
-    () => agent?.knowledge_sources_config?.knowledge_sources_details?.map((ks, index) => (
-      <li key={index}><Badge palette="teal" appearance="square">{ks.name}</Badge></li>
+    () => agent?.knowledge_source_config?.knowledge_sources?.map((ks, index) => (
+      <li key={index}><Badge palette="teal" appearance="square">{ks}</Badge></li>
     )),
     [agent],
   )
@@ -36,31 +28,32 @@ export const AgentDescription = ({ agentId, llm, description, numberOfKnowledgeS
   }, [numberOfKnowledgeSources])
   const tools = useMemo(() => {
     const result: React.ReactElement[] = []
-    for (const kit of agent?.toolkits?.builtins ?? []) {
-      for (const tool of kit.tools ?? []) {
-        result.push(<li key={tool.id}><ToolBadge name={tool.name || tool.id || 'unknown'} image={kit.image_url} /></li>)
-      }
+    for (const tool of agent?.tools ?? []) {
+      const toolWithImage = toolById(tool.builtin_tool_id, toolKits)
+      result.push(<li key={tool.builtin_tool_id}>
+        <ToolBadge name={toolWithImage?.name || toolWithImage?.id || 'unknown'} image={toolWithImage?.image} />
+      </li>)
     }
     return result
   }, [agent])
 
   return (
     <AgentDescriptionBox>
-      {description && <section>
+      {agent?.description && <section>
         <Text appearance="microtext1" className="title">{t.description}</Text>
-        <Text>{description}</Text>
+        <Text>{agent?.description}</Text>
       </section>}
       {(!!numberOfKnowledgeSources || !!knowledgeSources?.length) && <section>
         <Text appearance="microtext1" className="title">Knowledge sources</Text>
-        <ul>{isLoading ? skeleton : knowledgeSources}</ul>
+        <ul>{isLoading || isLoadingToolKit ? skeleton : knowledgeSources}</ul>
       </section>}
       {!!tools.length && <section>
         <Text appearance="microtext1" className="title">{t.tools}</Text>
         <ul>{tools}</ul>
       </section>}
-      {llm && <section>
+      {agent?.model_name && <section>
         <Text appearance="microtext1" className="title">LLM</Text>
-        <Badge palette="orange" appearance="square">{llm}</Badge>
+        <Badge palette="orange" appearance="square">{agent?.model_name}</Badge>
       </section>}
     </AgentDescriptionBox>
   )

package/src/views/Agents/AgentsPanel.tsx

@@ -1,3 +1,4 @@
+import { agentToolsClient } from '@stack-spot/portal-network'
 import { useEffect, useMemo, useRef } from 'react'
 import { RightPanelTabs } from '../../components/RightPanelTabs'
 import { useCurrentChat } from '../../context/hooks'
@@ -5,8 +6,6 @@ import { checkIsTrial } from '../../utils/check-is-trial'
 import { AgentsTab, AgentsTabWorkspace } from './AgentsTab'
 import { useAgentsDictionary } from './dictionary'
 
-const agentDefaultSlug = 'stk_code_buddy'
-
 /**
  * Renders the Agent selection form in the Right Panel if this is the panel that is currently opened.
  */
@@ -17,22 +16,22 @@ export const AgentsPanel = () => {
   const agent = useRef(chat.get('agent'))
 
   useEffect(() => {
-    if (agentDefaultSlug !== chat.get('agent')?.slug) {
+    if (agentToolsClient.agentDefaultSlug !== chat.get('agent')?.slug) {
       agent.current = chat.get('agent')
     }
   }, [chat])
 
   const tabs= useMemo(() => isTrial ? [
-    { title: t.favorites, content: <AgentsTab key="favorite" visibility="FAVORITE" agent={agent} /> },
-    { title: t.builtin, content: <AgentsTab key="builtin" visibility="BUILT-IN" agent={agent} /> },
-    { title: t.personal, content: <AgentsTab key="personal" visibility="PERSONAL" agent={agent} /> },
+    { title: t.favorites, content: <AgentsTab key="favorite" visibility="favorite" agent={agent} /> },
+    { title: t.builtin, content: <AgentsTab key="builtin" visibility="built_in" agent={agent} /> },
+    { title: t.personal, content: <AgentsTab key="personal" visibility="personal" agent={agent} /> },
   ]: [
-    { title: t.favorites, content: <AgentsTab key="favorite" visibility="FAVORITE" agent={agent} /> },
-    { title: t.builtin, content: <AgentsTab key="builtin" visibility="BUILT-IN" agent={agent} /> },
-    { title: t.personal, content: <AgentsTab key="personal" visibility="PERSONAL" agent={agent} /> },
-    { title: t.shared, content: <AgentsTab key="shared" visibility="SHARED" agent={agent} /> },
-    { title: t.spots, content: <AgentsTabWorkspace key="workspace"  visibility="WORKSPACE" agent={agent} /> },
-    { title: t.account, content: <AgentsTab key="account" visibility="ACCOUNT" agent={agent} /> },
+    { title: t.favorites, content: <AgentsTab key="favorite" visibility="favorite" agent={agent} /> },
+    { title: t.builtin, content: <AgentsTab key="builtin" visibility="built_in" agent={agent} /> },
+    { title: t.personal, content: <AgentsTab key="personal" visibility="personal" agent={agent} /> },
+    { title: t.shared, content: <AgentsTab key="shared" visibility="shared" agent={agent} /> },
+    { title: t.spots, content: <AgentsTabWorkspace key="workspace"  visibility="workspace" agent={agent} /> },
+    { title: t.account, content: <AgentsTab key="account" visibility="account" agent={agent} /> },
  
   ], [t, isTrial, agent])
   

package/src/views/Agents/AgentsTab.tsx

@@ -2,8 +2,7 @@ import { Button, IconBox, Text } from '@citric/core'
 import { Agent, Search } from '@citric/icons'
 import { Placeholder } from '@stack-spot/portal-components/Placeholder'
 import { MiniLogo } from '@stack-spot/portal-components/svg'
-import { agentClient, AgentResponseWithBuiltIn, workspaceAiClient } from '@stack-spot/portal-network'
-import { VisibilityLevel } from '@stack-spot/portal-network/api/agent'
+import { AgentResponseWithBuiltIn, agentToolsClient, AgentVisibilityLevel, workspaceAiClient } from '@stack-spot/portal-network'
 import { WorkspaceResponse } from '@stack-spot/portal-network/api/workspace-ai'
 import { useCallback, useMemo, useState } from 'react'
 import { ButtonFavorite } from '../../components/ButtonFavorite'
@@ -20,7 +19,7 @@ import { AgentLabel } from './styled'
 import { useAgentFavorites } from './useAgentFavorites'
 
 export interface AgentTabProps {
-  visibility: VisibilityLevel | 'BUILT-IN',
+  visibility: AgentVisibilityLevel,
   workspaceId?: string,
   agent: React.MutableRefObject<ChatProperties['agent']>,
   showSubmitButton?: boolean,
@@ -33,16 +32,15 @@ export const AgentsTab = ({ visibility, workspaceId, agent, showSubmitButton = t
   const [filter, setFilter] = useState('')
   const { useFavorites, onAddFavorite, onRemoveFavorite } = useAgentFavorites()
   const listFavorites = useFavorites()
-  const agentDefault = agentClient.agentDefault.useQuery({})
+  const agentDefault = agentToolsClient.agentDefault.useQuery()
   const agents = workspaceId
-    ? workspaceAiClient.getAgentFromWorkspaceAi.useQuery({ workspaceId })
-    : agentClient.allAgents.useQuery({ visibilities: [visibility] })
-
+    ? workspaceAiClient.getAgentFromWorkspaceAi.useQuery({ workspaceId })  as AgentResponseWithBuiltIn[]
+    : agentToolsClient.agents.useQuery({ visibility })
 
   const [value, setValue] = useState<AgentResponseWithBuiltIn | undefined>(
     agent.current
       ? agents.find(a => a.id === agent.current?.id)
-      : chat.get('agent') ? agents.find(a => a.id === chat.get('agent')?.id) : agentDefault,
+      : chat.get('agent') ? agents.find(a => a.id === chat.get('agent')?.id) : agentDefault as AgentResponseWithBuiltIn,
   )
 
   const filtered = useMemo(
@@ -53,14 +51,17 @@ export const AgentsTab = ({ visibility, workspaceId, agent, showSubmitButton = t
 
   function submit() {
     if (value) {
-      chat.set('agent', { id: value.id, label: value.name, image: value.avatar, builtIn: !!value.builtIn, slug: value.slug })
+      chat.set(
+        'agent', 
+        { id: value.id, label: value.name, image: value.avatar!, builtIn: value.visibility_level === 'built_in', slug: value.slug },
+      )
     }
     close()
   }
 
   const onChange = useCallback((newValue: AgentResponseWithBuiltIn) => {
     setValue(newValue)
-    agent.current = { ...newValue, label: newValue.name, builtIn: !!newValue.builtIn }
+    agent.current = { ...newValue, label: newValue.name, builtIn: newValue.visibility_level === 'built_in' }
   }, [])
 
   return (
@@ -83,13 +84,7 @@ export const AgentsTab = ({ visibility, workspaceId, agent, showSubmitButton = t
               <Text>{name}</Text>
             </AgentLabel>
           )}
-          renderDescription={a => <AgentDescription
-            agentId={a.id}
-            visibility={visibility}
-            description={a.description}
-            llm={a.llm_config?.model_slug}
-            numberOfKnowledgeSources={a.knowledge_sources_config?.knowledge_sources?.length ?? 0}
-          />}
+          renderDescription={a => <AgentDescription agentId={a.id} />}
           optionClassName={a => (a === value && filter && !a.name.toLocaleLowerCase().includes(filter.toLocaleLowerCase()))
             ? 'filtered-out'
             : ''

package/src/views/Agents/useAgentFavorites.ts

@@ -1,15 +1,15 @@
 /* eslint-disable filenames/match-regex */
-import { agentClient } from '@stack-spot/portal-network'
+import { agentClient, agentToolsClient } from '@stack-spot/portal-network'
 
 export function useAgentFavorites() {
-  const useFavorites = () => agentClient.allAgents.useQuery({ visibilities: ['FAVORITE'] })
+  const useFavorites = () => agentToolsClient.agents.useQuery({ visibility: 'favorite' })
   const [addFavorite, pendingAddFav] = agentClient.addFavoriteAgent.useMutation()
   const [removeFavorite, pendingRemoveFav] = agentClient.removeFavoriteAgent.useMutation()
 
   const removeFavoriteAgent = async (idOrSlug?: string) => {
     try {
       await removeFavorite({ agentId: idOrSlug || '' })
-      await agentClient.allAgents.invalidate({ visibilities: ['FAVORITE'] })
+      await agentToolsClient.agents.invalidate({ visibility: 'favorite' })
     } catch (error) {
       // eslint-disable-next-line no-console
       console.error(error)
@@ -19,7 +19,7 @@ export function useAgentFavorites() {
   const addFavoriteAgent = async (idOrSlug?: string) => {
     try {
       await addFavorite({ agentId: idOrSlug || '' })
-      await agentClient.allAgents.invalidate({ visibilities: ['FAVORITE'] })
+      await agentToolsClient.agents.invalidate({ visibility: 'favorite' })
     } catch (error) {
       // eslint-disable-next-line no-console
       console.error(error)

package/src/views/Chat/ChatMessage.tsx

@@ -1,7 +1,7 @@
 import { Box, Button, Checkbox, Flex, IconBox, Input, Label, Radio, Text } from '@citric/core'
 import { Check, Cog, Copy, Dislike, DislikeFill, Like, LikeFill, TimesCircle } from '@citric/icons'
 import { Badge, IconButton, Tooltip } from '@citric/ui'
-import { agentClient } from '@stack-spot/portal-network'
+import { agentToolsClient } from '@stack-spot/portal-network'
 import { listToClass } from '@stack-spot/portal-theme'
 import { Dictionary, useTranslate } from '@stack-spot/portal-translate'
 import { groupBy } from 'lodash'
@@ -193,11 +193,10 @@ export const ChatMessage = ({ message, isLast, beforeMessage, afterMessage }: Pr
   const widget = useWidget()
   const chat = useCurrentChat()
   const agentId = entry.agent?.id ?? ''
-  const [agent] = agentClient.agentById.useStatefulQuery({ agentId, builtIn: !!entry?.agent?.builtIn }, { enabled: !!agentId  })
+  const [toolKits] = agentToolsClient.tools.useStatefulQuery({ enabled: !!agentId })
   const [copied, setCopied] = useState(false)
   const [showUserButtonCopy, setShowUserButtonCopy] = useState(false)
 
-  
   useChatScrollToBottomEffect(ref, [entry])
 
   const detailKS = useCallback(({ name, slug, documentScore, documentId }: Required<TextChatEntry>['knowledgeSources'][number]) => {
@@ -349,7 +348,7 @@ export const ChatMessage = ({ message, isLast, beforeMessage, afterMessage }: Pr
           className="tools-badge"
           label={t.tools}
           images={entry.tools.slice(0, 3).map((id) => {
-            const tool = toolById(id, agent?.toolkits)
+            const tool = toolById(id, toolKits)
             return { key: id, name: tool?.name || id, icon: <Cog />, url: tool?.image }
           })}
           onClick={openToolsPanel}

package/src/views/ChatHistory/HistoryItem.tsx

@@ -2,7 +2,7 @@ import { IconBox, Input } from '@citric/core'
 import { Check, Download, EllipsisHorizontal, Pencil, Trash } from '@citric/icons'
 import { IconButton, LoadingCircular } from '@citric/ui'
 import { focusNextIgnoringChildren } from '@stack-spot/portal-components'
-import { aiClient } from '@stack-spot/portal-network'
+import { agentToolsClient, aiClient } from '@stack-spot/portal-network'
 import { ConversationResponse } from '@stack-spot/portal-network/api/ai'
 import { theme } from '@stack-spot/portal-theme'
 import { last } from 'lodash'
@@ -11,12 +11,13 @@ import { OverlayMenu } from '../../components/OverlayMenu'
 import { useWidget } from '../../context/hooks'
 import { ChatEntry } from '../../state/ChatEntry'
 import { ChatState } from '../../state/ChatState'
+import { LabeledAgent } from '../../state/types'
 import { ButtonAction } from '../../types'
 import { download } from '../../utils/download'
 import { genericSourcesToKnowledgeSources } from '../../utils/knowledge-source'
 import { useHistoryDictionary } from './dictionary'
 import { HistoryItemBox } from './styled'
-import { findStack, findWorkspace, getAllAgents } from './utils'
+import { findStack, findWorkspace } from './utils'
 
 /**
  * Renders an item of the list of conversations (history).
@@ -88,12 +89,16 @@ export const HistoryItem = ({ item }: { item: ConversationResponse }) => {
     setLoading(true)
     try {
       const chat = await aiClient.chat.query({ conversationId: item.id })
+      const historyAgentIds = chat.history?.map(item => item.custom_agent?.id).filter(Boolean) as string[] ?? []
       const [stack, workspace, agents] = await Promise.all([
         findStack(chat.ai_stack_id),
         findWorkspace(chat.workspace_id),
-        getAllAgents(),
+        agentToolsClient.agentsByIds.query({ searchAgentsRequest: { ids: historyAgentIds } }),
       ])
-      const agent = agents.find(a => a.id === last(chat.history)?.custom_agent?.id)
+      const agentsAsLabeledAgents: LabeledAgent[] = agents
+        .map((a) => ({ ...a, label: a.name, image: a.avatar ?? '', builtIn: a.visibility_level === 'built_in' }))
+      
+      const agent = agentsAsLabeledAgents.find(a => a.id === last(chat.history)?.custom_agent?.id)
       const builtIn = !!last(chat.history ?? [])?.custom_agent?.built_in
       widget.chatTabs.add(new ChatState({
         id: chat.id,
@@ -103,7 +108,7 @@ export const HistoryItem = ({ item }: { item: ConversationResponse }) => {
           agentType: item.agent === 'USER' ? 'user' : 'bot',
           content: item.content,
           type: 'md',
-          agent: agents.find(a => a.id === item.custom_agent?.id),
+          agent: agentsAsLabeledAgents.find(a => a.id === item.custom_agent?.id),
           messageId: item.message_id,
           knowledgeSources: item.agent === 'USER' ? undefined : genericSourcesToKnowledgeSources(item.sources),
           updated: item.updated,

package/src/views/ChatHistory/utils.ts

@@ -1,6 +1,5 @@
-import { agentClient, aiClient, workspaceClient } from '@stack-spot/portal-network'
+import { aiClient, workspaceClient } from '@stack-spot/portal-network'
 import { ChatProperties } from '../../state/ChatState'
-import { LabeledWithImage } from '../../state/types'
 
 /**
  * Finds a stack by its id.
@@ -36,19 +35,3 @@ export async function findWorkspace(id: string | null): Promise<ChatProperties['
     return { id, label: id }
   }
 }
-
-
-/**
- * Finds all the agents, including common agents and public agents.
- * @returns an array with every agent.
- */
-export async function getAllAgents(): Promise<LabeledWithImage[]> {
-  try {
-    const agents = await agentClient.allAgents.query({ visibilities: ['ALL'] })
-    return agents.map(a => ({ id: a.id, label: a.name, image: a.avatar, slug: a.slug, builtIn: a.builtIn }))
-  } catch (error) {
-    // eslint-disable-next-line no-console
-    console.error(error)
-    return []
-  }
-}

package/src/views/Home/CustomAgent.tsx

@@ -1,6 +1,6 @@
 import { IconBox, Text } from '@citric/core'
 import { Agent } from '@citric/icons'
-import { agentClient } from '@stack-spot/portal-network'
+import { agentToolsClient } from '@stack-spot/portal-network'
 import { useMemo } from 'react'
 import { QuickStartButton } from '../../components/QuickStartButton'
 import { useCurrentChat, useCurrentChatState } from '../../context/hooks'
@@ -12,15 +12,15 @@ import { HomeBox } from './styled'
  */
 export const CustomAgent = () => {
   const { id, label, image } = useCurrentChatState('agent') ?? {}
-  const [agent] = agentClient.agent.useStatefulQuery({ agentId: id! })
+  const [agent] = agentToolsClient.agent.useStatefulQuery({ agentId: id! })
   const chat = useCurrentChat()
-  const suggestions = useMemo(() => agent?.suggested_prompts?.map((prompt, index) => (
+  const suggestions = useMemo(() => agent?.conversation_starter?.map((prompt, index) => (
     <QuickStartButton
       key={index}
       label={prompt}
       onClick={() => send(prompt)}
     />
-  )), [agent?.suggested_prompts])
+  )), [agent?.conversation_starter])
 
   function send(message: string) {
     chat.pushMessage(ChatEntry.createUserEntry(message))

package/src/views/MessageInput/AgentSelector.tsx

@@ -1,6 +1,6 @@
 import { Flex, IconBox, Image } from '@citric/core'
 import { Agent } from '@citric/icons'
-import { agentClient, AgentResponseWithBuiltIn } from '@stack-spot/portal-network'
+import { AgentResponseWithBuiltIn, agentToolsClient } from '@stack-spot/portal-network'
 import { useCallback } from 'react'
 import { Selector } from '../../components/Selector'
 import { useCurrentChat, useCurrentChatState } from '../../context/hooks'
@@ -53,9 +53,9 @@ export const AgentSelector = ({ inputRef, isTrial }: {
 
   const getAgents = () => {
     if (isTrial) {
-      return agentClient.allAgents.useQuery({ visibilities: ['PERSONAL', 'BUILT-IN'] }) 
+      return agentToolsClient.allAgents.useQuery({ visibilities: ['personal', 'built_in'] })
     }
-    return agentClient.allAgents.useQuery({ visibilities: ['ACCOUNT', 'SHARED', 'PERSONAL', 'BUILT-IN', 'WORKSPACE'] })
+    return agentToolsClient.allAgents.useQuery({ visibilities: ['account', 'shared', 'personal', 'built_in', 'workspace'] })
   }
 
   return <Selector
@@ -68,7 +68,7 @@ export const AgentSelector = ({ inputRef, isTrial }: {
       regex: agentRegex,
       urlBuilder: (agent) => `/agents/${agent?.id}`,
       searchProp: 'name',
-      sections: isTrial ? ['favorite', 'personal', 'built-in'] : ['favorite', 'personal', 'workspace', 'account', 'shared', 'built-in'],
+      sections: isTrial ? ['favorite', 'personal', 'built_in'] : ['favorite', 'personal', 'workspace', 'account', 'shared', 'built_in'],
       renderComponentItem: AgentItem,
       isEnabled: isAgentEnabled,
       onSelect: onSelectItem,

package/src/views/MessageInput/ButtonAgent.tsx

@@ -2,14 +2,14 @@ import { Flex, IconBox } from '@citric/core'
 import { Agent, TimesMini } from '@citric/icons'
 import { IconButton, Tooltip } from '@citric/ui'
 import { MiniLogo } from '@stack-spot/portal-components/svg'
-import { agentClient } from '@stack-spot/portal-network'
+import { agentToolsClient } from '@stack-spot/portal-network'
 import { useEffect } from 'react'
 import { useCurrentChat, useCurrentChatState, useWidget } from '../../context/hooks'
 import { useMessageInputDictionary } from './dictionary'
 
 export const ButtonAgent = () => {
   const t = useMessageInputDictionary()
-  const agentDefault = agentClient.agentDefault.useQuery({})
+  const agentDefault = agentToolsClient.agentDefault.useQuery()
   const widget = useWidget()
   const chat = useCurrentChat()
   const agent = useCurrentChatState('agent')

package/src/views/MessageInput/QuickCommandSelector.tsx

@@ -13,14 +13,14 @@ export const QuickCommandSelector = ({ inputRef, isTrial }:
   const chat = useCurrentChat()
   const isQuickCommandEnabled =  useCurrentChatState('features').quickCommands
 
-  const useFavorites = () => aiClient.quickCommands.useQuery({ visibility: 'favorite' })
+  const useFavorites = () => aiClient.allQuickCommands.useQuery({ visibility: 'favorite' })
   const [addFavorite, pendingAddFav] = aiClient.addFavoriteQuickCommand.useMutation()
   const [removeFavorite, pendingRemoveFav] = aiClient.removeFavoriteQuickCommand.useMutation()
 
   const addFavoriteQc = async(idOrSlug?: string) => {
     try {
       await addFavorite({ slug: idOrSlug || '' })
-      await aiClient.quickCommands.invalidate()
+      await aiClient.allQuickCommands.invalidate()
     } catch (error) {
       // eslint-disable-next-line no-console
       console.error(error)
@@ -45,7 +45,7 @@ export const QuickCommandSelector = ({ inputRef, isTrial }:
   const removeFavoriteQc = async(idOrSlug?: string) => {
     try {
       await removeFavorite({ slug: idOrSlug || '' })
-      await aiClient.quickCommands.invalidate()
+      await aiClient.allQuickCommands.invalidate()
     } catch (error) {
       // eslint-disable-next-line no-console
       console.error(error)
@@ -77,7 +77,7 @@ export const QuickCommandSelector = ({ inputRef, isTrial }:
   }, [chat, inputRef])
 
   const getQuickCommands = () => {
-    const quickCommands = aiClient.quickCommands.useQuery({ order: 'a-to-z' })
+    const quickCommands = aiClient.allQuickCommands.useQuery({ order: 'a-to-z' })
     const quickCommandsFiltered = quickCommands.filter((qc) => qc.visibility_level.toLowerCase() !== 'workspace')
     const workspaceQuickCommands = workspaceAiClient.workspacesContentsByType.useQuery({ contentType: 'quick_command' })
     const workspaceQuickCommandsWithWorkspaceName: QuickCommandResponseWithSpaceName[] = workspaceQuickCommands

package/src/views/MessageInput/dictionary.ts

@@ -8,7 +8,7 @@ const dictionary = {
     knowledgeSource: 'Select knowledge sources',
     agent: 'Select agent',
     send: 'Send message',
-    placeholder: 'Send a message to $0',
+    placeholder: 'Send a message to $0. For commands, use @ or /',
     cancel: 'Cancel',
     removeConfig: 'Remove all the configuration',
     removeStack: 'Stop using the current stack',
@@ -25,7 +25,7 @@ const dictionary = {
     cantSendBecauseOfUploadError: 'Can\'t send the message because one of the files in the upload list could not be uploaded. Please, retry it or remove it from the list.',
     cantSendBecauseOfUploadProgress: 'Please wait until all files are uploaded before sending the message. You can also cancel the upload by removing it from the list of uploads.',
     cantSendBecauseOfEmptyContent: 'You can\'t send empty messages. Please write some text or upload a file.',
-    chatAgent: 'Agent',
+    chatAgent: 'Agents',
   },
   pt: {
     stack: 'Selecionar stack',
@@ -34,7 +34,7 @@ const dictionary = {
     knowledgeSource: 'Selecionar knowledge sources',
     agent: 'Selecionar agente',
     send: 'Enviar mensagem',
-    placeholder: 'Envie uma mensagem para $0',
+    placeholder: 'Envie uma mensagem para $0. Para comandos, use @ ou /',
     cancel: 'Cancelar',
     removeConfig: 'Remover todas as configurações',
     removeStack: 'Parar de usar a stack atual',
@@ -53,7 +53,7 @@ const dictionary = {
     cantSendBecauseOfUploadError: 'Não é possível enviar a mensagem, pois um dos arquivos na lista de uploads não pôde ser enviado. Por favor, tente enviá-lo novamente ou remova-o da lista.',
     cantSendBecauseOfUploadProgress: 'Por favor aguarde todos os uploads de arquivos antes de enviar a mensagem. Você pode cancelar o upload removendo o arquivo da lista de uploads.',
     cantSendBecauseOfEmptyContent: 'Não é possível enviar mensagens vazias. Por favor, escreva algum texto ou envie um arquivo.',
-    chatAgent: 'Agente',
+    chatAgent: 'Agentes',
   },
 } satisfies Dictionary