import fsSync from "node:fs"; import path from "node:path"; import type { OpenClawConfig } from "../config/config.js"; import { openBoundaryFileSync } from "../infra/boundary-file-read.js"; import type { UpdateChannel } from "../infra/update-channels.js"; import { resolveUserPath } from "../utils.js"; import { resolveBundledPluginSources } from "./bundled-sources.js"; import { installPluginFromNpmSpec, PLUGIN_INSTALL_ERROR_CODE, type InstallPluginResult, resolvePluginInstallDir, } from "./install.js"; import { buildNpmResolutionInstallFields, recordPluginInstall } from "./installs.js"; export type PluginUpdateLogger = { info?: (message: string) => void; warn?: (message: string) => void; error?: (message: string) => void; }; export type PluginUpdateStatus = "updated" | "unchanged" | "skipped" | "error"; export type PluginUpdateOutcome = { pluginId: string; status: PluginUpdateStatus; message: string; currentVersion?: string; nextVersion?: string; }; export type PluginUpdateSummary = { config: OpenClawConfig; changed: boolean; outcomes: PluginUpdateOutcome[]; }; export type PluginUpdateIntegrityDriftParams = { pluginId: string; spec: string; expectedIntegrity: string; actualIntegrity: string; resolvedSpec?: string; resolvedVersion?: string; dryRun: boolean; }; export type PluginChannelSyncSummary = { switchedToBundled: string[]; switchedToNpm: string[]; warnings: string[]; errors: string[]; }; export type PluginChannelSyncResult = { config: OpenClawConfig; changed: boolean; summary: PluginChannelSyncSummary; }; function formatNpmInstallFailure(params: { pluginId: string; spec: string; phase: "check" | "update"; result: Extract; }): string { if (params.result.code === PLUGIN_INSTALL_ERROR_CODE.NPM_PACKAGE_NOT_FOUND) { return `Failed to ${params.phase} ${params.pluginId}: npm package not found for ${params.spec}.`; } return `Failed to ${params.phase} ${params.pluginId}: ${params.result.error}`; } type InstallIntegrityDrift = { spec: string; expectedIntegrity: string; actualIntegrity: string; resolution: { resolvedSpec?: string; version?: string; }; }; async function readInstalledPackageVersion(dir: string): Promise { const manifestPath = path.join(dir, "package.json"); const opened = openBoundaryFileSync({ absolutePath: manifestPath, rootPath: dir, boundaryLabel: "installed plugin directory", }); if (!opened.ok) { return undefined; } try { const raw = fsSync.readFileSync(opened.fd, "utf-8"); const parsed = JSON.parse(raw) as { version?: unknown }; return typeof parsed.version === "string" ? parsed.version : undefined; } catch { return undefined; } finally { fsSync.closeSync(opened.fd); } } function pathsEqual(left?: string, right?: string): boolean { if (!left || !right) { return false; } return resolveUserPath(left) === resolveUserPath(right); } function buildLoadPathHelpers(existing: string[]) { let paths = [...existing]; const resolveSet = () => new Set(paths.map((entry) => resolveUserPath(entry))); let resolved = resolveSet(); let changed = false; const addPath = (value: string) => { const normalized = resolveUserPath(value); if (resolved.has(normalized)) { return; } paths.push(value); resolved.add(normalized); changed = true; }; const removePath = (value: string) => { const normalized = resolveUserPath(value); if (!resolved.has(normalized)) { return; } paths = paths.filter((entry) => resolveUserPath(entry) !== normalized); resolved = resolveSet(); changed = true; }; return { addPath, removePath, get changed() { return changed; }, get paths() { return paths; }, }; } function createPluginUpdateIntegrityDriftHandler(params: { pluginId: string; dryRun: boolean; logger: PluginUpdateLogger; onIntegrityDrift?: (params: PluginUpdateIntegrityDriftParams) => boolean | Promise; }) { return async (drift: InstallIntegrityDrift) => { const payload: PluginUpdateIntegrityDriftParams = { pluginId: params.pluginId, spec: drift.spec, expectedIntegrity: drift.expectedIntegrity, actualIntegrity: drift.actualIntegrity, resolvedSpec: drift.resolution.resolvedSpec, resolvedVersion: drift.resolution.version, dryRun: params.dryRun, }; if (params.onIntegrityDrift) { return await params.onIntegrityDrift(payload); } params.logger.warn?.( `Integrity drift for "${params.pluginId}" (${payload.resolvedSpec ?? payload.spec}): expected ${payload.expectedIntegrity}, got ${payload.actualIntegrity}`, ); return true; }; } export async function updateNpmInstalledPlugins(params: { config: OpenClawConfig; logger?: PluginUpdateLogger; pluginIds?: string[]; skipIds?: Set; dryRun?: boolean; onIntegrityDrift?: (params: PluginUpdateIntegrityDriftParams) => boolean | Promise; }): Promise { const logger = params.logger ?? {}; const installs = params.config.plugins?.installs ?? {}; const targets = params.pluginIds?.length ? params.pluginIds : Object.keys(installs); const outcomes: PluginUpdateOutcome[] = []; let next = params.config; let changed = false; for (const pluginId of targets) { if (params.skipIds?.has(pluginId)) { outcomes.push({ pluginId, status: "skipped", message: `Skipping "${pluginId}" (already updated).`, }); continue; } const record = installs[pluginId]; if (!record) { outcomes.push({ pluginId, status: "skipped", message: `No install record for "${pluginId}".`, }); continue; } if (record.source !== "npm") { outcomes.push({ pluginId, status: "skipped", message: `Skipping "${pluginId}" (source: ${record.source}).`, }); continue; } if (!record.spec) { outcomes.push({ pluginId, status: "skipped", message: `Skipping "${pluginId}" (missing npm spec).`, }); continue; } let installPath: string; try { installPath = record.installPath ?? resolvePluginInstallDir(pluginId); } catch (err) { outcomes.push({ pluginId, status: "error", message: `Invalid install path for "${pluginId}": ${String(err)}`, }); continue; } const currentVersion = await readInstalledPackageVersion(installPath); if (params.dryRun) { let probe: Awaited>; try { probe = await installPluginFromNpmSpec({ spec: record.spec, mode: "update", dryRun: true, expectedPluginId: pluginId, expectedIntegrity: record.integrity, onIntegrityDrift: createPluginUpdateIntegrityDriftHandler({ pluginId, dryRun: true, logger, onIntegrityDrift: params.onIntegrityDrift, }), logger, }); } catch (err) { outcomes.push({ pluginId, status: "error", message: `Failed to check ${pluginId}: ${String(err)}`, }); continue; } if (!probe.ok) { outcomes.push({ pluginId, status: "error", message: formatNpmInstallFailure({ pluginId, spec: record.spec, phase: "check", result: probe, }), }); continue; } const nextVersion = probe.version ?? "unknown"; const currentLabel = currentVersion ?? "unknown"; if (currentVersion && probe.version && currentVersion === probe.version) { outcomes.push({ pluginId, status: "unchanged", currentVersion: currentVersion ?? undefined, nextVersion: probe.version ?? undefined, message: `${pluginId} is up to date (${currentLabel}).`, }); } else { outcomes.push({ pluginId, status: "updated", currentVersion: currentVersion ?? undefined, nextVersion: probe.version ?? undefined, message: `Would update ${pluginId}: ${currentLabel} -> ${nextVersion}.`, }); } continue; } let result: Awaited>; try { result = await installPluginFromNpmSpec({ spec: record.spec, mode: "update", expectedPluginId: pluginId, expectedIntegrity: record.integrity, onIntegrityDrift: createPluginUpdateIntegrityDriftHandler({ pluginId, dryRun: false, logger, onIntegrityDrift: params.onIntegrityDrift, }), logger, }); } catch (err) { outcomes.push({ pluginId, status: "error", message: `Failed to update ${pluginId}: ${String(err)}`, }); continue; } if (!result.ok) { outcomes.push({ pluginId, status: "error", message: formatNpmInstallFailure({ pluginId, spec: record.spec, phase: "update", result: result, }), }); continue; } const nextVersion = result.version ?? (await readInstalledPackageVersion(result.targetDir)); next = recordPluginInstall(next, { pluginId, source: "npm", spec: record.spec, installPath: result.targetDir, version: nextVersion, ...buildNpmResolutionInstallFields(result.npmResolution), }); changed = true; const currentLabel = currentVersion ?? "unknown"; const nextLabel = nextVersion ?? "unknown"; if (currentVersion && nextVersion && currentVersion === nextVersion) { outcomes.push({ pluginId, status: "unchanged", currentVersion: currentVersion ?? undefined, nextVersion: nextVersion ?? undefined, message: `${pluginId} already at ${currentLabel}.`, }); } else { outcomes.push({ pluginId, status: "updated", currentVersion: currentVersion ?? undefined, nextVersion: nextVersion ?? undefined, message: `Updated ${pluginId}: ${currentLabel} -> ${nextLabel}.`, }); } } return { config: next, changed, outcomes }; } export async function syncPluginsForUpdateChannel(params: { config: OpenClawConfig; channel: UpdateChannel; workspaceDir?: string; logger?: PluginUpdateLogger; }): Promise { const summary: PluginChannelSyncSummary = { switchedToBundled: [], switchedToNpm: [], warnings: [], errors: [], }; const bundled = resolveBundledPluginSources({ workspaceDir: params.workspaceDir }); if (bundled.size === 0) { return { config: params.config, changed: false, summary }; } let next = params.config; const loadHelpers = buildLoadPathHelpers(next.plugins?.load?.paths ?? []); const installs = next.plugins?.installs ?? {}; let changed = false; if (params.channel === "dev") { for (const [pluginId, record] of Object.entries(installs)) { const bundledInfo = bundled.get(pluginId); if (!bundledInfo) { continue; } loadHelpers.addPath(bundledInfo.localPath); const alreadyBundled = record.source === "path" && pathsEqual(record.sourcePath, bundledInfo.localPath); if (alreadyBundled) { continue; } next = recordPluginInstall(next, { pluginId, source: "path", sourcePath: bundledInfo.localPath, installPath: bundledInfo.localPath, spec: record.spec ?? bundledInfo.npmSpec, version: record.version, }); summary.switchedToBundled.push(pluginId); changed = true; } } else { for (const [pluginId, record] of Object.entries(installs)) { const bundledInfo = bundled.get(pluginId); if (!bundledInfo) { continue; } if (record.source === "npm") { loadHelpers.removePath(bundledInfo.localPath); continue; } if (record.source !== "path") { continue; } if (!pathsEqual(record.sourcePath, bundledInfo.localPath)) { continue; } const spec = record.spec ?? bundledInfo.npmSpec; if (!spec) { summary.warnings.push(`Missing npm spec for ${pluginId}; keeping local path.`); continue; } let result: Awaited>; try { result = await installPluginFromNpmSpec({ spec, mode: "update", expectedPluginId: pluginId, logger: params.logger, }); } catch (err) { summary.errors.push(`Failed to install ${pluginId}: ${String(err)}`); continue; } if (!result.ok) { summary.errors.push(`Failed to install ${pluginId}: ${result.error}`); continue; } next = recordPluginInstall(next, { pluginId, source: "npm", spec, installPath: result.targetDir, version: result.version, ...buildNpmResolutionInstallFields(result.npmResolution), sourcePath: undefined, }); summary.switchedToNpm.push(pluginId); changed = true; loadHelpers.removePath(bundledInfo.localPath); } } if (loadHelpers.changed) { next = { ...next, plugins: { ...next.plugins, load: { ...next.plugins?.load, paths: loadHelpers.paths, }, }, }; changed = true; } return { config: next, changed, summary }; }