@lssm/module.ai-chat 0.0.0-canary-20251217052941 → 0.0.0-canary-20251217060433

package/dist/ai-chat.feature.d.ts

@@ -0,0 +1,11 @@
+import { FeatureModuleSpec } from "@lssm/lib.contracts";
+
+//#region src/ai-chat.feature.d.ts
+
+/**
+ * AI Chat feature module that bundles conversational AI assistance
+ * for ContractSpec development across CLI, VSCode, and Studio.
+ */
+declare const AiChatFeature: FeatureModuleSpec;
+//#endregion
+export { AiChatFeature };

package/dist/context/context-builder.d.ts

@@ -0,0 +1,56 @@
+import { WorkspaceContext } from "./workspace-context.js";
+
+//#region src/context/context-builder.d.ts
+
+/**
+ * Context entry for a file or spec
+ */
+interface ContextEntry {
+  type: 'spec' | 'file' | 'reference';
+  path: string;
+  content?: string;
+  summary?: string;
+  relevance: number;
+}
+/**
+ * Built context for LLM
+ */
+interface BuiltContext {
+  entries: ContextEntry[];
+  summary: string;
+  totalTokensEstimate: number;
+}
+/**
+ * Options for building context
+ */
+interface ContextBuilderOptions {
+  /** Maximum estimated tokens for context */
+  maxTokens?: number;
+  /** Query to use for relevance scoring */
+  query?: string;
+  /** Specific files to include */
+  includeFiles?: string[];
+  /** Specific specs to include */
+  includeSpecs?: string[];
+}
+/**
+ * Context builder for creating rich LLM context
+ */
+declare class ContextBuilder {
+  private readonly context;
+  constructor(context: WorkspaceContext);
+  /**
+   * Build context for a chat message
+   */
+  build(options?: ContextBuilderOptions): BuiltContext;
+  /**
+   * Build a text summary of the context entries
+   */
+  private buildSummary;
+}
+/**
+ * Create a context builder
+ */
+declare function createContextBuilder(context: WorkspaceContext): ContextBuilder;
+//#endregion
+export { BuiltContext, ContextBuilder, ContextBuilderOptions, ContextEntry, createContextBuilder };

package/dist/context/file-operations.d.ts

@@ -0,0 +1,99 @@
+//#region src/context/file-operations.d.ts
+/**
+ * File operations for workspace context
+ *
+ * Provides read/write operations for files in the workspace.
+ */
+/**
+ * Result of a file read operation
+ */
+interface FileReadResult {
+  success: boolean;
+  path: string;
+  content?: string;
+  error?: string;
+}
+/**
+ * Result of a file write operation
+ */
+interface FileWriteResult {
+  success: boolean;
+  path: string;
+  error?: string;
+}
+/**
+ * File operation to perform
+ */
+interface FileOperation {
+  type: 'read' | 'write' | 'create' | 'delete';
+  path: string;
+  content?: string;
+}
+/**
+ * Result of a file operation
+ */
+interface FileOperationResult {
+  operation: FileOperation;
+  success: boolean;
+  content?: string;
+  error?: string;
+}
+/**
+ * Interface for file system operations
+ */
+interface FileSystem {
+  /**
+   * Read a file's contents
+   */
+  readFile(path: string): Promise<string>;
+  /**
+   * Write content to a file
+   */
+  writeFile(path: string, content: string): Promise<void>;
+  /**
+   * Check if a file exists
+   */
+  exists(path: string): Promise<boolean>;
+  /**
+   * Delete a file
+   */
+  deleteFile(path: string): Promise<void>;
+  /**
+   * List files in a directory
+   */
+  listFiles(directory: string, options?: {
+    recursive?: boolean;
+    pattern?: string;
+  }): Promise<string[]>;
+}
+/**
+ * File operations executor
+ */
+declare class FileOperations {
+  private readonly fs;
+  private readonly workspacePath;
+  private readonly allowWrites;
+  constructor(fs: FileSystem, workspacePath: string, allowWrites?: boolean);
+  /**
+   * Read a file
+   */
+  read(relativePath: string): Promise<FileReadResult>;
+  /**
+   * Write to a file
+   */
+  write(relativePath: string, content: string): Promise<FileWriteResult>;
+  /**
+   * Execute multiple file operations
+   */
+  execute(operations: FileOperation[]): Promise<FileOperationResult[]>;
+  /**
+   * Resolve a relative path to an absolute path
+   */
+  private resolvePath;
+}
+/**
+ * Create a file operations instance with Node.js fs
+ */
+declare function createNodeFileOperations(workspacePath: string, allowWrites?: boolean): FileOperations;
+//#endregion
+export { FileOperation, FileOperationResult, FileOperations, FileReadResult, FileSystem, FileWriteResult, createNodeFileOperations };

