langtrain 0.2.0 → 0.2.2

package/dist/index.d.mts

@@ -16,6 +16,23 @@ interface ClientConfig {
     timeout?: number;
     /** Maximum number of retries on transient errors (default: 2). */
     maxRetries?: number;
+    /** Max requests per second (client-side rate limiting, default: 10). */
+    maxRequestsPerSecond?: number;
+    /** Enable debug logging to stderr (default: false). */
+    debug?: boolean;
+    /** Optional callback invoked on every request for observability. */
+    onRequest?: (event: RequestEvent) => void;
+}
+/** Emitted for every API request (success or failure). */
+interface RequestEvent {
+    method: string;
+    path: string;
+    status?: number;
+    latencyMs: number;
+    attempt: number;
+    error?: LangtrainError;
+    rateLimitRemaining?: number;
+    rateLimitReset?: number;
 }
 declare class LangtrainError extends Error {
     /** HTTP status code, if available. */
@@ -24,10 +41,13 @@ declare class LangtrainError extends Error {
     readonly code?: string;
     /** The original error, if any. */
     readonly cause?: Error;
+    /** Seconds until rate limit resets (from Retry-After header). */
+    readonly retryAfter?: number;
     constructor(message: string, options?: {
         status?: number;
         code?: string;
         cause?: Error;
+        retryAfter?: number;
     });
     /** True if the error was a network/timeout issue (retryable). */
     get isTransient(): boolean;
@@ -41,24 +61,32 @@ declare class LangtrainError extends Error {
 /**
  * BaseClient — abstract foundation for all Langtrain SDK clients.
  *
- * Provides:
+ * Features:
  * - Shared axios instance with API key auth
  * - Configurable timeouts
  * - Automatic retry with exponential backoff on transient errors
+ * - Client-side token-bucket rate limiting
+ * - Retry-After header respect on 429s
  * - Structured error wrapping (LangtrainError)
+ * - Debug logging and request event hooks
  */
 declare abstract class BaseClient {
     protected readonly http: AxiosInstance;
     protected readonly maxRetries: number;
+    private readonly rateLimiter;
+    private readonly debug;
+    private readonly onRequest?;
     constructor(config: ClientConfig);
     /**
-     * Execute a request with automatic retry and error wrapping.
+     * Execute a request with rate limiting, automatic retry, and error wrapping.
      */
     protected request<T>(fn: () => Promise<T>): Promise<T>;
     /**
      * Wrap any thrown error into a structured LangtrainError.
      */
     private wrapError;
+    private log;
+    private emitEvent;
     private sleep;
 }
 

package/dist/index.d.ts

@@ -16,6 +16,23 @@ interface ClientConfig {
     timeout?: number;
     /** Maximum number of retries on transient errors (default: 2). */
     maxRetries?: number;
+    /** Max requests per second (client-side rate limiting, default: 10). */
+    maxRequestsPerSecond?: number;
+    /** Enable debug logging to stderr (default: false). */
+    debug?: boolean;
+    /** Optional callback invoked on every request for observability. */
+    onRequest?: (event: RequestEvent) => void;
+}
+/** Emitted for every API request (success or failure). */
+interface RequestEvent {
+    method: string;
+    path: string;
+    status?: number;
+    latencyMs: number;
+    attempt: number;
+    error?: LangtrainError;
+    rateLimitRemaining?: number;
+    rateLimitReset?: number;
 }
 declare class LangtrainError extends Error {
     /** HTTP status code, if available. */
@@ -24,10 +41,13 @@ declare class LangtrainError extends Error {
     readonly code?: string;
     /** The original error, if any. */
     readonly cause?: Error;
+    /** Seconds until rate limit resets (from Retry-After header). */
+    readonly retryAfter?: number;
     constructor(message: string, options?: {
         status?: number;
         code?: string;
         cause?: Error;
+        retryAfter?: number;
     });
     /** True if the error was a network/timeout issue (retryable). */
     get isTransient(): boolean;
@@ -41,24 +61,32 @@ declare class LangtrainError extends Error {
 /**
  * BaseClient — abstract foundation for all Langtrain SDK clients.
  *
- * Provides:
+ * Features:
  * - Shared axios instance with API key auth
  * - Configurable timeouts
  * - Automatic retry with exponential backoff on transient errors
+ * - Client-side token-bucket rate limiting
+ * - Retry-After header respect on 429s
  * - Structured error wrapping (LangtrainError)
+ * - Debug logging and request event hooks
  */
 declare abstract class BaseClient {
     protected readonly http: AxiosInstance;
     protected readonly maxRetries: number;
+    private readonly rateLimiter;
+    private readonly debug;
+    private readonly onRequest?;
     constructor(config: ClientConfig);
     /**
-     * Execute a request with automatic retry and error wrapping.
+     * Execute a request with rate limiting, automatic retry, and error wrapping.
      */
     protected request<T>(fn: () => Promise<T>): Promise<T>;
     /**
      * Wrap any thrown error into a structured LangtrainError.
      */
     private wrapError;
+    private log;
+    private emitEvent;
     private sleep;
 }
 

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var chunkZN3AO753_js=require('./chunk-ZN3AO753.js');Object.defineProperty(exports,"AgentClient",{enumerable:true,get:function(){return chunkZN3AO753_js.d}});Object.defineProperty(exports,"AgentTypes",{enumerable:true,get:function(){return chunkZN3AO753_js.e}});Object.defineProperty(exports,"BaseClient",{enumerable:true,get:function(){return chunkZN3AO753_js.c}});Object.defineProperty(exports,"FileClient",{enumerable:true,get:function(){return chunkZN3AO753_js.f}});Object.defineProperty(exports,"GuardrailClient",{enumerable:true,get:function(){return chunkZN3AO753_js.m}});Object.defineProperty(exports,"LangtrainError",{enumerable:true,get:function(){return chunkZN3AO753_js.b}});Object.defineProperty(exports,"Langtune",{enumerable:true,get:function(){return chunkZN3AO753_js.r}});Object.defineProperty(exports,"Langvision",{enumerable:true,get:function(){return chunkZN3AO753_js.q}});Object.defineProperty(exports,"ModelClient",{enumerable:true,get:function(){return chunkZN3AO753_js.i}});Object.defineProperty(exports,"ModelTypes",{enumerable:true,get:function(){return chunkZN3AO753_js.j}});Object.defineProperty(exports,"SecretClient",{enumerable:true,get:function(){return chunkZN3AO753_js.k}});Object.defineProperty(exports,"SecretTypes",{enumerable:true,get:function(){return chunkZN3AO753_js.l}});Object.defineProperty(exports,"SubscriptionClient",{enumerable:true,get:function(){return chunkZN3AO753_js.h}});Object.defineProperty(exports,"Text",{enumerable:true,get:function(){return chunkZN3AO753_js.p}});Object.defineProperty(exports,"TrainingClient",{enumerable:true,get:function(){return chunkZN3AO753_js.g}});Object.defineProperty(exports,"UsageClient",{enumerable:true,get:function(){return chunkZN3AO753_js.n}});Object.defineProperty(exports,"Vision",{enumerable:true,get:function(){return chunkZN3AO753_js.o}});//# sourceMappingURL=index.js.map
+'use strict';var chunkK5LXUJ4G_js=require('./chunk-K5LXUJ4G.js');Object.defineProperty(exports,"AgentClient",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.d}});Object.defineProperty(exports,"AgentTypes",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.e}});Object.defineProperty(exports,"BaseClient",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.c}});Object.defineProperty(exports,"FileClient",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.f}});Object.defineProperty(exports,"GuardrailClient",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.m}});Object.defineProperty(exports,"LangtrainError",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.b}});Object.defineProperty(exports,"Langtune",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.r}});Object.defineProperty(exports,"Langvision",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.q}});Object.defineProperty(exports,"ModelClient",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.i}});Object.defineProperty(exports,"ModelTypes",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.j}});Object.defineProperty(exports,"SecretClient",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.k}});Object.defineProperty(exports,"SecretTypes",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.l}});Object.defineProperty(exports,"SubscriptionClient",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.h}});Object.defineProperty(exports,"Text",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.p}});Object.defineProperty(exports,"TrainingClient",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.g}});Object.defineProperty(exports,"UsageClient",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.n}});Object.defineProperty(exports,"Vision",{enumerable:true,get:function(){return chunkK5LXUJ4G_js.o}});//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.mjs

