mcard-js 2.1.12 → 2.1.13

package/dist/ptr/llm/LLMRuntime.js

@@ -0,0 +1,176 @@
+/**
+ * LLM Runtime Module
+ *
+ * Provides LLMRuntime for executing LLM prompts as part of the PTR polyglot runtime system.
+ * Replicates mcard.ptr.core.llm.runtime.LLMRuntime
+ */
+import { LLMConfig, DEFAULT_PROVIDER } from './Config.js';
+import { OllamaProvider } from './providers/OllamaProvider.js';
+import { WebLLMProvider } from './providers/WebLLMProvider.js';
+import { MLCLLMProvider } from './providers/MLCLLMProvider.js';
+import { IO } from '../../monads/IO.js';
+import { Either } from '../../monads/Either.js';
+export function get_provider(provider_name = DEFAULT_PROVIDER, base_url = null, timeout = 120) {
+    if (provider_name === 'ollama') {
+        return new OllamaProvider(base_url, timeout);
+    }
+    if (provider_name === 'webllm') {
+        return new WebLLMProvider();
+    }
+    if (provider_name === 'mlc-llm') {
+        return new MLCLLMProvider(base_url, timeout);
+    }
+    // Future: lmstudio, openai
+    throw new Error(`Unknown provider: ${provider_name}`);
+}
+export class LLMRuntime {
+    provider_name;
+    _provider = null;
+    constructor(provider_name = DEFAULT_PROVIDER) {
+        this.provider_name = provider_name;
+    }
+    get provider() {
+        if (!this._provider) {
+            this._provider = get_provider(this.provider_name);
+        }
+        return this._provider;
+    }
+    async execute(codeOrPath, context, config, chapterDir) {
+        // In Python, execute signature is (concrete_impl, target, context)
+        // In JS, it is (codeOrPath, context, config, chapterDir)
+        // If context is a string, it's the prompt, not config overrides.
+        let configCtx = {};
+        if (typeof context === 'object' && context !== null) {
+            configCtx = context;
+        }
+        const concrete = config;
+        // Build configuration
+        const llmConfig = LLMConfig.from_concrete(concrete, configCtx);
+        // Update provider if different
+        if (llmConfig.provider !== this.provider_name) {
+            this._provider = get_provider(llmConfig.provider, llmConfig.endpoint_url, llmConfig.timeout);
+        }
+        // Get prompt from target (context/input)
+        let prompt = '';
+        if (typeof context === 'string') {
+            prompt = context;
+        }
+        else {
+            // If it's an object, we use it as JSON
+            // Future: support extracting specific field like 'question' or 'prompt' if defined in CLM inputs?
+            // For now, just dump it.
+            prompt = JSON.stringify(context);
+        }
+        // Execute
+        let result;
+        if (llmConfig.system_prompt) {
+            result = await this._execute_chat(prompt, llmConfig);
+        }
+        else {
+            result = await this._execute_completion(prompt, llmConfig);
+        }
+        if (result.isLeft) {
+            return `Error: ${result.left}`;
+        }
+        return this._format_response(result.right, llmConfig);
+    }
+    async _execute_completion(prompt, config) {
+        const params = config.to_provider_params();
+        return this.provider.complete(prompt, params);
+    }
+    async _execute_chat(prompt, config) {
+        const messages = [];
+        if (config.system_prompt) {
+            messages.push({ role: 'system', content: config.system_prompt });
+        }
+        messages.push({ role: 'user', content: prompt });
+        if (config.assistant_instruction) {
+            messages.push({ role: 'assistant', content: config.assistant_instruction });
+        }
+        const params = config.to_provider_params();
+        return this.provider.chat(messages, params);
+    }
+    _format_response(response, config) {
+        let content = response;
+        if (response && typeof response === 'object' && 'content' in response) {
+            content = response.content;
+        }
+        if (config.response_format === 'json') {
+            try {
+                if (typeof content === 'string') {
+                    const start = content.indexOf('{');
+                    const end = content.lastIndexOf('}') + 1;
+                    if (start >= 0 && end > start) {
+                        return JSON.parse(content.substring(start, end));
+                    }
+                }
+                return content;
+            }
+            catch (e) {
+                return content;
+            }
+        }
+        return content;
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Monadic Interface Functions
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create a monadic LLM completion execution.
+ *
+ * Returns IO<Either<string, any>> for functional composition.
+ */
+export function promptMonad(prompt, config = {}) {
+    return IO.of(async () => {
+        try {
+            // Instantiate config to get provider and defaults
+            // We cast config to any because LLMConfig constructor expects Partial<LLMConfig> 
+            // but our partial might miss some index signature stuff if any.
+            // Actually config is Partial<LLMConfig> so it's fine.
+            const llmConfig = new LLMConfig(config);
+            const runtime = new LLMRuntime(llmConfig.provider);
+            const params = llmConfig.to_provider_params();
+            return runtime.provider.complete(prompt, params);
+        }
+        catch (e) {
+            return Either.left(`LLM execution failed: ${e}`);
+        }
+    });
+}
+/**
+ * Create a monadic LLM chat execution.
+ *
+ * Returns IO<Either<string, any>> for functional composition.
+ */
+export function chatMonad(messages = null, prompt = null, system_prompt = "", config = {}) {
+    return IO.of(async () => {
+        try {
+            // Merge system prompt into config if provided
+            const configData = { ...config };
+            if (system_prompt)
+                configData.system_prompt = system_prompt;
+            const llmConfig = new LLMConfig(configData);
+            const runtime = new LLMRuntime(llmConfig.provider);
+            // Build messages if not provided
+            const msgs = messages ? [...messages] : [];
+            if (msgs.length === 0) {
+                if (llmConfig.system_prompt) {
+                    msgs.push({ role: 'system', content: llmConfig.system_prompt });
+                }
+                if (prompt) {
+                    msgs.push({ role: 'user', content: prompt });
+                }
+                if (llmConfig.assistant_instruction) {
+                    msgs.push({ role: 'assistant', content: llmConfig.assistant_instruction });
+                }
+            }
+            const params = llmConfig.to_provider_params();
+            return runtime.provider.chat(msgs, params);
+        }
+        catch (e) {
+            return Either.left(`LLM chat failed: ${e}`);
+        }
+    });
+}
+//# sourceMappingURL=LLMRuntime.js.map

package/dist/ptr/llm/LLMRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMRuntime.js","sourceRoot":"","sources":["../../../src/ptr/llm/LLMRuntime.ts"],"names":[],"mappings":"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"}

package/dist/ptr/llm/providers/LLMProvider.d.ts

@@ -0,0 +1,43 @@
+/**
+ * LLM Provider Interface
+ *
+ * Abstract interface for LLM providers.
+ * Replicates mcard.ptr.core.llm.providers.base.LLMProvider
+ */
+import { Either } from '../../../monads/Either';
+export interface ChatMessage {
+    role: string;
+    content: string;
+}
+export interface LLMProvider {
+    provider_name: string;
+    /**
+     * Generate text completion for a prompt.
+     */
+    complete(prompt: string, params: Record<string, any>): Promise<Either<string, string>>;
+    /**
+     * Generate chat completion from messages.
+     */
+    chat(messages: ChatMessage[], params: Record<string, any>): Promise<Either<string, Record<string, any>>>;
+    /**
+     * Check if the provider service is available.
+     */
+    validate_connection(): Promise<boolean>;
+    /**
+     * List available models from the provider.
+     */
+    list_models(): Promise<Either<string, string[]>>;
+    /**
+     * Get provider status information.
+     */
+    get_status(): Promise<Record<string, any>>;
+}
+export declare abstract class BaseLLMProvider implements LLMProvider {
+    abstract provider_name: string;
+    abstract complete(prompt: string, params: Record<string, any>): Promise<Either<string, string>>;
+    abstract chat(messages: ChatMessage[], params: Record<string, any>): Promise<Either<string, Record<string, any>>>;
+    abstract validate_connection(): Promise<boolean>;
+    abstract list_models(): Promise<Either<string, string[]>>;
+    get_status(): Promise<Record<string, any>>;
+}
+//# sourceMappingURL=LLMProvider.d.ts.map

package/dist/ptr/llm/providers/LLMProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMProvider.d.ts","sourceRoot":"","sources":["../../../../src/ptr/llm/providers/LLMProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvF;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAEzG;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAEjD;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;CAC9C;AAED,8BAAsB,eAAgB,YAAW,WAAW;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/F,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACjH,QAAQ,CAAC,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAChD,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAsBnD"}

package/dist/ptr/llm/providers/LLMProvider.js

@@ -0,0 +1,31 @@
+/**
+ * LLM Provider Interface
+ *
+ * Abstract interface for LLM providers.
+ * Replicates mcard.ptr.core.llm.providers.base.LLMProvider
+ */
+export class BaseLLMProvider {
+    async get_status() {
+        const available = await this.validate_connection();
+        let models = [];
+        if (available) {
+            const result = await this.list_models();
+            if (result.isRight) {
+                models = result.right;
+            }
+            else {
+                models = result.left; // Error message
+            }
+        }
+        else {
+            models = "Not connected";
+        }
+        return {
+            provider: this.provider_name,
+            available,
+            models: Array.isArray(models) ? models : [],
+            error: typeof models === 'string' ? models : null
+        };
+    }
+}
+//# sourceMappingURL=LLMProvider.js.map

package/dist/ptr/llm/providers/LLMProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMProvider.js","sourceRoot":"","sources":["../../../../src/ptr/llm/providers/LLMProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsCH,MAAM,OAAgB,eAAe;IAQjC,KAAK,CAAC,UAAU;QACZ,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACnD,IAAI,MAAM,GAAsB,EAAE,CAAC;QAEnC,IAAI,SAAS,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACJ,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,gBAAgB;YAC1C,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,MAAM,GAAG,eAAe,CAAC;QAC7B,CAAC;QAED,OAAO;YACH,QAAQ,EAAE,IAAI,CAAC,aAAa;YAC5B,SAAS;YACT,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAC3C,KAAK,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;SACpD,CAAC;IACN,CAAC;CACJ"}

package/dist/ptr/llm/providers/MLCLLMProvider.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MLC LLM Provider Implementation
+ *
+ * Provider for the MLC LLM REST API (OpenAI compatible).
+ * Typically running via `mlc_llm serve`.
+ */
+import { BaseLLMProvider, ChatMessage } from './LLMProvider.js';
+import { Either } from '../../../monads/Either.js';
+export declare class MLCLLMProvider extends BaseLLMProvider {
+    provider_name: string;
+    private base_url;
+    private timeout;
+    private config;
+    constructor(base_url?: string | null, timeout?: number);
+    private _fetch_json;
+    private _node_request;
+    complete(prompt: string, params: Record<string, any>): Promise<Either<string, string>>;
+    chat(messages: ChatMessage[], params: Record<string, any>): Promise<Either<string, Record<string, any>>>;
+    validate_connection(): Promise<boolean>;
+    list_models(): Promise<Either<string, string[]>>;
+}
+//# sourceMappingURL=MLCLLMProvider.d.ts.map

package/dist/ptr/llm/providers/MLCLLMProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MLCLLMProvider.d.ts","sourceRoot":"","sources":["../../../../src/ptr/llm/providers/MLCLLMProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAKnD,qBAAa,cAAe,SAAQ,eAAe;IAC/C,aAAa,SAAa;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAM;gBAER,QAAQ,GAAE,MAAM,GAAG,IAAW,EAAE,OAAO,GAAE,MAAY;YAOnD,WAAW;IA2BzB,OAAO,CAAC,aAAa;IA0Cf,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IA2BtF,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAgCxG,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAKvC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAWzD"}

package/dist/ptr/llm/providers/MLCLLMProvider.js

@@ -0,0 +1,155 @@
+/**
+ * MLC LLM Provider Implementation
+ *
+ * Provider for the MLC LLM REST API (OpenAI compatible).
+ * Typically running via `mlc_llm serve`.
+ */
+import { BaseLLMProvider } from './LLMProvider.js';
+import { Either } from '../../../monads/Either.js';
+import { LLM_PROVIDERS } from '../Config.js';
+import * as http from 'http';
+import * as https from 'https';
+export class MLCLLMProvider extends BaseLLMProvider {
+    provider_name = 'mlc-llm';
+    base_url;
+    timeout;
+    config;
+    constructor(base_url = null, timeout = 120) {
+        super();
+        this.config = LLM_PROVIDERS['mlc-llm'];
+        this.base_url = (base_url || this.config.base_url).replace(/\/$/, '');
+        this.timeout = timeout * 1000;
+    }
+    async _fetch_json(endpoint, options) {
+        // Prefer native fetch if available (Node 18+, Browser)
+        if (typeof globalThis.fetch === 'function') {
+            try {
+                const controller = new AbortController();
+                const id = setTimeout(() => controller.abort(), this.timeout);
+                const response = await fetch(`${this.base_url}${endpoint}`, {
+                    ...options,
+                    signal: controller.signal
+                });
+                clearTimeout(id);
+                if (!response.ok) {
+                    return Either.left(`HTTP error ${response.status}: ${await response.text()}`);
+                }
+                const data = await response.json();
+                return Either.right(data);
+            }
+            catch (e) {
+                return Either.left(`Connection error: ${e.message}`);
+            }
+        }
+        // Fallback to http/https module for older environments (unlikely given engine constraint but safe)
+        return this._node_request(endpoint, options);
+    }
+    _node_request(endpoint, options) {
+        const urlStr = `${this.base_url}${endpoint}`;
+        const url = new URL(urlStr);
+        const isHttps = url.protocol === 'https:';
+        const client = isHttps ? https : http;
+        const reqOptions = {
+            method: options.method || 'GET',
+            headers: options.headers || {},
+            timeout: this.timeout,
+        };
+        return new Promise((resolve) => {
+            const req = client.request(url, reqOptions, (res) => {
+                let body = '';
+                res.on('data', (chunk) => body += chunk);
+                res.on('end', () => {
+                    if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                        try {
+                            resolve(Either.right(JSON.parse(body)));
+                        }
+                        catch (e) {
+                            resolve(Either.left(`Parse error: ${e}`));
+                        }
+                    }
+                    else {
+                        resolve(Either.left(`HTTP Error ${res.statusCode}: ${body}`));
+                    }
+                });
+            });
+            req.on('error', (e) => resolve(Either.left(e.message)));
+            req.on('timeout', () => {
+                req.destroy();
+                resolve(Either.left('Request timed out'));
+            });
+            if (options.body) {
+                req.write(options.body);
+            }
+            req.end();
+        });
+    }
+    async complete(prompt, params) {
+        // MLC LLM / OpenAI 'completions' endpoint
+        const data = {
+            model: params.model || this.config.default_model,
+            prompt: prompt,
+            max_tokens: params.max_tokens,
+            temperature: params.temperature,
+            top_p: params.top_p,
+            stream: false
+        };
+        const result = await this._fetch_json(this.config.api_path, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(data)
+        });
+        if (result.isLeft)
+            return Either.left(result.left);
+        const response = result.right;
+        // OpenAI format: choices[0].text
+        if (response.choices && response.choices.length > 0) {
+            return Either.right(response.choices[0].text || '');
+        }
+        return Either.left(`Unexpected response format: ${JSON.stringify(response)}`);
+    }
+    async chat(messages, params) {
+        const data = {
+            model: params.model || this.config.default_model,
+            messages: messages,
+            max_tokens: params.max_tokens,
+            temperature: params.temperature,
+            top_p: params.top_p,
+            stream: false
+        };
+        const result = await this._fetch_json(this.config.chat_path, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(data)
+        });
+        if (result.isLeft)
+            return Either.left(result.left);
+        const response = result.right;
+        // OpenAI format: choices[0].message
+        if (response.choices && response.choices.length > 0) {
+            const message = response.choices[0].message;
+            return Either.right({
+                content: message.content,
+                role: message.role,
+                model: response.model,
+                usage: response.usage
+            });
+        }
+        return Either.left(`Unexpected response format: ${JSON.stringify(response)}`);
+    }
+    async validate_connection() {
+        const result = await this._fetch_json(this.config.models_path, { method: 'GET' });
+        return result.isRight;
+    }
+    async list_models() {
+        const result = await this._fetch_json(this.config.models_path, { method: 'GET' });
+        if (result.isLeft)
+            return Either.left(result.left);
+        const response = result.right;
+        // OpenAI format: { data: [{ id: 'model-id', ... }] }
+        if (response.data && Array.isArray(response.data)) {
+            return Either.right(response.data.map((m) => m.id));
+        }
+        return Either.left('Invalid models response');
+    }
+}
+//# sourceMappingURL=MLCLLMProvider.js.map

