@personaai/react 0.5.1 → 0.5.4

package/dist/index.d.cts

@@ -1,7 +1,9 @@
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
+import { LogLevel, Logger } from '@personaai/logger';
+export { CreateLoggerOptions, LogLevel, LogTransport, Logger, createLogger, createNoopLogger, getLogLevel, isLevelEnabled, setLogLevel } from '@personaai/logger';
 
-type PersonaRole = 'user' | 'assistant' | 'system' | 'reasoning';
+type PersonaRole = "user" | "assistant" | "system" | "reasoning";
 /**
  * A reasoning (chain-of-thought) message, streamed ahead of the assistant's
  * answer. Each provider reasoning phase is its OWN message — the SDK never
@@ -10,7 +12,7 @@ type PersonaRole = 'user' | 'assistant' | 'system' | 'reasoning';
  */
 /** One live update on a running `task` (subagent) tool call's timeline. */
 interface PersonaSubagentActivityEntry {
-    kind: 'text' | 'tool_start' | 'tool_result';
+    kind: "text" | "tool_start" | "tool_result";
     toolName?: string;
     args?: string;
     result?: string;
@@ -22,6 +24,13 @@ interface PersonaToolCall {
     args?: string;
     result?: string;
     isError?: boolean;
+    /**
+     * Monotonic stream-order index, assigned when the call's first chunk
+     * arrives. Reasoning phases and tool calls share the same counter, so a
+     * client can interleave them chronologically (thought → tool → thought →
+     * tool → answer). Absent on calls loaded from history.
+     */
+    seq?: number;
     /** Nested activity timeline — only present on `task` (subagent) tool calls. */
     subagentActivity?: PersonaSubagentActivityEntry[];
 }
@@ -32,6 +41,12 @@ interface PersonaMessage {
     createdAt: Date;
     isStreaming?: boolean;
     toolCalls?: PersonaToolCall[];
+    /**
+     * Monotonic stream-order index for `role: 'reasoning'` messages, from the
+     * same counter as `PersonaToolCall.seq` — lets clients place each reasoning
+     * phase in its chronological spot relative to the tool calls that bracket it.
+     */
+    seq?: number;
     /**
      * @deprecated Model reasoning now streams as its own `role: 'reasoning'`
      * messages (one per phase, never merged). These fields are retained for
@@ -53,17 +68,17 @@ interface PersonaClarificationQuestion {
 }
 /** A paused human-in-the-loop tool approval, or a paused clarification question. */
 type PersonaInterrupt = {
-    kind: 'hitl';
+    kind: "hitl";
     actionRequests: PersonaHitlActionRequest[];
     reviewConfigs: unknown[];
 } | {
-    kind: 'clarification';
+    kind: "clarification";
     questions: PersonaClarificationQuestion[];
 };
 /** What to send back in `sendMessage(content, { resume })` to unpause a paused run. */
 type PersonaResumeValue = {
     decisions: Array<{
-        type: 'approve' | 'reject';
+        type: "approve" | "reject";
         message?: string;
     }>;
 } | {
@@ -99,6 +114,10 @@ interface PersonaProviderProps {
     getAuthToken?: () => Promise<string | null | undefined> | string | null | undefined;
     /** Default Agent ID to direct chat conversations to */
     defaultAgentId?: string;
+    /** Log level for the React SDK — off by default. */
+    logLevel?: LogLevel;
+    /** Custom logger instance — when provided, `logLevel` is ignored. */
+    logger?: Logger;
     children: ReactNode;
 }
 interface PersonaThread {
@@ -127,7 +146,7 @@ interface PersonaFileItem {
     createdAt: string;
 }
 interface PersonaMemoryFile {
-    scope?: 'user' | 'agent';
+    scope?: "user" | "agent";
     agentId?: string;
     path: string;
     content: string;
@@ -154,34 +173,34 @@ interface PersonaMemoryList {
  * and `REASONING_END` rather than `REASONING_MESSAGE_END`).
  */
 type PersonaStreamingEvent = {
-    type: 'TEXT_MESSAGE_CHUNK';
+    type: "TEXT_MESSAGE_CHUNK";
     delta: string;
     messageId?: string;
-    role?: 'assistant';
+    role?: "assistant";
 } | {
-    type: 'TOOL_CALL_CHUNK';
+    type: "TOOL_CALL_CHUNK";
     toolCallId?: string;
     toolCallName?: string;
     delta?: string;
     parentMessageId?: string;
 } | {
-    type: 'TOOL_CALL_RESULT';
+    type: "TOOL_CALL_RESULT";
     toolCallId: string;
     content: string;
     messageId?: string;
-    role?: 'tool';
+    role?: "tool";
     structuredContent?: unknown;
 } | {
-    type: 'REASONING_MESSAGE_START';
+    type: "REASONING_MESSAGE_START";
     messageId: string;
 } | {
-    type: 'REASONING_MESSAGE_CONTENT';
+    type: "REASONING_MESSAGE_CONTENT";
     messageId: string;
     delta: string;
 } | {
-    type: 'REASONING_END';
+    type: "REASONING_END";
 } | {
-    type: 'STATE_SNAPSHOT';
+    type: "STATE_SNAPSHOT";
     /** Raw wire shape (snake_case timestamps) — useChat normalizes this into `files`/`todos`. */
     snapshot: {
         files: Record<string, {
@@ -193,41 +212,41 @@ type PersonaStreamingEvent = {
         todos: PersonaTodo[];
     };
 } | {
-    type: 'RUN_ERROR';
+    type: "RUN_ERROR";
     code: string;
     message: string;
     retryable?: boolean;
     providerName?: string;
 } | {
-    type: 'CUSTOM';
-    name: 'hitl_request';
+    type: "CUSTOM";
+    name: "hitl_request";
     value: {
         actionRequests: PersonaHitlActionRequest[];
         reviewConfigs: unknown[];
     };
 } | {
-    type: 'CUSTOM';
-    name: 'clarification_request';
+    type: "CUSTOM";
+    name: "clarification_request";
     value: {
         questions: PersonaClarificationQuestion[];
         currentIndex: number;
     };
 } | {
-    type: 'CUSTOM';
-    name: 'subagent_activity';
+    type: "CUSTOM";
+    name: "subagent_activity";
     value: {
         toolCallId: string;
     } & PersonaSubagentActivityEntry;
 } | {
-    type: 'CUSTOM';
-    name: 'mcp_app';
+    type: "CUSTOM";
+    name: "mcp_app";
     value: {
         toolCallId: string;
         resourceUri: string;
         mcpId: string;
     };
 } | {
-    type: 'CUSTOM';
+    type: "CUSTOM";
     name: string & {};
     value: unknown;
 };
@@ -262,8 +281,9 @@ interface PersonaContextValue {
     getAuthToken?: () => Promise<string | null | undefined> | string | null | undefined;
     defaultAgentId?: string;
     fetchWithAuth: (path: string, init?: RequestInit) => Promise<Response>;
+    logger: Logger;
 }
-declare function PersonaProvider({ baseUrl, getAuthToken, defaultAgentId, children, }: PersonaProviderProps): react__default.JSX.Element;
+declare function PersonaProvider({ baseUrl, getAuthToken, defaultAgentId, logLevel, logger: loggerProp, children, }: PersonaProviderProps): react__default.JSX.Element;
 declare function usePersonaContext(): PersonaContextValue;
 
 declare function useChat(options?: UseChatOptions): {
@@ -481,6 +501,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.4.0";
+declare const VERSION = "0.5.4";
 
 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 PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendMessageOverride, type UseChatOptions, type UseMcpConnectionsOptions, VERSION, openSSEStream, supportsStreamingFetch, useAgents, useChat, useConnection, useFiles, useMcpConnections, useMemory, usePersonaContext, useThreads };

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
+import { LogLevel, Logger } from '@personaai/logger';
+export { CreateLoggerOptions, LogLevel, LogTransport, Logger, createLogger, createNoopLogger, getLogLevel, isLevelEnabled, setLogLevel } from '@personaai/logger';
 
-type PersonaRole = 'user' | 'assistant' | 'system' | 'reasoning';
+type PersonaRole = "user" | "assistant" | "system" | "reasoning";
 /**
  * A reasoning (chain-of-thought) message, streamed ahead of the assistant's
  * answer. Each provider reasoning phase is its OWN message — the SDK never
@@ -10,7 +12,7 @@ type PersonaRole = 'user' | 'assistant' | 'system' | 'reasoning';
  */
 /** One live update on a running `task` (subagent) tool call's timeline. */
 interface PersonaSubagentActivityEntry {
-    kind: 'text' | 'tool_start' | 'tool_result';
+    kind: "text" | "tool_start" | "tool_result";
     toolName?: string;
     args?: string;
     result?: string;
@@ -22,6 +24,13 @@ interface PersonaToolCall {
     args?: string;
     result?: string;
     isError?: boolean;
+    /**
+     * Monotonic stream-order index, assigned when the call's first chunk
+     * arrives. Reasoning phases and tool calls share the same counter, so a
+     * client can interleave them chronologically (thought → tool → thought →
+     * tool → answer). Absent on calls loaded from history.
+     */
+    seq?: number;
     /** Nested activity timeline — only present on `task` (subagent) tool calls. */
     subagentActivity?: PersonaSubagentActivityEntry[];
 }
@@ -32,6 +41,12 @@ interface PersonaMessage {
     createdAt: Date;
     isStreaming?: boolean;
     toolCalls?: PersonaToolCall[];
+    /**
+     * Monotonic stream-order index for `role: 'reasoning'` messages, from the
+     * same counter as `PersonaToolCall.seq` — lets clients place each reasoning
+     * phase in its chronological spot relative to the tool calls that bracket it.
+     */
+    seq?: number;
     /**
      * @deprecated Model reasoning now streams as its own `role: 'reasoning'`
      * messages (one per phase, never merged). These fields are retained for
@@ -53,17 +68,17 @@ interface PersonaClarificationQuestion {
 }
 /** A paused human-in-the-loop tool approval, or a paused clarification question. */
 type PersonaInterrupt = {
-    kind: 'hitl';
+    kind: "hitl";
     actionRequests: PersonaHitlActionRequest[];
     reviewConfigs: unknown[];
 } | {
-    kind: 'clarification';
+    kind: "clarification";
     questions: PersonaClarificationQuestion[];
 };
 /** What to send back in `sendMessage(content, { resume })` to unpause a paused run. */
 type PersonaResumeValue = {
     decisions: Array<{
-        type: 'approve' | 'reject';
+        type: "approve" | "reject";
         message?: string;
     }>;
 } | {
@@ -99,6 +114,10 @@ interface PersonaProviderProps {
     getAuthToken?: () => Promise<string | null | undefined> | string | null | undefined;
     /** Default Agent ID to direct chat conversations to */
     defaultAgentId?: string;
+    /** Log level for the React SDK — off by default. */
+    logLevel?: LogLevel;
+    /** Custom logger instance — when provided, `logLevel` is ignored. */
+    logger?: Logger;
     children: ReactNode;
 }
 interface PersonaThread {
@@ -127,7 +146,7 @@ interface PersonaFileItem {
     createdAt: string;
 }
 interface PersonaMemoryFile {
-    scope?: 'user' | 'agent';
+    scope?: "user" | "agent";
     agentId?: string;
     path: string;
     content: string;
@@ -154,34 +173,34 @@ interface PersonaMemoryList {
  * and `REASONING_END` rather than `REASONING_MESSAGE_END`).
  */
 type PersonaStreamingEvent = {
-    type: 'TEXT_MESSAGE_CHUNK';
+    type: "TEXT_MESSAGE_CHUNK";
     delta: string;
     messageId?: string;
-    role?: 'assistant';
+    role?: "assistant";
 } | {
-    type: 'TOOL_CALL_CHUNK';
+    type: "TOOL_CALL_CHUNK";
     toolCallId?: string;
     toolCallName?: string;
     delta?: string;
     parentMessageId?: string;
 } | {
-    type: 'TOOL_CALL_RESULT';
+    type: "TOOL_CALL_RESULT";
     toolCallId: string;
     content: string;
     messageId?: string;
-    role?: 'tool';
+    role?: "tool";
     structuredContent?: unknown;
 } | {
-    type: 'REASONING_MESSAGE_START';
+    type: "REASONING_MESSAGE_START";
     messageId: string;
 } | {
-    type: 'REASONING_MESSAGE_CONTENT';
+    type: "REASONING_MESSAGE_CONTENT";
     messageId: string;
     delta: string;
 } | {
-    type: 'REASONING_END';
+    type: "REASONING_END";
 } | {
-    type: 'STATE_SNAPSHOT';
+    type: "STATE_SNAPSHOT";
     /** Raw wire shape (snake_case timestamps) — useChat normalizes this into `files`/`todos`. */
     snapshot: {
         files: Record<string, {
@@ -193,41 +212,41 @@ type PersonaStreamingEvent = {
         todos: PersonaTodo[];
     };
 } | {
-    type: 'RUN_ERROR';
+    type: "RUN_ERROR";
     code: string;
     message: string;
     retryable?: boolean;
     providerName?: string;
 } | {
-    type: 'CUSTOM';
-    name: 'hitl_request';
+    type: "CUSTOM";
+    name: "hitl_request";
     value: {
         actionRequests: PersonaHitlActionRequest[];
         reviewConfigs: unknown[];
     };
 } | {
-    type: 'CUSTOM';
-    name: 'clarification_request';
+    type: "CUSTOM";
+    name: "clarification_request";
     value: {
         questions: PersonaClarificationQuestion[];
         currentIndex: number;
     };
 } | {
-    type: 'CUSTOM';
-    name: 'subagent_activity';
+    type: "CUSTOM";
+    name: "subagent_activity";
     value: {
         toolCallId: string;
     } & PersonaSubagentActivityEntry;
 } | {
-    type: 'CUSTOM';
-    name: 'mcp_app';
+    type: "CUSTOM";
+    name: "mcp_app";
     value: {
         toolCallId: string;
         resourceUri: string;
         mcpId: string;
     };
 } | {
-    type: 'CUSTOM';
+    type: "CUSTOM";
     name: string & {};
     value: unknown;
 };
@@ -262,8 +281,9 @@ interface PersonaContextValue {
     getAuthToken?: () => Promise<string | null | undefined> | string | null | undefined;
     defaultAgentId?: string;
     fetchWithAuth: (path: string, init?: RequestInit) => Promise<Response>;
+    logger: Logger;
 }
-declare function PersonaProvider({ baseUrl, getAuthToken, defaultAgentId, children, }: PersonaProviderProps): react__default.JSX.Element;
+declare function PersonaProvider({ baseUrl, getAuthToken, defaultAgentId, logLevel, logger: loggerProp, children, }: PersonaProviderProps): react__default.JSX.Element;
 declare function usePersonaContext(): PersonaContextValue;
 
 declare function useChat(options?: UseChatOptions): {
@@ -481,6 +501,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.4.0";
+declare const VERSION = "0.5.4";
 
 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 PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendMessageOverride, type UseChatOptions, type UseMcpConnectionsOptions, VERSION, openSSEStream, supportsStreamingFetch, useAgents, useChat, useConnection, useFiles, useMcpConnections, useMemory, usePersonaContext, useThreads };