@lssm/module.ai-chat 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

package/dist/core/chat-service.js

@@ -1,4 +1,14 @@
-import{InMemoryConversationStore as e}from"./conversation-store.js";import{generateText as t,streamText as n}from"ai";var r=class{provider;context;store;systemPrompt;maxHistoryMessages;onUsage;constructor(t){this.provider=t.provider,this.context=t.context,this.store=t.store??new e,this.systemPrompt=t.systemPrompt??`You are ContractSpec AI, an expert coding assistant specialized in ContractSpec development.
+import { InMemoryConversationStore } from "./conversation-store.js";
+import { generateText, streamText } from "ai";
+
+//#region src/core/chat-service.ts
+/**
+* Main chat orchestration service
+*/
+/**
+* Default system prompt for ContractSpec vibe coding
+*/
+const DEFAULT_SYSTEM_PROMPT = `You are ContractSpec AI, an expert coding assistant specialized in ContractSpec development.
 
 Your capabilities:
 - Help users create, modify, and understand ContractSpec specifications
@@ -11,4 +21,203 @@ Guidelines:
 - Provide code examples when helpful
 - Reference relevant ContractSpec concepts and patterns
 - Ask clarifying questions when the user's intent is unclear
-- When suggesting code changes, explain the rationale`,this.maxHistoryMessages=t.maxHistoryMessages??20,this.onUsage=t.onUsage}async send(e){let n;if(e.conversationId){let t=await this.store.get(e.conversationId);if(!t)throw Error(`Conversation ${e.conversationId} not found`);n=t}else n=await this.store.create({status:`active`,provider:this.provider.name,model:this.provider.model,messages:[],workspacePath:this.context?.workspacePath});await this.store.appendMessage(n.id,{role:`user`,content:e.content,status:`completed`,attachments:e.attachments});let r=this.buildPrompt(n,e),i=this.provider.getModel();try{let e=await t({model:i,prompt:r,system:this.systemPrompt}),a=await this.store.appendMessage(n.id,{role:`assistant`,content:e.text,status:`completed`}),o=await this.store.get(n.id);if(!o)throw Error(`Conversation lost after update`);return{message:a,conversation:o}}catch(e){throw await this.store.appendMessage(n.id,{role:`assistant`,content:``,status:`error`,error:{code:`generation_failed`,message:e instanceof Error?e.message:String(e)}}),e}}async stream(e){let t;if(e.conversationId){let n=await this.store.get(e.conversationId);if(!n)throw Error(`Conversation ${e.conversationId} not found`);t=n}else t=await this.store.create({status:`active`,provider:this.provider.name,model:this.provider.model,messages:[],workspacePath:this.context?.workspacePath});await this.store.appendMessage(t.id,{role:`user`,content:e.content,status:`completed`,attachments:e.attachments});let r=await this.store.appendMessage(t.id,{role:`assistant`,content:``,status:`streaming`}),i=this.buildPrompt(t,e),a=this.provider.getModel(),o=this;async function*s(){let e=``;try{let s=n({model:a,prompt:i,system:o.systemPrompt});for await(let t of s.textStream)e+=t,yield{type:`text`,content:t};await o.store.updateMessage(t.id,r.id,{content:e,status:`completed`}),yield{type:`done`}}catch(n){await o.store.updateMessage(t.id,r.id,{content:e,status:`error`,error:{code:`stream_failed`,message:n instanceof Error?n.message:String(n)}}),yield{type:`error`,error:{code:`stream_failed`,message:n instanceof Error?n.message:String(n)}}}}return{conversationId:t.id,messageId:r.id,stream:s()}}async getConversation(e){return this.store.get(e)}async listConversations(e){return this.store.list({status:`active`,...e})}async deleteConversation(e){return this.store.delete(e)}buildPrompt(e,t){let n=``,r=Math.max(0,e.messages.length-this.maxHistoryMessages);for(let t=r;t<e.messages.length;t++){let r=e.messages[t];r&&(r.role===`user`||r.role===`assistant`)&&(n+=`${r.role===`user`?`User`:`Assistant`}: ${r.content}\n\n`)}let i=t.content;if(t.attachments?.length){let e=t.attachments.map(e=>e.type===`file`||e.type===`code`?`\n\n### ${e.name}\n\`\`\`\n${e.content}\n\`\`\``:`\n\n[Attachment: ${e.name}]`).join(``);i+=e}return n+=`User: ${i}\n\nAssistant:`,n}};function i(e){return new r(e)}export{r as ChatService,i as createChatService};
+- When suggesting code changes, explain the rationale`;
+/**
+* Main chat service for AI-powered conversations
+*/
+var ChatService = class {
+	provider;
+	context;
+	store;
+	systemPrompt;
+	maxHistoryMessages;
+	onUsage;
+	constructor(config) {
+		this.provider = config.provider;
+		this.context = config.context;
+		this.store = config.store ?? new InMemoryConversationStore();
+		this.systemPrompt = config.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
+		this.maxHistoryMessages = config.maxHistoryMessages ?? 20;
+		this.onUsage = config.onUsage;
+	}
+	/**
+	* Send a message and get a complete response
+	*/
+	async send(options) {
+		let conversation;
+		if (options.conversationId) {
+			const existing = await this.store.get(options.conversationId);
+			if (!existing) throw new Error(`Conversation ${options.conversationId} not found`);
+			conversation = existing;
+		} else conversation = await this.store.create({
+			status: "active",
+			provider: this.provider.name,
+			model: this.provider.model,
+			messages: [],
+			workspacePath: this.context?.workspacePath
+		});
+		await this.store.appendMessage(conversation.id, {
+			role: "user",
+			content: options.content,
+			status: "completed",
+			attachments: options.attachments
+		});
+		const prompt = this.buildPrompt(conversation, options);
+		const model = this.provider.getModel();
+		try {
+			const result = await generateText({
+				model,
+				prompt,
+				system: this.systemPrompt
+			});
+			const assistantMessage = await this.store.appendMessage(conversation.id, {
+				role: "assistant",
+				content: result.text,
+				status: "completed"
+			});
+			const updatedConversation = await this.store.get(conversation.id);
+			if (!updatedConversation) throw new Error("Conversation lost after update");
+			return {
+				message: assistantMessage,
+				conversation: updatedConversation
+			};
+		} catch (error) {
+			await this.store.appendMessage(conversation.id, {
+				role: "assistant",
+				content: "",
+				status: "error",
+				error: {
+					code: "generation_failed",
+					message: error instanceof Error ? error.message : String(error)
+				}
+			});
+			throw error;
+		}
+	}
+	/**
+	* Send a message and get a streaming response
+	*/
+	async stream(options) {
+		let conversation;
+		if (options.conversationId) {
+			const existing = await this.store.get(options.conversationId);
+			if (!existing) throw new Error(`Conversation ${options.conversationId} not found`);
+			conversation = existing;
+		} else conversation = await this.store.create({
+			status: "active",
+			provider: this.provider.name,
+			model: this.provider.model,
+			messages: [],
+			workspacePath: this.context?.workspacePath
+		});
+		await this.store.appendMessage(conversation.id, {
+			role: "user",
+			content: options.content,
+			status: "completed",
+			attachments: options.attachments
+		});
+		const assistantMessage = await this.store.appendMessage(conversation.id, {
+			role: "assistant",
+			content: "",
+			status: "streaming"
+		});
+		const prompt = this.buildPrompt(conversation, options);
+		const model = this.provider.getModel();
+		const self = this;
+		async function* streamGenerator() {
+			let fullContent = "";
+			try {
+				const result = streamText({
+					model,
+					prompt,
+					system: self.systemPrompt
+				});
+				for await (const chunk of result.textStream) {
+					fullContent += chunk;
+					yield {
+						type: "text",
+						content: chunk
+					};
+				}
+				await self.store.updateMessage(conversation.id, assistantMessage.id, {
+					content: fullContent,
+					status: "completed"
+				});
+				yield { type: "done" };
+			} catch (error) {
+				await self.store.updateMessage(conversation.id, assistantMessage.id, {
+					content: fullContent,
+					status: "error",
+					error: {
+						code: "stream_failed",
+						message: error instanceof Error ? error.message : String(error)
+					}
+				});
+				yield {
+					type: "error",
+					error: {
+						code: "stream_failed",
+						message: error instanceof Error ? error.message : String(error)
+					}
+				};
+			}
+		}
+		return {
+			conversationId: conversation.id,
+			messageId: assistantMessage.id,
+			stream: streamGenerator()
+		};
+	}
+	/**
+	* Get a conversation by ID
+	*/
+	async getConversation(conversationId) {
+		return this.store.get(conversationId);
+	}
+	/**
+	* List conversations
+	*/
+	async listConversations(options) {
+		return this.store.list({
+			status: "active",
+			...options
+		});
+	}
+	/**
+	* Delete a conversation
+	*/
+	async deleteConversation(conversationId) {
+		return this.store.delete(conversationId);
+	}
+	/**
+	* Build prompt string for LLM
+	*/
+	buildPrompt(conversation, options) {
+		let prompt = "";
+		const historyStart = Math.max(0, conversation.messages.length - this.maxHistoryMessages);
+		for (let i = historyStart; i < conversation.messages.length; i++) {
+			const msg = conversation.messages[i];
+			if (!msg) continue;
+			if (msg.role === "user" || msg.role === "assistant") prompt += `${msg.role === "user" ? "User" : "Assistant"}: ${msg.content}\n\n`;
+		}
+		let content = options.content;
+		if (options.attachments?.length) {
+			const attachmentInfo = options.attachments.map((a) => {
+				if (a.type === "file" || a.type === "code") return `\n\n### ${a.name}\n\`\`\`\n${a.content}\n\`\`\``;
+				return `\n\n[Attachment: ${a.name}]`;
+			}).join("");
+			content += attachmentInfo;
+		}
+		prompt += `User: ${content}\n\nAssistant:`;
+		return prompt;
+	}
+};
+/**
+* Create a chat service with the given configuration
+*/
+function createChatService(config) {
+	return new ChatService(config);
+}
+
+//#endregion
+export { ChatService, createChatService };

