@nekutima/provili-sdk 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Nekutima
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @nekutima/provili-sdk
+
+Nekutima's AI SDK. It provides two things:
+
+1. **LLM Engine access layer** — a vendor-neutral, isomorphic (browser + Node) way to talk to an LLM provider. Configure an engine once and use the same `chat` / `chatStream` / `embed` / `health` surface regardless of vendor.
+2. **Pro.vi.li platform client** — typed client for the Pro.vi.li backend (chat, sessions, agents, knowledge/RAG, prompts, users, roles, MCP).
+
+## Install
+
+```sh
+npm install @nekutima/provili-sdk
+```
+
+## LLM Engines
+
+```ts
+import { createEngineClient, validateEngineConfig } from '@nekutima/provili-sdk/llm-engines';
+
+const engine = { type: 'deepseek' as const, apiKey: process.env.DEEPSEEK_API_KEY, model: 'deepseek-chat' };
+
+const errors = validateEngineConfig(engine); // [] when valid
+if (errors.length) throw new Error(errors.map((e) => e.message).join(', '));
+
+const client = createEngineClient(engine);
+
+const health = await client.health();            // { ok, latencyMs, category? }
+const answer = await client.chat([{ role: 'user', content: 'Hello' }]);
+
+for await (const delta of client.chatStream([{ role: 'user', content: 'Tell me a story' }])) {
+    process.stdout.write(delta);
+}
+```
+
+Supported types: `ollama`, `deepseek`, `openai`, `anthropic`, `gemini`, `xai`, `openrouter`, `custom`
+(any OpenAI-compatible endpoint). Each type declares its own minimal configuration via
+`ENGINE_TYPE_DESCRIPTORS`; vendor URL/auth/streaming differences are handled inside the SDK.
+
+The layer is isomorphic: it uses the global `fetch` (injectable via `createEngineClient(config, { fetch })`)
+and never touches Node-only APIs, so the same code runs in a browser or on a server.
+
+## Platform client
+
+```ts
+import { createProviliSDK } from '@nekutima/provili-sdk';
+
+const sdk = createProviliSDK({ baseURL: 'https://your-provili-host/api' });
+```
+
+## Building
+
+```sh
+npm run build:sdk    # from the repo root
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/core/http-client.d.ts

@@ -0,0 +1,84 @@
+import { AxiosRequestConfig } from "axios";
+import { AuthConfig } from "../models/auth.model";
+import { RateLimitConfig } from "./rate-limiter";
+export interface ProviliConfig {
+    baseURL: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+    withCredentials?: boolean;
+    auth?: AuthConfig;
+    rateLimit?: RateLimitConfig;
+}
+/**
+ * HTTP client for Pro.vi.li SDK
+ * Based on Biome SDK patterns with axios integration
+ */
+export declare class ProviliHttpClient {
+    private config;
+    static onAuthExpired: (() => void) | null;
+    private readonly axiosInstance;
+    private currentAuth?;
+    private rateLimiter?;
+    /**
+     * Get the base URL configured for this client
+     */
+    get baseURL(): string;
+    constructor(config: ProviliConfig);
+    /**
+     * Perform GET request
+     */
+    get<T>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Perform POST request
+     */
+    post<T>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Perform PUT request
+     */
+    put<T>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Perform PATCH request
+     */
+    patch<T>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Perform DELETE request
+     */
+    delete<T = void>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Set default headers
+     */
+    setHeader(name: string, value: string): void;
+    /**
+     * Remove default header
+     */
+    removeHeader(name: string): void;
+    /**
+     * Set authentication
+     */
+    setAuth(auth: AuthConfig): void;
+    /**
+     * Get current authentication config
+     */
+    getAuth(): AuthConfig | undefined;
+    /**
+     * Clear authentication
+     */
+    clearAuth(): void;
+    /**
+     * Apply current authentication to headers
+     */
+    private applyAuth;
+    /**
+     * Get rate limiter status
+     */
+    getRateLimitStatus(): {
+        availableTokens: number;
+        maxTokens: number;
+        timeUntilNextToken: number;
+    } | undefined;
+    /**
+     * Setup request and response interceptors
+     */
+    private setupInterceptors;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/core/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/core/http-client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAiB,kBAAkB,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAe,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAcd,OAAO,CAAC,MAAM;IAb1B,MAAM,CAAC,aAAa,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,WAAW,CAAC,CAAc;IAElC;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;gBAEmB,MAAM,EAAE,aAAa;IAoBzC;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKlE;;OAEG;IACG,IAAI,CAAC,CAAC,EACR,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,GAAG,CAAC,CAAC,EACP,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,KAAK,CAAC,CAAC,EACT,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK5E;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5C;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAK/B;;OAEG;IACH,OAAO,IAAI,UAAU,GAAG,SAAS;IAIjC;;OAEG;IACH,SAAS,IAAI,IAAI;IAMjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAejB;;OAEG;IACH,kBAAkB;;;;;IAIlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAuD5B"}

package/dist/core/http-client.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviliHttpClient = void 0;
+const tslib_1 = require("tslib");
+const axios_1 = tslib_1.__importDefault(require("axios"));
+const rate_limiter_1 = require("./rate-limiter");
+/**
+ * HTTP client for Pro.vi.li SDK
+ * Based on Biome SDK patterns with axios integration
+ */
+class ProviliHttpClient {
+    /**
+     * Get the base URL configured for this client
+     */
+    get baseURL() {
+        return this.config.baseURL;
+    }
+    constructor(config) {
+        this.config = config;
+        this.currentAuth = config.auth;
+        if (config.rateLimit) {
+            this.rateLimiter = new rate_limiter_1.RateLimiter(config.rateLimit);
+        }
+        this.axiosInstance = axios_1.default.create({
+            baseURL: config.baseURL,
+            timeout: config.timeout || 30000,
+            headers: {
+                ...config.headers,
+            },
+            withCredentials: config.withCredentials !== undefined ? config.withCredentials : true,
+        });
+        this.setupInterceptors();
+        this.applyAuth();
+    }
+    /**
+     * Perform GET request
+     */
+    async get(url, config) {
+        const response = await this.axiosInstance.get(url, config);
+        return response.data;
+    }
+    /**
+     * Perform POST request
+     */
+    async post(url, data, config) {
+        const response = await this.axiosInstance.post(url, data, config);
+        return response.data;
+    }
+    /**
+     * Perform PUT request
+     */
+    async put(url, data, config) {
+        const response = await this.axiosInstance.put(url, data, config);
+        return response.data;
+    }
+    /**
+     * Perform PATCH request
+     */
+    async patch(url, data, config) {
+        const response = await this.axiosInstance.patch(url, data, config);
+        return response.data;
+    }
+    /**
+     * Perform DELETE request
+     */
+    async delete(url, config) {
+        const response = await this.axiosInstance.delete(url, config);
+        return response.data;
+    }
+    /**
+     * Set default headers
+     */
+    setHeader(name, value) {
+        this.axiosInstance.defaults.headers.common[name] = value;
+    }
+    /**
+     * Remove default header
+     */
+    removeHeader(name) {
+        delete this.axiosInstance.defaults.headers.common[name];
+    }
+    /**
+     * Set authentication
+     */
+    setAuth(auth) {
+        this.currentAuth = auth;
+        this.applyAuth();
+    }
+    /**
+     * Get current authentication config
+     */
+    getAuth() {
+        return this.currentAuth;
+    }
+    /**
+     * Clear authentication
+     */
+    clearAuth() {
+        this.currentAuth = undefined;
+        this.removeHeader('Authorization');
+        this.removeHeader('X-API-Key');
+    }
+    /**
+     * Apply current authentication to headers
+     */
+    applyAuth() {
+        if (!this.currentAuth) {
+            return;
+        }
+        if (this.currentAuth.method === 'api-key') {
+            // Use HTTP Basic auth for API keys
+            const credentials = btoa(`${this.currentAuth.apiKey}:`);
+            this.setHeader('Authorization', `Basic ${credentials}`);
+        }
+        else if (this.currentAuth.method === 'jwt') {
+            // Use Bearer token for JWT
+            this.setHeader('Authorization', `Bearer ${this.currentAuth.token}`);
+        }
+    }
+    /**
+     * Get rate limiter status
+     */
+    getRateLimitStatus() {
+        return this.rateLimiter?.getStatus();
+    }
+    /**
+     * Setup request and response interceptors
+     */
+    setupInterceptors() {
+        // Request interceptor
+        this.axiosInstance.interceptors.request.use((config) => {
+            // Ensure config has headers
+            if (!config.headers) {
+                config.headers = {};
+            }
+            // Check rate limit before making request
+            if (this.rateLimiter) {
+                const canProceed = this.rateLimiter.consumeToken();
+                if (!canProceed) {
+                    const waitTime = this.rateLimiter.getTimeUntilNextToken();
+                    throw new Error(`Rate limit exceeded. Try again in ${Math.ceil(waitTime / 1000)} seconds.`);
+                }
+            }
+            // Ensure auth headers are set
+            if (this.currentAuth) {
+                if (this.currentAuth.method === 'api-key') {
+                    const credentials = btoa(`${this.currentAuth.apiKey}:`);
+                    config.headers.Authorization = `Basic ${credentials}`;
+                }
+                else if (this.currentAuth.method === 'jwt') {
+                    config.headers.Authorization = `Bearer ${this.currentAuth.token}`;
+                }
+            }
+            // Ensure proper content type for non-FormData requests
+            if (config.data && !(config.data instanceof FormData)) {
+                config.headers['Content-Type'] = 'application/json';
+            }
+            return config;
+        }, (error) => Promise.reject(error));
+        // Response interceptor for error handling
+        this.axiosInstance.interceptors.response.use((response) => response, (error) => {
+            // Handle rate limit responses from server
+            if (error.response?.status === 429) {
+                // Server rate limit - could implement backoff here
+            }
+            // Handle common error scenarios
+            if (error.response?.status === 401) {
+                this.clearAuth();
+                ProviliHttpClient.onAuthExpired?.();
+            }
+            return Promise.reject(error);
+        });
+    }
+}
+exports.ProviliHttpClient = ProviliHttpClient;
+ProviliHttpClient.onAuthExpired = null;
+//# sourceMappingURL=http-client.js.map

package/dist/core/http-client.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,3 @@
+export * from './http-client';
+export * from './rate-limiter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// Core infrastructure
+tslib_1.__exportStar(require("./http-client"), exports);
+tslib_1.__exportStar(require("./rate-limiter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;AAAA,sBAAsB;AACtB,wDAA8B;AAC9B,yDAA+B"}

package/dist/core/rate-limiter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Rate limiter for Pro.vi.li SDK
+ * Implements token bucket algorithm for request rate limiting
+ */
+export interface RateLimitConfig {
+    requestsPerMinute: number;
+    burstLimit?: number;
+}
+export declare class RateLimiter {
+    private tokens;
+    private lastRefill;
+    private readonly maxTokens;
+    private readonly refillRate;
+    constructor(config: RateLimitConfig);
+    /**
+     * Check if a request can be made
+     */
+    canMakeRequest(): boolean;
+    /**
+     * Consume a token for a request
+     */
+    consumeToken(): boolean;
+    /**
+     * Get time until next token is available (in milliseconds)
+     */
+    getTimeUntilNextToken(): number;
+    /**
+     * Refill tokens based on elapsed time
+     */
+    private refillTokens;
+    /**
+     * Get current status
+     */
+    getStatus(): {
+        availableTokens: number;
+        maxTokens: number;
+        timeUntilNextToken: number;
+    };
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/core/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/core/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,EAAE,eAAe;IAOnC;;OAEG;IACH,cAAc,IAAI,OAAO;IAKzB;;OAEG;IACH,YAAY,IAAI,OAAO;IAQvB;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAQ/B;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,SAAS;;;;;CAQZ"}

package/dist/core/rate-limiter.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Rate limiter for Pro.vi.li SDK
+ * Implements token bucket algorithm for request rate limiting
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiter = void 0;
+class RateLimiter {
+    constructor(config) {
+        this.maxTokens = config.burstLimit || config.requestsPerMinute;
+        this.tokens = this.maxTokens;
+        this.lastRefill = Date.now();
+        this.refillRate = config.requestsPerMinute / 60000; // tokens per millisecond
+    }
+    /**
+     * Check if a request can be made
+     */
+    canMakeRequest() {
+        this.refillTokens();
+        return this.tokens >= 1;
+    }
+    /**
+     * Consume a token for a request
+     */
+    consumeToken() {
+        if (!this.canMakeRequest()) {
+            return false;
+        }
+        this.tokens -= 1;
+        return true;
+    }
+    /**
+     * Get time until next token is available (in milliseconds)
+     */
+    getTimeUntilNextToken() {
+        if (this.tokens >= 1) {
+            return 0;
+        }
+        const tokensNeeded = 1 - this.tokens;
+        return tokensNeeded / this.refillRate;
+    }
+    /**
+     * Refill tokens based on elapsed time
+     */
+    refillTokens() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        const tokensToAdd = elapsed * this.refillRate;
+        this.tokens = Math.min(this.maxTokens, this.tokens + tokensToAdd);
+        this.lastRefill = now;
+    }
+    /**
+     * Get current status
+     */
+    getStatus() {
+        this.refillTokens();
+        return {
+            availableTokens: Math.floor(this.tokens),
+            maxTokens: this.maxTokens,
+            timeUntilNextToken: this.getTimeUntilNextToken()
+        };
+    }
+}
+exports.RateLimiter = RateLimiter;
+//# sourceMappingURL=rate-limiter.js.map

package/dist/core/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/core/rate-limiter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAOH,MAAa,WAAW;IAMpB,YAAY,MAAuB;QAC/B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,iBAAiB,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,iBAAiB,GAAG,KAAK,CAAC,CAAC,yBAAyB;IACjF,CAAC;IAED;;OAEG;IACH,cAAc;QACV,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,YAAY;QACR,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,qBAAqB;QACjB,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC;QACb,CAAC;QACD,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACrC,OAAO,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC;IAC1C,CAAC;IAED;;OAEG;IACK,YAAY;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;QACtC,MAAM,WAAW,GAAG,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC;QAE9C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,SAAS;QACL,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO;YACH,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;YACxC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,kBAAkB,EAAE,IAAI,CAAC,qBAAqB,EAAE;SACnD,CAAC;IACN,CAAC;CACJ;AAlED,kCAkEC"}