Function createLaunchdManager

packages/server/src/svc/launchd.ts:57–228

(
  overrides: Partial<LaunchdManagerDeps> = {},
)

export function createLaunchdManager(
  overrides: Partial<LaunchdManagerDeps> = {},
): ServiceManager {
  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();
    const installed = existsSync(plistPath);
    if (!installed) {
      deleteInstallPlan();
      return { ok: true, message: 'LaunchAgent was not installed; nothing to remove.' };
    }
    const bootout = await deps.execLaunchctl([
      'bootout',
      `${deps.guiDomain()}/${KIMI_SERVER_LABEL}`,
    ]);

    void bootout;
    try {
      rmSync(plistPath, { force: true });
    } catch (error) {