@qwanyx/stack 0.2.75 → 0.2.76

package/dist/client/LLMClient.d.ts

@@ -0,0 +1,86 @@
+/**
+ * LLMClient - AI/LLM Communication Layer
+ *
+ * Provides a type-safe interface to the qwanyx-brain LLM coprocessor.
+ * All operations communicate through the unified `/spu/invoke` endpoint.
+ */
+export type QwanyxModel = 'xlm' | 'mlm' | 'nlm';
+export interface LLMClientConfig {
+    baseUrl: string;
+    system_id: string;
+}
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface AnalyzeDocumentFile {
+    filename: string;
+    data: string;
+    content_type: string;
+}
+export declare class LLMClient {
+    private config;
+    constructor(config: LLMClientConfig);
+    /**
+     * Call the LLM coprocessor
+     */
+    private callLLM;
+    /**
+     * Get auth token from localStorage (browser) or return empty string
+     */
+    private getToken;
+    /**
+     * Simple text completion
+     */
+    complete(prompt: string, options?: {
+        model?: QwanyxModel;
+        systemPrompt?: string;
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<string>;
+    /**
+     * Chat completion with messages
+     */
+    chat(messages: ChatMessage[], options?: {
+        model?: QwanyxModel;
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<string>;
+    /**
+     * Chat completion with JSON response
+     * Automatically parses the response and strips markdown code blocks
+     */
+    chatJson<T>(systemPrompt: string, userPrompt: string, options?: {
+        model?: QwanyxModel;
+        temperature?: number;
+    }): Promise<T>;
+    /**
+     * Analyze documents (PDF, images, text files) via base64 encoding
+     */
+    analyzeDocuments(prompt: string, files: AnalyzeDocumentFile[], options?: {
+        model?: QwanyxModel;
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<string>;
+    /**
+     * Transcribe audio to text
+     */
+    transcribe(audioData: string, // base64 encoded
+    options?: {
+        filename?: string;
+        language?: string;
+    }): Promise<string>;
+    private promptCache;
+    /**
+     * Get a prompt template from the server
+     */
+    getPrompt(name: string): Promise<string>;
+    /**
+     * Clear prompt cache (useful when prompts are updated)
+     */
+    clearPromptCache(): void;
+    /**
+     * Replace {{placeholders}} in a prompt template
+     */
+    buildPrompt(template: string, context: Record<string, string>): string;
+}