maxun-sdk 0.0.1

package/dist/client/maxun-client.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Maxun API Client
+ * Handles all HTTP communication with the Maxun backend API
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Client = void 0;
+const axios_1 = __importDefault(require("axios"));
+const http_1 = __importDefault(require("http"));
+const https_1 = __importDefault(require("https"));
+const types_1 = require("../types");
+class Client {
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.axios = axios_1.default.create({
+            baseURL: config.baseUrl || 'http://localhost:8080/api/sdk',
+            headers: {
+                'x-api-key': this.apiKey,
+                'Content-Type': 'application/json',
+            },
+            timeout: 30000,
+        });
+        // Add response interceptor for error handling
+        this.axios.interceptors.response.use((response) => response, (error) => {
+            throw this.handleError(error);
+        });
+    }
+    /**
+     * Handle API errors and convert to MaxunError
+     */
+    handleError(error) {
+        if (error.response) {
+            const data = error.response.data;
+            return new types_1.MaxunError(data?.error || data?.message || 'API request failed', error.response.status, data);
+        }
+        else if (error.request) {
+            return new types_1.MaxunError('No response from server', undefined, error.message);
+        }
+        else {
+            return new types_1.MaxunError(error.message);
+        }
+    }
+    /**
+     * Get all robots for the authenticated user
+     */
+    async getRobots() {
+        const response = await this.axios.get('/robots');
+        return response.data.data || [];
+    }
+    /**
+     * Get a specific robot by ID
+     */
+    async getRobot(robotId) {
+        const response = await this.axios.get(`/robots/${robotId}`);
+        if (!response.data.data) {
+            throw new types_1.MaxunError(`Robot ${robotId} not found`, 404);
+        }
+        return response.data.data;
+    }
+    /**
+     * Create a new robot
+     */
+    async createRobot(workflowFile) {
+        // Create a fresh HTTP agent for this request to avoid stale connections
+        const httpAgent = new http_1.default.Agent({ keepAlive: false });
+        const httpsAgent = new https_1.default.Agent({ keepAlive: false });
+        const robotTypeValue = workflowFile.meta?.robotType || workflowFile.meta?.type;
+        const payload = {
+            ...workflowFile,
+            meta: {
+                ...workflowFile.meta,
+                type: robotTypeValue,
+                robotType: robotTypeValue,
+            }
+        };
+        const response = await this.axios.post('/robots', payload, {
+            timeout: 120000,
+            httpAgent,
+            httpsAgent,
+        });
+        if (!response.data.data) {
+            throw new types_1.MaxunError('Failed to create robot');
+        }
+        return response.data.data;
+    }
+    /**
+     * Update an existing robot
+     */
+    async updateRobot(robotId, updates) {
+        const response = await this.axios.put(`/robots/${robotId}`, updates);
+        if (!response.data.data) {
+            throw new types_1.MaxunError(`Failed to update robot ${robotId}`);
+        }
+        return response.data.data;
+    }
+    /**
+     * Delete a robot
+     */
+    async deleteRobot(robotId) {
+        await this.axios.delete(`/robots/${robotId}`);
+    }
+    /**
+     * Execute a robot and get results
+     */
+    async executeRobot(robotId, options) {
+        // Execute and wait for completion (endpoint handles waiting)
+        const response = await this.axios.post(`/robots/${robotId}/execute`, {
+            params: options?.params,
+            webhook: options?.webhook,
+        }, {
+            timeout: options?.timeout || 300000, // 5 minutes default
+        });
+        if (!response.data.data) {
+            throw new types_1.MaxunError('Failed to execute robot');
+        }
+        return response.data.data;
+    }
+    /**
+     * Get all runs for a robot
+     */
+    async getRuns(robotId) {
+        const response = await this.axios.get(`/robots/${robotId}/runs`);
+        return response.data.data || [];
+    }
+    /**
+     * Get a specific run by ID
+     */
+    async getRun(robotId, runId) {
+        const response = await this.axios.get(`/robots/${robotId}/runs/${runId}`);
+        if (!response.data.data) {
+            throw new types_1.MaxunError(`Run ${runId} not found`, 404);
+        }
+        return response.data.data;
+    }
+    /**
+     * Abort a running or queued run
+     */
+    async abortRun(robotId, runId) {
+        await this.axios.post(`/robots/${robotId}/runs/${runId}/abort`);
+    }
+    /**
+     * Schedule a robot for periodic execution
+     */
+    async scheduleRobot(robotId, schedule) {
+        const response = await this.axios.put(`/robots/${robotId}`, { schedule });
+        if (!response.data.data) {
+            throw new types_1.MaxunError(`Failed to schedule robot ${robotId}`);
+        }
+        return response.data.data;
+    }
+    /**
+     * Remove schedule from a robot
+     */
+    async unscheduleRobot(robotId) {
+        const response = await this.axios.put(`/robots/${robotId}`, { schedule: null });
+        if (!response.data.data) {
+            throw new types_1.MaxunError(`Failed to unschedule robot ${robotId}`);
+        }
+        return response.data.data;
+    }
+    /**
+     * Add a webhook to a robot
+     */
+    async addWebhook(robotId, webhook) {
+        const robot = await this.getRobot(robotId);
+        const webhooks = robot.webhooks || [];
+        // Add webhook with proper structure
+        const newWebhook = {
+            id: `webhook_${Date.now()}`,
+            url: webhook.url,
+            events: webhook.events || ['run.completed', 'run.failed'],
+            active: true,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        webhooks.push(newWebhook);
+        const response = await this.axios.put(`/robots/${robotId}`, {
+            webhooks,
+        });
+        if (!response.data.data) {
+            throw new types_1.MaxunError(`Failed to add webhook to robot ${robotId}`);
+        }
+        return response.data.data;
+    }
+    /**
+     * LLM-based extraction - extract data using natural language prompt
+     */
+    async extractWithLLM(url, options) {
+        const response = await this.axios.post('/extract/llm', {
+            url,
+            prompt: options.prompt,
+            llmProvider: options.llmProvider,
+            llmModel: options.llmModel,
+            llmApiKey: options.llmApiKey,
+            llmBaseUrl: options.llmBaseUrl,
+            robotName: options.robotName,
+        }, {
+            timeout: 300000,
+        });
+        if (!response.data.data) {
+            throw new types_1.MaxunError('Failed to extract data with LLM');
+        }
+        return response.data.data;
+    }
+}
+exports.Client = Client;
+//# sourceMappingURL=maxun-client.js.map