@@ -1,2 +1,2 @@
-export{d as AgentClient,e as AgentTypes,c as BaseClient,f as FileClient,m as GuardrailClient,b as LangtrainError,r as Langtune,q as Langvision,i as ModelClient,j as ModelTypes,k as SecretClient,l as SecretTypes,h as SubscriptionClient,p as Text,g as TrainingClient,n as UsageClient,o as Vision}from'./chunk-36QS5AXY.mjs';//# sourceMappingURL=index.mjs.map
+export{d as AgentClient,e as AgentTypes,c as BaseClient,f as FileClient,m as GuardrailClient,b as LangtrainError,r as Langtune,q as Langvision,i as ModelClient,j as ModelTypes,k as SecretClient,l as SecretTypes,h as SubscriptionClient,p as Text,g as TrainingClient,n as UsageClient,o as Vision}from'./chunk-A7PMJDMV.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langtrain",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Unified JavaScript SDK for Langtrain Ecosystem",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/cli/auth.ts

@@ -1,6 +1,25 @@
-import { password, isCancel, cancel, intro, green, yellow, red, bgMagenta, black, spinner, gray, cyan, dim, bold } from './ui';
+import { password, isCancel, cancel, intro, green, yellow, red, bgMagenta, black, spinner, gray, cyan, dim, bold, note } from './ui';
 import { getConfig, saveConfig } from './config';
 import { SubscriptionClient, SubscriptionInfo } from '../index';
