@fllf/agent-sdk 0.1.0

package/dist/llm/LLM.js

@@ -0,0 +1,404 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLM = void 0;
+const zod_1 = require("zod");
+const observability_1 = require("../observability");
+const errors_1 = require("./errors");
+const factory_1 = require("./factory");
+const DEFAULT_TIMEOUT_MS = 60_000;
+const DEFAULT_MAX_RETRIES = 2;
+const DEFAULT_RETRY_DELAY_MS = 250;
+const DEFAULT_RETRY_MAX_DELAY_MS = 2_000;
+class LLM {
+    provider;
+    runtimeConfig;
+    constructor(config = {}) {
+        const { provider, timeoutMs, maxRetries, retryDelayMs, retryMaxDelayMs, ...providerConfig } = config;
+        const resolvedProvider = provider
+            ? factory_1.ModelProviderFactory.create(provider, providerConfig)
+            : factory_1.ModelProviderFactory.autoDetect(providerConfig);
+        this.provider = resolvedProvider;
+        this.runtimeConfig = {
+            timeoutMs: timeoutMs ?? DEFAULT_TIMEOUT_MS,
+            maxRetries: maxRetries ?? DEFAULT_MAX_RETRIES,
+            retryDelayMs: retryDelayMs ?? DEFAULT_RETRY_DELAY_MS,
+            retryMaxDelayMs: retryMaxDelayMs ?? DEFAULT_RETRY_MAX_DELAY_MS,
+        };
+    }
+    get name() {
+        return this.provider.name;
+    }
+    get model() {
+        return this.provider.model;
+    }
+    get client() {
+        return this.provider.client;
+    }
+    capabilities(model) {
+        return this.provider.capabilities(model);
+    }
+    /**
+     * Agent 和 Executor 都通过这里与模型对话。
+     * 这里集中处理超时、重试和错误归一化，避免这些横切逻辑散到每个 Agent 里。
+     */
+    async chat(request) {
+        const model = request.model ?? this.model;
+        const startedAt = Date.now();
+        await (0, observability_1.emitRuntimeEvent)(request.trace?.observer, {
+            type: 'llm:start',
+            runId: request.trace?.runId ?? 'standalone',
+            timestamp: new Date(),
+            agentName: request.trace?.agentName,
+            sessionId: request.trace?.sessionId,
+            provider: this.name,
+            model,
+            messageCount: request.messages.length,
+            toolCount: request.tools?.length ?? 0,
+            metadata: request.metadata,
+        });
+        try {
+            const response = await this.runWithRetries({
+                ...request,
+                model,
+            }, (attemptRequest) => this.provider.chat(attemptRequest));
+            await (0, observability_1.emitRuntimeEvent)(request.trace?.observer, {
+                type: 'llm:end',
+                runId: request.trace?.runId ?? 'standalone',
+                timestamp: new Date(),
+                durationMs: Date.now() - startedAt,
+                agentName: request.trace?.agentName,
+                sessionId: request.trace?.sessionId,
+                provider: this.name,
+                model,
+                outputLength: response.content.length,
+            });
+            return response;
+        }
+        catch (error) {
+            const normalizedError = (0, errors_1.normalizeLLMError)(error, { provider: this.name });
+            await (0, observability_1.emitRuntimeEvent)(request.trace?.observer, {
+                type: 'llm:error',
+                runId: request.trace?.runId ?? 'standalone',
+                timestamp: new Date(),
+                durationMs: Date.now() - startedAt,
+                agentName: request.trace?.agentName,
+                sessionId: request.trace?.sessionId,
+                provider: this.name,
+                model,
+                error: (0, observability_1.toObservedError)(normalizedError),
+            });
+            throw normalizedError;
+        }
+    }
+    async generateObject(request) {
+        const { schema, name, description, ...chatRequest } = request;
+        const jsonSchema = {
+            name: name ?? 'structured_output',
+            schema: zod_1.z.toJSONSchema(schema),
+            strict: true,
+        };
+        if (description !== undefined) {
+            Object.assign(jsonSchema, { description });
+        }
+        const response = await this.chat({
+            ...chatRequest,
+            responseFormat: {
+                type: 'json_schema',
+                jsonSchema,
+            },
+        });
+        const parsedJson = parseJsonResponse(response.content, this.name);
+        const parsedSchema = schema.safeParse(parsedJson);
+        if (!parsedSchema.success) {
+            throw new errors_1.LLMStructuredOutputError('Model response did not match the requested schema.', {
+                provider: this.name,
+                cause: parsedSchema.error,
+            });
+        }
+        return {
+            value: parsedSchema.data,
+            response,
+        };
+    }
+    stream(request) {
+        const model = request.model ?? this.model;
+        const streamRequest = {
+            ...request,
+            model,
+        };
+        return this.observeStream(streamRequest, model);
+    }
+    async runWithRetries(request, operation) {
+        const maxRetries = request.maxRetries ?? this.runtimeConfig.maxRetries;
+        for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+            try {
+                return await this.runSingleAttempt(request, operation);
+            }
+            catch (error) {
+                const normalizedError = (0, errors_1.normalizeLLMError)(error, { provider: this.name });
+                const shouldRetry = normalizedError.retryable && attempt < maxRetries;
+                if (!shouldRetry) {
+                    throw normalizedError;
+                }
+                await sleep(getRetryDelayMs(request, this.runtimeConfig, attempt), request.signal);
+            }
+        }
+        throw new errors_1.LLMInvalidResponseError('LLM retry loop exited unexpectedly.', {
+            provider: this.name,
+        });
+    }
+    async runSingleAttempt(request, operation) {
+        const timeoutMs = request.timeoutMs ?? this.runtimeConfig.timeoutMs;
+        const attemptSignal = createAttemptSignal(request.signal, timeoutMs > 0);
+        try {
+            const attemptRequest = withSignal(request, attemptSignal.signal);
+            return await withTimeout(operation(attemptRequest), timeoutMs, () => attemptSignal.abortForTimeout(), this.name);
+        }
+        catch (error) {
+            if (attemptSignal.timedOut()) {
+                throw new errors_1.LLMTimeoutError(`LLM request timed out after ${timeoutMs}ms.`, {
+                    provider: this.name,
+                    cause: error,
+                });
+            }
+            if (attemptSignal.abortedByCaller()) {
+                throw new errors_1.LLMAbortError('LLM request was aborted by the caller.', {
+                    provider: this.name,
+                    cause: error,
+                });
+            }
+            throw error;
+        }
+        finally {
+            attemptSignal.cleanup();
+        }
+    }
+    async *observeStream(request, model) {
+        const startedAt = Date.now();
+        let outputLength = 0;
+        await (0, observability_1.emitRuntimeEvent)(request.trace?.observer, {
+            type: 'llm:start',
+            runId: request.trace?.runId ?? 'standalone',
+            timestamp: new Date(),
+            agentName: request.trace?.agentName,
+            sessionId: request.trace?.sessionId,
+            provider: this.name,
+            model,
+            messageCount: request.messages.length,
+            toolCount: request.tools?.length ?? 0,
+            metadata: request.metadata,
+        });
+        try {
+            for await (const chunk of this.runStreamWithRetries(request)) {
+                outputLength += chunk.contentDelta?.length ?? 0;
+                yield chunk;
+            }
+            await (0, observability_1.emitRuntimeEvent)(request.trace?.observer, {
+                type: 'llm:end',
+                runId: request.trace?.runId ?? 'standalone',
+                timestamp: new Date(),
+                durationMs: Date.now() - startedAt,
+                agentName: request.trace?.agentName,
+                sessionId: request.trace?.sessionId,
+                provider: this.name,
+                model,
+                outputLength,
+            });
+        }
+        catch (error) {
+            const normalizedError = (0, errors_1.normalizeLLMError)(error, { provider: this.name });
+            await (0, observability_1.emitRuntimeEvent)(request.trace?.observer, {
+                type: 'llm:error',
+                runId: request.trace?.runId ?? 'standalone',
+                timestamp: new Date(),
+                durationMs: Date.now() - startedAt,
+                agentName: request.trace?.agentName,
+                sessionId: request.trace?.sessionId,
+                provider: this.name,
+                model,
+                error: (0, observability_1.toObservedError)(normalizedError),
+            });
+            throw normalizedError;
+        }
+    }
+    async *runStreamWithRetries(request) {
+        const maxRetries = request.maxRetries ?? this.runtimeConfig.maxRetries;
+        let hasYieldedChunk = false;
+        for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+            try {
+                for await (const chunk of this.runStreamSingleAttempt(request)) {
+                    hasYieldedChunk = true;
+                    yield chunk;
+                }
+                return;
+            }
+            catch (error) {
+                const normalizedError = (0, errors_1.normalizeLLMError)(error, { provider: this.name });
+                const shouldRetry = normalizedError.retryable
+                    && attempt < maxRetries
+                    && !hasYieldedChunk;
+                if (!shouldRetry) {
+                    throw normalizedError;
+                }
+                await sleep(getRetryDelayMs(request, this.runtimeConfig, attempt), request.signal);
+            }
+        }
+        throw new errors_1.LLMInvalidResponseError('LLM stream retry loop exited unexpectedly.', {
+            provider: this.name,
+        });
+    }
+    async *runStreamSingleAttempt(request) {
+        if (!this.provider.stream) {
+            throw new errors_1.LLMInvalidResponseError(`${this.name} provider does not support streaming.`, {
+                provider: this.name,
+            });
+        }
+        const timeoutMs = request.timeoutMs ?? this.runtimeConfig.timeoutMs;
+        const attemptSignal = createAttemptSignal(request.signal, timeoutMs > 0);
+        const startedAt = Date.now();
+        let iterator;
+        try {
+            const attemptRequest = withSignal(request, attemptSignal.signal);
+            iterator = this.provider.stream(attemptRequest)[Symbol.asyncIterator]();
+            while (true) {
+                const nextTimeoutMs = getRemainingTimeoutMs(timeoutMs, startedAt, attemptSignal);
+                const next = await withTimeout(iterator.next(), nextTimeoutMs, () => attemptSignal.abortForTimeout(), this.name);
+                if (next.done) {
+                    return;
+                }
+                yield next.value;
+            }
+        }
+        catch (error) {
+            if (attemptSignal.timedOut()) {
+                throw new errors_1.LLMTimeoutError(`LLM request timed out after ${timeoutMs}ms.`, {
+                    provider: this.name,
+                    cause: error,
+                });
+            }
+            if (attemptSignal.abortedByCaller()) {
+                throw new errors_1.LLMAbortError('LLM request was aborted by the caller.', {
+                    provider: this.name,
+                    cause: error,
+                });
+            }
+            throw error;
+        }
+        finally {
+            if (iterator && !attemptSignal.timedOut()) {
+                await iterator.return?.();
+            }
+            attemptSignal.cleanup();
+        }
+    }
+}
+exports.LLM = LLM;
+function createAttemptSignal(callerSignal, needsSignal) {
+    if (callerSignal?.aborted) {
+        throw new errors_1.LLMAbortError('LLM request was aborted before it started.');
+    }
+    if (!callerSignal && !needsSignal) {
+        return {
+            signal: undefined,
+            timedOut: () => false,
+            abortedByCaller: () => false,
+            abortForTimeout: () => undefined,
+            cleanup: () => undefined,
+        };
+    }
+    const controller = new AbortController();
+    let timedOut = false;
+    let abortedByCaller = false;
+    const onCallerAbort = () => {
+        abortedByCaller = true;
+        controller.abort(callerSignal?.reason);
+    };
+    callerSignal?.addEventListener('abort', onCallerAbort, { once: true });
+    return {
+        signal: controller.signal,
+        timedOut: () => timedOut,
+        abortedByCaller: () => abortedByCaller,
+        abortForTimeout: () => {
+            timedOut = true;
+            controller.abort();
+        },
+        cleanup: () => {
+            callerSignal?.removeEventListener('abort', onCallerAbort);
+        },
+    };
+}
+function getRemainingTimeoutMs(timeoutMs, startedAt, attemptSignal) {
+    if (timeoutMs <= 0) {
+        return timeoutMs;
+    }
+    const remainingMs = timeoutMs - (Date.now() - startedAt);
+    if (remainingMs <= 0) {
+        attemptSignal.abortForTimeout();
+        throw new errors_1.LLMTimeoutError(`LLM request timed out after ${timeoutMs}ms.`);
+    }
+    return remainingMs;
+}
+function withSignal(request, signal) {
+    const attemptRequest = { ...request };
+    if (signal !== undefined) {
+        attemptRequest.signal = signal;
+    }
+    else {
+        delete attemptRequest.signal;
+    }
+    return attemptRequest;
+}
+async function sleep(delayMs, signal) {
+    if (delayMs <= 0) {
+        return;
+    }
+    if (signal?.aborted) {
+        throw new errors_1.LLMAbortError('LLM retry wait was aborted by the caller.');
+    }
+    let onAbort;
+    await new Promise((resolve, reject) => {
+        const timeoutId = setTimeout(resolve, delayMs);
+        onAbort = () => {
+            clearTimeout(timeoutId);
+            reject(new errors_1.LLMAbortError('LLM retry wait was aborted by the caller.'));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    }).finally(() => {
+        if (onAbort) {
+            signal?.removeEventListener('abort', onAbort);
+        }
+    });
+}
+async function withTimeout(promise, timeoutMs, onTimeout, provider) {
+    if (timeoutMs <= 0) {
+        return promise;
+    }
+    return await new Promise((resolve, reject) => {
+        const timeoutId = setTimeout(() => {
+            onTimeout();
+            reject(new errors_1.LLMTimeoutError(`LLM request timed out after ${timeoutMs}ms.`, {
+                provider,
+            }));
+        }, timeoutMs);
+        promise.then(resolve, reject).finally(() => {
+            clearTimeout(timeoutId);
+        });
+    });
+}
+function getRetryDelayMs(request, runtimeConfig, attempt) {
+    const retryDelayMs = request.retryDelayMs ?? runtimeConfig.retryDelayMs;
+    const retryMaxDelayMs = request.retryMaxDelayMs ?? runtimeConfig.retryMaxDelayMs;
+    return Math.min(retryDelayMs * 2 ** attempt, retryMaxDelayMs);
+}
+function parseJsonResponse(content, provider) {
+    try {
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new errors_1.LLMStructuredOutputError('Model response was not valid JSON.', {
+            provider,
+            cause: error,
+        });
+    }
+}
+//# sourceMappingURL=LLM.js.map

package/dist/llm/LLM.js.map

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

package/dist/llm/errors.d.ts

@@ -0,0 +1,43 @@
+import type { ModelProviderName } from './types';
+export type LLMErrorCode = 'auth' | 'rate_limit' | 'timeout' | 'aborted' | 'provider' | 'invalid_response' | 'structured_output';
+export interface LLMErrorOptions {
+    code: LLMErrorCode;
+    provider?: ModelProviderName | undefined;
+    status?: number | undefined;
+    retryable?: boolean | undefined;
+    cause?: unknown;
+}
+export declare class LLMError extends Error {
+    readonly code: LLMErrorCode;
+    readonly provider: ModelProviderName | undefined;
+    readonly status: number | undefined;
+    readonly retryable: boolean;
+    constructor(message: string, options: LLMErrorOptions);
+}
+export declare class LLMAuthenticationError extends LLMError {
+    constructor(message: string, options?: Omit<LLMErrorOptions, 'code' | 'retryable'>);
+}
+export declare class LLMRateLimitError extends LLMError {
+    constructor(message: string, options?: Omit<LLMErrorOptions, 'code' | 'retryable'>);
+}
+export declare class LLMTimeoutError extends LLMError {
+    constructor(message: string, options?: Omit<LLMErrorOptions, 'code' | 'retryable'>);
+}
+export declare class LLMAbortError extends LLMError {
+    constructor(message: string, options?: Omit<LLMErrorOptions, 'code' | 'retryable'>);
+}
+export declare class LLMProviderError extends LLMError {
+    constructor(message: string, options?: Omit<LLMErrorOptions, 'code'>);
+}
+export declare class LLMInvalidResponseError extends LLMError {
+    constructor(message: string, options?: Omit<LLMErrorOptions, 'code' | 'retryable'>);
+}
+export declare class LLMStructuredOutputError extends LLMError {
+    constructor(message: string, options?: Omit<LLMErrorOptions, 'code' | 'retryable'>);
+}
+export interface NormalizeLLMErrorOptions {
+    provider?: ModelProviderName;
+}
+export declare function normalizeLLMError(error: unknown, options?: NormalizeLLMErrorOptions): LLMError;
+export declare function isRetryableStatus(status: number | undefined): boolean;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/llm/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,MAAM,YAAY,GAClB,MAAM,GACN,YAAY,GACZ,SAAS,GACT,SAAS,GACT,UAAU,GACV,kBAAkB,GAClB,mBAAmB,CAAC;AAE1B,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,QAAS,SAAQ,KAAK;IAC/B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;CAQxD;AAED,qBAAa,sBAAuB,SAAQ,QAAQ;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,CAAM;CAGzF;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,CAAM;CAGzF;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,CAAM;CAGzF;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,CAAM;CAGzF;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAM;CAO3E;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,CAAM;CAGzF;AAED,qBAAa,wBAAyB,SAAQ,QAAQ;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,CAAM;CAGzF;AAED,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,wBAA6B,GAAG,QAAQ,CAoClG;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CASrE"}

package/dist/llm/errors.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMStructuredOutputError = exports.LLMInvalidResponseError = exports.LLMProviderError = exports.LLMAbortError = exports.LLMTimeoutError = exports.LLMRateLimitError = exports.LLMAuthenticationError = exports.LLMError = void 0;
+exports.normalizeLLMError = normalizeLLMError;
+exports.isRetryableStatus = isRetryableStatus;
+class LLMError extends Error {
+    code;
+    provider;
+    status;
+    retryable;
+    constructor(message, options) {
+        super(message, { cause: options.cause });
+        this.name = new.target.name;
+        this.code = options.code;
+        this.provider = options.provider;
+        this.status = options.status;
+        this.retryable = options.retryable ?? false;
+    }
+}
+exports.LLMError = LLMError;
+class LLMAuthenticationError extends LLMError {
+    constructor(message, options = {}) {
+        super(message, { ...options, code: 'auth', retryable: false });
+    }
+}
+exports.LLMAuthenticationError = LLMAuthenticationError;
+class LLMRateLimitError extends LLMError {
+    constructor(message, options = {}) {
+        super(message, { ...options, code: 'rate_limit', retryable: true });
+    }
+}
+exports.LLMRateLimitError = LLMRateLimitError;
+class LLMTimeoutError extends LLMError {
+    constructor(message, options = {}) {
+        super(message, { ...options, code: 'timeout', retryable: true });
+    }
+}
+exports.LLMTimeoutError = LLMTimeoutError;
+class LLMAbortError extends LLMError {
+    constructor(message, options = {}) {
+        super(message, { ...options, code: 'aborted', retryable: false });
+    }
+}
+exports.LLMAbortError = LLMAbortError;
+class LLMProviderError extends LLMError {
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            code: 'provider',
+            retryable: options.retryable ?? isRetryableStatus(options.status),
+        });
+    }
+}
+exports.LLMProviderError = LLMProviderError;
+class LLMInvalidResponseError extends LLMError {
+    constructor(message, options = {}) {
+        super(message, { ...options, code: 'invalid_response', retryable: false });
+    }
+}
+exports.LLMInvalidResponseError = LLMInvalidResponseError;
+class LLMStructuredOutputError extends LLMError {
+    constructor(message, options = {}) {
+        super(message, { ...options, code: 'structured_output', retryable: false });
+    }
+}
+exports.LLMStructuredOutputError = LLMStructuredOutputError;
+function normalizeLLMError(error, options = {}) {
+    if (error instanceof LLMError) {
+        return error;
+    }
+    const status = getStatus(error);
+    const message = getMessage(error);
+    if (status === 401 || status === 403) {
+        return new LLMAuthenticationError(message, {
+            provider: options.provider,
+            status,
+            cause: error,
+        });
+    }
+    if (status === 429) {
+        return new LLMRateLimitError(message, {
+            provider: options.provider,
+            status,
+            cause: error,
+        });
+    }
+    if (isAbortLikeError(error)) {
+        return new LLMAbortError(message, {
+            provider: options.provider,
+            cause: error,
+        });
+    }
+    return new LLMProviderError(message, {
+        provider: options.provider,
+        status,
+        cause: error,
+    });
+}
+function isRetryableStatus(status) {
+    return status === 408
+        || status === 409
+        || status === 425
+        || status === 429
+        || status === 500
+        || status === 502
+        || status === 503
+        || status === 504;
+}
+function getMessage(error) {
+    if (error instanceof Error && error.message) {
+        return error.message;
+    }
+    return String(error);
+}
+function getStatus(error) {
+    if (!isRecord(error)) {
+        return undefined;
+    }
+    const status = error.status ?? error.statusCode;
+    return typeof status === 'number' ? status : undefined;
+}
+function isAbortLikeError(error) {
+    return error instanceof Error && error.name === 'AbortError';
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=errors.js.map

package/dist/llm/errors.js.map

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

package/dist/llm/factory.d.ts

@@ -0,0 +1,9 @@
+import type { ChatModel, ModelProviderName, ProviderConfig } from './types';
+export type ProviderBuilder = (config?: ProviderConfig) => ChatModel;
+export declare class ModelProviderFactory {
+    private static readonly builders;
+    static register(providerName: ModelProviderName, builder: ProviderBuilder): void;
+    static autoDetect(config?: ProviderConfig): ChatModel;
+    static create(providerName: ModelProviderName, config?: ProviderConfig): ChatModel;
+}
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/llm/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE5E,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,CAAC,EAAE,cAAc,KAAK,SAAS,CAAC;AAErE,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAiD;IAEjF,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAIhF,MAAM,CAAC,UAAU,CAAC,MAAM,GAAE,cAAmB,GAAG,SAAS;IAQzD,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,iBAAiB,EAAE,MAAM,GAAE,cAAmB,GAAG,SAAS;CAQzF"}

package/dist/llm/factory.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelProviderFactory = void 0;
+const openai_1 = require("./providers/openai");
+const local_1 = require("./providers/local");
+class ModelProviderFactory {
+    static builders = new Map();
+    static register(providerName, builder) {
+        this.builders.set(providerName, builder);
+    }
+    static autoDetect(config = {}) {
+        if (process.env.OPENAI_API_KEY) {
+            return this.create('openai', config);
+        }
+        return this.create('local', config);
+    }
+    static create(providerName, config = {}) {
+        const builder = this.builders.get(providerName);
+        if (!builder) {
+            throw new Error(`Unknown model provider: ${providerName}`);
+        }
+        return builder(config);
+    }
+}
+exports.ModelProviderFactory = ModelProviderFactory;
+ModelProviderFactory.register('openai', (config) => new openai_1.OpenAIProvider(config));
+ModelProviderFactory.register('local', (config) => new local_1.LocalProvider(config));
+//# sourceMappingURL=factory.js.map

package/dist/llm/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/llm/factory.ts"],"names":[],"mappings":";;;AAAA,+CAAoD;AACpD,6CAAkD;AAKlD,MAAa,oBAAoB;IACrB,MAAM,CAAU,QAAQ,GAAG,IAAI,GAAG,EAAsC,CAAC;IAEjF,MAAM,CAAC,QAAQ,CAAC,YAA+B,EAAE,OAAwB;QACrE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,SAAyB,EAAE;QACzC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,YAA+B,EAAE,SAAyB,EAAE;QACtE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;;AAtBL,oDAuBC;AAED,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,uBAAc,CAAC,MAAM,CAAC,CAAC,CAAC;AAChF,oBAAoB,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,qBAAa,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/llm/index.d.ts

@@ -0,0 +1,6 @@
+export { LLM } from './LLM';
+export { LLMAbortError, LLMAuthenticationError, LLMError, LLMInvalidResponseError, LLMProviderError, LLMRateLimitError, LLMStructuredOutputError, LLMTimeoutError, normalizeLLMError, } from './errors';
+export { ModelProviderFactory } from './factory';
+export type { ModelProvider } from './providers/base';
+export type { ChatMessage, ChatModel, ChatRequest, ChatResponse, ChatResponseFormat, ChatStreamChunk, ChatToolCall, ChatToolSchema, LLMConfig, LLMRuntimeConfig, ModelCapabilities, ModelProviderName, ProviderConfig, StructuredOutputRequest, StructuredOutputResponse, TokenUsage, } from './types';
+//# sourceMappingURL=index.d.ts.map