package/dist/context/index.d.ts

@@ -0,0 +1,4 @@
+import { FileInfo, SpecInfo, WorkspaceContext, WorkspaceContextConfig, WorkspaceSummary, createWorkspaceContext } from "./workspace-context.js";
+import { BuiltContext, ContextBuilder, ContextBuilderOptions, ContextEntry, createContextBuilder } from "./context-builder.js";
+import { FileOperation, FileOperationResult, FileOperations, FileReadResult, FileSystem, FileWriteResult, createNodeFileOperations } from "./file-operations.js";
+export { BuiltContext, ContextBuilder, ContextBuilderOptions, ContextEntry, FileInfo, FileOperation, FileOperationResult, FileOperations, FileReadResult, FileSystem, FileWriteResult, SpecInfo, WorkspaceContext, WorkspaceContextConfig, WorkspaceSummary, createContextBuilder, createNodeFileOperations, createWorkspaceContext };

package/dist/context/workspace-context.d.ts

@@ -0,0 +1,116 @@
+//#region src/context/workspace-context.d.ts
+/**
+ * Workspace context management
+ *
+ * Provides access to specs, files, and codebase information
+ * for context-aware AI chat assistance.
+ */
+/**
+ * Spec information for context
+ */
+interface SpecInfo {
+  name: string;
+  version: number;
+  type: 'command' | 'query' | 'event' | 'presentation';
+  path: string;
+  description?: string;
+  tags?: string[];
+}
+/**
+ * File information for context
+ */
+interface FileInfo {
+  path: string;
+  relativePath: string;
+  name: string;
+  extension: string;
+  size: number;
+  isSpec: boolean;
+}
+/**
+ * Workspace summary for context
+ */
+interface WorkspaceSummary {
+  name: string;
+  path: string;
+  specs: {
+    total: number;
+    commands: number;
+    queries: number;
+    events: number;
+    presentations: number;
+  };
+  files: {
+    total: number;
+    typescript: number;
+    specFiles: number;
+  };
+}
+/**
+ * Configuration for workspace context
+ */
+interface WorkspaceContextConfig {
+  /** Root path of the workspace */
+  workspacePath: string;
+  /** File patterns to include */
+  includePatterns?: string[];
+  /** File patterns to exclude */
+  excludePatterns?: string[];
+  /** Maximum file size to read (bytes) */
+  maxFileSize?: number;
+  /** Whether to enable file writes */
+  allowWrites?: boolean;
+}
+/**
+ * Workspace context for AI chat
+ */
+declare class WorkspaceContext {
+  readonly workspacePath: string;
+  readonly allowWrites: boolean;
+  private specs;
+  private files;
+  private initialized;
+  constructor(config: WorkspaceContextConfig);
+  /**
+   * Initialize the workspace context by scanning files
+   */
+  initialize(): Promise<void>;
+  /**
+   * Get all discovered specs
+   */
+  getSpecs(): SpecInfo[];
+  /**
+   * Get all discovered files
+   */
+  getFiles(): FileInfo[];
+  /**
+   * Add specs to the context
+   */
+  addSpecs(specs: SpecInfo[]): void;
+  /**
+   * Add files to the context
+   */
+  addFiles(files: FileInfo[]): void;
+  /**
+   * Get a summary of the workspace for context
+   */
+  getSummary(): WorkspaceSummary;
+  /**
+   * Get a context summary for LLM prompts
+   */
+  getContextSummary(): string;
+  /**
+   * Find specs matching a query
+   */
+  findSpecs(query: string): SpecInfo[];
+  /**
+   * Find files matching a query
+   */
+  findFiles(query: string): FileInfo[];
+}
+/**
+ * Create a workspace context from a path
+ */
+declare function createWorkspaceContext(path: string, options?: Partial<WorkspaceContextConfig>): Promise<WorkspaceContext>;
+//#endregion
+export { FileInfo, SpecInfo, WorkspaceContext, WorkspaceContextConfig, WorkspaceSummary, createWorkspaceContext };

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