+import axios from 'axios';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+
+const execAsync = promisify(exec);
+const API_BASE = 'https://api.langtrain.ai/api/v1';
+
+async function openBrowser(url: string) {
+    try {
+        const command = process.platform === 'win32'
+            ? `start ${url}`
+            : process.platform === 'darwin'
+                ? `open "${url}"`
+                : `xdg-open "${url}"`;
+        await execAsync(command);
+    } catch {
+        // Silently fail if browser can't open
+    }
+}
 
 /**
  * Quick check if API key is stored (no network call).
@@ -28,9 +47,86 @@ export async function ensureAuth(): Promise<string> {
 }
 
 /**
- * Interactive login — Claude-style API key entry with immediate verification.
+ * Interactive login — browser-based OAuth flow with API key fallback.
  */
 export async function handleLogin() {
+    const s = spinner();
+    s.start('Connecting to Langtrain...');
+
+    try {
+        // 1. Request device code
+        const { data: codeData } = await axios.post(`${API_BASE}/auth/device/code`);
+        const { device_code, user_code, verification_url, expires_in, interval } = codeData;
+
+        s.stop(green('Connected.'));
+
+        console.log('\n  ' + bgMagenta(black(' AUTHENTICATION ')) + '\n');
+        console.log(`  To log in, please open your browser to:\n  ${cyan(verification_url + '?code=' + user_code)}\n`);
+
+        note(
+            `Confirmation Code:\n${bold(user_code)}`,
+            'Verify in Browser'
+        );
+
+        console.log(gray('  Opening browser automatically...'));
+        await openBrowser(`${verification_url}?code=${user_code}`);
+
+        const pollSpinner = spinner();
+        pollSpinner.start('Waiting for approval in browser...');
+
+        // 2. Poll for token
+        const startTime = Date.now();
+        const timeout = expires_in * 1000;
+
+        while (Date.now() - startTime < timeout) {
+            try {
+                const { data: tokenData } = await axios.post(`${API_BASE}/auth/device/token?device_code=${device_code}`);
+
+                if (tokenData.status === 'approved') {
+                    const apiKey = tokenData.api_key;
+                    pollSpinner.stop(green('Approved!'));
+
+                    const verifySpinner = spinner();
+                    verifySpinner.start('Verifying credentials...');
+
+                    const client = new SubscriptionClient({ apiKey });
+                    const info = await client.getStatus();
+
+                    const planBadge = info.plan === 'pro'
+                        ? bgMagenta(black(' PRO '))
+                        : info.plan === 'enterprise'
+                            ? bgMagenta(black(' ENTERPRISE '))
+                            : ' FREE ';
+
+                    verifySpinner.stop(green(`Authenticated ${planBadge}`));
+
+                    const config = getConfig();
+                    saveConfig({ ...config, apiKey });
+                    console.log(green('  ✔ Credentials saved to ~/.langtrain/config.json\n'));
+                    return;
+                }
+
+                if (tokenData.status === 'expired') {
+                    pollSpinner.stop(red('Device code expired.'));
+                    break;
+                }
+
+                // Wait for the requested interval
+                await new Promise(r => setTimeout(r, interval * 1000));
+            } catch (err) {
+                // Ignore network errors during polling
+                await new Promise(r => setTimeout(r, interval * 1000));
+            }
+        }
+
+        pollSpinner.stop(yellow('Login timed out.'));
+    } catch (err: any) {
+        s.stop(red('Could not reach Langtrain server.'));
+    }
+
+    // 3. Fallback to manual entry if browser flow fails
+    console.log(gray('\n  Browser login failed or timed out. Falling back to manual entry.'));
+
     while (true) {
         console.log(dim('  ─────────────────────────────────────'));
         console.log(gray('  Get your API Key at: ') + cyan('https://app.langtrain.xyz/home/api'));
@@ -49,8 +145,8 @@ export async function handleLogin() {
             process.exit(0);
         }
 
-        const s = spinner();
-        s.start('Verifying API Key...');
+        const verifySpinner = spinner();
+        verifySpinner.start('Verifying API Key...');
 
         try {
             const client = new SubscriptionClient({ apiKey: apiKey as string });
@@ -62,22 +158,14 @@ export async function handleLogin() {
                     ? bgMagenta(black(' ENTERPRISE '))
                     : ' FREE ';
 
-            s.stop(green(`Authenticated ${planBadge}`));
-
-            // Show initial token info if available
-            if (info.usage) {
-                const used = info.usage.tokensUsedThisMonth || 0;
-                const limit = info.usage.tokenLimit || 10000;
-                const pct = Math.round((used / limit) * 100);
-                console.log(dim(`  Tokens: ${used.toLocaleString()} / ${limit.toLocaleString()} (${pct}% used)`));
-            }
+            verifySpinner.stop(green(`Authenticated ${planBadge}`));
 
             const config = getConfig();
             saveConfig({ ...config, apiKey: apiKey as string });
             console.log(green('  ✔ Credentials saved to ~/.langtrain/config.json\n'));
             return;
         } catch (e: any) {
-            s.stop(red('Invalid API Key. Please try again.'));
+            verifySpinner.stop(red('Invalid API Key. Please try again.'));
         }
     }
 }

package/src/lib/base.ts

@@ -1,4 +1,4 @@
-import axios, { AxiosInstance, AxiosError, AxiosRequestConfig } from 'axios';
+import axios, { AxiosInstance, AxiosError, AxiosRequestConfig, AxiosResponse } from 'axios';
 
 // ── Shared Configuration ───────────────────────────────────────────────────
 
@@ -12,11 +12,30 @@ export interface ClientConfig {
     timeout?: number;
     /** Maximum number of retries on transient errors (default: 2). */
     maxRetries?: number;
+    /** Max requests per second (client-side rate limiting, default: 10). */
+    maxRequestsPerSecond?: number;
+    /** Enable debug logging to stderr (default: false). */
+    debug?: boolean;
+    /** Optional callback invoked on every request for observability. */
+    onRequest?: (event: RequestEvent) => void;
+}
+
+/** Emitted for every API request (success or failure). */
+export interface RequestEvent {
+    method: string;
+    path: string;
+    status?: number;
+    latencyMs: number;
+    attempt: number;
+    error?: LangtrainError;
+    rateLimitRemaining?: number;
+    rateLimitReset?: number;
 }
 
 const DEFAULT_BASE_URL = 'https://api.langtrain.ai/api/v1';
 const DEFAULT_TIMEOUT = 30_000;
 const DEFAULT_MAX_RETRIES = 2;
+const DEFAULT_MAX_RPS = 10;
 const RETRYABLE_STATUS_CODES = [408, 429, 500, 502, 503, 504];
 
 // ── Custom Error ───────────────────────────────────────────────────────────
@@ -28,13 +47,21 @@ export class LangtrainError extends Error {
     readonly code?: string;
     /** The original error, if any. */
     readonly cause?: Error;
+    /** Seconds until rate limit resets (from Retry-After header). */
+    readonly retryAfter?: number;
 
-    constructor(message: string, options?: { status?: number; code?: string; cause?: Error }) {
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        cause?: Error;
+        retryAfter?: number;
+    }) {
         super(message);
         this.name = 'LangtrainError';
         this.status = options?.status;
         this.code = options?.code;
         this.cause = options?.cause;
+        this.retryAfter = options?.retryAfter;
     }
 
     /** True if the error was a network/timeout issue (retryable). */
@@ -59,23 +86,85 @@ export class LangtrainError extends Error {
     }
 }
 
