@morlay/dsh-llm-openai-compatible 0.0.1

package/lib/index.d.mts

@@ -0,0 +1,89 @@
+import { DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_REQUEST_IMAGE_BYTES, DEFAULT_MAX_TOKENS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, OpenAICompatibleAdapter, OpenAICompatibleAdapterOptions, ReasoningEffort, ResolvedModelProfile, ResolvedProviderProfile } from "./adapter.mjs";
+import z from "@deepseek-ai/schemastery";
+import { ModelModality, RetryPolicyConfig } from "@deepseek-ai/dsh-llm";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/index.d.ts
+declare const name = "llm-openai-compatible";
+declare const inject: string[];
+declare const NS: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+/** Selectable reasoning levels a profile or model may declare. */
+declare const REASONING_LEVELS: readonly ["off", "low", "high", "max"];
+/** Accepted model input modalities. */
+declare const MODEL_MODALITIES: readonly ["text", "image"];
+/** Source shape of one model catalog entry. */
+interface ModelProfileSource {
+  id: string;
+  name?: string;
+  description?: string;
+  contextWindow?: number;
+  maxTokens?: number;
+  inputModalities?: ModelModality[];
+  reasoningEfforts?: false | Partial<Record<ReasoningEffort, string | null>>;
+}
+/** Source shape of one provider route profile; the `providers` dict key IS the route. */
+interface ProviderProfileSource {
+  /** Credential reference (environment-variable name); absence sends no authorization header. */
+  apiKeyEnv?: string;
+  /** Name shown by configuration surfaces; defaults to the route key. */
+  displayName?: string;
+  /** Required endpoint base; requests hit `${baseURL}/chat/completions`. */
+  baseURL: string;
+  /** Extra request headers, merged under the mandatory attribution headers. */
+  headers?: Record<string, string>;
+  temperature?: number;
+  topP?: number;
+  topK?: number;
+  presencePenalty?: number;
+  frequencyPenalty?: number;
+  seed?: number;
+  /** Deployment default reasoning level; omission keeps the provider default. */
+  reasoning?: ReasoningEffort;
+  /** This route's model catalog; omission serves an empty catalog (unlisted ids pass through). */
+  models?: ModelProfileSource[];
+  defaultContextWindow?: number;
+  defaultMaxTokens?: number;
+  maxRequestImageBytes?: number;
+  streamIdleTimeoutMs?: number;
+  /** Whole-request deadline in milliseconds; unset arms no overall timer. */
+  timeoutMs?: number;
+  retryPolicy?: RetryPolicyConfig;
+}
+/** Plugin configuration: the provider routes this instance owns. */
+interface Config {
+  /** Provider routes, keyed by route. An empty (or omitted) dict is the dormant posture. */
+  providers?: Record<string, ProviderProfileSource>;
+}
+/** Runtime schema for {@link Config}. */
+declare const Config: z<Config>;
+/**
+ * The one explicit resolve step from a raw profile to validated connection
+ * facts. Programmatic construction may bypass Schemastery normalization, so
+ * every default and bound is re-judged here — for the composition entry at
+ * load (fail loud) and for each settings snapshot at its first use.
+ * @param provider - the route key owning this profile.
+ * @param source - raw profile from config or a resolved settings snapshot.
+ * @returns validated connection facts plus the credential reference.
+ */
+declare function resolveAdapterOptions(provider: string, source: ProviderProfileSource): ResolvedProviderProfile;
+/**
+ * Validate profiles and return a detached route-keyed map suitable for
+ * per-request reads. This is the one explicit resolve step, so an omitted dict
+ * resolves to the empty (dormant) route set here rather than through a hidden
+ * fallback.
+ * @param providers - configured provider profiles keyed by route.
+ * @returns validated profiles in configuration order.
+ */
+declare function resolveProfiles(providers: Readonly<Record<string, ProviderProfileSource>> | undefined): Map<string, ResolvedProviderProfile>;
+/**
+ * Reject a section this adapter could not serve. Registered as the settings
+ * namespace's validator, so an unserviceable profile is refused where it is
+ * written instead of being stored and then quietly disabling every route in
+ * the namespace.
+ * @param config - the resolved section to check.
+ */
+declare function assertServiceable(config: Config): void;
+/** Register one generic OpenAI-compatible adapter for all configured provider routes. */
+declare function apply(ctx: Context, config: Config): void;
+//#endregion
+export { Config, DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_REQUEST_IMAGE_BYTES, DEFAULT_MAX_TOKENS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, MODEL_MODALITIES, ModelProfileSource, NS, OpenAICompatibleAdapter, type OpenAICompatibleAdapterOptions, ProviderProfileSource, REASONING_LEVELS, type ReasoningEffort, type ResolvedModelProfile, type ResolvedProviderProfile, apply, assertServiceable, inject, name, resolveAdapterOptions, resolveProfiles };
+//# sourceMappingURL=index.d.mts.map

package/lib/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;cAsDa;cACA;cACA,wCAAE;;cAGF;;cAEA;;UAGI;EACf;EACA;EACA;EACA;EACA;EACA,kBAAkB;EAClB,2BAA2B,QAAQ,OAAO;;;UAI3B;;EAEf;;EAEA;;EAEA;;EAEA,UAAU;EAEV;EACA;EACA;EACA;EACA;EACA;;EAEA,YAAY;;EAEZ,SAAS;EACT;EACA;EACA;EACA;;EAEA;EACA,cAAc;;;UAIC;;EAEf,YAAY,eAAe;;;cAuChB,QAAQ,EAAE;;;;;;;;;;iBA8HP,sBACd,kBACA,QAAQ,wBACP;;;;;;;;;iBAgHa,gBACd,WAAW,SAAS,eAAe,sCAClC,YAAY;;;;;;;;iBAmBC,kBAAkB,QAAQ;;iBAoD1B,MAAM,KAAK,SAAS,QAAQ"}

package/lib/index.mjs

