@personaai/react 0.7.8 → 0.7.10

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;
@@ -107,6 +112,25 @@ interface PersonaPresentedFile {
     title: string;
     description: string;
 }
+/**
+ * One `execute` tool call against an Agent's sandbox (real shell execution
+ * in an isolated CodeSandbox VM — requires the Agent's `sandboxEnabled` and
+ * a `CSB_API_KEY` Project Secret; see the Agent's `sandboxEnabled` field).
+ * Derived from `PersonaToolCall`s named `execute` across every message in
+ * the conversation, in stream order — not a separate live/history-tracked
+ * state, so it's always consistent with `messages`.
+ */
+interface PersonaSandboxCommand {
+    toolCallId: string;
+    /** The shell command, parsed from the tool call's `args`. Falls back to the raw args string while still streaming/incomplete. */
+    command: string;
+    /** stdout/stderr, once the call finishes. */
+    output?: string;
+    /** `null` when the result parsed but didn't carry an exit code; `undefined` while still running. */
+    exitCode?: number | null;
+    status: "running" | "done" | "error";
+    seq?: number;
+}
 interface PersonaProviderProps {
     /** Base URL where the Persona runtime / adapter is mounted, e.g. "http://localhost:4000/api/persona" */
     baseUrl: string;
@@ -424,6 +448,7 @@ declare function useChat(options?: UseChatOptions): {
     presentedFile: PersonaPresentedFile | null;
     dismissPresentedFile: () => void;
     openWorkspaceFile: (path: string) => void;
+    sandboxCommands: PersonaSandboxCommand[];
     stop: () => void;
     reload: () => void;
     clear: () => void;
@@ -585,6 +610,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 +679,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.7.3";
+declare const VERSION = "0.7.10";
 
-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 PersonaSandboxCommand, 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;
@@ -107,6 +112,25 @@ interface PersonaPresentedFile {
     title: string;
     description: string;
 }
+/**
+ * One `execute` tool call against an Agent's sandbox (real shell execution
+ * in an isolated CodeSandbox VM — requires the Agent's `sandboxEnabled` and
+ * a `CSB_API_KEY` Project Secret; see the Agent's `sandboxEnabled` field).
+ * Derived from `PersonaToolCall`s named `execute` across every message in
+ * the conversation, in stream order — not a separate live/history-tracked
+ * state, so it's always consistent with `messages`.
+ */
+interface PersonaSandboxCommand {
+    toolCallId: string;
+    /** The shell command, parsed from the tool call's `args`. Falls back to the raw args string while still streaming/incomplete. */
+    command: string;
+    /** stdout/stderr, once the call finishes. */
+    output?: string;
+    /** `null` when the result parsed but didn't carry an exit code; `undefined` while still running. */
+    exitCode?: number | null;
+    status: "running" | "done" | "error";
+    seq?: number;
+}
 interface PersonaProviderProps {
     /** Base URL where the Persona runtime / adapter is mounted, e.g. "http://localhost:4000/api/persona" */
     baseUrl: string;
@@ -424,6 +448,7 @@ declare function useChat(options?: UseChatOptions): {
     presentedFile: PersonaPresentedFile | null;
     dismissPresentedFile: () => void;
     openWorkspaceFile: (path: string) => void;
+    sandboxCommands: PersonaSandboxCommand[];
     stop: () => void;
     reload: () => void;
     clear: () => void;
@@ -585,6 +610,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 +679,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.7.3";
+declare const VERSION = "0.7.10";
 
-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 PersonaSandboxCommand, 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

@@ -330,6 +330,37 @@ function parsePresentedFile(content) {
     return null;
   }
 }
+function parseSandboxCommand(tc) {
+  let command = tc.args ?? "";
+  try {
+    const parsedArgs = JSON.parse(tc.args || "{}");
+    if (typeof parsedArgs.command === "string") command = parsedArgs.command;
+  } catch {
+  }
+  let output;
+  let exitCode;
+  if (tc.result) {
+    try {
+      const parsedResult = JSON.parse(tc.result);
+      if (typeof parsedResult.output === "string") {
+        output = parsedResult.output;
+        exitCode = typeof parsedResult.exitCode === "number" ? parsedResult.exitCode : null;
+      } else {
+        output = tc.result;
+      }
+    } catch {
+      output = tc.result;
+    }
+  }
+  return {
+    toolCallId: tc.toolCallId,
+    command,
+    output,
+    exitCode,
+    status: tc.isError ? "error" : tc.result ? "done" : "running",
+    seq: tc.seq
+  };
+}
 function normalizeWorkspaceFiles(raw) {
   const normalized = {};
   for (const [path, file] of Object.entries(raw || {})) {
@@ -390,6 +421,15 @@ function useChat(options = {}) {
   const [files, setFiles] = useState({});
   const [todos, setTodos] = useState([]);
   const [presentedFile, setPresentedFile] = useState(null);
+  const sandboxCommands = useMemo2(() => {
+    const commands = [];
+    for (const message of messages) {
+      for (const tc of message.toolCalls ?? []) {
+        if (tc.toolName === "execute") commands.push(parseSandboxCommand(tc));
+      }
+    }
+    return commands;
+  }, [messages]);
   const abortControllerRef = useRef(null);
   const loadedThreadIdRef = useRef(void 0);
   const voiceThreadRef = useRef(threadId);
@@ -865,6 +905,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", {
@@ -1053,6 +1105,7 @@ function useChat(options = {}) {
     presentedFile,
     dismissPresentedFile,
     openWorkspaceFile,
+    sandboxCommands,
     stop,
     reload,
     clear,
@@ -1975,6 +2028,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 +2077,7 @@ import {
   getLogLevel,
   isLevelEnabled
 } from "@personaai/logger";
-var VERSION = "0.7.3";
+var VERSION = "0.7.10";
 export {
   PersonaProvider,
   VERSION,
@@ -1998,6 +2092,7 @@ export {
   useChat,
   useConnection,
   useFiles,
+  useMcp,
   useMcpConnections,
   useMemory,
   usePersonaContext,