import fs from "node:fs";

import path from "node:path";

import type { OpenClawConfig } from "../config/types.js";

import { isBlockedObjectKey } from "../infra/prototype-keys.js";

import {

normalizeOptionalLowercaseString,

normalizeOptionalString,

} from "../shared/string-coerce.js";

import { normalizeOptionalTrimmedStringList } from "../shared/string-normalization.js";

import { sanitizeForLog } from "../terminal/ansi.js";

import { resolveUserPath } from "../utils.js";

import { resolveCompatibilityHostVersion } from "../version.js";

import { loadBundleManifest } from "./bundle-manifest.js";

packageChannel?: OpenClawPackageManifest["channel"];

}): Record<string, PluginManifestChannelConfig> | undefined {

const channelId = params.packageChannel?.id?.trim();

if (!channelId || !params.channelConfigs?.[channelId]) {

if (

!channelId ||

isBlockedObjectKey(channelId) ||

!params.channelConfigs ||

!Object.prototype.hasOwnProperty.call(params.channelConfigs, channelId)

) {

return params.channelConfigs;

}

const existing = params.channelConfigs[channelId];

if (!existing) {

return params.channelConfigs;

}

const label = existing.label ?? normalizeOptionalString(params.packageChannel?.label) ?? "";

const description =

existing.description ?? normalizeOptionalString(params.packageChannel?.blurb) ?? "";

const preferOver =

existing.preferOver ?? normalizePreferredPluginIds(params.packageChannel?.preferOver);

return {

...params.channelConfigs,

[channelId]: {

...existing,

...(label ? { label } : {}),

...(description ? { description } : {}),

...(preferOver?.length ? { preferOver } : {}),

},

const merged: Record<string, PluginManifestChannelConfig> = Object.create(null);

for (const [key, value] of Object.entries(params.channelConfigs)) {

if (!isBlockedObjectKey(key)) {

merged[key] = value;

}

}

merged[channelId] = {

...existing,

...(label ? { label } : {}),

...(description ? { description } : {}),

...(preferOver?.length ? { preferOver } : {}),

};

return merged;

}

function buildRecord(params: {

}

params.diagnostics.push({

level: "warn",

pluginId: params.record.id,

source: params.record.manifestPath,

message: `providerAuthEnvVars is deprecated compatibility metadata for provider env-var lookup; mirror ${providerIds.join(", ")} env vars to setup.providers[].envVars before the deprecation window closes`,

pluginId: sanitizeForLog(params.record.id),

source: sanitizeForLog(params.record.manifestPath),

message: `providerAuthEnvVars is deprecated compatibility metadata for provider env-var lookup; mirror ${providerIds.map(sanitizeForLog).join(", ")} env vars to setup.providers[].envVars before the deprecation window closes`,

});

}

return;

}

const channelConfigs = params.record.channelConfigs ?? {};

const missingChannels = declaredChannels.filter((channelId) => !channelConfigs[channelId]);

const missingChannels = declaredChannels.filter(

(channelId) => !Object.prototype.hasOwnProperty.call(channelConfigs, channelId),

);

if (missingChannels.length === 0) {

return;

}

const safeMissingChannels = missingChannels.map(sanitizeForLog);

params.diagnostics.push({

level: "warn",

pluginId: params.record.id,

source: params.record.manifestPath,

message: `channel plugin manifest declares ${missingChannels.join(", ")} without channelConfigs metadata; add openclaw.plugin.json#channelConfigs so config schema and setup surfaces work before runtime loads`,

pluginId: sanitizeForLog(params.record.id),

source: sanitizeForLog(params.record.manifestPath),

message: `channel plugin manifest declares ${safeMissingChannels.join(", ")} without channelConfigs metadata; add openclaw.plugin.json#channelConfigs so config schema and setup surfaces work before runtime loads`,

});

}