@@ -0,0 +1,293 @@
+import { DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_REQUEST_IMAGE_BYTES, DEFAULT_MAX_TOKENS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, OpenAICompatibleAdapter } from "./adapter.mjs";
+import z from "@deepseek-ai/schemastery";
+import { LlmError, RetryPolicySchema, assertUsableApiKey, resolveRetryPolicy } from "@deepseek-ai/dsh-llm";
+import { credentialRef } from "@deepseek-ai/dsh-credentials";
+import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
+import { deepEqualJson, installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+import { MAX_TIMER_DELAY_MS } from "@deepseek-ai/dsh-timeout";
+import { getOrCreateAnonymousUserId } from "@deepseek-ai/dsh-anonymous-user-id";
+//#region src/index.ts
+const name = "llm-openai-compatible";
+const inject = ["llm"];
+const NS = settingsNamespace("llm-openai-compatible");
+/** Selectable reasoning levels a profile or model may declare. */
+const REASONING_LEVELS = [
+	"off",
+	"low",
+	"high",
+	"max"
+];
+/** Accepted model input modalities. */
+const MODEL_MODALITIES = ["text", "image"];
+const modelSchema = z.object({
+	id: z.string().required(),
+	name: z.string(),
+	description: z.string(),
+	contextWindow: z.number().step(1).min(1),
+	maxTokens: z.number().step(1).min(1),
+	inputModalities: z.array(z.union(MODEL_MODALITIES)).min(1).default(["text"]),
+	reasoningEfforts: z.union([z.const(false), z.dict(z.union([z.string(), z.const(null)]))])
+});
+const providerSchema = z.object({
+	apiKeyEnv: z.string().role("credential-ref"),
+	displayName: z.string(),
+	baseURL: z.string().required(),
+	headers: z.dict(z.string()),
+	temperature: z.number().min(0).max(2),
+	topP: z.number().min(0).max(1),
+	topK: z.number().step(1).min(1),
+	presencePenalty: z.number().min(-2).max(2),
+	frequencyPenalty: z.number().min(-2).max(2),
+	seed: z.number().step(1).min(1),
+	reasoning: z.union(REASONING_LEVELS),
+	models: z.array(modelSchema),
+	defaultContextWindow: z.number().step(1).min(1).default(DEFAULT_CONTEXT_WINDOW),
+	defaultMaxTokens: z.number().step(1).min(1).default(DEFAULT_MAX_TOKENS),
+	maxRequestImageBytes: z.number().step(1).min(1).default(DEFAULT_MAX_REQUEST_IMAGE_BYTES),
+	streamIdleTimeoutMs: z.number().min(Number.MIN_VALUE).max(MAX_TIMER_DELAY_MS).default(DEFAULT_STREAM_IDLE_TIMEOUT_MS),
+	timeoutMs: z.number().min(Number.MIN_VALUE).max(MAX_TIMER_DELAY_MS),
+	retryPolicy: RetryPolicySchema
+});
+/** Runtime schema for {@link Config}. */
+const Config = z.object({ providers: z.dict(providerSchema).default({}) });
+function isReasoningEffort(value) {
+	return REASONING_LEVELS.includes(value);
+}
+/** Validate one model's declared reasoning efforts into detached form. */
+function resolveReasoningEfforts(provider, modelId, value) {
+	if (value === void 0) return {};
+	if (value === false) return { reasoningEfforts: false };
+	const declaration = {};
+	for (const [effort, wire] of Object.entries(value)) {
+		if (!isReasoningEffort(effort)) throw new Error(`llm-openai-compatible: provider "${provider}" model "${modelId}" declares unknown reasoning effort "${effort}"`);
+		if (effort === "off") {
+			if (wire !== null) throw new Error(`llm-openai-compatible: provider "${provider}" model "${modelId}" reasoning effort "off" must leave an empty wire spelling (null) to omit reasoning_effort`);
+			declaration.off = null;
+			continue;
+		}
+		if (wire === null || wire.length === 0) throw new Error(`llm-openai-compatible: provider "${provider}" model "${modelId}" reasoning effort "${effort}" needs a non-empty wire spelling`);
+		declaration[effort] = wire;
+	}
+	return { reasoningEfforts: declaration };
+}
+/** Validate and detach one provider route's model catalog. */
+function resolveModels(provider, models) {
+	if (models === void 0) return [];
+	const seen = /* @__PURE__ */ new Set();
+	return models.map((model) => {
+		if (model.id.length === 0) throw new Error(`llm-openai-compatible: provider "${provider}" catalog model ids must be non-empty`);
+		if (model.name !== void 0 && model.name.length === 0) throw new Error(`llm-openai-compatible: provider "${provider}" catalog model "${model.id}" has an empty name`);
+		if (model.contextWindow !== void 0 && (!Number.isInteger(model.contextWindow) || model.contextWindow <= 0)) throw new Error(`llm-openai-compatible: provider "${provider}" catalog model "${model.id}" contextWindow must be a positive integer`);
+		if (model.maxTokens !== void 0 && (!Number.isInteger(model.maxTokens) || model.maxTokens <= 0)) throw new Error(`llm-openai-compatible: provider "${provider}" catalog model "${model.id}" maxTokens must be a positive integer`);
+		const inputModalities = model.inputModalities ?? ["text"];
+		if (inputModalities.length === 0) throw new Error(`llm-openai-compatible: provider "${provider}" catalog model "${model.id}" inputModalities must not be empty`);
+		if (inputModalities.some((modality) => !MODEL_MODALITIES.includes(modality))) throw new Error(`llm-openai-compatible: provider "${provider}" catalog model "${model.id}" inputModalities must contain only "text" and "image"`);
+		if (new Set(inputModalities).size !== inputModalities.length) throw new Error(`llm-openai-compatible: provider "${provider}" catalog model "${model.id}" inputModalities must not contain duplicates`);
+		if (seen.has(model.id)) throw new Error(`llm-openai-compatible: provider "${provider}" has duplicate catalog model "${model.id}"`);
+		seen.add(model.id);
+		return {
+			id: model.id,
+			...model.name === void 0 ? {} : { name: model.name },
+			...model.description === void 0 ? {} : { description: model.description },
+			...model.contextWindow === void 0 ? {} : { contextWindow: model.contextWindow },
+			...model.maxTokens === void 0 ? {} : { maxTokens: model.maxTokens },
+			inputModalities: [...inputModalities],
+			...resolveReasoningEfforts(provider, model.id, model.reasoningEfforts)
+		};
+	});
+}
+/** A bounded finite number within `[lo, hi]`, or undefined. */
+function bounded(value, lo, hi) {
+	if (value === void 0) return void 0;
+	if (!Number.isFinite(value) || value < lo || value > hi) return void 0;
+	return value;
+}
+/**
+* The one explicit resolve step from a raw profile to validated connection
+* facts. Programmatic construction may bypass Schemastery normalization, so
+* every default and bound is re-judged here — for the composition entry at
+* load (fail loud) and for each settings snapshot at its first use.
+* @param provider - the route key owning this profile.
+* @param source - raw profile from config or a resolved settings snapshot.
+* @returns validated connection facts plus the credential reference.
+*/
+function resolveAdapterOptions(provider, source) {
+	if (provider.length === 0) throw new Error("llm-openai-compatible: provider names must be non-empty");
+	if (source.baseURL === void 0 || source.baseURL.length === 0) throw new Error(`llm-openai-compatible: provider "${provider}" requires a non-empty baseURL`);
+	if (source.displayName !== void 0 && source.displayName.length === 0) throw new Error(`llm-openai-compatible: provider "${provider}" has an empty displayName`);
+	const streamIdleTimeoutMs = source.streamIdleTimeoutMs ?? 3e5;
+	if (!Number.isFinite(streamIdleTimeoutMs) || streamIdleTimeoutMs <= 0 || streamIdleTimeoutMs > MAX_TIMER_DELAY_MS) throw new Error(`llm-openai-compatible: provider "${provider}" streamIdleTimeoutMs must be a positive finite number no greater than ${MAX_TIMER_DELAY_MS}`);
+	const maxRequestImageBytes = source.maxRequestImageBytes ?? 20971520;
+	if (!Number.isSafeInteger(maxRequestImageBytes) || maxRequestImageBytes <= 0) throw new Error(`llm-openai-compatible: provider "${provider}" maxRequestImageBytes must be a positive safe integer`);
+	const defaultContextWindow = source.defaultContextWindow ?? 262144;
+	if (!Number.isInteger(defaultContextWindow) || defaultContextWindow <= 0) throw new Error(`llm-openai-compatible: provider "${provider}" defaultContextWindow must be a positive integer`);
+	const defaultMaxTokens = source.defaultMaxTokens ?? 32768;
+	if (!Number.isSafeInteger(defaultMaxTokens) || defaultMaxTokens <= 0) throw new Error(`llm-openai-compatible: provider "${provider}" defaultMaxTokens must be a positive safe integer`);
+	const timeoutMs = bounded(source.timeoutMs, Number.MIN_VALUE, MAX_TIMER_DELAY_MS);
+	if (source.timeoutMs !== void 0 && timeoutMs === void 0) throw new Error(`llm-openai-compatible: provider "${provider}" timeoutMs must be a positive finite number no greater than ${MAX_TIMER_DELAY_MS}`);
+	if (bounded(source.temperature, 0, 2) === void 0 && source.temperature !== void 0) throw new Error(`llm-openai-compatible: provider "${provider}" temperature must be a finite number within 0..2`);
+	if (bounded(source.topP, 0, 1) === void 0 && source.topP !== void 0) throw new Error(`llm-openai-compatible: provider "${provider}" topP must be a finite number within 0..1`);
+	if (source.topK !== void 0 && (!Number.isInteger(source.topK) || source.topK <= 0)) throw new Error(`llm-openai-compatible: provider "${provider}" topK must be a positive integer`);
+	if (bounded(source.presencePenalty, -2, 2) === void 0 && source.presencePenalty !== void 0) throw new Error(`llm-openai-compatible: provider "${provider}" presencePenalty must be a finite number within -2..2`);
+	if (bounded(source.frequencyPenalty, -2, 2) === void 0 && source.frequencyPenalty !== void 0) throw new Error(`llm-openai-compatible: provider "${provider}" frequencyPenalty must be a finite number within -2..2`);
+	if (source.seed !== void 0 && (!Number.isInteger(source.seed) || source.seed <= 0)) throw new Error(`llm-openai-compatible: provider "${provider}" seed must be a positive integer`);
+	if (source.reasoning !== void 0 && !isReasoningEffort(source.reasoning)) throw new Error(`llm-openai-compatible: provider "${provider}" reasoning must be one of ${REASONING_LEVELS.join(", ")}`);
+	return {
+		provider,
+		displayName: source.displayName ?? provider,
+		...source.apiKeyEnv === void 0 ? {} : { apiKeyEnv: credentialRef(source.apiKeyEnv) },
+		baseURL: source.baseURL,
+		...source.headers === void 0 ? {} : { headers: { ...source.headers } },
+		...source.temperature === void 0 ? {} : { temperature: source.temperature },
+		...source.topP === void 0 ? {} : { topP: source.topP },
+		...source.topK === void 0 ? {} : { topK: source.topK },
+		...source.presencePenalty === void 0 ? {} : { presencePenalty: source.presencePenalty },
+		...source.frequencyPenalty === void 0 ? {} : { frequencyPenalty: source.frequencyPenalty },
+		...source.seed === void 0 ? {} : { seed: source.seed },
+		...source.reasoning === void 0 ? {} : { reasoning: source.reasoning },
+		models: resolveModels(provider, source.models),
+		defaultContextWindow,
+		defaultMaxTokens,
+		maxRequestImageBytes,
+		streamIdleTimeoutMs,
+		...timeoutMs === void 0 ? {} : { timeoutMs },
+		retryPolicy: resolveRetryPolicy(source.retryPolicy, `llm-openai-compatible: provider "${provider}" retryPolicy`)
+	};
+}
+/**
+* Validate profiles and return a detached route-keyed map suitable for
+* per-request reads. This is the one explicit resolve step, so an omitted dict
+* resolves to the empty (dormant) route set here rather than through a hidden
+* fallback.
+* @param providers - configured provider profiles keyed by route.
+* @returns validated profiles in configuration order.
+*/
+function resolveProfiles(providers) {
+	if (Array.isArray(providers)) throw new Error("llm-openai-compatible: providers is now a dict keyed by provider route, not an array of profiles");
+	const resolved = /* @__PURE__ */ new Map();
+	for (const [provider, source] of Object.entries(providers ?? {})) resolved.set(provider, resolveAdapterOptions(provider, source));
+	return resolved;
+}
+/**
+* Reject a section this adapter could not serve. Registered as the settings
+* namespace's validator, so an unserviceable profile is refused where it is
+* written instead of being stored and then quietly disabling every route in
+* the namespace.
+* @param config - the resolved section to check.
+*/
+function assertServiceable(config) {
+	resolveProfiles(config.providers);
+}
+/** The registry captures these per route; a change here must re-register. */
+function registrationFacts(profiles) {
+	return [...profiles.entries()].map(([provider, profile]) => ({
+		provider,
+		displayName: profile.displayName,
+		retryPolicy: profile.retryPolicy
+	})).sort((left, right) => left.provider.localeCompare(right.provider));
+}
+/**
+* The configurable-provider directory: every route the current profiles
+* declare. A hand-declared route has no catalog entry, so without this it
+* would have no settings address and configuration surfaces could neither
+* show nor edit it. The profile half is unconditional, which keeps a route
+* already stored against a withheld provider editable and deletable.
+*/
+function directoryEntries(profiles) {
+	const entries = /* @__PURE__ */ new Map();
+	for (const [provider, profile] of profiles) entries.set(provider, {
+		provider,
+		displayName: profile.displayName,
+		settingsNs: NS,
+		settingsPath: ["providers", provider],
+		declared: true
+	});
+	return [...entries.values()];
+}
+/** Register one generic OpenAI-compatible adapter for all configured provider routes. */
+function apply(ctx, config) {
+	let current = () => config;
+	let lastRaw;
+	let memoized;
+	/** The resolved profiles for the current configuration, memoized by raw identity. */
+	const profiles = () => {
+		const raw = current();
+		if (raw === lastRaw && memoized !== void 0) return memoized;
+		const next = resolveProfiles(raw.providers);
+		lastRaw = raw;
+		memoized = next;
+		return next;
+	};
+	profiles();
+	const resolveApiKey = async (provider, profile) => {
+		const ref = profile.apiKeyEnv;
+		if (ref === void 0) return void 0;
+		const credentials = ctx.get("credentials");
+		if (credentials !== void 0) {
+			const hit = await credentials.resolve(ref);
+			if (hit !== void 0) return assertUsableApiKey(hit.value, "llm-openai-compatible", ref);
+		} else {
+			const ambient = launchEnvironmentOf(ctx).get(ref);
+			if (ambient !== void 0 && ambient.value.length > 0) return assertUsableApiKey(ambient.value, "llm-openai-compatible", ref);
+		}
+		throw new LlmError(`llm-openai-compatible: no credential for provider route "${provider}"; its profile resolves ${ref}, which is not set — store ${ref} through the credentials service (the web Models page writes it), or export ${ref} in the launching environment`, "MISSING_CREDENTIAL");
+	};
+	let userId;
+	const resolveUserId = () => userId ??= getOrCreateAnonymousUserId();
+	const adapter = new OpenAICompatibleAdapter({
+		profiles,
+		resolveApiKey,
+		resolveUserId,
+		resolveAttachments: () => ctx.get("attachments")
+	});
+	let directory;
+	let directoryFacts;
+	const ensureDirectory = () => {
+		const entries = directoryEntries(profiles());
+		if (deepEqualJson(entries, directoryFacts)) return;
+		if (directory === void 0) directory = ctx.llm.registerConfigurableProviders(entries);
+		else directory.replace(entries);
+		directoryFacts = entries;
+	};
+	ensureDirectory();
+	let registration;
+	let registeredFacts;
+	const ensureRegistrationFacts = () => {
+		const facts = registrationFacts(profiles());
+		if (deepEqualJson(facts, registeredFacts)) return;
+		const routes = [...profiles().keys()];
+		if (registration === void 0) {
+			if (routes.length === 0) {
+				registeredFacts = facts;
+				return;
+			}
+			registration = ctx.llm.registerAdapter(routes, adapter);
+		} else registration.replace(routes);
+		registeredFacts = facts;
+	};
+	ensureRegistrationFacts();
+	installSettingsSection(ctx, NS, Config, config, {
+		validate: assertServiceable,
+		setSource: (source) => {
+			current = source;
+		},
+		onChange: () => {
+			try {
+				ensureRegistrationFacts();
+			} catch (error) {
+				ctx.logger.error("llm-openai-compatible: keeping the previously registered routes after a refused update");
+				ctx.logger.error(error);
+			}
+			try {
+				ensureDirectory();
+			} catch (error) {
+				ctx.logger.error("llm-openai-compatible: keeping the previous configurable-provider directory after a refused update");
+				ctx.logger.error(error);
+			}
+		}
+	});
+}
+//#endregion
+export { Config, DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_REQUEST_IMAGE_BYTES, DEFAULT_MAX_TOKENS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, MODEL_MODALITIES, NS, OpenAICompatibleAdapter, REASONING_LEVELS, apply, assertServiceable, inject, name, resolveAdapterOptions, resolveProfiles };
+
+//# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Register a {@link OpenAICompatibleAdapter} for every route in the plugin's\n * `providers` dict on `ctx.llm`. Profile facts resolve per request over the\n * optional `llm-openai-compatible` user-settings section (`ctx.settings`), so\n * a changed base URL, catalog, sampling default, or key reaches the very next\n * request without restarting anything, while an in-flight stream keeps the\n * facts it started with. A changed *route set* (or a route's\n * registration-captured retry policy) re-registers the same adapter instance\n * in place, and the configurable-provider directory tracks the declared\n * routes so configuration surfaces can show and edit each profile.\n * @module @morlay/dsh-llm-openai-compatible\n */\n\nimport type { Context } from \"@deepseek-ai/cordis\";\nimport z from \"@deepseek-ai/schemastery\";\nimport {\n  LlmError,\n  RetryPolicySchema,\n  assertUsableApiKey,\n  resolveRetryPolicy,\n} from \"@deepseek-ai/dsh-llm\";\nimport type { ModelModality, RetryPolicyConfig } from \"@deepseek-ai/dsh-llm\";\nimport { credentialRef } from \"@deepseek-ai/dsh-credentials\";\nimport { launchEnvironmentOf } from \"@deepseek-ai/dsh-launch-environment\";\nimport {\n  deepEqualJson,\n  installSettingsSection,\n  settingsNamespace,\n} from \"@deepseek-ai/dsh-settings\";\nimport { MAX_TIMER_DELAY_MS } from \"@deepseek-ai/dsh-timeout\";\nimport { getOrCreateAnonymousUserId } from \"@deepseek-ai/dsh-anonymous-user-id\";\nimport {\n  DEFAULT_CONTEXT_WINDOW,\n  DEFAULT_MAX_REQUEST_IMAGE_BYTES,\n  DEFAULT_MAX_TOKENS,\n  DEFAULT_STREAM_IDLE_TIMEOUT_MS,\n  OpenAICompatibleAdapter,\n} from \"./adapter.ts\";\nimport type { ReasoningEffort, ResolvedModelProfile, ResolvedProviderProfile } from \"./adapter.ts\";\n\nexport { OpenAICompatibleAdapter } from \"./adapter.ts\";\nexport type {\n  OpenAICompatibleAdapterOptions,\n  ReasoningEffort,\n  ResolvedModelProfile,\n  ResolvedProviderProfile,\n} from \"./adapter.ts\";\nexport {\n  DEFAULT_CONTEXT_WINDOW,\n  DEFAULT_MAX_REQUEST_IMAGE_BYTES,\n  DEFAULT_MAX_TOKENS,\n  DEFAULT_STREAM_IDLE_TIMEOUT_MS,\n} from \"./adapter.ts\";\n\nexport const name = \"llm-openai-compatible\";\nexport const inject = [\"llm\"];\nexport const NS = settingsNamespace(\"llm-openai-compatible\");\n\n/** Selectable reasoning levels a profile or model may declare. */\nexport const REASONING_LEVELS = [\"off\", \"low\", \"high\", \"max\"] as const;\n/** Accepted model input modalities. */\nexport const MODEL_MODALITIES = [\"text\", \"image\"] as const;\n\n/** Source shape of one model catalog entry. */\nexport interface ModelProfileSource {\n  id: string;\n  name?: string;\n  description?: string;\n  contextWindow?: number;\n  maxTokens?: number;\n  inputModalities?: ModelModality[];\n  reasoningEfforts?: false | Partial<Record<ReasoningEffort, string | null>>;\n}\n\n/** Source shape of one provider route profile; the `providers` dict key IS the route. */\nexport interface ProviderProfileSource {\n  /** Credential reference (environment-variable name); absence sends no authorization header. */\n  apiKeyEnv?: string;\n  /** Name shown by configuration surfaces; defaults to the route key. */\n  displayName?: string;\n  /** Required endpoint base; requests hit `${baseURL}/chat/completions`. */\n  baseURL: string;\n  /** Extra request headers, merged under the mandatory attribution headers. */\n  headers?: Record<string, string>;\n  // === sampling defaults (request-level values win) ===\n  temperature?: number;\n  topP?: number;\n  topK?: number;\n  presencePenalty?: number;\n  frequencyPenalty?: number;\n  seed?: number;\n  /** Deployment default reasoning level; omission keeps the provider default. */\n  reasoning?: ReasoningEffort;\n  /** This route's model catalog; omission serves an empty catalog (unlisted ids pass through). */\n  models?: ModelProfileSource[];\n  defaultContextWindow?: number;\n  defaultMaxTokens?: number;\n  maxRequestImageBytes?: number;\n  streamIdleTimeoutMs?: number;\n  /** Whole-request deadline in milliseconds; unset arms no overall timer. */\n  timeoutMs?: number;\n  retryPolicy?: RetryPolicyConfig;\n}\n\n/** Plugin configuration: the provider routes this instance owns. */\nexport interface Config {\n  /** Provider routes, keyed by route. An empty (or omitted) dict is the dormant posture. */\n  providers?: Record<string, ProviderProfileSource>;\n}\n\nconst modelSchema = z.object({\n  id: z.string().required(),\n  name: z.string(),\n  description: z.string(),\n  contextWindow: z.number().step(1).min(1),\n  maxTokens: z.number().step(1).min(1),\n  inputModalities: z.array(z.union(MODEL_MODALITIES)).min(1).default([\"text\"]),\n  reasoningEfforts: z.union([z.const(false), z.dict(z.union([z.string(), z.const(null)]))]),\n});\n\nconst providerSchema = z.object({\n  apiKeyEnv: z.string().role(\"credential-ref\"),\n  displayName: z.string(),\n  baseURL: z.string().required(),\n  headers: z.dict(z.string()),\n  temperature: z.number().min(0).max(2),\n  topP: z.number().min(0).max(1),\n  topK: z.number().step(1).min(1),\n  presencePenalty: z.number().min(-2).max(2),\n  frequencyPenalty: z.number().min(-2).max(2),\n  seed: z.number().step(1).min(1),\n  reasoning: z.union(REASONING_LEVELS),\n  models: z.array(modelSchema),\n  defaultContextWindow: z.number().step(1).min(1).default(DEFAULT_CONTEXT_WINDOW),\n  defaultMaxTokens: z.number().step(1).min(1).default(DEFAULT_MAX_TOKENS),\n  maxRequestImageBytes: z.number().step(1).min(1).default(DEFAULT_MAX_REQUEST_IMAGE_BYTES),\n  streamIdleTimeoutMs: z\n    .number()\n    .min(Number.MIN_VALUE)\n    .max(MAX_TIMER_DELAY_MS)\n    .default(DEFAULT_STREAM_IDLE_TIMEOUT_MS),\n  timeoutMs: z.number().min(Number.MIN_VALUE).max(MAX_TIMER_DELAY_MS),\n  retryPolicy: RetryPolicySchema,\n});\n\n/** Runtime schema for {@link Config}. */\nexport const Config: z<Config> = z.object({\n  providers: z.dict(providerSchema).default({}),\n});\n\nfunction isReasoningEffort(value: string): value is ReasoningEffort {\n  return (REASONING_LEVELS as readonly string[]).includes(value);\n}\n\n/** Validate one model's declared reasoning efforts into detached form. */\nfunction resolveReasoningEfforts(\n  provider: string,\n  modelId: string,\n  value: ModelProfileSource[\"reasoningEfforts\"],\n): Pick<ResolvedModelProfile, \"reasoningEfforts\"> {\n  if (value === void 0) return {};\n  if (value === false) return { reasoningEfforts: false };\n  const declaration: Partial<Record<ReasoningEffort, string | null>> = {};\n  for (const [effort, wire] of Object.entries(value)) {\n    if (!isReasoningEffort(effort)) {\n      throw new Error(\n        `llm-openai-compatible: provider \"${provider}\" model \"${modelId}\" declares unknown reasoning effort \"${effort}\"`,\n      );\n    }\n    if (effort === \"off\") {\n      if (wire !== null) {\n        throw new Error(\n          `llm-openai-compatible: provider \"${provider}\" model \"${modelId}\" reasoning effort \"off\" must leave an empty wire spelling (null) to omit reasoning_effort`,\n        );\n      }\n      declaration.off = null;\n      continue;\n    }\n    if (wire === null || wire.length === 0) {\n      throw new Error(\n        `llm-openai-compatible: provider \"${provider}\" model \"${modelId}\" reasoning effort \"${effort}\" needs a non-empty wire spelling`,\n      );\n    }\n    declaration[effort] = wire;\n  }\n  return { reasoningEfforts: declaration };\n}\n\n/** Validate and detach one provider route's model catalog. */\nfunction resolveModels(\n  provider: string,\n  models: readonly ModelProfileSource[] | undefined,\n): readonly ResolvedModelProfile[] {\n  if (models === void 0) return [];\n  const seen = new Set<string>();\n  return models.map((model) => {\n    if (model.id.length === 0)\n      throw new Error(\n        `llm-openai-compatible: provider \"${provider}\" catalog model ids must be non-empty`,\n      );\n    if (model.name !== void 0 && model.name.length === 0)\n      throw new Error(\n        `llm-openai-compatible: provider \"${provider}\" catalog model \"${model.id}\" has an empty name`,\n      );\n    if (\n      model.contextWindow !== void 0 &&\n      (!Number.isInteger(model.contextWindow) || model.contextWindow <= 0)\n    ) {\n      throw new Error(\n        `llm-openai-compatible: provider \"${provider}\" catalog model \"${model.id}\" contextWindow must be a positive integer`,\n      );\n    }\n    if (\n      model.maxTokens !== void 0 &&\n      (!Number.isInteger(model.maxTokens) || model.maxTokens <= 0)\n    ) {\n      throw new Error(\n        `llm-openai-compatible: provider \"${provider}\" catalog model \"${model.id}\" maxTokens must be a positive integer`,\n      );\n    }\n    const inputModalities = model.inputModalities ?? [\"text\"];\n    if (inputModalities.length === 0)\n      throw new Error(\n        `llm-openai-compatible: provider \"${provider}\" catalog model \"${model.id}\" inputModalities must not be empty`,\n      );\n    if (\n      inputModalities.some(\n        (modality) => !(MODEL_MODALITIES as readonly string[]).includes(modality),\n      )\n    ) {\n      throw new Error(\n        `llm-openai-compatible: provider \"${provider}\" catalog model \"${model.id}\" inputModalities must contain only \"text\" and \"image\"`,\n      );\n    }\n    if (new Set(inputModalities).size !== inputModalities.length) {\n      throw new Error(\n        `llm-openai-compatible: provider \"${provider}\" catalog model \"${model.id}\" inputModalities must not contain duplicates`,\n      );\n    }\n    if (seen.has(model.id))\n      throw new Error(\n        `llm-openai-compatible: provider \"${provider}\" has duplicate catalog model \"${model.id}\"`,\n      );\n    seen.add(model.id);\n    return {\n      id: model.id,\n      ...(model.name === void 0 ? {} : { name: model.name }),\n      ...(model.description === void 0 ? {} : { description: model.description }),\n      ...(model.contextWindow === void 0 ? {} : { contextWindow: model.contextWindow }),\n      ...(model.maxTokens === void 0 ? {} : { maxTokens: model.maxTokens }),\n      inputModalities: [...inputModalities],\n      ...resolveReasoningEfforts(provider, model.id, model.reasoningEfforts),\n    };\n  });\n}\n\n/** A bounded finite number within `[lo, hi]`, or undefined. */\nfunction bounded(value: number | undefined, lo: number, hi: number): number | undefined {\n  if (value === void 0) return void 0;\n  if (!Number.isFinite(value) || value < lo || value > hi) return void 0;\n  return value;\n}\n\n/**\n * The one explicit resolve step from a raw profile to validated connection\n * facts. Programmatic construction may bypass Schemastery normalization, so\n * every default and bound is re-judged here — for the composition entry at\n * load (fail loud) and for each settings snapshot at its first use.\n * @param provider - the route key owning this profile.\n * @param source - raw profile from config or a resolved settings snapshot.\n * @returns validated connection facts plus the credential reference.\n */\nexport function resolveAdapterOptions(\n  provider: string,\n  source: ProviderProfileSource,\n): ResolvedProviderProfile {\n  if (provider.length === 0)\n    throw new Error(\"llm-openai-compatible: provider names must be non-empty\");\n  if (source.baseURL === void 0 || source.baseURL.length === 0) {\n    throw new Error(`llm-openai-compatible: provider \"${provider}\" requires a non-empty baseURL`);\n  }\n  if (source.displayName !== void 0 && source.displayName.length === 0) {\n    throw new Error(`llm-openai-compatible: provider \"${provider}\" has an empty displayName`);\n  }\n  const streamIdleTimeoutMs = source.streamIdleTimeoutMs ?? DEFAULT_STREAM_IDLE_TIMEOUT_MS;\n  if (\n    !Number.isFinite(streamIdleTimeoutMs) ||\n    streamIdleTimeoutMs <= 0 ||\n    streamIdleTimeoutMs > MAX_TIMER_DELAY_MS\n  ) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" streamIdleTimeoutMs must be a positive finite number no greater than ${MAX_TIMER_DELAY_MS}`,\n    );\n  }\n  const maxRequestImageBytes = source.maxRequestImageBytes ?? DEFAULT_MAX_REQUEST_IMAGE_BYTES;\n  if (!Number.isSafeInteger(maxRequestImageBytes) || maxRequestImageBytes <= 0) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" maxRequestImageBytes must be a positive safe integer`,\n    );\n  }\n  const defaultContextWindow = source.defaultContextWindow ?? DEFAULT_CONTEXT_WINDOW;\n  if (!Number.isInteger(defaultContextWindow) || defaultContextWindow <= 0) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" defaultContextWindow must be a positive integer`,\n    );\n  }\n  const defaultMaxTokens = source.defaultMaxTokens ?? DEFAULT_MAX_TOKENS;\n  if (!Number.isSafeInteger(defaultMaxTokens) || defaultMaxTokens <= 0) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" defaultMaxTokens must be a positive safe integer`,\n    );\n  }\n  const timeoutMs = bounded(source.timeoutMs, Number.MIN_VALUE, MAX_TIMER_DELAY_MS);\n  if (source.timeoutMs !== void 0 && timeoutMs === void 0) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" timeoutMs must be a positive finite number no greater than ${MAX_TIMER_DELAY_MS}`,\n    );\n  }\n  if (bounded(source.temperature, 0, 2) === void 0 && source.temperature !== void 0) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" temperature must be a finite number within 0..2`,\n    );\n  }\n  if (bounded(source.topP, 0, 1) === void 0 && source.topP !== void 0) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" topP must be a finite number within 0..1`,\n    );\n  }\n  if (source.topK !== void 0 && (!Number.isInteger(source.topK) || source.topK <= 0)) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" topK must be a positive integer`,\n    );\n  }\n  if (bounded(source.presencePenalty, -2, 2) === void 0 && source.presencePenalty !== void 0) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" presencePenalty must be a finite number within -2..2`,\n    );\n  }\n  if (bounded(source.frequencyPenalty, -2, 2) === void 0 && source.frequencyPenalty !== void 0) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" frequencyPenalty must be a finite number within -2..2`,\n    );\n  }\n  if (source.seed !== void 0 && (!Number.isInteger(source.seed) || source.seed <= 0)) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" seed must be a positive integer`,\n    );\n  }\n  if (source.reasoning !== void 0 && !isReasoningEffort(source.reasoning)) {\n    throw new Error(\n      `llm-openai-compatible: provider \"${provider}\" reasoning must be one of ${REASONING_LEVELS.join(\", \")}`,\n    );\n  }\n  return {\n    provider,\n    displayName: source.displayName ?? provider,\n    ...(source.apiKeyEnv === void 0 ? {} : { apiKeyEnv: credentialRef(source.apiKeyEnv) }),\n    baseURL: source.baseURL,\n    ...(source.headers === void 0 ? {} : { headers: { ...source.headers } }),\n    ...(source.temperature === void 0 ? {} : { temperature: source.temperature }),\n    ...(source.topP === void 0 ? {} : { topP: source.topP }),\n    ...(source.topK === void 0 ? {} : { topK: source.topK }),\n    ...(source.presencePenalty === void 0 ? {} : { presencePenalty: source.presencePenalty }),\n    ...(source.frequencyPenalty === void 0 ? {} : { frequencyPenalty: source.frequencyPenalty }),\n    ...(source.seed === void 0 ? {} : { seed: source.seed }),\n    ...(source.reasoning === void 0 ? {} : { reasoning: source.reasoning }),\n    models: resolveModels(provider, source.models),\n    defaultContextWindow,\n    defaultMaxTokens,\n    maxRequestImageBytes,\n    streamIdleTimeoutMs,\n    ...(timeoutMs === void 0 ? {} : { timeoutMs }),\n    retryPolicy: resolveRetryPolicy(\n      source.retryPolicy,\n      `llm-openai-compatible: provider \"${provider}\" retryPolicy`,\n    ),\n  };\n}\n\n/**\n * Validate profiles and return a detached route-keyed map suitable for\n * per-request reads. This is the one explicit resolve step, so an omitted dict\n * resolves to the empty (dormant) route set here rather than through a hidden\n * fallback.\n * @param providers - configured provider profiles keyed by route.\n * @returns validated profiles in configuration order.\n */\nexport function resolveProfiles(\n  providers: Readonly<Record<string, ProviderProfileSource>> | undefined,\n): Map<string, ResolvedProviderProfile> {\n  if (Array.isArray(providers))\n    throw new Error(\n      \"llm-openai-compatible: providers is now a dict keyed by provider route, not an array of profiles\",\n    );\n  const resolved = new Map<string, ResolvedProviderProfile>();\n  for (const [provider, source] of Object.entries(providers ?? {})) {\n    resolved.set(provider, resolveAdapterOptions(provider, source));\n  }\n  return resolved;\n}\n\n/**\n * Reject a section this adapter could not serve. Registered as the settings\n * namespace's validator, so an unserviceable profile is refused where it is\n * written instead of being stored and then quietly disabling every route in\n * the namespace.\n * @param config - the resolved section to check.\n */\nexport function assertServiceable(config: Config): void {\n  resolveProfiles(config.providers);\n}\n\n/** The registry captures these per route; a change here must re-register. */\nfunction registrationFacts(profiles: ReadonlyMap<string, ResolvedProviderProfile>): unknown[] {\n  return [...profiles.entries()]\n    .map(([provider, profile]) => ({\n      provider,\n      displayName: profile.displayName,\n      retryPolicy: profile.retryPolicy,\n    }))\n    .sort((left, right) => left.provider.localeCompare(right.provider));\n}\n\n/**\n * The configurable-provider directory: every route the current profiles\n * declare. A hand-declared route has no catalog entry, so without this it\n * would have no settings address and configuration surfaces could neither\n * show nor edit it. The profile half is unconditional, which keeps a route\n * already stored against a withheld provider editable and deletable.\n */\nfunction directoryEntries(profiles: ReadonlyMap<string, ResolvedProviderProfile>): {\n  provider: string;\n  displayName: string;\n  settingsNs: typeof NS;\n  settingsPath: readonly string[];\n  declared: boolean;\n}[] {\n  const entries = new Map<\n    string,\n    {\n      provider: string;\n      displayName: string;\n      settingsNs: typeof NS;\n      settingsPath: readonly string[];\n      declared: boolean;\n    }\n  >();\n  for (const [provider, profile] of profiles) {\n    entries.set(provider, {\n      provider,\n      displayName: profile.displayName,\n      settingsNs: NS,\n      settingsPath: [\"providers\", provider],\n      declared: true,\n    });\n  }\n  return [...entries.values()];\n}\n\n/** Register one generic OpenAI-compatible adapter for all configured provider routes. */\nexport function apply(ctx: Context, config: Config): void {\n  let current = () => config;\n  let lastRaw: Config | undefined;\n  let memoized: Map<string, ResolvedProviderProfile> | undefined;\n  /** The resolved profiles for the current configuration, memoized by raw identity. */\n  const profiles = (): ReadonlyMap<string, ResolvedProviderProfile> => {\n    const raw = current();\n    if (raw === lastRaw && memoized !== void 0) return memoized;\n    const next = resolveProfiles(raw.providers);\n    lastRaw = raw;\n    memoized = next;\n    return next;\n  };\n  profiles();\n  const resolveApiKey = async (\n    provider: string,\n    profile: ResolvedProviderProfile,\n  ): Promise<string | undefined> => {\n    const ref = profile.apiKeyEnv;\n    if (ref === void 0) return void 0;\n    const credentials = ctx.get(\"credentials\");\n    if (credentials !== void 0) {\n      const hit = await credentials.resolve(ref);\n      if (hit !== void 0) return assertUsableApiKey(hit.value, \"llm-openai-compatible\", ref);\n    } else {\n      const ambient = launchEnvironmentOf(ctx).get(ref);\n      if (ambient !== void 0 && ambient.value.length > 0)\n        return assertUsableApiKey(ambient.value, \"llm-openai-compatible\", ref);\n    }\n    throw new LlmError(\n      `llm-openai-compatible: no credential for provider route \"${provider}\"; its profile resolves ${ref}, which is not set — store ${ref} through the credentials service (the web Models page writes it), or export ${ref} in the launching environment`,\n      \"MISSING_CREDENTIAL\",\n    );\n  };\n  let userId: string | undefined;\n  const resolveUserId = () => (userId ??= getOrCreateAnonymousUserId());\n  const adapter = new OpenAICompatibleAdapter({\n    profiles,\n    resolveApiKey,\n    resolveUserId,\n    resolveAttachments: () => ctx.get(\"attachments\"),\n  });\n  let directory: ReturnType<typeof ctx.llm.registerConfigurableProviders> | undefined;\n  let directoryFacts: unknown[] | undefined;\n  const ensureDirectory = () => {\n    const entries = directoryEntries(profiles());\n    if (deepEqualJson(entries, directoryFacts)) return;\n    if (directory === void 0) directory = ctx.llm.registerConfigurableProviders(entries);\n    else directory.replace(entries);\n    directoryFacts = entries;\n  };\n  ensureDirectory();\n  let registration: ReturnType<typeof ctx.llm.registerAdapter> | undefined;\n  let registeredFacts: unknown[] | undefined;\n  const ensureRegistrationFacts = () => {\n    const facts = registrationFacts(profiles());\n    if (deepEqualJson(facts, registeredFacts)) return;\n    const routes = [...profiles().keys()];\n    if (registration === void 0) {\n      if (routes.length === 0) {\n        registeredFacts = facts;\n        return;\n      }\n      registration = ctx.llm.registerAdapter(routes, adapter);\n    } else {\n      registration.replace(routes);\n    }\n    registeredFacts = facts;\n  };\n  ensureRegistrationFacts();\n  installSettingsSection(ctx, NS, Config, config, {\n    validate: assertServiceable,\n    setSource: (source) => {\n      current = source;\n    },\n    onChange: () => {\n      try {\n        ensureRegistrationFacts();\n      } catch (error) {\n        ctx.logger.error(\n          \"llm-openai-compatible: keeping the previously registered routes after a refused update\",\n        );\n        ctx.logger.error(error);\n      }\n      try {\n        ensureDirectory();\n      } catch (error) {\n        ctx.logger.error(\n          \"llm-openai-compatible: keeping the previous configurable-provider directory after a refused update\",\n        );\n        ctx.logger.error(error);\n      }\n    },\n  });\n}\n"],"mappings":"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"}

package/lib/serialize.d.mts

@@ -0,0 +1,68 @@
+import { ResolvedModelProfile, ResolvedProviderProfile } from "./adapter.mjs";
+import { GenerateOptions } from "@deepseek-ai/dsh-llm";
+import { LanguageModelV4FunctionTool, LanguageModelV4Prompt, SharedV4ProviderOptions } from "@ai-sdk/provider";
+import { AttachmentStore } from "@deepseek-ai/dsh-attachment";
+//#region src/serialize.d.ts
+/** Provider-specific options the adapter forwards into the request body. */
+type OpenAICompatibleProviderOptions = SharedV4ProviderOptions & {
+  "openai-compatible"?: {
+    /** Exact wire `reasoning_effort` spelling; absence omits the field. */
+    reasoningEffort?: string;
+    /** Non-standard `top_k` sampling knob, sent only to gateways that accept it. */
+    top_k?: number;
+  };
+};
+/** The per-call options resolved from one harness request and provider profile. */
+interface OpenAICompatibleCallOptions {
+  prompt: LanguageModelV4Prompt;
+  maxOutputTokens?: number;
+  temperature?: number;
+  topP?: number;
+  presencePenalty?: number;
+  frequencyPenalty?: number;
+  seed?: number;
+  stopSequences?: string[];
+  tools?: LanguageModelV4FunctionTool[];
+  providerOptions?: OpenAICompatibleProviderOptions;
+}
+/**
+ * Resolve one reasoning effort to its wire spelling for the exact model.
+ * `off` (and a `null` wire spelling) means *omit the field* — the provider
+ * default applies; every other declared effort sends its configured value.
+ * An effort the model does not declare fails here, before any network I/O:
+ * that is where a bad request-level effort AND a bad profile default both
+ * belong (describing a model must never throw, but executing a request must).
+ * @param model - the configured model descriptor, or `undefined` for an
+ *   unlisted model id (which carries no reasoning declaration).
+ * @param effort - the resolved effort to send, or `undefined` to send none.
+ * @returns the wire `reasoning_effort` value, or `undefined` to omit the field.
+ * @throws LlmError `UNSUPPORTED_REASONING_EFFORT` when the model does not
+ *   declare the effort.
+ */
+declare function resolveReasoningWire(model: ResolvedModelProfile | undefined, effort: ResolvedProviderProfile["reasoning"] | undefined): string | undefined;
+/**
+ * Build the full call options for text-only content.
+ * @param options - the harness request.
+ * @param profile - resolved provider profile.
+ * @param model - configured model descriptor, or `undefined` for unlisted ids.
+ * @returns the AI SDK call options (settings + prompt + provider options).
+ */
+declare function serializeCallOptions(options: GenerateOptions, profile: ResolvedProviderProfile, model: ResolvedModelProfile | undefined): Promise<OpenAICompatibleCallOptions>;
+/**
+ * Build one image-capable request while keeping durable bytes out of session
+ * messages. Oversized oldest images become deterministic text before any
+ * attachment read.
+ * @param options - the harness request containing image-capable user content.
+ * @param profile - resolved provider profile.
+ * @param model - configured model descriptor, or `undefined` for unlisted ids.
+ * @param images - the attachment resolver, request bound, and cancellation.
+ * @returns the fully materialized call options.
+ */
+declare function serializeCallOptionsWithImages(options: GenerateOptions, profile: ResolvedProviderProfile, model: ResolvedModelProfile | undefined, images: {
+  attachments: AttachmentStore;
+  maxRequestImageBytes: number;
+  signal?: AbortSignal;
+}): Promise<OpenAICompatibleCallOptions>;
+//#endregion
+export { OpenAICompatibleCallOptions, OpenAICompatibleProviderOptions, resolveReasoningWire, serializeCallOptions, serializeCallOptionsWithImages };
+//# sourceMappingURL=serialize.d.mts.map

package/lib/serialize.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.mts","names":[],"sources":["../src/serialize.ts"],"mappings":";;;;;;KA+BY,kCAAkC;EAC5C;;IAEE;;IAEA;;;;UAKa;EACf,QAAQ;EACR;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR,kBAAkB;;;;;;;;;;;;;;;;iBAiBJ,qBACd,OAAO,kCACP,QAAQ;;;;;;;;iBAiSY,qBACpB,SAAS,iBACT,SAAS,yBACT,OAAO,mCACN,QAAQ;;;;;;;;;;;iBAiBW,+BACpB,SAAS,iBACT,SAAS,yBACT,OAAO,kCACP;EAAU,aAAa;EAAiB;EAA8B,SAAS;IAC9E,QAAQ"}