@personaai/react 0.18.0 → 0.19.0

package/dist/index.d.cts

@@ -292,6 +292,12 @@ type PersonaStreamingEvent = {
         resourceUri: string;
         mcpId: string;
     };
+} | {
+    type: "CUSTOM";
+    name: "mcp_auth_required";
+    value: {
+        servers: PersonaMcpAuthRequiredServer[];
+    };
 } | {
     type: "CUSTOM";
     name: "workflow_node_started";
@@ -332,6 +338,15 @@ interface UseChatOptions {
     onThreadCreated?: (threadId: string) => void;
     /** Called when the backend auto-generates a thread title (3-4 word LLM summary of first user message). */
     onTitle?: (title: string) => void;
+    /**
+     * Called at the start of a run when the Agent has `authMode: 'user'` MCP
+     * connectors this end user hasn't connected — their tools are dropped from
+     * the toolset server-side, so the model simply can't use them. Use this to
+     * show a "Connect your account" affordance; `useMcpConnections` returns
+     * each server's `authorizeUrl` for the actual consent redirect. Not called
+     * when every user-mode connector is connected.
+     */
+    onMcpAuthRequired?: (servers: PersonaMcpAuthRequiredServer[]) => void;
     /**
      * Pass the object returned by `useVoice()` (sharing the same `threadId`) to have `useChat`
      * merge live voice turns into `messages` automatically — one bubble per utterance, deduped
@@ -1163,6 +1178,17 @@ interface PersonaMcpOAuthInput {
     clientSecret: string;
     scopes?: string[];
 }
+/**
+ * One `authType: 'oauth', authMode: 'user'` MCP an Agent has attached whose
+ * tools were dropped for this end user because they haven't connected (or
+ * their grant was revoked/expired). Emitted as the `mcp_auth_required`
+ * CUSTOM stream event at the start of every run; see `onMcpAuthRequired`.
+ */
+interface PersonaMcpAuthRequiredServer {
+    mcpId: string;
+    name: string;
+    description?: string;
+}
 interface CreatePersonaMcpInput {
     name: string;
     transport: PersonaMcpTransport;
@@ -1261,6 +1287,16 @@ interface PersonaContextValue {
     fetchWithAuth: (path: string, init?: RequestInit) => Promise<Response>;
     logger: Logger;
 }
+/** Structured, trackable details of a non-ok API response. */
+interface PersonaHttpFailureInfo {
+    status: number;
+    code?: string;
+    message?: string;
+}
+/** A Response whose error body has been parsed and attached by fetchWithAuth. */
+interface PersonaFailureResponse extends Response {
+    personaError?: PersonaHttpFailureInfo;
+}
 declare function PersonaProvider({ baseUrl, getAuthToken, defaultAgentId, logLevel, logger: loggerProp, children, }: PersonaProviderProps): react__default.JSX.Element;
 declare function usePersonaContext(): PersonaContextValue;
 
@@ -1522,6 +1558,17 @@ declare function useConnection(autoCheck?: boolean): {
     checkHealth: () => Promise<PersonaHealthInfo | null>;
 };
 
+/**
+ * Why a user-mode MCP isn't usable, in increasing specificity over the bare
+ * `connected` boolean:
+ * - `connected` — a usable token row exists (may still be refreshed soon).
+ * - `expired` — a row exists but its access token is dead and there's no
+ *   refresh token to renew it; `authorizeUrl` is populated.
+ * - `needs_auth` — the provider rejected the stored grant (revoked or
+ *   expired refresh token); reconnecting is the only fix.
+ * - `not_connected` — this end user has never connected.
+ */
+type PersonaMcpConnectionStatus = "connected" | "expired" | "needs_auth" | "not_connected";
 /**
  * One `authType: 'oauth', authMode: 'user'` MCP an Agent has attached, and
  * whether the current end user has connected it yet. `authorizeUrl` is only
@@ -1534,6 +1581,17 @@ interface PersonaMcpConnection {
     name: string;
     description: string;
     connected: boolean;
+    /**
+     * Finer-grained than `connected` — tells "never connected" apart from
+     * "token expired" and "grant revoked", so the UI can say "Connect" vs.
+     * "Reconnect". Absent against backends predating this field; treat
+     * `undefined` as `connected ? "connected" : "not_connected"`.
+     */
+    status?: PersonaMcpConnectionStatus;
+    /** When the stored access token expires (ISO string), if the provider returned one. */
+    expiresAt?: string | null;
+    /** The provider's rejection reason when `status` is `needs_auth` (never contains tokens). */
+    lastError?: string | null;
     authorizeUrl: string | null;
 }
 interface UseMcpConnectionsOptions {
@@ -1835,6 +1893,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.18.0";
+declare const VERSION = "0.19.0";
 
-export { ARCHITECT_AGENT_ID, type CreatePersonaAgentInput, type CreatePersonaKnowledgeBaseInput, type CreatePersonaMcpInput, type CreatePersonaRcpSourceInput, type CreatePersonaSkillInput, type CreatePersonaWorkflowInput, type OpenSSEOptions, type PersonaAgent, type PersonaAgentCategory, type PersonaAgentMessageDelivery, type PersonaAgentSnapshot, type PersonaAgentSocialLinks, type PersonaAgentVisibility, type PersonaBulkDeleteResult, type PersonaClarificationQuestion, type PersonaDeleteDocumentResult, type PersonaFileItem, type PersonaHealthInfo, type PersonaHitlActionRequest, type PersonaInterrupt, type PersonaKnowledgeBase, type PersonaKnowledgeBaseUsage, type PersonaKnowledgeDocument, type PersonaKnowledgeSearchResult, type PersonaMcp, type PersonaMcpAuthMode, type PersonaMcpAuthType, type PersonaMcpConnection, type PersonaMcpOAuthConfig, type PersonaMcpOAuthInput, type PersonaMcpResourceSummary, type PersonaMcpResourceTemplate, type PersonaMcpTestConnectionResult, type PersonaMcpTool, type PersonaMcpTransport, type PersonaMemoryAgentGroup, type PersonaMemoryFile, type PersonaMemoryList, type PersonaMessage, type PersonaMessageChannel, type PersonaMessageDelivery, type PersonaNodeOnErrorAction, type PersonaNodeRetryPolicy, type PersonaNodeRun, type PersonaNodeRunState, type PersonaNodeRunStatus, type PersonaPagination, type PersonaPresentedFile, PersonaProvider, type PersonaProviderProps, type PersonaRcpParamContextMapEntry, type PersonaRcpSource, type PersonaRcpSourceTestResult, type PersonaRcpSourceToolParamSummary, type PersonaRcpSourceToolSummary, type PersonaResourceUsage, type PersonaResumeValue, type PersonaRole, type PersonaSandboxCommand, type PersonaSkill, type PersonaSkillFile, type PersonaSkillUsage, type PersonaStreamingEvent, type PersonaSubagentActivityEntry, type PersonaThread, type PersonaTodo, type PersonaToolCall, type PersonaUploadDocumentsResult, type PersonaVoiceEndReason, type PersonaVoiceState, type PersonaVoiceToolCall, type PersonaVoiceTranscriptLine, type PersonaWorkflow, type PersonaWorkflowDraft, type PersonaWorkflowEdge, type PersonaWorkflowNode, type PersonaWorkflowNodeData, type PersonaWorkflowNodeType, type PersonaWorkflowOwnerType, type PersonaWorkflowRun, type PersonaWorkflowRunStatus, type PersonaWorkflowTrigger, type PersonaWorkflowTriggerType, type PersonaWorkflowUsage, type PersonaWorkflowVersion, type PersonaWorkflowVisibility, type PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendArchitectMessageOverride, type SendMessageOverride, type SendPersonaAgentMessageInput, type SendPersonaMessageInput, type UpdatePersonaAgentInput, type UpdatePersonaKnowledgeBaseInput, type UpdatePersonaMcpInput, type UpdatePersonaRcpSourceInput, type UpdatePersonaSkillInput, type UpdatePersonaWorkflowInput, type UploadKnowledgeDocumentInput, type UseAgentsOptions, type UseArchitectChatOptions, type UseChatOptions, type UseKnowledgeBasesOptions, type UseMcpAdminOptions, type UseMcpConnectionsOptions, type UseMcpOptions, type UseMessagesResult, type UseRcpSourcesOptions, type UseSkillsOptions, type UseVoiceOptions, type UseVoiceResult, type UseWorkflowOptions, type UseWorkflowRunsOptions, type UseWorkflowStreamOptions, type UseWorkflowStreamResult, type UseWorkflowsOptions, VERSION, type WorkflowsPagination, openSSEStream, supportsStreamingFetch, useAgents, useArchitectChat, useChat, useConnection, useFiles, useKnowledgeBases, useMcp, useMcpAdmin, useMcpConnections, useMemory, useMessages, usePersonaContext, useRcpSources, useSkills, useThreads, useVoice, useWorkflow, useWorkflowRuns, useWorkflowStream, useWorkflows, useWorkspaceFiles };
+export { ARCHITECT_AGENT_ID, type CreatePersonaAgentInput, type CreatePersonaKnowledgeBaseInput, type CreatePersonaMcpInput, type CreatePersonaRcpSourceInput, type CreatePersonaSkillInput, type CreatePersonaWorkflowInput, type OpenSSEOptions, type PersonaAgent, type PersonaAgentCategory, type PersonaAgentMessageDelivery, type PersonaAgentSnapshot, type PersonaAgentSocialLinks, type PersonaAgentVisibility, type PersonaBulkDeleteResult, type PersonaClarificationQuestion, type PersonaDeleteDocumentResult, type PersonaFailureResponse, type PersonaFileItem, type PersonaHealthInfo, type PersonaHitlActionRequest, type PersonaHttpFailureInfo, type PersonaInterrupt, type PersonaKnowledgeBase, type PersonaKnowledgeBaseUsage, type PersonaKnowledgeDocument, type PersonaKnowledgeSearchResult, type PersonaMcp, type PersonaMcpAuthMode, type PersonaMcpAuthRequiredServer, type PersonaMcpAuthType, type PersonaMcpConnection, type PersonaMcpConnectionStatus, type PersonaMcpOAuthConfig, type PersonaMcpOAuthInput, type PersonaMcpResourceSummary, type PersonaMcpResourceTemplate, type PersonaMcpTestConnectionResult, type PersonaMcpTool, type PersonaMcpTransport, type PersonaMemoryAgentGroup, type PersonaMemoryFile, type PersonaMemoryList, type PersonaMessage, type PersonaMessageChannel, type PersonaMessageDelivery, type PersonaNodeOnErrorAction, type PersonaNodeRetryPolicy, type PersonaNodeRun, type PersonaNodeRunState, type PersonaNodeRunStatus, type PersonaPagination, type PersonaPresentedFile, PersonaProvider, type PersonaProviderProps, type PersonaRcpParamContextMapEntry, type PersonaRcpSource, type PersonaRcpSourceTestResult, type PersonaRcpSourceToolParamSummary, type PersonaRcpSourceToolSummary, type PersonaResourceUsage, type PersonaResumeValue, type PersonaRole, type PersonaSandboxCommand, type PersonaSkill, type PersonaSkillFile, type PersonaSkillUsage, type PersonaStreamingEvent, type PersonaSubagentActivityEntry, type PersonaThread, type PersonaTodo, type PersonaToolCall, type PersonaUploadDocumentsResult, type PersonaVoiceEndReason, type PersonaVoiceState, type PersonaVoiceToolCall, type PersonaVoiceTranscriptLine, type PersonaWorkflow, type PersonaWorkflowDraft, type PersonaWorkflowEdge, type PersonaWorkflowNode, type PersonaWorkflowNodeData, type PersonaWorkflowNodeType, type PersonaWorkflowOwnerType, type PersonaWorkflowRun, type PersonaWorkflowRunStatus, type PersonaWorkflowTrigger, type PersonaWorkflowTriggerType, type PersonaWorkflowUsage, type PersonaWorkflowVersion, type PersonaWorkflowVisibility, type PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendArchitectMessageOverride, type SendMessageOverride, type SendPersonaAgentMessageInput, type SendPersonaMessageInput, type UpdatePersonaAgentInput, type UpdatePersonaKnowledgeBaseInput, type UpdatePersonaMcpInput, type UpdatePersonaRcpSourceInput, type UpdatePersonaSkillInput, type UpdatePersonaWorkflowInput, type UploadKnowledgeDocumentInput, type UseAgentsOptions, type UseArchitectChatOptions, type UseChatOptions, type UseKnowledgeBasesOptions, type UseMcpAdminOptions, type UseMcpConnectionsOptions, type UseMcpOptions, type UseMessagesResult, type UseRcpSourcesOptions, type UseSkillsOptions, type UseVoiceOptions, type UseVoiceResult, type UseWorkflowOptions, type UseWorkflowRunsOptions, type UseWorkflowStreamOptions, type UseWorkflowStreamResult, type UseWorkflowsOptions, VERSION, type WorkflowsPagination, openSSEStream, supportsStreamingFetch, useAgents, useArchitectChat, useChat, useConnection, useFiles, useKnowledgeBases, useMcp, useMcpAdmin, useMcpConnections, useMemory, useMessages, usePersonaContext, useRcpSources, useSkills, useThreads, useVoice, useWorkflow, useWorkflowRuns, useWorkflowStream, useWorkflows, useWorkspaceFiles };

package/dist/index.d.ts

@@ -292,6 +292,12 @@ type PersonaStreamingEvent = {
         resourceUri: string;
         mcpId: string;
     };
+} | {
+    type: "CUSTOM";
+    name: "mcp_auth_required";
+    value: {
+        servers: PersonaMcpAuthRequiredServer[];
+    };
 } | {
     type: "CUSTOM";
     name: "workflow_node_started";
@@ -332,6 +338,15 @@ interface UseChatOptions {
     onThreadCreated?: (threadId: string) => void;
     /** Called when the backend auto-generates a thread title (3-4 word LLM summary of first user message). */
     onTitle?: (title: string) => void;
+    /**
+     * Called at the start of a run when the Agent has `authMode: 'user'` MCP
+     * connectors this end user hasn't connected — their tools are dropped from
+     * the toolset server-side, so the model simply can't use them. Use this to
+     * show a "Connect your account" affordance; `useMcpConnections` returns
+     * each server's `authorizeUrl` for the actual consent redirect. Not called
+     * when every user-mode connector is connected.
+     */
+    onMcpAuthRequired?: (servers: PersonaMcpAuthRequiredServer[]) => void;
     /**
      * Pass the object returned by `useVoice()` (sharing the same `threadId`) to have `useChat`
      * merge live voice turns into `messages` automatically — one bubble per utterance, deduped
@@ -1163,6 +1178,17 @@ interface PersonaMcpOAuthInput {
     clientSecret: string;
     scopes?: string[];
 }
+/**
+ * One `authType: 'oauth', authMode: 'user'` MCP an Agent has attached whose
+ * tools were dropped for this end user because they haven't connected (or
+ * their grant was revoked/expired). Emitted as the `mcp_auth_required`
+ * CUSTOM stream event at the start of every run; see `onMcpAuthRequired`.
+ */
+interface PersonaMcpAuthRequiredServer {
+    mcpId: string;
+    name: string;
+    description?: string;
+}
 interface CreatePersonaMcpInput {
     name: string;
     transport: PersonaMcpTransport;
@@ -1261,6 +1287,16 @@ interface PersonaContextValue {
     fetchWithAuth: (path: string, init?: RequestInit) => Promise<Response>;
     logger: Logger;
 }
+/** Structured, trackable details of a non-ok API response. */
+interface PersonaHttpFailureInfo {
+    status: number;
+    code?: string;
+    message?: string;
+}
+/** A Response whose error body has been parsed and attached by fetchWithAuth. */
+interface PersonaFailureResponse extends Response {
+    personaError?: PersonaHttpFailureInfo;
+}
 declare function PersonaProvider({ baseUrl, getAuthToken, defaultAgentId, logLevel, logger: loggerProp, children, }: PersonaProviderProps): react__default.JSX.Element;
 declare function usePersonaContext(): PersonaContextValue;
 
@@ -1522,6 +1558,17 @@ declare function useConnection(autoCheck?: boolean): {
     checkHealth: () => Promise<PersonaHealthInfo | null>;
 };
 
+/**
+ * Why a user-mode MCP isn't usable, in increasing specificity over the bare
+ * `connected` boolean:
+ * - `connected` — a usable token row exists (may still be refreshed soon).
+ * - `expired` — a row exists but its access token is dead and there's no
+ *   refresh token to renew it; `authorizeUrl` is populated.
+ * - `needs_auth` — the provider rejected the stored grant (revoked or
+ *   expired refresh token); reconnecting is the only fix.
+ * - `not_connected` — this end user has never connected.
+ */
+type PersonaMcpConnectionStatus = "connected" | "expired" | "needs_auth" | "not_connected";
 /**
  * One `authType: 'oauth', authMode: 'user'` MCP an Agent has attached, and
  * whether the current end user has connected it yet. `authorizeUrl` is only
@@ -1534,6 +1581,17 @@ interface PersonaMcpConnection {
     name: string;
     description: string;
     connected: boolean;
+    /**
+     * Finer-grained than `connected` — tells "never connected" apart from
+     * "token expired" and "grant revoked", so the UI can say "Connect" vs.
+     * "Reconnect". Absent against backends predating this field; treat
+     * `undefined` as `connected ? "connected" : "not_connected"`.
+     */
+    status?: PersonaMcpConnectionStatus;
+    /** When the stored access token expires (ISO string), if the provider returned one. */
+    expiresAt?: string | null;
+    /** The provider's rejection reason when `status` is `needs_auth` (never contains tokens). */
+    lastError?: string | null;
     authorizeUrl: string | null;
 }
 interface UseMcpConnectionsOptions {
@@ -1835,6 +1893,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.18.0";
+declare const VERSION = "0.19.0";
 
-export { ARCHITECT_AGENT_ID, type CreatePersonaAgentInput, type CreatePersonaKnowledgeBaseInput, type CreatePersonaMcpInput, type CreatePersonaRcpSourceInput, type CreatePersonaSkillInput, type CreatePersonaWorkflowInput, type OpenSSEOptions, type PersonaAgent, type PersonaAgentCategory, type PersonaAgentMessageDelivery, type PersonaAgentSnapshot, type PersonaAgentSocialLinks, type PersonaAgentVisibility, type PersonaBulkDeleteResult, type PersonaClarificationQuestion, type PersonaDeleteDocumentResult, type PersonaFileItem, type PersonaHealthInfo, type PersonaHitlActionRequest, type PersonaInterrupt, type PersonaKnowledgeBase, type PersonaKnowledgeBaseUsage, type PersonaKnowledgeDocument, type PersonaKnowledgeSearchResult, type PersonaMcp, type PersonaMcpAuthMode, type PersonaMcpAuthType, type PersonaMcpConnection, type PersonaMcpOAuthConfig, type PersonaMcpOAuthInput, type PersonaMcpResourceSummary, type PersonaMcpResourceTemplate, type PersonaMcpTestConnectionResult, type PersonaMcpTool, type PersonaMcpTransport, type PersonaMemoryAgentGroup, type PersonaMemoryFile, type PersonaMemoryList, type PersonaMessage, type PersonaMessageChannel, type PersonaMessageDelivery, type PersonaNodeOnErrorAction, type PersonaNodeRetryPolicy, type PersonaNodeRun, type PersonaNodeRunState, type PersonaNodeRunStatus, type PersonaPagination, type PersonaPresentedFile, PersonaProvider, type PersonaProviderProps, type PersonaRcpParamContextMapEntry, type PersonaRcpSource, type PersonaRcpSourceTestResult, type PersonaRcpSourceToolParamSummary, type PersonaRcpSourceToolSummary, type PersonaResourceUsage, type PersonaResumeValue, type PersonaRole, type PersonaSandboxCommand, type PersonaSkill, type PersonaSkillFile, type PersonaSkillUsage, type PersonaStreamingEvent, type PersonaSubagentActivityEntry, type PersonaThread, type PersonaTodo, type PersonaToolCall, type PersonaUploadDocumentsResult, type PersonaVoiceEndReason, type PersonaVoiceState, type PersonaVoiceToolCall, type PersonaVoiceTranscriptLine, type PersonaWorkflow, type PersonaWorkflowDraft, type PersonaWorkflowEdge, type PersonaWorkflowNode, type PersonaWorkflowNodeData, type PersonaWorkflowNodeType, type PersonaWorkflowOwnerType, type PersonaWorkflowRun, type PersonaWorkflowRunStatus, type PersonaWorkflowTrigger, type PersonaWorkflowTriggerType, type PersonaWorkflowUsage, type PersonaWorkflowVersion, type PersonaWorkflowVisibility, type PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendArchitectMessageOverride, type SendMessageOverride, type SendPersonaAgentMessageInput, type SendPersonaMessageInput, type UpdatePersonaAgentInput, type UpdatePersonaKnowledgeBaseInput, type UpdatePersonaMcpInput, type UpdatePersonaRcpSourceInput, type UpdatePersonaSkillInput, type UpdatePersonaWorkflowInput, type UploadKnowledgeDocumentInput, type UseAgentsOptions, type UseArchitectChatOptions, type UseChatOptions, type UseKnowledgeBasesOptions, type UseMcpAdminOptions, type UseMcpConnectionsOptions, type UseMcpOptions, type UseMessagesResult, type UseRcpSourcesOptions, type UseSkillsOptions, type UseVoiceOptions, type UseVoiceResult, type UseWorkflowOptions, type UseWorkflowRunsOptions, type UseWorkflowStreamOptions, type UseWorkflowStreamResult, type UseWorkflowsOptions, VERSION, type WorkflowsPagination, openSSEStream, supportsStreamingFetch, useAgents, useArchitectChat, useChat, useConnection, useFiles, useKnowledgeBases, useMcp, useMcpAdmin, useMcpConnections, useMemory, useMessages, usePersonaContext, useRcpSources, useSkills, useThreads, useVoice, useWorkflow, useWorkflowRuns, useWorkflowStream, useWorkflows, useWorkspaceFiles };
+export { ARCHITECT_AGENT_ID, type CreatePersonaAgentInput, type CreatePersonaKnowledgeBaseInput, type CreatePersonaMcpInput, type CreatePersonaRcpSourceInput, type CreatePersonaSkillInput, type CreatePersonaWorkflowInput, type OpenSSEOptions, type PersonaAgent, type PersonaAgentCategory, type PersonaAgentMessageDelivery, type PersonaAgentSnapshot, type PersonaAgentSocialLinks, type PersonaAgentVisibility, type PersonaBulkDeleteResult, type PersonaClarificationQuestion, type PersonaDeleteDocumentResult, type PersonaFailureResponse, type PersonaFileItem, type PersonaHealthInfo, type PersonaHitlActionRequest, type PersonaHttpFailureInfo, type PersonaInterrupt, type PersonaKnowledgeBase, type PersonaKnowledgeBaseUsage, type PersonaKnowledgeDocument, type PersonaKnowledgeSearchResult, type PersonaMcp, type PersonaMcpAuthMode, type PersonaMcpAuthRequiredServer, type PersonaMcpAuthType, type PersonaMcpConnection, type PersonaMcpConnectionStatus, type PersonaMcpOAuthConfig, type PersonaMcpOAuthInput, type PersonaMcpResourceSummary, type PersonaMcpResourceTemplate, type PersonaMcpTestConnectionResult, type PersonaMcpTool, type PersonaMcpTransport, type PersonaMemoryAgentGroup, type PersonaMemoryFile, type PersonaMemoryList, type PersonaMessage, type PersonaMessageChannel, type PersonaMessageDelivery, type PersonaNodeOnErrorAction, type PersonaNodeRetryPolicy, type PersonaNodeRun, type PersonaNodeRunState, type PersonaNodeRunStatus, type PersonaPagination, type PersonaPresentedFile, PersonaProvider, type PersonaProviderProps, type PersonaRcpParamContextMapEntry, type PersonaRcpSource, type PersonaRcpSourceTestResult, type PersonaRcpSourceToolParamSummary, type PersonaRcpSourceToolSummary, type PersonaResourceUsage, type PersonaResumeValue, type PersonaRole, type PersonaSandboxCommand, type PersonaSkill, type PersonaSkillFile, type PersonaSkillUsage, type PersonaStreamingEvent, type PersonaSubagentActivityEntry, type PersonaThread, type PersonaTodo, type PersonaToolCall, type PersonaUploadDocumentsResult, type PersonaVoiceEndReason, type PersonaVoiceState, type PersonaVoiceToolCall, type PersonaVoiceTranscriptLine, type PersonaWorkflow, type PersonaWorkflowDraft, type PersonaWorkflowEdge, type PersonaWorkflowNode, type PersonaWorkflowNodeData, type PersonaWorkflowNodeType, type PersonaWorkflowOwnerType, type PersonaWorkflowRun, type PersonaWorkflowRunStatus, type PersonaWorkflowTrigger, type PersonaWorkflowTriggerType, type PersonaWorkflowUsage, type PersonaWorkflowVersion, type PersonaWorkflowVisibility, type PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendArchitectMessageOverride, type SendMessageOverride, type SendPersonaAgentMessageInput, type SendPersonaMessageInput, type UpdatePersonaAgentInput, type UpdatePersonaKnowledgeBaseInput, type UpdatePersonaMcpInput, type UpdatePersonaRcpSourceInput, type UpdatePersonaSkillInput, type UpdatePersonaWorkflowInput, type UploadKnowledgeDocumentInput, type UseAgentsOptions, type UseArchitectChatOptions, type UseChatOptions, type UseKnowledgeBasesOptions, type UseMcpAdminOptions, type UseMcpConnectionsOptions, type UseMcpOptions, type UseMessagesResult, type UseRcpSourcesOptions, type UseSkillsOptions, type UseVoiceOptions, type UseVoiceResult, type UseWorkflowOptions, type UseWorkflowRunsOptions, type UseWorkflowStreamOptions, type UseWorkflowStreamResult, type UseWorkflowsOptions, VERSION, type WorkflowsPagination, openSSEStream, supportsStreamingFetch, useAgents, useArchitectChat, useChat, useConnection, useFiles, useKnowledgeBases, useMcp, useMcpAdmin, useMcpConnections, useMemory, useMessages, usePersonaContext, useRcpSources, useSkills, useThreads, useVoice, useWorkflow, useWorkflowRuns, useWorkflowStream, useWorkflows, useWorkspaceFiles };

package/dist/index.js

@@ -65,10 +65,33 @@ function PersonaProvider({
           ok: res.ok
         });
         if (!res.ok) {
+          const parsedResult = { isJson: false };
+          try {
+            const body = await res.clone().json();
+            if (body && typeof body === "object") {
+              const message = body.error?.message ?? body.message ?? void 0;
+              if (body.error?.code ?? message) {
+                parsedResult.isJson = true;
+                parsedResult.info = {
+                  status: res.status,
+                  code: body.error?.code,
+                  message
+                };
+              }
+            }
+          } catch {
+          }
           logger.warn("fetchWithAuth non-ok", {
             path: cleanPath,
-            status: res.status
+            status: res.status,
+            ...parsedResult.info ?? {}
           });
+          if (parsedResult.info) {
+            try {
+              res.personaError = parsedResult.info;
+            } catch {
+            }
+          }
         } else {
           logger.info("fetchWithAuth succeeded", {
             path: cleanPath,
@@ -364,6 +387,14 @@ function normalizePendingInterrupt(pending) {
 }
 
 // src/hooks/useChat.ts
+function httpFailure(res, what) {
+  const info = res.personaError;
+  if (!info || !info.code && !info.message) {
+    return new Error(`Failed to ${what}: ${res.statusText || res.status}`);
+  }
+  const parts = [info.status, info.code, info.message].filter(Boolean).join(", ");
+  return new Error(`Failed to ${what}: ${parts}`);
+}
 function parseSandboxCommand(tc) {
   let command = tc.args ?? "";
   try {
@@ -496,8 +527,7 @@ function useChat(options = {}) {
       setError(null);
       try {
         const res = await fetchWithAuth(`/threads/${id}/messages`);
-        if (!res.ok)
-          throw new Error(`Failed to load thread history: ${res.statusText}`);
+        if (!res.ok) throw httpFailure(res, "load thread history");
         const body = await res.json();
         const data = body?.data ?? body;
         const raw = data?.messages ?? [];
@@ -757,7 +787,7 @@ function useChat(options = {}) {
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({ agentId: targetAgentId })
           });
-          if (!createRes.ok) throw new Error(`Failed to create thread: ${createRes.statusText}`);
+          if (!createRes.ok) throw httpFailure(createRes, "create thread");
           const createBody = await createRes.json();
           const created = createBody?.data ?? createBody;
           resolvedThreadId = created._id ?? created.id;
@@ -933,6 +963,13 @@ function useChat(options = {}) {
                       patchAssistant({});
                     }
                   }
+                } else if (event.name === "mcp_auth_required") {
+                  const val = event.value;
+                  const servers = val?.servers ?? [];
+                  if (servers.length > 0) {
+                    chatLogger.info("mcp auth required", { mcpIds: servers.map((s) => s.mcpId) });
+                    options.onMcpAuthRequired?.(servers);
+                  }
                 }
               } else if (event.type === "title") {
                 const title = event.title;
@@ -2873,7 +2910,7 @@ function useMcpConnections(options = {}) {
           throw new Error(`Failed to disconnect MCP: ${res.statusText}`);
         setConnections(
           (prev) => prev.map(
-            (c) => c.mcpId === mcpId ? { ...c, connected: false, authorizeUrl: null } : c
+            (c) => c.mcpId === mcpId ? { ...c, connected: false, status: "not_connected", authorizeUrl: null } : c
           )
         );
         void fetchConnections();
@@ -4372,7 +4409,7 @@ import {
   getLogLevel,
   isLevelEnabled
 } from "@personaai/logger";
-var VERSION = "0.18.0";
+var VERSION = "0.19.0";
 export {
   ARCHITECT_AGENT_ID,
   PersonaProvider,