Function handleVis

apps/kimi-code/src/cli/sub/vis.ts:51–101

(deps: VisDeps, opts: VisOptions)

}

export async function handleVis(deps: VisDeps, opts: VisOptions): Promise<void> {
  const homeDir = deps.getHomeDir();

  // Lazily load the embedded single-file SPA so normal `kimi` startup never
  // pays for it. The module is generated at build time (prebuild). When running
  // from source without a build — e.g. tests — the generated value module is
  // absent and the dynamic import throws; in that case the server falls back to
  // its own static `public/` directory.
  let webAsset: { gzipped: Uint8Array } | undefined;
  try {
    const { VIS_WEB_GZIP_B64 } = await import('#/generated/vis-web-asset');
    if (VIS_WEB_GZIP_B64.length > 0) {
      webAsset = { gzipped: new Uint8Array(Buffer.from(VIS_WEB_GZIP_B64, 'base64')) };
    }
  } catch {
    // Embedded asset not generated in this context — fall back to filesystem.
  }

  let server: StartedVisServer;
  try {
    server = await deps.startVisServer({
      homeDir,
      port: opts.port ?? 0,
      ...(opts.host === undefined ? {} : { host: opts.host }),
      ...(webAsset === undefined ? {} : { webAsset }),
    });
  } catch (error) {
    const msg = error instanceof Error ? error.message : String(error);
    deps.stderr.write(`Failed to start kimi vis: ${msg}\n`);
    return deps.exit(1);
  }

  const target =
    opts.sessionId === undefined
      ? server.url
      : `${server.url}sessions/${encodeURIComponent(opts.sessionId)}`;

  deps.stdout.write(`kimi vis is running at ${server.url}\n`);
  deps.stdout.write('Press Ctrl-C to stop.\n');

  if (opts.open) {
    try {
      await deps.openUrl(target);
    } catch {
      deps.stderr.write(`Could not open a browser; visit ${target} manually.\n`);
    }
  }

  await deps.waitForShutdown();
  await server.close();
}

export function registerVisCommand(parent: Command, overrides?: Partial<VisDeps>): void {
  parent