browserclaw-agent 0.6.1 → 0.7.0

package/dist/api-types.d.ts

@@ -0,0 +1,81 @@
+import type { LlmConfig } from './types.js';
+export declare const API_VERSION = 1;
+export type ApiVersion = typeof API_VERSION;
+export interface CreateSessionRequest {
+    prompt: string;
+    url?: string;
+    headless?: boolean;
+    skip_moderation?: boolean;
+    skip_postprocessing?: boolean;
+    llm_config?: LlmConfig;
+}
+export interface CreateSessionResponse {
+    session_id: string;
+    status: string;
+    created_at: string;
+}
+interface BaseSSEEvent {
+    apiVersion: ApiVersion;
+}
+export type SSEEvent = (BaseSSEEvent & {
+    type: 'connected';
+    session_id: string;
+}) | (BaseSSEEvent & {
+    type: 'step';
+    step: number;
+    action?: unknown;
+    url?: string;
+    title?: string;
+}) | (BaseSSEEvent & {
+    type: 'thinking';
+    step: number;
+    message: string;
+}) | (BaseSSEEvent & {
+    type: 'completed';
+    answer?: string;
+    duration_ms?: number;
+}) | (BaseSSEEvent & {
+    type: 'failed';
+    step?: number;
+    error: string;
+}) | (BaseSSEEvent & {
+    type: 'step_error';
+    step: number;
+    action?: string;
+    error: string;
+    error_kind?: string;
+}) | (BaseSSEEvent & {
+    type: 'context_compressed';
+    step: number;
+    droppedSteps: number;
+    summary: string;
+    summary_length: number;
+}) | (BaseSSEEvent & {
+    type: 'context_compress_failed';
+    step: number;
+    error: string;
+}) | (BaseSSEEvent & {
+    type: 'domain_blocked';
+    domain: string;
+    reason: string;
+    attempt: number;
+}) | (BaseSSEEvent & {
+    type: 'skill_skipped';
+    domain: string;
+    reason: string;
+}) | (BaseSSEEvent & {
+    type: 'user_interjection_timeout';
+    step: number;
+    question: string;
+}) | (BaseSSEEvent & {
+    type: 'ask_user';
+    step: number;
+    question: string;
+}) | (BaseSSEEvent & {
+    type: 'user_response';
+    step: number;
+    text: string;
+});
+export type SSEEventType = SSEEvent['type'];
+export {};
+//# sourceMappingURL=api-types.d.ts.map

package/dist/api-types.d.ts.map

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

package/dist/api-types.js

@@ -0,0 +1,6 @@
+// CONTRACT MIRROR — keep in sync with src/Frontend/src/lib/api-types.ts.
+// Separate tsconfig roots block a shared module; Frontend declares LlmConfig
+// inline + adds ApiErrorBody, Services imports LlmConfig from ./types.js.
+// Any SSEEvent / CreateSession* / API_VERSION change must be mirrored in both.
+export const API_VERSION = 1;
+//# sourceMappingURL=api-types.js.map

package/dist/api-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-types.js","sourceRoot":"","sources":["../src/api-types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,6EAA6E;AAC7E,0EAA0E;AAC1E,+EAA+E;AAI/E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC"}

package/dist/config.d.ts

@@ -18,6 +18,9 @@ export declare const SCROLL_PIXELS = 500;
 export declare const USER_RESPONSE_TIMEOUT_MS: number;
 export declare const MAX_STEPS: number;
 export declare const LLM_MAX_TOKENS: number;
