@dsh-plus/llm-pi 0.1.0

package/lib/index.d.ts

@@ -0,0 +1,90 @@
+import z from "@deepseek-ai/schemastery";
+import * as _deepseek_ai_dsh_settings0 from "@deepseek-ai/dsh-settings";
+import { Context } from "@deepseek-ai/cordis";
+
+//#region src/config.d.ts
+
+/** settings 命名空间；webui 配置卡片与插件运行期读取同一份。 */
+declare const SETTINGS_NS: _deepseek_ai_dsh_settings0.SettingsNamespace;
+/** 本插件可为手写 route 提供的协议实现（与官方 PROTOCOLS 表一致）。 */
+declare const PROTOCOL_IDS: readonly ["openai-completions", "openai-responses", "anthropic-messages"];
+type ProtocolId = (typeof PROTOCOL_IDS)[number];
+/** pi-ai 思考档位，升级序。 */
+declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+declare const MODALITIES: readonly ["text", "image"];
+type ThinkingLevel = (typeof THINKING_LEVELS)[number];
+type Modality = (typeof MODALITIES)[number];
+type ReasoningEfforts = Partial<Record<ThinkingLevel, string | null>>;
+/** 单个模型条目：id 必填，其余字段缺省即继承。 */
+interface ModelEntryConfig {
+  id: string;
+  extends?: string;
+  name?: string;
+  contextWindow?: number;
+  maxTokens?: number;
+  input?: Modality[];
+  reasoningEfforts?: false | ReasoningEfforts;
+  compat?: Record<string, unknown>;
+}
+/** 单个 provider route 配置（providers 字典的值）。 */
+interface ProviderProfileConfig {
+  extends?: string;
+  displayName?: string;
+  api?: ProtocolId;
+  baseURL?: string;
+  apiKeyEnv?: string;
+  headers?: Record<string, string>;
+  compat?: Record<string, unknown>;
+  defaultContextWindow?: number;
+  defaultMaxTokens?: number;
+  defaultInput?: Modality[];
+  reasoning?: ThinkingLevel;
+  thinkingBudgets?: {
+    minimal: number;
+    low: number;
+    medium: number;
+    high: number;
+  };
+  cacheRetention?: 'none' | 'short' | 'long';
+  transport?: 'sse' | 'websocket' | 'websocket-cached' | 'auto';
+  timeoutMs?: number;
+  websocketConnectTimeoutMs?: number;
+  streamIdleTimeoutMs?: number;
+  retryPolicy?: unknown;
+  models?: ModelEntryConfig[];
+}
+/** 插件配置根。 */
+interface LlmPiConfig {
+  enabled: boolean;
+  catalogUrl: string;
+  catalogRefreshHours: number;
+  catalogProxy: string;
+  providers: Record<string, ProviderProfileConfig>;
+}
+declare const Config: z<LlmPiConfig>;
+/** 配置卡片读取用的传输对象：配置无密钥字段，原样传输；附运行期元信息。 */
+interface WireConfig {
+  enabled: boolean;
+  catalogUrl: string;
+  catalogRefreshHours: number;
+  catalogProxy: string;
+  providers: Record<string, ProviderProfileConfig>;
+  /** 是否存在可写的 settings provider（决定卡片是否允许编辑）。 */
+  writable: boolean;
+  /** 模块解析来源与自检结果（dsh 树 / vendored 兜底）。 */
+  kitSource: string;
+  /** models.dev 快照状态（fetchedAt/模型数/错误），供卡片展示。 */
+  modelsDevStatus: {
+    fetchedAt: string | null;
+    providers: number;
+    models: number;
+    error: string | null;
+  } | null;
+}
+//#endregion
+//#region src/index.d.ts
+declare const name = "dsh-plus-llm-pi";
+declare const inject: readonly ["llm"];
+declare function apply(ctx: Context, config: LlmPiConfig): Promise<void>;
+//#endregion
+export { Config, type LlmPiConfig, type ModelEntryConfig, type ProviderProfileConfig, SETTINGS_NS, type WireConfig, apply, inject, name };