@gr33n-ai/jade-sdk-client 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -1,7 +1,150 @@
-import { ConversationEntry } from '@gr33n-ai/agent-sdk-client';
+import { ConversationEntry, AgentClientConfig } from '@gr33n-ai/agent-sdk-client';
 export * from '@gr33n-ai/agent-sdk-client';
-import { P as ProcessingOptions, a as ProcessedEntry, M as MediaInfo, T as ToolDefinition, b as ToolMediaResult, c as ParsedToolResult } from './types-peBknkiN.cjs';
-export { g as MediaResult, e as ParsedSuggestion, d as ParsedToolInput, S as SuggestionParseResult, f as TextSegment, h as hasSuggestions, p as parseSuggestions } from './types-peBknkiN.cjs';
+export { AgentClient as JadeClient } from '@gr33n-ai/agent-sdk-client';
+import { UseAgentSessionOptions, UseAgentSessionReturn, AgentProvider } from '@gr33n-ai/agent-sdk-client/react';
+export * from '@gr33n-ai/agent-sdk-client/react';
+
+/**
+ * Tool types for Jade SDK.
+ * Used for parsing tool inputs and results.
+ */
+interface ParsedToolInput {
+    type: string;
+    data: Record<string, unknown>;
+}
+interface ParsedToolResult {
+    type: string;
+    data: Record<string, unknown>;
+}
+interface ToolDefinition {
+    name: string;
+    displayName: string;
+    iconName: string;
+    iconVariant?: (input: unknown) => string;
+    category: 'generation' | 'processing' | 'utility' | 'system';
+    consumesResult: boolean;
+    consumeExtra?: number;
+    parseInput: (toolInput: unknown) => ParsedToolInput | null;
+    parseResult?: (content: string) => ParsedToolResult | null;
+}
+interface MediaResult {
+    requestId: string;
+    urls: string[];
+    fileType?: string;
+    metadata?: Record<string, unknown>;
+    originalSource?: string;
+}
+interface ToolMediaResult {
+    requestId: string;
+    urls: string[];
+    fileType?: string;
+    metadata?: Record<string, unknown>;
+    originalSource?: string;
+    originalToolUseId?: string;
+    originalToolName?: string;
+    prompt?: string;
+    model?: string;
+    aspectRatio?: string;
+    inputMediaUrls?: string[];
+    lastFrameUrl?: string;
+    elements?: string[][];
+}
+
+/**
+ * Parser for gr3.suggestion tags in assistant text.
+ * Extracts suggestions and returns clean text with suggestion metadata.
+ */
+interface ParsedSuggestion {
+    text: string;
+    startIndex: number;
+    endIndex: number;
+}
+interface SuggestionParseResult {
+    cleanText: string;
+    suggestions: ParsedSuggestion[];
+    segments: TextSegment[];
+}
+type TextSegment = {
+    type: 'text';
+    content: string;
+} | {
+    type: 'suggestion';
+    content: string;
+};
+/**
+ * Parse text containing gr3.suggestion tags.
+ * Returns the clean text (with tags removed) and an array of suggestions with their positions.
+ */
+declare function parseSuggestions(text: string): SuggestionParseResult;
+/**
+ * Check if text contains any gr3.suggestion tags.
+ */
+declare function hasSuggestions(text: string): boolean;
+
+/**
+ * Type definitions for Jade SDK.
+ */
+
+interface ProcessedEntry {
+    /** The original conversation entry */
+    entry: ConversationEntry;
+    /** Original entry type category */
+    originalType: 'tool_call' | 'tool_result' | 'assistant_text' | 'user_text' | 'compact' | 'error';
+    /** Display type for UI rendering */
+    displayType: string;
+    /** Icon name for this entry (e.g., 'Image', 'Video', 'Bot') */
+    iconName: string;
+    /** Additional data for dynamic icon selection */
+    iconData?: unknown;
+    /** Display title (for mcp__jade__ tools) */
+    title?: string;
+    /** Parsed data for rendering */
+    data: Record<string, unknown>;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Tool definition if this is a tool call */
+    toolDefinition?: ToolDefinition;
+    /** Parsed input if this is a tool call */
+    parsedInput?: ParsedToolInput;
+    /** Parsed result if tool consumed its result */
+    parsedResult?: ParsedToolResult;
+    /** The consumed result entry (if tool consumed it) */
+    consumedResult?: ConversationEntry;
+    /** Media URLs extracted from the result */
+    mediaUrls?: string[];
+    /** Parsed suggestions from gr3.suggestion tags */
+    suggestions?: ParsedSuggestion[];
+    /** Text segments for rendering (alternating text and suggestions) */
+    textSegments?: TextSegment[];
+}
+interface ProcessingOptions {
+    /** Skip Skill context injection entries (default: true) */
+    skipSkillContext?: boolean;
+    /** Pair tool calls with their results (default: true) */
+    pairToolResults?: boolean;
+    /** Extract media URLs from results (default: true) */
+    extractMedia?: boolean;
+}
+interface MediaInfo {
+    /** Media URL */
+    url: string;
+    /** Media type */
+    type: 'image' | 'video' | 'audio';
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Tool name that generated this media */
+    toolName?: string;
+    /** Tool use ID */
+    toolUseId?: string;
+    /** Prompt used to generate this media */
+    prompt?: string;
+    /** Model used for generation */
+    model?: string;
+    /** Aspect ratio */
+    aspectRatio?: string;
+    /** Input media URLs used for generation */
+    inputMediaUrls?: string[];
+}
 
 /**
  * Conversation processor for Jade SDK.
@@ -90,4 +233,93 @@ declare function extractMediaInfo(content: string): {
     urls: string[];
 } | null;
 
-export { MediaInfo, type MediaType, ParsedToolResult, ProcessedEntry, ProcessingOptions, TOOL_REGISTRY, ToolDefinition, ToolMediaResult, createMediaParseResult, extractMedia, extractMediaInfo, extractMediaInfoFromToolResult, getMediaTypeFromExtension, getMediaTypeFromUrl, getToolDefinition, getToolIconName, parseToolResultContent, processConversation };
+interface UseJadeSessionOptions extends UseAgentSessionOptions {
+    /** Skip Skill context injection entries (default: true) */
+    skipSkillContext?: boolean;
+    /** Processing options */
+    processingOptions?: ProcessingOptions;
+}
+interface UseJadeSessionReturn extends UseAgentSessionReturn {
+    /** Processed conversation entries with tool pairing and parsing */
+    processedConversation: ProcessedEntry[];
+    /** All media extracted from conversation (deduplicated, sorted by timestamp) */
+    media: MediaInfo[];
+}
+/**
+ * Hook for managing Jade agent sessions with enhanced conversation processing.
+ *
+ * Extends useAgentSession with:
+ * - Processed conversation (tool call/result pairing, parsed inputs/results)
+ * - Media extraction from generated content
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   conversation,
+ *   processedConversation,
+ *   media,
+ *   isStreaming,
+ *   sendMessage,
+ * } = useJadeSession();
+ *
+ * // Render processed entries
+ * {processedConversation.map((entry, i) => (
+ *   <MessageRenderer key={i} entry={entry} />
+ * ))}
+ *
+ * // Show media gallery
+ * {media.map((item) => (
+ *   <MediaThumbnail key={item.url} {...item} />
+ * ))}
+ * ```
+ */
+declare function useJadeSession(options?: UseJadeSessionOptions): UseJadeSessionReturn;
+
+/**
+ * Hook for extracting media from conversation entries.
+ *
+ * @param conversation - Array of conversation entries
+ * @returns Array of media info objects (deduplicated, sorted by timestamp)
+ *
+ * @example
+ * ```tsx
+ * const media = useMedia(conversation);
+ *
+ * {media.map((item) => (
+ *   <MediaThumbnail
+ *     key={item.url}
+ *     url={item.url}
+ *     type={item.type}
+ *     prompt={item.prompt}
+ *   />
+ * ))}
+ * ```
+ */
+declare function useMedia(conversation: ConversationEntry[]): MediaInfo[];
+
+/**
+ * JadeProvider for Jade SDK.
+ * Re-exports AgentProvider with Jade branding.
+ */
+
+/**
+ * Configuration for JadeProvider.
+ */
+type JadeClientConfig = AgentClientConfig;
+/**
+ * Provider component for Jade SDK.
+ * Wraps your app to provide the agent client context.
+ *
+ * @example
+ * ```tsx
+ * <JadeProvider config={{
+ *   endpoint: 'https://api.jade.gr33n.ai',
+ *   getAuthToken: () => authToken,
+ * }}>
+ *   <App />
+ * </JadeProvider>
+ * ```
+ */
+declare const JadeProvider: typeof AgentProvider;
+
+export { type JadeClientConfig, JadeProvider, type MediaInfo, type MediaResult, type MediaType, type ParsedSuggestion, type ParsedToolInput, type ParsedToolResult, type ProcessedEntry, type ProcessingOptions, type SuggestionParseResult, TOOL_REGISTRY, type TextSegment, type ToolDefinition, type ToolMediaResult, type UseJadeSessionOptions, type UseJadeSessionReturn, createMediaParseResult, extractMedia, extractMediaInfo, extractMediaInfoFromToolResult, getMediaTypeFromExtension, getMediaTypeFromUrl, getToolDefinition, getToolIconName, hasSuggestions, parseSuggestions, parseToolResultContent, processConversation, useJadeSession, useMedia };