package/dist/ptr/llm/providers/MLCLLMProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MLCLLMProvider.js","sourceRoot":"","sources":["../../../../src/ptr/llm/providers/MLCLLMProvider.ts"],"names":[],"mappings":"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"}

package/dist/ptr/llm/providers/OllamaEmbeddingProvider.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Ollama Embedding Provider
+ *
+ * Generates embeddings using Ollama models (e.g., nomic-embed-text).
+ */
+import { EmbeddingProvider } from '../../../storage/VectorStore';
+export declare class OllamaEmbeddingProvider implements EmbeddingProvider {
+    readonly modelName: string;
+    private baseUrl;
+    constructor(modelName?: string, baseUrl?: string);
+    /**
+     * Generate embedding for a single text string
+     */
+    embed(text: string): Promise<number[]>;
+    /**
+     * Generate embeddings for a batch of texts
+     */
+    embedBatch(texts: string[]): Promise<number[][]>;
+}
+//# sourceMappingURL=OllamaEmbeddingProvider.d.ts.map

package/dist/ptr/llm/providers/OllamaEmbeddingProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OllamaEmbeddingProvider.d.ts","sourceRoot":"","sources":["../../../../src/ptr/llm/providers/OllamaEmbeddingProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,qBAAa,uBAAwB,YAAW,iBAAiB;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,OAAO,CAAS;gBAEZ,SAAS,GAAE,MAA2B,EAAE,OAAO,GAAE,MAAiC;IAK9F;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkB5C;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAOzD"}