+export declare const MAX_STEPS_HARD_CEILING: number;
+export declare const INTERJECTION_TIMEOUT_CANCEL: boolean;
+export declare const STRICT_NONIDEMPOTENT_BAN: boolean;
 export declare const USER_INTERJECTION_ENABLED: boolean;
 export declare const MAX_INTERJECTIONS_PER_RUN = 20;
 export declare const INTERJECTION_MIN_INTERVAL_MS = 2000;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAWhF;AAID,eAAO,MAAM,kBAAkB,QAAwD,CAAC;AACxF,eAAO,MAAM,mBAAmB,QAAyD,CAAC;AAC1F,eAAO,MAAM,mBAAmB,QAAyD,CAAC;AAC1F,eAAO,MAAM,cAAc,QAAqD,CAAC;AACjF,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,wBAAwB,QAAiE,CAAC;AACvG,eAAO,MAAM,SAAS,QAA8C,CAAC;AACrE,eAAO,MAAM,cAAc,QAAqD,CAAC;AAGjF,eAAO,MAAM,yBAAyB,SAAkD,CAAC;AACzF,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAClD,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAC7C,eAAO,MAAM,gCAAgC,OAAQ,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,IAAI,WAAW,CAO5C;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,cAAc,IAAI,YAAY,CAkB7C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAWhF;AAID,eAAO,MAAM,kBAAkB,QAAwD,CAAC;AACxF,eAAO,MAAM,mBAAmB,QAAyD,CAAC;AAC1F,eAAO,MAAM,mBAAmB,QAAyD,CAAC;AAC1F,eAAO,MAAM,cAAc,QAAqD,CAAC;AACjF,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,wBAAwB,QAAiE,CAAC;AACvG,eAAO,MAAM,SAAS,QAA8C,CAAC;AACrE,eAAO,MAAM,cAAc,QAAqD,CAAC;AAGjF,eAAO,MAAM,sBAAsB,QAA4D,CAAC;AAChG,eAAO,MAAM,2BAA2B,SAAqD,CAAC;AAC9F,eAAO,MAAM,wBAAwB,SAAkD,CAAC;AAGxF,eAAO,MAAM,yBAAyB,SAAkD,CAAC;AACzF,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAClD,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAC7C,eAAO,MAAM,gCAAgC,OAAQ,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,IAAI,WAAW,CAO5C;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,cAAc,IAAI,YAAY,CAO7C"}

package/dist/config.js

