@propio-ai/providers 0.1.0

package/dist/providers/xai.js

@@ -0,0 +1,371 @@
+import { ProviderError, ProviderAuthenticationError, } from "../types.js";
+import { withRetry } from "../internal/withRetry.js";
+import { buildOpenAIChatCompletionRequestBody, expandToolResultMessages, parseJsonMaybe, parseOpenAIStreamToolCallArguments, readSseDataLines, } from "../internal/shared.js";
+import { consumeOpenAiChatCompletionsStream } from "../internal/openAiStream.js";
+import { OpenAiCompatibleProvider, } from "../internal/openAiCompatibleProvider.js";
+const XAI_CHAT_COMPLETIONS_API_URLS = [
+    "https://api.x.ai/v1/chat/completions",
+    "https://us-east-1.api.x.ai/v1/chat/completions",
+    "https://eu-west-1.api.x.ai/v1/chat/completions",
+];
+const XAI_RESPONSES_API_URLS = [
+    "https://api.x.ai/v1/responses",
+    "https://us-east-1.api.x.ai/v1/responses",
+    "https://eu-west-1.api.x.ai/v1/responses",
+];
+/**
+ * xAI (Grok) implementation of LLMProvider using the OpenAI-compatible API at api.x.ai.
+ */
+export class XaiProvider extends OpenAiCompatibleProvider {
+    constructor(options) {
+        super();
+        this.name = "xai";
+        const apiKey = options.apiKey ?? process.env.XAI_API_KEY ?? "";
+        if (!apiKey || apiKey.trim() === "") {
+            throw new ProviderAuthenticationError("xAI API key is required. Set XAI_API_KEY or pass apiKey in options.");
+        }
+        this.retryConfig = options.retryConfig;
+        this.onDiagnosticEvent = options.onDiagnosticEvent;
+        this.model = options.model;
+        this.configureCapabilities(options.contextWindowTokens);
+        this.apiKey = apiKey;
+    }
+    shouldRetryEndpoint(status) {
+        return status !== undefined && status >= 500 && status < 600;
+    }
+    isAbortError(translated) {
+        return (translated.message === "Request cancelled" ||
+            translated.originalError?.name === "AbortError");
+    }
+    shouldContinueToNextEndpoint(error, translated) {
+        return !(error instanceof ProviderError) && !this.isAbortError(translated);
+    }
+    async createEndpointResponseError(response) {
+        let errorBody = "";
+        try {
+            errorBody = await response.text();
+        }
+        catch {
+            // ignore read failures
+        }
+        return {
+            translated: this.translateError(new Error(errorBody || `HTTP ${response.status}`), response),
+            retryable: this.shouldRetryEndpoint(response.status),
+        };
+    }
+    getContinuationError(error) {
+        const translated = error instanceof ProviderError ? error : this.translateError(error);
+        if (!this.shouldContinueToNextEndpoint(error, translated)) {
+            throw translated;
+        }
+        return translated;
+    }
+    async createPostResponse(apiUrls, body, signal) {
+        let lastError = null;
+        for (const apiUrl of apiUrls) {
+            try {
+                const response = await fetch(apiUrl, {
+                    method: "POST",
+                    headers: {
+                        Authorization: `Bearer ${this.apiKey}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify(body),
+                    signal,
+                });
+                if (response.ok) {
+                    return response;
+                }
+                const { translated, retryable } = await this.createEndpointResponseError(response);
+                if (!retryable) {
+                    throw translated;
+                }
+                lastError = translated;
+            }
+            catch (error) {
+                lastError = this.getContinuationError(error);
+            }
+        }
+        throw lastError ?? new ProviderError("xAI request failed");
+    }
+    async *streamChat(request) {
+        try {
+            if (request.requestReasoning) {
+                yield* this.streamResponsesChat(request);
+                return;
+            }
+            const body = this.createChatCompletionRequestBody(request);
+            const reader = await this.postStreamReader(request, XAI_CHAT_COMPLETIONS_API_URLS, body);
+            const toolCallsByIndex = new Map();
+            yield* this.consumeChatCompletionsStream(reader, toolCallsByIndex);
+        }
+        catch (error) {
+            if (error instanceof ProviderError)
+                throw error;
+            throw this.translateError(error);
+        }
+    }
+    async *streamResponsesChat(request) {
+        const body = this.createResponsesRequestBody(request);
+        const reader = await this.postStreamReader(request, XAI_RESPONSES_API_URLS, body);
+        yield* this.consumeResponsesStream(reader);
+    }
+    async postStreamReader(request, apiUrls, body) {
+        const response = await withRetry(() => this.createPostResponse(apiUrls, body, request.signal), this.buildRetryOptions(request, this.model, this.retryConfig, this.onDiagnosticEvent));
+        const reader = this.getResponseReader(response);
+        if (!reader) {
+            throw this.translateError(new Error("No response body"));
+        }
+        return reader;
+    }
+    createResponsesRequestBody(request) {
+        const body = {
+            model: request.model || this.model,
+            input: this.chatMessagesToResponsesInput(request.messages),
+            stream: true,
+        };
+        if (request.tools && request.tools.length > 0) {
+            body.tools = request.tools.map((tool) => this.chatToolToResponsesTool(tool));
+        }
+        return body;
+    }
+    chatToolToResponsesTool(tool) {
+        return {
+            type: "function",
+            name: tool.function.name,
+            description: tool.function.description,
+            parameters: tool.function.parameters ?? {
+                type: "object",
+                properties: {},
+            },
+        };
+    }
+    serializeToolArguments(args) {
+        return typeof args === "string" ? args : JSON.stringify(args ?? {});
+    }
+    chatMessagesToResponsesInput(messages) {
+        const input = [];
+        for (const msg of expandToolResultMessages(messages)) {
+            this.appendResponsesInputMessage(msg, input);
+        }
+        return input;
+    }
+    appendResponsesInputMessage(msg, input) {
+        if (msg.role === "system") {
+            input.push({ role: "system", content: msg.content ?? "" });
+            return;
+        }
+        if (msg.role === "user") {
+            this.appendResponsesUserMessage(msg, input);
+            return;
+        }
+        if (msg.role === "assistant") {
+            this.appendResponsesAssistantMessage(msg, input);
+            return;
+        }
+        if (msg.role === "tool" && msg.toolCallId) {
+            input.push({
+                type: "function_call_output",
+                call_id: msg.toolCallId,
+                output: msg.content ?? "",
+            });
+        }
+    }
+    appendResponsesUserMessage(msg, input) {
+        const content = [];
+        if (msg.content) {
+            content.push({ type: "input_text", text: msg.content });
+        }
+        input.push({
+            role: "user",
+            content: content.length > 0 ? content : [{ type: "input_text", text: "" }],
+        });
+    }
+    appendResponsesAssistantMessage(msg, input) {
+        if (msg.content) {
+            input.push({ role: "assistant", content: msg.content });
+        }
+        if (!msg.toolCalls) {
+            return;
+        }
+        for (const toolCall of msg.toolCalls) {
+            const callId = toolCall.id ?? `call_${toolCall.function.name}_${input.length}`;
+            input.push({
+                type: "function_call",
+                id: callId,
+                call_id: callId,
+                name: toolCall.function.name,
+                arguments: this.serializeToolArguments(toolCall.function.arguments),
+                status: "completed",
+            });
+        }
+    }
+    async *consumeResponsesStream(reader) {
+        const state = {
+            functionCallsByOutputIndex: new Map(),
+            hasFunctionCall: false,
+        };
+        let stopReason = "end_turn";
+        for await (const data of readSseDataLines(reader)) {
+            const result = this.parseResponsesStreamLine(data, state);
+            if (result.stopReason) {
+                stopReason = result.stopReason;
+            }
+            yield* result.events;
+        }
+        yield { type: "terminal", stopReason };
+    }
+    createChatCompletionRequestBody(request) {
+        return buildOpenAIChatCompletionRequestBody({
+            request,
+            model: this.model,
+            mapMessage: (msg) => this.chatMessageToOpenAIMessage(msg),
+            mapTool: (tool) => this.chatToolToOpenAITool(tool),
+        });
+    }
+    getResponseReader(response) {
+        return response.body?.getReader() ?? null;
+    }
+    async *consumeChatCompletionsStream(reader, toolCallsByIndex) {
+        yield* consumeOpenAiChatCompletionsStream(reader, toolCallsByIndex);
+    }
+    mapXaiResponsesStopReason(status, hasFunctionCall) {
+        if (hasFunctionCall) {
+            return "tool_use";
+        }
+        if (status === "incomplete") {
+            return "max_tokens";
+        }
+        if (status === "failed" || status === "cancelled") {
+            return "error";
+        }
+        return "end_turn";
+    }
+    buildResponsesToolCallsEvent(toolCall) {
+        const name = toolCall.name ?? "";
+        if (!name) {
+            return null;
+        }
+        const argsString = toolCall.arguments ?? toolCall.argsString ?? "";
+        const toolCalls = [
+            {
+                id: toolCall.call_id ?? toolCall.id,
+                function: {
+                    name,
+                    arguments: parseOpenAIStreamToolCallArguments(argsString),
+                },
+            },
+        ];
+        return { type: "tool_calls", toolCalls };
+    }
+    parseResponsesStreamLine(data, state) {
+        if (data === "[DONE]") {
+            return { events: [] };
+        }
+        const event = parseJsonMaybe(data);
+        if (!event?.type) {
+            return { events: [] };
+        }
+        return this.handleResponsesStreamEvent(event, state);
+    }
+    // fallow-ignore-next-line complexity
+    handleResponsesStreamEvent(event, state) {
+        switch (event.type) {
+            case "response.reasoning_summary_text.delta":
+            case "response.reasoning_text.delta":
+                return this.handleResponsesReasoningDelta(event);
+            case "response.output_text.delta":
+                return this.handleResponsesOutputTextDelta(event);
+            case "response.output_item.added":
+                return this.handleResponsesOutputItemAdded(event, state);
+            case "response.function_call_arguments.delta":
+                return this.handleResponsesFunctionCallArgumentsDelta(event, state);
+            case "response.output_item.done":
+                return this.handleResponsesOutputItemDone(event, state);
+            case "response.completed":
+            case "response.done":
+            case "response.incomplete":
+                return this.handleResponsesTerminalEvent(event, state);
+            case "response.failed":
+                return {
+                    events: [],
+                    stopReason: this.mapXaiResponsesStopReason("failed", false),
+                };
+            default:
+                return { events: [] };
+        }
+    }
+    handleResponsesReasoningDelta(event) {
+        if (!event.delta) {
+            return { events: [] };
+        }
+        return { events: [{ type: "thinking_delta", delta: event.delta }] };
+    }
+    handleResponsesOutputTextDelta(event) {
+        if (!event.delta) {
+            return { events: [] };
+        }
+        return { events: [{ type: "assistant_text", delta: event.delta }] };
+    }
+    handleResponsesOutputItemAdded(event, state) {
+        const item = event.item;
+        if (item?.type !== "function_call") {
+            return { events: [] };
+        }
+        const outputIndex = event.output_index ?? 0;
+        state.functionCallsByOutputIndex.set(outputIndex, {
+            id: item.call_id ?? item.id,
+            name: item.name ?? "",
+            argsString: item.arguments ?? "",
+        });
+        return { events: [] };
+    }
+    handleResponsesFunctionCallArgumentsDelta(event, state) {
+        const accumulated = state.functionCallsByOutputIndex.get(event.output_index ?? 0);
+        if (accumulated && event.delta) {
+            accumulated.argsString += event.delta;
+        }
+        return { events: [] };
+    }
+    // fallow-ignore-next-line complexity
+    handleResponsesOutputItemDone(event, state) {
+        const item = event.item;
+        if (item?.type !== "function_call") {
+            return { events: [] };
+        }
+        const outputIndex = event.output_index ?? 0;
+        const accumulated = state.functionCallsByOutputIndex.get(outputIndex);
+        const toolCallsEvent = this.buildResponsesToolCallsEvent({
+            id: item.id,
+            call_id: item.call_id ?? accumulated?.id,
+            name: item.name ?? accumulated?.name,
+            arguments: item.arguments ?? accumulated?.argsString,
+        });
+        state.functionCallsByOutputIndex.delete(outputIndex);
+        if (!toolCallsEvent) {
+            return { events: [] };
+        }
+        state.hasFunctionCall = true;
+        return { events: [toolCallsEvent] };
+    }
+    handleResponsesTerminalEvent(event, state) {
+        const status = event.type === "response.incomplete"
+            ? "incomplete"
+            : event.response?.status;
+        return {
+            events: [],
+            stopReason: this.mapXaiResponsesStopReason(status, state.hasFunctionCall),
+        };
+    }
+    translateError(error, response, _responseBody) {
+        return this.translateStandardOpenAiError(error, response, {
+            model: this.model,
+            authenticationMessage: "Invalid xAI API key",
+            rateLimitMessage: "xAI rate limit exceeded",
+            serviceErrorMessage: "xAI service error",
+            connectionErrorMessage: "Failed to connect to xAI API",
+            requestFailedMessage: "xAI request failed",
+        });
+    }
+}
+//# sourceMappingURL=xai.js.map

package/dist/providers/xai.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Tool result representation
+ */
+export interface ToolResult {
+    toolCallId: string;
+    toolName: string;
+    content: string;
+}
+/**
+ * Provider-agnostic message type
+ */
+export interface ChatMessage {
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+    /**
+     * Provider-specific reasoning state that some thinking models require to be
+     * replayed during tool-call loops. It is not rendered to users.
+     */
+    reasoningContent?: string;
+    toolCalls?: ChatToolCall[];
+    toolCallId?: string;
+    toolResults?: ToolResult[];
+    images?: (Uint8Array | string)[];
+}
+/**
+ * Tool call representation
+ */
+export interface ChatToolCall {
+    id?: string;
+    /**
+     * Gemini thought signature required for function-call rounds on Gemini 3.
+     * Other providers ignore this field.
+     */
+    thoughtSignature?: string;
+    function: {
+        name: string;
+        arguments: Record<string, any>;
+    };
+}
+/**
+ * Tool definition
+ */
+export interface ChatTool {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties?: Record<string, any>;
+            required?: string[];
+            [key: string]: any;
+        };
+    };
+}
+/**
+ * Chat request with all information needed for LLM request
+ */
+export interface ChatRequest {
+    messages: ChatMessage[];
+    model: string;
+    tools?: ChatTool[];
+    stream?: boolean;
+    signal?: AbortSignal;
+    iteration?: number;
+    /**
+     * Ask providers that support exposed reasoning to return live thinking
+     * tokens. Providers that do not support this should ignore it.
+     */
+    requestReasoning?: boolean;
+}
+/**
+ * Chat response from provider
+ */
+export interface ChatResponse {
+    message: ChatMessage;
+    stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
+}
+export type ProviderReasoningSummarySource = "provider" | "agent";
+export interface AssistantTextStreamEvent {
+    type: "assistant_text";
+    delta: string;
+}
+export interface ThinkingDeltaStreamEvent {
+    type: "thinking_delta";
+    delta: string;
+}
+export interface ToolCallsStreamEvent {
+    type: "tool_calls";
+    toolCalls: ChatToolCall[];
+    reasoningContent?: string;
+}
+export interface StatusStreamEvent {
+    type: "status";
+    status: string;
+    phase?: string;
+}
+export interface ReasoningSummaryStreamEvent {
+    type: "reasoning_summary";
+    summary: string;
+    source: ProviderReasoningSummarySource;
+}
+/**
+ * Normalized terminal event emitted when stream ends.
+ * Maps provider-specific stop reasons to a canonical set.
+ */
+export type StopReason = "end_turn" | "tool_use" | "max_tokens" | "stop_sequence" | "error";
+export interface StreamTerminalEvent {
+    type: "terminal";
+    stopReason: StopReason;
+    rawProviderReason?: string;
+}
+/**
+ * Backward-compatible streaming chunk shape.
+ * New implementations should emit ChatStreamEvent variants with a `type`.
+ */
+export interface ChatChunk {
+    delta: string;
+    toolCalls?: ChatToolCall[];
+}
+/**
+ * Streaming event model used across providers/agent runtime.
+ */
+export type ChatStreamEvent = AssistantTextStreamEvent | ThinkingDeltaStreamEvent | ToolCallsStreamEvent | StatusStreamEvent | ReasoningSummaryStreamEvent | StreamTerminalEvent | ChatChunk;
+/**
+ * Base provider error class
+ */
+export declare class ProviderError extends Error {
+    originalError?: Error;
+    constructor(message: string, originalError?: Error);
+}
+/**
+ * Authentication error
+ */
+export declare class ProviderAuthenticationError extends ProviderError {
+    constructor(message: string, originalError?: Error);
+}
+/**
+ * Rate limit error with optional retry info
+ */
+export declare class ProviderRateLimitError extends ProviderError {
+    retryAfterSeconds?: number;
+    constructor(message: string, retryAfterSeconds?: number, originalError?: Error);
+}
+/**
+ * Capacity error for upstream resource exhaustion (e.g., OpenRouter 529)
+ */
+export declare class ProviderCapacityError extends ProviderError {
+    constructor(message: string, originalError?: Error);
+}
+/**
+ * Model not found error
+ */
+export declare class ProviderModelNotFoundError extends ProviderError {
+    modelName: string;
+    constructor(modelName: string, message: string, originalError?: Error);
+}
+/**
+ * Context length exceeded error. Thrown when the prompt exceeds the model's
+ * context window. The agent loop uses this signal to rebuild the prompt at
+ * a tighter retry level instead of surfacing the error to the user.
+ */
+export declare class ProviderContextLengthError extends ProviderError {
+    constructor(message: string, originalError?: Error);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,60 @@
+/**
+ * Base provider error class
+ */
+export class ProviderError extends Error {
+    constructor(message, originalError) {
+        super(message);
+        this.name = "ProviderError";
+        this.originalError = originalError;
+    }
+}
+/**
+ * Authentication error
+ */
+export class ProviderAuthenticationError extends ProviderError {
+    constructor(message, originalError) {
+        super(message, originalError);
+        this.name = "ProviderAuthenticationError";
+    }
+}
+/**
+ * Rate limit error with optional retry info
+ */
+export class ProviderRateLimitError extends ProviderError {
+    constructor(message, retryAfterSeconds, originalError) {
+        super(message, originalError);
+        this.name = "ProviderRateLimitError";
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+/**
+ * Capacity error for upstream resource exhaustion (e.g., OpenRouter 529)
+ */
+export class ProviderCapacityError extends ProviderError {
+    constructor(message, originalError) {
+        super(message, originalError);
+        this.name = "ProviderCapacityError";
+    }
+}
+/**
+ * Model not found error
+ */
+export class ProviderModelNotFoundError extends ProviderError {
+    constructor(modelName, message, originalError) {
+        super(message, originalError);
+        this.name = "ProviderModelNotFoundError";
+        this.modelName = modelName;
+    }
+}
+/**
+ * Context length exceeded error. Thrown when the prompt exceeds the model's
+ * context window. The agent loop uses this signal to rebuild the prompt at
+ * a tighter retry level instead of surfacing the error to the user.
+ */
+export class ProviderContextLengthError extends ProviderError {
+    constructor(message, originalError) {
+        super(message, originalError);
+        this.name = "ProviderContextLengthError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwJA;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGtC,YAAY,OAAe,EAAE,aAAqB;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,aAAa;IAC5D,YAAY,OAAe,EAAE,aAAqB;QAChD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IAGvD,YACE,OAAe,EACf,iBAA0B,EAC1B,aAAqB;QAErB,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAY,OAAe,EAAE,aAAqB;QAChD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,aAAa;IAG3D,YAAY,SAAiB,EAAE,OAAe,EAAE,aAAqB;QACnE,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,0BAA2B,SAAQ,aAAa;IAC3D,YAAY,OAAe,EAAE,aAAqB;QAChD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF"}