package/dist/client/maxun-client.js.map

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

package/dist/extract.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Extract - Main class for the Extract SDK
+ */
+import { Client } from './client/maxun-client';
+import { Config } from './types';
+import { ExtractBuilder } from './builders/extract-builder';
+import { Robot } from './robot/robot';
+export declare class Extract {
+    client: Client;
+    constructor(config: Config);
+    /**
+     * Create a new extraction workflow
+     */
+    create(name: string): ExtractBuilder;
+    /**
+     * Build and save the robot to Maxun
+     */
+    build(builder: ExtractBuilder): Promise<Robot>;
+    /**
+     * Get all extract robots
+     */
+    getRobots(): Promise<Robot[]>;
+    /**
+     * Get a specific robot by ID
+     */
+    getRobot(robotId: string): Promise<Robot>;
+    /**
+     * Delete a robot
+     */
+    deleteRobot(robotId: string): Promise<void>;
+    /**
+     * LLM-based extraction - create a robot using natural language prompt
+     * The robot is saved and can be executed anytime by the user
+     *
+     * @param url - The URL to extract data from
+     * @param options - Extraction options
+     * @param options.prompt - Natural language prompt describing what to extract
+     * @param options.llmProvider - LLM provider to use: 'anthropic', 'openai', or 'ollama' (default: 'ollama')
+     * @param options.llmModel - Model name (default: 'llama3.2-vision' for ollama, 'claude-3-5-sonnet-20241022' for anthropic, 'gpt-4-vision-preview' for openai)
+     * @param options.llmApiKey - API key for the LLM provider (not needed for ollama)
+     * @param options.llmBaseUrl - Base URL for the LLM provider (default: 'http://localhost:11434' for ollama)
+     * @param options.robotName - Optional custom name for the robot
+     * @returns Robot instance that can be executed
+     */
+    extract(url: string, options: {
+        prompt: string;
+        llmProvider?: 'anthropic' | 'openai' | 'ollama';
+        llmModel?: string;
+        llmApiKey?: string;
+        llmBaseUrl?: string;
+        robotName?: string;
+    }): Promise<Robot>;
+}
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAA2B,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,qBAAa,OAAO;IACX,MAAM,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAMpC;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAmBpD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAQnC;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAK/C;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;QAClC,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,KAAK,CAAC;CAKnB"}

