@gitkraken/core-gitlens 0.6.0 → 0.7.0

package/dist/plus/ai/providers/openAICompatibleProvider.js

@@ -1,51 +1,51 @@
-import { openAICompatibleProviderDescriptor as provider } from '../constants.js';
-import { openAIModels } from '../models/model.js';
-import { isAzureUrl } from '../utils/ai.utils.js';
-import { OpenAICompatibleProviderBase } from './openAICompatibleProviderBase.js';
-const models = openAIModels(provider);
-export class OpenAICompatibleProvider extends OpenAICompatibleProviderBase {
-    id = provider.id;
-    name = provider.name;
-    descriptor = provider;
-    config = {
-        keyUrl: undefined,
-        keyValidator: /(?:sk-)?[a-zA-Z0-9]{32,}/,
-    };
-    getModels() {
-        return Promise.resolve(models);
-    }
-    getUrl(_model) {
-        const cfg = this.context.getProviderConfig(this.id);
-        if (!cfg.enabled)
-            return undefined;
-        return cfg.url || undefined;
-    }
-    // Unknown user-configured backend — fall back to prompt-described JSON
-    supportsResponseFormat(_model) {
-        return false;
-    }
-    async getOrPromptBaseUrl(silent, hasApiKey) {
-        const orgConf = this.context.getProviderConfig(this.id);
-        if (!orgConf.enabled)
-            return undefined;
-        if (orgConf.url)
-            return orgConf.url;
-        const url = this.getUrl();
-        if (silent || (url != null && hasApiKey))
-            return url;
-        return this.context.getOrPromptUrl(this.id, {
-            currentUrl: url,
-            title: 'Connect to OpenAI-Compatible Provider',
-            placeholder: `Please enter your provider's URL to use this feature`,
-            validator: u => (isAzureUrl(u) ? 'Use the Azure OpenAI provider instead' : undefined),
-        }, silent);
-    }
-    async configured(silent) {
-        const hasApiKey = await super.configured(true);
-        const url = await this.getOrPromptBaseUrl(silent, hasApiKey);
-        if (!url || isAzureUrl(url))
-            return false;
-        return silent ? hasApiKey : super.configured(silent);
-    }
-}
+import { openAICompatibleProviderDescriptor } from "../constants.js";
+import { openAIModels } from "../models/model.js";
+import { isAzureUrl } from "../utils/ai.utils.js";
+import { OpenAICompatibleProviderBase } from "./openAICompatibleProviderBase.js";
+import * as l10n from "@vscode/l10n";
+//#region ../plus/ai/src/providers/openAICompatibleProvider.ts
+const models = openAIModels(openAICompatibleProviderDescriptor);
+var OpenAICompatibleProvider = class extends OpenAICompatibleProviderBase {
+	id = openAICompatibleProviderDescriptor.id;
+	name = openAICompatibleProviderDescriptor.name;
+	descriptor = openAICompatibleProviderDescriptor;
+	config = {
+		keyUrl: void 0,
+		keyValidator: /(?:sk-)?[a-zA-Z0-9]{32,}/
+	};
+	getModels() {
+		return Promise.resolve(models);
+	}
+	getUrl(_model) {
+		const cfg = this.context.getProviderConfig(this.id);
+		if (!cfg.enabled) return void 0;
+		return cfg.url || void 0;
+	}
+	supportsResponseFormat(_model) {
+		return false;
+	}
+	async getOrPromptBaseUrl(silent, hasApiKey) {
+		const orgConf = this.context.getProviderConfig(this.id);
+		if (!orgConf.enabled) return void 0;
+		if (orgConf.url) return orgConf.url;
+		const url = this.getUrl();
+		if (silent || url != null && hasApiKey) return url;
+		return this.context.getOrPromptUrl(this.id, {
+			currentUrl: url,
+			title: l10n.t("Connect to OpenAI-Compatible Provider"),
+			placeholder: l10n.t("Please enter your provider's URL to use this feature"),
+			prompt: l10n.t("Enter your OpenAI-Compatible Provider URL"),
+			validator: (u) => isAzureUrl(u) ? l10n.t("Use the Azure OpenAI provider instead") : void 0
+		}, silent);
+	}
+	async configured(silent) {
+		const hasApiKey = await super.configured(true);
+		const url = await this.getOrPromptBaseUrl(silent, hasApiKey);
+		if (!url || isAzureUrl(url)) return false;
+		return silent ? hasApiKey : super.configured(silent);
+	}
+};
+//#endregion
+export { OpenAICompatibleProvider };
+
 //# sourceMappingURL=openAICompatibleProvider.js.map