@@ -0,0 +1,72 @@
+import { WorkspaceContext } from "../context/workspace-context.js";
+import { ChatConversation, SendMessageOptions, SendMessageResult, StreamMessageResult } from "./message-types.js";
+import { ConversationStore } from "./conversation-store.js";
+import { Provider } from "@lssm/lib.ai-providers";
+
+//#region src/core/chat-service.d.ts
+
+/**
+ * Configuration for ChatService
+ */
+interface ChatServiceConfig {
+  /** LLM provider to use */
+  provider: Provider;
+  /** Optional workspace context for code-aware chat */
+  context?: WorkspaceContext;
+  /** Optional conversation store (defaults to in-memory) */
+  store?: ConversationStore;
+  /** Default system prompt */
+  systemPrompt?: string;
+  /** Maximum conversation history to include */
+  maxHistoryMessages?: number;
+  /** Callback for usage tracking */
+  onUsage?: (usage: {
+    inputTokens: number;
+    outputTokens: number;
+  }) => void;
+}
+/**
+ * Main chat service for AI-powered conversations
+ */
+declare class ChatService {
+  private readonly provider;
+  private readonly context?;
+  private readonly store;
+  private readonly systemPrompt;
+  private readonly maxHistoryMessages;
+  private readonly onUsage?;
+  constructor(config: ChatServiceConfig);
+  /**
+   * Send a message and get a complete response
+   */
+  send(options: SendMessageOptions): Promise<SendMessageResult>;
+  /**
+   * Send a message and get a streaming response
+   */
+  stream(options: SendMessageOptions): Promise<StreamMessageResult>;
+  /**
+   * Get a conversation by ID
+   */
+  getConversation(conversationId: string): Promise<ChatConversation | null>;
+  /**
+   * List conversations
+   */
+  listConversations(options?: {
+    limit?: number;
+    offset?: number;
+  }): Promise<ChatConversation[]>;
+  /**
+   * Delete a conversation
+   */
+  deleteConversation(conversationId: string): Promise<boolean>;
+  /**
+   * Build prompt string for LLM
+   */
+  private buildPrompt;
+}
+/**
+ * Create a chat service with the given configuration
+ */
+declare function createChatService(config: ChatServiceConfig): ChatService;
+//#endregion
+export { ChatService, ChatServiceConfig, createChatService };

package/dist/core/conversation-store.d.ts

@@ -0,0 +1,73 @@
+import { ChatConversation, ChatMessage, ConversationStatus } from "./message-types.js";
+
+//#region src/core/conversation-store.d.ts
+
+/**
+ * Interface for conversation persistence
+ */
+interface ConversationStore {
+  /**
+   * Get a conversation by ID
+   */
+  get(conversationId: string): Promise<ChatConversation | null>;
+  /**
+   * Create a new conversation
+   */
+  create(conversation: Omit<ChatConversation, 'id' | 'createdAt' | 'updatedAt'>): Promise<ChatConversation>;
+  /**
+   * Update conversation properties
+   */
+  update(conversationId: string, updates: Partial<Pick<ChatConversation, 'title' | 'status' | 'summary' | 'metadata'>>): Promise<ChatConversation | null>;
+  /**
+   * Append a message to a conversation
+   */
+  appendMessage(conversationId: string, message: Omit<ChatMessage, 'id' | 'conversationId' | 'createdAt' | 'updatedAt'>): Promise<ChatMessage>;
+  /**
+   * Update a message in a conversation
+   */
+  updateMessage(conversationId: string, messageId: string, updates: Partial<ChatMessage>): Promise<ChatMessage | null>;
+  /**
+   * Delete a conversation
+   */
+  delete(conversationId: string): Promise<boolean>;
+  /**
+   * List conversations with optional filters
+   */
+  list(options?: {
+    status?: ConversationStatus;
+    limit?: number;
+    offset?: number;
+  }): Promise<ChatConversation[]>;
+  /**
+   * Search conversations by content
+   */
+  search(query: string, limit?: number): Promise<ChatConversation[]>;
+}
+/**
+ * In-memory conversation store for development and testing
+ */
+declare class InMemoryConversationStore implements ConversationStore {
+  private readonly conversations;
+  get(conversationId: string): Promise<ChatConversation | null>;
+  create(conversation: Omit<ChatConversation, 'id' | 'createdAt' | 'updatedAt'>): Promise<ChatConversation>;
+  update(conversationId: string, updates: Partial<Pick<ChatConversation, 'title' | 'status' | 'summary' | 'metadata'>>): Promise<ChatConversation | null>;
+  appendMessage(conversationId: string, message: Omit<ChatMessage, 'id' | 'conversationId' | 'createdAt' | 'updatedAt'>): Promise<ChatMessage>;
+  updateMessage(conversationId: string, messageId: string, updates: Partial<ChatMessage>): Promise<ChatMessage | null>;
+  delete(conversationId: string): Promise<boolean>;
+  list(options?: {
+    status?: ConversationStatus;
+    limit?: number;
+    offset?: number;
+  }): Promise<ChatConversation[]>;
+  search(query: string, limit?: number): Promise<ChatConversation[]>;
+  /**
+   * Clear all conversations (for testing)
+   */
+  clear(): void;
+}
+/**
+ * Create an in-memory conversation store
+ */
+declare function createInMemoryConversationStore(): ConversationStore;
+//#endregion
+export { ConversationStore, InMemoryConversationStore, createInMemoryConversationStore };

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+import { ChatAttachment, ChatCodeBlock, ChatConversation, ChatMessage, ChatRole, ChatSource, ChatStreamChunk, ChatToolCall, ConversationStatus, MessageStatus, SendMessageOptions, SendMessageResult, StreamMessageResult } from "./message-types.js";
+import { ConversationStore, InMemoryConversationStore, createInMemoryConversationStore } from "./conversation-store.js";
+import { ChatService, ChatServiceConfig, createChatService } from "./chat-service.js";
+export { ChatAttachment, ChatCodeBlock, ChatConversation, ChatMessage, ChatRole, ChatService, ChatServiceConfig, ChatSource, ChatStreamChunk, ChatToolCall, ConversationStatus, ConversationStore, InMemoryConversationStore, MessageStatus, SendMessageOptions, SendMessageResult, StreamMessageResult, createChatService, createInMemoryConversationStore };

