// Plugin install command implementation for bundled, npm, path, git, ClawHub, and hook packs.

import fs from "node:fs";

import { isRecord } from "@openclaw/normalization-core/record-coerce";

import { uniqueStrings } from "@openclaw/normalization-core/string-normalization";

invalidateRuntimeCache?: boolean;

runtime?: RuntimeEnv;

}) {

// Bundled plugins with required config are recorded but not enabled until config validates.

const existingEntry = params.snapshot.config.plugins?.entries?.[params.bundledSource.pluginId];

const shouldEnable = hasValidBundledPluginConfig({

bundledSource: params.bundledSource,

// Persistence helpers for plugin and hook-pack installs plus related config mutation.

import { theme } from "../../packages/terminal-core/src/theme.js";

import { replaceConfigFile } from "../config/config.js";

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

install: Omit<PluginInstallUpdate, "pluginId">;

runtime: RuntimeEnv;

}): void {

// Warn when a newly installed npm plugin is shadowed by an explicit config source.

if (params.install.source !== "npm") {

return;

}

// Text formatter for plugin list rows and verbose plugin details.

import { sanitizeTerminalText } from "../../packages/terminal-core/src/safe-text.js";

import { theme } from "../../packages/terminal-core/src/theme.js";

import type { PluginRecord } from "../plugins/registry.js";

// Plugin uninstall command implementation and confirmation-driven removal plan execution.

import os from "node:os";

import path from "node:path";

import { theme } from "../../packages/terminal-core/src/theme.js";

opts: PluginUninstallOptions = {},

runtime: RuntimeEnv = defaultRuntime,

): Promise<void> {

// Uninstall mutates config/install records and optionally managed files, so guard write mode first.

assertConfigWriteAllowedInCurrentMode();

const {

// Port inspection and force-free helpers used by gateway run/install flows.

import { execFileSync } from "node:child_process";

import { createServer } from "node:net";

import { formatErrorMessage } from "../infra/errors.js";

}

function isRecoverableLsofError(err: unknown): boolean {

// Permission or missing-binary failures can fall back to fuser on Linux.

const code = getErrnoCode(err);

if (code === "ENOENT" || code === "EACCES" || code === "EPERM") {

return true;

// Profile name validation and normalization helpers for root CLI profile routing.

import { normalizeLowercaseStringOrEmpty } from "@openclaw/normalization-core/string-coerce";

const PROFILE_NAME_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/i;

// Root --profile/--dev parsing and environment projection for profile-specific state.

import os from "node:os";

import path from "node:path";

import {

}

export function parseCliProfileArgs(argv: string[]): CliProfileParseResult {

// Root profile flags are stripped before Commander sees argv, except command-local cases.

let profile: string | null = null;

let sawDev = false;

// Builds the root Commander program, context, help, hooks, and command registry.

import process from "node:process";

import { Command } from "commander";

import { registerProgramCommands } from "./command-registry.js";

// Core command registry that lazily imports command groups based on parsed argv.

import type { Command } from "commander";

import { resolveCliArgvInvocation } from "../argv-invocation.js";

import { shouldRegisterPrimaryCommandOnly } from "../command-registration-policy.js";

];

function resolveCoreCommandGroups(ctx: ProgramContext, argv: string[]): CommandGroupEntry[] {

// Descriptor metadata and import specs stay separate so help can stay cheap.

return buildCommandGroupEntries(

getCoreCliCommandDescriptors(),

coreEntrySpecs,

// CLI config readiness guard, legacy-state migration routing, and invalid-config allowances.

import fs from "node:fs";

import os from "node:os";

import path from "node:path";

}

function hasLegacyStateMigrationInputs(): boolean {

// Only run migration prompts when old state actually exists in known legacy locations.

const stateDir = resolveStateDir(process.env, os.homedir);

const oauthDir = resolveOAuthDir(process.env, stateDir);

if (