package/dist/plus/ai/providers/openAICompatibleProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"openAICompatibleProvider.js","sourceRoot":"","sources":["../../../../src/plus/ai/providers/openAICompatibleProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kCAAkC,IAAI,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAGjF,MAAM,MAAM,GAA4B,YAAY,CAAC,QAAQ,CAAC,CAAC;AAE/D,MAAM,OAAO,wBAAyB,SAAQ,4BAAgD;IACpF,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC;IACjB,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IACX,UAAU,GAAG,QAAQ,CAAC;IACtB,MAAM,GAAG;QAC3B,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,0BAA0B;KACxC,CAAC;IAEF,SAAS;QACR,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAES,MAAM,CAAC,MAAoC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAEnC,OAAO,GAAG,CAAC,GAAG,IAAI,SAAS,CAAC;IAC7B,CAAC;IAED,uEAAuE;IACpD,sBAAsB,CAAC,MAAmC;QAC5E,OAAO,KAAK,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,MAAe,EAAE,SAAkB;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QACvC,IAAI,OAAO,CAAC,GAAG;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC;QAEpC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAE1B,IAAI,MAAM,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,SAAS,CAAC;YAAE,OAAO,GAAG,CAAC;QAErD,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CACjC,IAAI,CAAC,EAAE,EACP;YACC,UAAU,EAAE,GAAG;YACf,KAAK,EAAE,uCAAuC;YAC9C,WAAW,EAAE,sDAAsD;YACnE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,SAAS,CAAC;SACrF,EACD,MAAM,CACN,CAAC;IACH,CAAC;IAEQ,KAAK,CAAC,UAAU,CAAC,MAAe;QACxC,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAE/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7D,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAE1C,OAAO,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;CACD"}
+{"version":3,"file":"openAICompatibleProvider.js","names":["provider"],"sources":["../../../../../plus/ai/src/providers/openAICompatibleProvider.ts"],"sourcesContent":["import * as l10n from '@vscode/l10n';\nimport { openAICompatibleProviderDescriptor as provider } from '../constants.js';\nimport type { AIModel } from '../models/model.js';\nimport { openAIModels } from '../models/model.js';\nimport { isAzureUrl } from '../utils/ai.utils.js';\nimport { OpenAICompatibleProviderBase } from './openAICompatibleProviderBase.js';\n\ntype OpenAICompatibleModel = AIModel<typeof provider.id>;\nconst models: OpenAICompatibleModel[] = openAIModels(provider);\n\nexport class OpenAICompatibleProvider extends OpenAICompatibleProviderBase<typeof provider.id> {\n\treadonly id = provider.id;\n\treadonly name = provider.name;\n\tprotected readonly descriptor = provider;\n\tprotected readonly config = {\n\t\tkeyUrl: undefined,\n\t\tkeyValidator: /(?:sk-)?[a-zA-Z0-9]{32,}/,\n\t};\n\n\tgetModels(): Promise<readonly AIModel<typeof provider.id>[]> {\n\t\treturn Promise.resolve(models);\n\t}\n\n\tprotected getUrl(_model?: AIModel<typeof provider.id>): string | undefined {\n\t\tconst cfg = this.context.getProviderConfig(this.id);\n\t\tif (!cfg.enabled) return undefined;\n\n\t\treturn cfg.url || undefined;\n\t}\n\n\t// Unknown user-configured backend — fall back to prompt-described JSON\n\tprotected override supportsResponseFormat(_model: AIModel<typeof provider.id>): boolean {\n\t\treturn false;\n\t}\n\n\tprivate async getOrPromptBaseUrl(silent: boolean, hasApiKey: boolean): Promise<string | undefined> {\n\t\tconst orgConf = this.context.getProviderConfig(this.id);\n\t\tif (!orgConf.enabled) return undefined;\n\t\tif (orgConf.url) return orgConf.url;\n\n\t\tconst url = this.getUrl();\n\n\t\tif (silent || (url != null && hasApiKey)) return url;\n\n\t\treturn this.context.getOrPromptUrl(\n\t\t\tthis.id,\n\t\t\t{\n\t\t\t\tcurrentUrl: url,\n\t\t\t\ttitle: l10n.t('Connect to OpenAI-Compatible Provider'),\n\t\t\t\tplaceholder: l10n.t(\"Please enter your provider's URL to use this feature\"),\n\t\t\t\tprompt: l10n.t('Enter your OpenAI-Compatible Provider URL'),\n\t\t\t\tvalidator: u => (isAzureUrl(u) ? l10n.t('Use the Azure OpenAI provider instead') : undefined),\n\t\t\t},\n\t\t\tsilent,\n\t\t);\n\t}\n\n\toverride async configured(silent: boolean): Promise<boolean> {\n\t\tconst hasApiKey = await super.configured(true);\n\n\t\tconst url = await this.getOrPromptBaseUrl(silent, hasApiKey);\n\t\tif (!url || isAzureUrl(url)) return false;\n\n\t\treturn silent ? hasApiKey : super.configured(silent);\n\t}\n}\n"],"mappings":";;;;;;AAQA,MAAM,SAAkC,aAAaA,kCAAQ;AAE7D,IAAa,2BAAb,cAA8C,6BAAiD;CAC9F,KAAcA,mCAAS;CACvB,OAAgBA,mCAAS;CACzB,aAAgCA;CAChC,SAA4B;EAC3B,QAAQ,KAAA;EACR,cAAc;CACf;CAEA,YAA6D;EAC5D,OAAO,QAAQ,QAAQ,MAAM;CAC9B;CAEA,OAAiB,QAA0D;EAC1E,MAAM,MAAM,KAAK,QAAQ,kBAAkB,KAAK,EAAE;EAClD,IAAI,CAAC,IAAI,SAAS,OAAO,KAAA;EAEzB,OAAO,IAAI,OAAO,KAAA;CACnB;CAGA,uBAA0C,QAA8C;EACvF,OAAO;CACR;CAEA,MAAc,mBAAmB,QAAiB,WAAiD;EAClG,MAAM,UAAU,KAAK,QAAQ,kBAAkB,KAAK,EAAE;EACtD,IAAI,CAAC,QAAQ,SAAS,OAAO,KAAA;EAC7B,IAAI,QAAQ,KAAK,OAAO,QAAQ;EAEhC,MAAM,MAAM,KAAK,OAAO;EAExB,IAAI,UAAW,OAAO,QAAQ,WAAY,OAAO;EAEjD,OAAO,KAAK,QAAQ,eACnB,KAAK,IACL;GACC,YAAY;GACZ,OAAO,KAAK,EAAE,uCAAuC;GACrD,aAAa,KAAK,EAAE,sDAAsD;GAC1E,QAAQ,KAAK,EAAE,2CAA2C;GAC1D,YAAW,MAAM,WAAW,CAAC,IAAI,KAAK,EAAE,uCAAuC,IAAI,KAAA;EACpF,GACA,MACD;CACD;CAEA,MAAe,WAAW,QAAmC;EAC5D,MAAM,YAAY,MAAM,MAAM,WAAW,IAAI;EAE7C,MAAM,MAAM,MAAM,KAAK,mBAAmB,QAAQ,SAAS;EAC3D,IAAI,CAAC,OAAO,WAAW,GAAG,GAAG,OAAO;EAEpC,OAAO,SAAS,YAAY,MAAM,WAAW,MAAM;CACpD;AACD"}