package/dist/index.d.ts

@@ -1,7 +1,150 @@
-import { ConversationEntry } from '@gr33n-ai/agent-sdk-client';
+import { ConversationEntry, AgentClientConfig } from '@gr33n-ai/agent-sdk-client';
 export * from '@gr33n-ai/agent-sdk-client';
-import { P as ProcessingOptions, a as ProcessedEntry, M as MediaInfo, T as ToolDefinition, b as ToolMediaResult, c as ParsedToolResult } from './types-peBknkiN.js';
-export { g as MediaResult, e as ParsedSuggestion, d as ParsedToolInput, S as SuggestionParseResult, f as TextSegment, h as hasSuggestions, p as parseSuggestions } from './types-peBknkiN.js';
+export { AgentClient as JadeClient } from '@gr33n-ai/agent-sdk-client';
+import { UseAgentSessionOptions, UseAgentSessionReturn, AgentProvider } from '@gr33n-ai/agent-sdk-client/react';
+export * from '@gr33n-ai/agent-sdk-client/react';
+
+/**
+ * Tool types for Jade SDK.
+ * Used for parsing tool inputs and results.
+ */
+interface ParsedToolInput {
+    type: string;
+    data: Record<string, unknown>;
+}
+interface ParsedToolResult {
+    type: string;
+    data: Record<string, unknown>;
+}
+interface ToolDefinition {
+    name: string;
+    displayName: string;
+    iconName: string;
+    iconVariant?: (input: unknown) => string;
+    category: 'generation' | 'processing' | 'utility' | 'system';
+    consumesResult: boolean;
+    consumeExtra?: number;
+    parseInput: (toolInput: unknown) => ParsedToolInput | null;
+    parseResult?: (content: string) => ParsedToolResult | null;
+}
+interface MediaResult {
+    requestId: string;
+    urls: string[];
+    fileType?: string;
+    metadata?: Record<string, unknown>;
+    originalSource?: string;
+}
+interface ToolMediaResult {
+    requestId: string;
+    urls: string[];
+    fileType?: string;
+    metadata?: Record<string, unknown>;
+    originalSource?: string;
+    originalToolUseId?: string;
+    originalToolName?: string;
+    prompt?: string;
+    model?: string;
+    aspectRatio?: string;
+    inputMediaUrls?: string[];
+    lastFrameUrl?: string;
+    elements?: string[][];
+}
+
+/**
+ * Parser for gr3.suggestion tags in assistant text.
+ * Extracts suggestions and returns clean text with suggestion metadata.
+ */
+interface ParsedSuggestion {
+    text: string;
+    startIndex: number;
+    endIndex: number;
+}
+interface SuggestionParseResult {
+    cleanText: string;
+    suggestions: ParsedSuggestion[];
+    segments: TextSegment[];
+}
+type TextSegment = {
+    type: 'text';
+    content: string;
+} | {
+    type: 'suggestion';
+    content: string;
+};
+/**
+ * Parse text containing gr3.suggestion tags.
+ * Returns the clean text (with tags removed) and an array of suggestions with their positions.
+ */
+declare function parseSuggestions(text: string): SuggestionParseResult;
+/**
+ * Check if text contains any gr3.suggestion tags.
+ */
+declare function hasSuggestions(text: string): boolean;
+
+/**
+ * Type definitions for Jade SDK.
+ */
+
+interface ProcessedEntry {
+    /** The original conversation entry */
+    entry: ConversationEntry;
+    /** Original entry type category */
+    originalType: 'tool_call' | 'tool_result' | 'assistant_text' | 'user_text' | 'compact' | 'error';
+    /** Display type for UI rendering */
+    displayType: string;
+    /** Icon name for this entry (e.g., 'Image', 'Video', 'Bot') */
+    iconName: string;
+    /** Additional data for dynamic icon selection */
+    iconData?: unknown;
+    /** Display title (for mcp__jade__ tools) */
+    title?: string;
+    /** Parsed data for rendering */
+    data: Record<string, unknown>;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Tool definition if this is a tool call */
+    toolDefinition?: ToolDefinition;
+    /** Parsed input if this is a tool call */
+    parsedInput?: ParsedToolInput;
+    /** Parsed result if tool consumed its result */
+    parsedResult?: ParsedToolResult;
+    /** The consumed result entry (if tool consumed it) */
+    consumedResult?: ConversationEntry;
+    /** Media URLs extracted from the result */
+    mediaUrls?: string[];
+    /** Parsed suggestions from gr3.suggestion tags */
+    suggestions?: ParsedSuggestion[];
+    /** Text segments for rendering (alternating text and suggestions) */
+    textSegments?: TextSegment[];
+}
+interface ProcessingOptions {
+    /** Skip Skill context injection entries (default: true) */
+    skipSkillContext?: boolean;
+    /** Pair tool calls with their results (default: true) */
+    pairToolResults?: boolean;
+    /** Extract media URLs from results (default: true) */
+    extractMedia?: boolean;
+}
+interface MediaInfo {
+    /** Media URL */
+    url: string;
+    /** Media type */
+    type: 'image' | 'video' | 'audio';
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Tool name that generated this media */
+    toolName?: string;
+    /** Tool use ID */
+    toolUseId?: string;
+    /** Prompt used to generate this media */
+    prompt?: string;
+    /** Model used for generation */
+    model?: string;
+    /** Aspect ratio */
+    aspectRatio?: string;
+    /** Input media URLs used for generation */
+    inputMediaUrls?: string[];
+}
 
 /**
  * Conversation processor for Jade SDK.
@@ -90,4 +233,93 @@ declare function extractMediaInfo(content: string): {
     urls: string[];
 } | null;
 
-export { MediaInfo, type MediaType, ParsedToolResult, ProcessedEntry, ProcessingOptions, TOOL_REGISTRY, ToolDefinition, ToolMediaResult, createMediaParseResult, extractMedia, extractMediaInfo, extractMediaInfoFromToolResult, getMediaTypeFromExtension, getMediaTypeFromUrl, getToolDefinition, getToolIconName, parseToolResultContent, processConversation };
+interface UseJadeSessionOptions extends UseAgentSessionOptions {
+    /** Skip Skill context injection entries (default: true) */
+    skipSkillContext?: boolean;
+    /** Processing options */
+    processingOptions?: ProcessingOptions;
+}
+interface UseJadeSessionReturn extends UseAgentSessionReturn {
+    /** Processed conversation entries with tool pairing and parsing */
+    processedConversation: ProcessedEntry[];
+    /** All media extracted from conversation (deduplicated, sorted by timestamp) */
+    media: MediaInfo[];
+}
+/**
+ * Hook for managing Jade agent sessions with enhanced conversation processing.
+ *
+ * Extends useAgentSession with:
+ * - Processed conversation (tool call/result pairing, parsed inputs/results)
+ * - Media extraction from generated content
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   conversation,
+ *   processedConversation,
+ *   media,
+ *   isStreaming,
+ *   sendMessage,
+ * } = useJadeSession();
+ *
+ * // Render processed entries
+ * {processedConversation.map((entry, i) => (
+ *   <MessageRenderer key={i} entry={entry} />
+ * ))}
+ *
+ * // Show media gallery
+ * {media.map((item) => (
+ *   <MediaThumbnail key={item.url} {...item} />
+ * ))}
+ * ```
+ */
+declare function useJadeSession(options?: UseJadeSessionOptions): UseJadeSessionReturn;
+
+/**
+ * Hook for extracting media from conversation entries.
+ *
+ * @param conversation - Array of conversation entries
+ * @returns Array of media info objects (deduplicated, sorted by timestamp)
+ *
+ * @example
+ * ```tsx
+ * const media = useMedia(conversation);
+ *
+ * {media.map((item) => (
+ *   <MediaThumbnail
+ *     key={item.url}
+ *     url={item.url}
+ *     type={item.type}
+ *     prompt={item.prompt}
+ *   />
+ * ))}
+ * ```
+ */
+declare function useMedia(conversation: ConversationEntry[]): MediaInfo[];
+
+/**
+ * JadeProvider for Jade SDK.
+ * Re-exports AgentProvider with Jade branding.
+ */
+
+/**
+ * Configuration for JadeProvider.
+ */
+type JadeClientConfig = AgentClientConfig;
+/**
+ * Provider component for Jade SDK.
+ * Wraps your app to provide the agent client context.
+ *
+ * @example
+ * ```tsx
+ * <JadeProvider config={{
+ *   endpoint: 'https://api.jade.gr33n.ai',
+ *   getAuthToken: () => authToken,
+ * }}>
+ *   <App />
+ * </JadeProvider>
+ * ```
+ */
+declare const JadeProvider: typeof AgentProvider;
+
+export { type JadeClientConfig, JadeProvider, type MediaInfo, type MediaResult, type MediaType, type ParsedSuggestion, type ParsedToolInput, type ParsedToolResult, type ProcessedEntry, type ProcessingOptions, type SuggestionParseResult, TOOL_REGISTRY, type TextSegment, type ToolDefinition, type ToolMediaResult, type UseJadeSessionOptions, type UseJadeSessionReturn, createMediaParseResult, extractMedia, extractMediaInfo, extractMediaInfoFromToolResult, getMediaTypeFromExtension, getMediaTypeFromUrl, getToolDefinition, getToolIconName, hasSuggestions, parseSuggestions, parseToolResultContent, processConversation, useJadeSession, useMedia };