@umituz/web-ai 0.0.0-stage → 1.0.0

package/dist/chat.service-DBKq9I2c.d.cts

@@ -0,0 +1,124 @@
+import { c as TextTier, C as ChatMessage$1 } from './index-fXjxTR5W.cjs';
+import { b as ITextProvider, c as ProviderFactory } from './provider.factory-COsnprLH.cjs';
+
+type ChatMessageSender = "user" | "assistant" | "system";
+type ChatMessageType = "text" | "image" | "audio" | "sticker";
+interface ChatMessage {
+    readonly id: string;
+    readonly sender: ChatMessageSender;
+    readonly content: string;
+    readonly timestamp: string;
+    readonly type?: ChatMessageType;
+    readonly imageUrl?: string;
+    readonly reaction?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+interface ChatConversation {
+    readonly id: string;
+    readonly companionId: string;
+    readonly companionName: string;
+    readonly lastMessage?: ChatMessage;
+    readonly messageCount: number;
+    readonly updatedAt: string;
+}
+interface SendMessageInput {
+    readonly companionId: string;
+    readonly text: string;
+    readonly type?: ChatMessageType;
+    readonly imageUrl?: string;
+}
+interface SendMessageResult {
+    readonly userMessage: ChatMessage;
+    readonly aiResponse?: ChatMessage;
+}
+interface ChatConfig {
+    readonly systemPrompt?: string;
+    readonly temperature?: number;
+    readonly maxTokens?: number;
+    /** Neutral quality tier — resolved against whichever provider serves the chat. */
+    readonly tier?: TextTier;
+    /** Explicit model id; wins over tier resolution. */
+    readonly model?: string;
+}
+interface IChatStorage {
+    saveMessage(conversationId: string, message: ChatMessage): Promise<void>;
+    getMessages(conversationId: string): Promise<ChatMessage[]>;
+    updateMessage(messageId: string, updates: Partial<ChatMessage>): Promise<void>;
+    deleteMessage(messageId: string): Promise<void>;
+}
+interface ChatTokenUsage {
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly totalTokens: number;
+}
+
+interface SystemPromptStrategy {
+    resolve(config: ChatConfig): string | undefined;
+}
+declare const DEFAULT_PROMPT_STRATEGY: SystemPromptStrategy;
+
+interface IChatService {
+    sendMessage(input: SendMessageInput): Promise<SendMessageResult>;
+    getConversation(conversationId: string): Promise<ChatConversation | null>;
+    getConversations(): Promise<ChatConversation[]>;
+    generateAIResponse(companionId: string, userMessage: string, context?: ReadonlyArray<ChatMessage>): Promise<ChatMessage>;
+    generateStreamingResponse(userMessage: string, context: ReadonlyArray<ChatMessage>, onChunk: (chunk: string) => void): Promise<string>;
+}
+interface UseChatOptions {
+    readonly conversationId: string;
+    readonly storage?: IChatStorage;
+    readonly config?: ChatConfig;
+    readonly autoSave?: boolean;
+    readonly stream?: boolean;
+    readonly onMessageSent?: (message: ChatMessage) => void;
+    readonly onAIResponse?: (message: ChatMessage) => void;
+    readonly onError?: (error: string) => void;
+}
+interface UseChatReturn {
+    readonly messages: ReadonlyArray<ChatMessage>;
+    readonly isLoading: boolean;
+    readonly isTyping: boolean;
+    readonly error: string | null;
+    sendMessage: (text: string, type?: ChatMessage["type"]) => Promise<ChatMessage | null>;
+    regenerate: () => Promise<ChatMessage | null>;
+    cancel: () => void;
+    clearMessages: () => void;
+    clearError: () => void;
+    reset: () => void;
+    updateConfig: (config: Partial<ChatConfig>) => void;
+}
+interface IMessageFormatter {
+    toCoreMessages(messages: ReadonlyArray<ChatMessage>): ChatMessage$1[];
+    toChatMessage(content: string, sender: ChatMessage["sender"]): ChatMessage;
+}
+
+/**
+ * Conversation engine over the neutral text surface. Accepts either a
+ * single ITextProvider or a ProviderFactory (which brings tier defaults,
+ * health checks, and fallback across providers). Model choice is tier-based:
+ * `config.tier ?? provider default` — no hardcoded model names anywhere.
+ */
+declare class ChatService implements IChatService {
+    private readonly engine;
+    private config;
+    private promptStrategy;
+    private storage;
+    constructor(engine: ITextProvider | ProviderFactory);
+    initialize(config: ChatConfig): void;
+    updateConfig(config: Partial<ChatConfig>): void;
+    setPromptStrategy(strategy: SystemPromptStrategy): void;
+    setStorage(storage: IChatStorage): void;
+    getConversation(conversationId: string): Promise<ChatConversation | null>;
+    getConversations(): Promise<ChatConversation[]>;
+    sendMessage(input: SendMessageInput): Promise<SendMessageResult>;
+    generateAIResponse(companionId: string, userMessage: string, context?: ReadonlyArray<ChatMessage>): Promise<ChatMessage>;
+    generateStreamingResponse(userMessage: string, context: ReadonlyArray<ChatMessage>, onChunk: (chunk: string) => void): Promise<string>;
+    private buildRequest;
+    private resolveSystemPrompt;
+    private run;
+    private runStream;
+    private requireStorage;
+}
+declare function extractTokenUsage(message: ChatMessage): ChatTokenUsage | null;
+
+export { type ChatConfig as C, DEFAULT_PROMPT_STRATEGY as D, type IChatService as I, type SendMessageInput as S, type UseChatOptions as U, type ChatConversation as a, type ChatMessageSender as b, type ChatMessageType as c, ChatService as d, type ChatTokenUsage as e, type ChatMessage as f, type IChatStorage as g, type IMessageFormatter as h, type SendMessageResult as i, type SystemPromptStrategy as j, type UseChatReturn as k, extractTokenUsage as l };

package/dist/chat.service-RQn8UTXD.d.ts

@@ -0,0 +1,124 @@
+import { c as TextTier, C as ChatMessage$1 } from './index-fXjxTR5W.js';
+import { b as ITextProvider, c as ProviderFactory } from './provider.factory-CpWFyjbw.js';
+
+type ChatMessageSender = "user" | "assistant" | "system";
+type ChatMessageType = "text" | "image" | "audio" | "sticker";
+interface ChatMessage {
+    readonly id: string;
+    readonly sender: ChatMessageSender;
+    readonly content: string;
+    readonly timestamp: string;
+    readonly type?: ChatMessageType;
+    readonly imageUrl?: string;
+    readonly reaction?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+interface ChatConversation {
+    readonly id: string;
+    readonly companionId: string;
+    readonly companionName: string;
+    readonly lastMessage?: ChatMessage;
+    readonly messageCount: number;
+    readonly updatedAt: string;
+}
+interface SendMessageInput {
+    readonly companionId: string;
+    readonly text: string;
+    readonly type?: ChatMessageType;
+    readonly imageUrl?: string;
+}
+interface SendMessageResult {
+    readonly userMessage: ChatMessage;
+    readonly aiResponse?: ChatMessage;
+}
+interface ChatConfig {
+    readonly systemPrompt?: string;
+    readonly temperature?: number;
+    readonly maxTokens?: number;
+    /** Neutral quality tier — resolved against whichever provider serves the chat. */
+    readonly tier?: TextTier;
+    /** Explicit model id; wins over tier resolution. */
+    readonly model?: string;
+}
+interface IChatStorage {
+    saveMessage(conversationId: string, message: ChatMessage): Promise<void>;
+    getMessages(conversationId: string): Promise<ChatMessage[]>;
+    updateMessage(messageId: string, updates: Partial<ChatMessage>): Promise<void>;
+    deleteMessage(messageId: string): Promise<void>;
+}
+interface ChatTokenUsage {
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly totalTokens: number;
+}
+
+interface SystemPromptStrategy {
+    resolve(config: ChatConfig): string | undefined;
+}
+declare const DEFAULT_PROMPT_STRATEGY: SystemPromptStrategy;
+
+interface IChatService {
+    sendMessage(input: SendMessageInput): Promise<SendMessageResult>;
+    getConversation(conversationId: string): Promise<ChatConversation | null>;
+    getConversations(): Promise<ChatConversation[]>;
+    generateAIResponse(companionId: string, userMessage: string, context?: ReadonlyArray<ChatMessage>): Promise<ChatMessage>;
+    generateStreamingResponse(userMessage: string, context: ReadonlyArray<ChatMessage>, onChunk: (chunk: string) => void): Promise<string>;
+}
+interface UseChatOptions {
+    readonly conversationId: string;
+    readonly storage?: IChatStorage;
+    readonly config?: ChatConfig;
+    readonly autoSave?: boolean;
+    readonly stream?: boolean;
+    readonly onMessageSent?: (message: ChatMessage) => void;
+    readonly onAIResponse?: (message: ChatMessage) => void;
+    readonly onError?: (error: string) => void;
+}
+interface UseChatReturn {
+    readonly messages: ReadonlyArray<ChatMessage>;
+    readonly isLoading: boolean;
+    readonly isTyping: boolean;
+    readonly error: string | null;
+    sendMessage: (text: string, type?: ChatMessage["type"]) => Promise<ChatMessage | null>;
+    regenerate: () => Promise<ChatMessage | null>;
+    cancel: () => void;
+    clearMessages: () => void;
+    clearError: () => void;
+    reset: () => void;
+    updateConfig: (config: Partial<ChatConfig>) => void;
+}
+interface IMessageFormatter {
+    toCoreMessages(messages: ReadonlyArray<ChatMessage>): ChatMessage$1[];
+    toChatMessage(content: string, sender: ChatMessage["sender"]): ChatMessage;
+}
+
+/**
+ * Conversation engine over the neutral text surface. Accepts either a
+ * single ITextProvider or a ProviderFactory (which brings tier defaults,
+ * health checks, and fallback across providers). Model choice is tier-based:
+ * `config.tier ?? provider default` — no hardcoded model names anywhere.
+ */
+declare class ChatService implements IChatService {
+    private readonly engine;
+    private config;
+    private promptStrategy;
+    private storage;
+    constructor(engine: ITextProvider | ProviderFactory);
+    initialize(config: ChatConfig): void;
+    updateConfig(config: Partial<ChatConfig>): void;
+    setPromptStrategy(strategy: SystemPromptStrategy): void;
+    setStorage(storage: IChatStorage): void;
+    getConversation(conversationId: string): Promise<ChatConversation | null>;
+    getConversations(): Promise<ChatConversation[]>;
+    sendMessage(input: SendMessageInput): Promise<SendMessageResult>;
+    generateAIResponse(companionId: string, userMessage: string, context?: ReadonlyArray<ChatMessage>): Promise<ChatMessage>;
+    generateStreamingResponse(userMessage: string, context: ReadonlyArray<ChatMessage>, onChunk: (chunk: string) => void): Promise<string>;
+    private buildRequest;
+    private resolveSystemPrompt;
+    private run;
+    private runStream;
+    private requireStorage;
+}
+declare function extractTokenUsage(message: ChatMessage): ChatTokenUsage | null;
+
+export { type ChatConfig as C, DEFAULT_PROMPT_STRATEGY as D, type IChatService as I, type SendMessageInput as S, type UseChatOptions as U, type ChatConversation as a, type ChatMessageSender as b, type ChatMessageType as c, ChatService as d, type ChatTokenUsage as e, type ChatMessage as f, type IChatStorage as g, type IMessageFormatter as h, type SendMessageResult as i, type SystemPromptStrategy as j, type UseChatReturn as k, extractTokenUsage as l };