@@ -1,4 +1,3 @@
-import { getAvailableProviders, getActiveProvider, getModel } from './llm.js';
 import { logger } from './logger.js';
 export function requireEnv(name) {
     const value = process.env[name];
@@ -52,6 +51,10 @@ export const SCROLL_PIXELS = 500;
 export const USER_RESPONSE_TIMEOUT_MS = parseInt(process.env.USER_RESPONSE_TIMEOUT_MS ?? '300000', 10);
 export const MAX_STEPS = parseInt(process.env.MAX_STEPS ?? '50', 10);
 export const LLM_MAX_TOKENS = parseInt(process.env.LLM_MAX_TOKENS ?? '1024', 10);
+// Optional opt-in flags. Defaults preserve pre-flag behavior (see .env.example).
+export const MAX_STEPS_HARD_CEILING = parseInt(process.env.MAX_STEPS_HARD_CEILING ?? '100', 10);
+export const INTERJECTION_TIMEOUT_CANCEL = process.env.INTERJECTION_TIMEOUT_CANCEL === 'true';
+export const STRICT_NONIDEMPOTENT_BAN = process.env.STRICT_NONIDEMPOTENT_BAN === 'true';
 // User-interjection limits (always-on user chat feature).
 export const USER_INTERJECTION_ENABLED = process.env.ENABLE_USER_INTERJECTION === 'true';
 export const MAX_INTERJECTIONS_PER_RUN = 20;
@@ -67,15 +70,6 @@ export function getMinioConfig() {
     };
 }
 export function validateConfig() {
-    const available = getAvailableProviders();
-    if (available.length === 0) {
-        logger.fatal('No AI providers available — set at least one provider API key');
-        process.exit(1);
-    }
-    logger.info({ providers: available.map((p) => p.provider) }, 'Available providers');
-    // Validate LLM_PROVIDER + API key at startup so we fail fast
-    const active = getActiveProvider();
-    logger.info({ provider: active.provider, model: getModel() }, 'Active provider');
     return {
         port: requireEnvInt('PORT'),
         rateLimitMax: requireEnvInt('RATE_LIMIT_MAX'),

package/dist/config.js.map

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

package/dist/idempotency.d.ts

@@ -0,0 +1,48 @@
+export declare const IDEMPOTENCY_TTL_MS: number;
+export declare const IDEMPOTENCY_MAX_KEY_LENGTH = 256;
+export interface FingerprintInput {
+    prompt: string;
+    url?: string;
+    headless?: boolean;
+    skip_moderation?: boolean;
+    skip_postprocessing?: boolean;
+    llm_config?: {
+        provider: string;
+        model: string;
+    };
+}
+export declare function buildRequestFingerprint(input: FingerprintInput): string;
+export declare function getIdempotencyCacheKey(clientIp: string, idempotencyKey: string): string;
+export declare function normalizeIdempotencyKey(raw: unknown): string | undefined;
+export interface PendingIdempotencyEntry<T> {
+    kind: 'pending';
+    fingerprint: string;
+    createdAt: number;
+    promise: Promise<T>;
+    resolve: (value: T) => void;
+    reject: (error: Error) => void;
+}
+export interface CompletedIdempotencyEntry<T> {
+    kind: 'completed';
+    fingerprint: string;
+    createdAt: number;
+    response: T;
+}
+export type IdempotencyCacheEntry<T> = PendingIdempotencyEntry<T> | CompletedIdempotencyEntry<T>;
+export type IdempotencyLookupResult<T> = {
+    kind: 'miss';
+} | {
+    kind: 'fingerprint_mismatch';
+} | {
+    kind: 'pending_match';
+    promise: Promise<T>;
+} | {
+    kind: 'completed_match';
+    response: T;
+};
+export declare function expirePendingIdempotency<T>(cache: Map<string, IdempotencyCacheEntry<T>>, now: number): void;
+export declare function lookupIdempotency<T>(cache: Map<string, IdempotencyCacheEntry<T>>, cacheKey: string, fingerprint: string, now: number): IdempotencyLookupResult<T>;
+export declare function reserveIdempotency<T>(cache: Map<string, IdempotencyCacheEntry<T>>, cacheKey: string, fingerprint: string, now: number): PendingIdempotencyEntry<T>;
+export declare function completeIdempotency<T>(cache: Map<string, IdempotencyCacheEntry<T>>, cacheKey: string, reservation: PendingIdempotencyEntry<T>, response: T, now: number): void;
+export declare function failIdempotency<T>(cache: Map<string, IdempotencyCacheEntry<T>>, cacheKey: string, reservation: PendingIdempotencyEntry<T>, error: Error): void;
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/idempotency.d.ts.map

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

package/dist/idempotency.js

@@ -0,0 +1,99 @@
+import { createHash } from 'node:crypto';
+export const IDEMPOTENCY_TTL_MS = 5 * 60 * 1000;
+export const IDEMPOTENCY_MAX_KEY_LENGTH = 256;
+// api_key is intentionally NOT in the fingerprint: don't retain digests of
+// secrets in memory, and BYOK clients can rotate keys without losing replay.
+export function buildRequestFingerprint(input) {
+    const canonical = {
+        prompt: input.prompt,
+        url: input.url ?? null,
+        headless: input.headless ?? null,
+        skip_moderation: input.skip_moderation ?? false,
+        skip_postprocessing: input.skip_postprocessing ?? false,
+        llm_provider: input.llm_config?.provider ?? null,
+        llm_model: input.llm_config?.model ?? null,
+    };
+    return createHash('sha256').update(JSON.stringify(canonical)).digest('hex');
+}
+// Tuple-encoded so colons in IPv6 / opaque keys can't cause ambiguous collapses.
+export function getIdempotencyCacheKey(clientIp, idempotencyKey) {
+    return JSON.stringify([clientIp, idempotencyKey]);
+}
+export function normalizeIdempotencyKey(raw) {
+    const value = Array.isArray(raw) ? raw[0] : raw;
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed === '' || trimmed.length > IDEMPOTENCY_MAX_KEY_LENGTH)
+        return undefined;
+    return trimmed;
+}
+// Reject + evict any pending entry older than IDEMPOTENCY_TTL_MS so a wedged
+// createSession can't poison the (clientIp, key) slot indefinitely. Waiters
+// awaiting the rejected promise unblock with a clean error.
+export function expirePendingIdempotency(cache, now) {
+    for (const [key, entry] of cache) {
+        if (entry.kind === 'pending' && now - entry.createdAt > IDEMPOTENCY_TTL_MS) {
+            cache.delete(key);
+            entry.reject(new Error('Idempotency reservation expired (original request did not complete in time)'));
+        }
+    }
+}
+export function lookupIdempotency(cache, cacheKey, fingerprint, now) {
+    const entry = cache.get(cacheKey);
+    if (entry === undefined)
+        return { kind: 'miss' };
+    if (now - entry.createdAt > IDEMPOTENCY_TTL_MS) {
+        cache.delete(cacheKey);
+        if (entry.kind === 'pending') {
+            entry.reject(new Error('Idempotency reservation expired (original request did not complete in time)'));
+        }
+        return { kind: 'miss' };
+    }
+    if (entry.fingerprint !== fingerprint) {
+        return { kind: 'fingerprint_mismatch' };
+    }
+    if (entry.kind === 'pending') {
+        return { kind: 'pending_match', promise: entry.promise };
+    }
+    return { kind: 'completed_match', response: entry.response };
+}
+export function reserveIdempotency(cache, cacheKey, fingerprint, now) {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    promise.catch(() => undefined);
+    const entry = {
+        kind: 'pending',
+        fingerprint,
+        createdAt: now,
+        promise,
+        resolve,
+        reject,
+    };
+    cache.set(cacheKey, entry);
+    return entry;
+}
+// Reservation passed to complete/fail so a wedged-then-recovered handler can't
+// overwrite a fresh entry that another request created after cleanup evicted us.
+export function completeIdempotency(cache, cacheKey, reservation, response, now) {
+    if (cache.get(cacheKey) !== reservation)
+        return;
+    cache.set(cacheKey, {
+        kind: 'completed',
+        fingerprint: reservation.fingerprint,
+        createdAt: now,
+        response,
+    });
+    reservation.resolve(response);
+}
+export function failIdempotency(cache, cacheKey, reservation, error) {
+    if (cache.get(cacheKey) === reservation) {
+        cache.delete(cacheKey);
+    }
+    reservation.reject(error);
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/idempotency.js.map

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

package/dist/index.d.ts

@@ -8,4 +8,5 @@ export { fillIframeFieldByTokens } from './skills/fill-iframe-field.js';
 export type { FillIframeFieldResult } from './skills/fill-iframe-field.js';
 export type { AgentAction, AgentActionType, AgentLoopResult, AgentProgress, AgentStep, CatalogSkill, CreateSessionRequest, DomainLesson, DomainSkillEntry, LlmConfig, LlmProvider, Session, SessionStatus, SkillMetadata, SkillOutput, SkillStep, TaskLesson, UserMessage, } from './types.js';
 export { HttpError, LlmParseError } from './types.js';
+export * from 'browserclaw';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC/F,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAExG,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,YAAY,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,aAAa,EACb,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,OAAO,EACP,aAAa,EACb,aAAa,EACb,WAAW,EACX,SAAS,EACT,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC/F,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAExG,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,YAAY,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,aAAa,EACb,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,OAAO,EACP,aAAa,EACb,aAAa,EACb,WAAW,EACX,SAAS,EACT,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtD,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -3,4 +3,5 @@ export { defaultAgentConfig } from './config.js';
 export { runWithLlmConfig, getTokenUsage } from './llm.js';
 export { fillIframeFieldByTokens } from './skills/fill-iframe-field.js';
 export { HttpError, LlmParseError } from './types.js';
+export * from 'browserclaw';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAG/F,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAuBxE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAG/F,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAuBxE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtD,cAAc,aAAa,CAAC"}

package/dist/llm.d.ts

@@ -1,5 +1,7 @@
 import type { LlmConfig } from './types.js';
 export declare function sanitizeErrorText(text: string): string;
+export declare function extractProviderMessage(err: unknown): string | null;
+export declare function isFailFastError(err: unknown): boolean;
 export interface TokenUsage {
     input: number;
     output: number;
@@ -15,16 +17,6 @@ export declare const BYOK_PROVIDERS: Partial<Record<string, {
     baseURL: string;
     useMaxCompletionTokens: boolean;
 }>>;
-export interface ProviderConfig {
-    provider: string;
-    label: string;
-    baseURL: string;
-    envVar: string;
-    useMaxCompletionTokens: boolean;
-}
-export declare function getAvailableProviders(): ProviderConfig[];
-export declare function getActiveProvider(): ProviderConfig;
-export declare function getModel(): string;
 export interface LLMRequest {
     system: string;
     message: string;

package/dist/llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAW5C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAWD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvF;AAaD,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,sBAAsB,EAAE,OAAO,CAAA;CAAE,CAAC,CAKxG,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAwJD,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CAExD;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAOjC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAwGD,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED,wBAAgB,aAAa,IAAI,UAAU,CAK1C;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAWxC;AA2FD,wBAAsB,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAgD/D;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAU5D;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDrG"}
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAW5C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAsBlE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMrD;AAmBD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvF;AAQD,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,sBAAsB,EAAE,OAAO,CAAA;CAAE,CAAC,CAKxG,CAAC;AAQF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAuFD,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,aAAa,IAAI,UAAU,CAG1C;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAuFD,wBAAsB,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAoB/D;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAkB5D;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCrG"}