Tianyi Cui
42863d7c24
# Conflicts: # docs/config-catalog.md # packages/llm/llm-deepseek/src/index.ts # packages/llm/llm-deepseek/tests/adapter.spec.ts # packages/llm/llm-pi-ai/README.md # packages/llm/llm-pi-ai/src/index.ts # packages/llm/llm-pi-ai/tests/adapter.spec.ts # packages/llm/llm-pi-ai/tests/convert.spec.ts
97 lines
3.7 KiB
TypeScript
97 lines
3.7 KiB
TypeScript
/**
|
|
* Register a {@link DeepSeekAdapter} for the `deepseek` provider route on `ctx.llm`. Configuration uses
|
|
* Cordis schemastery; pass secrets from environment variables through `cordis.yml` with `!!js`,
|
|
* as shown in the package README, rather than reading ad hoc files.
|
|
* @module @deepseek-ai/dsh-llm-deepseek
|
|
*/
|
|
|
|
import type { Context } from 'cordis'
|
|
import z from 'schemastery'
|
|
import type {} from '@deepseek-ai/dsh-llm'
|
|
import { DeepSeekAdapter } from './adapter.ts'
|
|
import type { DeepSeekCatalogModel } from './adapter.ts'
|
|
|
|
export { DeepSeekAdapter } from './adapter.ts'
|
|
export type { DeepSeekAdapterOptions, DeepSeekCatalogModel } from './adapter.ts'
|
|
export type { RequestDefaults } from './serialize.ts'
|
|
export type * from './types.ts'
|
|
|
|
export const name = 'llm-deepseek'
|
|
export const inject = ['llm']
|
|
|
|
const DEFAULT_MODELS: DeepSeekCatalogModel[] = [
|
|
{ id: 'deepseek-v4-flash' },
|
|
{ id: 'deepseek-v4-pro' },
|
|
]
|
|
|
|
/**
|
|
* Plugin config, validated by the same-named schemastery schema. Every field
|
|
* is optional in yml: credentials/endpoint fall back to the environment (a
|
|
* missing API key fails plugin load, not the first call), and omitted
|
|
* thinking fields send nothing on the wire, so the provider default applies.
|
|
*/
|
|
export interface Config {
|
|
/** API key; falls back to $DEEPSEEK_API_KEY. Required one way or the other. */
|
|
apiKey?: string
|
|
/** Endpoint base; falls back to $DEEPSEEK_BASE_URL, then the public API. */
|
|
baseURL?: string
|
|
/** Thinking-mode default for every request (provider default: enabled). */
|
|
thinking?: 'enabled' | 'disabled'
|
|
/** Thinking effort (only meaningful with thinking enabled). */
|
|
reasoningEffort?: 'high' | 'max'
|
|
/** Advisory models shown by discovery consumers; defaults to V4 Flash and V4 Pro. */
|
|
models?: DeepSeekCatalogModel[]
|
|
}
|
|
|
|
const catalogModel: z<DeepSeekCatalogModel> = z.object({
|
|
id: z.string().required(),
|
|
name: z.string(),
|
|
description: z.string(),
|
|
})
|
|
|
|
export const Config: z<Config> = z.object({
|
|
apiKey: z.string(),
|
|
baseURL: z.string(),
|
|
thinking: z.union(['enabled', 'disabled']),
|
|
reasoningEffort: z.union(['high', 'max']),
|
|
models: z.array(catalogModel).default(DEFAULT_MODELS),
|
|
})
|
|
|
|
/** Public API default; the internal endpoint comes from $DEEPSEEK_BASE_URL. */
|
|
export const PUBLIC_BASE_URL = 'https://api.deepseek.com'
|
|
|
|
/** Resolve, validate, and detach the advisory model catalog. */
|
|
function resolveModels(models: readonly DeepSeekCatalogModel[] | undefined): DeepSeekCatalogModel[] {
|
|
const seen = new Set<string>()
|
|
return (models ?? DEFAULT_MODELS).map((model) => {
|
|
if (model.id.length === 0) throw new Error('llm-deepseek: catalog model ids must be non-empty')
|
|
if (model.name !== undefined && model.name.length === 0) {
|
|
throw new Error(`llm-deepseek: catalog model "${model.id}" has an empty name`)
|
|
}
|
|
if (seen.has(model.id)) throw new Error(`llm-deepseek: duplicate catalog model "${model.id}"`)
|
|
seen.add(model.id)
|
|
return {
|
|
id: model.id,
|
|
...model.name === undefined ? {} : { name: model.name },
|
|
...model.description === undefined ? {} : { description: model.description },
|
|
}
|
|
})
|
|
}
|
|
|
|
export function apply(ctx: Context, config: Config): void {
|
|
const apiKey = config.apiKey ?? process.env.DEEPSEEK_API_KEY
|
|
if (apiKey === undefined || apiKey.length === 0) {
|
|
throw new Error('llm-deepseek: an API key is required (Config.apiKey or $DEEPSEEK_API_KEY)')
|
|
}
|
|
const baseURL = config.baseURL ?? process.env.DEEPSEEK_BASE_URL ?? PUBLIC_BASE_URL
|
|
ctx.llm.registerAdapter(['deepseek'], new DeepSeekAdapter({
|
|
apiKey,
|
|
baseURL,
|
|
defaults: {
|
|
thinking: config.thinking,
|
|
reasoningEffort: config.reasoningEffort,
|
|
},
|
|
models: resolveModels(config.models),
|
|
}))
|
|
}
|