@personaai/react 0.7.8 → 0.7.9

package/dist/index.d.cts

@@ -33,6 +33,11 @@ interface PersonaToolCall {
     seq?: number;
     /** Nested activity timeline — only present on `task` (subagent) tool calls. */
     subagentActivity?: PersonaSubagentActivityEntry[];
+    /** Present when this tool is backed by an interactive MCP Ext App. */
+    mcpApp?: {
+        resourceUri: string;
+        mcpId: string;
+    };
 }
 interface PersonaMessage {
     id: string;
@@ -585,6 +590,19 @@ declare function useMcpConnections(options?: UseMcpConnectionsOptions): {
     refetch: () => Promise<PersonaMcpConnection[]>;
 };
 
+interface UseMcpOptions {
+    /** Default MCP server ID for resource reads and tool calls */
+    mcpId?: string;
+}
+/**
+ * Hook for interacting with MCP servers connected via the Persona runtime.
+ * Provides helper functions for reading UI/data resources and calling server tools.
+ */
+declare function useMcp(options?: UseMcpOptions): {
+    readResource: (uri: string, mcpId?: string) => Promise<any>;
+    callTool: (name: string, args?: Record<string, unknown>, mcpId?: string) => Promise<any>;
+};
+
 /**
  * SSE transport for chat streams, with a React Native fallback.
  *
@@ -641,6 +659,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.7.3";
+declare const VERSION = "0.7.9";
 
-export { type OpenSSEOptions, type PersonaAgentSummary, type PersonaClarificationQuestion, type PersonaFileItem, type PersonaHealthInfo, type PersonaHitlActionRequest, type PersonaInterrupt, type PersonaMcpConnection, type PersonaMemoryAgentGroup, type PersonaMemoryFile, type PersonaMemoryList, type PersonaMessage, type PersonaPresentedFile, PersonaProvider, type PersonaProviderProps, type PersonaResumeValue, type PersonaRole, type PersonaStreamingEvent, type PersonaSubagentActivityEntry, type PersonaThread, type PersonaTodo, type PersonaToolCall, type PersonaVoiceEndReason, type PersonaVoiceState, type PersonaVoiceToolCall, type PersonaVoiceTranscriptLine, type PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendMessageOverride, type UseChatOptions, type UseMcpConnectionsOptions, type UseVoiceOptions, type UseVoiceResult, VERSION, openSSEStream, supportsStreamingFetch, useAgents, useChat, useConnection, useFiles, useMcpConnections, useMemory, usePersonaContext, useThreads, useVoice };
+export { type OpenSSEOptions, type PersonaAgentSummary, type PersonaClarificationQuestion, type PersonaFileItem, type PersonaHealthInfo, type PersonaHitlActionRequest, type PersonaInterrupt, type PersonaMcpConnection, type PersonaMemoryAgentGroup, type PersonaMemoryFile, type PersonaMemoryList, type PersonaMessage, type PersonaPresentedFile, PersonaProvider, type PersonaProviderProps, type PersonaResumeValue, type PersonaRole, type PersonaStreamingEvent, type PersonaSubagentActivityEntry, type PersonaThread, type PersonaTodo, type PersonaToolCall, type PersonaVoiceEndReason, type PersonaVoiceState, type PersonaVoiceToolCall, type PersonaVoiceTranscriptLine, type PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendMessageOverride, type UseChatOptions, type UseMcpConnectionsOptions, type UseMcpOptions, type UseVoiceOptions, type UseVoiceResult, VERSION, openSSEStream, supportsStreamingFetch, useAgents, useChat, useConnection, useFiles, useMcp, useMcpConnections, useMemory, usePersonaContext, useThreads, useVoice };

package/dist/index.d.ts

@@ -33,6 +33,11 @@ interface PersonaToolCall {
     seq?: number;
     /** Nested activity timeline — only present on `task` (subagent) tool calls. */
     subagentActivity?: PersonaSubagentActivityEntry[];
+    /** Present when this tool is backed by an interactive MCP Ext App. */
+    mcpApp?: {
+        resourceUri: string;
+        mcpId: string;
+    };
 }
 interface PersonaMessage {
     id: string;
@@ -585,6 +590,19 @@ declare function useMcpConnections(options?: UseMcpConnectionsOptions): {
     refetch: () => Promise<PersonaMcpConnection[]>;
 };
 
+interface UseMcpOptions {
+    /** Default MCP server ID for resource reads and tool calls */
+    mcpId?: string;
+}
+/**
+ * Hook for interacting with MCP servers connected via the Persona runtime.
+ * Provides helper functions for reading UI/data resources and calling server tools.
+ */
+declare function useMcp(options?: UseMcpOptions): {
+    readResource: (uri: string, mcpId?: string) => Promise<any>;
+    callTool: (name: string, args?: Record<string, unknown>, mcpId?: string) => Promise<any>;
+};
+
 /**
  * SSE transport for chat streams, with a React Native fallback.
  *
@@ -641,6 +659,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.7.3";
+declare const VERSION = "0.7.9";
 
-export { type OpenSSEOptions, type PersonaAgentSummary, type PersonaClarificationQuestion, type PersonaFileItem, type PersonaHealthInfo, type PersonaHitlActionRequest, type PersonaInterrupt, type PersonaMcpConnection, type PersonaMemoryAgentGroup, type PersonaMemoryFile, type PersonaMemoryList, type PersonaMessage, type PersonaPresentedFile, PersonaProvider, type PersonaProviderProps, type PersonaResumeValue, type PersonaRole, type PersonaStreamingEvent, type PersonaSubagentActivityEntry, type PersonaThread, type PersonaTodo, type PersonaToolCall, type PersonaVoiceEndReason, type PersonaVoiceState, type PersonaVoiceToolCall, type PersonaVoiceTranscriptLine, type PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendMessageOverride, type UseChatOptions, type UseMcpConnectionsOptions, type UseVoiceOptions, type UseVoiceResult, VERSION, openSSEStream, supportsStreamingFetch, useAgents, useChat, useConnection, useFiles, useMcpConnections, useMemory, usePersonaContext, useThreads, useVoice };
+export { type OpenSSEOptions, type PersonaAgentSummary, type PersonaClarificationQuestion, type PersonaFileItem, type PersonaHealthInfo, type PersonaHitlActionRequest, type PersonaInterrupt, type PersonaMcpConnection, type PersonaMemoryAgentGroup, type PersonaMemoryFile, type PersonaMemoryList, type PersonaMessage, type PersonaPresentedFile, PersonaProvider, type PersonaProviderProps, type PersonaResumeValue, type PersonaRole, type PersonaStreamingEvent, type PersonaSubagentActivityEntry, type PersonaThread, type PersonaTodo, type PersonaToolCall, type PersonaVoiceEndReason, type PersonaVoiceState, type PersonaVoiceToolCall, type PersonaVoiceTranscriptLine, type PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendMessageOverride, type UseChatOptions, type UseMcpConnectionsOptions, type UseMcpOptions, type UseVoiceOptions, type UseVoiceResult, VERSION, openSSEStream, supportsStreamingFetch, useAgents, useChat, useConnection, useFiles, useMcp, useMcpConnections, useMemory, usePersonaContext, useThreads, useVoice };

package/dist/index.js

@@ -865,6 +865,18 @@ function useChat(options = {}) {
                     ];
                     patchAssistant({});
                   }
+                } else if (event.name === "mcp_app") {
+                  const val = event.value;
+                  if (val?.toolCallId && val?.resourceUri && val?.mcpId) {
+                    const existing = toolCallsMap.get(val.toolCallId);
+                    if (existing) {
+                      existing.mcpApp = {
+                        resourceUri: val.resourceUri,
+                        mcpId: val.mcpId
+                      };
+                      patchAssistant({});
+                    }
+                  }
                 }
               } else if (event.type === "RUN_ERROR") {
                 chatLogger.warn("run error", {
@@ -1975,6 +1987,47 @@ function useMcpConnections(options = {}) {
   };
 }
 
+// src/hooks/useMcp.ts
+import { useCallback as useCallback9 } from "react";
+function useMcp(options = {}) {
+  const { fetchWithAuth } = usePersonaContext();
+  const defaultMcpId = options.mcpId;
+  const readResource = useCallback9(
+    async (uri, mcpId) => {
+      const id = mcpId ?? defaultMcpId;
+      if (!id) throw new Error("MCP server ID is required to read resource");
+      const res = await fetchWithAuth(
+        `/mcps/${id}/resource?uri=${encodeURIComponent(uri)}`
+      );
+      if (!res.ok) {
+        throw new Error(`Failed to read MCP resource: ${res.statusText}`);
+      }
+      return await res.json();
+    },
+    [fetchWithAuth, defaultMcpId]
+  );
+  const callTool = useCallback9(
+    async (name, args, mcpId) => {
+      const id = mcpId ?? defaultMcpId;
+      if (!id) throw new Error("MCP server ID is required to call tool");
+      const res = await fetchWithAuth(`/mcps/${id}/call-tool`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ name, arguments: args })
+      });
+      if (!res.ok) {
+        throw new Error(`Failed to call MCP tool: ${res.statusText}`);
+      }
+      return await res.json();
+    },
+    [fetchWithAuth, defaultMcpId]
+  );
+  return {
+    readResource,
+    callTool
+  };
+}
+
 // src/index.ts
 import {
   createLogger as createLogger2,
@@ -1983,7 +2036,7 @@ import {
   getLogLevel,
   isLevelEnabled
 } from "@personaai/logger";
-var VERSION = "0.7.3";
+var VERSION = "0.7.9";
 export {
   PersonaProvider,
   VERSION,
@@ -1998,6 +2051,7 @@ export {
   useChat,
   useConnection,
   useFiles,
+  useMcp,
   useMcpConnections,
   useMemory,
   usePersonaContext,