@mastra/playground-ui 68.0.0-alpha.2 → 68.0.0-alpha.3

package/dist/domains/chat/tools/mcp-input-request.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-input-request.cjs.js","names":["isRecord"],"sources":["../../../../src/domains/chat/tools/mcp-input-request.ts"],"sourcesContent":["import type { MessageMetadata, SuspendedToolMetadata } from '../messages/message-metadata';\nimport { isRecord } from '../messages/signal-data';\n\n/** An embedded request an MCP server sent while its task waits (`{ method, params }`). */\nexport interface McpInputRequest {\n  method: string;\n  params?: Record<string, unknown>;\n}\n\n/** What `@mastra/mcp` suspends a task-backed tool call with (`MCPInputRequestSuspendPayload`). */\nexport interface McpInputRequestPayload {\n  type: 'mcp-input-request';\n  serverName: string;\n  toolName: string;\n  taskId: string;\n  createdAt: string;\n  /** When the call suspended; new each time the same task asks again, unlike `createdAt`. */\n  requestedAt?: string;\n  requests: Record<string, McpInputRequest>;\n}\n\nexport type McpInputAction = 'accept' | 'decline' | 'cancel';\n\nexport interface McpInputResponse {\n  action: McpInputAction;\n  content?: Record<string, unknown>;\n}\n\n/** Resume data answering every request key (`MCPInputRequestResumeData`). */\nexport interface McpInputResumeData {\n  inputResponses: Record<string, McpInputResponse>;\n}\n\nexport function isMcpInputRequest(payload: unknown): payload is McpInputRequestPayload {\n  return (\n    isRecord(payload) &&\n    payload.type === 'mcp-input-request' &&\n    typeof payload.serverName === 'string' &&\n    typeof payload.toolName === 'string' &&\n    typeof payload.taskId === 'string' &&\n    typeof payload.createdAt === 'string' &&\n    isRecord(payload.requests) &&\n    Object.values(payload.requests).every(request => isRecord(request) && typeof request.method === 'string')\n  );\n}\n\n/** More questions at once than any real task asks; the server decides these, so Studio bounds them. */\nexport const MAX_INPUT_REQUESTS = 20;\nexport const MAX_REQUEST_MESSAGE_LENGTH = 2_000;\nexport const MAX_INPUT_REQUESTS_SIZE = 64 * 1024;\n\n/** Whether the server sent more than Studio draws: too many questions, a huge message, or huge params. */\nexport function inputRequestTooLarge(payload: McpInputRequestPayload): boolean {\n  const requests = Object.values(payload.requests);\n  if (requests.length > MAX_INPUT_REQUESTS) return true;\n  if (\n    requests.some(\n      request =>\n        typeof request.params?.message === 'string' && request.params.message.length > MAX_REQUEST_MESSAGE_LENGTH,\n    )\n  ) {\n    return true;\n  }\n  return JSON.stringify(payload.requests).length > MAX_INPUT_REQUESTS_SIZE;\n}\n\n/**\n * This call's own suspension. Saved entries are keyed by call id, but a live run keys them by tool\n * name (two calls of one tool share that key), so the entry's own `toolCallId` decides.\n */\nexport function findSuspension(\n  metadata: MessageMetadata | undefined,\n  toolCallId: string,\n): SuspendedToolMetadata | undefined {\n  const suspensions = metadata?.suspendedTools;\n  if (!suspensions) return undefined;\n  return Object.values(suspensions).find(entry => entry?.toolCallId === toolCallId);\n}\n\n/** The MCP input request this call is suspended on, if it is. */\nexport function suspendedMcpInputRequest(\n  metadata: MessageMetadata | undefined,\n  toolCallId: string,\n): McpInputRequestPayload | undefined {\n  const payload = findSuspension(metadata, toolCallId)?.suspendPayload;\n  return isMcpInputRequest(payload) ? payload : undefined;\n}\n"],"mappings":";;;AAiCA,SAAgB,kBAAkB,SAAqD;CACrF,OACEA,0CAAAA,SAAS,OAAO,KAChB,QAAQ,SAAS,uBACjB,OAAO,QAAQ,eAAe,YAC9B,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,WAAW,YAC1B,OAAO,QAAQ,cAAc,YAC7BA,0CAAAA,SAAS,QAAQ,QAAQ,KACzB,OAAO,OAAO,QAAQ,QAAQ,CAAC,CAAC,OAAM,YAAWA,0CAAAA,SAAS,OAAO,KAAK,OAAO,QAAQ,WAAW,QAAQ;AAE5G;;AAGA,IAAa,qBAAqB;AAClC,IAAa,6BAA6B;AAC1C,IAAa,0BAA0B;;AAGvC,SAAgB,qBAAqB,SAA0C;CAC7E,MAAM,WAAW,OAAO,OAAO,QAAQ,QAAQ;CAC/C,IAAI,SAAS,SAAA,IAA6B,OAAO;CACjD,IACE,SAAS,MACP,YACE,OAAO,QAAQ,QAAQ,YAAY,YAAY,QAAQ,OAAO,QAAQ,SAAA,GAC1E,GAEA,OAAO;CAET,OAAO,KAAK,UAAU,QAAQ,QAAQ,CAAC,CAAC,SAAS;AACnD;;;;;AAMA,SAAgB,eACd,UACA,YACmC;CACnC,MAAM,cAAc,UAAU;CAC9B,IAAI,CAAC,aAAa,OAAO,KAAA;CACzB,OAAO,OAAO,OAAO,WAAW,CAAC,CAAC,MAAK,UAAS,OAAO,eAAe,UAAU;AAClF;;AAGA,SAAgB,yBACd,UACA,YACoC;CACpC,MAAM,UAAU,eAAe,UAAU,UAAU,CAAC,EAAE;CACtD,OAAO,kBAAkB,OAAO,IAAI,UAAU,KAAA;AAChD"}

package/dist/domains/chat/tools/mcp-input-request.d.ts

@@ -0,0 +1 @@
+export * from '../../../src/domains/chat/tools/mcp-input-request';

package/dist/domains/chat/tools/mcp-input-request.es.js

@@ -0,0 +1,33 @@
+import { isRecord } from "../messages/signal-data.es.js";
+// src/domains/chat/tools/mcp-input-request.ts
+function isMcpInputRequest(payload) {
+	return isRecord(payload) && payload.type === "mcp-input-request" && typeof payload.serverName === "string" && typeof payload.toolName === "string" && typeof payload.taskId === "string" && typeof payload.createdAt === "string" && isRecord(payload.requests) && Object.values(payload.requests).every((request) => isRecord(request) && typeof request.method === "string");
+}
+/** More questions at once than any real task asks; the server decides these, so Studio bounds them. */
+var MAX_INPUT_REQUESTS = 20;
+var MAX_REQUEST_MESSAGE_LENGTH = 2e3;
+var MAX_INPUT_REQUESTS_SIZE = 65536;
+/** Whether the server sent more than Studio draws: too many questions, a huge message, or huge params. */
+function inputRequestTooLarge(payload) {
+	const requests = Object.values(payload.requests);
+	if (requests.length > 20) return true;
+	if (requests.some((request) => typeof request.params?.message === "string" && request.params.message.length > 2e3)) return true;
+	return JSON.stringify(payload.requests).length > MAX_INPUT_REQUESTS_SIZE;
+}
+/**
+* This call's own suspension. Saved entries are keyed by call id, but a live run keys them by tool
+* name (two calls of one tool share that key), so the entry's own `toolCallId` decides.
+*/
+function findSuspension(metadata, toolCallId) {
+	const suspensions = metadata?.suspendedTools;
+	if (!suspensions) return void 0;
+	return Object.values(suspensions).find((entry) => entry?.toolCallId === toolCallId);
+}
+/** The MCP input request this call is suspended on, if it is. */
+function suspendedMcpInputRequest(metadata, toolCallId) {
+	const payload = findSuspension(metadata, toolCallId)?.suspendPayload;
+	return isMcpInputRequest(payload) ? payload : void 0;
+}
+export { MAX_INPUT_REQUESTS, MAX_INPUT_REQUESTS_SIZE, MAX_REQUEST_MESSAGE_LENGTH, findSuspension, inputRequestTooLarge, isMcpInputRequest, suspendedMcpInputRequest };
+
+//# sourceMappingURL=mcp-input-request.es.js.map

package/dist/domains/chat/tools/mcp-input-request.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-input-request.es.js","names":[],"sources":["../../../../src/domains/chat/tools/mcp-input-request.ts"],"sourcesContent":["import type { MessageMetadata, SuspendedToolMetadata } from '../messages/message-metadata';\nimport { isRecord } from '../messages/signal-data';\n\n/** An embedded request an MCP server sent while its task waits (`{ method, params }`). */\nexport interface McpInputRequest {\n  method: string;\n  params?: Record<string, unknown>;\n}\n\n/** What `@mastra/mcp` suspends a task-backed tool call with (`MCPInputRequestSuspendPayload`). */\nexport interface McpInputRequestPayload {\n  type: 'mcp-input-request';\n  serverName: string;\n  toolName: string;\n  taskId: string;\n  createdAt: string;\n  /** When the call suspended; new each time the same task asks again, unlike `createdAt`. */\n  requestedAt?: string;\n  requests: Record<string, McpInputRequest>;\n}\n\nexport type McpInputAction = 'accept' | 'decline' | 'cancel';\n\nexport interface McpInputResponse {\n  action: McpInputAction;\n  content?: Record<string, unknown>;\n}\n\n/** Resume data answering every request key (`MCPInputRequestResumeData`). */\nexport interface McpInputResumeData {\n  inputResponses: Record<string, McpInputResponse>;\n}\n\nexport function isMcpInputRequest(payload: unknown): payload is McpInputRequestPayload {\n  return (\n    isRecord(payload) &&\n    payload.type === 'mcp-input-request' &&\n    typeof payload.serverName === 'string' &&\n    typeof payload.toolName === 'string' &&\n    typeof payload.taskId === 'string' &&\n    typeof payload.createdAt === 'string' &&\n    isRecord(payload.requests) &&\n    Object.values(payload.requests).every(request => isRecord(request) && typeof request.method === 'string')\n  );\n}\n\n/** More questions at once than any real task asks; the server decides these, so Studio bounds them. */\nexport const MAX_INPUT_REQUESTS = 20;\nexport const MAX_REQUEST_MESSAGE_LENGTH = 2_000;\nexport const MAX_INPUT_REQUESTS_SIZE = 64 * 1024;\n\n/** Whether the server sent more than Studio draws: too many questions, a huge message, or huge params. */\nexport function inputRequestTooLarge(payload: McpInputRequestPayload): boolean {\n  const requests = Object.values(payload.requests);\n  if (requests.length > MAX_INPUT_REQUESTS) return true;\n  if (\n    requests.some(\n      request =>\n        typeof request.params?.message === 'string' && request.params.message.length > MAX_REQUEST_MESSAGE_LENGTH,\n    )\n  ) {\n    return true;\n  }\n  return JSON.stringify(payload.requests).length > MAX_INPUT_REQUESTS_SIZE;\n}\n\n/**\n * This call's own suspension. Saved entries are keyed by call id, but a live run keys them by tool\n * name (two calls of one tool share that key), so the entry's own `toolCallId` decides.\n */\nexport function findSuspension(\n  metadata: MessageMetadata | undefined,\n  toolCallId: string,\n): SuspendedToolMetadata | undefined {\n  const suspensions = metadata?.suspendedTools;\n  if (!suspensions) return undefined;\n  return Object.values(suspensions).find(entry => entry?.toolCallId === toolCallId);\n}\n\n/** The MCP input request this call is suspended on, if it is. */\nexport function suspendedMcpInputRequest(\n  metadata: MessageMetadata | undefined,\n  toolCallId: string,\n): McpInputRequestPayload | undefined {\n  const payload = findSuspension(metadata, toolCallId)?.suspendPayload;\n  return isMcpInputRequest(payload) ? payload : undefined;\n}\n"],"mappings":";;AAiCA,SAAgB,kBAAkB,SAAqD;CACrF,OACE,SAAS,OAAO,KAChB,QAAQ,SAAS,uBACjB,OAAO,QAAQ,eAAe,YAC9B,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,WAAW,YAC1B,OAAO,QAAQ,cAAc,YAC7B,SAAS,QAAQ,QAAQ,KACzB,OAAO,OAAO,QAAQ,QAAQ,CAAC,CAAC,OAAM,YAAW,SAAS,OAAO,KAAK,OAAO,QAAQ,WAAW,QAAQ;AAE5G;;AAGA,IAAa,qBAAqB;AAClC,IAAa,6BAA6B;AAC1C,IAAa,0BAA0B;;AAGvC,SAAgB,qBAAqB,SAA0C;CAC7E,MAAM,WAAW,OAAO,OAAO,QAAQ,QAAQ;CAC/C,IAAI,SAAS,SAAA,IAA6B,OAAO;CACjD,IACE,SAAS,MACP,YACE,OAAO,QAAQ,QAAQ,YAAY,YAAY,QAAQ,OAAO,QAAQ,SAAA,GAC1E,GAEA,OAAO;CAET,OAAO,KAAK,UAAU,QAAQ,QAAQ,CAAC,CAAC,SAAS;AACnD;;;;;AAMA,SAAgB,eACd,UACA,YACmC;CACnC,MAAM,cAAc,UAAU;CAC9B,IAAI,CAAC,aAAa,OAAO,KAAA;CACzB,OAAO,OAAO,OAAO,WAAW,CAAC,CAAC,MAAK,UAAS,OAAO,eAAe,UAAU;AAClF;;AAGA,SAAgB,yBACd,UACA,YACoC;CACpC,MAAM,UAAU,eAAe,UAAU,UAAU,CAAC,EAAE;CACtD,OAAO,kBAAkB,OAAO,IAAI,UAAU,KAAA;AAChD"}

