Function install

packages/server/src/svc/launchd.ts:62–97

(args: InstallArgs)

  const deps: LaunchdManagerDeps = { ...DEFAULT_DEPS, ...overrides };

  async function install(args: InstallArgs): Promise<InstallResult> {
    const plistPath = deps.plistPath();
    const logPath = deps.logPath();
    const program = deps.resolveProgram();
    const plan = buildInstallPlan({ ...args, program, logPath });

    const alreadyInstalled = existsSync(plistPath);
    if (alreadyInstalled && args.force !== true) {
      return {
        status: 'already-installed',
        message: `LaunchAgent already installed at ${plistPath}. Rerun with --force to replace it.`,
        plistPath,
      };
    }

    if (alreadyInstalled) {

      await bestEffortBootout(deps);
    }

    writePlist(plistPath, plan, logPath);
    writeInstallPlan(plan);

    const bootstrap = await deps.execLaunchctl(['bootstrap', deps.guiDomain(), plistPath]);
    if (bootstrap.code !== 0 && !isAlreadyLoaded(bootstrap)) {
      throw new Error(
        `launchctl bootstrap failed (code ${bootstrap.code}): ${detail(bootstrap) ?? 'unknown error'}`,
      );
    }

    return {
      status: alreadyInstalled ? 'replaced' : 'installed',
      message: `Kimi server LaunchAgent ${alreadyInstalled ? 'replaced' : 'installed'} at ${plistPath} (port ${plan.port}).`,
      plistPath,
    };
  }

  async function uninstall(): Promise<LifecycleResult> {
    const plistPath = deps.plistPath();