package/dist/extract.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Extract - Main class for the Extract SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Extract = void 0;
+const maxun_client_1 = require("./client/maxun-client");
+const extract_builder_1 = require("./builders/extract-builder");
+const robot_1 = require("./robot/robot");
+class Extract {
+    constructor(config) {
+        this.client = new maxun_client_1.Client(config);
+    }
+    /**
+     * Create a new extraction workflow
+     */
+    create(name) {
+        const builder = new extract_builder_1.ExtractBuilder(name);
+        builder.setExtractor(this);
+        return builder;
+    }
+    /**
+     * Build and save the robot to Maxun
+     */
+    async build(builder) {
+        const workflow = builder.getWorkflowArray();
+        const meta = builder.getMeta();
+        // Generate a unique ID for the robot
+        const robotId = `robot_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        meta.id = robotId;
+        const workflowFile = {
+            meta: meta,
+            workflow,
+        };
+        // Create the robot
+        const robot = await this.client.createRobot(workflowFile);
+        return new robot_1.Robot(this.client, robot);
+    }
+    /**
+     * Get all extract robots
+     */
+    async getRobots() {
+        const robots = await this.client.getRobots();
+        const extractRobots = robots.filter((r) => r.recording_meta.robotType === 'extract');
+        return extractRobots.map((r) => new robot_1.Robot(this.client, r));
+    }
+    /**
+     * Get a specific robot by ID
+     */
+    async getRobot(robotId) {
+        const robot = await this.client.getRobot(robotId);
+        return new robot_1.Robot(this.client, robot);
+    }
+    /**
+     * Delete a robot
+     */
+    async deleteRobot(robotId) {
+        await this.client.deleteRobot(robotId);
+    }
+    /**
+     * LLM-based extraction - create a robot using natural language prompt
+     * The robot is saved and can be executed anytime by the user
+     *
+     * @param url - The URL to extract data from
+     * @param options - Extraction options
+     * @param options.prompt - Natural language prompt describing what to extract
+     * @param options.llmProvider - LLM provider to use: 'anthropic', 'openai', or 'ollama' (default: 'ollama')
+     * @param options.llmModel - Model name (default: 'llama3.2-vision' for ollama, 'claude-3-5-sonnet-20241022' for anthropic, 'gpt-4-vision-preview' for openai)
+     * @param options.llmApiKey - API key for the LLM provider (not needed for ollama)
+     * @param options.llmBaseUrl - Base URL for the LLM provider (default: 'http://localhost:11434' for ollama)
+     * @param options.robotName - Optional custom name for the robot
+     * @returns Robot instance that can be executed
+     */
+    async extract(url, options) {
+        const robotData = await this.client.extractWithLLM(url, options);
+        const robot = await this.client.getRobot(robotData.robotId);
+        return new robot_1.Robot(this.client, robot);
+    }
+}
+exports.Extract = Extract;
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,wDAA+C;AAE/C,gEAA4D;AAC5D,yCAAsC;AAEtC,MAAa,OAAO;IAGlB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,qBAAM,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,MAAM,OAAO,GAAG,IAAI,gCAAc,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,OAAuB;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAE/B,qCAAqC;QACrC,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACjF,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC;QAElB,MAAM,YAAY,GAAQ;YACxB,IAAI,EAAE,IAAW;YACjB,QAAQ;SACT,CAAC;QAEF,mBAAmB;QACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAE1D,OAAO,IAAI,aAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAC7C,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,KAAK,SAAS,CAChD,CAAC;QACF,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,aAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,aAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,OAO1B;QACC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5D,OAAO,IAAI,aAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;CACF;AA1FD,0BA0FC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Maxun SDK - Unified package for web automation and data extraction
+ *
+ * @packageDocumentation
+ */
+export { Extract } from './extract';
+export { Scrape } from './scrape';
+export { Robot } from './robot/robot';
+export { Client } from './client/maxun-client';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAG/C,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Maxun SDK - Unified package for web automation and data extraction
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Client = exports.Robot = exports.Scrape = exports.Extract = void 0;
+// Main classes
+var extract_1 = require("./extract");
+Object.defineProperty(exports, "Extract", { enumerable: true, get: function () { return extract_1.Extract; } });
+var scrape_1 = require("./scrape");
+Object.defineProperty(exports, "Scrape", { enumerable: true, get: function () { return scrape_1.Scrape; } });
+var robot_1 = require("./robot/robot");
+Object.defineProperty(exports, "Robot", { enumerable: true, get: function () { return robot_1.Robot; } });
+var maxun_client_1 = require("./client/maxun-client");
+Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return maxun_client_1.Client; } });
+// All types
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,uCAAsC;AAA7B,8FAAA,KAAK,OAAA;AACd,sDAA+C;AAAtC,sGAAA,MAAM,OAAA;AAEf,YAAY;AACZ,0CAAwB"}

package/dist/llm/index.d.ts

@@ -0,0 +1,12 @@
+import { BaseLLMProvider } from './providers/base';
+import { LLMConfig } from '../types';
+/**
+ * Factory function to create LLM provider instances
+ */
+export declare function createLLMProvider(config: LLMConfig): BaseLLMProvider;
+export { BaseLLMProvider } from './providers/base';
+export { OllamaProvider } from './providers/ollama';
+export { AnthropicProvider } from './providers/anthropic';
+export { OpenAIProvider } from './providers/openai';
+export type { LLMConfig, LLMMessage, LLMResponse, LLMProvider } from '../types';
+//# sourceMappingURL=index.d.ts.map

package/dist/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAInD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,eAAe,CAWpE;AAGD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIProvider = exports.AnthropicProvider = exports.OllamaProvider = exports.BaseLLMProvider = void 0;
+exports.createLLMProvider = createLLMProvider;
+const ollama_1 = require("./providers/ollama");
+const anthropic_1 = require("./providers/anthropic");
+const openai_1 = require("./providers/openai");
+/**
+ * Factory function to create LLM provider instances
+ */
+function createLLMProvider(config) {
+    switch (config.provider) {
+        case 'ollama':
+            return new ollama_1.OllamaProvider(config);
+        case 'anthropic':
+            return new anthropic_1.AnthropicProvider(config);
+        case 'openai':
+            return new openai_1.OpenAIProvider(config);
+        default:
+            throw new Error(`Unsupported LLM provider: ${config.provider}`);
+    }
+}
+// Re-export types and base class
+var base_1 = require("./providers/base");
+Object.defineProperty(exports, "BaseLLMProvider", { enumerable: true, get: function () { return base_1.BaseLLMProvider; } });
+var ollama_2 = require("./providers/ollama");
+Object.defineProperty(exports, "OllamaProvider", { enumerable: true, get: function () { return ollama_2.OllamaProvider; } });
+var anthropic_2 = require("./providers/anthropic");
+Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return anthropic_2.AnthropicProvider; } });
+var openai_2 = require("./providers/openai");
+Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return openai_2.OpenAIProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":";;;AASA,8CAWC;AAnBD,+CAAoD;AACpD,qDAA0D;AAC1D,+CAAoD;AAGpD;;GAEG;AACH,SAAgB,iBAAiB,CAAC,MAAiB;IACjD,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ;YACX,OAAO,IAAI,uBAAc,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,WAAW;YACd,OAAO,IAAI,6BAAiB,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,QAAQ;YACX,OAAO,IAAI,uBAAc,CAAC,MAAM,CAAC,CAAC;QACpC;YACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,iCAAiC;AACjC,yCAAmD;AAA1C,uGAAA,eAAe,OAAA;AACxB,6CAAoD;AAA3C,wGAAA,cAAc,OAAA;AACvB,mDAA0D;AAAjD,8GAAA,iBAAiB,OAAA;AAC1B,6CAAoD;AAA3C,wGAAA,cAAc,OAAA"}

package/dist/llm/providers/anthropic.d.ts

@@ -0,0 +1,13 @@
+import { BaseLLMProvider } from './base';
+import { LLMMessage, LLMResponse, LLMConfig } from '../types';
+/**
+ * Anthropic provider for Claude models
+ */
+export declare class AnthropicProvider extends BaseLLMProvider {
+    private client;
+    constructor(config: LLMConfig);
+    chat(messages: LLMMessage[]): Promise<LLMResponse>;
+    validateConfig(): void;
+    getProviderName(): string;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/llm/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/anthropic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE9D;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,EAAE,SAAS;IAQvB,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAgCxD,cAAc,IAAI,IAAI;IAUtB,eAAe,IAAI,MAAM;CAG1B"}

package/dist/llm/providers/anthropic.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicProvider = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const base_1 = require("./base");
+/**
+ * Anthropic provider for Claude models
+ */
+class AnthropicProvider extends base_1.BaseLLMProvider {
+    constructor(config) {
+        super(config);
+        this.client = new sdk_1.default({
+            apiKey: config.apiKey || process.env.ANTHROPIC_API_KEY
+        });
+    }
+    async chat(messages) {
+        try {
+            // Anthropic requires system message separately
+            const systemMessage = messages.find(m => m.role === 'system');
+            const userMessages = messages.filter(m => m.role !== 'system');
+            const response = await this.client.messages.create({
+                model: this.config.model || 'claude-3-5-sonnet-20241022',
+                max_tokens: this.config.maxTokens || 4096,
+                temperature: this.config.temperature || 0.7,
+                system: systemMessage?.content,
+                messages: userMessages.map(msg => ({
+                    role: msg.role,
+                    content: msg.content
+                }))
+            });
+            const textContent = response.content.find((c) => c.type === 'text');
+            return {
+                content: textContent?.type === 'text' ? textContent.text : '',
+                usage: {
+                    promptTokens: response.usage.input_tokens,
+                    completionTokens: response.usage.output_tokens,
+                    totalTokens: response.usage.input_tokens + response.usage.output_tokens
+                }
+            };
+        }
+        catch (error) {
+            throw new Error(`Anthropic API error: ${error.message || error}`);
+        }
+    }
+    validateConfig() {
+        if (!this.config.apiKey && !process.env.ANTHROPIC_API_KEY) {
+            throw new Error('Anthropic API key required. Set ANTHROPIC_API_KEY environment variable or provide apiKey in config.');
+        }
+        if (!this.config.model) {
+            console.warn('Anthropic model not specified, using default: claude-3-5-sonnet-20241022');
+        }
+    }
+    getProviderName() {
+        return 'Anthropic';
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;
+//# sourceMappingURL=anthropic.js.map

package/dist/llm/providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../src/llm/providers/anthropic.ts"],"names":[],"mappings":";;;;;;AAAA,4DAA0C;AAC1C,iCAAyC;AAGzC;;GAEG;AACH,MAAa,iBAAkB,SAAQ,sBAAe;IAGpD,YAAY,MAAiB;QAC3B,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,MAAM,GAAG,IAAI,aAAS,CAAC;YAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;SACvD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAsB;QAC/B,IAAI,CAAC;YACH,+CAA+C;YAC/C,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAC9D,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAE/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACjD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,4BAA4B;gBACxD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI;gBACzC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,GAAG;gBAC3C,MAAM,EAAE,aAAa,EAAE,OAAO;gBAC9B,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACjC,IAAI,EAAE,GAAG,CAAC,IAA4B;oBACtC,OAAO,EAAE,GAAG,CAAC,OAAO;iBACrB,CAAC,CAAC;aACJ,CAAC,CAAC;YAEH,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;YAEzE,OAAO;gBACL,OAAO,EAAE,WAAW,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAC7D,KAAK,EAAE;oBACL,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;oBACzC,gBAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;oBAC9C,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa;iBACxE;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,qGAAqG,CAAC,CAAC;QACzH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,eAAe;QACb,OAAO,WAAW,CAAC;IACrB,CAAC;CACF;AAxDD,8CAwDC"}

package/dist/llm/providers/base.d.ts

@@ -0,0 +1,30 @@
+import { LLMConfig, LLMMessage, LLMResponse } from '../types';
+/**
+ * Abstract base class for LLM providers
+ * Provides common interface for Anthropic, OpenAI, and Ollama
+ */
+export declare abstract class BaseLLMProvider {
+    protected config: LLMConfig;
+    constructor(config: LLMConfig);
+    /**
+     * Send chat messages to LLM and get response
+     */
+    abstract chat(messages: LLMMessage[]): Promise<LLMResponse>;
+    /**
+     * Validate provider-specific configuration
+     */
+    abstract validateConfig(): void;
+    /**
+     * Get the provider name
+     */
+    abstract getProviderName(): string;
+    /**
+     * Helper to create system message
+     */
+    protected createSystemMessage(content: string): LLMMessage;
+    /**
+     * Helper to create user message
+     */
+    protected createUserMessage(content: string): LLMMessage;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/llm/providers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE9D;;;GAGG;AACH,8BAAsB,eAAe;IACnC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC;gBAEhB,MAAM,EAAE,SAAS;IAK7B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,cAAc,IAAI,IAAI;IAE/B;;OAEG;IACH,QAAQ,CAAC,eAAe,IAAI,MAAM;IAElC;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAI1D;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;CAGzD"}

package/dist/llm/providers/base.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseLLMProvider = void 0;
+/**
+ * Abstract base class for LLM providers
+ * Provides common interface for Anthropic, OpenAI, and Ollama
+ */
+class BaseLLMProvider {
+    constructor(config) {
+        this.config = config;
+        this.validateConfig();
+    }
+    /**
+     * Helper to create system message
+     */
+    createSystemMessage(content) {
+        return { role: 'system', content };
+    }
+    /**
+     * Helper to create user message
+     */
+    createUserMessage(content) {
+        return { role: 'user', content };
+    }
+}
+exports.BaseLLMProvider = BaseLLMProvider;
+//# sourceMappingURL=base.js.map

package/dist/llm/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/llm/providers/base.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAsB,eAAe;IAGnC,YAAY,MAAiB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAiBD;;OAEG;IACO,mBAAmB,CAAC,OAAe;QAC3C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACO,iBAAiB,CAAC,OAAe;QACzC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACnC,CAAC;CACF;AApCD,0CAoCC"}

package/dist/llm/providers/ollama.d.ts

@@ -0,0 +1,14 @@
+import { BaseLLMProvider } from './base';
+import { LLMMessage, LLMResponse, LLMConfig } from '../types';
+/**
+ * Ollama provider for local LLM inference
+ * Supports Llama, Mistral, and other open-source models
+ */
+export declare class OllamaProvider extends BaseLLMProvider {
+    private client;
+    constructor(config: LLMConfig);
+    chat(messages: LLMMessage[]): Promise<LLMResponse>;
+    validateConfig(): void;
+    getProviderName(): string;
+}
+//# sourceMappingURL=ollama.d.ts.map

package/dist/llm/providers/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/ollama.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE9D;;;GAGG;AACH,qBAAa,cAAe,SAAQ,eAAe;IACjD,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,SAAS;IAQvB,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IA2BxD,cAAc,IAAI,IAAI;IAUtB,eAAe,IAAI,MAAM;CAG1B"}