package/dist/core/message-types.d.ts

@@ -0,0 +1,149 @@
+//#region src/core/message-types.d.ts
+/**
+ * Message and conversation types for AI Chat
+ */
+/**
+ * Role of a message participant
+ */
+type ChatRole = 'user' | 'assistant' | 'system';
+/**
+ * Status of a message
+ */
+type MessageStatus = 'pending' | 'streaming' | 'completed' | 'error';
+/**
+ * Attachment type for messages
+ */
+interface ChatAttachment {
+  id: string;
+  type: 'file' | 'image' | 'code' | 'spec';
+  name: string;
+  content?: string;
+  mimeType?: string;
+  size?: number;
+  path?: string;
+}
+/**
+ * Code block within a message
+ */
+interface ChatCodeBlock {
+  id: string;
+  language: string;
+  code: string;
+  filename?: string;
+  startLine?: number;
+  endLine?: number;
+}
+/**
+ * Tool call information
+ */
+interface ChatToolCall {
+  id: string;
+  name: string;
+  args: Record<string, unknown>;
+  result?: unknown;
+  status: 'pending' | 'running' | 'completed' | 'error';
+  error?: string;
+}
+/**
+ * Source/citation in a message
+ */
+interface ChatSource {
+  id: string;
+  title: string;
+  url?: string;
+  snippet?: string;
+  type: 'file' | 'spec' | 'doc' | 'web';
+}
+/**
+ * A single chat message
+ */
+interface ChatMessage {
+  id: string;
+  conversationId: string;
+  role: ChatRole;
+  content: string;
+  status: MessageStatus;
+  createdAt: Date;
+  updatedAt: Date;
+  attachments?: ChatAttachment[];
+  codeBlocks?: ChatCodeBlock[];
+  toolCalls?: ChatToolCall[];
+  sources?: ChatSource[];
+  reasoning?: string;
+  usage?: {
+    inputTokens: number;
+    outputTokens: number;
+  };
+  error?: {
+    code: string;
+    message: string;
+  };
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Conversation status
+ */
+type ConversationStatus = 'active' | 'archived' | 'deleted';
+/**
+ * A conversation containing multiple messages
+ */
+interface ChatConversation {
+  id: string;
+  title?: string;
+  status: ConversationStatus;
+  createdAt: Date;
+  updatedAt: Date;
+  provider: string;
+  model: string;
+  workspacePath?: string;
+  contextFiles?: string[];
+  messages: ChatMessage[];
+  summary?: string;
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Options for sending a message
+ */
+interface SendMessageOptions {
+  conversationId?: string;
+  content: string;
+  attachments?: ChatAttachment[];
+  systemPrompt?: string;
+  maxTokens?: number;
+  temperature?: number;
+  stream?: boolean;
+}
+/**
+ * Streaming chunk from AI response
+ */
+interface ChatStreamChunk {
+  type: 'text' | 'reasoning' | 'tool_call' | 'source' | 'error' | 'done';
+  content?: string;
+  toolCall?: ChatToolCall;
+  source?: ChatSource;
+  error?: {
+    code: string;
+    message: string;
+  };
+  usage?: {
+    inputTokens: number;
+    outputTokens: number;
+  };
+}
+/**
+ * Result of sending a message
+ */
+interface SendMessageResult {
+  message: ChatMessage;
+  conversation: ChatConversation;
+}
+/**
+ * Streaming result
+ */
+interface StreamMessageResult {
+  conversationId: string;
+  messageId: string;
+  stream: AsyncIterable<ChatStreamChunk>;
+}
+//#endregion
+export { ChatAttachment, ChatCodeBlock, ChatConversation, ChatMessage, ChatRole, ChatSource, ChatStreamChunk, ChatToolCall, ConversationStatus, MessageStatus, SendMessageOptions, SendMessageResult, StreamMessageResult };

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { FileInfo, SpecInfo, WorkspaceContext, WorkspaceContextConfig, WorkspaceSummary, createWorkspaceContext } from "./context/workspace-context.js";
+import { BuiltContext, ContextBuilder, ContextBuilderOptions, ContextEntry, createContextBuilder } from "./context/context-builder.js";
+import { FileOperation, FileOperationResult, FileOperations, FileReadResult, FileSystem, FileWriteResult, createNodeFileOperations } from "./context/file-operations.js";
+import { ChatAttachment, ChatCodeBlock, ChatConversation, ChatMessage, ChatRole, ChatSource, ChatStreamChunk, ChatToolCall, ConversationStatus, MessageStatus, SendMessageOptions, SendMessageResult, StreamMessageResult } from "./core/message-types.js";
+import { ConversationStore, InMemoryConversationStore, createInMemoryConversationStore } from "./core/conversation-store.js";
+import { ChatService, ChatServiceConfig, createChatService } from "./core/chat-service.js";
+import "./core/index.js";
+import { AiChatFeature } from "./ai-chat.feature.js";
+import { isStudioAvailable, supportsLocalMode } from "./providers/chat-utilities.js";
+import { ChatModelInfo, ChatProvider, ChatProviderConfig, ChatProviderMode, ChatProviderName, DEFAULT_MODELS, MODELS, ModelCapabilities, ProviderAvailability, createProvider, createProviderFromEnv, getAvailableProviders, getDefaultModel, getEnvVarName, getModelInfo, getModelsForProvider, getRecommendedModels, hasCredentials, isOllamaRunning, listOllamaModels, validateProvider } from "./providers/index.js";
+import { ChatContainer } from "./presentation/components/ChatContainer.js";
+import { ChatMessage as ChatMessage$1 } from "./presentation/components/ChatMessage.js";
+import { ChatInput } from "./presentation/components/ChatInput.js";
+import "./presentation/components/index.js";
+import { useChat } from "./presentation/hooks/useChat.js";
+import { useProviders } from "./presentation/hooks/useProviders.js";
+import "./presentation/hooks/index.js";
+export { AiChatFeature, BuiltContext, ChatAttachment, ChatCodeBlock, ChatContainer, ChatConversation, ChatInput, ChatMessage, ChatMessage$1 as ChatMessageComponent, ChatModelInfo, ChatProvider, ChatProviderConfig, ChatProviderMode, ChatProviderName, ChatRole, ChatService, ChatServiceConfig, ChatSource, ChatStreamChunk, ChatToolCall, ContextBuilder, ContextBuilderOptions, ContextEntry, ConversationStatus, ConversationStore, DEFAULT_MODELS, FileInfo, FileOperation, FileOperationResult, FileOperations, FileReadResult, FileSystem, FileWriteResult, InMemoryConversationStore, MODELS, MessageStatus, ModelCapabilities, ProviderAvailability, SendMessageOptions, SendMessageResult, SpecInfo, StreamMessageResult, WorkspaceContext, WorkspaceContextConfig, WorkspaceSummary, createChatService, createContextBuilder, createInMemoryConversationStore, createNodeFileOperations, createProvider, createProviderFromEnv, createWorkspaceContext, getAvailableProviders, getDefaultModel, getEnvVarName, getModelInfo, getModelsForProvider, getRecommendedModels, hasCredentials, isOllamaRunning, isStudioAvailable, listOllamaModels, supportsLocalMode, useChat, useProviders, validateProvider };

package/dist/presentation/components/ChatContainer.d.ts

@@ -0,0 +1,20 @@
+import * as React from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/presentation/components/ChatContainer.d.ts
+interface ChatContainerProps {
+  children: React.ReactNode;
+  className?: string;
+  /** Show scroll-to-bottom button when scrolled up */
+  showScrollButton?: boolean;
+}
+/**
+ * Container component for chat messages with scrolling
+ */
+declare function ChatContainer({
+  children,
+  className,
+  showScrollButton
+}: ChatContainerProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { ChatContainer };

package/dist/presentation/components/ChatInput.d.ts

@@ -0,0 +1,34 @@
+import { ChatAttachment } from "../../core/message-types.js";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
+
+//#region src/presentation/components/ChatInput.d.ts
+interface ChatInputProps {
+  /** Called when a message is sent */
+  onSend: (content: string, attachments?: ChatAttachment[]) => void;
+  /** Whether input is disabled (e.g., during streaming) */
+  disabled?: boolean;
+  /** Whether currently loading/streaming */
+  isLoading?: boolean;
+  /** Placeholder text */
+  placeholder?: string;
+  /** Additional class name */
+  className?: string;
+  /** Show attachment button */
+  showAttachments?: boolean;
+  /** Max attachments allowed */
+  maxAttachments?: number;
+}
+/**
+ * Chat input component with attachment support
+ */
+declare function ChatInput({
+  onSend,
+  disabled,
+  isLoading,
+  placeholder,
+  className,
+  showAttachments,
+  maxAttachments
+}: ChatInputProps): react_jsx_runtime2.JSX.Element;
+//#endregion
+export { ChatInput };

package/dist/presentation/components/ChatMessage.d.ts

@@ -0,0 +1,23 @@
+import { ChatMessage } from "../../core/message-types.js";
+import * as react_jsx_runtime1 from "react/jsx-runtime";
+
+//#region src/presentation/components/ChatMessage.d.ts
+interface ChatMessageProps {
+  message: ChatMessage;
+  className?: string;
+  /** Show copy button */
+  showCopy?: boolean;
+  /** Show avatar */
+  showAvatar?: boolean;
+}
+/**
+ * Chat message component
+ */
+declare function ChatMessage$1({
+  message,
+  className,
+  showCopy,
+  showAvatar
+}: ChatMessageProps): react_jsx_runtime1.JSX.Element;
+//#endregion
+export { ChatMessage$1 as ChatMessage };

package/dist/presentation/components/CodePreview.d.ts

@@ -0,0 +1,39 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/presentation/components/CodePreview.d.ts
+interface CodePreviewProps {
+  /** Code content */
+  code: string;
+  /** Programming language */
+  language?: string;
+  /** File name */
+  filename?: string;
+  /** Additional class name */
+  className?: string;
+  /** Show copy button */
+  showCopy?: boolean;
+  /** Show execute button (for applicable languages) */
+  showExecute?: boolean;
+  /** Called when execute is clicked */
+  onExecute?: (code: string) => void;
+  /** Show download button */
+  showDownload?: boolean;
+  /** Max height before scroll */
+  maxHeight?: number;
+}
+/**
+ * Code preview component with syntax highlighting placeholder
+ */
+declare function CodePreview({
+  code,
+  language,
+  filename,
+  className,
+  showCopy,
+  showExecute,
+  onExecute,
+  showDownload,
+  maxHeight
+}: CodePreviewProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { CodePreview };

package/dist/presentation/components/ContextIndicator.d.ts

@@ -0,0 +1,25 @@
+import { WorkspaceSummary } from "../../context/workspace-context.js";
+import * as react_jsx_runtime4 from "react/jsx-runtime";
+
+//#region src/presentation/components/ContextIndicator.d.ts
+interface ContextIndicatorProps {
+  /** Workspace summary */
+  summary?: WorkspaceSummary;
+  /** Whether context is active */
+  active?: boolean;
+  /** Additional class name */
+  className?: string;
+  /** Show details */
+  showDetails?: boolean;
+}
+/**
+ * Indicator showing active workspace context
+ */
+declare function ContextIndicator({
+  summary,
+  active,
+  className,
+  showDetails
+}: ContextIndicatorProps): react_jsx_runtime4.JSX.Element;
+//#endregion
+export { ContextIndicator };

package/dist/presentation/components/ModelPicker.d.ts

@@ -0,0 +1,38 @@
+import { ProviderMode, ProviderName } from "@lssm/lib.ai-providers";
+import * as react_jsx_runtime3 from "react/jsx-runtime";
+
+//#region src/presentation/components/ModelPicker.d.ts
+interface ModelSelection {
+  provider: ProviderName;
+  model: string;
+  mode: ProviderMode;
+}
+interface ModelPickerProps {
+  /** Currently selected provider/model */
+  value: ModelSelection;
+  /** Called when selection changes */
+  onChange: (value: ModelSelection) => void;
+  /** Available providers (with availability info) */
+  availableProviders?: Array<{
+    provider: ProviderName;
+    available: boolean;
+    mode: ProviderMode;
+    reason?: string;
+  }>;
+  /** Additional class name */
+  className?: string;
+  /** Compact mode (smaller) */
+  compact?: boolean;
+}
+/**
+ * Model picker component for selecting AI provider and model
+ */
+declare function ModelPicker({
+  value,
+  onChange,
+  availableProviders,
+  className,
+  compact
+}: ModelPickerProps): react_jsx_runtime3.JSX.Element;
+//#endregion
+export { ModelPicker };

package/dist/presentation/components/index.d.ts

@@ -0,0 +1,7 @@
+import { ChatContainer } from "./ChatContainer.js";
+import { ChatMessage } from "./ChatMessage.js";
+import { ChatInput } from "./ChatInput.js";
+import { ModelPicker } from "./ModelPicker.js";
+import { ContextIndicator } from "./ContextIndicator.js";
+import { CodePreview } from "./CodePreview.js";
+export { ChatContainer, ChatInput, ChatMessage, CodePreview, ContextIndicator, ModelPicker };

package/dist/presentation/hooks/index.d.ts

@@ -0,0 +1,3 @@
+import { UseChatOptions, UseChatReturn, useChat } from "./useChat.js";
+import { UseProvidersReturn, useProviders } from "./useProviders.js";
+export { type UseChatOptions, type UseChatReturn, type UseProvidersReturn, useChat, useProviders };

package/dist/presentation/hooks/useChat.d.ts

@@ -0,0 +1,66 @@
+import { ChatAttachment, ChatConversation, ChatMessage } from "../../core/message-types.js";
+import { ProviderMode, ProviderName } from "@lssm/lib.ai-providers";
+
+//#region src/presentation/hooks/useChat.d.ts
+
+/**
+ * Options for useChat hook
+ */
+interface UseChatOptions {
+  /** Provider to use */
+  provider?: ProviderName;
+  /** Provider mode */
+  mode?: ProviderMode;
+  /** Model to use */
+  model?: string;
+  /** API key for BYOK mode */
+  apiKey?: string;
+  /** API proxy URL for managed mode */
+  proxyUrl?: string;
+  /** Initial conversation ID to resume */
+  conversationId?: string;
+  /** System prompt override */
+  systemPrompt?: string;
+  /** Enable streaming */
+  streaming?: boolean;
+  /** Called when a message is sent */
+  onSend?: (message: ChatMessage) => void;
+  /** Called when a response is received */
+  onResponse?: (message: ChatMessage) => void;
+  /** Called on error */
+  onError?: (error: Error) => void;
+  /** Called when usage is recorded */
+  onUsage?: (usage: {
+    inputTokens: number;
+    outputTokens: number;
+  }) => void;
+}
+/**
+ * Return type for useChat hook
+ */
+interface UseChatReturn {
+  /** Current messages */
+  messages: ChatMessage[];
+  /** Current conversation */
+  conversation: ChatConversation | null;
+  /** Whether currently loading/streaming */
+  isLoading: boolean;
+  /** Current error */
+  error: Error | null;
+  /** Send a message */
+  sendMessage: (content: string, attachments?: ChatAttachment[]) => Promise<void>;
+  /** Clear conversation and start fresh */
+  clearConversation: () => void;
+  /** Set conversation ID to resume */
+  setConversationId: (id: string | null) => void;
+  /** Regenerate last response */
+  regenerate: () => Promise<void>;
+  /** Stop current generation */
+  stop: () => void;
+}
+/**
+ * Hook for managing AI chat state
+ */
+declare function useChat(options?: UseChatOptions): UseChatReturn;
+//#endregion
+export { UseChatOptions, UseChatReturn, useChat };

package/dist/presentation/hooks/useProviders.d.ts

@@ -0,0 +1,37 @@
+import { ModelInfo, ProviderMode, ProviderName } from "@lssm/lib.ai-providers";
+
+//#region src/presentation/hooks/useProviders.d.ts
+
+/**
+ * Provider availability info
+ */
+interface ProviderInfo {
+  provider: ProviderName;
+  available: boolean;
+  mode: ProviderMode;
+  reason?: string;
+  models: ModelInfo[];
+}
+/**
+ * Return type for useProviders hook
+ */
+interface UseProvidersReturn {
+  /** All providers with availability info */
+  providers: ProviderInfo[];
+  /** Available providers only */
+  availableProviders: ProviderInfo[];
+  /** Check if a provider is available */
+  isAvailable: (provider: ProviderName) => boolean;
+  /** Get models for a provider */
+  getModels: (provider: ProviderName) => ModelInfo[];
+  /** Loading state */
+  isLoading: boolean;
+  /** Refresh provider availability */
+  refresh: () => Promise<void>;
+}
+/**
+ * Hook for managing AI provider information
+ */
+declare function useProviders(): UseProvidersReturn;
+//#endregion
+export { UseProvidersReturn, useProviders };

package/dist/presentation/index.d.ts

@@ -0,0 +1,11 @@
+import { ChatContainer } from "./components/ChatContainer.js";
+import { ChatMessage } from "./components/ChatMessage.js";
+import { ChatInput } from "./components/ChatInput.js";
+import { ModelPicker } from "./components/ModelPicker.js";
+import { ContextIndicator } from "./components/ContextIndicator.js";
+import { CodePreview } from "./components/CodePreview.js";
+import "./components/index.js";
+import { UseChatOptions, UseChatReturn, useChat } from "./hooks/useChat.js";
+import { UseProvidersReturn, useProviders } from "./hooks/useProviders.js";
+import "./hooks/index.js";
+export { ChatContainer, ChatInput, ChatMessage, CodePreview, ContextIndicator, ModelPicker, UseChatOptions, UseChatReturn, UseProvidersReturn, useChat, useProviders };

package/dist/providers/chat-utilities.d.ts

@@ -0,0 +1,14 @@
+import { ProviderName } from "@lssm/lib.ai-providers";
+
+//#region src/providers/chat-utilities.d.ts
+
+/**
+ * Check if a provider supports local mode
+ */
+declare function supportsLocalMode(provider: ProviderName): boolean;
+/**
+ * Check if a provider is available in Studio (cloud only)
+ */
+declare function isStudioAvailable(provider: ProviderName): boolean;
+//#endregion
+export { isStudioAvailable, supportsLocalMode };

package/dist/providers/index.d.ts

@@ -0,0 +1,3 @@
+import { isStudioAvailable, supportsLocalMode } from "./chat-utilities.js";
+import { DEFAULT_MODELS, MODELS, ModelCapabilities, ModelInfo as ChatModelInfo, Provider as ChatProvider, ProviderAvailability, ProviderConfig as ChatProviderConfig, ProviderMode as ChatProviderMode, ProviderName as ChatProviderName, createProvider, createProviderFromEnv, getAvailableProviders, getDefaultModel, getEnvVarName, getModelInfo, getModelsForProvider, getRecommendedModels, hasCredentials, isOllamaRunning, listOllamaModels, validateProvider } from "@lssm/lib.ai-providers";
+export { type ChatModelInfo, type ChatProvider, type ChatProviderConfig, type ChatProviderMode, type ChatProviderName, DEFAULT_MODELS, MODELS, type ModelCapabilities, type ProviderAvailability, createProvider, createProviderFromEnv, getAvailableProviders, getDefaultModel, getEnvVarName, getModelInfo, getModelsForProvider, getRecommendedModels, hasCredentials, isOllamaRunning, isStudioAvailable, listOllamaModels, supportsLocalMode, validateProvider };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/module.ai-chat",
-  "version": "0.0.0-canary-20251217052941",
+  "version": "0.0.0-canary-20251217060433",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -23,13 +23,13 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/lib.ai-agent": "0.0.0-canary-20251217052941",
-    "@lssm/lib.ai-providers": "0.0.0-canary-20251217052941",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217052941",
-    "@lssm/lib.metering": "0.0.0-canary-20251217052941",
-    "@lssm/lib.cost-tracking": "0.0.0-canary-20251217052941",
-    "@lssm/lib.design-system": "0.0.0-canary-20251217052941",
-    "@lssm/lib.ui-kit-web": "0.0.0-canary-20251217052941",
+    "@lssm/lib.ai-agent": "0.0.0-canary-20251217060433",
+    "@lssm/lib.ai-providers": "0.0.0-canary-20251217060433",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217060433",
+    "@lssm/lib.metering": "0.0.0-canary-20251217060433",
+    "@lssm/lib.cost-tracking": "0.0.0-canary-20251217060433",
+    "@lssm/lib.design-system": "0.0.0-canary-20251217060433",
+    "@lssm/lib.ui-kit-web": "0.0.0-canary-20251217060433",
     "@ai-sdk/react": "beta",
     "ai": "beta",
     "lucide-react": "^0.535.0",
@@ -37,8 +37,8 @@
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217052941",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217052941",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217060433",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217060433",
     "@types/react": "^19.0.14",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
@@ -47,13 +47,13 @@
     "react": ">=18.0.0"
   },
   "exports": {
-    ".": "./src/index.ts",
-    "./context": "./src/context/index.ts",
-    "./core": "./src/core/index.ts",
-    "./presentation": "./src/presentation/index.ts",
-    "./presentation/components": "./src/presentation/components/index.ts",
-    "./presentation/hooks": "./src/presentation/hooks/index.ts",
-    "./providers": "./src/providers/index.ts",
+    ".": "./dist/index.js",
+    "./context": "./dist/context/index.js",
+    "./core": "./dist/core/index.js",
+    "./presentation": "./dist/presentation/index.js",
+    "./presentation/components": "./dist/presentation/components/index.js",
+    "./presentation/hooks": "./dist/presentation/hooks/index.js",
+    "./providers": "./dist/providers/index.js",
     "./*": "./*"
   },
   "publishConfig": {