@qwanyx/stack 0.2.74 → 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;
+}

package/dist/components/QMap/QMap.d.ts

@@ -11,4 +11,4 @@
  */
 import { GraphNode } from '../../types';
 import type { QMapProps } from './types';
-export declare function QMap<T extends GraphNode = GraphNode>({ viewNode, nodes, edges, renderNode, defaultNodeWidth, defaultNodeHeight, onNodeMove, onNodeClick, onNodeDoubleClick, onNodeContextMenu, onSelectionChange, onEdgeClick, onViewChange, onTransformChange, minZoom, maxZoom, initialTransform, defaultEdgeStyle, defaultEdgeColor, defaultEdgeWidth, draggable, selectable, zoomable, pannable, className, style, background, showGrid, gridSize }: QMapProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function QMap<T extends GraphNode = GraphNode>({ viewNode, nodes, edges, renderNode, defaultNodeWidth, defaultNodeHeight, onNodeMove, onNodeClick, onNodeDoubleClick, onNodeContextMenu, selectedIds: controlledSelectedIds, onSelectionChange, onEdgeClick, onViewChange, onTransformChange, minZoom, maxZoom, initialTransform, defaultEdgeStyle, defaultEdgeColor, defaultEdgeWidth, draggable, selectable, zoomable, pannable, className, style, background, showGrid, gridSize }: QMapProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/components/QMap/hooks/useSelection.d.ts

@@ -12,6 +12,8 @@ export interface UseSelectionOptions {
     transform: QMapTransform;
     nodePositions: Map<string, QMapNodePosition>;
     disabled?: boolean;
+    /** Controlled selection - if provided, uses this instead of internal state */
+    controlledSelectedIds?: string[];
     onSelectionChange?: (selectedIds: string[]) => void;
 }
 export declare function useSelection(options: UseSelectionOptions): UseSelectionReturn;

package/dist/components/QMap/types.d.ts

@@ -50,6 +50,8 @@ export interface QMapProps<T extends GraphNode = GraphNode> {
     onNodeClick?: (node: T, event: React.MouseEvent) => void;
     onNodeDoubleClick?: (node: T, event: React.MouseEvent) => void;
     onNodeContextMenu?: (node: T, event: React.MouseEvent) => void;
+    /** Controlled selection - if provided, component uses this instead of internal state */
+    selectedIds?: string[];
     onSelectionChange?: (selectedIds: string[]) => void;
     onEdgeClick?: (edge: QMapEdge, event: React.MouseEvent) => void;
     onViewChange?: (viewData: QMapViewData) => void;