package/dist/ptr/llm/providers/OllamaEmbeddingProvider.js

@@ -0,0 +1,42 @@
+/**
+ * Ollama Embedding Provider
+ *
+ * Generates embeddings using Ollama models (e.g., nomic-embed-text).
+ */
+export class OllamaEmbeddingProvider {
+    modelName;
+    baseUrl;
+    constructor(modelName = 'nomic-embed-text', baseUrl = 'http://localhost:11434') {
+        this.modelName = modelName;
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+    }
+    /**
+     * Generate embedding for a single text string
+     */
+    async embed(text) {
+        const response = await fetch(`${this.baseUrl}/api/embeddings`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: this.modelName,
+                prompt: text,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Ollama embedding failed: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data.embedding;
+    }
+    /**
+     * Generate embeddings for a batch of texts
+     */
+    async embedBatch(texts) {
+        const embeddings = [];
+        for (const text of texts) {
+            embeddings.push(await this.embed(text));
+        }
+        return embeddings;
+    }
+}
+//# sourceMappingURL=OllamaEmbeddingProvider.js.map

package/dist/ptr/llm/providers/OllamaEmbeddingProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OllamaEmbeddingProvider.js","sourceRoot":"","sources":["../../../../src/ptr/llm/providers/OllamaEmbeddingProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,OAAO,uBAAuB;IACvB,SAAS,CAAS;IACnB,OAAO,CAAS;IAExB,YAAY,YAAoB,kBAAkB,EAAE,UAAkB,wBAAwB;QAC1F,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,IAAY;QACpB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,iBAAiB,EAAE;YAC3D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACjB,KAAK,EAAE,IAAI,CAAC,SAAS;gBACrB,MAAM,EAAE,IAAI;aACf,CAAC;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA6B,CAAC;QAC9D,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,KAAe;QAC5B,MAAM,UAAU,GAAe,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,UAAU,CAAC;IACtB,CAAC;CACJ"}

package/dist/ptr/llm/providers/OllamaProvider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Ollama Provider Implementation
+ *
+ * Provider for the Ollama local LLM service.
+ * Replicates mcard.ptr.core.llm.providers.ollama.OllamaProvider
+ */
+import { BaseLLMProvider, ChatMessage } from './LLMProvider.js';
+import { Either } from '../../../monads/Either.js';
+export declare class OllamaProvider extends BaseLLMProvider {
+    provider_name: string;
+    private base_url;
+    private timeout;
+    private config;
+    constructor(base_url?: string | null, timeout?: number);
+    private _make_request;
+    complete(prompt: string, params: Record<string, any>): Promise<Either<string, string>>;
+    chat(messages: ChatMessage[], params: Record<string, any>): Promise<Either<string, Record<string, any>>>;
+    validate_connection(): Promise<boolean>;
+    list_models(): Promise<Either<string, string[]>>;
+}
+//# sourceMappingURL=OllamaProvider.d.ts.map

package/dist/ptr/llm/providers/OllamaProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OllamaProvider.d.ts","sourceRoot":"","sources":["../../../../src/ptr/llm/providers/OllamaProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAKnD,qBAAa,cAAe,SAAQ,eAAe;IAC/C,aAAa,SAAY;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAM;gBAER,QAAQ,GAAE,MAAM,GAAG,IAAW,EAAE,OAAO,GAAE,MAAY;YAOnD,aAAa;IAgErB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IA2BtF,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAkCxG,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAKvC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAezD"}