@umituz/web-ai 1.1.0 → 1.2.0

package/dist/hooks/index.d.cts

@@ -3,12 +3,14 @@ import { d as AIErrorCode, t as SentimentAnalysisResult, C as ContentAnalysisReq
 export { f as AspectRatio, h as CreditCost, i as GENERATION_COSTS, j as GenerationMetadata, x as calculateCreditCost } from '../AIErrors-_IyXRWj1.cjs';
 import { d as ProviderConfig, I as ImageGenerationRequest, G as GeneratedContent, V as VideoGenerationRequest, a as ImageToVideoRequest, b as VideoToVideoRequest } from '../ProviderConfig-DIFa9nmG.cjs';
 import { c as ITextGenerator, d as ITextProvider, e as ProviderFactory } from '../provider.factory-Ce6Een1G.cjs';
-import { A as AIProviderConfig, q as GroqGenerationConfig } from '../create-ai-DRysRImc.cjs';
+import { A as AIProviderConfig, q as GroqGenerationConfig } from '../create-ai-DDyTVzef.cjs';
 import { b as TextTier } from '../index-OhvYUTXf.cjs';
 import { C as CacheManager, b as CacheStats } from '../cache-manager-Df9LLYGA.cjs';
 import { d as ChatService, U as UseChatOptions, k as UseChatReturn } from '../chat.service-8MaW9pum.cjs';
-import { T as TextGenerationService, j as PrunaResult, G as GenerateOptions, e as PrunaInput, a as GenerationStage } from '../cancellation-error-_39nYWwz.cjs';
-export { C as CancellationError } from '../cancellation-error-_39nYWwz.cjs';
+import { T as TextGenerationService, j as PrunaResult, G as GenerateOptions, e as PrunaInput, a as GenerationStage } from '../cancellation-error-BWb59Wkj.cjs';
+export { C as CancellationError } from '../cancellation-error-BWb59Wkj.cjs';
+import { Dispatch, SetStateAction } from 'react';
+import { R as RemoteChatClient, b as RemoteChatStreamBody } from '../remote-chat-client-LrNlew4n.cjs';
 import '../index-Dv8gRzAu.cjs';
 
 /** Provider config for the underlying AIContentService — new AIProviderConfig,
@@ -244,6 +246,57 @@ interface UseGroqDeps {
 }
 declare function useGroq(options?: UseGroqOptions, deps?: UseGroqDeps): UseGroqReturn;
 
+type RemoteChatMessageStatus = "pending" | "streaming" | "complete" | "stopped" | "error";
+interface RemoteChatUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly reasoningTokens?: number;
+}
+interface RemoteChatMessage {
+    readonly id: string;
+    readonly role: "user" | "assistant";
+    readonly content: string;
+    readonly reasoning: string;
+    readonly status: RemoteChatMessageStatus;
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+    } | null;
+    readonly usage: RemoteChatUsage | null;
+}
+/** Placeholder id for the assistant message while it streams; replaced by
+ *  the persisted id on `done`. */
+declare const REMOTE_CHAT_STREAMING_ID = "streaming";
+interface UseRemoteChatOptions<TToolCall = unknown> {
+    readonly client: RemoteChatClient;
+    /** Called for every `tool_call` event (pending approval, etc.). */
+    readonly onToolCall?: (toolCall: TToolCall) => void;
+    /** Called once per finished stream (success, error, or abort). */
+    readonly onStreamEnd?: (info: {
+        readonly conversationId: string;
+        readonly stopped: boolean;
+    }) => void | Promise<void>;
+    /** Id factory for the optimistic user echo. */
+    readonly localUserId?: () => string;
+}
+interface UseRemoteChatReturn {
+    readonly messages: ReadonlyArray<RemoteChatMessage>;
+    setMessages: Dispatch<SetStateAction<RemoteChatMessage[]>>;
+    readonly isStreaming: boolean;
+    readonly isResolving: boolean;
+    /** Start a stream; `localUserContent` echoes the user message optimistically. */
+    stream(conversationId: string, body: RemoteChatStreamBody, opts?: {
+        readonly localUserContent?: string;
+    }): Promise<void>;
+    /** Approve/reject a tool call and consume the continuation stream. */
+    resolveToolCall(conversationId: string, toolCallId: string, approved: boolean): Promise<boolean>;
+    /** Abort the active stream; the next `onStreamEnd` reports `stopped: true`. */
+    abort(): void;
+    /** Patch the last message (status/id/usage updates). */
+    patchLast(patch: Partial<RemoteChatMessage>): void;
+}
+declare function useRemoteChat<TToolCall = unknown>(options: UseRemoteChatOptions<TToolCall>): UseRemoteChatReturn;
+
 interface AsyncActionState<TResult> {
     result: TResult | null;
     isLoading: boolean;
@@ -279,4 +332,4 @@ interface UsePrunaProxyOptions {
 type UsePrunaProxyReturn = AsyncActionApi<PrunaResult, PrunaInput>;
 declare function usePrunaProxy(options: UsePrunaProxyOptions): UsePrunaProxyReturn;
 
-export { type AsyncActionApi, type AsyncActionExecutor, type AsyncActionState, type ContentWizardRequest, type CreditCheckFunction, GenerationProgress, GenerationResult, GenerationStatus, GenerationType, ImageGenerationInput, ImageQuality, type SaveFunction, type UploadFunction, type UseAIContentOptions, type UseAIContentReturn, type UseAIGenerationOptions, type UseAIGenerationReturn, type UseAsyncActionOptions, type UseBlogGeneratorOptions, type UseBlogGeneratorReturn, type UseCacheStatsOptions, type UseChatDeps, type UseContentWizardOptions, type UseContentWizardReturn, type UseGroqDeps, type UseGroqOptions, type UseGroqReturn, type UseImageWizardOptions, type UseImageWizardReturn, type UsePrunaGenerationOptions, type UsePrunaGenerationReturn, type UsePrunaProxyOptions, type UsePrunaProxyReturn, type UseSocialContentGeneratorOptions, type UseSocialContentGeneratorReturn, type UseTextConfig, type UseTextDeps, type UseTextOptions, type UseTextReturn, type UseVideoWizardOptions, type UseVideoWizardReturn, VideoGenerationInput, VideoQuality, type VideoWizardRequest, useAIContent, useAIGeneration, useAsyncAction, useBlogGenerator, useCacheStats, useChat, useContentWizard, useGroq, useImageWizard, usePrunaGeneration, usePrunaProxy, useSocialContentGenerator, useText, useVideoWizard };
+export { type AsyncActionApi, type AsyncActionExecutor, type AsyncActionState, type ContentWizardRequest, type CreditCheckFunction, GenerationProgress, GenerationResult, GenerationStatus, GenerationType, ImageGenerationInput, ImageQuality, REMOTE_CHAT_STREAMING_ID, type RemoteChatMessage, type RemoteChatMessageStatus, type RemoteChatUsage, type SaveFunction, type UploadFunction, type UseAIContentOptions, type UseAIContentReturn, type UseAIGenerationOptions, type UseAIGenerationReturn, type UseAsyncActionOptions, type UseBlogGeneratorOptions, type UseBlogGeneratorReturn, type UseCacheStatsOptions, type UseChatDeps, type UseContentWizardOptions, type UseContentWizardReturn, type UseGroqDeps, type UseGroqOptions, type UseGroqReturn, type UseImageWizardOptions, type UseImageWizardReturn, type UsePrunaGenerationOptions, type UsePrunaGenerationReturn, type UsePrunaProxyOptions, type UsePrunaProxyReturn, type UseRemoteChatOptions, type UseRemoteChatReturn, type UseSocialContentGeneratorOptions, type UseSocialContentGeneratorReturn, type UseTextConfig, type UseTextDeps, type UseTextOptions, type UseTextReturn, type UseVideoWizardOptions, type UseVideoWizardReturn, VideoGenerationInput, VideoQuality, type VideoWizardRequest, useAIContent, useAIGeneration, useAsyncAction, useBlogGenerator, useCacheStats, useChat, useContentWizard, useGroq, useImageWizard, usePrunaGeneration, usePrunaProxy, useRemoteChat, useSocialContentGenerator, useText, useVideoWizard };

package/dist/hooks/index.d.ts

@@ -3,12 +3,14 @@ import { d as AIErrorCode, t as SentimentAnalysisResult, C as ContentAnalysisReq
 export { f as AspectRatio, h as CreditCost, i as GENERATION_COSTS, j as GenerationMetadata, x as calculateCreditCost } from '../AIErrors-TuSFl--T.js';
 import { d as ProviderConfig, I as ImageGenerationRequest, G as GeneratedContent, V as VideoGenerationRequest, a as ImageToVideoRequest, b as VideoToVideoRequest } from '../ProviderConfig-DIFa9nmG.js';
 import { c as ITextGenerator, d as ITextProvider, e as ProviderFactory } from '../provider.factory-B9RNUTYj.js';
-import { A as AIProviderConfig, q as GroqGenerationConfig } from '../create-ai-D-oEWzf9.js';
+import { A as AIProviderConfig, q as GroqGenerationConfig } from '../create-ai-Cq3HkJxd.js';
 import { b as TextTier } from '../index-OhvYUTXf.js';
 import { C as CacheManager, b as CacheStats } from '../cache-manager-Df9LLYGA.js';
 import { d as ChatService, U as UseChatOptions, k as UseChatReturn } from '../chat.service-B4Isrckn.js';
-import { T as TextGenerationService, j as PrunaResult, G as GenerateOptions, e as PrunaInput, a as GenerationStage } from '../cancellation-error-hYcE9AS9.js';
-export { C as CancellationError } from '../cancellation-error-hYcE9AS9.js';
+import { T as TextGenerationService, j as PrunaResult, G as GenerateOptions, e as PrunaInput, a as GenerationStage } from '../cancellation-error-D9LETLCD.js';
+export { C as CancellationError } from '../cancellation-error-D9LETLCD.js';
+import { Dispatch, SetStateAction } from 'react';
+import { R as RemoteChatClient, b as RemoteChatStreamBody } from '../remote-chat-client-LrNlew4n.js';
 import '../index-1e91KRYU.js';
 
 /** Provider config for the underlying AIContentService — new AIProviderConfig,
@@ -244,6 +246,57 @@ interface UseGroqDeps {
 }
 declare function useGroq(options?: UseGroqOptions, deps?: UseGroqDeps): UseGroqReturn;
 
+type RemoteChatMessageStatus = "pending" | "streaming" | "complete" | "stopped" | "error";
+interface RemoteChatUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly reasoningTokens?: number;
+}
+interface RemoteChatMessage {
+    readonly id: string;
+    readonly role: "user" | "assistant";
+    readonly content: string;
+    readonly reasoning: string;
+    readonly status: RemoteChatMessageStatus;
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+    } | null;
+    readonly usage: RemoteChatUsage | null;
+}
+/** Placeholder id for the assistant message while it streams; replaced by
+ *  the persisted id on `done`. */
+declare const REMOTE_CHAT_STREAMING_ID = "streaming";
+interface UseRemoteChatOptions<TToolCall = unknown> {
+    readonly client: RemoteChatClient;
+    /** Called for every `tool_call` event (pending approval, etc.). */
+    readonly onToolCall?: (toolCall: TToolCall) => void;
+    /** Called once per finished stream (success, error, or abort). */
+    readonly onStreamEnd?: (info: {
+        readonly conversationId: string;
+        readonly stopped: boolean;
+    }) => void | Promise<void>;
+    /** Id factory for the optimistic user echo. */
+    readonly localUserId?: () => string;
+}
+interface UseRemoteChatReturn {
+    readonly messages: ReadonlyArray<RemoteChatMessage>;
+    setMessages: Dispatch<SetStateAction<RemoteChatMessage[]>>;
+    readonly isStreaming: boolean;
+    readonly isResolving: boolean;
+    /** Start a stream; `localUserContent` echoes the user message optimistically. */
+    stream(conversationId: string, body: RemoteChatStreamBody, opts?: {
+        readonly localUserContent?: string;
+    }): Promise<void>;
+    /** Approve/reject a tool call and consume the continuation stream. */
+    resolveToolCall(conversationId: string, toolCallId: string, approved: boolean): Promise<boolean>;
+    /** Abort the active stream; the next `onStreamEnd` reports `stopped: true`. */
+    abort(): void;
+    /** Patch the last message (status/id/usage updates). */
+    patchLast(patch: Partial<RemoteChatMessage>): void;
+}
+declare function useRemoteChat<TToolCall = unknown>(options: UseRemoteChatOptions<TToolCall>): UseRemoteChatReturn;
+
 interface AsyncActionState<TResult> {
     result: TResult | null;
     isLoading: boolean;
@@ -279,4 +332,4 @@ interface UsePrunaProxyOptions {
 type UsePrunaProxyReturn = AsyncActionApi<PrunaResult, PrunaInput>;
 declare function usePrunaProxy(options: UsePrunaProxyOptions): UsePrunaProxyReturn;
 
-export { type AsyncActionApi, type AsyncActionExecutor, type AsyncActionState, type ContentWizardRequest, type CreditCheckFunction, GenerationProgress, GenerationResult, GenerationStatus, GenerationType, ImageGenerationInput, ImageQuality, type SaveFunction, type UploadFunction, type UseAIContentOptions, type UseAIContentReturn, type UseAIGenerationOptions, type UseAIGenerationReturn, type UseAsyncActionOptions, type UseBlogGeneratorOptions, type UseBlogGeneratorReturn, type UseCacheStatsOptions, type UseChatDeps, type UseContentWizardOptions, type UseContentWizardReturn, type UseGroqDeps, type UseGroqOptions, type UseGroqReturn, type UseImageWizardOptions, type UseImageWizardReturn, type UsePrunaGenerationOptions, type UsePrunaGenerationReturn, type UsePrunaProxyOptions, type UsePrunaProxyReturn, type UseSocialContentGeneratorOptions, type UseSocialContentGeneratorReturn, type UseTextConfig, type UseTextDeps, type UseTextOptions, type UseTextReturn, type UseVideoWizardOptions, type UseVideoWizardReturn, VideoGenerationInput, VideoQuality, type VideoWizardRequest, useAIContent, useAIGeneration, useAsyncAction, useBlogGenerator, useCacheStats, useChat, useContentWizard, useGroq, useImageWizard, usePrunaGeneration, usePrunaProxy, useSocialContentGenerator, useText, useVideoWizard };
+export { type AsyncActionApi, type AsyncActionExecutor, type AsyncActionState, type ContentWizardRequest, type CreditCheckFunction, GenerationProgress, GenerationResult, GenerationStatus, GenerationType, ImageGenerationInput, ImageQuality, REMOTE_CHAT_STREAMING_ID, type RemoteChatMessage, type RemoteChatMessageStatus, type RemoteChatUsage, type SaveFunction, type UploadFunction, type UseAIContentOptions, type UseAIContentReturn, type UseAIGenerationOptions, type UseAIGenerationReturn, type UseAsyncActionOptions, type UseBlogGeneratorOptions, type UseBlogGeneratorReturn, type UseCacheStatsOptions, type UseChatDeps, type UseContentWizardOptions, type UseContentWizardReturn, type UseGroqDeps, type UseGroqOptions, type UseGroqReturn, type UseImageWizardOptions, type UseImageWizardReturn, type UsePrunaGenerationOptions, type UsePrunaGenerationReturn, type UsePrunaProxyOptions, type UsePrunaProxyReturn, type UseRemoteChatOptions, type UseRemoteChatReturn, type UseSocialContentGeneratorOptions, type UseSocialContentGeneratorReturn, type UseTextConfig, type UseTextDeps, type UseTextOptions, type UseTextReturn, type UseVideoWizardOptions, type UseVideoWizardReturn, VideoGenerationInput, VideoQuality, type VideoWizardRequest, useAIContent, useAIGeneration, useAsyncAction, useBlogGenerator, useCacheStats, useChat, useContentWizard, useGroq, useImageWizard, usePrunaGeneration, usePrunaProxy, useRemoteChat, useSocialContentGenerator, useText, useVideoWizard };