惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

WordPress大学
WordPress大学
aimingoo的专栏
aimingoo的专栏
月光博客
月光博客
博客园 - Franky
Martin Fowler
Martin Fowler
U
Unit 42
阮一峰的网络日志
阮一峰的网络日志
Recent Announcements
Recent Announcements
The Cloudflare Blog
博客园 - 聂微东
酷 壳 – CoolShell
酷 壳 – CoolShell
宝玉的分享
宝玉的分享
J
Java Code Geeks
B
Blog RSS Feed
博客园 - 三生石上(FineUI控件)
MongoDB | Blog
MongoDB | Blog
腾讯CDC
博客园_首页
博客园 - 司徒正美
D
DataBreaches.Net
I
InfoQ
GbyAI
GbyAI
IT之家
IT之家
罗磊的独立博客

Recent Commits to openclaw:main

test: merge chat side-result checks · openclaw/openclaw@ddd2c2a test: merge cron history checks · openclaw/openclaw@f7eb746 test: merge responsive navigation shell checks · openclaw/openclaw@c2e4b47 docs(changelog): add codex oauth fixes · openclaw/openclaw@628e6cd test: merge navigation routing cases · openclaw/openclaw@5d8cecb Tests: mock channel registry bundled fallback · openclaw/openclaw@2b08233 Secrets: avoid broad web search discovery for single plugin config · openclaw/openclaw@a464f59 test: merge config view browser checks · openclaw/openclaw@20cf511 fix(status): align oauth health with runtime · openclaw/openclaw@eed7116 feat: add macOS screen snapshots for monitor preview (#67954) thanks … · openclaw/openclaw@f377db1 fix: report shared auth scopes in hello-ok (#67810) thanks @BunsDev · openclaw/openclaw@0b6c39b Auto-reply: avoid eager bundled route fallback · openclaw/openclaw@3ea1bf4 Tests: narrow session binding contract setup · openclaw/openclaw@54e4e16 fix(macOS): enable undo/redo in webchat composer text input (#34962) · openclaw/openclaw@00951dc Tests: speed up channel setup promotion · openclaw/openclaw@82b529a Docs: refresh agent instructions · openclaw/openclaw@5775fe2 fix(auth): serialize OAuth refresh across agents to fix #26322 (#67876) · openclaw/openclaw@8e79080 test: allow ollama public surface boundary test · openclaw/openclaw@7d4f1a6 Docs: add test performance guardrails · openclaw/openclaw@89706d3 Tests: restore context-engine usage proof · openclaw/openclaw@e4c4f95 Tests: slim context engine runtime coverage · openclaw/openclaw@74c198f ci: retry failed custom checkouts · openclaw/openclaw@0ee5baf test: trim duplicate provider auth onboarding cases · openclaw/openclaw@1ffc02e matrix: fix sessions_spawn --thread subagent session spawning (#67643) · openclaw/openclaw@1ce2596 test: reduce auth choice fixture churn · openclaw/openclaw@857b9cd test: mock health status config boundaries · openclaw/openclaw@9d5ab4a test: mock onboard config io boundary · openclaw/openclaw@299694d test: mock legacy state plugin boundaries · openclaw/openclaw@2713089 test: mock channel install boundaries · openclaw/openclaw@b945248 test: mock doctor preview channel boundaries · openclaw/openclaw@b1a3ad4
feat(plugins): report setup descriptor drift (#71194) · o...
vincentkoc · 2026-04-25 · via Recent Commits to openclaw:main

@@ -46,11 +46,26 @@ type SetupAutoEnableProbeEntry = {

4646

probe: PluginSetupAutoEnableProbe;

4747

};

484849+

export type PluginSetupRegistryDiagnosticCode =

50+

| "setup-descriptor-provider-missing-runtime"

51+

| "setup-descriptor-provider-runtime-undeclared"

52+

| "setup-descriptor-cli-backend-missing-runtime"

53+

| "setup-descriptor-cli-backend-runtime-undeclared";

54+55+

export type PluginSetupRegistryDiagnostic = {

56+

pluginId: string;

57+

code: PluginSetupRegistryDiagnosticCode;

58+

declaredId?: string;

59+

runtimeId?: string;

60+

message: string;

61+

};

62+4963

type PluginSetupRegistry = {

5064

providers: SetupProviderEntry[];

5165

cliBackends: SetupCliBackendEntry[];

5266

configMigrations: SetupConfigMigrationEntry[];

5367

autoEnableProbes: SetupAutoEnableProbeEntry[];

68+

diagnostics: PluginSetupRegistryDiagnostic[];

5469

};

55705671

type SetupAutoEnableReason = {

@@ -372,6 +387,75 @@ function findUniqueSetupManifestOwner(params: {

372387

return matches.length === 1 ? matches[0] : undefined;

373388

}

374389390+

function mapNormalizedIds(ids: readonly string[]): Map<string, string> {

391+

const mapped = new Map<string, string>();

392+

for (const id of ids) {

393+

const normalized = normalizeProviderId(id);

394+

if (!normalized || mapped.has(normalized)) {

395+

continue;

396+

}

397+

mapped.set(normalized, id);

398+

}

399+

return mapped;

400+

}

401+402+

function pushSetupDescriptorDriftDiagnostics(params: {

403+

record: PluginManifestRecord;

404+

providers: readonly ProviderPlugin[];

405+

cliBackends: readonly CliBackendPlugin[];

406+

diagnostics: PluginSetupRegistryDiagnostic[];

407+

}): void {

408+

const declaredProviderIds = params.record.setup?.providers?.map((entry) => entry.id);

409+

if (declaredProviderIds) {

410+

for (const declaredId of declaredProviderIds) {

411+

if (!params.providers.some((provider) => matchesProvider(provider, declaredId))) {

412+

params.diagnostics.push({

413+

pluginId: params.record.id,

414+

code: "setup-descriptor-provider-missing-runtime",

415+

declaredId,

416+

message: `setup.providers declares "${declaredId}" but setup runtime did not register a matching provider.`,

417+

});

418+

}

419+

}

420+

for (const provider of params.providers) {

421+

if (!declaredProviderIds.some((declaredId) => matchesProvider(provider, declaredId))) {

422+

params.diagnostics.push({

423+

pluginId: params.record.id,

424+

code: "setup-descriptor-provider-runtime-undeclared",

425+

runtimeId: provider.id,

426+

message: `setup runtime registered provider "${provider.id}" but setup.providers does not declare it.`,

427+

});

428+

}

429+

}

430+

}

431+432+

const declaredCliBackendIds = params.record.setup?.cliBackends;

433+

if (declaredCliBackendIds) {

434+

const declaredCliBackends = mapNormalizedIds(declaredCliBackendIds);

435+

const runtimeCliBackends = mapNormalizedIds(params.cliBackends.map((backend) => backend.id));

436+

for (const [normalized, declaredId] of declaredCliBackends) {

437+

if (!runtimeCliBackends.has(normalized)) {

438+

params.diagnostics.push({

439+

pluginId: params.record.id,

440+

code: "setup-descriptor-cli-backend-missing-runtime",

441+

declaredId,

442+

message: `setup.cliBackends declares "${declaredId}" but setup runtime did not register a matching CLI backend.`,

443+

});

444+

}

445+

}

446+

for (const [normalized, runtimeId] of runtimeCliBackends) {

447+

if (!declaredCliBackends.has(normalized)) {

448+

params.diagnostics.push({

449+

pluginId: params.record.id,

450+

code: "setup-descriptor-cli-backend-runtime-undeclared",

451+

runtimeId,

452+

message: `setup runtime registered CLI backend "${runtimeId}" but setup.cliBackends does not declare it.`,

453+

});

454+

}

455+

}

456+

}

457+

}

458+375459

export function resolvePluginSetupRegistry(params?: {

376460

workspaceDir?: string;

377461

env?: NodeJS.ProcessEnv;

@@ -397,6 +481,7 @@ export function resolvePluginSetupRegistry(params?: {

397481

cliBackends: [],

398482

configMigrations: [],

399483

autoEnableProbes: [],

484+

diagnostics: [],

400485

} satisfies PluginSetupRegistry;

401486

setCachedSetupValue(setupRegistryCache, cacheKey, empty);

402487

return empty;

@@ -406,6 +491,7 @@ export function resolvePluginSetupRegistry(params?: {

406491

const cliBackends: SetupCliBackendEntry[] = [];

407492

const configMigrations: SetupConfigMigrationEntry[] = [];

408493

const autoEnableProbes: SetupAutoEnableProbeEntry[] = [];

494+

const diagnostics: PluginSetupRegistryDiagnostic[] = [];

409495

const providerKeys = new Set<string>();

410496

const cliBackendKeys = new Set<string>();

411497

@@ -423,6 +509,8 @@ export function resolvePluginSetupRegistry(params?: {

423509

continue;

424510

}

425511512+

const recordProviders: ProviderPlugin[] = [];

513+

const recordCliBackends: CliBackendPlugin[] = [];

426514

const api = buildSetupPluginApi({

427515

record,

428516

setupSource: setupRegistration.setupSource,

@@ -437,6 +525,7 @@ export function resolvePluginSetupRegistry(params?: {

437525

pluginId: record.id,

438526

provider,

439527

});

528+

recordProviders.push(provider);

440529

},

441530

registerCliBackend(backend) {

442531

const key = `${record.id}:${normalizeProviderId(backend.id)}`;

@@ -448,6 +537,7 @@ export function resolvePluginSetupRegistry(params?: {

448537

pluginId: record.id,

449538

backend,

450539

});

540+

recordCliBackends.push(backend);

451541

},

452542

registerConfigMigration(migrate) {

453543

configMigrations.push({

@@ -473,13 +563,20 @@ export function resolvePluginSetupRegistry(params?: {

473563

} catch {

474564

continue;

475565

}

566+

pushSetupDescriptorDriftDiagnostics({

567+

record,

568+

providers: recordProviders,

569+

cliBackends: recordCliBackends,

570+

diagnostics,

571+

});

476572

}

477573478574

const registry = {

479575

providers,

480576

cliBackends,

481577

configMigrations,

482578

autoEnableProbes,

579+

diagnostics,

483580

} satisfies PluginSetupRegistry;

484581

setCachedSetupValue(setupRegistryCache, cacheKey, registry);

485582

return registry;