package/dist/core/conversation-store.js

@@ -1 +1,108 @@
-function e(e){return`${e}_${Date.now()}_${Math.random().toString(36).slice(2,11)}`}var t=class{conversations=new Map;async get(e){return this.conversations.get(e)??null}async create(t){let n=new Date,r={...t,id:e(`conv`),createdAt:n,updatedAt:n};return this.conversations.set(r.id,r),r}async update(e,t){let n=this.conversations.get(e);if(!n)return null;let r={...n,...t,updatedAt:new Date};return this.conversations.set(e,r),r}async appendMessage(t,n){let r=this.conversations.get(t);if(!r)throw Error(`Conversation ${t} not found`);let i=new Date,a={...n,id:e(`msg`),conversationId:t,createdAt:i,updatedAt:i};return r.messages.push(a),r.updatedAt=i,a}async updateMessage(e,t,n){let r=this.conversations.get(e);if(!r)return null;let i=r.messages.findIndex(e=>e.id===t);if(i===-1)return null;let a=r.messages[i];if(!a)return null;let o={...a,...n,updatedAt:new Date};return r.messages[i]=o,r.updatedAt=new Date,o}async delete(e){return this.conversations.delete(e)}async list(e){let t=Array.from(this.conversations.values());e?.status&&(t=t.filter(t=>t.status===e.status)),t.sort((e,t)=>t.updatedAt.getTime()-e.updatedAt.getTime());let n=e?.offset??0,r=e?.limit??100;return t.slice(n,n+r)}async search(e,t=20){let n=e.toLowerCase(),r=[];for(let e of this.conversations.values()){if(e.title?.toLowerCase().includes(n)){r.push(e);continue}if(e.messages.some(e=>e.content.toLowerCase().includes(n))&&r.push(e),r.length>=t)break}return r}clear(){this.conversations.clear()}};function n(){return new t}export{t as InMemoryConversationStore,n as createInMemoryConversationStore};
+//#region src/core/conversation-store.ts
+/**
+* Generate a unique ID
+*/
+function generateId(prefix) {
+	return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+/**
+* In-memory conversation store for development and testing
+*/
+var InMemoryConversationStore = class {
+	conversations = /* @__PURE__ */ new Map();
+	async get(conversationId) {
+		return this.conversations.get(conversationId) ?? null;
+	}
+	async create(conversation) {
+		const now = /* @__PURE__ */ new Date();
+		const fullConversation = {
+			...conversation,
+			id: generateId("conv"),
+			createdAt: now,
+			updatedAt: now
+		};
+		this.conversations.set(fullConversation.id, fullConversation);
+		return fullConversation;
+	}
+	async update(conversationId, updates) {
+		const conversation = this.conversations.get(conversationId);
+		if (!conversation) return null;
+		const updated = {
+			...conversation,
+			...updates,
+			updatedAt: /* @__PURE__ */ new Date()
+		};
+		this.conversations.set(conversationId, updated);
+		return updated;
+	}
+	async appendMessage(conversationId, message) {
+		const conversation = this.conversations.get(conversationId);
+		if (!conversation) throw new Error(`Conversation ${conversationId} not found`);
+		const now = /* @__PURE__ */ new Date();
+		const fullMessage = {
+			...message,
+			id: generateId("msg"),
+			conversationId,
+			createdAt: now,
+			updatedAt: now
+		};
+		conversation.messages.push(fullMessage);
+		conversation.updatedAt = now;
+		return fullMessage;
+	}
+	async updateMessage(conversationId, messageId, updates) {
+		const conversation = this.conversations.get(conversationId);
+		if (!conversation) return null;
+		const messageIndex = conversation.messages.findIndex((m) => m.id === messageId);
+		if (messageIndex === -1) return null;
+		const message = conversation.messages[messageIndex];
+		if (!message) return null;
+		const updated = {
+			...message,
+			...updates,
+			updatedAt: /* @__PURE__ */ new Date()
+		};
+		conversation.messages[messageIndex] = updated;
+		conversation.updatedAt = /* @__PURE__ */ new Date();
+		return updated;
+	}
+	async delete(conversationId) {
+		return this.conversations.delete(conversationId);
+	}
+	async list(options) {
+		let results = Array.from(this.conversations.values());
+		if (options?.status) results = results.filter((c) => c.status === options.status);
+		results.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+		const offset = options?.offset ?? 0;
+		const limit = options?.limit ?? 100;
+		return results.slice(offset, offset + limit);
+	}
+	async search(query, limit = 20) {
+		const lowerQuery = query.toLowerCase();
+		const results = [];
+		for (const conversation of this.conversations.values()) {
+			if (conversation.title?.toLowerCase().includes(lowerQuery)) {
+				results.push(conversation);
+				continue;
+			}
+			if (conversation.messages.some((m) => m.content.toLowerCase().includes(lowerQuery))) results.push(conversation);
+			if (results.length >= limit) break;
+		}
+		return results;
+	}
+	/**
+	* Clear all conversations (for testing)
+	*/
+	clear() {
+		this.conversations.clear();
+	}
+};
+/**
+* Create an in-memory conversation store
+*/
+function createInMemoryConversationStore() {
+	return new InMemoryConversationStore();
+}
+
+//#endregion
+export { InMemoryConversationStore, createInMemoryConversationStore };

package/dist/core/index.js

@@ -1 +1,4 @@
-import{InMemoryConversationStore as e,createInMemoryConversationStore as t}from"./conversation-store.js";import{ChatService as n,createChatService as r}from"./chat-service.js";export{n as ChatService,e as InMemoryConversationStore,r as createChatService,t as createInMemoryConversationStore};
+import { InMemoryConversationStore, createInMemoryConversationStore } from "./conversation-store.js";
+import { ChatService, createChatService } from "./chat-service.js";
+
+export { ChatService, InMemoryConversationStore, createChatService, createInMemoryConversationStore };

package/dist/index.d.ts

@@ -4,7 +4,6 @@ import { FileOperation, FileOperationResult, FileOperations, FileReadResult, Fil
 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";
@@ -14,5 +13,4 @@ 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/index.js

@@ -1 +1,22 @@
-import{AiChatFeature as e}from"./ai-chat.feature.js";import{InMemoryConversationStore as t,createInMemoryConversationStore as n}from"./core/conversation-store.js";import{ChatService as r,createChatService as i}from"./core/chat-service.js";import"./core/index.js";import{isStudioAvailable as a,supportsLocalMode as o}from"./providers/chat-utilities.js";import{DEFAULT_MODELS as s,MODELS as c,createProvider as l,createProviderFromEnv as u,getAvailableProviders as d,getDefaultModel as f,getEnvVarName as p,getModelInfo as m,getModelsForProvider as h,getRecommendedModels as g,hasCredentials as _,isOllamaRunning as v,listOllamaModels as y,validateProvider as b}from"./providers/index.js";import{WorkspaceContext as x,createWorkspaceContext as S}from"./context/workspace-context.js";import{ContextBuilder as C,createContextBuilder as w}from"./context/context-builder.js";import{FileOperations as T,createNodeFileOperations as E}from"./context/file-operations.js";import"./context/index.js";import{ChatContainer as D}from"./presentation/components/ChatContainer.js";import{ChatMessage as O}from"./presentation/components/ChatMessage.js";import{ChatInput as k}from"./presentation/components/ChatInput.js";import"./presentation/components/index.js";import{useChat as A}from"./presentation/hooks/useChat.js";import{useProviders as j}from"./presentation/hooks/useProviders.js";import"./presentation/hooks/index.js";export{e as AiChatFeature,D as ChatContainer,k as ChatInput,O as ChatMessageComponent,r as ChatService,C as ContextBuilder,s as DEFAULT_MODELS,T as FileOperations,t as InMemoryConversationStore,c as MODELS,x as WorkspaceContext,i as createChatService,w as createContextBuilder,n as createInMemoryConversationStore,E as createNodeFileOperations,l as createProvider,u as createProviderFromEnv,S as createWorkspaceContext,d as getAvailableProviders,f as getDefaultModel,p as getEnvVarName,m as getModelInfo,h as getModelsForProvider,g as getRecommendedModels,_ as hasCredentials,v as isOllamaRunning,a as isStudioAvailable,y as listOllamaModels,o as supportsLocalMode,A as useChat,j as useProviders,b as validateProvider};
+import { AiChatFeature } from "./ai-chat.feature.js";
+import { InMemoryConversationStore, createInMemoryConversationStore } from "./core/conversation-store.js";
+import { ChatService, createChatService } from "./core/chat-service.js";
+import "./core/index.js";
+import { DEFAULT_MODELS, MODELS, getDefaultModel, getModelInfo, getModelsForProvider, getRecommendedModels } from "./libs/ai-providers/dist/models.js";
+import { createProvider, createProviderFromEnv, getAvailableProviders } from "./libs/ai-providers/dist/factory.js";
+import { getEnvVarName, hasCredentials, isOllamaRunning, listOllamaModels, validateProvider } from "./libs/ai-providers/dist/validation.js";
+import { isStudioAvailable, supportsLocalMode } from "./providers/chat-utilities.js";
+import "./providers/index.js";
+import { WorkspaceContext, createWorkspaceContext } from "./context/workspace-context.js";
+import { ContextBuilder, createContextBuilder } from "./context/context-builder.js";
+import { FileOperations, createNodeFileOperations } from "./context/file-operations.js";
+import "./context/index.js";
+import { ChatContainer } from "./presentation/components/ChatContainer.js";
+import { ChatMessage } 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, ChatContainer, ChatInput, ChatMessage as ChatMessageComponent, ChatService, ContextBuilder, DEFAULT_MODELS, FileOperations, InMemoryConversationStore, MODELS, WorkspaceContext, createChatService, createContextBuilder, createInMemoryConversationStore, createNodeFileOperations, createProvider, createProviderFromEnv, createWorkspaceContext, getAvailableProviders, getDefaultModel, getEnvVarName, getModelInfo, getModelsForProvider, getRecommendedModels, hasCredentials, isOllamaRunning, isStudioAvailable, listOllamaModels, supportsLocalMode, useChat, useProviders, validateProvider };

package/dist/libs/ai-providers/dist/factory.js

@@ -0,0 +1,225 @@
+import { DEFAULT_MODELS, getModelsForProvider } from "./models.js";
+import { anthropic } from "@ai-sdk/anthropic";
+import { google } from "@ai-sdk/google";
+import { mistral } from "@ai-sdk/mistral";
+import { openai } from "@ai-sdk/openai";
+import { ollama } from "ollama-ai-provider";
+
+//#region ../../libs/ai-providers/dist/factory.js
+/**
+* Base provider implementation
+*/
+var BaseProvider = class {
+	name;
+	model;
+	mode;
+	config;
+	cachedModel = null;
+	constructor(config) {
+		this.name = config.provider;
+		this.model = config.model ?? DEFAULT_MODELS[config.provider];
+		this.mode = this.determineMode(config);
+		this.config = config;
+	}
+	determineMode(config) {
+		if (config.provider === "ollama") return "local";
+		if (config.apiKey) return "byok";
+		return "managed";
+	}
+	getModel() {
+		if (!this.cachedModel) this.cachedModel = this.createModel();
+		return this.cachedModel;
+	}
+	createModel() {
+		const { apiKey, baseUrl, proxyUrl, organizationId } = this.config;
+		switch (this.name) {
+			case "ollama": {
+				const originalBaseUrl = process.env.OLLAMA_BASE_URL;
+				if (baseUrl && baseUrl !== "http://localhost:11434") process.env.OLLAMA_BASE_URL = baseUrl;
+				const ollamaModel = ollama(this.model);
+				if (originalBaseUrl !== void 0) process.env.OLLAMA_BASE_URL = originalBaseUrl;
+				else if (baseUrl && baseUrl !== "http://localhost:11434") delete process.env.OLLAMA_BASE_URL;
+				return ollamaModel;
+			}
+			case "openai":
+				if (this.mode === "managed") {
+					const originalBaseUrl = process.env.OPENAI_BASE_URL;
+					if (proxyUrl) process.env.OPENAI_BASE_URL = proxyUrl;
+					const model = openai(this.model);
+					if (originalBaseUrl !== void 0) process.env.OPENAI_BASE_URL = originalBaseUrl;
+					else if (proxyUrl) delete process.env.OPENAI_BASE_URL;
+					return model;
+				}
+				return openai(this.model);
+			case "anthropic":
+				if (this.mode === "managed") {
+					const originalBaseUrl = process.env.OPENAI_BASE_URL;
+					if (proxyUrl) process.env.OPENAI_BASE_URL = proxyUrl;
+					const model = openai(this.model);
+					if (originalBaseUrl !== void 0) process.env.OPENAI_BASE_URL = originalBaseUrl;
+					else if (proxyUrl) delete process.env.OPENAI_BASE_URL;
+					return model;
+				}
+				return anthropic(this.model);
+			case "mistral":
+				if (this.mode === "managed") {
+					const originalBaseUrl = process.env.OPENAI_BASE_URL;
+					if (proxyUrl) process.env.OPENAI_BASE_URL = proxyUrl;
+					const model = openai(this.model);
+					if (originalBaseUrl !== void 0) process.env.OPENAI_BASE_URL = originalBaseUrl;
+					else if (proxyUrl) delete process.env.OPENAI_BASE_URL;
+					return model;
+				}
+				return mistral(this.model);
+			case "gemini":
+				if (this.mode === "managed") {
+					const originalBaseUrl = process.env.OPENAI_BASE_URL;
+					if (proxyUrl) process.env.OPENAI_BASE_URL = proxyUrl;
+					const model = openai(this.model);
+					if (originalBaseUrl !== void 0) process.env.OPENAI_BASE_URL = originalBaseUrl;
+					else if (proxyUrl) delete process.env.OPENAI_BASE_URL;
+					return model;
+				}
+				return google(this.model);
+			default: throw new Error(`Unknown provider: ${this.name}`);
+		}
+	}
+	async listModels() {
+		if (this.name === "ollama") return this.listOllamaModels();
+		return getModelsForProvider(this.name);
+	}
+	async listOllamaModels() {
+		try {
+			const baseUrl = this.config.baseUrl ?? "http://localhost:11434";
+			const response = await fetch(`${baseUrl}/api/tags`);
+			if (!response.ok) return getModelsForProvider("ollama");
+			return ((await response.json()).models ?? []).map((m) => ({
+				id: m.name,
+				name: m.name,
+				provider: "ollama",
+				contextWindow: 8e3,
+				capabilities: {
+					vision: false,
+					tools: false,
+					reasoning: false,
+					streaming: true
+				}
+			}));
+		} catch {
+			return getModelsForProvider("ollama");
+		}
+	}
+	async validate() {
+		if (this.name === "ollama") return this.validateOllama();
+		if (this.mode === "byok" && !this.config.apiKey) return {
+			valid: false,
+			error: `API key required for ${this.name}`
+		};
+		if (this.mode === "managed" && !this.config.proxyUrl && !this.config.organizationId) return {
+			valid: false,
+			error: "Managed mode requires proxyUrl or organizationId"
+		};
+		return { valid: true };
+	}
+	async validateOllama() {
+		try {
+			const baseUrl = this.config.baseUrl ?? "http://localhost:11434";
+			const response = await fetch(`${baseUrl}/api/tags`);
+			if (!response.ok) return {
+				valid: false,
+				error: `Ollama server returned ${response.status}`
+			};
+			const models = (await response.json()).models ?? [];
+			if (!models.some((m) => m.name === this.model)) return {
+				valid: false,
+				error: `Model "${this.model}" not found. Available: ${models.map((m) => m.name).join(", ")}`
+			};
+			return { valid: true };
+		} catch (error) {
+			return {
+				valid: false,
+				error: `Cannot connect to Ollama at ${this.config.baseUrl ?? "http://localhost:11434"}: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+};
+/**
+* Create a provider from configuration
+*/
+function createProvider(config) {
+	return new BaseProvider(config);
+}
+/**
+* Create a provider from environment variables
+*/
+function createProviderFromEnv() {
+	const provider = process.env.CONTRACTSPEC_AI_PROVIDER ?? "openai";
+	const model = process.env.CONTRACTSPEC_AI_MODEL;
+	let apiKey;
+	switch (provider) {
+		case "openai":
+			apiKey = process.env.OPENAI_API_KEY;
+			break;
+		case "anthropic":
+			apiKey = process.env.ANTHROPIC_API_KEY;
+			break;
+		case "mistral":
+			apiKey = process.env.MISTRAL_API_KEY;
+			break;
+		case "gemini":
+			apiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
+			break;
+		case "ollama": break;
+	}
+	return createProvider({
+		provider,
+		model,
+		apiKey,
+		baseUrl: process.env.OLLAMA_BASE_URL,
+		proxyUrl: process.env.CONTRACTSPEC_AI_PROXY_URL,
+		organizationId: process.env.CONTRACTSPEC_ORG_ID
+	});
+}
+/**
+* Get all available providers with their status
+*/
+function getAvailableProviders() {
+	const providers = [];
+	providers.push({
+		provider: "ollama",
+		available: true,
+		mode: "local"
+	});
+	const openaiKey = process.env.OPENAI_API_KEY;
+	providers.push({
+		provider: "openai",
+		available: Boolean(openaiKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),
+		mode: openaiKey ? "byok" : "managed",
+		reason: !openaiKey ? "Set OPENAI_API_KEY for BYOK mode" : void 0
+	});
+	const anthropicKey = process.env.ANTHROPIC_API_KEY;
+	providers.push({
+		provider: "anthropic",
+		available: Boolean(anthropicKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),
+		mode: anthropicKey ? "byok" : "managed",
+		reason: !anthropicKey ? "Set ANTHROPIC_API_KEY for BYOK mode" : void 0
+	});
+	const mistralKey = process.env.MISTRAL_API_KEY;
+	providers.push({
+		provider: "mistral",
+		available: Boolean(mistralKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),
+		mode: mistralKey ? "byok" : "managed",
+		reason: !mistralKey ? "Set MISTRAL_API_KEY for BYOK mode" : void 0
+	});
+	const geminiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
+	providers.push({
+		provider: "gemini",
+		available: Boolean(geminiKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),
+		mode: geminiKey ? "byok" : "managed",
+		reason: !geminiKey ? "Set GOOGLE_API_KEY for BYOK mode" : void 0
+	});
+	return providers;
+}
+
+//#endregion
+export { createProvider, createProviderFromEnv, getAvailableProviders };

package/dist/libs/ai-providers/dist/index.js

@@ -0,0 +1,4 @@
+import { DEFAULT_MODELS, MODELS, getDefaultModel, getModelInfo, getModelsForProvider, getRecommendedModels } from "./models.js";
+import { createProvider, createProviderFromEnv, getAvailableProviders } from "./factory.js";
+import { getEnvVarName, hasCredentials, isOllamaRunning, listOllamaModels, validateProvider } from "./validation.js";
+import "./legacy.js";

package/dist/libs/ai-providers/dist/legacy.js

@@ -0,0 +1,2 @@
+import { getRecommendedModels } from "./models.js";
+import "./factory.js";