feat(models): register protocols and evidence-bound capabilities

This commit is contained in:
Agent Workbench Dev
2026-10-31 21:56:41 +08:00
parent 299fb14234
commit 578cf88eca
9 changed files with 154 additions and 4 deletions
+10 -3
View File
@@ -2,6 +2,7 @@ import { randomUUID, createHash } from 'node:crypto';
import { setTimeout as delay } from 'node:timers/promises';
import { ModelRequestError } from '../../server/diagnostics.mjs';
import { CredentialVault } from './credential-vault.mjs';
import { modelProtocol, capabilityDeclarations, capabilityView } from '../../shared/contracts/model-capabilities.mjs';
const legacyId = 'legacy-default';
const stamp = () => new Date().toISOString();
@@ -107,7 +108,8 @@ export class ModelHub {
...(this.credentialVault ? { savedCredential: this.credentialVault.status(connection) } : {}),
status: !connection.enabled ? 'disabled' : !ready ? 'needs_key' : health?.blocked ? 'needs_attention' : health?.cooldownUntil > Date.now() ? 'cooling' : 'configured',
activeRequests: this.leases.get(connection.id) ?? 0, health: health ?? { state: 'unverified' },
capabilities: { tools: 'protocol_declared', vision: 'unknown', audio: 'unknown' } };
streaming: connection.streaming === true, capabilitySchema: 1, capabilityDeclarations: capabilityDeclarations(undefined, connection.capabilityDeclarations),
capabilities: capabilityView(connection, credential?.revision ?? 0) };
}
view() { return { revision: this.state.revision, selected: this.state.selected, connections: this.connections().map(value => this.status(value)), pools: this.state.pools,
imports: Object.entries(this.state.imports).map(([id, value]) => ({ id, ...value })), attempts: this.attempts.slice(-100).reverse(), waiting: this.waiting,
@@ -119,10 +121,15 @@ export class ModelHub {
const previous = input.id ? this.connection(input.id) : null;
if (this.state.connections.length >= 100 && !previous) throw error('最多保存100个模型连接。');
if (previous && input.revision !== previous.revision) throw error('模型连接已修改,请刷新后重试。', 409);
if (input.protocol && input.protocol !== 'chat-completions') throw error('当前接入仅支持经过验证的 Chat Completions 协议。');
const protocol = modelProtocol(input.protocol ?? previous?.protocol ?? 'chat-completions');
const declarations = capabilityDeclarations(input.capabilityDeclarations, previous?.capabilityDeclarations);
if (input.streaming !== undefined && typeof input.streaming !== 'boolean') throw error('流式选项必须为开启或关闭。');
const streaming = input.streaming ?? previous?.streaming ?? false;
if (streaming && declarations.streaming !== 'supported') throw error('请先声明服务支持流式输出,再开启流式请求。');
const name = label(input.name), model = label(input.model, 200);
if (!name || !model) throw error('请填写连接名称和实际模型名称。');
const connection = { id: previous?.id ?? randomUUID(), name, brand: label(input.brand || '自定义', 40), protocol: 'chat-completions', model,
const connection = { id: previous?.id ?? randomUUID(), name, brand: label(input.brand || '自定义', 40), protocol, model,
capabilitySchema: 1, capabilityDeclarations: declarations, streaming,
baseUrl: modelEndpoint(input.baseUrl), enabled: input.enabled !== false, requiresKey: input.requiresKey !== false,
contextLimit: bounded(input.contextLimit, 16000, 1000, 200000), maxOutputTokens: bounded(input.maxOutputTokens, 2048, 256, 16000),
concurrency: bounded(input.concurrency, 1, 1, 8), revision: (previous?.revision ?? 0) + 1,
@@ -0,0 +1,36 @@
export const MODEL_PROTOCOLS = ['chat-completions', 'responses'];
export const MODEL_CAPABILITIES = ['text', 'tools', 'streaming', 'vision', 'audio'];
const failure = message => Object.assign(new Error(message), { status: 400 });
export function modelProtocol(value = 'chat-completions') {
if (!MODEL_PROTOCOLS.includes(value)) throw failure('请选择已接入的 Chat Completions 或 Responses 协议。');
return value;
}
export function capabilityDeclarations(input, previous = null) {
const result = { text: 'supported', tools: 'supported', streaming: 'unknown', vision: 'unknown', audio: 'unknown', ...previous };
if (input === undefined) return result;
if (!input || typeof input !== 'object' || Array.isArray(input)) throw failure('模型能力声明格式无效。');
for (const [key, value] of Object.entries(input)) {
if (!MODEL_CAPABILITIES.includes(key) || !['supported', 'unsupported', 'unknown'].includes(value)) throw failure('能力只能声明支持、不支持或未知,不能自行标为已验证。');
result[key] = value;
}
return result;
}
export function capabilityView(connection, credentialRevision = 0) {
const declarations = capabilityDeclarations(undefined, connection.capabilityDeclarations);
const evidence = connection.capabilityEvidence;
const current = evidence?.connectionRevision === connection.revision && evidence?.credentialRevision === credentialRevision;
return Object.fromEntries(MODEL_CAPABILITIES.map(key => [key,
declarations[key] === 'unsupported' ? 'unsupported' : current && evidence.results?.[key] === 'verified' ? 'verified'
: declarations[key] === 'supported' ? 'protocol_declared' : 'unknown']));
}
export function capabilityRejections(connection, requirements, credentialRevision = 0) {
const view = capabilityView(connection, credentialRevision);
return requirements.filter(key => !['verified', 'protocol_declared'].includes(view[key])).map(capability => ({
connectionId: connection.id, connectionName: connection.name, capability, state: view[capability] ?? 'unknown',
reason: view[capability] === 'unsupported' ? '连接明确声明不支持所需能力' : '连接尚未声明或验证所需能力',
}));
}