package/dist/domains/chat/tools/tool-card-kind.cjs.js

@@ -1,9 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_tool_presentation = require("../../../tool-presentation-CQlDEwgS.cjs");
+const require_tool_presentation = require("../../../tool-presentation-D6nzVruN.cjs");
 const require_domains_chat_messages_signal_data = require("../messages/signal-data.cjs.js");
 const require_domains_chat_tools_badges_knowledge_tool_badge = require("./badges/knowledge-tool-badge.cjs.js");
 const require_domains_chat_tools_code_mode = require("./code-mode.cjs.js");
 require("./connect-prompt-tool-id.cjs.js");
+const require_domains_chat_tools_mcp_input_request = require("./mcp-input-request.cjs.js");
 require("./submit-plan-tool-id.cjs.js");
 const require_domains_chat_tools_workspace_tool_constants = require("./workspace-tool-constants.cjs.js");
 const require_domains_connect_types = require("../../connect/types.cjs.js");
@@ -18,6 +19,8 @@ var isNetworkFrom = (metadata, from) => metadata?.mode === "network" && metadata
 var isAgentCall = (metadata, toolName) => isNetworkFrom(metadata, "AGENT") || toolName.startsWith("agent-");
 var isWorkflowCall = (metadata, toolName) => isNetworkFrom(metadata, "WORKFLOW") || toolName.startsWith("workflow-");
 var isSettledState = (state) => state === "output-available" || state === "result";