package/dist/plus/ai/providers/openAICompatibleProviderBase.d.ts

@@ -1,198 +1,200 @@
-import type { AIProviders } from '../constants.js';
-import type { AIActionType, AIModel, AIProviderDescriptor } from '../models/model.js';
-import type { AIChatMessage, AIChatMessageRole, AIFinishReason, AIProvider, AIProviderResponse, AIResponseFormat, AIToolCall, AIToolDefinition, JSONSchema } from '../models/provider.js';
-import type { AIProviderContext } from './context.js';
+import { AIActionType, AIModel, AIProviderDescriptor } from "../models/model.js";
+import { AIProviders } from "../constants.js";
+import { AIChatMessage, AIChatMessageRole, AIFinishReason, AIProvider, AIProviderResponse, AIResponseFormat, AIToolCall, AIToolDefinition, JSONSchema } from "../models/provider.js";
+import { AIProviderContext } from "./context.js";
+//#region ../plus/ai/src/providers/openAICompatibleProviderBase.d.ts
 export declare abstract class OpenAICompatibleProviderBase<T extends AIProviders> implements AIProvider<T> {
-    protected readonly context: AIProviderContext;
-    constructor(context: AIProviderContext);
-    dispose(): void;
-    [Symbol.dispose](): void;
-    abstract readonly id: T;
-    abstract readonly name: string;
-    protected abstract readonly descriptor: AIProviderDescriptor<T>;
-    protected abstract readonly config: {
-        keyUrl?: string;
-        keyValidator?: RegExp;
+  protected readonly context: AIProviderContext;
+  constructor(context: AIProviderContext);
+  dispose(): void;
+  [Symbol.dispose](): void;
+  abstract readonly id: T;
+  abstract readonly name: string;
+  protected abstract readonly descriptor: AIProviderDescriptor<T>;
+  protected abstract readonly config: {
+    keyUrl?: string;
+    keyValidator?: RegExp;
+  };
+  configured(silent: boolean): Promise<boolean>;
+  getApiKey(silent: boolean): Promise<string | undefined>;
+  abstract getModels(): Promise<readonly AIModel<T>[]>;
+  protected isResponseFormatSessionRejected(model: AIModel<T>, responseFormat: AIResponseFormat): boolean;
+  protected rememberResponseFormatRejection(model: AIModel<T>, responseFormat: AIResponseFormat): void;
+  protected abstract getUrl(_model: AIModel<T>): string | undefined;
+  protected getHeaders<TAction extends AIActionType>(_action: TAction, apiKey: string, _model: AIModel<T>, _url: string, _conversationId?: string): Record<string, string> | Promise<Record<string, string>>;
+  sendRequest<TAction extends AIActionType>(action: TAction, model: AIModel<T>, apiKey: string, getMessages: (maxInputTokens: number, retries: number) => Promise<AIChatMessage<AIChatMessageRole>[]>, options: {
+    signal: AbortSignal;
+    modelOptions?: {
+      outputTokens?: number;
+      temperature?: number;
     };
-    configured(silent: boolean): Promise<boolean>;
-    getApiKey(silent: boolean): Promise<string | undefined>;
-    abstract getModels(): Promise<readonly AIModel<T>[]>;
-    protected isResponseFormatSessionRejected(model: AIModel<T>, responseFormat: AIResponseFormat): boolean;
-    protected rememberResponseFormatRejection(model: AIModel<T>, responseFormat: AIResponseFormat): void;
-    protected abstract getUrl(_model: AIModel<T>): string | undefined;
-    protected getHeaders<TAction extends AIActionType>(_action: TAction, apiKey: string, _model: AIModel<T>, _url: string, _conversationId?: string): Record<string, string> | Promise<Record<string, string>>;
-    sendRequest<TAction extends AIActionType>(action: TAction, model: AIModel<T>, apiKey: string, getMessages: (maxInputTokens: number, retries: number) => Promise<AIChatMessage<AIChatMessageRole>[]>, options: {
-        signal: AbortSignal;
-        modelOptions?: {
-            outputTokens?: number;
-            temperature?: number;
-        };
-        conversationId?: string;
-        responseFormat?: AIResponseFormat;
-        tools?: readonly AIToolDefinition[];
-    }): Promise<AIProviderResponse<void> | undefined>;
-    protected fetch<TAction extends AIActionType>(action: TAction, model: AIModel<T>, apiKey: string, messages: (maxInputTokens: number, retries: number) => Promise<AIChatMessage<AIChatMessageRole>[]>, modelOptions?: {
-        outputTokens?: number;
-        temperature?: number;
-    }, responseFormat?: AIResponseFormat, signal?: AbortSignal, conversationId?: string, tools?: readonly AIToolDefinition[]): Promise<AIProviderResponse<void>>;
-    /**
-     * Returns the message-related request fields. The default sends every message inline (OpenAI
-     * Chat Completions semantics); providers whose API carries the initial system prompt separately
-     * (e.g. Anthropic's top-level `system`) override this to extract it from the messages.
-     */
-    protected extractSystemPrompt(messages: AIChatMessage<AIChatMessageRole>[]): {
-        messages: AIChatMessage<AIChatMessageRole>[];
-        system?: string;
-    };
-    /** Whether the given model accepts a native response-format/schema field; when false the
-     *  prompt's JSON description is the only format control (the request is unchanged).
-     *  Dynamic-catalog providers (GitKraken, OpenRouter) populate
-     *  {@link AIModel.supportsStructuredOutputs}; static providers override with id-based gates */
-    protected supportsResponseFormat(model: AIModel<T>): boolean;
-    /**
-     * Whether a failed response reads as a rejection of the `tools` field rather than a problem with the
-     * prompt — the trigger for one retry without tools, so a tool-using feature degrades to single-shot
-     * instead of failing outright.
-     *
-     * Providers that wrap upstream rejections in their own envelope (e.g. GitKraken) must override this:
-     * the wrapper's prose names neither "tool" nor "function", so the text match here cannot see through
-     * it and the fallback would never fire.
-     */
-    protected isToolsRejection(status: number, message: string | undefined): boolean;
-    /** Whether a failed response means the native response format itself was rejected — the
-     *  trigger for stripping it and retrying via the prompt-described JSON. Providers that wrap
-     *  upstream rejections in their own envelope (e.g. GitKraken) extend this */
-    protected isResponseFormatRejection(status: number, body: string): boolean;
-    /** Translates the canonical response format onto the request; called only when
-     *  {@link supportsResponseFormat} allows it. Base emits the OpenAI `response_format.json_schema`
-     *  envelope. Overrides must REPLACE this for providers with a different native field
-     *  (e.g. Anthropic `output_config`) — never leave both on the request. */
-    protected applyResponseFormat(request: ChatCompletionRequest, _model: AIModel<T>, responseFormat: AIResponseFormat): void;
-    protected extractContent(data: ChatCompletionResponse): string;
-    /** Normalizes abnormal completion signals (all arrive as HTTP 200) so consumers can
-     *  distinguish truncated/filtered/refused output from a malformed-but-complete reply */
-    protected extractFinishReason(data: ChatCompletionResponse): AIFinishReason | undefined;
-    /**
-     * Maps messages onto the provider's wire shape. The default is OpenAI Chat Completions: assistant
-     * tool calls go in `tool_calls` with `arguments` JSON-stringified, and tool results are `tool`-role
-     * entries keyed by `tool_call_id`. Providers with a different tool encoding (e.g. Anthropic's
-     * content blocks) override this.
-     */
-    protected serializeMessages(messages: AIChatMessage<AIChatMessageRole>[]): unknown[];
-    /** Returns the tool-related request fields. The default is the OpenAI `function` envelope. */
-    protected serializeTools(tools: readonly AIToolDefinition[]): {
-        tools: unknown[];
-    };
-    /**
-     * Extracts tool calls from a response, handling both the OpenAI shape
-     * (`choices[].message.tool_calls`, whose `arguments` is a JSON string) and the Anthropic shape
-     * (`content[]` blocks of type `tool_use`) — mirroring how {@link fetch} already reads content
-     * from both.
-     */
-    protected parseToolCalls(data: ChatCompletionResponse): AIToolCall[] | undefined;
-    protected handleFetchFailure<TAction extends AIActionType>(rsp: Response, _action: TAction, model: AIModel<T>, retries: number, maxInputTokens: number, 
-    /** The already-read error body, when the caller had to read it (avoids a second decode) */
-    body?: string, sentTools?: boolean): Promise<{
-        retry: true;
-        maxInputTokens: number;
-        withoutTools?: boolean;
-    }>;
-    protected fetchCore<TAction extends AIActionType>(action: TAction, model: AIModel<T>, apiKey: string, request: object, signal: AbortSignal | undefined, conversationId?: string): Promise<Response>;
+    conversationId?: string;
+    responseFormat?: AIResponseFormat;
+    tools?: readonly AIToolDefinition[];
+  }): Promise<AIProviderResponse<void> | undefined>;
+  protected fetch<TAction extends AIActionType>(action: TAction, model: AIModel<T>, apiKey: string, messages: (maxInputTokens: number, retries: number) => Promise<AIChatMessage<AIChatMessageRole>[]>, modelOptions?: {
+    outputTokens?: number;
+    temperature?: number;
+  }, responseFormat?: AIResponseFormat, signal?: AbortSignal, conversationId?: string, tools?: readonly AIToolDefinition[]): Promise<AIProviderResponse<void>>;
+  /**
+   * Returns the message-related request fields. The default sends every message inline (OpenAI
+   * Chat Completions semantics); providers whose API carries the initial system prompt separately
+   * (e.g. Anthropic's top-level `system`) override this to extract it from the messages.
+   */
+  protected extractSystemPrompt(messages: AIChatMessage<AIChatMessageRole>[]): {
+    messages: AIChatMessage<AIChatMessageRole>[];
+    system?: string;
+  };
+  /** Whether the given model accepts a native response-format/schema field; when false the
+   *  prompt's JSON description is the only format control (the request is unchanged).
+   *  Dynamic-catalog providers (GitKraken, OpenRouter) populate
+   *  {@link AIModel.supportsStructuredOutputs}; static providers override with id-based gates */
+  protected supportsResponseFormat(model: AIModel<T>): boolean;
+  /**
+   * Whether a failed response reads as a rejection of the `tools` field rather than a problem with the
+   * prompt — the trigger for one retry without tools, so a tool-using feature degrades to single-shot
+   * instead of failing outright.
+   *
+   * Providers that wrap upstream rejections in their own envelope (e.g. GitKraken) must override this:
+   * the wrapper's prose names neither "tool" nor "function", so the text match here cannot see through
+   * it and the fallback would never fire.
+   */
+  protected isToolsRejection(status: number, message: string | undefined): boolean;
+  /** Whether a failed response means the native response format itself was rejected — the
+   *  trigger for stripping it and retrying via the prompt-described JSON. Providers that wrap
+   *  upstream rejections in their own envelope (e.g. GitKraken) extend this */
+  protected isResponseFormatRejection(status: number, body: string): boolean;
+  /** Translates the canonical response format onto the request; called only when
+   *  {@link supportsResponseFormat} allows it. Base emits the OpenAI `response_format.json_schema`
+   *  envelope. Overrides must REPLACE this for providers with a different native field
+   *  (e.g. Anthropic `output_config`) — never leave both on the request. */
+  protected applyResponseFormat(request: ChatCompletionRequest, _model: AIModel<T>, responseFormat: AIResponseFormat): void;
+  protected extractContent(data: ChatCompletionResponse): string;
+  /** Normalizes abnormal completion signals (all arrive as HTTP 200) so consumers can
+   *  distinguish truncated/filtered/refused output from a malformed-but-complete reply */
+  protected extractFinishReason(data: ChatCompletionResponse): AIFinishReason | undefined;
+  /**
+   * Maps messages onto the provider's wire shape. The default is OpenAI Chat Completions: assistant
+   * tool calls go in `tool_calls` with `arguments` JSON-stringified, and tool results are `tool`-role
+   * entries keyed by `tool_call_id`. Providers with a different tool encoding (e.g. Anthropic's
+   * content blocks) override this.
+   */
+  protected serializeMessages(messages: AIChatMessage<AIChatMessageRole>[]): unknown[];
+  /** Returns the tool-related request fields. The default is the OpenAI `function` envelope. */
+  protected serializeTools(tools: readonly AIToolDefinition[]): {
+    tools: unknown[];
+  };
+  /**
+   * Extracts tool calls from a response, handling both the OpenAI shape
+   * (`choices[].message.tool_calls`, whose `arguments` is a JSON string) and the Anthropic shape
+   * (`content[]` blocks of type `tool_use`) — mirroring how {@link fetch} already reads content
+   * from both.
+   */
+  protected parseToolCalls(data: ChatCompletionResponse): AIToolCall[] | undefined;
+  protected handleFetchFailure<TAction extends AIActionType>(rsp: Response, _action: TAction, model: AIModel<T>, retries: number, maxInputTokens: number,
+  /** The already-read error body, when the caller had to read it (avoids a second decode) */
+  body?: string, sentTools?: boolean): Promise<{
+    retry: true;
+    maxInputTokens: number;
+    withoutTools?: boolean;
+  }>;
+  protected fetchCore<TAction extends AIActionType>(action: TAction, model: AIModel<T>, apiKey: string, request: object, signal: AbortSignal | undefined, conversationId?: string): Promise<Response>;
 }
 export interface ChatCompletionRequest {
-    model: string;
-    /** Provider-shaped messages from {@link OpenAICompatibleProviderBase.serializeMessages} */
-    messages: unknown[];
-    /** Anthropic carries the initial system prompt here instead of as a `system`-role message */
-    system?: string;
-    /** Tool definitions, shaped by {@link OpenAICompatibleProviderBase.serializeTools} */
-    tools?: unknown[];
-    /** @deprecated but used by Anthropic & Gemini */
-    max_tokens?: number;
-    /** Currently can't be used for Anthropic & Gemini */
-    max_completion_tokens?: number;
-    metadata?: Record<string, string>;
-    stream?: boolean;
-    temperature?: number;
-    top_p?: number;
-    /** Not supported by many models/providers */
-    reasoning_effort?: 'low' | 'medium' | 'high';
-    /** OpenAI-compatible structured output (set via {@link OpenAICompatibleProviderBase.applyResponseFormat}) */
-    response_format?: {
-        type: 'json_schema';
-        json_schema: {
-            name: string;
-            strict: boolean;
-            schema: JSONSchema;
-        };
-    };
-    /** Anthropic-native structured output (set only by the Anthropic override) */
-    output_config?: {
-        format: {
-            type: 'json_schema';
-            schema: JSONSchema;
-        };
+  model: string;
+  /** Provider-shaped messages from {@link OpenAICompatibleProviderBase.serializeMessages} */
+  messages: unknown[];
+  /** Anthropic carries the initial system prompt here instead of as a `system`-role message */
+  system?: string;
+  /** Tool definitions, shaped by {@link OpenAICompatibleProviderBase.serializeTools} */
+  tools?: unknown[];
+  /** @deprecated but used by Anthropic & Gemini */
+  max_tokens?: number;
+  /** Currently can't be used for Anthropic & Gemini */
+  max_completion_tokens?: number;
+  metadata?: Record<string, string>;
+  stream?: boolean;
+  temperature?: number;
+  top_p?: number;
+  /** Not supported by many models/providers */
+  reasoning_effort?: 'low' | 'medium' | 'high';
+  /** OpenAI-compatible structured output (set via {@link OpenAICompatibleProviderBase.applyResponseFormat}) */
+  response_format?: {
+    type: 'json_schema';
+    json_schema: {
+      name: string;
+      strict: boolean;
+      schema: JSONSchema;
     };
-    /** OpenRouter-only routing constraint (set only by the OpenRouter override) */
-    provider?: {
-        require_parameters: boolean;
+  };
+  /** Anthropic-native structured output (set only by the Anthropic override) */
+  output_config?: {
+    format: {
+      type: 'json_schema';
+      schema: JSONSchema;
     };
+  };
+  /** OpenRouter-only routing constraint (set only by the OpenRouter override) */
+  provider?: {
+    require_parameters: boolean;
+  };
 }
 export interface ChatCompletionResponse {
-    id: string;
-    model: string;
-    /** OpenAI compatible output */
-    choices?: {
-        index: number;
-        message: {
-            role: string;
-            content: string | null;
-            /** OpenAI-only; most OpenAI-compatible servers omit it entirely */
-            refusal?: string | null;
-            tool_calls?: {
-                id: string;
-                type: string;
-                function: {
-                    name: string;
-                    arguments: string;
-                };
-                /** GitKraken proxy only — an opaque provider reasoning token to round-trip */
-                thought_signature?: string;
-            }[];
-        };
-        finish_reason: string;
-    }[];
-    /** Anthropic output (non-text blocks, e.g. thinking, carry no text). `tool_use` blocks add the
-     *  call fields, which is why `id`/`name` are optional here — {@link parseToolCalls} narrows on
-     *  `type` and then checks them. */
-    content?: {
+  id: string;
+  model: string;
+  /** OpenAI compatible output */
+  choices?: {
+    index: number;
+    message: {
+      role: string;
+      content: string | null;
+      /** OpenAI-only; most OpenAI-compatible servers omit it entirely */
+      refusal?: string | null;
+      tool_calls?: {
+        id: string;
         type: string;
-        text?: string;
-        id?: string;
-        name?: string;
-        input?: Record<string, unknown>;
-    }[];
-    /** Error envelope some providers/proxies return with an OK status (e.g. OpenRouter upstream failures) */
-    error?: {
-        message?: string;
-        code?: number | string;
-    } | null;
-    /** Anthropic stop reason */
-    stop_reason?: string;
-    usage: {
-        /** OpenAI compatible */
-        prompt_tokens?: number;
-        completion_tokens?: number;
-        total_tokens?: number;
-        /** Anthropic */
-        input_tokens?: number;
-        output_tokens?: number;
-        /** GitKraken */
-        gk: {
-            used: number;
-            limit: number;
-            resets_on: string;
+        function: {
+          name: string;
+          arguments: string;
         };
+        /** GitKraken proxy only — an opaque provider reasoning token to round-trip */
+        thought_signature?: string;
+      }[];
+    };
+    finish_reason: string;
+  }[];
+  /** Anthropic output (non-text blocks, e.g. thinking, carry no text). `tool_use` blocks add the
+   *  call fields, which is why `id`/`name` are optional here — {@link parseToolCalls} narrows on
+   *  `type` and then checks them. */
+  content?: {
+    type: string;
+    text?: string;
+    id?: string;
+    name?: string;
+    input?: Record<string, unknown>;
+  }[];
+  /** Error envelope some providers/proxies return with an OK status (e.g. OpenRouter upstream failures) */
+  error?: {
+    message?: string;
+    code?: number | string;
+  } | null;
+  /** Anthropic stop reason */
+  stop_reason?: string;
+  usage: {
+    /** OpenAI compatible */
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    /** Anthropic */
+    input_tokens?: number;
+    output_tokens?: number;
+    /** GitKraken */
+    gk: {
+      used: number;
+      limit: number;
+      resets_on: string;
     };
+  };
 }
+//#endregion
 //# sourceMappingURL=openAICompatibleProviderBase.d.ts.map