@cadraos/sdk 0.1.10 → 0.1.11-test
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/chat/index.cjs +157 -50
- package/dist/chat/index.cjs.map +1 -1
- package/dist/chat/index.d.cts +58 -23
- package/dist/chat/index.d.ts +58 -23
- package/dist/chat/index.js +156 -51
- package/dist/chat/index.js.map +1 -1
- package/dist/chat/styles.css +1 -0
- package/dist/index.cjs +52 -30
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +29 -29
- package/dist/index.d.ts +29 -29
- package/dist/index.js +49 -29
- package/dist/index.js.map +1 -1
- package/package.json +6 -2
package/dist/chat/index.d.cts
CHANGED
|
@@ -176,6 +176,14 @@ interface ExecutionStreamEvent {
|
|
|
176
176
|
[key: string]: unknown;
|
|
177
177
|
};
|
|
178
178
|
}
|
|
179
|
+
/**
|
|
180
|
+
* Tool call verbosity levels for controlling which tool calls are displayed
|
|
181
|
+
*
|
|
182
|
+
* - `"compact"` (default) — Hide internal/orchestration tools, show user-facing tools in compact style
|
|
183
|
+
* - `"verbose"` — Show all tools including internal ones (useful for debugging)
|
|
184
|
+
* - `"hidden"` — Hide all tool calls entirely
|
|
185
|
+
*/
|
|
186
|
+
type ToolCallVerbosity = "compact" | "verbose" | "hidden";
|
|
179
187
|
/**
|
|
180
188
|
* Theme mode options
|
|
181
189
|
*/
|
|
@@ -211,6 +219,8 @@ interface ChatMessageProps {
|
|
|
211
219
|
enableMarkdown?: boolean;
|
|
212
220
|
/** Whether to show tool calls */
|
|
213
221
|
showToolCalls?: boolean;
|
|
222
|
+
/** Tool call verbosity level (overrides showToolCalls when set) */
|
|
223
|
+
toolCallVerbosity?: ToolCallVerbosity;
|
|
214
224
|
/** Additional CSS classes */
|
|
215
225
|
className?: string;
|
|
216
226
|
/** Custom markdown component overrides */
|
|
@@ -243,7 +253,7 @@ interface ChatMessageProps {
|
|
|
243
253
|
* />
|
|
244
254
|
* ```
|
|
245
255
|
*/
|
|
246
|
-
declare function ChatMessage({ message, enableMarkdown, showToolCalls, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, }: ChatMessageProps): react_jsx_runtime.JSX.Element;
|
|
256
|
+
declare function ChatMessage({ message, enableMarkdown, showToolCalls, toolCallVerbosity, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, }: ChatMessageProps): react_jsx_runtime.JSX.Element;
|
|
247
257
|
|
|
248
258
|
interface MessageListProps {
|
|
249
259
|
/** Array of messages to display */
|
|
@@ -271,6 +281,8 @@ interface MessageListProps {
|
|
|
271
281
|
enableMarkdown?: boolean;
|
|
272
282
|
/** Whether to show tool calls */
|
|
273
283
|
showToolCalls?: boolean;
|
|
284
|
+
/** Tool call verbosity level */
|
|
285
|
+
toolCallVerbosity?: ToolCallVerbosity;
|
|
274
286
|
/** Additional CSS classes */
|
|
275
287
|
className?: string;
|
|
276
288
|
/** Custom markdown component overrides */
|
|
@@ -307,7 +319,7 @@ interface MessageListProps {
|
|
|
307
319
|
* />
|
|
308
320
|
* ```
|
|
309
321
|
*/
|
|
310
|
-
declare function MessageList({ messages, welcomeMessage, renderWelcome, isLoading, isStreaming, isLoadingHistory, enableMarkdown, showToolCalls, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, sendMessage, }: MessageListProps): react_jsx_runtime.JSX.Element;
|
|
322
|
+
declare function MessageList({ messages, welcomeMessage, renderWelcome, isLoading, isStreaming, isLoadingHistory, enableMarkdown, showToolCalls, toolCallVerbosity, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, sendMessage, }: MessageListProps): react_jsx_runtime.JSX.Element;
|
|
311
323
|
|
|
312
324
|
/**
|
|
313
325
|
* Common types shared across all resources
|
|
@@ -1234,6 +1246,16 @@ interface AgentChatProps {
|
|
|
1234
1246
|
enableMarkdown?: boolean;
|
|
1235
1247
|
/** Show tool call visualization */
|
|
1236
1248
|
showToolCalls?: boolean;
|
|
1249
|
+
/**
|
|
1250
|
+
* Tool call verbosity level
|
|
1251
|
+
*
|
|
1252
|
+
* - `"compact"` (default) — Hide internal tools, show user-facing tools in compact style when completed
|
|
1253
|
+
* - `"verbose"` — Show all tools including internal ones (debugging)
|
|
1254
|
+
* - `"hidden"` — Hide all tool calls
|
|
1255
|
+
*
|
|
1256
|
+
* When `showToolCalls={false}`, this is automatically set to `"hidden"`.
|
|
1257
|
+
*/
|
|
1258
|
+
toolCallVerbosity?: ToolCallVerbosity;
|
|
1237
1259
|
/** Custom markdown component overrides (e.g., for artifact rendering) */
|
|
1238
1260
|
markdownComponents?: MessageListProps["markdownComponents"];
|
|
1239
1261
|
/** Custom URL transform for markdown (e.g., to preserve artifact: protocol) */
|
|
@@ -1268,7 +1290,7 @@ interface AgentChatProps {
|
|
|
1268
1290
|
* />
|
|
1269
1291
|
* ```
|
|
1270
1292
|
*/
|
|
1271
|
-
declare function AgentChat({ agentId, teamId, sessionId, adapter, onMessage, onError, onSessionCreated, onSessionStart, onToolCall, onToolResult, onClarification, initialMessages, placeholder, welcomeMessage, renderWelcome, maxHeight, className, theme, enableAttachments, enableMarkdown, showToolCalls, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, }: AgentChatProps): react_jsx_runtime.JSX.Element;
|
|
1293
|
+
declare function AgentChat({ agentId, teamId, sessionId, adapter, onMessage, onError, onSessionCreated, onSessionStart, onToolCall, onToolResult, onClarification, initialMessages, placeholder, welcomeMessage, renderWelcome, maxHeight, className, theme, enableAttachments, enableMarkdown, showToolCalls, toolCallVerbosity, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, }: AgentChatProps): react_jsx_runtime.JSX.Element;
|
|
1272
1294
|
|
|
1273
1295
|
/**
|
|
1274
1296
|
* Retry utility with exponential backoff
|
|
@@ -2622,17 +2644,17 @@ declare class SessionsAPI extends BaseResourceAPI {
|
|
|
2622
2644
|
}
|
|
2623
2645
|
|
|
2624
2646
|
/**
|
|
2625
|
-
*
|
|
2647
|
+
* Cadra Client
|
|
2626
2648
|
*
|
|
2627
2649
|
* Main entry point for the SDK. Provides access to all resource APIs.
|
|
2628
2650
|
*
|
|
2629
2651
|
* @example
|
|
2630
2652
|
* ```typescript
|
|
2631
|
-
* import {
|
|
2653
|
+
* import { CadraClient } from '@cadraos/sdk';
|
|
2632
2654
|
*
|
|
2633
|
-
* const client = new
|
|
2634
|
-
* apiKey: process.env.
|
|
2635
|
-
* orgId: Number(process.env.
|
|
2655
|
+
* const client = new CadraClient({
|
|
2656
|
+
* apiKey: process.env.CADRA_API_KEY,
|
|
2657
|
+
* orgId: Number(process.env.CADRA_ORG_ID),
|
|
2636
2658
|
* });
|
|
2637
2659
|
*
|
|
2638
2660
|
* // List agents
|
|
@@ -2658,12 +2680,12 @@ declare class SessionsAPI extends BaseResourceAPI {
|
|
|
2658
2680
|
/**
|
|
2659
2681
|
* Client options for API key authentication
|
|
2660
2682
|
*/
|
|
2661
|
-
interface
|
|
2683
|
+
interface CadraClientOptionsApiKey {
|
|
2662
2684
|
/** API key for authentication */
|
|
2663
2685
|
apiKey: string;
|
|
2664
2686
|
/** Organization ID */
|
|
2665
2687
|
orgId: number;
|
|
2666
|
-
/** Base URL for API (default: https://api.
|
|
2688
|
+
/** Base URL for API (default: https://api.cadraos.com) */
|
|
2667
2689
|
baseUrl?: string;
|
|
2668
2690
|
/** Request timeout in milliseconds (default: 30000) */
|
|
2669
2691
|
timeout?: number;
|
|
@@ -2675,12 +2697,12 @@ interface AISaaSClientOptionsApiKey {
|
|
|
2675
2697
|
/**
|
|
2676
2698
|
* Client options for OAuth token authentication
|
|
2677
2699
|
*/
|
|
2678
|
-
interface
|
|
2700
|
+
interface CadraClientOptionsToken {
|
|
2679
2701
|
/** OAuth token for authentication */
|
|
2680
2702
|
token: string;
|
|
2681
2703
|
/** Organization ID */
|
|
2682
2704
|
orgId: number;
|
|
2683
|
-
/** Base URL for API (default: https://api.
|
|
2705
|
+
/** Base URL for API (default: https://api.cadraos.com) */
|
|
2684
2706
|
baseUrl?: string;
|
|
2685
2707
|
/** Request timeout in milliseconds (default: 30000) */
|
|
2686
2708
|
timeout?: number;
|
|
@@ -2692,12 +2714,12 @@ interface AISaaSClientOptionsToken {
|
|
|
2692
2714
|
/**
|
|
2693
2715
|
* Client options for token provider authentication
|
|
2694
2716
|
*/
|
|
2695
|
-
interface
|
|
2717
|
+
interface CadraClientOptionsTokenProvider {
|
|
2696
2718
|
/** Token provider callback (called before each request) */
|
|
2697
2719
|
tokenProvider: () => Promise<string>;
|
|
2698
2720
|
/** Organization ID */
|
|
2699
2721
|
orgId: number;
|
|
2700
|
-
/** Base URL for API (default: https://api.
|
|
2722
|
+
/** Base URL for API (default: https://api.cadraos.com) */
|
|
2701
2723
|
baseUrl?: string;
|
|
2702
2724
|
/** Request timeout in milliseconds (default: 30000) */
|
|
2703
2725
|
timeout?: number;
|
|
@@ -2709,14 +2731,14 @@ interface AISaaSClientOptionsTokenProvider {
|
|
|
2709
2731
|
/**
|
|
2710
2732
|
* All client options
|
|
2711
2733
|
*/
|
|
2712
|
-
type
|
|
2734
|
+
type CadraClientOptions = CadraClientOptionsApiKey | CadraClientOptionsToken | CadraClientOptionsTokenProvider;
|
|
2713
2735
|
/**
|
|
2714
2736
|
* AI SaaS Client
|
|
2715
2737
|
*
|
|
2716
2738
|
* Main class for interacting with the AI SaaS API.
|
|
2717
2739
|
* Provides access to all resource APIs (agents, skills, tools, artifacts, sessions).
|
|
2718
2740
|
*/
|
|
2719
|
-
declare class
|
|
2741
|
+
declare class CadraClient {
|
|
2720
2742
|
private readonly httpClient;
|
|
2721
2743
|
private readonly config;
|
|
2722
2744
|
/**
|
|
@@ -2747,25 +2769,25 @@ declare class AISaaSClient {
|
|
|
2747
2769
|
* @example
|
|
2748
2770
|
* ```typescript
|
|
2749
2771
|
* // API key authentication
|
|
2750
|
-
* const client = new
|
|
2772
|
+
* const client = new CadraClient({
|
|
2751
2773
|
* apiKey: 'sk_...',
|
|
2752
2774
|
* orgId: 123,
|
|
2753
2775
|
* });
|
|
2754
2776
|
*
|
|
2755
2777
|
* // OAuth token authentication
|
|
2756
|
-
* const client = new
|
|
2778
|
+
* const client = new CadraClient({
|
|
2757
2779
|
* token: 'eyJ...',
|
|
2758
2780
|
* orgId: 123,
|
|
2759
2781
|
* });
|
|
2760
2782
|
*
|
|
2761
2783
|
* // Token provider (for automatic refresh)
|
|
2762
|
-
* const client = new
|
|
2784
|
+
* const client = new CadraClient({
|
|
2763
2785
|
* tokenProvider: async () => myAuth.getAccessToken(),
|
|
2764
2786
|
* orgId: 123,
|
|
2765
2787
|
* });
|
|
2766
2788
|
* ```
|
|
2767
2789
|
*/
|
|
2768
|
-
constructor(options:
|
|
2790
|
+
constructor(options: CadraClientOptions);
|
|
2769
2791
|
/**
|
|
2770
2792
|
* Validate client options
|
|
2771
2793
|
*/
|
|
@@ -2788,7 +2810,7 @@ interface DefaultAdapterConfig {
|
|
|
2788
2810
|
/**
|
|
2789
2811
|
* Pre-constructed CadraClient (takes priority over individual options)
|
|
2790
2812
|
*/
|
|
2791
|
-
client?:
|
|
2813
|
+
client?: CadraClient;
|
|
2792
2814
|
/**
|
|
2793
2815
|
* Base URL for the API
|
|
2794
2816
|
* @example "https://api.example.com/v1"
|
|
@@ -3226,6 +3248,17 @@ interface ChatInputProps {
|
|
|
3226
3248
|
*/
|
|
3227
3249
|
declare function ChatInput({ onSend, onStop, placeholder, disabled, isLoading, enableAttachments, attachments, onRemoveAttachment, dropZoneRef, isUploadingAttachments, className, }: ChatInputProps): react_jsx_runtime.JSX.Element;
|
|
3228
3250
|
|
|
3251
|
+
/**
|
|
3252
|
+
* Tool name patterns for internal/orchestration tools that should be hidden
|
|
3253
|
+
* in compact verbosity mode. These are matched after stripping common prefixes
|
|
3254
|
+
* (e.g., `team_api_handoff_to_agent` → `handoff_to_agent`).
|
|
3255
|
+
*/
|
|
3256
|
+
declare const INTERNAL_TOOL_NAMES: Set<string>;
|
|
3257
|
+
/**
|
|
3258
|
+
* Check if a tool name is an internal/orchestration tool.
|
|
3259
|
+
* Strips common prefixes before matching (e.g., `team_api_handoff_to_agent` → matches `handoff_to_agent`).
|
|
3260
|
+
*/
|
|
3261
|
+
declare function isInternalTool(toolName: string): boolean;
|
|
3229
3262
|
interface ToolCallEntryProps {
|
|
3230
3263
|
/** Tool call data */
|
|
3231
3264
|
toolCall: ToolCall;
|
|
@@ -3239,6 +3272,8 @@ interface ToolCallEntryProps {
|
|
|
3239
3272
|
alt?: string;
|
|
3240
3273
|
filename?: string;
|
|
3241
3274
|
}) => void;
|
|
3275
|
+
/** Render in compact single-line style (for completed tools in compact verbosity) */
|
|
3276
|
+
compact?: boolean;
|
|
3242
3277
|
}
|
|
3243
3278
|
/**
|
|
3244
3279
|
* Displays a single tool call with status and expandable details
|
|
@@ -3257,7 +3292,7 @@ interface ToolCallEntryProps {
|
|
|
3257
3292
|
* />
|
|
3258
3293
|
* ```
|
|
3259
3294
|
*/
|
|
3260
|
-
declare function ToolCallEntry({ toolCall, className, showFullJson, onImageClick, }: ToolCallEntryProps): react_jsx_runtime.JSX.Element;
|
|
3295
|
+
declare function ToolCallEntry({ toolCall, className, showFullJson, onImageClick, compact, }: ToolCallEntryProps): react_jsx_runtime.JSX.Element;
|
|
3261
3296
|
|
|
3262
3297
|
interface AskUserPromptProps {
|
|
3263
3298
|
/** The question to display to the user */
|
|
@@ -3377,4 +3412,4 @@ declare function ClockIcon({ className, ...props }: IconProps): react_jsx_runtim
|
|
|
3377
3412
|
*/
|
|
3378
3413
|
declare function compressImage(file: File, targetSizeKB?: number): Promise<File>;
|
|
3379
3414
|
|
|
3380
|
-
export { AgentChat, type AgentChatProps, AlertCircleIcon, type Artifact$1 as Artifact, AskUserPrompt, type AskUserPromptProps, type AttachmentData, type AttachmentFile, BotIcon, type ChatAdapter, ChatConfigProvider, type ChatConfigProviderProps, ChatContainer, type ChatContainerProps, type ChatError, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageProps, type ChatMessage$1 as ChatMessageType, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, type ClarificationData, ClockIcon, CodeIcon, CopyIcon, DatabaseIcon, type DefaultAdapterConfig, DownloadIcon, type Execution, type ExecutionResult, type ExecutionStreamEvent, ExternalLinkIcon, FileDropZone, type FileDropZoneProps, type FileDropZoneRef, FileIcon, FileTextIcon, HelpCircleIcon, type HistoryMessage, type IconProps, ImageIcon, ImagesIcon, type ListSessionsInput, ListTodoIcon, LoadingSpinner, MarkdownContent, type MarkdownContentProps, Maximize2Icon, MessageCircleIcon, MessageList, type MessageListProps, Minimize2Icon, PaperclipIcon, SendIcon, type SendMessageInput$1 as SendMessageInput, type SendMessageOptions, type SessionHistory$1 as SessionHistory, type SessionList, type SessionListItem, SparklesIcon, type StartExecutionInput, StopCircleIcon, type ThemeMode, type ThinkingBlock, type TodoItem, TodoList, type TodoListProps, type ToolCall, ToolCallEntry, type ToolCallEntryProps, type UploadUrlInput, type UploadUrlResult, type UseAgentChatOptions, type UseAgentChatResult, type UseExecutionStreamOptions, type UseExecutionStreamResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments };
|
|
3415
|
+
export { AgentChat, type AgentChatProps, AlertCircleIcon, type Artifact$1 as Artifact, AskUserPrompt, type AskUserPromptProps, type AttachmentData, type AttachmentFile, BotIcon, type ChatAdapter, ChatConfigProvider, type ChatConfigProviderProps, ChatContainer, type ChatContainerProps, type ChatError, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageProps, type ChatMessage$1 as ChatMessageType, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, type ClarificationData, ClockIcon, CodeIcon, CopyIcon, DatabaseIcon, type DefaultAdapterConfig, DownloadIcon, type Execution, type ExecutionResult, type ExecutionStreamEvent, ExternalLinkIcon, FileDropZone, type FileDropZoneProps, type FileDropZoneRef, FileIcon, FileTextIcon, HelpCircleIcon, type HistoryMessage, INTERNAL_TOOL_NAMES, type IconProps, ImageIcon, ImagesIcon, type ListSessionsInput, ListTodoIcon, LoadingSpinner, MarkdownContent, type MarkdownContentProps, Maximize2Icon, MessageCircleIcon, MessageList, type MessageListProps, Minimize2Icon, PaperclipIcon, SendIcon, type SendMessageInput$1 as SendMessageInput, type SendMessageOptions, type SessionHistory$1 as SessionHistory, type SessionList, type SessionListItem, SparklesIcon, type StartExecutionInput, StopCircleIcon, type ThemeMode, type ThinkingBlock, type TodoItem, TodoList, type TodoListProps, type ToolCall, ToolCallEntry, type ToolCallEntryProps, type ToolCallVerbosity, type UploadUrlInput, type UploadUrlResult, type UseAgentChatOptions, type UseAgentChatResult, type UseExecutionStreamOptions, type UseExecutionStreamResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, isInternalTool, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments };
|
package/dist/chat/index.d.ts
CHANGED
|
@@ -176,6 +176,14 @@ interface ExecutionStreamEvent {
|
|
|
176
176
|
[key: string]: unknown;
|
|
177
177
|
};
|
|
178
178
|
}
|
|
179
|
+
/**
|
|
180
|
+
* Tool call verbosity levels for controlling which tool calls are displayed
|
|
181
|
+
*
|
|
182
|
+
* - `"compact"` (default) — Hide internal/orchestration tools, show user-facing tools in compact style
|
|
183
|
+
* - `"verbose"` — Show all tools including internal ones (useful for debugging)
|
|
184
|
+
* - `"hidden"` — Hide all tool calls entirely
|
|
185
|
+
*/
|
|
186
|
+
type ToolCallVerbosity = "compact" | "verbose" | "hidden";
|
|
179
187
|
/**
|
|
180
188
|
* Theme mode options
|
|
181
189
|
*/
|
|
@@ -211,6 +219,8 @@ interface ChatMessageProps {
|
|
|
211
219
|
enableMarkdown?: boolean;
|
|
212
220
|
/** Whether to show tool calls */
|
|
213
221
|
showToolCalls?: boolean;
|
|
222
|
+
/** Tool call verbosity level (overrides showToolCalls when set) */
|
|
223
|
+
toolCallVerbosity?: ToolCallVerbosity;
|
|
214
224
|
/** Additional CSS classes */
|
|
215
225
|
className?: string;
|
|
216
226
|
/** Custom markdown component overrides */
|
|
@@ -243,7 +253,7 @@ interface ChatMessageProps {
|
|
|
243
253
|
* />
|
|
244
254
|
* ```
|
|
245
255
|
*/
|
|
246
|
-
declare function ChatMessage({ message, enableMarkdown, showToolCalls, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, }: ChatMessageProps): react_jsx_runtime.JSX.Element;
|
|
256
|
+
declare function ChatMessage({ message, enableMarkdown, showToolCalls, toolCallVerbosity, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, }: ChatMessageProps): react_jsx_runtime.JSX.Element;
|
|
247
257
|
|
|
248
258
|
interface MessageListProps {
|
|
249
259
|
/** Array of messages to display */
|
|
@@ -271,6 +281,8 @@ interface MessageListProps {
|
|
|
271
281
|
enableMarkdown?: boolean;
|
|
272
282
|
/** Whether to show tool calls */
|
|
273
283
|
showToolCalls?: boolean;
|
|
284
|
+
/** Tool call verbosity level */
|
|
285
|
+
toolCallVerbosity?: ToolCallVerbosity;
|
|
274
286
|
/** Additional CSS classes */
|
|
275
287
|
className?: string;
|
|
276
288
|
/** Custom markdown component overrides */
|
|
@@ -307,7 +319,7 @@ interface MessageListProps {
|
|
|
307
319
|
* />
|
|
308
320
|
* ```
|
|
309
321
|
*/
|
|
310
|
-
declare function MessageList({ messages, welcomeMessage, renderWelcome, isLoading, isStreaming, isLoadingHistory, enableMarkdown, showToolCalls, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, sendMessage, }: MessageListProps): react_jsx_runtime.JSX.Element;
|
|
322
|
+
declare function MessageList({ messages, welcomeMessage, renderWelcome, isLoading, isStreaming, isLoadingHistory, enableMarkdown, showToolCalls, toolCallVerbosity, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, sendMessage, }: MessageListProps): react_jsx_runtime.JSX.Element;
|
|
311
323
|
|
|
312
324
|
/**
|
|
313
325
|
* Common types shared across all resources
|
|
@@ -1234,6 +1246,16 @@ interface AgentChatProps {
|
|
|
1234
1246
|
enableMarkdown?: boolean;
|
|
1235
1247
|
/** Show tool call visualization */
|
|
1236
1248
|
showToolCalls?: boolean;
|
|
1249
|
+
/**
|
|
1250
|
+
* Tool call verbosity level
|
|
1251
|
+
*
|
|
1252
|
+
* - `"compact"` (default) — Hide internal tools, show user-facing tools in compact style when completed
|
|
1253
|
+
* - `"verbose"` — Show all tools including internal ones (debugging)
|
|
1254
|
+
* - `"hidden"` — Hide all tool calls
|
|
1255
|
+
*
|
|
1256
|
+
* When `showToolCalls={false}`, this is automatically set to `"hidden"`.
|
|
1257
|
+
*/
|
|
1258
|
+
toolCallVerbosity?: ToolCallVerbosity;
|
|
1237
1259
|
/** Custom markdown component overrides (e.g., for artifact rendering) */
|
|
1238
1260
|
markdownComponents?: MessageListProps["markdownComponents"];
|
|
1239
1261
|
/** Custom URL transform for markdown (e.g., to preserve artifact: protocol) */
|
|
@@ -1268,7 +1290,7 @@ interface AgentChatProps {
|
|
|
1268
1290
|
* />
|
|
1269
1291
|
* ```
|
|
1270
1292
|
*/
|
|
1271
|
-
declare function AgentChat({ agentId, teamId, sessionId, adapter, onMessage, onError, onSessionCreated, onSessionStart, onToolCall, onToolResult, onClarification, initialMessages, placeholder, welcomeMessage, renderWelcome, maxHeight, className, theme, enableAttachments, enableMarkdown, showToolCalls, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, }: AgentChatProps): react_jsx_runtime.JSX.Element;
|
|
1293
|
+
declare function AgentChat({ agentId, teamId, sessionId, adapter, onMessage, onError, onSessionCreated, onSessionStart, onToolCall, onToolResult, onClarification, initialMessages, placeholder, welcomeMessage, renderWelcome, maxHeight, className, theme, enableAttachments, enableMarkdown, showToolCalls, toolCallVerbosity, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, }: AgentChatProps): react_jsx_runtime.JSX.Element;
|
|
1272
1294
|
|
|
1273
1295
|
/**
|
|
1274
1296
|
* Retry utility with exponential backoff
|
|
@@ -2622,17 +2644,17 @@ declare class SessionsAPI extends BaseResourceAPI {
|
|
|
2622
2644
|
}
|
|
2623
2645
|
|
|
2624
2646
|
/**
|
|
2625
|
-
*
|
|
2647
|
+
* Cadra Client
|
|
2626
2648
|
*
|
|
2627
2649
|
* Main entry point for the SDK. Provides access to all resource APIs.
|
|
2628
2650
|
*
|
|
2629
2651
|
* @example
|
|
2630
2652
|
* ```typescript
|
|
2631
|
-
* import {
|
|
2653
|
+
* import { CadraClient } from '@cadraos/sdk';
|
|
2632
2654
|
*
|
|
2633
|
-
* const client = new
|
|
2634
|
-
* apiKey: process.env.
|
|
2635
|
-
* orgId: Number(process.env.
|
|
2655
|
+
* const client = new CadraClient({
|
|
2656
|
+
* apiKey: process.env.CADRA_API_KEY,
|
|
2657
|
+
* orgId: Number(process.env.CADRA_ORG_ID),
|
|
2636
2658
|
* });
|
|
2637
2659
|
*
|
|
2638
2660
|
* // List agents
|
|
@@ -2658,12 +2680,12 @@ declare class SessionsAPI extends BaseResourceAPI {
|
|
|
2658
2680
|
/**
|
|
2659
2681
|
* Client options for API key authentication
|
|
2660
2682
|
*/
|
|
2661
|
-
interface
|
|
2683
|
+
interface CadraClientOptionsApiKey {
|
|
2662
2684
|
/** API key for authentication */
|
|
2663
2685
|
apiKey: string;
|
|
2664
2686
|
/** Organization ID */
|
|
2665
2687
|
orgId: number;
|
|
2666
|
-
/** Base URL for API (default: https://api.
|
|
2688
|
+
/** Base URL for API (default: https://api.cadraos.com) */
|
|
2667
2689
|
baseUrl?: string;
|
|
2668
2690
|
/** Request timeout in milliseconds (default: 30000) */
|
|
2669
2691
|
timeout?: number;
|
|
@@ -2675,12 +2697,12 @@ interface AISaaSClientOptionsApiKey {
|
|
|
2675
2697
|
/**
|
|
2676
2698
|
* Client options for OAuth token authentication
|
|
2677
2699
|
*/
|
|
2678
|
-
interface
|
|
2700
|
+
interface CadraClientOptionsToken {
|
|
2679
2701
|
/** OAuth token for authentication */
|
|
2680
2702
|
token: string;
|
|
2681
2703
|
/** Organization ID */
|
|
2682
2704
|
orgId: number;
|
|
2683
|
-
/** Base URL for API (default: https://api.
|
|
2705
|
+
/** Base URL for API (default: https://api.cadraos.com) */
|
|
2684
2706
|
baseUrl?: string;
|
|
2685
2707
|
/** Request timeout in milliseconds (default: 30000) */
|
|
2686
2708
|
timeout?: number;
|
|
@@ -2692,12 +2714,12 @@ interface AISaaSClientOptionsToken {
|
|
|
2692
2714
|
/**
|
|
2693
2715
|
* Client options for token provider authentication
|
|
2694
2716
|
*/
|
|
2695
|
-
interface
|
|
2717
|
+
interface CadraClientOptionsTokenProvider {
|
|
2696
2718
|
/** Token provider callback (called before each request) */
|
|
2697
2719
|
tokenProvider: () => Promise<string>;
|
|
2698
2720
|
/** Organization ID */
|
|
2699
2721
|
orgId: number;
|
|
2700
|
-
/** Base URL for API (default: https://api.
|
|
2722
|
+
/** Base URL for API (default: https://api.cadraos.com) */
|
|
2701
2723
|
baseUrl?: string;
|
|
2702
2724
|
/** Request timeout in milliseconds (default: 30000) */
|
|
2703
2725
|
timeout?: number;
|
|
@@ -2709,14 +2731,14 @@ interface AISaaSClientOptionsTokenProvider {
|
|
|
2709
2731
|
/**
|
|
2710
2732
|
* All client options
|
|
2711
2733
|
*/
|
|
2712
|
-
type
|
|
2734
|
+
type CadraClientOptions = CadraClientOptionsApiKey | CadraClientOptionsToken | CadraClientOptionsTokenProvider;
|
|
2713
2735
|
/**
|
|
2714
2736
|
* AI SaaS Client
|
|
2715
2737
|
*
|
|
2716
2738
|
* Main class for interacting with the AI SaaS API.
|
|
2717
2739
|
* Provides access to all resource APIs (agents, skills, tools, artifacts, sessions).
|
|
2718
2740
|
*/
|
|
2719
|
-
declare class
|
|
2741
|
+
declare class CadraClient {
|
|
2720
2742
|
private readonly httpClient;
|
|
2721
2743
|
private readonly config;
|
|
2722
2744
|
/**
|
|
@@ -2747,25 +2769,25 @@ declare class AISaaSClient {
|
|
|
2747
2769
|
* @example
|
|
2748
2770
|
* ```typescript
|
|
2749
2771
|
* // API key authentication
|
|
2750
|
-
* const client = new
|
|
2772
|
+
* const client = new CadraClient({
|
|
2751
2773
|
* apiKey: 'sk_...',
|
|
2752
2774
|
* orgId: 123,
|
|
2753
2775
|
* });
|
|
2754
2776
|
*
|
|
2755
2777
|
* // OAuth token authentication
|
|
2756
|
-
* const client = new
|
|
2778
|
+
* const client = new CadraClient({
|
|
2757
2779
|
* token: 'eyJ...',
|
|
2758
2780
|
* orgId: 123,
|
|
2759
2781
|
* });
|
|
2760
2782
|
*
|
|
2761
2783
|
* // Token provider (for automatic refresh)
|
|
2762
|
-
* const client = new
|
|
2784
|
+
* const client = new CadraClient({
|
|
2763
2785
|
* tokenProvider: async () => myAuth.getAccessToken(),
|
|
2764
2786
|
* orgId: 123,
|
|
2765
2787
|
* });
|
|
2766
2788
|
* ```
|
|
2767
2789
|
*/
|
|
2768
|
-
constructor(options:
|
|
2790
|
+
constructor(options: CadraClientOptions);
|
|
2769
2791
|
/**
|
|
2770
2792
|
* Validate client options
|
|
2771
2793
|
*/
|
|
@@ -2788,7 +2810,7 @@ interface DefaultAdapterConfig {
|
|
|
2788
2810
|
/**
|
|
2789
2811
|
* Pre-constructed CadraClient (takes priority over individual options)
|
|
2790
2812
|
*/
|
|
2791
|
-
client?:
|
|
2813
|
+
client?: CadraClient;
|
|
2792
2814
|
/**
|
|
2793
2815
|
* Base URL for the API
|
|
2794
2816
|
* @example "https://api.example.com/v1"
|
|
@@ -3226,6 +3248,17 @@ interface ChatInputProps {
|
|
|
3226
3248
|
*/
|
|
3227
3249
|
declare function ChatInput({ onSend, onStop, placeholder, disabled, isLoading, enableAttachments, attachments, onRemoveAttachment, dropZoneRef, isUploadingAttachments, className, }: ChatInputProps): react_jsx_runtime.JSX.Element;
|
|
3228
3250
|
|
|
3251
|
+
/**
|
|
3252
|
+
* Tool name patterns for internal/orchestration tools that should be hidden
|
|
3253
|
+
* in compact verbosity mode. These are matched after stripping common prefixes
|
|
3254
|
+
* (e.g., `team_api_handoff_to_agent` → `handoff_to_agent`).
|
|
3255
|
+
*/
|
|
3256
|
+
declare const INTERNAL_TOOL_NAMES: Set<string>;
|
|
3257
|
+
/**
|
|
3258
|
+
* Check if a tool name is an internal/orchestration tool.
|
|
3259
|
+
* Strips common prefixes before matching (e.g., `team_api_handoff_to_agent` → matches `handoff_to_agent`).
|
|
3260
|
+
*/
|
|
3261
|
+
declare function isInternalTool(toolName: string): boolean;
|
|
3229
3262
|
interface ToolCallEntryProps {
|
|
3230
3263
|
/** Tool call data */
|
|
3231
3264
|
toolCall: ToolCall;
|
|
@@ -3239,6 +3272,8 @@ interface ToolCallEntryProps {
|
|
|
3239
3272
|
alt?: string;
|
|
3240
3273
|
filename?: string;
|
|
3241
3274
|
}) => void;
|
|
3275
|
+
/** Render in compact single-line style (for completed tools in compact verbosity) */
|
|
3276
|
+
compact?: boolean;
|
|
3242
3277
|
}
|
|
3243
3278
|
/**
|
|
3244
3279
|
* Displays a single tool call with status and expandable details
|
|
@@ -3257,7 +3292,7 @@ interface ToolCallEntryProps {
|
|
|
3257
3292
|
* />
|
|
3258
3293
|
* ```
|
|
3259
3294
|
*/
|
|
3260
|
-
declare function ToolCallEntry({ toolCall, className, showFullJson, onImageClick, }: ToolCallEntryProps): react_jsx_runtime.JSX.Element;
|
|
3295
|
+
declare function ToolCallEntry({ toolCall, className, showFullJson, onImageClick, compact, }: ToolCallEntryProps): react_jsx_runtime.JSX.Element;
|
|
3261
3296
|
|
|
3262
3297
|
interface AskUserPromptProps {
|
|
3263
3298
|
/** The question to display to the user */
|
|
@@ -3377,4 +3412,4 @@ declare function ClockIcon({ className, ...props }: IconProps): react_jsx_runtim
|
|
|
3377
3412
|
*/
|
|
3378
3413
|
declare function compressImage(file: File, targetSizeKB?: number): Promise<File>;
|
|
3379
3414
|
|
|
3380
|
-
export { AgentChat, type AgentChatProps, AlertCircleIcon, type Artifact$1 as Artifact, AskUserPrompt, type AskUserPromptProps, type AttachmentData, type AttachmentFile, BotIcon, type ChatAdapter, ChatConfigProvider, type ChatConfigProviderProps, ChatContainer, type ChatContainerProps, type ChatError, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageProps, type ChatMessage$1 as ChatMessageType, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, type ClarificationData, ClockIcon, CodeIcon, CopyIcon, DatabaseIcon, type DefaultAdapterConfig, DownloadIcon, type Execution, type ExecutionResult, type ExecutionStreamEvent, ExternalLinkIcon, FileDropZone, type FileDropZoneProps, type FileDropZoneRef, FileIcon, FileTextIcon, HelpCircleIcon, type HistoryMessage, type IconProps, ImageIcon, ImagesIcon, type ListSessionsInput, ListTodoIcon, LoadingSpinner, MarkdownContent, type MarkdownContentProps, Maximize2Icon, MessageCircleIcon, MessageList, type MessageListProps, Minimize2Icon, PaperclipIcon, SendIcon, type SendMessageInput$1 as SendMessageInput, type SendMessageOptions, type SessionHistory$1 as SessionHistory, type SessionList, type SessionListItem, SparklesIcon, type StartExecutionInput, StopCircleIcon, type ThemeMode, type ThinkingBlock, type TodoItem, TodoList, type TodoListProps, type ToolCall, ToolCallEntry, type ToolCallEntryProps, type UploadUrlInput, type UploadUrlResult, type UseAgentChatOptions, type UseAgentChatResult, type UseExecutionStreamOptions, type UseExecutionStreamResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments };
|
|
3415
|
+
export { AgentChat, type AgentChatProps, AlertCircleIcon, type Artifact$1 as Artifact, AskUserPrompt, type AskUserPromptProps, type AttachmentData, type AttachmentFile, BotIcon, type ChatAdapter, ChatConfigProvider, type ChatConfigProviderProps, ChatContainer, type ChatContainerProps, type ChatError, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageProps, type ChatMessage$1 as ChatMessageType, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, type ClarificationData, ClockIcon, CodeIcon, CopyIcon, DatabaseIcon, type DefaultAdapterConfig, DownloadIcon, type Execution, type ExecutionResult, type ExecutionStreamEvent, ExternalLinkIcon, FileDropZone, type FileDropZoneProps, type FileDropZoneRef, FileIcon, FileTextIcon, HelpCircleIcon, type HistoryMessage, INTERNAL_TOOL_NAMES, type IconProps, ImageIcon, ImagesIcon, type ListSessionsInput, ListTodoIcon, LoadingSpinner, MarkdownContent, type MarkdownContentProps, Maximize2Icon, MessageCircleIcon, MessageList, type MessageListProps, Minimize2Icon, PaperclipIcon, SendIcon, type SendMessageInput$1 as SendMessageInput, type SendMessageOptions, type SessionHistory$1 as SessionHistory, type SessionList, type SessionListItem, SparklesIcon, type StartExecutionInput, StopCircleIcon, type ThemeMode, type ThinkingBlock, type TodoItem, TodoList, type TodoListProps, type ToolCall, ToolCallEntry, type ToolCallEntryProps, type ToolCallVerbosity, type UploadUrlInput, type UploadUrlResult, type UseAgentChatOptions, type UseAgentChatResult, type UseExecutionStreamOptions, type UseExecutionStreamResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, isInternalTool, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments };
|