+/** A call running as a Mastra background task. An awaited call's part also names its task, but holds the final result. */
+var isDeferredCall = (backgroundTaskId, backgroundTaskStatus) => backgroundTaskId !== void 0 && backgroundTaskStatus !== "completed" && backgroundTaskStatus !== "failed";
 /** A call neither settled nor carried by a live run reads as idle, so stale history never shimmers. */
 function badgeStatus(state, chatRunning) {
 	if (state === "output-error") return "error";
@@ -39,13 +42,14 @@ function toolInteraction(metadata, toolName, toolCallId) {
 function isHiddenTool(toolName) {
 	return toolName === "updateWorkingMemory" || require_tool_presentation.isTaskTool(toolName);
 }
-function toolCardKind({ toolName, toolCallId, input, output, state }, { metadata, mcpAppTools }) {
+function toolCardKind({ toolName, toolCallId, input, output, state, backgroundTaskId, backgroundTaskStatus }, { metadata, mcpAppTools }) {
 	if (toolName === "mastra-memory-om-observation") return "observation";
 	if (isHiddenTool(toolName)) return "hidden";
 	if (toolName === "ask_user") return "ask_user";
 	if (toolName === "request_connection" && require_domains_connect_types.isConnectPromptPayload(output)) return "connect_prompt";
 	const { suspended } = toolInteraction(metadata, toolName, toolCallId);
 	if (toolName === "submit_plan" || hasSubmitPlanToolId(suspended?.suspendPayload) || hasSubmitPlanToolId(output)) return "submit_plan";
+	if (!isDeferredCall(backgroundTaskId, backgroundTaskStatus) && require_domains_chat_tools_mcp_input_request.suspendedMcpInputRequest(metadata, toolCallId)) return "mcp_input_request";
 	if (typeof output === "string" && output.toLowerCase().includes("background task")) return "background";
 	if (isAgentCall(metadata, toolName)) return "agent";
 	if (isWorkflowCall(metadata, toolName)) return "workflow";
@@ -53,12 +57,13 @@ function toolCardKind({ toolName, toolCallId, input, output, state }, { metadata
 	if (SANDBOX_TOOLS.has(toolName)) return "sandbox";
 	if (codeModeCall(input, output)) return "code_mode";
 	if (mcpAppTools?.[toolName]) return "mcp_app";
-	if (require_domains_chat_tools_badges_knowledge_tool_badge.KNOWLEDGE_TOOLS.has(toolName) && isSettledState(state) && require_domains_chat_tools_badges_knowledge_tool_badge.knowledgeCard(toolName, input, output)) return "knowledge";
+	if (require_domains_chat_tools_badges_knowledge_tool_badge.KNOWLEDGE_TOOLS.has(toolName) && (state === "output-error" || isSettledState(state) && require_domains_chat_tools_badges_knowledge_tool_badge.knowledgeCard(toolName, input, output))) return "knowledge";
 	return "plain";
 }
 exports.badgeStatus = badgeStatus;
 exports.codeModeCall = codeModeCall;
 exports.isAgentCall = isAgentCall;
+exports.isDeferredCall = isDeferredCall;
 exports.isHiddenTool = isHiddenTool;
 exports.isSettledState = isSettledState;
 exports.isWorkflowCall = isWorkflowCall;

package/dist/domains/chat/tools/tool-card-kind.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-card-kind.cjs.js","names":["WORKSPACE_TOOLS","isRecord","getCodeModeCall","isTaskTool","isConnectPromptPayload","KNOWLEDGE_TOOLS","knowledgeCard"],"sources":["../../../../src/domains/chat/tools/tool-card-kind.ts"],"sourcesContent":["import type { MessageMetadata, SuspendedToolMetadata, ToolApprovalMetadata } from '../messages/message-metadata';\nimport type { ToolPartFields } from '../messages/renderers/tool-part';\nimport { isRecord } from '../messages/signal-data';\nimport { KNOWLEDGE_TOOLS, knowledgeCard } from './badges/knowledge-tool-badge';\nimport { getCodeModeCall } from './code-mode';\nimport { CONNECT_PROMPT_TOOL_NAME } from './connect-prompt-tool-id';\nimport { SUBMIT_PLAN_TOOL_ID } from './submit-plan-tool-id';\nimport { WORKSPACE_TOOLS } from './workspace-tool-constants';\nimport { isConnectPromptPayload } from '@/domains/connect/types';\nimport type { ActivityStatus } from '@/ds/components/ai/activity';\nimport { isTaskTool } from '@/ds/components/ai/tool-call';\n\n/** Which card draws a call. Decided once, shared by the dispatcher and the fold. */\nexport type ToolCardKind =\n  | 'hidden'\n  | 'observation'\n  | 'ask_user'\n  | 'connect_prompt'\n  | 'submit_plan'\n  | 'background'\n  | 'agent'\n  | 'workflow'\n  | 'file_tree'\n  | 'sandbox'\n  | 'code_mode'\n  | 'mcp_app'\n  | 'knowledge'\n  | 'plain';\n\nexport interface ToolCardContext {\n  metadata?: MessageMetadata;\n  mcpAppTools?: Record<string, unknown>;\n}\n\nexport interface ToolInteraction {\n  approval?: ToolApprovalMetadata;\n  suspended?: SuspendedToolMetadata;\n}\n\nconst SANDBOX_TOOLS = new Set<string>([\n  WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND,\n  WORKSPACE_TOOLS.SANDBOX.GET_PROCESS_OUTPUT,\n  WORKSPACE_TOOLS.SANDBOX.KILL_PROCESS,\n]);\n\nconst hasSubmitPlanToolId = (value: unknown): boolean => isRecord(value) && value.toolId === SUBMIT_PLAN_TOOL_ID;\n\nconst isNetworkFrom = (metadata: MessageMetadata | undefined, from: string): boolean =>\n  metadata?.mode === 'network' && metadata.from === from;\n\nexport const isAgentCall = (metadata: MessageMetadata | undefined, toolName: string): boolean =>\n  isNetworkFrom(metadata, 'AGENT') || toolName.startsWith('agent-');\n\nexport const isWorkflowCall = (metadata: MessageMetadata | undefined, toolName: string): boolean =>\n  isNetworkFrom(metadata, 'WORKFLOW') || toolName.startsWith('workflow-');\n\nexport const isSettledState = (state: string | undefined): boolean =>\n  state === 'output-available' || state === 'result';\n\n/** A call neither settled nor carried by a live run reads as idle, so stale history never shimmers. */\nexport function badgeStatus(state: string | undefined, chatRunning: boolean): ActivityStatus {\n  if (state === 'output-error') return 'error';\n  if (isSettledState(state) || !chatRunning) return 'idle';\n  return 'running';\n}\n\nexport const codeModeCall = (input: unknown, output: unknown) =>\n  isRecord(input) || typeof input === 'string' ? getCodeModeCall(input, output) : null;\n\n/** Approval and suspension land keyed by tool name on older runs and by call id on newer ones. */\nexport function toolInteraction(\n  metadata: MessageMetadata | undefined,\n  toolName: string,\n  toolCallId: string,\n): ToolInteraction {\n  const approvals = metadata?.requireApprovalMetadata;\n  const suspensions = metadata?.suspendedTools;\n  const namedApproval = approvals?.[toolName];\n  return {\n    approval:\n      metadata?.mode === 'network'\n        ? namedApproval?.toolCallId === toolCallId\n          ? namedApproval\n          : approvals?.[toolCallId]\n        : (approvals?.[toolCallId] ??\n          Object.values(approvals ?? {}).find(approval => approval.toolCallId === toolCallId)),\n    suspended: suspensions?.[toolName] ?? suspensions?.[toolCallId],\n  };\n}\n\n/** Tools the transcript never draws: working memory updates and task tools (shown in the docked task list). */\nexport function isHiddenTool(toolName: string): boolean {\n  return toolName === 'updateWorkingMemory' || isTaskTool(toolName);\n}\n\nexport function toolCardKind(\n  { toolName, toolCallId, input, output, state }: ToolPartFields,\n  { metadata, mcpAppTools }: ToolCardContext,\n): ToolCardKind {\n  if (toolName === 'mastra-memory-om-observation') return 'observation';\n  if (isHiddenTool(toolName)) return 'hidden';\n  // A question read back in history draws as a plain badge, but it is still a question: never folded away.\n  if (toolName === 'ask_user') return 'ask_user';\n  // Built-in `request_connection` tool from `@mastra/connect`: a settled call renders\n  // as an interactive connect card; while running it falls back to a plain badge.\n  if (toolName === CONNECT_PROMPT_TOOL_NAME && isConnectPromptPayload(output)) return 'connect_prompt';\n  const { suspended } = toolInteraction(metadata, toolName, toolCallId);\n  if (\n    toolName === SUBMIT_PLAN_TOOL_ID ||\n    hasSubmitPlanToolId(suspended?.suspendPayload) ||\n    hasSubmitPlanToolId(output)\n  ) {\n    return 'submit_plan';\n  }\n  if (typeof output === 'string' && output.toLowerCase().includes('background task')) return 'background';\n  if (isAgentCall(metadata, toolName)) return 'agent';\n  if (isWorkflowCall(metadata, toolName)) return 'workflow';\n  if (toolName === WORKSPACE_TOOLS.FILESYSTEM.LIST_FILES) return 'file_tree';\n  if (SANDBOX_TOOLS.has(toolName)) return 'sandbox';\n  if (codeModeCall(input, output)) return 'code_mode';\n  if (mcpAppTools?.[toolName]) return 'mcp_app';\n  // A settled Knowledge result draws as a readable card; while running or failed it stays a plain badge.\n  if (KNOWLEDGE_TOOLS.has(toolName) && isSettledState(state) && knowledgeCard(toolName, input, output)) {\n    return 'knowledge';\n  }\n  return 'plain';\n}\n"],"mappings":";;;;;;;;;;AAuCA,IAAM,gCAAgB,IAAI,IAAY;CACpCA,oDAAAA,gBAAgB,QAAQ;CACxBA,oDAAAA,gBAAgB,QAAQ;CACxBA,oDAAAA,gBAAgB,QAAQ;AAC1B,CAAC;AAED,IAAM,uBAAuB,UAA4BC,0CAAAA,SAAS,KAAK,KAAK,MAAM,WAAA;AAElF,IAAM,iBAAiB,UAAuC,SAC5D,UAAU,SAAS,aAAa,SAAS,SAAS;AAEpD,IAAa,eAAe,UAAuC,aACjE,cAAc,UAAU,OAAO,KAAK,SAAS,WAAW,QAAQ;AAElE,IAAa,kBAAkB,UAAuC,aACpE,cAAc,UAAU,UAAU,KAAK,SAAS,WAAW,WAAW;AAExE,IAAa,kBAAkB,UAC7B,UAAU,sBAAsB,UAAU;;AAG5C,SAAgB,YAAY,OAA2B,aAAsC;CAC3F,IAAI,UAAU,gBAAgB,OAAO;CACrC,IAAI,eAAe,KAAK,KAAK,CAAC,aAAa,OAAO;CAClD,OAAO;AACT;AAEA,IAAa,gBAAgB,OAAgB,WAC3CA,0CAAAA,SAAS,KAAK,KAAK,OAAO,UAAU,WAAWC,qCAAAA,gBAAgB,OAAO,MAAM,IAAI;;AAGlF,SAAgB,gBACd,UACA,UACA,YACiB;CACjB,MAAM,YAAY,UAAU;CAC5B,MAAM,cAAc,UAAU;CAC9B,MAAM,gBAAgB,YAAY;CAClC,OAAO;EACL,UACE,UAAU,SAAS,YACf,eAAe,eAAe,aAC5B,gBACA,YAAY,cACb,YAAY,eACb,OAAO,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,MAAK,aAAY,SAAS,eAAe,UAAU;EACxF,WAAW,cAAc,aAAa,cAAc;CACtD;AACF;;AAGA,SAAgB,aAAa,UAA2B;CACtD,OAAO,aAAa,yBAAyBC,0BAAAA,WAAW,QAAQ;AAClE;AAEA,SAAgB,aACd,EAAE,UAAU,YAAY,OAAO,QAAQ,SACvC,EAAE,UAAU,eACE;CACd,IAAI,aAAa,gCAAgC,OAAO;CACxD,IAAI,aAAa,QAAQ,GAAG,OAAO;CAEnC,IAAI,aAAa,YAAY,OAAO;CAGpC,IAAI,aAAA,wBAAyCC,8BAAAA,uBAAuB,MAAM,GAAG,OAAO;CACpF,MAAM,EAAE,cAAc,gBAAgB,UAAU,UAAU,UAAU;CACpE,IACE,aAAA,iBACA,oBAAoB,WAAW,cAAc,KAC7C,oBAAoB,MAAM,GAE1B,OAAO;CAET,IAAI,OAAO,WAAW,YAAY,OAAO,YAAY,CAAC,CAAC,SAAS,iBAAiB,GAAG,OAAO;CAC3F,IAAI,YAAY,UAAU,QAAQ,GAAG,OAAO;CAC5C,IAAI,eAAe,UAAU,QAAQ,GAAG,OAAO;CAC/C,IAAI,aAAaJ,oDAAAA,gBAAgB,WAAW,YAAY,OAAO;CAC/D,IAAI,cAAc,IAAI,QAAQ,GAAG,OAAO;CACxC,IAAI,aAAa,OAAO,MAAM,GAAG,OAAO;CACxC,IAAI,cAAc,WAAW,OAAO;CAEpC,IAAIK,uDAAAA,gBAAgB,IAAI,QAAQ,KAAK,eAAe,KAAK,KAAKC,uDAAAA,cAAc,UAAU,OAAO,MAAM,GACjG,OAAO;CAET,OAAO;AACT"}
+{"version":3,"file":"tool-card-kind.cjs.js","names":["WORKSPACE_TOOLS","isRecord","getCodeModeCall","isTaskTool","isConnectPromptPayload","suspendedMcpInputRequest","KNOWLEDGE_TOOLS","knowledgeCard"],"sources":["../../../../src/domains/chat/tools/tool-card-kind.ts"],"sourcesContent":["import type { MessageMetadata, SuspendedToolMetadata, ToolApprovalMetadata } from '../messages/message-metadata';\nimport type { ToolPartFields } from '../messages/renderers/tool-part';\nimport { isRecord } from '../messages/signal-data';\nimport { KNOWLEDGE_TOOLS, knowledgeCard } from './badges/knowledge-tool-badge';\nimport { getCodeModeCall } from './code-mode';\nimport { CONNECT_PROMPT_TOOL_NAME } from './connect-prompt-tool-id';\nimport { suspendedMcpInputRequest } from './mcp-input-request';\nimport { SUBMIT_PLAN_TOOL_ID } from './submit-plan-tool-id';\nimport { WORKSPACE_TOOLS } from './workspace-tool-constants';\nimport { isConnectPromptPayload } from '@/domains/connect/types';\nimport type { ActivityStatus } from '@/ds/components/ai/activity';\nimport { isTaskTool } from '@/ds/components/ai/tool-call';\n\n/** Which card draws a call. Decided once, shared by the dispatcher and the fold. */\nexport type ToolCardKind =\n  | 'hidden'\n  | 'observation'\n  | 'ask_user'\n  | 'connect_prompt'\n  | 'submit_plan'\n  | 'mcp_input_request'\n  | 'background'\n  | 'agent'\n  | 'workflow'\n  | 'file_tree'\n  | 'sandbox'\n  | 'code_mode'\n  | 'mcp_app'\n  | 'knowledge'\n  | 'plain';\n\nexport interface ToolCardContext {\n  metadata?: MessageMetadata;\n  mcpAppTools?: Record<string, unknown>;\n}\n\nexport interface ToolInteraction {\n  approval?: ToolApprovalMetadata;\n  suspended?: SuspendedToolMetadata;\n}\n\nconst SANDBOX_TOOLS = new Set<string>([\n  WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND,\n  WORKSPACE_TOOLS.SANDBOX.GET_PROCESS_OUTPUT,\n  WORKSPACE_TOOLS.SANDBOX.KILL_PROCESS,\n]);\n\nconst hasSubmitPlanToolId = (value: unknown): boolean => isRecord(value) && value.toolId === SUBMIT_PLAN_TOOL_ID;\n\nconst isNetworkFrom = (metadata: MessageMetadata | undefined, from: string): boolean =>\n  metadata?.mode === 'network' && metadata.from === from;\n\nexport const isAgentCall = (metadata: MessageMetadata | undefined, toolName: string): boolean =>\n  isNetworkFrom(metadata, 'AGENT') || toolName.startsWith('agent-');\n\nexport const isWorkflowCall = (metadata: MessageMetadata | undefined, toolName: string): boolean =>\n  isNetworkFrom(metadata, 'WORKFLOW') || toolName.startsWith('workflow-');\n\nexport const isSettledState = (state: string | undefined): boolean =>\n  state === 'output-available' || state === 'result';\n\n/** A call running as a Mastra background task. An awaited call's part also names its task, but holds the final result. */\nexport const isDeferredCall = (backgroundTaskId: string | undefined, backgroundTaskStatus: string | undefined) =>\n  backgroundTaskId !== undefined && backgroundTaskStatus !== 'completed' && backgroundTaskStatus !== 'failed';\n\n/** A call neither settled nor carried by a live run reads as idle, so stale history never shimmers. */\nexport function badgeStatus(state: string | undefined, chatRunning: boolean): ActivityStatus {\n  if (state === 'output-error') return 'error';\n  if (isSettledState(state) || !chatRunning) return 'idle';\n  return 'running';\n}\n\nexport const codeModeCall = (input: unknown, output: unknown) =>\n  isRecord(input) || typeof input === 'string' ? getCodeModeCall(input, output) : null;\n\n/** Approval and suspension land keyed by tool name on older runs and by call id on newer ones. */\nexport function toolInteraction(\n  metadata: MessageMetadata | undefined,\n  toolName: string,\n  toolCallId: string,\n): ToolInteraction {\n  const approvals = metadata?.requireApprovalMetadata;\n  const suspensions = metadata?.suspendedTools;\n  const namedApproval = approvals?.[toolName];\n  return {\n    approval:\n      metadata?.mode === 'network'\n        ? namedApproval?.toolCallId === toolCallId\n          ? namedApproval\n          : approvals?.[toolCallId]\n        : (approvals?.[toolCallId] ??\n          Object.values(approvals ?? {}).find(approval => approval.toolCallId === toolCallId)),\n    suspended: suspensions?.[toolName] ?? suspensions?.[toolCallId],\n  };\n}\n\n/** Tools the transcript never draws: working memory updates and task tools (shown in the docked task list). */\nexport function isHiddenTool(toolName: string): boolean {\n  return toolName === 'updateWorkingMemory' || isTaskTool(toolName);\n}\n\nexport function toolCardKind(\n  { toolName, toolCallId, input, output, state, backgroundTaskId, backgroundTaskStatus }: ToolPartFields,\n  { metadata, mcpAppTools }: ToolCardContext,\n): ToolCardKind {\n  if (toolName === 'mastra-memory-om-observation') return 'observation';\n  if (isHiddenTool(toolName)) return 'hidden';\n  // A question read back in history draws as a plain badge, but it is still a question: never folded away.\n  if (toolName === 'ask_user') return 'ask_user';\n  // Built-in `request_connection` tool from `@mastra/connect`: a settled call renders\n  // as an interactive connect card; while running it falls back to a plain badge.\n  if (toolName === CONNECT_PROMPT_TOOL_NAME && isConnectPromptPayload(output)) return 'connect_prompt';\n  const { suspended } = toolInteraction(metadata, toolName, toolCallId);\n  if (\n    toolName === SUBMIT_PLAN_TOOL_ID ||\n    hasSubmitPlanToolId(suspended?.suspendPayload) ||\n    hasSubmitPlanToolId(output)\n  ) {\n    return 'submit_plan';\n  }\n  // A foreground call parked on an MCP task's question: the run waits for the answer. A deferred\n  // call's question lives on its background task instead, which the background card reads.\n  if (!isDeferredCall(backgroundTaskId, backgroundTaskStatus) && suspendedMcpInputRequest(metadata, toolCallId)) {\n    return 'mcp_input_request';\n  }\n  if (typeof output === 'string' && output.toLowerCase().includes('background task')) return 'background';\n  if (isAgentCall(metadata, toolName)) return 'agent';\n  if (isWorkflowCall(metadata, toolName)) return 'workflow';\n  if (toolName === WORKSPACE_TOOLS.FILESYSTEM.LIST_FILES) return 'file_tree';\n  if (SANDBOX_TOOLS.has(toolName)) return 'sandbox';\n  if (codeModeCall(input, output)) return 'code_mode';\n  if (mcpAppTools?.[toolName]) return 'mcp_app';\n  // A settled or failed Knowledge call draws as a readable card; while running it stays a plain badge.\n  if (\n    KNOWLEDGE_TOOLS.has(toolName) &&\n    (state === 'output-error' || (isSettledState(state) && knowledgeCard(toolName, input, output)))\n  ) {\n    return 'knowledge';\n  }\n  return 'plain';\n}\n"],"mappings":";;;;;;;;;;;AAyCA,IAAM,gCAAgB,IAAI,IAAY;CACpCA,oDAAAA,gBAAgB,QAAQ;CACxBA,oDAAAA,gBAAgB,QAAQ;CACxBA,oDAAAA,gBAAgB,QAAQ;AAC1B,CAAC;AAED,IAAM,uBAAuB,UAA4BC,0CAAAA,SAAS,KAAK,KAAK,MAAM,WAAA;AAElF,IAAM,iBAAiB,UAAuC,SAC5D,UAAU,SAAS,aAAa,SAAS,SAAS;AAEpD,IAAa,eAAe,UAAuC,aACjE,cAAc,UAAU,OAAO,KAAK,SAAS,WAAW,QAAQ;AAElE,IAAa,kBAAkB,UAAuC,aACpE,cAAc,UAAU,UAAU,KAAK,SAAS,WAAW,WAAW;AAExE,IAAa,kBAAkB,UAC7B,UAAU,sBAAsB,UAAU;;AAG5C,IAAa,kBAAkB,kBAAsC,yBACnE,qBAAqB,KAAA,KAAa,yBAAyB,eAAe,yBAAyB;;AAGrG,SAAgB,YAAY,OAA2B,aAAsC;CAC3F,IAAI,UAAU,gBAAgB,OAAO;CACrC,IAAI,eAAe,KAAK,KAAK,CAAC,aAAa,OAAO;CAClD,OAAO;AACT;AAEA,IAAa,gBAAgB,OAAgB,WAC3CA,0CAAAA,SAAS,KAAK,KAAK,OAAO,UAAU,WAAWC,qCAAAA,gBAAgB,OAAO,MAAM,IAAI;;AAGlF,SAAgB,gBACd,UACA,UACA,YACiB;CACjB,MAAM,YAAY,UAAU;CAC5B,MAAM,cAAc,UAAU;CAC9B,MAAM,gBAAgB,YAAY;CAClC,OAAO;EACL,UACE,UAAU,SAAS,YACf,eAAe,eAAe,aAC5B,gBACA,YAAY,cACb,YAAY,eACb,OAAO,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,MAAK,aAAY,SAAS,eAAe,UAAU;EACxF,WAAW,cAAc,aAAa,cAAc;CACtD;AACF;;AAGA,SAAgB,aAAa,UAA2B;CACtD,OAAO,aAAa,yBAAyBC,0BAAAA,WAAW,QAAQ;AAClE;AAEA,SAAgB,aACd,EAAE,UAAU,YAAY,OAAO,QAAQ,OAAO,kBAAkB,wBAChE,EAAE,UAAU,eACE;CACd,IAAI,aAAa,gCAAgC,OAAO;CACxD,IAAI,aAAa,QAAQ,GAAG,OAAO;CAEnC,IAAI,aAAa,YAAY,OAAO;CAGpC,IAAI,aAAA,wBAAyCC,8BAAAA,uBAAuB,MAAM,GAAG,OAAO;CACpF,MAAM,EAAE,cAAc,gBAAgB,UAAU,UAAU,UAAU;CACpE,IACE,aAAA,iBACA,oBAAoB,WAAW,cAAc,KAC7C,oBAAoB,MAAM,GAE1B,OAAO;CAIT,IAAI,CAAC,eAAe,kBAAkB,oBAAoB,KAAKC,6CAAAA,yBAAyB,UAAU,UAAU,GAC1G,OAAO;CAET,IAAI,OAAO,WAAW,YAAY,OAAO,YAAY,CAAC,CAAC,SAAS,iBAAiB,GAAG,OAAO;CAC3F,IAAI,YAAY,UAAU,QAAQ,GAAG,OAAO;CAC5C,IAAI,eAAe,UAAU,QAAQ,GAAG,OAAO;CAC/C,IAAI,aAAaL,oDAAAA,gBAAgB,WAAW,YAAY,OAAO;CAC/D,IAAI,cAAc,IAAI,QAAQ,GAAG,OAAO;CACxC,IAAI,aAAa,OAAO,MAAM,GAAG,OAAO;CACxC,IAAI,cAAc,WAAW,OAAO;CAEpC,IACEM,uDAAAA,gBAAgB,IAAI,QAAQ,MAC3B,UAAU,kBAAmB,eAAe,KAAK,KAAKC,uDAAAA,cAAc,UAAU,OAAO,MAAM,IAE5F,OAAO;CAET,OAAO;AACT"}

package/dist/domains/chat/tools/tool-card-kind.es.js

@@ -1,8 +1,9 @@
-import { n as isTaskTool } from "../../../tool-presentation-DvCsb_kz.js";
+import { n as isTaskTool } from "../../../tool-presentation-CvibOP1J.js";
 import { isRecord } from "../messages/signal-data.es.js";
 import { KNOWLEDGE_TOOLS, knowledgeCard } from "./badges/knowledge-tool-badge.es.js";
 import { getCodeModeCall } from "./code-mode.es.js";
 import "./connect-prompt-tool-id.es.js";
+import { suspendedMcpInputRequest } from "./mcp-input-request.es.js";
 import "./submit-plan-tool-id.es.js";
 import { WORKSPACE_TOOLS } from "./workspace-tool-constants.es.js";
 import { isConnectPromptPayload } from "../../connect/types.es.js";
@@ -17,6 +18,8 @@ var isNetworkFrom = (metadata, from) => metadata?.mode === "network" && metadata
 var isAgentCall = (metadata, toolName) => isNetworkFrom(metadata, "AGENT") || toolName.startsWith("agent-");
 var isWorkflowCall = (metadata, toolName) => isNetworkFrom(metadata, "WORKFLOW") || toolName.startsWith("workflow-");
 var isSettledState = (state) => state === "output-available" || state === "result";
+/** A call running as a Mastra background task. An awaited call's part also names its task, but holds the final result. */
+var isDeferredCall = (backgroundTaskId, backgroundTaskStatus) => backgroundTaskId !== void 0 && backgroundTaskStatus !== "completed" && backgroundTaskStatus !== "failed";
 /** A call neither settled nor carried by a live run reads as idle, so stale history never shimmers. */
 function badgeStatus(state, chatRunning) {
 	if (state === "output-error") return "error";
@@ -38,13 +41,14 @@ function toolInteraction(metadata, toolName, toolCallId) {
 function isHiddenTool(toolName) {
 	return toolName === "updateWorkingMemory" || isTaskTool(toolName);
 }
-function toolCardKind({ toolName, toolCallId, input, output, state }, { metadata, mcpAppTools }) {
+function toolCardKind({ toolName, toolCallId, input, output, state, backgroundTaskId, backgroundTaskStatus }, { metadata, mcpAppTools }) {
 	if (toolName === "mastra-memory-om-observation") return "observation";
 	if (isHiddenTool(toolName)) return "hidden";
 	if (toolName === "ask_user") return "ask_user";
 	if (toolName === "request_connection" && isConnectPromptPayload(output)) return "connect_prompt";
 	const { suspended } = toolInteraction(metadata, toolName, toolCallId);
 	if (toolName === "submit_plan" || hasSubmitPlanToolId(suspended?.suspendPayload) || hasSubmitPlanToolId(output)) return "submit_plan";
+	if (!isDeferredCall(backgroundTaskId, backgroundTaskStatus) && suspendedMcpInputRequest(metadata, toolCallId)) return "mcp_input_request";
 	if (typeof output === "string" && output.toLowerCase().includes("background task")) return "background";
 	if (isAgentCall(metadata, toolName)) return "agent";
 	if (isWorkflowCall(metadata, toolName)) return "workflow";
@@ -52,9 +56,9 @@ function toolCardKind({ toolName, toolCallId, input, output, state }, { metadata
 	if (SANDBOX_TOOLS.has(toolName)) return "sandbox";
 	if (codeModeCall(input, output)) return "code_mode";
 	if (mcpAppTools?.[toolName]) return "mcp_app";
-	if (KNOWLEDGE_TOOLS.has(toolName) && isSettledState(state) && knowledgeCard(toolName, input, output)) return "knowledge";
+	if (KNOWLEDGE_TOOLS.has(toolName) && (state === "output-error" || isSettledState(state) && knowledgeCard(toolName, input, output))) return "knowledge";
 	return "plain";
 }
-export { badgeStatus, codeModeCall, isAgentCall, isHiddenTool, isSettledState, isWorkflowCall, toolCardKind, toolInteraction };
+export { badgeStatus, codeModeCall, isAgentCall, isDeferredCall, isHiddenTool, isSettledState, isWorkflowCall, toolCardKind, toolInteraction };
 
 //# sourceMappingURL=tool-card-kind.es.js.map

package/dist/domains/chat/tools/tool-card-kind.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-card-kind.es.js","names":[],"sources":["../../../../src/domains/chat/tools/tool-card-kind.ts"],"sourcesContent":["import type { MessageMetadata, SuspendedToolMetadata, ToolApprovalMetadata } from '../messages/message-metadata';\nimport type { ToolPartFields } from '../messages/renderers/tool-part';\nimport { isRecord } from '../messages/signal-data';\nimport { KNOWLEDGE_TOOLS, knowledgeCard } from './badges/knowledge-tool-badge';\nimport { getCodeModeCall } from './code-mode';\nimport { CONNECT_PROMPT_TOOL_NAME } from './connect-prompt-tool-id';\nimport { SUBMIT_PLAN_TOOL_ID } from './submit-plan-tool-id';\nimport { WORKSPACE_TOOLS } from './workspace-tool-constants';\nimport { isConnectPromptPayload } from '@/domains/connect/types';\nimport type { ActivityStatus } from '@/ds/components/ai/activity';\nimport { isTaskTool } from '@/ds/components/ai/tool-call';\n\n/** Which card draws a call. Decided once, shared by the dispatcher and the fold. */\nexport type ToolCardKind =\n  | 'hidden'\n  | 'observation'\n  | 'ask_user'\n  | 'connect_prompt'\n  | 'submit_plan'\n  | 'background'\n  | 'agent'\n  | 'workflow'\n  | 'file_tree'\n  | 'sandbox'\n  | 'code_mode'\n  | 'mcp_app'\n  | 'knowledge'\n  | 'plain';\n\nexport interface ToolCardContext {\n  metadata?: MessageMetadata;\n  mcpAppTools?: Record<string, unknown>;\n}\n\nexport interface ToolInteraction {\n  approval?: ToolApprovalMetadata;\n  suspended?: SuspendedToolMetadata;\n}\n\nconst SANDBOX_TOOLS = new Set<string>([\n  WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND,\n  WORKSPACE_TOOLS.SANDBOX.GET_PROCESS_OUTPUT,\n  WORKSPACE_TOOLS.SANDBOX.KILL_PROCESS,\n]);\n\nconst hasSubmitPlanToolId = (value: unknown): boolean => isRecord(value) && value.toolId === SUBMIT_PLAN_TOOL_ID;\n\nconst isNetworkFrom = (metadata: MessageMetadata | undefined, from: string): boolean =>\n  metadata?.mode === 'network' && metadata.from === from;\n\nexport const isAgentCall = (metadata: MessageMetadata | undefined, toolName: string): boolean =>\n  isNetworkFrom(metadata, 'AGENT') || toolName.startsWith('agent-');\n\nexport const isWorkflowCall = (metadata: MessageMetadata | undefined, toolName: string): boolean =>\n  isNetworkFrom(metadata, 'WORKFLOW') || toolName.startsWith('workflow-');\n\nexport const isSettledState = (state: string | undefined): boolean =>\n  state === 'output-available' || state === 'result';\n\n/** A call neither settled nor carried by a live run reads as idle, so stale history never shimmers. */\nexport function badgeStatus(state: string | undefined, chatRunning: boolean): ActivityStatus {\n  if (state === 'output-error') return 'error';\n  if (isSettledState(state) || !chatRunning) return 'idle';\n  return 'running';\n}\n\nexport const codeModeCall = (input: unknown, output: unknown) =>\n  isRecord(input) || typeof input === 'string' ? getCodeModeCall(input, output) : null;\n\n/** Approval and suspension land keyed by tool name on older runs and by call id on newer ones. */\nexport function toolInteraction(\n  metadata: MessageMetadata | undefined,\n  toolName: string,\n  toolCallId: string,\n): ToolInteraction {\n  const approvals = metadata?.requireApprovalMetadata;\n  const suspensions = metadata?.suspendedTools;\n  const namedApproval = approvals?.[toolName];\n  return {\n    approval:\n      metadata?.mode === 'network'\n        ? namedApproval?.toolCallId === toolCallId\n          ? namedApproval\n          : approvals?.[toolCallId]\n        : (approvals?.[toolCallId] ??\n          Object.values(approvals ?? {}).find(approval => approval.toolCallId === toolCallId)),\n    suspended: suspensions?.[toolName] ?? suspensions?.[toolCallId],\n  };\n}\n\n/** Tools the transcript never draws: working memory updates and task tools (shown in the docked task list). */\nexport function isHiddenTool(toolName: string): boolean {\n  return toolName === 'updateWorkingMemory' || isTaskTool(toolName);\n}\n\nexport function toolCardKind(\n  { toolName, toolCallId, input, output, state }: ToolPartFields,\n  { metadata, mcpAppTools }: ToolCardContext,\n): ToolCardKind {\n  if (toolName === 'mastra-memory-om-observation') return 'observation';\n  if (isHiddenTool(toolName)) return 'hidden';\n  // A question read back in history draws as a plain badge, but it is still a question: never folded away.\n  if (toolName === 'ask_user') return 'ask_user';\n  // Built-in `request_connection` tool from `@mastra/connect`: a settled call renders\n  // as an interactive connect card; while running it falls back to a plain badge.\n  if (toolName === CONNECT_PROMPT_TOOL_NAME && isConnectPromptPayload(output)) return 'connect_prompt';\n  const { suspended } = toolInteraction(metadata, toolName, toolCallId);\n  if (\n    toolName === SUBMIT_PLAN_TOOL_ID ||\n    hasSubmitPlanToolId(suspended?.suspendPayload) ||\n    hasSubmitPlanToolId(output)\n  ) {\n    return 'submit_plan';\n  }\n  if (typeof output === 'string' && output.toLowerCase().includes('background task')) return 'background';\n  if (isAgentCall(metadata, toolName)) return 'agent';\n  if (isWorkflowCall(metadata, toolName)) return 'workflow';\n  if (toolName === WORKSPACE_TOOLS.FILESYSTEM.LIST_FILES) return 'file_tree';\n  if (SANDBOX_TOOLS.has(toolName)) return 'sandbox';\n  if (codeModeCall(input, output)) return 'code_mode';\n  if (mcpAppTools?.[toolName]) return 'mcp_app';\n  // A settled Knowledge result draws as a readable card; while running or failed it stays a plain badge.\n  if (KNOWLEDGE_TOOLS.has(toolName) && isSettledState(state) && knowledgeCard(toolName, input, output)) {\n    return 'knowledge';\n  }\n  return 'plain';\n}\n"],"mappings":";;;;;;;;;AAuCA,IAAM,gCAAgB,IAAI,IAAY;CACpC,gBAAgB,QAAQ;CACxB,gBAAgB,QAAQ;CACxB,gBAAgB,QAAQ;AAC1B,CAAC;AAED,IAAM,uBAAuB,UAA4B,SAAS,KAAK,KAAK,MAAM,WAAA;AAElF,IAAM,iBAAiB,UAAuC,SAC5D,UAAU,SAAS,aAAa,SAAS,SAAS;AAEpD,IAAa,eAAe,UAAuC,aACjE,cAAc,UAAU,OAAO,KAAK,SAAS,WAAW,QAAQ;AAElE,IAAa,kBAAkB,UAAuC,aACpE,cAAc,UAAU,UAAU,KAAK,SAAS,WAAW,WAAW;AAExE,IAAa,kBAAkB,UAC7B,UAAU,sBAAsB,UAAU;;AAG5C,SAAgB,YAAY,OAA2B,aAAsC;CAC3F,IAAI,UAAU,gBAAgB,OAAO;CACrC,IAAI,eAAe,KAAK,KAAK,CAAC,aAAa,OAAO;CAClD,OAAO;AACT;AAEA,IAAa,gBAAgB,OAAgB,WAC3C,SAAS,KAAK,KAAK,OAAO,UAAU,WAAW,gBAAgB,OAAO,MAAM,IAAI;;AAGlF,SAAgB,gBACd,UACA,UACA,YACiB;CACjB,MAAM,YAAY,UAAU;CAC5B,MAAM,cAAc,UAAU;CAC9B,MAAM,gBAAgB,YAAY;CAClC,OAAO;EACL,UACE,UAAU,SAAS,YACf,eAAe,eAAe,aAC5B,gBACA,YAAY,cACb,YAAY,eACb,OAAO,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,MAAK,aAAY,SAAS,eAAe,UAAU;EACxF,WAAW,cAAc,aAAa,cAAc;CACtD;AACF;;AAGA,SAAgB,aAAa,UAA2B;CACtD,OAAO,aAAa,yBAAyB,WAAW,QAAQ;AAClE;AAEA,SAAgB,aACd,EAAE,UAAU,YAAY,OAAO,QAAQ,SACvC,EAAE,UAAU,eACE;CACd,IAAI,aAAa,gCAAgC,OAAO;CACxD,IAAI,aAAa,QAAQ,GAAG,OAAO;CAEnC,IAAI,aAAa,YAAY,OAAO;CAGpC,IAAI,aAAA,wBAAyC,uBAAuB,MAAM,GAAG,OAAO;CACpF,MAAM,EAAE,cAAc,gBAAgB,UAAU,UAAU,UAAU;CACpE,IACE,aAAA,iBACA,oBAAoB,WAAW,cAAc,KAC7C,oBAAoB,MAAM,GAE1B,OAAO;CAET,IAAI,OAAO,WAAW,YAAY,OAAO,YAAY,CAAC,CAAC,SAAS,iBAAiB,GAAG,OAAO;CAC3F,IAAI,YAAY,UAAU,QAAQ,GAAG,OAAO;CAC5C,IAAI,eAAe,UAAU,QAAQ,GAAG,OAAO;CAC/C,IAAI,aAAa,gBAAgB,WAAW,YAAY,OAAO;CAC/D,IAAI,cAAc,IAAI,QAAQ,GAAG,OAAO;CACxC,IAAI,aAAa,OAAO,MAAM,GAAG,OAAO;CACxC,IAAI,cAAc,WAAW,OAAO;CAEpC,IAAI,gBAAgB,IAAI,QAAQ,KAAK,eAAe,KAAK,KAAK,cAAc,UAAU,OAAO,MAAM,GACjG,OAAO;CAET,OAAO;AACT"}
+{"version":3,"file":"tool-card-kind.es.js","names":[],"sources":["../../../../src/domains/chat/tools/tool-card-kind.ts"],"sourcesContent":["import type { MessageMetadata, SuspendedToolMetadata, ToolApprovalMetadata } from '../messages/message-metadata';\nimport type { ToolPartFields } from '../messages/renderers/tool-part';\nimport { isRecord } from '../messages/signal-data';\nimport { KNOWLEDGE_TOOLS, knowledgeCard } from './badges/knowledge-tool-badge';\nimport { getCodeModeCall } from './code-mode';\nimport { CONNECT_PROMPT_TOOL_NAME } from './connect-prompt-tool-id';\nimport { suspendedMcpInputRequest } from './mcp-input-request';\nimport { SUBMIT_PLAN_TOOL_ID } from './submit-plan-tool-id';\nimport { WORKSPACE_TOOLS } from './workspace-tool-constants';\nimport { isConnectPromptPayload } from '@/domains/connect/types';\nimport type { ActivityStatus } from '@/ds/components/ai/activity';\nimport { isTaskTool } from '@/ds/components/ai/tool-call';\n\n/** Which card draws a call. Decided once, shared by the dispatcher and the fold. */\nexport type ToolCardKind =\n  | 'hidden'\n  | 'observation'\n  | 'ask_user'\n  | 'connect_prompt'\n  | 'submit_plan'\n  | 'mcp_input_request'\n  | 'background'\n  | 'agent'\n  | 'workflow'\n  | 'file_tree'\n  | 'sandbox'\n  | 'code_mode'\n  | 'mcp_app'\n  | 'knowledge'\n  | 'plain';\n\nexport interface ToolCardContext {\n  metadata?: MessageMetadata;\n  mcpAppTools?: Record<string, unknown>;\n}\n\nexport interface ToolInteraction {\n  approval?: ToolApprovalMetadata;\n  suspended?: SuspendedToolMetadata;\n}\n\nconst SANDBOX_TOOLS = new Set<string>([\n  WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND,\n  WORKSPACE_TOOLS.SANDBOX.GET_PROCESS_OUTPUT,\n  WORKSPACE_TOOLS.SANDBOX.KILL_PROCESS,\n]);\n\nconst hasSubmitPlanToolId = (value: unknown): boolean => isRecord(value) && value.toolId === SUBMIT_PLAN_TOOL_ID;\n\nconst isNetworkFrom = (metadata: MessageMetadata | undefined, from: string): boolean =>\n  metadata?.mode === 'network' && metadata.from === from;\n\nexport const isAgentCall = (metadata: MessageMetadata | undefined, toolName: string): boolean =>\n  isNetworkFrom(metadata, 'AGENT') || toolName.startsWith('agent-');\n\nexport const isWorkflowCall = (metadata: MessageMetadata | undefined, toolName: string): boolean =>\n  isNetworkFrom(metadata, 'WORKFLOW') || toolName.startsWith('workflow-');\n\nexport const isSettledState = (state: string | undefined): boolean =>\n  state === 'output-available' || state === 'result';\n\n/** A call running as a Mastra background task. An awaited call's part also names its task, but holds the final result. */\nexport const isDeferredCall = (backgroundTaskId: string | undefined, backgroundTaskStatus: string | undefined) =>\n  backgroundTaskId !== undefined && backgroundTaskStatus !== 'completed' && backgroundTaskStatus !== 'failed';\n\n/** A call neither settled nor carried by a live run reads as idle, so stale history never shimmers. */\nexport function badgeStatus(state: string | undefined, chatRunning: boolean): ActivityStatus {\n  if (state === 'output-error') return 'error';\n  if (isSettledState(state) || !chatRunning) return 'idle';\n  return 'running';\n}\n\nexport const codeModeCall = (input: unknown, output: unknown) =>\n  isRecord(input) || typeof input === 'string' ? getCodeModeCall(input, output) : null;\n\n/** Approval and suspension land keyed by tool name on older runs and by call id on newer ones. */\nexport function toolInteraction(\n  metadata: MessageMetadata | undefined,\n  toolName: string,\n  toolCallId: string,\n): ToolInteraction {\n  const approvals = metadata?.requireApprovalMetadata;\n  const suspensions = metadata?.suspendedTools;\n  const namedApproval = approvals?.[toolName];\n  return {\n    approval:\n      metadata?.mode === 'network'\n        ? namedApproval?.toolCallId === toolCallId\n          ? namedApproval\n          : approvals?.[toolCallId]\n        : (approvals?.[toolCallId] ??\n          Object.values(approvals ?? {}).find(approval => approval.toolCallId === toolCallId)),\n    suspended: suspensions?.[toolName] ?? suspensions?.[toolCallId],\n  };\n}\n\n/** Tools the transcript never draws: working memory updates and task tools (shown in the docked task list). */\nexport function isHiddenTool(toolName: string): boolean {\n  return toolName === 'updateWorkingMemory' || isTaskTool(toolName);\n}\n\nexport function toolCardKind(\n  { toolName, toolCallId, input, output, state, backgroundTaskId, backgroundTaskStatus }: ToolPartFields,\n  { metadata, mcpAppTools }: ToolCardContext,\n): ToolCardKind {\n  if (toolName === 'mastra-memory-om-observation') return 'observation';\n  if (isHiddenTool(toolName)) return 'hidden';\n  // A question read back in history draws as a plain badge, but it is still a question: never folded away.\n  if (toolName === 'ask_user') return 'ask_user';\n  // Built-in `request_connection` tool from `@mastra/connect`: a settled call renders\n  // as an interactive connect card; while running it falls back to a plain badge.\n  if (toolName === CONNECT_PROMPT_TOOL_NAME && isConnectPromptPayload(output)) return 'connect_prompt';\n  const { suspended } = toolInteraction(metadata, toolName, toolCallId);\n  if (\n    toolName === SUBMIT_PLAN_TOOL_ID ||\n    hasSubmitPlanToolId(suspended?.suspendPayload) ||\n    hasSubmitPlanToolId(output)\n  ) {\n    return 'submit_plan';\n  }\n  // A foreground call parked on an MCP task's question: the run waits for the answer. A deferred\n  // call's question lives on its background task instead, which the background card reads.\n  if (!isDeferredCall(backgroundTaskId, backgroundTaskStatus) && suspendedMcpInputRequest(metadata, toolCallId)) {\n    return 'mcp_input_request';\n  }\n  if (typeof output === 'string' && output.toLowerCase().includes('background task')) return 'background';\n  if (isAgentCall(metadata, toolName)) return 'agent';\n  if (isWorkflowCall(metadata, toolName)) return 'workflow';\n  if (toolName === WORKSPACE_TOOLS.FILESYSTEM.LIST_FILES) return 'file_tree';\n  if (SANDBOX_TOOLS.has(toolName)) return 'sandbox';\n  if (codeModeCall(input, output)) return 'code_mode';\n  if (mcpAppTools?.[toolName]) return 'mcp_app';\n  // A settled or failed Knowledge call draws as a readable card; while running it stays a plain badge.\n  if (\n    KNOWLEDGE_TOOLS.has(toolName) &&\n    (state === 'output-error' || (isSettledState(state) && knowledgeCard(toolName, input, output)))\n  ) {\n    return 'knowledge';\n  }\n  return 'plain';\n}\n"],"mappings":";;;;;;;;;;AAyCA,IAAM,gCAAgB,IAAI,IAAY;CACpC,gBAAgB,QAAQ;CACxB,gBAAgB,QAAQ;CACxB,gBAAgB,QAAQ;AAC1B,CAAC;AAED,IAAM,uBAAuB,UAA4B,SAAS,KAAK,KAAK,MAAM,WAAA;AAElF,IAAM,iBAAiB,UAAuC,SAC5D,UAAU,SAAS,aAAa,SAAS,SAAS;AAEpD,IAAa,eAAe,UAAuC,aACjE,cAAc,UAAU,OAAO,KAAK,SAAS,WAAW,QAAQ;AAElE,IAAa,kBAAkB,UAAuC,aACpE,cAAc,UAAU,UAAU,KAAK,SAAS,WAAW,WAAW;AAExE,IAAa,kBAAkB,UAC7B,UAAU,sBAAsB,UAAU;;AAG5C,IAAa,kBAAkB,kBAAsC,yBACnE,qBAAqB,KAAA,KAAa,yBAAyB,eAAe,yBAAyB;;AAGrG,SAAgB,YAAY,OAA2B,aAAsC;CAC3F,IAAI,UAAU,gBAAgB,OAAO;CACrC,IAAI,eAAe,KAAK,KAAK,CAAC,aAAa,OAAO;CAClD,OAAO;AACT;AAEA,IAAa,gBAAgB,OAAgB,WAC3C,SAAS,KAAK,KAAK,OAAO,UAAU,WAAW,gBAAgB,OAAO,MAAM,IAAI;;AAGlF,SAAgB,gBACd,UACA,UACA,YACiB;CACjB,MAAM,YAAY,UAAU;CAC5B,MAAM,cAAc,UAAU;CAC9B,MAAM,gBAAgB,YAAY;CAClC,OAAO;EACL,UACE,UAAU,SAAS,YACf,eAAe,eAAe,aAC5B,gBACA,YAAY,cACb,YAAY,eACb,OAAO,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,MAAK,aAAY,SAAS,eAAe,UAAU;EACxF,WAAW,cAAc,aAAa,cAAc;CACtD;AACF;;AAGA,SAAgB,aAAa,UAA2B;CACtD,OAAO,aAAa,yBAAyB,WAAW,QAAQ;AAClE;AAEA,SAAgB,aACd,EAAE,UAAU,YAAY,OAAO,QAAQ,OAAO,kBAAkB,wBAChE,EAAE,UAAU,eACE;CACd,IAAI,aAAa,gCAAgC,OAAO;CACxD,IAAI,aAAa,QAAQ,GAAG,OAAO;CAEnC,IAAI,aAAa,YAAY,OAAO;CAGpC,IAAI,aAAA,wBAAyC,uBAAuB,MAAM,GAAG,OAAO;CACpF,MAAM,EAAE,cAAc,gBAAgB,UAAU,UAAU,UAAU;CACpE,IACE,aAAA,iBACA,oBAAoB,WAAW,cAAc,KAC7C,oBAAoB,MAAM,GAE1B,OAAO;CAIT,IAAI,CAAC,eAAe,kBAAkB,oBAAoB,KAAK,yBAAyB,UAAU,UAAU,GAC1G,OAAO;CAET,IAAI,OAAO,WAAW,YAAY,OAAO,YAAY,CAAC,CAAC,SAAS,iBAAiB,GAAG,OAAO;CAC3F,IAAI,YAAY,UAAU,QAAQ,GAAG,OAAO;CAC5C,IAAI,eAAe,UAAU,QAAQ,GAAG,OAAO;CAC/C,IAAI,aAAa,gBAAgB,WAAW,YAAY,OAAO;CAC/D,IAAI,cAAc,IAAI,QAAQ,GAAG,OAAO;CACxC,IAAI,aAAa,OAAO,MAAM,GAAG,OAAO;CACxC,IAAI,cAAc,WAAW,OAAO;CAEpC,IACE,gBAAgB,IAAI,QAAQ,MAC3B,UAAU,kBAAmB,eAAe,KAAK,KAAK,cAAc,UAAU,OAAO,MAAM,IAE5F,OAAO;CAET,OAAO;AACT"}

package/dist/domains/chat/tools/tool-card.cjs.js

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_tool_card = require("../../../tool-card-DrqPZfPQ.cjs");
+const require_tool_card = require("../../../tool-card-rxhTDpk_.cjs");
 exports.ToolCard = require_tool_card.ToolCard;
 exports.ToolCardInner = require_tool_card.ToolCardInner;

package/dist/domains/chat/tools/tool-card.es.js

@@ -1 +1 @@
-export { t as ToolCard, n as ToolCardInner } from "../../../tool-card-sO6P2Qj4.js";
+export { t as ToolCard, n as ToolCardInner } from "../../../tool-card-toDgoZzJ.js";

package/dist/domains/chat/tools/tool-groups.cjs.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_tool_call = require("../../../tool-call-Bu66PkD-.cjs");
+const require_tool_call = require("../../../tool-call-DBn14X-3.cjs");
 const require_domains_chat_messages_signal_data = require("../messages/signal-data.cjs.js");
 const require_domains_chat_messages_renderers_tool_part = require("../messages/renderers/tool-part.cjs.js");
 const require_domains_chat_tools_tool_card_kind = require("./tool-card-kind.cjs.js");

package/dist/domains/chat/tools/tool-groups.es.js

@@ -1,4 +1,4 @@
-import { u as groupConsecutive } from "../../../tool-call-Ch9-jjXU.js";
+import { u as groupConsecutive } from "../../../tool-call-Dsj43lvJ.js";
 import { isSignalData } from "../messages/signal-data.es.js";
 import { isToolPart, readToolPart } from "../messages/renderers/tool-part.es.js";
 import { toolCardKind, toolInteraction } from "./tool-card-kind.es.js";

package/dist/domains/chat.cjs.js

@@ -1,4 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_domains_chat_messages_signal_data = require("./chat/messages/signal-data.cjs.js");
+const require_domains_chat_knowledge_pinned_knowledge_data = require("./chat/knowledge/pinned-knowledge-data.cjs.js");
+const require_domains_chat_knowledge_knowledge_links = require("./chat/knowledge/knowledge-links.cjs.js");
 const require_domains_chat_context_chat_context = require("./chat/context/chat-context.cjs.js");
 const require_domains_chat_components_badge_wrapper = require("./chat/components/badge-wrapper.cjs.js");
 const require_domains_chat_components_loading_badge = require("./chat/components/loading-badge.cjs.js");
@@ -7,9 +10,6 @@ const require_domains_chat_components_section_label = require("./chat/components
 const require_domains_chat_context_dataset_save_context_value = require("./chat/context/dataset-save-context-value.cjs.js");
 const require_domains_chat_context_dataset_save_context = require("./chat/context/dataset-save-context.cjs.js");
 const require_domains_chat_context_tool_call_context = require("./chat/context/tool-call-context.cjs.js");
-const require_domains_chat_messages_signal_data = require("./chat/messages/signal-data.cjs.js");
-const require_domains_chat_knowledge_pinned_knowledge_data = require("./chat/knowledge/pinned-knowledge-data.cjs.js");
-const require_domains_chat_knowledge_knowledge_links = require("./chat/knowledge/knowledge-links.cjs.js");
 const require_domains_chat_knowledge_pinned_knowledge = require("./chat/knowledge/pinned-knowledge.cjs.js");
 const require_domains_chat_tools_badges_knowledge_tool_badge = require("./chat/tools/badges/knowledge-tool-badge.cjs.js");
 const require_domains_chat_messages_renderers_tool_part = require("./chat/messages/renderers/tool-part.cjs.js");
@@ -52,5 +52,7 @@ exports.useChatRunning = require_domains_chat_context_chat_context.useChatRunnin
 exports.useChatSend = require_domains_chat_context_chat_context.useChatSend;
 exports.useChatTasks = require_domains_chat_context_chat_context.useChatTasks;
 exports.useDatasetSaveContext = require_domains_chat_context_dataset_save_context_value.useDatasetSaveContext;
+exports.useHasKnowledgeLinks = require_domains_chat_knowledge_knowledge_links.useHasKnowledgeLinks;
+exports.useKnowledgeLinksContext = require_domains_chat_knowledge_knowledge_links.useKnowledgeLinksContext;
 exports.useOptionalToolCall = require_domains_chat_context_tool_call_context.useOptionalToolCall;
 exports.useToolCall = require_domains_chat_context_tool_call_context.useToolCall;

package/dist/domains/chat.es.js

@@ -1,3 +1,6 @@
+import { formatSignalValue, getMcpEventSignalInfo, getNotificationMetadata, getSignalType, isRecord, isSignalData, isUserSignalType, signalContentsToText, toReactiveSignalData } from "./chat/messages/signal-data.es.js";
+import { knowledgePageHref, pinnedKnowledgeFromSignal } from "./chat/knowledge/pinned-knowledge-data.es.js";
+import { KnowledgeLinksProvider, KnowledgePageLink, useHasKnowledgeLinks, useKnowledgeLinksContext } from "./chat/knowledge/knowledge-links.es.js";
 import { ChatAgentContext, ChatMessagesContext, ChatRunningContext, ChatSendContext, ChatTasksContext, useChatMessages, useChatRunning, useChatSend, useChatTasks } from "./chat/context/chat-context.es.js";
 import { BadgeWrapper } from "./chat/components/badge-wrapper.es.js";
 import { LoadingBadge } from "./chat/components/loading-badge.es.js";
@@ -6,12 +9,9 @@ import { SectionLabel } from "./chat/components/section-label.es.js";
 import { useDatasetSaveContext } from "./chat/context/dataset-save-context-value.es.js";
 import { DatasetSaveProvider } from "./chat/context/dataset-save-context.es.js";
 import { ToolCallProvider, useOptionalToolCall, useToolCall } from "./chat/context/tool-call-context.es.js";
-import { formatSignalValue, getMcpEventSignalInfo, getNotificationMetadata, getSignalType, isRecord, isSignalData, isUserSignalType, signalContentsToText, toReactiveSignalData } from "./chat/messages/signal-data.es.js";
-import { knowledgePageHref, pinnedKnowledgeFromSignal } from "./chat/knowledge/pinned-knowledge-data.es.js";
-import { KnowledgeLinksProvider, KnowledgePageLink } from "./chat/knowledge/knowledge-links.es.js";
 import { PinnedKnowledgeActivity } from "./chat/knowledge/pinned-knowledge.es.js";
 import { KNOWLEDGE_TOOLS, knowledgeCard } from "./chat/tools/badges/knowledge-tool-badge.es.js";
 import { isToolPart, readToolPart } from "./chat/messages/renderers/tool-part.es.js";
 import { DatasetSaveAction, SaveFullConversationAction } from "./chat/messages/dataset-save-action.es.js";
 import { AssistantMessageActions } from "./chat/messages/assistant-message-actions.es.js";
-export { AssistantMessageActions, BadgeWrapper, ChatAgentContext, ChatMessagesContext, ChatRunningContext, ChatSendContext, ChatTasksContext, DatasetSaveAction, DatasetSaveProvider, KNOWLEDGE_TOOLS, KnowledgeLinksProvider, KnowledgePageLink, LoadingBadge, NetworkChoiceMetadataDialogTrigger, PinnedKnowledgeActivity, SaveFullConversationAction, SectionLabel, ToolCallProvider, formatSignalValue, getMcpEventSignalInfo, getNotificationMetadata, getSignalType, isRecord, isSignalData, isToolPart, isUserSignalType, knowledgeCard, knowledgePageHref, pinnedKnowledgeFromSignal, readToolPart, signalContentsToText, toReactiveSignalData, useChatMessages, useChatRunning, useChatSend, useChatTasks, useDatasetSaveContext, useOptionalToolCall, useToolCall };
+export { AssistantMessageActions, BadgeWrapper, ChatAgentContext, ChatMessagesContext, ChatRunningContext, ChatSendContext, ChatTasksContext, DatasetSaveAction, DatasetSaveProvider, KNOWLEDGE_TOOLS, KnowledgeLinksProvider, KnowledgePageLink, LoadingBadge, NetworkChoiceMetadataDialogTrigger, PinnedKnowledgeActivity, SaveFullConversationAction, SectionLabel, ToolCallProvider, formatSignalValue, getMcpEventSignalInfo, getNotificationMetadata, getSignalType, isRecord, isSignalData, isToolPart, isUserSignalType, knowledgeCard, knowledgePageHref, pinnedKnowledgeFromSignal, readToolPart, signalContentsToText, toReactiveSignalData, useChatMessages, useChatRunning, useChatSend, useChatTasks, useDatasetSaveContext, useHasKnowledgeLinks, useKnowledgeLinksContext, useOptionalToolCall, useToolCall };

package/dist/domains/knowledge/components/KnowledgePageCard.cjs.js

@@ -0,0 +1,48 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_Txt = require("../../../Txt-BnoSqxKE.cjs");
+const require_domains_knowledge_lib_linkCountsText = require("../lib/linkCountsText.cjs.js");
+let react_jsx_runtime = require("react/jsx-runtime");
+// src/domains/knowledge/components/KnowledgePageCard.tsx
+/**
+* What the explorer's graph tooltip says about a page: name, kind and ref, children, links. The graph's
+* dots and the hover cards on page links in chat both draw it.
+*/
+function KnowledgePageCard({ name, kind, pageRef, path, childCount, links, notShown }) {
+	const children = childCount && childCount !== "0" ? `${childCount} ${childCount === "1" ? "child" : "children"}` : null;
+	const linkText = links && (links.in > 0 || links.out > 0) ? require_domains_knowledge_lib_linkCountsText.linkCountsText(links, notShown) : null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Txt.Txt, {
+			as: "span",
+			variant: "label",
+			tone: "ink",
+			children: name
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Txt.Txt, {
+			as: "span",
+			variant: "meta",
+			tone: "muted",
+			children: pageRef ? `${kind} · ${pageRef}` : kind
+		}),
+		path ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Txt.Txt, {
+			as: "span",
+			variant: "meta",
+			tone: "muted",
+			children: path
+		}) : null,
+		children ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Txt.Txt, {
+			as: "span",
+			variant: "meta",
+			tone: "muted",
+			children
+		}) : null,
+		linkText ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Txt.Txt, {
+			as: "span",
+			variant: "meta",
+			tone: "muted",
+			children: linkText
+		}) : null
+	] });
+}
+exports.KnowledgePageCard = KnowledgePageCard;
+
+//# sourceMappingURL=KnowledgePageCard.cjs.js.map

package/dist/domains/knowledge/components/KnowledgePageCard.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgePageCard.cjs.js","names":["linkCountsText","_Fragment","Txt"],"sources":["../../../../src/domains/knowledge/components/KnowledgePageCard.tsx"],"sourcesContent":["import { linkCountsText } from '../lib/linkCountsText';\nimport { Txt } from '@/ds/components/Txt';\n\nexport interface KnowledgePageCardProps {\n  name: string;\n  /** `Page`, `Scope` or a scope's display label. */\n  kind: string;\n  /** Where the page is addressed, e.g. `org:acme#policies/refunds`. */\n  pageRef?: string;\n  /** Where the page sits, from its root scope down. */\n  path?: string;\n  /** Already formatted (`1000+` when the server capped the count); left out when unknown or zero. */\n  childCount?: string;\n  /** Left out when unknown or both zero. */\n  links?: { in: number; out: number };\n  /** Of `links`, how many go to pages the graph doesn't draw. */\n  notShown?: number;\n}\n\n/**\n * What the explorer's graph tooltip says about a page: name, kind and ref, children, links. The graph's\n * dots and the hover cards on page links in chat both draw it.\n */\nexport function KnowledgePageCard({ name, kind, pageRef, path, childCount, links, notShown }: KnowledgePageCardProps) {\n  const children =\n    childCount && childCount !== '0' ? `${childCount} ${childCount === '1' ? 'child' : 'children'}` : null;\n  const linkText = links && (links.in > 0 || links.out > 0) ? linkCountsText(links, notShown) : null;\n  return (\n    <>\n      <Txt as=\"span\" variant=\"label\" tone=\"ink\">\n        {name}\n      </Txt>\n      <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n        {pageRef ? `${kind} · ${pageRef}` : kind}\n      </Txt>\n      {path ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {path}\n        </Txt>\n      ) : null}\n      {children ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {children}\n        </Txt>\n      ) : null}\n      {linkText ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {linkText}\n        </Txt>\n      ) : null}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;AAuBA,SAAgB,kBAAkB,EAAE,MAAM,MAAM,SAAS,MAAM,YAAY,OAAO,YAAoC;CACpH,MAAM,WACJ,cAAc,eAAe,MAAM,GAAG,WAAW,GAAG,eAAe,MAAM,UAAU,eAAe;CACpG,MAAM,WAAW,UAAU,MAAM,KAAK,KAAK,MAAM,MAAM,KAAKA,6CAAAA,eAAe,OAAO,QAAQ,IAAI;CAC9F,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAAC,kBAAAA,UAAA,EAAA,UAAA;EACE,iBAAA,GAAA,kBAAA,IAAA,CAACC,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAQ,MAAK;GACjC,UAAA;EACE,CAAA;EACL,iBAAA,GAAA,kBAAA,IAAA,CAACA,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC,UAAA,UAAU,GAAG,KAAK,KAAK,YAAY;EACjC,CAAA;EACJ,OACC,iBAAA,GAAA,kBAAA,IAAA,CAACA,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC,UAAA;EACE,CAAA,IACH;EACH,WACC,iBAAA,GAAA,kBAAA,IAAA,CAACA,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC;EACE,CAAA,IACH;EACH,WACC,iBAAA,GAAA,kBAAA,IAAA,CAACA,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC,UAAA;EACE,CAAA,IACH;CACJ,EAAA,CAAA;AAEN"}

package/dist/domains/knowledge/components/KnowledgePageCard.d.ts

@@ -0,0 +1 @@
+export * from '../../../src/domains/knowledge/components/KnowledgePageCard';

package/dist/domains/knowledge/components/KnowledgePageCard.es.js

@@ -0,0 +1,47 @@
+import { t as Txt } from "../../../Txt-BM6TVV_c.js";
+import { linkCountsText } from "../lib/linkCountsText.es.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+// src/domains/knowledge/components/KnowledgePageCard.tsx
+/**
+* What the explorer's graph tooltip says about a page: name, kind and ref, children, links. The graph's
+* dots and the hover cards on page links in chat both draw it.
+*/
+function KnowledgePageCard({ name, kind, pageRef, path, childCount, links, notShown }) {
+	const children = childCount && childCount !== "0" ? `${childCount} ${childCount === "1" ? "child" : "children"}` : null;
+	const linkText = links && (links.in > 0 || links.out > 0) ? linkCountsText(links, notShown) : null;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsx(Txt, {
+			as: "span",
+			variant: "label",
+			tone: "ink",
+			children: name
+		}),
+		/* @__PURE__ */ jsx(Txt, {
+			as: "span",
+			variant: "meta",
+			tone: "muted",
+			children: pageRef ? `${kind} · ${pageRef}` : kind
+		}),
+		path ? /* @__PURE__ */ jsx(Txt, {
+			as: "span",
+			variant: "meta",
+			tone: "muted",
+			children: path
+		}) : null,
+		children ? /* @__PURE__ */ jsx(Txt, {
+			as: "span",
+			variant: "meta",
+			tone: "muted",
+			children
+		}) : null,
+		linkText ? /* @__PURE__ */ jsx(Txt, {
+			as: "span",
+			variant: "meta",
+			tone: "muted",
+			children: linkText
+		}) : null
+	] });
+}
+export { KnowledgePageCard };
+
+//# sourceMappingURL=KnowledgePageCard.es.js.map

package/dist/domains/knowledge/components/KnowledgePageCard.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgePageCard.es.js","names":["_Fragment"],"sources":["../../../../src/domains/knowledge/components/KnowledgePageCard.tsx"],"sourcesContent":["import { linkCountsText } from '../lib/linkCountsText';\nimport { Txt } from '@/ds/components/Txt';\n\nexport interface KnowledgePageCardProps {\n  name: string;\n  /** `Page`, `Scope` or a scope's display label. */\n  kind: string;\n  /** Where the page is addressed, e.g. `org:acme#policies/refunds`. */\n  pageRef?: string;\n  /** Where the page sits, from its root scope down. */\n  path?: string;\n  /** Already formatted (`1000+` when the server capped the count); left out when unknown or zero. */\n  childCount?: string;\n  /** Left out when unknown or both zero. */\n  links?: { in: number; out: number };\n  /** Of `links`, how many go to pages the graph doesn't draw. */\n  notShown?: number;\n}\n\n/**\n * What the explorer's graph tooltip says about a page: name, kind and ref, children, links. The graph's\n * dots and the hover cards on page links in chat both draw it.\n */\nexport function KnowledgePageCard({ name, kind, pageRef, path, childCount, links, notShown }: KnowledgePageCardProps) {\n  const children =\n    childCount && childCount !== '0' ? `${childCount} ${childCount === '1' ? 'child' : 'children'}` : null;\n  const linkText = links && (links.in > 0 || links.out > 0) ? linkCountsText(links, notShown) : null;\n  return (\n    <>\n      <Txt as=\"span\" variant=\"label\" tone=\"ink\">\n        {name}\n      </Txt>\n      <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n        {pageRef ? `${kind} · ${pageRef}` : kind}\n      </Txt>\n      {path ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {path}\n        </Txt>\n      ) : null}\n      {children ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {children}\n        </Txt>\n      ) : null}\n      {linkText ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {linkText}\n        </Txt>\n      ) : null}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;AAuBA,SAAgB,kBAAkB,EAAE,MAAM,MAAM,SAAS,MAAM,YAAY,OAAO,YAAoC;CACpH,MAAM,WACJ,cAAc,eAAe,MAAM,GAAG,WAAW,GAAG,eAAe,MAAM,UAAU,eAAe;CACpG,MAAM,WAAW,UAAU,MAAM,KAAK,KAAK,MAAM,MAAM,KAAK,eAAe,OAAO,QAAQ,IAAI;CAC9F,OACE,qBAAAA,UAAA,EAAA,UAAA;EACE,oBAAC,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAQ,MAAK;GACjC,UAAA;EACE,CAAA;EACL,oBAAC,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC,UAAA,UAAU,GAAG,KAAK,KAAK,YAAY;EACjC,CAAA;EACJ,OACC,oBAAC,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC,UAAA;EACE,CAAA,IACH;EACH,WACC,oBAAC,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC;EACE,CAAA,IACH;EACH,WACC,oBAAC,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC,UAAA;EACE,CAAA,IACH;CACJ,EAAA,CAAA;AAEN"}

package/dist/domains/knowledge/components/KnowledgePageDetail.cjs.js

@@ -1,7 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_Txt = require("../../../Txt-BnoSqxKE.cjs");
 const require_Badge = require("../../../Badge-DZ6r6bcw.cjs");
-const require_MarkdownRenderer = require("../../../MarkdownRenderer-CB8Z_CHc.cjs");
+const require_MarkdownRenderer = require("../../../MarkdownRenderer-y65WGBhC.cjs");
+const require_domains_knowledge_lib_remarkKnowledgeLinks = require("../lib/remarkKnowledgeLinks.cjs.js");
+const require_domains_knowledge_lib_pageRefs = require("../lib/pageRefs.cjs.js");
 const require_domains_knowledge_lib_recordText = require("../lib/recordText.cjs.js");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -93,6 +95,32 @@ function knowledgePagePath(page, ancestors) {
 	if (keys.some((key) => !key)) return null;
 	return `${scope.address}#${keys.join("/")}`;
 }
+var BodyLinks = (0, react.createContext)(null);
+/**
+* A `[[ref]]` from a page body: the page's name as a link when a loaded page answers to the ref, the ref
+* itself in a quiet style when none does. Every other `<span>` the markdown makes passes through.
+*/
+function BodySpan({ node, ...props }) {
+	const links = (0, react.useContext)(BodyLinks);
+	const ref = node?.properties[require_domains_knowledge_lib_remarkKnowledgeLinks.KNOWLEDGE_REF_PROPERTY];
+	if (typeof ref !== "string" || !links) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { ...props });
+	const target = links.index.resolve(ref);
+	return target ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+		type: "button",
+		"data-testid": "knowledge-body-link",
+		title: ref,
+		className: "rounded bg-badge-blue-subtle px-1 font-medium text-badge-blue-foreground hover:underline",
+		onClick: () => links.onPageClick(target),
+		children: target.name
+	}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+		"data-testid": "knowledge-body-link-unresolved",
+		title: "No loaded page has this address",
+		className: "rounded border border-dashed border-border px-1 text-muted-foreground",
+		children: ref
+	});
+}
+var BODY_REMARK_PLUGINS = [require_domains_knowledge_lib_remarkKnowledgeLinks.remarkKnowledgeLinks];
+var BODY_COMPONENTS = { span: BodySpan };
 function Section({ label, count, children }) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 		"aria-label": label,
@@ -121,9 +149,20 @@ function PageLink({ page, onPageClick }) {
 		children: page.name
 	});
 }