+// ── Token Bucket Rate Limiter ──────────────────────────────────────────────
+
+/**
+ * Simple token-bucket rate limiter.
+ * Allows bursting up to `capacity` requests, refills at `refillRate` tokens/sec.
+ */
+class RateLimiter {
+    private tokens: number;
+    private lastRefill: number;
+
+    constructor(
+        private readonly capacity: number,
+        private readonly refillRate: number,
+    ) {
+        this.tokens = capacity;
+        this.lastRefill = Date.now();
+    }
+
+    /** Wait until a token is available, then consume it. */
+    async acquire(): Promise<void> {
+        this.refill();
+
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return;
+        }
+
+        // Wait for next token
+        const waitMs = ((1 - this.tokens) / this.refillRate) * 1000;
+        await this.sleep(Math.ceil(waitMs));
+        this.refill();
+        this.tokens -= 1;
+    }
+
+    /** Pause for `seconds` (e.g. from Retry-After header). */
+    async waitFor(seconds: number): Promise<void> {
+        await this.sleep(seconds * 1000);
+    }
+
+    private refill(): void {
+        const now = Date.now();
+        const elapsed = (now - this.lastRefill) / 1000;
+        this.tokens = Math.min(this.capacity, this.tokens + elapsed * this.refillRate);
+        this.lastRefill = now;
+    }
+
+    private sleep(ms: number): Promise<void> {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+
 // ── Base Client ────────────────────────────────────────────────────────────
 
 /**
  * BaseClient — abstract foundation for all Langtrain SDK clients.
  *
- * Provides:
+ * Features:
  * - Shared axios instance with API key auth
  * - Configurable timeouts
  * - Automatic retry with exponential backoff on transient errors
+ * - Client-side token-bucket rate limiting
+ * - Retry-After header respect on 429s
  * - Structured error wrapping (LangtrainError)
+ * - Debug logging and request event hooks
  */
 export abstract class BaseClient {
     protected readonly http: AxiosInstance;
     protected readonly maxRetries: number;
+    private readonly rateLimiter: RateLimiter;
+    private readonly debug: boolean;
+    private readonly onRequest?: (event: RequestEvent) => void;
 
     constructor(config: ClientConfig) {
         this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.debug = config.debug ?? false;
+        this.onRequest = config.onRequest;
+
+        const maxRps = config.maxRequestsPerSecond ?? DEFAULT_MAX_RPS;
+        this.rateLimiter = new RateLimiter(maxRps, maxRps);
 
         this.http = axios.create({
             baseURL: config.baseUrl || DEFAULT_BASE_URL,
@@ -83,30 +172,61 @@ export abstract class BaseClient {
             headers: {
                 'X-API-Key': config.apiKey,
                 'Content-Type': 'application/json',
+                'User-Agent': 'langtrain-sdk/0.2.x',
             },
         });
     }
 
     /**
-     * Execute a request with automatic retry and error wrapping.
+     * Execute a request with rate limiting, automatic retry, and error wrapping.
      */
     protected async request<T>(fn: () => Promise<T>): Promise<T> {
         let lastError: LangtrainError | undefined;
 
         for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            // Acquire a rate limiter token before each attempt
+            await this.rateLimiter.acquire();
+
+            const start = Date.now();
+
             try {
-                return await fn();
+                const result = await fn();
+                const latencyMs = Date.now() - start;
+
+                this.log(`✓ request succeeded (${latencyMs}ms, attempt ${attempt + 1})`);
+                this.emitEvent({ method: '', path: '', status: 200, latencyMs, attempt });
+
+                return result;
             } catch (error) {
+                const latencyMs = Date.now() - start;
                 lastError = this.wrapError(error);
 
-                // Only retry on transient errors, and not on the last attempt
+                this.log(`✗ request failed: ${lastError.message} (${latencyMs}ms, attempt ${attempt + 1})`);
+                this.emitEvent({
+                    method: '', path: '',
+                    status: lastError.status,
+                    latencyMs,
+                    attempt,
+                    error: lastError,
+                    rateLimitRemaining: lastError.isRateLimited ? 0 : undefined,
+                    rateLimitReset: lastError.retryAfter,
+                });
+
+                // Don't retry non-transient errors or on last attempt
                 if (!lastError.isTransient || attempt === this.maxRetries) {
                     throw lastError;
                 }
 
-                // Exponential backoff: 500ms, 1000ms, 2000ms...
-                const delay = Math.min(500 * Math.pow(2, attempt), 5000);
-                await this.sleep(delay);
+                // If rate-limited with Retry-After, respect it
+                if (lastError.isRateLimited && lastError.retryAfter) {
+                    this.log(`⏳ rate limited, waiting ${lastError.retryAfter}s (Retry-After)`);
+                    await this.rateLimiter.waitFor(lastError.retryAfter);
+                } else {
+                    // Exponential backoff: 500ms, 1000ms, 2000ms...
+                    const delay = Math.min(500 * Math.pow(2, attempt), 5000);
+                    this.log(`↻ retrying in ${delay}ms...`);
+                    await this.sleep(delay);
+                }
             }
         }
 
@@ -121,21 +241,35 @@ export abstract class BaseClient {
 
         if (error instanceof AxiosError) {
             const status = error.response?.status;
+            const headers = error.response?.headers;
             const data = error.response?.data as Record<string, unknown> | undefined;
             const serverMessage = data?.detail ?? data?.message ?? data?.error;
 
+            // Parse Retry-After header (seconds or HTTP date)
+            let retryAfter: number | undefined;
+            const retryHeader = headers?.['retry-after'];
+            if (retryHeader) {
+                const parsed = Number(retryHeader);
+                retryAfter = isNaN(parsed)
+                    ? Math.max(0, Math.ceil((new Date(retryHeader).getTime() - Date.now()) / 1000))
+                    : parsed;
+            }
+
             const message = serverMessage
                 ? String(serverMessage)
                 : error.code === 'ECONNABORTED'
                     ? `Request timed out`
-                    : status
-                        ? `API request failed with status ${status}`
-                        : `Network error: ${error.message}`;
+                    : status === 429
+                        ? `Rate limited${retryAfter ? ` — retry in ${retryAfter}s` : ''}`
+                        : status
+                            ? `API request failed with status ${status}`
+                            : `Network error: ${error.message}`;
 
             return new LangtrainError(message, {
                 status,
                 code: error.code,
                 cause: error,
+                retryAfter,
             });
         }
 
@@ -146,6 +280,22 @@ export abstract class BaseClient {
         return new LangtrainError(String(error));
     }
 
+    private log(msg: string): void {
+        if (this.debug) {
+            process.stderr.write(`[langtrain] ${msg}\n`);
+        }
+    }
+
+    private emitEvent(event: RequestEvent): void {
+        if (this.onRequest) {
+            try {
+                this.onRequest(event);
+            } catch {
+                // Never let user callbacks crash the SDK
+            }
+        }
+    }
+
     private sleep(ms: number): Promise<void> {
         return new Promise(resolve => setTimeout(resolve, ms));
     }

package/dist/chunk-36QS5AXY.mjs

@@ -1,3 +0,0 @@
-import w,{AxiosError}from'axios';import k from'form-data';import y from'fs';import*as langvision from'langvision';export{langvision as o };export{Langvision as q}from'langvision';import*as langtune from'langtune';export{langtune as p };export{Langtune as r}from'langtune';var C=Object.defineProperty;var q=(n=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(n,{get:(e,t)=>(typeof require<"u"?require:e)[t]}):n)(function(n){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+n+'" is not supported')});var p=(n,e)=>{for(var t in e)C(n,t,{get:e[t],enumerable:true});};var T="https://api.langtrain.ai/api/v1",A=3e4,P=2,F=[408,429,500,502,503,504],a=class extends Error{constructor(e,t){super(e),this.name="LangtrainError",this.status=t?.status,this.code=t?.code,this.cause=t?.cause;}get isTransient(){return this.code==="ECONNABORTED"||this.code==="NETWORK_ERROR"||this.status!==void 0&&F.includes(this.status)}get isAuthError(){return this.status===401||this.status===403}get isNotFound(){return this.status===404}get isRateLimited(){return this.status===429}},s=class{constructor(e){this.maxRetries=e.maxRetries??P,this.http=w.create({baseURL:e.baseUrl||T,timeout:e.timeout??A,headers:{"X-API-Key":e.apiKey,"Content-Type":"application/json"}});}async request(e){let t;for(let r=0;r<=this.maxRetries;r++)try{return await e()}catch(i){if(t=this.wrapError(i),!t.isTransient||r===this.maxRetries)throw t;let o=Math.min(500*Math.pow(2,r),5e3);await this.sleep(o);}throw t}wrapError(e){if(e instanceof a)return e;if(e instanceof AxiosError){let t=e.response?.status,r=e.response?.data,i=r?.detail??r?.message??r?.error,o=i?String(i):e.code==="ECONNABORTED"?"Request timed out":t?`API request failed with status ${t}`:`Network error: ${e.message}`;return new a(o,{status:t,code:e.code,cause:e})}return e instanceof Error?new a(e.message,{cause:e}):new a(String(e))}sleep(e){return new Promise(t=>setTimeout(t,e))}};var b={};p(b,{AgentClient:()=>u});var u=class extends s{constructor(e){super(e);}async list(e){return this.request(async()=>{let t={};return e&&(t.workspace_id=e),(await this.http.get("/agents",{params:t})).data.agents})}async get(e){return this.request(async()=>(await this.http.get(`/agents/${e}`)).data)}async create(e){return this.request(async()=>(await this.http.post("/agents/",e)).data)}async delete(e){return this.request(async()=>{await this.http.delete(`/agents/${e}`);})}async execute(e,t,r=[],i){return this.request(async()=>(await this.http.post(`/agents/${e}/execute`,{input:t,messages:r,conversation_id:i})).data)}async logs(e,t=100){return this.request(async()=>(await this.http.get(`/agents/${e}/logs`,{params:{limit:t}})).data.logs)}};var d=class extends s{constructor(e){super(e);}async upload(e,t,r="fine-tune"){if(!y.existsSync(e))throw new Error(`File not found: ${e}`);return this.request(async()=>{let i=new k;return i.append("file",y.createReadStream(e)),t&&i.append("workspace_id",t),i.append("purpose",r),(await this.http.post("/files",i,{headers:i.getHeaders(),maxContentLength:1/0,maxBodyLength:1/0})).data})}async list(e,t){return this.request(async()=>{let r={workspace_id:e};return t&&(r.purpose=t),(await this.http.get("/files",{params:r})).data.data})}async delete(e){return this.request(async()=>{await this.http.delete(`/files/${e}`);})}};var l=class extends s{constructor(e){super(e);}async createJob(e){return this.request(async()=>(await this.http.post("/finetune/jobs",e)).data)}async listJobs(e,t=10){return this.request(async()=>(await this.http.get("/finetune/jobs",{params:{workspace_id:e,limit:t}})).data)}async getJob(e){return this.request(async()=>(await this.http.get(`/finetune/jobs/${e}`)).data)}async cancelJob(e){return this.request(async()=>(await this.http.post(`/finetune/jobs/${e}/cancel`)).data)}};var m=class extends s{constructor(e){super(e);}async getStatus(){return this.request(async()=>(await this.http.get("/subscription/status")).data)}async checkFeature(e){return this.request(async()=>(await this.http.get(`/subscription/check/${e}`)).data)}async getLimits(){return this.request(async()=>(await this.http.get("/subscription/analytics")).data)}};var _={};p(_,{ModelClient:()=>c});var c=class extends s{constructor(e){super(e);}async list(e){return this.request(async()=>{let t={};return e&&(t.task=e),(await this.http.get("/models",{params:t})).data.data})}async get(e){return this.request(async()=>(await this.http.get(`/models/${e}`)).data)}};var x={};p(x,{SecretClient:()=>g});var g=class extends s{constructor(e){super(e);}async list(e){return this.request(async()=>{let t={};return e&&(t.workspace_id=e),(await this.http.get("/secrets",{params:t})).data.secrets})}async set(e,t,r){return this.request(async()=>(await this.http.post("/secrets",{key:e,value:t,workspace_id:r})).data)}async delete(e,t){return this.request(async()=>{let r={};t&&(r.workspace_id=t),await this.http.delete(`/secrets/${e}`,{params:r});})}};var h=class extends s{constructor(e){super(e);}async list(e){return this.request(async()=>{let t={};return e&&(t.workspace_id=e),(await this.http.get("/guardrails/",{params:t})).data})}async get(e){return this.request(async()=>(await this.http.get(`/guardrails/${e}`)).data)}async create(e){return this.request(async()=>(await this.http.post("/guardrails/",e)).data)}async delete(e){return this.request(async()=>{await this.http.delete(`/guardrails/${e}`);})}async apply(e,t){return this.request(async()=>(await this.http.post("/guardrails/apply",{dataset_id:e,guardrail_id:t})).data)}};var f=class extends s{constructor(e){super(e);}async getSummary(e){return this.request(async()=>(await this.http.get("/usage",{params:{workspace_id:e}})).data)}async getHistory(e,t=30){return this.request(async()=>(await this.http.get("/usage/history",{params:{workspace_id:e,days:t}})).data.history)}};
-export{q as a,a as b,s as c,u as d,b as e,d as f,l as g,m as h,c as i,_ as j,g as k,x as l,h as m,f as n};//# sourceMappingURL=chunk-36QS5AXY.mjs.map
-//# sourceMappingURL=chunk-36QS5AXY.mjs.map