@promptbook/cli 0.114.0-5 → 0.114.0-50

package/src/book-components/Chat/utils/externalSourceToolCall.ts

@@ -0,0 +1,65 @@
+import type {
+    AgentMessageTouchedExternalSource,
+    AgentMessageTouchedExternalSourceKind,
+} from '../../../utils/agent-message-runtime/AgentMessageTouchedExternalSource';
+import { normalizeAgentMessageTouchedExternalSource } from '../../../utils/agent-message-runtime/AgentMessageTouchedExternalSource';
+
+/**
+ * Synthetic tool name used for external-source chips in chat UI.
+ *
+ * The Agents Server emits one such tool call per source outside the agent an answer viewed or
+ * edited, so the chat shows which services, websites and searches the agent really reached below
+ * the message that touched them. Work the agent does inside itself emits nothing.
+ *
+ * @private internal chat-ui marker for touched external sources
+ */
+export const EXTERNAL_SOURCE_TOOL_CALL_NAME = 'external_source_touched';
+
+/**
+ * Emoji shown in the chip of each external source category.
+ *
+ * @private internal chat-ui constant for touched external sources
+ */
+const EXTERNAL_SOURCE_EMOJI_BY_KIND: Readonly<Record<AgentMessageTouchedExternalSourceKind, string>> = {
+    integration: '🔌',
+    website: '🌐',
+    search: '🔎',
+};
+
+/**
+ * Parses the external-source chip payload from one tool result.
+ *
+ * @param result - Raw tool result payload.
+ * @returns Parsed source metadata, or `null` when the result describes no external source.
+ *
+ * @private internal helper reused by chip and modal rendering
+ */
+export function parseExternalSourceToolCallResult(result: unknown): AgentMessageTouchedExternalSource | null {
+    return normalizeAgentMessageTouchedExternalSource(result);
+}
+
+/**
+ * Resolves the chip label of one touched external source.
+ *
+ * @param externalSource - Parsed source metadata.
+ * @returns User-facing name of the source.
+ *
+ * @private internal helper reused by chip and modal rendering
+ */
+export function resolveExternalSourceToolCallLabel(externalSource: AgentMessageTouchedExternalSource): string {
+    return externalSource.name;
+}
+
+/**
+ * Resolves the chip emoji of one touched external source.
+ *
+ * @param externalSource - Parsed source metadata.
+ * @returns Emoji telling apart an integration, a website and a search.
+ *
+ * @private internal helper reused by chip and modal rendering
+ */
+export function resolveExternalSourceToolCallEmoji(externalSource: AgentMessageTouchedExternalSource): string {
+    return EXTERNAL_SOURCE_EMOJI_BY_KIND[externalSource.kind];
+}
+
+// Note: [💞] Ignore a discrepancy between file name and entity name

package/src/book-components/Chat/utils/getToolCallChipletInfo.ts

@@ -1,6 +1,17 @@
 import type { ToolCall } from '../../../types/ToolCall';
 import { ASSISTANT_PREPARATION_TOOL_CALL_NAME } from '../../../types/ToolCall';
 import type { AgentChipData } from '../AgentChip/AgentChip';
+import {
+    AGENT_PROJECT_TOOL_CALL_NAME,
+    parseAgentProjectToolCallResult,
+    resolveAgentProjectToolCallLabel,
+} from './agentProjectToolCall';
+import {
+    EXTERNAL_SOURCE_TOOL_CALL_NAME,
+    parseExternalSourceToolCallResult,
+    resolveExternalSourceToolCallEmoji,
+    resolveExternalSourceToolCallLabel,
+} from './externalSourceToolCall';
 import { formatToolCallLocalTime } from './formatToolCallLocalTime';
 import { formatToolCallTranslationTemplate } from './formatToolCallTranslationTemplate';
 import {
@@ -112,6 +123,8 @@ type ToolCallChipletResolver = (context: ToolCallChipletContext) => ToolCallChip
  */
 const SPECIALIZED_TOOL_CALL_CHIPLET_RESOLVERS: ReadonlyArray<ToolCallChipletResolver> = [
     resolveWalletCredentialChipletInfo,
+    resolveAgentProjectToolCallChipletInfo,
+    resolveExternalSourceToolCallChipletInfo,
     resolveTeamToolCallChipletInfo,
     resolveTimeToolCallChipletInfo,
     resolveEmailToolCallChipletInfo,
@@ -140,6 +153,8 @@ export function buildToolCallChipText(chipletInfo: ToolCallChipletInfo): string
 export const TOOL_TITLES: Record<string, { title: string; emoji: string }> = {
     [ASSISTANT_PREPARATION_TOOL_CALL_NAME]: { title: 'Preparing agent', emoji: '✨' },
     [WALLET_CREDENTIAL_TOOL_CALL_NAME]: { title: 'Credential used', emoji: '🔐' },
+    [AGENT_PROJECT_TOOL_CALL_NAME]: { title: 'Project', emoji: '📁' },
+    [EXTERNAL_SOURCE_TOOL_CALL_NAME]: { title: 'External source', emoji: '🌐' },
     'self-learning': { title: 'self-learning', emoji: '🧠' },
     retrieve_user_memory: { title: 'Reading memory', emoji: '🧠' },
     store_user_memory: { title: 'Storing memory', emoji: '🧠' },
@@ -320,6 +335,55 @@ function resolveWalletCredentialChipletInfo(context: ToolCallChipletContext): To
     return createEmojiToolCallChipletInfo(context, walletCredentialResult.credentialName);
 }
 
+/**
+ * Resolves the project-name chip label for touched agent projects.
+ *
+ * @param context - Shared chiplet resolution context.
+ * @returns Chiplet info when the tool call marks a touched project, otherwise `null`.
+ *
+ * @private utility of `<Chat/>`
+ */
+function resolveAgentProjectToolCallChipletInfo(context: ToolCallChipletContext): ToolCallChipletInfo | null {
+    if (context.toolCall.name !== AGENT_PROJECT_TOOL_CALL_NAME) {
+        return null;
+    }
+
+    const projectResult = parseAgentProjectToolCallResult(context.resultRaw);
+    if (!projectResult) {
+        return null;
+    }
+
+    return createEmojiToolCallChipletInfo(context, resolveAgentProjectToolCallLabel(projectResult));
+}
+
+/**
+ * Resolves the source-name chip label for touched external sources.
+ *
+ * The emoji tells apart an integration, a website and a search, so it overrides the single emoji
+ * registered for the tool name itself.
+ *
+ * @param context - Shared chiplet resolution context.
+ * @returns Chiplet info when the tool call marks a touched external source, otherwise `null`.
+ *
+ * @private utility of `<Chat/>`
+ */
+function resolveExternalSourceToolCallChipletInfo(context: ToolCallChipletContext): ToolCallChipletInfo | null {
+    if (context.toolCall.name !== EXTERNAL_SOURCE_TOOL_CALL_NAME) {
+        return null;
+    }
+
+    const externalSource = parseExternalSourceToolCallResult(context.resultRaw);
+    if (!externalSource) {
+        return null;
+    }
+
+    return {
+        text: `${resolveExternalSourceToolCallEmoji(externalSource)} ${resolveExternalSourceToolCallLabel(
+            externalSource,
+        )}`,
+    };
+}
+
 /**
  * Resolves a chip label and agent metadata for TEAM tool calls.
  *