+var refIndexes = /* @__PURE__ */ new WeakMap();
+/** One ref index per loaded-pages map, shared by every note drawn from it. */
+function loadedRefIndex(pagesById) {
+	let index = refIndexes.get(pagesById);
+	if (!index) refIndexes.set(pagesById, index = require_domains_knowledge_lib_pageRefs.knowledgePageRefIndex(pagesById.values()));
+	return index;
+}
 /** One note: who wrote it and when, its text with `[[mentions]]` linked when the page is known, and the scopes it is stamped to. */
 function KnowledgeNoteItem({ note, pagesById, onPageClick, highlighted, itemRef, showPage, compact }) {
-	const mentioned = note.mentions.map((id) => pagesById.get(id)).filter((candidate) => candidate !== void 0);
+	const refIndex = loadedRefIndex(pagesById);
+	const mentionTarget = (ref) => {
+		const target = refIndex.resolve(ref);
+		return target && note.mentions.includes(target.id) ? target : void 0;
+	};
 	const scopeLabel = (id) => {
 		const scopePage = pagesById.get(id);
 		return scopePage?.address ?? scopePage?.name ?? id;
@@ -170,8 +209,7 @@ function KnowledgeNoteItem({ note, pagesById, onPageClick, highlighted, itemRef,
 					className: "text-ui-md break-words text-foreground",
 					children: require_domains_knowledge_lib_recordText.parseRecordSegments(note.text).map((segment, index) => {
 						if (segment.type === "text") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: segment.value }, index);
-						const name = segment.value.trim().toLocaleLowerCase();
-						const target = mentioned.find((candidate) => candidate.name.trim().toLocaleLowerCase() === name);
+						const target = mentionTarget(segment.value);
 						return target ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 							type: "button",
 							className: "rounded bg-badge-blue-subtle px-1 font-medium text-badge-blue-foreground hover:underline",
@@ -214,6 +252,19 @@ function KnowledgePageDetail({ page, notes, pin, pagesById, onPageClick, highlig
 	const scope = page.isScope ? page : ancestors.find((candidate) => candidate.id === page.scopeId) ?? pagesById.get(page.scopeId);
 	const path = knowledgePagePath(page, ancestors);
 	const kind = page.isScope ? page.displayLabel ?? "Scope" : "Page";
+	const refIndex = (0, react.useMemo)(() => require_domains_knowledge_lib_pageRefs.knowledgePageRefIndex([
+		...pagesById.values(),
+		...ancestors,
+		page
+	]), [
+		pagesById,
+		ancestors,
+		page
+	]);
+	const bodyLinks = (0, react.useMemo)(() => ({
+		index: refIndex,
+		onPageClick
+	}), [refIndex, onPageClick]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("article", {
 		"aria-label": page.name,
 		className: "flex min-h-0 flex-col overflow-y-auto",
@@ -340,7 +391,14 @@ function KnowledgePageDetail({ page, notes, pin, pagesById, onPageClick, highlig
 				children: [page.body ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 					"data-testid": "knowledge-page-body",
 					className: "max-w-3xl",
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_MarkdownRenderer.MarkdownRenderer, { children: page.body })
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BodyLinks.Provider, {
+						value: bodyLinks,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_MarkdownRenderer.MarkdownRenderer, {
+							remarkPlugins: BODY_REMARK_PLUGINS,
+							components: BODY_COMPONENTS,
+							children: page.body
+						})
+					})
 				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_Txt.Txt, {
 					variant: "body",
 					tone: "muted",